@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
package/src/lib/symbols.js CHANGED
@@ -1,108 +1,108 @@
1
- /**
2
- * Symbol registry for internal framework properties and generated code.
3
- *
4
- * @typedef {Object} BlitsSymbols
5
- * @property {symbol} currentView
6
- * @property {symbol} cursorTagStart
7
- * @property {symbol} computedKeys
8
- * @property {symbol} destroy
9
- * @property {symbol} getChildren
10
- * @property {symbol} holder
11
- * @property {symbol} id
12
- * @property {symbol} identifier
13
- * @property {symbol} index
14
- * @property {symbol} init
15
- * @property {symbol} inputEvents
16
- * @property {symbol} intervals
17
- * @property {symbol} launched
18
- * @property {symbol} level
19
- * @property {symbol} methodKeys
20
- * @property {symbol} originalState
21
- * @property {symbol} propKeys
22
- * @property {symbol} raw
23
- * @property {symbol} ready
24
- * @property {symbol} renderer
25
- * @property {symbol} routes
26
- * @property {symbol} routerHooks
27
- * @property {symbol} settings
28
- * @property {symbol} state
29
- * @property {symbol} stateKeys
30
- * @property {symbol} textnode
31
- * @property {symbol} timeouts
32
- * @property {symbol} type
33
- * @property {symbol} watchers
34
- * @property {symbol} watchKeys
35
- * @property {symbol} wrapper
36
- * @property {symbol} children
37
- * @property {symbol} components
38
- * @property {symbol} config
39
- * @property {symbol} isSlot
40
- * @property {symbol} props
41
- * @property {symbol} slots
42
- * @property {symbol} componentType
43
- * @property {symbol} isComponent
44
- * @property {symbol} effects
45
- * @property {symbol} removeGlobalEffects
46
- */
47
-
48
- /**
49
- * Internal symbol registry for Blits framework and generated code.
50
- *
51
- * @type {BlitsSymbols}
52
- */
53
- export default {
54
- currentView: Symbol('currentView'),
55
- cursorTagStart: Symbol('cursorTagStart'),
56
- computedKeys: Symbol('computedKeys'),
57
- destroy: Symbol('destroy'),
58
- getChildren: Symbol('getChildren'),
59
- holder: Symbol('holder'),
60
- id: Symbol('id'),
61
- identifier: Symbol('identifier'),
62
- index: Symbol('index'),
63
- init: Symbol('init'),
64
- inputEvents: Symbol('inputEvents'),
65
- intervals: Symbol('intervals'),
66
- launched: Symbol('launched'),
67
- level: Symbol('level'),
68
- methodKeys: Symbol('methodKeys'),
69
- originalState: Symbol('originalState'),
70
- propKeys: Symbol('propKeys'),
71
- raw: Symbol('raw'),
72
- ready: Symbol('ready'),
73
- renderer: Symbol('renderer'),
74
- routes: Symbol('routes'),
75
- routerHooks: Symbol('routerHooks'),
76
- settings: Symbol('settings'),
77
- state: Symbol('state'),
78
- stateKeys: Symbol('stateKeys'),
79
- textnode: Symbol('textnode'),
80
- timeouts: Symbol('timeouts'),
81
- type: Symbol('type'),
82
- watchers: Symbol('watchers'),
83
- watchKeys: Symbol('watchKeys'),
84
- wrapper: Symbol('wrapper'),
85
-
86
- /* Utilizing the global Symbol registry for the following purposes */
87
-
88
- // Symbol 'children' utilized within generated code
89
- children: Symbol.for('children'),
90
- // Symbol 'components' utilized within generated code
91
- components: Symbol.for('components'),
92
- // Symbol 'config' utilized within generated code
93
- config: Symbol.for('config'),
94
- // Symbol 'isSlot' utilized within generated code
95
- isSlot: Symbol.for('isSlot'),
96
- // Symbol 'props' utilized within generated code
97
- props: Symbol.for('props'),
98
- // Symbol 'slots' utilized within generated code
99
- slots: Symbol.for('slots'),
100
- // Symbol 'componentType' utilized within generated code
101
- componentType: Symbol.for('componentType'),
102
- // Symbol 'isComponent' utilized within generated code
103
- isComponent: Symbol.for('isComponent'),
104
- // Symbol 'effects' utilized within generated code
105
- effects: Symbol.for('effects'),
106
- // Symbol 'removeGlobalEffects' utilized within generated code
107
- removeGlobalEffects: Symbol.for('removeGlobalEffects'),
108
- }
1
+ /**
2
+ * Symbol registry for internal framework properties and generated code.
3
+ *
4
+ * @typedef {Object} BlitsSymbols
5
+ * @property {symbol} currentView
6
+ * @property {symbol} cursorTagStart
7
+ * @property {symbol} computedKeys
8
+ * @property {symbol} destroy
9
+ * @property {symbol} getChildren
10
+ * @property {symbol} holder
11
+ * @property {symbol} id
12
+ * @property {symbol} identifier
13
+ * @property {symbol} index
14
+ * @property {symbol} init
15
+ * @property {symbol} inputEvents
16
+ * @property {symbol} intervals
17
+ * @property {symbol} launched
18
+ * @property {symbol} level
19
+ * @property {symbol} methodKeys
20
+ * @property {symbol} originalState
21
+ * @property {symbol} propKeys
22
+ * @property {symbol} raw
23
+ * @property {symbol} ready
24
+ * @property {symbol} renderer
25
+ * @property {symbol} routes
26
+ * @property {symbol} routerHooks
27
+ * @property {symbol} settings
28
+ * @property {symbol} state
29
+ * @property {symbol} stateKeys
30
+ * @property {symbol} textnode
31
+ * @property {symbol} timeouts
32
+ * @property {symbol} type
33
+ * @property {symbol} watchers
34
+ * @property {symbol} watchKeys
35
+ * @property {symbol} wrapper
36
+ * @property {symbol} children
37
+ * @property {symbol} components
38
+ * @property {symbol} config
39
+ * @property {symbol} isSlot
40
+ * @property {symbol} props
41
+ * @property {symbol} slots
42
+ * @property {symbol} componentType
43
+ * @property {symbol} isComponent
44
+ * @property {symbol} effects
45
+ * @property {symbol} removeGlobalEffects
46
+ */
47
+
48
+ /**
49
+ * Internal symbol registry for Blits framework and generated code.
50
+ *
51
+ * @type {BlitsSymbols}
52
+ */
53
+ export default {
54
+ currentView: Symbol('currentView'),
55
+ cursorTagStart: Symbol('cursorTagStart'),
56
+ computedKeys: Symbol('computedKeys'),
57
+ destroy: Symbol('destroy'),
58
+ getChildren: Symbol('getChildren'),
59
+ holder: Symbol('holder'),
60
+ id: Symbol('id'),
61
+ identifier: Symbol('identifier'),
62
+ index: Symbol('index'),
63
+ init: Symbol('init'),
64
+ inputEvents: Symbol('inputEvents'),
65
+ intervals: Symbol('intervals'),
66
+ launched: Symbol('launched'),
67
+ level: Symbol('level'),
68
+ methodKeys: Symbol('methodKeys'),
69
+ originalState: Symbol('originalState'),
70
+ propKeys: Symbol('propKeys'),
71
+ raw: Symbol('raw'),
72
+ ready: Symbol('ready'),
73
+ renderer: Symbol('renderer'),
74
+ routes: Symbol('routes'),
75
+ routerHooks: Symbol('routerHooks'),
76
+ settings: Symbol('settings'),
77
+ state: Symbol('state'),
78
+ stateKeys: Symbol('stateKeys'),
79
+ textnode: Symbol('textnode'),
80
+ timeouts: Symbol('timeouts'),
81
+ type: Symbol('type'),
82
+ watchers: Symbol('watchers'),
83
+ watchKeys: Symbol('watchKeys'),
84
+ wrapper: Symbol('wrapper'),
85
+
86
+ /* Utilizing the global Symbol registry for the following purposes */
87
+
88
+ // Symbol 'children' utilized within generated code
89
+ children: Symbol.for('children'),
90
+ // Symbol 'components' utilized within generated code
91
+ components: Symbol.for('components'),
92
+ // Symbol 'config' utilized within generated code
93
+ config: Symbol.for('config'),
94
+ // Symbol 'isSlot' utilized within generated code
95
+ isSlot: Symbol.for('isSlot'),
96
+ // Symbol 'props' utilized within generated code
97
+ props: Symbol.for('props'),
98
+ // Symbol 'slots' utilized within generated code
99
+ slots: Symbol.for('slots'),
100
+ // Symbol 'componentType' utilized within generated code
101
+ componentType: Symbol.for('componentType'),
102
+ // Symbol 'isComponent' utilized within generated code
103
+ isComponent: Symbol.for('isComponent'),
104
+ // Symbol 'effects' utilized within generated code
105
+ effects: Symbol.for('effects'),
106
+ // Symbol 'removeGlobalEffects' utilized within generated code
107
+ removeGlobalEffects: Symbol.for('removeGlobalEffects'),
108
+ }