@flighthq/path-formats 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './svgPathData';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './svgPathData';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/svgPathData.d.ts

@@ -0,0 +1,34 @@
+import type { Path } from '@flighthq/types';
+/**
+ * Parses an SVG path `d` string into the end of an existing `path`, appending its contours via the
+ * `@flighthq/path` builders. Supports the full SVG path grammar: absolute (uppercase) and relative
+ * (lowercase) `M L H V C S Q T A Z`, implicit repeated commands, and the smooth-curve shorthands
+ * `S`/`T` (reflecting the previous cubic/quadratic control point). Returns `false` without further
+ * mutation guarantee on structurally malformed input (a leading command that is not moveto, an
+ * unknown command letter, or a missing/short coordinate run); returns `true` when the whole string
+ * parses. An empty or whitespace-only string is well-formed and appends nothing.
+ *
+ * Elliptic arcs (`A`/`a`) are appended through `appendPathArcTo`, which approximates them as cubic
+ * bezier segments — a subsequent `forEachPathSegment` walk (and `formatSvgPathData`) therefore sees
+ * cubics, not an arc verb. The geometry round-trips; the arc command does not.
+ */
+export declare function appendSvgPathData(path: Path, d: string): boolean;
+/**
+ * Serializes a `Path` to an SVG path `d` string, emitting absolute commands. Each `PathSegment`
+ * maps to its SVG verb: `moveTo`→`M`, `lineTo`→`L`, `curveTo` (quadratic)→`Q`, `cubicCurveTo`→`C`,
+ * `close`→`Z`. Arcs are not a distinct segment kind — the path stores them as cubics — so no `A`
+ * command is produced.
+ *
+ * `options.precision`, when given, rounds every coordinate to that many decimal places and drops
+ * trailing zeros; the default emits full-precision numbers (also trailing-zero-free).
+ */
+export declare function formatSvgPathData(path: Readonly<Path>, options?: Readonly<{
+    precision?: number;
+}>): string;
+/**
+ * Parses an SVG path `d` string into a freshly allocated `Path`, or returns `null` on structurally
+ * malformed input (see `appendSvgPathData` for the malformed cases). An empty or whitespace-only
+ * string yields an empty path, not `null`.
+ */
+export declare function parseSvgPathData(d: string): Path | null;
+//# sourceMappingURL=svgPathData.d.ts.map

package/dist/svgPathData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgPathData.d.ts","sourceRoot":"","sources":["../src/svgPathData.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAqPhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAwB1G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIvD"}

package/dist/svgPathData.js

