embedded-react 0.20.0 → 0.22.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 (140) hide show
  1. package/NOTICE +5 -0
  2. package/README.md +3 -2
  3. package/aot/app-file-loader.mjs +116 -0
  4. package/aot/compile.mjs +17 -47
  5. package/aot/compiler/alerts.mjs +604 -0
  6. package/aot/compiler/animations.mjs +299 -57
  7. package/aot/compiler/boot.mjs +27 -2
  8. package/aot/compiler/check.mjs +62 -10
  9. package/aot/compiler/collect.mjs +517 -137
  10. package/aot/compiler/contexts.mjs +391 -0
  11. package/aot/compiler/control-flow.mjs +276 -117
  12. package/aot/compiler/custom-hooks.mjs +686 -0
  13. package/aot/compiler/elements/button.mjs +182 -0
  14. package/aot/compiler/elements/image-background.mjs +76 -0
  15. package/aot/compiler/elements/image.mjs +2 -1
  16. package/aot/compiler/elements/props.mjs +47 -8
  17. package/aot/compiler/elements/rewrite.mjs +118 -0
  18. package/aot/compiler/elements/section-list.mjs +370 -0
  19. package/aot/compiler/expressions.mjs +1378 -97
  20. package/aot/compiler/handlers.mjs +1807 -354
  21. package/aot/compiler/helper-values.mjs +312 -0
  22. package/aot/compiler/ir/nodes.mjs +40 -1
  23. package/aot/compiler/ir/reads.mjs +206 -5
  24. package/aot/compiler/ir/text.mjs +5 -1
  25. package/aot/compiler/ir/types.mjs +12 -0
  26. package/aot/compiler/kept-states.mjs +177 -0
  27. package/aot/compiler/keyboard-dismiss.mjs +99 -0
  28. package/aot/compiler/keyboard.mjs +1 -1
  29. package/aot/compiler/list-items.mjs +226 -0
  30. package/aot/compiler/list-order.mjs +586 -0
  31. package/aot/compiler/list-split.mjs +259 -0
  32. package/aot/compiler/loops.mjs +582 -0
  33. package/aot/compiler/lower.mjs +203 -53
  34. package/aot/compiler/native-files.mjs +439 -0
  35. package/aot/compiler/native-header.mjs +335 -0
  36. package/aot/compiler/native-modules.mjs +1173 -0
  37. package/aot/compiler/nodes.mjs +45 -31
  38. package/aot/compiler/options.mjs +3 -2
  39. package/aot/compiler/out.mjs +18 -1
  40. package/aot/compiler/package/animations.mjs +133 -23
  41. package/aot/compiler/package/assemble.mjs +2 -4
  42. package/aot/compiler/package/bytecode.mjs +37 -8
  43. package/aot/compiler/package/checks.mjs +4 -0
  44. package/aot/compiler/package/codegen.mjs +906 -33
  45. package/aot/compiler/package/enums.mjs +10 -0
  46. package/aot/compiler/package/format.mjs +16 -3
  47. package/aot/compiler/package/lower.mjs +707 -176
  48. package/aot/compiler/package/string-caps.mjs +515 -0
  49. package/aot/compiler/package/tables.mjs +24 -0
  50. package/aot/compiler/package/writer.mjs +22 -0
  51. package/aot/compiler/parse.mjs +3 -1
  52. package/aot/compiler/record-shapes.mjs +246 -0
  53. package/aot/compiler/records.mjs +654 -0
  54. package/aot/compiler/reducers.mjs +272 -0
  55. package/aot/compiler/scroll-to.mjs +112 -0
  56. package/aot/compiler/static-eval.mjs +315 -7
  57. package/aot/compiler/style-text.mjs +20 -5
  58. package/aot/compiler/svg.mjs +13 -7
  59. package/aot/compiler/switch-cases.mjs +198 -0
  60. package/aot/compiler/tagged-records.mjs +450 -0
  61. package/aot/compiler/typing.mjs +307 -0
  62. package/aot/compiler/updaters.mjs +321 -0
  63. package/aot/compiler/window-dimensions.mjs +94 -0
  64. package/aot/compiler/worked-values.mjs +319 -0
  65. package/aot/demo-file.mjs +30 -0
  66. package/aot/style-map.mjs +94 -3
  67. package/assets/bake-font.mjs +187 -244
  68. package/assets/bake-image.mjs +47 -71
  69. package/assets/bake-svg.mjs +465 -533
  70. package/assets/build-builtin-font.mjs +14 -27
  71. package/assets/emit-c.mjs +124 -204
  72. package/assets/emit-container.mjs +129 -197
  73. package/assets/emit-pack.mjs +92 -136
  74. package/assets/font-config.mjs +19 -27
  75. package/assets/font-sizes.mjs +432 -507
  76. package/assets/glyph-coverage.mjs +170 -214
  77. package/assets/index.mjs +52 -97
  78. package/assets/rasterize.mjs +173 -194
  79. package/assets/svg-loader.mjs +42 -48
  80. package/build.mjs +85 -94
  81. package/cli.mjs +490 -586
  82. package/compile-bin.mjs +24 -36
  83. package/flash.mjs +297 -401
  84. package/hotreload/dev-device.mjs +229 -270
  85. package/hotreload/pack-app.mjs +118 -159
  86. package/hotreload/pack-split.mjs +146 -213
  87. package/hotreload/package-transfer.mjs +128 -131
  88. package/hotreload/protocol.mjs +118 -118
  89. package/hotreload/uploader.mjs +132 -159
  90. package/hotreload/watch-tree.mjs +56 -65
  91. package/pack-container.mjs +94 -116
  92. package/package.json +19 -16
  93. package/persist-transform.mjs +89 -105
  94. package/qjsc-wasm.mjs +47 -72
  95. package/sim/embedded-react.wasm +0 -0
  96. package/sim/index.html +1 -1
  97. package/sim-server.mjs +260 -354
  98. package/src/embedded-react/Alert.mjs +112 -0
  99. package/src/embedded-react/Animated.mjs +412 -0
  100. package/src/embedded-react/{AppRegistry.js → AppRegistry.mjs} +26 -25
  101. package/src/embedded-react/{Button.js → Button.mjs} +29 -53
  102. package/src/embedded-react/Dimensions.mjs +32 -0
  103. package/src/embedded-react/Easing.mjs +34 -0
  104. package/src/embedded-react/{FlatList.js → FlatList.mjs} +25 -42
  105. package/src/embedded-react/{ImageBackground.js → ImageBackground.mjs} +11 -22
  106. package/src/embedded-react/Keyboard.mjs +82 -0
  107. package/src/embedded-react/{LayoutAnimation.js → LayoutAnimation.mjs} +17 -28
  108. package/src/embedded-react/PanResponder.mjs +256 -0
  109. package/src/embedded-react/{Platform.js → Platform.mjs} +8 -9
  110. package/src/embedded-react/{Pressable.js → Pressable.mjs} +12 -25
  111. package/src/embedded-react/SectionList.mjs +103 -0
  112. package/src/embedded-react/{StyleSheet.js → StyleSheet.mjs} +16 -20
  113. package/src/embedded-react/{TouchableOpacity.js → TouchableOpacity.mjs} +47 -83
  114. package/src/embedded-react/background-image.mjs +321 -0
  115. package/src/embedded-react/{components.js → components.mjs} +1 -3
  116. package/src/embedded-react/{imperative.js → imperative.mjs} +27 -38
  117. package/src/embedded-react/index.d.ts +238 -5
  118. package/src/embedded-react/index.js +26 -17
  119. package/src/embedded-react/layout-anim-config.mjs +85 -0
  120. package/src/embedded-react/{list-child.js → list-child.mjs} +11 -20
  121. package/src/embedded-react/{named-colors.js → named-colors.mjs} +2 -6
  122. package/src/embedded-react/nativeModule.mjs +371 -0
  123. package/src/embedded-react/split-style.mjs +57 -0
  124. package/src/embedded-react/svg-ops.mjs +1075 -0
  125. package/src/embedded-react/{useHostValue.js → useHostValue.mjs} +2 -4
  126. package/src/embedded-react/{usePersistentState.js → usePersistentState.mjs} +34 -38
  127. package/src/embedded-react/{warn-props.js → warn-props.mjs} +32 -39
  128. package/src/host-config.mjs +512 -0
  129. package/src/{native-ui.js → native-ui.mjs} +1 -8
  130. package/src/props.mjs +341 -0
  131. package/src/{renderer.js → renderer.mjs} +30 -44
  132. package/src/embedded-react/Animated.js +0 -440
  133. package/src/embedded-react/Easing.js +0 -39
  134. package/src/embedded-react/PanResponder.js +0 -330
  135. package/src/embedded-react/SectionList.js +0 -148
  136. package/src/embedded-react/layout-anim-config.js +0 -101
  137. package/src/embedded-react/split-style.js +0 -58
  138. package/src/embedded-react/svg-ops.js +0 -1295
  139. package/src/host-config.js +0 -548
  140. package/src/props.js +0 -306
