@hexpro/qr-code-studio 0.0.0-stage → 0.1.0

package/dist/render/raster.js

@@ -0,0 +1,245 @@
+/**
+ * The rasteriser: a scene to RGBA pixels, identical in every engine.
+ *
+ * The scan check draws a design with this and reads it back, and a PNG export
+ * is this output encoded, so both must give the same bytes in Node, Chromium,
+ * WebKit and Firefox. That rules out a canvas, whose anti-aliasing and
+ * blending differ by engine and by GPU, and it is the reason for every choice
+ * below: coverage is exact (see `coverage.ts`), curves are cut by a formula
+ * that needs only a square root, all arithmetic is float64 with no function
+ * IEEE 754 leaves loose, and there is exactly one rounding to bytes, at the
+ * end of each row.
+ *
+ * Compositing is source over in sRGB gamma space, which is how browsers draw
+ * SVG, so a rasterised scene and the same scene's SVG in a browser agree to
+ * within anti-aliasing. Each layer's coverage is computed for the layer as a
+ * whole, so two shapes that touch inside one layer are one region and their
+ * shared edge is not blended twice into a seam. A group with an opacity or a
+ * clip is drawn into a row of its own and then laid over its parent, as SVG
+ * isolates it.
+ *
+ * The image is produced a row at a time, top to bottom, so beyond the output
+ * itself the memory is the geometry and a few rows of float64.
+ */
+import { QrStudioError } from '../core/errors.js';
+import { PathBuilder } from '../geometry/path.js';
+import { checkColour } from './colour.js';
+import { CoverageScratch, EdgeSet } from './coverage.js';
+import { PreparedPaint, over } from './paint.js';
+import { normaliseScene } from './scene.js';
+/**
+ * The most pixels one call will allocate: a gibibyte of RGBA.
+ *
+ * 8000 by 8000, the largest export the studio offers, is a quarter of it.
+ */
+export const MAX_PIXELS = 268435456;
+function size(value, name) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        throw new TypeError(`rasterise: ${name} is a whole number of pixels, 1 or more.`);
+    }
+    return value;
+}
+export function rasterise(scene, options) {
+    if (typeof options !== 'object' || options === null) {
+        throw new TypeError('rasterise: options gives at least the width in pixels.');
+    }
+    const normal = normaliseScene(scene, 'rasterise');
+    const width = size(options.width, 'width');
+    const height = options.height === undefined
+        ? Math.max(1, Math.round((width * normal.height) / normal.width))
+        : size(options.height, 'height');
+    if (options.background !== undefined)
+        checkColour(options.background, 'rasterise: background');
+    if (width * height > MAX_PIXELS) {
+        throw new QrStudioError('render/surface-too-large', 'That picture is too large to draw here. Choose a smaller size.', { width, height, maxPixels: MAX_PIXELS });
+    }
+    const sx = width / normal.width;
+    const sy = height / normal.height;
+    const unitsX = normal.width / width;
+    const unitsY = normal.height / height;
+    const shared = new CoverageScratch(width);
+    const edgesOf = (path) => EdgeSet.fromPath(path, shared, height, sx, sy);
+    let depth = 0;
+    const prepare = (node, level) => {
+        if (level > depth)
+            depth = level;
+        if (node.kind === 'path') {
+            return {
+                kind: 'path',
+                edges: edgesOf(node.path),
+                paint: new PreparedPaint(node.paint),
+            };
+        }
+        const clip = node.clip === null ? null : edgesOf(node.clip);
+        if (node.kind === 'image') {
+            const box = new PathBuilder().rect(node.x, node.y, node.width, node.height).build();
+            return { kind: 'image', box: edgesOf(box), clip, node };
+        }
+        return {
+            kind: 'group',
+            children: node.children.map((child) => prepare(child, level + 1)),
+            clip,
+            opacity: node.opacity,
+        };
+    };
+    const layers = normal.layers.map((layer) => prepare(layer, 0));
+    const background = normal.background.kind === 'none' ? null : new PreparedPaint(normal.background);
+    const scratch = [];
+    for (let level = 0; level <= depth + 1; level += 1) {
+        scratch.push({
+            row: new Float64Array(width * 4),
+            cover: new Float64Array(width),
+            clip: new Float64Array(width),
+        });
+    }
+    const full = new Float64Array(width).fill(1);
+    const matte = new Float64Array(4);
+    if (options.background !== undefined) {
+        const { r, g, b, a } = options.background;
+        matte[0] = (r / 255) * a;
+        matte[1] = (g / 255) * a;
+        matte[2] = (b / 255) * a;
+        matte[3] = a;
+    }
+    const data = new Uint8ClampedArray(width * height * 4);
+    const texel = new Float64Array(4);
+    const drawImage = (item, level, y, dst) => {
+        const own = scratch[level];
+        if (!item.box.coverage(y, own.cover))
+            return;
+        let start = item.box.start;
+        let end = item.box.end;
+        if (item.clip !== null) {
+            if (!item.clip.coverage(y, own.clip))
+                return;
+            start = Math.max(start, item.clip.start);
+            end = Math.min(end, item.clip.end);
+        }
+        const { node } = item;
+        const { image } = node;
+        const pixels = image.data;
+        const iw = image.width;
+        const ih = image.height;
+        const v = texelCoordinate((((y + 0.5) * unitsY - node.y) / node.height) * ih - 0.5, ih);
+        const row0 = Math.min(Math.max(Math.floor(v), 0), ih - 1);
+        const row1 = Math.min(Math.max(Math.floor(v) + 1, 0), ih - 1);
+        const fy = Math.min(Math.max(v - Math.floor(v), 0), 1);
+        for (let x = start; x < end; x += 1) {
+            let c = own.cover[x];
+            if (item.clip !== null)
+                c *= own.clip[x];
+            if (c === 0)
+                continue;
+            const u = texelCoordinate((((x + 0.5) * unitsX - node.x) / node.width) * iw - 0.5, iw);
+            const col0 = Math.min(Math.max(Math.floor(u), 0), iw - 1);
+            const col1 = Math.min(Math.max(Math.floor(u) + 1, 0), iw - 1);
+            const fx = Math.min(Math.max(u - Math.floor(u), 0), 1);
+            texel.fill(0);
+            sampleInto(texel, pixels, (row0 * iw + col0) * 4, (1 - fx) * (1 - fy));
+            sampleInto(texel, pixels, (row0 * iw + col1) * 4, fx * (1 - fy));
+            sampleInto(texel, pixels, (row1 * iw + col0) * 4, (1 - fx) * fy);
+            sampleInto(texel, pixels, (row1 * iw + col1) * 4, fx * fy);
+            over(dst, x * 4, texel[0] * c, texel[1] * c, texel[2] * c, texel[3] * c);
+        }
+    };
+    const draw = (item, level, y, dst) => {
+        const own = scratch[level];
+        if (item.kind === 'path') {
+            if (!item.edges.coverage(y, own.cover))
+                return;
+            item.paint.composite(dst, own.cover, item.edges.start, item.edges.end, (y + 0.5) * unitsY, unitsX);
+            return;
+        }
+        if (item.kind === 'image') {
+            drawImage(item, level, y, dst);
+            return;
+        }
+        if (item.clip === null && item.opacity === 1) {
+            // Nothing to isolate: drawing the children straight onto the parent
+            // is the same picture, source over being associative.
+            for (const child of item.children)
+                draw(child, level + 1, y, dst);
+            return;
+        }
+        let start = 0;
+        let end = width;
+        if (item.clip !== null) {
+            if (!item.clip.coverage(y, own.clip))
+                return;
+            start = item.clip.start;
+            end = item.clip.end;
+        }
+        const inner = scratch[level + 1].row;
+        inner.fill(0);
+        for (const child of item.children)
+            draw(child, level + 1, y, inner);
+        for (let x = start; x < end; x += 1) {
+            const k = item.opacity * (item.clip === null ? 1 : own.clip[x]);
+            if (k === 0)
+                continue;
+            const i = x * 4;
+            over(dst, i, inner[i] * k, inner[i + 1] * k, inner[i + 2] * k, inner[i + 3] * k);
+        }
+    };
+    const main = new Float64Array(width * 4);
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1)
+            main.set(matte, x * 4);
+        if (background !== null)
+            background.composite(main, full, 0, width, (y + 0.5) * unitsY, unitsX);
+        for (const layer of layers)
+            draw(layer, 0, y, main);
+        writeRow(main, data, y * width * 4, width);
+    }
+    return { width, height, data };
+}
+/**
+ * A texel coordinate held to the image and its border.
+ *
+ * An image box a hair wide or a long way out can overflow the mapping to an
+ * infinity or a NaN, and a NaN in the row would poison every layer drawn over
+ * that pixel afterwards (NaN times zero is NaN). Beyond the edge texels the
+ * sampling clamps anyway, so nothing that could be seen changes.
+ */
+function texelCoordinate(value, size) {
+    if (!(value >= -1))
+        return -1;
+    return value > size ? size : value;
+}
+/** Add a straight texel, premultiplied and weighted, to a running sample. */
+function sampleInto(out, pixels, at, weight) {
+    if (weight === 0)
+        return;
+    const a = (pixels[at + 3] / 255) * weight;
+    out[0] = out[0] + (pixels[at] / 255) * a;
+    out[1] = out[1] + (pixels[at + 1] / 255) * a;
+    out[2] = out[2] + (pixels[at + 2] / 255) * a;
+    out[3] = out[3] + a;
+}
+function toByte(value) {
+    const scaled = value * 255 + 0.5;
+    if (!(scaled > 0))
+        return 0;
+    return scaled >= 255 ? 255 : Math.floor(scaled);
+}
+/**
+ * The one place a colour becomes bytes: unpremultiply and round half up.
+ *
+ * A pixel whose alpha rounds to zero is written as all zeros, so a picture has
+ * one spelling of "nothing here" whatever was faintly drawn there.
+ */
+function writeRow(row, out, offset, width) {
+    for (let x = 0; x < width; x += 1) {
+        const i = x * 4;
+        const a = row[i + 3];
+        const alpha = toByte(a);
+        if (alpha === 0)
+            continue;
+        const o = offset + i;
+        out[o] = toByte(row[i] / a);
+        out[o + 1] = toByte(row[i + 1] / a);
+        out[o + 2] = toByte(row[i + 2] / a);
+        out[o + 3] = alpha;
+    }
+}
+//# sourceMappingURL=raster.js.map

