@pixodesk/svg-animator-core 1.0.45 → 1.0.47

package/dist/index.min.js

@@ -1 +1 @@
-import{PX_DEFAULT_DURATION_MS as n,PX_TIMELINE_SHARED_KEYS as e,PX_TIME_ONLY_TIMELINE_KEYS as t,PX_TRANSFORM_PART_KEYS as i,PX_TRIGGER_DEFAULTS as o,PX_WIRE_BASELINE_VERSION as r,PX_WIRE_SCHEMA_VERSION as l,PX_WIRE_STEPS as a,PX_WIRE_VERSION as s,PX_WIRE_VERSION_KEY as u,PxAlongPathMode as c,PxAnimatedSvgDocumentSchema as f,PxAnimatorConfigSchema as d,PxAttrValueSchema as m,PxBezierPathSchema as v,PxClipPathEffectSchema as g,PxCloneEffectSchema as y,PxCloneWithout as b,PxControlMode as p,PxDefinitionsSchema as h,PxDiagnosticCode as w,PxDiagnosticKind as F,PxEffectsSchema as N,PxElementAnimationSchema as j,PxFillGradientEffectSchema as k,PxFillMode as A,PxFinishAction as T,PxGradientSpreadMethod as C,PxGradientStopSchema as O,PxGradientType as P,PxKeyframeSchema as R,PxKeyframeValueSchema as D,PxLengthAdjust as S,PxLoopDirection as E,PxLoopRepeatAt as M,PxLoopSchema as q,PxMaskType as x,PxMaskedByEffectSchema as J,PxMouseOutAction as z,PxNodeBaseSchema as H,PxNodeSchema as V,PxOffScreenAction as B,PxPathOverflow as G,PxPinAlign as I,PxPlaybackDirection as K,PxPropertyAnimationSchema as L,PxRepeaterEffectSchema as Q,PxRetimeEffectSchema as U,PxScrollAxis as W,PxScrollKind as X,PxScrollPhase as Y,PxScrollRangePointSchema as Z,PxScrollRangeSchema as $,PxScrollSchema as _,PxScrollSource as nn,PxStrokeTrimEffectSchema as en,PxStrokeTrimSubPaths as tn,PxSvgNodeRootSchema as on,PxTextEffectSchema as rn,PxTextPathEffectSchema as ln,PxTextPathMethod as an,PxTextPathSpacing as sn,PxTimelineEngine as un,PxTimelineEngineSetting as cn,PxTimelineSchema as fn,PxTransformByEffectSchema as dn,PxTransformPartsSchema as mn,PxTransformValueSchema as vn,PxTriggerSchema as gn,PxTriggerStart as yn,PxUnits as bn,PxWireStepKind as pn,PxWireVersionRelation as hn,__spreadProps as wn,__spreadValues as Fn,applyWireSteps as Nn,calcAnimationValues as jn,clamp as kn,compareWireVersion as An,controlModeTakesOverTrigger as Tn,convertWireDocument as Cn,describeSchema as On,diagnoseDocument as Pn,downgradeWireDocument as Rn,flattenAnimatorTimeline as Dn,formatWireVersion as Sn,generateNewIds as En,getAnimatorConfig as Mn,getBindings as qn,getChildren as xn,getDefinitions as Jn,isNativeForced as zn,isPxDocument as Hn,isValidPxDocument as Vn,materializeAllInTree as Bn,materializeNodeEffects as Gn,mayUseNativeScrollTimeline as In,nestAnimatorTimeline as Kn,normalizeBindings as Ln,parseWireVersion as Qn,px as Un,readWireVersion as Wn,resolveControlMode as Xn,resolveTimelineEngine as Yn,resolveTrigger as Zn,schemaKeys as $n,toDomProps as _n,validateDocument as ne,validateNodeEffects as ee,wireVersionAdvice as te}from"./chunk-5HEVTP2N.min.js";var ie="setPlaybackRate: rate must be finite and non-zero";function oe(n){return Number.isFinite(n)&&0!==n}function re(n,e){return n>0?e===1/0?1/0:n*(e>0?e:1):0}function le(n,e){return n>0?e===1/0?n:n*(e>0?e:1):0}function ae(n,e){return Number.isNaN(n)||n<0?0:Number.isFinite(e)?n>e?e:n:Number.isFinite(n)?n:0}function se(n,e,t){const i=le(e,t);return i>0&&Number.isFinite(n)?n<=0?0:t===1/0?n%i/i:n>=i?1:n/i:0}function ue(n,e,t){const i=le(e,t);return i>0&&Number.isFinite(n)?n<=0?0:n>=1?i:n*i:0}function ce(n,e=Date.now){let t=0,i=0,o=!1,r=1;const l=()=>ae(o?t+(e()-i)*r:t,n);return{now:l,isRunning:()=>o,start:(a,s)=>{t=ae(null!=s?s:l(),n),r=oe(a)?a:1,i=e(),o=!0},stop:()=>{t=l(),i=0,o=!1},seek:r=>{t=ae(r,n),o&&(i=e())}}}function fe(n){const e=globalThis;"function"!=typeof e.cancelAnimationFrame?e.clearTimeout(n):e.cancelAnimationFrame(n)}function de(e,t,i){var o;const r=Mn(e)||{},l=Ln(e,un.js),a=r.iterations;let s=1;"number"==typeof a&&(s=a||1),"infinite"===a&&(s=1/0),s<1&&(s=1);const u=+(r.duration||n),c=u&&s?u*(s===1/0?1/0:s):u?(null!=s?s:1)*u:0,f=r.direction||"normal",d=null!=(o=r.fill)?o:"forwards",m="forwards"===d||"both"===d,v="backwards"===d||"both"===d;let g=null,y=!1,b=-(r.delay||0),p=0,h=1,w=!1;const F=r.frameRate,N=F&&F>0?1e3/F:0;let j=0;const k=()=>{const n=p?(Date.now()-p)*h:0;return b+n},A=()=>{let n=k();return Number.isFinite(c)&&n>c&&(n=c),n<0&&(n=0),n};function T(n){let e=function(){const e=u>0?u:1;let t=0,i=0;if(u>0){n=kn(n,0,s*e),i=Math.max(0,Math.ceil(n/e)-1),i=Math.min(i,s-1);t=kn((n-i*e)/e,0,1)}else t=n;const o=f||"normal";let r=t;return"reverse"===o?r=1-t:"alternate"===o?i%2==1&&(r=1-t):"alternate-reverse"===o&&i%2==0&&(r=1-t),r}();for(const n of l||[]){const i=n.animate;if(!i||"object"!=typeof i||Array.isArray(i)){console.warn("Empty or unresolved binding",n);continue}const o=jn(i,e*u);for(const[e,i]of Object.entries(o))t.setAttribute(n.id,e,i)}}r.delay&&(r.delay<0?T(A()):v&&T(0));const C=()=>!!y&&(!!t.isConnected()&&(h<0?k()>0:!(Number.isFinite(c)&&A()>=c))),O=n=>{null!==g&&(fe(g),g=null),(n||C())&&(g=function(n){const e=globalThis;return"function"==typeof e.requestAnimationFrame?e.requestAnimationFrame(n):e.setTimeout(n,16)}(()=>{g=null,(()=>{var n,e;if(!t.isConnected())return void P();const o=A(),r=k();if(r<0&&h>0)v&&T(0);else{if(h<0&&r<=0)return P(),T(0),void(w||(w=!0,null==(n=null==i?void 0:i.onFinish)||n.call(i)));if(h>0&&c&&Number.isFinite(c)&&o>=c)return P(),T(m?c:0),void(w||(w=!0,null==(e=null==i?void 0:i.onFinish)||e.call(i)));if(N>0){const n=Date.now();if(j&&n-j<N)return;j=n}T(o)}})(),O()}))},P=()=>{if(!y)return;let n=k();Number.isFinite(c)&&n>c&&(n=c),b=n,p=0,y=!1,null!==g&&(fe(g),g=null),n>=0?T(n):v&&T(0)},R={isReady:()=>!0,getRootElement:()=>null,isPlaying:()=>C(),play:()=>{var n;(()=>{if(!y){if(h>=0)Number.isFinite(c)&&b>=c&&(b=0);else if(b<=0){if(!Number.isFinite(c))return void console.warn("play: cannot start reverse playback of an infinite animation from time 0");b=c}w=!1,y=!0,p=Date.now(),O(!0)}})(),null==(n=null==i?void 0:i.onPlay)||n.call(i)},pause:()=>{var n;P(),null==(n=null==i?void 0:i.onPause)||n.call(i)},cancel:()=>{var n;P(),b=0,p=0,y=!1,w=!1,T(b),null==(n=null==i?void 0:i.onCancel)||n.call(i)},finish:()=>{((n=!0)=>{var e;b=Number.isFinite(c)?c:A(),p=0,y=!1,null!==g&&(fe(g),g=null),T(m?b:0),n&&!w&&(w=!0,null==(e=null==i?void 0:i.onFinish)||e.call(i))})(!0)},setPlaybackRate:n=>{if(!oe(n))return void console.warn(ie);let e=k();Number.isFinite(c)&&e>c&&(e=c),n<0!=h<0&&(w=!1),h=n,b=e,y&&(p=Date.now())},getCurrentTime:()=>A(),setCurrentTime:n=>{n=ae(n,c),b=n,y&&(p=Date.now()),(!Number.isFinite(c)||n<c)&&(w=!1),T(A())},getCurrentProgress:()=>se(A(),u,s),setCurrentProgress:n=>{R.setCurrentTime(ue(n,u,s))},destroy:()=>{var n;R.cancel(),null==(n=null==i?void 0:i.onRemove)||n.call(i)}};return R}var me=["timelineSource","scroll","trigger","delay","iterations","direction","fill","resetOnFinish","duration","mode","frameRate"],ve=["definitions","bindings"],ge=n=>!!n&&"object"==typeof n&&!Array.isArray(n);function ye(n,e){const t=ge(n)?Fn({},n):{};for(const n of Object.keys(e)){const i=e[n];null!==i?ge(i)?t[n]=ye(t[n],i):t[n]=i:delete t[n]}return t}function be(n,i,o){const r=ge(l=n)&&"string"==typeof l.type?l.type:"time";var l;const a=ge(i)&&"string"==typeof i.type?String(i.type):r;let s;if(a!==r){const t={};if(ge(n))for(const i of e)void 0!==n[i]&&(t[i]=n[i]);s=ye(t,i)}else s=ye(n,i);if("scroll"===(u=a)||"view"===u){for(const n of t)void 0!==s[n]&&(o("animator.timeline."+n+": no slot on a '"+a+"' timeline — dropped"),delete s[n]);"infinite"===s.iterations&&(o("animator.timeline.iterations: 'infinite' cannot map onto a scroll range — dropped"),delete s.iterations)}var u;return s}function pe(n,e){let t;if("string"==typeof n)try{t=JSON.parse(n)}catch(n){console.warn("timeline override: not valid JSON — ignored",n),t=void 0}else t=null!=n?n:void 0;const{duration:i,delay:o,iterations:r,start:l}=e;if(void 0===i&&void 0===o&&void 0===r&&void 0===l)return void 0===t?void 0:{timeline:t};const a=ge(t)?Fn({},t):{};return void 0!==i&&(a.duration=i),void 0!==o&&(a.delay=o),void 0!==r&&(a.iterations=r),void 0!==l&&(a.trigger=wn(Fn({},a.trigger),{start:l})),{timeline:a}}function he(n,e){const t=[],i=n=>t.push(n);if(null===e)return{config:void 0,warnings:t};if(!ge(e)||0===Object.keys(e).length)return{config:n,warnings:t};const o=ge(n)?me.filter(e=>void 0!==n[e]):[];o.length&&i("animator: the base carries the flat runtime spelling ("+o.join(", ")+"); the patch merges the wire spelling only");const r=ge(n)?Fn({},n):{};for(const n of Object.keys(e)){const t=e[n];null!==t?"timeline"!==n?ge(t)?r[n]=ye(r[n],t):r[n]=t:r.timeline=ge(t)?be(r.timeline,t,i):t:delete r[n]}return{config:r,warnings:t}}function we(n,e,t){var i,o;const r=!!(null==t?void 0:t.resetTimeline);if(!(n&&void 0!==e&&(r||null!==e&&ge(e)&&Object.keys(e).length)))return{doc:n,warnings:[]};const l=n,a=ge(l.animator),s=!a&&ge(null==(i=l.meta)?void 0:i.animator),u=a?l.animator:s?l.meta.animator:void 0,c=[];a&&ge(null==(o=l.meta)?void 0:o.animator)&&c.push("animator: doc.meta.animator is shadowed by doc.animator and was not patched");let f=u;if(r){const n={};for(const e of ve)ge(u)&&void 0!==u[e]&&(n[e]=u[e]);f=n}const d=he(f,null!=e?e:{});return c.push(...d.warnings),d.config===u?{doc:n,warnings:c}:s?{doc:wn(Fn({},l),{meta:wn(Fn({},l.meta),{animator:d.config})}),warnings:c}:{doc:wn(Fn({},l),{animator:d.config}),warnings:c}}export{ie as PX_RATE_REJECTED,i as PX_TRANSFORM_PART_KEYS,o as PX_TRIGGER_DEFAULTS,r as PX_WIRE_BASELINE_VERSION,l as PX_WIRE_SCHEMA_VERSION,a as PX_WIRE_STEPS,s as PX_WIRE_VERSION,u as PX_WIRE_VERSION_KEY,c as PxAlongPathMode,f as PxAnimatedSvgDocumentSchema,d as PxAnimatorConfigSchema,m as PxAttrValueSchema,v as PxBezierPathSchema,g as PxClipPathEffectSchema,y as PxCloneEffectSchema,b as PxCloneWithout,p as PxControlMode,h as PxDefinitionsSchema,w as PxDiagnosticCode,F as PxDiagnosticKind,N as PxEffectsSchema,j as PxElementAnimationSchema,k as PxFillGradientEffectSchema,A as PxFillMode,T as PxFinishAction,C as PxGradientSpreadMethod,O as PxGradientStopSchema,P as PxGradientType,R as PxKeyframeSchema,D as PxKeyframeValueSchema,S as PxLengthAdjust,E as PxLoopDirection,M as PxLoopRepeatAt,q as PxLoopSchema,x as PxMaskType,J as PxMaskedByEffectSchema,z as PxMouseOutAction,H as PxNodeBaseSchema,V as PxNodeSchema,B as PxOffScreenAction,G as PxPathOverflow,I as PxPinAlign,K as PxPlaybackDirection,L as PxPropertyAnimationSchema,Q as PxRepeaterEffectSchema,U as PxRetimeEffectSchema,W as PxScrollAxis,X as PxScrollKind,Y as PxScrollPhase,Z as PxScrollRangePointSchema,$ as PxScrollRangeSchema,_ as PxScrollSchema,nn as PxScrollSource,en as PxStrokeTrimEffectSchema,tn as PxStrokeTrimSubPaths,on as PxSvgNodeRootSchema,rn as PxTextEffectSchema,ln as PxTextPathEffectSchema,an as PxTextPathMethod,sn as PxTextPathSpacing,un as PxTimelineEngine,cn as PxTimelineEngineSetting,fn as PxTimelineSchema,dn as PxTransformByEffectSchema,mn as PxTransformPartsSchema,vn as PxTransformValueSchema,gn as PxTriggerSchema,yn as PxTriggerStart,bn as PxUnits,pn as PxWireStepKind,hn as PxWireVersionRelation,we as applyAnimatorConfig,Nn as applyWireSteps,jn as calcAnimationValues,ae as clampSeekMs,An as compareWireVersion,Tn as controlModeTakesOverTrigger,Cn as convertWireDocument,de as createAdapterAnimator,ce as createRunClock,On as describeSchema,Pn as diagnoseDocument,Rn as downgradeWireDocument,Dn as flattenAnimatorTimeline,pe as foldTimelineOverride,Sn as formatWireVersion,En as generateNewIds,Mn as getAnimatorConfig,qn as getBindings,xn as getChildren,Jn as getDefinitions,zn as isNativeForced,Hn as isPxDocument,oe as isValidPlaybackRate,Vn as isValidPxDocument,Bn as materializeAllInTree,Gn as materializeNodeEffects,In as mayUseNativeScrollTimeline,he as mergeAnimatorConfig,Kn as nestAnimatorTimeline,Ln as normalizeBindings,Qn as parseWireVersion,le as progressSpanMs,ue as progressToTimeMs,Un as px,Wn as readWireVersion,Xn as resolveControlMode,Yn as resolveTimelineEngine,Zn as resolveTrigger,$n as schemaKeys,re as seekCeilingMs,se as timeToProgress,_n as toDomProps,ne as validateDocument,ee as validateNodeEffects,te as wireVersionAdvice};
+import{PX_DEFAULT_DURATION_MS as n,PX_DEFAULT_ITERATIONS as e,PX_TIMELINE_SHARED_KEYS as t,PX_TIME_ONLY_TIMELINE_KEYS as i,PX_TRANSFORM_PART_KEYS as o,PX_TRIGGER_DEFAULTS as r,PX_WIRE_BASELINE_VERSION as l,PX_WIRE_SCHEMA_VERSION as a,PX_WIRE_STEPS as s,PX_WIRE_VERSION as u,PX_WIRE_VERSION_KEY as c,PxAlongPathMode as f,PxAnimatedSvgDocumentSchema as d,PxAnimatorConfigSchema as m,PxAttrValueSchema as v,PxBezierPathSchema as g,PxClipPathEffectSchema as y,PxCloneEffectSchema as b,PxCloneWithout as p,PxControlMode as h,PxDefinitionsSchema as w,PxDiagnosticCode as F,PxDiagnosticKind as N,PxEffectsSchema as j,PxElementAnimationSchema as k,PxFillGradientEffectSchema as A,PxFillMode as C,PxFinishAction as O,PxGradientSpreadMethod as R,PxGradientStopSchema as T,PxGradientType as P,PxKeyframeSchema as D,PxKeyframeValueSchema as S,PxLengthAdjust as M,PxLoopDirection as q,PxLoopRepeatAt as x,PxLoopSchema as E,PxMaskType as J,PxMaskedByEffectSchema as z,PxMouseOutAction as I,PxNodeBaseSchema as K,PxNodeSchema as V,PxOffScreenAction as B,PxPathOverflow as G,PxPinAlign as H,PxPlaybackDirection as L,PxPropertyAnimationSchema as Q,PxRepeaterEffectSchema as U,PxRetimeEffectSchema as W,PxScrollAxis as X,PxScrollKind as Y,PxScrollPhase as Z,PxScrollRangePointSchema as $,PxScrollRangeSchema as _,PxScrollSchema as nn,PxScrollSource as en,PxStrokeTrimEffectSchema as tn,PxStrokeTrimSubPaths as on,PxSvgNodeRootSchema as rn,PxTextEffectSchema as ln,PxTextPathEffectSchema as an,PxTextPathMethod as sn,PxTextPathSpacing as un,PxTimeTimelineSchema as cn,PxTimelineEngine as fn,PxTimelineEngineSetting as dn,PxTimelineSchema as mn,PxTransformByEffectSchema as vn,PxTransformPartsSchema as gn,PxTransformValueSchema as yn,PxTriggerSchema as bn,PxTriggerStart as pn,PxUnits as hn,PxWireStepKind as wn,PxWireVersionRelation as Fn,__spreadProps as Nn,__spreadValues as jn,applyWireSteps as kn,calcAnimationValues as An,clamp as Cn,compareWireVersion as On,controlModeTakesOverTrigger as Rn,convertWireDocument as Tn,describeSchema as Pn,diagnoseDocument as Dn,downgradeWireDocument as Sn,flattenAnimatorTimeline as Mn,formatWireVersion as qn,generateNewIds as xn,getAnimatorConfig as En,getBindings as Jn,getChildren as zn,getDefinitions as In,isNativeForced as Kn,isPxDocument as Vn,isValidPxDocument as Bn,materializeAllInTree as Gn,materializeNodeEffects as Hn,mayUseNativeScrollTimeline as Ln,nestAnimatorTimeline as Qn,normalizeBindings as Un,parseWireVersion as Wn,px as Xn,readWireVersion as Yn,resolveControlMode as Zn,resolveTimelineEngine as $n,resolveTrigger as _n,schemaKeys as ne,toDomProps as ee,validateDocument as te,validateNodeEffects as ie,wireVersionAdvice as oe}from"./chunk-K2732IVS.min.js";var re="setPlaybackRate: rate must be finite and non-zero";function le(n){return Number.isFinite(n)&&0!==n}function ae(n,e){return n>0?e===1/0?1/0:n*(e>0?e:1):0}function se(n,e){return n>0?e===1/0?n:n*(e>0?e:1):0}function ue(n,e){return Number.isNaN(n)||n<0?0:Number.isFinite(e)?n>e?e:n:Number.isFinite(n)?n:0}function ce(n,e,t){const i=se(e,t);return i>0&&Number.isFinite(n)?n<=0?0:t===1/0?n%i/i:n>=i?1:n/i:0}function fe(n,e,t){const i=se(e,t);return i>0&&Number.isFinite(n)?n<=0?0:n>=1?i:n*i:0}function de(n,e=Date.now){let t=0,i=0,o=!1,r=1;const l=()=>ue(o?t+(e()-i)*r:t,n);return{now:l,isRunning:()=>o,start:(a,s)=>{t=ue(null!=s?s:l(),n),r=le(a)?a:1,i=e(),o=!0},stop:()=>{t=l(),i=0,o=!1},seek:r=>{t=ue(r,n),o&&(i=e())}}}function me(n){const e=globalThis;"function"!=typeof e.cancelAnimationFrame?e.clearTimeout(n):e.cancelAnimationFrame(n)}function ve(t,i,o){var r;const l=En(t)||{},a=Un(t,fn.js),s=l.iterations;let u=1;"number"==typeof s&&(u=s||e),"infinite"===s&&(u=1/0),u<1&&(u=1);const c=+(l.duration||n),f=c&&u?c*(u===1/0?1/0:u):c?(null!=u?u:e)*c:0,d=l.direction||cn.defaults.direction,m=null!=(r=l.fill)?r:cn.defaults.fillMode,v="forwards"===m||"both"===m,g="backwards"===m||"both"===m;let y=null,b=!1,p=-(l.delay||0),h=0,w=1,F=!1;const N=l.frameRate,j=N&&N>0?1e3/N:0;let k=0;const A=()=>{const n=h?(Date.now()-h)*w:0;return p+n},C=()=>{let n=A();return Number.isFinite(f)&&n>f&&(n=f),n<0&&(n=0),n};function O(n){let e=function(){const e=c>0?c:1;let t=0,i=0;if(c>0){n=Cn(n,0,u*e),i=Math.max(0,Math.ceil(n/e)-1),i=Math.min(i,u-1);t=Cn((n-i*e)/e,0,1)}else t=n;const o=d||"normal";let r=t;return"reverse"===o?r=1-t:"alternate"===o?i%2==1&&(r=1-t):"alternate-reverse"===o&&i%2==0&&(r=1-t),r}();for(const n of a||[]){const t=n.animate;if(!t||"object"!=typeof t||Array.isArray(t)){console.warn("Empty or unresolved binding",n);continue}const o=An(t,e*c);for(const[e,t]of Object.entries(o))i.setAttribute(n.id,e,t)}}l.delay&&(l.delay<0?O(C()):g&&O(0));const R=()=>!!b&&(!!i.isConnected()&&(w<0?A()>0:!(Number.isFinite(f)&&C()>=f))),T=n=>{null!==y&&(me(y),y=null),(n||R())&&(y=function(n){const e=globalThis;return"function"==typeof e.requestAnimationFrame?e.requestAnimationFrame(n):e.setTimeout(n,16)}(()=>{y=null,(()=>{var n,e;if(!i.isConnected())return void P();const t=C(),r=A();if(r<0&&w>0)g&&O(0);else{if(w<0&&r<=0)return P(),O(0),void(F||(F=!0,null==(n=null==o?void 0:o.onFinish)||n.call(o)));if(w>0&&f&&Number.isFinite(f)&&t>=f)return P(),O(v?f:0),void(F||(F=!0,null==(e=null==o?void 0:o.onFinish)||e.call(o)));if(j>0){const n=Date.now();if(k&&n-k<j)return;k=n}O(t)}})(),T()}))},P=()=>{if(!b)return;let n=A();Number.isFinite(f)&&n>f&&(n=f),p=n,h=0,b=!1,null!==y&&(me(y),y=null),n>=0?O(n):g&&O(0)},D={isReady:()=>!0,getRootElement:()=>null,isPlaying:()=>R(),play:()=>{var n;(()=>{if(!b){if(w>=0)Number.isFinite(f)&&p>=f&&(p=0);else if(p<=0){if(!Number.isFinite(f))return void console.warn("play: cannot start reverse playback of an infinite animation from time 0");p=f}F=!1,b=!0,h=Date.now(),T(!0)}})(),null==(n=null==o?void 0:o.onPlay)||n.call(o)},pause:()=>{var n;P(),null==(n=null==o?void 0:o.onPause)||n.call(o)},cancel:()=>{var n;P(),p=0,h=0,b=!1,F=!1,O(p),null==(n=null==o?void 0:o.onCancel)||n.call(o)},finish:()=>{((n=!0)=>{var e;p=Number.isFinite(f)?f:C(),h=0,b=!1,null!==y&&(me(y),y=null),O(v?p:0),n&&!F&&(F=!0,null==(e=null==o?void 0:o.onFinish)||e.call(o))})(!0)},setPlaybackRate:n=>{if(!le(n))return void console.warn(re);let e=A();Number.isFinite(f)&&e>f&&(e=f),n<0!=w<0&&(F=!1),w=n,p=e,b&&(h=Date.now())},getCurrentTime:()=>C(),setCurrentTime:n=>{n=ue(n,f),p=n,b&&(h=Date.now()),(!Number.isFinite(f)||n<f)&&(F=!1),O(C())},getCurrentProgress:()=>ce(C(),c,u),setCurrentProgress:n=>{D.setCurrentTime(fe(n,c,u))},destroy:()=>{var n;D.cancel(),null==(n=null==o?void 0:o.onRemove)||n.call(o)}};return D}var ge=["timelineSource","scroll","trigger","delay","iterations","direction","fill","resetOnFinish","duration","mode","frameRate"],ye=["definitions","bindings"],be=n=>!!n&&"object"==typeof n&&!Array.isArray(n);function pe(n,e){const t=be(n)?jn({},n):{};for(const n of Object.keys(e)){const i=e[n];null!==i?be(i)?t[n]=pe(t[n],i):t[n]=i:delete t[n]}return t}function he(n,e,o){const r=be(l=n)&&"string"==typeof l.type?l.type:"time";var l;const a=be(e)&&"string"==typeof e.type?String(e.type):r;let s;if(a!==r){const i={};if(be(n))for(const e of t)void 0!==n[e]&&(i[e]=n[e]);s=pe(i,e)}else s=pe(n,e);if("scroll"===(u=a)||"view"===u){for(const n of i)void 0!==s[n]&&(o("animator.timeline."+n+": no slot on a '"+a+"' timeline — dropped"),delete s[n]);"infinite"===s.iterations&&(o("animator.timeline.iterations: 'infinite' cannot map onto a scroll range — dropped"),delete s.iterations)}var u;return s}function we(n,e){let t;if("string"==typeof n)try{t=JSON.parse(n)}catch(n){console.warn("timeline override: not valid JSON — ignored",n),t=void 0}else t=null!=n?n:void 0;const{duration:i,delay:o,iterations:r,start:l}=e;if(void 0===i&&void 0===o&&void 0===r&&void 0===l)return void 0===t?void 0:{timeline:t};const a=be(t)?jn({},t):{};return void 0!==i&&(a.duration=i),void 0!==o&&(a.delay=o),void 0!==r&&(a.iterations=r),void 0!==l&&(a.trigger=Nn(jn({},a.trigger),{start:l})),{timeline:a}}function Fe(n,e){const t=[],i=n=>t.push(n);if(null===e)return{config:void 0,warnings:t};if(!be(e)||0===Object.keys(e).length)return{config:n,warnings:t};const o=be(n)?ge.filter(e=>void 0!==n[e]):[];o.length&&i("animator: the base carries the flat runtime spelling ("+o.join(", ")+"); the patch merges the wire spelling only");const r=be(n)?jn({},n):{};for(const n of Object.keys(e)){const t=e[n];null!==t?"timeline"!==n?be(t)?r[n]=pe(r[n],t):r[n]=t:r.timeline=be(t)?he(r.timeline,t,i):t:delete r[n]}return{config:r,warnings:t}}function Ne(n,e,t){var i,o;const r=!!(null==t?void 0:t.resetTimeline);if(!(n&&void 0!==e&&(r||null!==e&&be(e)&&Object.keys(e).length)))return{doc:n,warnings:[]};const l=n,a=be(l.animator),s=!a&&be(null==(i=l.meta)?void 0:i.animator),u=a?l.animator:s?l.meta.animator:void 0,c=[];a&&be(null==(o=l.meta)?void 0:o.animator)&&c.push("animator: doc.meta.animator is shadowed by doc.animator and was not patched");let f=u;if(r){const n={};for(const e of ye)be(u)&&void 0!==u[e]&&(n[e]=u[e]);f=n}const d=Fe(f,null!=e?e:{});return c.push(...d.warnings),d.config===u?{doc:n,warnings:c}:s?{doc:Nn(jn({},l),{meta:Nn(jn({},l.meta),{animator:d.config})}),warnings:c}:{doc:Nn(jn({},l),{animator:d.config}),warnings:c}}export{re as PX_RATE_REJECTED,o as PX_TRANSFORM_PART_KEYS,r as PX_TRIGGER_DEFAULTS,l as PX_WIRE_BASELINE_VERSION,a as PX_WIRE_SCHEMA_VERSION,s as PX_WIRE_STEPS,u as PX_WIRE_VERSION,c as PX_WIRE_VERSION_KEY,f as PxAlongPathMode,d as PxAnimatedSvgDocumentSchema,m as PxAnimatorConfigSchema,v as PxAttrValueSchema,g as PxBezierPathSchema,y as PxClipPathEffectSchema,b as PxCloneEffectSchema,p as PxCloneWithout,h as PxControlMode,w as PxDefinitionsSchema,F as PxDiagnosticCode,N as PxDiagnosticKind,j as PxEffectsSchema,k as PxElementAnimationSchema,A as PxFillGradientEffectSchema,C as PxFillMode,O as PxFinishAction,R as PxGradientSpreadMethod,T as PxGradientStopSchema,P as PxGradientType,D as PxKeyframeSchema,S as PxKeyframeValueSchema,M as PxLengthAdjust,q as PxLoopDirection,x as PxLoopRepeatAt,E as PxLoopSchema,J as PxMaskType,z as PxMaskedByEffectSchema,I as PxMouseOutAction,K as PxNodeBaseSchema,V as PxNodeSchema,B as PxOffScreenAction,G as PxPathOverflow,H as PxPinAlign,L as PxPlaybackDirection,Q as PxPropertyAnimationSchema,U as PxRepeaterEffectSchema,W as PxRetimeEffectSchema,X as PxScrollAxis,Y as PxScrollKind,Z as PxScrollPhase,$ as PxScrollRangePointSchema,_ as PxScrollRangeSchema,nn as PxScrollSchema,en as PxScrollSource,tn as PxStrokeTrimEffectSchema,on as PxStrokeTrimSubPaths,rn as PxSvgNodeRootSchema,ln as PxTextEffectSchema,an as PxTextPathEffectSchema,sn as PxTextPathMethod,un as PxTextPathSpacing,cn as PxTimeTimelineSchema,fn as PxTimelineEngine,dn as PxTimelineEngineSetting,mn as PxTimelineSchema,vn as PxTransformByEffectSchema,gn as PxTransformPartsSchema,yn as PxTransformValueSchema,bn as PxTriggerSchema,pn as PxTriggerStart,hn as PxUnits,wn as PxWireStepKind,Fn as PxWireVersionRelation,Ne as applyAnimatorConfig,kn as applyWireSteps,An as calcAnimationValues,ue as clampSeekMs,On as compareWireVersion,Rn as controlModeTakesOverTrigger,Tn as convertWireDocument,ve as createAdapterAnimator,de as createRunClock,Pn as describeSchema,Dn as diagnoseDocument,Sn as downgradeWireDocument,Mn as flattenAnimatorTimeline,we as foldTimelineOverride,qn as formatWireVersion,xn as generateNewIds,En as getAnimatorConfig,Jn as getBindings,zn as getChildren,In as getDefinitions,Kn as isNativeForced,Vn as isPxDocument,le as isValidPlaybackRate,Bn as isValidPxDocument,Gn as materializeAllInTree,Hn as materializeNodeEffects,Ln as mayUseNativeScrollTimeline,Fe as mergeAnimatorConfig,Qn as nestAnimatorTimeline,Un as normalizeBindings,Wn as parseWireVersion,se as progressSpanMs,fe as progressToTimeMs,Xn as px,Yn as readWireVersion,Zn as resolveControlMode,$n as resolveTimelineEngine,_n as resolveTrigger,ne as schemaKeys,ae as seekCeilingMs,ce as timeToProgress,ee as toDomProps,te as validateDocument,ie as validateNodeEffects,oe as wireVersionAdvice};

