@barefootjs/jsx 0.37.1 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/dist/action-accessor.d.ts +159 -0
  2. package/dist/action-accessor.d.ts.map +1 -0
  3. package/dist/adapters/env-signal.d.ts +0 -8
  4. package/dist/adapters/env-signal.d.ts.map +1 -1
  5. package/dist/adapters/interface.d.ts +12 -0
  6. package/dist/adapters/interface.d.ts.map +1 -1
  7. package/dist/adapters/jsx-adapter.d.ts.map +1 -1
  8. package/dist/analyzer.d.ts +61 -1
  9. package/dist/analyzer.d.ts.map +1 -1
  10. package/dist/async-action-refusal.d.ts +45 -0
  11. package/dist/async-action-refusal.d.ts.map +1 -0
  12. package/dist/builtin-lowering-plugins.d.ts.map +1 -1
  13. package/dist/compiler.d.ts.map +1 -1
  14. package/dist/component-root-scope-comment.d.ts +36 -0
  15. package/dist/component-root-scope-comment.d.ts.map +1 -0
  16. package/dist/debug.d.ts +61 -5
  17. package/dist/debug.d.ts.map +1 -1
  18. package/dist/errors.d.ts +7 -0
  19. package/dist/errors.d.ts.map +1 -1
  20. package/dist/event-handler-name.d.ts +13 -0
  21. package/dist/event-handler-name.d.ts.map +1 -0
  22. package/dist/expression-parser.d.ts +9 -0
  23. package/dist/expression-parser.d.ts.map +1 -1
  24. package/dist/format-date-refusal.d.ts +33 -0
  25. package/dist/format-date-refusal.d.ts.map +1 -0
  26. package/dist/index.d.ts +6 -4
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +3260 -1914
  29. package/dist/ir-to-client-js/build-references.d.ts.map +1 -1
  30. package/dist/ir-to-client-js/collect-elements.d.ts.map +1 -1
  31. package/dist/ir-to-client-js/compute-inlinability.d.ts.map +1 -1
  32. package/dist/ir-to-client-js/compute-scope.d.ts.map +1 -1
  33. package/dist/ir-to-client-js/control-flow/plan/build-branch-loop.d.ts.map +1 -1
  34. package/dist/ir-to-client-js/control-flow/plan/build-component-loop.d.ts.map +1 -1
  35. package/dist/ir-to-client-js/control-flow/plan/build-composite-loop.d.ts.map +1 -1
  36. package/dist/ir-to-client-js/control-flow/plan/build-loop-child-arm.d.ts.map +1 -1
  37. package/dist/ir-to-client-js/control-flow/plan/build-loop.d.ts.map +1 -1
  38. package/dist/ir-to-client-js/control-flow/plan/insert.d.ts +2 -0
  39. package/dist/ir-to-client-js/control-flow/plan/insert.d.ts.map +1 -1
  40. package/dist/ir-to-client-js/control-flow/plan/lazy-row-eligibility.d.ts +1 -1
  41. package/dist/ir-to-client-js/control-flow/plan/loop.d.ts +57 -12
  42. package/dist/ir-to-client-js/control-flow/plan/loop.d.ts.map +1 -1
  43. package/dist/ir-to-client-js/control-flow/shared.d.ts +44 -3
  44. package/dist/ir-to-client-js/control-flow/shared.d.ts.map +1 -1
  45. package/dist/ir-to-client-js/control-flow/stringify/component-loop.d.ts +7 -5
  46. package/dist/ir-to-client-js/control-flow/stringify/component-loop.d.ts.map +1 -1
  47. package/dist/ir-to-client-js/csr-substitute.d.ts.map +1 -1
  48. package/dist/ir-to-client-js/declaration-sort.d.ts +2 -1
  49. package/dist/ir-to-client-js/declaration-sort.d.ts.map +1 -1
  50. package/dist/ir-to-client-js/emit-module-level.d.ts.map +1 -1
  51. package/dist/ir-to-client-js/emit-reactive.d.ts +43 -2
  52. package/dist/ir-to-client-js/emit-reactive.d.ts.map +1 -1
  53. package/dist/ir-to-client-js/emit-registration.d.ts.map +1 -1
  54. package/dist/ir-to-client-js/html-template.d.ts.map +1 -1
  55. package/dist/ir-to-client-js/plan/declaration-emit.d.ts +7 -5
  56. package/dist/ir-to-client-js/plan/declaration-emit.d.ts.map +1 -1
  57. package/dist/ir-to-client-js/prop-handling.d.ts.map +1 -1
  58. package/dist/ir-to-client-js/reactivity.d.ts +9 -1
  59. package/dist/ir-to-client-js/reactivity.d.ts.map +1 -1
  60. package/dist/ir-to-client-js/source-map.d.ts.map +1 -1
  61. package/dist/ir-to-client-js/types.d.ts +4 -0
  62. package/dist/ir-to-client-js/types.d.ts.map +1 -1
  63. package/dist/ir-to-client-js/utils.d.ts +66 -1
  64. package/dist/ir-to-client-js/utils.d.ts.map +1 -1
  65. package/dist/jsx-to-ir.d.ts.map +1 -1
  66. package/dist/opaque-local-accessor.d.ts +27 -0
  67. package/dist/opaque-local-accessor.d.ts.map +1 -0
  68. package/dist/signal-initializer.d.ts +24 -0
  69. package/dist/signal-initializer.d.ts.map +1 -0
  70. package/dist/template-position-walk.d.ts +68 -0
  71. package/dist/template-position-walk.d.ts.map +1 -0
  72. package/dist/to-locale-date-lowering.d.ts +7 -4
  73. package/dist/to-locale-date-lowering.d.ts.map +1 -1
  74. package/dist/types.d.ts +104 -17
  75. package/dist/types.d.ts.map +1 -1
  76. package/package.json +2 -2
  77. package/src/__tests__/__snapshots__/doc-examples.test.ts.snap +878 -4528
  78. package/src/__tests__/action-accessor.test.ts +166 -0
  79. package/src/__tests__/binding-scope-ratchet.test.ts +21 -10
  80. package/src/__tests__/branch-local-in-raw-capture.test.ts +1 -1
  81. package/src/__tests__/branch-local-same-name-collision.test.ts +9 -9
  82. package/src/__tests__/client-js-generation.test.ts +175 -0
  83. package/src/__tests__/component-root-scope-comment.test.ts +106 -0
  84. package/src/__tests__/create-mutation.test.ts +220 -0
  85. package/src/__tests__/create-query.test.ts +644 -0
  86. package/src/__tests__/csr-fragment-root-scope-shape.test.ts +156 -0
  87. package/src/__tests__/debug.test.ts +222 -0
  88. package/src/__tests__/doc-examples.test.ts +78 -25
  89. package/src/__tests__/event-handler-name.test.ts +74 -0
  90. package/src/__tests__/flatmap-segments.test.ts +11 -9
  91. package/src/__tests__/format-date-refusal.test.ts +134 -0
  92. package/src/__tests__/fragment-wrapped-conditional-return-branch.test.ts +132 -0
  93. package/src/__tests__/hydrate-template.test.ts +9 -1
  94. package/src/__tests__/issue-2798-static-nested-loop-bindings.test.ts +2 -2
  95. package/src/__tests__/issue-3009-loop-branch-ref.test.ts +2 -2
  96. package/src/__tests__/issue-3044-nested-prop-object-array-not-static.test.ts +213 -0
  97. package/src/__tests__/issue-3113-init-fn-name-collision.test.ts +133 -0
  98. package/src/__tests__/jsx-return-type-assertion.test.ts +2 -2
  99. package/src/__tests__/lazy-row-eligibility.test.ts +5 -4
  100. package/src/__tests__/loop-row-child-children-reactive-attrs.test.ts +108 -0
  101. package/src/__tests__/loop-row-child-text-children-markers.test.ts +158 -0
  102. package/src/__tests__/opaque-local-accessor.test.ts +90 -0
  103. package/src/__tests__/profiler-e2e.test.ts +13 -8
  104. package/src/__tests__/props-destructuring.test.ts +79 -4
  105. package/src/__tests__/reactive-factory-arity.test.ts +311 -0
  106. package/src/__tests__/ref-attr-absent-at-ssr.test.ts +472 -0
  107. package/src/__tests__/ssr-portal-ref-callback.test.ts +219 -0
  108. package/src/action-accessor.ts +289 -0
  109. package/src/adapters/env-signal.ts +2 -21
  110. package/src/adapters/interface.ts +13 -0
  111. package/src/adapters/jsx-adapter.ts +17 -0
  112. package/src/analyzer.ts +589 -60
  113. package/src/async-action-refusal.ts +254 -0
  114. package/src/builtin-lowering-plugins.ts +0 -2
  115. package/src/compiler.ts +27 -0
  116. package/src/component-root-scope-comment.ts +59 -0
  117. package/src/debug.ts +318 -103
  118. package/src/errors.ts +83 -1
  119. package/src/event-handler-name.ts +14 -0
  120. package/src/expression-parser.ts +41 -17
  121. package/src/format-date-refusal.ts +147 -0
  122. package/src/index.ts +14 -3
  123. package/src/ir-to-client-js/build-references.ts +6 -2
  124. package/src/ir-to-client-js/child-components.ts +8 -3
  125. package/src/ir-to-client-js/collect-elements.ts +28 -13
  126. package/src/ir-to-client-js/compute-inlinability.ts +2 -1
  127. package/src/ir-to-client-js/compute-scope.ts +3 -1
  128. package/src/ir-to-client-js/control-flow/plan/build-branch-loop.ts +2 -4
  129. package/src/ir-to-client-js/control-flow/plan/build-component-loop.ts +67 -5
  130. package/src/ir-to-client-js/control-flow/plan/build-composite-loop.ts +3 -6
  131. package/src/ir-to-client-js/control-flow/plan/build-insert.ts +1 -0
  132. package/src/ir-to-client-js/control-flow/plan/build-loop-child-arm.ts +2 -1
  133. package/src/ir-to-client-js/control-flow/plan/build-loop.ts +23 -11
  134. package/src/ir-to-client-js/control-flow/plan/insert.ts +2 -0
  135. package/src/ir-to-client-js/control-flow/plan/lazy-row-eligibility.ts +3 -3
  136. package/src/ir-to-client-js/control-flow/plan/loop.ts +51 -10
  137. package/src/ir-to-client-js/control-flow/shared.ts +78 -5
  138. package/src/ir-to-client-js/control-flow/stringify/component-loop.ts +25 -12
  139. package/src/ir-to-client-js/control-flow/stringify/insert.ts +1 -1
  140. package/src/ir-to-client-js/csr-substitute.ts +11 -3
  141. package/src/ir-to-client-js/declaration-sort.ts +7 -3
  142. package/src/ir-to-client-js/emit-module-level.ts +7 -4
  143. package/src/ir-to-client-js/emit-reactive.ts +140 -10
  144. package/src/ir-to-client-js/emit-registration.ts +6 -11
  145. package/src/ir-to-client-js/generate-init.ts +2 -2
  146. package/src/ir-to-client-js/html-template.ts +41 -19
  147. package/src/ir-to-client-js/index.ts +9 -3
  148. package/src/ir-to-client-js/phases/ref-callbacks.ts +1 -1
  149. package/src/ir-to-client-js/plan/build-declaration-emit.ts +16 -15
  150. package/src/ir-to-client-js/plan/declaration-emit.ts +7 -5
  151. package/src/ir-to-client-js/prop-handling.ts +4 -0
  152. package/src/ir-to-client-js/reactivity.ts +21 -16
  153. package/src/ir-to-client-js/source-map.ts +2 -1
  154. package/src/ir-to-client-js/stringify/declaration-emit.ts +14 -7
  155. package/src/ir-to-client-js/types.ts +4 -0
  156. package/src/ir-to-client-js/utils.ts +89 -7
  157. package/src/jsx-to-ir.ts +772 -50
  158. package/src/opaque-local-accessor.ts +44 -0
  159. package/src/rich-type-refusal.ts +1 -1
  160. package/src/signal-initializer.ts +36 -0
  161. package/src/template-position-walk.ts +203 -0
  162. package/src/to-locale-date-lowering.ts +7 -4
  163. package/src/types.ts +103 -15
  164. package/dist/format-date-lowering.d.ts +0 -30
  165. package/dist/format-date-lowering.d.ts.map +0 -1
  166. package/src/__tests__/create-selector.test.ts +0 -124
  167. package/src/__tests__/format-date-lowering.test.ts +0 -125
  168. package/src/format-date-lowering.ts +0 -55
