@lightningjs/blits 1.30.2 → 1.31.0

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 (152) hide show
  1. package/CHANGELOG.md +1029 -1019
  2. package/LICENSE +202 -202
  3. package/NOTICE +12 -12
  4. package/README.md +33 -33
  5. package/bin/index.js +8 -8
  6. package/blits.d.ts +6 -6
  7. package/index.d.ts +1099 -1099
  8. package/index.js +28 -28
  9. package/package.json +57 -56
  10. package/public/assets/fps_sprite.base64.js +1 -1
  11. package/scripts/postpublish.js +59 -59
  12. package/scripts/prepublishOnly.js +84 -84
  13. package/scripts/prepush.js +78 -78
  14. package/src/announcer/announcer.js +162 -162
  15. package/src/announcer/speechSynthesis.js +107 -107
  16. package/src/application.js +100 -100
  17. package/src/component/base/announcer.js +27 -27
  18. package/src/component/base/events.js +69 -69
  19. package/src/component/base/index.js +33 -33
  20. package/src/component/base/methods.js +244 -244
  21. package/src/component/base/router.js +41 -41
  22. package/src/component/base/timeouts_intervals.js +99 -99
  23. package/src/component/base/utils.js +72 -72
  24. package/src/component/setup/computed.js +48 -48
  25. package/src/component/setup/index.js +62 -62
  26. package/src/component/setup/input.js +30 -30
  27. package/src/component/setup/methods.js +37 -37
  28. package/src/component/setup/props.js +62 -62
  29. package/src/component/setup/routes.js +42 -42
  30. package/src/component/setup/state.js +59 -59
  31. package/src/component/setup/watch.js +35 -35
  32. package/src/component.js +437 -437
  33. package/src/components/Circle.js +73 -73
  34. package/src/components/FPScounter.js +1510 -1510
  35. package/src/components/RouterView.js +81 -81
  36. package/src/components/Sprite.js +94 -94
  37. package/src/components/index.js +28 -28
  38. package/src/constants.js +21 -21
  39. package/src/engine.js +1 -1
  40. package/src/engines/L3/element.js +744 -744
  41. package/src/engines/L3/fontLoader.js +38 -38
  42. package/src/engines/L3/index.js +7 -7
  43. package/src/engines/L3/launch.js +123 -123
  44. package/src/engines/L3/shaderLoader.js +12 -12
  45. package/src/engines/index.js +1 -1
  46. package/src/focus.js +90 -90
  47. package/src/helpers/deepEqualArray.js +50 -50
  48. package/src/helpers/fetchJson.js +34 -34
  49. package/src/helpers/sequence.js +26 -26
  50. package/src/launch.js +123 -123
  51. package/src/lib/blitsfileconverter/blitsfileconverter.js +52 -52
  52. package/src/lib/codegenerator/generator.js +788 -788
  53. package/src/lib/colors/colors.js +92 -92
  54. package/src/lib/colors/htmlColors.js +168 -168
  55. package/src/lib/componentId.js +49 -49
  56. package/src/lib/eventListeners.js +123 -123
  57. package/src/lib/hooks.js +59 -59
  58. package/src/lib/lifecycle.js +85 -85
  59. package/src/lib/log.js +117 -117
  60. package/src/lib/precompiler/precompiler.js +73 -73
  61. package/src/lib/reactivity/effect.js +93 -93
  62. package/src/lib/reactivity/reactive.js +208 -208
  63. package/src/lib/reactivityguard/computedprops.js +218 -218
  64. package/src/lib/symbols.js +108 -108
  65. package/src/lib/templateparser/parser.js +386 -386
  66. package/src/lib/utils.js +27 -27
  67. package/src/plugin.js +27 -27
  68. package/src/plugins/appstate.js +26 -26
  69. package/src/plugins/index.js +20 -20
  70. package/src/plugins/language.js +152 -152
  71. package/src/plugins/log.js +25 -25
  72. package/src/plugins/theme.js +94 -94
  73. package/src/router/router.js +516 -514
  74. package/src/router/transitions/fadeIn.js +27 -27
  75. package/src/router/transitions/fadeInOut.js +33 -33
  76. package/src/router/transitions/index.js +21 -21
  77. package/src/router/transitions/slideIn.js +28 -28
  78. package/src/router/transitions/slideInOut.js +33 -33
  79. package/src/settings.js +40 -40
  80. package/vite/blitsFileConverter.js +67 -67
  81. package/vite/index.js +28 -28
  82. package/vite/msdfGenerator.js +269 -269
  83. package/vite/preCompiler.js +47 -42
  84. package/vite/reactivityGuard.js +45 -45
  85. package/vscode/data/template-attributes.json +589 -589
  86. package/.editorconfig +0 -7
  87. package/.eslintignore +0 -1
  88. package/.eslintrc.cjs +0 -65
  89. package/.github/workflows/comment-lint-results.yml +0 -125
  90. package/.github/workflows/comment-test-results.yml +0 -109
  91. package/.github/workflows/deploy-docs.yml +0 -27
  92. package/.github/workflows/run-blits-tests.yml +0 -142
  93. package/.github/workflows/run-lint.yml +0 -128
  94. package/.husky/pre-commit +0 -1
  95. package/.husky/pre-push +0 -1
  96. package/.vscode/extensions.json +0 -7
  97. package/.vscode/settings.json +0 -9
  98. package/COPYING +0 -1
  99. package/banner.png +0 -0
  100. package/docs/.nojekyll +0 -0
  101. package/docs/README.md +0 -19
  102. package/docs/_sidebar.md +0 -37
  103. package/docs/built-in/directives.md +0 -50
  104. package/docs/built-in/for-loop.md +0 -204
  105. package/docs/built-in/layout.md +0 -168
  106. package/docs/components/component_state.md +0 -90
  107. package/docs/components/computed_properties.md +0 -45
  108. package/docs/components/lifecycle_events.md +0 -42
  109. package/docs/components/methods.md +0 -45
  110. package/docs/components/props.md +0 -56
  111. package/docs/components/user_input.md +0 -186
  112. package/docs/components/utility_methods.md +0 -320
  113. package/docs/components/watchers.md +0 -34
  114. package/docs/essentials/application_root.md +0 -19
  115. package/docs/essentials/components.md +0 -68
  116. package/docs/essentials/displaying_images.md +0 -67
  117. package/docs/essentials/displaying_text.md +0 -135
  118. package/docs/essentials/element_attributes.md +0 -195
  119. package/docs/essentials/settings.md +0 -117
  120. package/docs/essentials/template_syntax.md +0 -83
  121. package/docs/getting_started/file_structure.md +0 -58
  122. package/docs/getting_started/getting_started.md +0 -45
  123. package/docs/getting_started/intro.md +0 -20
  124. package/docs/index.html +0 -47
  125. package/docs/performance/lazy-loading.md +0 -161
  126. package/docs/plugins/global_app_state.md +0 -98
  127. package/docs/plugins/language.md +0 -172
  128. package/docs/plugins/text-to-speech-announcer.md +0 -120
  129. package/docs/plugins/theme.md +0 -176
  130. package/docs/router/basics.md +0 -175
  131. package/docs/router/hooks.md +0 -70
  132. package/docs/router/transitions.md +0 -146
  133. package/docs/sidebar.json +0 -171
  134. package/docs/transitions_animations/transitions.md +0 -150
  135. package/jsconfig.json +0 -12
  136. package/src/component/setup/props.test.js +0 -238
  137. package/src/component.test.js +0 -388
  138. package/src/components/Circle.orig.js +0 -31
  139. package/src/components/FPScounter.orig.js +0 -121
  140. package/src/components/RouterView.orig.js +0 -54
  141. package/src/components/Sprite.orig.js +0 -58
  142. package/src/components/index.orig.js +0 -28
  143. package/src/engines/L3/element.test.js +0 -579
  144. package/src/helpers/deepEqualArray.test.js +0 -127
  145. package/src/lib/codegenerator/generator.test.js +0 -3801
  146. package/src/lib/colors/colors.test.js +0 -290
  147. package/src/lib/componentId.test.js +0 -84
  148. package/src/lib/eventListeners.test.js +0 -236
  149. package/src/lib/reactivity/effect.test.js +0 -35
  150. package/src/lib/reactivity/reactive.test.js +0 -27
  151. package/src/lib/templateparser/parser.test.js +0 -1411
  152. package/src/router/router.test.js +0 -473
