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
@@ -0,0 +1,246 @@
1
+ /*
2
+ * Copyright 2026 Cory Lamming
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+ // record-shapes.mts — the shapes an object state takes: its initial value, and the objects its setter is given.
17
+ /*----------------------------------------------------------------------------------------------------------------------
18
+ - Imports
19
+ ---------------------------------------------------------------------------------------------------------------------*/
20
+ import { aotError } from './diagnostics.mjs';
21
+ import { flattenTree, isObjectTree, propertyKey } from './records.mjs';
22
+ import { evalStatic, rethrowFoldLimit } from './static-eval.mjs';
23
+ import { returnedValues } from './updaters.mjs';
24
+ /*----------------------------------------------------------------------------------------------------------------------
25
+ - Constants
26
+ ---------------------------------------------------------------------------------------------------------------------*/
27
+ // Keys that never hold child AST nodes.
28
+ const SKIP_KEYS = new Set([
29
+ 'loc',
30
+ 'start',
31
+ 'end',
32
+ 'range',
33
+ 'extra',
34
+ 'leadingComments',
35
+ 'trailingComments',
36
+ 'innerComments',
37
+ ]);
38
+ /*----------------------------------------------------------------------------------------------------------------------
39
+ - Implementation
40
+ ---------------------------------------------------------------------------------------------------------------------*/
41
+ /**
42
+ * Whether a value can name a shape: a string, a finite number or a boolean.
43
+ *
44
+ * @param value The value.
45
+ *
46
+ * @returns Whether it can.
47
+ */
48
+ const isTagValue = (value) => typeof value === 'string' ||
49
+ typeof value === 'boolean' ||
50
+ (typeof value === 'number' && Number.isFinite(value));
51
+ /**
52
+ * The fields of an object literal, nested ones flattened; a field that folds holds its value.
53
+ *
54
+ * @param node The object.
55
+ * @param scope Compile-time constants in reach.
56
+ *
57
+ * @returns The object.
58
+ */
59
+ function writtenObjectOf(node, scope) {
60
+ const written = { fields: new Map(), spread: false, node };
61
+ const visit = (object, path) => {
62
+ for (const property of object.properties) {
63
+ if (property.type === 'SpreadElement') {
64
+ written.spread = true;
65
+ continue;
66
+ }
67
+ if (property.type !== 'ObjectProperty')
68
+ continue;
69
+ let key;
70
+ try {
71
+ key = propertyKey(property);
72
+ }
73
+ catch {
74
+ continue; // refused where the write is lowered
75
+ }
76
+ const fieldPath = [...path, key];
77
+ const { value: valueNode } = property;
78
+ if (valueNode.type === 'ObjectExpression') {
79
+ visit(valueNode, fieldPath);
80
+ continue;
81
+ }
82
+ let value;
83
+ let known = true;
84
+ try {
85
+ value = evalStatic(valueNode, scope);
86
+ }
87
+ catch (error) {
88
+ rethrowFoldLimit(error);
89
+ known = false;
90
+ }
91
+ if (known && isObjectTree(value)) {
92
+ for (const [nestedKey, nested] of flattenTree(value)) {
93
+ written.fields.set([...fieldPath, nestedKey].join('.'), {
94
+ known: true,
95
+ value: nested,
96
+ });
97
+ }
98
+ continue;
99
+ }
100
+ written.fields.set(fieldPath.join('.'), known ? { known, value, node: valueNode } : { known, node: valueNode });
101
+ }
102
+ };
103
+ visit(node, []);
104
+ return written;
105
+ }
106
+ /**
107
+ * The objects a value can be: itself, a side of a ternary, or what a function returns.
108
+ *
109
+ * @param node The value.
110
+ * @param scope Compile-time constants in reach.
111
+ * @param objects Takes the objects.
112
+ */
113
+ function collectObjects(node, scope, objects) {
114
+ if (node.type === 'ObjectExpression') {
115
+ objects.push(writtenObjectOf(node, scope));
116
+ }
117
+ else if (node.type === 'ConditionalExpression') {
118
+ collectObjects(node.consequent, scope, objects);
119
+ collectObjects(node.alternate, scope, objects);
120
+ }
121
+ else if (node.type === 'ArrowFunctionExpression' ||
122
+ node.type === 'FunctionExpression' ||
123
+ node.type === 'FunctionDeclaration') {
124
+ const values = node.body.type === 'BlockStatement'
125
+ ? returnedValues(node.body)
126
+ : [node.body];
127
+ values.forEach(value => collectObjects(value, scope, objects));
128
+ }
129
+ }
130
+ /**
131
+ * The objects a reducer returns.
132
+ *
133
+ * @param reducer The reducer.
134
+ * @param scope Compile-time constants in reach.
135
+ *
136
+ * @returns The objects.
137
+ */
138
+ export function returnedObjects(reducer, scope) {
139
+ const objects = [];
140
+ collectObjects(reducer, scope, objects);
141
+ return objects;
142
+ }
143
+ /**
144
+ * The objects a setter is called with anywhere in a component: given directly, as a side of a ternary, or by an
145
+ * updater.
146
+ *
147
+ * @param body The component's body.
148
+ * @param setter The setter's name.
149
+ * @param scope Compile-time constants in reach.
150
+ *
151
+ * @returns The objects.
152
+ */
153
+ export function writtenObjects(body, setter, scope) {
154
+ const objects = [];
155
+ const walk = (node) => {
156
+ if (Array.isArray(node)) {
157
+ node.forEach(walk);
158
+ return;
159
+ }
160
+ if (typeof node !== 'object' || node === null)
161
+ return;
162
+ const astNode = node;
163
+ if (astNode.type === 'CallExpression' &&
164
+ astNode.callee.type === 'Identifier' &&
165
+ astNode.callee.name === setter &&
166
+ astNode.arguments[0]) {
167
+ collectObjects(astNode.arguments[0], scope, objects);
168
+ }
169
+ for (const [key, child] of Object.entries(astNode)) {
170
+ if (!SKIP_KEYS.has(key))
171
+ walk(child);
172
+ }
173
+ };
174
+ walk(body);
175
+ return objects;
176
+ }
177
+ /**
178
+ * The shapes an object state takes, when it takes more than one: the initial value and each object written out in
179
+ * full, told apart by a field that holds a constant in each, the first such field of the initial value.
180
+ *
181
+ * @param name The state's name.
182
+ * @param setter The setter's name.
183
+ * @param initial The initial value's fields.
184
+ * @param written The objects the setter is given.
185
+ * @param write How a write of an object is written, for errors: by default a call to the setter.
186
+ *
187
+ * @returns The shapes, or null when the state has one shape.
188
+ */
189
+ export function recordShapesOf(name, setter, initial, written, write = object => `${setter}(${object})`) {
190
+ // A write that spreads the old value keeps its shape, so one that changes a constant of the initial value and adds
191
+ // a field no shape has is a new shape written as a spread.
192
+ const full = written.filter(object => !object.spread);
193
+ const known = new Set([
194
+ ...initial.keys(),
195
+ ...full.flatMap(object => [...object.fields.keys()]),
196
+ ]);
197
+ for (const object of written) {
198
+ if (!object.spread)
199
+ continue;
200
+ const added = [...object.fields.keys()].find(key => !known.has(key));
201
+ const retagged = [...object.fields].find(([key, field]) => field.known &&
202
+ isTagValue(initial.get(key)) &&
203
+ field.value !== initial.get(key));
204
+ if (!added || !retagged)
205
+ continue;
206
+ const [tagKey, { value }] = retagged;
207
+ const error = aotError(`AOT: a write that spreads "${name}" keeps its shape, so it can't add "${added}"`, `to give ${name} another shape, write the new shape out in full: ` +
208
+ `${write(`{${tagKey}: ${typeof value === 'string' ? `'${value}'` : String(value)}, ${added}: …}`)}.`);
209
+ if (object.node.loc)
210
+ error.aotLoc = object.node.loc.start;
211
+ throw error;
212
+ }
213
+ const keysDiffer = (object) => [...object.fields.keys()].some(key => !initial.has(key)) ||
214
+ (!object.spread && object.fields.size !== initial.size);
215
+ if (!full.length || !written.some(keysDiffer))
216
+ return null;
217
+ for (const [key, initialValue] of initial) {
218
+ if (key.includes('.') || !isTagValue(initialValue))
219
+ continue;
220
+ const values = [initialValue];
221
+ const shapes = [
222
+ new Set([...initial.keys()].filter(field => field !== key)),
223
+ ];
224
+ const agrees = full.every(object => {
225
+ const tag = object.fields.get(key);
226
+ if (!tag?.known || typeof tag.value !== typeof initialValue)
227
+ return false;
228
+ if (!isTagValue(tag.value))
229
+ return false;
230
+ const fields = new Set([...object.fields.keys()].filter(field => field !== key));
231
+ const shape = values.indexOf(tag.value);
232
+ if (shape < 0) {
233
+ values.push(tag.value);
234
+ shapes.push(fields);
235
+ return true;
236
+ }
237
+ return (shapes[shape].size === fields.size &&
238
+ [...fields].every(field => shapes[shape].has(field)));
239
+ });
240
+ if (agrees && values.length > 1)
241
+ return { key, values, shapes };
242
+ }
243
+ throw aotError(`AOT: state "${name}" is written with objects of different fields`, `an object of several shapes needs a field naming the shape, with a constant written in each: ` +
244
+ `${write("{kind: 'busy', pct: 0}")}. Write each new shape out in full; a write that keeps the shape ` +
245
+ `spreads the old value: ${write(`{...${name}, pct: 1}`)}.`);
246
+ }