@barefootjs/jsx 0.39.7 → 0.39.8

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 (146) hide show
  1. package/dist/adapters/callback-method.d.ts +17 -0
  2. package/dist/adapters/callback-method.d.ts.map +1 -1
  3. package/dist/adapters/component-props.d.ts +80 -13
  4. package/dist/adapters/component-props.d.ts.map +1 -1
  5. package/dist/adapters/dsl-template-adapter.d.ts +151 -0
  6. package/dist/adapters/dsl-template-adapter.d.ts.map +1 -0
  7. package/dist/adapters/jsx-adapter.d.ts +4 -0
  8. package/dist/adapters/jsx-adapter.d.ts.map +1 -1
  9. package/dist/adapters/literal-value.d.ts +2 -2
  10. package/dist/adapters/literal-value.d.ts.map +1 -1
  11. package/dist/adapters/parsed-expr-emitter.d.ts +27 -0
  12. package/dist/adapters/parsed-expr-emitter.d.ts.map +1 -1
  13. package/dist/adapters/style-object.d.ts +33 -0
  14. package/dist/adapters/style-object.d.ts.map +1 -0
  15. package/dist/analyzer.d.ts.map +1 -1
  16. package/dist/children-nullish.d.ts +22 -0
  17. package/dist/children-nullish.d.ts.map +1 -0
  18. package/dist/errors.d.ts +1 -0
  19. package/dist/errors.d.ts.map +1 -1
  20. package/dist/expression-parser.d.ts +9 -19
  21. package/dist/expression-parser.d.ts.map +1 -1
  22. package/dist/free-refs.d.ts +6 -0
  23. package/dist/free-refs.d.ts.map +1 -1
  24. package/dist/index.d.ts +14 -11
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +14685 -14000
  27. package/dist/ir-to-client-js/compute-inlinability.d.ts.map +1 -1
  28. package/dist/ir-to-client-js/control-flow/plan/event-collision.d.ts +2 -1
  29. package/dist/ir-to-client-js/control-flow/plan/event-collision.d.ts.map +1 -1
  30. package/dist/ir-to-client-js/control-flow/plan/insert.d.ts +2 -2
  31. package/dist/ir-to-client-js/control-flow/plan/insert.d.ts.map +1 -1
  32. package/dist/ir-to-client-js/control-flow/stringify/event-delegation.d.ts.map +1 -1
  33. package/dist/ir-to-client-js/control-flow/stringify/event-listener.d.ts +10 -9
  34. package/dist/ir-to-client-js/control-flow/stringify/event-listener.d.ts.map +1 -1
  35. package/dist/ir-to-client-js/csr-substitute.d.ts.map +1 -1
  36. package/dist/ir-to-client-js/emit-reactive.d.ts +1 -1
  37. package/dist/ir-to-client-js/emit-reactive.d.ts.map +1 -1
  38. package/dist/ir-to-client-js/emit-registration.d.ts +10 -8
  39. package/dist/ir-to-client-js/emit-registration.d.ts.map +1 -1
  40. package/dist/ir-to-client-js/generate-init.d.ts.map +1 -1
  41. package/dist/ir-to-client-js/html-template.d.ts +0 -9
  42. package/dist/ir-to-client-js/html-template.d.ts.map +1 -1
  43. package/dist/ir-to-client-js/identifiers.d.ts +6 -8
  44. package/dist/ir-to-client-js/identifiers.d.ts.map +1 -1
  45. package/dist/ir-to-client-js/imports.d.ts +23 -2
  46. package/dist/ir-to-client-js/imports.d.ts.map +1 -1
  47. package/dist/ir-to-client-js/phases/props-extraction.d.ts +3 -2
  48. package/dist/ir-to-client-js/phases/props-extraction.d.ts.map +1 -1
  49. package/dist/ir-to-client-js/prune-unused-prop-extractions.d.ts +1 -1
  50. package/dist/ir-to-client-js/prune-unused-prop-extractions.d.ts.map +1 -1
  51. package/dist/ir-to-client-js/reactivity.d.ts.map +1 -1
  52. package/dist/ir-to-client-js/rewrite-destructured-props.d.ts +1 -1
  53. package/dist/ir-to-client-js/rewrite-destructured-props.d.ts.map +1 -1
  54. package/dist/ir-to-client-js/safe-html.d.ts +20 -2
  55. package/dist/ir-to-client-js/safe-html.d.ts.map +1 -1
  56. package/dist/ir-to-client-js/types.d.ts +3 -3
  57. package/dist/ir-to-client-js/types.d.ts.map +1 -1
  58. package/dist/ir-to-client-js/utils.d.ts +2 -11
  59. package/dist/ir-to-client-js/utils.d.ts.map +1 -1
  60. package/dist/jsx-to-ir.d.ts.map +1 -1
  61. package/dist/nullable-signal-attr.d.ts +40 -10
  62. package/dist/nullable-signal-attr.d.ts.map +1 -1
  63. package/dist/prop-rewrite.d.ts +18 -0
  64. package/dist/prop-rewrite.d.ts.map +1 -1
  65. package/dist/props-binding.d.ts +9 -1
  66. package/dist/props-binding.d.ts.map +1 -1
  67. package/dist/scanner/js-scanner.d.ts.map +1 -1
  68. package/dist/scanner/js-scanner.js +30 -2
  69. package/dist/signal-prop-name-collision.d.ts +6 -5
  70. package/dist/signal-prop-name-collision.d.ts.map +1 -1
  71. package/dist/ssr-defaults.d.ts +28 -0
  72. package/dist/ssr-defaults.d.ts.map +1 -1
  73. package/dist/ssr-seed-plan.d.ts +39 -14
  74. package/dist/ssr-seed-plan.d.ts.map +1 -1
  75. package/dist/types.d.ts +108 -18
  76. package/dist/types.d.ts.map +1 -1
  77. package/dist/value-references.d.ts +21 -0
  78. package/dist/value-references.d.ts.map +1 -1
  79. package/package.json +2 -2
  80. package/src/__tests__/__snapshots__/doc-examples.test.ts.snap +18 -18
  81. package/src/__tests__/adapter-output.test.ts +5 -3
  82. package/src/__tests__/analyzer.test.ts +33 -0
  83. package/src/__tests__/arithmetic-lowering.test.ts +44 -0
  84. package/src/__tests__/children-read.test.ts +226 -0
  85. package/src/__tests__/client-template-escape-soundness.test.ts +31 -1
  86. package/src/__tests__/component-props.test.ts +68 -1
  87. package/src/__tests__/constant-inlining-tree.test.ts +136 -0
  88. package/src/__tests__/destructure-default-reads-earlier-param.test.ts +138 -0
  89. package/src/__tests__/dsl-template-adapter.test.ts +173 -0
  90. package/src/__tests__/event-handler-verbatim.test.ts +73 -0
  91. package/src/__tests__/expression-parser.test.ts +1 -44
  92. package/src/__tests__/nullable-signal-attr.test.ts +67 -3
  93. package/src/__tests__/reference-graph-identifiers.test.ts +161 -0
  94. package/src/__tests__/runtime-import-detection.test.ts +134 -0
  95. package/src/__tests__/signal-prop-name-collision.test.ts +30 -0
  96. package/src/__tests__/ssr-defaults.test.ts +19 -1
  97. package/src/__tests__/ssr-seed-plan.test.ts +119 -0
  98. package/src/__tests__/style-object-plan.test.ts +54 -0
  99. package/src/__tests__/zero-param-helper-inline.test.ts +57 -0
  100. package/src/adapters/callback-method.ts +23 -0
  101. package/src/adapters/component-props.ts +130 -12
  102. package/src/adapters/dsl-template-adapter.ts +248 -0
  103. package/src/adapters/jsx-adapter.ts +12 -6
  104. package/src/adapters/literal-value.ts +2 -2
  105. package/src/adapters/parsed-expr-emitter.ts +34 -0
  106. package/src/adapters/style-object.ts +61 -0
  107. package/src/analyzer.ts +114 -15
  108. package/src/children-nullish.ts +33 -0
  109. package/src/debug.ts +2 -2
  110. package/src/errors.ts +12 -0
  111. package/src/expression-parser.ts +56 -53
  112. package/src/free-refs.ts +28 -17
  113. package/src/index.ts +18 -8
  114. package/src/ir-to-client-js/compute-inlinability.ts +29 -2
  115. package/src/ir-to-client-js/control-flow/plan/event-collision.ts +2 -1
  116. package/src/ir-to-client-js/control-flow/plan/insert.ts +2 -2
  117. package/src/ir-to-client-js/control-flow/stringify/event-delegation.ts +3 -2
  118. package/src/ir-to-client-js/control-flow/stringify/event-listener.ts +13 -12
  119. package/src/ir-to-client-js/csr-substitute.ts +12 -2
  120. package/src/ir-to-client-js/emit-reactive.ts +2 -2
  121. package/src/ir-to-client-js/emit-registration.ts +28 -57
  122. package/src/ir-to-client-js/generate-init.ts +17 -1
  123. package/src/ir-to-client-js/html-template.ts +30 -50
  124. package/src/ir-to-client-js/identifiers.ts +75 -24
  125. package/src/ir-to-client-js/imports.ts +56 -19
  126. package/src/ir-to-client-js/index.ts +2 -1
  127. package/src/ir-to-client-js/phases/event-handlers.ts +2 -2
  128. package/src/ir-to-client-js/phases/props-extraction.ts +16 -15
  129. package/src/ir-to-client-js/plan/build-declaration-emit.ts +2 -2
  130. package/src/ir-to-client-js/prune-unused-prop-extractions.ts +7 -4
  131. package/src/ir-to-client-js/reactivity.ts +2 -2
  132. package/src/ir-to-client-js/rewrite-destructured-props.ts +21 -4
  133. package/src/ir-to-client-js/safe-html.ts +29 -35
  134. package/src/ir-to-client-js/types.ts +3 -2
  135. package/src/ir-to-client-js/utils.ts +2 -26
  136. package/src/jsx-to-ir.ts +279 -78
  137. package/src/nullable-signal-attr.ts +149 -33
  138. package/src/prop-rewrite.ts +41 -0
  139. package/src/props-binding.ts +17 -2
  140. package/src/scanner/__tests__/js-scanner.test.ts +37 -0
  141. package/src/scanner/js-scanner.ts +64 -4
  142. package/src/signal-prop-name-collision.ts +50 -24
  143. package/src/ssr-defaults.ts +47 -20
  144. package/src/ssr-seed-plan.ts +103 -23
  145. package/src/types.ts +115 -19
  146. package/src/value-references.ts +132 -0
