@pixodesk/svg-animator-core 1.0.45 → 1.0.47

package/dist/{PxDocumentDiagnostic-CBhVyNEi.d.ts → PxDocumentDiagnostic-DX8w42-I.d.ts}

@@ -55,7 +55,7 @@ interface PxValidationContext {
     strict?: boolean;
 }
 /** @public @advanced */
-interface PxSchema<T, IsOptional extends boolean = false> {
+interface PxSchema<T, IsOptional extends boolean = false, StatesDefault extends boolean = boolean> {
     /** Phantom discriminator — `false` for required schemas, `true` for optional. Used by InferShape. */
     readonly _optional: IsOptional;
     sanitize(raw: unknown): T;
@@ -69,8 +69,19 @@ interface PxSchema<T, IsOptional extends boolean = false> {
     /** True if raw has the right structure to attempt sanitization (may still need repair). */
     _canSanitize(raw: unknown): boolean;
     readonly _default: T;
+    /** Whether `_default` was STATED (`px.enum([...], x)`, `px.number(x)`) rather than implied by
+     *  position or type — carried in the type, so an object schema can offer its stated ones as
+     *  `defaults`. Only a stated default is what an ABSENT optional field means. */
+    readonly _statesDefault: StatesDefault;
+    /**
+     * What the field means when a document LEAVES IT OUT — the value every reader must fall back
+     * to (the player normalises to it, the Editor's model defaults to it). `undefined` when the
+     * schema states none: absent then simply means unset. Readers ask the OBJECT schema instead:
+     * `PxTriggerSchema.defaults.mouseOut` is typed, and only stated fields are keys of it.
+     */
+    absentDefault(): T | undefined;
     /** Returns a new schema that marks this field as optional (?: in object shapes). */
-    optional(): PxSchema<T | undefined, true>;
+    optional(): PxSchema<T | undefined, true, StatesDefault>;
 }
 /** Extract the TypeScript type from a schema. @public @advanced */
 type PxInfer<S> = S extends PxSchema<infer T, any> ? T : never;
@@ -92,6 +103,25 @@ type UnionMembers<T extends ReadonlyArray<PxSchema<any, any>>> = {
 }[number];
 type AnyDiscriminantShape<K extends string> = Record<K, PxSchema<string | number | boolean | undefined, any>>;
 type AnyShape = Record<string, PxSchema<any, any>>;
+/** The keys of a shape whose schema STATES what absent means. */
+type StatedKeys<S extends AnyShape> = {
+    [K in keyof S]: S[K] extends PxSchema<any, any, true> ? K : never;
+}[keyof S];
+/**
+ * WHAT EACH FIELD MEANS WHEN A DOCUMENT LEAVES IT OUT — one entry per field whose schema states it
+ * (`px.enum([...], x)`, `px.number(x)`, a literal), typed without `undefined`. A field that states
+ * none (absent = unset, e.g. `clone.without`) is not a key, so asking for it does not compile — and
+ * neither does a key the schema has since renamed. The ONE source every reader shares: the player
+ * normalises an absent field to it, the Editor's model defaults to it.
+ */
+type InferDefaults<S extends AnyShape> = {
+    readonly [K in StatedKeys<S>]: Exclude<PxInfer<S[K]>, undefined>;
+};
+/** A closed or open object schema, with its shape and its stated {@link InferDefaults}. */
+type ObjectSchema<T, S extends AnyShape> = PxSchema<T> & {
+    readonly _shape: S;
+    readonly defaults: InferDefaults<S>;
+};
 type InferShape<S extends AnyShape> = {
     [K in keyof S as S[K] extends PxSchema<any, true> ? never : K]: PxInfer<S[K]>;
 } & {
@@ -166,23 +196,34 @@ type PxSchemaDesc = {
 };
 /** @public @advanced */
 declare function describeSchema(schema: PxSchema<any, any>): PxSchemaDesc;
+/** Matches a string. Absent means the stated value; without one, '' is only the repair value. */
+declare function string(): PxSchema<string, false, false>;
+declare function string(defaultVal: string): PxSchema<string, false, true>;
+/** Matches a finite number. Absent means the stated value; without one, 0 is only the repair value. */
+declare function number(): PxSchema<number, false, false>;
+declare function number(defaultVal: number): PxSchema<number, false, true>;
+/** Matches a boolean. Absent means the stated value; without one, false is only the repair value. */
+declare function boolean(): PxSchema<boolean, false, false>;
+declare function boolean(defaultVal: boolean): PxSchema<boolean, false, true>;
+/** Matches one of a fixed set of string/number values. Absent means the stated value; without one,
+ *  the first value is only the repair value. */
+declare function oneOf<T extends string | number>(values: readonly T[]): PxSchema<T, false, false>;
+declare function oneOf<T extends string | number>(values: readonly T[], defaultVal: T): PxSchema<T, false, true>;
+/**
+ * Returns the first schema whose isValid passes; TypeScript infers the union of all member types.
+ * Absent means the stated value; without one, the first member's default is only the repair value.
+ */
+declare function unionOf<const T extends ReadonlyArray<PxSchema<any, any>>>(schemas: T): PxSchema<UnionMembers<T>, false, false>;
+declare function unionOf<const T extends ReadonlyArray<PxSchema<any, any>>>(schemas: T, defaultVal: UnionMembers<T>): PxSchema<UnionMembers<T>, false, true>;
 /** @public @advanced */
 declare const px: {
-    /** Matches a string. Default: '' or provided value. */
-    readonly string: (defaultVal?: string) => PxSchema<string>;
-    /** Matches a finite number. Default: 0 or provided value. */
-    readonly number: (defaultVal?: number) => PxSchema<number>;
-    /** Matches a boolean. Default: false or provided value. */
-    readonly boolean: (defaultVal?: boolean) => PxSchema<boolean>;
-    /** Matches one exact primitive value; its default is the value itself. */
-    readonly literal: <T extends string | number | boolean>(value: T) => PxSchema<T>;
-    /** Matches one of a fixed set of string/number values. Default: first value. */
-    readonly enum: <T extends string | number>(values: readonly T[], defaultVal?: T) => PxSchema<T>;
-    /**
-     * Returns the first schema whose isValid passes.
-     * TypeScript infers the union of all member types automatically.
-     */
-    readonly union: <const T extends ReadonlyArray<PxSchema<any, any>>>(schemas: T, defaultVal?: UnionMembers<T>) => PxSchema<UnionMembers<T>>;
+    readonly string: typeof string;
+    readonly number: typeof number;
+    readonly boolean: typeof boolean;
+    /** Matches one exact primitive value; absent means the value itself. */
+    readonly literal: <T extends string | number | boolean>(value: T) => PxSchema<T, false, true>;
+    readonly enum: typeof oneOf;
+    readonly union: typeof unionOf;
     /**
      * Discriminated union — reads `raw[key]`, finds the member schema whose
      * literal at `key` matches, then delegates sanitize/isValid to that member.
@@ -192,17 +233,14 @@ declare const px: {
     readonly discriminatedUnion: <K extends string, const T extends ReadonlyArray<PxSchema<any, any> & {
         readonly _shape: AnyDiscriminantShape<K>;
     }>>(key: K, schemas: T) => PxSchema<UnionMembers<T>>;
-    /** Typed object — unknown keys are stripped. Required fields fall back to their default. */
-    readonly object: <S extends AnyShape>(shape: S) => PxSchema<InferShape<S>> & {
-        readonly _shape: S;
-    };
+    /** Typed object — unknown keys are stripped. Required fields fall back to their default.
+     *  Its `defaults` say what each stated field means when a document leaves it out. */
+    readonly object: <S extends AnyShape>(shape: S) => ObjectSchema<InferShape<S>, S>;
     /**
      * Open object — validates known keys; passes unknown keys through as-is,
      * or validates/sanitizes them against `openSchema` when provided.
      */
-    readonly openObject: <S extends AnyShape, V = any>(shape: S, openSchema?: PxSchema<V>) => PxSchema<InferOpenShape<S, V>> & {
-        readonly _shape: S;
-    };
+    readonly openObject: <S extends AnyShape, V = any>(shape: S, openSchema?: PxSchema<V>) => ObjectSchema<InferOpenShape<S, V>, S>;
     /**
      * Creates a new closed object schema by merging a base schema's shape with additional fields.
      * The base can be the result of px.object() or px.openObject() — anything with a _shape property.
@@ -212,9 +250,7 @@ declare const px: {
      */
     readonly extendedObject: <B extends AnyShape, E extends AnyShape>(base: {
         readonly _shape: B;
-    }, extra: E) => PxSchema<InferShape<B & E>> & {
-        readonly _shape: B & E;
-    };
+    }, extra: E) => ObjectSchema<InferShape<B & E>, B & E>;
     /** Array whose unrecoverable items are filtered out. Default: []. */
     readonly array: <T>(item: PxSchema<T>) => PxSchema<Array<T>>;
     /** String-keyed record whose unrecoverable values are dropped. Default: {}. */
@@ -544,7 +580,14 @@ declare const PX_TRIGGER_DEFAULTS: {
     readonly mouseOut: "continue";
     readonly visibilityThreshold: 0.5;
     readonly visibilityDebounce: 150;
+    readonly finish: "hold";
 };
+/**
+ * What an absent `timeline.duration` means — the number the SCHEMA states (`PxTimeTimelineSchema.defaults.duration`), kept here as a constant for the runtime's arithmetic. @internal
+ */
+declare const PX_DEFAULT_DURATION_MS = 1000;
+/** What an absent `timeline.iterations` means — see `PX_DEFAULT_DURATION_MS`. @internal */
+declare const PX_DEFAULT_ITERATIONS = 1;
 /** A trigger with every default filled in. @public @advanced */
 interface PxResolvedTrigger {
     readonly start: NonNullable<PxTrigger['start']>;
@@ -1004,7 +1047,7 @@ declare function createDiagnostics(config?: PxDiagnosticsConfig, prefix?: string
  * `string | [x1, y1, x2, y2]`
  * @public @advanced
  */
-declare const PxEasingOrRefSchema: PxSchema<string | [number, number, number, number], false>;
+declare const PxEasingOrRefSchema: PxSchema<string | [number, number, number, number], false, false>;
 /**
  * Easing function definition.
  * Can be a named reference to a predefined easing or a cubic-bezier array [x1, y1, x2, y2].
@@ -1060,7 +1103,7 @@ declare const PxKeyframeValueSchema: PxSchema<string | number | number[] | ({} &
     origin?: [number, number] | undefined;
 }) | _PxGradientStop[] | ({
     pathData: string;
-} & {}), false>;
+} & {}), false, false>;
 /** @public @advanced */
 declare const PxKeyframeSchema: PxSchema<{} & {
     time?: number | undefined;
@@ -1076,9 +1119,9 @@ declare const PxKeyframeSchema: PxSchema<{} & {
     easing?: string | [number, number, number, number] | undefined;
     tangentOut?: [number, number] | undefined;
     tangentIn?: [number, number] | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        time: PxSchema<number | undefined, true>;
+        time: PxSchema<number | undefined, true, false>;
         value: PxSchema<string | number | number[] | ({} & {
             translate?: [number, number] | undefined;
             rotate?: number | undefined;
@@ -1087,11 +1130,12 @@ declare const PxKeyframeSchema: PxSchema<{} & {
             origin?: [number, number] | undefined;
         }) | _PxGradientStop[] | ({
             pathData: string;
-        } & {}) | undefined, true>;
-        easing: PxSchema<string | [number, number, number, number] | undefined, true>;
-        tangentOut: PxSchema<[number, number] | undefined, true>;
-        tangentIn: PxSchema<[number, number] | undefined, true>;
+        } & {}) | undefined, true, false>;
+        easing: PxSchema<string | [number, number, number, number] | undefined, true, false>;
+        tangentOut: PxSchema<[number, number] | undefined, true, boolean>;
+        tangentIn: PxSchema<[number, number] | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /**
  * THE RUNTIME FORM — what `normalizeKeyframes` hands the engines, and what the tree-level
@@ -1155,11 +1199,15 @@ declare const PxLoopSchema: PxSchema<{} & {
     segmentCount?: number | undefined;
     repeatAt?: "start" | "end" | undefined;
     direction?: "normal" | "alternate" | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        segmentCount: PxSchema<number | undefined, true>;
-        repeatAt: PxSchema<"start" | "end" | undefined, true>;
-        direction: PxSchema<"normal" | "alternate" | undefined, true>;
+        segmentCount: PxSchema<number | undefined, true, false>;
+        repeatAt: PxSchema<"start" | "end" | undefined, true, true>;
+        direction: PxSchema<"normal" | "alternate" | undefined, true, true>;
+    };
+    readonly defaults: {
+        readonly direction: "normal" | "alternate";
+        readonly repeatAt: "start" | "end";
     };
 };
 /**
@@ -1248,7 +1296,7 @@ declare const PxPropertyAnimationSchema: PxSchema<{} & {
     }) | undefined;
     autoOrient?: boolean | undefined;
     alongPathMode?: "sampled" | "offsetPath" | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         value: PxSchema<string | number | number[] | ({} & {
             translate?: [number, number] | undefined;
@@ -1258,7 +1306,7 @@ declare const PxPropertyAnimationSchema: PxSchema<{} & {
             origin?: [number, number] | undefined;
         }) | _PxGradientStop[] | ({
             pathData: string;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         keyframes: PxSchema<({} & {
             time?: number | undefined;
             value?: string | number | number[] | ({} & {
@@ -1273,14 +1321,17 @@ declare const PxPropertyAnimationSchema: PxSchema<{} & {
             easing?: string | [number, number, number, number] | undefined;
             tangentOut?: [number, number] | undefined;
             tangentIn?: [number, number] | undefined;
-        })[] | undefined, true>;
+        })[] | undefined, true, boolean>;
         loop: PxSchema<boolean | ({} & {
             segmentCount?: number | undefined;
             repeatAt?: "start" | "end" | undefined;
             direction?: "normal" | "alternate" | undefined;
-        }) | undefined, true>;
-        autoOrient: PxSchema<boolean | undefined, true>;
-        alongPathMode: PxSchema<"sampled" | "offsetPath" | undefined, true>;
+        }) | undefined, true, false>;
+        autoOrient: PxSchema<boolean | undefined, true, false>;
+        alongPathMode: PxSchema<"sampled" | "offsetPath" | undefined, true, true>;
+    };
+    readonly defaults: {
+        readonly alongPathMode: "sampled" | "offsetPath";
     };
 };
 /** Animation definition for a single CSS/SVG property. @public */
@@ -1292,14 +1343,15 @@ declare const PxTransformPartsSchema: PxSchema<{} & {
     skew?: number | undefined;
     scale?: [number, number] | undefined;
     origin?: [number, number] | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        translate: PxSchema<[number, number] | undefined, true>;
-        rotate: PxSchema<number | undefined, true>;
-        skew: PxSchema<number | undefined, true>;
-        scale: PxSchema<[number, number] | undefined, true>;
-        origin: PxSchema<[number, number] | undefined, true>;
+        translate: PxSchema<[number, number] | undefined, true, boolean>;
+        rotate: PxSchema<number | undefined, true, false>;
+        skew: PxSchema<number | undefined, true, false>;
+        scale: PxSchema<[number, number] | undefined, true, boolean>;
+        origin: PxSchema<[number, number] | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** Record of transform parts forming a single transform `value`. @public */
 type PxTransformParts = PxInfer<typeof PxTransformPartsSchema>;
@@ -1371,7 +1423,7 @@ declare const PxTransformValueSchema: PxSchema<string | ({} & {
         scale?: [number, number] | undefined;
         origin?: [number, number] | undefined;
     };
-} & {}), false>;
+} & {}), false, false>;
 /** Unified `transform` slot value: string | structured static | animated. @public */
 type PxTransformValue = PxInfer<typeof PxTransformValueSchema>;
 /** @public @advanced */
@@ -1407,7 +1459,7 @@ declare const PxAnimationDefinitionSchema: PxSchema<Record<string, {} & {
     }) | undefined;
     autoOrient?: boolean | undefined;
     alongPathMode?: "sampled" | "offsetPath" | undefined;
-}>, false>;
+}>, false, boolean>;
 /**
  * Complete animation definition containing one or more property animations.
  * Each key is a CSS/SVG property name (e.g., "opacity", "scale", "rotate").
@@ -1479,7 +1531,7 @@ declare const PxElementAnimationSchema: PxSchema<string | Record<string, {} & {
     }) | undefined;
     autoOrient?: boolean | undefined;
     alongPathMode?: "sampled" | "offsetPath" | undefined;
-}>)[], false>;
+}>)[], false, false>;
 /**
  * Element animation specification.
  * Can be a string reference, array of references, inline definition, or a mixed array.
@@ -1494,14 +1546,22 @@ declare const PxTriggerSchema: PxSchema<{} & {
     finish?: "reset" | "hold" | undefined;
     visibilityThreshold?: number | undefined;
     visibilityDebounce?: number | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        start: PxSchema<"none" | "mouseOver" | "load" | "click" | undefined, true>;
-        offScreen: PxSchema<"continue" | "pause" | "reset" | undefined, true>;
-        mouseOut: PxSchema<"reverse" | "continue" | "pause" | "reset" | undefined, true>;
-        finish: PxSchema<"reset" | "hold" | undefined, true>;
-        visibilityThreshold: PxSchema<number | undefined, true>;
-        visibilityDebounce: PxSchema<number | undefined, true>;
+        start: PxSchema<"none" | "mouseOver" | "load" | "click" | undefined, true, true>;
+        offScreen: PxSchema<"continue" | "pause" | "reset" | undefined, true, true>;
+        mouseOut: PxSchema<"reverse" | "continue" | "pause" | "reset" | undefined, true, true>;
+        finish: PxSchema<"reset" | "hold" | undefined, true, true>;
+        visibilityThreshold: PxSchema<number | undefined, true, true>;
+        visibilityDebounce: PxSchema<number | undefined, true, true>;
+    };
+    readonly defaults: {
+        readonly offScreen: "continue" | "pause" | "reset";
+        readonly start: "none" | "mouseOver" | "load" | "click";
+        readonly mouseOut: "reverse" | "continue" | "pause" | "reset";
+        readonly visibilityThreshold: number;
+        readonly finish: "reset" | "hold";
+        readonly visibilityDebounce: number;
     };
 };
 /** Defines when and how an animation should be triggered. @public */