@@ -0,0 +1,330 @@
+import { appendPathArcTo, appendPathClose, appendPathCubicCurveTo, appendPathCurveTo, appendPathLineTo, appendPathMoveTo, createPath, forEachPathSegment, } from '@flighthq/path';
+/**
+ * Parses an SVG path `d` string into the end of an existing `path`, appending its contours via the
+ * `@flighthq/path` builders. Supports the full SVG path grammar: absolute (uppercase) and relative
+ * (lowercase) `M L H V C S Q T A Z`, implicit repeated commands, and the smooth-curve shorthands
+ * `S`/`T` (reflecting the previous cubic/quadratic control point). Returns `false` without further
+ * mutation guarantee on structurally malformed input (a leading command that is not moveto, an
+ * unknown command letter, or a missing/short coordinate run); returns `true` when the whole string
+ * parses. An empty or whitespace-only string is well-formed and appends nothing.
+ *
+ * Elliptic arcs (`A`/`a`) are appended through `appendPathArcTo`, which approximates them as cubic
+ * bezier segments — a subsequent `forEachPathSegment` walk (and `formatSvgPathData`) therefore sees
+ * cubics, not an arc verb. The geometry round-trips; the arc command does not.
+ */
+export function appendSvgPathData(path, d) {
+    const length = d.length;
+    let pos = 0;
+    // Current point, subpath start (for Z), and the last emitted control points in absolute space.
+    // `lastControl2` feeds `S` reflection (valid only after C/S); `lastQuadControl` feeds `T`
+    // reflection (valid only after Q/T). `lastKind` records the previous group's canonical letter so
+    // a shorthand can decide whether reflection applies.
+    let currentX = 0;
+    let currentY = 0;
+    let startX = 0;
+    let startY = 0;
+    let lastControl2X = 0;
+    let lastControl2Y = 0;
+    let lastQuadControlX = 0;
+    let lastQuadControlY = 0;
+    let lastKind = '';
+    function skipSeparators() {
+        while (pos < length) {
+            const c = d.charCodeAt(pos);
+            // space, tab, LF, CR, FF, or comma
+            if (c === 32 || c === 9 || c === 10 || c === 13 || c === 12 || c === 44)
+                pos++;
+            else
+                break;
+        }
+    }
+    function readNumber() {
+        skipSeparators();
+        const start = pos;
+        if (pos < length && (d[pos] === '+' || d[pos] === '-'))
+            pos++;
+        let sawDigit = false;
+        while (pos < length && d[pos] >= '0' && d[pos] <= '9') {
+            pos++;
+            sawDigit = true;
+        }
+        if (pos < length && d[pos] === '.') {
+            pos++;
+            while (pos < length && d[pos] >= '0' && d[pos] <= '9') {
+                pos++;
+                sawDigit = true;
+            }
+        }
+        if (!sawDigit) {
+            pos = start;
+            return null;
+        }
+        if (pos < length && (d[pos] === 'e' || d[pos] === 'E')) {
+            const expStart = pos;
+            pos++;
+            if (pos < length && (d[pos] === '+' || d[pos] === '-'))
+                pos++;
+            let expDigit = false;
+            while (pos < length && d[pos] >= '0' && d[pos] <= '9') {
+                pos++;
+                expDigit = true;
+            }
+            if (!expDigit)
+                pos = expStart;
+        }
+        return Number.parseFloat(d.slice(start, pos));
+    }
+    // An arc flag is a single '0' or '1' character, which may be packed against neighbours with no
+    // separator (`0110` = four flags), so it is read one char at a time rather than as a number.
+    function readFlag() {
+        skipSeparators();
+        if (pos < length && d[pos] === '0') {
+            pos++;
+            return 0;
+        }
+        if (pos < length && d[pos] === '1') {
+            pos++;
+            return 1;
+        }
+        return null;
+    }
+    while (true) {
+        skipSeparators();
+        if (pos >= length)
+            break;
+        const commandLetter = d[pos];
+        if (!isSvgCommandLetter(commandLetter))
+            return false;
+        pos++;
+        // Path data must open with a moveto.
+        if (lastKind === '' && commandLetter !== 'M' && commandLetter !== 'm')
+            return false;
+        if (commandLetter === 'Z' || commandLetter === 'z') {
+            appendPathClose(path);
+            currentX = startX;
+            currentY = startY;
+            lastKind = 'Z';
+            continue;
+        }
+        // Execute one or more operand groups. After the first `M`/`m` group, implicit repeats are
+        // lineto groups (SVG spec), so the active letter shifts from M→L (or m→l).
+        let active = commandLetter;
+        let first = true;
+        while (true) {
+            if (!first) {
+                skipSeparators();
+                if (pos >= length)
+                    break;
+                if (isSvgCommandLetter(d[pos]))
+                    break;
+            }
+            const relative = active >= 'a';
+            const upper = relative ? active.toUpperCase() : active;
+            if (upper === 'M') {
+                const nx = readNumber();
+                const ny = readNumber();
+                if (nx === null || ny === null)
+                    return false;
+                currentX = relative ? currentX + nx : nx;
+                currentY = relative ? currentY + ny : ny;
+                startX = currentX;
+                startY = currentY;
+                appendPathMoveTo(path, currentX, currentY);
+                lastKind = 'M';
+            }
+            else if (upper === 'L') {
+                const nx = readNumber();
+                const ny = readNumber();
+                if (nx === null || ny === null)
+                    return false;
+                currentX = relative ? currentX + nx : nx;
+                currentY = relative ? currentY + ny : ny;
+                appendPathLineTo(path, currentX, currentY);
+                lastKind = 'L';
+            }
+            else if (upper === 'H') {
+                const nx = readNumber();
+                if (nx === null)
+                    return false;
+                currentX = relative ? currentX + nx : nx;
+                appendPathLineTo(path, currentX, currentY);
+                lastKind = 'L';
+            }
+            else if (upper === 'V') {
+                const ny = readNumber();
+                if (ny === null)
+                    return false;
+                currentY = relative ? currentY + ny : ny;
+                appendPathLineTo(path, currentX, currentY);
+                lastKind = 'L';
+            }
+            else if (upper === 'C') {
+                const x1 = readNumber();
+                const y1 = readNumber();
+                const x2 = readNumber();
+                const y2 = readNumber();
+                const x = readNumber();
+                const y = readNumber();
+                if (x1 === null || y1 === null || x2 === null || y2 === null || x === null || y === null)
+                    return false;
+                const c1x = relative ? currentX + x1 : x1;
+                const c1y = relative ? currentY + y1 : y1;
+                const c2x = relative ? currentX + x2 : x2;
+                const c2y = relative ? currentY + y2 : y2;
+                const ax = relative ? currentX + x : x;
+                const ay = relative ? currentY + y : y;
+                appendPathCubicCurveTo(path, c1x, c1y, c2x, c2y, ax, ay);
+                lastControl2X = c2x;
+                lastControl2Y = c2y;
+                currentX = ax;
+                currentY = ay;
+                lastKind = 'C';
+            }
+            else if (upper === 'S') {
+                const x2 = readNumber();
+                const y2 = readNumber();
+                const x = readNumber();
+                const y = readNumber();
+                if (x2 === null || y2 === null || x === null || y === null)
+                    return false;
+                const reflect = lastKind === 'C' || lastKind === 'S';
+                const c1x = reflect ? 2 * currentX - lastControl2X : currentX;
+                const c1y = reflect ? 2 * currentY - lastControl2Y : currentY;
+                const c2x = relative ? currentX + x2 : x2;
+                const c2y = relative ? currentY + y2 : y2;
+                const ax = relative ? currentX + x : x;
+                const ay = relative ? currentY + y : y;
+                appendPathCubicCurveTo(path, c1x, c1y, c2x, c2y, ax, ay);
+                lastControl2X = c2x;
+                lastControl2Y = c2y;
+                currentX = ax;
+                currentY = ay;
+                lastKind = 'S';
+            }
+            else if (upper === 'Q') {
+                const x1 = readNumber();
+                const y1 = readNumber();
+                const x = readNumber();
+                const y = readNumber();
+                if (x1 === null || y1 === null || x === null || y === null)
+                    return false;
+                const cx = relative ? currentX + x1 : x1;
+                const cy = relative ? currentY + y1 : y1;
+                const ax = relative ? currentX + x : x;
+                const ay = relative ? currentY + y : y;
+                appendPathCurveTo(path, cx, cy, ax, ay);
+                lastQuadControlX = cx;
+                lastQuadControlY = cy;
+                currentX = ax;
+                currentY = ay;
+                lastKind = 'Q';
+            }
+            else if (upper === 'T') {
+                const x = readNumber();
+                const y = readNumber();
+                if (x === null || y === null)
+                    return false;
+                const reflect = lastKind === 'Q' || lastKind === 'T';
+                const cx = reflect ? 2 * currentX - lastQuadControlX : currentX;
+                const cy = reflect ? 2 * currentY - lastQuadControlY : currentY;
+                const ax = relative ? currentX + x : x;
+                const ay = relative ? currentY + y : y;
+                appendPathCurveTo(path, cx, cy, ax, ay);
+                lastQuadControlX = cx;
+                lastQuadControlY = cy;
+                currentX = ax;
+                currentY = ay;
+                lastKind = 'T';
+            }
+            else if (upper === 'A') {
+                const rx = readNumber();
+                const ry = readNumber();
+                const rotationDegrees = readNumber();
+                const largeArc = readFlag();
+                const sweep = readFlag();
+                const x = readNumber();
+                const y = readNumber();
+                if (rx === null ||
+                    ry === null ||
+                    rotationDegrees === null ||
+                    largeArc === null ||
+                    sweep === null ||
+                    x === null ||
+                    y === null) {
+                    return false;
+                }
+                const ax = relative ? currentX + x : x;
+                const ay = relative ? currentY + y : y;
+                appendPathArcTo(path, rx, ry, (rotationDegrees * Math.PI) / 180, largeArc === 1, sweep === 1, ax, ay);
+                currentX = ax;
+                currentY = ay;
+                lastKind = 'A';
+            }
+            else {
+                return false;
+            }
+            first = false;
+            if (active === 'M')
+                active = 'L';
+            else if (active === 'm')
+                active = 'l';
+        }
+    }
+    return true;
+}
+/**
+ * Serializes a `Path` to an SVG path `d` string, emitting absolute commands. Each `PathSegment`
+ * maps to its SVG verb: `moveTo`→`M`, `lineTo`→`L`, `curveTo` (quadratic)→`Q`, `cubicCurveTo`→`C`,
+ * `close`→`Z`. Arcs are not a distinct segment kind — the path stores them as cubics — so no `A`
+ * command is produced.
+ *
+ * `options.precision`, when given, rounds every coordinate to that many decimal places and drops
+ * trailing zeros; the default emits full-precision numbers (also trailing-zero-free).
+ */
+export function formatSvgPathData(path, options) {
+    const precision = options?.precision;
+    const parts = [];
+    forEachPathSegment(path, (segment) => {
+        if (segment.kind === 'moveTo') {
+            parts.push(`M${formatSvgNumber(segment.x, precision)} ${formatSvgNumber(segment.y, precision)}`);
+        }
+        else if (segment.kind === 'lineTo') {
+            parts.push(`L${formatSvgNumber(segment.x, precision)} ${formatSvgNumber(segment.y, precision)}`);
+        }
+        else if (segment.kind === 'curveTo') {
+            parts.push(`Q${formatSvgNumber(segment.controlX, precision)} ${formatSvgNumber(segment.controlY, precision)} ` +
+                `${formatSvgNumber(segment.x, precision)} ${formatSvgNumber(segment.y, precision)}`);
+        }
+        else if (segment.kind === 'cubicCurveTo') {
+            parts.push(`C${formatSvgNumber(segment.control1X, precision)} ${formatSvgNumber(segment.control1Y, precision)} ` +
+                `${formatSvgNumber(segment.control2X, precision)} ${formatSvgNumber(segment.control2Y, precision)} ` +
+                `${formatSvgNumber(segment.x, precision)} ${formatSvgNumber(segment.y, precision)}`);
+        }
+        else if (segment.kind === 'close') {
+            parts.push('Z');
+        }
+    });
+    return parts.join('');
+}
+/**
+ * Parses an SVG path `d` string into a freshly allocated `Path`, or returns `null` on structurally
+ * malformed input (see `appendSvgPathData` for the malformed cases). An empty or whitespace-only
+ * string yields an empty path, not `null`.
+ */
+export function parseSvgPathData(d) {
+    const path = createPath();
+    if (!appendSvgPathData(path, d))
+        return null;
+    return path;
+}
+function formatSvgNumber(value, precision) {
+    if (precision === undefined)
+        return String(value);
+    const factor = 10 ** precision;
+    // String() of the rounded number drops trailing zeros and normalizes -0 to "0".
+    return String(Math.round(value * factor) / factor);
+}
+function isSvgCommandLetter(c) {
+    return 'MmLlHhVvCcSsQqTtAaZz'.indexOf(c) !== -1;
+}
+//# sourceMappingURL=svgPathData.js.map