package/dist/render/raster.js.map

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

package/dist/render/scene.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Checking a scene, and reducing it to the cases the writers handle.
+ *
+ * Both writers start here, so the decisions about edge cases are made once
+ * and the SVG and the raster cannot disagree about them: a gradient with one
+ * stop is that stop's colour, a linear gradient whose ends coincide or a radial
+ * one with no radius is its last stop's colour (as SVG specifies), a gradient
+ * with no stops paints nothing, and a group at zero opacity, an image with no
+ * area or anything clipped by an empty clip is left out entirely.
+ *
+ * Every number must be finite, and a value of the wrong shape throws a
+ * TypeError naming where it was found (a layer index, a field). Values are
+ * never repeated in a message.
+ */
+import type { Path } from '../geometry/path.js';
+import type { Colour, RgbaImage, Scene, ScenePaint } from './types.js';
+/** Groups nest at most this deep. Far past any design, and it stops a cycle. */
+export declare const MAX_DEPTH = 32;
+export interface NormalStop {
+    readonly offset: number;
+    readonly colour: Colour;
+}
+export type NormalPaint = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'solid';
+    readonly colour: Colour;
+} | {
+    readonly kind: 'linear';
+    readonly x1: number;
+    readonly y1: number;
+    readonly x2: number;
+    readonly y2: number;
+    readonly stops: readonly NormalStop[];
+} | {
+    readonly kind: 'radial';
+    readonly cx: number;
+    readonly cy: number;
+    readonly r: number;
+    readonly stops: readonly NormalStop[];
+} | {
+    readonly kind: 'conic';
+    readonly cx: number;
+    readonly cy: number;
+    readonly angle: number;
+    readonly stops: readonly NormalStop[];
+};
+/** A paint that puts something on the page. */
+export type DrawnPaint = Exclude<NormalPaint, {
+    readonly kind: 'none';
+}>;
+export type NormalNode = {
+    readonly kind: 'path';
+    readonly path: Path;
+    readonly paint: DrawnPaint;
+} | {
+    readonly kind: 'image';
+    readonly image: RgbaImage;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly clip: Path | null;
+} | {
+    readonly kind: 'group';
+    readonly children: readonly NormalNode[];
+    readonly clip: Path | null;
+    readonly opacity: number;
+};
+export interface NormalScene {
+    readonly width: number;
+    readonly height: number;
+    readonly unitsPerMm: number | null;
+    readonly background: NormalPaint;
+    readonly layers: readonly NormalNode[];
+    readonly title: string | null;
+}
+/** Check a paint and reduce its degenerate forms. */
+export declare function normalisePaint(paint: ScenePaint, where: string): NormalPaint;
+/** Throw a TypeError unless `image` is an RGBA image this package can read. */
+export declare function checkImage(image: RgbaImage, where: string): void;
+/** Check a scene and reduce it. Throws a TypeError for anything malformed. */
+export declare function normaliseScene(scene: Scene, where: string): NormalScene;
+//# sourceMappingURL=scene.d.ts.map