@@ -1,81 +1,81 @@
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
- import Router from '../router/router.js'
20
-
21
- let hashchangeHandler = null
22
-
23
- export default () =>
24
- Component('RouterView', {
25
- /* eslint-disable no-unused-vars */
26
- code: {
27
- render: function anonymous(parent, component, context, components, effect, getRaw, Log) {
28
- const elms = []
29
- let componentType
30
- const rootComponent = component
31
- let propData
32
- let slotComponent
33
- let inSlot = false
34
- let slotChildCounter = 0
35
- const elementConfig0 = {}
36
-
37
- elms[0] = this.element(
38
- { parent: parent || 'root' },
39
- inSlot === true ? slotComponent : component
40
- )
41
-
42
- elementConfig0['w'] = parent.node.width * (100 / 100)
43
- elementConfig0['height'] = parent.node.height * (100 / 100)
44
- elms[0].populate(elementConfig0)
45
-
46
- if (inSlot === true) {
47
- slotChildCounter -= 1
48
- }
49
-
50
- return elms
51
- },
52
- effects: [],
53
- context: {},
54
- },
55
- state() {
56
- return {
57
- activeView: null,
58
- }
59
- },
60
- hooks: {
61
- ready() {
62
- hashchangeHandler = () => Router.navigate.apply(this)
63
- Router.navigate.apply(this)
64
- window.addEventListener('hashchange', hashchangeHandler)
65
- },
66
- destroy() {
67
- window.removeEventListener('hashchange', hashchangeHandler, false)
68
- },
69
- focus() {
70
- this.activeView && this.activeView.$focus()
71
- },
72
- },
73
- input: {
74
- back(e) {
75
- const navigating = Router.back.call(this)
76
- if (navigating === false) {
77
- this.parent.$focus(e)
78
- }
79
- },
80
- },
81
- })
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
+ import Router from '../router/router.js'
20
+
21
+ let hashchangeHandler = null
22
+
23
+ export default () =>
24
+ Component('RouterView', {
25
+ /* eslint-disable no-unused-vars */
26
+ code: {
27
+ render: function anonymous(parent, component, context, components, effect, getRaw, Log) {
28
+ const elms = []
29
+ let componentType
30
+ const rootComponent = component
31
+ let propData
32
+ let slotComponent
33
+ let inSlot = false
34
+ let slotChildCounter = 0
35
+ const elementConfig0 = {}
36
+
37
+ elms[0] = this.element(
38
+ { parent: parent || 'root' },
39
+ inSlot === true ? slotComponent : component
40
+ )
41
+
42
+ elementConfig0['w'] = parent.node.width * (100 / 100)
43
+ elementConfig0['height'] = parent.node.height * (100 / 100)
44
+ elms[0].populate(elementConfig0)
45
+
46
+ if (inSlot === true) {
47
+ slotChildCounter -= 1
48
+ }
49
+
50
+ return elms
51
+ },
52
+ effects: [],
53
+ context: {},
54
+ },
55
+ state() {
56
+ return {
57
+ activeView: null,
58
+ }
59
+ },
60
+ hooks: {
61
+ ready() {
62
+ hashchangeHandler = () => Router.navigate.apply(this)
63
+ Router.navigate.apply(this)
64
+ window.addEventListener('hashchange', hashchangeHandler)
65
+ },
66
+ destroy() {
67
+ window.removeEventListener('hashchange', hashchangeHandler, false)
68
+ },
69
+ focus() {
70
+ this.activeView && this.activeView.$focus()
71
+ },
72
+ },
73
+ input: {
74
+ back(e) {
75
+ const navigating = Router.back.call(this)
76
+ if (navigating === false) {
77
+ this.parent.$focus(e)
78
+ }
79
+ },
80
+ },
81
+ })
@@ -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,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'