rtistree 0.5.0

package/dist/components.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+export const componentSchema = z.strictObject({
+    parameters: z.record(z.string(), z.json()).default({}),
+    layers: z.array(z.record(z.string(), z.unknown())).min(1),
+});
+export const componentsSchema = z.record(z.string(), componentSchema);
+export const instanceSchema = z.strictObject({
+    use: z.string(),
+    id: z.string(),
+    params: z.record(z.string(), z.json()).default({}),
+    bounds: z
+        .tuple([z.number(), z.number(), z.number().positive(), z.number().positive()])
+        .optional(),
+    role: z.string().optional(),
+    z: z.number().optional(),
+    transform: z.unknown().optional(),
+});
+function substitute(value, params) {
+    if (typeof value === 'string') {
+        const exact = value.match(/^\{\{([\w-]+)\}\}$/);
+        if (exact) {
+            if (!Object.hasOwn(params, exact[1]))
+                throw new Error(`Missing component parameter: ${exact[1]}`);
+            return params[exact[1]];
+        }
+        return value.replace(/\{\{([\w-]+)\}\}/g, (_, key) => {
+            if (!Object.hasOwn(params, key))
+                throw new Error(`Missing component parameter: ${key}`);
+            const v = params[key];
+            if (typeof v === 'object')
+                throw new Error('Only scalar parameters can be interpolated');
+            return String(v);
+        });
+    }
+    if (Array.isArray(value))
+        return value.map((v) => substitute(v, params));
+    if (value && typeof value === 'object')
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, substitute(v, params)]));
+    return value;
+}
+function namespace(layers, prefix) {
+    const ids = new Map();
+    const collect = (list) => {
+        for (const l of list) {
+            if (typeof l.id === 'string')
+                ids.set(l.id, `${prefix}-${l.id}`);
+            if (Array.isArray(l.children))
+                collect(l.children);
+        }
+    };
+    collect(layers);
+    const walk = (v) => {
+        if (Array.isArray(v))
+            return v.map(walk);
+        if (v && typeof v === 'object')
+            return Object.fromEntries(Object.entries(v).map(([k, x]) => [
+                k,
+                (k === 'id' || k === 'target') && typeof x === 'string' && ids.has(x)
+                    ? ids.get(x)
+                    : walk(x),
+            ]));
+        return v;
+    };
+    return walk(layers);
+}
+export function expandComponents(input, definitions, stack = []) {
+    if (stack.length > 24)
+        throw new Error('Component expansion is too deep');
+    return input.map((raw) => {
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+            throw new Error('Layer must be an object');
+        const layer = raw;
+        if ('use' in layer) {
+            const instance = instanceSchema.parse(layer), component = definitions[instance.use];
+            if (!component)
+                throw new Error(`Unknown component: ${instance.use}`);
+            if (stack.includes(instance.use))
+                throw new Error('Cyclic component use');
+            for (const key of Object.keys(instance.params))
+                if (!Object.hasOwn(component.parameters, key))
+                    throw new Error(`Unknown component parameter: ${key}`);
+            const expanded = expandComponents(substitute(component.layers, { ...component.parameters, ...instance.params }), definitions, [...stack, instance.use]);
+            const { use, params, ...attrs } = instance;
+            return {
+                ...attrs,
+                type: 'group',
+                children: namespace(expanded, instance.id),
+            };
+        }
+        return {
+            ...layer,
+            ...(Array.isArray(layer.children)
+                ? { children: expandComponents(layer.children, definitions, stack) }
+                : {}),
+        };
+    });
+}
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

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

package/dist/construction.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export declare const constructionSchema: z.ZodObject<{
+    points: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+        anchor: z.ZodString;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>]>>;
+    paths: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        op: z.ZodLiteral<"M">;
+        to: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"L">;
+        to: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"Q">;
+        control: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+        to: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"C">;
+        control1: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+        control2: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+        to: z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodString, z.ZodObject<{
+            anchor: z.ZodString;
+            offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"Z">;
+    }, z.core.$strict>], "op">>>>;
+}, z.core.$strict>;
+/** Resolve a named 2D construction graph. Moving an anchor updates every dependent guide. */
+export declare function resolveConstruction(raw: unknown): {
+    points: Record<string, [number, number]>;
+    paths: {
+        [k: string]: string;
+    };
+};