package/dist/render/scene.d.ts.map

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

package/dist/render/scene.js

@@ -0,0 +1,216 @@
+/**
+ * Checking a scene, and reducing it to the cases the writers handle.
+ *
+ * Both writers start here, so the decisions about edge cases are made once
+ * and the SVG and the raster cannot disagree about them: a gradient with one
+ * stop is that stop's colour, a linear gradient whose ends coincide or a radial
+ * one with no radius is its last stop's colour (as SVG specifies), a gradient
+ * with no stops paints nothing, and a group at zero opacity, an image with no
+ * area or anything clipped by an empty clip is left out entirely.
+ *
+ * Every number must be finite, and a value of the wrong shape throws a
+ * TypeError naming where it was found (a layer index, a field). Values are
+ * never repeated in a message.
+ */
+import { checkPath, walkPath } from '../geometry/path.js';
+import { checkColour } from './colour.js';
+/** Groups nest at most this deep. Far past any design, and it stops a cycle. */
+export const MAX_DEPTH = 32;
+function finite(value, where, name) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError(`${where}: ${name} is not a finite number.`);
+    }
+    return value;
+}
+function solid(colour) {
+    return colour.a === 0 ? { kind: 'none' } : { kind: 'solid', colour };
+}
+function normaliseStops(stops, where) {
+    if (!Array.isArray(stops))
+        throw new TypeError(`${where}: stops is a list.`);
+    const out = [];
+    let floor = 0;
+    for (let i = 0; i < stops.length; i += 1) {
+        const stop = stops[i];
+        if (typeof stop !== 'object' || stop === null) {
+            throw new TypeError(`${where}: stop ${i} is not a stop.`);
+        }
+        const offset = finite(stop.offset, where, `stop ${i} offset`);
+        checkColour(stop.colour, `${where}: stop ${i}`);
+        // SVG clamps each offset to 0..1 and then to at least the one before.
+        floor = Math.max(floor, Math.min(Math.max(offset, 0), 1));
+        out.push({ offset: floor, colour: stop.colour });
+    }
+    return out;
+}
+/** Check a paint and reduce its degenerate forms. */
+export function normalisePaint(paint, where) {
+    if (typeof paint !== 'object' || paint === null) {
+        throw new TypeError(`${where}: a paint is an object with a kind.`);
+    }
+    if (paint.kind === 'solid') {
+        checkColour(paint.colour, where);
+        return solid(paint.colour);
+    }
+    if (paint.kind !== 'linear' && paint.kind !== 'radial' && paint.kind !== 'conic') {
+        throw new TypeError(`${where}: the paint kind is not solid, linear, radial or conic.`);
+    }
+    const stops = normaliseStops(paint.stops, where);
+    const last = stops[stops.length - 1];
+    if (paint.kind === 'linear') {
+        const x1 = finite(paint.x1, where, 'x1');
+        const y1 = finite(paint.y1, where, 'y1');
+        const x2 = finite(paint.x2, where, 'x2');
+        const y2 = finite(paint.y2, where, 'y2');
+        if (last === undefined)
+            return { kind: 'none' };
+        if (stops.length === 1 || (x1 === x2 && y1 === y2))
+            return solid(last.colour);
+        return { kind: 'linear', x1, y1, x2, y2, stops };
+    }
+    if (paint.kind === 'radial') {
+        const cx = finite(paint.cx, where, 'cx');
+        const cy = finite(paint.cy, where, 'cy');
+        const r = finite(paint.r, where, 'r');
+        if (r < 0)
+            throw new TypeError(`${where}: a radial gradient's r cannot be negative.`);
+        if (last === undefined)
+            return { kind: 'none' };
+        if (stops.length === 1 || r === 0)
+            return solid(last.colour);
+        return { kind: 'radial', cx, cy, r, stops };
+    }
+    const cx = finite(paint.cx, where, 'cx');
+    const cy = finite(paint.cy, where, 'cy');
+    const angle = finite(paint.angle, where, 'angle');
+    if (last === undefined)
+        return { kind: 'none' };
+    if (stops.length === 1)
+        return solid(last.colour);
+    return { kind: 'conic', cx, cy, angle, stops };
+}
+/** True when walking the path would draw at least one segment. */
+function draws(path) {
+    let any = false;
+    walkPath(path, {
+        move() { },
+        line() {
+            any = true;
+        },
+        quad() {
+            any = true;
+        },
+        cubic() {
+            any = true;
+        },
+        close() { },
+    }, 'draws');
+    return any;
+}
+/** Throw a TypeError unless `image` is an RGBA image this package can read. */
+export function checkImage(image, where) {
+    if (typeof image !== 'object' || image === null) {
+        throw new TypeError(`${where}: image is an object with width, height and data.`);
+    }
+    const { width, height } = image;
+    const data = image.data;
+    if (!Number.isInteger(width) || width < 1 || !Number.isInteger(height) || height < 1) {
+        throw new TypeError(`${where}: the image's width and height are whole numbers, 1 or more.`);
+    }
+    if (!(data instanceof Uint8ClampedArray) && !(data instanceof Uint8Array)) {
+        throw new TypeError(`${where}: the image's data is a Uint8ClampedArray.`);
+    }
+    if (data.length !== width * height * 4) {
+        throw new TypeError(`${where}: the image's data is not four bytes a pixel.`);
+    }
+}
+/** A clip path, or null for none. Returns undefined when the clip removes everything. */
+function normaliseClip(clip, where) {
+    if (clip === undefined)
+        return null;
+    checkPath(clip, `${where}: clip`);
+    return draws(clip) ? clip : undefined;
+}
+function normaliseNode(node, where, depth) {
+    if (typeof node !== 'object' || node === null) {
+        throw new TypeError(`${where}: a node is an object with a kind.`);
+    }
+    if (node.kind === 'path') {
+        checkPath(node.path, where);
+        const paint = normalisePaint(node.paint, `${where}: paint`);
+        if (paint.kind === 'none' || !draws(node.path))
+            return null;
+        return { kind: 'path', path: node.path, paint };
+    }
+    if (node.kind === 'image') {
+        checkImage(node.image, where);
+        const x = finite(node.x, where, 'x');
+        const y = finite(node.y, where, 'y');
+        const width = finite(node.width, where, 'width');
+        const height = finite(node.height, where, 'height');
+        if (width < 0 || height < 0) {
+            throw new TypeError(`${where}: an image's width and height cannot be negative.`);
+        }
+        const clip = normaliseClip(node.clip, where);
+        if (clip === undefined || width === 0 || height === 0)
+            return null;
+        return { kind: 'image', image: node.image, x, y, width, height, clip };
+    }
+    if (node.kind === 'group') {
+        if (depth >= MAX_DEPTH) {
+            throw new TypeError(`${where}: groups nest more than ${MAX_DEPTH} deep.`);
+        }
+        const opacity = node.opacity === undefined
+            ? 1
+            : Math.min(Math.max(finite(node.opacity, where, 'opacity'), 0), 1);
+        const clip = normaliseClip(node.clip, where);
+        const children = normaliseNodes(node.children, where, depth + 1);
+        if (clip === undefined || opacity === 0 || children.length === 0)
+            return null;
+        return { kind: 'group', children, clip, opacity };
+    }
+    throw new TypeError(`${where}: the node kind is not path, image or group.`);
+}
+function normaliseNodes(nodes, where, depth) {
+    if (!Array.isArray(nodes))
+        throw new TypeError(`${where}: children is a list of nodes.`);
+    const out = [];
+    for (let i = 0; i < nodes.length; i += 1) {
+        const normal = normaliseNode(nodes[i], `${where} > ${i}`, depth);
+        if (normal !== null)
+            out.push(normal);
+    }
+    return out;
+}
+/** Check a scene and reduce it. Throws a TypeError for anything malformed. */
+export function normaliseScene(scene, where) {
+    if (typeof scene !== 'object' || scene === null) {
+        throw new TypeError(`${where}: a scene is an object.`);
+    }
+    const width = finite(scene.width, where, 'scene width');
+    const height = finite(scene.height, where, 'scene height');
+    if (width <= 0 || height <= 0) {
+        throw new TypeError(`${where}: the scene's width and height are more than zero.`);
+    }
+    let unitsPerMm = null;
+    if (scene.unitsPerMm !== undefined) {
+        unitsPerMm = finite(scene.unitsPerMm, where, 'unitsPerMm');
+        if (unitsPerMm <= 0)
+            throw new TypeError(`${where}: unitsPerMm is more than zero.`);
+    }
+    if (scene.title !== undefined && typeof scene.title !== 'string') {
+        throw new TypeError(`${where}: title is a string.`);
+    }
+    const background = scene.background === null || scene.background === undefined
+        ? { kind: 'none' }
+        : normalisePaint(scene.background, `${where}: background`);
+    return {
+        width,
+        height,
+        unitsPerMm,
+        background,
+        layers: normaliseNodes(scene.layers, `${where}: layer`, 0),
+        title: scene.title ?? null,
+    };
+}
+//# sourceMappingURL=scene.js.map

