@sudobility/music_drawing 0.0.6 → 0.0.10

package/dist/skia/skia-context.js

@@ -0,0 +1,394 @@
+import { parseCssFont } from './css-font.js';
+/** CSS `font-weight: bold`, and the neutral weight, as Skia's enum spells them. */
+const BOLD_WEIGHT = 700;
+const NORMAL_WEIGHT = 400;
+/** The 2D default font, per the canvas spec. */
+const DEFAULT_FONT = '10px sans-serif';
+/**
+ * Resolved faces, shared by every context built from the same `Skia`.
+ *
+ * The idiomatic React Native pattern records a fresh `SkCanvas` per frame —
+ * `Skia.PictureRecorder().beginRecording()` — and therefore a fresh context per
+ * frame. An instance-level cache would put a `matchFamilyStyle` lookup back on
+ * the per-frame path for every shorthand the renderer sets. Keyed on
+ * `skia.Skia`, the package's own singleton, rather than on the module wrapper,
+ * which a host may well rebuild inline at each call.
+ */
+const FONT_CACHES = new WeakMap();
+function fontCacheFor(api) {
+    const existing = FONT_CACHES.get(api);
+    if (existing)
+        return existing;
+    const created = new Map();
+    FONT_CACHES.set(api, created);
+    return created;
+}
+const IDENTITY = { a: 1, b: 0, c: 0, d: 1, e: 0, f: 0 };
+function initialState() {
+    return {
+        matrix: { ...IDENTITY },
+        fillStyle: '#000000',
+        strokeStyle: '#000000',
+        lineWidth: 1,
+        lineCap: 'butt',
+        lineJoin: 'miter',
+        font: DEFAULT_FONT,
+        globalAlpha: 1,
+        shadowBlur: 0,
+        shadowColor: 'rgba(0, 0, 0, 0)',
+        lineDash: [],
+    };
+}
+class SkiaDrawingContext {
+    constructor(options) {
+        this.state = initialState();
+        this.stack = [];
+        /** Canvas connects an arc to the current point; a fresh path has none. */
+        this.hasCurrentPoint = false;
+        this.skia = options.skia;
+        this.target = options.canvas;
+        this.canvas = { width: options.width, height: options.height };
+        this.fontCache = fontCacheFor(options.skia.Skia);
+        // After `this.skia`: a field initializer would run before the constructor
+        // body and find it undefined.
+        this.path = this.newPath();
+    }
+    // ---------------------------------------------------------------- state
+    save() {
+        this.stack.push({
+            ...this.state,
+            matrix: { ...this.state.matrix },
+            lineDash: [...this.state.lineDash],
+        });
+    }
+    restore() {
+        const previous = this.stack.pop();
+        if (previous)
+            this.state = previous;
+    }
+    get fillStyle() {
+        return this.state.fillStyle;
+    }
+    set fillStyle(value) {
+        this.state.fillStyle = value;
+    }
+    get strokeStyle() {
+        return this.state.strokeStyle;
+    }
+    set strokeStyle(value) {
+        this.state.strokeStyle = value;
+    }
+    get lineWidth() {
+        return this.state.lineWidth;
+    }
+    set lineWidth(value) {
+        // Canvas ignores a value that is not finite and positive, keeping the one
+        // before it. Skia would take a zero and stroke a hairline instead.
+        if (Number.isFinite(value) && value > 0)
+            this.state.lineWidth = value;
+    }
+    get lineCap() {
+        return this.state.lineCap;
+    }
+    set lineCap(value) {
+        this.state.lineCap = value;
+    }
+    get lineJoin() {
+        return this.state.lineJoin;
+    }
+    set lineJoin(value) {
+        this.state.lineJoin = value;
+    }
+    get font() {
+        return this.state.font;
+    }
+    set font(value) {
+        this.state.font = value;
+    }
+    get globalAlpha() {
+        return this.state.globalAlpha;
+    }
+    set globalAlpha(value) {
+        // Out of range is ignored rather than clamped, which is what canvas does.
+        if (Number.isFinite(value) && value >= 0 && value <= 1) {
+            this.state.globalAlpha = value;
+        }
+    }
+    get shadowBlur() {
+        return this.state.shadowBlur;
+    }
+    set shadowBlur(value) {
+        this.state.shadowBlur = value;
+    }
+    get shadowColor() {
+        return this.state.shadowColor;
+    }
+    set shadowColor(value) {
+        this.state.shadowColor = value;
+    }
+    setLineDash(segments) {
+        this.state.lineDash = [...segments];
+    }
+    // ------------------------------------------------------------ transform
+    translate(x, y) {
+        const m = this.state.matrix;
+        m.e += m.a * x + m.c * y;
+        m.f += m.b * x + m.d * y;
+    }
+    scale(x, y) {
+        const m = this.state.matrix;
+        m.a *= x;
+        m.b *= x;
+        m.c *= y;
+        m.d *= y;
+    }
+    setTransform(a, b, c, d, e, f) {
+        this.state.matrix = { a, b, c, d, e, f };
+    }
+    getTransform() {
+        return { ...this.state.matrix };
+    }
+    // ----------------------------------------------------------------- path
+    newPath() {
+        return this.skiaApi.Path.Make();
+    }
+    get skiaApi() {
+        return this.skia.Skia;
+    }
+    beginPath() {
+        this.path = this.newPath();
+        this.hasCurrentPoint = false;
+    }
+    closePath() {
+        this.path.close();
+    }
+    moveTo(x, y) {
+        this.path.moveTo(x, y);
+        this.hasCurrentPoint = true;
+    }
+    lineTo(x, y) {
+        // Canvas treats `lineTo` with no current point as a `moveTo`.
+        if (!this.hasCurrentPoint) {
+            this.moveTo(x, y);
+            return;
+        }
+        this.path.lineTo(x, y);
+    }
+    bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y) {
+        this.path.cubicTo(cp1x, cp1y, cp2x, cp2y, x, y);
+        this.hasCurrentPoint = true;
+    }
+    quadraticCurveTo(cpx, cpy, x, y) {
+        this.path.quadTo(cpx, cpy, x, y);
+        this.hasCurrentPoint = true;
+    }
+    arc(x, y, radius, startAngle, endAngle, counterclockwise = false) {
+        const oval = this.skiaApi.XYWHRect(x - radius, y - radius, radius * 2, radius * 2);
+        this.path.arcToOval(oval, toDegrees(startAngle), toDegrees(sweepOf(startAngle, endAngle, counterclockwise)), 
+        // Canvas draws a line from the current point to the arc's start; Skia
+        // does the same when told not to force a move.
+        !this.hasCurrentPoint);
+        this.hasCurrentPoint = true;
+    }
+    rect(x, y, width, height) {
+        this.path.addRect(this.skiaApi.XYWHRect(x, y, width, height));
+        // Canvas ends `rect()` with the current point at (x, y), so a following
+        // arc joins the path rather than opening a new contour.
+        this.hasCurrentPoint = true;
+    }
+    // ----------------------------------------------------------------- draw
+    /**
+     * Runs `draw` with the 2D transform installed, then takes it back off.
+     *
+     * Bracketing each draw rather than tracking Skia's matrix means the host's own
+     * canvas state is exactly as it was left, which matters when the context is
+     * one of several things painting into a frame.
+     */
+    inUserSpace(draw) {
+        const { a, b, c, d, e, f } = this.state.matrix;
+        this.target.save();
+        // Skia wants a row-major 3×3; canvas's six values are its top two rows.
+        this.target.concat([a, c, e, b, d, f, 0, 0, 1]);
+        draw();
+        this.target.restore();
+    }
+    paintFor(style, stroke) {
+        const paint = this.skiaApi.Paint();
+        paint.setAntiAlias(true);
+        this.applyColor(paint, style);
+        const alpha = this.state.globalAlpha;
+        if (alpha < 1)
+            paint.setAlphaf(paint.getAlphaf() * alpha);
+        if (stroke) {
+            paint.setStyle(this.skia.PaintStyle.Stroke);
+            paint.setStrokeWidth(this.state.lineWidth);
+            paint.setStrokeCap(this.strokeCap());
+            paint.setStrokeJoin(this.strokeJoin());
+            if (this.state.lineDash.length > 0) {
+                paint.setPathEffect(this.skiaApi.PathEffect.MakeDash([...this.state.lineDash]));
+            }
+        }
+        else {
+            paint.setStyle(this.skia.PaintStyle.Fill);
+        }
+        return paint;
+    }
+    /**
+     * Colours a paint from a 2D style value, never throwing.
+     *
+     * A gradient or pattern has no equivalent here — nothing in this package sets
+     * one, and a visible glyph beats a dropped one. More importantly `Skia.Color`
+     * throws on a string it cannot parse, where canvas ignores the assignment and
+     * carries on; since the renderer catches draw failures a whole system at a
+     * time, letting that through would turn one typo in a caller's theme into a
+     * swathe of missing music.
+     *
+     * If even black will not parse, the paint is left as Skia made it — which is
+     * opaque black already, so the fallback needs no colour at all.
+     */
+    applyColor(paint, style) {
+        const css = typeof style === 'string' ? style : '#000000';
+        try {
+            paint.setColor(this.skiaApi.Color(css));
+            return;
+        }
+        catch {
+            // Unparseable; try black before giving up.
+        }
+        try {
+            paint.setColor(this.skiaApi.Color('#000000'));
+        }
+        catch {
+            // Leave Skia's own default, which is opaque black.
+        }
+    }
+    strokeCap() {
+        const { StrokeCap } = this.skia;
+        if (this.state.lineCap === 'round')
+            return StrokeCap.Round;
+        if (this.state.lineCap === 'square')
+            return StrokeCap.Square;
+        return StrokeCap.Butt;
+    }
+    strokeJoin() {
+        const { StrokeJoin } = this.skia;
+        if (this.state.lineJoin === 'round')
+            return StrokeJoin.Round;
+        if (this.state.lineJoin === 'bevel')
+            return StrokeJoin.Bevel;
+        return StrokeJoin.Miter;
+    }
+    fill() {
+        const paint = this.paintFor(this.state.fillStyle, false);
+        this.inUserSpace(() => this.target.drawPath(this.path, paint));
+    }
+    stroke() {
+        const paint = this.paintFor(this.state.strokeStyle, true);
+        this.inUserSpace(() => this.target.drawPath(this.path, paint));
+    }
+    fillRect(x, y, width, height) {
+        const rect = this.skiaApi.XYWHRect(x, y, width, height);
+        const paint = this.paintFor(this.state.fillStyle, false);
+        this.inUserSpace(() => this.target.drawRect(rect, paint));
+    }
+    clearRect(x, y, width, height) {
+        const rect = this.skiaApi.XYWHRect(x, y, width, height);
+        const paint = this.skiaApi.Paint();
+        // Erase to transparent rather than paint black — the host's own background
+        // shows through, exactly as clearing a canvas does.
+        paint.setBlendMode(this.skia.BlendMode.Clear);
+        paint.setColor(this.skiaApi.Color('#00000000'));
+        this.inUserSpace(() => this.target.drawRect(rect, paint));
+    }
+    // ----------------------------------------------------------------- text
+    resolveFont() {
+        const key = this.state.font;
+        const cached = this.fontCache.get(key);
+        if (cached)
+            return cached;
+        const { family, sizePx, bold, italic } = parseCssFont(key);
+        const typeface = this.matchTypeface(family, bold, italic);
+        const font = this.skiaApi.Font(typeface ?? undefined, sizePx);
+        this.fontCache.set(key, font);
+        return font;
+    }
+    matchTypeface(family, bold, italic) {
+        try {
+            return this.skiaApi.FontMgr.System().matchFamilyStyle(family, {
+                weight: bold ? BOLD_WEIGHT : NORMAL_WEIGHT,
+                slant: italic
+                    ? this.skia.FontSlant.Italic
+                    : this.skia.FontSlant.Upright,
+            });
+        }
+        catch {
+            // No system font manager, or no match at all: Skia's default face still
+            // draws something legible, which beats losing the frame.
+            return null;
+        }
+    }
+    fillText(text, x, y) {
+        const font = this.resolveFont();
+        const paint = this.paintFor(this.state.fillStyle, false);
+        this.inUserSpace(() => this.target.drawText(text, x, y, paint, font));
+    }
+    measureText(text) {
+        const font = this.resolveFont();
+        const bounds = font.measureText(text);
+        const metrics = font.getMetrics();
+        // `measureText` returns glyph *bounds*; canvas reports the advance width,
+        // which includes side bearings. Summing glyph advances is the equivalent.
+        const widths = font.getGlyphWidths(font.getGlyphIDs(text));
+        const advance = widths.reduce((total, width) => total + width, 0);
+        return {
+            width: advance > 0 ? advance : bounds.width,
+            actualBoundingBoxAscent: -bounds.y,
+            actualBoundingBoxDescent: bounds.height + bounds.y,
+            fontBoundingBoxAscent: -metrics.ascent,
+            fontBoundingBoxDescent: metrics.descent,
+        };
+    }
+}
+const DEGREES_PER_RADIAN = 180 / Math.PI;
+const TAU = Math.PI * 2;
+function toDegrees(radians) {
+    return radians * DEGREES_PER_RADIAN;
+}
+/**
+ * Canvas's arc-direction rule as a signed sweep.
+ *
+ * Going clockwise the sweep is positive and wraps up to a full turn; going
+ * counterclockwise it is negative. A range wider than a full turn is clamped,
+ * which is what makes `arc(…, 0, 2π)` a circle rather than nothing.
+ */
+function sweepOf(startAngle, endAngle, counterclockwise) {
+    const delta = endAngle - startAngle;
+    if (!counterclockwise) {
+        if (delta >= TAU)
+            return TAU;
+        return delta < 0 ? TAU - (-delta % TAU) : delta;
+    }
+    if (delta <= -TAU)
+        return -TAU;
+    return delta > 0 ? -(TAU - (delta % TAU)) : delta;
+}
+/**
+ * Wraps a Skia canvas as the 2D drawing context this package paints into.
+ *
+ * ```ts
+ * import * as skia from '@shopify/react-native-skia';
+ * import { CanvasScoreRenderer } from '@sudobility/music_drawing';
+ * import { createSkiaContext2D } from '@sudobility/music_drawing/skia';
+ *
+ * const ctx = createSkiaContext2D({ skia, canvas, width, height });
+ * new CanvasScoreRenderer().render(score, ctx, options);
+ * ```
+ *
+ * The Skia module is injected rather than imported so that this package
+ * depends on nothing but `vexflow`; passing the namespace is what type-checks
+ * the host's Skia against what the adapter uses.
+ */
+export function createSkiaContext2D(options) {
+    return new SkiaDrawingContext(options);
+}
+//# sourceMappingURL=skia-context.js.map