package/dist/construction.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+const pair = z.tuple([
+    z.number().finite().min(-1e6).max(1e6),
+    z.number().finite().min(-1e6).max(1e6),
+]);
+const id = z.string().regex(/^[A-Za-z][A-Za-z0-9_-]{0,79}$/);
+const point = z.union([pair, id, z.strictObject({ anchor: id, offset: pair })]);
+export const constructionSchema = z.strictObject({
+    points: z.record(id, point),
+    paths: z
+        .record(id, z
+        .array(z.discriminatedUnion('op', [
+        z.strictObject({ op: z.literal('M'), to: point }),
+        z.strictObject({ op: z.literal('L'), to: point }),
+        z.strictObject({ op: z.literal('Q'), control: point, to: point }),
+        z.strictObject({ op: z.literal('C'), control1: point, control2: point, to: point }),
+        z.strictObject({ op: z.literal('Z') }),
+    ]))
+        .min(1)
+        .max(4096))
+        .default({}),
+});
+/** Resolve a named 2D construction graph. Moving an anchor updates every dependent guide. */
+export function resolveConstruction(raw) {
+    const spec = constructionSchema.parse(raw), points = Object.create(null), visiting = new Set();
+    if (Object.keys(spec.points).length > 4096 || Object.keys(spec.paths).length > 256)
+        throw new Error('Construction exceeds 4096 points / 256 paths');
+    const resolve = (ref) => {
+        if (Array.isArray(ref))
+            return [...ref];
+        if (typeof ref === 'object') {
+            const a = named(ref.anchor);
+            const value = [a[0] + ref.offset[0], a[1] + ref.offset[1]];
+            if (value.some((v) => !Number.isFinite(v) || Math.abs(v) > 1e6))
+                throw new Error('Resolved construction coordinate exceeds range');
+            return value;
+        }
+        return named(ref);
+    };
+    const named = (name) => {
+        if (Object.hasOwn(points, name))
+            return points[name];
+        if (visiting.has(name))
+            throw new Error(`Construction cycle at ${name}`);
+        if (!Object.hasOwn(spec.points, name))
+            throw new Error(`Unknown construction point ${name}`);
+        visiting.add(name);
+        const p = resolve(spec.points[name]);
+        visiting.delete(name);
+        if (p.some((v) => !Number.isFinite(v) || Math.abs(v) > 1e6))
+            throw new Error('Resolved construction coordinate exceeds range');
+        return (points[name] = p);
+    };
+    Object.keys(spec.points).forEach(named);
+    const xy = (ref) => resolve(ref).join(' ');
+    const paths = Object.fromEntries(Object.entries(spec.paths).map(([id, segments]) => {
+        if (segments[0].op !== 'M')
+            throw new Error('Construction paths must start with M');
+        return [
+            id,
+            segments
+                .map((s) => {
+                switch (s.op) {
+                    case 'M':
+                    case 'L':
+                        return `${s.op}${xy(s.to)}`;
+                    case 'Q':
+                        return `Q${xy(s.control)} ${xy(s.to)}`;
+                    case 'C':
+                        return `C${xy(s.control1)} ${xy(s.control2)} ${xy(s.to)}`;
+                    case 'Z':
+                        return 'Z';
+                }
+            })
+                .join(' '),
+        ];
+    }));
+    return { points, paths };
+}
+//# sourceMappingURL=construction.js.map

