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,272 @@
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
+ /*
17
+ * useReducer: each `dispatch(action)` runs the reducer in place, as an updater with a block body. The action is bound
18
+ * where it is dispatched: its constant fields fold, so the branches its type rules out are dropped before the body is
19
+ * lowered, and a `throw` for an action no dispatch sends never runs.
20
+ */
21
+ /*----------------------------------------------------------------------------------------------------------------------
22
+ - Imports
23
+ ---------------------------------------------------------------------------------------------------------------------*/
24
+ import { lowerLocal } from './expressions.mjs';
25
+ import { exits, statementsOf } from './helper-values.mjs';
26
+ import { AstLeaf, isObjectTree, objectTreeOf } from './records.mjs';
27
+ import { RuntimeLeaf, evalStatic, foldScope, rethrowFoldLimit, withoutNames, } from './static-eval.mjs';
28
+ import { switchAsIf } from './switch-cases.mjs';
29
+ import { declaredIn } from './updaters.mjs';
30
+ /*----------------------------------------------------------------------------------------------------------------------
31
+ - Implementation
32
+ ---------------------------------------------------------------------------------------------------------------------*/
33
+ /**
34
+ * What an expression folds to, if it does.
35
+ *
36
+ * @param node The expression.
37
+ * @param scope The constants a fold may read.
38
+ *
39
+ * @returns The value, or undefined when it does not fold.
40
+ */
41
+ function folded(node, scope) {
42
+ try {
43
+ return { value: evalStatic(node, scope, 'strict') };
44
+ }
45
+ catch (error) {
46
+ rethrowFoldLimit(error);
47
+ return undefined;
48
+ }
49
+ }
50
+ /**
51
+ * The local a runtime value is held in, worked out where it is written.
52
+ *
53
+ * @param node The value.
54
+ * @param environment The environment it is written in.
55
+ *
56
+ * @returns The local.
57
+ */
58
+ function localOf(node, environment) {
59
+ return lowerLocal(node, environment);
60
+ }
61
+ /**
62
+ * An object's fields as the reducer reads them: a constant stays one, and anything else is worked out at the
63
+ * dispatch, so names the reducer declares can't change what it reads.
64
+ *
65
+ * @param tree The object.
66
+ * @param environment The dispatch's environment.
67
+ * @param scope The constants a fold may read there.
68
+ *
69
+ * @returns The object.
70
+ */
71
+ function settledTree(tree, environment, scope) {
72
+ return Object.fromEntries(Object.entries(tree).map(([key, value]) => {
73
+ if (isObjectTree(value)) {
74
+ return [key, settledTree(value, environment, scope)];
75
+ }
76
+ if (!(value instanceof AstLeaf))
77
+ return [key, value];
78
+ const constant = value.locals.size
79
+ ? undefined
80
+ : folded(value.node, scope);
81
+ if (constant && typeof constant.value !== 'object') {
82
+ return [key, constant.value];
83
+ }
84
+ const fieldEnvironment = value.locals.size
85
+ ? {
86
+ ...environment,
87
+ locals: new Map([...environment.locals, ...value.locals]),
88
+ }
89
+ : environment;
90
+ return [key, new RuntimeLeaf(localOf(value.node, fieldEnvironment))];
91
+ }));
92
+ }
93
+ /**
94
+ * An action that picks between two at run time: a ternary of actions, or an object with a field that is a ternary of
95
+ * two constants, `{type: up ? 'inc' : 'dec'}`. Each side is dispatched on its own, so its constant fields fold.
96
+ *
97
+ * @param action What is dispatched.
98
+ * @param scope The constants a fold may read.
99
+ *
100
+ * @returns The test and the action each way, or null when the action picks nothing.
101
+ */
102
+ export function actionChoice(action, scope) {
103
+ if (action.type === 'ConditionalExpression' && !folded(action.test, scope)) {
104
+ return {
105
+ test: action.test,
106
+ whenTrue: action.consequent,
107
+ whenFalse: action.alternate,
108
+ };
109
+ }
110
+ if (action.type !== 'ObjectExpression')
111
+ return null;
112
+ for (const [index, property] of action.properties.entries()) {
113
+ if (property.type !== 'ObjectProperty' ||
114
+ property.value.type !== 'ConditionalExpression' ||
115
+ folded(property.value.test, scope)) {
116
+ continue;
117
+ }
118
+ const { test, consequent, alternate } = property.value;
119
+ const isConstant = (node) => {
120
+ const value = folded(node, scope);
121
+ return value !== undefined && typeof value.value !== 'object';
122
+ };
123
+ if (!isConstant(consequent) || !isConstant(alternate))
124
+ continue;
125
+ const withValue = (value) => ({
126
+ ...action,
127
+ properties: action.properties.map((other, at) => at === index ? { ...property, value } : other),
128
+ });
129
+ return {
130
+ test,
131
+ whenTrue: withValue(consequent),
132
+ whenFalse: withValue(alternate),
133
+ };
134
+ }
135
+ return null;
136
+ }
137
+ /**
138
+ * The environment a reducer's body runs in for one dispatch: the action parameter bound to what is dispatched. A
139
+ * constant folds, an object is its fields, and anything else is a local holding the value.
140
+ *
141
+ * @param parameter The action parameter's name, if the reducer has one.
142
+ * @param action What the dispatch passes.
143
+ * @param environment The dispatch's environment.
144
+ *
145
+ * @returns The body's environment.
146
+ */
147
+ export function actionEnvironment(parameter, action, environment) {
148
+ if (!parameter)
149
+ return environment;
150
+ const scope = foldScope(environment, environment.constants ?? {});
151
+ const locals = new Map(environment.locals);
152
+ const state = new Map(environment.state);
153
+ const constants = { ...environment.constants };
154
+ locals.delete(parameter);
155
+ state.delete(parameter);
156
+ delete constants[parameter];
157
+ const constant = folded(action, scope);
158
+ const tree = constant ? null : objectTreeOf(action, environment);
159
+ if (constant) {
160
+ constants[parameter] = constant.value;
161
+ }
162
+ else if (tree) {
163
+ constants[parameter] = settledTree(tree, environment, scope);
164
+ }
165
+ else {
166
+ locals.set(parameter, localOf(action, environment));
167
+ }
168
+ return { ...environment, locals, state, constants };
169
+ }
170
+ /**
171
+ * A value with each ternary whose test folds made the side it picks.
172
+ *
173
+ * @param node The value.
174
+ * @param scope The constants a fold may read.
175
+ *
176
+ * @returns The value.
177
+ */
178
+ function prunedValue(node, scope) {
179
+ if (node.type !== 'ConditionalExpression')
180
+ return node;
181
+ const test = folded(node.test, scope);
182
+ if (test) {
183
+ return prunedValue(test.value ? node.consequent : node.alternate, scope);
184
+ }
185
+ return {
186
+ ...node,
187
+ consequent: prunedValue(node.consequent, scope),
188
+ alternate: prunedValue(node.alternate, scope),
189
+ };
190
+ }
191
+ /**
192
+ * Statements with each branch whose test folds made the one it takes, in loops too. A branch taken that always ends
193
+ * drops the statements after it, which never run. Tests on the action's constant fields fold, so a `switch
194
+ * (action.type)` keeps only the case a dispatch takes. A name a block or a loop declares hides what it names outside,
195
+ * so no test folds through it.
196
+ *
197
+ * @param statements The statements.
198
+ * @param scope The constants a fold may read.
199
+ *
200
+ * @returns The statements.
201
+ */
202
+ export function prunedStatements(statements, scope) {
203
+ const pruned = [];
204
+ scope = withoutNames(scope, declaredIn(statements));
205
+ for (const original of statements) {
206
+ const statement = original.type === 'SwitchStatement' ? switchAsIf(original) : original;
207
+ switch (statement.type) {
208
+ case 'IfStatement': {
209
+ const test = folded(statement.test, scope);
210
+ if (!test) {
211
+ pruned.push({
212
+ ...statement,
213
+ consequent: {
214
+ type: 'BlockStatement',
215
+ body: prunedStatements(statementsOf(statement.consequent), scope),
216
+ directives: [],
217
+ },
218
+ alternate: statement.alternate
219
+ ? {
220
+ type: 'BlockStatement',
221
+ body: prunedStatements(statementsOf(statement.alternate), scope),
222
+ directives: [],
223
+ }
224
+ : null,
225
+ });
226
+ continue;
227
+ }
228
+ // The branch taken runs in place. One that always ends is the last thing that runs.
229
+ const branch = test.value ? statement.consequent : statement.alternate;
230
+ const taken = branch
231
+ ? prunedStatements(statementsOf(branch), scope)
232
+ : [];
233
+ if (exits(taken)) {
234
+ pruned.push(...taken);
235
+ return pruned;
236
+ }
237
+ if (taken.length) {
238
+ pruned.push({ type: 'BlockStatement', body: taken, directives: [] });
239
+ }
240
+ continue;
241
+ }
242
+ case 'BlockStatement': {
243
+ const body = prunedStatements(statement.body, scope);
244
+ pruned.push({ ...statement, body });
245
+ if (exits(body))
246
+ return pruned;
247
+ continue;
248
+ }
249
+ case 'ForStatement':
250
+ case 'ForOfStatement': {
251
+ const head = statement.type === 'ForStatement' ? statement.init : statement.left;
252
+ pruned.push({
253
+ ...statement,
254
+ body: {
255
+ type: 'BlockStatement',
256
+ body: prunedStatements(statementsOf(statement.body), withoutNames(scope, declaredIn([head]))),
257
+ directives: [],
258
+ },
259
+ });
260
+ continue;
261
+ }
262
+ case 'ReturnStatement':
263
+ pruned.push(statement.argument
264
+ ? { ...statement, argument: prunedValue(statement.argument, scope) }
265
+ : statement);
266
+ return pruned;
267
+ default:
268
+ pruned.push(statement);
269
+ }
270
+ }
271
+ return pruned;
272
+ }
@@ -0,0 +1,112 @@
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
+ /**
17
+ * @file compiler/scroll-to.mts
18
+ * @brief Lowers `scrollTo(ref.current, {x, y})`: a scroll of the ScrollView the ref is on, and its position after.
19
+ */
20
+ import { aotError } from './diagnostics.mjs';
21
+ import { lowerExpr } from './expressions.mjs';
22
+ /*----------------------------------------------------------------------------------------------------------------------
23
+ - Constants
24
+ ---------------------------------------------------------------------------------------------------------------------*/
25
+ /** The fields of the position scrollTo returns, in the order the runtime gives them. */
26
+ export const SCROLL_POSITION_FIELDS = ['x', 'y', 'maxX', 'maxY'];
27
+ const HINT = 'call it as scrollTo(list.current, {y: 120}), where list is a useRef() on a <ScrollView>; leave an axis out ' +
28
+ 'to keep it, or the offset out to only read the position.';
29
+ /*----------------------------------------------------------------------------------------------------------------------
30
+ - Implementation
31
+ ---------------------------------------------------------------------------------------------------------------------*/
32
+ /**
33
+ * Whether an expression is a `scrollTo(…)` call.
34
+ *
35
+ * @param node The expression.
36
+ *
37
+ * @returns True when it is.
38
+ */
39
+ export function isScrollToCall(node) {
40
+ return (node?.type === 'CallExpression' &&
41
+ node.callee.type === 'Identifier' &&
42
+ node.callee.name === 'scrollTo');
43
+ }
44
+ /**
45
+ * One axis of the offset, or null when the offset leaves it out.
46
+ *
47
+ * @param offset The offset's object literal.
48
+ * @param axis The axis.
49
+ * @param environment The expression environment.
50
+ *
51
+ * @returns The axis's value.
52
+ */
53
+ function axisOf(offset, axis, environment) {
54
+ // The last of a key written twice is the one JS keeps.
55
+ const property = offset.properties.findLast(candidate => candidate.type === 'ObjectProperty' &&
56
+ candidate.key.type === 'Identifier' &&
57
+ candidate.key.name === axis);
58
+ return property
59
+ ? lowerExpr(property.value, environment)
60
+ : null;
61
+ }
62
+ /**
63
+ * Lowers a `scrollTo(ref.current, {x, y}?)` call.
64
+ *
65
+ * @param call The call.
66
+ * @param environment The expression environment.
67
+ * @param results The locals its position is kept in, when the code reads it.
68
+ *
69
+ * @returns The statement.
70
+ */
71
+ export function lowerScrollTo(call, environment, results) {
72
+ const [handle, offset, ...rest] = call.arguments;
73
+ const ref = handle?.type === 'MemberExpression' &&
74
+ !handle.computed &&
75
+ handle.object.type === 'Identifier' &&
76
+ handle.property.type === 'Identifier' &&
77
+ handle.property.name === 'current'
78
+ ? environment.refs?.get(handle.object.name)
79
+ : null;
80
+ if (ref?.kind !== 'node') {
81
+ throw aotError('AOT: scrollTo() takes the `.current` of a node ref first', HINT);
82
+ }
83
+ ref.used = true;
84
+ const isOffset = offset?.type === 'ObjectExpression' &&
85
+ offset.properties.every(property => property.type === 'ObjectProperty' &&
86
+ !property.computed &&
87
+ property.key.type === 'Identifier' &&
88
+ (property.key.name === 'x' || property.key.name === 'y'));
89
+ if (rest.length || (offset && !isOffset)) {
90
+ throw aotError('AOT: scrollTo() takes its offset as an object literal of x and y', HINT);
91
+ }
92
+ return {
93
+ kind: 'scrollTo',
94
+ node: ref.slotName,
95
+ x: offset ? axisOf(offset, 'x', environment) : null,
96
+ y: offset ? axisOf(offset, 'y', environment) : null,
97
+ results,
98
+ };
99
+ }
100
+ /**
101
+ * Refuses the position scrollTo returns where it can't be kept: anywhere but a const, or a field read in one.
102
+ *
103
+ * @param node The expression.
104
+ *
105
+ * @returns The error, or null when the expression is no scrollTo call.
106
+ */
107
+ export function unkeptScrollError(node) {
108
+ return isScrollToCall(node)
109
+ ? aotError('AOT: scrollTo() returns a position, which only a const keeps', 'keep it first, then read its fields: const position = scrollTo(list.current); or ' +
110
+ 'const {y, maxY} = scrollTo(list.current);')
111
+ : null;
112
+ }