postext 1.19.3 → 1.20.1

package/dist/comics/lettering/__tests__/stubMeasure.js

@@ -0,0 +1,47 @@
+// A deterministic text measurer for the lettering tests (no canvas in the
+// node test environment): advances by character class, in ems of the
+// font's px size, close enough to a comic face for shapes to be judged.
+import { clearTextWidthCache } from '../../../measure/canvas';
+const SIZE_RE = /(\d*\.?\d+)px/;
+/** Advance of one character, in em. */
+export function stubAdvance(ch) {
+    // Bidi controls are default ignorable: no advance (as a canvas gives).
+    if (/[\u2066-\u2069]/.test(ch))
+        return 0;
+    if (/[　-ヿ㐀-鿿豈-﫿！-｠]/.test(ch))
+        return 1;
+    if (/[؀-ۿ]/.test(ch))
+        return 0.42;
+    if (/\s/.test(ch))
+        return 0.27;
+    if (/[A-Z0-9]/.test(ch))
+        return 0.6;
+    if (/[a-z]/.test(ch))
+        return 0.5;
+    if (/[.,;:'!|]/.test(ch))
+        return 0.25;
+    if (ch === '…')
+        return 0.8;
+    return 0.55;
+}
+class StubCtx {
+    font = '16px sans-serif';
+    measureText(s) {
+        const m = SIZE_RE.exec(this.font);
+        const px = m ? parseFloat(m[1]) : 16;
+        let w = 0;
+        for (const ch of s)
+            w += stubAdvance(ch);
+        return { width: w * px };
+    }
+}
+/** Install the stub as the engine's measuring canvas. */
+export function installStubMeasure() {
+    globalThis.OffscreenCanvas = class {
+        getContext() {
+            return new StubCtx();
+        }
+    };
+    clearTextWidthCache();
+}
+//# sourceMappingURL=stubMeasure.js.map

package/dist/comics/lettering/__tests__/stubMeasure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubMeasure.js","sourceRoot":"","sources":["../../../../src/comics/lettering/__tests__/stubMeasure.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,wEAAwE;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,OAAO,GAAG,eAAe,CAAC;AAEhC,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,uEAAuE;IACvE,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACjC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,EAAE,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO;IACX,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,CAAC,CAAS;QACnB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,EAAE,IAAI,CAAC;YAAE,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,UAAU,kBAAkB;IAC/B,UAAsD,CAAC,eAAe,GAAG;QACxE,UAAU;YACR,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;IACF,mBAAmB,EAAE,CAAC;AACxB,CAAC"}

package/dist/comics/lettering/__tests__/text.test.d.ts

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

package/dist/comics/lettering/__tests__/text.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.test.d.ts","sourceRoot":"","sources":["../../../../src/comics/lettering/__tests__/text.test.ts"],"names":[],"mappings":""}

package/dist/comics/lettering/__tests__/text.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect } from 'vitest';
+import { breakPoints, markupOf, prepareText, readLetteringText } from '../text';
+import { presetLetteringStyles } from '../presets';
+import { parseRichDesignText } from '../../../design/richText';
+const styleFor = (locale, id = 'speech') => presetLetteringStyles({ fontSizePx: 12, locale })[id];
+const prep = (text, locale, extra = {}, map) => prepareText(readLetteringText(text, map), { ...styleFor(locale), ...extra }, { locale, vertical: false });
+const span = (text, bold = false, italic = false, more = {}) => ({ text, bold, italic, ...more });
+describe('lettering text: house rules (SPEC D3.1)', () => {
+    it('stands ASCII ! and ? upright in Japanese columns (a pair left to the one-cell rule), not in rows', () => {
+        const v = (t) => prepareText(readLetteringText(t, [...t].map((_, i) => 100 + i)), styleFor('ja'), { locale: 'ja', vertical: true });
+        const col = v('キャロット!? 本当!');
+        // The pair stays ASCII: the vertical layout sets it in one cell with
+        // the face's own glyphs (comic faces lack ⁉ ‼).
+        expect(col.text).toBe('キャロット!? 本当！');
+        expect(col.source[5]).toBe(105);
+        expect(col.source[6]).toBe(106);
+        expect(v('メン!!!').text).toBe('メン！！！');
+        // Chinese columns set every mark full width.
+        expect(prepareText(readLetteringText('真的!?', undefined), styleFor('ja'), { locale: 'zh', vertical: true }).text).toBe('真的！？');
+        expect(prepareText(readLetteringText('本当!', undefined), styleFor('ja'), { locale: 'ja', vertical: false }).text).toBe('本当!');
+        expect(prepareText(readLetteringText('Really!?', undefined), styleFor('en'), { locale: 'en', vertical: true }).text).toBe('REALLY!?');
+    });
+    it('sets cased scripts in capitals, keeps Arabic and CJK as they are', () => {
+        expect(prep('Did you hear that?', 'en').text).toBe('DID YOU HEAR THAT?');
+        expect(prep('¿Has oído eso?', 'es').text).toBe('¿HAS OÍDO ESO?');
+        expect(prep('هل سمعت ذلك؟', 'ar').text).toBe('هل سمعت ذلك؟');
+        expect(prep('いまの音、聞こえた？', 'ja').text).toBe('いまの音、聞こえた？');
+    });
+    it('upper-cases in the locale rules and keeps a source offset per character', () => {
+        const p = prep('straße', 'de', {}, [10, 11, 12, 13, 14, 15]);
+        expect(p.text).toBe('STRASSE');
+        expect(p.source).toEqual([10, 11, 12, 13, 14, 14, 15]);
+        expect(prep('iki', 'tr').text).toBe('İKİ');
+    });
+    it('normalises ellipses, double dashes and the final stop', () => {
+        expect(prep('Well... maybe', 'en', { textTransform: 'none' }).text).toBe('Well… maybe');
+        expect(prep('Wait—what?', 'en', { textTransform: 'none', doubleDash: true }).text).toBe('Wait--what?');
+        expect(prep('Wait—what?', 'en', { textTransform: 'none' }).text).toBe('Wait—what?');
+        expect(prep('なんでもない。もう寝なさい。', 'ja').text).toBe('なんでもない。もう寝なさい');
+        expect(prep('沒什麼。', 'zh-Hant').text).toBe('沒什麼');
+        expect(prep('沒什麼。', 'zh-Hant', { dropFinalStop: false }).text).toBe('沒什麼。');
+        expect(prep('他說…', 'zh-Hant').text).toBe('他說……');
+        expect(prep('C’est fini.', 'fr', { textTransform: 'none' }).text).toBe('C’est fini.');
+    });
+    it('prints emphasis bold italic, bold only in scripts without italics', () => {
+        const en = prep([span('I said '), span('now', false, true), span('!')], 'en');
+        const i = en.text.indexOf('NOW');
+        expect(en.style[i]).toMatchObject({ bold: true, italic: true });
+        expect(en.style[0]).toMatchObject({ bold: false, italic: false });
+        const ar = prep([span('قلت '), span('الآن', true)], 'ar');
+        expect(ar.style[ar.text.length - 1]).toMatchObject({ bold: true, italic: false });
+    });
+    it('collapses white space and reads forced breaks', () => {
+        expect(prep('one   two \n three', 'en', { textTransform: 'none' }).text).toBe('one two\nthree');
+        expect(prep('one\u2028two', 'en', { textTransform: 'none' }).text).toBe('one\ntwo');
+    });
+});
+describe('lettering text: legal breaks', () => {
+    it('breaks Latin text at spaces only, cheaper after a sentence end', () => {
+        const p = prep('Hi there. Go on', 'en', { textTransform: 'none' });
+        const pts = breakPoints(p, 'gb', false);
+        expect(pts.map((b) => p.text.slice(0, b.end))).toEqual(['Hi', 'Hi there.', 'Hi there. Go', 'Hi there. Go on']);
+        const after = (s) => pts.find((b) => p.text.slice(0, b.end) === s).penalty;
+        expect(after('Hi there.')).toBeLessThan(after('Hi'));
+    });
+    it('keeps Japanese kinsoku: no column opens with a closing mark or a small kana', () => {
+        const p = prep('ちょっと待って、ね', 'ja');
+        const pts = breakPoints(p, 'ja-very-strict', true).filter((b) => !b.forced);
+        for (const b of pts) {
+            expect('、ょっ').not.toContain(p.text[b.next]);
+        }
+    });
+    it('never breaks inside a tate-chu-yoko run', () => {
+        const p = prepareText(readLetteringText([span('あと'), span('12', false, false, { combineUpright: true }), span('分')], undefined), styleFor('ja'), { locale: 'ja', vertical: true });
+        const pts = breakPoints(p, 'ja-strict', true);
+        const at = p.text.indexOf('12');
+        expect(pts.some((b) => b.end === at + 1)).toBe(false);
+    });
+    it('writes markup that reads back to the same text', () => {
+        const p = prep([span('Look '), span('out*_', true), span(' x^2^ now')], 'en', { textTransform: 'none' });
+        const markup = markupOf(p, 0, p.text.length);
+        const rt = parseRichDesignText(markup, { family: 'X', sizePx: 12, weight: 400, italic: false });
+        expect(rt.text).toBe(p.text);
+    });
+});
+//# sourceMappingURL=text.test.js.map

package/dist/comics/lettering/__tests__/text.test.js.map

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

package/dist/comics/lettering/geom.d.ts

@@ -0,0 +1,78 @@
+import type { Point, Rect } from './types';
+/** A 32-bit FNV-1a hash of a string: the seed of every jitter. */
+export declare function hashString(s: string): number;
+/** A deterministic generator of numbers in [0, 1) seeded by `seed`
+ *  (mulberry32). */
+export declare function seededRandom(seed: number): () => number;
+export declare const dist: (a: Point, b: Point) => number;
+export declare const add: (a: Point, b: Point) => Point;
+export declare const sub: (a: Point, b: Point) => Point;
+export declare const scale: (a: Point, k: number) => Point;
+export declare const lerp: (a: Point, b: Point, t: number) => Point;
+export declare const norm: (a: Point) => Point;
+/** `a` turned a quarter turn (to the left in page coordinates, y down). */
+export declare const perp: (a: Point) => Point;
+export declare function rectOf(x: number, y: number, width: number, height: number): Rect;
+export declare function rectCentre(r: Rect): Point;
+export declare function unionRect(a: Rect | undefined, b: Rect): Rect;
+export declare function boundsOf(points: readonly Point[]): Rect;
+export declare function rectsOverlap(a: Rect, b: Rect, margin?: number): boolean;
+export declare function rectOverlapArea(a: Rect, b: Rect): number;
+export declare function pointInRect(p: Point, r: Rect, margin?: number): boolean;
+/** Signed area of a polygon (positive when clockwise on a y-down page). */
+export declare function signedArea(poly: readonly Point[]): number;
+/** Whether `p` lies inside the convex polygon `poly` (either winding). */
+export declare function pointInConvex(p: Point, poly: readonly Point[]): boolean;
+/** A convex polygon with each edge moved inward by `d` (clipped by the
+ *  half-planes of the moved edges). Empty when it vanishes. */
+export declare function insetConvex(poly: readonly Point[], d: number): Point[];
+/** The part of `poly` on the side of the line through `p` that `n` points
+ *  to (Sutherland–Hodgman, one edge). */
+export declare function clipHalfPlane(poly: readonly Point[], p: Point, n: Point): Point[];
+/** The part of a convex `poly` inside the rectangle `r`. */
+export declare function clipToRect(poly: readonly Point[], r: Rect): Point[];
+/** Where the ray from `o` along `dir` first leaves the polygon (the
+ *  distance along `dir`, normalised), or undefined. */
+export declare function rayExit(o: Point, dir: Point, poly: readonly Point[]): number | undefined;
+/** Distance along `dir` (unit) from `o` to segment `ab`, or undefined. */
+export declare function raySegment(o: Point, dir: Point, a: Point, b: Point): number | undefined;
+/** Whether segments `ab` and `cd` cross. */
+export declare function segmentsCross(a: Point, b: Point, c: Point, d: Point): boolean;
+/** Distance between segments `ab` and `cd` (0 when they cross). */
+export declare function segmentDistance(a: Point, b: Point, c: Point, d: Point): number;
+/** Whether segment `ab` crosses rect `r` (or lies inside it). */
+export declare function segmentHitsRect(a: Point, b: Point, r: Rect): boolean;
+/** The point of the polygon's boundary nearest to `p`. */
+export declare function nearestOnPolygon(p: Point, poly: readonly Point[]): Point;
+/** One command of a path in page px: M L C Z only. */
+export interface PathCmd {
+    op: 'M' | 'L' | 'C' | 'Z';
+    pts: Point[];
+}
+/** SVG path data of commands (two decimals). */
+export declare function pathData(cmds: readonly PathCmd[]): string;
+/** Commands moved by (dx, dy). */
+export declare function translateCmds(cmds: readonly PathCmd[], dx: number, dy: number): PathCmd[];
+/** A closed polygon (straight segments). */
+export declare function polygonCmds(points: readonly Point[]): PathCmd[];
+/** A closed smooth curve through `points` (Catmull-Rom turned into cubic
+ *  Beziers). */
+export declare function smoothClosedCmds(points: readonly Point[]): PathCmd[];
+/** An open smooth curve through `points` (Catmull-Rom, ends clamped), as
+ *  `C` commands that continue from `points[0]`. */
+export declare function smoothOpenCmds(points: readonly Point[]): PathCmd[];
+/** A circle as four cubic arcs. */
+export declare function circleCmds(c: Point, r: number): PathCmd[];
+/** A rectangle with corners rounded by `radius` (cubic arcs). */
+export declare function roundedRectCmds(r: Rect, radius: number): PathCmd[];
+/** Length of the closed polygon through `points`. */
+export declare function perimeter(points: readonly Point[]): number;
+/** Points at `count` equal steps of arc length along the closed polygon
+ *  `points` (starting at `points[0]`, shifted by `phase` steps), each with
+ *  the polygon's outward normal there (`cw`: the polygon runs clockwise on
+ *  the page). */
+export declare function resampleClosed(points: readonly Point[], count: number, phase?: number): {
+    p: Point;
+    n: Point;
+}[];
+//# sourceMappingURL=geom.d.ts.map

package/dist/comics/lettering/geom.d.ts.map

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

package/dist/comics/lettering/geom.js

@@ -0,0 +1,376 @@
+// Small geometry helpers of the lettering: seeded noise, polygons, rects,
+// and SVG path data (M L C Z only, so that every renderer reads it).
+/** A 32-bit FNV-1a hash of a string: the seed of every jitter. */
+export function hashString(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+/** A deterministic generator of numbers in [0, 1) seeded by `seed`
+ *  (mulberry32). */
+export function seededRandom(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+export const dist = (a, b) => Math.hypot(a.x - b.x, a.y - b.y);
+export const add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
+export const sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
+export const scale = (a, k) => ({ x: a.x * k, y: a.y * k });
+export const lerp = (a, b, t) => ({ x: a.x + (b.x - a.x) * t, y: a.y + (b.y - a.y) * t });
+export const norm = (a) => {
+    const l = Math.hypot(a.x, a.y) || 1;
+    return { x: a.x / l, y: a.y / l };
+};
+/** `a` turned a quarter turn (to the left in page coordinates, y down). */
+export const perp = (a) => ({ x: a.y, y: -a.x });
+export function rectOf(x, y, width, height) {
+    return { x, y, width, height };
+}
+export function rectCentre(r) {
+    return { x: r.x + r.width / 2, y: r.y + r.height / 2 };
+}
+export function unionRect(a, b) {
+    if (!a)
+        return { ...b };
+    const x = Math.min(a.x, b.x);
+    const y = Math.min(a.y, b.y);
+    return { x, y, width: Math.max(a.x + a.width, b.x + b.width) - x, height: Math.max(a.y + a.height, b.y + b.height) - y };
+}
+export function boundsOf(points) {
+    let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
+    for (const p of points) {
+        if (p.x < x0)
+            x0 = p.x;
+        if (p.y < y0)
+            y0 = p.y;
+        if (p.x > x1)
+            x1 = p.x;
+        if (p.y > y1)
+            y1 = p.y;
+    }
+    return points.length ? { x: x0, y: y0, width: x1 - x0, height: y1 - y0 } : { x: 0, y: 0, width: 0, height: 0 };
+}
+export function rectsOverlap(a, b, margin = 0) {
+    return a.x < b.x + b.width + margin && b.x < a.x + a.width + margin
+        && a.y < b.y + b.height + margin && b.y < a.y + a.height + margin;
+}
+export function rectOverlapArea(a, b) {
+    const w = Math.min(a.x + a.width, b.x + b.width) - Math.max(a.x, b.x);
+    const h = Math.min(a.y + a.height, b.y + b.height) - Math.max(a.y, b.y);
+    return w > 0 && h > 0 ? w * h : 0;
+}
+export function pointInRect(p, r, margin = 0) {
+    return p.x >= r.x - margin && p.x <= r.x + r.width + margin && p.y >= r.y - margin && p.y <= r.y + r.height + margin;
+}
+/** Signed area of a polygon (positive when clockwise on a y-down page). */
+export function signedArea(poly) {
+    let s = 0;
+    for (let i = 0; i < poly.length; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        s += a.x * b.y - b.x * a.y;
+    }
+    return s / 2;
+}
+/** Whether `p` lies inside the convex polygon `poly` (either winding). */
+export function pointInConvex(p, poly) {
+    if (poly.length < 3)
+        return false;
+    let sign = 0;
+    for (let i = 0; i < poly.length; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        const c = (b.x - a.x) * (p.y - a.y) - (b.y - a.y) * (p.x - a.x);
+        if (Math.abs(c) < 1e-9)
+            continue;
+        const s = c > 0 ? 1 : -1;
+        if (sign === 0)
+            sign = s;
+        else if (s !== sign)
+            return false;
+    }
+    return true;
+}
+/** A convex polygon with each edge moved inward by `d` (clipped by the
+ *  half-planes of the moved edges). Empty when it vanishes. */
+export function insetConvex(poly, d) {
+    if (poly.length < 3)
+        return [];
+    if (d <= 0)
+        return poly.map((p) => ({ ...p }));
+    const cw = signedArea(poly) > 0;
+    let out = poly.map((p) => ({ ...p }));
+    for (let i = 0; i < poly.length && out.length > 0; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        // Inward normal: on a clockwise (y-down) polygon, to the right of a→b.
+        const e = norm(sub(b, a));
+        const n = cw ? { x: -e.y, y: e.x } : { x: e.y, y: -e.x };
+        const a2 = add(a, scale(n, d));
+        out = clipHalfPlane(out, a2, n);
+    }
+    return out;
+}
+/** The part of `poly` on the side of the line through `p` that `n` points
+ *  to (Sutherland–Hodgman, one edge). */
+export function clipHalfPlane(poly, p, n) {
+    const side = (q) => (q.x - p.x) * n.x + (q.y - p.y) * n.y;
+    const out = [];
+    for (let i = 0; i < poly.length; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        const sa = side(a);
+        const sb = side(b);
+        if (sa >= 0)
+            out.push(a);
+        if ((sa >= 0) !== (sb >= 0))
+            out.push(lerp(a, b, sa / (sa - sb)));
+    }
+    return out;
+}
+/** The part of a convex `poly` inside the rectangle `r`. */
+export function clipToRect(poly, r) {
+    let out = [...poly];
+    out = clipHalfPlane(out, { x: r.x, y: r.y }, { x: 1, y: 0 });
+    out = clipHalfPlane(out, { x: r.x + r.width, y: r.y }, { x: -1, y: 0 });
+    out = clipHalfPlane(out, { x: r.x, y: r.y }, { x: 0, y: 1 });
+    out = clipHalfPlane(out, { x: r.x, y: r.y + r.height }, { x: 0, y: -1 });
+    return out;
+}
+/** Where the ray from `o` along `dir` first leaves the polygon (the
+ *  distance along `dir`, normalised), or undefined. */
+export function rayExit(o, dir, poly) {
+    let best;
+    for (let i = 0; i < poly.length; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        const t = raySegment(o, dir, a, b);
+        if (t !== undefined && t > 1e-9 && (best === undefined || t < best))
+            best = t;
+    }
+    return best;
+}
+/** Distance along `dir` (unit) from `o` to segment `ab`, or undefined. */
+export function raySegment(o, dir, a, b) {
+    const ex = b.x - a.x;
+    const ey = b.y - a.y;
+    const den = dir.x * ey - dir.y * ex;
+    if (Math.abs(den) < 1e-12)
+        return undefined;
+    const t = ((a.x - o.x) * ey - (a.y - o.y) * ex) / den;
+    const u = ((a.x - o.x) * dir.y - (a.y - o.y) * dir.x) / den;
+    if (u < -1e-9 || u > 1 + 1e-9)
+        return undefined;
+    return t;
+}
+/** Whether segments `ab` and `cd` cross. */
+export function segmentsCross(a, b, c, d) {
+    const o = (p, q, r) => (q.x - p.x) * (r.y - p.y) - (q.y - p.y) * (r.x - p.x);
+    const d1 = o(c, d, a);
+    const d2 = o(c, d, b);
+    const d3 = o(a, b, c);
+    const d4 = o(a, b, d);
+    return ((d1 > 0) !== (d2 > 0)) && ((d3 > 0) !== (d4 > 0)) && d1 !== 0 && d2 !== 0 && d3 !== 0 && d4 !== 0;
+}
+/** Distance between segments `ab` and `cd` (0 when they cross). */
+export function segmentDistance(a, b, c, d) {
+    if (segmentsCross(a, b, c, d))
+        return 0;
+    const toSeg = (p, s, e) => {
+        const vx = e.x - s.x;
+        const vy = e.y - s.y;
+        const l2 = vx * vx + vy * vy;
+        const t = l2 > 0 ? Math.max(0, Math.min(1, ((p.x - s.x) * vx + (p.y - s.y) * vy) / l2)) : 0;
+        return Math.hypot(p.x - (s.x + t * vx), p.y - (s.y + t * vy));
+    };
+    return Math.min(toSeg(a, c, d), toSeg(b, c, d), toSeg(c, a, b), toSeg(d, a, b));
+}
+/** Whether segment `ab` crosses rect `r` (or lies inside it). */
+export function segmentHitsRect(a, b, r) {
+    if (pointInRect(a, r) || pointInRect(b, r))
+        return true;
+    const c = [
+        { x: r.x, y: r.y }, { x: r.x + r.width, y: r.y },
+        { x: r.x + r.width, y: r.y + r.height }, { x: r.x, y: r.y + r.height },
+    ];
+    for (let i = 0; i < 4; i++)
+        if (segmentsCross(a, b, c[i], c[(i + 1) % 4]))
+            return true;
+    return false;
+}
+/** The point of the polygon's boundary nearest to `p`. */
+export function nearestOnPolygon(p, poly) {
+    let best = poly[0] ?? p;
+    let bestD = Infinity;
+    for (let i = 0; i < poly.length; i++) {
+        const a = poly[i];
+        const b = poly[(i + 1) % poly.length];
+        const ab = sub(b, a);
+        const l2 = ab.x * ab.x + ab.y * ab.y || 1;
+        const t = Math.max(0, Math.min(1, ((p.x - a.x) * ab.x + (p.y - a.y) * ab.y) / l2));
+        const q = add(a, scale(ab, t));
+        const d = dist(p, q);
+        if (d < bestD) {
+            bestD = d;
+            best = q;
+        }
+    }
+    return best;
+}
+const num = (v) => {
+    const r = Math.round(v * 100) / 100;
+    return Object.is(r, -0) ? '0' : String(r);
+};
+const pt = (p) => `${num(p.x)} ${num(p.y)}`;
+/** SVG path data of commands (two decimals). */
+export function pathData(cmds) {
+    let d = '';
+    for (const c of cmds) {
+        if (c.op === 'Z')
+            d += 'Z';
+        else if (c.op === 'C')
+            d += `C${pt(c.pts[0])} ${pt(c.pts[1])} ${pt(c.pts[2])}`;
+        else
+            d += `${c.op}${pt(c.pts[0])}`;
+    }
+    return d;
+}
+/** Commands moved by (dx, dy). */
+export function translateCmds(cmds, dx, dy) {
+    return cmds.map((c) => ({ op: c.op, pts: c.pts.map((p) => ({ x: p.x + dx, y: p.y + dy })) }));
+}
+/** A closed polygon (straight segments). */
+export function polygonCmds(points) {
+    if (points.length === 0)
+        return [];
+    return [
+        { op: 'M', pts: [{ ...points[0] }] },
+        ...points.slice(1).map((p) => ({ op: 'L', pts: [{ ...p }] })),
+        { op: 'Z', pts: [] },
+    ];
+}
+/** A closed smooth curve through `points` (Catmull-Rom turned into cubic
+ *  Beziers). */
+export function smoothClosedCmds(points) {
+    const n = points.length;
+    if (n < 3)
+        return polygonCmds(points);
+    const out = [{ op: 'M', pts: [{ ...points[0] }] }];
+    for (let i = 0; i < n; i++) {
+        const p0 = points[(i - 1 + n) % n];
+        const p1 = points[i];
+        const p2 = points[(i + 1) % n];
+        const p3 = points[(i + 2) % n];
+        out.push({
+            op: 'C',
+            pts: [
+                { x: p1.x + (p2.x - p0.x) / 6, y: p1.y + (p2.y - p0.y) / 6 },
+                { x: p2.x - (p3.x - p1.x) / 6, y: p2.y - (p3.y - p1.y) / 6 },
+                { ...p2 },
+            ],
+        });
+    }
+    out.push({ op: 'Z', pts: [] });
+    return out;
+}
+/** An open smooth curve through `points` (Catmull-Rom, ends clamped), as
+ *  `C` commands that continue from `points[0]`. */
+export function smoothOpenCmds(points) {
+    const n = points.length;
+    const out = [];
+    for (let i = 0; i + 1 < n; i++) {
+        const p0 = points[Math.max(0, i - 1)];
+        const p1 = points[i];
+        const p2 = points[i + 1];
+        const p3 = points[Math.min(n - 1, i + 2)];
+        out.push({
+            op: 'C',
+            pts: [
+                { x: p1.x + (p2.x - p0.x) / 6, y: p1.y + (p2.y - p0.y) / 6 },
+                { x: p2.x - (p3.x - p1.x) / 6, y: p2.y - (p3.y - p1.y) / 6 },
+                { ...p2 },
+            ],
+        });
+    }
+    return out;
+}
+/** A circle as four cubic arcs. */
+export function circleCmds(c, r) {
+    const k = 0.5522847498 * r;
+    const P = (x, y) => ({ x: c.x + x, y: c.y + y });
+    return [
+        { op: 'M', pts: [P(r, 0)] },
+        { op: 'C', pts: [P(r, k), P(k, r), P(0, r)] },
+        { op: 'C', pts: [P(-k, r), P(-r, k), P(-r, 0)] },
+        { op: 'C', pts: [P(-r, -k), P(-k, -r), P(0, -r)] },
+        { op: 'C', pts: [P(k, -r), P(r, -k), P(r, 0)] },
+        { op: 'Z', pts: [] },
+    ];
+}
+/** A rectangle with corners rounded by `radius` (cubic arcs). */
+export function roundedRectCmds(r, radius) {
+    const rad = Math.max(0, Math.min(radius, r.width / 2, r.height / 2));
+    const { x, y, width: w, height: h } = r;
+    if (rad <= 0.01)
+        return polygonCmds([{ x, y }, { x: x + w, y }, { x: x + w, y: y + h }, { x, y: y + h }]);
+    const k = 0.5522847498 * rad;
+    return [
+        { op: 'M', pts: [{ x: x + rad, y }] },
+        { op: 'L', pts: [{ x: x + w - rad, y }] },
+        { op: 'C', pts: [{ x: x + w - rad + k, y }, { x: x + w, y: y + rad - k }, { x: x + w, y: y + rad }] },
+        { op: 'L', pts: [{ x: x + w, y: y + h - rad }] },
+        { op: 'C', pts: [{ x: x + w, y: y + h - rad + k }, { x: x + w - rad + k, y: y + h }, { x: x + w - rad, y: y + h }] },
+        { op: 'L', pts: [{ x: x + rad, y: y + h }] },
+        { op: 'C', pts: [{ x: x + rad - k, y: y + h }, { x, y: y + h - rad + k }, { x, y: y + h - rad }] },
+        { op: 'L', pts: [{ x, y: y + rad }] },
+        { op: 'C', pts: [{ x, y: y + rad - k }, { x: x + rad - k, y }, { x: x + rad, y }] },
+        { op: 'Z', pts: [] },
+    ];
+}
+/** Length of the closed polygon through `points`. */
+export function perimeter(points) {
+    let s = 0;
+    for (let i = 0; i < points.length; i++)
+        s += dist(points[i], points[(i + 1) % points.length]);
+    return s;
+}
+/** Points at `count` equal steps of arc length along the closed polygon
+ *  `points` (starting at `points[0]`, shifted by `phase` steps), each with
+ *  the polygon's outward normal there (`cw`: the polygon runs clockwise on
+ *  the page). */
+export function resampleClosed(points, count, phase = 0) {
+    const n = points.length;
+    const cum = [0];
+    for (let i = 0; i < n; i++)
+        cum.push(cum[i] + dist(points[i], points[(i + 1) % n]));
+    const total = cum[n];
+    const cw = signedArea(points) > 0;
+    const out = [];
+    let seg = 0;
+    for (let j = 0; j < count; j++) {
+        let s = ((j + phase) / count) * total;
+        s = ((s % total) + total) % total;
+        while (seg > 0 && cum[seg] > s)
+            seg--;
+        while (seg < n - 1 && cum[seg + 1] < s)
+            seg++;
+        const a = points[seg];
+        const b = points[(seg + 1) % n];
+        const t = (s - cum[seg]) / Math.max(1e-9, cum[seg + 1] - cum[seg]);
+        const e = norm(sub(b, a));
+        // Outward: left of the direction on a clockwise (y-down) polygon.
+        const nn = cw ? { x: e.y, y: -e.x } : { x: -e.y, y: e.x };
+        out.push({ p: lerp(a, b, t), n: nn });
+    }
+    return out;
+}
+//# sourceMappingURL=geom.js.map