package/dist/construction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"construction.js","sourceRoot":"","sources":["../src/construction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;IACnB,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACtC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACvC,CAAC,CAAC;AACH,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAC7D,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC;IAC3B,KAAK,EAAE,CAAC;SACL,MAAM,CACL,EAAE,EACF,CAAC;SACE,KAAK,CACJ,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE;QACzB,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACjE,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACnF,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;KACvC,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC,CACb;SACA,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AACH,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,EACxC,MAAM,GAAqC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAC9D,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG;QAChF,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,CAAC,GAAQ,EAAoB,EAAE;QAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7E,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAoB,EAAE;QAC/C,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAE,CAAC;QACtD,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QAC7F,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,CAAC;QACtC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,CAAC,GAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;QAChD,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACrF,OAAO;YACL,EAAE;YACF,QAAQ;iBACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC;oBACb,KAAK,GAAG,CAAC;oBACT,KAAK,GAAG;wBACN,OAAO,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC9B,KAAK,GAAG;wBACN,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBACzC,KAAK,GAAG;wBACN,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC5D,KAAK,GAAG;wBACN,OAAO,GAAG,CAAC;gBACf,CAAC;YACH,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,CAAC;SACb,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/critique.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { type Scene } from './schema.js';
+import type { RenderResult } from './render.js';
+import type { VerificationReport } from './verify.js';
+export declare const critiqueSchema: z.ZodObject<{
+    scene_hash: z.ZodString;
+    png_hash: z.ZodString;
+    reviewer: z.ZodString;
+    method: z.ZodEnum<{
+        human: "human";
+        "vision-agent": "vision-agent";
+    }>;
+    summary: z.ZodString;
+    score: z.ZodNumber;
+    issues: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodEnum<{
+            coherence: "coherence";
+            composition: "composition";
+            lighting: "lighting";
+            semantic: "semantic";
+            texture: "texture";
+            typography: "typography";
+        }>;
+        severity: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>;
+        target: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type VisualCritique = z.infer<typeof critiqueSchema>;
+export type VisualCritic = (input: {
+    scene: Scene;
+    render: RenderResult;
+    verification: VerificationReport;
+    intent?: string;
+    signal?: AbortSignal;
+}) => Promise<VisualCritique>;
+export declare function validateCritique(raw: unknown, scene: Scene, render: RenderResult): VisualCritique;

package/dist/critique.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { boundsSchema, flattenLayers } from './schema.js';
+export const critiqueSchema = z.strictObject({
+    scene_hash: z.string().regex(/^sha256:[a-f0-9]{64}$/),
+    png_hash: z.string().regex(/^sha256:[a-f0-9]{64}$/),
+    reviewer: z.string().min(1).max(200),
+    method: z.enum(['vision-agent', 'human']),
+    summary: z.string().min(1).max(4000),
+    score: z.number().min(0).max(1),
+    issues: z
+        .array(z.strictObject({
+        id: z.string(),
+        category: z.enum([
+            'composition',
+            'typography',
+            'lighting',
+            'texture',
+            'semantic',
+            'coherence',
+        ]),
+        severity: z.enum(['high', 'medium', 'low']),
+        target: z.string().optional(),
+        region: boundsSchema.optional(),
+        message: z.string().min(1),
+        suggestion: z.string().optional(),
+    }))
+        .max(100),
+});
+export function validateCritique(raw, scene, render) {
+    const critique = critiqueSchema.parse(raw);
+    if (critique.scene_hash !== render.evidence.scene.hash ||
+        critique.png_hash !== render.evidence.render.png_hash)
+        throw new Error('Critique is stale: scene and PNG hashes must match the current render');
+    for (const issue of critique.issues) {
+        if (issue.target && !flattenLayers(scene.layers).some((l) => l.id === issue.target))
+            throw new Error('Unknown critique target');
+        if (issue.region) {
+            const [x, y, w, h] = issue.region;
+            if (x < 0 || y < 0 || x + w > scene.canvas.width || y + h > scene.canvas.height)
+                throw new Error('Critique issue lies outside the image');
+        }
+    }
+    return critique;
+}
+//# sourceMappingURL=critique.js.map

package/dist/critique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.js","sourceRoot":"","sources":["../src/critique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,aAAa,CAAC;AAGtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,YAAY,CAAC;QACb,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;YACf,aAAa;YACb,YAAY;YACZ,UAAU;YACV,SAAS;YACT,UAAU;YACV,WAAW;SACZ,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC,CACH;SACA,GAAG,CAAC,GAAG,CAAC;CACZ,CAAC,CAAC;AASH,MAAM,UAAU,gBAAgB,CAAC,GAAY,EAAE,KAAY,EAAE,MAAoB;IAC/E,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,IACE,QAAQ,CAAC,UAAU,KAAK,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI;QAClD,QAAQ,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ;QAErD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM;gBAC7E,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/detail.d.ts

@@ -0,0 +1,5 @@
+import { type Canvas, type Image } from './native.js';
+import { type ResolvedLayer, type Matrix } from './layout.js';
+import type { RasterRegion } from './schema.js';
+/** Supersample only promoted patches. The semantic surface stays the source. */
+export declare function renderDetail(surface: Canvas, region: RasterRegion, node: ResolvedLayer, lookup: (id: string) => Canvas, images: Map<string, Image>, canvasTransform?: Matrix): void;

package/dist/detail.js

@@ -0,0 +1,52 @@
+import { createCanvas } from './native.js';
+import { multiply } from './layout.js';
+import { coordinateMatrix, inverse, worldScope } from './spatial.js';
+import { applyRasterOperation, pixelBounds } from './paint.js';
+/** Supersample only promoted patches. The semantic surface stays the source. */
+export function renderDetail(surface, region, node, lookup, images, canvasTransform) {
+    if (!region.operations.length && !region.source)
+        return;
+    const [x, y, w, h] = region.bounds, scale = region.scale;
+    const matrix = multiply(region.space === 'layer'
+        ? coordinateMatrix(region, node)
+        : (canvasTransform ?? coordinateMatrix(region, node)), [1, 0, 0, 1, x, y]);
+    const rw = Math.ceil(w * scale), rh = Math.ceil(h * scale);
+    if (rw * rh > 16 * 1024 * 1024)
+        throw new Error('Promoted region exceeds 16 megapixels');
+    const patch = createCanvas(rw, rh), ctx = patch.getContext('2d');
+    const toPatch = multiply([scale, 0, 0, scale, 0, 0], inverse(matrix));
+    ctx.setTransform(...toPatch);
+    ctx.drawImage(surface, 0, 0);
+    ctx.resetTransform();
+    if (region.source) {
+        if (region.composite !== 'over')
+            ctx.clearRect(0, 0, rw, rh);
+        ctx.drawImage(images.get(region.source), 0, 0, rw, rh);
+    }
+    const localLookup = (id) => {
+        const c = createCanvas(rw, rh), cc = c.getContext('2d');
+        cc.setTransform(...toPatch);
+        cc.drawImage(lookup(id), 0, 0);
+        return c;
+    };
+    for (const op of region.operations)
+        applyRasterOperation(patch, {
+            ...op,
+            space: 'layer',
+            ...(op.mask
+                ? { mask: { ...op.mask, space: op.mask.type === 'semantic-object' ? 'canvas' : 'layer' } }
+                : {}),
+        }, localLookup, [scale, 0, 0, scale, 0, 0], [scale, 0, 0, scale, 0, 0]);
+    const edited = createCanvas(surface.width, surface.height), out = edited.getContext('2d');
+    out.drawImage(surface, 0, 0);
+    out.setTransform(...matrix);
+    out.beginPath();
+    out.rect(0, 0, w, h);
+    out.clip();
+    out.clearRect(0, 0, w, h);
+    out.drawImage(patch, 0, 0, w, h);
+    const bounds = pixelBounds(worldScope([0, 0, w, h], matrix), surface.width, surface.height);
+    if (bounds)
+        surface.getContext('2d').putImageData(out.getImageData(...bounds), bounds[0], bounds[1]);
+}
+//# sourceMappingURL=detail.js.map

package/dist/detail.js.map

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

package/dist/document.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+export declare const documentSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    unit: z.ZodDefault<z.ZodEnum<{
+        in: "in";
+        mm: "mm";
+        pt: "pt";
+    }>>;
+    ppi: z.ZodDefault<z.ZodNumber>;
+    bleed: z.ZodDefault<z.ZodNumber>;
+    safe_margin: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type PhysicalDocument = z.infer<typeof documentSchema>;
+export declare const mmPerUnit: {
+    mm: number;
+    in: number;
+    pt: number;
+};
+export declare function documentGeometry(document: PhysicalDocument): {
+    trim_mm: [number, number];
+    bleed_mm: number;
+    safe_mm: number;
+    full_mm: [number, number];
+    pixels: [number, number];
+    trim_pt: [number, number];
+    bleed_pt: number;
+};
+export declare function lengthMm(value: string): number;
+export declare const exportPresetSchema: z.ZodObject<{
+    format: z.ZodDefault<z.ZodEnum<{
+        jpeg: "jpeg";
+        pdf: "pdf";
+        png: "png";
+        svg: "svg";
+        tiff: "tiff";
+    }>>;
+    colour_space: z.ZodDefault<z.ZodEnum<{
+        cmyk: "cmyk";
+        srgb: "srgb";
+    }>>;
+    profile: z.ZodOptional<z.ZodString>;
+    profile_hash: z.ZodOptional<z.ZodString>;
+    intent: z.ZodDefault<z.ZodLiteral<"perceptual">>;
+    quality: z.ZodDefault<z.ZodNumber>;
+    chroma_subsampling: z.ZodDefault<z.ZodEnum<{
+        "4:2:0": "4:2:0";
+        "4:4:4": "4:4:4";
+    }>>;
+    background: z.ZodDefault<z.ZodString>;
+    crop_marks: z.ZodDefault<z.ZodBoolean>;
+    minimum_ppi: z.ZodDefault<z.ZodNumber>;
+    max_ink: z.ZodDefault<z.ZodNumber>;
+    black: z.ZodDefault<z.ZodEnum<{
+        "k-only": "k-only";
+        profile: "profile";
+    }>>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        hybrid: "hybrid";
+        raster: "raster";
+    }>>;
+    ppi: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type ExportPreset = z.infer<typeof exportPresetSchema>;

package/dist/document.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const documentSchema = z.strictObject({
+    width: z.number().positive().max(2000),
+    height: z.number().positive().max(2000),
+    unit: z.enum(['mm', 'in', 'pt']).default('mm'),
+    ppi: z.number().min(36).max(1200).default(300),
+    bleed: z.number().min(0).max(100).default(0),
+    safe_margin: z.number().min(0).max(100).default(0),
+});
+export const mmPerUnit = { mm: 1, in: 25.4, pt: 25.4 / 72 };
+export function documentGeometry(document) {
+    const d = documentSchema.parse(document), unit = mmPerUnit[d.unit];
+    const trim = [d.width * unit, d.height * unit];
+    const bleed = d.bleed * unit, safe = d.safe_margin * unit;
+    if (safe * 2 >= Math.min(...trim))
+        throw new Error('Safe margin consumes the trim area');
+    const full = trim.map((v) => v + bleed * 2);
+    return {
+        trim_mm: trim,
+        bleed_mm: bleed,
+        safe_mm: safe,
+        full_mm: full,
+        pixels: full.map((v) => Math.round((v * d.ppi) / 25.4)),
+        trim_pt: trim.map((v) => (v * 72) / 25.4),
+        bleed_pt: (bleed * 72) / 25.4,
+    };
+}
+export function lengthMm(value) {
+    const m = /^(\d+(?:\.\d+)?)(mm|in|pt)?$/.exec(value);
+    if (!m)
+        throw new Error('Expected a length such as 3mm, 0.125in or 9pt');
+    return Number(m[1]) * mmPerUnit[(m[2] ?? 'mm')];
+}
+export const exportPresetSchema = z.strictObject({
+    format: z.enum(['png', 'jpeg', 'tiff', 'pdf', 'svg']).default('pdf'),
+    colour_space: z.enum(['srgb', 'cmyk']).default('srgb'),
+    profile: z.string().optional(),
+    profile_hash: z
+        .string()
+        .regex(/^sha256:[a-f0-9]{64}$/)
+        .optional(),
+    intent: z.literal('perceptual').default('perceptual'),
+    quality: z.number().int().min(1).max(100).default(90),
+    chroma_subsampling: z.enum(['4:4:4', '4:2:0']).default('4:4:4'),
+    background: z
+        .string()
+        .regex(/^#[a-fA-F0-9]{6}$/)
+        .default('#ffffff'),
+    crop_marks: z.boolean().default(false),
+    minimum_ppi: z.number().min(1).max(1200).default(150),
+    max_ink: z.number().min(100).max(400).default(300),
+    black: z.enum(['profile', 'k-only']).default('k-only'),
+    mode: z.enum(['hybrid', 'raster']).default('hybrid'),
+    ppi: z.number().min(36).max(1200).optional(),
+});
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

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