rtistree 0.5.0

package/dist/print-scene.d.ts

@@ -0,0 +1,490 @@
+import { type Scene } from './schema.js';
+import type { Matrix } from './layout.js';
+/** Scale geometry through an outer transform; preserve source pixels and edit coordinates. */
+export declare function printScene(input: Scene, ppi?: number): {
+    scene: {
+        version: 1;
+        canvas: {
+            width: number;
+            height: number;
+            colour_space: "srgb";
+            background: string;
+        };
+        document?: {
+            width: number;
+            height: number;
+            unit: "in" | "mm" | "pt";
+            ppi: number;
+            bleed: number;
+            safe_margin: number;
+        } | undefined;
+        paragraph_styles?: Record<string, {
+            font: string;
+            size: number;
+            weight: "bold" | "regular";
+            colour: string;
+            line_height: number;
+            align: "center" | "left" | "right";
+            tracking?: number | undefined;
+            kerning?: boolean | undefined;
+        }> | undefined;
+        fonts?: Record<string, {
+            source: string;
+            hash?: string | undefined;
+        }> | undefined;
+        metadata: Record<string, import("zod").JSONType>;
+        assets: Record<string, {
+            recipe?: {
+                source: string;
+                hash: string;
+            } | undefined;
+            type: "generated-image" | "image";
+            source: string;
+            hash?: string | undefined;
+        }>;
+        layers: {
+            id: string;
+            name?: string | undefined;
+            role?: string | undefined;
+            type: "adjustment" | "asset" | "generated-asset" | "group" | "procedural" | "raster" | "text" | "vector";
+            visible: boolean;
+            opacity: number;
+            blend_mode: "darken" | "difference" | "hard-light" | "lighten" | "multiply" | "normal" | "overlay" | "screen" | "soft-light";
+            z: number;
+            bounds?: [number, number, number, number] | undefined;
+            width?: string | number | undefined;
+            aspect_ratio?: number | undefined;
+            grow?: number | undefined;
+            height?: string | number | undefined;
+            anchor: "bottom-left" | "bottom-right" | "center" | "top-left" | "top-right";
+            affine?: [number, number, number, number, number, number] | undefined;
+            transform?: {
+                rotation: number;
+                scale: [number, number];
+            } | undefined;
+            layout?: {
+                type: "absolute" | "horizontal" | "vertical";
+                justify?: "center" | "end" | "space-between" | "start" | undefined;
+                padding: number;
+                gap: number;
+                align: "center" | "end" | "start";
+            } | undefined;
+            shape?: {
+                line_cap?: "butt" | "round" | "square" | undefined;
+                line_join?: "bevel" | "miter" | "round" | undefined;
+                dash?: number[] | undefined;
+                dash_offset?: number | undefined;
+                type: "rectangle";
+                fill: string;
+                radius: number;
+                stroke?: string | undefined;
+                stroke_width: number;
+            } | {
+                line_cap?: "butt" | "round" | "square" | undefined;
+                line_join?: "bevel" | "miter" | "round" | undefined;
+                dash?: number[] | undefined;
+                dash_offset?: number | undefined;
+                type: "ellipse";
+                fill: string;
+                stroke?: string | undefined;
+                stroke_width: number;
+            } | {
+                line_cap?: "butt" | "round" | "square" | undefined;
+                line_join?: "bevel" | "miter" | "round" | undefined;
+                dash?: number[] | undefined;
+                dash_offset?: number | undefined;
+                type: "path";
+                d: string;
+                fill: string;
+                stroke?: string | undefined;
+                stroke_width: number;
+            } | undefined;
+            content?: string | undefined;
+            runs?: {
+                text: string;
+                colour?: string | undefined;
+                weight?: "bold" | "regular" | undefined;
+            }[] | undefined;
+            paragraph_style?: string | undefined;
+            crop?: [number, number, number, number] | undefined;
+            focal_point?: [number, number] | undefined;
+            perspective?: [[number, number], [number, number], [number, number], [number, number]] | undefined;
+            style?: {
+                font: string;
+                size: number;
+                weight: "bold" | "regular";
+                colour: string;
+                line_height: number;
+                align: "center" | "left" | "right";
+                tracking?: number | undefined;
+                kerning?: boolean | undefined;
+            } | undefined;
+            source?: string | undefined;
+            fit: "contain" | "cover" | "stretch";
+            generator?: {
+                type: "solid";
+                colour: string;
+            } | {
+                type: "gradient";
+                from: string;
+                to: string;
+                angle: number;
+            } | {
+                type: "noise";
+                seed: number;
+                amount: number;
+                colour: string;
+            } | undefined;
+            mask?: import("./schema.js").Mask | undefined;
+            effects: {
+                type: "blur";
+                radius: number;
+            }[];
+            operations: ({
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "levels";
+                black: number;
+                white: number;
+                gamma: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "curves";
+                channel: "b" | "g" | "r" | "rgb";
+                points: [number, number][];
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "whiteBalance";
+                temperature: number;
+                tint: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "clone";
+                source_offset: [number, number];
+                opacity: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "heal";
+                source_offset: [number, number];
+                opacity: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "fill";
+                colour: string;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "paintStroke";
+                path: [number, number][];
+                radius: number;
+                hardness: number;
+                colour: string;
+                opacity: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "eraseStroke";
+                path: [number, number][];
+                radius: number;
+                hardness: number;
+                opacity: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "brightness";
+                amount: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "contrast";
+                amount: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "saturation";
+                amount: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "hueShift";
+                degrees: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "noise";
+                amount: number;
+                seed: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "blur";
+                radius: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "colourReplace";
+                from: string;
+                to: string;
+                tolerance: number;
+            } | {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                mask?: import("./schema.js").Mask | undefined;
+                type: "setPixels";
+                pixels: {
+                    x: number;
+                    y: number;
+                    colour: string;
+                }[];
+            })[];
+            regions?: {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                id: string;
+                bounds: [number, number, number, number];
+                scale: number;
+                source?: string | undefined;
+                composite?: "over" | "replace" | undefined;
+                operations: ({
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "levels";
+                    black: number;
+                    white: number;
+                    gamma: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "curves";
+                    channel: "b" | "g" | "r" | "rgb";
+                    points: [number, number][];
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "whiteBalance";
+                    temperature: number;
+                    tint: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "clone";
+                    source_offset: [number, number];
+                    opacity: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "heal";
+                    source_offset: [number, number];
+                    opacity: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "fill";
+                    colour: string;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "paintStroke";
+                    path: [number, number][];
+                    radius: number;
+                    hardness: number;
+                    colour: string;
+                    opacity: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "eraseStroke";
+                    path: [number, number][];
+                    radius: number;
+                    hardness: number;
+                    opacity: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "brightness";
+                    amount: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "contrast";
+                    amount: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "saturation";
+                    amount: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "hueShift";
+                    degrees: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "noise";
+                    amount: number;
+                    seed: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "blur";
+                    radius: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "colourReplace";
+                    from: string;
+                    to: string;
+                    tolerance: number;
+                } | {
+                    space?: "canvas" | "layer" | undefined;
+                    reference_size?: [number, number] | undefined;
+                    bounds: [number, number, number, number];
+                    mask?: import("./schema.js").Mask | undefined;
+                    type: "setPixels";
+                    pixels: {
+                        x: number;
+                        y: number;
+                        colour: string;
+                    }[];
+                })[];
+            }[] | undefined;
+            tiles: {
+                space?: "canvas" | "layer" | undefined;
+                reference_size?: [number, number] | undefined;
+                bounds: [number, number, number, number];
+                palette: Record<string, string>;
+                pixels: string[];
+            }[];
+            children: /*elided*/ any[];
+        }[];
+        verification: {
+            rules: ({
+                type: "pixel-contrast";
+                target: string;
+                minimum: number;
+                percentile: number;
+            } | {
+                type: "visible-area";
+                target: string;
+                minimum: number;
+            } | {
+                type: "region-luma";
+                bounds: [number, number, number, number];
+                minimum: number;
+                maximum: number;
+            } | {
+                type: "safe-area";
+                target: string;
+                minimum: number;
+            } | {
+                type: "text-overflow";
+                target: string;
+            } | {
+                type: "text-equals";
+                target: string;
+                expected: string;
+            } | {
+                type: "required-role";
+                role: string;
+            } | {
+                type: "contrast";
+                target: string;
+                against: string;
+                minimum: number;
+            } | {
+                type: "no-overlap";
+                target: string;
+                other: string;
+            })[];
+        };
+    };
+    geometry: {
+        trim_mm: [number, number];
+        bleed_mm: number;
+        safe_mm: number;
+        full_mm: [number, number];
+        pixels: [number, number];
+        trim_pt: [number, number];
+        bleed_pt: number;
+    };
+    scale: number;
+    bleed: number;
+    document: {
+        width: number;
+        height: number;
+        unit: "in" | "mm" | "pt";
+        bleed: number;
+        safe_margin: number;
+        ppi: number;
+    };
+    options: {
+        canvasTransform: Matrix;
+    };
+};

