@motion-script/web 0.1.0

package/dist/shapes/index.js

@@ -0,0 +1,297 @@
+import { RectShape } from "./rect";
+import { EllipseShape } from "./ellipse";
+import { PathShape } from "./path";
+import { LineShape } from "./line";
+import { buildText } from "./text";
+import { PolygonShape } from "./polygon";
+import { PolygramShape } from "./polygram";
+import { BooleanHandler } from "./boolean";
+import { MaskHandler } from "./mask";
+// Shallow equality check for plain state objects. Handles the common case where
+// all values are primitives or the same object reference (e.g. arrays held stable).
+function shallowEqual(a, b) {
+    const keysA = Object.keys(a);
+    if (keysA.length !== Object.keys(b).length)
+        return false;
+    for (const k of keysA) {
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+function shallowEqualExcluding(a, b, ...exclude) {
+    const excSet = new Set(exclude);
+    const keysA = Object.keys(a).filter(k => !excSet.has(k));
+    const keysB = Object.keys(b).filter(k => !excSet.has(k));
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA) {
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+export class ShapeHandler {
+    canvasKit;
+    getCanvas;
+    getPaint;
+    fontMgr;
+    shapes = [];
+    paintApplied = false;
+    pendingShadows = null;
+    boolean;
+    mask;
+    // Bounds override stack. Callers like the image-node renderer push their
+    // own rect so fills that depend on shape bounds (gradients, image-shaders)
+    // resolve correctly even though no path lives in `shapes`.
+    boundsOverride = [];
+    // Shape instance cache: survives reset() so ckPaths persist across frames.
+    // Key format: "<nodeId>:<shapeIndex>"
+    shapeCache = new Map();
+    currentNodeId = "";
+    shapeIndex = 0;
+    // Cached union bounds for the current shape set, cleared when shapes change.
+    _cachedBounds = null;
+    _boundsDirty = true;
+    constructor(canvasKit, getCanvas, getPaint, fontMgr) {
+        this.canvasKit = canvasKit;
+        this.getCanvas = getCanvas;
+        this.getPaint = getPaint;
+        this.fontMgr = fontMgr;
+        this.boolean = new BooleanHandler(canvasKit, getCanvas);
+        this.mask = new MaskHandler(canvasKit, getCanvas, this.boolean);
+    }
+    beginNode(nodeId) {
+        this.currentNodeId = nodeId;
+        this.shapeIndex = 0;
+    }
+    reset() {
+        this.shapes = [];
+        this.paintApplied = false;
+        this.pendingShadows = null;
+        this._boundsDirty = true;
+        this._cachedBounds = null;
+    }
+    storePendingShadows(shadows) {
+        this.pendingShadows = shadows.length > 0 ? shadows : null;
+    }
+    takePendingShadows() {
+        const s = this.pendingShadows;
+        this.pendingShadows = null;
+        return s;
+    }
+    dispose() {
+        this.shapes = [];
+        for (const entry of this.shapeCache.values()) {
+            entry.shape.deletePaths();
+        }
+        this.shapeCache.clear();
+        this.boolean.dispose();
+        this.mask.dispose();
+    }
+    isCollectingPaths() {
+        return this.boolean.isCollecting();
+    }
+    pushBounds(b) {
+        this.boundsOverride.push(b);
+    }
+    popBounds() {
+        this.boundsOverride.pop();
+    }
+    getShapeBounds() {
+        if (this.boundsOverride.length > 0) {
+            return this.boundsOverride[this.boundsOverride.length - 1];
+        }
+        if (!this._boundsDirty && this._cachedBounds !== null) {
+            return this._cachedBounds;
+        }
+        let left = Infinity, top = Infinity, right = -Infinity, bottom = -Infinity;
+        for (const shape of this.shapes) {
+            if (shape.ckPath) {
+                const b = shape.ckPath.getBounds();
+                if (b[0] < left)
+                    left = b[0];
+                if (b[1] < top)
+                    top = b[1];
+                if (b[2] > right)
+                    right = b[2];
+                if (b[3] > bottom)
+                    bottom = b[3];
+            }
+            else if (shape.bounds) {
+                if (shape.bounds.left < left)
+                    left = shape.bounds.left;
+                if (shape.bounds.top < top)
+                    top = shape.bounds.top;
+                if (shape.bounds.right > right)
+                    right = shape.bounds.right;
+                if (shape.bounds.bottom > bottom)
+                    bottom = shape.bounds.bottom;
+            }
+        }
+        this._boundsDirty = false;
+        this._cachedBounds = isFinite(left) ? { left, top, right, bottom } : null;
+        return this._cachedBounds;
+    }
+    addShape(newShape) {
+        this._boundsDirty = true;
+        const isolated = !this.boolean.isCollecting();
+        // Try to reuse a cached shape if we have a stable node ID.
+        let shape = newShape;
+        if (this.currentNodeId) {
+            const key = `${this.currentNodeId}:${this.shapeIndex++}`;
+            const entry = this.shapeCache.get(key);
+            if (entry) {
+                const cached = entry.shape;
+                const newState = newShape.inputState;
+                const oldState = cached.inputState;
+                if (shallowEqual(newState, oldState)) {
+                    // Exact match — reuse the cached shape (with its ckPath intact).
+                    shape = cached;
+                }
+                else if (cached.hasTrim() && newShape.hasTrim()
+                    && shallowEqualExcluding(newState, oldState, 'start', 'end')) {
+                    // Only trim range changed — re-trim from the cached base path.
+                    const { start, end } = newShape.trimRange();
+                    if (entry.trimStart !== start || entry.trimEnd !== end) {
+                        cached.retrim(start, end);
+                        entry.trimStart = start;
+                        entry.trimEnd = end;
+                    }
+                    cached.inputState = newShape.inputState;
+                    shape = cached;
+                }
+                else {
+                    // State mismatch — evict old entry and use new shape.
+                    cached.deletePaths();
+                    const tr = newShape.hasTrim() ? newShape.trimRange() : { start: 0, end: 1 };
+                    this.shapeCache.set(key, { shape: newShape, trimStart: tr.start, trimEnd: tr.end });
+                    shape = newShape;
+                }
+            }
+            else {
+                const tr = newShape.hasTrim() ? newShape.trimRange() : { start: 0, end: 1 };
+                this.shapeCache.set(key, { shape: newShape, trimStart: tr.start, trimEnd: tr.end });
+            }
+        }
+        if (!isolated) {
+            shape.ensurePath();
+            if (shape.ckPath)
+                this.boolean.contributeToPathCollection(shape.ckPath);
+        }
+        this.shapes.push(shape.toCurrentShape(isolated));
+    }
+    rect(state) {
+        this.addShape(new RectShape(this.canvasKit, this.getCanvas(), state));
+    }
+    ellipse(state) {
+        this.addShape(new EllipseShape(this.canvasKit, this.getCanvas(), state));
+    }
+    path(state) {
+        this.addShape(new PathShape(this.canvasKit, this.getCanvas(), state));
+    }
+    line(state) {
+        this.addShape(new LineShape(this.canvasKit, this.getCanvas(), state));
+    }
+    polygon(state) {
+        this.addShape(new PolygonShape(this.canvasKit, this.getCanvas(), state));
+    }
+    polygram(state) {
+        this.addShape(new PolygramShape(this.canvasKit, this.getCanvas(), state));
+    }
+    text(state) {
+        this._boundsDirty = true;
+        const shape = buildText(this.canvasKit, this.getCanvas(), this.fontMgr, state);
+        this.shapes.push(shape);
+    }
+    // ─── Cut ───────────────────────────────────────────────────────────────────
+    // Use the most-recently drawn shape as a cutter: union all the shapes before
+    // it, then subtract that last shape, so only it punches a hole. The combined
+    // path replaces `shapes`, so anything drawn afterward stacks onto it and the
+    // whole thing paints as one surface — a single gradient resolves across all
+    // of it. Shapes without a ckPath (text) are skipped.
+    cut() {
+        const withPaths = this.shapes.filter(s => s.ckPath);
+        if (withPaths.length === 0)
+            return;
+        // The last shape is the cutter; everything before it is the base.
+        const cutter = withPaths[withPaths.length - 1].ckPath.copy();
+        const baseShapes = withPaths.slice(0, -1);
+        let combined;
+        if (baseShapes.length === 0) {
+            // Nothing to cut from — the lone shape stays as-is.
+            cutter.delete();
+            combined = withPaths[0].ckPath.copy();
+        }
+        else {
+            const base = this.boolean.combinePaths(baseShapes.map(s => s.ckPath.copy()), "union");
+            if (!base) {
+                cutter.delete();
+                combined = null;
+            }
+            else {
+                combined = this.boolean.combinePaths([base, cutter], "subtract");
+            }
+        }
+        // combinePaths consumed/deleted the copies; now drop the originals.
+        for (const shape of this.shapes)
+            shape.ckPath?.delete();
+        this.shapes = [];
+        this.paintApplied = false;
+        if (!combined)
+            return;
+        const canvas = this.getCanvas();
+        this.shapes.push({
+            draw: (paint) => { canvas.drawPath(combined, paint); },
+            ckPath: combined,
+        });
+    }
+    // Build a single shape from the union of all accumulated path shapes, so a
+    // stroke follows only the outer boundary with no seams where shapes overlap.
+    // Returns null when there are fewer than two path shapes (caller strokes the
+    // shapes directly) or text is involved (no path to union). The caller owns
+    // the returned shape's ckPath and must delete() it. Does not mutate `shapes`.
+    unionStrokeShape() {
+        if (this.shapes.some(s => s.isText))
+            return null;
+        const withPaths = this.shapes.filter(s => s.ckPath);
+        if (withPaths.length < 2)
+            return null;
+        const combined = this.boolean.combinePaths(withPaths.map(s => s.ckPath.copy()), "union");
+        if (!combined)
+            return null;
+        const canvas = this.getCanvas();
+        return {
+            draw: (paint) => { canvas.drawPath(combined, paint); },
+            ckPath: combined,
+        };
+    }
+    // ─── Boolean ─────────────────────────────────────────────────────────────
+    beginBoolean(op) {
+        this.boolean.beginBoolean(op);
+    }
+    endBoolean() {
+        const shape = this.boolean.endBoolean(this.getCanvas);
+        this.shapes = [];
+        this.paintApplied = false;
+        if (shape)
+            this.shapes.push(shape);
+    }
+    // ─── Mask ─────────────────────────────────────────────────────────────────
+    beginMask(options) {
+        this.mask.beginMask(options);
+    }
+    applyMask() {
+        this.mask.applyMask(() => {
+            this.shapes = [];
+            this.paintApplied = false;
+        });
+    }
+    endMask() {
+        this.mask.endMask();
+    }
+    getMaskApply() {
+        return this.mask.getApply();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/shapes/index.js.map

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

package/dist/shapes/line.d.ts

@@ -0,0 +1,25 @@
+import { LineState, Vector2 } from "@motion-script/core";
+import { BaseShape } from "./base";
+type LineGeo = {
+    points: Vector2[];
+    radius: number;
+    closed: boolean;
+};
+/**
+ * Polyline (open or closed) through `points`, with corners optionally rounded
+ * by cutting back along each adjacent edge and joining with a quadratic curve
+ * (`radius` clamped to half the shorter adjacent edge to avoid overshoot).
+ */
+export declare class LineShape extends BaseShape<LineState, LineGeo> {
+    protected resolveState(state: Partial<LineState>): LineState;
+    protected computeGeometry(): LineGeo;
+    protected buildSVGPath(geo: LineGeo): string;
+    protected needsTrim(): boolean;
+    protected getTrimRange(): {
+        start: number;
+        end: number;
+    };
+    ensurePath(): void;
+}
+export {};
+//# sourceMappingURL=line.d.ts.map

package/dist/shapes/line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../src/shapes/line.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC,KAAK,OAAO,GAAG;IACX,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC;AA6DF;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IACxD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS;IAI5D,SAAS,CAAC,eAAe,IAAI,OAAO;IAKpC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5C,SAAS,CAAC,SAAS,IAAI,OAAO;IAI9B,SAAS,CAAC,YAAY;;;;IAKb,UAAU,IAAI,IAAI;CAI9B"}

package/dist/shapes/line.js

@@ -0,0 +1,87 @@
+import { withLineDescriptor } from "@motion-script/core";
+import { BaseShape } from "./base";
+function buildLineSvg(points, radius, closed) {
+    if (points.length === 0)
+        return "M 0 0";
+    if (points.length === 1)
+        return `M ${points[0].x} ${points[0].y}`;
+    const r = Math.max(0, radius);
+    const parts = [];
+    const count = points.length;
+    const getDir = (a, b) => {
+        const dx = b.x - a.x;
+        const dy = b.y - a.y;
+        const len = Math.sqrt(dx * dx + dy * dy);
+        return len > 0 ? { dx: dx / len, dy: dy / len, len } : { dx: 0, dy: 0, len: 0 };
+    };
+    if (r === 0) {
+        parts.push(`M ${points[0].x} ${points[0].y}`);
+        for (let i = 1; i < count; i++) {
+            parts.push(`L ${points[i].x} ${points[i].y}`);
+        }
+    }
+    else {
+        const endIdx = closed ? count : count - 1;
+        for (let i = 0; i <= endIdx; i++) {
+            const prev = points[(i - 1 + count) % count];
+            const curr = points[i % count];
+            const next = points[(i + 1) % count];
+            if (!closed && i === 0) {
+                parts.push(`M ${curr.x} ${curr.y}`);
+                continue;
+            }
+            if (!closed && i === count - 1) {
+                parts.push(`L ${curr.x} ${curr.y}`);
+                continue;
+            }
+            const dIn = getDir(prev, curr);
+            const dOut = getDir(curr, next);
+            const cutIn = Math.min(r, dIn.len / 2);
+            const cutOut = Math.min(r, dOut.len / 2);
+            const inX = curr.x - dIn.dx * cutIn;
+            const inY = curr.y - dIn.dy * cutIn;
+            const outX = curr.x + dOut.dx * cutOut;
+            const outY = curr.y + dOut.dy * cutOut;
+            if (i === 0 && closed) {
+                parts.push(`M ${inX} ${inY}`);
+            }
+            else {
+                parts.push(`L ${inX} ${inY}`);
+            }
+            parts.push(`Q ${curr.x} ${curr.y} ${outX} ${outY}`);
+        }
+    }
+    if (closed)
+        parts.push("Z");
+    return parts.join(" ");
+}
+/**
+ * Polyline (open or closed) through `points`, with corners optionally rounded
+ * by cutting back along each adjacent edge and joining with a quadratic curve
+ * (`radius` clamped to half the shorter adjacent edge to avoid overshoot).
+ */
+export class LineShape extends BaseShape {
+    resolveState(state) {
+        return withLineDescriptor(state);
+    }
+    computeGeometry() {
+        const { points, radius, closed } = this.fullState;
+        return { points, radius, closed };
+    }
+    buildSVGPath(geo) {
+        return buildLineSvg(geo.points, geo.radius, geo.closed);
+    }
+    needsTrim() {
+        return this.fullState.start !== 0 || this.fullState.end !== 1;
+    }
+    getTrimRange() {
+        return { start: this.fullState.start, end: this.fullState.end };
+    }
+    // ensurePath() guards against empty points before attempting path creation
+    ensurePath() {
+        if (this.fullState.points.length === 0)
+            return;
+        super.ensurePath();
+    }
+}
+//# sourceMappingURL=line.js.map

package/dist/shapes/line.js.map

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

package/dist/shapes/mask.d.ts

@@ -0,0 +1,28 @@
+import type { CanvasKit, Canvas } from "@motion-script/canvaskit";
+import { MaskApplyLayer, MaskOptions } from "@motion-script/core";
+import type { BooleanHandler } from "./boolean";
+/**
+ * Implements the three mask modes by composing canvas save/clip/blend
+ * primitives:
+ *  - "vector": collect contributed paths into a union and `clipPath` directly
+ *    (no layer — cheapest, but limited to geometric shapes).
+ *  - "luminance": render the mask content through a luminance-to-alpha color
+ *    filter into a layer, so pixel brightness drives opacity.
+ *  - "alpha": render the mask content into a plain layer and blend the masked
+ *    content against it with `SrcIn`/`SrcOut`.
+ * `restores` records how many `canvas.restore()` calls `endMask` must issue
+ * to unwind the saves made in `beginMask`/`applyMask`.
+ */
+export declare class MaskHandler {
+    private canvasKit;
+    private getCanvas;
+    private boolean;
+    private maskStack;
+    constructor(canvasKit: CanvasKit, getCanvas: () => Canvas, boolean: BooleanHandler);
+    dispose(): void;
+    beginMask(options?: MaskOptions): void;
+    getApply(): Set<MaskApplyLayer> | null;
+    applyMask(onReset: () => void): void;
+    endMask(): void;
+}
+//# sourceMappingURL=mask.d.ts.map

package/dist/shapes/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../src/shapes/mask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAY,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAUhD;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IAIhB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IALnB,OAAO,CAAC,SAAS,CAAmB;gBAGxB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,MAAM,EACvB,OAAO,EAAE,cAAc;IAGnC,OAAO,IAAI,IAAI;IAIf,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAuCtC,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,IAAI;IAKtC,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAsCpC,OAAO,IAAI,IAAI;CAQlB"}

package/dist/shapes/mask.js

@@ -0,0 +1,106 @@
+/**
+ * Implements the three mask modes by composing canvas save/clip/blend
+ * primitives:
+ *  - "vector": collect contributed paths into a union and `clipPath` directly
+ *    (no layer — cheapest, but limited to geometric shapes).
+ *  - "luminance": render the mask content through a luminance-to-alpha color
+ *    filter into a layer, so pixel brightness drives opacity.
+ *  - "alpha": render the mask content into a plain layer and blend the masked
+ *    content against it with `SrcIn`/`SrcOut`.
+ * `restores` records how many `canvas.restore()` calls `endMask` must issue
+ * to unwind the saves made in `beginMask`/`applyMask`.
+ */
+export class MaskHandler {
+    canvasKit;
+    getCanvas;
+    boolean;
+    maskStack = [];
+    constructor(canvasKit, getCanvas, boolean) {
+        this.canvasKit = canvasKit;
+        this.getCanvas = getCanvas;
+        this.boolean = boolean;
+    }
+    dispose() {
+        this.maskStack = [];
+    }
+    beginMask(options) {
+        const canvas = this.getCanvas();
+        const mode = options?.mode ?? "alpha";
+        const inverted = options?.inverted ?? false;
+        const raw = options?.apply;
+        const apply = raw != null
+            ? new Set(Array.isArray(raw) ? raw : [raw])
+            : null;
+        if (mode === "vector") {
+            canvas.save();
+            this.boolean.pushFrame();
+            this.maskStack.push({ mode, inverted, apply, restores: 1 });
+            return;
+        }
+        if (mode === "luminance") {
+            canvas.saveLayer();
+            const lumPaint = new this.canvasKit.Paint();
+            const lumFilter = this.canvasKit.ColorFilter.MakeMatrix([
+                0, 0, 0, 0, 0,
+                0, 0, 0, 0, 0,
+                0, 0, 0, 0, 0,
+                0.2126, 0.7152, 0.0722, 0, 0,
+            ]);
+            lumPaint.setColorFilter(lumFilter);
+            canvas.saveLayer(lumPaint);
+            lumPaint.delete();
+            this.maskStack.push({ mode, inverted, apply, restores: 2 });
+            return;
+        }
+        // alpha
+        canvas.saveLayer();
+        this.maskStack.push({ mode, inverted, apply, restores: 2 });
+    }
+    // Returns the apply set for the innermost active mask, or null if no mask
+    // is active / no apply restriction was set (= all layers pass through).
+    getApply() {
+        const top = this.maskStack[this.maskStack.length - 1];
+        return top?.apply ?? null;
+    }
+    applyMask(onReset) {
+        const canvas = this.getCanvas();
+        const top = this.maskStack[this.maskStack.length - 1];
+        if (!top) {
+            console.warn("applyMask() called outside of a mask scope.");
+            return;
+        }
+        if (top.mode === "vector") {
+            const paths = this.boolean.popFrame();
+            const combined = this.boolean.combinePaths(paths, "union");
+            onReset();
+            if (combined) {
+                const op = top.inverted
+                    ? this.canvasKit.ClipOp.Difference
+                    : this.canvasKit.ClipOp.Intersect;
+                canvas.clipPath(combined, op, true);
+                combined.delete();
+            }
+            return;
+        }
+        if (top.mode === "luminance") {
+            canvas.restore();
+        }
+        const blendPaint = new this.canvasKit.Paint();
+        blendPaint.setBlendMode(top.inverted
+            ? this.canvasKit.BlendMode.SrcOut
+            : this.canvasKit.BlendMode.SrcIn);
+        canvas.saveLayer(blendPaint);
+        blendPaint.delete();
+        onReset();
+    }
+    endMask() {
+        const frame = this.maskStack.pop();
+        if (!frame)
+            return;
+        const canvas = this.getCanvas();
+        for (let i = 0; i < frame.restores; i++) {
+            canvas.restore();
+        }
+    }
+}
+//# sourceMappingURL=mask.js.map

package/dist/shapes/mask.js.map

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

package/dist/shapes/paragraph-layout.d.ts

@@ -0,0 +1,64 @@
+import type { CanvasKit, Font, Paint, Canvas, TypefaceFontProvider } from "@motion-script/canvaskit";
+import type { FontStyle, TextAlign } from "@motion-script/core";
+/**
+ * One styled run of text fed to the paragraph layout. Mirrors the fields the
+ * layout engine needs; callers attach their own draw-time data (fills/strokes)
+ * separately, keyed by run index.
+ */
+export interface ParagraphSegment {
+    text: string;
+    fontFamily: string;
+    fontSize: number;
+    fontWeight: number;
+    fontStyle: FontStyle;
+    letterSpacing: number;
+}
+/**
+ * A shaped run ready to draw with our own paints. We let CanvasKit's
+ * ParagraphBuilder do shaping/line-breaking/positioning (the layout power),
+ * but draw via canvas.drawGlyphs with a Font we own (the path-glyph power) so
+ * gradient/image fills and glyph-union strokes keep working. We build that Font
+ * from the run's own `typeface` (this CanvasKit build hands back the
+ * variation-positioned instance, e.g. a variable font at the run's `wght`), so
+ * the drawn glyphs match the shaped weight exactly.
+ */
+export interface ShapedRun {
+    /** Index of the originating ParagraphSegment, for mapping fills/strokes. */
+    segmentIndex: number;
+    glyphs: Uint16Array;
+    /** x,y pairs, already offset to the shape's centered coordinate space. */
+    positions: Float32Array;
+    font: Font;
+}
+export interface ParagraphLayoutResult {
+    runs: ShapedRun[];
+    bounds: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    /** Intrinsic block width/height of the laid-out text. */
+    width: number;
+    height: number;
+    /** Fonts created during layout; caller must delete() each after drawing. */
+    fonts: Font[];
+}
+/**
+ * Lay out styled segments through ParagraphBuilder and return shaped glyph runs
+ * positioned in a coordinate space centered on (originX, originY). `maxWidth`
+ * bounds line wrapping; pass Infinity (mapped to a large value) for no wrap.
+ *
+ * The fontMgr must already have the families registered (loadFont); a private
+ * FontCollection wrapping it is created per call.
+ */
+export declare function layoutParagraph(canvasKit: CanvasKit, fontMgr: TypefaceFontProvider, segments: ParagraphSegment[], opts: {
+    align: TextAlign;
+    lineHeight: number;
+    maxWidth: number;
+    originX: number;
+    originY: number;
+}): ParagraphLayoutResult;
+/** Draw a shaped run with the given paint via our own glyph pipeline. */
+export declare function drawShapedRun(canvas: Canvas, run: ShapedRun, paint: Paint): void;
+//# sourceMappingURL=paragraph-layout.d.ts.map

package/dist/shapes/paragraph-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-layout.d.ts","sourceRoot":"","sources":["../../src/shapes/paragraph-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAY,MAAM,0BAA0B,CAAC;AAC/G,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACtB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,SAAS,EAAE,YAAY,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,EAAE,IAAI,EAAE,CAAC;CACjB;AAqBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,EAAE;IACF,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB,GACF,qBAAqB,CA4HvB;AAeD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAEhF"}