@@ -141,6 +141,23 @@ export declare function unloweredCallRefusal(callee: ParsedExpr, args: readonly
141
141
  message: string;
142
142
  suggestion: string;
143
143
  };
144
+ /**
145
+ * BF101 for a `.filter(...).map(...)` predicate shape a DSL adapter's filter
146
+ * emitter has no form for: a conditional, a template literal, an object
147
+ * literal, a standalone arrow or regex, or an unsupported node (#3534). The
148
+ * emitters used to stand a truthy constant in for these, so every row
149
+ * rendered; the same predicate outside a loop is evaluated or refused, never
150
+ * guessed.
151
+ */
152
+ export declare function filterPredicateShapeRefusal(shape: string, adapterName: string): {
153
+ message: string;
154
+ suggestion: string;
155
+ };
156
+ /** BF101 for a loop filter whose predicate never reached the IR (#3534). */
157
+ export declare function missingFilterPredicateRefusal(raw: string, adapterName: string): {
158
+ message: string;
159
+ suggestion: string;
160
+ };
144
161
  /**
145
162
  * The BF101 for a callback method nested inside a filter predicate, which a
146
163
  * predicate emitter has no scalar form for.
@@ -1 +1 @@
1
- {"version":3,"file":"callback-method.d.ts","sourceRoot":"","sources":["../../src/adapters/callback-method.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"callback-method.d.ts","sourceRoot":"","sources":["../../src/adapters/callback-method.ts"],"names":[],"mappings":"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"}
@@ -5,15 +5,19 @@
5
5
  * Every DSL adapter assembles them the same way: callback props and `ref`
6
6
  * are client-only and dropped; a named JSX-valued prop is captured as
7
7
  * HTML; `{...props}` (the component's own props object, which no DSL scope
8
- * holds as one value) enumerates the props params; any other spread is
9
- * folded in at its source position, so a later entry wins on a key
10
- * conflict, as in `{...a, ...b}`; then the compiler-controlled `_bf_slot`
11
- * and `children` entries come last, so a spread can never override them.
8
+ * holds as one value) enumerates the props params, and a param that
9
+ * something earlier in the call may have set is carried only when the
10
+ * caller passed it ({@link propsSpreadParam}); any other spread is folded
11
+ * in at its source position, so a later entry wins on a key conflict, as in
12
+ * `{...a, ...b}`; then the compiler-controlled `_bf_slot` and `children`
13
+ * entries come last, so a spread can never override them.
12
14
  * {@link planComponentProps} makes those decisions once. An adapter spells
13
15
  * the entries and spreads through {@link spellComponentProps}, keeps its
14
16
  * own capture mechanism (`{% set %}…{% endset %}`, `_erbout.slice!`,
15
17
  * `begin … end`, a Kolon macro), and folds the spelled segments into its
16
- * own hash literal.
18
+ * own hash literal. An adapter that builds the child's input as a typed
19
+ * literal at compile time instead (Go's `<Child>Input{...}`) reads the same
20
+ * plan one key at a time through {@link resolveComponentPropKeys}.
17
21
  */
