embedded-react 0.18.0 → 0.20.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 (117) hide show
  1. package/NOTICE +1 -1
  2. package/README.md +8 -4
  3. package/aot/compile.mjs +178 -58
  4. package/aot/compiler/animations.mjs +290 -281
  5. package/aot/compiler/boot.mjs +70 -33
  6. package/aot/compiler/branch-merge.mjs +4 -3
  7. package/aot/compiler/check.mjs +9 -9
  8. package/aot/compiler/collect.mjs +324 -205
  9. package/aot/compiler/control-flow.mjs +209 -197
  10. package/aot/compiler/diagnostics.mjs +22 -25
  11. package/aot/compiler/elements/activity-indicator.mjs +25 -24
  12. package/aot/compiler/elements/dial.mjs +91 -77
  13. package/aot/compiler/elements/flat-list.mjs +24 -22
  14. package/aot/compiler/elements/image.mjs +51 -50
  15. package/aot/compiler/elements/modal.mjs +31 -30
  16. package/aot/compiler/elements/props.mjs +23 -23
  17. package/aot/compiler/elements/switch.mjs +42 -34
  18. package/aot/compiler/elements/text-input.mjs +34 -32
  19. package/aot/compiler/expressions.mjs +372 -333
  20. package/aot/compiler/handlers.mjs +473 -387
  21. package/aot/compiler/ir/functions.mjs +11 -1
  22. package/aot/compiler/ir/nodes.mjs +4 -4
  23. package/aot/compiler/ir/reads.mjs +19 -19
  24. package/aot/compiler/ir/types.mjs +14 -14
  25. package/aot/compiler/ir/vectors.mjs +5 -1
  26. package/aot/compiler/keyboard.mjs +17 -7
  27. package/aot/compiler/lower.mjs +77 -80
  28. package/aot/compiler/nodes.mjs +169 -152
  29. package/aot/compiler/options.mjs +35 -30
  30. package/aot/compiler/out.mjs +18 -22
  31. package/aot/compiler/package/animations.mjs +669 -0
  32. package/aot/compiler/package/arena.mjs +252 -0
  33. package/aot/compiler/package/assemble.mjs +177 -0
  34. package/aot/compiler/package/bytecode.mjs +286 -0
  35. package/aot/compiler/package/checks.mjs +1022 -0
  36. package/aot/compiler/package/codegen.mjs +1329 -0
  37. package/aot/compiler/package/enums.mjs +138 -0
  38. package/aot/compiler/package/format.mjs +760 -0
  39. package/aot/compiler/package/layouts.mjs +136 -0
  40. package/aot/compiler/package/lower.mjs +1606 -0
  41. package/aot/compiler/package/props.mjs +118 -0
  42. package/aot/compiler/package/tables.mjs +103 -0
  43. package/aot/compiler/package/vectors.mjs +502 -0
  44. package/aot/compiler/package/writer.mjs +664 -0
  45. package/aot/compiler/pan-responder.mjs +69 -61
  46. package/aot/compiler/parse.mjs +21 -21
  47. package/aot/compiler/static-eval.mjs +25 -23
  48. package/aot/compiler/style-text.mjs +161 -172
  49. package/aot/compiler/svg.mjs +477 -251
  50. package/aot/screenshot-smoke.mjs +55 -41
  51. package/aot/style-map.mjs +102 -90
  52. package/assets/bake-font.mjs +123 -77
  53. package/assets/bake-image.mjs +39 -22
  54. package/assets/bake-svg.mjs +361 -262
  55. package/assets/build-builtin-font.mjs +14 -10
  56. package/assets/emit-c.mjs +83 -62
  57. package/assets/emit-container.mjs +124 -38
  58. package/assets/emit-pack.mjs +77 -67
  59. package/assets/font-config.mjs +9 -6
  60. package/assets/font-sizes.mjs +163 -123
  61. package/assets/glyph-coverage.mjs +74 -54
  62. package/assets/index.mjs +31 -9
  63. package/assets/rasterize.mjs +126 -99
  64. package/assets/svg-loader.mjs +8 -8
  65. package/build.mjs +16 -14
  66. package/cli.mjs +359 -172
  67. package/compile-bin.mjs +5 -5
  68. package/flash.mjs +537 -0
  69. package/hotreload/dev-device.mjs +90 -33
  70. package/hotreload/pack-app.mjs +55 -43
  71. package/hotreload/pack-split.mjs +46 -37
  72. package/hotreload/package-transfer.mjs +175 -0
  73. package/hotreload/protocol.mjs +51 -38
  74. package/hotreload/uploader.mjs +38 -27
  75. package/hotreload/watch-tree.mjs +19 -19
  76. package/pack-container.mjs +31 -23
  77. package/package.json +11 -12
  78. package/persist-transform.mjs +34 -28
  79. package/qjsc-wasm.mjs +25 -14
  80. package/sim/embedded-react.cjs +1 -1
  81. package/sim/embedded-react.js +1 -1
  82. package/sim/embedded-react.wasm +0 -0
  83. package/sim/index.html +94 -85
  84. package/sim-server.mjs +101 -82
  85. package/src/embedded-react/Animated.js +24 -24
  86. package/src/embedded-react/Easing.js +1 -1
  87. package/src/embedded-react/FlatList.js +4 -4
  88. package/src/embedded-react/LayoutAnimation.js +8 -5
  89. package/src/embedded-react/PanResponder.js +75 -71
  90. package/src/embedded-react/Pressable.js +2 -8
  91. package/src/embedded-react/SectionList.js +6 -6
  92. package/src/embedded-react/StyleSheet.js +4 -3
  93. package/src/embedded-react/TouchableOpacity.js +13 -8
  94. package/src/embedded-react/index.d.ts +5 -5
  95. package/src/embedded-react/layout-anim-config.js +10 -4
  96. package/src/embedded-react/list-child.js +5 -5
  97. package/src/embedded-react/named-colors.js +1 -1
  98. package/src/embedded-react/split-style.js +11 -11
  99. package/src/embedded-react/svg-ops.js +760 -593
  100. package/src/embedded-react/useHostValue.js +3 -3
  101. package/src/embedded-react/usePersistentState.js +6 -6
  102. package/src/embedded-react/warn-props.js +1 -1
  103. package/src/host-config.js +60 -53
  104. package/src/props.js +49 -41
  105. package/src/renderer.js +7 -4
  106. package/aot/compiler/assemble.mjs +0 -944
  107. package/aot/compiler/c/animations.mjs +0 -436
  108. package/aot/compiler/c/boot.mjs +0 -127
  109. package/aot/compiler/c/expressions.mjs +0 -270
  110. package/aot/compiler/c/functions.mjs +0 -268
  111. package/aot/compiler/c/keyboard.mjs +0 -96
  112. package/aot/compiler/c/nodes.mjs +0 -303
  113. package/aot/compiler/c/pan-responder.mjs +0 -136
  114. package/aot/compiler/c/statements.mjs +0 -319
  115. package/aot/compiler/c/text.mjs +0 -83
  116. package/aot/compiler/c/vectors.mjs +0 -381
  117. package/aot/compiler/c-syntax.mjs +0 -127