package/dist/internal.cjs

@@ -55,6 +55,7 @@ __export(internal_exports, {
   PX_COLOR_ATTR_NAMES: () => PX_COLOR_ATTR_NAMES,
   PX_CSS_ONLY_STYLE_PROPS: () => PX_CSS_ONLY_STYLE_PROPS,
   PX_DEFAULT_DURATION_MS: () => PX_DEFAULT_DURATION_MS,
+  PX_DEFAULT_ITERATIONS: () => PX_DEFAULT_ITERATIONS,
   PX_DISALLOWED_SVG_TAGS_LOWER: () => PX_DISALLOWED_SVG_TAGS_LOWER,
   PX_LOOP_JUMP_SHIFT_MS: () => PX_LOOP_JUMP_SHIFT_MS,
   PX_PCT_BASED_ATTR_NAMES: () => PX_PCT_BASED_ATTR_NAMES,
@@ -115,19 +116,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;
@@ -141,8 +154,8 @@ var Optional = class extends Base {
   }
 };
 var Str = class extends Base {
-  constructor(_default = "") {
-    super();
+  constructor(_default, statesDefault) {
+    super(statesDefault);
     this._default = _default;
   }
   sanitize(raw) {
@@ -155,8 +168,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) {
@@ -169,8 +182,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) {
@@ -183,8 +196,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;
   }
@@ -198,8 +212,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];
   }
@@ -214,8 +228,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;
     /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Union from Tuple. */
     this._kind = "union";
@@ -269,7 +283,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;
     /** Structural tag read by {@link describeSchema}. */
@@ -309,13 +323,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 : {};
@@ -357,12 +377,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 : {};
@@ -407,7 +428,7 @@ var OpenObj = class extends Base {
 };
 var Arr = class extends Base {
   constructor(item) {
-    super();
+    super(false);
     this.item = item;
     this._default = [];
   }
@@ -439,7 +460,7 @@ var Arr = class extends Base {
 };
 var Rec = class extends Base {
   constructor(value) {
-    super();
+    super(false);
     this.value = value;
     /** Structural tag read by {@link describeSchema}. */
     this._kind = "record";
@@ -473,7 +494,7 @@ var Rec = class extends Base {
 };
 var Any = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -488,7 +509,7 @@ var Any = class extends Base {
 };
 var Defined = class extends Base {
   constructor() {
-    super(...arguments);
+    super(false);
     this._default = void 0;
   }
   sanitize(raw) {
@@ -505,7 +526,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;
@@ -526,7 +547,7 @@ var Lazy = class extends Base {
 };
 var Tuple = class extends Base {
   constructor(schemas) {
-    super();
+    super(false);
     this.schemas = schemas;
     /** Structural tag read by {@link describeSchema} — `schemas` alone cannot tell Tuple from Union. */
     this._kind = "tuple";
@@ -577,22 +598,29 @@ function describeSchema(schema) {
   if ("fn" in s) return { kind: "lazy", resolved: (_a2 = s.resolved) != null ? _a2 : s.resolved = s.fn() };
   return { kind: "leaf" };
 }
+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.
@@ -600,7 +628,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,
@@ -721,8 +750,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). */
@@ -935,15 +967,15 @@ var keyframeTangentIn = (kf) => anyKf(kf).tangentIn;
 var keyframeTangentOut = (kf) => anyKf(kf).tangentOut;
 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(),
@@ -973,9 +1005,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(),
@@ -1001,7 +1033,7 @@ var PxScrollRangePointSchema = implementsInterface()(px.object({
     PxScrollPhase.exit,
     PxScrollPhase.entryCrossing,
     PxScrollPhase.exitCrossing
-  ]).optional(),
+  ], PxScrollPhase.cover).optional(),
   fraction: px.number().optional()
 }));
 var PxScrollRangeSchema = px.object({
@@ -1009,37 +1041,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
@@ -1050,8 +1082,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(),
@@ -1131,9 +1163,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(),
@@ -1145,7 +1178,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(),
@@ -1177,17 +1210,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()
 }));
@@ -1634,7 +1670,6 @@ function parseTransformParts(str2) {
   return Object.keys(out).length ? out : void 0;
 }
 var PX_STYLE_ATTR_NAMES = /* @__PURE__ */ new Set(["offset-distance", "offsetDistance"]);
-var PX_DEFAULT_DURATION_MS = 1e3;
 function kebabToCamelCaseWord(kebab) {
   return kebab.includes("-") ? kebab.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()) : kebab;
 }
@@ -6058,9 +6093,10 @@ function replaceUrlRefs(value, idMap) {
 // src/materialize/PxRestPose.ts
 var TRANSFORM_CHANNEL = "transform";
 var REVERSED_DIRECTIONS = /* @__PURE__ */ new Set(["reverse", "alternate-reverse"]);
+var VERIFY_SAMPLE_FRACTIONS = [0, 0.25, 0.5, 0.75, 1];
 var SCRATCH_ID_PREFIX = "__px_rest_";
 function materializeRestPosesInTree(root, engine) {
-  var _a2;
+  var _a2, _b;
   const out = deepClone(root);
   const config = getAnimatorConfig(out) || {};
   const duration = +(config.duration || PX_DEFAULT_DURATION_MS);
@@ -6072,18 +6108,27 @@ function materializeRestPosesInTree(root, engine) {
   for (const [key, animate] of before) {
     const node = nodes.get(key);
     if (!node) continue;
-    for (const channel of Object.keys(animate)) {
+    const channels = Object.keys(animate);
+    for (const channel of channels) {
+      if (PX_TRANSFORM_FN_NAMES.has(channel)) continue;
       if (!mayCarryRestPose(node, channel)) continue;
       const value = firstFrameValue(animate, channel, firstFrameTime);
       if (value === void 0) continue;
       node[channel] = value;
       added.set(key, [...(_a2 = added.get(key)) != null ? _a2 : [], channel]);
     }
+    if (channels.some((channel) => PX_TRANSFORM_FN_NAMES.has(channel)) && mayCarryTransformRestPose(node)) {
+      const parts = firstFrameTransformParts(animate, firstFrameTime);
+      if (parts) {
+        node[TRANSFORM_CHANNEL] = parts;
+        added.set(key, [...(_b = added.get(key)) != null ? _b : [], TRANSFORM_CHANNEL]);
+      }
+    }
   }
   if (added.size) {
     const after = bindingsOf(out, engine);
     for (const [key, channels] of added) {
-      if (JSON.stringify(after.get(key)) === JSON.stringify(before.get(key))) continue;
+      if (writesTheSameFrames(before.get(key), after.get(key), duration)) continue;
       const node = nodes.get(key);
       if (node) for (const channel of channels) delete node[channel];
     }
@@ -6092,16 +6137,31 @@ function materializeRestPosesInTree(root, engine) {
 }
 function mayCarryRestPose(node, channel) {
   if (node[channel] !== void 0) return false;
-  if (PX_TRANSFORM_FN_NAMES.has(channel)) return false;
-  if (channel === TRANSFORM_CHANNEL) {
-    for (const part of PX_TRANSFORM_FN_NAMES) if (node[part] !== void 0) return false;
-  }
+  if (channel === TRANSFORM_CHANNEL) return mayCarryTransformRestPose(node);
+  return true;
+}
+function mayCarryTransformRestPose(node) {
+  if (node[TRANSFORM_CHANNEL] !== void 0) return false;
+  for (const part of PX_TRANSFORM_FN_NAMES) if (node[part] !== void 0) return false;
   return true;
 }
 function firstFrameValue(animate, channel, timeMs) {
   const values = Object.values(calcAnimationValues({ [channel]: animate[channel] }, timeMs));
   return values.length === 1 && values[0] !== "" ? values[0] : void 0;
 }
+function firstFrameTransformParts(animate, timeMs) {
+  const family = {};
+  for (const channel of Object.keys(animate)) if (PX_TRANSFORM_FN_NAMES.has(channel)) family[channel] = animate[channel];
+  const written = calcAnimationValues(family, timeMs)[TRANSFORM_CHANNEL];
+  if (!written) return void 0;
+  const parts = parseTransformParts(written.replace(/(px|deg)\b/g, ""));
+  return parts && Object.keys(parts).length ? parts : void 0;
+}
+function writesTheSameFrames(a, b, durationMs) {
+  if (!a || !b) return a === b;
+  const frame = (animate, t) => JSON.stringify(calcAnimationValues(animate, t)).replace(/\s+/g, "");
+  return VERIFY_SAMPLE_FRACTIONS.every((fraction) => frame(a, fraction * durationMs) === frame(b, fraction * durationMs));
+}
 function bindingsOf(tree, engine) {
   const scratch = deepClone(tree);
   const keyById = /* @__PURE__ */ new Map();
@@ -6544,6 +6604,7 @@ function releaseLogProblems(releases, steps, declared, baseline) {
   PX_COLOR_ATTR_NAMES,
   PX_CSS_ONLY_STYLE_PROPS,
   PX_DEFAULT_DURATION_MS,
+  PX_DEFAULT_ITERATIONS,
   PX_DISALLOWED_SVG_TAGS_LOWER,
   PX_LOOP_JUMP_SHIFT_MS,
   PX_PCT_BASED_ATTR_NAMES,