@@ -13,7 +13,6 @@
13
13
  * See the License for the specific language governing permissions and
14
14
  * limitations under the License.
15
15
  */
16
-
17
16
  // useHostValue — a numeric value fed by the C HOST at runtime, not by the app.
18
17
  //
19
18
  // Flow B (AOT): the compiler recognizes `const steps = useHostValue(0)` and lowers it to an ordinary state
@@ -24,8 +23,7 @@
24
23
  // Flow A / simulator: there is no host, so this simply returns the initial value (the simulator has no
25
24
  // IMU to drive it anyway).
26
25
  //
27
- // @param {number} initial Initial value, used until the host writes one.
28
- // @returns {number} the current value.
26
+ // `initial` is the value until the host writes one.
29
27
  export function useHostValue(initial) {
30
- return initial;
28
+ return initial;
31
29
  }
@@ -13,57 +13,53 @@
13
13
  * See the License for the specific language governing permissions and
14
14
  * limitations under the License.
15
15
  */
16
-
17
16
  // usePersistentState — a useState that survives the simulator's hot reload (see
18
- // tools/simulator/README.md). The simulator's build transform (persist-transform.mjs) rewrites the app's plain `useState`
17
+ // tools/simulator/README.md). The simulator's build transform (persist-transform.mts) rewrites the app's plain `useState`
19
18
  // into this helper, so persistence is transparent — you normally never call this directly; it's also