@@ -1509,11 +1569,12 @@ type PxTrigger = PxInfer<typeof PxTriggerSchema>;
 declare const PxGlyphSchema: PxSchema<{
     width: number;
     pathData: string;
-} & {}, false> & {
+} & {}, false, boolean> & {
     readonly _shape: {
-        width: PxSchema<number, false>;
-        pathData: PxSchema<string, false>;
+        width: PxSchema<number, false, false>;
+        pathData: PxSchema<string, false, false>;
     };
+    readonly defaults: {};
 };
 /** @public */
 type PxGlyph = PxInfer<typeof PxGlyphSchema>;
@@ -1526,17 +1587,18 @@ declare const PxGlyphFontSchema: PxSchema<{
         width: number;
         pathData: string;
     } & {}>;
-} & {}, false> & {
+} & {}, false, boolean> & {
     readonly _shape: {
-        fontFamily: PxSchema<string, false>;
-        fontStyle: PxSchema<string, false>;
-        ascent: PxSchema<number, false>;
-        unitsPerEm: PxSchema<number, false>;
+        fontFamily: PxSchema<string, false, false>;
+        fontStyle: PxSchema<string, false, false>;
+        ascent: PxSchema<number, false, false>;
+        unitsPerEm: PxSchema<number, false, false>;
         glyphs: PxSchema<Record<string, {
             width: number;
             pathData: string;
-        } & {}>, false>;
+        } & {}>, false, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public */
 type PxGlyphFont = PxInfer<typeof PxGlyphFontSchema>;
@@ -1586,9 +1648,9 @@ declare const PxDefinitionsSchema: PxSchema<{} & {
             pathData: string;
         } & {}>;
     } & {}> | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        easings: PxSchema<Record<string, [number, number, number, number]> | undefined, true>;