package/dist/svgPathData.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/path-formats",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/path": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Tree-shakable path serialization codecs for @flighthq/path (SVG path data)",
+  "sideEffects": false
+}

package/src/svgPathData.test.ts

@@ -0,0 +1,237 @@
+import { createPath, forEachPathSegment } from '@flighthq/path';
+import type { Path, PathSegment } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { appendSvgPathData, formatSvgPathData, parseSvgPathData } from './svgPathData';
+
+function collectSegments(path: Readonly<Path>): PathSegment[] {
+  const segments: PathSegment[] = [];
+  forEachPathSegment(path, (segment) => segments.push(segment));
+  return segments;
+}
+
+describe('appendSvgPathData', () => {
+  it('appends into an existing path without clearing it', () => {
+    const path = createPath();
+    appendSvgPathData(path, 'M0 0 L10 0');
+    const ok = appendSvgPathData(path, 'M20 20 L30 20');
+    expect(ok).toBe(true);
+    const segments = collectSegments(path);
+    expect(segments.map((s) => s.kind)).toEqual(['moveTo', 'lineTo', 'moveTo', 'lineTo']);
+  });
+
+  it('returns false on malformed input', () => {
+    const path = createPath();
+    expect(appendSvgPathData(path, 'L10 10')).toBe(false);
+  });
+});
+
+describe('formatSvgPathData', () => {
+  it('emits absolute M/L/C/Q/Z commands per segment kind', () => {
+    const path = createPath();
+    appendSvgPathData(path, 'M0 0 L10 0 Q15 5 20 0 C22 2 24 2 26 0 Z');
+    expect(formatSvgPathData(path)).toBe('M0 0L10 0Q15 5 20 0C22 2 24 2 26 0Z');
+  });
+
+  it('rounds coordinates and trims trailing zeros with a precision option', () => {
+    const path = createPath();
+    appendSvgPathData(path, 'M0.123456 0.5 L10.987654 20');
+    expect(formatSvgPathData(path, { precision: 2 })).toBe('M0.12 0.5L10.99 20');
+  });
+
+  it('emits full precision by default', () => {
+    const path = createPath();
+    appendSvgPathData(path, 'M0.5 0.25 L1.5 2.75');
+    expect(formatSvgPathData(path)).toBe('M0.5 0.25L1.5 2.75');
+  });
+
+  it('emits no A command — arcs are stored as cubics', () => {
+    const path = createPath();
+    appendSvgPathData(path, 'M0 0 A5 5 0 0 1 10 0');
+    const d = formatSvgPathData(path);
+    expect(d).not.toContain('A');
+    expect(d.startsWith('M0 0C')).toBe(true);
+  });
+});
+
+describe('parseSvgPathData', () => {
+  it('parses absolute moveto and lineto', () => {
+    const path = parseSvgPathData('M0 0 L10 10');
+    expect(path).not.toBeNull();
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'lineTo', x: 10, y: 10 },
+    ]);
+  });
+
+  it('treats repeated moveto operands as implicit lineto', () => {
+    const path = parseSvgPathData('M0 0 1 1 2 2');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'lineTo', x: 1, y: 1 },
+      { kind: 'lineTo', x: 2, y: 2 },
+    ]);
+  });
+
+  it('resolves relative commands against the current point', () => {
+    const path = parseSvgPathData('m10 10 l5 5 l-5 0');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 10, y: 10 },
+      { kind: 'lineTo', x: 15, y: 15 },
+      { kind: 'lineTo', x: 10, y: 15 },
+    ]);
+  });
+
+  it('maps horizontal and vertical lineto (absolute and relative)', () => {
+    const path = parseSvgPathData('M0 0 H10 V20 h5 v-5');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'lineTo', x: 10, y: 0 },
+      { kind: 'lineTo', x: 10, y: 20 },
+      { kind: 'lineTo', x: 15, y: 20 },
+      { kind: 'lineTo', x: 15, y: 15 },
+    ]);
+  });
+
+  it('parses cubic curves', () => {
+    const path = parseSvgPathData('M0 0 C1 2 3 4 5 6');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'cubicCurveTo', control1X: 1, control1Y: 2, control2X: 3, control2Y: 4, x: 5, y: 6 },
+    ]);
+  });
+
+  it('reflects the previous cubic control for the S shorthand', () => {
+    const path = parseSvgPathData('M0 0 C1 2 3 4 5 6 S3 3 4 4');
+    const segments = collectSegments(path as Path);
+    expect(segments[2]).toEqual({
+      kind: 'cubicCurveTo',
+      control1X: 7,
+      control1Y: 8,
+      control2X: 3,
+      control2Y: 3,
+      x: 4,
+      y: 4,
+    });
+  });
+
+  it('uses the current point as the S control when the previous command was not a cubic', () => {
+    const path = parseSvgPathData('M0 0 L2 2 S3 3 4 4');
+    const segments = collectSegments(path as Path);
+    expect(segments[2]).toEqual({
+      kind: 'cubicCurveTo',
+      control1X: 2,
+      control1Y: 2,
+      control2X: 3,
+      control2Y: 3,
+      x: 4,
+      y: 4,
+    });
+  });
+
+  it('parses quadratic curves', () => {
+    const path = parseSvgPathData('M0 0 Q1 1 2 2');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'curveTo', controlX: 1, controlY: 1, x: 2, y: 2 },
+    ]);
+  });
+
+  it('reflects the previous quadratic control for the T shorthand', () => {
+    const path = parseSvgPathData('M0 0 Q1 1 2 2 T4 4');
+    const segments = collectSegments(path as Path);
+    expect(segments[2]).toEqual({ kind: 'curveTo', controlX: 3, controlY: 3, x: 4, y: 4 });
+  });
+
+  it('appends an arc as cubic segments ending at the arc endpoint', () => {
+    const path = parseSvgPathData('M0 0 A5 5 0 0 1 10 0');
+    expect(path).not.toBeNull();
+    const segments = collectSegments(path as Path);
+    expect(segments[0].kind).toBe('moveTo');
+    expect(segments[1].kind).toBe('cubicCurveTo');
+    const last = segments[segments.length - 1] as Extract<PathSegment, { kind: 'cubicCurveTo' }>;
+    expect(last.x).toBeCloseTo(10, 6);
+    expect(last.y).toBeCloseTo(0, 6);
+  });
+
+  it('closes contours and returns the current point to the subpath start', () => {
+    const path = parseSvgPathData('M0 0 L10 0 L10 10 Z L5 5');
+    const segments = collectSegments(path as Path);
+    expect(segments.map((s) => s.kind)).toEqual(['moveTo', 'lineTo', 'lineTo', 'close', 'lineTo']);
+    // The lineto after Z starts from the subpath origin (0,0) and goes to (5,5).
+    expect(segments[4]).toEqual({ kind: 'lineTo', x: 5, y: 5 });
+  });
+
+  it('tokenizes numbers with no space before a negative sign', () => {
+    const path = parseSvgPathData('M0 0L10-5');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 0, y: 0 },
+      { kind: 'lineTo', x: 10, y: -5 },
+    ]);
+  });
+
+  it('tokenizes scientific notation and comma separators', () => {
+    const path = parseSvgPathData('M1e1,1e1 L2E1,-1.5e1');
+    expect(collectSegments(path as Path)).toEqual([
+      { kind: 'moveTo', x: 10, y: 10 },
+      { kind: 'lineTo', x: 20, y: -15 },
+    ]);
+  });
+
+  it('parses packed arc flags with no separators', () => {
+    const path = parseSvgPathData('M0 0A5 5 0 0110 0');
+    expect(path).not.toBeNull();
+    const segments = collectSegments(path as Path);
+    const last = segments[segments.length - 1] as Extract<PathSegment, { kind: 'cubicCurveTo' }>;
+    expect(last.x).toBeCloseTo(10, 6);
+    expect(last.y).toBeCloseTo(0, 6);
+  });
+
+  it('returns an empty path for empty or whitespace-only input', () => {
+    expect(collectSegments(parseSvgPathData('') as Path)).toEqual([]);
+    expect(collectSegments(parseSvgPathData('   \n  ') as Path)).toEqual([]);
+  });
+
+  it('returns null when the path does not begin with a moveto', () => {
+    expect(parseSvgPathData('L10 10')).toBeNull();
+  });
+
+  it('returns null on an unknown command letter', () => {
+    expect(parseSvgPathData('M0 0 X10 10')).toBeNull();
+  });
+
+  it('returns null on a short coordinate run', () => {
+    expect(parseSvgPathData('M0 0 L10')).toBeNull();
+    expect(parseSvgPathData('M')).toBeNull();
+    expect(parseSvgPathData('M0 0 C1 2 3 4 5')).toBeNull();
+  });
+
+  it('round-trips representative path data through format and back', () => {
+    const cases = [
+      'M0 0 L10 0 L10 10 Z',
+      'M0 0 C1 2 3 4 5 6 S7 8 9 10',
+      'M0 0 Q1 1 2 2 T4 4 T6 0',
+      'm10 10 h20 v20 h-20 z',
+      'M0 0 A5 5 0 0 1 10 0 A5 5 0 0 1 20 0',
+    ];
+    for (const d of cases) {
+      const first = parseSvgPathData(d);
+      expect(first).not.toBeNull();
+      const reserialized = formatSvgPathData(first as Path);
+      const second = parseSvgPathData(reserialized);
+      expect(second).not.toBeNull();
+      const a = collectSegments(first as Path);
+      const b = collectSegments(second as Path);
+      expect(b.length).toBe(a.length);
+      for (let i = 0; i < a.length; i++) {
+        expect(b[i].kind).toBe(a[i].kind);
+        const av = a[i] as unknown as Record<string, number>;
+        const bv = b[i] as unknown as Record<string, number>;
+        for (const key of Object.keys(av)) {
+          if (key === 'kind') continue;
+          expect(bv[key]).toBeCloseTo(av[key], 6);
+        }
+      }
+    }
+  });
+});