svg-scroll-draw 2.12.0 → 2.13.0

package/README.md

@@ -32,6 +32,7 @@
 | `devtools` | `svg-scroll-draw/devtools` | Visual overlay showing every active animation's triggers and progress. Dev-only. |
 | `AOS` | `svg-scroll-draw/aos` | Drop-in replacement for AOS: same `AOS.init()`, same `data-aos` markup, no `aos.css`. |
 | `ScrollReveal` | `svg-scroll-draw/scrollreveal` | Drop-in replacement for ScrollReveal.js 4, MIT instead of GPL-3.0. |
+| `Vivus` | `svg-scroll-draw/vivus` | Drop-in replacement for vivus 0.4: same `new Vivus()` API and output. |
 
 All APIs return the same instance object: `{ destroy, replay, pause, resume, seek, getProgress }`.
 
@@ -430,6 +431,36 @@ Differences, on purpose:
 
 ---
 
+## vivus drop-in — keep your `new Vivus()` code
+
+On [vivus](https://github.com/maxwellito/vivus)? It has not shipped since 0.4.6 (April 2021).
+`svg-scroll-draw/vivus` runs the same API, so the move is an import change. 3.9 KB gzipped, against
+4.1 KB.
+
+```diff
+- import Vivus from 'vivus';
++ import Vivus from 'svg-scroll-draw/vivus';
+
+  new Vivus('my-svg', { type: 'oneByOne', duration: 200 }, () => console.log('drawn'));
+```
+
+No bundler? `<script src="https://unpkg.com/svg-scroll-draw/dist/cdn/vivus.global.js"></script>`
+defines `window.Vivus`. With CommonJS, `require('svg-scroll-draw/vivus').default` is the class.
+
+Every option, every animation type (`delayed`, `sync`, `async`, `nsync`, `oneByOne`, `scenario`,
+`scenario-sync`), the `start` modes, `file` and `<object>` loading, the `data-start` / `data-duration` /
+`data-delay` / `data-async` / `data-ignore` attributes, `Vivus.EASE` and the other timing functions, and
+`play` / `stop` / `reset` / `finish` / `setFrameProgress` / `getStatus` / `destroy` / `recalc` behave as
+in 0.4.6. Shapes become `<path>`s with the same `d` strings, and dashes get the same values: the browser
+suite runs vivus 0.4.6 beside it across nine configurations and requires the SVG markup to match exactly
+at every point of the animation. Like vivus, the clock is the animation frame.
+
+One difference, on purpose: under `prefers-reduced-motion: reduce`, `play()` jumps to the end and still
+fires its callbacks. When you want the stroke to follow the scroll instead of a clock, use
+[`scrollDraw`](#scrolldraw--svg-path-drawing-v1-api-unchanged) from the same package.
+
+---
+
 ## Instance API
 
 Every function returns the same instance object:
@@ -522,6 +553,7 @@ devtools.highlight('#my-element'); // outline for 2 seconds
 | `svg-scroll-draw/devtools` | `devtools` (dev-only) |
 | `svg-scroll-draw/aos` | `AOS` (default), `init`, `refresh`, `refreshHard`, `destroy` |
 | `svg-scroll-draw/scrollreveal` | `ScrollReveal` (default and named) |
+| `svg-scroll-draw/vivus` | `Vivus` (default and named) |
 
 ---
 
@@ -535,6 +567,7 @@ devtools.highlight('#my-element'); // outline for 2 seconds
 | `svg-scroll-draw/text` | 2.5 KB |
 | `svg-scroll-draw/video` | 2.0 KB |
 | `svg-scroll-draw/scrollreveal` | 4.5 KB |
+| `svg-scroll-draw/vivus` | 3.9 KB |
 | `svg-scroll-draw/aos` (styles included) | 3.0 KB |
 | `svg-scroll-draw/snap` | 1.7 KB |
 | `svg-scroll-draw/devtools` | 1.7 KB (dev only) |

package/dist/cdn/vivus.global.js

@@ -0,0 +1 @@
+"use strict";(()=>{function g(){return typeof window>"u"||typeof window.matchMedia!="function"?!1:window.matchMedia("(prefers-reduced-motion: reduce)").matches}function m(r,...t){}var E=["delayed","sync","async","nsync","oneByOne","scenario","scenario-sync"],L=["inViewport","manual","autostart"];function u(r,t){let e=parseInt(r,10);return e>=0?e:t}function V(r){if(typeof window>"u")return!1;let t=window,e=i=>typeof t[i]=="function"&&r instanceof t[i];return e("SVGSVGElement")||e("SVGGElement")||r?.constructor===t.SVGElement}var y=["cx","cy","points","r","rx","ry","x","x1","x2","y","y1","y2"],$=["line","ellipse","circle","polygon","polyline","rect"],S="http://www.w3.org/2000/svg";function v(r){let t=r.points.trim().split(" ");if(r.points.indexOf(",")===-1){let i=[];for(let s=0;s<t.length;s+=2)i.push(`${t[s]},${t[s+1]}`);t=i}let e=`M${t[0]}`;for(let i=1;i<t.length;i++)t[i].indexOf(",")!==-1&&(e+=`L${t[i]}`);return e}function b(r,t,e,i){let s=parseFloat(e)||0,a=parseFloat(i)||0,n=parseFloat(r)||0,o=parseFloat(t)||0,l=n-s,h=n+s;return`M${l},${o}A${s},${a} 0,1,1 ${h},${o}A${s},${a} 0,1,1 ${l},${o}`}var x={line:r=>`M${r.x1||0},${r.y1||0}L${r.x2||0},${r.y2||0}`,rect(r){let t=parseFloat(r.x)||0,e=parseFloat(r.y)||0,i=parseFloat(r.width)||0,s=parseFloat(r.height)||0;if(r.rx||r.ry){let a=parseInt(r.rx,10)||-1,n=parseInt(r.ry,10)||-1;a=Math.min(Math.max(a<0?n:a,0),i/2),n=Math.min(Math.max(n<0?a:n,0),s/2);let o=`A ${a},${n},0,0,1,`;return`M ${t+a},${e} L ${t+i-a},${e} ${o}${t+i},${e+n} L ${t+i},${e+s-n} ${o}${t+i-a},${e+s} L ${t+a},${e+s} ${o}${t},${e+s-n} L ${t},${e+n} ${o}${t+a},${e}`}return`M${t} ${e} L${t+i} ${e} L${t+i} ${e+s} L${t} ${e+s} Z`},polyline:v,polygon:r=>`${v(r)}Z`,ellipse:r=>b(r.cx,r.cy,r.rx,r.ry),circle:r=>b(r.cx,r.cy,r.r,r.r)};function A(r){for(let t of Array.from(r.querySelectorAll($.join(",")))){let e={};for(let{name:a,value:n}of Array.from(t.attributes)){if(y.indexOf(a)!==-1&&n.indexOf("%")!==-1)throw new Error("Pathformer [parseAttr]: a SVG shape got values in percentage. This cannot be transformed into 'path' tags. Please use 'viewBox'.");e[a]=n}let i=x[t.tagName.toLowerCase()](e),s=document.createElementNS(S,"path");for(let{name:a,value:n}of Array.from(t.attributes))y.indexOf(a)===-1&&s.setAttribute(a,n);s.setAttribute("d",i),t.parentNode?.replaceChild(s,t)}}var c=class c{constructor(t,e,i){this.isReady=!1;this.type="delayed";this.start="inViewport";this.duration=120;this.delay=null;this.dashGap=1;this.forceRender=!1;this.reverseStack=!1;this.selfDestroy=!1;this.ignoreInvisible=!1;this.animTimingFunction=c.LINEAR;this.pathTimingFunction=c.LINEAR;this.callback=()=>{};this.map=[];this.frameLength=0;this.currentFrame=0;this.delayUnit=0;this.speed=1;this.handle=null;this.instanceCallback=null;this.mustRecalcScale=null;this.viewportListener=null;this.setElement(t,e),this.setOptions(e),this.setCallback(i),this.isReady&&this.init()}setElement(t,e){if(t===void 0)throw new Error('Vivus [constructor]: "element" parameter is required');let i=t;if(typeof i=="string"){let s=document.getElementById(i);if(!s)throw new Error('Vivus [constructor]: "element" parameter is not related to an existing ID');i=s}if(this.parentEl=i,e&&e.file){let s=new XMLHttpRequest;s.addEventListener("load",()=>{let a=document.createElement("div");a.innerHTML=s.responseText;let n=a.querySelector("svg");if(!n)throw new Error(`Vivus [load]: Cannot find the SVG in the loaded file : ${e.file}`);this.el=n,n.setAttribute("width","100%"),n.setAttribute("height","100%"),this.parentEl.appendChild(n),this.isReady=!0,this.init()}),s.open("GET",e.file),s.send();return}if(V(i)){this.el=i,this.isReady=!0;return}if(i instanceof HTMLObjectElement){let s=i,a=n=>{if(this.isReady)return;let o=s.contentDocument&&s.contentDocument.querySelector("svg");if(!o&&n)throw new Error("Vivus [constructor]: object loaded does not contain any SVG");o&&(s.getAttribute("built-by-vivus")&&(this.parentEl.insertBefore(o,s),this.parentEl.removeChild(s),o.setAttribute("width","100%"),o.setAttribute("height","100%")),this.el=o,this.isReady=!0,this.init())};a(),this.isReady||s.addEventListener("load",a);return}throw new Error('Vivus [constructor]: "element" parameter is not valid (or miss the "file" attribute)')}setOptions(t){if(t!==void 0&&(t===null||t.constructor!==Object))throw new Error('Vivus [constructor]: "options" parameter must be an object');let e=t||{};if(e.type&&E.indexOf(e.type)===-1)throw new Error(`Vivus [constructor]: ${e.type} is not an existing animation \`type\``);if(e.start&&L.indexOf(e.start)===-1)throw new Error(`Vivus [constructor]: ${e.start} is not an existing \`start\` option`);this.type=e.type||"delayed",this.start=e.start||"inViewport";let i=navigator.userAgent,s=i.indexOf("MSIE")!==-1||i.indexOf("Trident/")!==-1||i.indexOf("Edge/")!==-1;if(this.duration=u(e.duration,120),this.delay=u(e.delay,null),this.dashGap=u(e.dashGap,1),this.forceRender=Object.prototype.hasOwnProperty.call(e,"forceRender")?!!e.forceRender:s,this.reverseStack=!!e.reverseStack,this.selfDestroy=!!e.selfDestroy,this.onReady=e.onReady,this.map=[],this.ignoreInvisible=Object.prototype.hasOwnProperty.call(e,"ignoreInvisible")?!!e.ignoreInvisible:!1,this.animTimingFunction=e.animTimingFunction||c.LINEAR,this.pathTimingFunction=e.pathTimingFunction||c.LINEAR,this.delay!==null&&this.delay>=this.duration)throw new Error("Vivus [constructor]: delay must be shorter than duration")}setCallback(t){if(t&&typeof t!="function")throw new Error('Vivus [constructor]: "callback" parameter must be a function');this.callback=t||(()=>{})}mapping(){let t=0,e=0,i=0,s=!1,a=Array.from(this.el.querySelectorAll("path"));a.forEach((n,o)=>{if(this.isInvisible(n))return;let l={el:n,length:0,startAt:0,duration:0,isResizeSensitive:!1},h=1;if(n.getAttribute("vector-effect")==="non-scaling-stroke"){let d=n.getBoundingClientRect(),f=n.getBBox();h=Math.max(d.width/f.width,d.height/f.height),l.isResizeSensitive=!0,s=!0}if(l.length=Math.ceil(n.getTotalLength()*h),isNaN(l.length)){m("vivus: cannot retrieve a path element length",n);return}this.map.push(l),n.style.strokeDasharray=`${l.length} ${l.length+this.dashGap*2}`,n.style.strokeDashoffset=String(l.length+this.dashGap),l.length+=this.dashGap,e+=l.length,this.renderPath(o)}),s&&m("vivus: this SVG contains non-scaling-strokes. Call instance.recalc() when the SVG is resized."),e=e===0?1:e,this.delay=this.delay===null?this.duration/3:this.delay,this.delayUnit=this.delay/(a.length>1?a.length-1:1),this.reverseStack&&this.map.reverse(),this.map.forEach((n,o)=>{let l=()=>{let h={};for(let{name:d,value:f}of Array.from(n.el.attributes))h[d]=f;return h};switch(this.type){case"delayed":n.startAt=this.delayUnit*o,n.duration=this.duration-this.delay;break;case"oneByOne":n.startAt=i/e*this.duration,n.duration=n.length/e*this.duration;break;case"sync":case"async":case"nsync":n.startAt=0,n.duration=this.duration;break;case"scenario-sync":{let h=l();n.startAt=t+(u(h["data-delay"],this.delayUnit)||0),n.duration=u(h["data-duration"],this.duration),t=h["data-async"]!==void 0?n.startAt:n.startAt+n.duration,this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}case"scenario":{let h=l();n.startAt=u(h["data-start"],this.delayUnit)||0,n.duration=u(h["data-duration"],this.duration),this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}}i+=n.length,this.frameLength=this.frameLength||this.duration})}recalc(){this.mustRecalcScale||(this.mustRecalcScale=requestAnimationFrame(()=>this.performLineRecalc()))}performLineRecalc(){for(let t of this.map){if(!t.isResizeSensitive)continue;let e=t.el.getBoundingClientRect(),i=t.el.getBBox(),s=Math.max(e.width/i.width,e.height/i.height);t.length=Math.ceil(t.el.getTotalLength()*s),t.el.style.strokeDasharray=`${t.length} ${t.length+this.dashGap*2}`}this.trace(),this.mustRecalcScale=null}draw(){if(this.currentFrame+=this.speed,this.currentFrame<=0)this.stop(),this.reset();else if(this.currentFrame>=this.frameLength)this.stop(),this.currentFrame=this.frameLength,this.trace(),this.selfDestroy&&this.destroy();else{this.trace(),this.handle=requestAnimationFrame(()=>this.draw());return}this.finished()}finished(){if(this.callback(this),this.instanceCallback){let t=this.instanceCallback;this.instanceCallback=null,t(this)}}trace(){let t=this.animTimingFunction(this.currentFrame/this.frameLength)*this.frameLength;this.map.forEach((e,i)=>{let s=this.pathTimingFunction(Math.max(0,Math.min(1,(t-e.startAt)/e.duration)));e.progress!==s&&(e.progress=s,e.el.style.strokeDashoffset=String(Math.floor(e.length*(1-s))),this.renderPath(i))})}renderPath(t){let e=this.forceRender&&this.map&&this.map[t];if(!e)return;let i=e.el.cloneNode(!0);e.el.parentNode?.replaceChild(i,e.el),e.el=i}init(){this.frameLength=0,this.currentFrame=0,this.map=[],A(this.el),this.mapping(),this.starter(),this.onReady&&this.onReady(this)}starter(){if(this.start==="manual")return;if(this.start==="autostart"){this.play();return}let t=()=>{this.isInViewport(this.parentEl,1)&&(this.play(),window.removeEventListener("scroll",t),this.viewportListener=null)};this.viewportListener=t,window.addEventListener("scroll",t),t()}getStatus(){return this.currentFrame===0?"start":this.currentFrame===this.frameLength?"end":"progress"}reset(){return this.setFrameProgress(0)}finish(){return this.setFrameProgress(1)}setFrameProgress(t){let e=Math.min(1,Math.max(0,t));return this.currentFrame=Math.round(this.frameLength*e),this.trace(),this}play(t,e){this.instanceCallback=null;let i=t;if(i&&typeof i=="function")this.instanceCallback=i,i=void 0;else if(i&&typeof i!="number")throw new Error("Vivus [play]: invalid speed");return e&&typeof e=="function"&&!this.instanceCallback&&(this.instanceCallback=e),this.speed=i||1,g()?(this.stop(),this.currentFrame=this.speed<0?0:this.frameLength,this.trace(),this.speed>0&&this.selfDestroy&&this.destroy(),this.finished(),this):(this.handle||this.draw(),this)}stop(){return this.handle&&(cancelAnimationFrame(this.handle),this.handle=null),this}destroy(){this.stop(),this.viewportListener&&(window.removeEventListener("scroll",this.viewportListener),this.viewportListener=null),this.map.forEach((t,e)=>{t.el.style.strokeDashoffset="",t.el.style.strokeDasharray="",this.renderPath(e)})}isInvisible(t){let e=t.getAttribute("data-ignore");if(e!==null)return e!=="false";if(this.ignoreInvisible){let i=t.getBoundingClientRect();return!i.width&&!i.height}return!1}isInViewport(t,e=0){let i=window.pageYOffset||document.documentElement.scrollTop,s=i+Math.max(document.documentElement.clientHeight,window.innerHeight),a=t.getBoundingClientRect(),n=i+a.top;return n+a.height*(e||0)<=s&&n+a.height>=i}};c.LINEAR=t=>t,c.EASE=t=>-Math.cos(t*Math.PI)/2+.5,c.EASE_OUT=t=>1-Math.pow(1-t,3),c.EASE_IN=t=>Math.pow(t,3),c.EASE_OUT_BOUNCE=t=>{let e=-Math.cos(t*(.5*Math.PI))+1,i=Math.pow(e,1.5),s=Math.pow(1-t,2),a=-Math.abs(Math.cos(i*(2.5*Math.PI)))+1;return 1-s+a*s};var p=c,w=p;globalThis.Vivus=w;})();

package/dist/vivus/index.cjs

@@ -0,0 +1,2 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});function g(){return typeof window>"u"||typeof window.matchMedia!="function"?false:window.matchMedia("(prefers-reduced-motion: reduce)").matches}var w=typeof __SVG_SCROLL_DRAW_DEV__<"u"?__SVG_SCROLL_DRAW_DEV__:typeof process<"u"&&typeof process.env<"u"&&process.env.NODE_ENV!=="production";function m(r,...t){w&&console.warn(`[svg-scroll-draw] ${r}`,...t);}var E=["delayed","sync","async","nsync","oneByOne","scenario","scenario-sync"],L=["inViewport","manual","autostart"];function u(r,t){let e=parseInt(r,10);return e>=0?e:t}function V(r){if(typeof window>"u")return  false;let t=window,e=i=>typeof t[i]=="function"&&r instanceof t[i];return e("SVGSVGElement")||e("SVGGElement")||r?.constructor===t.SVGElement}var y=["cx","cy","points","r","rx","ry","x","x1","x2","y","y1","y2"],$=["line","ellipse","circle","polygon","polyline","rect"],x="http://www.w3.org/2000/svg";function v(r){let t=r.points.trim().split(" ");if(r.points.indexOf(",")===-1){let i=[];for(let s=0;s<t.length;s+=2)i.push(`${t[s]},${t[s+1]}`);t=i;}let e=`M${t[0]}`;for(let i=1;i<t.length;i++)t[i].indexOf(",")!==-1&&(e+=`L${t[i]}`);return e}function b(r,t,e,i){let s=parseFloat(e)||0,a=parseFloat(i)||0,n=parseFloat(r)||0,o=parseFloat(t)||0,l=n-s,h=n+s;return `M${l},${o}A${s},${a} 0,1,1 ${h},${o}A${s},${a} 0,1,1 ${l},${o}`}var A={line:r=>`M${r.x1||0},${r.y1||0}L${r.x2||0},${r.y2||0}`,rect(r){let t=parseFloat(r.x)||0,e=parseFloat(r.y)||0,i=parseFloat(r.width)||0,s=parseFloat(r.height)||0;if(r.rx||r.ry){let a=parseInt(r.rx,10)||-1,n=parseInt(r.ry,10)||-1;a=Math.min(Math.max(a<0?n:a,0),i/2),n=Math.min(Math.max(n<0?a:n,0),s/2);let o=`A ${a},${n},0,0,1,`;return `M ${t+a},${e} L ${t+i-a},${e} ${o}${t+i},${e+n} L ${t+i},${e+s-n} ${o}${t+i-a},${e+s} L ${t+a},${e+s} ${o}${t},${e+s-n} L ${t},${e+n} ${o}${t+a},${e}`}return `M${t} ${e} L${t+i} ${e} L${t+i} ${e+s} L${t} ${e+s} Z`},polyline:v,polygon:r=>`${v(r)}Z`,ellipse:r=>b(r.cx,r.cy,r.rx,r.ry),circle:r=>b(r.cx,r.cy,r.r,r.r)};function R(r){for(let t of Array.from(r.querySelectorAll($.join(",")))){let e={};for(let{name:a,value:n}of Array.from(t.attributes)){if(y.indexOf(a)!==-1&&n.indexOf("%")!==-1)throw new Error("Pathformer [parseAttr]: a SVG shape got values in percentage. This cannot be transformed into 'path' tags. Please use 'viewBox'.");e[a]=n;}let i=A[t.tagName.toLowerCase()](e),s=document.createElementNS(x,"path");for(let{name:a,value:n}of Array.from(t.attributes))y.indexOf(a)===-1&&s.setAttribute(a,n);s.setAttribute("d",i),t.parentNode?.replaceChild(s,t);}}var c=class c{constructor(t,e,i){this.isReady=false;this.type="delayed";this.start="inViewport";this.duration=120;this.delay=null;this.dashGap=1;this.forceRender=false;this.reverseStack=false;this.selfDestroy=false;this.ignoreInvisible=false;this.animTimingFunction=c.LINEAR;this.pathTimingFunction=c.LINEAR;this.callback=()=>{};this.map=[];this.frameLength=0;this.currentFrame=0;this.delayUnit=0;this.speed=1;this.handle=null;this.instanceCallback=null;this.mustRecalcScale=null;this.viewportListener=null;this.setElement(t,e),this.setOptions(e),this.setCallback(i),this.isReady&&this.init();}setElement(t,e){if(t===void 0)throw new Error('Vivus [constructor]: "element" parameter is required');let i=t;if(typeof i=="string"){let s=document.getElementById(i);if(!s)throw new Error('Vivus [constructor]: "element" parameter is not related to an existing ID');i=s;}if(this.parentEl=i,e&&e.file){let s=new XMLHttpRequest;s.addEventListener("load",()=>{let a=document.createElement("div");a.innerHTML=s.responseText;let n=a.querySelector("svg");if(!n)throw new Error(`Vivus [load]: Cannot find the SVG in the loaded file : ${e.file}`);this.el=n,n.setAttribute("width","100%"),n.setAttribute("height","100%"),this.parentEl.appendChild(n),this.isReady=true,this.init();}),s.open("GET",e.file),s.send();return}if(V(i)){this.el=i,this.isReady=true;return}if(i instanceof HTMLObjectElement){let s=i,a=n=>{if(this.isReady)return;let o=s.contentDocument&&s.contentDocument.querySelector("svg");if(!o&&n)throw new Error("Vivus [constructor]: object loaded does not contain any SVG");o&&(s.getAttribute("built-by-vivus")&&(this.parentEl.insertBefore(o,s),this.parentEl.removeChild(s),o.setAttribute("width","100%"),o.setAttribute("height","100%")),this.el=o,this.isReady=true,this.init());};a(),this.isReady||s.addEventListener("load",a);return}throw new Error('Vivus [constructor]: "element" parameter is not valid (or miss the "file" attribute)')}setOptions(t){if(t!==void 0&&(t===null||t.constructor!==Object))throw new Error('Vivus [constructor]: "options" parameter must be an object');let e=t||{};if(e.type&&E.indexOf(e.type)===-1)throw new Error(`Vivus [constructor]: ${e.type} is not an existing animation \`type\``);if(e.start&&L.indexOf(e.start)===-1)throw new Error(`Vivus [constructor]: ${e.start} is not an existing \`start\` option`);this.type=e.type||"delayed",this.start=e.start||"inViewport";let i=navigator.userAgent,s=i.indexOf("MSIE")!==-1||i.indexOf("Trident/")!==-1||i.indexOf("Edge/")!==-1;if(this.duration=u(e.duration,120),this.delay=u(e.delay,null),this.dashGap=u(e.dashGap,1),this.forceRender=Object.prototype.hasOwnProperty.call(e,"forceRender")?!!e.forceRender:s,this.reverseStack=!!e.reverseStack,this.selfDestroy=!!e.selfDestroy,this.onReady=e.onReady,this.map=[],this.ignoreInvisible=Object.prototype.hasOwnProperty.call(e,"ignoreInvisible")?!!e.ignoreInvisible:false,this.animTimingFunction=e.animTimingFunction||c.LINEAR,this.pathTimingFunction=e.pathTimingFunction||c.LINEAR,this.delay!==null&&this.delay>=this.duration)throw new Error("Vivus [constructor]: delay must be shorter than duration")}setCallback(t){if(t&&typeof t!="function")throw new Error('Vivus [constructor]: "callback" parameter must be a function');this.callback=t||(()=>{});}mapping(){let t=0,e=0,i=0,s=false,a=Array.from(this.el.querySelectorAll("path"));a.forEach((n,o)=>{if(this.isInvisible(n))return;let l={el:n,length:0,startAt:0,duration:0,isResizeSensitive:false},h=1;if(n.getAttribute("vector-effect")==="non-scaling-stroke"){let d=n.getBoundingClientRect(),f=n.getBBox();h=Math.max(d.width/f.width,d.height/f.height),l.isResizeSensitive=true,s=true;}if(l.length=Math.ceil(n.getTotalLength()*h),isNaN(l.length)){m("vivus: cannot retrieve a path element length",n);return}this.map.push(l),n.style.strokeDasharray=`${l.length} ${l.length+this.dashGap*2}`,n.style.strokeDashoffset=String(l.length+this.dashGap),l.length+=this.dashGap,e+=l.length,this.renderPath(o);}),s&&m("vivus: this SVG contains non-scaling-strokes. Call instance.recalc() when the SVG is resized."),e=e===0?1:e,this.delay=this.delay===null?this.duration/3:this.delay,this.delayUnit=this.delay/(a.length>1?a.length-1:1),this.reverseStack&&this.map.reverse(),this.map.forEach((n,o)=>{let l=()=>{let h={};for(let{name:d,value:f}of Array.from(n.el.attributes))h[d]=f;return h};switch(this.type){case "delayed":n.startAt=this.delayUnit*o,n.duration=this.duration-this.delay;break;case "oneByOne":n.startAt=i/e*this.duration,n.duration=n.length/e*this.duration;break;case "sync":case "async":case "nsync":n.startAt=0,n.duration=this.duration;break;case "scenario-sync":{let h=l();n.startAt=t+(u(h["data-delay"],this.delayUnit)||0),n.duration=u(h["data-duration"],this.duration),t=h["data-async"]!==void 0?n.startAt:n.startAt+n.duration,this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}case "scenario":{let h=l();n.startAt=u(h["data-start"],this.delayUnit)||0,n.duration=u(h["data-duration"],this.duration),this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}}i+=n.length,this.frameLength=this.frameLength||this.duration;});}recalc(){this.mustRecalcScale||(this.mustRecalcScale=requestAnimationFrame(()=>this.performLineRecalc()));}performLineRecalc(){for(let t of this.map){if(!t.isResizeSensitive)continue;let e=t.el.getBoundingClientRect(),i=t.el.getBBox(),s=Math.max(e.width/i.width,e.height/i.height);t.length=Math.ceil(t.el.getTotalLength()*s),t.el.style.strokeDasharray=`${t.length} ${t.length+this.dashGap*2}`;}this.trace(),this.mustRecalcScale=null;}draw(){if(this.currentFrame+=this.speed,this.currentFrame<=0)this.stop(),this.reset();else if(this.currentFrame>=this.frameLength)this.stop(),this.currentFrame=this.frameLength,this.trace(),this.selfDestroy&&this.destroy();else {this.trace(),this.handle=requestAnimationFrame(()=>this.draw());return}this.finished();}finished(){if(this.callback(this),this.instanceCallback){let t=this.instanceCallback;this.instanceCallback=null,t(this);}}trace(){let t=this.animTimingFunction(this.currentFrame/this.frameLength)*this.frameLength;this.map.forEach((e,i)=>{let s=this.pathTimingFunction(Math.max(0,Math.min(1,(t-e.startAt)/e.duration)));e.progress!==s&&(e.progress=s,e.el.style.strokeDashoffset=String(Math.floor(e.length*(1-s))),this.renderPath(i));});}renderPath(t){let e=this.forceRender&&this.map&&this.map[t];if(!e)return;let i=e.el.cloneNode(true);e.el.parentNode?.replaceChild(i,e.el),e.el=i;}init(){this.frameLength=0,this.currentFrame=0,this.map=[],R(this.el),this.mapping(),this.starter(),this.onReady&&this.onReady(this);}starter(){if(this.start==="manual")return;if(this.start==="autostart"){this.play();return}let t=()=>{this.isInViewport(this.parentEl,1)&&(this.play(),window.removeEventListener("scroll",t),this.viewportListener=null);};this.viewportListener=t,window.addEventListener("scroll",t),t();}getStatus(){return this.currentFrame===0?"start":this.currentFrame===this.frameLength?"end":"progress"}reset(){return this.setFrameProgress(0)}finish(){return this.setFrameProgress(1)}setFrameProgress(t){let e=Math.min(1,Math.max(0,t));return this.currentFrame=Math.round(this.frameLength*e),this.trace(),this}play(t,e){this.instanceCallback=null;let i=t;if(i&&typeof i=="function")this.instanceCallback=i,i=void 0;else if(i&&typeof i!="number")throw new Error("Vivus [play]: invalid speed");return e&&typeof e=="function"&&!this.instanceCallback&&(this.instanceCallback=e),this.speed=i||1,g()?(this.stop(),this.currentFrame=this.speed<0?0:this.frameLength,this.trace(),this.speed>0&&this.selfDestroy&&this.destroy(),this.finished(),this):(this.handle||this.draw(),this)}stop(){return this.handle&&(cancelAnimationFrame(this.handle),this.handle=null),this}destroy(){this.stop(),this.viewportListener&&(window.removeEventListener("scroll",this.viewportListener),this.viewportListener=null),this.map.forEach((t,e)=>{t.el.style.strokeDashoffset="",t.el.style.strokeDasharray="",this.renderPath(e);});}isInvisible(t){let e=t.getAttribute("data-ignore");if(e!==null)return e!=="false";if(this.ignoreInvisible){let i=t.getBoundingClientRect();return !i.width&&!i.height}return  false}isInViewport(t,e=0){let i=window.pageYOffset||document.documentElement.scrollTop,s=i+Math.max(document.documentElement.clientHeight,window.innerHeight),a=t.getBoundingClientRect(),n=i+a.top;return n+a.height*(e||0)<=s&&n+a.height>=i}};c.LINEAR=t=>t,c.EASE=t=>-Math.cos(t*Math.PI)/2+.5,c.EASE_OUT=t=>1-Math.pow(1-t,3),c.EASE_IN=t=>Math.pow(t,3),c.EASE_OUT_BOUNCE=t=>{let e=-Math.cos(t*(.5*Math.PI))+1,i=Math.pow(e,1.5),s=Math.pow(1-t,2),a=-Math.abs(Math.cos(i*(2.5*Math.PI)))+1;return 1-s+a*s};var p=c,O=p;
+exports.Vivus=p;exports.default=O;