package/dist/print-scene.js

@@ -0,0 +1,55 @@
+import { parseScene, flattenLayers, layerMasks } from './schema.js';
+import { documentGeometry } from './document.js';
+/** Scale geometry through an outer transform; preserve source pixels and edit coordinates. */
+export function printScene(input, ppi) {
+    if (!input.document)
+        throw new Error('A physical document is required for print export');
+    const document = { ...input.document, ppi: ppi ?? input.document.ppi }, geometry = documentGeometry(document);
+    if (Math.abs(input.canvas.width / input.canvas.height - geometry.trim_mm[0] / geometry.trim_mm[1]) >
+        0.002)
+        throw new Error('Canvas and physical trim aspect ratios disagree');
+    const scale = (geometry.trim_mm[0] * document.ppi) / 25.4 / input.canvas.width, bleed = (geometry.bleed_mm * document.ppi) / 25.4;
+    const source = structuredClone(input), ids = new Set(flattenLayers(source.layers).map((l) => l.id));
+    let wrapper = 'printFrame';
+    while (ids.has(wrapper))
+        wrapper += 'x';
+    for (const l of flattenLayers(source.layers)) {
+        for (const effect of l.effects)
+            effect.radius *= scale;
+        for (const mask of layerMasks(l)) {
+            mask.feather *= scale;
+            if (mask.expand)
+                mask.expand *= scale;
+        }
+        for (const op of l.operations)
+            if (op.type === 'blur')
+                op.radius *= scale;
+    }
+    const canvasTransform = [scale, 0, 0, scale, bleed, bleed];
+    const scene = parseScene({
+        ...source,
+        canvas: { ...source.canvas, width: geometry.pixels[0], height: geometry.pixels[1] },
+        layers: [
+            {
+                id: wrapper,
+                type: 'group',
+                bounds: [0, 0, input.canvas.width, input.canvas.height],
+                affine: canvasTransform,
+                children: source.layers,
+            },
+        ],
+        verification: { rules: [] },
+    });
+    // Unbounded procedural backgrounds actually paint into the bleed, without changing their trim geometry.
+    for (const layer of scene.layers[0].children)
+        if (layer.type === 'procedural' && !layer.bounds && !layer.width && !layer.height) {
+            layer.bounds = [
+                -bleed / scale,
+                -bleed / scale,
+                geometry.pixels[0] / scale,
+                geometry.pixels[1] / scale,
+            ];
+        }
+    return { scene, geometry, scale, bleed, document, options: { canvasTransform } };
+}
+//# sourceMappingURL=print-scene.js.map

package/dist/print-scene.js.map

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