@pixodesk/svg-animator-web 1.0.44 → 1.0.46

package/dist/internal.cjs

@@ -29,7 +29,7 @@ module.exports = __toCommonJS(internal_exports);
 // src/shared/PxAnimatorKeys.ts
 var PX_ANIMATOR_DOC_KEY = "doc";
 
-// ../svg-animator-core/dist/chunk-EFQLDGFY.js
+// ../svg-animator-core/dist/chunk-37OFJ3RX.js
 var __defProp2 = Object.defineProperty;
 var __defProps = Object.defineProperties;
 var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
@@ -60,19 +60,31 @@ function pathStr(path) {
   return result;
 }
 var Base = class {
+  /** Structural schemas (objects, arrays, unions of objects…) pass `false`: they state no scalar default. */
+  constructor(_statesDefault) {
+    this._statesDefault = _statesDefault;
+  }
   _canSanitize(raw) {
     return this.isValid(raw);
   }
+  /** A REQUIRED field is never absent; its default is the repair value. */
+  absentDefault() {
+    return this._default;
+  }
   optional() {
     return new Optional(this);
   }
 };
 var Optional = class extends Base {
   constructor(inner) {
-    super();
+    super(inner._statesDefault);
     this.inner = inner;
     this._default = void 0;
   }
+  /** Absent means the inner schema's STATED default — or nothing at all when it states none. */
+  absentDefault() {
+    return this.inner._statesDefault ? this.inner._default : void 0;
+  }
   sanitize(raw) {
     if (raw === void 0 || raw === null) return void 0;
     return this.inner._canSanitize(raw) ? this.inner.sanitize(raw) : void 0;
@@ -86,8 +98,8 @@ var Optional = class extends Base {
   }
 };
 var Str = class extends Base {
-  constructor(_default = "") {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -100,8 +112,8 @@ var Str = class extends Base {
   }
 };
 var Num = class extends Base {
-  constructor(_default = 0) {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -114,8 +126,8 @@ var Num = class extends Base {
   }
 };
 var Bool = class extends Base {
-  constructor(_default = false) {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -128,8 +140,9 @@ var Bool = class extends Base {
   }
 };
 var Literal = class extends Base {
+  /** A literal IS its own value: absent means it. */
   constructor(value) {
-    super();
+    super(true);
     this.value = value;
     this._default = value;
   }
@@ -143,8 +156,8 @@ var Literal = class extends Base {
   }
 };
 var Enum = class extends Base {
-  constructor(values, defaultVal) {
-    super();
+  constructor(values, defaultVal, statesDefault) {
+    super(statesDefault);
     this.values = values;
     this._default = defaultVal != null ? defaultVal : values[0];
   }
@@ -159,8 +172,8 @@ var Enum = class extends Base {
 };
 var UNION_MEMBER_ERROR_LIMIT = 4;
 var Union = class extends Base {
-  constructor(schemas, defaultVal) {
-    super();
+  constructor(schemas, defaultVal, statesDefault) {
+    super(statesDefault);
     this.schemas = schemas;
     this._kind = "union";
     this._default = defaultVal != null ? defaultVal : schemas[0]._default;
@@ -213,7 +226,7 @@ var Union = class extends Base {
 var DiscriminatedUnion = class extends Base {
   constructor(_key, _schemas, defaultVal) {
     var _a2;
-    super();
+    super(false);
     this._key = _key;
     this._schemas = _schemas;
     this._kind = "discriminatedUnion";
@@ -252,13 +265,19 @@ var DiscriminatedUnion = class extends Base {
     return schema ? schema._canSanitize(raw) : this._schemas[0]._canSanitize(raw);
   }
 };
+function statedDefaults(shape) {
+  const out = {};
+  for (const key of Object.keys(shape)) if (shape[key]._statesDefault) out[key] = shape[key].absentDefault();
+  return Object.freeze(out);
+}
 var Obj = class extends Base {
   constructor(_shape) {
-    super();
+    super(false);
     this._shape = _shape;
     const d = {};
     for (const key of Object.keys(_shape)) d[key] = _shape[key]._default;
     this._default = d;
+    this.defaults = statedDefaults(_shape);
   }
   sanitize(raw) {
     const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
@@ -300,12 +319,13 @@ var Obj = class extends Base {
 };
 var OpenObj = class extends Base {
   constructor(_shape, _openSchema) {
-    super();
+    super(false);
     this._shape = _shape;
     this._openSchema = _openSchema;
     const d = {};
     for (const key of Object.keys(_shape)) d[key] = _shape[key]._default;
     this._default = d;
+    this.defaults = statedDefaults(_shape);
   }
   sanitize(raw) {
     const src = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
@@ -350,7 +370,7 @@ var OpenObj = class extends Base {
 };
 var Arr = class extends Base {
   constructor(item) {
-    super();
+    super(false);
     this.item = item;
     this._default = [];
   }
@@ -382,7 +402,7 @@ var Arr = class extends Base {
 };
 var Rec = class extends Base {
   constructor(value) {
-    super();
+    super(false);
     this.value = value;
     this._kind = "record";
     this._default = {};
@@ -415,7 +435,7 @@ var Rec = class extends Base {
 };
 var Any = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -430,7 +450,7 @@ var Any = class extends Base {
 };
 var Defined = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -447,7 +467,7 @@ var Defined = class extends Base {
 };
 var Lazy = class extends Base {
   constructor(fn, _default) {
-    super();
+    super(false);
     this.fn = fn;
     this._default = _default;
     this.resolved = null;
@@ -468,7 +488,7 @@ var Lazy = class extends Base {
 };
 var Tuple = class extends Base {
   constructor(schemas) {
-    super();
+    super(false);
     this.schemas = schemas;
     this._kind = "tuple";
     this._default = schemas.map((s) => s._default);
@@ -499,22 +519,29 @@ var Tuple = class extends Base {
 function implementsInterface() {
   return (schema) => schema;
 }
+function string(defaultVal) {
+  return defaultVal === void 0 ? new Str("", false) : new Str(defaultVal, true);
+}
+function number(defaultVal) {
+  return defaultVal === void 0 ? new Num(0, false) : new Num(defaultVal, true);
+}
+function boolean(defaultVal) {
+  return defaultVal === void 0 ? new Bool(false, false) : new Bool(defaultVal, true);
+}
+function oneOf(values, defaultVal) {
+  return defaultVal === void 0 ? new Enum(values, void 0, false) : new Enum(values, defaultVal, true);
+}
+function unionOf(schemas, defaultVal) {
+  return defaultVal === void 0 ? new Union(schemas, void 0, false) : new Union(schemas, defaultVal, true);
+}
 var px = {
-  /** Matches a string. Default: '' or provided value. */
-  string: (defaultVal = "") => new Str(defaultVal),
-  /** Matches a finite number. Default: 0 or provided value. */
-  number: (defaultVal = 0) => new Num(defaultVal),
-  /** Matches a boolean. Default: false or provided value. */
-  boolean: (defaultVal = false) => new Bool(defaultVal),
-  /** Matches one exact primitive value; its default is the value itself. */
+  string,
+  number,
+  boolean,
+  /** Matches one exact primitive value; absent means the value itself. */
   literal: (value) => new Literal(value),
-  /** Matches one of a fixed set of string/number values. Default: first value. */
-  enum: (values, defaultVal) => new Enum(values, defaultVal),
-  /**
-   * Returns the first schema whose isValid passes.
-   * TypeScript infers the union of all member types automatically.
-   */
-  union: (schemas, defaultVal) => new Union(schemas, defaultVal),
+  enum: oneOf,
+  union: unionOf,
   /**
    * Discriminated union — reads `raw[key]`, finds the member schema whose
    * literal at `key` matches, then delegates sanitize/isValid to that member.
@@ -522,7 +549,8 @@ var px = {
    * TypeScript infers the union of all member types automatically.
    */
   discriminatedUnion: (key, schemas) => new DiscriminatedUnion(key, schemas),
-  /** Typed object — unknown keys are stripped. Required fields fall back to their default. */
+  /** 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. */
   object: (shape) => new Obj(shape),
   /**
    * Open object — validates known keys; passes unknown keys through as-is,
@@ -646,8 +674,11 @@ var PX_TRIGGER_DEFAULTS = {
   offScreen: "pause",
   mouseOut: "continue",
   visibilityThreshold: 0.5,
-  visibilityDebounce: 150
+  visibilityDebounce: 150,
+  finish: "hold"
 };
+var PX_DEFAULT_DURATION_MS = 1e3;
+var PX_DEFAULT_ITERATIONS = 1;
 var PxLoopRepeatAt = {
   /** Segment from the START; the repetition runs BEFORE the first keyframe
    *  (intro loops that play until the main timeline begins). */
@@ -747,15 +778,15 @@ var PxKeyframeSchema = implementsInterface()(px.object({
 }));
 var PxLoopSchema = implementsInterface()(px.object({
   segmentCount: px.number().optional(),
-  repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end]).optional(),
-  direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate]).optional()
+  repeatAt: px.enum([PxLoopRepeatAt.start, PxLoopRepeatAt.end], PxLoopRepeatAt.end).optional(),
+  direction: px.enum([PxLoopDirection.normal, PxLoopDirection.alternate], PxLoopDirection.normal).optional()
 }));
 var PxPropertyAnimationSchema = implementsInterface()(px.object({
   value: PxKeyframeValueSchema.optional(),
   keyframes: px.array(PxKeyframeSchema).optional(),
   loop: px.union([PxLoopSchema, px.boolean()]).optional(),
   autoOrient: px.boolean().optional(),
-  alongPathMode: px.enum([PxAlongPathMode.sampled, PxAlongPathMode.offsetPath]).optional()
+  alongPathMode: px.enum([PxAlongPathMode.sampled, PxAlongPathMode.offsetPath], PxAlongPathMode.sampled).optional()
 }));
 var PxTransformPartsSchema = implementsInterface()(px.object({
   translate: px.tuple([px.number(), px.number()]).optional(),
@@ -785,9 +816,9 @@ var PxTriggerSchema = implementsInterface()(px.object({
   // What happens after a NATURAL finish — `'hold'` (default: keep the end state per
   // `fill`) or `'reset'` (snap back to the start state). One of four occasion keys
   // (`start`, `offScreen`, `mouseOut`, `finish`), all named the same way.
-  finish: px.enum([PxFinishAction.hold, PxFinishAction.reset]).optional(),
-  visibilityThreshold: px.number().optional(),
-  visibilityDebounce: px.number().optional()
+  finish: px.enum([PxFinishAction.hold, PxFinishAction.reset], PX_TRIGGER_DEFAULTS.finish).optional(),
+  visibilityThreshold: px.number(PX_TRIGGER_DEFAULTS.visibilityThreshold).optional(),
+  visibilityDebounce: px.number(PX_TRIGGER_DEFAULTS.visibilityDebounce).optional()
 }));
 var PxGlyphSchema = implementsInterface()(px.object({
   width: px.number(),
@@ -813,7 +844,7 @@ var PxScrollRangePointSchema = implementsInterface()(px.object({
     PxScrollPhase.exit,
     PxScrollPhase.entryCrossing,
     PxScrollPhase.exitCrossing
-  ]).optional(),
+  ], PxScrollPhase.cover).optional(),
   fraction: px.number().optional()
 }));
 var PxScrollRangeSchema = px.object({
@@ -821,37 +852,37 @@ var PxScrollRangeSchema = px.object({
   end: PxScrollRangePointSchema.optional()
 });
 var PxScrollSchema = implementsInterface()(px.object({
-  kind: px.enum([PxScrollKind.view, PxScrollKind.scroll]).optional(),
-  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
-  source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
+  kind: px.enum([PxScrollKind.view, PxScrollKind.scroll], PxScrollKind.view).optional(),
+  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y], PxScrollAxis.block).optional(),
+  source: px.enum([PxScrollSource.nearest, PxScrollSource.root], PxScrollSource.nearest).optional(),
   // Free-form: the two keywords `parent`/`scroller` plus any CSS selector.
   subject: px.string().optional(),
   smoothing: px.number().optional(),
-  pin: px.boolean().optional(),
-  pinAlign: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+  pin: px.boolean(false).optional(),
+  pinAlign: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom], PxPinAlign.top).optional(),
   pinOffset: px.number().optional(),
   pinDistance: px.number().optional(),
   range: PxScrollRangeSchema.optional()
 }));
 var PxTimelinePinSchema = implementsInterface()(px.object({
-  align: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom]).optional(),
+  align: px.enum([PxPinAlign.top, PxPinAlign.center, PxPinAlign.bottom], PxPinAlign.top).optional(),
   offset: px.number().optional(),
   distance: px.number().optional()
 }));
-var PxTimelineEngineSchema = px.enum([PxTimelineEngineSetting.auto, PxTimelineEngineSetting.native, PxTimelineEngineSetting.js]).optional();
+var PxTimelineEngineSchema = px.enum([PxTimelineEngineSetting.auto, PxTimelineEngineSetting.native, PxTimelineEngineSetting.js], PxTimelineEngineSetting.auto).optional();
 var PxTimeTimelineSchema = implementsInterface()(px.object({
   type: px.literal("time").optional(),
   engine: PxTimelineEngineSchema,
   frameRate: px.number().optional(),
   // §2.8: duration is a property of the TIMELINE — how long one pass takes.
-  duration: px.number().optional(),
+  duration: px.number(PX_DEFAULT_DURATION_MS).optional(),
   trigger: PxTriggerSchema.optional(),
-  delay: px.number().optional(),
-  iterations: px.union([px.number(), px.literal("infinite")]).optional(),
+  delay: px.number(0).optional(),
+  iterations: px.union([px.number(PX_DEFAULT_ITERATIONS), px.literal("infinite")], PX_DEFAULT_ITERATIONS).optional(),
   // `fillMode` on the wire (CSS `animation-fill-mode`; the runtime view calls it `fill`)
   // — never `fill`, which is paint everywhere else in the format.
-  fillMode: px.enum([PxFillMode.forwards, PxFillMode.backwards, PxFillMode.both, PxFillMode.none]).optional(),
-  direction: px.enum([PxPlaybackDirection.normal, PxPlaybackDirection.reverse, PxPlaybackDirection.alternate, PxPlaybackDirection.alternateReverse]).optional()
+  fillMode: px.enum([PxFillMode.forwards, PxFillMode.backwards, PxFillMode.both, PxFillMode.none], PxFillMode.forwards).optional(),
+  direction: px.enum([PxPlaybackDirection.normal, PxPlaybackDirection.reverse, PxPlaybackDirection.alternate, PxPlaybackDirection.alternateReverse], PxPlaybackDirection.normal).optional()
 }));
 var scrollishTimelineShape = {
   // §2.8: duration is a property of the TIMELINE — under scrubbing it is the keyframe
@@ -862,8 +893,8 @@ var scrollishTimelineShape = {
   iterations: px.number().optional(),
   engine: PxTimelineEngineSchema,
   frameRate: px.number().optional(),
-  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y]).optional(),
-  source: px.enum([PxScrollSource.nearest, PxScrollSource.root]).optional(),
+  axis: px.enum([PxScrollAxis.block, PxScrollAxis.inline, PxScrollAxis.x, PxScrollAxis.y], PxScrollAxis.block).optional(),
+  source: px.enum([PxScrollSource.nearest, PxScrollSource.root], PxScrollSource.nearest).optional(),
   subject: px.string().optional(),
   // 'parent' | 'scroller' | any CSS selector
   smoothing: px.number().optional(),
@@ -943,9 +974,10 @@ var PxRepeaterEffectSchema = implementsInterface()(px.object({
 }));
 var PxMaskedByEffectSchema = implementsInterface()(px.object({
   source: px.string().optional(),
-  maskType: px.enum([PxMaskType.luminance, PxMaskType.alpha]).optional(),
-  maskUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
-  maskContentUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
+  // SVG's own initial values — what a <mask> does when the attribute is not there.
+  maskType: px.enum([PxMaskType.luminance, PxMaskType.alpha], PxMaskType.luminance).optional(),
+  maskUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.objectBoundingBox).optional(),
+  maskContentUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.userSpaceOnUse).optional(),
   x: px.number().optional(),
   y: px.number().optional(),
   width: px.number().optional(),
@@ -957,7 +989,7 @@ var PxClipPathEffectSchema = implementsInterface()(px.object({
 var PxStrokeTrimEffectSchema = implementsInterface()(px.object({
   offset: PxAnimatableNumberSchema.optional(),
   range: PxAnimatableVec2Schema.optional(),
-  subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined]).optional()
+  subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined], PxStrokeTrimSubPaths.separate).optional()
 }));
 var PxRetimeEffectSchema = implementsInterface()(px.object({
   start: px.number().optional(),
@@ -989,17 +1021,20 @@ var PxFillGradientEffectSchema = implementsInterface()(px.object({
   radius: PxAnimatableNumberSchema.optional(),
   focal: PxAnimatableVec2Schema.optional(),
   stops: PxAnimatableGradientStopsSchema.optional(),
-  gradientUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox]).optional(),
-  spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat]).optional(),
+  // SVG's own initial values — what a gradient does when the attribute is not there.
+  gradientUnits: px.enum([PxUnits.userSpaceOnUse, PxUnits.objectBoundingBox], PxUnits.objectBoundingBox).optional(),
+  spreadMethod: px.enum([PxGradientSpreadMethod.pad, PxGradientSpreadMethod.reflect, PxGradientSpreadMethod.repeat], PxGradientSpreadMethod.pad).optional(),
   gradientTransform: px.string().optional()
 }));
 var PxStrokeGradientEffectSchema = PxFillGradientEffectSchema;
 var PxTextPathEffectSchema = implementsInterface()(px.object({
   pathData: px.string(),
-  pathOverflow: px.enum([PxPathOverflow.clip, PxPathOverflow.extend]).optional(),
-  lengthAdjust: px.enum([PxLengthAdjust.spacing, PxLengthAdjust.spacingAndGlyphs]).optional(),
-  method: px.enum([PxTextPathMethod.align, PxTextPathMethod.stretch]).optional(),
-  spacing: px.enum([PxTextPathSpacing.auto, PxTextPathSpacing.exact]).optional(),
+  // `extend` is what an omitted pathOverflow means (glyphs continue along the tangent); the
+  // other three are SVG's own initial values for the native <textPath> attributes.
+  pathOverflow: px.enum([PxPathOverflow.clip, PxPathOverflow.extend], PxPathOverflow.extend).optional(),
+  lengthAdjust: px.enum([PxLengthAdjust.spacing, PxLengthAdjust.spacingAndGlyphs], PxLengthAdjust.spacing).optional(),
+  method: px.enum([PxTextPathMethod.align, PxTextPathMethod.stretch], PxTextPathMethod.align).optional(),
+  spacing: px.enum([PxTextPathSpacing.auto, PxTextPathSpacing.exact], PxTextPathSpacing.exact).optional(),
   startOffset: PxAnimatableNumberSchema.optional(),
   textLength: PxAnimatableNumberSchema.optional()
 }));