package/dist/vivus/index.d.mts

@@ -0,0 +1,100 @@
+type VivusType = 'delayed' | 'sync' | 'async' | 'nsync' | 'oneByOne' | 'scenario' | 'scenario-sync';
+type VivusStart = 'inViewport' | 'manual' | 'autostart';
+type VivusTiming = (x: number) => number;
+type VivusCallback = (instance: Vivus) => void;
+interface VivusOptions {
+    type?: VivusType;
+    /** Load the SVG from this URL into `element` instead of using markup. */
+    file?: string;
+    start?: VivusStart;
+    /** Animation length in frames. Default 120. */
+    duration?: number;
+    /** For `delayed`: frames between the first and last path starting. Default duration / 3. */
+    delay?: number;
+    /** Extra gap in the dash pattern, so the line start never shows early. Default 1. */
+    dashGap?: number;
+    /** Clone-and-replace each path after every update (an old IE/Edge repaint hack). */
+    forceRender?: boolean;
+    reverseStack?: boolean;
+    selfDestroy?: boolean;
+    onReady?: VivusCallback;
+    ignoreInvisible?: boolean;
+    pathTimingFunction?: VivusTiming;
+    animTimingFunction?: VivusTiming;
+}
+interface PathRecord {
+    el: SVGPathElement;
+    length: number;
+    startAt: number;
+    duration: number;
+    isResizeSensitive: boolean;
+    progress?: number;
+}
+declare class Vivus {
+    static LINEAR: VivusTiming;
+    static EASE: VivusTiming;
+    static EASE_OUT: VivusTiming;
+    static EASE_IN: VivusTiming;
+    static EASE_OUT_BOUNCE: VivusTiming;
+    el: Element;
+    parentEl: Element;
+    isReady: boolean;
+    type: VivusType;
+    start: VivusStart;
+    duration: number;
+    delay: number | null;
+    dashGap: number;
+    forceRender: boolean;
+    reverseStack: boolean;
+    selfDestroy: boolean;
+    ignoreInvisible: boolean;
+    onReady?: VivusCallback;
+    animTimingFunction: VivusTiming;
+    pathTimingFunction: VivusTiming;
+    callback: VivusCallback;
+    map: PathRecord[];
+    frameLength: number;
+    currentFrame: number;
+    delayUnit: number;
+    speed: number;
+    handle: number | null;
+    private instanceCallback;
+    private mustRecalcScale;
+    private viewportListener;
+    constructor(element: string | Element, options?: VivusOptions, callback?: VivusCallback);
+    private setElement;
+    private setOptions;
+    private setCallback;
+    /** Measure every path, set its dashes, and work out when each one draws. */
+    mapping(): void;
+    /** Re-measure `vector-effect: non-scaling-stroke` paths on the next frame (after a resize). */
+    recalc(): void;
+    performLineRecalc(): void;
+    /** One frame: advance by `speed`, render, and finish at either end. */
+    draw(): void;
+    private finished;
+    /** Render the current frame to every path's dash offset. */
+    trace(): void;
+    renderPath(index: number): void;
+    init(): void;
+    private starter;
+    /** `'start'`, `'progress'` or `'end'`. */
+    getStatus(): 'start' | 'progress' | 'end';
+    reset(): this;
+    finish(): this;
+    /** Jump to a point (0–1) and render it. */
+    setFrameProgress(progress: number): this;
+    /**
+     * Animate at `speed` frames per frame (negative plays backwards). The callback
+     * may be given alone, as the first argument.
+     */
+    play(speed?: number | VivusCallback, callback?: VivusCallback): this;
+    stop(): this;
+    /** Stop and remove every dash style vivus set. */
+    destroy(): void;
+    isInvisible(el: Element): boolean;
+    /** Whether `el` is in view; with `h` = 1 its whole height must fit above the fold. */
+    isInViewport(el: Element, h?: number): boolean;
+}
+
+export { Vivus, type VivusCallback, type VivusOptions, type VivusStart, type VivusTiming, type VivusType, Vivus as default };