+        easings: PxSchema<Record<string, [number, number, number, number]> | undefined, true, boolean>;
         animations: PxSchema<Record<string, Record<string, {} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -1621,7 +1683,7 @@ declare const PxDefinitionsSchema: PxSchema<{} & {
             }) | undefined;
             autoOrient?: boolean | undefined;
             alongPathMode?: "sampled" | "offsetPath" | undefined;
-        }>> | undefined, true>;
+        }>> | undefined, true, boolean>;
         fonts: PxSchema<Record<string, {
             fontFamily: string;
             fontStyle: string;
@@ -1631,8 +1693,9 @@ declare const PxDefinitionsSchema: PxSchema<{} & {
                 width: number;
                 pathData: string;
             } & {}>;
-        } & {}> | undefined, true>;
+        } & {}> | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** Reusable definitions library for easings, animations and fonts. @public */
 type PxDefinitions = PxInfer<typeof PxDefinitionsSchema>;
@@ -1640,10 +1703,13 @@ type PxDefinitions = PxInfer<typeof PxDefinitionsSchema>;
 declare const PxScrollRangePointSchema: PxSchema<{} & {
     phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
     fraction?: number | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        phase: PxSchema<"cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined, true>;
-        fraction: PxSchema<number | undefined, true>;
+        phase: PxSchema<"cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined, true, true>;
+        fraction: PxSchema<number | undefined, true, false>;
+    };
+    readonly defaults: {
+        readonly phase: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing";
     };
 };
 /** @public */
