svg-scroll-draw 0.2.1 → 0.4.0

package/dist/angular/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:o}}function te(e,t,n,o){switch(o){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(n+o)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function ye(e,t,n){return Math.min(n,Math.max(t,e))}function z(e,t,n,o){return n===t?0:ye((e-t)/(n-t)*o,0,1)}function oe(e,t,n,o,i){let p=te(e.top,e.height,t,o.element)-re(o.viewport,n),d=te(e.top,e.height,t,i.element)-re(i.viewport,n);return {tStart:p,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,n){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*n)},${Math.round(o[1]+(i[1]-o[1])*n)},${Math.round(o[2]+(i[2]-o[2])*n)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function be(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ge(e,t,n){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let p=n==="x"?window.scrollX:window.scrollY,d=e-p,A=t-p,T=n==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:p=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:J=false,debug:ce=false,axis:f="y",scrollContainer:W,autoReverse:K=false,delay:Q=0,strokeColor:g,strokeWidth:w,waypoints:G,onProgress:ue,onStart:pe,onComplete:U}=t,Y=typeof d=="function"?d:X[d]??X.linear,fe=_(A.start??"top bottom"),de=_(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(g)?g[0]:null,x=Array.isArray(g)?g[1]:typeof g=="string"?g:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),h=[],$=0,k=0,L=false,V=false,M=0,N=false,F=-1,C=-1,P=null,R=new Set;function q(){return l?f==="x"?l.scrollLeft:l.scrollTop:f==="x"?window.scrollX:window.scrollY}function me(){return l?f==="x"?l.clientWidth:l.clientHeight:f==="x"?window.innerWidth:window.innerHeight}function Z(){let r=e.getBoundingClientRect(),s,D,y;if(l){let c=l.getBoundingClientRect();s=f==="x"?r.left-c.left+l.scrollLeft:r.top-c.top+l.scrollTop,D=f==="x"?r.width:r.height,y=q();}else s=f==="x"?r.left:r.top,D=f==="x"?r.width:r.height,y=q();let a=oe({top:s,height:D},y,me(),fe,de);$=a.tStart,k=a.tEnd,ce&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=ge($,k,f));}function he(){I.forEach((r,s)=>{r.style.strokeDasharray=`${h[s]}`,r.style.strokeDashoffset=b==="reverse"?"0":`${h[s]}`,p?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`);});}if(I.forEach(r=>{be(r);let s=j(r);h.push(s),n?(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?`${s}`:"0",p&&(r.style.opacity="1"),x&&(r.style.stroke=x),E!==null&&(r.style.strokeWidth=`${E}`)):(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?"0":`${s}`,p?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`));}),n)return U?.(),{destroy:()=>{},replay:()=>{}};Z();function ee(){if(!N)return;let r=q(),s=K?C===-1||r>=C?"forward":"reverse":b;C=r;let D=k-$,y=true;if(I.forEach((a,c)=>{let S=c*T*D,u=Y(z(r,$+S,k+S,i));J&&!K&&(F=Math.max(F,u),u=F),a.style.strokeDashoffset=s==="reverse"?`${h[c]*u}`:`${h[c]*(1-u)}`,p&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=se(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ue?.(u),u<1&&(y=false);}),G){let a=Y(z(r,$,k,i));for(let c in G){let S=parseFloat(c);a>=S&&!R.has(S)&&(R.add(S),G[c]?.());}}!V&&z(r,$,k,i)>0&&(V=true,pe?.()),y&&!L?(L=true,U?.()):!y&&!J&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(r=>{r.forEach(s=>{N=s.isIntersecting,N?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:l??null}),H;function O(){clearTimeout(H),H=setTimeout(()=>{I.forEach((r,s)=>{h[s]=j(r),r.style.strokeDasharray=`${h[s]}`;}),Z();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),Q>0?setTimeout(()=>B.observe(e),Q):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(H),P?.remove();},replay(){F=-1,C=-1,V=false,L=false,R.clear(),he();}}}var ae=class{constructor(){this.instance=null;}init(t,n={}){return this.destroy(),this.instance=le(t,n),this}replay(){return this.instance?.replay(),this}destroy(){return this.instance?.destroy(),this.instance=null,this}};exports.ScrollDrawRef=ae;

package/dist/angular/index.d.mts

@@ -0,0 +1,73 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * Framework-agnostic class for use in Angular components.
+ * No @angular/core dependency required.
+ *
+ * @example
+ * // In your Angular component:
+ * import { ScrollDrawRef } from 'svg-scroll-draw/angular';
+ *
+ * @Component({ template: '<div #container><svg>...</svg></div>' })
+ * export class HeroComponent implements AfterViewInit, OnDestroy {
+ *   @ViewChild('container') containerRef!: ElementRef<HTMLElement>;
+ *   private draw = new ScrollDrawRef();
+ *
+ *   ngAfterViewInit() {
+ *     this.draw.init(this.containerRef.nativeElement, {
+ *       easing: 'ease-out',
+ *       speed: 1.2,
+ *       fade: true,
+ *     });
+ *   }
+ *
+ *   ngOnDestroy() { this.draw.destroy(); }
+ *
+ *   replay() { this.draw.replay(); }
+ * }
+ */
+declare class ScrollDrawRef {
+    private instance;
+    init(element: HTMLElement, options?: ScrollDrawOptions): this;
+    replay(): this;
+    destroy(): this;
+}
+
+export { type ScrollDrawInstance, type ScrollDrawOptions, ScrollDrawRef };

package/dist/angular/index.d.ts

@@ -0,0 +1,73 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * Framework-agnostic class for use in Angular components.
+ * No @angular/core dependency required.
+ *
+ * @example
+ * // In your Angular component:
+ * import { ScrollDrawRef } from 'svg-scroll-draw/angular';
+ *
+ * @Component({ template: '<div #container><svg>...</svg></div>' })
+ * export class HeroComponent implements AfterViewInit, OnDestroy {
+ *   @ViewChild('container') containerRef!: ElementRef<HTMLElement>;
+ *   private draw = new ScrollDrawRef();
+ *
+ *   ngAfterViewInit() {
+ *     this.draw.init(this.containerRef.nativeElement, {
+ *       easing: 'ease-out',
+ *       speed: 1.2,
+ *       fade: true,
+ *     });
+ *   }
+ *
+ *   ngOnDestroy() { this.draw.destroy(); }
+ *
+ *   replay() { this.draw.replay(); }
+ * }
+ */
+declare class ScrollDrawRef {
+    private instance;
+    init(element: HTMLElement, options?: ScrollDrawOptions): this;
+    replay(): this;
+    destroy(): this;
+}
+
+export { type ScrollDrawInstance, type ScrollDrawOptions, ScrollDrawRef };

package/dist/angular/index.mjs

@@ -0,0 +1,3 @@
+var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:o}}function te(e,t,n,o){switch(o){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(n+o)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function ye(e,t,n){return Math.min(n,Math.max(t,e))}function z(e,t,n,o){return n===t?0:ye((e-t)/(n-t)*o,0,1)}function oe(e,t,n,o,i){let p=te(e.top,e.height,t,o.element)-re(o.viewport,n),d=te(e.top,e.height,t,i.element)-re(i.viewport,n);return {tStart:p,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,n){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*n)},${Math.round(o[1]+(i[1]-o[1])*n)},${Math.round(o[2]+(i[2]-o[2])*n)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function be(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ge(e,t,n){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let p=n==="x"?window.scrollX:window.scrollY,d=e-p,A=t-p,T=n==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:p=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:J=false,debug:ce=false,axis:f="y",scrollContainer:W,autoReverse:K=false,delay:Q=0,strokeColor:g,strokeWidth:w,waypoints:G,onProgress:ue,onStart:pe,onComplete:U}=t,Y=typeof d=="function"?d:X[d]??X.linear,fe=_(A.start??"top bottom"),de=_(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(g)?g[0]:null,x=Array.isArray(g)?g[1]:typeof g=="string"?g:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),h=[],$=0,k=0,L=false,V=false,M=0,N=false,F=-1,C=-1,P=null,R=new Set;function q(){return l?f==="x"?l.scrollLeft:l.scrollTop:f==="x"?window.scrollX:window.scrollY}function me(){return l?f==="x"?l.clientWidth:l.clientHeight:f==="x"?window.innerWidth:window.innerHeight}function Z(){let r=e.getBoundingClientRect(),s,D,y;if(l){let c=l.getBoundingClientRect();s=f==="x"?r.left-c.left+l.scrollLeft:r.top-c.top+l.scrollTop,D=f==="x"?r.width:r.height,y=q();}else s=f==="x"?r.left:r.top,D=f==="x"?r.width:r.height,y=q();let a=oe({top:s,height:D},y,me(),fe,de);$=a.tStart,k=a.tEnd,ce&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=ge($,k,f));}function he(){I.forEach((r,s)=>{r.style.strokeDasharray=`${h[s]}`,r.style.strokeDashoffset=b==="reverse"?"0":`${h[s]}`,p?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`);});}if(I.forEach(r=>{be(r);let s=j(r);h.push(s),n?(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?`${s}`:"0",p&&(r.style.opacity="1"),x&&(r.style.stroke=x),E!==null&&(r.style.strokeWidth=`${E}`)):(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?"0":`${s}`,p?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`));}),n)return U?.(),{destroy:()=>{},replay:()=>{}};Z();function ee(){if(!N)return;let r=q(),s=K?C===-1||r>=C?"forward":"reverse":b;C=r;let D=k-$,y=true;if(I.forEach((a,c)=>{let S=c*T*D,u=Y(z(r,$+S,k+S,i));J&&!K&&(F=Math.max(F,u),u=F),a.style.strokeDashoffset=s==="reverse"?`${h[c]*u}`:`${h[c]*(1-u)}`,p&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=se(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ue?.(u),u<1&&(y=false);}),G){let a=Y(z(r,$,k,i));for(let c in G){let S=parseFloat(c);a>=S&&!R.has(S)&&(R.add(S),G[c]?.());}}!V&&z(r,$,k,i)>0&&(V=true,pe?.()),y&&!L?(L=true,U?.()):!y&&!J&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(r=>{r.forEach(s=>{N=s.isIntersecting,N?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:l??null}),H;function O(){clearTimeout(H),H=setTimeout(()=>{I.forEach((r,s)=>{h[s]=j(r),r.style.strokeDasharray=`${h[s]}`;}),Z();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),Q>0?setTimeout(()=>B.observe(e),Q):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(H),P?.remove();},replay(){F=-1,C=-1,V=false,L=false,R.clear(),he();}}}var ae=class{constructor(){this.instance=null;}init(t,n={}){return this.destroy(),this.instance=le(t,n),this}replay(){return this.instance?.replay(),this}destroy(){return this.instance?.destroy(),this.instance=null,this}};export{ae as ScrollDrawRef};

package/dist/cdn/svg-scroll-draw.global.js

@@ -1 +1,3 @@
-"use strict";var SvgScrollDraw=(()=>{var A=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var J=Object.prototype.hasOwnProperty;var K=(e,t)=>{for(var r in t)A(e,r,{get:t[r],enumerable:!0})},Q=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of j(t))!J.call(e,o)&&o!==r&&A(e,o,{get:()=>t[o],enumerable:!(n=_(t,o))||n.enumerable});return e};var U=e=>Q(A({},"__esModule",{value:!0}),e);var Z={};K(Z,{scrollDraw:()=>Y});var D={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function x(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return{element:"top",viewport:t};let r=t.split(/\s+/).filter(Boolean),[n="top",o="bottom"]=r;return{element:n,viewport:o}}function C(e,t,r,n){switch(n){case"top":return e+r;case"center":return e+r+t/2;case"bottom":return e+r+t;default:return e+r}}function G(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case"top":return 0;case"center":return t/2;case"bottom":return t;default:return t}}function I(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),n=parseFloat(e.getAttribute("height")??"0");return 2*(r+n)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function W(e,t,r){return Math.min(r,Math.max(t,e))}function V(e,t,r,n){return r===t?0:W((e-t)/(r-t)*n,0,1)}function N(e,t,r,n,o){let a=C(e.top,e.height,t,n.element)-G(n.viewport,r),c=C(e.top,e.height,t,o.element)-G(o.viewport,r);return{tStart:a,tEnd:c}}function q(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t)}function X(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?q("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&q("Element has a fill \u2014 it may obscure the stroke animation.",e)}function w(e,t={}){if(typeof window>"u")return{destroy:()=>{}};let{selector:r="path, polyline, line, polygon, rect, circle",speed:n=1,fade:o=!1,easing:a="linear",trigger:c={},stagger:m=0,direction:p="forward",onProgress:z,onComplete:M}=t,P=typeof a=="function"?a:D[a]??D.linear,R=x(c.start??"top bottom"),B=x(c.end??"bottom top"),b=Array.from(e.querySelectorAll(r)),u=[],h=0,y=0,E=!1,f=0,v=!1;function k(){let s=e.getBoundingClientRect(),i=N({top:s.top,height:s.height},window.scrollY,window.innerHeight,R,B);h=i.tStart,y=i.tEnd}b.forEach(s=>{X(s);let i=I(s);u.push(i),s.style.strokeDasharray=`${i}`,s.style.strokeDashoffset=p==="reverse"?"0":`${i}`,o&&(s.style.opacity=p==="reverse"?"1":"0")}),k();function F(){if(!v)return;let s=y-h,i=!0;b.forEach(($,g)=>{let L=g*m*s,l=P(V(window.scrollY,h+L,y+L,n));$.style.strokeDashoffset=p==="reverse"?`${u[g]*l}`:`${u[g]*(1-l)}`,o&&($.style.opacity=p==="reverse"?`${1-l}`:`${l}`),g===0&&z?.(l),l<1&&(i=!1)}),i&&!E?(E=!0,M?.()):i||(E=!1),f=requestAnimationFrame(F)}let O=new IntersectionObserver(s=>{s.forEach(i=>{v=i.isIntersecting,v?f=requestAnimationFrame(F):cancelAnimationFrame(f)})});O.observe(e);let S;function d(){clearTimeout(S),S=setTimeout(()=>{b.forEach((s,i)=>{u[i]=I(s),s.style.strokeDasharray=`${u[i]}`}),k()},150)}return window.addEventListener("resize",d),window.addEventListener("orientationchange",d),{destroy(){cancelAnimationFrame(f),O.disconnect(),window.removeEventListener("resize",d),window.removeEventListener("orientationchange",d),clearTimeout(S)}}}function Y(e,t){if(typeof window>"u")return{destroy:()=>{}};let r=typeof e=="string"?document.querySelector(e):e;return r?w(r,t):(console.warn("[svg-scroll-draw] Container not found:",e),{destroy:()=>{}})}var T=class extends HTMLElement{constructor(){super(...arguments);this.instance=null}connectedCallback(){let r={},n=this.getAttribute("speed"),o=this.getAttribute("easing"),a=this.getAttribute("stagger"),c=this.getAttribute("direction"),m=this.getAttribute("selector");n&&(r.speed=parseFloat(n)),o&&(r.easing=o),a&&(r.stagger=parseFloat(a)),c&&(r.direction=c),m&&(r.selector=m),this.hasAttribute("fade")&&(r.fade=this.getAttribute("fade")!=="false"),this.instance=w(this,r)}disconnectedCallback(){this.instance?.destroy(),this.instance=null}};typeof customElements<"u"&&!customElements.get("scroll-draw")&&customElements.define("scroll-draw",T);return U(Z);})();
+"use strict";var SvgScrollDraw=(()=>{var _=Object.defineProperty;var be=Object.getOwnPropertyDescriptor;var ye=Object.getOwnPropertyNames;var we=Object.prototype.hasOwnProperty;var ve=(e,t)=>{for(var r in t)_(e,r,{get:t[r],enumerable:!0})},xe=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of ye(t))!we.call(e,s)&&s!==r&&_(e,s,{get:()=>t[s],enumerable:!(n=be(t,s))||n.enumerable});return e};var Ee=e=>xe(_({},"__esModule",{value:!0}),e);var De={};ve(De,{scrollDraw:()=>$e});var j={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function J(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return{element:"top",viewport:t};let[r="top",n="bottom"]=t.split(/\s+/).filter(Boolean);return{element:r,viewport:n}}function oe(e,t,r,n){switch(n){case"top":return e+r;case"center":return e+r+t/2;case"bottom":return e+r+t;default:return e+r}}function se(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case"top":return 0;case"center":return t/2;case"bottom":return t;default:return t}}function K(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),n=parseFloat(e.getAttribute("height")??"0");return 2*(r+n)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function Se(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,n){return r===t?0:Se((e-t)/(r-t)*n,0,1)}function le(e,t,r,n,s){let l=oe(e.top,e.height,t,n.element)-se(n.viewport,r),a=oe(e.top,e.height,t,s.element)-se(s.viewport,r);return{tStart:l,tEnd:a}}function ie(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return[parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return[parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let n=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return n?[parseInt(n[1]),parseInt(n[2]),parseInt(n[3])]:null}function ae(e,t,r){let n=ie(e),s=ie(t);return!n||!s?e:`rgb(${Math.round(n[0]+(s[0]-n[0])*r)},${Math.round(n[1]+(s[1]-n[1])*r)},${Math.round(n[2]+(s[2]-n[2])*r)})`}function ce(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t)}function Ae(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?ce("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&ce("Element has a fill \u2014 it may obscure the stroke animation.",e)}function ke(e,t,r){let n=document.createElement("div");n.setAttribute("data-svg-scroll-draw-debug",""),n.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function s(){let l=r==="x"?window.scrollX:window.scrollY,a=e-l,m=t-l,I=r==="x";n.innerHTML=`
+      <div style="position:absolute;${I?`left:${a}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${a}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${I?`left:${m}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${m}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`}return document.body.appendChild(n),window.addEventListener("scroll",s,{passive:!0}),s(),n}function W(e,t={}){if(typeof window>"u")return{destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:n="path, polyline, line, polygon, rect, circle",speed:s=1,fade:l=!1,easing:a="linear",trigger:m={},stagger:I=0,direction:y="forward",once:U=!1,debug:ue=!1,axis:d="y",scrollContainer:G,autoReverse:Y=!1,delay:Z=0,strokeColor:w,strokeWidth:v,waypoints:V,onProgress:fe,onStart:pe,onComplete:ee}=t,te=typeof a=="function"?a:j[a]??j.linear,de=J(m.start??"top bottom"),me=J(m.end??"bottom top"),c=typeof G=="string"?document.querySelector(G):G??null,x=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="string"?w:null,g=Array.isArray(v)?v[0]:null,S=Array.isArray(v)?v[1]:typeof v=="number"?v:null,T=Array.from(e.querySelectorAll(n)),h=[],A=0,k=0,L=!1,N=!1,M=0,P=!1,C=-1,F=-1,R=null,q=new Set;function B(){return c?d==="x"?c.scrollLeft:c.scrollTop:d==="x"?window.scrollX:window.scrollY}function ge(){return c?d==="x"?c.clientWidth:c.clientHeight:d==="x"?window.innerWidth:window.innerHeight}function re(){let o=e.getBoundingClientRect(),i,D,b;if(c){let f=c.getBoundingClientRect();i=d==="x"?o.left-f.left+c.scrollLeft:o.top-f.top+c.scrollTop,D=d==="x"?o.width:o.height,b=B()}else i=d==="x"?o.left:o.top,D=d==="x"?o.width:o.height,b=B();let u=le({top:i,height:D},b,ge(),de,me);A=u.tStart,k=u.tEnd,ue&&process.env.NODE_ENV!=="production"&&(R?.remove(),R=ke(A,k,d))}function he(){T.forEach((o,i)=>{o.style.strokeDasharray=`${h[i]}`,o.style.strokeDashoffset=y==="reverse"?"0":`${h[i]}`,l?o.style.opacity=y==="reverse"?"1":"0":o.style.opacity="",x&&(o.style.stroke=x),g!==null&&(o.style.strokeWidth=`${g}`)})}if(T.forEach(o=>{Ae(o);let i=K(o);h.push(i),r?(o.style.strokeDasharray=`${i}`,o.style.strokeDashoffset=y==="reverse"?`${i}`:"0",l&&(o.style.opacity="1"),E&&(o.style.stroke=E),S!==null&&(o.style.strokeWidth=`${S}`)):(o.style.strokeDasharray=`${i}`,o.style.strokeDashoffset=y==="reverse"?"0":`${i}`,l?o.style.opacity=y==="reverse"?"1":"0":o.style.opacity="",x&&(o.style.stroke=x),g!==null&&(o.style.strokeWidth=`${g}`))}),r)return ee?.(),{destroy:()=>{},replay:()=>{}};re();function ne(){if(!P)return;let o=B(),i=Y?F===-1||o>=F?"forward":"reverse":y;F=o;let D=k-A,b=!0;if(T.forEach((u,f)=>{let $=f*I*D,p=te(z(o,A+$,k+$,s));U&&!Y&&(C=Math.max(C,p),p=C),u.style.strokeDashoffset=i==="reverse"?`${h[f]*p}`:`${h[f]*(1-p)}`,l&&(u.style.opacity=i==="reverse"?`${1-p}`:`${p}`),x&&E?u.style.stroke=ae(x,E,p):E&&(u.style.stroke=E),g!==null&&S!==null?u.style.strokeWidth=`${g+(S-g)*p}`:S!==null&&(u.style.strokeWidth=`${S}`),f===0&&fe?.(p),p<1&&(b=!1)}),V){let u=te(z(o,A,k,s));for(let f in V){let $=parseFloat(f);u>=$&&!q.has($)&&(q.add($),V[f]?.())}}!N&&z(o,A,k,s)>0&&(N=!0,pe?.()),b&&!L?(L=!0,ee?.()):!b&&!U&&(L=!1),M=requestAnimationFrame(ne)}let H=new IntersectionObserver(o=>{o.forEach(i=>{P=i.isIntersecting,P?M=requestAnimationFrame(ne):cancelAnimationFrame(M)})},{root:c??null}),X;function O(){clearTimeout(X),X=setTimeout(()=>{T.forEach((o,i)=>{h[i]=K(o),o.style.strokeDasharray=`${h[i]}`}),re()},150)}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),Z>0?setTimeout(()=>H.observe(e),Z):H.observe(e),{destroy(){cancelAnimationFrame(M),H.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(X),R?.remove()},replay(){C=-1,F=-1,N=!1,L=!1,q.clear(),he()}}}function $e(e,t){let r={destroy:()=>{},replay:()=>{}};if(typeof window>"u")return r;let n=typeof e=="string"?document.querySelector(e):e;return n?W(n,t):(console.warn("[svg-scroll-draw] Container not found:",e),r)}var Q=class extends HTMLElement{constructor(){super(...arguments);this.instance=null}connectedCallback(){let r={},n=this.getAttribute("speed"),s=this.getAttribute("easing"),l=this.getAttribute("stagger"),a=this.getAttribute("direction"),m=this.getAttribute("selector");n&&(r.speed=parseFloat(n)),s&&(r.easing=s),l&&(r.stagger=parseFloat(l)),a&&(r.direction=a),m&&(r.selector=m),this.hasAttribute("fade")&&(r.fade=this.getAttribute("fade")!=="false"),this.instance=W(this,r)}disconnectedCallback(){this.instance?.destroy(),this.instance=null}};typeof customElements<"u"&&!customElements.get("scroll-draw")&&customElements.define("scroll-draw",Q);return Ee(De);})();

package/dist/index.cjs

@@ -1 +1,3 @@
-'use strict';var v={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let r=t.split(/\s+/).filter(Boolean),[s="top",i="bottom"]=r;return {element:s,viewport:i}}function k(e,t,r,s){switch(s){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function F(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),s=parseFloat(e.getAttribute("height")??"0");return 2*(r+s)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function M(e,t,r){return Math.min(r,Math.max(t,e))}function L(e,t,r,s){return r===t?0:M((e-t)/(r-t)*s,0,1)}function G(e,t,r,s,i){let c=k(e.top,e.height,t,s.element)-F(s.viewport,r),u=k(e.top,e.height,t,i.element)-F(i.viewport,r);return {tStart:c,tEnd:u}}function O(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function B(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?O("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&O("Element has a fill \u2014 it may obscure the stroke animation.",e);}function V(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:r="path, polyline, line, polygon, rect, circle",speed:s=1,fade:i=false,easing:c="linear",trigger:u={},stagger:C=0,direction:m="forward",onProgress:N,onComplete:q}=t,z=typeof c=="function"?c:v[c]??v.linear,P=S(u.start??"top bottom"),R=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(r)),l=[],w=0,b=0,h=false,p=0,y=false;function A(){let n=e.getBoundingClientRect(),o=G({top:n.top,height:n.height},window.scrollY,window.innerHeight,P,R);w=o.tStart,b=o.tEnd;}d.forEach(n=>{B(n);let o=D(n);l.push(o),n.style.strokeDasharray=`${o}`,n.style.strokeDashoffset=m==="reverse"?"0":`${o}`,i&&(n.style.opacity=m==="reverse"?"1":"0");}),A();function x(){if(!y)return;let n=b-w,o=true;d.forEach((I,g)=>{let $=g*C*n,a=z(L(window.scrollY,w+$,b+$,s));I.style.strokeDashoffset=m==="reverse"?`${l[g]*a}`:`${l[g]*(1-a)}`,i&&(I.style.opacity=m==="reverse"?`${1-a}`:`${a}`),g===0&&N?.(a),a<1&&(o=false);}),o&&!h?(h=true,q?.()):o||(h=false),p=requestAnimationFrame(x);}let T=new IntersectionObserver(n=>{n.forEach(o=>{y=o.isIntersecting,y?p=requestAnimationFrame(x):cancelAnimationFrame(p);});});T.observe(e);let E;function f(){clearTimeout(E),E=setTimeout(()=>{d.forEach((n,o)=>{l[o]=D(n),n.style.strokeDasharray=`${l[o]}`;}),A();},150);}return window.addEventListener("resize",f),window.addEventListener("orientationchange",f),{destroy(){cancelAnimationFrame(p),T.disconnect(),window.removeEventListener("resize",f),window.removeEventListener("orientationchange",f),clearTimeout(E);}}}function Q(e,t){if(typeof window>"u")return {destroy:()=>{}};let r=typeof e=="string"?document.querySelector(e):e;return r?V(r,t):(console.warn("[svg-scroll-draw] Container not found:",e),{destroy:()=>{}})}exports.scrollDraw=Q;
+'use strict';var _={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function H(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function te(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function ye(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:ye((e-t)/(r-t)*o,0,1)}function oe(e,t,r,o,i){let f=te(e.top,e.height,t,o.element)-re(o.viewport,r),d=te(e.top,e.height,t,i.element)-re(i.viewport,r);return {tStart:f,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,r){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function be(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ge(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,A=t-f,I=r==="x";o.innerHTML=`
+      <div style="position:absolute;${I?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${I?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:A={},stagger:I=0,direction:g="forward",once:J=false,debug:ae=false,axis:p="y",scrollContainer:W,autoReverse:K=false,delay:Q=0,strokeColor:h,strokeWidth:w,waypoints:G,onProgress:ce,onStart:ue,onComplete:U}=t,Y=typeof d=="function"?d:_[d]??_.linear,fe=H(A.start??"top bottom"),pe=H(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,T=Array.from(e.querySelectorAll(o)),y=[],$=0,S=0,L=false,V=false,M=0,N=false,C=-1,F=-1,P=null,R=new Set;function q(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function Z(){let n=e.getBoundingClientRect(),s,D,b;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,D=p==="x"?n.width:n.height,b=q();}else s=p==="x"?n.left:n.top,D=p==="x"?n.width:n.height,b=q();let a=oe({top:s,height:D},b,de(),fe,pe);$=a.tStart,S=a.tEnd,ae&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=ge($,S,p));}function me(){T.forEach((n,s)=>{n.style.strokeDasharray=`${y[s]}`,n.style.strokeDashoffset=g==="reverse"?"0":`${y[s]}`,f?n.style.opacity=g==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(T.forEach(n=>{be(n);let s=j(n);y.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=g==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=g==="reverse"?"0":`${s}`,f?n.style.opacity=g==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return U?.(),{destroy:()=>{},replay:()=>{}};Z();function ee(){if(!N)return;let n=q(),s=K?F===-1||n>=F?"forward":"reverse":g;F=n;let D=S-$,b=true;if(T.forEach((a,c)=>{let k=c*I*D,u=Y(z(n,$+k,S+k,i));J&&!K&&(C=Math.max(C,u),u=C),a.style.strokeDashoffset=s==="reverse"?`${y[c]*u}`:`${y[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=se(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ce?.(u),u<1&&(b=false);}),G){let a=Y(z(n,$,S,i));for(let c in G){let k=parseFloat(c);a>=k&&!R.has(k)&&(R.add(k),G[c]?.());}}!V&&z(n,$,S,i)>0&&(V=true,ue?.()),b&&!L?(L=true,U?.()):!b&&!J&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(n=>{n.forEach(s=>{N=s.isIntersecting,N?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:l??null}),X;function O(){clearTimeout(X),X=setTimeout(()=>{T.forEach((n,s)=>{y[s]=j(n),n.style.strokeDasharray=`${y[s]}`;}),Z();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),Q>0?setTimeout(()=>B.observe(e),Q):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(X),P?.remove();},replay(){C=-1,F=-1,V=false,L=false,R.clear(),me();}}}function Ee(e,t){let r={destroy:()=>{},replay:()=>{}};if(typeof window>"u")return r;let o=typeof e=="string"?document.querySelector(e):e;return o?le(o,t):(console.warn("[svg-scroll-draw] Container not found:",e),r)}exports.scrollDraw=Ee;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -9,16 +9,32 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 interface ScrollDrawInstance {
     destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
 }
 
 declare function scrollDraw(target: string | Element, options?: ScrollDrawOptions): ScrollDrawInstance;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -9,16 +9,32 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 interface ScrollDrawInstance {
     destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
 }
 
 declare function scrollDraw(target: string | Element, options?: ScrollDrawOptions): ScrollDrawInstance;

package/dist/index.mjs

@@ -1 +1,3 @@
-var v={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let r=t.split(/\s+/).filter(Boolean),[s="top",i="bottom"]=r;return {element:s,viewport:i}}function k(e,t,r,s){switch(s){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function F(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),s=parseFloat(e.getAttribute("height")??"0");return 2*(r+s)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function M(e,t,r){return Math.min(r,Math.max(t,e))}function L(e,t,r,s){return r===t?0:M((e-t)/(r-t)*s,0,1)}function G(e,t,r,s,i){let c=k(e.top,e.height,t,s.element)-F(s.viewport,r),u=k(e.top,e.height,t,i.element)-F(i.viewport,r);return {tStart:c,tEnd:u}}function O(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function B(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?O("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&O("Element has a fill \u2014 it may obscure the stroke animation.",e);}function V(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:r="path, polyline, line, polygon, rect, circle",speed:s=1,fade:i=false,easing:c="linear",trigger:u={},stagger:C=0,direction:m="forward",onProgress:N,onComplete:q}=t,z=typeof c=="function"?c:v[c]??v.linear,P=S(u.start??"top bottom"),R=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(r)),l=[],w=0,b=0,h=false,p=0,y=false;function A(){let n=e.getBoundingClientRect(),o=G({top:n.top,height:n.height},window.scrollY,window.innerHeight,P,R);w=o.tStart,b=o.tEnd;}d.forEach(n=>{B(n);let o=D(n);l.push(o),n.style.strokeDasharray=`${o}`,n.style.strokeDashoffset=m==="reverse"?"0":`${o}`,i&&(n.style.opacity=m==="reverse"?"1":"0");}),A();function x(){if(!y)return;let n=b-w,o=true;d.forEach((I,g)=>{let $=g*C*n,a=z(L(window.scrollY,w+$,b+$,s));I.style.strokeDashoffset=m==="reverse"?`${l[g]*a}`:`${l[g]*(1-a)}`,i&&(I.style.opacity=m==="reverse"?`${1-a}`:`${a}`),g===0&&N?.(a),a<1&&(o=false);}),o&&!h?(h=true,q?.()):o||(h=false),p=requestAnimationFrame(x);}let T=new IntersectionObserver(n=>{n.forEach(o=>{y=o.isIntersecting,y?p=requestAnimationFrame(x):cancelAnimationFrame(p);});});T.observe(e);let E;function f(){clearTimeout(E),E=setTimeout(()=>{d.forEach((n,o)=>{l[o]=D(n),n.style.strokeDasharray=`${l[o]}`;}),A();},150);}return window.addEventListener("resize",f),window.addEventListener("orientationchange",f),{destroy(){cancelAnimationFrame(p),T.disconnect(),window.removeEventListener("resize",f),window.removeEventListener("orientationchange",f),clearTimeout(E);}}}function Q(e,t){if(typeof window>"u")return {destroy:()=>{}};let r=typeof e=="string"?document.querySelector(e):e;return r?V(r,t):(console.warn("[svg-scroll-draw] Container not found:",e),{destroy:()=>{}})}export{Q as scrollDraw};
+var _={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function H(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function te(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function ye(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:ye((e-t)/(r-t)*o,0,1)}function oe(e,t,r,o,i){let f=te(e.top,e.height,t,o.element)-re(o.viewport,r),d=te(e.top,e.height,t,i.element)-re(i.viewport,r);return {tStart:f,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,r){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function be(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ge(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,A=t-f,I=r==="x";o.innerHTML=`
+      <div style="position:absolute;${I?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${I?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:A={},stagger:I=0,direction:g="forward",once:J=false,debug:ae=false,axis:p="y",scrollContainer:W,autoReverse:K=false,delay:Q=0,strokeColor:h,strokeWidth:w,waypoints:G,onProgress:ce,onStart:ue,onComplete:U}=t,Y=typeof d=="function"?d:_[d]??_.linear,fe=H(A.start??"top bottom"),pe=H(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,T=Array.from(e.querySelectorAll(o)),y=[],$=0,S=0,L=false,V=false,M=0,N=false,C=-1,F=-1,P=null,R=new Set;function q(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function Z(){let n=e.getBoundingClientRect(),s,D,b;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,D=p==="x"?n.width:n.height,b=q();}else s=p==="x"?n.left:n.top,D=p==="x"?n.width:n.height,b=q();let a=oe({top:s,height:D},b,de(),fe,pe);$=a.tStart,S=a.tEnd,ae&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=ge($,S,p));}function me(){T.forEach((n,s)=>{n.style.strokeDasharray=`${y[s]}`,n.style.strokeDashoffset=g==="reverse"?"0":`${y[s]}`,f?n.style.opacity=g==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(T.forEach(n=>{be(n);let s=j(n);y.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=g==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=g==="reverse"?"0":`${s}`,f?n.style.opacity=g==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return U?.(),{destroy:()=>{},replay:()=>{}};Z();function ee(){if(!N)return;let n=q(),s=K?F===-1||n>=F?"forward":"reverse":g;F=n;let D=S-$,b=true;if(T.forEach((a,c)=>{let k=c*I*D,u=Y(z(n,$+k,S+k,i));J&&!K&&(C=Math.max(C,u),u=C),a.style.strokeDashoffset=s==="reverse"?`${y[c]*u}`:`${y[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=se(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ce?.(u),u<1&&(b=false);}),G){let a=Y(z(n,$,S,i));for(let c in G){let k=parseFloat(c);a>=k&&!R.has(k)&&(R.add(k),G[c]?.());}}!V&&z(n,$,S,i)>0&&(V=true,ue?.()),b&&!L?(L=true,U?.()):!b&&!J&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(n=>{n.forEach(s=>{N=s.isIntersecting,N?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:l??null}),X;function O(){clearTimeout(X),X=setTimeout(()=>{T.forEach((n,s)=>{y[s]=j(n),n.style.strokeDasharray=`${y[s]}`;}),Z();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),Q>0?setTimeout(()=>B.observe(e),Q):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(X),P?.remove();},replay(){C=-1,F=-1,V=false,L=false,R.clear(),me();}}}function Ee(e,t){let r={destroy:()=>{},replay:()=>{}};if(typeof window>"u")return r;let o=typeof e=="string"?document.querySelector(e):e;return o?le(o,t):(console.warn("[svg-scroll-draw] Container not found:",e),r)}export{Ee as scrollDraw};

package/dist/react/index.cjs

@@ -1 +1,3 @@
-'use strict';var react=require('react'),jsxRuntime=require('react/jsx-runtime');var v={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let r=t.split(/\s+/).filter(Boolean),[s="top",i="bottom"]=r;return {element:s,viewport:i}}function F(e,t,r,s){switch(s){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function L(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),s=parseFloat(e.getAttribute("height")??"0");return 2*(r+s)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function q(e,t,r){return Math.min(r,Math.max(t,e))}function R(e,t,r,s){return r===t?0:q((e-t)/(r-t)*s,0,1)}function I(e,t,r,s,i){let a=F(e.top,e.height,t,s.element)-L(s.viewport,r),u=F(e.top,e.height,t,i.element)-L(i.viewport,r);return {tStart:a,tEnd:u}}function N(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function B(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?N("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&N("Element has a fill \u2014 it may obscure the stroke animation.",e);}function G(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:r="path, polyline, line, polygon, rect, circle",speed:s=1,fade:i=false,easing:a="linear",trigger:u={},stagger:P=0,direction:m="forward",onProgress:O,onComplete:V}=t,C=typeof a=="function"?a:v[a]??v.linear,z=S(u.start??"top bottom"),M=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(r)),l=[],w=0,b=0,h=false,p=0,y=false;function A(){let n=e.getBoundingClientRect(),o=I({top:n.top,height:n.height},window.scrollY,window.innerHeight,z,M);w=o.tStart,b=o.tEnd;}d.forEach(n=>{B(n);let o=D(n);l.push(o),n.style.strokeDasharray=`${o}`,n.style.strokeDashoffset=m==="reverse"?"0":`${o}`,i&&(n.style.opacity=m==="reverse"?"1":"0");}),A();function T(){if(!y)return;let n=b-w,o=true;d.forEach(($,g)=>{let k=g*P*n,c=C(R(window.scrollY,w+k,b+k,s));$.style.strokeDashoffset=m==="reverse"?`${l[g]*c}`:`${l[g]*(1-c)}`,i&&($.style.opacity=m==="reverse"?`${1-c}`:`${c}`),g===0&&O?.(c),c<1&&(o=false);}),o&&!h?(h=true,V?.()):o||(h=false),p=requestAnimationFrame(T);}let x=new IntersectionObserver(n=>{n.forEach(o=>{y=o.isIntersecting,y?p=requestAnimationFrame(T):cancelAnimationFrame(p);});});x.observe(e);let E;function f(){clearTimeout(E),E=setTimeout(()=>{d.forEach((n,o)=>{l[o]=D(n),n.style.strokeDasharray=`${l[o]}`;}),A();},150);}return window.addEventListener("resize",f),window.addEventListener("orientationchange",f),{destroy(){cancelAnimationFrame(p),x.disconnect(),window.removeEventListener("resize",f),window.removeEventListener("orientationchange",f),clearTimeout(E);}}}function j({children:e,className:t,style:r,...s}){let i=react.useRef(null);return react.useEffect(()=>{if(!i.current)return;let a=G(i.current,s);return ()=>a.destroy()},[]),jsxRuntime.jsx("div",{ref:i,className:t,style:r,children:e})}exports.ScrollDraw=j;
+'use strict';var react=require('react'),jsxRuntime=require('react/jsx-runtime');var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:o}}function te(e,t,n,o){switch(o){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function J(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(n+o)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function ye(e,t,n){return Math.min(n,Math.max(t,e))}function N(e,t,n,o){return n===t?0:ye((e-t)/(n-t)*o,0,1)}function oe(e,t,n,o,i){let l=te(e.top,e.height,t,o.element)-re(o.viewport,n),d=te(e.top,e.height,t,i.element)-re(i.viewport,n);return {tStart:l,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,n){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*n)},${Math.round(o[1]+(i[1]-o[1])*n)},${Math.round(o[2]+(i[2]-o[2])*n)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function ge(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function be(e,t,n){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let l=n==="x"?window.scrollX:window.scrollY,d=e-l,A=t-l,T=n==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:l=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:K=false,debug:ae=false,axis:p="y",scrollContainer:P,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:z,onProgress:ce,onStart:ue,onComplete:Y}=t,Z=typeof d=="function"?d:X[d]??X.linear,fe=_(A.start??"top bottom"),pe=_(A.end??"bottom top"),a=typeof P=="string"?document.querySelector(P):P??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),y=[],$=0,k=0,L=false,O=false,M=0,W=false,C=-1,F=-1,G=null,V=new Set;function q(){return a?p==="x"?a.scrollLeft:a.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return a?p==="x"?a.clientWidth:a.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function j(){let r=e.getBoundingClientRect(),s,D,g;if(a){let u=a.getBoundingClientRect();s=p==="x"?r.left-u.left+a.scrollLeft:r.top-u.top+a.scrollTop,D=p==="x"?r.width:r.height,g=q();}else s=p==="x"?r.left:r.top,D=p==="x"?r.width:r.height,g=q();let c=oe({top:s,height:D},g,de(),fe,pe);$=c.tStart,k=c.tEnd,ae&&process.env.NODE_ENV!=="production"&&(G?.remove(),G=be($,k,p));}function me(){I.forEach((r,s)=>{r.style.strokeDasharray=`${y[s]}`,r.style.strokeDashoffset=b==="reverse"?"0":`${y[s]}`,l?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`);});}if(I.forEach(r=>{ge(r);let s=J(r);y.push(s),n?(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?`${s}`:"0",l&&(r.style.opacity="1"),x&&(r.style.stroke=x),E!==null&&(r.style.strokeWidth=`${E}`)):(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?"0":`${s}`,l?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`));}),n)return Y?.(),{destroy:()=>{},replay:()=>{}};j();function ee(){if(!W)return;let r=q(),s=Q?F===-1||r>=F?"forward":"reverse":b;F=r;let D=k-$,g=true;if(I.forEach((c,u)=>{let S=u*T*D,f=Z(N(r,$+S,k+S,i));K&&!Q&&(C=Math.max(C,f),f=C),c.style.strokeDashoffset=s==="reverse"?`${y[u]*f}`:`${y[u]*(1-f)}`,l&&(c.style.opacity=s==="reverse"?`${1-f}`:`${f}`),v&&x?c.style.stroke=se(v,x,f):x&&(c.style.stroke=x),m!==null&&E!==null?c.style.strokeWidth=`${m+(E-m)*f}`:E!==null&&(c.style.strokeWidth=`${E}`),u===0&&ce?.(f),f<1&&(g=false);}),z){let c=Z(N(r,$,k,i));for(let u in z){let S=parseFloat(u);c>=S&&!V.has(S)&&(V.add(S),z[u]?.());}}!O&&N(r,$,k,i)>0&&(O=true,ue?.()),g&&!L?(L=true,Y?.()):!g&&!K&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(r=>{r.forEach(s=>{W=s.isIntersecting,W?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:a??null}),H;function R(){clearTimeout(H),H=setTimeout(()=>{I.forEach((r,s)=>{y[s]=J(r),r.style.strokeDasharray=`${y[s]}`;}),j();},150);}return window.addEventListener("resize",R),window.addEventListener("orientationchange",R),U>0?setTimeout(()=>B.observe(e),U):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",R),window.removeEventListener("orientationchange",R),clearTimeout(H),G?.remove();},replay(){C=-1,F=-1,O=false,L=false,V.clear(),me();}}}function De({children:e,className:t,style:n,...o}){let i=react.useRef(null);return react.useEffect(()=>{if(!i.current)return;let l=le(i.current,o);return ()=>l.destroy()},[]),jsxRuntime.jsx("div",{ref:i,className:t,style:n,children:e})}exports.ScrollDraw=De;

package/dist/react/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -12,12 +12,26 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -12,12 +12,26 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 

package/dist/react/index.mjs

@@ -1 +1,3 @@
-import {useRef,useEffect}from'react';import {jsx}from'react/jsx-runtime';var v={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let r=t.split(/\s+/).filter(Boolean),[s="top",i="bottom"]=r;return {element:s,viewport:i}}function F(e,t,r,s){switch(s){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function L(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),s=parseFloat(e.getAttribute("height")??"0");return 2*(r+s)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function q(e,t,r){return Math.min(r,Math.max(t,e))}function R(e,t,r,s){return r===t?0:q((e-t)/(r-t)*s,0,1)}function I(e,t,r,s,i){let a=F(e.top,e.height,t,s.element)-L(s.viewport,r),u=F(e.top,e.height,t,i.element)-L(i.viewport,r);return {tStart:a,tEnd:u}}function N(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function B(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?N("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&N("Element has a fill \u2014 it may obscure the stroke animation.",e);}function G(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:r="path, polyline, line, polygon, rect, circle",speed:s=1,fade:i=false,easing:a="linear",trigger:u={},stagger:P=0,direction:m="forward",onProgress:O,onComplete:V}=t,C=typeof a=="function"?a:v[a]??v.linear,z=S(u.start??"top bottom"),M=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(r)),l=[],w=0,b=0,h=false,p=0,y=false;function A(){let n=e.getBoundingClientRect(),o=I({top:n.top,height:n.height},window.scrollY,window.innerHeight,z,M);w=o.tStart,b=o.tEnd;}d.forEach(n=>{B(n);let o=D(n);l.push(o),n.style.strokeDasharray=`${o}`,n.style.strokeDashoffset=m==="reverse"?"0":`${o}`,i&&(n.style.opacity=m==="reverse"?"1":"0");}),A();function T(){if(!y)return;let n=b-w,o=true;d.forEach(($,g)=>{let k=g*P*n,c=C(R(window.scrollY,w+k,b+k,s));$.style.strokeDashoffset=m==="reverse"?`${l[g]*c}`:`${l[g]*(1-c)}`,i&&($.style.opacity=m==="reverse"?`${1-c}`:`${c}`),g===0&&O?.(c),c<1&&(o=false);}),o&&!h?(h=true,V?.()):o||(h=false),p=requestAnimationFrame(T);}let x=new IntersectionObserver(n=>{n.forEach(o=>{y=o.isIntersecting,y?p=requestAnimationFrame(T):cancelAnimationFrame(p);});});x.observe(e);let E;function f(){clearTimeout(E),E=setTimeout(()=>{d.forEach((n,o)=>{l[o]=D(n),n.style.strokeDasharray=`${l[o]}`;}),A();},150);}return window.addEventListener("resize",f),window.addEventListener("orientationchange",f),{destroy(){cancelAnimationFrame(p),x.disconnect(),window.removeEventListener("resize",f),window.removeEventListener("orientationchange",f),clearTimeout(E);}}}function j({children:e,className:t,style:r,...s}){let i=useRef(null);return useEffect(()=>{if(!i.current)return;let a=G(i.current,s);return ()=>a.destroy()},[]),jsx("div",{ref:i,className:t,style:r,children:e})}export{j as ScrollDraw};
+import {useRef,useEffect}from'react';import {jsx}from'react/jsx-runtime';var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:o}}function te(e,t,n,o){switch(o){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function re(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function J(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(n+o)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function ye(e,t,n){return Math.min(n,Math.max(t,e))}function N(e,t,n,o){return n===t?0:ye((e-t)/(n-t)*o,0,1)}function oe(e,t,n,o,i){let l=te(e.top,e.height,t,o.element)-re(o.viewport,n),d=te(e.top,e.height,t,i.element)-re(i.viewport,n);return {tStart:l,tEnd:d}}function ne(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function se(e,t,n){let o=ne(e),i=ne(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*n)},${Math.round(o[1]+(i[1]-o[1])*n)},${Math.round(o[2]+(i[2]-o[2])*n)})`}function ie(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function ge(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?ie("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&ie("Element has a fill \u2014 it may obscure the stroke animation.",e);}function be(e,t,n){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let l=n==="x"?window.scrollX:window.scrollY,d=e-l,A=t-l,T=n==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function le(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:l=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:K=false,debug:ae=false,axis:p="y",scrollContainer:P,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:z,onProgress:ce,onStart:ue,onComplete:Y}=t,Z=typeof d=="function"?d:X[d]??X.linear,fe=_(A.start??"top bottom"),pe=_(A.end??"bottom top"),a=typeof P=="string"?document.querySelector(P):P??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),y=[],$=0,k=0,L=false,O=false,M=0,W=false,C=-1,F=-1,G=null,V=new Set;function q(){return a?p==="x"?a.scrollLeft:a.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return a?p==="x"?a.clientWidth:a.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function j(){let r=e.getBoundingClientRect(),s,D,g;if(a){let u=a.getBoundingClientRect();s=p==="x"?r.left-u.left+a.scrollLeft:r.top-u.top+a.scrollTop,D=p==="x"?r.width:r.height,g=q();}else s=p==="x"?r.left:r.top,D=p==="x"?r.width:r.height,g=q();let c=oe({top:s,height:D},g,de(),fe,pe);$=c.tStart,k=c.tEnd,ae&&process.env.NODE_ENV!=="production"&&(G?.remove(),G=be($,k,p));}function me(){I.forEach((r,s)=>{r.style.strokeDasharray=`${y[s]}`,r.style.strokeDashoffset=b==="reverse"?"0":`${y[s]}`,l?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`);});}if(I.forEach(r=>{ge(r);let s=J(r);y.push(s),n?(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?`${s}`:"0",l&&(r.style.opacity="1"),x&&(r.style.stroke=x),E!==null&&(r.style.strokeWidth=`${E}`)):(r.style.strokeDasharray=`${s}`,r.style.strokeDashoffset=b==="reverse"?"0":`${s}`,l?r.style.opacity=b==="reverse"?"1":"0":r.style.opacity="",v&&(r.style.stroke=v),m!==null&&(r.style.strokeWidth=`${m}`));}),n)return Y?.(),{destroy:()=>{},replay:()=>{}};j();function ee(){if(!W)return;let r=q(),s=Q?F===-1||r>=F?"forward":"reverse":b;F=r;let D=k-$,g=true;if(I.forEach((c,u)=>{let S=u*T*D,f=Z(N(r,$+S,k+S,i));K&&!Q&&(C=Math.max(C,f),f=C),c.style.strokeDashoffset=s==="reverse"?`${y[u]*f}`:`${y[u]*(1-f)}`,l&&(c.style.opacity=s==="reverse"?`${1-f}`:`${f}`),v&&x?c.style.stroke=se(v,x,f):x&&(c.style.stroke=x),m!==null&&E!==null?c.style.strokeWidth=`${m+(E-m)*f}`:E!==null&&(c.style.strokeWidth=`${E}`),u===0&&ce?.(f),f<1&&(g=false);}),z){let c=Z(N(r,$,k,i));for(let u in z){let S=parseFloat(u);c>=S&&!V.has(S)&&(V.add(S),z[u]?.());}}!O&&N(r,$,k,i)>0&&(O=true,ue?.()),g&&!L?(L=true,Y?.()):!g&&!K&&(L=false),M=requestAnimationFrame(ee);}let B=new IntersectionObserver(r=>{r.forEach(s=>{W=s.isIntersecting,W?M=requestAnimationFrame(ee):cancelAnimationFrame(M);});},{root:a??null}),H;function R(){clearTimeout(H),H=setTimeout(()=>{I.forEach((r,s)=>{y[s]=J(r),r.style.strokeDasharray=`${y[s]}`;}),j();},150);}return window.addEventListener("resize",R),window.addEventListener("orientationchange",R),U>0?setTimeout(()=>B.observe(e),U):B.observe(e),{destroy(){cancelAnimationFrame(M),B.disconnect(),window.removeEventListener("resize",R),window.removeEventListener("orientationchange",R),clearTimeout(H),G?.remove();},replay(){C=-1,F=-1,O=false,L=false,V.clear(),me();}}}function De({children:e,className:t,style:n,...o}){let i=useRef(null);return useEffect(()=>{if(!i.current)return;let l=le(i.current,o);return ()=>l.destroy()},[]),jsx("div",{ref:i,className:t,style:n,children:e})}export{De as ScrollDraw};

package/dist/solid/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var solidJs=require('solid-js');var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function re(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function be(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:be((e-t)/(r-t)*o,0,1)}function se(e,t,r,o,i){let f=re(e.top,e.height,t,o.element)-ne(o.viewport,r),d=re(e.top,e.height,t,i.element)-ne(i.viewport,r);return {tStart:f,tEnd:d}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function ie(e,t,r){let o=oe(e),i=oe(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function he(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function we(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,A=t-f,T=r==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function J(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:K=false,debug:ue=false,axis:p="y",scrollContainer:W,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:G,onProgress:fe,onStart:pe,onComplete:Y}=t,Z=typeof d=="function"?d:X[d]??X.linear,de=_(A.start??"top bottom"),me=_(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),g=[],S=0,$=0,M=false,V=false,L=0,N=false,C=-1,F=-1,P=null,R=new Set;function H(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function ge(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function ee(){let n=e.getBoundingClientRect(),s,D,y;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,D=p==="x"?n.width:n.height,y=H();}else s=p==="x"?n.left:n.top,D=p==="x"?n.width:n.height,y=H();let a=se({top:s,height:D},y,ge(),de,me);S=a.tStart,$=a.tEnd,ue&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=we(S,$,p));}function ye(){I.forEach((n,s)=>{n.style.strokeDasharray=`${g[s]}`,n.style.strokeDashoffset=b==="reverse"?"0":`${g[s]}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(I.forEach(n=>{he(n);let s=j(n);g.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!N)return;let n=H(),s=Q?F===-1||n>=F?"forward":"reverse":b;F=n;let D=$-S,y=true;if(I.forEach((a,c)=>{let k=c*T*D,u=Z(z(n,S+k,$+k,i));K&&!Q&&(C=Math.max(C,u),u=C),a.style.strokeDashoffset=s==="reverse"?`${g[c]*u}`:`${g[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&fe?.(u),u<1&&(y=false);}),G){let a=Z(z(n,S,$,i));for(let c in G){let k=parseFloat(c);a>=k&&!R.has(k)&&(R.add(k),G[c]?.());}}!V&&z(n,S,$,i)>0&&(V=true,pe?.()),y&&!M?(M=true,Y?.()):!y&&!K&&(M=false),L=requestAnimationFrame(te);}let q=new IntersectionObserver(n=>{n.forEach(s=>{N=s.isIntersecting,N?L=requestAnimationFrame(te):cancelAnimationFrame(L);});},{root:l??null}),B;function O(){clearTimeout(B),B=setTimeout(()=>{I.forEach((n,s)=>{g[s]=j(n),n.style.strokeDasharray=`${g[s]}`;}),ee();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),U>0?setTimeout(()=>q.observe(e),U):q.observe(e),{destroy(){cancelAnimationFrame(L),q.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(B),P?.remove();},replay(){C=-1,F=-1,V=false,M=false,R.clear(),ye();}}}function ke(e={}){let t,r;return solidJs.onMount(()=>{t&&(r=J(t,e));}),solidJs.onCleanup(()=>{r?.destroy();}),o=>{t=o;}}function Ae(e={}){let t,r;return solidJs.onMount(()=>{t&&(r=J(t,e));}),solidJs.onCleanup(()=>{r?.destroy(),r=void 0;}),{ref:o=>{t=o;},getInstance:()=>r}}exports.createScrollDraw=Ae;exports.useScrollDraw=ke;

package/dist/solid/index.d.mts

@@ -0,0 +1,66 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * SolidJS hook — returns a ref setter to attach to any container element.
+ *
+ * @example
+ * import { useScrollDraw } from 'svg-scroll-draw/solid';
+ *
+ * function Hero() {
+ *   const ref = useScrollDraw({ easing: 'spring', fade: true });
+ *   return <div ref={ref}><svg>...</svg></div>;
+ * }
+ */
+declare function useScrollDraw(options?: ScrollDrawOptions): (node: HTMLElement) => void;
+/**
+ * Returns both the ref setter and a getter for the live instance,
+ * so you can call instance.replay() from component logic.
+ *
+ * @example
+ * const { ref, getInstance } = createScrollDraw({ easing: 'ease-out' });
+ * <div ref={ref}><svg>...</svg></div>
+ * <button onClick={() => getInstance()?.replay()}>Replay</button>
+ */
+declare function createScrollDraw(options?: ScrollDrawOptions): {
+    ref: (node: HTMLElement) => void;
+    getInstance: () => ScrollDrawInstance | undefined;
+};
+
+export { type ScrollDrawOptions, createScrollDraw, useScrollDraw };

package/dist/solid/index.d.ts

@@ -0,0 +1,66 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * SolidJS hook — returns a ref setter to attach to any container element.
+ *
+ * @example
+ * import { useScrollDraw } from 'svg-scroll-draw/solid';
+ *
+ * function Hero() {
+ *   const ref = useScrollDraw({ easing: 'spring', fade: true });
+ *   return <div ref={ref}><svg>...</svg></div>;
+ * }
+ */
+declare function useScrollDraw(options?: ScrollDrawOptions): (node: HTMLElement) => void;
+/**
+ * Returns both the ref setter and a getter for the live instance,
+ * so you can call instance.replay() from component logic.
+ *
+ * @example
+ * const { ref, getInstance } = createScrollDraw({ easing: 'ease-out' });
+ * <div ref={ref}><svg>...</svg></div>
+ * <button onClick={() => getInstance()?.replay()}>Replay</button>
+ */
+declare function createScrollDraw(options?: ScrollDrawOptions): {
+    ref: (node: HTMLElement) => void;
+    getInstance: () => ScrollDrawInstance | undefined;
+};
+
+export { type ScrollDrawOptions, createScrollDraw, useScrollDraw };

package/dist/solid/index.mjs

@@ -0,0 +1,3 @@
+import {onMount,onCleanup}from'solid-js';var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function re(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function be(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:be((e-t)/(r-t)*o,0,1)}function se(e,t,r,o,i){let f=re(e.top,e.height,t,o.element)-ne(o.viewport,r),d=re(e.top,e.height,t,i.element)-ne(i.viewport,r);return {tStart:f,tEnd:d}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function ie(e,t,r){let o=oe(e),i=oe(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function he(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function we(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,A=t-f,T=r==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${A}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${A}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function J(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:A={},stagger:T=0,direction:b="forward",once:K=false,debug:ue=false,axis:p="y",scrollContainer:W,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:G,onProgress:fe,onStart:pe,onComplete:Y}=t,Z=typeof d=="function"?d:X[d]??X.linear,de=_(A.start??"top bottom"),me=_(A.end??"bottom top"),l=typeof W=="string"?document.querySelector(W):W??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),g=[],S=0,$=0,M=false,V=false,L=0,N=false,C=-1,F=-1,P=null,R=new Set;function H(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function ge(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function ee(){let n=e.getBoundingClientRect(),s,D,y;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,D=p==="x"?n.width:n.height,y=H();}else s=p==="x"?n.left:n.top,D=p==="x"?n.width:n.height,y=H();let a=se({top:s,height:D},y,ge(),de,me);S=a.tStart,$=a.tEnd,ue&&process.env.NODE_ENV!=="production"&&(P?.remove(),P=we(S,$,p));}function ye(){I.forEach((n,s)=>{n.style.strokeDasharray=`${g[s]}`,n.style.strokeDashoffset=b==="reverse"?"0":`${g[s]}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(I.forEach(n=>{he(n);let s=j(n);g.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!N)return;let n=H(),s=Q?F===-1||n>=F?"forward":"reverse":b;F=n;let D=$-S,y=true;if(I.forEach((a,c)=>{let k=c*T*D,u=Z(z(n,S+k,$+k,i));K&&!Q&&(C=Math.max(C,u),u=C),a.style.strokeDashoffset=s==="reverse"?`${g[c]*u}`:`${g[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&fe?.(u),u<1&&(y=false);}),G){let a=Z(z(n,S,$,i));for(let c in G){let k=parseFloat(c);a>=k&&!R.has(k)&&(R.add(k),G[c]?.());}}!V&&z(n,S,$,i)>0&&(V=true,pe?.()),y&&!M?(M=true,Y?.()):!y&&!K&&(M=false),L=requestAnimationFrame(te);}let q=new IntersectionObserver(n=>{n.forEach(s=>{N=s.isIntersecting,N?L=requestAnimationFrame(te):cancelAnimationFrame(L);});},{root:l??null}),B;function O(){clearTimeout(B),B=setTimeout(()=>{I.forEach((n,s)=>{g[s]=j(n),n.style.strokeDasharray=`${g[s]}`;}),ee();},150);}return window.addEventListener("resize",O),window.addEventListener("orientationchange",O),U>0?setTimeout(()=>q.observe(e),U):q.observe(e),{destroy(){cancelAnimationFrame(L),q.disconnect(),window.removeEventListener("resize",O),window.removeEventListener("orientationchange",O),clearTimeout(B),P?.remove();},replay(){C=-1,F=-1,V=false,M=false,R.clear(),ye();}}}function ke(e={}){let t,r;return onMount(()=>{t&&(r=J(t,e));}),onCleanup(()=>{r?.destroy();}),o=>{t=o;}}function Ae(e={}){let t,r;return onMount(()=>{t&&(r=J(t,e));}),onCleanup(()=>{r?.destroy(),r=void 0;}),{ref:o=>{t=o;},getInstance:()=>r}}export{Ae as createScrollDraw,ke as useScrollDraw};

package/dist/svelte/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var _={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function j(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function re(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function J(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function ye(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:ye((e-t)/(r-t)*o,0,1)}function se(e,t,r,o,i){let f=re(e.top,e.height,t,o.element)-ne(o.viewport,r),d=re(e.top,e.height,t,i.element)-ne(i.viewport,r);return {tStart:f,tEnd:d}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function ie(e,t,r){let o=oe(e),i=oe(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function ge(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function be(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,D=t-f,T=r==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${D}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${D}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function W(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:D={},stagger:T=0,direction:b="forward",once:K=false,debug:ae=false,axis:p="y",scrollContainer:G,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:V,onProgress:ce,onStart:ue,onComplete:Y}=t,Z=typeof d=="function"?d:_[d]??_.linear,fe=j(D.start??"top bottom"),pe=j(D.end??"bottom top"),l=typeof G=="string"?document.querySelector(G):G??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),y=[],S=0,$=0,L=false,N=false,M=0,P=false,F=-1,O=-1,R=null,q=new Set;function B(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function ee(){let n=e.getBoundingClientRect(),s,A,g;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,A=p==="x"?n.width:n.height,g=B();}else s=p==="x"?n.left:n.top,A=p==="x"?n.width:n.height,g=B();let a=se({top:s,height:A},g,de(),fe,pe);S=a.tStart,$=a.tEnd,ae&&process.env.NODE_ENV!=="production"&&(R?.remove(),R=be(S,$,p));}function me(){I.forEach((n,s)=>{n.style.strokeDasharray=`${y[s]}`,n.style.strokeDashoffset=b==="reverse"?"0":`${y[s]}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(I.forEach(n=>{ge(n);let s=J(n);y.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!P)return;let n=B(),s=Q?O===-1||n>=O?"forward":"reverse":b;O=n;let A=$-S,g=true;if(I.forEach((a,c)=>{let k=c*T*A,u=Z(z(n,S+k,$+k,i));K&&!Q&&(F=Math.max(F,u),u=F),a.style.strokeDashoffset=s==="reverse"?`${y[c]*u}`:`${y[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ce?.(u),u<1&&(g=false);}),V){let a=Z(z(n,S,$,i));for(let c in V){let k=parseFloat(c);a>=k&&!q.has(k)&&(q.add(k),V[c]?.());}}!N&&z(n,S,$,i)>0&&(N=true,ue?.()),g&&!L?(L=true,Y?.()):!g&&!K&&(L=false),M=requestAnimationFrame(te);}let H=new IntersectionObserver(n=>{n.forEach(s=>{P=s.isIntersecting,P?M=requestAnimationFrame(te):cancelAnimationFrame(M);});},{root:l??null}),X;function C(){clearTimeout(X),X=setTimeout(()=>{I.forEach((n,s)=>{y[s]=J(n),n.style.strokeDasharray=`${y[s]}`;}),ee();},150);}return window.addEventListener("resize",C),window.addEventListener("orientationchange",C),U>0?setTimeout(()=>H.observe(e),U):H.observe(e),{destroy(){cancelAnimationFrame(M),H.disconnect(),window.removeEventListener("resize",C),window.removeEventListener("orientationchange",C),clearTimeout(X),R?.remove();},replay(){F=-1,O=-1,N=false,L=false,q.clear(),me();}}}function Ee(e,t={}){let r=W(e,t);return {update(o){r.destroy(),r=W(e,o);},destroy(){r.destroy();}}}function Se(e={}){let t=null;function r(o){return t=W(o,e),{destroy(){t?.destroy(),t=null;}}}return {action:r,getInstance:()=>t}}exports.createScrollDraw=Se;exports.scrollDraw=Ee;

package/dist/svelte/index.d.mts

@@ -0,0 +1,78 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * Svelte action — apply to any container element wrapping an SVG.
+ *
+ * @example
+ * <script>
+ *   import { scrollDraw } from 'svg-scroll-draw/svelte';
+ * </script>
+ *
+ * <div use:scrollDraw={{ easing: 'ease-out', speed: 1.2, fade: true }}>
+ *   <svg>...</svg>
+ * </div>
+ */
+declare function scrollDraw(node: HTMLElement, options?: ScrollDrawOptions): {
+    update(newOptions: ScrollDrawOptions): void;
+    destroy(): void;
+};
+/**
+ * Composable helper — returns an action and the live instance so you can
+ * call `instance.replay()` from your Svelte component logic.
+ *
+ * @example
+ * <script>
+ *   import { createScrollDraw } from 'svg-scroll-draw/svelte';
+ *   const { action, getInstance } = createScrollDraw({ easing: 'spring' });
+ * </script>
+ *
+ * <div use:action>
+ *   <svg>...</svg>
+ * </div>
+ * <button on:click={() => getInstance()?.replay()}>Replay</button>
+ */
+declare function createScrollDraw(options?: ScrollDrawOptions): {
+    action: (node: HTMLElement) => {
+        destroy(): void;
+    };
+    getInstance: () => ScrollDrawInstance | null;
+};
+
+export { type ScrollDrawOptions, createScrollDraw, scrollDraw };

package/dist/svelte/index.d.ts

@@ -0,0 +1,78 @@
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
+interface TriggerConfig {
+    start?: string;
+    end?: string;
+}
+interface ScrollDrawOptions {
+    selector?: string;
+    speed?: number;
+    fade?: boolean;
+    easing?: EasingName | ((t: number) => number);
+    trigger?: TriggerConfig;
+    stagger?: number;
+    direction?: 'forward' | 'reverse';
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
+    onProgress?: (alpha: number) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+}
+interface ScrollDrawInstance {
+    destroy: () => void;
+    /** Reset and replay the animation from the beginning. */
+    replay: () => void;
+}
+
+/**
+ * Svelte action — apply to any container element wrapping an SVG.
+ *
+ * @example
+ * <script>
+ *   import { scrollDraw } from 'svg-scroll-draw/svelte';
+ * </script>
+ *
+ * <div use:scrollDraw={{ easing: 'ease-out', speed: 1.2, fade: true }}>
+ *   <svg>...</svg>
+ * </div>
+ */
+declare function scrollDraw(node: HTMLElement, options?: ScrollDrawOptions): {
+    update(newOptions: ScrollDrawOptions): void;
+    destroy(): void;
+};
+/**
+ * Composable helper — returns an action and the live instance so you can
+ * call `instance.replay()` from your Svelte component logic.
+ *
+ * @example
+ * <script>
+ *   import { createScrollDraw } from 'svg-scroll-draw/svelte';
+ *   const { action, getInstance } = createScrollDraw({ easing: 'spring' });
+ * </script>
+ *
+ * <div use:action>
+ *   <svg>...</svg>
+ * </div>
+ * <button on:click={() => getInstance()?.replay()}>Replay</button>
+ */
+declare function createScrollDraw(options?: ScrollDrawOptions): {
+    action: (node: HTMLElement) => {
+        destroy(): void;
+    };
+    getInstance: () => ScrollDrawInstance | null;
+};
+
+export { type ScrollDrawOptions, createScrollDraw, scrollDraw };

package/dist/svelte/index.mjs

@@ -0,0 +1,3 @@
+var _={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function j(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[r="top",o="bottom"]=t.split(/\s+/).filter(Boolean);return {element:r,viewport:o}}function re(e,t,r,o){switch(o){case "top":return e+r;case "center":return e+r+t/2;case "bottom":return e+r+t;default:return e+r}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function J(e){let t=e.tagName.toLowerCase();if(t==="rect"){let r=parseFloat(e.getAttribute("width")??"0"),o=parseFloat(e.getAttribute("height")??"0");return 2*(r+o)}if(t==="circle"){let r=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*r}return e.getTotalLength()}function ye(e,t,r){return Math.min(r,Math.max(t,e))}function z(e,t,r,o){return r===t?0:ye((e-t)/(r-t)*o,0,1)}function se(e,t,r,o,i){let f=re(e.top,e.height,t,o.element)-ne(o.viewport,r),d=re(e.top,e.height,t,i.element)-ne(i.viewport,r);return {tStart:f,tEnd:d}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let r=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(r)return [parseInt(r[1],16),parseInt(r[2],16),parseInt(r[3],16)];let o=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return o?[parseInt(o[1]),parseInt(o[2]),parseInt(o[3])]:null}function ie(e,t,r){let o=oe(e),i=oe(t);return !o||!i?e:`rgb(${Math.round(o[0]+(i[0]-o[0])*r)},${Math.round(o[1]+(i[1]-o[1])*r)},${Math.round(o[2]+(i[2]-o[2])*r)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function ge(e){let t=e.getAttribute("stroke"),r=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):r&&r!=="none"&&r!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function be(e,t,r){let o=document.createElement("div");o.setAttribute("data-svg-scroll-draw-debug",""),o.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=r==="x"?window.scrollX:window.scrollY,d=e-f,D=t-f,T=r==="x";o.innerHTML=`
+      <div style="position:absolute;${T?`left:${d}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${d}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${D}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${D}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(o),window.addEventListener("scroll",i,{passive:true}),i(),o}function W(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let r=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:o="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:d="linear",trigger:D={},stagger:T=0,direction:b="forward",once:K=false,debug:ae=false,axis:p="y",scrollContainer:G,autoReverse:Q=false,delay:U=0,strokeColor:h,strokeWidth:w,waypoints:V,onProgress:ce,onStart:ue,onComplete:Y}=t,Z=typeof d=="function"?d:_[d]??_.linear,fe=j(D.start??"top bottom"),pe=j(D.end??"bottom top"),l=typeof G=="string"?document.querySelector(G):G??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,m=Array.isArray(w)?w[0]:null,E=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(o)),y=[],S=0,$=0,L=false,N=false,M=0,P=false,F=-1,O=-1,R=null,q=new Set;function B(){return l?p==="x"?l.scrollLeft:l.scrollTop:p==="x"?window.scrollX:window.scrollY}function de(){return l?p==="x"?l.clientWidth:l.clientHeight:p==="x"?window.innerWidth:window.innerHeight}function ee(){let n=e.getBoundingClientRect(),s,A,g;if(l){let c=l.getBoundingClientRect();s=p==="x"?n.left-c.left+l.scrollLeft:n.top-c.top+l.scrollTop,A=p==="x"?n.width:n.height,g=B();}else s=p==="x"?n.left:n.top,A=p==="x"?n.width:n.height,g=B();let a=se({top:s,height:A},g,de(),fe,pe);S=a.tStart,$=a.tEnd,ae&&process.env.NODE_ENV!=="production"&&(R?.remove(),R=be(S,$,p));}function me(){I.forEach((n,s)=>{n.style.strokeDasharray=`${y[s]}`,n.style.strokeDashoffset=b==="reverse"?"0":`${y[s]}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`);});}if(I.forEach(n=>{ge(n);let s=J(n);y.push(s),r?(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(n.style.opacity="1"),x&&(n.style.stroke=x),E!==null&&(n.style.strokeWidth=`${E}`)):(n.style.strokeDasharray=`${s}`,n.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?n.style.opacity=b==="reverse"?"1":"0":n.style.opacity="",v&&(n.style.stroke=v),m!==null&&(n.style.strokeWidth=`${m}`));}),r)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!P)return;let n=B(),s=Q?O===-1||n>=O?"forward":"reverse":b;O=n;let A=$-S,g=true;if(I.forEach((a,c)=>{let k=c*T*A,u=Z(z(n,S+k,$+k,i));K&&!Q&&(F=Math.max(F,u),u=F),a.style.strokeDashoffset=s==="reverse"?`${y[c]*u}`:`${y[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),m!==null&&E!==null?a.style.strokeWidth=`${m+(E-m)*u}`:E!==null&&(a.style.strokeWidth=`${E}`),c===0&&ce?.(u),u<1&&(g=false);}),V){let a=Z(z(n,S,$,i));for(let c in V){let k=parseFloat(c);a>=k&&!q.has(k)&&(q.add(k),V[c]?.());}}!N&&z(n,S,$,i)>0&&(N=true,ue?.()),g&&!L?(L=true,Y?.()):!g&&!K&&(L=false),M=requestAnimationFrame(te);}let H=new IntersectionObserver(n=>{n.forEach(s=>{P=s.isIntersecting,P?M=requestAnimationFrame(te):cancelAnimationFrame(M);});},{root:l??null}),X;function C(){clearTimeout(X),X=setTimeout(()=>{I.forEach((n,s)=>{y[s]=J(n),n.style.strokeDasharray=`${y[s]}`;}),ee();},150);}return window.addEventListener("resize",C),window.addEventListener("orientationchange",C),U>0?setTimeout(()=>H.observe(e),U):H.observe(e),{destroy(){cancelAnimationFrame(M),H.disconnect(),window.removeEventListener("resize",C),window.removeEventListener("orientationchange",C),clearTimeout(X),R?.remove();},replay(){F=-1,O=-1,N=false,L=false,q.clear(),me();}}}function Ee(e,t={}){let r=W(e,t);return {update(o){r.destroy(),r=W(e,o);},destroy(){r.destroy();}}}function Se(e={}){let t=null;function r(o){return t=W(o,e),{destroy(){t?.destroy(),t=null;}}}return {action:r,getInstance:()=>t}}export{Se as createScrollDraw,Ee as scrollDraw};

package/dist/vue/index.cjs

@@ -1 +1,3 @@
-'use strict';var vue=require('vue');var E={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let n=t.split(/\s+/).filter(Boolean),[r="top",s="bottom"]=n;return {element:r,viewport:s}}function L(e,t,n,r){switch(r){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function $(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),r=parseFloat(e.getAttribute("height")??"0");return 2*(n+r)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function U(e,t,n){return Math.min(n,Math.max(t,e))}function k(e,t,n,r){return n===t?0:U((e-t)/(n-t)*r,0,1)}function P(e,t,n,r,s){let l=L(e.top,e.height,t,r.element)-$(r.viewport,n),u=L(e.top,e.height,t,s.element)-$(s.viewport,n);return {tStart:l,tEnd:u}}function I(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function _(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?I("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&I("Element has a fill \u2014 it may obscure the stroke animation.",e);}function A(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:n="path, polyline, line, polygon, rect, circle",speed:r=1,fade:s=false,easing:l="linear",trigger:u={},stagger:R=0,direction:m="forward",onProgress:V,onComplete:z}=t,q=typeof l=="function"?l:E[l]??E.linear,B=S(u.start??"top bottom"),j=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(n)),c=[],w=0,b=0,h=false,f=0,y=false;function T(){let o=e.getBoundingClientRect(),i=P({top:o.top,height:o.height},window.scrollY,window.innerHeight,B,j);w=i.tStart,b=i.tEnd;}d.forEach(o=>{_(o);let i=D(o);c.push(i),o.style.strokeDasharray=`${i}`,o.style.strokeDashoffset=m==="reverse"?"0":`${i}`,s&&(o.style.opacity=m==="reverse"?"1":"0");}),T();function x(){if(!y)return;let o=b-w,i=true;d.forEach((F,p)=>{let C=p*R*o,a=q(k(window.scrollY,w+C,b+C,r));F.style.strokeDashoffset=m==="reverse"?`${c[p]*a}`:`${c[p]*(1-a)}`,s&&(F.style.opacity=m==="reverse"?`${1-a}`:`${a}`),p===0&&V?.(a),a<1&&(i=false);}),i&&!h?(h=true,z?.()):i||(h=false),f=requestAnimationFrame(x);}let O=new IntersectionObserver(o=>{o.forEach(i=>{y=i.isIntersecting,y?f=requestAnimationFrame(x):cancelAnimationFrame(f);});});O.observe(e);let v;function g(){clearTimeout(v),v=setTimeout(()=>{d.forEach((o,i)=>{c[i]=D(o),o.style.strokeDasharray=`${c[i]}`;}),T();},150);}return window.addEventListener("resize",g),window.addEventListener("orientationchange",g),{destroy(){cancelAnimationFrame(f),O.disconnect(),window.removeEventListener("resize",g),window.removeEventListener("orientationchange",g),clearTimeout(v);}}}function H(e={}){let t=vue.ref(null);return vue.onMounted(()=>{if(!t.value)return;let n=A(t.value,e);vue.onUnmounted(()=>n.destroy());}),t}var ee=vue.defineComponent({name:"ScrollDraw",props:{selector:{type:String},speed:{type:Number},fade:{type:Boolean},stagger:{type:Number},easing:{type:[String,Function]},direction:{type:String},trigger:{type:Object},onProgress:{type:Function},onComplete:{type:Function}},setup(e,{slots:t}){let n=vue.ref(null);return vue.onMounted(()=>{if(!n.value)return;let r={};e.selector!=null&&(r.selector=e.selector),e.speed!=null&&(r.speed=e.speed),e.fade!=null&&(r.fade=e.fade),e.stagger!=null&&(r.stagger=e.stagger),e.easing!=null&&(r.easing=e.easing),e.direction!=null&&(r.direction=e.direction),e.trigger!=null&&(r.trigger=e.trigger),e.onProgress!=null&&(r.onProgress=e.onProgress),e.onComplete!=null&&(r.onComplete=e.onComplete);let s=A(n.value,r);vue.onUnmounted(()=>s.destroy());}),()=>vue.h("div",{ref:n},t.default?.())}});exports.ScrollDraw=ee;exports.useScrollDraw=H;
+'use strict';var vue=require('vue');var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",r="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:r}}function re(e,t,n,r){switch(r){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),r=parseFloat(e.getAttribute("height")??"0");return 2*(n+r)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function he(e,t,n){return Math.min(n,Math.max(t,e))}function P(e,t,n,r){return n===t?0:he((e-t)/(n-t)*r,0,1)}function se(e,t,n,r,i){let f=re(e.top,e.height,t,r.element)-ne(r.viewport,n),m=re(e.top,e.height,t,i.element)-ne(i.viewport,n);return {tStart:f,tEnd:m}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let r=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return r?[parseInt(r[1]),parseInt(r[2]),parseInt(r[3])]:null}function ie(e,t,n){let r=oe(e),i=oe(t);return !r||!i?e:`rgb(${Math.round(r[0]+(i[0]-r[0])*n)},${Math.round(r[1]+(i[1]-r[1])*n)},${Math.round(r[2]+(i[2]-r[2])*n)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function we(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ve(e,t,n){let r=document.createElement("div");r.setAttribute("data-svg-scroll-draw-debug",""),r.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=n==="x"?window.scrollX:window.scrollY,m=e-f,D=t-f,T=n==="x";r.innerHTML=`
+      <div style="position:absolute;${T?`left:${m}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${m}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${D}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${D}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(r),window.addEventListener("scroll",i,{passive:true}),i(),r}function U(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:r="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:m="linear",trigger:D={},stagger:T=0,direction:b="forward",once:J=false,debug:fe=false,axis:d="y",scrollContainer:z,autoReverse:K=false,delay:Q=0,strokeColor:h,strokeWidth:w,waypoints:N,onProgress:de,onStart:me,onComplete:Y}=t,Z=typeof m=="function"?m:X[m]??X.linear,pe=_(D.start??"top bottom"),ge=_(D.end??"bottom top"),l=typeof z=="string"?document.querySelector(z):z??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,p=Array.isArray(w)?w[0]:null,S=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(r)),g=[],E=0,$=0,C=false,R=false,M=0,W=false,O=-1,F=-1,G=null,V=new Set;function B(){return l?d==="x"?l.scrollLeft:l.scrollTop:d==="x"?window.scrollX:window.scrollY}function ye(){return l?d==="x"?l.clientWidth:l.clientHeight:d==="x"?window.innerWidth:window.innerHeight}function ee(){let o=e.getBoundingClientRect(),s,A,y;if(l){let c=l.getBoundingClientRect();s=d==="x"?o.left-c.left+l.scrollLeft:o.top-c.top+l.scrollTop,A=d==="x"?o.width:o.height,y=B();}else s=d==="x"?o.left:o.top,A=d==="x"?o.width:o.height,y=B();let a=se({top:s,height:A},y,ye(),pe,ge);E=a.tStart,$=a.tEnd,fe&&process.env.NODE_ENV!=="production"&&(G?.remove(),G=ve(E,$,d));}function be(){I.forEach((o,s)=>{o.style.strokeDasharray=`${g[s]}`,o.style.strokeDashoffset=b==="reverse"?"0":`${g[s]}`,f?o.style.opacity=b==="reverse"?"1":"0":o.style.opacity="",v&&(o.style.stroke=v),p!==null&&(o.style.strokeWidth=`${p}`);});}if(I.forEach(o=>{we(o);let s=j(o);g.push(s),n?(o.style.strokeDasharray=`${s}`,o.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(o.style.opacity="1"),x&&(o.style.stroke=x),S!==null&&(o.style.strokeWidth=`${S}`)):(o.style.strokeDasharray=`${s}`,o.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?o.style.opacity=b==="reverse"?"1":"0":o.style.opacity="",v&&(o.style.stroke=v),p!==null&&(o.style.strokeWidth=`${p}`));}),n)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!W)return;let o=B(),s=K?F===-1||o>=F?"forward":"reverse":b;F=o;let A=$-E,y=true;if(I.forEach((a,c)=>{let k=c*T*A,u=Z(P(o,E+k,$+k,i));J&&!K&&(O=Math.max(O,u),u=O),a.style.strokeDashoffset=s==="reverse"?`${g[c]*u}`:`${g[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),p!==null&&S!==null?a.style.strokeWidth=`${p+(S-p)*u}`:S!==null&&(a.style.strokeWidth=`${S}`),c===0&&de?.(u),u<1&&(y=false);}),N){let a=Z(P(o,E,$,i));for(let c in N){let k=parseFloat(c);a>=k&&!V.has(k)&&(V.add(k),N[c]?.());}}!R&&P(o,E,$,i)>0&&(R=true,me?.()),y&&!C?(C=true,Y?.()):!y&&!J&&(C=false),M=requestAnimationFrame(te);}let q=new IntersectionObserver(o=>{o.forEach(s=>{W=s.isIntersecting,W?M=requestAnimationFrame(te):cancelAnimationFrame(M);});},{root:l??null}),H;function L(){clearTimeout(H),H=setTimeout(()=>{I.forEach((o,s)=>{g[s]=j(o),o.style.strokeDasharray=`${g[s]}`;}),ee();},150);}return window.addEventListener("resize",L),window.addEventListener("orientationchange",L),Q>0?setTimeout(()=>q.observe(e),Q):q.observe(e),{destroy(){cancelAnimationFrame(M),q.disconnect(),window.removeEventListener("resize",L),window.removeEventListener("orientationchange",L),clearTimeout(H),G?.remove();},replay(){O=-1,F=-1,R=false,C=false,V.clear(),be();}}}function Te(e={}){let t=vue.ref(null);return vue.onMounted(()=>{if(!t.value)return;let n=U(t.value,e);vue.onUnmounted(()=>n.destroy());}),t}var Ie=vue.defineComponent({name:"ScrollDraw",props:{selector:{type:String},speed:{type:Number},fade:{type:Boolean},stagger:{type:Number},easing:{type:[String,Function]},direction:{type:String},trigger:{type:Object},onProgress:{type:Function},onStart:{type:Function},onComplete:{type:Function},once:{type:Boolean},debug:{type:Boolean}},setup(e,{slots:t}){let n=vue.ref(null);return vue.onMounted(()=>{if(!n.value)return;let r={};e.selector!=null&&(r.selector=e.selector),e.speed!=null&&(r.speed=e.speed),e.fade!=null&&(r.fade=e.fade),e.stagger!=null&&(r.stagger=e.stagger),e.easing!=null&&(r.easing=e.easing),e.direction!=null&&(r.direction=e.direction),e.trigger!=null&&(r.trigger=e.trigger),e.once!=null&&(r.once=e.once),e.debug!=null&&(r.debug=e.debug),e.onProgress!=null&&(r.onProgress=e.onProgress),e.onStart!=null&&(r.onStart=e.onStart),e.onComplete!=null&&(r.onComplete=e.onComplete);let i=U(n.value,r);vue.onUnmounted(()=>i.destroy());}),()=>vue.h("div",{ref:n},t.default?.())}});exports.ScrollDraw=Ie;exports.useScrollDraw=Te;

package/dist/vue/index.d.mts

@@ -1,6 +1,6 @@
 import * as vue from 'vue';
 
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -11,12 +11,26 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 
@@ -48,9 +62,18 @@ declare const ScrollDraw: vue.DefineComponent<vue.ExtractPropTypes<{
     onProgress: {
         type: FunctionConstructor;
     };
+    onStart: {
+        type: FunctionConstructor;
+    };
     onComplete: {
         type: FunctionConstructor;
     };
+    once: {
+        type: BooleanConstructor;
+    };
+    debug: {
+        type: BooleanConstructor;
+    };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
@@ -78,11 +101,22 @@ declare const ScrollDraw: vue.DefineComponent<vue.ExtractPropTypes<{
     onProgress: {
         type: FunctionConstructor;
     };
+    onStart: {
+        type: FunctionConstructor;
+    };
     onComplete: {
         type: FunctionConstructor;
     };
+    once: {
+        type: BooleanConstructor;
+    };
+    debug: {
+        type: BooleanConstructor;
+    };
 }>> & Readonly<{}>, {
     fade: boolean;
+    once: boolean;
+    debug: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 export { ScrollDraw, type ScrollDrawOptions, useScrollDraw };

package/dist/vue/index.d.ts

@@ -1,6 +1,6 @@
 import * as vue from 'vue';
 
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';
+type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring';
 interface TriggerConfig {
     start?: string;
     end?: string;
@@ -11,12 +11,26 @@ interface ScrollDrawOptions {
     fade?: boolean;
     easing?: EasingName | ((t: number) => number);
     trigger?: TriggerConfig;
-    /** Normalized scroll-progress offset between each path starting (0–1). e.g. 0.15 → each path begins 15% of the scroll range after the previous. */
     stagger?: number;
-    /** 'forward' draws the path in (default). 'reverse' erases — path starts fully drawn and disappears as you scroll. */
     direction?: 'forward' | 'reverse';
-    /** Called every animation frame with the current draw progress (0–1) of the first path. */
+    once?: boolean;
+    debug?: boolean;
+    /** Scroll axis to track. 'y' (default) for vertical, 'x' for horizontal. */
+    axis?: 'x' | 'y';
+    /** CSS selector or Element for a custom scroll container (default: window). */
+    scrollContainer?: string | Element;
+    /** Automatically reverse the animation when the user scrolls back up. */
+    autoReverse?: boolean;
+    /** Delay in milliseconds before the engine starts observing (useful for page-load sequences). */
+    delay?: number;
+    /** Animate stroke color. Single string = static override. Tuple = interpolate from → to. */
+    strokeColor?: string | [string, string];
+    /** Animate stroke width. Single number = static override. Tuple = interpolate from → to. */
+    strokeWidth?: number | [number, number];
+    /** Fire callbacks at specific progress thresholds (0–1). Resets on replay(). */
+    waypoints?: Record<number, () => void>;
     onProgress?: (alpha: number) => void;
+    onStart?: () => void;
     onComplete?: () => void;
 }
 
@@ -48,9 +62,18 @@ declare const ScrollDraw: vue.DefineComponent<vue.ExtractPropTypes<{
     onProgress: {
         type: FunctionConstructor;
     };
+    onStart: {
+        type: FunctionConstructor;
+    };
     onComplete: {
         type: FunctionConstructor;
     };
+    once: {
+        type: BooleanConstructor;
+    };
+    debug: {
+        type: BooleanConstructor;
+    };
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
@@ -78,11 +101,22 @@ declare const ScrollDraw: vue.DefineComponent<vue.ExtractPropTypes<{
     onProgress: {
         type: FunctionConstructor;
     };
+    onStart: {
+        type: FunctionConstructor;
+    };
     onComplete: {
         type: FunctionConstructor;
     };
+    once: {
+        type: BooleanConstructor;
+    };
+    debug: {
+        type: BooleanConstructor;
+    };
 }>> & Readonly<{}>, {
     fade: boolean;
+    once: boolean;
+    debug: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 export { ScrollDraw, type ScrollDrawOptions, useScrollDraw };

package/dist/vue/index.mjs

@@ -1 +1,3 @@
-import {defineComponent,ref,onMounted,onUnmounted,h}from'vue';var E={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e};function S(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let n=t.split(/\s+/).filter(Boolean),[r="top",s="bottom"]=n;return {element:r,viewport:s}}function L(e,t,n,r){switch(r){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function $(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function D(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),r=parseFloat(e.getAttribute("height")??"0");return 2*(n+r)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function U(e,t,n){return Math.min(n,Math.max(t,e))}function k(e,t,n,r){return n===t?0:U((e-t)/(n-t)*r,0,1)}function P(e,t,n,r,s){let l=L(e.top,e.height,t,r.element)-$(r.viewport,n),u=L(e.top,e.height,t,s.element)-$(s.viewport,n);return {tStart:l,tEnd:u}}function I(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function _(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?I("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&I("Element has a fill \u2014 it may obscure the stroke animation.",e);}function A(e,t={}){if(typeof window>"u")return {destroy:()=>{}};let{selector:n="path, polyline, line, polygon, rect, circle",speed:r=1,fade:s=false,easing:l="linear",trigger:u={},stagger:R=0,direction:m="forward",onProgress:V,onComplete:z}=t,q=typeof l=="function"?l:E[l]??E.linear,B=S(u.start??"top bottom"),j=S(u.end??"bottom top"),d=Array.from(e.querySelectorAll(n)),c=[],w=0,b=0,h=false,f=0,y=false;function T(){let o=e.getBoundingClientRect(),i=P({top:o.top,height:o.height},window.scrollY,window.innerHeight,B,j);w=i.tStart,b=i.tEnd;}d.forEach(o=>{_(o);let i=D(o);c.push(i),o.style.strokeDasharray=`${i}`,o.style.strokeDashoffset=m==="reverse"?"0":`${i}`,s&&(o.style.opacity=m==="reverse"?"1":"0");}),T();function x(){if(!y)return;let o=b-w,i=true;d.forEach((F,p)=>{let C=p*R*o,a=q(k(window.scrollY,w+C,b+C,r));F.style.strokeDashoffset=m==="reverse"?`${c[p]*a}`:`${c[p]*(1-a)}`,s&&(F.style.opacity=m==="reverse"?`${1-a}`:`${a}`),p===0&&V?.(a),a<1&&(i=false);}),i&&!h?(h=true,z?.()):i||(h=false),f=requestAnimationFrame(x);}let O=new IntersectionObserver(o=>{o.forEach(i=>{y=i.isIntersecting,y?f=requestAnimationFrame(x):cancelAnimationFrame(f);});});O.observe(e);let v;function g(){clearTimeout(v),v=setTimeout(()=>{d.forEach((o,i)=>{c[i]=D(o),o.style.strokeDasharray=`${c[i]}`;}),T();},150);}return window.addEventListener("resize",g),window.addEventListener("orientationchange",g),{destroy(){cancelAnimationFrame(f),O.disconnect(),window.removeEventListener("resize",g),window.removeEventListener("orientationchange",g),clearTimeout(v);}}}function H(e={}){let t=ref(null);return onMounted(()=>{if(!t.value)return;let n=A(t.value,e);onUnmounted(()=>n.destroy());}),t}var ee=defineComponent({name:"ScrollDraw",props:{selector:{type:String},speed:{type:Number},fade:{type:Boolean},stagger:{type:Number},easing:{type:[String,Function]},direction:{type:String},trigger:{type:Object},onProgress:{type:Function},onComplete:{type:Function}},setup(e,{slots:t}){let n=ref(null);return onMounted(()=>{if(!n.value)return;let r={};e.selector!=null&&(r.selector=e.selector),e.speed!=null&&(r.speed=e.speed),e.fade!=null&&(r.fade=e.fade),e.stagger!=null&&(r.stagger=e.stagger),e.easing!=null&&(r.easing=e.easing),e.direction!=null&&(r.direction=e.direction),e.trigger!=null&&(r.trigger=e.trigger),e.onProgress!=null&&(r.onProgress=e.onProgress),e.onComplete!=null&&(r.onComplete=e.onComplete);let s=A(n.value,r);onUnmounted(()=>s.destroy());}),()=>h("div",{ref:n},t.default?.())}});export{ee as ScrollDraw,H as useScrollDraw};
+import {defineComponent,ref,onMounted,onUnmounted,h}from'vue';var X={linear:e=>e,"ease-in":e=>e*e,"ease-out":e=>e*(2-e),"ease-in-out":e=>e<.5?2*e*e:-1+(4-2*e)*e,spring:e=>1-Math.cos(e*Math.PI*2.5)*Math.pow(1-e,2.2)};function _(e="top bottom"){let t=e.trim();if(/^\d+(\.\d+)?%$/.test(t))return {element:"top",viewport:t};let[n="top",r="bottom"]=t.split(/\s+/).filter(Boolean);return {element:n,viewport:r}}function re(e,t,n,r){switch(r){case "top":return e+n;case "center":return e+n+t/2;case "bottom":return e+n+t;default:return e+n}}function ne(e,t){if(/^\d+(\.\d+)?%$/.test(e))return t*(parseFloat(e)/100);switch(e){case "top":return 0;case "center":return t/2;case "bottom":return t;default:return t}}function j(e){let t=e.tagName.toLowerCase();if(t==="rect"){let n=parseFloat(e.getAttribute("width")??"0"),r=parseFloat(e.getAttribute("height")??"0");return 2*(n+r)}if(t==="circle"){let n=parseFloat(e.getAttribute("r")??"0");return 2*Math.PI*n}return e.getTotalLength()}function he(e,t,n){return Math.min(n,Math.max(t,e))}function P(e,t,n,r){return n===t?0:he((e-t)/(n-t)*r,0,1)}function se(e,t,n,r,i){let f=re(e.top,e.height,t,r.element)-ne(r.viewport,n),m=re(e.top,e.height,t,i.element)-ne(i.viewport,n);return {tStart:f,tEnd:m}}function oe(e){let t=/^#([a-f\d])([a-f\d])([a-f\d])$/i.exec(e);if(t)return [parseInt(t[1]+t[1],16),parseInt(t[2]+t[2],16),parseInt(t[3]+t[3],16)];let n=/^#([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);if(n)return [parseInt(n[1],16),parseInt(n[2],16),parseInt(n[3],16)];let r=/^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i.exec(e);return r?[parseInt(r[1]),parseInt(r[2]),parseInt(r[3])]:null}function ie(e,t,n){let r=oe(e),i=oe(t);return !r||!i?e:`rgb(${Math.round(r[0]+(i[0]-r[0])*n)},${Math.round(r[1]+(i[1]-r[1])*n)},${Math.round(r[2]+(i[2]-r[2])*n)})`}function le(e,t){process.env.NODE_ENV!=="production"&&console.warn(`[svg-scroll-draw] ${e}`,t);}function we(e){let t=e.getAttribute("stroke"),n=e.getAttribute("fill");!t||t==="none"?le("Element has no stroke \u2014 path will not be visible.",e):n&&n!=="none"&&n!=="transparent"&&le("Element has a fill \u2014 it may obscure the stroke animation.",e);}function ve(e,t,n){let r=document.createElement("div");r.setAttribute("data-svg-scroll-draw-debug",""),r.style.cssText="position:fixed;pointer-events:none;z-index:9999;font-family:monospace;font-size:11px;top:0;left:0;right:0;bottom:0;";function i(){let f=n==="x"?window.scrollX:window.scrollY,m=e-f,D=t-f,T=n==="x";r.innerHTML=`
+      <div style="position:absolute;${T?`left:${m}px;top:0;bottom:0;border-left:2px dashed #22c55e;`:`top:${m}px;left:0;right:0;border-top:2px dashed #22c55e;`}padding:2px 6px;color:#22c55e;background:rgba(0,0,0,.6)">\u25B6 start</div>
+      <div style="position:absolute;${T?`left:${D}px;top:0;bottom:0;border-left:2px dashed #ef4444;`:`top:${D}px;left:0;right:0;border-top:2px dashed #ef4444;`}padding:2px 6px;color:#ef4444;background:rgba(0,0,0,.6)">\u25A0 end</div>`;}return document.body.appendChild(r),window.addEventListener("scroll",i,{passive:true}),i(),r}function U(e,t={}){if(typeof window>"u")return {destroy:()=>{},replay:()=>{}};let n=window.matchMedia("(prefers-reduced-motion: reduce)").matches,{selector:r="path, polyline, line, polygon, rect, circle",speed:i=1,fade:f=false,easing:m="linear",trigger:D={},stagger:T=0,direction:b="forward",once:J=false,debug:fe=false,axis:d="y",scrollContainer:z,autoReverse:K=false,delay:Q=0,strokeColor:h,strokeWidth:w,waypoints:N,onProgress:de,onStart:me,onComplete:Y}=t,Z=typeof m=="function"?m:X[m]??X.linear,pe=_(D.start??"top bottom"),ge=_(D.end??"bottom top"),l=typeof z=="string"?document.querySelector(z):z??null,v=Array.isArray(h)?h[0]:null,x=Array.isArray(h)?h[1]:typeof h=="string"?h:null,p=Array.isArray(w)?w[0]:null,S=Array.isArray(w)?w[1]:typeof w=="number"?w:null,I=Array.from(e.querySelectorAll(r)),g=[],E=0,$=0,C=false,R=false,M=0,W=false,O=-1,F=-1,G=null,V=new Set;function B(){return l?d==="x"?l.scrollLeft:l.scrollTop:d==="x"?window.scrollX:window.scrollY}function ye(){return l?d==="x"?l.clientWidth:l.clientHeight:d==="x"?window.innerWidth:window.innerHeight}function ee(){let o=e.getBoundingClientRect(),s,A,y;if(l){let c=l.getBoundingClientRect();s=d==="x"?o.left-c.left+l.scrollLeft:o.top-c.top+l.scrollTop,A=d==="x"?o.width:o.height,y=B();}else s=d==="x"?o.left:o.top,A=d==="x"?o.width:o.height,y=B();let a=se({top:s,height:A},y,ye(),pe,ge);E=a.tStart,$=a.tEnd,fe&&process.env.NODE_ENV!=="production"&&(G?.remove(),G=ve(E,$,d));}function be(){I.forEach((o,s)=>{o.style.strokeDasharray=`${g[s]}`,o.style.strokeDashoffset=b==="reverse"?"0":`${g[s]}`,f?o.style.opacity=b==="reverse"?"1":"0":o.style.opacity="",v&&(o.style.stroke=v),p!==null&&(o.style.strokeWidth=`${p}`);});}if(I.forEach(o=>{we(o);let s=j(o);g.push(s),n?(o.style.strokeDasharray=`${s}`,o.style.strokeDashoffset=b==="reverse"?`${s}`:"0",f&&(o.style.opacity="1"),x&&(o.style.stroke=x),S!==null&&(o.style.strokeWidth=`${S}`)):(o.style.strokeDasharray=`${s}`,o.style.strokeDashoffset=b==="reverse"?"0":`${s}`,f?o.style.opacity=b==="reverse"?"1":"0":o.style.opacity="",v&&(o.style.stroke=v),p!==null&&(o.style.strokeWidth=`${p}`));}),n)return Y?.(),{destroy:()=>{},replay:()=>{}};ee();function te(){if(!W)return;let o=B(),s=K?F===-1||o>=F?"forward":"reverse":b;F=o;let A=$-E,y=true;if(I.forEach((a,c)=>{let k=c*T*A,u=Z(P(o,E+k,$+k,i));J&&!K&&(O=Math.max(O,u),u=O),a.style.strokeDashoffset=s==="reverse"?`${g[c]*u}`:`${g[c]*(1-u)}`,f&&(a.style.opacity=s==="reverse"?`${1-u}`:`${u}`),v&&x?a.style.stroke=ie(v,x,u):x&&(a.style.stroke=x),p!==null&&S!==null?a.style.strokeWidth=`${p+(S-p)*u}`:S!==null&&(a.style.strokeWidth=`${S}`),c===0&&de?.(u),u<1&&(y=false);}),N){let a=Z(P(o,E,$,i));for(let c in N){let k=parseFloat(c);a>=k&&!V.has(k)&&(V.add(k),N[c]?.());}}!R&&P(o,E,$,i)>0&&(R=true,me?.()),y&&!C?(C=true,Y?.()):!y&&!J&&(C=false),M=requestAnimationFrame(te);}let q=new IntersectionObserver(o=>{o.forEach(s=>{W=s.isIntersecting,W?M=requestAnimationFrame(te):cancelAnimationFrame(M);});},{root:l??null}),H;function L(){clearTimeout(H),H=setTimeout(()=>{I.forEach((o,s)=>{g[s]=j(o),o.style.strokeDasharray=`${g[s]}`;}),ee();},150);}return window.addEventListener("resize",L),window.addEventListener("orientationchange",L),Q>0?setTimeout(()=>q.observe(e),Q):q.observe(e),{destroy(){cancelAnimationFrame(M),q.disconnect(),window.removeEventListener("resize",L),window.removeEventListener("orientationchange",L),clearTimeout(H),G?.remove();},replay(){O=-1,F=-1,R=false,C=false,V.clear(),be();}}}function Te(e={}){let t=ref(null);return onMounted(()=>{if(!t.value)return;let n=U(t.value,e);onUnmounted(()=>n.destroy());}),t}var Ie=defineComponent({name:"ScrollDraw",props:{selector:{type:String},speed:{type:Number},fade:{type:Boolean},stagger:{type:Number},easing:{type:[String,Function]},direction:{type:String},trigger:{type:Object},onProgress:{type:Function},onStart:{type:Function},onComplete:{type:Function},once:{type:Boolean},debug:{type:Boolean}},setup(e,{slots:t}){let n=ref(null);return onMounted(()=>{if(!n.value)return;let r={};e.selector!=null&&(r.selector=e.selector),e.speed!=null&&(r.speed=e.speed),e.fade!=null&&(r.fade=e.fade),e.stagger!=null&&(r.stagger=e.stagger),e.easing!=null&&(r.easing=e.easing),e.direction!=null&&(r.direction=e.direction),e.trigger!=null&&(r.trigger=e.trigger),e.once!=null&&(r.once=e.once),e.debug!=null&&(r.debug=e.debug),e.onProgress!=null&&(r.onProgress=e.onProgress),e.onStart!=null&&(r.onStart=e.onStart),e.onComplete!=null&&(r.onComplete=e.onComplete);let i=U(n.value,r);onUnmounted(()=>i.destroy());}),()=>h("div",{ref:n},t.default?.())}});export{Ie as ScrollDraw,Te as useScrollDraw};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svg-scroll-draw",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Scroll-driven SVG path drawing animation library — zero dependencies, under 3KB gzipped, works with React, Vue, and vanilla JS",
   "keywords": [
     "svg",
@@ -21,7 +21,15 @@
     "vanilla-js",
     "web-component",
     "zero-dependencies",
-    "lightweight"
+    "lightweight",
+    "svelte",
+    "svelte-action",
+    "solid",
+    "solidjs",
+    "angular",
+    "horizontal-scroll",
+    "color-animation",
+    "waypoints"
   ],
   "homepage": "https://ink-scroll.vercel.app",
   "repository": {
@@ -60,6 +68,21 @@
       "types": "./dist/vue/index.d.ts",
       "import": "./dist/vue/index.mjs",
       "require": "./dist/vue/index.cjs"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "import": "./dist/svelte/index.mjs",
+      "require": "./dist/svelte/index.cjs"
+    },
+    "./solid": {
+      "types": "./dist/solid/index.d.ts",
+      "import": "./dist/solid/index.mjs",
+      "require": "./dist/solid/index.cjs"
+    },
+    "./angular": {
+      "types": "./dist/angular/index.d.ts",
+      "import": "./dist/angular/index.mjs",
+      "require": "./dist/angular/index.cjs"
     }
   },
   "scripts": {
@@ -74,6 +97,7 @@
     "@types/react": "^18.0.0",
     "@vitest/coverage-v8": "^2.0.0",
     "jsdom": "^25.0.0",
+    "solid-js": "^1.9.13",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.0.0",
@@ -81,7 +105,8 @@
   },
   "peerDependencies": {
     "react": ">=17",
-    "vue": ">=3"
+    "vue": ">=3",
+    "solid-js": ">=1"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -89,6 +114,9 @@
     },
     "vue": {
       "optional": true
+    },
+    "solid-js": {
+      "optional": true
     }
   }
 }