package/dist/vivus/index.d.ts

@@ -0,0 +1,100 @@
+type VivusType = 'delayed' | 'sync' | 'async' | 'nsync' | 'oneByOne' | 'scenario' | 'scenario-sync';
+type VivusStart = 'inViewport' | 'manual' | 'autostart';
+type VivusTiming = (x: number) => number;
+type VivusCallback = (instance: Vivus) => void;
+interface VivusOptions {
+    type?: VivusType;
+    /** Load the SVG from this URL into `element` instead of using markup. */
+    file?: string;
+    start?: VivusStart;
+    /** Animation length in frames. Default 120. */
+    duration?: number;
+    /** For `delayed`: frames between the first and last path starting. Default duration / 3. */
+    delay?: number;
+    /** Extra gap in the dash pattern, so the line start never shows early. Default 1. */
+    dashGap?: number;
+    /** Clone-and-replace each path after every update (an old IE/Edge repaint hack). */
+    forceRender?: boolean;
+    reverseStack?: boolean;
+    selfDestroy?: boolean;
+    onReady?: VivusCallback;
+    ignoreInvisible?: boolean;
+    pathTimingFunction?: VivusTiming;
+    animTimingFunction?: VivusTiming;
+}
+interface PathRecord {
+    el: SVGPathElement;
+    length: number;
+    startAt: number;
+    duration: number;
+    isResizeSensitive: boolean;
+    progress?: number;
+}
+declare class Vivus {
+    static LINEAR: VivusTiming;
+    static EASE: VivusTiming;
+    static EASE_OUT: VivusTiming;
+    static EASE_IN: VivusTiming;
+    static EASE_OUT_BOUNCE: VivusTiming;
+    el: Element;
+    parentEl: Element;
+    isReady: boolean;
+    type: VivusType;
+    start: VivusStart;
+    duration: number;
+    delay: number | null;
+    dashGap: number;
+    forceRender: boolean;
+    reverseStack: boolean;
+    selfDestroy: boolean;
+    ignoreInvisible: boolean;
+    onReady?: VivusCallback;
+    animTimingFunction: VivusTiming;
+    pathTimingFunction: VivusTiming;
+    callback: VivusCallback;
+    map: PathRecord[];
+    frameLength: number;
+    currentFrame: number;
+    delayUnit: number;
+    speed: number;
+    handle: number | null;
+    private instanceCallback;
+    private mustRecalcScale;
+    private viewportListener;
+    constructor(element: string | Element, options?: VivusOptions, callback?: VivusCallback);
+    private setElement;
+    private setOptions;
+    private setCallback;
+    /** Measure every path, set its dashes, and work out when each one draws. */
+    mapping(): void;
+    /** Re-measure `vector-effect: non-scaling-stroke` paths on the next frame (after a resize). */
+    recalc(): void;
+    performLineRecalc(): void;
+    /** One frame: advance by `speed`, render, and finish at either end. */
+    draw(): void;
+    private finished;
+    /** Render the current frame to every path's dash offset. */
+    trace(): void;
+    renderPath(index: number): void;
+    init(): void;
+    private starter;
+    /** `'start'`, `'progress'` or `'end'`. */
+    getStatus(): 'start' | 'progress' | 'end';
+    reset(): this;
+    finish(): this;
+    /** Jump to a point (0–1) and render it. */
+    setFrameProgress(progress: number): this;
+    /**
+     * Animate at `speed` frames per frame (negative plays backwards). The callback
+     * may be given alone, as the first argument.
+     */
+    play(speed?: number | VivusCallback, callback?: VivusCallback): this;
+    stop(): this;
+    /** Stop and remove every dash style vivus set. */
+    destroy(): void;
+    isInvisible(el: Element): boolean;
+    /** Whether `el` is in view; with `h` = 1 its whole height must fit above the fold. */
+    isInViewport(el: Element, h?: number): boolean;
+}
+
+export { Vivus, type VivusCallback, type VivusOptions, type VivusStart, type VivusTiming, type VivusType, Vivus as default };

