@barefootjs/jsx 0.40.0 → 0.40.2

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 (249) hide show
  1. package/dist/adapters/ambiguous-nil-arithmetic.d.ts +42 -0
  2. package/dist/adapters/ambiguous-nil-arithmetic.d.ts.map +1 -0
  3. package/dist/adapters/attr-plan.d.ts.map +1 -1
  4. package/dist/adapters/boolean-carrier.d.ts +31 -0
  5. package/dist/adapters/boolean-carrier.d.ts.map +1 -0
  6. package/dist/adapters/boolean-result.d.ts +32 -10
  7. package/dist/adapters/boolean-result.d.ts.map +1 -1
  8. package/dist/adapters/brace-delimiter-text.d.ts +18 -0
  9. package/dist/adapters/brace-delimiter-text.d.ts.map +1 -0
  10. package/dist/adapters/callback-method.d.ts +38 -5
  11. package/dist/adapters/callback-method.d.ts.map +1 -1
  12. package/dist/adapters/component-props.d.ts +22 -7
  13. package/dist/adapters/component-props.d.ts.map +1 -1
  14. package/dist/adapters/computed-const.d.ts +28 -1
  15. package/dist/adapters/computed-const.d.ts.map +1 -1
  16. package/dist/adapters/dsl-template-adapter.d.ts +39 -1
  17. package/dist/adapters/dsl-template-adapter.d.ts.map +1 -1
  18. package/dist/adapters/loop-bound-names.d.ts +9 -1
  19. package/dist/adapters/loop-bound-names.d.ts.map +1 -1
  20. package/dist/adapters/loop-row-type.d.ts +52 -0
  21. package/dist/adapters/loop-row-type.d.ts.map +1 -0
  22. package/dist/adapters/nil-reading.d.ts +68 -0
  23. package/dist/adapters/nil-reading.d.ts.map +1 -0
  24. package/dist/adapters/non-primitive-equality.d.ts +33 -0
  25. package/dist/adapters/non-primitive-equality.d.ts.map +1 -0
  26. package/dist/adapters/number-value.d.ts +45 -0
  27. package/dist/adapters/number-value.d.ts.map +1 -0
  28. package/dist/adapters/operand-typing.d.ts +126 -0
  29. package/dist/adapters/operand-typing.d.ts.map +1 -0
  30. package/dist/adapters/parsed-expr-emitter.d.ts +70 -12
  31. package/dist/adapters/parsed-expr-emitter.d.ts.map +1 -1
  32. package/dist/adapters/primitive-plan.d.ts +291 -0
  33. package/dist/adapters/primitive-plan.d.ts.map +1 -0
  34. package/dist/analyzer-context.d.ts +11 -0
  35. package/dist/analyzer-context.d.ts.map +1 -1
  36. package/dist/analyzer.d.ts +34 -0
  37. package/dist/analyzer.d.ts.map +1 -1
  38. package/dist/augment-inherited-props.d.ts +63 -8
  39. package/dist/augment-inherited-props.d.ts.map +1 -1
  40. package/dist/compiler.d.ts.map +1 -1
  41. package/dist/event-handler-name.d.ts +12 -0
  42. package/dist/event-handler-name.d.ts.map +1 -1
  43. package/dist/expression-parser.d.ts +8 -0
  44. package/dist/expression-parser.d.ts.map +1 -1
  45. package/dist/index.d.ts +24 -11
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +5671 -2586
  48. package/dist/ir-to-client-js/build-references.d.ts.map +1 -1
  49. package/dist/ir-to-client-js/child-props-object.d.ts +64 -0
  50. package/dist/ir-to-client-js/child-props-object.d.ts.map +1 -0
  51. package/dist/ir-to-client-js/collect-elements.d.ts.map +1 -1
  52. package/dist/ir-to-client-js/control-flow/plan/build-component-loop.d.ts.map +1 -1
  53. package/dist/ir-to-client-js/control-flow/plan/build-inner-loop.d.ts +29 -0
  54. package/dist/ir-to-client-js/control-flow/plan/build-inner-loop.d.ts.map +1 -1
  55. package/dist/ir-to-client-js/control-flow/plan/build-lazy-row.d.ts +2 -0
  56. package/dist/ir-to-client-js/control-flow/plan/build-lazy-row.d.ts.map +1 -1
  57. package/dist/ir-to-client-js/control-flow/plan/build-loop-child-arm.d.ts.map +1 -1
  58. package/dist/ir-to-client-js/control-flow/plan/build-reactive-effects.d.ts.map +1 -1
  59. package/dist/ir-to-client-js/control-flow/plan/inner-loop.d.ts +5 -4
  60. package/dist/ir-to-client-js/control-flow/plan/inner-loop.d.ts.map +1 -1
  61. package/dist/ir-to-client-js/control-flow/plan/loop-child-arm.d.ts +2 -0
  62. package/dist/ir-to-client-js/control-flow/plan/loop-child-arm.d.ts.map +1 -1
  63. package/dist/ir-to-client-js/control-flow/plan/loop.d.ts +15 -0
  64. package/dist/ir-to-client-js/control-flow/plan/loop.d.ts.map +1 -1
  65. package/dist/ir-to-client-js/control-flow/plan/reactive-effects.d.ts +2 -0
  66. package/dist/ir-to-client-js/control-flow/plan/reactive-effects.d.ts.map +1 -1
  67. package/dist/ir-to-client-js/control-flow/shared.d.ts.map +1 -1
  68. package/dist/ir-to-client-js/control-flow/stringify/claim-plan.d.ts +22 -0
  69. package/dist/ir-to-client-js/control-flow/stringify/claim-plan.d.ts.map +1 -1
  70. package/dist/ir-to-client-js/control-flow/stringify/component-loop.d.ts.map +1 -1
  71. package/dist/ir-to-client-js/control-flow/stringify/event-listener.d.ts +1 -1
  72. package/dist/ir-to-client-js/control-flow/stringify/event-listener.d.ts.map +1 -1
  73. package/dist/ir-to-client-js/control-flow/stringify/lazy-row.d.ts.map +1 -1
  74. package/dist/ir-to-client-js/html-template.d.ts +3 -2
  75. package/dist/ir-to-client-js/html-template.d.ts.map +1 -1
  76. package/dist/ir-to-client-js/imports.d.ts +2 -2
  77. package/dist/ir-to-client-js/imports.d.ts.map +1 -1
  78. package/dist/ir-to-client-js/index.d.ts +2 -6
  79. package/dist/ir-to-client-js/index.d.ts.map +1 -1
  80. package/dist/ir-to-client-js/plan/build-static-array-child-init.d.ts.map +1 -1
  81. package/dist/ir-to-client-js/plan/static-array-child-init.d.ts +37 -19
  82. package/dist/ir-to-client-js/plan/static-array-child-init.d.ts.map +1 -1
  83. package/dist/ir-to-client-js/prop-handling.d.ts.map +1 -1
  84. package/dist/ir-to-client-js/reactivity.d.ts.map +1 -1
  85. package/dist/ir-to-client-js/safe-html.d.ts +9 -3
  86. package/dist/ir-to-client-js/safe-html.d.ts.map +1 -1
  87. package/dist/ir-to-client-js/stringify/static-array-child-init.d.ts +3 -2
  88. package/dist/ir-to-client-js/stringify/static-array-child-init.d.ts.map +1 -1
  89. package/dist/ir-to-client-js/types.d.ts +30 -0
  90. package/dist/ir-to-client-js/types.d.ts.map +1 -1
  91. package/dist/ir-to-client-js/utils.d.ts +8 -0
  92. package/dist/ir-to-client-js/utils.d.ts.map +1 -1
  93. package/dist/jsx-to-ir.d.ts +1 -0
  94. package/dist/jsx-to-ir.d.ts.map +1 -1
  95. package/dist/nullable-signal-attr.d.ts +95 -10
  96. package/dist/nullable-signal-attr.d.ts.map +1 -1
  97. package/dist/prop-rewrite.d.ts +7 -0
  98. package/dist/prop-rewrite.d.ts.map +1 -1
  99. package/dist/props-binding.d.ts +27 -3
  100. package/dist/props-binding.d.ts.map +1 -1
  101. package/dist/props-object-whole-read.d.ts +15 -0
  102. package/dist/props-object-whole-read.d.ts.map +1 -0
  103. package/dist/rich-type-refusal.d.ts.map +1 -1
  104. package/dist/scope/binding-scope.d.ts +100 -4
  105. package/dist/scope/binding-scope.d.ts.map +1 -1
  106. package/dist/scope/lexical-scope-walk.d.ts +3 -2
  107. package/dist/scope/lexical-scope-walk.d.ts.map +1 -1
  108. package/dist/scope/root-prop-alias.d.ts +16 -0
  109. package/dist/scope/root-prop-alias.d.ts.map +1 -1
  110. package/dist/signal-prop-name-collision.d.ts.map +1 -1
  111. package/dist/ssr-defaults.d.ts +4 -2
  112. package/dist/ssr-defaults.d.ts.map +1 -1
  113. package/dist/ssr-seed-plan.d.ts +14 -0
  114. package/dist/ssr-seed-plan.d.ts.map +1 -1
  115. package/dist/strip-types.d.ts +13 -0
  116. package/dist/strip-types.d.ts.map +1 -1
  117. package/dist/template-parts.d.ts.map +1 -1
  118. package/dist/template-position-walk.d.ts +21 -3
  119. package/dist/template-position-walk.d.ts.map +1 -1
  120. package/dist/types.d.ts +120 -0
  121. package/dist/types.d.ts.map +1 -1
  122. package/package.json +2 -2
  123. package/src/__tests__/__snapshots__/doc-examples.test.ts.snap +3 -3
  124. package/src/__tests__/binding-scope-ratchet.test.ts +12 -2
  125. package/src/__tests__/binding-scope.test.ts +89 -1
  126. package/src/__tests__/body-destructure-props-object-alias.test.ts +123 -0
  127. package/src/__tests__/boolean-carrier.test.ts +74 -0
  128. package/src/__tests__/boolean-result.test.ts +22 -5
  129. package/src/__tests__/brace-delimiter-text.test.ts +26 -0
  130. package/src/__tests__/callback-method.test.ts +62 -2
  131. package/src/__tests__/child-components-in-map.test.ts +1 -1
  132. package/src/__tests__/component-props.test.ts +14 -0
  133. package/src/__tests__/computed-const.test.ts +188 -0
  134. package/src/__tests__/emit-to-string-call.test.ts +2 -1
  135. package/src/__tests__/expression-parser.test.ts +24 -0
  136. package/src/__tests__/hydration-payload-analysis.test.ts +166 -0
  137. package/src/__tests__/issue-2724-prop-alias-loop-not-static.test.ts +7 -7
  138. package/src/__tests__/issue-2754-rest-spread-needs-slot.test.ts +5 -2
  139. package/src/__tests__/issue-2798-static-nested-loop-bindings.test.ts +1 -1
  140. package/src/__tests__/issue-2835-props-type-member-name-collision.test.ts +4 -4
  141. package/src/__tests__/issue-3044-nested-prop-object-array-not-static.test.ts +1 -1
  142. package/src/__tests__/issue-3688-props-spread-child-csr.test.ts +143 -0
  143. package/src/__tests__/issue-3713-props-spread-loop-row.test.ts +65 -0
  144. package/src/__tests__/lookup-literal-const.test.ts +9 -3
  145. package/src/__tests__/loop-index-reactivity.test.ts +2 -2
  146. package/src/__tests__/loop-param-accessor-key-member-safety.test.ts +1 -1
  147. package/src/__tests__/loop-plan.test.ts +1 -1
  148. package/src/__tests__/loop-row-const-initializer-shadow.test.ts +146 -0
  149. package/src/__tests__/loop-row-prop-read.test.ts +111 -0
  150. package/src/__tests__/loop-row-type.test.ts +64 -0
  151. package/src/__tests__/lowering-value-position.test.ts +4 -0
  152. package/src/__tests__/memo-body-expr.test.ts +137 -0
  153. package/src/__tests__/module-const-destructure-default.test.ts +156 -0
  154. package/src/__tests__/nested-loop-index-param.test.ts +1 -1
  155. package/src/__tests__/nested-loop-reactive-attrs.test.ts +2 -2
  156. package/src/__tests__/nested-row-shadowing.test.ts +2 -2
  157. package/src/__tests__/nil-reading.test.ts +77 -0
  158. package/src/__tests__/nullable-signal-attr.test.ts +231 -2
  159. package/src/__tests__/primitive-plan.test.ts +416 -0
  160. package/src/__tests__/profile-binding-ids.test.ts +14 -0
  161. package/src/__tests__/profile-loop-binding-ids.test.ts +2 -2
  162. package/src/__tests__/profile-nested-binding-ids.test.ts +2 -2
  163. package/src/__tests__/props-object-whole-read.test.ts +40 -0
  164. package/src/__tests__/reactive-attrs-in-map.test.ts +1 -1
  165. package/src/__tests__/reactive-factory-inlining.test.ts +4 -1
  166. package/src/__tests__/rest-binding-gaps.test.ts +192 -0
  167. package/src/__tests__/root-prop-alias.test.ts +79 -1
  168. package/src/__tests__/signal-prop-name-collision.test.ts +102 -2
  169. package/src/__tests__/source-file-cache.test.ts +105 -0
  170. package/src/__tests__/ssr-seed-plan.test.ts +43 -0
  171. package/src/__tests__/static-loop-csr-materialize.test.ts +2 -2
  172. package/src/__tests__/static-record-literal-array.test.ts +171 -0
  173. package/src/__tests__/string-concat-identifier.test.ts +40 -1
  174. package/src/__tests__/template-parts-literal-boundary.test.ts +19 -0
  175. package/src/adapters/ambiguous-nil-arithmetic.ts +103 -0
  176. package/src/adapters/attr-plan.ts +6 -2
  177. package/src/adapters/boolean-carrier.ts +76 -0
  178. package/src/adapters/boolean-result.ts +72 -66
  179. package/src/adapters/brace-delimiter-text.ts +25 -0
  180. package/src/adapters/callback-method.ts +151 -27
  181. package/src/adapters/component-props.ts +28 -8
  182. package/src/adapters/computed-const.ts +443 -10
  183. package/src/adapters/dsl-template-adapter.ts +79 -2
  184. package/src/adapters/loop-bound-names.ts +9 -1
  185. package/src/adapters/loop-plan.ts +1 -1
  186. package/src/adapters/loop-row-type.ts +139 -0
  187. package/src/adapters/nil-reading.ts +297 -0
  188. package/src/adapters/non-primitive-equality.ts +92 -0
  189. package/src/adapters/number-value.ts +108 -0
  190. package/src/adapters/operand-typing.ts +522 -0
  191. package/src/adapters/parsed-expr-emitter.ts +154 -19
  192. package/src/adapters/primitive-plan.ts +696 -0
  193. package/src/analyzer-context.ts +14 -0
  194. package/src/analyzer.ts +692 -85
  195. package/src/augment-inherited-props.ts +108 -10
  196. package/src/compiler.ts +17 -0
  197. package/src/event-handler-name.ts +15 -0
  198. package/src/expression-parser.ts +74 -2
  199. package/src/index.ts +45 -9
  200. package/src/ir-to-client-js/build-references.ts +69 -0
  201. package/src/ir-to-client-js/child-props-object.ts +106 -0
  202. package/src/ir-to-client-js/collect-elements.ts +100 -67
  203. package/src/ir-to-client-js/compute-inlinability.ts +1 -1
  204. package/src/ir-to-client-js/control-flow/plan/build-component-loop.ts +15 -1
  205. package/src/ir-to-client-js/control-flow/plan/build-inner-loop.ts +85 -5
  206. package/src/ir-to-client-js/control-flow/plan/build-lazy-row.ts +3 -0
  207. package/src/ir-to-client-js/control-flow/plan/build-loop-child-arm.ts +30 -28
  208. package/src/ir-to-client-js/control-flow/plan/build-reactive-effects.ts +1 -0
  209. package/src/ir-to-client-js/control-flow/plan/inner-loop.ts +5 -4
  210. package/src/ir-to-client-js/control-flow/plan/loop-child-arm.ts +2 -0
  211. package/src/ir-to-client-js/control-flow/plan/loop.ts +12 -0
  212. package/src/ir-to-client-js/control-flow/plan/reactive-effects.ts +2 -0
  213. package/src/ir-to-client-js/control-flow/shared.ts +23 -24
  214. package/src/ir-to-client-js/control-flow/stringify/claim-plan.ts +29 -0
  215. package/src/ir-to-client-js/control-flow/stringify/component-loop.ts +8 -2
  216. package/src/ir-to-client-js/control-flow/stringify/event-listener.ts +8 -1
  217. package/src/ir-to-client-js/control-flow/stringify/inner-loop.ts +8 -7
  218. package/src/ir-to-client-js/control-flow/stringify/lazy-row.ts +8 -7
  219. package/src/ir-to-client-js/control-flow/stringify/loop-child-arm.ts +4 -4
  220. package/src/ir-to-client-js/control-flow/stringify/loop.ts +3 -3
  221. package/src/ir-to-client-js/control-flow/stringify/reactive-effects.ts +6 -6
  222. package/src/ir-to-client-js/emit-reactive.ts +1 -1
  223. package/src/ir-to-client-js/html-template.ts +95 -38
  224. package/src/ir-to-client-js/imports.ts +1 -1
  225. package/src/ir-to-client-js/index.ts +53 -11
  226. package/src/ir-to-client-js/plan/build-static-array-child-init.ts +42 -15
  227. package/src/ir-to-client-js/plan/static-array-child-init.ts +34 -19
  228. package/src/ir-to-client-js/prop-handling.ts +22 -3
  229. package/src/ir-to-client-js/reactivity.ts +14 -0
  230. package/src/ir-to-client-js/safe-html.ts +11 -4
  231. package/src/ir-to-client-js/stringify/static-array-child-init.ts +30 -12
  232. package/src/ir-to-client-js/types.ts +23 -0
  233. package/src/ir-to-client-js/utils.ts +15 -1
  234. package/src/jsx-to-ir.ts +510 -58
  235. package/src/nullable-signal-attr.ts +366 -28
  236. package/src/prop-rewrite.ts +30 -6
  237. package/src/props-binding.ts +54 -3
  238. package/src/props-object-whole-read.ts +87 -0
  239. package/src/rich-type-refusal.ts +2 -1
  240. package/src/scope/binding-scope.ts +203 -11
  241. package/src/scope/lexical-scope-walk.ts +4 -3
  242. package/src/scope/root-prop-alias.ts +23 -0
  243. package/src/signal-prop-name-collision.ts +113 -22
  244. package/src/ssr-defaults.ts +10 -4
  245. package/src/ssr-seed-plan.ts +82 -17
  246. package/src/strip-types.ts +31 -3
  247. package/src/template-parts.ts +21 -1
  248. package/src/template-position-walk.ts +57 -28
  249. package/src/types.ts +117 -0