@@ -1658,17 +1724,18 @@ declare const PxScrollRangeSchema: PxSchema<{} & {
         phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
         fraction?: number | undefined;
     }) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         start: PxSchema<({} & {
             phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
             fraction?: number | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         end: PxSchema<({} & {
             phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
             fraction?: number | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxScrollSchema: PxSchema<{} & {
@@ -1691,17 +1758,17 @@ declare const PxScrollSchema: PxSchema<{} & {
             fraction?: number | undefined;
         }) | undefined;
     }) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        kind: PxSchema<"view" | "scroll" | undefined, true>;
-        axis: PxSchema<"block" | "inline" | "x" | "y" | undefined, true>;
-        source: PxSchema<"nearest" | "root" | undefined, true>;
-        subject: PxSchema<string | undefined, true>;
-        smoothing: PxSchema<number | undefined, true>;
-        pin: PxSchema<boolean | undefined, true>;
-        pinAlign: PxSchema<"top" | "center" | "bottom" | undefined, true>;
-        pinOffset: PxSchema<number | undefined, true>;
-        pinDistance: PxSchema<number | undefined, true>;
+        kind: PxSchema<"view" | "scroll" | undefined, true, true>;
+        axis: PxSchema<"block" | "inline" | "x" | "y" | undefined, true, true>;
+        source: PxSchema<"nearest" | "root" | undefined, true, true>;
+        subject: PxSchema<string | undefined, true, false>;
+        smoothing: PxSchema<number | undefined, true, false>;
+        pin: PxSchema<boolean | undefined, true, true>;
+        pinAlign: PxSchema<"top" | "center" | "bottom" | undefined, true, true>;
+        pinOffset: PxSchema<number | undefined, true, false>;
+        pinDistance: PxSchema<number | undefined, true, false>;
         range: PxSchema<({} & {
             start?: ({} & {
                 phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
@@ -1711,11 +1778,67 @@ declare const PxScrollSchema: PxSchema<{} & {
                 phase?: "cover" | "contain" | "entry" | "exit" | "entry-crossing" | "exit-crossing" | undefined;
                 fraction?: number | undefined;
             }) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
+    };
+    readonly defaults: {
+        readonly source: "nearest" | "root";
+        readonly axis: "block" | "inline" | "x" | "y";
+        readonly pin: boolean;
+        readonly kind: "view" | "scroll";
+        readonly pinAlign: "top" | "center" | "bottom";
     };
 };
 /** @public */
 type PxScroll = PxInfer<typeof PxScrollSchema>;
+/** The time-driven member of {@link PxTimelineSchema} — what an absent `type` selects. Exported
+ *  so a reader can ask it what an omitted field means (`PxTimeTimelineSchema.defaults.duration`).
+ *  @public @advanced */
+declare const PxTimeTimelineSchema: PxSchema<{} & {
+    type?: "time" | undefined;
+    engine?: "native" | "js" | "auto" | undefined;
+    frameRate?: number | undefined;
+    duration?: number | undefined;
+    trigger?: ({} & {
+        start?: "none" | "mouseOver" | "load" | "click" | undefined;
+        offScreen?: "continue" | "pause" | "reset" | undefined;
+        mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+        finish?: "reset" | "hold" | undefined;
+        visibilityThreshold?: number | undefined;
+        visibilityDebounce?: number | undefined;
+    }) | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    fillMode?: "none" | "forwards" | "backwards" | "both" | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+}, false, boolean> & {
+    readonly _shape: {
+        type: PxSchema<"time" | undefined, true, true>;
+        engine: PxSchema<"native" | "js" | "auto" | undefined, true, true>;
+        frameRate: PxSchema<number | undefined, true, false>;
+        duration: PxSchema<number | undefined, true, true>;
+        trigger: PxSchema<({} & {
+            start?: "none" | "mouseOver" | "load" | "click" | undefined;
+            offScreen?: "continue" | "pause" | "reset" | undefined;
+            mouseOut?: "reverse" | "continue" | "pause" | "reset" | undefined;
+            finish?: "reset" | "hold" | undefined;
+            visibilityThreshold?: number | undefined;
+            visibilityDebounce?: number | undefined;
+        }) | undefined, true, boolean>;
+        delay: PxSchema<number | undefined, true, true>;
+        iterations: PxSchema<number | "infinite" | undefined, true, true>;
+        fillMode: PxSchema<"none" | "forwards" | "backwards" | "both" | undefined, true, true>;
+        direction: PxSchema<"reverse" | "normal" | "alternate" | "alternate-reverse" | undefined, true, true>;
+    };
+    readonly defaults: {
+        readonly duration: number;
+        readonly iterations: number | "infinite";
+        readonly engine: "native" | "js" | "auto";
+        readonly delay: number;
+        readonly fillMode: "none" | "forwards" | "backwards" | "both";
+        readonly direction: "reverse" | "normal" | "alternate" | "alternate-reverse";
+        readonly type: "time";
+    };
+};
 /** @public @advanced */
 declare const PxTimelineSchema: PxSchema<({} & {
     type?: "time" | undefined;
@@ -1786,7 +1909,7 @@ declare const PxTimelineSchema: PxSchema<({} & {
             fraction?: number | undefined;
         }) | undefined;
     }) | undefined;
-}), false>;
+}), false, boolean>;
 /** @public */
 type PxTimeline = PxInfer<typeof PxTimelineSchema>;
 /**
@@ -1886,11 +2009,12 @@ interface _PxAnimatorConfig {
 declare const PxBindingSchema: PxSchema<{
     target: string;
     animateWith: string[];
-} & {}, false> & {
+} & {}, false, boolean> & {
     readonly _shape: {
-        target: PxSchema<string, false>;
-        animateWith: PxSchema<string[], false>;
+        target: PxSchema<string, false, false>;
+        animateWith: PxSchema<string[], false, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public */
 type PxBinding = PxInfer<typeof PxBindingSchema>;
