12 2024 Release of the APL compliant APL Viewhost Web

For more details on this release refer to CHANGELOG.md

To learn about APL see: https://developer.amazon.com/docs/alexa-presentation-language/understand-apl.html

CHANGELOG.md

@@ -1,13 +1,27 @@
 # Changelog for apl-viewhost-web
 
+## [2024.3]
+This release adds support for version 2024.3 of the APL specification. Please also see APL Core Library for changes: [apl-core-library CHANGELOG](https://github.com/alexa/apl-core-library/blob/master/CHANGELOG.md)
+
+## Added
+- Add support for text selection
+- Add support for accessibility labels
+- Add support for bulleted lists
+- Add support for performance metrics
+- Add support for pause and resume
+
+## Changed
+- Update webpack to 5 and typescript to 4
+- Bug fixes
+
 ## [2024.2]
 This release adds support for version 2024.2 of the APL specification. Please also see APL Core Library for changes: [apl-core-library CHANGELOG](https://github.com/alexa/apl-core-library/blob/master/CHANGELOG.md)
 
 ### Added
 - New interface APLViewhostWASM and DocumentHandle
 - Add support for Host Component
 - Add IEmbeddedDocumentFactory to fetch embedded document from runtime
-
+ 
 ### Changed
 - Migrate to new core text measurement method
 - Migrate to core PackageManager interface to support ImportPackage command

CMakeLists.txt

@@ -1,12 +1,14 @@
 cmake_minimum_required(VERSION 3.6)
 set(CMAKE_CXX_STANDARD 11)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
-project (apl-wasm VERSION 1.0.0 LANGUAGES C CXX)
+
+project(apl-wasm VERSION 1.0.0 LANGUAGES C CXX)
 
 option(APL_CORE_PATH "Path to APLCoreEngine" OFF)
 
 # Web Assembly
 option(WASM "Build WebAssembly binary" OFF)
+option(BUNDLE_MODE "Bundle the WebAssembly binary to the js" ON)
 option(ASMJS "Build ASM.js" OFF)
 option(WEBSOCKET "Build Websocket Server" OFF)
 option(EMSCRIPTEN_SOURCEMAPS "Builds source maps." OFF)
@@ -16,6 +18,9 @@ if(WASM)
     # make sure we enable exception support when building APL core, since PEGTL
     # relies on it
     set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fexceptions")
+    if(BUNDLE_MODE)
+        set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -s SINGLE_FILE=1")
+    endif()
 endif()
 
 if(${APL_CORE_PATH} STREQUAL "OFF")
@@ -39,9 +44,4 @@ include_directories(${PEGTL_INCLUDE})
 include_directories(${RAPIDJSON_INCLUDE})
 include_directories(${YOGA_INCLUDE})
 
-# build either the wasm or websocket backend
-if(WASM OR ASMJS)
-    add_subdirectory(wasm)
-elseif(WEBSOCKET)
-    add_subdirectory(websocket)
-endif()
+add_subdirectory(wasm)

README.md

@@ -1,10 +1,10 @@
 # Alexa Presentation Language (APL) Viewhost Web
 
 <p>
- <a href="https://github.com/alexa/apl-viewhost-web/tree/v2024.2.0" alt="version">
- <img src="https://img.shields.io/badge/stable%20version-2024.2.0-brightgreen" /></a>
- <a href="https://github.com/alexa/apl-core-library/tree/v2024.2.0" alt="APLCore">
- <img src="https://img.shields.io/badge/apl%20core%20library-2024.2.0-navy" /></a>
+ <a href="https://github.com/alexa/apl-viewhost-web/tree/v2024.3.0" alt="version">
+ <img src="https://img.shields.io/badge/stable%20version-2024.3.0-brightgreen" /></a>
+ <a href="https://github.com/alexa/apl-core-library/tree/v2024.3.0" alt="APLCore">
+ <img src="https://img.shields.io/badge/apl%20core%20library-2024.3.0-navy" /></a>
 </p>
 
 ## Introduction

THIRD-PARTY.txt

@@ -139,7 +139,6 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 
-
 ----------------
 Package: jquery
 Version: 3.5.1
@@ -300,7 +299,7 @@ SOFTWARE.
 
 ----------------
 Package: path-browserify
-Version: 0.0.1
+Version: 1.0.1
 Description: the path module from node core for browsers
 License: MIT
 Copyright (c) 2013 James Halliday
@@ -581,9 +580,65 @@ License: Apache-2.0
    See the License for the specific language governing permissions and
    limitations under the License.
 
+----------------
+Package: ts-loader
+Version: 9.3.1
+Description:
+License: MIT
+
+The MIT License (MIT)
+
+Copyright (c) 2015-present TypeStrong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+----------------
+Package: ts-node
+Version: 10.7.0
+Description:
+License: MIT
+
+The MIT License (MIT)
+
+Copyright (c) 2014 Blake Embrey (hello@blakeembrey.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
 ----------------
 Package: typescript
-Version: 2.7.2
+Version: 4.9.5
 Description: TypeScript is a language for application scale JavaScript development
 License: Apache-2.0
 Apache License
@@ -878,7 +933,7 @@ License: Apache-2.0
 
 ----------------
 Package: webpack
-Version: 4.43.0
+Version: 5.75.0
 Description: Packs CommonJs/AMD modules for the browser. Allows to split your codebase into multiple bundles, which can be loaded on demand. Support loaders to preprocess files, i.e. json, jsx, es7, css, less, ... and your custom stuff.
 License: MIT
 Copyright JS Foundation and other contributors
@@ -902,6 +957,60 @@ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.   
 
+----------------
+Package: webpack-bundle-analyzer
+Version: 4.10.2
+Description:
+License: MIT
+
+Copyright JS Foundation and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+----------------
+Package: webpack-merge
+Version: 5.10.0
+Description:
+License: MIT
+
+Copyright (c) 2015 Juho Vepsalainen
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
 ----------------
 Package: xregexp
 Version: 4.2.4
@@ -928,3 +1037,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
+

js/apl-html/lib/dts/Component.d.ts

@@ -12,12 +12,12 @@
         public getUniqueId() : string;
         public getId() : string;
         public getParent() : Component;
+        public isFocusable() : boolean;
         public update(type : number, value : number) : void;
         public updateEditText(type : number, value : string) : void;
         public pressed() : void;
         public updateScrollPosition(position : number);
         public updatePagerPosition(position : number);
-        public updateMediaState(state : APL.IMediaState, fromEvent : boolean);
         public updateGraphic(json : string);
         public getChildCount() : number;
         public getChildAt(index : number) : Component;

js/apl-html/lib/dts/Content.d.ts

@@ -7,6 +7,7 @@ declare namespace APL {
     export class ImportRef {
         public version(): string;
         public name(): string;
+        public domain(): string;
         public toString(): string;
     }
 

js/apl-html/lib/dts/Context.d.ts

@@ -50,6 +50,8 @@ declare namespace APL {
 
         public setBackground(background: APL.IBackground): void;
 
+        public getDocumentState(): Promise<string>;
+
         public getDataSourceContext(): Promise<string>;
 
         public getVisualContext(): Promise<string>;
@@ -89,7 +91,7 @@ declare namespace APL {
 
         public nextTime(): number;
 
-        public getViewportPixelSize(): object[];
+        public getViewportPixelSize(): object;
 
         public getViewportWidth(): number;
 

js/apl-html/package.json

@@ -37,20 +37,23 @@
     "mp3-parser": "^0.3.0",
     "rimraf": "^2.6.2",
     "style-loader": "^0.23.1",
-    "ts-loader": "^5.3.0",
-    "ts-node": "^8.0.2",
+    "ts-loader": "^9.3.1",
+    "ts-node": "^10.7.0",
     "tslint": "^5.12.1",
     "tslint-loader": "^3.5.4",
     "typedoc": "^0.15.0",
-    "typescript": "2.7.2",
+    "typescript": "4.9.5",
     "uglifyjs-webpack-plugin": "^2.1.2",
     "utf8": "3.0.0",
     "uuid": "^3.3.2",
     "webfontloader": "^1.6.28",
-    "webpack": "^4.26.1",
-    "webpack-bundle-analyzer": "^4.6.1",
-    "webpack-cli": "^3.3.12",
-    "webpack-merge": "^4.2.1",
+    "webpack": "5.75.0",
+    "webpack-bundle-analyzer": "^4.10.2",
+    "webpack-cli": "^5.1.4",
+    "webpack-merge": "^5.10.0",
     "xregexp": "4.2.4"
+  },
+  "dependencies": {
+    "path-browserify": "^1.0.1"
   }
 }