@barefootjs/jsx 0.40.1 → 0.41.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.
- package/dist/adapters/boolean-result.d.ts +32 -10
- package/dist/adapters/boolean-result.d.ts.map +1 -1
- package/dist/adapters/brace-delimiter-text.d.ts +18 -0
- package/dist/adapters/brace-delimiter-text.d.ts.map +1 -0
- package/dist/adapters/callback-method.d.ts +45 -5
- package/dist/adapters/callback-method.d.ts.map +1 -1
- package/dist/adapters/component-props.d.ts +3 -4
- package/dist/adapters/component-props.d.ts.map +1 -1
- package/dist/adapters/computed-const.d.ts +11 -1
- package/dist/adapters/computed-const.d.ts.map +1 -1
- package/dist/adapters/dsl-template-adapter.d.ts +24 -12
- package/dist/adapters/dsl-template-adapter.d.ts.map +1 -1
- package/dist/adapters/loop-bound-names.d.ts +9 -1
- package/dist/adapters/loop-bound-names.d.ts.map +1 -1
- package/dist/adapters/loop-row-type.d.ts +59 -0
- package/dist/adapters/loop-row-type.d.ts.map +1 -0
- package/dist/adapters/nil-reading.d.ts +63 -0
- package/dist/adapters/nil-reading.d.ts.map +1 -0
- package/dist/adapters/non-primitive-equality.d.ts +33 -0
- package/dist/adapters/non-primitive-equality.d.ts.map +1 -0
- package/dist/adapters/number-value.d.ts +5 -3
- package/dist/adapters/number-value.d.ts.map +1 -1
- package/dist/adapters/operand-typing.d.ts +126 -0
- package/dist/adapters/operand-typing.d.ts.map +1 -0
- package/dist/adapters/parsed-expr-emitter.d.ts +80 -12
- package/dist/adapters/parsed-expr-emitter.d.ts.map +1 -1
- package/dist/adapters/primitive-plan.d.ts +320 -0
- package/dist/adapters/primitive-plan.d.ts.map +1 -0
- package/dist/adapters/prop-classes.d.ts +5 -0
- package/dist/adapters/prop-classes.d.ts.map +1 -1
- package/dist/analyzer-context.d.ts +4 -0
- package/dist/analyzer-context.d.ts.map +1 -1
- package/dist/analyzer.d.ts.map +1 -1
- package/dist/augment-inherited-props.d.ts +63 -8
- package/dist/augment-inherited-props.d.ts.map +1 -1
- package/dist/compiler.d.ts.map +1 -1
- package/dist/event-handler-name.d.ts +12 -0
- package/dist/event-handler-name.d.ts.map +1 -1
- package/dist/expression-parser.d.ts +8 -0
- package/dist/expression-parser.d.ts.map +1 -1
- package/dist/index.d.ts +20 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4903 -2311
- package/dist/ir-to-client-js/build-references.d.ts.map +1 -1
- package/dist/ir-to-client-js/child-props-object.d.ts +106 -0
- package/dist/ir-to-client-js/child-props-object.d.ts.map +1 -0
- package/dist/ir-to-client-js/collect-elements.d.ts.map +1 -1
- package/dist/ir-to-client-js/control-flow/plan/build-inner-loop.d.ts.map +1 -1
- package/dist/ir-to-client-js/control-flow/plan/build-loop-child-arm.d.ts.map +1 -1
- package/dist/ir-to-client-js/control-flow/shared.d.ts.map +1 -1
- package/dist/ir-to-client-js/control-flow/stringify/claim-plan.d.ts +4 -2
- package/dist/ir-to-client-js/control-flow/stringify/claim-plan.d.ts.map +1 -1
- package/dist/ir-to-client-js/html-template.d.ts.map +1 -1
- package/dist/ir-to-client-js/imports.d.ts +2 -2
- package/dist/ir-to-client-js/imports.d.ts.map +1 -1
- package/dist/ir-to-client-js/index.d.ts +2 -6
- package/dist/ir-to-client-js/index.d.ts.map +1 -1
- package/dist/ir-to-client-js/phases/props-extraction.d.ts +3 -3
- package/dist/ir-to-client-js/plan/build-declaration-emit.d.ts.map +1 -1
- package/dist/ir-to-client-js/plan/build-static-array-child-init.d.ts.map +1 -1
- package/dist/ir-to-client-js/plan/static-array-child-init.d.ts +30 -18
- package/dist/ir-to-client-js/plan/static-array-child-init.d.ts.map +1 -1
- package/dist/ir-to-client-js/prop-handling.d.ts.map +1 -1
- package/dist/ir-to-client-js/prune-unused-prop-extractions.d.ts +3 -1
- package/dist/ir-to-client-js/prune-unused-prop-extractions.d.ts.map +1 -1
- package/dist/ir-to-client-js/stringify/static-array-child-init.d.ts +3 -2
- package/dist/ir-to-client-js/stringify/static-array-child-init.d.ts.map +1 -1
- package/dist/jsx-to-ir.d.ts +1 -0
- package/dist/jsx-to-ir.d.ts.map +1 -1
- package/dist/nullable-signal-attr.d.ts +51 -34
- package/dist/nullable-signal-attr.d.ts.map +1 -1
- package/dist/prop-rewrite.d.ts +7 -0
- package/dist/prop-rewrite.d.ts.map +1 -1
- package/dist/props-binding.d.ts +58 -13
- package/dist/props-binding.d.ts.map +1 -1
- package/dist/props-object-whole-read.d.ts +15 -0
- package/dist/props-object-whole-read.d.ts.map +1 -0
- package/dist/rich-type-refusal.d.ts.map +1 -1
- package/dist/scope/binding-scope.d.ts +85 -10
- package/dist/scope/binding-scope.d.ts.map +1 -1
- package/dist/scope/lexical-scope-walk.d.ts +3 -2
- package/dist/scope/lexical-scope-walk.d.ts.map +1 -1
- package/dist/scope/root-prop-alias.d.ts +10 -7
- package/dist/scope/root-prop-alias.d.ts.map +1 -1
- package/dist/ssr-defaults.d.ts +39 -3
- package/dist/ssr-defaults.d.ts.map +1 -1
- package/dist/strip-types.d.ts +13 -0
- package/dist/strip-types.d.ts.map +1 -1
- package/dist/template-position-walk.d.ts +21 -3
- package/dist/template-position-walk.d.ts.map +1 -1
- package/dist/types.d.ts +90 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/__tests__/__snapshots__/doc-examples.test.ts.snap +9 -9
- package/src/__tests__/binding-scope.test.ts +89 -1
- package/src/__tests__/body-destructure-props-object-alias.test.ts +123 -0
- package/src/__tests__/body-destructured-prop-default-arrow.test.ts +2 -2
- package/src/__tests__/body-destructured-props-live.test.ts +5 -5
- package/src/__tests__/boolean-result.test.ts +22 -5
- package/src/__tests__/brace-delimiter-text.test.ts +26 -0
- package/src/__tests__/callback-method.test.ts +62 -2
- package/src/__tests__/child-components-in-map.test.ts +1 -1
- package/src/__tests__/client-js-generation.test.ts +3 -3
- package/src/__tests__/computed-const.test.ts +103 -0
- package/src/__tests__/destructure-default-reads-earlier-param.test.ts +7 -7
- package/src/__tests__/destructured-props-live.test.ts +1 -1
- package/src/__tests__/emit-to-string-call.test.ts +2 -1
- package/src/__tests__/hydration-payload-analysis.test.ts +166 -0
- package/src/__tests__/issue-2724-prop-alias-loop-not-static.test.ts +7 -7
- package/src/__tests__/issue-2754-rest-spread-needs-slot.test.ts +5 -2
- package/src/__tests__/issue-2798-static-nested-loop-bindings.test.ts +1 -1
- package/src/__tests__/issue-2835-props-type-member-name-collision.test.ts +4 -4
- package/src/__tests__/issue-3044-nested-prop-object-array-not-static.test.ts +1 -1
- package/src/__tests__/issue-3688-props-spread-child-csr.test.ts +2 -1
- package/src/__tests__/issue-3713-props-spread-loop-row.test.ts +65 -0
- package/src/__tests__/issue-3861-object-spread-child.test.ts +102 -0
- package/src/__tests__/lookup-literal-const.test.ts +9 -3
- package/src/__tests__/loop-index-reactivity.test.ts +2 -2
- package/src/__tests__/loop-param-accessor-key-member-safety.test.ts +1 -1
- package/src/__tests__/loop-plan.test.ts +1 -1
- package/src/__tests__/loop-row-const-initializer-shadow.test.ts +146 -0
- package/src/__tests__/loop-row-type.test.ts +64 -0
- package/src/__tests__/lowering-value-position.test.ts +4 -0
- package/src/__tests__/memo-body-expr.test.ts +2 -2
- package/src/__tests__/module-const-destructure-default.test.ts +156 -0
- package/src/__tests__/nested-loop-index-param.test.ts +1 -1
- package/src/__tests__/nested-loop-reactive-attrs.test.ts +2 -2
- package/src/__tests__/nested-row-shadowing.test.ts +2 -2
- package/src/__tests__/nil-reading.test.ts +78 -0
- package/src/__tests__/nullable-signal-attr.test.ts +109 -48
- package/src/__tests__/primitive-plan.test.ts +494 -0
- package/src/__tests__/profile-loop-binding-ids.test.ts +2 -2
- package/src/__tests__/profile-nested-binding-ids.test.ts +2 -2
- package/src/__tests__/prop-default-undefined-only.test.ts +115 -0
- package/src/__tests__/prop-references.test.ts +2 -2
- package/src/__tests__/props-destructuring.test.ts +17 -0
- package/src/__tests__/props-object-whole-read.test.ts +40 -0
- package/src/__tests__/prune-unused-prop-extractions.test.ts +3 -3
- package/src/__tests__/reactive-attrs-in-map.test.ts +1 -1
- package/src/__tests__/reactive-factory-inlining.test.ts +4 -1
- package/src/__tests__/renamed-body-destructure-template.test.ts +7 -7
- package/src/__tests__/rest-binding-gaps.test.ts +192 -0
- package/src/__tests__/rewrite-destructured-props.test.ts +1 -1
- package/src/__tests__/root-prop-alias.test.ts +53 -8
- package/src/__tests__/ssr-defaults.test.ts +113 -25
- package/src/__tests__/static-loop-csr-materialize.test.ts +2 -2
- package/src/__tests__/static-record-literal-array.test.ts +171 -0
- package/src/__tests__/string-concat-identifier.test.ts +40 -1
- package/src/__tests__/written-binding-substitution.test.ts +8 -8
- package/src/adapters/boolean-result.ts +72 -66
- package/src/adapters/brace-delimiter-text.ts +25 -0
- package/src/adapters/callback-method.ts +159 -27
- package/src/adapters/component-props.ts +3 -4
- package/src/adapters/computed-const.ts +238 -4
- package/src/adapters/dsl-template-adapter.ts +62 -26
- package/src/adapters/loop-bound-names.ts +9 -1
- package/src/adapters/loop-plan.ts +1 -1
- package/src/adapters/loop-row-type.ts +149 -0
- package/src/adapters/nil-reading.ts +295 -0
- package/src/adapters/non-primitive-equality.ts +92 -0
- package/src/adapters/number-value.ts +17 -4
- package/src/adapters/operand-typing.ts +522 -0
- package/src/adapters/parsed-expr-emitter.ts +183 -19
- package/src/adapters/primitive-plan.ts +765 -0
- package/src/adapters/prop-classes.ts +16 -3
- package/src/analyzer-context.ts +6 -0
- package/src/analyzer.ts +532 -26
- package/src/augment-inherited-props.ts +108 -10
- package/src/compiler.ts +17 -0
- package/src/event-handler-name.ts +15 -0
- package/src/expression-parser.ts +70 -1
- package/src/index.ts +35 -16
- package/src/ir-to-client-js/build-references.ts +69 -0
- package/src/ir-to-client-js/child-props-object.ts +240 -0
- package/src/ir-to-client-js/collect-elements.ts +31 -63
- package/src/ir-to-client-js/control-flow/plan/build-inner-loop.ts +8 -1
- package/src/ir-to-client-js/control-flow/plan/build-loop-child-arm.ts +31 -28
- package/src/ir-to-client-js/control-flow/shared.ts +20 -22
- package/src/ir-to-client-js/control-flow/stringify/claim-plan.ts +5 -3
- package/src/ir-to-client-js/control-flow/stringify/inner-loop.ts +2 -2
- package/src/ir-to-client-js/control-flow/stringify/lazy-row.ts +1 -1
- package/src/ir-to-client-js/control-flow/stringify/loop-child-arm.ts +2 -2
- package/src/ir-to-client-js/control-flow/stringify/loop.ts +1 -1
- package/src/ir-to-client-js/control-flow/stringify/reactive-effects.ts +3 -3
- package/src/ir-to-client-js/html-template.ts +43 -17
- package/src/ir-to-client-js/imports.ts +2 -2
- package/src/ir-to-client-js/index.ts +53 -11
- package/src/ir-to-client-js/phases/props-extraction.ts +11 -7
- package/src/ir-to-client-js/plan/build-declaration-emit.ts +40 -7
- package/src/ir-to-client-js/plan/build-static-array-child-init.ts +31 -14
- package/src/ir-to-client-js/plan/static-array-child-init.ts +27 -18
- package/src/ir-to-client-js/prop-handling.ts +22 -3
- package/src/ir-to-client-js/prune-unused-prop-extractions.ts +58 -5
- package/src/ir-to-client-js/rewrite-destructured-props.ts +31 -1
- package/src/ir-to-client-js/stringify/static-array-child-init.ts +26 -10
- package/src/jsx-to-ir.ts +459 -37
- package/src/nullable-signal-attr.ts +200 -110
- package/src/prop-rewrite.ts +30 -6
- package/src/props-binding.ts +84 -19
- package/src/props-object-whole-read.ts +87 -0
- package/src/rich-type-refusal.ts +2 -1
- package/src/scope/binding-scope.ts +182 -18
- package/src/scope/lexical-scope-walk.ts +4 -3
- package/src/scope/root-prop-alias.ts +15 -8
- package/src/ssr-defaults.ts +100 -11
- package/src/strip-types.ts +31 -3
- package/src/template-position-walk.ts +57 -28
- package/src/types.ts +87 -0
- package/dist/adapters/ambiguous-nil-arithmetic.d.ts +0 -41
- package/dist/adapters/ambiguous-nil-arithmetic.d.ts.map +0 -1
- package/src/adapters/ambiguous-nil-arithmetic.ts +0 -94
|
@@ -15,8 +15,7 @@
|
|
|
15
15
|
* a non-nil value.
|
|
16
16
|
*/
|
|
17
17
|
import type { ParsedExpr } from './expression-parser.ts';
|
|
18
|
-
import {
|
|
19
|
-
import type { ComponentIR, MemoInfo, SignalInfo } from './types.ts';
|
|
18
|
+
import type { ComponentIR, IRMetadata, MemoInfo, SignalInfo } from './types.ts';
|
|
20
19
|
/** `undefined` / `null` as a parsed initial value. */
|
|
21
20
|
export declare function isNullishLiteral(expr: ParsedExpr | undefined): boolean;
|
|
22
21
|
/**
|
|
@@ -43,6 +42,22 @@ export declare function collectNullableSignalGetters(ir: ComponentIR): Set<strin
|
|
|
43
42
|
* survives into the signal.
|
|
44
43
|
*/
|
|
45
44
|
export declare function collectAbsentPropSeedReads(ir: ComponentIR): Map<string, Set<string>>;
|
|
45
|
+
/**
|
|
46
|
+
* Whether `expr` is never `undefined` / `null` at SSR, so JS `expr ?? y` is
|
|
47
|
+
* `expr`, even when it is `false`, `''` or `0`: a boolean-result expression
|
|
48
|
+
* (a comparison, `!`, a boolean literal, `isBooleanResultParsed`), or a read
|
|
49
|
+
* of a required (not optional, not rest) prop declared as a string, number
|
|
50
|
+
* or boolean, or a union of them, read as its binding (`flag`) or as
|
|
51
|
+
* `<propsObjectName>.<key>`, with no binding shadowing the read.
|
|
52
|
+
*/
|
|
53
|
+
export declare function isNeverNullishOperand(expr: ParsedExpr, metadata: Pick<IRMetadata, 'propsParams' | 'propsObjectName'>, isBound: (name: string) => boolean): boolean;
|
|
54
|
+
/**
|
|
55
|
+
* The params of `nullableProps` (`NullishAttrContext.nullableProps`) that
|
|
56
|
+
* `expr`'s value can be read whole from (`collectSeedPropReads`): the props
|
|
57
|
+
* whose absence an attribute bound to `expr` omits it for. A backend that
|
|
58
|
+
* types a prop by value (Go) makes these props nillable.
|
|
59
|
+
*/
|
|
60
|
+
export declare function nullablePropsYieldedBy(expr: ParsedExpr | undefined, nullableProps: ReadonlyMap<string, string>): Set<string>;
|
|
46
61
|
/**
|
|
47
62
|
* The getter an attribute value reads when the whole value is a bare,
|
|
48
63
|
* zero-argument getter call (`s()`); `null` for any other shape. A member
|
|
@@ -70,23 +85,37 @@ export interface NullishAttrContext {
|
|
|
70
85
|
* (`arithmeticOperandIsUndefined`). */
|
|
71
86
|
readonly undefinedSeededSignals?: ReadonlySet<string>;
|
|
72
87
|
readonly memos: ReadonlyMap<string, MemoInfo>;
|
|
88
|
+
/** Props that can be absent or `null` at SSR (no default, optional or
|
|
89
|
+
* typed with `undefined` / `null`), by the name a read uses
|
|
90
|
+
* (`collectNullablePropReads`). */
|
|
91
|
+
readonly nullableProps?: ReadonlyMap<string, string>;
|
|
73
92
|
/** Props declared as a number that may be `null` or absent (`n: number |
|
|
74
93
|
* null`, `n?: number`), by the name a read uses: the binding name, and
|
|
75
94
|
* `<propsObjectName>.<key>` for a member read (#3474), mapped to what the
|
|
76
95
|
* engine's nil stands for there (`NullableNumberPropNil`, #3533). */
|
|
77
96
|
readonly nullableNumberProps?: ReadonlyMap<string, NullableNumberPropNil>;
|
|
97
|
+
/** Props declared as a string or a boolean that may be `null` or absent
|
|
98
|
+
* (`s?: string`, `b: boolean | null`), keyed like {@link nullableNumberProps}.
|
|
99
|
+
* Read only for a relational operand (#3824 step 3): JS converts it with
|
|
100
|
+
* ToNumber unless both sides are strings, so its nil's reading decides the
|
|
101
|
+
* comparison (`undefined < 1` is false, `null < 1` is true). */
|
|
102
|
+
readonly nullableScalarProps?: ReadonlyMap<string, NullableScalarProp>;
|
|
103
|
+
}
|
|
104
|
+
/** A string or boolean prop's nil reading ({@link NullishAttrContext.nullableScalarProps}). */
|
|
105
|
+
export interface NullableScalarProp {
|
|
106
|
+
readonly family: 'string' | 'boolean';
|
|
107
|
+
readonly nil: NullableNumberPropNil;
|
|
78
108
|
}
|
|
79
109
|
/**
|
|
80
110
|
* What a nullable number prop's nil stands for at SSR (#3533). JS reads an
|
|
81
|
-
* absent prop as `undefined` (`NaN` in arithmetic) and a `null` one as `0
|
|
82
|
-
*
|
|
83
|
-
* decides. A prop whose type admits `null` (`n: number | null`) reads its
|
|
111
|
+
* absent prop as `undefined` (`NaN` in arithmetic) and a `null` one as `0`;
|
|
112
|
+
* the declared type decides the coercion an adapter spells statically. A prop whose type admits `null` (`n: number | null`) reads its
|
|
84
113
|
* nil as `null`. A prop that can only be absent (`n?: number`,
|
|
85
114
|
* `n: number | undefined`) reads it as `undefined`; a present value, `0`
|
|
86
115
|
* included, is unaffected. A prop that admits both (`n?: number | null`,
|
|
87
116
|
* `n: number | null | undefined`) is `'either'`: the type cannot say which
|
|
88
|
-
* one its nil stands for, so
|
|
89
|
-
* (
|
|
117
|
+
* one its nil stands for, so the operand is left to the runtime's helper,
|
|
118
|
+
* which reads the value itself (spec/js-undefined-value.md).
|
|
90
119
|
*/
|
|
91
120
|
export type NullableNumberPropNil = 'null' | 'undefined' | 'either';
|
|
92
121
|
export declare function collectNullishAttrContext(ir: ComponentIR): NullishAttrContext;
|
|
@@ -98,7 +127,8 @@ export declare function collectNullishAttrContext(ir: ComponentIR): NullishAttrC
|
|
|
98
127
|
* nullish value through:
|
|
99
128
|
*
|
|
100
129
|
* - a read of a nullable signal or of a memo whose type or body can be
|
|
101
|
-
* nullish (`label()` with `label = createMemo(() => s())`)
|
|
130
|
+
* nullish (`label()` with `label = createMemo(() => s())`), or of a prop
|
|
131
|
+
* that can be absent (`props.on && 'y'`);
|
|
102
132
|
* - an optional member read (`user()?.name`), an index or computed-key read
|
|
103
133
|
* (`pair[1]`, `row[key]`), or a member read of a value that can itself be
|
|
104
134
|
* nullish;
|
|
@@ -143,8 +173,15 @@ export declare const NULL_COERCING_ARITHMETIC_OPS: ReadonlySet<string>;
|
|
|
143
173
|
/** How a DSL adapter coerces an arithmetic operand (#3474): `'null'` reads a
|
|
144
174
|
* nil as `0` (JS `ToNumber(null)`), `'undefined'` reads it as `NaN`
|
|
145
175
|
* (`ToNumber(undefined)`), `null` leaves the operand as is. Either coercion
|
|
146
|
-
* leaves a non-nil operand's value as it is
|
|
147
|
-
|
|
176
|
+
* leaves a non-nil operand's value as it is: the operand is a number, so the
|
|
177
|
+
* runtime's JS `Number()` may spell `'undefined'`.
|
|
178
|
+
*
|
|
179
|
+
* `'undefined-keep'` (#3824 step 3) also reads a nil as `NaN`, but the
|
|
180
|
+
* operand is a string or boolean relational operand, which must reach the
|
|
181
|
+
* relational helper unconverted (`'a' < 'b'` compares strings), so the
|
|
182
|
+
* adapter spells it as a nil test: `NaN` when nil, the operand otherwise.
|
|
183
|
+
* `NaN` makes the comparison false, as `undefined < x` is in JS for any `x`. */
|
|
184
|
+
export type ArithmeticCoercion = 'null' | 'undefined' | 'undefined-keep' | null;
|
|
148
185
|
/**
|
|
149
186
|
* The one decision behind every DSL adapter's arithmetic over a nullish
|
|
150
187
|
* operand (#3474). An operand known to be `null` / `undefined`
|
|
@@ -153,30 +190,10 @@ export type ArithmeticCoercion = 'null' | 'undefined' | null;
|
|
|
153
190
|
* (`NullableNumberPropNil`, #3533), is coerced under the operators JS
|
|
154
191
|
* applies `ToNumber` to ({@link NULL_COERCING_ARITHMETIC_OPS}), and under
|
|
155
192
|
* `+` when the other operand is a number literal, where `+` cannot
|
|
156
|
-
* concatenate. Unary minus
|
|
157
|
-
* `other`. Each adapter only spells the
|
|
158
|
-
* reads nil as `0` spells `'null'` as the
|
|
193
|
+
* concatenate. Unary minus and unary plus apply `ToNumber` too: each passes
|
|
194
|
+
* its operator (`'-'` / `'+'`) with no `other`. Each adapter only spells the
|
|
195
|
+
* coercion; one whose engine already reads nil as `0` spells `'null'` as the
|
|
196
|
+
* operand itself.
|
|
159
197
|
*/
|
|
160
198
|
export declare function arithmeticOperandCoercion(op: string, operand: ParsedExpr | undefined, other: ParsedExpr | undefined, ctx: NullishAttrContext, isShadowed?: (name: string) => boolean): ArithmeticCoercion;
|
|
161
|
-
/**
|
|
162
|
-
* Whether an arithmetic operand reads a number prop whose type admits both
|
|
163
|
-
* `null` and absence (`n?: number | null`), directly or through a memo
|
|
164
|
-
* (#3700). JS reads the omitted prop as `undefined` (`NaN` in arithmetic)
|
|
165
|
-
* and a `null` one as `0`; a template engine holds both as one nil and the
|
|
166
|
-
* type cannot say which, so no spelling of {@link arithmeticOperandCoercion}
|
|
167
|
-
* renders both. Template adapters refuse such an operand instead of
|
|
168
|
-
* rendering one reading silently. Same operators and scope as
|
|
169
|
-
* {@link arithmeticOperandCoercion}.
|
|
170
|
-
*/
|
|
171
|
-
export declare function arithmeticOperandNilIsAmbiguous(op: string, operand: ParsedExpr | undefined, other: ParsedExpr | undefined, ctx: NullishAttrContext, isShadowed?: (name: string) => boolean): boolean;
|
|
172
|
-
/**
|
|
173
|
-
* Every arithmetic operand in `expr` that {@link arithmeticOperandNilIsAmbiguous}
|
|
174
|
-
* matches, for a whole expression a template adapter lowers without visiting
|
|
175
|
-
* each operator through its emitter (a memo body, a `.filter()` predicate, an
|
|
176
|
-
* expression the runtime evaluator runs). Operands of binary operators and of
|
|
177
|
-
* unary minus count. `scope` is where the expression is read; each arrow in
|
|
178
|
-
* it enters its params as a callback frame (`BindingScope.enterCallback`),
|
|
179
|
-
* so they shadow within its body only.
|
|
180
|
-
*/
|
|
181
|
-
export declare function ambiguousNilArithmeticOperands(expr: ParsedExpr, ctx: NullishAttrContext, scope?: BindingScope): ParsedExpr[];
|
|
182
199
|
//# sourceMappingURL=nullable-signal-attr.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"nullable-signal-attr.d.ts","sourceRoot":"","sources":["../src/nullable-signal-attr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;
|
|
1
|
+
{"version":3,"file":"nullable-signal-attr.d.ts","sourceRoot":"","sources":["../src/nullable-signal-attr.ts"],"names":[],"mappings":"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"}
|
package/dist/prop-rewrite.d.ts
CHANGED
|
@@ -119,4 +119,11 @@ export declare function applyRegexPropRefRewrite(text: string, propRefs: Iterabl
|
|
|
119
119
|
* `applyScopedPropRefRewrite`'s docstring.
|
|
120
120
|
*/
|
|
121
121
|
export declare function rewriteBarePropRefs(text: string, node: ts.Node, propNames: Set<string>, extraPropRefs?: ReadonlySet<string>, propAliases?: ReadonlyMap<string, string>, replacementFor?: (localName: string, callerKey: string) => string): string | undefined;
|
|
122
|
+
/**
|
|
123
|
+
* `rewriteBarePropRefs` without the regex fallback: `null` when `text`
|
|
124
|
+
* does not parse as an expression, so the caller refuses the shape instead
|
|
125
|
+
* of splicing names the scope-blind regex would also hit inside an inner
|
|
126
|
+
* binding (`const one = 'a'` → `const _p.one = 'a'`, #3845).
|
|
127
|
+
*/
|
|
128
|
+
export declare function rewriteBarePropRefsStructural(text: string, node: ts.Node, propNames: Set<string>, extraPropRefs?: ReadonlySet<string>, propAliases?: ReadonlyMap<string, string>, replacementFor?: (localName: string, callerKey: string) => string): string | undefined | null;
|
|
122
129
|
//# sourceMappingURL=prop-rewrite.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"prop-rewrite.d.ts","sourceRoot":"","sources":["../src/prop-rewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAA;AA0C3B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GACf,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAOnG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACxC,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,MAAM,GAAG,IAAI,CAsCf;AAED,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhG;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,mBAAmB,EAAE,GAAG,IAAI,CA4B3G;AA6BD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC1B,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAChE,MAAM,CAqBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAChE,MAAM,GAAG,SAAS,
|
|
1
|
+
{"version":3,"file":"prop-rewrite.d.ts","sourceRoot":"","sources":["../src/prop-rewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAA;AA0C3B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GACf,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAOnG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EACxC,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,MAAM,GAAG,IAAI,CAsCf;AAED,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhG;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,mBAAmB,EAAE,GAAG,IAAI,CA4B3G;AA6BD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC1B,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAChE,MAAM,CAqBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAChE,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAChE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI3B"}
|
package/dist/props-binding.d.ts
CHANGED
|
@@ -262,12 +262,19 @@ export declare function boundPropLocalNames(b: PropsParamBindings): ReadonlySet<
|
|
|
262
262
|
* never bound a parameter — so callers synthesize one of these instead of a
|
|
263
263
|
* full `ParamInfo` (which would need a fabricated `type`/`optional`).
|
|
264
264
|
*/
|
|
265
|
-
export type LivePropReadInfo = Pick<ParamInfo, 'name' | 'sourceName' | 'defaultValue' | 'defaultContainsArrow' | 'defaultParts'
|
|
265
|
+
export type LivePropReadInfo = Pick<ParamInfo, 'name' | 'sourceName' | 'defaultValue' | 'defaultContainsArrow' | 'defaultParts'> & {
|
|
266
|
+
/**
|
|
267
|
+
* The fallback is the author's own `??` (`const label = props.label ??
|
|
268
|
+
* 'x'`, a body alias), which replaces `null` too, not a destructure
|
|
269
|
+
* default, which replaces only `undefined`.
|
|
270
|
+
*/
|
|
271
|
+
readonly coalescesNull?: boolean;
|
|
272
|
+
};
|
|
266
273
|
/** `_p.<callerKey>` — `_p` is always keyed by the caller-facing name (#2524 CSR half). */
|
|
267
274
|
export declare function propReadBase(p: LivePropReadInfo): string;
|
|
268
275
|
/**
|
|
269
|
-
* The text a destructure default contributes
|
|
270
|
-
*
|
|
276
|
+
* The text a destructure default contributes to a prop read
|
|
277
|
+
* ({@link composePropRead}). An arrow (or function-expression) default needs its own
|
|
271
278
|
* parens — `??` binds tighter than an arrow head, so `_p.onInput ?? () =>
|
|
272
279
|
* {}` is a SyntaxError. The one implementation of that decision, shared by
|
|
273
280
|
* `propReadFallback` below (every live `_p.X` read) and `collectConstant`'s
|
|
@@ -277,11 +284,23 @@ export declare function propReadBase(p: LivePropReadInfo): string;
|
|
|
277
284
|
*/
|
|
278
285
|
export declare function coalesceDefaultText(defaultValue: string, defaultContainsArrow: boolean | undefined): string;
|
|
279
286
|
/**
|
|
280
|
-
*
|
|
281
|
-
*
|
|
287
|
+
* What a prop read falls back to:
|
|
288
|
+
* - `default`: the prop's destructure default, which JS applies to an
|
|
289
|
+
* absent or `undefined` prop only, never to `null`
|
|
290
|
+
* (`spec/js-undefined-value.md`, "Decisions" (6)).
|
|
291
|
+
* - `guard`: a value the compiler supplies for a defaultless prop so the
|
|
292
|
+
* read cannot throw (`[]` for a loop array, `{}` for a member read); it
|
|
293
|
+
* replaces either nil.
|
|
294
|
+
*/
|
|
295
|
+
export interface PropReadFallback {
|
|
296
|
+
readonly kind: 'default' | 'guard';
|
|
297
|
+
readonly text: string;
|
|
298
|
+
}
|
|
299
|
+
/**
|
|
300
|
+
* The fallback of a prop read, or null when the bare read is correct.
|
|
301
|
+
* Precedence:
|
|
282
302
|
* 1. an explicit destructure default (`{ x = 1 }`) — an arrow default gets
|
|
283
|
-
* an extra paren, since `??`
|
|
284
|
-
* `_p.onInput ?? () => {}` would be a syntax error.
|
|
303
|
+
* an extra paren, since `??` / `?:` bind tighter than the arrow head.
|
|
285
304
|
* 2. `usedAsLoopArray` → `[]`.
|
|
286
305
|
* 3. property/index access → `{}`, UNLESS the prop also guards a
|
|
287
306
|
* conditional: `{}` is truthy, so that would always render the branch.
|
|
@@ -290,15 +309,41 @@ export declare function coalesceDefaultText(defaultValue: string, defaultContain
|
|
|
290
309
|
* synthesized zero default would diverge from SSR instead (`size ?? 1`
|
|
291
310
|
* seeds 1 server-side; a `_p.size ?? 0` read would hydrate to 0).
|
|
292
311
|
*/
|
|
293
|
-
export declare function propReadFallback(p: LivePropReadInfo, usage: PropUsage | undefined, usedAsCondition: boolean):
|
|
312
|
+
export declare function propReadFallback(p: LivePropReadInfo, usage: PropUsage | undefined, usedAsCondition: boolean, retained?: ReadonlySet<string>): PropReadFallback | null;
|
|
313
|
+
/**
|
|
314
|
+
* A prop read `base` (a plain property read, `_p.x` / `props.x`, so reading
|
|
315
|
+
* it twice is safe) with its fallback, unparenthesized: a destructure
|
|
316
|
+
* default as `base === undefined ? default : base`, which keeps an explicit
|
|
317
|
+
* `null`, as JS does; a guard as `base ?? guard`. The one spelling every
|
|
318
|
+
* client-JS prop read and the body-destructure expansion share, and the
|
|
319
|
+
* shape `parsePropReadInitializer` recognizes.
|
|
320
|
+
*/
|
|
321
|
+
export declare function composePropRead(base: string, fallback: PropReadFallback | null): string;
|
|
294
322
|
/**
|
|
295
323
|
* A prop's destructure default as client JS. A default that reads an earlier
|
|
296
324
|
* binding of its own pattern (`{ off = false, on = off }`, #3531) renders each
|
|
297
|
-
* read as that prop's own live read (`_p.off
|
|
298
|
-
* scope binds no `off`; any other default is its
|
|
299
|
-
* the
|
|
325
|
+
* read as that prop's own live read (`_p.off === undefined ? false :
|
|
326
|
+
* _p.off`) where the emitted scope binds no `off`; any other default is its
|
|
327
|
+
* source text. `retained` names the earlier bindings that ARE locals of the
|
|
328
|
+
* emitted scope (`retainedPropLocals`): a read of one stays a read of that
|
|
329
|
+
* local, as in JS, so a default sharing an earlier binding's array, or
|
|
330
|
+
* reading a value a default assigned to it, sees that binding. Undefined
|
|
331
|
+
* when the prop has no default.
|
|
300
332
|
*/
|
|
301
|
-
export declare function propDefaultText(p: LivePropReadInfo): string | undefined;
|
|
333
|
+
export declare function propDefaultText(p: LivePropReadInfo, retained?: ReadonlySet<string>): string | undefined;
|
|
334
|
+
/**
|
|
335
|
+
* The destructured prop bindings the init body keeps as locals, by local
|
|
336
|
+
* name: a written or mutated parameter (`let start = …`, `emitPropsExtraction`)
|
|
337
|
+
* and a body destructure of the props object that does not keep its declared
|
|
338
|
+
* value (`let { a } = props`, or one mutated later). Every other destructured
|
|
339
|
+
* binding is read live (`keepsDeclaredValue`). A default reading one of these
|
|
340
|
+
* reads the local ({@link propDefaultText}).
|
|
341
|
+
*/
|
|
342
|
+
export declare function retainedPropLocals(b: {
|
|
343
|
+
propsObjectName: string | null;
|
|
344
|
+
propsParams: readonly ParamInfo[];
|
|
345
|
+
localConstants: readonly ConstantInfo[];
|
|
346
|
+
}): ReadonlySet<string>;
|
|
302
347
|
/**
|
|
303
348
|
* The live read of a destructured prop inside init scope, in the same shape
|
|
304
349
|
* props-object mode emits for `props.X`. The one formula every live-read
|
|
@@ -315,7 +360,7 @@ export declare function propDefaultText(p: LivePropReadInfo): string | undefined
|
|
|
315
360
|
* `pruneUnusedPropExtractions`'s AST matcher, so it composes
|
|
316
361
|
* `propReadBase`/`propReadFallback` itself.
|
|
317
362
|
*/
|
|
318
|
-
export declare function livePropReadExpr(p: LivePropReadInfo, usage: PropUsage | undefined, usedAsCondition: boolean): string;
|
|
363
|
+
export declare function livePropReadExpr(p: LivePropReadInfo, usage: PropUsage | undefined, usedAsCondition: boolean, retained?: ReadonlySet<string>): string;
|
|
319
364
|
/**
|
|
320
365
|
* The two component bindings that forward the caller's leftover props:
|
|
321
366
|
* the destructured `...rest` binding and a whole undestructured `(props)`
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"props-binding.d.ts","sourceRoot":"","sources":["../src/props-binding.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"props-binding.d.ts","sourceRoot":"","sources":["../src/props-binding.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whether a component observes its props object as a whole: any read of the
|
|
3
|
+
* props parameter other than a member read with a known key (`props.x`,
|
|
4
|
+
* `props['x']`). A whole read — `{...props}` on an element or a component,
|
|
5
|
+
* `Object.keys(props)`, `props[key]`, passing `props` to a function,
|
|
6
|
+
* `const { a, ...rest } = props` — can see a key the props type does not
|
|
7
|
+
* declare, so a caller's undeclared prop is not dead there.
|
|
8
|
+
*
|
|
9
|
+
* Syntactic, over the component's TS AST: a nested function, catch clause or
|
|
10
|
+
* block that rebinds the name shadows it, and a type position is not a read.
|
|
11
|
+
* A shadow this misses only makes the answer `true` more often.
|
|
12
|
+
*/
|
|
13
|
+
import ts from 'typescript';
|
|
14
|
+
export declare function observesWholePropsObject(fn: ts.FunctionDeclaration | ts.ArrowFunction | ts.FunctionExpression, name: string): boolean;
|
|
15
|
+
//# sourceMappingURL=props-object-whole-read.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"props-object-whole-read.d.ts","sourceRoot":"","sources":["../src/props-object-whole-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,EACrE,IAAI,EAAE,MAAM,GACX,OAAO,CAaT"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rich-type-refusal.d.ts","sourceRoot":"","sources":["../src/rich-type-refusal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,cAAc,EAKf,MAAM,YAAY,CAAA;
|
|
1
|
+
{"version":3,"file":"rich-type-refusal.d.ts","sourceRoot":"","sources":["../src/rich-type-refusal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,cAAc,EAKf,MAAM,YAAY,CAAA;AAkBnB;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAQ1G;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAe1I"}
|
|
@@ -29,11 +29,22 @@
|
|
|
29
29
|
* "just names you can't resolve against component-level state."
|
|
30
30
|
*/
|
|
31
31
|
/**
|
|
32
|
-
* The identifier a template reads as the component's props object
|
|
33
|
-
* `props.X` is the component's prop `X`
|
|
34
|
-
* (#3693).
|
|
32
|
+
* The identifier a template reads as the component's props object when the
|
|
33
|
+
* component does not name one itself: `props.X` is the component's prop `X`
|
|
34
|
+
* while no binding shadows `props` (#3693). A component that takes its props
|
|
35
|
+
* as one object names it with its parameter (`function C(p)`), and
|
|
36
|
+
* {@link BindingScope.forComponent} makes that name the props object instead.
|
|
35
37
|
*/
|
|
36
38
|
export declare const PROPS_OBJECT_IDENTIFIER = "props";
|
|
39
|
+
/**
|
|
40
|
+
* The identifier that names the props object of a component whose props
|
|
41
|
+
* parameter is `propsObjectName` (`IRMetadata.propsObjectName`): that name
|
|
42
|
+
* (`function C(p)` → `p`), or {@link PROPS_OBJECT_IDENTIFIER} when the
|
|
43
|
+
* component destructures its props (`null`). The single answer to "which
|
|
44
|
+
* identifier is the component's props object"; {@link BindingScope.propsObject}
|
|
45
|
+
* carries it.
|
|
46
|
+
*/
|
|
47
|
+
export declare function propsObjectIdentifier(propsObjectName: string | null | undefined): string;
|
|
37
48
|
/**
|
|
38
49
|
* How a name inside a `ScopeFrame` came to be bound — the row shapes
|
|
39
50
|
* (`'item'`/`'index'`/`'destructure'`/`'preamble'`) for `'loop-row'` frames,
|
|
@@ -87,9 +98,27 @@ export interface LoopBindingSource {
|
|
|
87
98
|
}
|
|
88
99
|
/** Structural pick of `TypeInfo` (`packages/jsx/src/types.ts`). */
|
|
89
100
|
export interface LoopValueType {
|
|
101
|
+
/** `TypeInfo.kind`; `'unknown'` for `any`, `unknown` and unresolved types. */
|
|
102
|
+
readonly kind?: string;
|
|
90
103
|
readonly primitive?: string;
|
|
91
104
|
readonly unionTypes?: readonly LoopValueType[];
|
|
105
|
+
/** A named type's name (`Row`), resolved through {@link NamedTypeFields}. */
|
|
106
|
+
readonly raw?: string;
|
|
107
|
+
readonly properties?: readonly LoopValueField[];
|
|
108
|
+
readonly elementType?: LoopValueType;
|
|
92
109
|
}
|
|
110
|
+
/** Structural pick of `PropertyInfo` (`packages/jsx/src/types.ts`). */
|
|
111
|
+
export interface LoopValueField {
|
|
112
|
+
readonly name: string;
|
|
113
|
+
readonly type: LoopValueType;
|
|
114
|
+
/** `name?:` — the field may be absent, so its value may be `undefined`. */
|
|
115
|
+
readonly optional?: boolean;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* The fields of a named type (`type Row = { … }`, an interface), by name;
|
|
119
|
+
* undefined when the component's file does not define it as an object type.
|
|
120
|
+
*/
|
|
121
|
+
export type NamedTypeFields = (name: string) => readonly LoopValueField[] | undefined;
|
|
93
122
|
/** Structural copy of `LoopBindingPathSegment` (`packages/jsx/src/types.ts`). */
|
|
94
123
|
export type RowPathSegment = {
|
|
95
124
|
readonly kind: 'field';
|
|
@@ -99,6 +128,34 @@ export type RowPathSegment = {
|
|
|
99
128
|
readonly kind: 'index';
|
|
100
129
|
readonly index: number;
|
|
101
130
|
};
|
|
131
|
+
/**
|
|
132
|
+
* The type at `segments` below `type`, through object types, named types
|
|
133
|
+
* (`namedFields`) and array elements; null when a step is not known.
|
|
134
|
+
*
|
|
135
|
+
* A union resolves the path in each member and is the union of the results,
|
|
136
|
+
* null when any member has no such path. A field is therefore definitely a
|
|
137
|
+
* string only when it is one in every member: the element type of a
|
|
138
|
+
* `concat` (`loopRowType`) is the union of its receiver's and arguments'
|
|
139
|
+
* element types, so `Row` and a same-shaped `Other` both read `id: string`,
|
|
140
|
+
* while an `any` member or an omitted field reads nothing (#3762 review).
|
|
141
|
+
*/
|
|
142
|
+
export declare function loopValueTypeAt(type: LoopValueType, segments: readonly RowPathSegment[], namedFields?: NamedTypeFields): LoopValueType | null;
|
|
143
|
+
/**
|
|
144
|
+
* The element type of an array type, or of a union whose every member is an
|
|
145
|
+
* array (a `concat` of arrays, a field read across `concat` rows): the union
|
|
146
|
+
* of their element types. Undefined for anything else. Every reader of an
|
|
147
|
+
* element type goes through this, so a union of arrays reads like an array
|
|
148
|
+
* (#3762 review).
|
|
149
|
+
*/
|
|
150
|
+
export declare function arrayElementType<T extends LoopValueType>(type: T | null | undefined): T | undefined;
|
|
151
|
+
/**
|
|
152
|
+
* The union of `members`, normalised: one member, or members that are all
|
|
153
|
+
* structurally the same type, is that member itself, so `Row[] ∪ Row[]`
|
|
154
|
+
* keeps the plain `Row[]` shape.
|
|
155
|
+
*/
|
|
156
|
+
export declare function unionOfLoopValueTypes<T extends LoopValueType>(members: readonly T[]): T;
|
|
157
|
+
/** Whether two types have the same structure: kind, name, primitive, fields, elements and members. */
|
|
158
|
+
export declare function isSameLoopValueShape(a: LoopValueType | undefined, b: LoopValueType | undefined): boolean;
|
|
102
159
|
/**
|
|
103
160
|
* A stack of `ScopeFrame`s, innermost frame at index 0 of the internal
|
|
104
161
|
* array (i.e. `frames[0]` is what `enterLoopRow`/`enterCallback` most
|
|
@@ -108,8 +165,22 @@ export type RowPathSegment = {
|
|
|
108
165
|
*/
|
|
109
166
|
export declare class BindingScope {
|
|
110
167
|
private readonly frames;
|
|
168
|
+
readonly propsObject: string;
|
|
111
169
|
static readonly EMPTY: BindingScope;
|
|
170
|
+
/**
|
|
171
|
+
* `propsObject`: the identifier that names the component's props object
|
|
172
|
+
* in this scope's component ({@link forComponent}). Every child scope
|
|
173
|
+
* keeps it.
|
|
174
|
+
*/
|
|
112
175
|
private constructor();
|
|
176
|
+
/**
|
|
177
|
+
* The empty scope of a component whose props object parameter is
|
|
178
|
+
* `propsObjectName` (`IRMetadata.propsObjectName`, decided in Phase 1):
|
|
179
|
+
* `function C(p)` reads its props as `p.X`, so `p` is the props object.
|
|
180
|
+
* A component that destructures its props (`null`) keeps
|
|
181
|
+
* {@link PROPS_OBJECT_IDENTIFIER}.
|
|
182
|
+
*/
|
|
183
|
+
static forComponent(propsObjectName: string | null): BindingScope;
|
|
113
184
|
/**
|
|
114
185
|
* Child scope with a new `'loop-row'` frame for one loop's per-item
|
|
115
186
|
* bindings. Parent (`this`) is not mutated; the returned scope is a
|
|
@@ -140,8 +211,8 @@ export declare class BindingScope {
|
|
|
140
211
|
* `adapters/loop-bound-names.ts`'s `collectLoopBoundNames` adds BOTH
|
|
141
212
|
* `node.param` AND every `paramBindings[i].name` unconditionally
|
|
142
213
|
* (never skipping `param` in the destructured case) — a deliberately
|
|
143
|
-
* coarser, over-inclusive collection
|
|
144
|
-
*
|
|
214
|
+
* coarser, over-inclusive collection for whole-component "may be
|
|
215
|
+
* shadowed somewhere" checks (safe to over-exclude there). This method
|
|
145
216
|
* follows the precise `jsx-to-ir.ts` `ctx.loopParams` semantics, since
|
|
146
217
|
* that is the mechanism actually doing scope-shadowed name RESOLUTION
|
|
147
218
|
* (the behavior `BindingScope` replaces), not coarse exclusion.
|
|
@@ -167,7 +238,7 @@ export declare class BindingScope {
|
|
|
167
238
|
isBound(name: string): boolean;
|
|
168
239
|
/**
|
|
169
240
|
* Whether a binding here shadows the component's props object
|
|
170
|
-
* ({@link
|
|
241
|
+
* ({@link propsObject}): a `.map((props) => …)` row, a
|
|
171
242
|
* destructured `({ props })` field, a preamble local or a callback param.
|
|
172
243
|
* `props.X` then reads that binding's member, not the component's prop
|
|
173
244
|
* `X` (#3693).
|
|
@@ -175,11 +246,15 @@ export declare class BindingScope {
|
|
|
175
246
|
shadowsPropsObject(): boolean;
|
|
176
247
|
/**
|
|
177
248
|
* Resolve string typing at this position, respecting the nearest binding.
|
|
178
|
-
* `componentProperty`: `name` is read as `props.<name
|
|
179
|
-
* component's prop only
|
|
180
|
-
* binding
|
|
249
|
+
* `componentProperty`: `name` is read as the literal `props.<name>`. That is
|
|
250
|
+
* the component's prop only when `props` is this component's props object
|
|
251
|
+
* and no binding shadows it; while a binding named `props` is in scope, it
|
|
252
|
+
* is that binding's member. `path`: the read is the member chain
|
|
253
|
+
* `name.<path…>` (`row.id`). A loop row binding resolves the chain against
|
|
254
|
+
* its row type (`LoopBindingSource.rowType`), through `namedFields` for a
|
|
255
|
+
* named type; an outer name has typing for itself only.
|
|
181
256
|
*/
|
|
182
|
-
isStringValueName(name: string, outer: (name: string) => boolean, componentProperty?: boolean): boolean;
|
|
257
|
+
isStringValueName(name: string, outer: (name: string) => boolean, componentProperty?: boolean, path?: readonly string[], namedFields?: NamedTypeFields): boolean;
|
|
183
258
|
/** Whether any frame is a loop row: the position sits inside a `.map()` row body. */
|
|
184
259
|
insideLoopRow(): boolean;
|
|
185
260
|
/** The names the innermost frame binds, in binding order. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"binding-scope.d.ts","sourceRoot":"","sources":["../../src/scope/binding-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH
|
|
1
|
+
{"version":3,"file":"binding-scope.d.ts","sourceRoot":"","sources":["../../src/scope/binding-scope.ts"],"names":[],"mappings":"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"}
|
|
@@ -20,7 +20,8 @@ import ts from 'typescript';
|
|
|
20
20
|
/**
|
|
21
21
|
* Depth-first walk that maintains the binding stack described above and
|
|
22
22
|
* reports every identifier along with whether a binding within `root`
|
|
23
|
-
* currently shadows it.
|
|
23
|
+
* currently shadows it. `isShadowed` answers the same question for any
|
|
24
|
+
* other name at that identifier's position.
|
|
24
25
|
*/
|
|
25
|
-
export declare function walkWithScope(root: ts.Node, visit: (ident: ts.Identifier, parent: ts.Node | undefined, shadowed: boolean) => void): void;
|
|
26
|
+
export declare function walkWithScope(root: ts.Node, visit: (ident: ts.Identifier, parent: ts.Node | undefined, shadowed: boolean, isShadowed: (name: string) => boolean) => void): void;
|
|
26
27
|
//# sourceMappingURL=lexical-scope-walk.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lexical-scope-walk.d.ts","sourceRoot":"","sources":["../../src/scope/lexical-scope-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAA;AAyH3B
|
|
1
|
+
{"version":3,"file":"lexical-scope-walk.d.ts","sourceRoot":"","sources":["../../src/scope/lexical-scope-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAA;AAyH3B;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,KAAK,IAAI,GAC3H,IAAI,CAkBN"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { ParsedExpr } from '../expression-parser.ts';
|
|
2
2
|
import type { ComponentIR } from '../types.ts';
|
|
3
|
-
import {
|
|
3
|
+
import type { BindingScope } from './binding-scope.ts';
|
|
4
4
|
/**
|
|
5
5
|
* Root-prop aliases for template engines that flatten `props.X` to the bare
|
|
6
6
|
* template variable `X` (#3314). A loop that binds the same name (`.map(value
|
|
@@ -44,13 +44,16 @@ export declare function rootPropReadName(name: string, scope: BindingScope, alia
|
|
|
44
44
|
/**
|
|
45
45
|
* Whether `expr` reads the component's props object at a position where
|
|
46
46
|
* `isBound` answers which names a binding shadows: the bare identifier
|
|
47
|
-
* `
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
47
|
+
* `propsObject` that no binding shadows (#3693). `propsObject` is the
|
|
48
|
+
* component's props object identifier, `BindingScope.propsObject`: the
|
|
49
|
+
* props parameter's own name (`function C(p)` reads `p.X`), or `props` for
|
|
50
|
+
* a component that destructures its props. A `.map((props) => …)` row, a
|
|
51
|
+
* destructured `({ props })` field, a preamble local or a callback param of
|
|
52
|
+
* that name is that binding instead, so `props.X` reads its member rather
|
|
53
|
+
* than flattening to the component's prop `X`. Template emitters flatten a
|
|
54
|
+
* props-object member read only when this holds; `isBound` is the
|
|
52
55
|
* adapter's current `BindingScope` (`scope.isBound`), or, in a filter
|
|
53
56
|
* predicate, the predicate's own params plus the enclosing scope.
|
|
54
57
|
*/
|
|
55
|
-
export declare function isRootPropsObject(expr: ParsedExpr, isBound: (name: string) => boolean): boolean;
|
|
58
|
+
export declare function isRootPropsObject(expr: ParsedExpr, isBound: (name: string) => boolean, propsObject: string): boolean;
|
|
56
59
|
//# sourceMappingURL=root-prop-alias.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"root-prop-alias.d.ts","sourceRoot":"","sources":["../../src/scope/root-prop-alias.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,
|
|
1
|
+
{"version":3,"file":"root-prop-alias.d.ts","sourceRoot":"","sources":["../../src/scope/root-prop-alias.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB5G;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAGR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAClC,WAAW,EAAE,MAAM,GAClB,OAAO,CAET"}
|
package/dist/ssr-defaults.d.ts
CHANGED
|
@@ -9,10 +9,19 @@ export interface SsrDefault {
|
|
|
9
9
|
/**
|
|
10
10
|
* Static fallback value when neither the caller's props nor the
|
|
11
11
|
* adapter's own derivation supplies one. JSON-encodable: number,
|
|
12
|
-
* string, boolean, null, or a tree of plain objects / arrays
|
|
13
|
-
*
|
|
12
|
+
* string, boolean, null, or a tree of plain objects / arrays, in which
|
|
13
|
+
* an `undefined` array element or object member is the sentinel
|
|
14
|
+
* `{"$undef": true}` (`UNDEFINED_SENTINEL`) that every runtime's seed
|
|
15
|
+
* decodes to its undefined value, and an object key that begins with `$`
|
|
16
|
+
* carries one more `$` (`encodeUndefinedMembers`). `null` when the source expression
|
|
17
|
+
* isn't statically evaluable.
|
|
18
|
+
*
|
|
19
|
+
* Absent on a prop entry whose prop has no destructure default
|
|
20
|
+
* (`spec/js-undefined-value.md`, "Shared: the seed and the default"):
|
|
21
|
+
* there is no default to fall back to, and every reader seeds such an
|
|
22
|
+
* entry with its nil, as {@link deriveStashFromDefaults} does.
|
|
14
23
|
*/
|
|
15
|
-
value
|
|
24
|
+
value?: unknown;
|
|
16
25
|
/**
|
|
17
26
|
* When set, the manifest consumer prefers `props[propName]` over
|
|
18
27
|
* `value`. Mirrors destructured-prop defaults
|
|
@@ -90,6 +99,33 @@ export declare function deriveStashFromDefaults(defaults: Record<string, SsrDefa
|
|
|
90
99
|
* exposes no template variables (no props, no signals, no memos).
|
|
91
100
|
*/
|
|
92
101
|
export declare function extractSsrDefaults(metadata: IRMetadata): Record<string, SsrDefault> | undefined;
|
|
102
|
+
/**
|
|
103
|
+
* The manifest's spelling of JS `undefined` inside a seed value: the
|
|
104
|
+
* one-key sentinel the golden vectors use (`spec/js-undefined-value.md`,
|
|
105
|
+
* "JSON encoding for vectors"). JSON has no `undefined`, and dropping it
|
|
106
|
+
* would turn an array element into `null` and a present member into a
|
|
107
|
+
* missing key.
|
|
108
|
+
*/
|
|
109
|
+
export declare const UNDEFINED_SENTINEL: Readonly<{
|
|
110
|
+
$undef: true;
|
|
111
|
+
}>;
|
|
112
|
+
/**
|
|
113
|
+
* `v` with each `undefined` array element and object member replaced by
|
|
114
|
+
* {@link UNDEFINED_SENTINEL}, as a new tree; a top-level `undefined` stays
|
|
115
|
+
* itself (the entry then has no `value`, which every seed reads as its
|
|
116
|
+
* undefined value). So that seed data shaped like the sentinel stays data,
|
|
117
|
+
* every object key that begins with `$` gets one more `$` (`$undef` to
|
|
118
|
+
* `$$undef`, `$$x` to `$$$x`): the only object left with the single key
|
|
119
|
+
* `$undef` is the sentinel, and {@link decodeUndefinedMembers} inverts the
|
|
120
|
+
* encoding exactly.
|
|
121
|
+
*/
|
|
122
|
+
export declare function encodeUndefinedMembers(v: unknown): unknown;
|
|
123
|
+
/**
|
|
124
|
+
* {@link encodeUndefinedMembers} inverted: each sentinel (an object whose
|
|
125
|
+
* only key is `$undef`, holding `true`) becomes `undefined` again, and each
|
|
126
|
+
* key that begins with `$$` loses one leading `$`.
|
|
127
|
+
*/
|
|
128
|
+
export declare function decodeUndefinedMembers(v: unknown): unknown;
|
|
93
129
|
/**
|
|
94
130
|
* Component-scope (non-module) `const` locals, by name → value source text.
|
|
95
131
|
* `referencesOwnProp` and `collectPropRefsTransitive` (below) use this to
|