@@ -2028,7 +2152,7 @@ declare const PxAnimatorConfigSchema: PxSchema<{} & {
     } & {})[] | undefined;
     debugGlobalName?: string | undefined;
     version?: string | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         timeline: PxSchema<({} & {
             type?: "time" | undefined;
@@ -2099,7 +2223,7 @@ declare const PxAnimatorConfigSchema: PxSchema<{} & {
                     fraction?: number | undefined;
                 }) | undefined;
             }) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         definitions: PxSchema<({} & {
             easings?: Record<string, [number, number, number, number]> | undefined;
             animations?: Record<string, Record<string, {} & {
@@ -2145,14 +2269,15 @@ declare const PxAnimatorConfigSchema: PxSchema<{} & {
                     pathData: string;
                 } & {}>;
             } & {}> | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         bindings: PxSchema<({
             target: string;
             animateWith: string[];
-        } & {})[] | undefined, true>;
-        debugGlobalName: PxSchema<string | undefined, true>;
-        version: PxSchema<string | undefined, true>;
+        } & {})[] | undefined, true, boolean>;
+        debugGlobalName: PxSchema<string | undefined, true, false>;
+        version: PxSchema<string | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /**
  * Global animation configuration that applies to all animations in the document.
@@ -2201,7 +2326,7 @@ declare const PxAttrValueSchema: PxSchema<string | number | number[] | ({} & {
     origin?: [number, number] | undefined;
 }) | ({
     value: any;
-} & {}), false>;
+} & {}), false, false>;
 /** Fixed-length 2-number tuple. `[x, y]` for positions, `[sx, sy]` for scale, …. @public */
 type PxVec2 = [number, number];
 /**
@@ -2403,7 +2528,7 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
     }) | ({
         value: [number, number];
     } & {}) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         translate: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
@@ -2439,7 +2564,7 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         rotate: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2474,7 +2599,7 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         scale: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2509,7 +2634,7 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         skew: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2544,7 +2669,7 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         origin: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2579,8 +2704,9 @@ declare const PxTransformByEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxRepeaterEffectSchema: PxSchema<{} & {
@@ -2760,9 +2886,9 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
     }) | ({
         value: [number, number];
     } & {}) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        copies: PxSchema<number | undefined, true>;
+        copies: PxSchema<number | undefined, true, false>;
         translate: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2797,7 +2923,7 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         rotate: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2832,7 +2958,7 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         skew: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2867,7 +2993,7 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         scale: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2902,7 +3028,7 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         origin: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -2937,8 +3063,9 @@ declare const PxRepeaterEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxMaskedByEffectSchema: PxSchema<{} & {
@@ -2950,16 +3077,21 @@ declare const PxMaskedByEffectSchema: PxSchema<{} & {
     y?: number | undefined;
     width?: number | undefined;
     height?: number | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        source: PxSchema<string | undefined, true>;
-        maskType: PxSchema<"luminance" | "alpha" | undefined, true>;
-        maskUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true>;
-        maskContentUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true>;
-        x: PxSchema<number | undefined, true>;
-        y: PxSchema<number | undefined, true>;
-        width: PxSchema<number | undefined, true>;
-        height: PxSchema<number | undefined, true>;
+        source: PxSchema<string | undefined, true, false>;
+        maskType: PxSchema<"luminance" | "alpha" | undefined, true, true>;
+        maskUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true, true>;
+        maskContentUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true, true>;
+        x: PxSchema<number | undefined, true, false>;
+        y: PxSchema<number | undefined, true, false>;
+        width: PxSchema<number | undefined, true, false>;
+        height: PxSchema<number | undefined, true, false>;
+    };
+    readonly defaults: {
+        readonly maskType: "luminance" | "alpha";
+        readonly maskUnits: "userSpaceOnUse" | "objectBoundingBox";
+        readonly maskContentUnits: "userSpaceOnUse" | "objectBoundingBox";
     };
 };
 /** @public @advanced */
