@pixodesk/svg-animator-core 1.0.29 → 1.0.30

package/README.md

@@ -56,7 +56,7 @@ runtime crash on a non-browser platform.
 | **Text** | `materialiseGlyphText`, `layoutGlyphTextChars`, `extendedPathForBrowser` |
 | **Node helpers** | `getNormalizedProps`, `sanitiseAttributeValue`, `resolveStyle`, `generateNewIds` |
 | **Playback engine** | `createBasicFrameLoopAnimator` + the `PxPlatformAdapter` interface |
-| **Wire enums** | `PxAnimatorMode`, `PxAnimatorEngine`, `PxLoopExtend`, `PxTrimSubPaths`, `PxMaskType`, `PxCloneType`, `PxUnits`, `PxGradientType`, `PxGradientUnits`, `PxGradientSpreadMethod`, `PxPathOverflow`, `PxLengthAdjust`, `PxTextPathMethod`, `PxTextPathSpacing` — every two-or-more-way wire selector is a named enum, not a bare string |
+| **Wire enums** | `PxAnimatorMode`, `PxAnimatorEngine`, `PxLoopExtend`, `PxStrokeTrimSubPaths`, `PxMaskType`, `PxCloneType`, `PxUnits`, `PxGradientType`, `PxGradientUnits`, `PxGradientSpreadMethod`, `PxPathOverflow`, `PxLengthAdjust`, `PxTextPathMethod`, `PxTextPathSpacing` — every two-or-more-way wire selector is a named enum, not a bare string |
 
 ### Validating a document
 
@@ -69,7 +69,7 @@ import { PxAnimatedSvgDocumentSchema, type PxValidationContext } from '@pixodesk
 
 const ctx: PxValidationContext = { errors: [], warnings: [], strict: true };
 const ok = PxAnimatedSvgDocumentSchema.isValid(doc, ctx, []);