20
19
  // exported for explicit use. Outside the simulator (e.g., on a device, where the host doesn't install
21
20
  // `__erPersist`) it is exactly useState, so the same app code runs everywhere.
22
21
  //
23
22
  // Values must be JSON-serializable (numbers, strings, booleans, plain objects/arrays). The simulator
24
23
  // resets the persisted state when you press R (manual reload) or restart it.
25
- import {useState, useCallback} from 'react';
26
-
24
+ import { useState, useCallback } from 'react';
27
25
  /**
28
26
  * Drop-in useState that persists across simulator reloads, keyed by a stable string.
29
27
  *
30
- * @param {string} key Stable identity for this piece of state (unique within the app).
31
- * @param {*|Function} initial Initial value (or a lazy initializer), used when nothing is persisted.
32
- * @returns {[*, Function]} [value, setValue] — same shape as useState.
28
+ * `key` is a stable identity for this piece of state, unique within the app. `initial` is the value, or a
29
+ * lazy initializer, used when nothing is persisted.
33
30
  */
34
31
  export function usePersistentState(key, initial) {
35
- const [value, setValue] = useState(() => {
36
- const store = globalThis.__erPersist;
37
- if (store) {
38
- const stored = store.get(key);
39
- if (stored !== undefined) {
40
- try {
41
- return JSON.parse(stored);
42
- } catch {
43
- /* corrupt/incompatible — fall back to initial */
44
- }
45
- }
46
- }
47
- return typeof initial === 'function' ? initial() : initial;
48
- });
49
-
50
- const setPersistedValue = useCallback(
51
- next => {
52
- setValue(previous => {
53
- const resolved = typeof next === 'function' ? next(previous) : next;
32
+ const [value, setValue] = useState(() => {
54
33
  const store = globalThis.__erPersist;
55
34
  if (store) {
56
- try {
57
- store.set(key, JSON.stringify(resolved));
58
- } catch {
59
- /* unserializable value — skip persistence, keep the in-memory state */
60
- }
35
+ const stored = store.get(key);
36
+ if (stored !== undefined) {
37
+ try {
38
+ return JSON.parse(stored);
39
+ }
40
+ catch {
41
+ /* corrupt/incompatible — fall back to initial */
42
+ }
43
+ }
61
44
  }
62
- return resolved;
63
- });
64
- },
65
- [key],
66
- );
67
-
68
- return [value, setPersistedValue];
45
+ return typeof initial === 'function' ? initial() : initial;
46
+ });
47
+ const setPersistedValue = useCallback((next) => {
48
+ setValue(previous => {
49
+ const resolved = typeof next === 'function'
50
+ ? next(previous)
51
+ : next;
52
+ const store = globalThis.__erPersist;
53
+ if (store) {
54
+ try {
55
+ store.set(key, JSON.stringify(resolved));
56
+ }
57
+ catch {
58
+ /* unserializable value — skip persistence, keep the in-memory state */
59
+ }
60
+ }
61
+ return resolved;
62
+ });
63
+ }, [key]);
64
+ return [value, setPersistedValue];
69
65
  }