@@ -1,125 +0,0 @@
1
- /**
2
- * `formatDatePlugin` (#2324) — recognises the `formatDate` import from
3
- * `@barefootjs/client` (incl. aliases and the runtime re-export) and lowers a
4
- * `formatDate(date, pattern[, timeZone])` call to the backend-neutral
5
- * `helper-call` on the `format_date` helper, normalizing the omitted
6
- * `timeZone` to the `'UTC'` literal (fixed helper arity of 3).
7
- */
8
- import { describe, expect, test } from 'bun:test'
9
- import { compileJSX, type ComponentIR } from '../index'
10
- import { formatDateLocalNames } from '../adapters/env-signal'
11
- import { matchFormatDateCall, formatDatePlugin } from '../format-date-lowering'
12
- import type { ParsedExpr } from '../expression-parser'
13
- import { TestAdapter } from '../adapters/test-adapter'
14
-
15
- function metadata(src: string): ComponentIR['metadata'] {
16
- const result = compileJSX(src.trimStart(), 'T.tsx', { adapter: new TestAdapter(), outputIR: true })
17
- const ir = JSON.parse(result.files.find(f => f.type === 'ir')!.content) as ComponentIR
18
- return ir.metadata
19
- }
20
-
21
- const CALLEE: ParsedExpr = { kind: 'identifier', name: 'formatDate' }
22
- const DATE_ARG: ParsedExpr = { kind: 'identifier', name: 'createdAt' }
23
- const PATTERN_ARG: ParsedExpr = { kind: 'literal', value: 'YYYY/M/D', literalType: 'string' }
24
- const TZ_ARG: ParsedExpr = { kind: 'literal', value: '+09:00', literalType: 'string' }
25
- const LOCALS = new Set(['formatDate'])
26
-
27
- describe('formatDateLocalNames (#2324)', () => {
28
- test('recognises the import, aliases, and the runtime entry', () => {
29
- const md = metadata(`
30
- 'use client'
31
- import { formatDate } from '@barefootjs/client'
32
- export function P(props: { createdAt: Date }) {
33
- return <time>{formatDate(props.createdAt, 'YYYY/M/D')}</time>
34
- }
35
- `)
36
- expect([...formatDateLocalNames(md)]).toEqual(['formatDate'])
37
-
38
- const aliased = metadata(`
39
- 'use client'
40
- import { formatDate as fd } from '@barefootjs/client/runtime'
41
- export function P(props: { createdAt: Date }) {
42
- return <time>{fd(props.createdAt, 'YYYY/M/D')}</time>
43
- }
44
- `)
45
- expect([...formatDateLocalNames(aliased)]).toEqual(['fd'])
46
- })
47
-
48
- test('is empty when not imported', () => {
49
- const md = metadata(`
50
- 'use client'
51
- export function P() { return <time>x</time> }
52
- `)
53
- expect(formatDateLocalNames(md).size).toBe(0)
54
- })
55
- })
56
-
57
- const EMPTY_NAMES = { kind: 'array-literal', elements: [], raw: '[]' }
58
-
59
- describe('matchFormatDateCall (#2324/#2334)', () => {
60
- test('normalizes a 3-arg call to canonical arity 4 (empty names table)', () => {
61
- expect(matchFormatDateCall(CALLEE, [DATE_ARG, PATTERN_ARG, TZ_ARG], LOCALS)).toEqual({
62
- kind: 'helper-call',
63
- helper: 'format_date',
64
- args: [DATE_ARG, PATTERN_ARG, TZ_ARG, EMPTY_NAMES as ParsedExpr],
65
- })
66
- })
67
-
68
- test('normalizes a 2-arg call by supplying the UTC literal and empty names', () => {
69
- const node = matchFormatDateCall(CALLEE, [DATE_ARG, PATTERN_ARG], LOCALS)
70
- expect(node).toEqual({
71
- kind: 'helper-call',
72
- helper: 'format_date',
73
- args: [
74
- DATE_ARG,
75
- PATTERN_ARG,
76
- { kind: 'literal', value: 'UTC', literalType: 'string' },
77
- EMPTY_NAMES as ParsedExpr,
78
- ],
79
- })
80
- })
81
-
82
- test('a caller-supplied 4th (names) argument passes through', () => {
83
- const namesArg: ParsedExpr = { kind: 'identifier', name: 'names' }
84
- expect(matchFormatDateCall(CALLEE, [DATE_ARG, PATTERN_ARG, TZ_ARG, namesArg], LOCALS)).toEqual({
85
- kind: 'helper-call',
86
- helper: 'format_date',
87
- args: [DATE_ARG, PATTERN_ARG, TZ_ARG, namesArg],
88
- })
89
- })
90
-
91
- test('declines wrong callees and arities', () => {
92
- expect(matchFormatDateCall({ kind: 'identifier', name: 'other' }, [DATE_ARG, PATTERN_ARG], LOCALS)).toBeNull()
93
- expect(
94
- matchFormatDateCall(
95
- { kind: 'member', object: DATE_ARG, property: 'formatDate', computed: false } as ParsedExpr,
96
- [DATE_ARG, PATTERN_ARG],
97
- LOCALS,
98
- ),
99
- ).toBeNull()
100
- expect(matchFormatDateCall(CALLEE, [DATE_ARG], LOCALS)).toBeNull()
101
- expect(matchFormatDateCall(CALLEE, [DATE_ARG, PATTERN_ARG, TZ_ARG, TZ_ARG, TZ_ARG], LOCALS)).toBeNull()
102
- })
103
-
104
- test('the plugin prepares only for components that import formatDate', () => {
105
- const withImport = metadata(`
106
- 'use client'
107
- import { formatDate } from '@barefootjs/client'
108
- export function P(props: { createdAt: Date }) {
109
- return <time>{formatDate(props.createdAt, 'YYYY/M/D')}</time>
110
- }
111
- `)
112
- const matcher = formatDatePlugin.prepare(withImport)
113
- expect(matcher).not.toBeNull()
114
- expect(matcher!(CALLEE, [DATE_ARG, PATTERN_ARG, TZ_ARG])).toMatchObject({
115
- kind: 'helper-call',
116
- helper: 'format_date',
117
- })
118
-
119
- const without = metadata(`
120
- 'use client'
121
- export function P() { return <time>x</time> }
122
- `)
123
- expect(formatDatePlugin.prepare(without)).toBeNull()
124
- })
125
- })
@@ -1,55 +0,0 @@
1
- /**
2
- * `formatDate` lowering plugin (#2324) — the pure-function date formatter
3
- * (`packages/client/src/format-date.ts`). A call to the `formatDate` binding
4
- * imported from `@barefootjs/client` lowers to a backend-neutral
5
- * `helper-call` on the `format_date` helper (spec/template-helpers.md), which
6
- * every adapter renders through its generic helper-call path (#2069) — no
7
- * adapter-specific recognition code, only the runtime helper each backend
8
- * ships.
9
- *
10
- * The canonical helper arity is 3: a two-arg call site
11
- * (`formatDate(d, 'YYYY/M/D')`) is normalized here by supplying the
12
- * `'UTC'` literal the client function defaults to, so backend helpers stay
13
- * fixed-arity. Unlike the `date` plugin there is no receiver-type gate —
14
- * `formatDate` is recognised by its import binding (like `queryHref`), and
15
- * its own receiver contract (native date / ISO string / nil → `''`) is total,
16
- * so any argument expression the adapter can evaluate is admissible.
17
- */
18
-
19
- import type { ParsedExpr } from './expression-parser.ts'
20
- import type { LoweringNode, LoweringPlugin } from './lowering-registry.ts'
21
- import { formatDateLocalNames } from './adapters/env-signal.ts'
22
-
23
- const UTC_LITERAL: ParsedExpr = { kind: 'literal', value: 'UTC', literalType: 'string' }
24
- const EMPTY_NAMES: ParsedExpr = { kind: 'array-literal', elements: [], raw: '[]' } as ParsedExpr
25
-
26
- /**
27
- * Recognise `formatDate(date, pattern[, timeZone[, names]])` against the
28
- * component's local import bindings, or decline (null): a non-identifier
29
- * callee, a name not bound to the `@barefootjs/client` import, or an arity
30
- * outside 2–4. The canonical helper arity is 4 (#2334): omitted `timeZone` /
31
- * `names` normalize to the `'UTC'` literal and the empty table the client
32
- * function defaults to, so backend helpers stay fixed-arity.
33
- */
34
- export function matchFormatDateCall(
35
- callee: ParsedExpr,
36
- args: readonly ParsedExpr[],
37
- locals: ReadonlySet<string>,
38
- ): LoweringNode | null {
39
- if (callee.kind !== 'identifier' || !locals.has(callee.name)) return null
40
- if (args.length < 2 || args.length > 4) return null
41
- return {
42
- kind: 'helper-call',
43
- helper: 'format_date',
44
- args: [args[0], args[1], args[2] ?? UTC_LITERAL, args[3] ?? EMPTY_NAMES],
45
- }
46
- }
47
-
48
- export const formatDatePlugin: LoweringPlugin = {
49
- name: 'formatDate',
50
- prepare(metadata) {
51
- const locals = formatDateLocalNames(metadata)
52
- if (locals.size === 0) return null
53
- return (callee, args) => matchFormatDateCall(callee, args, locals)
54
- },
55
- }