package/dist/vivus/index.mjs

@@ -0,0 +1,2 @@
+function g(){return typeof window>"u"||typeof window.matchMedia!="function"?false:window.matchMedia("(prefers-reduced-motion: reduce)").matches}var w=typeof __SVG_SCROLL_DRAW_DEV__<"u"?__SVG_SCROLL_DRAW_DEV__:typeof process<"u"&&typeof process.env<"u"&&process.env.NODE_ENV!=="production";function m(r,...t){w&&console.warn(`[svg-scroll-draw] ${r}`,...t);}var E=["delayed","sync","async","nsync","oneByOne","scenario","scenario-sync"],L=["inViewport","manual","autostart"];function u(r,t){let e=parseInt(r,10);return e>=0?e:t}function V(r){if(typeof window>"u")return  false;let t=window,e=i=>typeof t[i]=="function"&&r instanceof t[i];return e("SVGSVGElement")||e("SVGGElement")||r?.constructor===t.SVGElement}var y=["cx","cy","points","r","rx","ry","x","x1","x2","y","y1","y2"],$=["line","ellipse","circle","polygon","polyline","rect"],x="http://www.w3.org/2000/svg";function v(r){let t=r.points.trim().split(" ");if(r.points.indexOf(",")===-1){let i=[];for(let s=0;s<t.length;s+=2)i.push(`${t[s]},${t[s+1]}`);t=i;}let e=`M${t[0]}`;for(let i=1;i<t.length;i++)t[i].indexOf(",")!==-1&&(e+=`L${t[i]}`);return e}function b(r,t,e,i){let s=parseFloat(e)||0,a=parseFloat(i)||0,n=parseFloat(r)||0,o=parseFloat(t)||0,l=n-s,h=n+s;return `M${l},${o}A${s},${a} 0,1,1 ${h},${o}A${s},${a} 0,1,1 ${l},${o}`}var A={line:r=>`M${r.x1||0},${r.y1||0}L${r.x2||0},${r.y2||0}`,rect(r){let t=parseFloat(r.x)||0,e=parseFloat(r.y)||0,i=parseFloat(r.width)||0,s=parseFloat(r.height)||0;if(r.rx||r.ry){let a=parseInt(r.rx,10)||-1,n=parseInt(r.ry,10)||-1;a=Math.min(Math.max(a<0?n:a,0),i/2),n=Math.min(Math.max(n<0?a:n,0),s/2);let o=`A ${a},${n},0,0,1,`;return `M ${t+a},${e} L ${t+i-a},${e} ${o}${t+i},${e+n} L ${t+i},${e+s-n} ${o}${t+i-a},${e+s} L ${t+a},${e+s} ${o}${t},${e+s-n} L ${t},${e+n} ${o}${t+a},${e}`}return `M${t} ${e} L${t+i} ${e} L${t+i} ${e+s} L${t} ${e+s} Z`},polyline:v,polygon:r=>`${v(r)}Z`,ellipse:r=>b(r.cx,r.cy,r.rx,r.ry),circle:r=>b(r.cx,r.cy,r.r,r.r)};function R(r){for(let t of Array.from(r.querySelectorAll($.join(",")))){let e={};for(let{name:a,value:n}of Array.from(t.attributes)){if(y.indexOf(a)!==-1&&n.indexOf("%")!==-1)throw new Error("Pathformer [parseAttr]: a SVG shape got values in percentage. This cannot be transformed into 'path' tags. Please use 'viewBox'.");e[a]=n;}let i=A[t.tagName.toLowerCase()](e),s=document.createElementNS(x,"path");for(let{name:a,value:n}of Array.from(t.attributes))y.indexOf(a)===-1&&s.setAttribute(a,n);s.setAttribute("d",i),t.parentNode?.replaceChild(s,t);}}var c=class c{constructor(t,e,i){this.isReady=false;this.type="delayed";this.start="inViewport";this.duration=120;this.delay=null;this.dashGap=1;this.forceRender=false;this.reverseStack=false;this.selfDestroy=false;this.ignoreInvisible=false;this.animTimingFunction=c.LINEAR;this.pathTimingFunction=c.LINEAR;this.callback=()=>{};this.map=[];this.frameLength=0;this.currentFrame=0;this.delayUnit=0;this.speed=1;this.handle=null;this.instanceCallback=null;this.mustRecalcScale=null;this.viewportListener=null;this.setElement(t,e),this.setOptions(e),this.setCallback(i),this.isReady&&this.init();}setElement(t,e){if(t===void 0)throw new Error('Vivus [constructor]: "element" parameter is required');let i=t;if(typeof i=="string"){let s=document.getElementById(i);if(!s)throw new Error('Vivus [constructor]: "element" parameter is not related to an existing ID');i=s;}if(this.parentEl=i,e&&e.file){let s=new XMLHttpRequest;s.addEventListener("load",()=>{let a=document.createElement("div");a.innerHTML=s.responseText;let n=a.querySelector("svg");if(!n)throw new Error(`Vivus [load]: Cannot find the SVG in the loaded file : ${e.file}`);this.el=n,n.setAttribute("width","100%"),n.setAttribute("height","100%"),this.parentEl.appendChild(n),this.isReady=true,this.init();}),s.open("GET",e.file),s.send();return}if(V(i)){this.el=i,this.isReady=true;return}if(i instanceof HTMLObjectElement){let s=i,a=n=>{if(this.isReady)return;let o=s.contentDocument&&s.contentDocument.querySelector("svg");if(!o&&n)throw new Error("Vivus [constructor]: object loaded does not contain any SVG");o&&(s.getAttribute("built-by-vivus")&&(this.parentEl.insertBefore(o,s),this.parentEl.removeChild(s),o.setAttribute("width","100%"),o.setAttribute("height","100%")),this.el=o,this.isReady=true,this.init());};a(),this.isReady||s.addEventListener("load",a);return}throw new Error('Vivus [constructor]: "element" parameter is not valid (or miss the "file" attribute)')}setOptions(t){if(t!==void 0&&(t===null||t.constructor!==Object))throw new Error('Vivus [constructor]: "options" parameter must be an object');let e=t||{};if(e.type&&E.indexOf(e.type)===-1)throw new Error(`Vivus [constructor]: ${e.type} is not an existing animation \`type\``);if(e.start&&L.indexOf(e.start)===-1)throw new Error(`Vivus [constructor]: ${e.start} is not an existing \`start\` option`);this.type=e.type||"delayed",this.start=e.start||"inViewport";let i=navigator.userAgent,s=i.indexOf("MSIE")!==-1||i.indexOf("Trident/")!==-1||i.indexOf("Edge/")!==-1;if(this.duration=u(e.duration,120),this.delay=u(e.delay,null),this.dashGap=u(e.dashGap,1),this.forceRender=Object.prototype.hasOwnProperty.call(e,"forceRender")?!!e.forceRender:s,this.reverseStack=!!e.reverseStack,this.selfDestroy=!!e.selfDestroy,this.onReady=e.onReady,this.map=[],this.ignoreInvisible=Object.prototype.hasOwnProperty.call(e,"ignoreInvisible")?!!e.ignoreInvisible:false,this.animTimingFunction=e.animTimingFunction||c.LINEAR,this.pathTimingFunction=e.pathTimingFunction||c.LINEAR,this.delay!==null&&this.delay>=this.duration)throw new Error("Vivus [constructor]: delay must be shorter than duration")}setCallback(t){if(t&&typeof t!="function")throw new Error('Vivus [constructor]: "callback" parameter must be a function');this.callback=t||(()=>{});}mapping(){let t=0,e=0,i=0,s=false,a=Array.from(this.el.querySelectorAll("path"));a.forEach((n,o)=>{if(this.isInvisible(n))return;let l={el:n,length:0,startAt:0,duration:0,isResizeSensitive:false},h=1;if(n.getAttribute("vector-effect")==="non-scaling-stroke"){let d=n.getBoundingClientRect(),f=n.getBBox();h=Math.max(d.width/f.width,d.height/f.height),l.isResizeSensitive=true,s=true;}if(l.length=Math.ceil(n.getTotalLength()*h),isNaN(l.length)){m("vivus: cannot retrieve a path element length",n);return}this.map.push(l),n.style.strokeDasharray=`${l.length} ${l.length+this.dashGap*2}`,n.style.strokeDashoffset=String(l.length+this.dashGap),l.length+=this.dashGap,e+=l.length,this.renderPath(o);}),s&&m("vivus: this SVG contains non-scaling-strokes. Call instance.recalc() when the SVG is resized."),e=e===0?1:e,this.delay=this.delay===null?this.duration/3:this.delay,this.delayUnit=this.delay/(a.length>1?a.length-1:1),this.reverseStack&&this.map.reverse(),this.map.forEach((n,o)=>{let l=()=>{let h={};for(let{name:d,value:f}of Array.from(n.el.attributes))h[d]=f;return h};switch(this.type){case "delayed":n.startAt=this.delayUnit*o,n.duration=this.duration-this.delay;break;case "oneByOne":n.startAt=i/e*this.duration,n.duration=n.length/e*this.duration;break;case "sync":case "async":case "nsync":n.startAt=0,n.duration=this.duration;break;case "scenario-sync":{let h=l();n.startAt=t+(u(h["data-delay"],this.delayUnit)||0),n.duration=u(h["data-duration"],this.duration),t=h["data-async"]!==void 0?n.startAt:n.startAt+n.duration,this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}case "scenario":{let h=l();n.startAt=u(h["data-start"],this.delayUnit)||0,n.duration=u(h["data-duration"],this.duration),this.frameLength=Math.max(this.frameLength,n.startAt+n.duration);break}}i+=n.length,this.frameLength=this.frameLength||this.duration;});}recalc(){this.mustRecalcScale||(this.mustRecalcScale=requestAnimationFrame(()=>this.performLineRecalc()));}performLineRecalc(){for(let t of this.map){if(!t.isResizeSensitive)continue;let e=t.el.getBoundingClientRect(),i=t.el.getBBox(),s=Math.max(e.width/i.width,e.height/i.height);t.length=Math.ceil(t.el.getTotalLength()*s),t.el.style.strokeDasharray=`${t.length} ${t.length+this.dashGap*2}`;}this.trace(),this.mustRecalcScale=null;}draw(){if(this.currentFrame+=this.speed,this.currentFrame<=0)this.stop(),this.reset();else if(this.currentFrame>=this.frameLength)this.stop(),this.currentFrame=this.frameLength,this.trace(),this.selfDestroy&&this.destroy();else {this.trace(),this.handle=requestAnimationFrame(()=>this.draw());return}this.finished();}finished(){if(this.callback(this),this.instanceCallback){let t=this.instanceCallback;this.instanceCallback=null,t(this);}}trace(){let t=this.animTimingFunction(this.currentFrame/this.frameLength)*this.frameLength;this.map.forEach((e,i)=>{let s=this.pathTimingFunction(Math.max(0,Math.min(1,(t-e.startAt)/e.duration)));e.progress!==s&&(e.progress=s,e.el.style.strokeDashoffset=String(Math.floor(e.length*(1-s))),this.renderPath(i));});}renderPath(t){let e=this.forceRender&&this.map&&this.map[t];if(!e)return;let i=e.el.cloneNode(true);e.el.parentNode?.replaceChild(i,e.el),e.el=i;}init(){this.frameLength=0,this.currentFrame=0,this.map=[],R(this.el),this.mapping(),this.starter(),this.onReady&&this.onReady(this);}starter(){if(this.start==="manual")return;if(this.start==="autostart"){this.play();return}let t=()=>{this.isInViewport(this.parentEl,1)&&(this.play(),window.removeEventListener("scroll",t),this.viewportListener=null);};this.viewportListener=t,window.addEventListener("scroll",t),t();}getStatus(){return this.currentFrame===0?"start":this.currentFrame===this.frameLength?"end":"progress"}reset(){return this.setFrameProgress(0)}finish(){return this.setFrameProgress(1)}setFrameProgress(t){let e=Math.min(1,Math.max(0,t));return this.currentFrame=Math.round(this.frameLength*e),this.trace(),this}play(t,e){this.instanceCallback=null;let i=t;if(i&&typeof i=="function")this.instanceCallback=i,i=void 0;else if(i&&typeof i!="number")throw new Error("Vivus [play]: invalid speed");return e&&typeof e=="function"&&!this.instanceCallback&&(this.instanceCallback=e),this.speed=i||1,g()?(this.stop(),this.currentFrame=this.speed<0?0:this.frameLength,this.trace(),this.speed>0&&this.selfDestroy&&this.destroy(),this.finished(),this):(this.handle||this.draw(),this)}stop(){return this.handle&&(cancelAnimationFrame(this.handle),this.handle=null),this}destroy(){this.stop(),this.viewportListener&&(window.removeEventListener("scroll",this.viewportListener),this.viewportListener=null),this.map.forEach((t,e)=>{t.el.style.strokeDashoffset="",t.el.style.strokeDasharray="",this.renderPath(e);});}isInvisible(t){let e=t.getAttribute("data-ignore");if(e!==null)return e!=="false";if(this.ignoreInvisible){let i=t.getBoundingClientRect();return !i.width&&!i.height}return  false}isInViewport(t,e=0){let i=window.pageYOffset||document.documentElement.scrollTop,s=i+Math.max(document.documentElement.clientHeight,window.innerHeight),a=t.getBoundingClientRect(),n=i+a.top;return n+a.height*(e||0)<=s&&n+a.height>=i}};c.LINEAR=t=>t,c.EASE=t=>-Math.cos(t*Math.PI)/2+.5,c.EASE_OUT=t=>1-Math.pow(1-t,3),c.EASE_IN=t=>Math.pow(t,3),c.EASE_OUT_BOUNCE=t=>{let e=-Math.cos(t*(.5*Math.PI))+1,i=Math.pow(e,1.5),s=Math.pow(1-t,2),a=-Math.abs(Math.cos(i*(2.5*Math.PI)))+1;return 1-s+a*s};var p=c,O=p;
+export{p as Vivus,O as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svg-scroll-draw",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Scroll-driven animation for the web — draw SVG paths, reveal elements, pin sections, scrub video. Zero dependencies, native CSS fast path, works with React, Vue, Svelte, Solid, Angular, Astro and vanilla JS",
   "keywords": [
     "svg",
@@ -62,7 +62,11 @@
     "data-aos",
     "scrollreveal",
     "scrollreveal-alternative",
-    "scroll-reveal-mit"
+    "scroll-reveal-mit",
+    "vivus",
+    "vivus-alternative",
+    "svg-line-drawing",
+    "line-drawing"
   ],
   "homepage": "https://svg-scroll-draw.vercel.app",
   "repository": {
@@ -151,6 +155,9 @@
       ],
       "scrollreveal": [
         "./dist/scrollreveal/index.d.ts"
+      ],
+      "vivus": [
+        "./dist/vivus/index.d.ts"
       ]
     }
   },
