@lightningjs/blits 1.30.0 → 1.30.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. package/.editorconfig +7 -7
  2. package/.eslintignore +1 -1
  3. package/.eslintrc.cjs +65 -65
  4. package/.github/workflows/comment-lint-results.yml +124 -124
  5. package/.github/workflows/comment-test-results.yml +108 -108
  6. package/.github/workflows/deploy-docs.yml +27 -27
  7. package/.github/workflows/run-blits-tests.yml +141 -141
  8. package/.github/workflows/run-lint.yml +127 -127
  9. package/.husky/pre-commit +1 -1
  10. package/.vscode/extensions.json +7 -7
  11. package/.vscode/settings.json +9 -9
  12. package/CHANGELOG.md +1019 -1005
  13. package/COPYING +1 -0
  14. package/LICENSE +202 -202
  15. package/NOTICE +12 -12
  16. package/README.md +33 -33
  17. package/bin/index.js +8 -8
  18. package/blits.d.ts +6 -6
  19. package/docs/README.md +19 -19
  20. package/docs/_sidebar.md +37 -37
  21. package/docs/built-in/directives.md +50 -50
  22. package/docs/built-in/for-loop.md +203 -203
  23. package/docs/built-in/layout.md +168 -168
  24. package/docs/components/component_state.md +90 -90
  25. package/docs/components/computed_properties.md +45 -45
  26. package/docs/components/lifecycle_events.md +42 -42
  27. package/docs/components/methods.md +45 -45
  28. package/docs/components/props.md +56 -56
  29. package/docs/components/user_input.md +186 -186
  30. package/docs/components/utility_methods.md +320 -320
  31. package/docs/components/watchers.md +34 -34
  32. package/docs/essentials/application_root.md +19 -19
  33. package/docs/essentials/components.md +68 -68
  34. package/docs/essentials/displaying_images.md +67 -67
  35. package/docs/essentials/displaying_text.md +135 -135
  36. package/docs/essentials/element_attributes.md +195 -195
  37. package/docs/essentials/settings.md +117 -117
  38. package/docs/essentials/template_syntax.md +83 -83
  39. package/docs/getting_started/file_structure.md +58 -58
  40. package/docs/getting_started/getting_started.md +45 -45
  41. package/docs/getting_started/intro.md +20 -20
  42. package/docs/index.html +47 -47
  43. package/docs/performance/lazy-loading.md +161 -161
  44. package/docs/plugins/global_app_state.md +98 -98
  45. package/docs/plugins/language.md +172 -172
  46. package/docs/plugins/text-to-speech-announcer.md +119 -119
  47. package/docs/plugins/theme.md +176 -176
  48. package/docs/router/basics.md +175 -175
  49. package/docs/router/hooks.md +70 -70
  50. package/docs/router/transitions.md +146 -146
  51. package/docs/sidebar.json +171 -171
  52. package/docs/transitions_animations/transitions.md +150 -150
  53. package/index.d.ts +1099 -1099
  54. package/index.js +28 -28
  55. package/jsconfig.json +12 -12
  56. package/package.json +56 -56
  57. package/public/assets/fps_sprite.base64.js +1 -1
  58. package/scripts/postpublish.js +59 -59
  59. package/scripts/prepublishOnly.js +84 -84
  60. package/scripts/prepush.js +78 -78
  61. package/src/announcer/announcer.js +162 -162
  62. package/src/announcer/speechSynthesis.js +107 -107
  63. package/src/application.js +100 -100
  64. package/src/component/base/announcer.js +27 -27
  65. package/src/component/base/events.js +69 -69
  66. package/src/component/base/index.js +33 -33
  67. package/src/component/base/methods.js +244 -244
  68. package/src/component/base/router.js +41 -41
  69. package/src/component/base/timeouts_intervals.js +99 -99
  70. package/src/component/base/utils.js +72 -72
  71. package/src/component/setup/computed.js +48 -48
  72. package/src/component/setup/index.js +62 -62
  73. package/src/component/setup/input.js +30 -30
  74. package/src/component/setup/methods.js +37 -37
  75. package/src/component/setup/props.js +62 -62
  76. package/src/component/setup/props.test.js +238 -238
  77. package/src/component/setup/routes.js +42 -42
  78. package/src/component/setup/state.js +59 -59
  79. package/src/component/setup/watch.js +35 -35
  80. package/src/component.js +437 -437
  81. package/src/component.test.js +388 -388
  82. package/src/components/Circle.js +73 -73
  83. package/src/components/Circle.orig.js +31 -31
  84. package/src/components/FPScounter.js +1510 -1510
  85. package/src/components/FPScounter.orig.js +121 -121
  86. package/src/components/RouterView.js +81 -81
  87. package/src/components/RouterView.orig.js +54 -54
  88. package/src/components/Sprite.js +94 -94
  89. package/src/components/Sprite.orig.js +58 -58
  90. package/src/components/index.js +28 -28
  91. package/src/components/index.orig.js +28 -28
  92. package/src/constants.js +21 -21
  93. package/src/engine.js +1 -1
  94. package/src/engines/L3/element.js +744 -744
  95. package/src/engines/L3/element.test.js +579 -579
  96. package/src/engines/L3/fontLoader.js +38 -38
  97. package/src/engines/L3/index.js +7 -7
  98. package/src/engines/L3/launch.js +123 -123
  99. package/src/engines/L3/shaderLoader.js +12 -12
  100. package/src/engines/index.js +1 -1
  101. package/src/focus.js +90 -90
  102. package/src/helpers/deepEqualArray.js +50 -50
  103. package/src/helpers/deepEqualArray.test.js +127 -127
  104. package/src/helpers/fetchJson.js +34 -34
  105. package/src/helpers/sequence.js +26 -26
  106. package/src/launch.js +123 -123
  107. package/src/lib/blitsfileconverter/blitsfileconverter.js +52 -52
  108. package/src/lib/codegenerator/generator.js +788 -788
  109. package/src/lib/codegenerator/generator.test.js +3801 -3801
  110. package/src/lib/colors/colors.js +92 -92
  111. package/src/lib/colors/colors.test.js +290 -290
  112. package/src/lib/colors/htmlColors.js +168 -168
  113. package/src/lib/componentId.js +49 -49
  114. package/src/lib/componentId.test.js +84 -84
  115. package/src/lib/eventListeners.js +123 -123
  116. package/src/lib/eventListeners.test.js +236 -236
  117. package/src/lib/hooks.js +59 -59
  118. package/src/lib/lifecycle.js +85 -85
  119. package/src/lib/log.js +117 -117
  120. package/src/lib/precompiler/precompiler.js +73 -73
  121. package/src/lib/reactivity/effect.js +93 -93
  122. package/src/lib/reactivity/effect.test.js +35 -35
  123. package/src/lib/reactivity/reactive.js +208 -208
  124. package/src/lib/reactivity/reactive.test.js +27 -27
  125. package/src/lib/reactivityguard/computedprops.js +218 -218
  126. package/src/lib/symbols.js +108 -108
  127. package/src/lib/templateparser/parser.js +386 -386
  128. package/src/lib/templateparser/parser.test.js +1411 -1411
  129. package/src/lib/utils.js +27 -27
  130. package/src/plugin.js +27 -27
  131. package/src/plugins/appstate.js +26 -26
  132. package/src/plugins/index.js +20 -20
  133. package/src/plugins/language.js +152 -152
  134. package/src/plugins/log.js +25 -25
  135. package/src/plugins/theme.js +94 -94
  136. package/src/router/router.js +514 -514
  137. package/src/router/router.test.js +473 -473
  138. package/src/router/transitions/fadeIn.js +27 -27
  139. package/src/router/transitions/fadeInOut.js +33 -33
  140. package/src/router/transitions/index.js +21 -21
  141. package/src/router/transitions/slideIn.js +28 -28
  142. package/src/router/transitions/slideInOut.js +33 -33
  143. package/src/settings.js +40 -40
  144. package/vite/blitsFileConverter.js +67 -67
  145. package/vite/index.js +28 -28
  146. package/vite/msdfGenerator.js +269 -269
  147. package/vite/preCompiler.js +42 -42
  148. package/vite/reactivityGuard.js +45 -45
  149. package/vscode/data/template-attributes.json +589 -589