package/dist/render/scene.js.map

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

package/dist/render/sheets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Built-in label and card sheet templates.
+ *
+ * Each is named by its paper, count and label size, and its message key is
+ * `sheet.template.<id>`. The manufacturer's product code is given beside each
+ * as a compatibility note, with the page its layout comes from. Label stock
+ * is made in inches in the US and in millimetres elsewhere, and the figures
+ * below are the manufacturer's own in each case: the A4 sheets' pitches are
+ * the inch values their makers publish (66.04 mm is 2.6 inches, 101.6 mm is
+ * 4), which is why their margins are not round millimetres.
+ *
+ * Every template's margins are symmetric, and `tests/render/impose.test.ts`
+ * checks each one closes on its page to a hundredth of a millimetre: left
+ * margin, columns and gaps, right margin, and the same down the page.
+ *
+ * The round and square layouts (`letter-12-round-51`, `letter-12-square-51`
+ * and `a4-12-round-64`) give the label size and count as the manufacturers
+ * list them, but their pitch and margins are a symmetric layout that was not
+ * checked against the published template or a printed sheet while this was
+ * written. Print a test page on plain paper and hold it against the stock
+ * before running a batch on these three.
+ */
+import type { SheetTemplate } from './impose.js';
+/** The built-in templates, A4 first, each in a fresh frozen list. */
+export declare function builtInSheets(): readonly SheetTemplate[];
+//# sourceMappingURL=sheets.d.ts.map

package/dist/render/sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../src/render/sheets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4BjD,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,SAAS,aAAa,EAAE,CA4FxD"}