-if (!ok) console.error(ctx.errors);   // ["children[0].effects.trimPath.range: …", …]
+if (!ok) console.error(ctx.errors);   // ["children[0].effects.strokeTrim.range: …", …]
 ```
 
 **Two modes, two different questions:**
@@ -90,7 +90,7 @@ in-memory object that produced it.
 `materialiseAllInTree(doc, engine)` is the single entry point that turns a
 lightweight editor document into a flat tree any renderer can walk:
 
-1. **Effects** — `node.effects` (transformBy, repeater, maskedBy, trimPath,
+1. **Effects** — `node.effects` (transformBy, repeater, maskedBy, strokeTrim,
    clone/retime, gradients, textPath) become real nodes, wrappers and defs.
 2. **Loops** — each property's `loop` is expanded into explicit keyframes.
 3. **Motion paths** — tangented `transform` keyframes plus `autoOrient` are

package/dist/index.cjs

@@ -93,6 +93,8 @@ __export(index_exports, {
   PxScrollRangeSchema: () => PxScrollRangeSchema,
   PxScrollSchema: () => PxScrollSchema,
   PxStrokeGradientEffectSchema: () => PxStrokeGradientEffectSchema,
+  PxStrokeTrimEffectSchema: () => PxStrokeTrimEffectSchema,
+  PxStrokeTrimSubPaths: () => PxStrokeTrimSubPaths,
   PxSvgNodeExtra: () => PxSvgNodeExtra,
   PxTextEffectSchema: () => PxTextEffectSchema,
   PxTextPathEffectSchema: () => PxTextPathEffectSchema,
@@ -100,8 +102,6 @@ __export(index_exports, {
   PxTransformPartsSchema: () => PxTransformPartsSchema,
   PxTransformValueSchema: () => PxTransformValueSchema,
   PxTriggerSchema: () => PxTriggerSchema,
-  PxTrimPathEffectSchema: () => PxTrimPathEffectSchema,
-  PxTrimSubPaths: () => PxTrimSubPaths,
   STYLE_ATTR_NAMES: () => STYLE_ATTR_NAMES,
   TEXT_ATTR: () => TEXT_ATTR,
   TEXT_CONTENT_ATTR: () => TEXT_CONTENT_ATTR,
@@ -1162,7 +1162,7 @@ var PxTextPathSpacing = {
   auto: "auto",
   exact: "exact"
 };
-var PxTrimSubPaths = {
+var PxStrokeTrimSubPaths = {
   separate: "separate",
   combined: "combined"
 };
@@ -1406,10 +1406,10 @@ var PxClipPathEffectSchema = implementsInterface()(px.object({
   d: PxAnimatableStringSchema.optional(),
   animate: PxPropertyAnimationSchema.optional()
 }));
-var PxTrimPathEffectSchema = implementsInterface()(px.object({
+var PxStrokeTrimEffectSchema = implementsInterface()(px.object({
   offset: PxAnimatableNumberSchema.optional(),
   range: PxAnimatableVec2Schema.optional(),
-  subPaths: px.enum([PxTrimSubPaths.separate, PxTrimSubPaths.combined]).optional()
+  subPaths: px.enum([PxStrokeTrimSubPaths.separate, PxStrokeTrimSubPaths.combined]).optional()
 }));
 var PxRetimeEffectSchema = implementsInterface()(px.object({
   sourceId: px.string().optional(),
@@ -1463,7 +1463,7 @@ var PxEffectsSchema = implementsInterface()(px.object({
   repeater: PxRepeaterEffectSchema.optional(),
   maskedBy: PxMaskedByEffectSchema.optional(),
   clipPath: PxClipPathEffectSchema.optional(),
-  trimPath: PxTrimPathEffectSchema.optional(),
+  strokeTrim: PxStrokeTrimEffectSchema.optional(),
   clone: PxCloneEffectSchema.optional(),
   fillGradient: PxFillGradientEffectSchema.optional(),
   strokeGradient: PxStrokeGradientEffectSchema.optional(),
@@ -5135,10 +5135,10 @@ function applyTextGlyphsAlongPath(node, ctx, pathD, startOffset, textLength, pat
   return materialiseGlyphTextAlongPath(node, pathD, startOffset, { glyphs: ctx.glyphs, warnings: ctx.warnings }, textLength, pathOverflow);
 }
 
-// src/effects/trimPathEffect.ts
-function applyTrimPathEffect(node, trimPath, ctx) {
-  if (!trimPath) return node;
-  const combined = trimPath.subPaths === PxTrimSubPaths.combined;
+// src/effects/strokeTrimEffect.ts
+function applyStrokeTrimEffect(node, strokeTrim, ctx) {
+  if (!strokeTrim) return node;
+  const combined = strokeTrim.subPaths === PxStrokeTrimSubPaths.combined;
   const leafEntries = [];
   const measure = (n) => {
     if (Array.isArray(n.children) && n.children.length > 0) {
@@ -5169,9 +5169,9 @@ function applyTrimPathEffect(node, trimPath, ctx) {
   }
   const chainLengthPx = acc;
   if (combined && chainLengthPx < 1e-3) return node;
-  const offsetReadRaw = readAnimatable(trimPath.offset);
+  const offsetReadRaw = readAnimatable(strokeTrim.offset);
   const offsetRead = offsetReadRaw.kind === "absent" /* Absent */ ? { kind: "static" /* Static */, value: 0 } : offsetReadRaw;
-  const rangeReadRaw = readRangeWithCrossings(trimPath.range);
+  const rangeReadRaw = readRangeWithCrossings(strokeTrim.range);
   const rangeRead = rangeReadRaw.kind === "absent" /* Absent */ ? { kind: "static" /* Static */, value: [0, 1] } : rangeReadRaw;
   const offsetValues = readScalarValues(offsetRead);
   const minOffset = offsetValues.length ? Math.min(...offsetValues) : 0;
@@ -5503,7 +5503,7 @@ function applyPlayerEffects_exceptRetime(node, ctx) {
   const originalId = typeof node.id === "string" ? node.id : void 0;
   const innerIdForContentRef = originalId ? ctx.contentRefInnerIds.get(originalId) : void 0;
   if (!fx && !innerIdForContentRef) return node;
-  const { transformBy, repeater, maskedBy, clipPath, trimPath, clone: cloneFx, fillGradient, strokeGradient, textPath, text } = fx != null ? fx : {};
+  const { transformBy, repeater, maskedBy, clipPath, strokeTrim, clone: cloneFx, fillGradient, strokeGradient, textPath, text } = fx != null ? fx : {};
   if (fx) delete node.effects;
   let n = node;
   let consumedByGlyphs = false;
@@ -5523,7 +5523,7 @@ function applyPlayerEffects_exceptRetime(node, ctx) {
   if (!consumedByGlyphs) n = applyTextPathEffect(n, textPath, ctx);
   n = applyFillGradientEffect(n, fillGradient, ctx);
   n = applyStrokeGradientEffect(n, strokeGradient, ctx);
-  n = applyTrimPathEffect(n, trimPath, ctx);
+  n = applyStrokeTrimEffect(n, strokeTrim, ctx);
   n = applyRepeaterEffect(n, repeater, ctx);
   n = applyMaskedByEffect(n, maskedBy, transformBy, ctx);
   n = applyClipPathEffect(n, clipPath, ctx);
@@ -6247,6 +6247,8 @@ function subtractMultiset(a, b) {
   PxScrollRangeSchema,
   PxScrollSchema,
   PxStrokeGradientEffectSchema,
+  PxStrokeTrimEffectSchema,
+  PxStrokeTrimSubPaths,
   PxSvgNodeExtra,
   PxTextEffectSchema,
   PxTextPathEffectSchema,
@@ -6254,8 +6256,6 @@ function subtractMultiset(a, b) {
   PxTransformPartsSchema,
   PxTransformValueSchema,
   PxTriggerSchema,
-  PxTrimPathEffectSchema,
-  PxTrimSubPaths,
   STYLE_ATTR_NAMES,
   TEXT_ATTR,
   TEXT_CONTENT_ATTR,