@@ -1,94 +1,94 @@
1
- /*
2
- * Copyright 2023 Comcast Cable Communications Management, LLC
3
- * Licensed under the Apache License, Version 2.0 (the "License");
4
- * you may not use this file except in compliance with the License.
5
- * You may obtain a copy of the License at
6
- *
7
- * http://www.apache.org/licenses/LICENSE-2.0
8
- *
9
- * Unless required by applicable law or agreed to in writing, software
10
- * distributed under the License is distributed on an "AS IS" BASIS,
11
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- * See the License for the specific language governing permissions and
13
- * limitations under the License.
14
- *
15
- * SPDX-License-Identifier: Apache-2.0
16
- */
17
-
18
- import Component from '../component.js'
19
-
20
- import symbols from '../lib/symbols.js'
21
-
22
- export default () =>
23
- Component('Sprite', {
24
- /* eslint-disable no-unused-vars */
25
- code: {
26
- render: function anonymous(parent, component, context, components, effect, getRaw, Log) {
27
- const elms = []
28
- let componentType
29
- const rootComponent = component
30
- let propData
31
- let slotComponent
32
- let inSlot = false
33
- let slotChildCounter = 0
34
- const elementConfig0 = {}
35
-
36
- elms[0] = this.element(
37
- { parent: parent || 'root' },
38
- inSlot === true ? slotComponent : component
39
- )
40
-
41
- elementConfig0['w'] = parent.node.width * (100 / 100)
42
- elementConfig0['h'] = parent.node.height * (100 / 100)
43
- elementConfig0['texture'] = component.texture
44
- elementConfig0['color'] = component.color
45
- elms[0].populate(elementConfig0)
46
-
47
- if (inSlot === true) {
48
- slotChildCounter -= 1
49
- }
50
-
51
- return elms
52
- },
53
- effects: [
54
- function anonymous(component, elms, context, components, rootComponent, effect) {
55
- elms[0].set('texture', component.texture)
56
- },
57
- function anonymous(component, elms, context, components, rootComponent, effect) {
58
- elms[0].set('color', component.color)
59
- },
60
- ],
61
- context: {},
62
- },
63
- props: ['image', 'map', 'frame', 'color'],
64
- state() {
65
- return {
66
- spriteTexture: null,
67
- }
68
- },
69
- computed: {
70
- texture() {
71
- const options =
72
- 'frames' in this.map
73
- ? Object.assign({}, this.map.defaults || {}, this.map.frames[this.frame])
74
- : this.map[this.frame]
75
-
76
- if (this.spriteTexture !== null && options) {
77
- return this[symbols.renderer]().createTexture('SubTexture', {
78
- texture: this.spriteTexture,
79
- x: options.x,
80
- y: options.y,
81
- width: options.w,
82
- height: options.h,
83
- })
84
- }
85
- },
86
- },
87
- hooks: {
88
- ready() {
89
- this.spriteTexture = this[symbols.renderer]().createTexture('ImageTexture', {
90
- src: this.image,
91
- })
92
- },
93
- },
94
- })
1
+ /*
2
+ * Copyright 2023 Comcast Cable Communications Management, LLC
3
+ * Licensed under the Apache License, Version 2.0 (the "License");
4
+ * you may not use this file except in compliance with the License.
5
+ * You may obtain a copy of the License at
6
+ *
7
+ * http://www.apache.org/licenses/LICENSE-2.0
8
+ *
9
+ * Unless required by applicable law or agreed to in writing, software
10
+ * distributed under the License is distributed on an "AS IS" BASIS,
11
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ * See the License for the specific language governing permissions and
13
+ * limitations under the License.
14
+ *
15
+ * SPDX-License-Identifier: Apache-2.0
16
+ */
17
+
18
+ import Component from '../component.js'
19
+
20
+ import symbols from '../lib/symbols.js'
21
+
22
+ export default () =>
23
+ Component('Sprite', {
24
+ /* eslint-disable no-unused-vars */
25
+ code: {
26
+ render: function anonymous(parent, component, context, components, effect, getRaw, Log) {
27
+ const elms = []
28
+ let componentType
29
+ const rootComponent = component
30
+ let propData
31
+ let slotComponent
32
+ let inSlot = false
33
+ let slotChildCounter = 0
34
+ const elementConfig0 = {}
35
+
36
+ elms[0] = this.element(
37
+ { parent: parent || 'root' },
38
+ inSlot === true ? slotComponent : component
39
+ )
40
+
41
+ elementConfig0['w'] = parent.node.width * (100 / 100)
42
+ elementConfig0['h'] = parent.node.height * (100 / 100)
43
+ elementConfig0['texture'] = component.texture
44
+ elementConfig0['color'] = component.color
45
+ elms[0].populate(elementConfig0)
46
+
47
+ if (inSlot === true) {
48
+ slotChildCounter -= 1
49
+ }
50
+
51
+ return elms
52
+ },
53
+ effects: [
54
+ function anonymous(component, elms, context, components, rootComponent, effect) {
55
+ elms[0].set('texture', component.texture)
56
+ },
57
+ function anonymous(component, elms, context, components, rootComponent, effect) {
58
+ elms[0].set('color', component.color)
59
+ },
60
+ ],
61
+ context: {},
62
+ },
63
+ props: ['image', 'map', 'frame', 'color'],
64
+ state() {
65
+ return {
66
+ spriteTexture: null,
67
+ }
68
+ },
69
+ computed: {
70
+ texture() {
71
+ const options =
72
+ 'frames' in this.map
73
+ ? Object.assign({}, this.map.defaults || {}, this.map.frames[this.frame])
74
+ : this.map[this.frame]
75
+
76
+ if (this.spriteTexture !== null && options) {
77
+ return this[symbols.renderer]().createTexture('SubTexture', {
78
+ texture: this.spriteTexture,
79
+ x: options.x,
80
+ y: options.y,
81
+ width: options.w,
82
+ height: options.h,
83
+ })
84
+ }
85
+ },
86
+ },
87
+ hooks: {
88
+ ready() {
89
+ this.spriteTexture = this[symbols.renderer]().createTexture('ImageTexture', {
90
+ src: this.image,
91
+ })
92
+ },
93
+ },
94
+ })
@@ -1,58 +1,58 @@
1
- /*
2
- * Copyright 2023 Comcast Cable Communications Management, LLC
3
- * Licensed under the Apache License, Version 2.0 (the "License");
4
- * you may not use this file except in compliance with the License.
5
- * You may obtain a copy of the License at
6
- *
7
- * http://www.apache.org/licenses/LICENSE-2.0
8
- *
9
- * Unless required by applicable law or agreed to in writing, software
10
- * distributed under the License is distributed on an "AS IS" BASIS,
11
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- * See the License for the specific language governing permissions and
13
- * limitations under the License.
14
- *
15
- * SPDX-License-Identifier: Apache-2.0
16
- */
17
-
18
- import Component from '../component.js'
19
-
20
- import symbols from '../lib/symbols.js'
21
-
22
- export default () =>
23
- Component('Sprite', {
24
- template: `
25
- <Element w="100%" h="100%" :texture="$texture" :color="$color" />
26
- `,
27
- props: ['image', 'map', 'frame', 'color'],
28
- state() {
29
- return {
30
- spriteTexture: null,
31
- }
32
- },
33
- computed: {
34
- texture() {
35
- const options =
36
- 'frames' in this.map
37
- ? Object.assign({}, this.map.defaults || {}, this.map.frames[this.frame])
38
- : this.map[this.frame]
39
-
40
- if (this.spriteTexture !== null && options) {
41
- return this[symbols.renderer]().createTexture('SubTexture', {
42
- texture: this.spriteTexture,
43
- x: options.x,
44
- y: options.y,
45
- width: options.w,
46
- height: options.h,
47
- })
48
- }
49
- },
50
- },
51
- hooks: {
52
- ready() {
53
- this.spriteTexture = this[symbols.renderer]().createTexture('ImageTexture', {
54
- src: this.image,
55
- })
56
- },
57
- },
58
- })
1
+ /*
2
+ * Copyright 2023 Comcast Cable Communications Management, LLC
3
+ * Licensed under the Apache License, Version 2.0 (the "License");
4
+ * you may not use this file except in compliance with the License.
5
+ * You may obtain a copy of the License at
6
+ *
7
+ * http://www.apache.org/licenses/LICENSE-2.0
8
+ *
9
+ * Unless required by applicable law or agreed to in writing, software
10
+ * distributed under the License is distributed on an "AS IS" BASIS,
11
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ * See the License for the specific language governing permissions and
13
+ * limitations under the License.
14
+ *
15
+ * SPDX-License-Identifier: Apache-2.0
16
+ */
17
+
18
+ import Component from '../component.js'
19
+
20
+ import symbols from '../lib/symbols.js'
21
+
22
+ export default () =>
23
+ Component('Sprite', {
24
+ template: `
25
+ <Element w="100%" h="100%" :texture="$texture" :color="$color" />
26
+ `,
27
+ props: ['image', 'map', 'frame', 'color'],
28
+ state() {
29
+ return {
30
+ spriteTexture: null,
31
+ }
32
+ },
33
+ computed: {
34
+ texture() {
35
+ const options =
36
+ 'frames' in this.map
37
+ ? Object.assign({}, this.map.defaults || {}, this.map.frames[this.frame])
38
+ : this.map[this.frame]
39
+
40
+ if (this.spriteTexture !== null && options) {
41
+ return this[symbols.renderer]().createTexture('SubTexture', {
42
+ texture: this.spriteTexture,
43
+ x: options.x,
44
+ y: options.y,
45
+ width: options.w,
46
+ height: options.h,
47
+ })
48
+ }
49
+ },
50
+ },
51
+ hooks: {
52
+ ready() {
53
+ this.spriteTexture = this[symbols.renderer]().createTexture('ImageTexture', {
54
+ src: this.image,
55
+ })
56
+ },
57
+ },
58
+ })
@@ -1,28 +1,28 @@
1
- /*
2
- * Copyright 2024 Comcast Cable Communications Management, LLC
3
- * Licensed under the Apache License, Version 2.0 (the "License");
4
- * you may not use this file except in compliance with the License.
5
- * You may obtain a copy of the License at
6
- *
7
- * http://www.apache.org/licenses/LICENSE-2.0
8
- *
9
- * Unless required by applicable law or agreed to in writing, software
10
- * distributed under the License is distributed on an "AS IS" BASIS,
11
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- * See the License for the specific language governing permissions and
13
- * limitations under the License.
14
- *
15
- * SPDX-License-Identifier: Apache-2.0
16
- */
17
-
18
- import Circle from './Circle.js'
19
- import RouterView from './RouterView.js'
20
- import Sprite from './Sprite.js'
21
- import FPScounter from './FPScounter.js'
22
-
23
- export default () => ({
24
- Circle: Circle(),
25
- RouterView: RouterView(),
26
- Sprite: Sprite(),
27
- FPScounter: FPScounter(),
28
- })
1
+ /*
2
+ * Copyright 2024 Comcast Cable Communications Management, LLC
3
+ * Licensed under the Apache License, Version 2.0 (the "License");
4
+ * you may not use this file except in compliance with the License.
5
+ * You may obtain a copy of the License at
6
+ *
7
+ * http://www.apache.org/licenses/LICENSE-2.0
8
+ *
9
+ * Unless required by applicable law or agreed to in writing, software
10
+ * distributed under the License is distributed on an "AS IS" BASIS,
11
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ * See the License for the specific language governing permissions and
13
+ * limitations under the License.
14
+ *
15
+ * SPDX-License-Identifier: Apache-2.0
16
+ */
17
+
18
+ import Circle from './Circle.js'
19
+ import RouterView from './RouterView.js'
20
+ import Sprite from './Sprite.js'
21
+ import FPScounter from './FPScounter.js'
22
+
23
+ export default () => ({
24
+ Circle: Circle(),
25
+ RouterView: RouterView(),
26
+ Sprite: Sprite(),
27
+ FPScounter: FPScounter(),
28
+ })
@@ -1,28 +1,28 @@
1
- /*
2
- * Copyright 2024 Comcast Cable Communications Management, LLC
3
- * Licensed under the Apache License, Version 2.0 (the "License");
4
- * you may not use this file except in compliance with the License.
5
- * You may obtain a copy of the License at
6
- *
7
- * http://www.apache.org/licenses/LICENSE-2.0
8
- *
9
- * Unless required by applicable law or agreed to in writing, software
10
- * distributed under the License is distributed on an "AS IS" BASIS,
11
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- * See the License for the specific language governing permissions and
13
- * limitations under the License.
14
- *
15
- * SPDX-License-Identifier: Apache-2.0
16
- */
17
-
18
- import Circle from './Circle.js'
19
- import RouterView from './RouterView.js'
20
- import Sprite from './Sprite.js'
21
- import FPScounter from './FPScounter.js'
22
-
23
- export default () => ({
24
- Circle: Circle(),
25
- RouterView: RouterView(),
26
- Sprite: Sprite(),
27
- FPScounter: FPScounter(),
28
- })
1
+ /*
2
+ * Copyright 2024 Comcast Cable Communications Management, LLC
3
+ * Licensed under the Apache License, Version 2.0 (the "License");
4
+ * you may not use this file except in compliance with the License.
5
+ * You may obtain a copy of the License at
6
+ *
7
+ * http://www.apache.org/licenses/LICENSE-2.0
8
+ *
9
+ * Unless required by applicable law or agreed to in writing, software
10
+ * distributed under the License is distributed on an "AS IS" BASIS,
11
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ * See the License for the specific language governing permissions and
13
+ * limitations under the License.
14
+ *
15
+ * SPDX-License-Identifier: Apache-2.0
16
+ */
17
+
18
+ import Circle from './Circle.js'
19
+ import RouterView from './RouterView.js'
20
+ import Sprite from './Sprite.js'
21
+ import FPScounter from './FPScounter.js'
22
+
23
+ export default () => ({
24
+ Circle: Circle(),
25
+ RouterView: RouterView(),
26
+ Sprite: Sprite(),
27
+ FPScounter: FPScounter(),
28
+ })
package/src/constants.js CHANGED
@@ -1,21 +1,21 @@
1
- export const DEFAULT_HOLD_TIMEOUT_MS = 50
2
-
3
- export const SCREEN_RESOLUTIONS = {
4
- hd: 0.66666667,
5
- '720p': 0.66666667,
6
- 720: 0.66666667,
7
- fhd: 1,
8
- fullhd: 1,
9
- '1080p': 1,
10
- 1080: 1,
11
- '4k': 2,
12
- '2160p': 2,
13
- 2160: 2,
14
- }
15
-
16
- export const RENDER_QUALITIES = {
17
- low: 0.66666667,
18
- medium: 0.85,
19
- high: 1,
20
- retina: 2,
21
- }
1
+ export const DEFAULT_HOLD_TIMEOUT_MS = 50
2
+
3
+ export const SCREEN_RESOLUTIONS = {
4
+ hd: 0.66666667,
5
+ '720p': 0.66666667,
6
+ 720: 0.66666667,
7
+ fhd: 1,
8
+ fullhd: 1,
9
+ '1080p': 1,
10
+ 1080: 1,
11
+ '4k': 2,
12
+ '2160p': 2,
13
+ 2160: 2,
14
+ }
15
+
16
+ export const RENDER_QUALITIES = {
17
+ low: 0.66666667,
18
+ medium: 0.85,
19
+ high: 1,
20
+ retina: 2,
21
+ }
package/src/engine.js CHANGED
@@ -1 +1 @@
1
- export { L3 as default } from './engines/index.js'
1
+ export { L3 as default } from './engines/index.js'