@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
@@ -128,3 +128,135 @@ export function collectValueReferencedNames(code: string): Set<string> | null {
128
128
  visit(sourceFile)
129
129
  return names
130
130
  }
131
+
132
+ /**
133
+ * The nodes that open a binding scope in emitted JS: the module, every
134
+ * function-like node and class static block (its parameters and hoisted
135
+ * `var` / function names),
136
+ * blocks, `for` heads, `case` blocks and `catch` clauses (`let` / `const` /
137
+ * class names), and class expressions (their own name).
138
+ */
139
+ function isScopeNode(node: ts.Node): boolean {
140
+ return (
141
+ isVarScopeNode(node) ||
142
+ ts.isBlock(node) ||
143
+ ts.isForStatement(node) ||
144
+ ts.isForInStatement(node) ||
145
+ ts.isForOfStatement(node) ||
146
+ ts.isCaseBlock(node) ||
147
+ ts.isCatchClause(node) ||
148
+ ts.isClassExpression(node)
149
+ )
150
+ }
151
+
152
+ /**
153
+ * The nodes a `var` (and a parameter) binds into: the module, every
154
+ * function-like node, and a class static block, whose `var`s stay inside
155
+ * it (#3537 review).
156
+ */
157
+ function isVarScopeNode(node: ts.Node): boolean {
158
+ return ts.isSourceFile(node) || ts.isFunctionLike(node) || ts.isClassStaticBlockDeclaration(node)
159
+ }
160
+
161
+ function nearestScope(from: ts.Node, functionScoped: boolean): ts.Node {
162
+ let node: ts.Node | undefined = from
163
+ while (node) {
164
+ if (functionScoped ? isVarScopeNode(node) : isScopeNode(node)) return node
165
+ node = node.parent
166
+ }
167
+ return from.getSourceFile()
168
+ }
169
+
170
+ function bindingNames(name: ts.BindingName, out: string[]): string[] {
171
+ if (ts.isIdentifier(name)) {
172
+ out.push(name.text)
173
+ } else {
174
+ for (const element of name.elements) {
175
+ if (ts.isBindingElement(element)) bindingNames(element.name, out)
176
+ }
177
+ }
178
+ return out
179
+ }
180
+
181
+ /** The scope each declaration in `sourceFile` binds its names into. */
182
+ function collectScopeBindings(sourceFile: ts.SourceFile): Map<ts.Node, Set<string>> {
183
+ const bindings = new Map<ts.Node, Set<string>>()
184
+ const bind = (scope: ts.Node, names: readonly string[]): void => {
185
+ let set = bindings.get(scope)
186
+ if (!set) bindings.set(scope, (set = new Set()))
187
+ for (const name of names) set.add(name)
188
+ }
189
+ function visit(node: ts.Node): void {
190
+ if (ts.isVariableDeclaration(node)) {
191
+ const list = node.parent
192
+ const isVar = ts.isVariableDeclarationList(list) && (list.flags & ts.NodeFlags.BlockScoped) === 0
193
+ bind(nearestScope(list, isVar), bindingNames(node.name, []))
194
+ } else if (ts.isParameter(node)) {
195
+ bind(node.parent, bindingNames(node.name, []))
196
+ } else if ((ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node)) && node.name) {
197
+ bind(nearestScope(node.parent, false), [node.name.text])
198
+ } else if ((ts.isFunctionExpression(node) || ts.isClassExpression(node)) && node.name) {
199
+ bind(node, [node.name.text])
200
+ } else if (ts.isCatchClause(node) && node.variableDeclaration) {
201
+ bind(node, bindingNames(node.variableDeclaration.name, []))
202
+ node.block.statements.forEach(visit)
203
+ return
204
+ } else if (ts.isImportClause(node) && node.name) {
205
+ bind(sourceFile, [node.name.text])
206
+ } else if (ts.isNamespaceImport(node) || ts.isImportSpecifier(node)) {
207
+ bind(sourceFile, [node.name.text])
208
+ }
209
+ ts.forEachChild(node, visit)
210
+ }
211
+ visit(sourceFile)
212
+ return bindings
213
+ }
214
+
215
+ /** What {@link analyzeEmittedReferences} reports about one emitted module. */
216
+ export interface EmittedReferences {
217
+ /** Value references that no enclosing scope binds: imports or globals. */
218
+ free: Set<string>
219
+ /** Names called directly (`name(…)`), bound or not. */
220
+ called: Set<string>
221
+ }
222
+
223
+ /**
224
+ * Parse emitted client JS and report its unbound value references and its
225
+ * directly called names.
226
+ *
227
+ * Unlike {@link collectValueReferencedNames}, `free` resolves scopes, so a
228
+ * name the module declares itself (a module-level helper emitted as
229
+ * `var insert = …`, a parameter, a block-scoped `const`) is not reported
230
+ * where that declaration is visible (#3537). Hoisting is modelled per
231
+ * scope, not per position: a binding counts for its whole scope.
232
+ *
233
+ * Returns `null` when the text did not parse cleanly, with the same
234
+ * "cannot answer" contract as {@link collectValueReferencedNames}.
235
+ */
236
+ export function analyzeEmittedReferences(code: string): EmittedReferences | null {
237
+ let sourceFile: ts.SourceFile
238
+ try {
239
+ sourceFile = ts.createSourceFile('generated.js', code, ts.ScriptTarget.Latest, true, ts.ScriptKind.JS)
240
+ } catch {
241
+ return null
242
+ }
243
+ const diagnostics = (sourceFile as unknown as { parseDiagnostics?: readonly unknown[] }).parseDiagnostics
244
+ if (diagnostics && diagnostics.length > 0) return null
245
+
246
+ const bindings = collectScopeBindings(sourceFile)
247
+ const isBound = (id: ts.Identifier): boolean => {
248
+ for (let node: ts.Node | undefined = id.parent; node; node = node.parent) {
249
+ if (bindings.get(node)?.has(id.text)) return true
250
+ }
251
+ return false
252
+ }
253
+ const free = new Set<string>()
254
+ const called = new Set<string>()
255
+ function visit(node: ts.Node): void {
256
+ if (ts.isIdentifier(node) && isValueReferenceIdentifier(node) && !isBound(node)) free.add(node.text)
257
+ if (ts.isCallExpression(node) && ts.isIdentifier(node.expression)) called.add(node.expression.text)
258
+ ts.forEachChild(node, visit)
259
+ }
260
+ visit(sourceFile)
261
+ return { free, called }
262
+ }