@@ -17,20 +17,26 @@
17
17
  - Constants
18
18
  ---------------------------------------------------------------------------------------------------------------------*/
19
19
  /**
20
- * The largest value each size or cap takes; the smallest is 1. Screen dimensions end up in int16_t props, a
21
- * list's row count and a string buffer's size in a C `int`, and a nested <Text>'s segment count in the
22
- * engine's uint8_t `span_count`.
20
+ * The largest value each size or cap takes; the smallest is 1. Screen dimensions end up in int16_t props, and a
21
+ * nested <Text>'s segment count in the engine's uint8_t `span_count`.
23
22
  */
24
23
  const MAX_SCREEN = 32767;
25
- const MAX_LIST_CAP = 32767;
26
- const MAX_LIST_STR_CAP = 32767;
24
+ const MAX_LIST_CAPACITY = 32767;
25
+ const MAX_LIST_STRING_CAPACITY = 32767;
27
26
  const MAX_TEXT_SPANS = 255;
27
+ const MAX_TIMERS = 4096;
28
+ // What each size or cap is when neither the options nor a variable set it.
29
+ const DEFAULT_SCREEN_WIDTH = 800;
30
+ const DEFAULT_SCREEN_HEIGHT = 480;
31
+ const DEFAULT_LIST_CAPACITY = 16;
32
+ const DEFAULT_LIST_STRING_CAPACITY = 48;
33
+ const DEFAULT_TEXT_SPANS = 4;
34
+ const DEFAULT_TIMERS = 8;
28
35
  /*----------------------------------------------------------------------------------------------------------------------
29
36
  - Implementation
30
37
  ---------------------------------------------------------------------------------------------------------------------*/