@@ -390,6 +397,16 @@
         "default": "./dist/scrollreveal/index.cjs"
       }
     },
+    "./vivus": {
+      "import": {
+        "types": "./dist/vivus/index.d.mts",
+        "default": "./dist/vivus/index.mjs"
+      },
+      "require": {
+        "types": "./dist/vivus/index.d.ts",
+        "default": "./dist/vivus/index.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -417,6 +434,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.0.0",
+    "vivus": "^0.4.6",
     "vue": "^3.5.34"
   },
   "sideEffects": [
@@ -424,7 +442,8 @@
     "./dist/cdn/*",
     "./src/web-component/*",
     "./src/cdn.ts",
-    "./src/scrollreveal/cdn.ts"
+    "./src/scrollreveal/cdn.ts",
+    "./src/vivus/cdn.ts"
   ],
   "engines": {
     "node": ">=18"

package/dist/aos/index.d.mts

@@ -1,53 +0,0 @@
-type AOSAnchorPlacement = 'top-bottom' | 'top-center' | 'top-top' | 'center-bottom' | 'center-center' | 'center-top' | 'bottom-bottom' | 'bottom-center' | 'bottom-top';
-interface AOSOptions {
-    /** Px from the trigger point before the animation starts. Default 120. */
-    offset?: number;
-    /** Ms to wait before animating in. Default 0. */
-    delay?: number;
-    /** Animation length in ms. Default 400. */
-    duration?: number;
-    /** An AOS easing name (`'ease-out-back'`…) or any CSS timing function. Default `'ease'`. */
-    easing?: string;
-    /** Animate only the first time the element scrolls in. Default false. */
-    once?: boolean;
-    /** Animate out again when the element scrolls past the top. Default false. */
-    mirror?: boolean;
-    /** Which edge of the element meets which edge of the window. Default `'top-bottom'`. */
-    anchorPlacement?: AOSAnchorPlacement;
-    /** Skip animations entirely: a boolean, a predicate, or a viewport class. */
-    disable?: boolean | 'phone' | 'tablet' | 'mobile' | (() => boolean);
-    /** Document event that starts AOS. Default `'DOMContentLoaded'`. */
-    startEvent?: string;
-    /** Do not watch the DOM for new `[data-aos]` elements. Default false. */
-    disableMutationObserver?: boolean;
-    /** Class added at init. Default `'aos-init'`. */
-    initClassName?: string;
-    /** Class added while animated in. Default `'aos-animate'`. */
-    animatedClassName?: string;
-    /** Also add the `data-aos` value as classes (for animate.css-style sets). Default false. */
-    useClassNames?: boolean;
-    /** Accepted for compatibility; scroll handling is batched per frame instead. */
-    throttleDelay?: number;
-    /** Accepted for compatibility; resize handling is debounced internally. */
-    debounceDelay?: number;
-}
-/** Start animating every `[data-aos]` element. Same options as AOS. */
-declare function init(options?: AOSOptions): HTMLElement[];
-/** Recalculate every trigger position (after a layout change). */
-declare function refresh(): void;
-/** Find `[data-aos]` elements again (after adding or removing some), then refresh. */
-declare function refreshHard(): void;
-/**
- * Stop listening and remove the injected stylesheet. Not in AOS — added for
- * single-page apps that unmount the page AOS was started on. Elements keep
- * whatever classes they have.
- */
-declare function destroy(): void;
-declare const AOS: {
-    init: typeof init;
-    refresh: typeof refresh;
-    refreshHard: typeof refreshHard;
-    destroy: typeof destroy;
-};
-
-export { type AOSAnchorPlacement, type AOSOptions, AOS as default, destroy, init, refresh, refreshHard };

package/dist/aos/index.d.ts

@@ -1,53 +0,0 @@
-type AOSAnchorPlacement = 'top-bottom' | 'top-center' | 'top-top' | 'center-bottom' | 'center-center' | 'center-top' | 'bottom-bottom' | 'bottom-center' | 'bottom-top';
-interface AOSOptions {
-    /** Px from the trigger point before the animation starts. Default 120. */
-    offset?: number;
-    /** Ms to wait before animating in. Default 0. */
-    delay?: number;
-    /** Animation length in ms. Default 400. */
-    duration?: number;
-    /** An AOS easing name (`'ease-out-back'`…) or any CSS timing function. Default `'ease'`. */
-    easing?: string;
-    /** Animate only the first time the element scrolls in. Default false. */
-    once?: boolean;
-    /** Animate out again when the element scrolls past the top. Default false. */
-    mirror?: boolean;
-    /** Which edge of the element meets which edge of the window. Default `'top-bottom'`. */
-    anchorPlacement?: AOSAnchorPlacement;
-    /** Skip animations entirely: a boolean, a predicate, or a viewport class. */
-    disable?: boolean | 'phone' | 'tablet' | 'mobile' | (() => boolean);
-    /** Document event that starts AOS. Default `'DOMContentLoaded'`. */
-    startEvent?: string;
-    /** Do not watch the DOM for new `[data-aos]` elements. Default false. */
-    disableMutationObserver?: boolean;
-    /** Class added at init. Default `'aos-init'`. */
-    initClassName?: string;
-    /** Class added while animated in. Default `'aos-animate'`. */
-    animatedClassName?: string;
-    /** Also add the `data-aos` value as classes (for animate.css-style sets). Default false. */
-    useClassNames?: boolean;
-    /** Accepted for compatibility; scroll handling is batched per frame instead. */
-    throttleDelay?: number;
-    /** Accepted for compatibility; resize handling is debounced internally. */
-    debounceDelay?: number;
-}
-/** Start animating every `[data-aos]` element. Same options as AOS. */
-declare function init(options?: AOSOptions): HTMLElement[];
-/** Recalculate every trigger position (after a layout change). */
-declare function refresh(): void;
-/** Find `[data-aos]` elements again (after adding or removing some), then refresh. */
-declare function refreshHard(): void;
-/**
- * Stop listening and remove the injected stylesheet. Not in AOS — added for
- * single-page apps that unmount the page AOS was started on. Elements keep
- * whatever classes they have.
- */
-declare function destroy(): void;
-declare const AOS: {
-    init: typeof init;
-    refresh: typeof refresh;
-    refreshHard: typeof refreshHard;
-    destroy: typeof destroy;
-};
-
-export { type AOSAnchorPlacement, type AOSOptions, AOS as default, destroy, init, refresh, refreshHard };

package/dist/cinematic/index.d.mts

@@ -1,72 +0,0 @@
-type StoryEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring' | 'bounce' | 'elastic';
-/** A traced path that strokes itself on across a scroll range. */
-interface DrawAnimation {
-    type: 'draw';
-    /** DOM id the runtime binds to (with leading '#'), e.g. "#path-3". */
-    target: string;
-    /** SVG path data, in canvas coordinates. */
-    d: string;
-    /** Pre-measured total path length (px). */
-    length: number;
-    /** Scroll progress where the draw begins, e.g. "20%". */
-    start: string;
-    /** Scroll progress where the draw completes, e.g. "50%". */
-    end: string;
-    stroke: string;
-    strokeWidth: number;
-    easing: StoryEasing;
-}
-/** Any layer fading opacity across a scroll range. */
-interface FadeAnimation {
-    type: 'fade';
-    target: string;
-    start: string;
-    end: string;
-    from: number;
-    to: number;
-}
-type StoryAnimation = DrawAnimation | FadeAnimation;
-interface StoryScene {
-    id: string;
-    /** Optional background layer (a product photo) as a data URL or remote URL. */
-    background?: string;
-    animations: StoryAnimation[];
-}
-interface Story {
-    version: 1;
-    /** Total scroll height of the experience, e.g. "400vh". */
-    totalHeight: string;
-    /** The authoring viewBox the coordinates are expressed in. */
-    canvas: {
-        width: number;
-        height: number;
-    };
-    scenes: StoryScene[];
-}
-
-interface CinematicOptions {
-    /** Mount point — a selector or element. Becomes the scroll wrapper. */
-    wrapper: string | HTMLElement;
-}
-interface CinematicInstance {
-    /** Stop the scroll loop and detach observers (built DOM is left in place). */
-    destroy: () => void;
-    /** Current global scroll progress through the story (0–1). */
-    getProgress: () => number;
-}
-/**
- * The viral loader. Reads a Cinematic Story (authored in the Studio) and wires
- * a scroll-scrubbed timeline: paths stroke themselves on and layers fade in as
- * the user scrolls, all driven off the wrapper's scroll progress.
- *
- *   import { Cinematic } from "svg-scroll-draw";
- *   import story from "./story.json";
- *   new Cinematic({ wrapper: "#app" }).loadStory(story);
- */
-declare class Cinematic {
-    private mount;
-    constructor(options: CinematicOptions);
-    loadStory(story: Story): CinematicInstance;
-}
-
-export { Cinematic, type CinematicInstance, type CinematicOptions, type DrawAnimation, type FadeAnimation, type Story, type StoryAnimation, type StoryEasing, type StoryScene };

package/dist/cinematic/index.d.ts

@@ -1,72 +0,0 @@
-type StoryEasing = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring' | 'bounce' | 'elastic';
-/** A traced path that strokes itself on across a scroll range. */
-interface DrawAnimation {
-    type: 'draw';
-    /** DOM id the runtime binds to (with leading '#'), e.g. "#path-3". */
-    target: string;
-    /** SVG path data, in canvas coordinates. */
-    d: string;
-    /** Pre-measured total path length (px). */
-    length: number;
-    /** Scroll progress where the draw begins, e.g. "20%". */
-    start: string;
-    /** Scroll progress where the draw completes, e.g. "50%". */
-    end: string;
-    stroke: string;
-    strokeWidth: number;
-    easing: StoryEasing;
-}
-/** Any layer fading opacity across a scroll range. */
-interface FadeAnimation {
-    type: 'fade';
-    target: string;
-    start: string;
-    end: string;
-    from: number;
-    to: number;
-}
-type StoryAnimation = DrawAnimation | FadeAnimation;
-interface StoryScene {
-    id: string;
-    /** Optional background layer (a product photo) as a data URL or remote URL. */
-    background?: string;
-    animations: StoryAnimation[];
-}
-interface Story {
-    version: 1;
-    /** Total scroll height of the experience, e.g. "400vh". */
-    totalHeight: string;
-    /** The authoring viewBox the coordinates are expressed in. */
-    canvas: {
-        width: number;
-        height: number;
-    };
-    scenes: StoryScene[];
-}
-
-interface CinematicOptions {
-    /** Mount point — a selector or element. Becomes the scroll wrapper. */
-    wrapper: string | HTMLElement;
-}
-interface CinematicInstance {
-    /** Stop the scroll loop and detach observers (built DOM is left in place). */
-    destroy: () => void;
-    /** Current global scroll progress through the story (0–1). */
-    getProgress: () => number;
-}
-/**
- * The viral loader. Reads a Cinematic Story (authored in the Studio) and wires
- * a scroll-scrubbed timeline: paths stroke themselves on and layers fade in as
- * the user scrolls, all driven off the wrapper's scroll progress.
- *
- *   import { Cinematic } from "svg-scroll-draw";
- *   import story from "./story.json";
- *   new Cinematic({ wrapper: "#app" }).loadStory(story);
- */
-declare class Cinematic {
-    private mount;
-    constructor(options: CinematicOptions);
-    loadStory(story: Story): CinematicInstance;
-}
-
-export { Cinematic, type CinematicInstance, type CinematicOptions, type DrawAnimation, type FadeAnimation, type Story, type StoryAnimation, type StoryEasing, type StoryScene };

package/dist/devtools/index.d.mts

@@ -1,12 +0,0 @@
-declare function enable(): void;
-declare function disable(): void;
-declare function toggle(): void;
-declare function highlight(target: string | Element): void;
-declare const devtools: {
-    enable: typeof enable;
-    disable: typeof disable;
-    toggle: typeof toggle;
-    highlight: typeof highlight;
-};
-
-export { devtools };

package/dist/devtools/index.d.ts

@@ -1,12 +0,0 @@
-declare function enable(): void;
-declare function disable(): void;
-declare function toggle(): void;
-declare function highlight(target: string | Element): void;
-declare const devtools: {
-    enable: typeof enable;
-    disable: typeof disable;
-    toggle: typeof toggle;
-    highlight: typeof highlight;
-};
-
-export { devtools };

package/dist/text/index.d.mts

@@ -1,52 +0,0 @@
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring' | 'bounce' | 'elastic';
-interface TriggerConfig {
-    start?: string;
-    end?: string;
-}
-interface ScrollDrawInstance {
-    destroy: () => void;
-    /** Reset and replay the animation from the beginning. */
-    replay: () => void;
-    /** Pause the animation at the current progress. */
-    pause: () => void;
-    /** Resume a paused animation. */
-    resume: () => void;
-    /** Jump to a specific progress value (0–1) and pause. */
-    seek: (progress: number) => void;
-    /** Returns current draw progress (0–1). */
-    getProgress: () => number;
-    /**
-     * Re-measure after a layout change: path lengths, and the scroll trigger window.
-     *
-     * The engine already re-measures on `resize`, on `orientationchange`, and via a
-     * `ResizeObserver` on the document element — but none of those fire for a layout
-     * change that leaves the document height alone, such as a tab switching, a
-     * sibling collapsing, or a font swapping inside a fixed-height box. Call this
-     * after one of those.
-     *
-     * Optional on this shared type because several instances here are fan-outs over
-     * other instances or SSR no-op stubs. `scrollDraw`, `scrollPin`,
-     * `scrollHorizontal`, `scrollDrawTimeline` and the group APIs all provide it;
-     * use `instance.refresh?.()` if you hold an instance of unknown origin.
-     */
-    refresh?: () => void;
-}
-
-interface ScrollTextOptions {
-    split?: 'chars' | 'words' | 'lines';
-    stagger?: number;
-    easing?: EasingName | ((t: number) => number);
-    from?: {
-        opacity?: number;
-        y?: number;
-        x?: number;
-        rotate?: number;
-        scale?: number;
-    };
-    trigger?: TriggerConfig;
-    once?: boolean;
-    onComplete?: () => void;
-}
-declare function scrollText(target: string | Element, options?: ScrollTextOptions): ScrollDrawInstance;
-
-export { type ScrollTextOptions, scrollText };

package/dist/text/index.d.ts

@@ -1,52 +0,0 @@
-type EasingName = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'spring' | 'bounce' | 'elastic';
-interface TriggerConfig {
-    start?: string;
-    end?: string;
-}
-interface ScrollDrawInstance {
-    destroy: () => void;
-    /** Reset and replay the animation from the beginning. */
-    replay: () => void;
-    /** Pause the animation at the current progress. */
-    pause: () => void;
-    /** Resume a paused animation. */
-    resume: () => void;
-    /** Jump to a specific progress value (0–1) and pause. */
-    seek: (progress: number) => void;
-    /** Returns current draw progress (0–1). */
-    getProgress: () => number;
-    /**
-     * Re-measure after a layout change: path lengths, and the scroll trigger window.
-     *
-     * The engine already re-measures on `resize`, on `orientationchange`, and via a
-     * `ResizeObserver` on the document element — but none of those fire for a layout
-     * change that leaves the document height alone, such as a tab switching, a
-     * sibling collapsing, or a font swapping inside a fixed-height box. Call this
-     * after one of those.
-     *
-     * Optional on this shared type because several instances here are fan-outs over
-     * other instances or SSR no-op stubs. `scrollDraw`, `scrollPin`,
-     * `scrollHorizontal`, `scrollDrawTimeline` and the group APIs all provide it;
-     * use `instance.refresh?.()` if you hold an instance of unknown origin.
-     */
-    refresh?: () => void;
-}
-
-interface ScrollTextOptions {
-    split?: 'chars' | 'words' | 'lines';
-    stagger?: number;
-    easing?: EasingName | ((t: number) => number);
-    from?: {
-        opacity?: number;
-        y?: number;
-        x?: number;
-        rotate?: number;
-        scale?: number;
-    };
-    trigger?: TriggerConfig;
-    once?: boolean;
-    onComplete?: () => void;
-}
-declare function scrollText(target: string | Element, options?: ScrollTextOptions): ScrollDrawInstance;
-
-export { type ScrollTextOptions, scrollText };