package/dist/skia/skia-context.js.map

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

package/dist/test/canvas-stub.d.ts

@@ -1,20 +1,20 @@
 /**
- * A recording stand-in for `CanvasRenderingContext2D`: every method call is
+ * A recording stand-in for `DrawingContext2D`: every method call is
  * appended to `ops`; every property write is accepted; `measureText`
  * returns a deterministic width (8px/char) so VexFlow text layout math
  * stays finite. Proxy-based so any method VexFlow's `CanvasContext` calls
  * is recorded without this double having to enumerate the whole 2D API —
  * new methods VexFlow starts calling never require test-double updates.
  *
- * Exported from the package root (like `testStoreContext`) so downstream
- * suites — music_app's jsdom setup stubs `HTMLCanvasElement.getContext`
- * with it — share one implementation.
+ * Published at `@sudobility/music_drawing/test` so downstream suites — a jsdom
+ * setup stubbing `getContext`, say — share one implementation.
  */
+import type { DrawingContext2D } from '../drawing-context.js';
 export type MockOp = {
     method: string;
     args: unknown[];
 };
-export type Mock2DContext = CanvasRenderingContext2D & {
+export type Mock2DContext = DrawingContext2D & {
     ops: MockOp[];
 };
 export declare function createMock2DContext(width?: number, height?: number): Mock2DContext;

package/dist/test/canvas-stub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-stub.d.ts","sourceRoot":"","sources":["../../src/test/canvas-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,wBAAgB,mBAAmB,CAAC,KAAK,SAAM,EAAE,MAAM,SAAM,GAAG,aAAa,CAoC5E"}
+{"version":3,"file":"canvas-stub.d.ts","sourceRoot":"","sources":["../../src/test/canvas-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEjE,wBAAgB,mBAAmB,CAAC,KAAK,SAAM,EAAE,MAAM,SAAM,GAAG,aAAa,CAoC5E"}

package/dist/test/canvas-stub.js

@@ -1,14 +1,13 @@
 /**
- * A recording stand-in for `CanvasRenderingContext2D`: every method call is
+ * A recording stand-in for `DrawingContext2D`: every method call is
  * appended to `ops`; every property write is accepted; `measureText`
  * returns a deterministic width (8px/char) so VexFlow text layout math
  * stays finite. Proxy-based so any method VexFlow's `CanvasContext` calls
  * is recorded without this double having to enumerate the whole 2D API —
  * new methods VexFlow starts calling never require test-double updates.
  *
- * Exported from the package root (like `testStoreContext`) so downstream
- * suites — music_app's jsdom setup stubs `HTMLCanvasElement.getContext`
- * with it — share one implementation.
+ * Published at `@sudobility/music_drawing/test` so downstream suites — a jsdom
+ * setup stubbing `getContext`, say — share one implementation.
  */
 export function createMock2DContext(width = 800, height = 600) {
     const ops = [];

package/dist/test/canvas-stub.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas-stub.js","sourceRoot":"","sources":["../../src/test/canvas-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,UAAU,mBAAmB,CAAC,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAqC;QAC9C,GAAG;QACH,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACzB,WAAW,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAC9B,uBAAuB,EAAE,CAAC;YAC1B,wBAAwB,EAAE,CAAC;YAC3B,qBAAqB,EAAE,CAAC;YACxB,sBAAsB,EAAE,CAAC;SAC1B,CAAC;QACF,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5D,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAC/D,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAC/D,YAAY,EAAE,CAAC,EAAU,EAAE,EAAU,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;YAC/D,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,IAAI,iBAAiB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACvC,CAAC;KACH,CAAC;IACF,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtB,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;gBAChC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK;YACrB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAA6B,CAAC;AACjC,CAAC"}
+{"version":3,"file":"canvas-stub.js","sourceRoot":"","sources":["../../src/test/canvas-stub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,UAAU,mBAAmB,CAAC,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAqC;QAC9C,GAAG;QACH,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACzB,WAAW,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAC9B,uBAAuB,EAAE,CAAC;YAC1B,wBAAwB,EAAE,CAAC;YAC3B,qBAAqB,EAAE,CAAC;YACxB,sBAAsB,EAAE,CAAC;SAC1B,CAAC;QACF,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5D,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAC/D,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAC/D,YAAY,EAAE,CAAC,EAAU,EAAE,EAAU,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;YAC/D,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,IAAI,iBAAiB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACvC,CAAC;KACH,CAAC;IACF,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtB,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;gBAChC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK;YACrB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAA6B,CAAC;AACjC,CAAC"}

package/dist/test/fake-skia.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A recording stand-in for the `@shopify/react-native-skia` module.
+ *
+ * The adapter in `src/skia/` takes its Skia by injection, which is what makes
+ * this possible: the whole React Native drawing path can be exercised in Node,
+ * with no native module, no simulator and no 1.6 GB dependency. Every draw is
+ * recorded with the *effective* matrix at the time it happened, so a test can
+ * assert where something landed and not merely that it was drawn.
+ *
+ * Published at `@sudobility/music_drawing/test` alongside
+ * `createMock2DContext`, so a host app can reuse it to test its own Skia render
+ * surface.
+ */
+import type { SkiaCanvas, SkiaModule, SkiaRect } from '../skia/skia-api.js';
+/** One path command, in the order the adapter issued it. */
+export type FakePathCommand = {
+    command: string;
+    args: number[];
+};
+export type FakePaintState = {
+    color: string;
+    /** 0 fill, 1 stroke — Skia's own `PaintStyle` values. */
+    style: number;
+    strokeWidth: number;
+    cap: number;
+    join: number;
+    alpha: number;
+    blendMode: number | null;
+    dashed: boolean;
+};
+export type FakeDraw = {
+    op: 'drawPath';
+    commands: FakePathCommand[];
+    paint: FakePaintState;
+    matrix: number[];
+} | {
+    op: 'drawRect';
+    rect: SkiaRect;
+    paint: FakePaintState;
+    matrix: number[];
+} | {
+    op: 'drawText';
+    text: string;
+    x: number;
+    y: number;
+    paint: FakePaintState;
+    font: FakeFontState;
+    matrix: number[];
+};
+export type FakeFontState = {
+    family: string;
+    size: number;
+    bold: boolean;
+};
+/** A request that reached the font manager, so tests can assert style resolution. */
+export type FakeFontRequest = {
+    family: string;
+    style: unknown;
+};
+export type FakeSkia = SkiaModule & {
+    canvas: SkiaCanvas;
+    draws: FakeDraw[];
+    fontRequests: FakeFontRequest[];
+};
+/**
+ * Where a point ends up under a recorded matrix, computed straight from Skia's
+ * row-major contract: `[scaleX, skewX, transX, skewY, scaleY, transY]`.
+ *
+ * This is the independent half of the transform tests. Asserting on the matrix
+ * array alone cannot catch a transposition — the adapter and this fake would
+ * simply agree on the wrong order, and every transform the renderer uses is
+ * diagonal, where a transpose is invisible. Mapping a point under a *skewed*
+ * matrix and comparing against what canvas semantics say it should be checks
+ * the two sides against the spec rather than against each other.
+ */
+export declare function mapPoint(matrix: number[], x: number, y: number): {
+    x: number;
+    y: number;
+};
+export declare function createFakeSkia(): FakeSkia;
+//# sourceMappingURL=fake-skia.d.ts.map

package/dist/test/fake-skia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-skia.d.ts","sourceRoot":"","sources":["../../src/test/fake-skia.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,UAAU,EAGV,UAAU,EAGV,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAChB;IACE,EAAE,EAAE,UAAU,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3E;IACE,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEN,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5E,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC,CAAC;AAUF;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EAAE,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAyBD,wBAAgB,cAAc,IAAI,QAAQ,CAoMzC"}