31
38
  /**
32
- * Checks that a size or cap is a whole number from 1 to `max`, since it is written into the generated C as a
33
- * `#define` or an array size.
39
+ * Checks that a size or cap is a whole number from 1 to `max`, since it sizes what the package holds.
34
40
  *
35
41
  * @param value The value, as the option or the parsed variable gave it.
36
42
  * @param name The option or variable, as the error names it.
@@ -49,26 +55,29 @@ function wholeInRange(value, name, max, shown = String(value)) {
49
55
  return value;
50
56
  }
51
57
  /**
52
- * compileSource's options with the target screen and the fixed-buffer caps filled in. Each one the caller
58
+ * compilePackage's options with the screen and the fixed-buffer caps filled in. Each one the caller
53
59
  * leaves out falls back to its environment variable, then to a default. The environment is read on every
54
60
  * call, not at import, so one process can compile for several boards.
55
61
  *
56
- * screen ER_AOT_SCREEN_W / _H 800×480 Baked so a responsive app's `screen.width` branching
57
- * folds to the layout for THIS build.
62
+ * screen ER_AOT_SCREEN_W / _H 800×480 A panel to keep a layout for. A package finds its layouts
63
+ * unless told a size, with both variables or the option.
58
64
  * listCap ER_AOT_LIST_CAP 16 Rows a list state holds. Each pooled row costs engine
59
65
  * nodes, so lower it on a tight-RAM MCU.
60
66
  * listStrCap ER_AOT_LIST_STR_CAP 48 Characters per string buffer (list field, string state).
61
67
  * maxTextSpans ER_AOT_MAX_TEXT_SPANS 4 Inline segments in a nested <Text>. Must match the
62
68
  * engine's ER_TEXT_MAX_SPANS.
69
+ * maxTimers ER_AOT_MAX_TIMERS 8 Timers that run at once. Sizes the package's timer
70
+ * table.
63
71
  *
64
72
  * Each value must be a whole number from 1 up: to 32767 for the screen and the list caps, to 255 for
65
- * maxTextSpans. One that isn't, from the options or a variable, is an `AOT:` error that names it.
73
+ * maxTextSpans, to 4096 for maxTimers. One that isn't, from the options or a variable, is an `AOT:` error
74
+ * that names it.
66
75
  *
67
- * @param opts The options the caller passed.
76
+ * @param options The options the caller passed.
68
77
  *
69
78
  * @returns The same options with every value filled in.
70
79
  */