@@ -36,6 +36,8 @@
36
36
  import type { ParsedExpr, FlatDepth, TemplatePart, ObjectLiteralProperty } from '../expression-parser.ts'
37
37
  import { asCallbackMethodCall } from '../expression-parser.ts'
38
38
  import type { LoweringMatcher, LoweringNode } from '../lowering-registry.ts'
39
+ import { booleanValueSites, foldNegatedNumberLiteral, planPrimitive, planToString, type PrimitiveInputs, type PrimitivePlan } from './primitive-plan.ts'
40
+ import { rewriteNilReadings, rewriteNilReadingsDeep } from './nil-reading.ts'
39
41
 
40
42
  export type HigherOrderMethod = 'filter' | 'every' | 'some' | 'find' | 'findIndex' | 'findLast' | 'findLastIndex'
41
43
 
@@ -121,10 +123,26 @@ export interface LoweringEmitter {
121
123
  * the emitter can inspect their kinds before deciding how to lower
122
124
  * them, plus an `emit` callback to recurse on any child it wants the
123
125
  * default rendering for.
126
+ *
127
+ * The primitive operations (`binary`, `unary`, `logical`, a `conditional`'s
128
+ * test, `indexAccess`, a computed `member`, a number `literal`) also receive
129
+ * their {@link PrimitivePlan} as the last parameter (#3824,
130
+ * `spec/js-primitive-semantics.md` "How it reaches emitters"): native or
131
+ * helper, decided once by `planPrimitive` from the emitter's
132
+ * {@link ParsedExprEmitter.primitives}. `null` for a node that is not a
133
+ * primitive operation (a non-number literal, a non-computed member, loose
134
+ * `==`, …). Step 0: every emitter accepts the plan and keeps its own
135
+ * spelling; the rollout makes each one spell the plan.
124
136
  */
125
137
  export interface ParsedExprEmitter {
138
+ /**
139
+ * The inputs `planPrimitive` reads for this emitter: the operand typing at
140
+ * the emission site (the component's `collectOperandTyping` through the
141
+ * current `BindingScope`) and the target's `NativeSafeTable`.
142
+ */
143
+ readonly primitives: PrimitiveInputs
126
144
  identifier(name: string): string
127
- literal(value: string | number | boolean | null, literalType: LiteralType): string
145
+ literal(value: string | number | boolean | null, literalType: LiteralType, plan: PrimitivePlan | null): string
128
146
  call(callee: ParsedExpr, args: ParsedExpr[], emit: (e: ParsedExpr) => string): string
129
147
  // Optional (#2843): when present, `emitParsedExpr`'s `call` case tries
130
148
  // every matcher FIRST — before `call()` itself, and before the
@@ -137,6 +155,13 @@ export interface ParsedExprEmitter {
137
155
  // registry inline in its own `call()` per #2842) — behaviour is then
138
156
  // byte-identical to before this field existed.
139
157
  lowering?: LoweringEmitter
158
+ /**
159
+ * Spell a boolean-value plan (#3824 step 5): materialize `rendered`, a
160
+ * boolean whose value leaves the expression, as the host's boolean.
161
+ * {@link emitParsedValue} calls it only for a `helper` plan, so a target
162
+ * whose `NativeSafeTable` claims `boolean-value` never needs it.
163
+ */
164
+ booleanValue?(rendered: string, plan: PrimitivePlan): string
140
165
  // `optional` is true for a `?.`-written access (`user?.name`); see the
141
166
  // `ParsedExpr` `member` variant's docstring in `expression-parser.ts`
142
167
  // for the single-hop caveat. Every adapter's `member()` implementation
@@ -148,6 +173,7 @@ export interface ParsedExprEmitter {
148
173
  computed: boolean,
149
174
  optional: boolean,
150
175
  emit: (e: ParsedExpr) => string,
176
+ plan: PrimitivePlan | null,
151
177
  ): string
152
178
  // Element access with a non-literal index (`arr[index]`). The index
153
179
  // is a full `ParsedExpr` (loop variable, arithmetic, etc.); the
@@ -156,22 +182,30 @@ export interface ParsedExprEmitter {
156
182
  object: ParsedExpr,
157
183
  index: ParsedExpr,
158
184
  emit: (e: ParsedExpr) => string,
185
+ plan: PrimitivePlan | null,
159
186
  ): string
160
- binary(op: string, left: ParsedExpr, right: ParsedExpr, emit: (e: ParsedExpr) => string): string
161
- unary(op: string, argument: ParsedExpr, emit: (e: ParsedExpr) => string): string
187
+ binary(op: string, left: ParsedExpr, right: ParsedExpr, emit: (e: ParsedExpr) => string, plan: PrimitivePlan | null): string
188
+ unary(op: string, argument: ParsedExpr, emit: (e: ParsedExpr) => string, plan: PrimitivePlan | null): string
162
189
  logical(
163
190
  op: '&&' | '||' | '??',
164
191
  left: ParsedExpr,
165
192
  right: ParsedExpr,
166
193
  emit: (e: ParsedExpr) => string,
194
+ plan: PrimitivePlan | null,
167
195
  ): string
168
196
  conditional(
169
197
  test: ParsedExpr,
170
198
  consequent: ParsedExpr,
171
199
  alternate: ParsedExpr,
172
200
  emit: (e: ParsedExpr) => string,
201
+ plan: PrimitivePlan | null,
173
202
  ): string
174
- templateLiteral(parts: TemplatePart[], emit: (e: ParsedExpr) => string): string
203
+ /**
204
+ * `plans[i]` is the ToString plan of `parts[i]` (`planToString`, #3824
205
+ * step 4) for an expression part, null for a string part: the part as it
206
+ * is when native, through the runtime's `to_string` otherwise.
207
+ */
208
+ templateLiteral(parts: TemplatePart[], emit: (e: ParsedExpr) => string, plans: readonly (PrimitivePlan | null)[]): string
175
209
  // A higher-order callback method call (`<object>.<method>(<arrow>, …rest)`,
176
210
  // method ∈ `CALLBACK_METHODS`): `.filter`/`.find`/`.every`/`.some`/`.sort`/
177
211
  // `.reduce`/`.flatMap`/… (#2018 P5). The adapter serializes the `arrow` body
@@ -232,6 +266,24 @@ export interface ParsedExprEmitter {
232
266
  unsupported(raw: string, reason: string): string
233
267
  }
234
268
 
269
+ /**
270
+ * The adapter's string typing of a name at the emission site (its
271
+ * `BindingScope`): `componentProperty` when the read is `props.<name>`,
272
+ * `path` when it is the member chain `name.<path…>` (`row.id`).
273
+ */
274
+ export type StringNameTest = (name: string, componentProperty?: boolean, path?: readonly string[]) => boolean
275
+
276
+ /** `row.id.label` as its root name and field path; null for any other shape. */
277
+ function memberChain(expr: Extract<ParsedExpr, { kind: 'member' }>): { root: string; path: string[] } | null {
278
+ const path: string[] = []
279
+ let current: ParsedExpr = expr
280
+ while (current.kind === 'member' && !current.computed) {
281
+ path.unshift(current.property)
282
+ current = current.object
283
+ }
284
+ return current.kind === 'identifier' ? { root: current.name, path } : null
285
+ }
286
+
235
287
  /**
236
288
  * Whether an operand is string-typed, as far as the ParsedExpr tree can
237
289
  * tell: a string literal, a template literal, a zero-arg getter call /
@@ -244,7 +296,7 @@ export interface ParsedExprEmitter {
244
296
  * Consumed by `===`/`!==` lowering on backends whose `==` is numeric
245
297
  * (Perl `eq`/`ne`) and by `isStringConcatBinary` below.
246
298
  */
247
- export function isStringTypedOperand(expr: ParsedExpr, isStringName: (n: string, componentProperty?: boolean) => boolean): boolean {
299
+ export function isStringTypedOperand(expr: ParsedExpr, isStringName: StringNameTest): boolean {
248
300
  if (expr.kind === 'literal' && expr.literalType === 'string') return true
249
301
  if (expr.kind === 'template-literal') return true
250
302
  if (expr.kind === 'call' && expr.callee.kind === 'identifier' && expr.args.length === 0) {
@@ -253,6 +305,14 @@ export function isStringTypedOperand(expr: ParsedExpr, isStringName: (n: string,
253
305
  if (expr.kind === 'member' && expr.object.kind === 'identifier' && expr.object.name === 'props') {
254
306
  return isStringName(expr.property, true)
255
307
  }
308
+ // A field read (`row.id`, `row.meta.label`): string-typed when the
309
+ // binding's declared type says the field is (#3762). A member of a
310
+ // string-typed name is never itself a string (`label.length`), which also
311
+ // keeps a test that types the name alone from typing its members.
312
+ if (expr.kind === 'member') {
313
+ const chain = memberChain(expr)
314
+ return chain !== null && !isStringName(chain.root) && isStringName(chain.root, false, chain.path)
315
+ }
256
316
  // A bare identifier (#2212): a destructured prop param or a same-file
257
317
  // local const, string-typed per the caller's `isStringName` set — each
258
318
  // adapter's `collectStringValueNames` already tracks `propsParams`, so a
@@ -282,7 +342,7 @@ export function isStringConcatBinary(
282
342
  op: string,
283
343
  left: ParsedExpr,
284
344
  right: ParsedExpr,
285
- isStringName: (n: string, componentProperty?: boolean) => boolean,
345
+ isStringName: StringNameTest,
286
346
  ): boolean {
287
347
  return op === '+' && (isStringTypedOperand(left, isStringName) || isStringTypedOperand(right, isStringName))
288
348
  }
@@ -296,7 +356,7 @@ export function isStringConcatBinary(
296
356
  */
297
357
  export function isNumericArithmeticResult(
298
358
  expr: ParsedExpr | null | undefined,
299
- isStringName: (n: string, componentProperty?: boolean) => boolean,
359
+ isStringName: StringNameTest,
300
360
  ): boolean {
301
361
  if (!expr) return false
302
362
  if (expr.kind === 'unary') return expr.op === '-'
@@ -428,6 +488,17 @@ export function asToStringCall(expr: ParsedExpr): ParsedExpr | null {
428
488
  return callee.object
429
489
  }
430
490
 
491
+ /**
492
+ * The plan `emitParsedExpr` hands an emitter method for `expr`: decided by
493
+ * `planPrimitive` from the emitter's own typing and native-safe table.
494
+ */
495
+ export function primitivePlanFor(expr: ParsedExpr, emitter: Pick<ParsedExprEmitter, 'primitives'>): PrimitivePlan | null {
496
+ // The two kinds that are mostly not primitive operations skip the typing.
497
+ if (expr.kind === 'literal' && expr.literalType !== 'number') return null
498
+ if (expr.kind === 'member' && !expr.computed) return null
499
+ return planPrimitive(expr, emitter.primitives.typing(), emitter.primitives.nativeSafe)
500
+ }
501
+
431
502
  /**
432
503
  * Single point of dispatch from `ParsedExpr.kind` to the adapter's
433
504
  * method. Adapters call this once at their entry point; the recursion
@@ -437,13 +508,72 @@ export function asToStringCall(expr: ParsedExpr): ParsedExpr | null {
437
508
  * a TS compile error here — and, transitively, in every adapter that
438
509
  * hasn't extended its `ParsedExprEmitter` implementation.
439
510
  */
440
- export function emitParsedExpr(expr: ParsedExpr, emitter: ParsedExprEmitter): string {
441
- const emit = (child: ParsedExpr): string => emitParsedExpr(child, emitter)
511
+ export function emitParsedExpr(
512
+ expr: ParsedExpr,
513
+ emitter: ParsedExprEmitter,
514
+ sites?: ReadonlyMap<ParsedExpr, PrimitivePlan>,
515
+ ): string {
516
+ const rendered = dispatchParsedExpr(expr, emitter, sites)
517
+ const plan = sites?.get(expr)
518
+ return plan?.mode === 'helper' && emitter.booleanValue ? emitter.booleanValue(rendered, plan) : rendered
519
+ }
520
+
521
+ /**
522
+ * {@link emitParsedExpr} for `expr` read as a value that leaves the
523
+ * expression (a child prop, a stored seed, a `JSON.stringify` argument, a
524
+ * displayed text child): every boolean its value can be is spelled through
525
+ * the boolean-value plan `booleanValueSites` decides (#3824 step 5).
526
+ */
527
+ export function emitParsedValue(expr: ParsedExpr, emitter: ParsedExprEmitter): string {
528
+ return emitParsedExpr(expr, emitter, booleanValueSites(expr, emitter.primitives.nativeSafe))
529
+ }
530
+
531
+ /**
532
+ * The ToString plans of a template literal's parts, for
533
+ * {@link ParsedExprEmitter.templateLiteral}: null for a string part.
534
+ */
535
+ export function templatePartPlans(parts: readonly TemplatePart[], emitter: Pick<ParsedExprEmitter, 'primitives'>): (PrimitivePlan | null)[] {
536
+ const typing = emitter.primitives.typing()
537
+ return parts.map(p => (p.type === 'expression' ? planToString(p.expr, typing, emitter.primitives.nativeSafe) : null))
538
+ }
539
+
540
+ /**
541
+ * `expr` with the nil-reading rewrite applied to its own operands
542
+ * (`rewriteNilReadings`, #3824 step 4), in the emitter's scope. Only the
543
+ * kinds whose coercion the rewrite reads take the typing.
544
+ */
545
+ export function withNilReadings(expr: ParsedExpr, emitter: Pick<ParsedExprEmitter, 'primitives'>): ParsedExpr {
546
+ if (expr.kind !== 'binary' && expr.kind !== 'unary' && expr.kind !== 'template-literal') return expr
547
+ return rewriteNilReadings(expr, emitter.primitives.typing())
548
+ }
549
+
550
+ /**
551
+ * A callback's arrow with the nil-reading rewrite run over its whole body:
552
+ * the body reaches the runtime evaluator (or the adapter's own predicate
553
+ * form) without passing through {@link emitParsedExpr} node by node.
554
+ */
555
+ function withNilReadingBody(
556
+ arrow: Extract<ParsedExpr, { kind: 'arrow' }>,
557
+ emitter: Pick<ParsedExprEmitter, 'primitives'>,
558
+ ): Extract<ParsedExpr, { kind: 'arrow' }> {
559
+ const body = rewriteNilReadingsDeep(arrow.body, emitter.primitives.typing().enterCallback(arrow.params))
560
+ return body === arrow.body ? arrow : { ...arrow, body }
561
+ }
562
+
563
+ function dispatchParsedExpr(
564
+ original: ParsedExpr,
565
+ emitter: ParsedExprEmitter,
566
+ sites: ReadonlyMap<ParsedExpr, PrimitivePlan> | undefined,
567
+ ): string {
568
+ const emit = (child: ParsedExpr): string => emitParsedExpr(child, emitter, sites)
569
+ // The nil-reading rewrite runs wherever the plan runs: each operand whose
570
+ // nil Phase 1 can read is made non-nil before the node is planned.
571
+ const expr = withNilReadings(original, emitter)
442
572
  switch (expr.kind) {
443
573
  case 'identifier':
444
574
  return emitter.identifier(expr.name)
445
575
  case 'literal':
446
- return emitter.literal(expr.value, expr.literalType)
576
+ return emitter.literal(expr.value, expr.literalType, primitivePlanFor(expr, emitter))
447
577
  case 'call': {
448
578
  // #2843: a registered lowering plugin's call wins in EVERY value
449
579
  // position this dispatcher reaches, not only an adapter's own
@@ -471,23 +601,28 @@ export function emitParsedExpr(expr: ParsedExpr, emitter: ParsedExprEmitter): st
471
601
  // A higher-order callback call (`arr.filter(p)` / `arr.sort(cmp)` / …)
472
602
  // routes to the dedicated `callbackMethod` arm; any other call is generic.
473
603
  const cb = asCallbackMethodCall(expr)
474
- if (cb) return emitter.callbackMethod(cb.method, cb.object, cb.arrow, cb.args, emit)
604
+ if (cb) return emitter.callbackMethod(cb.method, cb.object, withNilReadingBody(cb.arrow, emitter), cb.args, emit)
475
605
  return emitter.call(expr.callee, expr.args, emit)
476
606
  }
477
607
  case 'member':
478
- return emitter.member(expr.object, expr.property, expr.computed, expr.optional, emit)
608
+ return emitter.member(expr.object, expr.property, expr.computed, expr.optional, emit, primitivePlanFor(expr, emitter))
479
609
  case 'index-access':
480
- return emitter.indexAccess(expr.object, expr.index, emit)
610
+ return emitter.indexAccess(expr.object, expr.index, emit, primitivePlanFor(expr, emitter))
481
611
  case 'binary':
482
- return emitter.binary(expr.op, expr.left, expr.right, emit)
483
- case 'unary':
484
- return emitter.unary(expr.op, expr.argument, emit)
612
+ return emitter.binary(expr.op, expr.left, expr.right, emit, primitivePlanFor(expr, emitter))
613
+ case 'unary': {
614
+ // `-1.5` is the literal `-1.5` (#3824 step 6): a unary minus over a
615
+ // non-zero number literal is spelled as the literal it folds into.
616
+ const folded = foldNegatedNumberLiteral(expr)
617
+ if (folded) return emitter.literal(folded.value, 'number', primitivePlanFor(folded, emitter))
618
+ return emitter.unary(expr.op, expr.argument, emit, primitivePlanFor(expr, emitter))
619
+ }
485
620
  case 'logical':
486
- return emitter.logical(expr.op, expr.left, expr.right, emit)
621
+ return emitter.logical(expr.op, expr.left, expr.right, emit, primitivePlanFor(expr, emitter))
487
622
  case 'conditional':
488
- return emitter.conditional(expr.test, expr.consequent, expr.alternate, emit)
623
+ return emitter.conditional(expr.test, expr.consequent, expr.alternate, emit, primitivePlanFor(expr, emitter))
489
624
  case 'template-literal':
490
- return emitter.templateLiteral(expr.parts, emit)
625
+ return emitter.templateLiteral(expr.parts, emit, templatePartPlans(expr.parts, emitter))
491
626
  case 'arrow':
492
627
  return emitter.arrow(expr.params, expr.body, emit)
493
628
  case 'regex':