18
22
  import type { AttrValue, IRComponent, IRNode, SpreadAttr } from '../types.ts';
19
23
  /** One entry of the props hash. */
@@ -45,31 +49,69 @@ export type ComponentPropEntry =
45
49
  kind: 'children';
46
50
  children: IRNode[];
47
51
  };
48
- /** A run of entries, or a spread folded in at its source position. */
52
+ /**
53
+ * A run of entries, a spread folded in at its source position, or one param
54
+ * of `{...props}` that the spread carries only when the caller passed it
55
+ * ({@link propsSpreadParam}). An adapter folds a `present-param` in like a
56
+ * spread of a one-key (or empty) hash.
57
+ */
49
58
  export type ComponentPropSegment = {
50
59
  kind: 'entries';
51
60
  entries: ComponentPropEntry[];
52
61
  } | {
53
62
  kind: 'spread';
54
63
  value: SpreadAttr;
64
+ } | {
65
+ kind: 'present-param';
66
+ name: string;
55
67
  };
68
+ /** A props param as `{...props}` enumerates it. */
69
+ export interface ComponentPropsParam {
70
+ name: string;
71
+ /** `false` for a required param, which the caller always passes. Unknown counts as optional. */
72
+ optional?: boolean;
73
+ }
56
74
  export interface ComponentPropsOptions {
57
75
  /** The SolidJS-style props identifier (`function C(props: P)`), if any. */
58
76
  propsObjectName: string | null;
59
77
  /** The analyzer-extracted props params, which `{...props}` enumerates. */
60
- propsParams: ReadonlyArray<{
61
- name: string;
62
- }>;
78
+ propsParams: ReadonlyArray<ComponentPropsParam>;
63
79
  }
80
+ /** What a call has set before a `{...props}` spread, as far as the compiler can see. */
81
+ export interface EarlierComponentProps {
82
+ /** The keys an earlier entry sets. */
83
+ keys: ReadonlySet<string>;
84
+ /** Whether an earlier spread whose keys are unknown may have set any key. */
85
+ spread: boolean;
86
+ }
87
+ /**
88
+ * How `{...props}` carries one param. JS spreads only the keys the props
89
+ * object has, so a param the caller left out keeps whatever an earlier entry
90
+ * or spread set: `<Tag size="s" {...props} />` keeps `size="s"` when the
91
+ * caller passes no `size`.
92
+ *
93
+ * - `'entry'`: an ordinary entry. Either nothing earlier can set the key, so
94
+ * an absent param and a nil one read the same to the child, or the param is
95
+ * required, so the caller always passes it and it always wins.
96
+ * - `'present'`: carried only when the caller passed it, so an absent param
97
+ * leaves the earlier value alone.
98
+ *
99
+ * A template backend reads an absent prop and an explicit `undefined` or
100
+ * `null` one as the same nil, so "passed" is spelled "not nil" there: a
101
+ * caller that passes `undefined`/`null` keeps the earlier value, where JS
102
+ * would override it with the nil (limitation
103
+ * `props-spread-explicit-null-override`).
104
+ */
105
+ export declare function propsSpreadParam(param: ComponentPropsParam, earlier: EarlierComponentProps): 'entry' | 'present';
64
106
  /** The key an entry sets in the props hash. */
65
107
  export declare function componentPropKey(entry: ComponentPropEntry): string;
66
108
  /**
67
109
  * The ordered props segments for `comp`. The first segment is always an
68
- * (possibly empty) entries segment, and a spread is followed by a new one
69
- * only when an entry comes after it.
110
+ * (possibly empty) entries segment, and a spread or a `present-param` is
111
+ * followed by a new one only when an entry comes after it.
70
112
  */
