@motion-script/core 0.1.0

package/dist/attributes/shape/path/dash.js

@@ -0,0 +1,299 @@
+import { calculatePathLength } from "./length";
+import { cubicAxis, quadAxis, distance, isSmoothCurveType, reflectControlPoint, } from "./bezier";
+/** Number of line segments each curve is flattened into when sampling. */
+const SAMPLE_STEPS = 50;
+/**
+ * Flattens path commands into one polyline per subpath. Curves are sampled into
+ * {@link SAMPLE_STEPS} straight segments; the resulting points are what the dash
+ * walker steps along to emit dashes at uniform arc-length intervals.
+ */
+function samplePathCommands(commands) {
+    const subpaths = [];
+    let current = [];
+    let curX = 0, curY = 0;
+    let startX = 0, startY = 0;
+    let prevCpX = 0, prevCpY = 0;
+    const startSubpath = (x, y) => {
+        if (current.length > 0)
+            subpaths.push(current);
+        current = [{ x, y }];
+        startX = x;
+        startY = y;
+    };
+    const add = (x, y) => current.push({ x, y });
+    for (const cmd of commands) {
+        let nextX = curX, nextY = curY;
+        let nextCpX = curX, nextCpY = curY;
+        switch (cmd.type) {
+            case 'M':
+                startSubpath(cmd.x, cmd.y);
+                nextX = cmd.x;
+                nextY = cmd.y;
+                break;
+            case 'm':
+                startSubpath(curX + cmd.x, curY + cmd.y);
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                break;
+            case 'L':
+                nextX = cmd.x;
+                nextY = cmd.y;
+                add(nextX, nextY);
+                break;
+            case 'l':
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                add(nextX, nextY);
+                break;
+            case 'H':
+                nextX = cmd.x;
+                add(nextX, curY);
+                break;
+            case 'h':
+                nextX = curX + cmd.x;
+                add(nextX, curY);
+                break;
+            case 'V':
+                nextY = cmd.y;
+                add(curX, nextY);
+                break;
+            case 'v':
+                nextY = curY + cmd.y;
+                add(curX, nextY);
+                break;
+            case 'C': {
+                nextCpX = cmd.x2;
+                nextCpY = cmd.y2;
+                nextX = cmd.x;
+                nextY = cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(cubicAxis(t, curX, cmd.x1, cmd.x2, nextX), cubicAxis(t, curY, cmd.y1, cmd.y2, nextY));
+                }
+                break;
+            }
+            case 'c': {
+                const ax1 = curX + cmd.x1, ay1 = curY + cmd.y1;
+                const ax2 = curX + cmd.x2, ay2 = curY + cmd.y2;
+                nextCpX = ax2;
+                nextCpY = ay2;
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(cubicAxis(t, curX, ax1, ax2, nextX), cubicAxis(t, curY, ay1, ay2, nextY));
+                }
+                break;
+            }
+            case 'S': {
+                const cp1x = reflectControlPoint(curX, prevCpX), cp1y = reflectControlPoint(curY, prevCpY);
+                nextCpX = cmd.x2;
+                nextCpY = cmd.y2;
+                nextX = cmd.x;
+                nextY = cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(cubicAxis(t, curX, cp1x, cmd.x2, nextX), cubicAxis(t, curY, cp1y, cmd.y2, nextY));
+                }
+                break;
+            }
+            case 's': {
+                const cp1x = reflectControlPoint(curX, prevCpX), cp1y = reflectControlPoint(curY, prevCpY);
+                const ax2 = curX + cmd.x2, ay2 = curY + cmd.y2;
+                nextCpX = ax2;
+                nextCpY = ay2;
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(cubicAxis(t, curX, cp1x, ax2, nextX), cubicAxis(t, curY, cp1y, ay2, nextY));
+                }
+                break;
+            }
+            case 'Q': {
+                nextCpX = cmd.x1;
+                nextCpY = cmd.y1;
+                nextX = cmd.x;
+                nextY = cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(quadAxis(t, curX, cmd.x1, nextX), quadAxis(t, curY, cmd.y1, nextY));
+                }
+                break;
+            }
+            case 'q': {
+                const ax1 = curX + cmd.x1, ay1 = curY + cmd.y1;
+                nextCpX = ax1;
+                nextCpY = ay1;
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(quadAxis(t, curX, ax1, nextX), quadAxis(t, curY, ay1, nextY));
+                }
+                break;
+            }
+            case 'T': {
+                const cp1x = reflectControlPoint(curX, prevCpX), cp1y = reflectControlPoint(curY, prevCpY);
+                nextCpX = cp1x;
+                nextCpY = cp1y;
+                nextX = cmd.x;
+                nextY = cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(quadAxis(t, curX, cp1x, nextX), quadAxis(t, curY, cp1y, nextY));
+                }
+                break;
+            }
+            case 't': {
+                const cp1x = reflectControlPoint(curX, prevCpX), cp1y = reflectControlPoint(curY, prevCpY);
+                nextCpX = cp1x;
+                nextCpY = cp1y;
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(quadAxis(t, curX, cp1x, nextX), quadAxis(t, curY, cp1y, nextY));
+                }
+                break;
+            }
+            case 'A': {
+                // Linear approximation for arcs
+                nextX = cmd.x;
+                nextY = cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(curX + t * (nextX - curX), curY + t * (nextY - curY));
+                }
+                break;
+            }
+            case 'a': {
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                for (let i = 1; i <= SAMPLE_STEPS; i++) {
+                    const t = i / SAMPLE_STEPS;
+                    add(curX + t * (nextX - curX), curY + t * (nextY - curY));
+                }
+                break;
+            }
+            case 'Z':
+            case 'z':
+                if (curX !== startX || curY !== startY) {
+                    add(startX, startY);
+                }
+                nextX = startX;
+                nextY = startY;
+                break;
+        }
+        curX = nextX;
+        curY = nextY;
+        if (isSmoothCurveType(cmd.type)) {
+            prevCpX = nextCpX;
+            prevCpY = nextCpY;
+        }
+        else {
+            prevCpX = curX;
+            prevCpY = curY;
+        }
+    }
+    if (current.length > 0)
+        subpaths.push(current);
+    return subpaths;
+}
+/**
+ * Walks a flattened subpath at constant speed, emitting `M`/`L` commands for the
+ * "on" runs of the dash pattern. `scaledDash` alternates on/off lengths starting
+ * with "on"; the index wraps so the pattern repeats along the whole subpath.
+ */
+function dashSubpath(points, scaledDash) {
+    if (points.length < 2)
+        return '';
+    const parts = [];
+    let dashIndex = 0;
+    let remaining = scaledDash[0]; // Distance left in the current dash segment.
+    let isOn = true; // Whether we're currently drawing (on) or skipping (off).
+    let needMove = true; // Whether the next "on" run still needs an opening M.
+    for (let i = 1; i < points.length; i++) {
+        const p0 = points[i - 1];
+        const p1 = points[i];
+        const dx = p1.x - p0.x;
+        const dy = p1.y - p0.y;
+        const segLen = distance(p0, p1);
+        if (segLen === 0)
+            continue;
+        let walked = 0;
+        while (walked < segLen) {
+            const available = segLen - walked;
+            if (remaining >= available) {
+                if (isOn) {
+                    if (needMove) {
+                        const t = walked / segLen;
+                        parts.push(`M ${p0.x + t * dx} ${p0.y + t * dy}`);
+                        needMove = false;
+                    }
+                    parts.push(`L ${p1.x} ${p1.y}`);
+                }
+                remaining -= available;
+                walked = segLen;
+                if (remaining === 0) {
+                    dashIndex = (dashIndex + 1) % scaledDash.length;
+                    isOn = !isOn;
+                    remaining = scaledDash[dashIndex];
+                    if (isOn)
+                        needMove = true;
+                }
+            }
+            else {
+                const endT = (walked + remaining) / segLen;
+                const endX = p0.x + endT * dx;
+                const endY = p0.y + endT * dy;
+                if (isOn) {
+                    if (needMove) {
+                        const startT = walked / segLen;
+                        parts.push(`M ${p0.x + startT * dx} ${p0.y + startT * dy}`);
+                        needMove = false;
+                    }
+                    parts.push(`L ${endX} ${endY}`);
+                }
+                walked += remaining;
+                dashIndex = (dashIndex + 1) % scaledDash.length;
+                isOn = !isOn;
+                remaining = scaledDash[dashIndex];
+                if (isOn)
+                    needMove = true;
+            }
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Converts path commands into a dashed SVG path string.
+ *
+ * The dash pattern is scaled uniformly so a whole number of cycles spans the path
+ * length — this avoids a half-cut dash at the start or end. Each subpath is then
+ * flattened and walked, emitting only the "on" runs.
+ *
+ * @param commands Path commands to dash.
+ * @param dash     Alternating on/off lengths (e.g. `[4, 2]` = 4 on, 2 off).
+ * @returns An SVG path `d` string containing only the visible dash segments,
+ *          or `''` when there is nothing to draw.
+ */
+export function applyDashPattern(commands, dash) {
+    if (!dash || dash.length === 0)
+        return '';
+    const cycleLength = dash.reduce((a, b) => a + b, 0);
+    if (cycleLength <= 0)
+        return '';
+    const totalLength = calculatePathLength(commands);
+    if (totalLength <= 0)
+        return '';
+    const cycles = Math.max(1, Math.round(totalLength / cycleLength));
+    const scale = totalLength / (cycles * cycleLength);
+    const scaledDash = dash.map(d => d * scale);
+    const subpaths = samplePathCommands(commands);
+    return subpaths
+        .map(sub => dashSubpath(sub, scaledDash))
+        .filter(Boolean)
+        .join(' ');
+}
+//# sourceMappingURL=dash.js.map

package/dist/attributes/shape/path/dash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.js","sourceRoot":"","sources":["../../../../src/attributes/shape/path/dash.ts"],"names":[],"mappings":"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"}

package/dist/attributes/shape/path/dash.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dash.test.d.ts.map

package/dist/attributes/shape/path/dash.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.test.d.ts","sourceRoot":"","sources":["../../../../src/attributes/shape/path/dash.test.ts"],"names":[],"mappings":""}

package/dist/attributes/shape/path/dash.test.js

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { applyDashPattern } from '@/attributes/shape/path/dash';
+const line = [
+    { type: 'M', x: 0, y: 0 },
+    { type: 'L', x: 100, y: 0 },
+];
+describe('applyDashPattern – guards', () => {
+    it('returns empty string for an empty dash array', () => {
+        expect(applyDashPattern(line, [])).toBe('');
+    });
+    it('returns empty string when the dash cycle sums to zero', () => {
+        expect(applyDashPattern(line, [0, 0])).toBe('');
+    });
+    it('returns empty string for a zero-length path', () => {
+        const point = [{ type: 'M', x: 5, y: 5 }];
+        expect(applyDashPattern(point, [4, 4])).toBe('');
+    });
+});
+describe('applyDashPattern – output', () => {
+    it('produces an SVG path string containing move and line commands', () => {
+        const out = applyDashPattern(line, [10, 10]);
+        expect(out).toMatch(/M /);
+        expect(out).toMatch(/L /);
+    });
+    it('begins drawing (an "on" run) at the path start', () => {
+        const out = applyDashPattern(line, [10, 10]);
+        expect(out.trimStart().startsWith('M')).toBe(true);
+    });
+    it('emits dashes only along an "on" run, leaving gaps for "off"', () => {
+        // A coarse pattern over a 100px line should yield multiple separate runs.
+        const out = applyDashPattern(line, [10, 10]);
+        const moveCount = (out.match(/M /g) ?? []).length;
+        expect(moveCount).toBeGreaterThan(1);
+    });
+});
+//# sourceMappingURL=dash.test.js.map

package/dist/attributes/shape/path/dash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.test.js","sourceRoot":"","sources":["../../../../src/attributes/shape/path/dash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,MAAM,IAAI,GAAkB;IACxB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACzB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;CAC9B,CAAC;AAEF,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAkB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,0EAA0E;QAC1E,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAClD,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/attributes/shape/path/index.d.ts

@@ -0,0 +1,5 @@
+/** Path geometry: length measurement, dash patterning, and arc-length trimming. */
+export { calculatePathLength } from './length';
+export { applyDashPattern } from './dash';
+export { extractSubpath } from './subpath';
+//# sourceMappingURL=index.d.ts.map

package/dist/attributes/shape/path/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/attributes/shape/path/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/attributes/shape/path/index.js

@@ -0,0 +1,5 @@
+/** Path geometry: length measurement, dash patterning, and arc-length trimming. */
+export { calculatePathLength } from './length';
+export { applyDashPattern } from './dash';
+export { extractSubpath } from './subpath';
+//# sourceMappingURL=index.js.map

package/dist/attributes/shape/path/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/attributes/shape/path/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/attributes/shape/path/length.d.ts

@@ -0,0 +1,14 @@
+import { PathCommand } from "../../../render/descriptors/path";
+/**
+ * Estimates the total length of an SVG path by walking its commands and summing
+ * each segment's length. Straight segments (L/H/V/Z) are measured exactly; curves
+ * (C/S/Q/T) are flattened into `steps` line segments and summed.
+ *
+ * Arcs (A/a) are approximated as a straight chord — see the note in the A/a case.
+ * For exact arc lengths, convert arcs to cubic Béziers before calling this.
+ *
+ * @param path  Path commands to measure (absolute or relative).
+ * @param steps Flattening resolution for curved segments. Higher is more accurate.
+ */
+export declare function calculatePathLength(path: PathCommand[], steps?: number): number;
+//# sourceMappingURL=length.d.ts.map

package/dist/attributes/shape/path/length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.d.ts","sourceRoot":"","sources":["../../../../src/attributes/shape/path/length.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AASxD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAoJnF"}

package/dist/attributes/shape/path/length.js

@@ -0,0 +1,169 @@
+import { cubicAxis, quadAxis, isSmoothCurveType, reflectControlPoint, sampleCurveLength, } from "./bezier";
+/**
+ * Estimates the total length of an SVG path by walking its commands and summing
+ * each segment's length. Straight segments (L/H/V/Z) are measured exactly; curves
+ * (C/S/Q/T) are flattened into `steps` line segments and summed.
+ *
+ * Arcs (A/a) are approximated as a straight chord — see the note in the A/a case.
+ * For exact arc lengths, convert arcs to cubic Béziers before calling this.
+ *
+ * @param path  Path commands to measure (absolute or relative).
+ * @param steps Flattening resolution for curved segments. Higher is more accurate.
+ */
+export function calculatePathLength(path, steps = 20) {
+    let totalLength = 0;
+    // Pen state.
+    let curX = 0;
+    let curY = 0;
+    let startX = 0;
+    let startY = 0;
+    // Trailing control point of the previous curve, used to reflect S/T commands.
+    let prevCpX = 0;
+    let prevCpY = 0;
+    const cubicLength = (x0, y0, x1, y1, x2, y2, x3, y3) => sampleCurveLength((t) => ({ x: cubicAxis(t, x0, x1, x2, x3), y: cubicAxis(t, y0, y1, y2, y3) }), steps);
+    const quadLength = (x0, y0, x1, y1, x2, y2) => sampleCurveLength((t) => ({ x: quadAxis(t, x0, x1, x2), y: quadAxis(t, y0, y1, y2) }), steps);
+    for (const cmd of path) {
+        let nextX = curX, nextY = curY;
+        let nextCpX = curX, nextCpY = curY;
+        let segmentLength = 0;
+        switch (cmd.type) {
+            case 'M':
+                nextX = cmd.x;
+                nextY = cmd.y;
+                startX = nextX;
+                startY = nextY;
+                break;
+            case 'm':
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                startX = nextX;
+                startY = nextY;
+                break;
+            case 'L':
+                nextX = cmd.x;
+                nextY = cmd.y;
+                segmentLength = Math.sqrt((nextX - curX) ** 2 + (nextY - curY) ** 2);
+                break;
+            case 'l':
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                segmentLength = Math.sqrt(cmd.x ** 2 + cmd.y ** 2);
+                break;
+            case 'H':
+                nextX = cmd.x;
+                segmentLength = Math.abs(nextX - curX);
+                break;
+            case 'h':
+                nextX = curX + cmd.x;
+                segmentLength = Math.abs(cmd.x);
+                break;
+            case 'V':
+                nextY = cmd.y;
+                segmentLength = Math.abs(nextY - curY);
+                break;
+            case 'v':
+                nextY = curY + cmd.y;
+                segmentLength = Math.abs(cmd.y);
+                break;
+            case 'C':
+                nextX = cmd.x;
+                nextY = cmd.y;
+                nextCpX = cmd.x2;
+                nextCpY = cmd.y2;
+                segmentLength = cubicLength(curX, curY, cmd.x1, cmd.y1, cmd.x2, cmd.y2, nextX, nextY);
+                break;
+            case 'c':
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                nextCpX = curX + cmd.x2;
+                nextCpY = curY + cmd.y2;
+                segmentLength = cubicLength(curX, curY, curX + cmd.x1, curY + cmd.y1, curX + cmd.x2, curY + cmd.y2, nextX, nextY);
+                break;
+            case 'S': {
+                const cp1x = reflectControlPoint(curX, prevCpX);
+                const cp1y = reflectControlPoint(curY, prevCpY);
+                nextX = cmd.x;
+                nextY = cmd.y;
+                nextCpX = cmd.x2;
+                nextCpY = cmd.y2;
+                segmentLength = cubicLength(curX, curY, cp1x, cp1y, cmd.x2, cmd.y2, nextX, nextY);
+                break;
+            }
+            case 's': {
+                const cp1x = reflectControlPoint(curX, prevCpX);
+                const cp1y = reflectControlPoint(curY, prevCpY);
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                nextCpX = curX + cmd.x2;
+                nextCpY = curY + cmd.y2;
+                segmentLength = cubicLength(curX, curY, cp1x, cp1y, curX + cmd.x2, curY + cmd.y2, nextX, nextY);
+                break;
+            }
+            case 'Q':
+                nextX = cmd.x;
+                nextY = cmd.y;
+                nextCpX = cmd.x1;
+                nextCpY = cmd.y1;
+                segmentLength = quadLength(curX, curY, cmd.x1, cmd.y1, nextX, nextY);
+                break;
+            case 'q':
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                nextCpX = curX + cmd.x1;
+                nextCpY = curY + cmd.y1;
+                segmentLength = quadLength(curX, curY, curX + cmd.x1, curY + cmd.y1, nextX, nextY);
+                break;
+            case 'T': {
+                const cp1x = reflectControlPoint(curX, prevCpX);
+                const cp1y = reflectControlPoint(curY, prevCpY);
+                nextX = cmd.x;
+                nextY = cmd.y;
+                nextCpX = cp1x;
+                nextCpY = cp1y;
+                segmentLength = quadLength(curX, curY, cp1x, cp1y, nextX, nextY);
+                break;
+            }
+            case 't': {
+                const cp1x = reflectControlPoint(curX, prevCpX);
+                const cp1y = reflectControlPoint(curY, prevCpY);
+                nextX = curX + cmd.x;
+                nextY = curY + cmd.y;
+                nextCpX = cp1x;
+                nextCpY = cp1y;
+                segmentLength = quadLength(curX, curY, cp1x, cp1y, nextX, nextY);
+                break;
+            }
+            case 'A':
+            case 'a':
+                // Note: True arc length requires complex conversion to center-parameterization.
+                // Approximating as a straight line to the end point.
+                // For exact arc lengths, convert arcs to cubic beziers before passing to this function.
+                nextX = cmd.type === 'A' ? cmd.x : curX + cmd.x;
+                nextY = cmd.type === 'A' ? cmd.y : curY + cmd.y;
+                segmentLength = Math.sqrt((nextX - curX) ** 2 + (nextY - curY) ** 2);
+                break;
+            case 'Z':
+            case 'z':
+                nextX = startX;
+                nextY = startY;
+                segmentLength = Math.sqrt((nextX - curX) ** 2 + (nextY - curY) ** 2);
+                break;
+        }
+        totalLength += segmentLength;
+        // Advance the pen.
+        curX = nextX;
+        curY = nextY;
+        // Remember the trailing control point so a following S/T can reflect it.
+        // If this command wasn't a curve, the implied control point is the current point.
+        if (isSmoothCurveType(cmd.type)) {
+            prevCpX = nextCpX;
+            prevCpY = nextCpY;
+        }
+        else {
+            prevCpX = curX;
+            prevCpY = curY;
+        }
+    }
+    return totalLength;
+}
+//# sourceMappingURL=length.js.map

package/dist/attributes/shape/path/length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.js","sourceRoot":"","sources":["../../../../src/attributes/shape/path/length.ts"],"names":[],"mappings":"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"}

package/dist/attributes/shape/path/length.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=length.test.d.ts.map

package/dist/attributes/shape/path/length.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length.test.d.ts","sourceRoot":"","sources":["../../../../src/attributes/shape/path/length.test.ts"],"names":[],"mappings":""}

package/dist/attributes/shape/path/length.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { calculatePathLength } from '@/attributes/shape/path/length';
+describe('calculatePathLength', () => {
+    it('returns 0 for an empty path', () => {
+        expect(calculatePathLength([])).toBe(0);
+    });
+    it('measures a single straight line', () => {
+        const path = [
+            { type: 'M', x: 0, y: 0 },
+            { type: 'L', x: 3, y: 4 },
+        ];
+        expect(calculatePathLength(path)).toBe(5);
+    });
+    it('sums H/V/Z into a closed-square perimeter', () => {
+        const path = [
+            { type: 'M', x: 0, y: 0 },
+            { type: 'H', x: 10 },
+            { type: 'V', y: 10 },
+            { type: 'H', x: 0 },
+            { type: 'Z' },
+        ];
+        expect(calculatePathLength(path)).toBe(40);
+    });
+    it('treats a move (M) as zero-length travel', () => {
+        const path = [
+            { type: 'M', x: 0, y: 0 },
+            { type: 'L', x: 10, y: 0 },
+            { type: 'M', x: 100, y: 100 },
+            { type: 'L', x: 110, y: 100 },
+        ];
+        expect(calculatePathLength(path)).toBe(20);
+    });
+    it('handles relative line commands', () => {
+        const path = [
+            { type: 'm', x: 5, y: 5 },
+            { type: 'l', x: 3, y: 4 },
+        ];
+        expect(calculatePathLength(path)).toBe(5);
+    });
+    it('measures a cubic curve as positive length close to its chord for a flat curve', () => {
+        const path = [
+            { type: 'M', x: 0, y: 0 },
+            { type: 'C', x1: 3.33, y1: 0, x2: 6.66, y2: 0, x: 10, y: 0 },
+        ];
+        // Control points colinear with endpoints → length equals the chord.
+        expect(calculatePathLength(path)).toBeCloseTo(10, 5);
+    });
+    it('approximates an arc as a straight chord', () => {
+        const path = [
+            { type: 'M', x: 0, y: 0 },
+            { type: 'A', rx: 5, ry: 5, rotation: 0, largeArc: 0, sweep: 1, x: 0, y: 10 },
+        ];
+        expect(calculatePathLength(path)).toBe(10);
+    });
+});
+//# sourceMappingURL=length.test.js.map