@@ -2999,7 +3131,7 @@ declare const PxClipPathEffectSchema: PxSchema<{} & {
     }) | ({
         value: string;
     } & {}) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         pathData: PxSchema<string | ({} & {
             value?: string | number | number[] | ({} & {
@@ -3035,8 +3167,9 @@ declare const PxClipPathEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: string;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxStrokeTrimEffectSchema: PxSchema<{} & {
@@ -3111,7 +3244,7 @@ declare const PxStrokeTrimEffectSchema: PxSchema<{} & {
         value: [number, number];
     } & {}) | undefined;
     subPaths?: "separate" | "combined" | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         offset: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
@@ -3147,7 +3280,7 @@ declare const PxStrokeTrimEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         range: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3182,8 +3315,11 @@ declare const PxStrokeTrimEffectSchema: PxSchema<{} & {
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
-        subPaths: PxSchema<"separate" | "combined" | undefined, true>;
+        } & {}) | undefined, true, false>;
+        subPaths: PxSchema<"separate" | "combined" | undefined, true, true>;
+    };
+    readonly defaults: {
+        readonly subPaths: "separate" | "combined";
     };
 };
 /** @public @advanced */
@@ -3191,12 +3327,13 @@ declare const PxRetimeEffectSchema: PxSchema<{} & {
     start?: number | undefined;
     stretch?: number | undefined;
     timeCrop?: [number, number] | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        start: PxSchema<number | undefined, true>;
-        stretch: PxSchema<number | undefined, true>;
-        timeCrop: PxSchema<[number, number] | undefined, true>;
+        start: PxSchema<number | undefined, true, false>;
+        stretch: PxSchema<number | undefined, true, false>;
+        timeCrop: PxSchema<[number, number] | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxCloneEffectSchema: PxSchema<{} & {
@@ -3207,16 +3344,17 @@ declare const PxCloneEffectSchema: PxSchema<{} & {
         stretch?: number | undefined;
         timeCrop?: [number, number] | undefined;
     }) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        without: PxSchema<"translate" | undefined, true>;
-        source: PxSchema<string | undefined, true>;
+        without: PxSchema<"translate" | undefined, true, false>;
+        source: PxSchema<string | undefined, true, false>;
         retime: PxSchema<({} & {
             start?: number | undefined;
             stretch?: number | undefined;
             timeCrop?: [number, number] | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** A single color stop. `offset` is in `[0, 1]`; `color` is a CSS color
  *  string (`#rrggbb`, `rgb(…)`, `rgba(…)`, or named). */
@@ -3228,11 +3366,12 @@ interface _PxGradientStop {
 declare const PxGradientStopSchema: PxSchema<{
     offset: number;
     color: string;
-} & {}, false> & {
+} & {}, false, boolean> & {
     readonly _shape: {
-        offset: PxSchema<number, false>;
-        color: PxSchema<string, false>;
+        offset: PxSchema<number, false, false>;
+        color: PxSchema<string, false, false>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxFillGradientEffectSchema: PxSchema<{
@@ -3457,9 +3596,9 @@ declare const PxFillGradientEffectSchema: PxSchema<{
     gradientUnits?: "userSpaceOnUse" | "objectBoundingBox" | undefined;
     spreadMethod?: "repeat" | "pad" | "reflect" | undefined;
     gradientTransform?: string | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        type: PxSchema<"linear" | "radial", false>;
+        type: PxSchema<"linear" | "radial", false, false>;
         start: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3494,7 +3633,7 @@ declare const PxFillGradientEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         end: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3529,7 +3668,7 @@ declare const PxFillGradientEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         center: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3564,7 +3703,7 @@ declare const PxFillGradientEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         radius: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3599,7 +3738,7 @@ declare const PxFillGradientEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         focal: PxSchema<[number, number] | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3634,7 +3773,7 @@ declare const PxFillGradientEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: [number, number];
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         stops: PxSchema<({
             offset: number;
             color: string;
@@ -3675,10 +3814,14 @@ declare const PxFillGradientEffectSchema: PxSchema<{
                 offset: number;
                 color: string;
             } & {})[];
-        } & {}) | undefined, true>;
-        gradientUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true>;
-        spreadMethod: PxSchema<"repeat" | "pad" | "reflect" | undefined, true>;
-        gradientTransform: PxSchema<string | undefined, true>;
+        } & {}) | undefined, true, false>;
+        gradientUnits: PxSchema<"userSpaceOnUse" | "objectBoundingBox" | undefined, true, true>;
+        spreadMethod: PxSchema<"repeat" | "pad" | "reflect" | undefined, true, true>;
+        gradientTransform: PxSchema<string | undefined, true, false>;
+    };
+    readonly defaults: {
+        readonly gradientUnits: "userSpaceOnUse" | "objectBoundingBox";
+        readonly spreadMethod: "repeat" | "pad" | "reflect";
     };
 };
 /** @public @advanced */
@@ -3759,13 +3902,13 @@ declare const PxTextPathEffectSchema: PxSchema<{
     }) | ({
         value: number;
     } & {}) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        pathData: PxSchema<string, false>;
-        pathOverflow: PxSchema<"clip" | "extend" | undefined, true>;
-        lengthAdjust: PxSchema<"spacing" | "spacingAndGlyphs" | undefined, true>;
-        method: PxSchema<"align" | "stretch" | undefined, true>;
-        spacing: PxSchema<"auto" | "exact" | undefined, true>;
+        pathData: PxSchema<string, false, false>;
+        pathOverflow: PxSchema<"clip" | "extend" | undefined, true, true>;
+        lengthAdjust: PxSchema<"spacing" | "spacingAndGlyphs" | undefined, true, true>;
+        method: PxSchema<"align" | "stretch" | undefined, true, true>;
+        spacing: PxSchema<"auto" | "exact" | undefined, true, true>;
         startOffset: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3800,7 +3943,7 @@ declare const PxTextPathEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
         textLength: PxSchema<number | ({} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -3835,16 +3978,23 @@ declare const PxTextPathEffectSchema: PxSchema<{
             alongPathMode?: "sampled" | "offsetPath" | undefined;
         }) | ({
             value: number;
-        } & {}) | undefined, true>;
+        } & {}) | undefined, true, false>;
+    };
+    readonly defaults: {
+        readonly spacing: "auto" | "exact";
+        readonly pathOverflow: "clip" | "extend";
+        readonly lengthAdjust: "spacing" | "spacingAndGlyphs";
+        readonly method: "align" | "stretch";
     };
 };
 /** @public @advanced */
 declare const PxTextEffectSchema: PxSchema<{} & {
     useGlyphs?: boolean | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        useGlyphs: PxSchema<boolean | undefined, true>;
+        useGlyphs: PxSchema<boolean | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare const PxEffectsSchema: PxSchema<{} & {
@@ -4859,7 +5009,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
     text?: ({} & {
         useGlyphs?: boolean | undefined;
     }) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
         transformBy: PxSchema<({} & {
             translate?: [number, number] | ({} & {
@@ -5037,7 +5187,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             }) | ({
                 value: [number, number];
             } & {}) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         repeater: PxSchema<({} & {
             copies?: number | undefined;
             translate?: [number, number] | ({} & {
@@ -5215,7 +5365,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             }) | ({
                 value: [number, number];
             } & {}) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         maskedBy: PxSchema<({} & {
             source?: string | undefined;
             maskType?: "luminance" | "alpha" | undefined;
@@ -5225,7 +5375,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             y?: number | undefined;
             width?: number | undefined;
             height?: number | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         clipPath: PxSchema<({} & {
             pathData?: string | ({} & {
                 value?: string | number | number[] | ({} & {
@@ -5262,7 +5412,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             }) | ({
                 value: string;
             } & {}) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         strokeTrim: PxSchema<({} & {
             offset?: number | ({} & {
                 value?: string | number | number[] | ({} & {
@@ -5335,7 +5485,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
                 value: [number, number];
             } & {}) | undefined;
             subPaths?: "separate" | "combined" | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         clone: PxSchema<({} & {
             without?: "translate" | undefined;
             source?: string | undefined;
@@ -5344,7 +5494,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
                 stretch?: number | undefined;
                 timeCrop?: [number, number] | undefined;
             }) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         fillGradient: PxSchema<({
             type: "linear" | "radial";
         } & {
@@ -5567,7 +5717,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             gradientUnits?: "userSpaceOnUse" | "objectBoundingBox" | undefined;
             spreadMethod?: "repeat" | "pad" | "reflect" | undefined;
             gradientTransform?: string | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         strokeGradient: PxSchema<({
             type: "linear" | "radial";
         } & {
@@ -5790,7 +5940,7 @@ declare const PxEffectsSchema: PxSchema<{} & {
             gradientUnits?: "userSpaceOnUse" | "objectBoundingBox" | undefined;
             spreadMethod?: "repeat" | "pad" | "reflect" | undefined;
             gradientTransform?: string | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         textPath: PxSchema<({
             pathData: string;
         } & {
@@ -5868,11 +6018,12 @@ declare const PxEffectsSchema: PxSchema<{} & {
             }) | ({
                 value: number;
             } & {}) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         text: PxSchema<({} & {
             useGlyphs?: boolean | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public */
 type PxEffects = PxInfer<typeof PxEffectsSchema>;
@@ -6995,13 +7146,13 @@ declare const PxNodeBaseSchema: PxSchema<{
     style?: Record<string, string | number> | undefined;
 } & {
     [key: string]: any;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        type: PxSchema<string, false>;
-        domType: PxSchema<string | undefined, true>;
-        textContent: PxSchema<string | undefined, true>;
-        id: PxSchema<string | undefined, true>;
-        meta: PxSchema<any, true>;
+        type: PxSchema<string, false, false>;
+        domType: PxSchema<string | undefined, true, false>;
+        textContent: PxSchema<string | undefined, true, false>;
+        id: PxSchema<string | undefined, true, false>;
+        meta: PxSchema<any, true, boolean>;
         effects: PxSchema<({} & {
             transformBy?: ({} & {
                 translate?: [number, number] | ({} & {
@@ -8014,7 +8165,7 @@ declare const PxNodeBaseSchema: PxSchema<{
             text?: ({} & {
                 useGlyphs?: boolean | undefined;
             }) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         animate: PxSchema<string | Record<string, {} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -8079,9 +8230,10 @@ declare const PxNodeBaseSchema: PxSchema<{
             }) | undefined;
             autoOrient?: boolean | undefined;
             alongPathMode?: "sampled" | "offsetPath" | undefined;
-        }>)[] | undefined, true>;
-        style: PxSchema<Record<string, string | number> | undefined, true>;
+        }>)[] | undefined, true, false>;
+        style: PxSchema<Record<string, string | number> | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /** @public @advanced */
 declare let PxNodeSchema: PxSchema<any>;
@@ -8233,11 +8385,11 @@ declare const PxSvgNodeRootSchema: PxSchema<{} & {
         debugGlobalName?: string | undefined;
         version?: string | undefined;
     }) | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        width: PxSchema<string | number | undefined, true>;
-        height: PxSchema<string | number | undefined, true>;
-        viewBox: PxSchema<string | undefined, true>;
+        width: PxSchema<string | number | undefined, true, false>;
+        height: PxSchema<string | number | undefined, true, false>;
+        viewBox: PxSchema<string | undefined, true, false>;
         animator: PxSchema<({} & {
             timeline?: ({} & {
                 type?: "time" | undefined;
@@ -8361,8 +8513,9 @@ declare const PxSvgNodeRootSchema: PxSchema<{} & {
             } & {})[] | undefined;
             debugGlobalName?: string | undefined;
             version?: string | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
     };
+    readonly defaults: {};
 };
 /**
  * Root SVG element containing the entire animated graphic.
@@ -9602,13 +9755,13 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
     style?: Record<string, string | number> | undefined;
 } & {
     [key: string]: any;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        type: PxSchema<"svg", false>;
-        children: PxSchema<any[] | undefined, true>;
-        width: PxSchema<string | number | undefined, true>;
-        height: PxSchema<string | number | undefined, true>;
-        viewBox: PxSchema<string | undefined, true>;
+        type: PxSchema<"svg", false, true>;
+        children: PxSchema<any[] | undefined, true, boolean>;
+        width: PxSchema<string | number | undefined, true, false>;
+        height: PxSchema<string | number | undefined, true, false>;
+        viewBox: PxSchema<string | undefined, true, false>;
         animator: PxSchema<({} & {
             timeline?: ({} & {
                 type?: "time" | undefined;
@@ -9732,11 +9885,11 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
             } & {})[] | undefined;
             debugGlobalName?: string | undefined;
             version?: string | undefined;
-        }) | undefined, true>;
-        domType: PxSchema<string | undefined, true>;
-        textContent: PxSchema<string | undefined, true>;
-        id: PxSchema<string | undefined, true>;
-        meta: PxSchema<any, true>;
+        }) | undefined, true, boolean>;
+        domType: PxSchema<string | undefined, true, false>;
+        textContent: PxSchema<string | undefined, true, false>;
+        id: PxSchema<string | undefined, true, false>;
+        meta: PxSchema<any, true, boolean>;
         effects: PxSchema<({} & {
             transformBy?: ({} & {
                 translate?: [number, number] | ({} & {
@@ -10749,7 +10902,7 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
             text?: ({} & {
                 useGlyphs?: boolean | undefined;
             }) | undefined;
-        }) | undefined, true>;
+        }) | undefined, true, boolean>;
         animate: PxSchema<string | Record<string, {} & {
             value?: string | number | number[] | ({} & {
                 translate?: [number, number] | undefined;
@@ -10814,8 +10967,11 @@ declare const PxAnimatedSvgDocumentSchema: PxSchema<{
             }) | undefined;
             autoOrient?: boolean | undefined;
             alongPathMode?: "sampled" | "offsetPath" | undefined;
-        }>)[] | undefined, true>;
-        style: PxSchema<Record<string, string | number> | undefined, true>;
+        }>)[] | undefined, true, false>;
+        style: PxSchema<Record<string, string | number> | undefined, true, boolean>;
+    };
+    readonly defaults: {
+        readonly type: "svg";
     };
 };
 /**
@@ -10866,13 +11022,14 @@ declare const PxBezierPathSchema: PxSchema<{
     i?: number[][] | undefined;
     o?: number[][] | undefined;
     c?: boolean | undefined;
-}, false> & {
+}, false, boolean> & {
     readonly _shape: {
-        v: PxSchema<number[][], false>;
-        i: PxSchema<number[][] | undefined, true>;
-        o: PxSchema<number[][] | undefined, true>;
-        c: PxSchema<boolean | undefined, true>;
+        v: PxSchema<number[][], false, boolean>;
+        i: PxSchema<number[][] | undefined, true, boolean>;
+        o: PxSchema<number[][] | undefined, true, boolean>;
+        c: PxSchema<boolean | undefined, true, false>;
     };
+    readonly defaults: {};
 };
 /** Represents a vector path for SVG shape animations. @public */
 type PxBezierPath = PxInfer<typeof PxBezierPathSchema>;
@@ -11159,4 +11316,4 @@ declare function diagnoseDocument(doc: unknown): PxDocumentDiagnosis;
  */
 declare function reportDocumentDiagnostics(doc: unknown, where: string): void;
 
-export { PxLoopRepeatAt as $, type PxDefinitions as A, PxDefinitionsSchema as B, type PxDiagnostic as C, PxDiagnosticCode as D, PxDiagnosticKind as E, type PxDiagnostics as F, type PxDiagnosticsConfig as G, type PxEffects as H, PxEffectsSchema as I, type PxElementAnimation as J, PxElementAnimationSchema as K, PxFillGradientEffectSchema as L, PxFillMode as M, PxFinishAction as N, type PxGlyph as O, type PxAnimatedSvgDocument as P, type PxGlyphFont as Q, PxGradientSpreadMethod as R, PxGradientStopSchema as S, PxGradientType as T, type PxInfer as U, type PxKeyframe as V, PxKeyframeSchema as W, PxKeyframeValueSchema as X, PxLengthAdjust as Y, type PxLoop as Z, PxLoopDirection as _, type PxEngineCallbacks as a, flattenAnimatorTimeline as a$, PxLoopSchema as a0, PxMaskType as a1, PxMaskedByEffectSchema as a2, PxMouseOutAction as a3, PxNodeBaseSchema as a4, PxNodeSchema as a5, PxOffScreenAction as a6, PxPathOverflow as a7, PxPinAlign as a8, type PxPlaybackApi as a9, PxTimelineEngine as aA, PxTimelineEngineSetting as aB, PxTimelineSchema as aC, PxTransformByEffectSchema as aD, type PxTransformParts as aE, PxTransformPartsSchema as aF, type PxTransformValue as aG, PxTransformValueSchema as aH, type PxTrigger as aI, PxTriggerSchema as aJ, PxUnits as aK, type PxValidationContext as aL, type PxVec2 as aM, type PxWireConversionOptions as aN, type PxWireConversionResult as aO, PxWireStepKind as aP, type PxWireVersion as aQ, PxWireVersionRelation as aR, type PxWireVersionStep as aS, applyWireSteps as aT, calcAnimationValues as aU, compareWireVersion as aV, controlModeTakesOverTrigger as aW, convertWireDocument as aX, describeSchema as aY, diagnoseDocument as aZ, downgradeWireDocument as a_, PxPlaybackDirection as aa, type PxPropertyAnimation as ab, PxPropertyAnimationSchema as ac, type PxRemoveIndex as ad, PxRepeaterEffectSchema as ae, PxRetimeEffectSchema as af, type PxSchema as ag, type PxSchemaDesc as ah, type PxScroll as ai, PxScrollAxis as aj, PxScrollKind as ak, PxScrollPhase as al, type PxScrollRangePoint as am, PxScrollRangePointSchema as an, PxScrollRangeSchema as ao, PxScrollSchema as ap, PxScrollSource as aq, PxStrokeTrimEffectSchema as ar, PxStrokeTrimSubPaths as as, type PxSvgNode as at, PxSvgNodeRootSchema as au, PxTextEffectSchema as av, PxTextPathEffectSchema as aw, PxTextPathMethod as ax, PxTextPathSpacing as ay, type PxTimeline as az, type PxAnimatorApi as b, formatWireVersion as b0, generateNewIds as b1, getAnimatorConfig as b2, getBindings as b3, getChildren as b4, getDefinitions as b5, isNativeForced as b6, isPxDocument as b7, isValidPxDocument as b8, materializeAllInTree as b9, createDiagnostics as bA, deepClone as bB, generateUniqueId as bC, interpolateValue as bD, keyframeEasing as bE, keyframeValue as bF, materializeMotionPathInPropAnim as bG, prepareDocumentForRender as bH, reportDocumentDiagnostics as bI, sanitizeAttributeValue as bJ, mayUseNativeScrollTimeline as ba, nestAnimatorTimeline as bb, normalizeBindings as bc, parseWireVersion as bd, px as be, readWireVersion as bf, resolveControlMode as bg, resolveTimelineEngine as bh, resolveTrigger as bi, schemaKeys as bj, toDomProps as bk, validateDocument as bl, validateNodeEffects as bm, wireVersionAdvice as bn, type PxAnimatable as bo, PX_ANIM_ATTR_NAME as bp, PX_ANIM_SRC_ATTR_NAME as bq, PX_CSS_ONLY_STYLE_PROPS as br, PX_DISALLOWED_SVG_TAGS_LOWER as bs, PX_LOOP_JUMP_SHIFT_MS as bt, PX_TEXT_CONTENT_ATTR as bu, PX_UNKNOWN_KEY_ERROR as bv, type PxAnyKeyframe as bw, type PxMaterializeAllOptions as bx, type PxNormalizedKeyframe as by, type PxNormalizedPropertyAnimation as bz, type PxAnimatorConfig as c, PxTriggerStart as d, type PxNode as e, PX_TRANSFORM_PART_KEYS as f, PX_TRIGGER_DEFAULTS as g, PX_WIRE_BASELINE_VERSION as h, PX_WIRE_STEPS as i, PX_WIRE_VERSION as j, PX_WIRE_VERSION_KEY as k, PxAlongPathMode as l, PxAnimatedSvgDocumentSchema as m, type PxAnimationDefinition as n, type PxAnimatorCallbacks as o, PxAnimatorConfigSchema as p, type PxAnimatorHandle as q, PxAttrValueSchema as r, type PxBezierPath as s, PxBezierPathSchema as t, type PxBinding as u, PxClipPathEffectSchema as v, PxCloneEffectSchema as w, PxCloneWithout as x, PxControlMode as y, type PxControlProps as z };
+export { PxLoopRepeatAt as $, type PxDefinitions as A, PxDefinitionsSchema as B, type PxDiagnostic as C, PxDiagnosticCode as D, PxDiagnosticKind as E, type PxDiagnostics as F, type PxDiagnosticsConfig as G, type PxEffects as H, PxEffectsSchema as I, type PxElementAnimation as J, PxElementAnimationSchema as K, PxFillGradientEffectSchema as L, PxFillMode as M, PxFinishAction as N, type PxGlyph as O, type PxAnimatedSvgDocument as P, type PxGlyphFont as Q, PxGradientSpreadMethod as R, PxGradientStopSchema as S, PxGradientType as T, type PxInfer as U, type PxKeyframe as V, PxKeyframeSchema as W, PxKeyframeValueSchema as X, PxLengthAdjust as Y, type PxLoop as Z, PxLoopDirection as _, type PxEngineCallbacks as a, downgradeWireDocument as a$, PxLoopSchema as a0, PxMaskType as a1, PxMaskedByEffectSchema as a2, PxMouseOutAction as a3, PxNodeBaseSchema as a4, PxNodeSchema as a5, PxOffScreenAction as a6, PxPathOverflow as a7, PxPinAlign as a8, type PxPlaybackApi as a9, type PxTimeline as aA, PxTimelineEngine as aB, PxTimelineEngineSetting as aC, PxTimelineSchema as aD, PxTransformByEffectSchema as aE, type PxTransformParts as aF, PxTransformPartsSchema as aG, type PxTransformValue as aH, PxTransformValueSchema as aI, type PxTrigger as aJ, PxTriggerSchema as aK, PxUnits as aL, type PxValidationContext as aM, type PxVec2 as aN, type PxWireConversionOptions as aO, type PxWireConversionResult as aP, PxWireStepKind as aQ, type PxWireVersion as aR, PxWireVersionRelation as aS, type PxWireVersionStep as aT, applyWireSteps as aU, calcAnimationValues as aV, compareWireVersion as aW, controlModeTakesOverTrigger as aX, convertWireDocument as aY, describeSchema as aZ, diagnoseDocument as a_, PxPlaybackDirection as aa, type PxPropertyAnimation as ab, PxPropertyAnimationSchema as ac, type PxRemoveIndex as ad, PxRepeaterEffectSchema as ae, PxRetimeEffectSchema as af, type PxSchema as ag, type PxSchemaDesc as ah, type PxScroll as ai, PxScrollAxis as aj, PxScrollKind as ak, PxScrollPhase as al, type PxScrollRangePoint as am, PxScrollRangePointSchema as an, PxScrollRangeSchema as ao, PxScrollSchema as ap, PxScrollSource as aq, PxStrokeTrimEffectSchema as ar, PxStrokeTrimSubPaths as as, type PxSvgNode as at, PxSvgNodeRootSchema as au, PxTextEffectSchema as av, PxTextPathEffectSchema as aw, PxTextPathMethod as ax, PxTextPathSpacing as ay, PxTimeTimelineSchema as az, type PxAnimatorApi as b, flattenAnimatorTimeline as b0, formatWireVersion as b1, generateNewIds as b2, getAnimatorConfig as b3, getBindings as b4, getChildren as b5, getDefinitions as b6, isNativeForced as b7, isPxDocument as b8, isValidPxDocument as b9, type PxMaterializeAllOptions as bA, type PxNormalizedKeyframe as bB, type PxNormalizedPropertyAnimation as bC, createDiagnostics as bD, deepClone as bE, generateUniqueId as bF, interpolateValue as bG, keyframeEasing as bH, keyframeValue as bI, materializeMotionPathInPropAnim as bJ, prepareDocumentForRender as bK, reportDocumentDiagnostics as bL, sanitizeAttributeValue as bM, materializeAllInTree as ba, mayUseNativeScrollTimeline as bb, nestAnimatorTimeline as bc, normalizeBindings as bd, parseWireVersion as be, px as bf, readWireVersion as bg, resolveControlMode as bh, resolveTimelineEngine as bi, resolveTrigger as bj, schemaKeys as bk, toDomProps as bl, validateDocument as bm, validateNodeEffects as bn, wireVersionAdvice as bo, type PxAnimatable as bp, PX_ANIM_ATTR_NAME as bq, PX_ANIM_SRC_ATTR_NAME as br, PX_CSS_ONLY_STYLE_PROPS as bs, PX_DEFAULT_DURATION_MS as bt, PX_DEFAULT_ITERATIONS as bu, PX_DISALLOWED_SVG_TAGS_LOWER as bv, PX_LOOP_JUMP_SHIFT_MS as bw, PX_TEXT_CONTENT_ATTR as bx, PX_UNKNOWN_KEY_ERROR as by, type PxAnyKeyframe as bz, type PxAnimatorConfig as c, PxTriggerStart as d, type PxNode as e, PX_TRANSFORM_PART_KEYS as f, PX_TRIGGER_DEFAULTS as g, PX_WIRE_BASELINE_VERSION as h, PX_WIRE_STEPS as i, PX_WIRE_VERSION as j, PX_WIRE_VERSION_KEY as k, PxAlongPathMode as l, PxAnimatedSvgDocumentSchema as m, type PxAnimationDefinition as n, type PxAnimatorCallbacks as o, PxAnimatorConfigSchema as p, type PxAnimatorHandle as q, PxAttrValueSchema as r, type PxBezierPath as s, PxBezierPathSchema as t, type PxBinding as u, PxClipPathEffectSchema as v, PxCloneEffectSchema as w, PxCloneWithout as x, PxControlMode as y, type PxControlProps as z };