rtistree 0.5.0

package/dist/project.js

@@ -0,0 +1,347 @@
+import { stringify } from 'yaml';
+import { resolveProject, projectPath } from './project-config.js';
+import { readJournal, compressJournal } from './history-storage.js';
+import { mergeSource } from './merge.js';
+import { validateCritique } from './critique.js';
+import { writeArtifact } from './artifacts.js';
+import { mkdir, open, readFile, unlink } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { canonical, localAssetPath, sceneHash, sha256 } from './assets.js';
+import { writeSceneBundle } from './artifacts.js';
+import { applyCommand, commandScopes, patchSchema } from './commands.js';
+import { flattenResolved, intersects, resolveLayout } from './layout.js';
+import { loadScene } from './loader.js';
+import { defaultRenderer } from './render.js';
+import { boundsSchema, parseScene } from './schema.js';
+import { measureLocality, verifyRendered } from './verify.js';
+function missing(error) {
+    return error.code === 'ENOENT';
+}
+export class Project {
+    source;
+    renderer;
+    config;
+    constructor(source, renderer = defaultRenderer, config) {
+        this.source = source;
+        this.renderer = renderer;
+        this.config = config;
+    }
+    static async open(file, renderer = defaultRenderer) {
+        const resolved = await resolveProject(file);
+        return new Project(await loadScene(resolved.file), renderer, resolved.config);
+    }
+    get root() {
+        return this.source.root;
+    }
+    get outputDirectory() {
+        return this.config
+            ? projectPath(this.root, this.config.output_dir)
+            : join(this.root, 'renders');
+    }
+    get journal() {
+        return join(this.root, 'history', `${basename(this.source.file)}.operations.jsonl`);
+    }
+    async state(allowSourceChange = false) {
+        // Re-read authoring files on every request, including long-lived MCP sessions.
+        const current = await loadScene(this.source.file), sourceHash = sceneHash(current.scene);
+        const raw = await readJournal(this.journal);
+        if (raw && !raw.endsWith('\n'))
+            throw new Error('History has an incomplete final record. Restore the journal from backup before editing.');
+        const initial = raw
+            ? (JSON.parse(raw.split('\n')[0]).baseline ?? current.scene)
+            : current.scene;
+        const state = {
+            sourceHash: sceneHash(initial),
+            baseline: initial,
+            incoming: current.scene,
+            scene: initial,
+            undo: [],
+            redo: [],
+            entries: [],
+        };
+        for (const line of raw.split('\n').filter(Boolean)) {
+            const entry = JSON.parse(line);
+            const { hash, ...payload } = entry;
+            if (sha256(canonical(payload)) !== hash)
+                throw new Error('History integrity check failed');
+            if (entry.kind === 'rebase') {
+                if (!entry.baseline || sceneHash(entry.baseline) !== entry.source_hash)
+                    throw new Error('Invalid rebase baseline');
+                state.baseline = parseScene(entry.baseline);
+                state.sourceHash = entry.source_hash;
+            }
+            else if (entry.source_hash !== state.sourceHash)
+                throw new Error('History source chain is inconsistent');
+            if (entry.sequence !== state.entries.length + 1 ||
+                entry.previous_hash !== (state.entries.at(-1)?.hash ?? null) ||
+                entry.before_hash !== sceneHash(state.scene))
+                throw new Error('History chain is inconsistent');
+            const after = parseScene(entry.after);
+            if (sceneHash(after) !== entry.after_hash)
+                throw new Error('History state hash mismatch');
+            if (entry.kind === 'apply' || entry.kind === 'rebase') {
+                state.undo.push(state.scene);
+                state.redo = [];
+            }
+            else if (entry.kind === 'undo') {
+                const previous = state.undo.pop();
+                if (!previous || sceneHash(previous) !== entry.after_hash)
+                    throw new Error('Invalid undo record');
+                state.redo.push(state.scene);
+            }
+            else if (entry.kind === 'redo') {
+                const next = state.redo.pop();
+                if (!next || sceneHash(next) !== entry.after_hash)
+                    throw new Error('Invalid redo record');
+                state.undo.push(state.scene);
+            }
+            else
+                throw new Error('Unknown history record');
+            state.scene = after;
+            state.entries.push(entry);
+        }
+        if (!allowSourceChange && state.sourceHash !== sourceHash)
+            throw new Error('Authoring files changed after edits were recorded. Run rebase to merge source changes, or restore the original source.');
+        const last = state.entries.at(-1);
+        if (last) {
+            await this.checkAssets(state.scene, last.asset_hashes);
+            for (const [id, font] of Object.entries(state.scene.fonts ?? {})) {
+                if (last.font_hashes &&
+                    sha256(await readFile(await localAssetPath(this.root, font.source))) !==
+                        last.font_hashes[`custom:${id}`])
+                    throw new Error(`Font changed since the recorded edit: ${id}`);
+            }
+        }
+        return state;
+    }
+    async checkAssets(scene, expected) {
+        if (!expected)
+            throw new Error('History record is missing asset provenance');
+        for (const [id, asset] of Object.entries(scene.assets)) {
+            const bytes = await readFile(await localAssetPath(this.root, asset.source));
+            if (sha256(bytes) !== expected[id])
+                throw new Error(`Asset changed since the recorded edit: ${id}. Restore the original asset to reproduce this history.`);
+        }
+    }
+    async scene() {
+        return (await this.state()).scene;
+    }
+    async history() {
+        return (await this.state()).entries;
+    }
+    async render(options = {}) {
+        return this.renderer.render(await this.scene(), this.root, options);
+    }
+    async verify() {
+        const scene = await this.scene();
+        return verifyRendered(scene, this.root, this.renderer);
+    }
+    async recordCritique(raw) {
+        const scene = await this.scene(), render = await this.renderer.render(scene, this.root), critique = validateCritique(raw, scene, render);
+        await writeArtifact(join(this.root, 'verification', `${basename(this.source.file)}.${render.evidence.scene.hash.slice(7)}.critique.json`), JSON.stringify(critique, null, 2) + '\n');
+        return critique;
+    }
+    async critique() {
+        const scene = await this.scene(), render = await this.renderer.render(scene, this.root);
+        try {
+            return validateCritique(JSON.parse(await readFile(join(this.root, 'verification', `${basename(this.source.file)}.${render.evidence.scene.hash.slice(7)}.critique.json`), 'utf8')), scene, render);
+        }
+        catch (e) {
+            if (missing(e))
+                return null;
+            throw e;
+        }
+    }
+    async inspect() {
+        const state = await this.state(), nodes = flattenResolved(resolveLayout(state.scene));
+        return {
+            version: state.scene.version,
+            hash: sceneHash(state.scene),
+            canvas: state.scene.canvas,
+            source_files: (await loadScene(this.source.file)).files,
+            assets: state.scene.assets,
+            history: { entries: state.entries.length, undo: state.undo.length, redo: state.redo.length },
+            layers: nodes.map((n) => ({
+                id: n.layer.id,
+                type: n.layer.type,
+                role: n.layer.role,
+                visible: n.visible,
+                opacity: n.layer.opacity,
+                bounds: n.bounds,
+                world_bounds: n.worldBounds,
+                children: n.children.map((c) => c.layer.id),
+                operations: n.layer.operations.length,
+                tiles: n.layer.tiles.length,
+                regions: n.layer.regions?.map((r) => ({
+                    id: r.id,
+                    bounds: r.bounds,
+                    scale: r.scale,
+                    resolution: [Math.ceil(r.bounds[2] * r.scale), Math.ceil(r.bounds[3] * r.scale)],
+                })),
+            })),
+        };
+    }
+    async inspectLayer(id) {
+        const scene = await this.scene(), node = flattenResolved(resolveLayout(scene)).find((n) => n.layer.id === id);
+        if (!node)
+            throw new Error(`Unknown layer: ${id}`);
+        return { layer: node.layer, bounds: node.bounds, world_bounds: node.worldBounds };
+    }
+    async inspectRegion(raw) {
+        const bounds = boundsSchema.parse(raw), scene = await this.scene(), render = await this.renderer.render(scene, this.root, { region: bounds });
+        const counts = new Map();
+        let total = 0, sum = 0;
+        for (let i = 0; i < render.pixels.length; i += 4) {
+            if (!render.pixels[i + 3])
+                continue;
+            const rgb = [0, 1, 2].map((c) => Math.min(255, Math.round(render.pixels[i + c] / 32) * 32));
+            const key = '#' + rgb.map((c) => c.toString(16).padStart(2, '0')).join('');
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+            sum +=
+                (0.2126 * render.pixels[i] +
+                    0.7152 * render.pixels[i + 1] +
+                    0.0722 * render.pixels[i + 2]) /
+                    255;
+            total++;
+        }
+        return {
+            bounds,
+            layers: flattenResolved(resolveLayout(scene))
+                .filter((n) => intersects(bounds, n.worldBounds))
+                .map((n) => ({ id: n.layer.id, role: n.layer.role, bounds: n.worldBounds })),
+            dominant_colours: [...counts]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 8)
+                .map(([colour, pixels]) => ({ colour, pixels })),
+            mean_luma: total ? sum / total : 0,
+            render,
+        };
+    }
+    async transaction(kind, reason, patch) {
+        await mkdir(join(this.root, 'history'), { recursive: true });
+        const lockPath = `${this.journal}.lock`;
+        let lock;
+        try {
+            lock = await open(lockPath, 'wx');
+        }
+        catch (error) {
+            if (error.code === 'EEXIST')
+                throw new Error(`Project is locked: ${lockPath}. If a writer crashed, remove this lock only after confirming no writer is active.`);
+            throw error;
+        }
+        try {
+            await lock.writeFile(JSON.stringify({ pid: process.pid, created: new Date().toISOString() }));
+            const state = await this.state(kind === 'rebase'), beforeHash = sceneHash(state.scene);
+            if (patch?.expected_hash && patch.expected_hash !== beforeHash)
+                throw new Error('Stale scene hash: inspect again before applying edits');
+            let after = state.scene;
+            const locality = [];
+            if (kind === 'rebase') {
+                after = parseScene(mergeSource(state.baseline, state.scene, state.incoming));
+            }
+            else if (kind === 'apply') {
+                for (const command of patch.commands) {
+                    const next = applyCommand(after, command), scopes = commandScopes(command, after, next);
+                    if (scopes.length) {
+                        const evidence = measureLocality(await this.renderer.render(after, this.root), await this.renderer.render(next, this.root), scopes);
+                        if (evidence.outside_changed_pixels)
+                            throw new Error(`Edit rejected: ${evidence.outside_changed_pixels} pixels changed outside its scope. Target the enclosing group after its effects, or remove the dependent mask.`);
+                        locality.push(evidence);
+                    }
+                    after = next;
+                }
+            }
+            else {
+                const next = kind === 'undo' ? state.undo.at(-1) : state.redo.at(-1);
+                if (!next)
+                    throw new Error(`Nothing to ${kind}`);
+                after = next;
+            }
+            // Validate renderability and pin asset provenance before committing.
+            const rendered = await this.renderer.render(after, this.root);
+            await this.checkAssets(after, rendered.evidence.assets);
+            const sourceNow = await loadScene(this.source.file), sourceHash = sceneHash(sourceNow.scene);
+            if (sourceHash !== (kind === 'rebase' ? sceneHash(state.incoming) : state.sourceHash))
+                throw new Error('Source changed during transaction');
+            const payload = {
+                sequence: state.entries.length + 1,
+                kind,
+                reason,
+                timestamp: new Date().toISOString(),
+                source_hash: sourceHash,
+                before_hash: beforeHash,
+                after_hash: sceneHash(after),
+                previous_hash: state.entries.at(-1)?.hash ?? null,
+                commands: patch?.commands ?? [],
+                asset_hashes: rendered.evidence.assets,
+                font_hashes: rendered.evidence.fonts,
+                ...(kind === 'rebase'
+                    ? { baseline: state.incoming }
+                    : state.entries.length === 0
+                        ? { baseline: state.baseline }
+                        : {}),
+                after,
+                locality,
+            };
+            const entry = { ...payload, hash: sha256(canonical(payload)) };
+            const journal = await open(this.journal, 'a');
+            try {
+                await journal.writeFile(JSON.stringify(entry) + '\n');
+                await journal.sync();
+            }
+            finally {
+                await journal.close();
+            }
+            return entry;
+        }
+        finally {
+            await lock.close();
+            await unlink(lockPath);
+        }
+    }
+    async apply(raw) {
+        const patch = patchSchema.parse(raw);
+        return this.transaction('apply', patch.reason, patch);
+    }
+    async undo(reason = 'Undo the previous edit') {
+        return this.transaction('undo', reason);
+    }
+    async redo(reason = 'Redo the previous edit') {
+        return this.transaction('redo', reason);
+    }
+    async rebase(reason = 'Merge nonconflicting authoring changes') {
+        return this.transaction('rebase', reason);
+    }
+    async compactHistory() {
+        await mkdir(join(this.root, 'history'), { recursive: true });
+        const lockPath = `${this.journal}.lock`, lock = await open(lockPath, 'wx');
+        try {
+            await this.state();
+            return await compressJournal(this.journal);
+        }
+        finally {
+            await lock.close();
+            await unlink(lockPath);
+        }
+    }
+    async exportScene(file) {
+        await writeSceneBundle(await this.scene(), this.root, file);
+        if (this.config) {
+            const config = structuredClone(this.config);
+            config.scene = basename(file);
+            for (const preset of Object.values(config.presets)) {
+                if (!preset.profile)
+                    continue;
+                const bytes = await readFile(await localAssetPath(this.root, preset.profile));
+                const hash = sha256(bytes);
+                if (preset.profile_hash && preset.profile_hash !== hash)
+                    throw new Error('ICC profile hash mismatch');
+                preset.profile = join('profiles', `${hash.slice(7)}.icc`);
+                preset.profile_hash = hash;
+                await writeArtifact(join(dirname(file), preset.profile), bytes);
+            }
+            await writeArtifact(join(dirname(file), 'rtistree.yaml'), stringify(config));
+        }
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAc,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAwD,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,UAAU,EAA2B,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAC;AA4BrF,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC5D,CAAC;AACD,MAAM,OAAO,OAAO;IAEP,MAAM;IACN,QAAQ;IACR,MAAM;IAHjB,YACW,MAAmB,EACnB,QAAQ,GAAa,eAAe,EACpC,MAAsB;sBAFtB,MAAM;wBACN,QAAQ;sBACR,MAAM;IACd,CAAC;IACJ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,QAAQ,GAAa,eAAe;QAClE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,OAAO,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM;YAChB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAChD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtF,CAAC;IACO,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK;QAC3C,+EAA+E;QAC/E,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAC/C,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,MAAM,OAAO,GAAG,GAAG;YACjB,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAkB,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;YAC/E,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAClB,MAAM,KAAK,GAAU;YACnB,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC;YAC9B,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,OAAO,CAAC,KAAK;YACvB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;YAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;YACnC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC3F,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,WAAW;oBACpE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC7C,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC5C,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC;YACvC,CAAC;iBAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,UAAU;gBAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,IACE,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAC3C,KAAK,CAAC,aAAa,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;gBAC5D,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;gBAE5C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC1F,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC7B,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAClC,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,UAAU;oBACvD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAC1F,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;;gBAAM,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACjD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACpB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU;YACvD,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;QACJ,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACvD,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,IACE,IAAI,CAAC,WAAW;oBAChB,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;wBAClE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;oBAElC,MAAM,IAAI,KAAK,CAAC,yCAAyC,EAAE,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACO,KAAK,CAAC,WAAW,CAAC,KAAY,EAAE,QAAgC;QACtE,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC7E,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5E,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,0CAA0C,EAAE,yDAAyD,CACtG,CAAC;QACN,CAAC;IACH,CAAC;IACD,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IACtC,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,GAAkB,EAAE;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,CAAC,MAAM;QACV,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,GAAY;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC9B,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EACrD,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,aAAa,CACjB,IAAI,CACF,IAAI,CAAC,IAAI,EACT,cAAc,EACd,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CACrF,EACD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACzC,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC9B,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,gBAAgB,CACrB,IAAI,CAAC,KAAK,CACR,MAAM,QAAQ,CACZ,IAAI,CACF,IAAI,CAAC,IAAI,EACT,cAAc,EACd,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CACrF,EACD,MAAM,CACP,CACF,EACD,KAAK,EACL,MAAM,CACP,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5B,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAO;QACX,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC9B,KAAK,GAAG,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;YAC5B,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;YAC5B,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAC1B,YAAY,EAAE,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;YACvD,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;YAC1B,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YAC5F,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE;gBACd,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;gBAClB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO;gBACxB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,YAAY,EAAE,CAAC,CAAC,WAAW;gBAC3B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM;gBACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;gBAC3B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACpC,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;iBACjF,CAAC,CAAC;aACJ,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,EAAU;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC9B,IAAI,GAAG,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;IACpF,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EACpC,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC1B,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,IAAI,KAAK,GAAG,CAAC,EACX,GAAG,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAE,SAAS;YACpC,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7F,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,GAAG;gBACD,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE;oBACzB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE;oBAC9B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;oBACjC,GAAG,CAAC;YACN,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO;YACL,MAAM;YACN,MAAM,EAAE,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;iBAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;iBAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9E,gBAAgB,EAAE,CAAC,GAAG,MAAM,CAAC;iBAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAClD,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM;SACP,CAAC;IACJ,CAAC;IACO,KAAK,CAAC,WAAW,CACvB,IAA0B,EAC1B,MAAc,EACd,KAAa;QAEb,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,OAAO,CAAC;QACxC,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBACpD,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,oFAAoF,CACnH,CAAC;YACJ,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAC9F,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,EAC/C,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,aAAa,KAAK,UAAU;gBAC5D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC3E,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACxB,MAAM,QAAQ,GAAuB,EAAE,CAAC;YACxC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/E,CAAC;iBAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC5B,KAAK,MAAM,OAAO,IAAI,KAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,EACvC,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;oBAC/C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBAClB,MAAM,QAAQ,GAAG,eAAe,CAC9B,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAC5C,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAC3C,MAAM,CACP,CAAC;wBACF,IAAI,QAAQ,CAAC,sBAAsB;4BACjC,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,CAAC,sBAAsB,gHAAgH,CAClK,CAAC;wBACJ,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;oBACD,KAAK,GAAG,IAAI,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrE,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;gBACjD,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,qEAAqE;YACrE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EACjD,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;gBACnF,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAEvD,MAAM,OAAO,GAA+B;gBAC1C,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAClC,IAAI;gBACJ,MAAM;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,WAAW,EAAE,UAAU;gBACvB,WAAW,EAAE,UAAU;gBACvB,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC;gBAC5B,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI;gBACjD,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,EAAE;gBAC/B,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;gBACtC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;gBACpC,GAAG,CAAC,IAAI,KAAK,QAAQ;oBACnB,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;oBAC9B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;wBAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;wBAC9B,CAAC,CAAC,EAAE,CAAC;gBACT,KAAK;gBACL,QAAQ;aACT,CAAC;YACF,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;gBACtD,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,GAAY;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,wBAAwB;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,wBAAwB;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,wCAAwC;QAC5D,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,OAAO,EACrC,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,gBAAgB,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,SAAS;gBAC9B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI;oBACrD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBAC/C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC3B,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF"}

package/dist/raster-edit.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import type { Project } from './project.js';
+export declare const rasterReadSchema: z.ZodObject<{
+    bounds: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    target: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const rasterWriteSchema: z.ZodObject<{
+    target: z.ZodString;
+    region_id: z.ZodString;
+    source: z.ZodString;
+    bounds: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    space: z.ZodDefault<z.ZodEnum<{
+        canvas: "canvas";
+        layer: "layer";
+    }>>;
+    composite: z.ZodDefault<z.ZodEnum<{
+        over: "over";
+        replace: "replace";
+    }>>;
+    expected_hash: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export declare function readRasterRegion(project: Project, raw: unknown): Promise<{
+    width: number;
+    height: number;
+    colour_space: 'srgb';
+    quality: string;
+    region?: import("./schema.js").Bounds;
+    layer?: string;
+    png_hash: string;
+    excluded_layers?: string[];
+    canvas_transform?: import("./layout.js").Matrix;
+    image: string;
+    evidence: string;
+    statistics: {
+        rasterized_layers: number;
+        cached_layers: number;
+        cache_bytes: number;
+        viewport_pixels?: number;
+    };
+    asset: {
+        source: string;
+        hash: string;
+    };
+    scene_hash: string;
+    bounds: [number, number, number, number];
+    target: string | undefined;
+    space: string;
+    encoding: string;
+    render: import("./render.js").RenderResult;
+}>;
+export declare function writeRasterRegion(project: Project, raw: unknown): Promise<{
+    scene_hash: string;
+    sequence: number;
+    locality: import("./verify.js").LocalityEvidence[];
+    asset: {
+        source: string;
+        hash: string;
+    };
+    region_id: string;
+}>;

package/dist/raster-edit.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import sharp from 'sharp';
+import { boundsSchema, flattenLayers } from './schema.js';
+import { localAssetPath, sceneHash, sha256 } from './assets.js';
+import { writeArtifact, writeRender } from './artifacts.js';
+export const rasterReadSchema = z.strictObject({
+    bounds: boundsSchema,
+    target: z.string().optional(),
+});
+export const rasterWriteSchema = z.strictObject({
+    target: z.string(),
+    region_id: z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,79}$/),
+    source: z.string(),
+    bounds: boundsSchema,
+    space: z.enum(['canvas', 'layer']).default('canvas'),
+    composite: z.enum(['replace', 'over']).default('replace'),
+    expected_hash: z.string(),
+    reason: z.string().min(1),
+});
+export async function readRasterRegion(project, raw) {
+    const options = rasterReadSchema.parse(raw), scene = await project.scene();
+    const render = await project.renderer.render(scene, project.root, {
+        layer: options.target,
+        region: options.bounds,
+        cache: false,
+        regionMode: 'full',
+    });
+    const path = join(project.outputDirectory, `region-${render.evidence.render.png_hash.slice(7)}.png`);
+    const artifact = await writeRender(path, render);
+    return {
+        ...artifact,
+        asset: { source: relative(project.root, path), hash: render.evidence.render.png_hash },
+        scene_hash: sceneHash(scene),
+        bounds: options.bounds,
+        target: options.target,
+        space: 'canvas',
+        encoding: 'PNG, straight RGBA on decode; 8-bit sRGB',
+        render,
+    };
+}
+export async function writeRasterRegion(project, raw) {
+    const options = rasterWriteSchema.parse(raw), scene = await project.scene();
+    if (sceneHash(scene) !== options.expected_hash)
+        throw new Error('Stale scene hash');
+    if (!options.bounds.every(Number.isInteger))
+        throw new Error('Dense patches require integer bounds');
+    const bytes = await readFile(await localAssetPath(project.root, options.source));
+    if (bytes.length > 64 * 1024 * 1024)
+        throw new Error('Dense patch exceeds 64 MiB');
+    const metadata = await sharp(bytes, { limitInputPixels: 16 * 1024 * 1024 }).metadata();
+    if (metadata.format !== 'png' ||
+        metadata.width !== options.bounds[2] ||
+        metadata.height !== options.bounds[3])
+        throw new Error('Dense patch must be a PNG matching the exact region dimensions');
+    const hash = sha256(bytes), source = join('raster', `${hash.slice(7)}.png`), id = `patch_${hash.slice(7, 39)}`;
+    const layer = flattenLayers(scene.layers).find((l) => l.id === options.target);
+    if (!layer)
+        throw new Error('Unknown patch target');
+    await writeArtifact(join(project.root, source), bytes);
+    const entry = await project.apply({
+        expected_hash: options.expected_hash,
+        reason: options.reason,
+        commands: [
+            { type: 'registerAsset', id, asset: { source, hash } },
+            {
+                type: layer.regions?.some((r) => r.id === options.region_id)
+                    ? 'updateRegion'
+                    : 'promoteRegion',
+                target: options.target,
+                region: {
+                    id: options.region_id,
+                    source: id,
+                    bounds: options.bounds,
+                    space: options.space,
+                    scale: 1,
+                    composite: options.composite,
+                },
+            },
+        ],
+    });
+    return {
+        scene_hash: entry.after_hash,
+        sequence: entry.sequence,
+        locality: entry.locality,
+        asset: { source, hash },
+        region_id: options.region_id,
+    };
+}
+//# sourceMappingURL=raster-edit.js.map

package/dist/raster-edit.js.map

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

package/dist/raster-studio.d.ts

@@ -0,0 +1,84 @@
+import { resolveConstruction } from './construction.js';
+import { type Canvas } from './native.js';
+export type RGBA = [number, number, number, number];
+export interface PixelSurface {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}
+export type EdgeMode = 'transparent' | 'clamp' | 'repeat';
+export declare const clamp: (x: number, lo?: number, hi?: number) => number;
+export declare const mix: (a: number, b: number, t: number) => number;
+export declare const smoothstep: (a: number, b: number, x: number) => number;
+export declare const repeat: (x: number, period: number) => number;
+export declare function randomGenerator(seed: number): () => number;
+/** Coordinate-addressed noise is independent of traversal order. */
+export declare function noise2D(x: number, y: number, seed?: number): number;
+export declare function fbm(x: number, y: number, seed?: number, octaves?: number): number;
+/** Pixel centres are integer coordinates; interpolate premultiplied colour to avoid dark fringes. */
+export declare function sample(s: PixelSurface, x: number, y: number, edge?: EdgeMode): RGBA;
+export interface BrushPoint {
+    x: number;
+    y: number;
+    pressure?: number;
+}
+export interface BrushOptions {
+    radius: number;
+    colour: string;
+    hardness?: number;
+    opacity?: number;
+    spacing?: number;
+    scatter?: number;
+}
+export type Vector3 = [number, number, number];
+export declare function heightNormal(height: (x: number, y: number) => number, x: number, y: number, strength?: number, step?: number): Vector3;
+export declare function lightSurface(normal: Vector3, base: RGBA, options?: {
+    light?: Vector3;
+    ambient?: number;
+    diffuse?: number;
+    specular?: number;
+    shininess?: number;
+}): RGBA;
+/** A synchronous authoring API. Programs return one Canvas; scene playback uses its baked PNG. */
+export declare function createRasterStudio(width: number, height: number, seed: number, inputs?: Record<string, Canvas>): {
+    width: number;
+    height: number;
+    seed: number;
+    techniques: {
+        mix: (a: string, b: string, t: number) => string;
+        atmosphere: (a: string, b: string, t: number) => string;
+        stroke(canvas: Canvas, points: BrushPoint[], options: import("./techniques.js").PaintOptions): Canvas;
+        glaze(canvas: Canvas, colour: string, opacity?: number): Canvas;
+        weave(canvas: Canvas, options?: {
+            spacing?: number;
+            opacity?: number;
+            colour?: string;
+        }): Canvas;
+    };
+    guides: typeof resolveConstruction;
+    path: (data: string) => import("@napi-rs/canvas").Path2D;
+    canvas: (w?: number, h?: number) => Canvas;
+    pixels: (c: Canvas) => PixelSurface;
+    put: (c: Canvas, p: PixelSurface) => Canvas;
+    raster: (fn: (x: number, y: number) => RGBA, w?: number, h?: number) => Canvas;
+    warp: (source: Canvas, coordinates: (x: number, y: number) => [number, number], edge?: EdgeMode, w?: number, h?: number) => Canvas;
+    sample: typeof sample;
+    brush: (c: Canvas, points: BrushPoint[], options: BrushOptions) => Canvas;
+    random: () => number;
+    clamp: typeof clamp;
+    mix: typeof mix;
+    smoothstep: typeof smoothstep;
+    repeat: typeof repeat;
+    normal: typeof heightNormal;
+    light: typeof lightSurface;
+    noise: (x: number, y: number, salt?: number) => number;
+    fbm: (x: number, y: number, octaves?: number, salt?: number) => number;
+    polar: (x: number, y: number, cx?: number, cy?: number) => {
+        radius: number;
+        angle: number;
+    };
+    input: (name: string) => Canvas;
+    displace: (source: Canvas, field: (x: number, y: number) => [number, number], amount?: number, edge?: EdgeMode) => Canvas;
+    blur: (source: Canvas, radius: number) => Canvas;
+};
+export type RasterStudio = ReturnType<typeof createRasterStudio>;