71
- export function resolveOptions(opts) {
80
+ export function resolveOptions(options) {
72
81
  // An unset or blank variable falls back to the default; any other value must parse to one in range.
73
82
  const isSet = (name) => (process.env[name] ?? '').trim() !== '';
74
83
  const fromEnv = (name, fallback, max) => {
@@ -77,30 +86,26 @@ export function resolveOptions(opts) {
77
86
  const raw = process.env[name];
78
87
  return wholeInRange(Number(raw), name, max, JSON.stringify(raw));
79
88
  };
80
- const fromOption = (value, name, envName, fallback, max) => value != null
89
+ const fromOption = (value, name, environmentName, fallback, max) => value != null
81
90
  ? wholeInRange(value, name, max)
82
- : fromEnv(envName, fallback, max);
91
+ : fromEnv(environmentName, fallback, max);
83
92
  return {
84
- ...opts,
85
- screen: opts.screen
93
+ ...options,
94
+ screen: options.screen
86
95
  ? {
87
- width: wholeInRange(opts.screen.width, 'screen.width', MAX_SCREEN),
88
- height: wholeInRange(opts.screen.height, 'screen.height', MAX_SCREEN),
96
+ width: wholeInRange(options.screen.width, 'screen.width', MAX_SCREEN),
97
+ height: wholeInRange(options.screen.height, 'screen.height', MAX_SCREEN),
89
98
  }
90
99
  : {
91
- width: fromEnv('ER_AOT_SCREEN_W', 800, MAX_SCREEN),
92
- height: fromEnv('ER_AOT_SCREEN_H', 480, MAX_SCREEN),
100
+ width: fromEnv('ER_AOT_SCREEN_W', DEFAULT_SCREEN_WIDTH, MAX_SCREEN),
101
+ height: fromEnv('ER_AOT_SCREEN_H', DEFAULT_SCREEN_HEIGHT, MAX_SCREEN),
93
102
  },
94
- // Where the size came from, for the error footer: 'option', 'env' (both dimensions) or 'default'.
95
- screenFrom: opts.screen
96
- ? 'option'
97
- : isSet('ER_AOT_SCREEN_W') && isSet('ER_AOT_SCREEN_H')
98
- ? 'env'
99
- : 'default',
103
+ screenFrom: 'option',
100
104
  caps: {
101
- listCap: fromOption(opts.listCap, 'listCap', 'ER_AOT_LIST_CAP', 16, MAX_LIST_CAP),
102
- listStrCap: fromOption(opts.listStrCap, 'listStrCap', 'ER_AOT_LIST_STR_CAP', 48, MAX_LIST_STR_CAP),
103
- maxTextSpans: fromOption(opts.maxTextSpans, 'maxTextSpans', 'ER_AOT_MAX_TEXT_SPANS', 4, MAX_TEXT_SPANS),
105
+ listCap: fromOption(options.listCap, 'listCap', 'ER_AOT_LIST_CAP', DEFAULT_LIST_CAPACITY, MAX_LIST_CAPACITY),
106
+ listStrCap: fromOption(options.listStrCap, 'listStrCap', 'ER_AOT_LIST_STR_CAP', DEFAULT_LIST_STRING_CAPACITY, MAX_LIST_STRING_CAPACITY),
107
+ maxTextSpans: fromOption(options.maxTextSpans, 'maxTextSpans', 'ER_AOT_MAX_TEXT_SPANS', DEFAULT_TEXT_SPANS, MAX_TEXT_SPANS),
108
+ maxTimers: fromOption(options.maxTimers, 'maxTimers', 'ER_AOT_MAX_TIMERS', DEFAULT_TIMERS, MAX_TIMERS),
104
109
  },
105
110
  };
106
111
  }
@@ -18,8 +18,7 @@
18
18
  ---------------------------------------------------------------------------------------------------------------------*/
19
19
  /**
20
20
  * Everything the passes lower for one app besides its element tree: the functions, drawings, responders and
21
- * effects, and the counters that name them. Each pass appends to it as the JSX tree is walked; writeApp then
22
- * writes it out as app.gen.c.
21
+ * effects, and the counters that name them. Each pass appends to it as the JSX tree is walked.
23
22
  *
24
23
  * @class Out
25
24
  */
@@ -28,43 +27,40 @@ export class Out {
28
27
  nodes = 0;
29
28
  /** Event handlers, one function each. */
30
29
  handlers = [];
31
- /** A useCallback's C handler, by component prefix and name, so each is emitted once. */
32
- cbEmitted = new Map();
30
+ /** A useCallback's handler, by component prefix and name, so each is emitted once. */
31
+ emittedCallbacks = new Map();
33
32
  /** File-scope vector op-tapes and paint tables, and the builders of state-driven drawings. */
34
33
  vectors = [];
35
- /** Numbers the next <Svg> (its tapes are `s_svg<id>_…`). */
36
- svgN = 0;
37
- /** Whether the generated C calls into <math.h>. */
38
- needsMath = false;
39
- timerFns = [];
40
- usesTimers = false;
41
- /** What er_app_build() runs last: mount-once effects, and the first run of each dep-driven one. */
34
+ /** Numbers the next <Svg> (which names its tapes). */
35
+ svgCount = 0;
36
+ timerFunctions = [];
37
+ /** What the build runs last: mount-once effects, and the first run of each dep-driven one. */
42
38
  mountEffects = [];
43
39
  /** Animations' on_complete callbacks: completions, completion waits, and chains. */
44
- animCbs = [];
40
+ animationCallbacks = [];
45
41
  /** The owner number of each composition that completion waits belong to, by composition; `isStarted` once a start waits. */
46
- animWaits = new Map();
42
+ animationWaits = new Map();
47
43
  /** Numbers the next animation sequence. */
48
- seqN = 0;
44
+ sequenceCount = 0;
49
45
  /** Image assets the app reaches: asset name → source-relative import path. */
50
46
  images = new Map();
51
47
  /** A dynamic image source was reached, so every imported image has to be baked. */
52
48
  bakeAllImages = false;
53
49
  /** Numbers the next inlined component instance (its storage prefix is `c<n>_`). */
54
- instN = 0;
50
+ instanceCount = 0;
55
51
  /** State, refs, and animated values that belong to inlined component instances. */
56
52
  childStateRecords = [];
57
53
  childRefs = [];
58
54
  childAnimations = [];
59
55
  /** Numbers the next effect. */
60
- effN = 0;
61
- effectFns = [];
56
+ effectCount = 0;
57
+ effectFunctions = [];
62
58
  /** File-scope variables the effects and animation loops need. */
63
- effectDecls = [];
64
- /** Dep-driven effects, which app_update() re-runs when one of their deps changed. */
65
- depEffects = [];
59
+ effectDeclarations = [];
60
+ /** Dep-driven effects, which the update re-runs when one of their deps changed. */
61
+ dependencyEffects = [];
66
62
  /** Numbers the next PanResponder. */
67
- panN = 0;
63
+ panCount = 0;
68
64
  /** Every PanResponder a node spreads, lowered once each. */
69
65
  panResponders = [];
70
66
  /** The module's function components, by name, for inlining. */
@@ -86,7 +82,7 @@ export class Out {
86
82
  /**
87
83
  * Reserves the next engine node.
88
84
  *
89
- * @returns Its number: the node is the C variable `n<number>`.
85
+ * @returns Its number: the node is known as `n<number>`.
90
86
  */
91
87
  allocateNodeId() {
92
88
  return this.nodes++;