71
- export declare function planComponentProps(comp: IRComponent, options: ComponentPropsOptions): ComponentPropSegment[];
72
- /** A spelled segment: the entries' hash-literal parts, or the spread's expression. */
113
+ export declare function planComponentProps(comp: Pick<IRComponent, 'props' | 'children' | 'slotId' | 'loopItemRoot'>, options: ComponentPropsOptions): ComponentPropSegment[];
114
+ /** A spelled segment: the entries' hash-literal parts, or the expression a spread folds in. */
73
115
  export type SpelledComponentPropSegment = {
74
116
  kind: 'entries';
75
117
  parts: string[];
@@ -82,12 +124,37 @@ export interface ComponentPropSpelling {
82
124
  entry(entry: ComponentPropEntry): string;
83
125
  /** The expression a spread folds in. */
84
126
  spread(value: SpreadAttr): string;
127
+ /**
128
+ * The expression a `present-param` segment folds in like a spread: a
129
+ * one-key hash `{ name: <param> }` when the param is not nil, an empty
130
+ * hash when it is.
131
+ */
132
+ presentParam(name: string): string;
85
133
  }
86
134
  /**
87
135
  * Spell a plan in source order, so the captures an entry's spelling emits
88
136
  * (named slots, then the children) keep their order and counter values.
89
137
  */
90
138
  export declare function spellComponentProps(segments: readonly ComponentPropSegment[], spelling: ComponentPropSpelling): SpelledComponentPropSegment[];
139
+ /**
140
+ * One key of the props hash, resolved at compile time: the latest of
141
+ * `presentParams` the caller passed, else `base`.
142
+ */
143
+ export interface ResolvedComponentProp {
144
+ key: string;
145
+ /** The last entry that sets the key unconditionally, or null when none does. */
146
+ base: ComponentPropEntry | null;
147
+ /** The `{...props}` params that override `base` when passed, earliest first. */
148
+ presentParams: string[];
149
+ }
150
+ /**
151
+ * A plan resolved one key at a time, in the order the keys are first set,
152
+ * for an adapter that builds the child's input as a typed literal at
153
+ * compile time rather than merging hashes at render time. Null when the
154
+ * plan folds in a spread whose keys are unknown: only a render-time merge
155
+ * can resolve that.
156
+ */
157
+ export declare function resolveComponentPropKeys(segments: readonly ComponentPropSegment[]): ResolvedComponentProp[] | null;
91
158
  /** Whether a spelled plan passes no props at all. */
92
159
  export declare function isEmptyComponentProps(segments: readonly SpelledComponentPropSegment[]): boolean;
93
160
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../../src/adapters/component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7E,mCAAmC;AACnC,MAAM,MAAM,kBAAkB;AAC5B,gFAAgF;AAC9E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACnD,wFAAwF;GACtF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AAC1D,8FAA8F;GAC5F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACvC,yEAAyE;GACvE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrC,gGAAgG;GAC9F;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAE5C,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAEzC,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,0EAA0E;IAC1E,WAAW,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7C;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,EAAE,CAqC5G;AAED,sFAAsF;AACtF,MAAM,MAAM,2BAA2B,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAA;IACxC,wCAAwC;IACxC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,QAAQ,EAAE,qBAAqB,GAC9B,2BAA2B,EAAE,CAU/B;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,GAAG,OAAO,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM3G"}
1
+ {"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../../src/adapters/component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7E,mCAAmC;AACnC,MAAM,MAAM,kBAAkB;AAC5B,gFAAgF;AAC9E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AACnD,wFAAwF;GACtF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AAC1D,8FAA8F;GAC5F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACvC,yEAAyE;GACvE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrC,gGAAgG;GAC9F;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3C,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,0EAA0E;IAC1E,WAAW,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CAChD;AAED,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACzB,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAGhH;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,CAAC,EACzE,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,EAAE,CAqDxB;AAED,+FAA+F;AAC/F,MAAM,MAAM,2BAA2B,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAA;IACxC,wCAAwC;IACxC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAA;IACjC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACnC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,QAAQ,EAAE,qBAAqB,GAC9B,2BAA2B,EAAE,CAW/B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,gFAAgF;IAChF,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC/B,gFAAgF;IAChF,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,GAAG,qBAAqB,EAAE,GAAG,IAAI,CAuBlH;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,GAAG,OAAO,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM3G"}
@@ -0,0 +1,151 @@
1
+ /**
2
+ * The `generate()` the eight DSL template adapters (Blade, ERB, Jinja,
3
+ * Mojolicious, Pebble, MiniJinja, Twig, Xslate) share (#3475), with the
4
+ * per-compile state it sets up. Each adapter renders the nodes in its own
5
+ * template language; how one compile begins and ends lives here once.
6
+ */
7
+ import { type LoweringMatcher } from '../lowering-registry.ts';
8
+ import { type NullishAttrContext } from '../nullable-signal-attr.ts';
9
+ import { BindingScope } from '../scope/binding-scope.ts';
10
+ import type { CompilerError, ComponentIR, IRIfStatement, IRMetadata } from '../types.ts';
11
+ import { type ComputedConstContext } from './computed-const.ts';
12
+ import { BaseAdapter, type AdapterGenerateOptions, type AdapterOutput } from './interface.ts';
13
+ /**
14
+ * How an adapter that renames reserved names spells a source identifier as
15
+ * a template variable, and the engine name its collision diagnostic uses.
16
+ */
17
+ export interface TemplateIdentifierSpelling {
18
+ /** The adapter's mangling (`jinjaIdent`, `twigIdent`, …). */
19
+ ident(name: string): string;
20
+ /** The engine name in the diagnostic ("Jinja", "MiniJinja", …). */
21
+ label: string;
22
+ }
23
+ export declare abstract class DslTemplateAdapter extends BaseAdapter {
24
+ protected componentName: string;
25
+ /** Diagnostics collected while rendering, merged into `ir.errors` at the end. */
26
+ protected errors: CompilerError[];
27
+ /**
28
+ * SolidJS-style props identifier (`function(props: P)`). The spread
29
+ * emission builds a props-object bag from it without re-walking the IR.
30
+ */
31
+ protected propsObjectName: string | null;
32
+ /**
33
+ * Name of the destructured `...rest` binding (`function X({ ...rest })`),
34
+ * if any. A closed-type rest-expanded attribute's expression is
35
+ * `${restPropsName}.${key}` (`expandSpreadAttribute`, #3057). Stripping
36
+ * this prefix the same way `propsObjectName.` is stripped lets the
37
+ * nullable-optional-props guard recognise it as a bare optional reference
38
+ * instead of falling through to unconditional emission.
39
+ */
40
+ protected restPropsName: string | null;
41
+ protected propsParams: {
42
+ name: string;
43
+ optional: boolean;
44
+ }[];
45
+ /** Props whose declared TS type is boolean (`collectBooleanTypedProps`). */
46
+ protected booleanTypedProps: Set<string>;
47
+ /** Names (signal getters + props) whose value is a string (`stringValueNamesFor`). */
48
+ protected stringValueNames: Set<string>;
49
+ /**
50
+ * Module-scope pure-string consts (`const x = 'literal'`), keyed by name →
51
+ * unescaped value. A className template literal that references such a
52
+ * const (`className={`${x} ${className}`}`) must inline the literal: the
53
+ * const is module-scope, so it never reaches the per-render context.
54
+ */
55
+ protected moduleStringConsts: Map<string, string>;
56
+ /**
57
+ * (#1922) Local binding names the request-scoped `searchParams()` env
58
+ * signal is imported under (handles `import { searchParams as sp }`). When
59
+ * non-empty the emitter lowers a `<binding>().get(k)` call to a real method
60
+ * call on the per-request `searchParams` reader instead of the generic
61
+ * deref. Read by the top-level ParsedExpr emitter.
62
+ */
63
+ protected _searchParamsLocals: Set<string>;
64
+ /**
65
+ * Call-lowering matchers active for this component (#2057), read by the
66
+ * top-level emitter. Covers both userland plugins and the compiler's
67
+ * built-in plugins (e.g. `queryHref`, #2042): one uniform path, no per-API
68
+ * branch.
69
+ */
70
+ protected _loweringMatchers: LoweringMatcher[];
71
+ /** The component's computed consts, inlined where a template reads them (#3494). */
72
+ protected computedConsts: ComputedConstContext | null;
73
+ /**
74
+ * Local + module constants from the IR, used by the conditional-spread and
75
+ * `Record<staticKeys, scalar>[propKey]` lowering paths (#textarea /
76
+ * #checkbox): the spread emission resolves a bare local const
77
+ * (`const sizeAttrs = size ? {…} : {}`) to its initializer text.
78
+ */
79
+ protected localConstants: IRMetadata['localConstants'];
80
+ /** Each prop's collision-free root alias (#3314), decided once per component. */
81
+ protected rootPropAliases: ReadonlyMap<string, string>;
82
+ /**
83
+ * The one canonical, position-accurate "names bound by an enclosing loop
84
+ * callback" service (#2482 Stage 2). Every shadow-guard site reads this
85
+ * one threaded, immutable scope: `renderLoop` enters the row with
86
+ * `enterLoopRow` around the loop's children and restores the outer scope
87
+ * by reference afterwards, mirroring `ctx.scope` in `jsx-to-ir.ts`.
88
+ * `IRLoop` structurally satisfies `LoopBindingSource`, so `renderLoop`
89
+ * passes the loop node straight to `enterLoopRow`.
90
+ */
91
+ protected scope: BindingScope;
92
+ /**
93
+ * Optional, no-default props that are absent when the caller omits them
94
+ * (`collectNullableOptionalProps`). A bare-reference attribute of one is
95
+ * guarded with the template's presence test, so the attribute drops rather
96
+ * than rendering `attr=""` (Hono-style nullish omission, e.g. textarea's
97
+ * `rows`).
98
+ */
99
+ protected nullableOptionalProps: Set<string>;
100
+ /** Getters of nullable signals (`collectNullableSignalGetters`, #3304). */
101
+ protected nullableSignalGetters: Set<string>;
102
+ /** Signals and memos `attrValueMayBeNullish` reads (#3322). */
103
+ protected nullishAttrCtx: NullishAttrContext;
104
+ /**
105
+ * Local alias -> declared/exported name for imported components (#2822,
106
+ * the SSR-side counterpart of #2777's client-JS registry-key fix). A child
107
+ * referenced under an import alias (`import { Foo as Bar }`, `<Bar/>`)
108
+ * must build its cross-template call against the child's own declared
109
+ * name (`Foo`, what `foo.tsx` registers its template as), never the
110
+ * caller-local binding. Read by `childTemplateName`.
111
+ */
112
+ protected importAliases: Map<string, string>;
113
+ /** Numbers the children captures of a child component that has no slot id. */
114
+ protected childrenCaptureCounter: number;
115
+ /** The adapter's name in the BF103 imported-loop-child diagnostic ("The Jinja adapter emits …"). */
116
+ protected abstract readonly loopChildDiagnosticName: string;
117
+ /**
118
+ * For an adapter that renames reserved names: two source names the
119
+ * renaming turns into one template variable would read the same value, so
120
+ * `generate()` refuses them (#3404). `null` when the adapter renames none.
121
+ */
122
+ protected readonly templateIdentifierSpelling: TemplateIdentifierSpelling | null;
123
+ /** The names whose value is a string, for `stringValueNames`. */
124
+ protected abstract stringValueNamesFor(ir: ComponentIR): Set<string>;
125
+ /**
126
+ * Sets the adapter's own per-compile state. Runs after the shared state
127
+ * above and before any diagnostic or rendering.
128
+ */
129
+ protected resetAdapterState(_ir: ComponentIR): void;
130
+ /** The root `if` statement of a component with conditional returns. */
131
+ protected abstract renderIfStatement(ifStmt: IRIfStatement): string;
132
+ /** The script registrations the template starts with. */
133
+ protected abstract generateScriptRegistrations(ir: ComponentIR, scriptBaseName?: string, scriptAssets?: string[], preloadAssets?: string[]): string;
134
+ /**
135
+ * SSR context consumers (`const x = useContext(Ctx)`): seeds each local
136
+ * from the active provider value, or the `createContext` default. The
137
+ * provider side pushes the value via `emitProvider` (#1297).
138
+ */
139
+ protected abstract contextConsumerSeed(ir: ComponentIR): string;
140
+ /**
141
+ * Prop/signal-derived memos with a `null` static SSR default (e.g.
142
+ * `createMemo(() => props.value * 10)`), computed in-template from the
143
+ * already-seeded prop/signal vars, mirroring Go's generated child
144
+ * constructor (#1297).
145
+ */
146
+ protected abstract derivedMemoSeed(ir: ComponentIR): string;
147
+ generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
148
+ private resetCompileState;
149
+ private collectCompileErrors;
150
+ }
151
+ //# sourceMappingURL=dsl-template-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dsl-template-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/dsl-template-adapter.ts"],"names":[],"mappings":"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"}
@@ -124,6 +124,10 @@ export declare abstract class JsxAdapter extends BaseAdapter {
124
124
  * `expr` (a presence peel, a prop-ref rewrite) fails the identity check
125
125
  * and wins, so this can only ever add the annotation, never undo a
126
126
  * downstream edit.
127
+ *
128
+ * The same identity rule brings back the author's own type syntax
129
+ * (`value={store as never}`, #2573): `typed.tsx` is written only while
130
+ * `expr` is still the text it was captured beside.
127
131
  */
128
132
  protected expressionValueToJs(value: Extract<AttrValue, {
129
133
  kind: 'expression';
@@ -1 +1 @@
1
- {"version":3,"file":"jsx-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/jsx-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,MAAM,EACN,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAM1D,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,8BAAsB,UAAW,SAAQ,WAAW;IAClD,SAAS,CAAC,aAAa,EAAE,MAAM,CAAK;IAEpC,yEAAyE;IACzE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IAE9C;;;;;;OAMG;IACH,mBAAmB,EAAE,oBAAoB,CAAa;IAMtD,SAAS,CAAC,sBAAsB,CAC9B,UAAU,EAAE,eAAe,EAAE,GAC5B,MAAM,CAuBR;IAMD;;;;;;;;;;OAUG;IACH,0BAA0B,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA2NnE;IAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0C;IAEhF,SAAS,CAAC,2BAA2B,CAAC,EAAE,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAmFlE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,+BAA+B,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CA0DjE;IAMD,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C;IAMD;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAE1E;IAED;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC,GAAG,MAAM,CASvF;IAMD,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEhD;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;CACF"}
1
+ {"version":3,"file":"jsx-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/jsx-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,MAAM,EACN,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAM1D,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,8BAAsB,UAAW,SAAQ,WAAW;IAClD,SAAS,CAAC,aAAa,EAAE,MAAM,CAAK;IAEpC,yEAAyE;IACzE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;IAE9C;;;;;;OAMG;IACH,mBAAmB,EAAE,oBAAoB,CAAa;IAMtD,SAAS,CAAC,sBAAsB,CAC9B,UAAU,EAAE,eAAe,EAAE,GAC5B,MAAM,CAuBR;IAMD;;;;;;;;;;OAUG;IACH,0BAA0B,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA2NnE;IAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0C;IAEhF,SAAS,CAAC,2BAA2B,CAAC,EAAE,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAmFlE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,SAAS,CAAC,+BAA+B,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAyDjE;IAMD,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C;IAMD;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAE1E;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC,GAAG,MAAM,CAYvF;IAMD,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEhD;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;CACF"}
@@ -7,11 +7,11 @@
7
7
  * literal index from a variable one with {@link isLiteralIndex}.
8
8
  */
9
9
  import type { ParsedExpr } from '../expression-parser.ts';
10
- import type { TypeInfo } from '../types.ts';
10
+ import type { TypeInfo, JsSourceText } from '../types.ts';
11
11
  /** True when `type` is the `string` primitive. */
12
12
  export declare function isStringTypeInfo(type: TypeInfo | undefined): boolean;
13
13
  /** True when `initialValue` is a bare string-literal expression. */
14
- export declare function isBareStringLiteral(initialValue: string | undefined): boolean;
14
+ export declare function isBareStringLiteral(initialValue: JsSourceText | undefined): boolean;
15
15
  /**
16
16
  * True when a parsed index is a numeric or string literal (`arr[0]`,
17
17
  * `m['k']`). The spread lowerings refuse (BF101) an indexed spread value
@@ -1 +1 @@
1
- {"version":3,"file":"literal-value.d.ts","sourceRoot":"","sources":["../../src/adapters/literal-value.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKzD"}
1
+ {"version":3,"file":"literal-value.d.ts","sourceRoot":"","sources":["../../src/adapters/literal-value.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzD,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAInF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKzD"}
@@ -142,6 +142,25 @@ export declare function isStringConcatBinary(op: string, left: ParsedExpr, right
142
142
  * result through their JS `Number::toString` helper instead (#3380).
143
143
  */
144
144
  export declare function isNumericArithmeticResult(expr: ParsedExpr | null | undefined, isStringName: (n: string, componentProperty?: boolean) => boolean): boolean;
145
+ /** A runtime helper of the template-helper catalogue (`spec/template-helpers.md`)
146
+ * that a binary arithmetic operator lowers to. */
147
+ export type ArithmeticHelper = 'mod';
148
+ /**
149
+ * The runtime helper a JS binary arithmetic operator lowers to on every
150
+ * template backend, or `null` when the backend spells the operator itself
151
+ * (#3474). The adapter only spells the call, in its own syntax
152
+ * (`bf.mod(a, b)`, `$bf->mod(a, b)`, `bf_mod a b`), over operands already
153
+ * coerced (`arithmeticOperandCoercion`) and grouped ({@link groupBinaryOperand}).
154
+ *
155
+ * `%` is JS's truncated remainder: the result takes the dividend's sign
156
+ * (`-7 % 2` is `-1`, `7 % -2` is `1`), keeps a fraction (`7.5 % 2` is `1.5`),
157
+ * and is `NaN` for a zero divisor or a `NaN` / infinite dividend. No
158
+ * engine's native operator computes it: Ruby, Python and Perl floor the
159
+ * quotient (`-7 % 2` is `1`), MiniJinja takes the Euclidean remainder, PHP,
160
+ * Perl and Kolon convert the operands to integers first (`NaN % 2` is `0`),
161
+ * and an integer zero divisor raises in Java, PHP and MiniJinja (#3574).
162
+ */
163
+ export declare function arithmeticHelper(op: string): ArithmeticHelper | null;
145
164
  /**
146
165
  * Wrap an emitted binary/logical/ternary OPERAND in parentheses so the
147
166
  * source grouping the `ParsedExpr` tree encodes survives infix
@@ -157,6 +176,14 @@ export declare function isNumericArithmeticResult(expr: ParsedExpr | null | unde
157
176
  * byte-identical.
158
177
  */
159
178
  export declare function groupBinaryOperand(operand: ParsedExpr, emitted: string): string;
179
+ /**
180
+ * Wrap an emitted unary-minus OPERAND in parentheses where the target's
181
+ * prefix `-` would otherwise bind to only part of it (#3474): a compound
182
+ * operand for the reason {@link groupBinaryOperand} gives (`-(a + b)`
183
+ * re-emitted as `-a + b`), and a nested unary operand, since `--x` is a
184
+ * decrement in PHP and Perl. A leaf operand stays unwrapped.
185
+ */
186
+ export declare function groupUnaryOperand(operand: ParsedExpr, emitted: string): string;
160
187
  /**
161
188
  * Split an `object-literal`'s (order-preserving) `properties` into rendered
162
189
  * SEGMENTS an adapter's `objectLiteral()` folds with its own merge idiom
@@ -1 +1 @@
1
- {"version":3,"file":"parsed-expr-emitter.d.ts","sourceRoot":"","sources":["../../src/adapters/parsed-expr-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAEzG,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE5E,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,CAAA;AAEjH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,SAAS,GACT,aAAa,GACb,IAAI,GACJ,QAAQ,GACR,OAAO,GACP,SAAS,GACT,YAAY,GACZ,aAAa,GACb,aAAa,GACb,MAAM,GACN,WAAW,GACX,SAAS,GACT,SAAS,GACT,OAAO,GACP,YAAY,GACZ,UAAU,GACV,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,QAAQ,CAAA;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAA;AAQ5C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAElE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IAC7C,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC3E;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAAA;IAClF,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAWrF,QAAQ,CAAC,EAAE,eAAe,CAAA;IAM1B,MAAM,CACJ,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IAIT,WAAW,CACT,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IACT,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAChG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAChF,OAAO,CACL,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,EACtB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IACT,WAAW,CACT,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,UAAU,EACrB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IACT,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAO/E,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,EAC7C,QAAQ,EAAE,UAAU,EAAE,EACtB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IAIT,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAClF,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAAG,MAAM,CAAA;IAM7E,aAAa,CACX,UAAU,EAAE,qBAAqB,EAAE,EACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IACT,WAAW,CACT,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,EAAE,EAClB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IAkBT,UAAU,CACR,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,EACvC,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,CAAA;IACT,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAsBjI;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,KAAK,OAAO,GAChE,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACnC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,KAAK,OAAO,GAChE,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC5C,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,qBAAqB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KAAK,MAAM,EAC3F,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,GAC9B,MAAM,EAAE,CAmBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAqEnF"}
1
+ {"version":3,"file":"parsed-expr-emitter.d.ts","sourceRoot":"","sources":["../../src/adapters/parsed-expr-emitter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * `style={{ … }}` object-literal lowering plan, shared by the template
3
+ * adapters (#3541).
4
+ *
5
+ * Every adapter used to re-parse the attribute text through
6
+ * `parseStyleObjectEntries` (a fresh `ts.createSourceFile`) and then each
7
+ * dynamic value through `parseExpression`. The IR already carries the
8
+ * object-literal tree on `ExpressionAttr.parsed`, so the plan reads that:
9
+ * the CSS keys are decided here once, and an adapter spells only its
10
+ * `style_object` runtime call. Reading the tree also accepts the shorthand
11
+ * `{ color }`, which the text parser refused.
12
+ */
13
+ import type { ExpressionAttr } from '../types.ts';
14
+ import { type ParsedExpr } from '../expression-parser.ts';
15
+ /** One CSS declaration of a style object: a static string, or a value to lower. */
16
+ export type StyleObjectPlanEntry = {
17
+ cssKey: string;
18
+ kind: 'literal';
19
+ value: string;
20
+ } | {
21
+ cssKey: string;
22
+ kind: 'expr';
23
+ expr: string;
24
+ parsed: ParsedExpr;
25
+ };
26
+ /**
27
+ * The CSS declarations of a `style` attribute's object literal, or `null`
28
+ * when the value is not an object literal every entry of which an adapter
29
+ * can lower: a spread, a numeric key, or a value outside the template
30
+ * subset keeps the attribute on the adapter's refusal path.
31
+ */
32
+ export declare function planStyleObject(value: Pick<ExpressionAttr, 'expr' | 'parsed'>): StyleObjectPlanEntry[] | null;
33
+ //# sourceMappingURL=style-object.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"style-object.d.ts","sourceRoot":"","sources":["../../src/adapters/style-object.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAA;AAEhC,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAA;AAWtE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,oBAAoB,EAAE,GAAG,IAAI,CAmB7G"}
@@ -1 +1 @@
1
- {"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The parts of a `??` / `||` read of the children prop, shared by the Phase 1
3
+ * classifier (`IRExpression.childrenRead`, #3539, #3554) and the emitters
4
+ * that splice the children markup and escape only the fallback.
5
+ */
6
+ import type { ParsedExpr } from './expression-parser.ts';
7
+ /**
8
+ * Split a left-nested chain of one fallback operator (`??` or `||`) into the
9
+ * value it reads first and the fallback taken when that value is nullish
10
+ * (`??`) or falsy (`||`): `(c ?? x) ?? y` reads `c`, else `x ?? y`, the same
11
+ * as `c ?? (x ?? y)`. `null` when `parsed` is not a `op` chain.
12
+ */
13
+ export declare function fallbackChainParts(parsed: ParsedExpr, op: '??' | '||'): {
14
+ head: ParsedExpr;
15
+ fallback: ParsedExpr;
16
+ } | null;
17
+ /** {@link fallbackChainParts} of a `??` chain. */
18
+ export declare function nullishChainParts(parsed: ParsedExpr): {
19
+ head: ParsedExpr;
20
+ fallback: ParsedExpr;
21
+ } | null;
22
+ //# sourceMappingURL=children-nullish.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"children-nullish.d.ts","sourceRoot":"","sources":["../src/children-nullish.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,IAAI,GAAG,IAAI,GACd;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAUnD;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAEvG"}
package/dist/errors.d.ts CHANGED
@@ -24,6 +24,7 @@ export declare const ErrorCodes: {
24
24
  readonly BUILTIN_REQUIRES_IMPORT: 'BF054';
25
25
  readonly INLINED_IMPORT_MISSING_EXPORT: 'BF055';
26
26
  readonly FORMAT_DATE_AUTHORED_CALL: 'BF056';
27
+ readonly RUNTIME_HELPER_NAME_COLLISION: 'BF057';
27
28
  readonly UNDECLARED_INIT_STATEMENT_REFERENCE: 'BF052';
28
29
  readonly STRIPPED_CLIENT_IMPORT_REFERENCED: 'BF053';
29
30
  readonly STAGE_REACTIVE_IN_TEMPLATE: 'BF060';
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
@@ -55,6 +55,7 @@ export type ParsedExpr = {
55
55
  kind: 'arrow';
56
56
  params: string[];
57
57
  body: ParsedExpr;
58
+ callKind?: 'async' | 'generator';
58
59
  } | {
59
60
  kind: 'regex';
60
61
  raw: string;
@@ -277,15 +278,6 @@ export declare function parseProviderObjectLiteral(source: string): ProviderObje
277
278
  * either a static string literal or a raw JS expression for the adapter to
278
279
  * lower (`color` → its template interpolation).
279
280
  */
280
- export type StyleObjectEntry = {
281
- cssKey: string;
282
- kind: 'literal';
283
- value: string;
284
- } | {
285
- cssKey: string;
286
- kind: 'expr';
287
- expr: string;
288
- };
289
281
  /** camelCase → kebab-case for CSS property names (`backgroundColor` →
290
282
  * `background-color`, `WebkitTransform` → `-webkit-transform`). The `ms`
291
283
  * vendor prefix is lowercase in React style keys (`msTransform`) yet the CSS
@@ -309,16 +301,6 @@ export declare function cssKebabCase(name: string): string;
309
301
  * reference and with Hono.
310
302
  */
311
303
  export declare function hasUnsafeStyleValue(value: string): boolean;
312
- /**
313
- * Parse a JSX `style={{ … }}` object-literal source into CSS entries, or
314
- * `null` when the shape isn't a plain object of static-keyed properties
315
- * (spread, computed key, shorthand, method, getter) — the adapter then keeps
316
- * refusing it. A bare `{…}` parses as a block statement, so the source is
317
- * wrapped in parens to force expression context. Used by the template adapters
318
- * to lower `style={{ backgroundColor: color, padding: '8px' }}` to a CSS
319
- * string instead of emitting BF101.
320
- */
321
- export declare function parseStyleObjectEntries(source: string): StyleObjectEntry[] | null;
322
304
  /**
323
305
  * Parse a JavaScript expression string into a ParsedExpr tree.
324
306
  */
@@ -506,6 +488,14 @@ export interface FoldBlockOptions {
506
488
  */
507
489
  pureCallNames?: ReadonlySet<string>;
508
490
  }
491
+ /**
492
+ * The value a call of `value` with no arguments evaluates to, when that is
493
+ * just its body: a zero-param, synchronous, non-generator arrow whose body
494
+ * is a pure value expression. Null otherwise (an async call returns a
495
+ * Promise, a generator an iterator, and a body that mutates state, like
496
+ * `++nextId`, must run where it is declared).
497
+ */
498
+ export declare function zeroArgCallBody(value: ParsedExpr): ParsedExpr | null;
509
499
  /**
510
500
  * Inline `name → value` everywhere it appears free in `expr` (the let-inline
511
501
  * step). Returns `null` if the substitution would capture a free variable of