embedded-react 0.21.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 (99) hide show
  1. package/README.md +2 -2
  2. package/aot/compile.mjs +1 -1
  3. package/aot/compiler/alerts.mjs +604 -0
  4. package/aot/compiler/check.mjs +1 -1
  5. package/aot/compiler/collect.mjs +1 -1
  6. package/aot/compiler/elements/button.mjs +3 -3
  7. package/aot/compiler/elements/image-background.mjs +1 -1
  8. package/aot/compiler/elements/props.mjs +10 -6
  9. package/aot/compiler/elements/section-list.mjs +1 -1
  10. package/aot/compiler/expressions.mjs +29 -2
  11. package/aot/compiler/handlers.mjs +73 -16
  12. package/aot/compiler/keyboard-dismiss.mjs +99 -0
  13. package/aot/compiler/keyboard.mjs +1 -1
  14. package/aot/compiler/lower.mjs +12 -0
  15. package/aot/compiler/nodes.mjs +17 -9
  16. package/aot/compiler/out.mjs +4 -0
  17. package/aot/compiler/package/codegen.mjs +36 -2
  18. package/aot/compiler/package/format.mjs +5 -3
  19. package/aot/compiler/package/lower.mjs +53 -19
  20. package/aot/compiler/scroll-to.mjs +112 -0
  21. package/aot/compiler/style-text.mjs +2 -2
  22. package/aot/compiler/svg.mjs +6 -3
  23. package/aot/compiler/updaters.mjs +1 -0
  24. package/aot/style-map.mjs +44 -1
  25. package/assets/bake-font.mjs +187 -244
  26. package/assets/bake-image.mjs +47 -71
  27. package/assets/bake-svg.mjs +465 -533
  28. package/assets/build-builtin-font.mjs +14 -27
  29. package/assets/emit-c.mjs +124 -204
  30. package/assets/emit-container.mjs +129 -197
  31. package/assets/emit-pack.mjs +92 -136
  32. package/assets/font-config.mjs +19 -27
  33. package/assets/font-sizes.mjs +432 -507
  34. package/assets/glyph-coverage.mjs +170 -214
  35. package/assets/index.mjs +52 -97
  36. package/assets/rasterize.mjs +173 -194
  37. package/assets/svg-loader.mjs +42 -48
  38. package/build.mjs +84 -101
  39. package/cli.mjs +482 -621
  40. package/compile-bin.mjs +24 -36
  41. package/flash.mjs +297 -401
  42. package/hotreload/dev-device.mjs +229 -270
  43. package/hotreload/pack-app.mjs +118 -159
  44. package/hotreload/pack-split.mjs +144 -200
  45. package/hotreload/package-transfer.mjs +128 -131
  46. package/hotreload/protocol.mjs +118 -118
  47. package/hotreload/uploader.mjs +132 -159
  48. package/hotreload/watch-tree.mjs +56 -65
  49. package/pack-container.mjs +93 -123
  50. package/package.json +19 -16
  51. package/persist-transform.mjs +89 -105
  52. package/qjsc-wasm.mjs +47 -72
  53. package/sim/embedded-react.wasm +0 -0
  54. package/sim/index.html +1 -1
  55. package/sim-server.mjs +260 -354
  56. package/src/embedded-react/Alert.mjs +112 -0
  57. package/src/embedded-react/Animated.mjs +412 -0
  58. package/src/embedded-react/{AppRegistry.js → AppRegistry.mjs} +26 -25
  59. package/src/embedded-react/{Button.js → Button.mjs} +29 -53
  60. package/src/embedded-react/{Dimensions.js → Dimensions.mjs} +12 -17
  61. package/src/embedded-react/Easing.mjs +34 -0
  62. package/src/embedded-react/{FlatList.js → FlatList.mjs} +25 -42
  63. package/src/embedded-react/{ImageBackground.js → ImageBackground.mjs} +11 -22
  64. package/src/embedded-react/Keyboard.mjs +82 -0
  65. package/src/embedded-react/{LayoutAnimation.js → LayoutAnimation.mjs} +17 -28
  66. package/src/embedded-react/PanResponder.mjs +256 -0
  67. package/src/embedded-react/{Platform.js → Platform.mjs} +8 -9
  68. package/src/embedded-react/{Pressable.js → Pressable.mjs} +12 -25
  69. package/src/embedded-react/SectionList.mjs +103 -0
  70. package/src/embedded-react/{StyleSheet.js → StyleSheet.mjs} +16 -20
  71. package/src/embedded-react/{TouchableOpacity.js → TouchableOpacity.mjs} +47 -83
  72. package/src/embedded-react/background-image.mjs +321 -0
  73. package/src/embedded-react/{components.js → components.mjs} +1 -3
  74. package/src/embedded-react/{imperative.js → imperative.mjs} +27 -38
  75. package/src/embedded-react/index.d.ts +155 -2
  76. package/src/embedded-react/index.js +26 -19
  77. package/src/embedded-react/layout-anim-config.mjs +85 -0
  78. package/src/embedded-react/{list-child.js → list-child.mjs} +11 -20
  79. package/src/embedded-react/{named-colors.js → named-colors.mjs} +2 -6
  80. package/src/embedded-react/nativeModule.mjs +371 -0
  81. package/src/embedded-react/split-style.mjs +57 -0
  82. package/src/embedded-react/svg-ops.mjs +1075 -0
  83. package/src/embedded-react/{useHostValue.js → useHostValue.mjs} +2 -4
  84. package/src/embedded-react/{usePersistentState.js → usePersistentState.mjs} +34 -38
  85. package/src/embedded-react/{warn-props.js → warn-props.mjs} +32 -39
  86. package/src/host-config.mjs +512 -0
  87. package/src/{native-ui.js → native-ui.mjs} +1 -8
  88. package/src/props.mjs +341 -0
  89. package/src/{renderer.js → renderer.mjs} +30 -44
  90. package/src/embedded-react/Animated.js +0 -440
  91. package/src/embedded-react/Easing.js +0 -39
  92. package/src/embedded-react/PanResponder.js +0 -330
  93. package/src/embedded-react/SectionList.js +0 -146
  94. package/src/embedded-react/layout-anim-config.js +0 -101
  95. package/src/embedded-react/nativeModule.js +0 -462
  96. package/src/embedded-react/split-style.js +0 -58
  97. package/src/embedded-react/svg-ops.js +0 -1295
  98. package/src/host-config.js +0 -548
  99. 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
  }