@@ -13,7 +13,6 @@
13
13
  * See the License for the specific language governing permissions and
14
14
  * limitations under the License.
15
15
  */
16
-
17
16
  // Shared "you passed a prop this component ignores" warning for the JS-only RN wrappers (Button,
18
17
  // FlatList, ImageBackground, SectionList). Those components exist for API compatibility, so an app
19
18
  // ported from React Native arrives carrying props that mean nothing on a panel — and a prop that is
@@ -22,7 +21,6 @@
22
21
  // Warns ONCE per component and then stops scanning: these render on the Flow A commit path, and a
23
22
  // misconfigured list re-renders on every data change. One line in the device console is a hint; one
24
23
  // line per commit is a flood that pushes everything else out of the scrollback.
25
-
26
24
  /**
27
25
  * RN props that wrap an OS service a bare panel does not have: a screen reader, a focus engine, a test
28
26
  * runner, a click sound. They are real RN props, they cost nothing to carry, and keeping them means a
@@ -34,47 +32,42 @@
34
32
  * about it is the point.
35
33
  */
36
34
  export const RN_PLATFORM_NO_OPS = [
37
- 'accessible',
38
- 'accessibilityLabel',
39
- 'accessibilityHint',
40
- 'accessibilityLanguage',
41
- 'accessibilityRole',
42
- 'accessibilityState',
43
- 'accessibilityActions',
44
- 'onAccessibilityAction',
45
- 'importantForAccessibility',
46
- 'testID',
47
- 'touchSoundDisabled',
48
- 'hasTVPreferredFocus',
49
- 'nextFocusDown',
50
- 'nextFocusForward',
51
- 'nextFocusLeft',
52
- 'nextFocusRight',
53
- 'nextFocusUp',
35
+ 'accessible',
36
+ 'accessibilityLabel',
37
+ 'accessibilityHint',
38
+ 'accessibilityLanguage',
39
+ 'accessibilityRole',
40
+ 'accessibilityState',
41
+ 'accessibilityActions',
42
+ 'onAccessibilityAction',
43
+ 'importantForAccessibility',
44
+ 'testID',
45
+ 'touchSoundDisabled',
46
+ 'hasTVPreferredFocus',
47
+ 'nextFocusDown',
48
+ 'nextFocusForward',
49
+ 'nextFocusLeft',
50
+ 'nextFocusRight',
51
+ 'nextFocusUp',
54
52
  ];
55
-
56
53
  /**
57
54
  * Builds the once-only prop warner for a component.
58
55
  *
59
- * @param {string} component Component name, as it appears in JSX (no angle brackets).
60
- * @param {string[]} supported Props the component honours. Listed in the warning as the way out.
61
- * @param {string} hint Why the rest are ignored / what to reach for instead. Ends the first sentence.
62
- * @param {string[]} [quiet] Props to ignore silently — RN props that wrap an OS service this board
63
- * doesn't have (accessibility, TV focus, test ids). They are portable no-ops, not mistakes.
64
- * @returns {(props: object) => void} Call with the full prop object on every render.
56
+ * `component` is the name as it appears in JSX. `supported` are the props it honours, listed in the
57
+ * warning as the way out. `hint` says why the rest are ignored, and ends the first sentence. `quiet` are
58
+ * props to ignore silently: RN props that wrap an OS service this board doesn't have. Call the result
59
+ * with the full prop object on every render.
65
60
  */
66
61
  export function createPropWarner(component, supported, hint, quiet = []) {
67
- let warned = false;
68
- return props => {
69
- if (warned) return;
70
- const names = Object.keys(props).filter(
71
- name => !supported.includes(name) && !quiet.includes(name),
72
- );
73
- if (names.length === 0) return;
74
- warned = true;
75
- console.warn(
76
- `embedded-react: <${component}> ignores ${names.join(', ')} — ${hint} ` +
77
- `Supported here: ${supported.join(', ')}.`,
78
- );
79
- };
62
+ let warned = false;
63
+ return props => {
64
+ if (warned)
65
+ return;
66
+ const names = Object.keys(props).filter(name => !supported.includes(name) && !quiet.includes(name));
67
+ if (names.length === 0)
68
+ return;
69
+ warned = true;
70
+ console.warn(`embedded-react: <${component}> ignores ${names.join(', ')} — ${hint} ` +
71
+ `Supported here: ${supported.join(', ')}.`);
72
+ };
80
73
  }