codeboard-studio 0.2.1

package/dist/src/audio/wav.js

@@ -0,0 +1,58 @@
+export function encodeWav(channels, sampleRate = 48000) {
+    if (!Number.isInteger(sampleRate) || sampleRate < 8000 || sampleRate > 192000 || channels.length < 1 || channels.length > 2)
+        throw new Error("WAV requires 1-2 channels and 8-192 kHz sample rate");
+    const count = channels[0].length;
+    if (count > sampleRate * 3600 || channels.some(c => c.length !== count))
+        throw new Error("WAV channel lengths differ or exceed one hour");
+    const bytes = count * channels.length * 2, b = Buffer.alloc(44 + bytes);
+    b.write("RIFF");
+    b.writeUInt32LE(36 + bytes, 4);
+    b.write("WAVEfmt ", 8);
+    b.writeUInt32LE(16, 16);
+    b.writeUInt16LE(1, 20);
+    b.writeUInt16LE(channels.length, 22);
+    b.writeUInt32LE(sampleRate, 24);
+    b.writeUInt32LE(sampleRate * channels.length * 2, 28);
+    b.writeUInt16LE(channels.length * 2, 32);
+    b.writeUInt16LE(16, 34);
+    b.write("data", 36);
+    b.writeUInt32LE(bytes, 40);
+    for (let i = 0; i < count; i++)
+        for (let c = 0; c < channels.length; c++) {
+            const v = channels[c][i];
+            if (!Number.isFinite(v))
+                throw new Error(`Invalid audio sample ${i}`);
+            b.writeInt16LE(Math.round(Math.max(-1, Math.min(1, v)) * 32767), 44 + (i * channels.length + c) * 2);
+        }
+    return b;
+}
+export function createToneWav(options = {}) {
+    const frequency = options.frequency ?? 440;
+    const durationSeconds = options.durationSeconds ?? 1;
+    const sampleRate = options.sampleRate ?? 48_000;
+    const volume = Math.max(0, Math.min(1, options.volume ?? 0.25));
+    const sampleCount = Math.max(1, Math.round(durationSeconds * sampleRate));
+    const dataBytes = sampleCount * 2;
+    const output = Buffer.alloc(44 + dataBytes);
+    output.write("RIFF", 0);
+    output.writeUInt32LE(36 + dataBytes, 4);
+    output.write("WAVEfmt ", 8);
+    output.writeUInt32LE(16, 16);
+    output.writeUInt16LE(1, 20);
+    output.writeUInt16LE(1, 22);
+    output.writeUInt32LE(sampleRate, 24);
+    output.writeUInt32LE(sampleRate * 2, 28);
+    output.writeUInt16LE(2, 32);
+    output.writeUInt16LE(16, 34);
+    output.write("data", 36);
+    output.writeUInt32LE(dataBytes, 40);
+    const attack = Math.max(1, Math.round((options.attackSeconds ?? 0.015) * sampleRate));
+    const release = Math.max(1, Math.round((options.releaseSeconds ?? 0.08) * sampleRate));
+    for (let index = 0; index < sampleCount; index += 1) {
+        const envelope = Math.min(1, index / attack, (sampleCount - index - 1) / release);
+        const sample = Math.sin(index / sampleRate * Math.PI * 2 * frequency) * volume * Math.max(0, envelope);
+        output.writeInt16LE(Math.round(sample * 32767), 44 + index * 2);
+    }
+    return output;
+}
+//# sourceMappingURL=wav.js.map

package/dist/src/audio/wav.js.map

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

package/dist/src/authoring-runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=authoring-runner.d.ts.map

package/dist/src/authoring-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-runner.d.ts","sourceRoot":"","sources":["../../src/authoring-runner.ts"],"names":[],"mappings":""}

package/dist/src/authoring-runner.js

@@ -0,0 +1,24 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { registerHooks } from "node:module";
+import { pathToFileURL } from "node:url";
+const script = process.argv[2];
+if (!script)
+    throw new Error("An authoring script is required");
+process.argv.splice(1, 1);
+registerHooks({
+    resolve(specifier, context, nextResolve) {
+        if (specifier === "codeboard-studio") {
+            return { url: new URL("./index.js", import.meta.url).href, shortCircuit: true };
+        }
+        return nextResolve(specifier, context);
+    },
+});
+await import(__rewriteRelativeImportExtension(pathToFileURL(script).href));
+//# sourceMappingURL=authoring-runner.js.map

package/dist/src/authoring-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-runner.js","sourceRoot":"","sources":["../../src/authoring-runner.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/B,IAAI,CAAC,MAAM;IAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AAChE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,aAAa,CAAC;IACZ,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW;QACrC,IAAI,SAAS,KAAK,kBAAkB,EAAE,CAAC;YACrC,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAClF,CAAC;QACD,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC;AACH,MAAM,MAAM,kCAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAC,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { findPackageJSON } from "node:module";
+import { resolve } from "node:path";
+import { writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { starter } from "./starter.js";
+import { confirmUpdate, installUpdate, latestRelease, newerRelease, notifyUpdate } from "./updates.js";
+import { exportMovie } from "./export/movie-export.js";
+import { StoryboardProject } from "./core/project.js";
+import { exportStoryboard } from "./export/storyboard-export.js";
+import { exportAnimaticPackage } from "./export/animatic-export.js";
+import { startPreview } from "./preview/server.js";
+import { ProjectStore } from "./storage/store.js";
+const packagePath = findPackageJSON(import.meta.url);
+if (!packagePath)
+    throw new Error("Codeboard package metadata is missing");
+const { version } = JSON.parse(readFileSync(packagePath, "utf8"));
+const program = new Command()
+    .name("codeboard")
+    .enablePositionalOptions()
+    .description("Draw, animate, and render through JavaScript or TypeScript")
+    .version(version);
+program.hook("preAction", async (_command, action) => {
+    if (action.name() !== "update")
+        await notifyUpdate(packagePath, version);
+});
+program.command("update")
+    .description("Check for and install the latest stable GitHub release")
+    .option("--check", "Check without installing")
+    .option("-y, --yes", "Install without an interactive confirmation")
+    .action(async (options) => {
+    try {
+        const latest = await latestRelease();
+        if (!newerRelease(latest, version)) {
+            console.log(`Codeboard ${version} is up to date (latest stable: ${latest}).`);
+            return;
+        }
+        console.log(`Codeboard ${latest} is available (installed: ${version}).`);
+        if (!options.check && (options.yes || await confirmUpdate()))
+            await installUpdate(packagePath, version, latest);
+    }
+    catch (error) {
+        program.error(error instanceof Error ? error.message : String(error));
+    }
+});
+program.command("init")
+    .argument("[file]", "New JavaScript authoring file", "scene.mjs")
+    .action(async (file) => {
+    await writeFile(resolve(file), starter, { flag: "wx" });
+    console.log(`Created ${file}. Run: codeboard run ${JSON.stringify(file)}`);
+});
+program.command("run")
+    .argument("<script>", "JavaScript or TypeScript authoring file")
+    .argument("[arguments...]", "Arguments passed to your script")
+    .passThroughOptions()
+    .action(async (script, args) => {
+    const child = spawn(process.execPath, [fileURLToPath(new URL("./authoring-runner.js", import.meta.url)), resolve(script), ...args], {
+        stdio: "inherit", windowsHide: true,
+    });
+    const forward = () => child.kill("SIGINT");
+    process.on("SIGINT", forward);
+    try {
+        process.exitCode = await new Promise((accept, reject) => {
+            child.once("error", reject);
+            child.once("exit", (code) => accept(code ?? 1));
+        });
+    }
+    finally {
+        process.off("SIGINT", forward);
+    }
+});
+program.command("render")
+    .argument("<project>", "Path to a .cboard file")
+    .option("-o, --output <directory>", "Export directory", "storyboard-export")
+    .option("--columns <number>", "Panels per sheet row", "2")
+    .option("--rows <number>", "Panel rows per sheet page", "2")
+    .action(async (projectPath, options) => {
+    const project = await StoryboardProject.open(resolve(projectPath));
+    const result = await exportStoryboard(project, resolve(options.output), { columns: Number(options.columns), rows: Number(options.rows) });
+    console.log(`Rendered ${result.panelFiles.length} panels and ${result.pdfFile}`);
+});
+program.command("validate")
+    .argument("<project>", "Path to a .cboard file")
+    .action(async (projectPath) => {
+    const store = ProjectStore.open(resolve(projectPath));
+    try {
+        store.verify();
+        console.log(JSON.stringify(store.inspect(), null, 2));
+    }
+    finally {
+        store.close();
+    }
+});
+program.command("animatic")
+    .argument("<project>", "Path to a .cboard file")
+    .option("-o, --output <directory>", "Animatic package directory", "animatic-export")
+    .action(async (projectPath, options) => {
+    const project = await StoryboardProject.open(resolve(projectPath));
+    const result = await exportAnimaticPackage(project, resolve(options.output));
+    console.log(`Rendered ${result.frameFiles.length} frames and ${result.manifestFile}`);
+});
+program.command("preview")
+    .argument("<project>", "Path to a .cboard file")
+    .option("-p, --port <number>", "Preview port", "4173")
+    .action(async (projectPath, options) => {
+    await startPreview(resolve(projectPath), { port: Number(options.port) });
+});
+program.command("movie").argument("<project>").requiredOption("-o, --output <file>").option("--ffmpeg <path>")
+    .action(async (path, options) => {
+    const project = await StoryboardProject.open(resolve(path));
+    console.log(await exportMovie(project, options.output, { onProgress: (n, total) => { if (n % 24 === 0)
+            console.log(`${n}/${total} frames`); }, ...(options.ffmpeg ? { ffmpegPath: options.ffmpeg } : {}) }));
+});
+program.command("inspect").argument("<project>").option("--panel <id>").option("--name <text>").option("--limit <number>", "Result count (maximum 200)", "50").option("--offset <number>", "Skip matching objects", "0").action((path, options) => {
+    const store = ProjectStore.open(resolve(path));
+    try {
+        console.log(JSON.stringify({ storage: store.inspect(), objects: store.findObjects({ limit: Number(options.limit), offset: Number(options.offset), ...options.panel ? { panelId: options.panel } : {}, ...options.name ? { name: options.name } : {} }) }, null, 2));
+    }
+    finally {
+        store.close();
+    }
+});
+await program.parseAsync();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/core/coordinates.d.ts

@@ -0,0 +1,16 @@
+import type { AffineMatrix, StoryboardDocument } from "../model/types.js";
+export interface CoordinateOptions {
+    frame?: number;
+    camera?: boolean;
+}
+export interface CoordinateSpace {
+    panelId: string;
+    layerId: string;
+    rootLayerId: string;
+    targetId: string;
+    frame: number;
+    localToFrame: AffineMatrix;
+    frameToLocal: AffineMatrix | null;
+}
+export declare function coordinateSpace(document: StoryboardDocument, targetId: string, options?: CoordinateOptions): CoordinateSpace;
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/src/core/coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../../src/core/coordinates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAO,kBAAkB,EAAgB,MAAM,mBAAmB,CAAC;AAM5F,MAAM,WAAW,iBAAiB;IAAE,KAAK,CAAC,EAAC,MAAM,CAAC;IAAA,MAAM,CAAC,EAAC,OAAO,CAAA;CAAC;AAClE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAC,MAAM,CAAC;IAAA,OAAO,EAAC,MAAM,CAAC;IAAA,WAAW,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAC9E,YAAY,EAAC,YAAY,CAAC;IAAA,YAAY,EAAC,YAAY,GAAC,IAAI,CAAC;CAC1D;AAUD,wBAAgB,eAAe,CAAC,QAAQ,EAAC,kBAAkB,EAAC,QAAQ,EAAC,MAAM,EAAC,OAAO,GAAC,iBAAoB,GAAE,eAAe,CAgBxH"}

package/dist/src/core/coordinates.js

@@ -0,0 +1,48 @@
+import { evaluateCamera, evaluateLayer } from "../animation/evaluate.js";
+import { assertRenderFrame } from "../animation/frame.js";
+import { cameraPlane } from "../animation/camera-plane.js";
+import { invertMatrix, matrixFromTransform, multiplyMatrices } from "../drawing/math.js";
+function locate(layers, id, ancestors = []) {
+    for (const layer of layers) {
+        const path = [...ancestors, layer];
+        if (layer.id === id)
+            return { path };
+        if (layer.kind === "group") {
+            const found = locate(layer.children, id, path);
+            if (found)
+                return found;
+        }
+        else {
+            const element = layer.elements.find(e => e.id === id);
+            if (element)
+                return { path, element };
+        }
+    }
+    return undefined;
+}
+export function coordinateSpace(document, targetId, options = {}) {
+    for (const panel of document.panels) {
+        const found = locate(panel.layers, targetId);
+        if (!found)
+            continue;
+        const frame = options.frame ?? panel.startFrame;
+        assertRenderFrame(frame);
+        let localToFrame = [1, 0, 0, 1, 0, 0];
+        if (options.camera !== false) {
+            const shot = document.shots.find(s => s.id === panel.shotId), camera = evaluateCamera(shot?.cameraKeyframes ?? [], frame), depth = evaluateLayer(found.path[0], frame).depth;
+            localToFrame = cameraPlane(camera, depth, panel.width, panel.height).matrix;
+        }
+        for (const layer of found.path)
+            localToFrame = multiplyMatrices(localToFrame, matrixFromTransform(evaluateLayer(layer, frame).transform, layer.pivot));
+        if (found.element?.matrix)
+            localToFrame = multiplyMatrices(localToFrame, found.element.matrix);
+        let frameToLocal = null;
+        try {
+            frameToLocal = invertMatrix(localToFrame);
+        }
+        catch { /* Forward mapping remains useful when inversion is unstable. */ }
+        return { panelId: panel.id, layerId: found.path.at(-1).id, rootLayerId: found.path[0].id, targetId, frame, localToFrame, frameToLocal };
+    }
+    throw new Error(`Coordinate target is not a layer or drawing element in a panel: ${targetId}`);
+}
+//# sourceMappingURL=coordinates.js.map

package/dist/src/core/coordinates.js.map

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

package/dist/src/core/handles.d.ts

@@ -0,0 +1,93 @@
+import type { BrushPreset, DrawingElement, Id, LayerChanges, LayerOptions, MotionAnnotation, NewDrawingElement, Panel, PanelOptions, PathCommand, Point, StoryboardDocument, StrokeOptions, Transform, VectorStrokeOptions, PixelBuffer, PixelRegion, RasterSurface, Pivot, VectorFill } from "../model/types.js";
+import { type PathBooleanOperation } from "../drawing/path-geometry.js";
+export interface ProjectActions {
+    _addScene(sequenceId: Id, name: string, id?: Id): SceneHandle;
+    toJSON(): StoryboardDocument;
+    _addShot(sceneId: Id, name: string, id?: Id): ShotHandle;
+    _addPanel(shotId: Id, options: PanelOptions): PanelHandle;
+    _addLayer(panelId: Id, kind: "raster" | "vector" | "group", name: string, options: LayerOptions, parentGroupId?: Id): LayerHandle;
+    _addElement(panelId: Id, layerId: Id, element: NewDrawingElement): Id;
+    _readPixels(panelId: Id, layerId: Id, elementId: Id, region?: PixelRegion): PixelBuffer;
+    _addMotion(panelId: Id, annotation: Omit<MotionAnnotation, "id"> & {
+        id?: Id;
+    }): Id;
+    _updatePanel(panelId: Id, changes: Partial<Pick<Panel, "title" | "durationFrames" | "action" | "dialogue" | "camera" | "notes">>): void;
+    _updateLayer(panelId: Id, layerId: Id, changes: LayerChanges): void;
+    _updateElement(panelId: Id, layerId: Id, elementId: Id, updater: (element: DrawingElement) => DrawingElement): void;
+    _updateElements(panelId: Id, layerId: Id, elementIds: Id[], updater: (element: DrawingElement) => DrawingElement): void;
+    _remove(panelId: Id, layerId?: Id, elementIds?: Id[]): void;
+}
+export declare class SequenceHandle {
+    private project;
+    readonly id: Id;
+    constructor(project: ProjectActions, id: Id);
+    addScene(name: string, id?: Id): SceneHandle;
+}
+export declare class SceneHandle {
+    private project;
+    readonly id: Id;
+    constructor(project: ProjectActions, id: Id);
+    addShot(name: string, id?: Id): ShotHandle;
+}
+export declare class ShotHandle {
+    private project;
+    readonly id: Id;
+    constructor(project: ProjectActions, id: Id);
+    addPanel(options?: PanelOptions): PanelHandle;
+}
+export declare class PanelHandle {
+    private project;
+    readonly id: Id;
+    constructor(project: ProjectActions, id: Id);
+    addRasterLayer(name: string, options?: LayerOptions, parentGroupId?: Id): LayerHandle;
+    addVectorLayer(name: string, options?: LayerOptions, parentGroupId?: Id): LayerHandle;
+    addGroup(name: string, options?: LayerOptions, parentGroupId?: Id): LayerHandle;
+    addMotion(label: string, from: Point, to: Point, color?: string, id?: Id): Id;
+    revise(changes: Partial<Pick<Panel, "title" | "durationFrames" | "action" | "dialogue" | "camera" | "notes">>): this;
+    layer(id: Id): LayerHandle;
+}
+export declare class LayerHandle {
+    private project;
+    readonly panelId: Id;
+    readonly id: Id;
+    constructor(project: ProjectActions, panelId: Id, id: Id);
+    rasterSurface(image: PixelBuffer, options?: Partial<Pick<RasterSurface, "id" | "name" | "matrix" | "opacity" | "visible">>): Id;
+    readPixels(elementId: Id, region?: PixelRegion): PixelBuffer;
+    editPixels(elementId: Id, region: PixelRegion, edit: (patch: PixelBuffer) => void): this;
+    rasterStroke(points: Point[], brush: BrushPreset, options?: StrokeOptions): Id;
+    erase(points: Point[], brush: BrushPreset, options?: Omit<StrokeOptions, "erase">): Id;
+    vectorStroke(points: Point[], options?: VectorStrokeOptions): Id;
+    path(commands: PathCommand[], options?: {
+        id?: Id;
+        name?: string;
+        fill?: VectorFill;
+        stroke?: string;
+        strokeWidth?: number;
+        opacity?: number;
+    }): Id;
+    text(text: string, x: number, y: number, options?: {
+        id?: Id;
+        name?: string;
+        color?: string;
+        font?: string;
+        align?: "left" | "center" | "right";
+        opacity?: number;
+    }): Id;
+    set(changes: LayerChanges): this;
+    edit(elementId: Id, updater: (element: DrawingElement) => DrawingElement): this;
+    outlineStroke(elementId: Id): this;
+    booleanPath(elementId: Id, tool: readonly PathCommand[], operation: PathBooleanOperation): this;
+}
+export declare class Selection {
+    private project;
+    private panelId;
+    private layerId;
+    private elementIds;
+    constructor(project: ProjectActions, panelId: Id, layerId: Id | undefined, elementIds: Id[]);
+    transform(transform: Partial<Transform>, options?: {
+        pivot?: Pivot;
+    }): this;
+    opacity(value: number): this;
+    remove(): void;
+}
+//# sourceMappingURL=handles.d.ts.map

package/dist/src/core/handles.d.ts.map

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

package/dist/src/core/handles.js

@@ -0,0 +1,190 @@
+import { matrixFromTransform, multiplyMatrices } from "../drawing/math.js";
+import { readPixelRegion, writePixelRegion, validatePixels } from "../drawing/pixels.js";
+import { outlinedStroke } from "../drawing/stroke-outline.js";
+import { combinePaths } from "../drawing/path-geometry.js";
+export class SequenceHandle {
+    project;
+    id;
+    constructor(project, id) {
+        this.project = project;
+        this.id = id;
+    }
+    addScene(name, id) { return this.project._addScene(this.id, name, id); }
+}
+export class SceneHandle {
+    project;
+    id;
+    constructor(project, id) {
+        this.project = project;
+        this.id = id;
+    }
+    addShot(name, id) { return this.project._addShot(this.id, name, id); }
+}
+export class ShotHandle {
+    project;
+    id;
+    constructor(project, id) {
+        this.project = project;
+        this.id = id;
+    }
+    addPanel(options = {}) { return this.project._addPanel(this.id, options); }
+}
+export class PanelHandle {
+    project;
+    id;
+    constructor(project, id) {
+        this.project = project;
+        this.id = id;
+    }
+    addRasterLayer(name, options = {}, parentGroupId) { return this.project._addLayer(this.id, "raster", name, options, parentGroupId); }
+    addVectorLayer(name, options = {}, parentGroupId) { return this.project._addLayer(this.id, "vector", name, options, parentGroupId); }
+    addGroup(name, options = {}, parentGroupId) { return this.project._addLayer(this.id, "group", name, options, parentGroupId); }
+    addMotion(label, from, to, color = "#d14a32", id) { return this.project._addMotion(this.id, { label, from, to, color, ...(id ? { id } : {}) }); }
+    revise(changes) { this.project._updatePanel(this.id, changes); return this; }
+    layer(id) { return new LayerHandle(this.project, this.id, id); }
+}
+export class LayerHandle {
+    project;
+    panelId;
+    id;
+    constructor(project, panelId, id) {
+        this.project = project;
+        this.panelId = panelId;
+        this.id = id;
+    }
+    rasterSurface(image, options = {}) {
+        validatePixels(image);
+        return this.project._addElement(this.panelId, this.id, { kind: "raster-surface", ...structuredClone(image), matrix: [1, 0, 0, 1, 0, 0], opacity: 1, visible: true, ...structuredClone(options) });
+    }
+    readPixels(elementId, region) {
+        return this.project._readPixels(this.panelId, this.id, elementId, region);
+    }
+    editPixels(elementId, region, edit) {
+        return this.edit(elementId, element => {
+            if (element.kind !== "raster-surface")
+                throw new Error(`Element ${elementId} is not a pixel surface`);
+            const patch = readPixelRegion(element, region), result = edit(patch);
+            if (result && typeof result.then === "function")
+                throw new Error("Pixel edit callbacks must be synchronous");
+            if (patch.width !== region.width || patch.height !== region.height)
+                throw new Error("Pixel edits cannot resize the selected region");
+            writePixelRegion(element, region.x, region.y, patch);
+            return element;
+        });
+    }
+    rasterStroke(points, brush, options = {}) {
+        const stroke = {
+            kind: "raster-stroke", points: structuredClone(points), brush: structuredClone(brush), color: options.color ?? "#222222",
+            opacity: options.opacity ?? 1, erase: options.erase ?? false, seed: options.seed ?? 1, visible: true,
+            ...(options.reveal ? { reveal: structuredClone(options.reveal) } : {}),
+            ...(options.id ? { id: options.id } : {}), ...(options.name ? { name: options.name } : {}),
+        };
+        return this.project._addElement(this.panelId, this.id, stroke);
+    }
+    erase(points, brush, options = {}) {
+        return this.rasterStroke(points, brush, { ...options, erase: true });
+    }
+    vectorStroke(points, options = {}) {
+        const stroke = {
+            kind: "vector-stroke", points: structuredClone(points), color: options.color ?? "#181716", width: options.width ?? 6,
+            opacity: options.opacity ?? 1, taperStart: options.taperStart ?? 0, taperEnd: options.taperEnd ?? 0,
+            pressureSize: options.pressureSize ?? 0.8, closed: options.closed ?? false, visible: true,
+            ...(options.id ? { id: options.id } : {}), ...(options.name ? { name: options.name } : {}),
+            ...(options.fill !== undefined ? { fill: options.fill } : {}),
+        };
+        return this.project._addElement(this.panelId, this.id, stroke);
+    }
+    path(commands, options = {}) {
+        return this.project._addElement(this.panelId, this.id, {
+            kind: "vector-path", commands: structuredClone(commands), strokeWidth: options.strokeWidth ?? 0,
+            opacity: options.opacity ?? 1, visible: true, ...(options.id ? { id: options.id } : {}),
+            ...(options.name ? { name: options.name } : {}), ...(options.fill !== undefined ? { fill: structuredClone(options.fill) } : {}),
+            ...(options.stroke !== undefined ? { stroke: options.stroke } : {}),
+        });
+    }
+    text(text, x, y, options = {}) {
+        return this.project._addElement(this.panelId, this.id, {
+            kind: "text", text, x, y, color: options.color ?? "#181716", font: options.font ?? "24px sans-serif",
+            align: options.align ?? "left", opacity: options.opacity ?? 1, visible: true,
+            ...(options.id ? { id: options.id } : {}), ...(options.name ? { name: options.name } : {}),
+        });
+    }
+    set(changes) {
+        this.project._updateLayer(this.panelId, this.id, changes);
+        return this;
+    }
+    edit(elementId, updater) {
+        this.project._updateElement(this.panelId, this.id, elementId, updater);
+        return this;
+    }
+    outlineStroke(elementId) {
+        return this.edit(elementId, element => {
+            if (element.kind !== "vector-stroke")
+                throw new Error(`Element ${elementId} is not a vector stroke`);
+            return outlinedStroke(element);
+        });
+    }
+    booleanPath(elementId, tool, operation) {
+        return this.edit(elementId, element => {
+            if (element.kind !== "vector-path")
+                throw new Error(`Element ${elementId} is not a vector contour`);
+            return { ...element, commands: combinePaths(element.commands, tool, operation) };
+        });
+    }
+}
+export class Selection {
+    project;
+    panelId;
+    layerId;
+    elementIds;
+    constructor(project, panelId, layerId, elementIds) {
+        this.project = project;
+        this.panelId = panelId;
+        this.layerId = layerId;
+        this.elementIds = elementIds;
+        this.elementIds = [...new Set(elementIds)];
+    }
+    transform(transform, options = {}) {
+        if (!this.layerId)
+            throw new Error("Selection.transform() requires a layerId");
+        if (this.elementIds.length === 0) {
+            if (options.pivot)
+                throw new Error("A temporary pivot requires selected elements; set the layer pivot for layer animation");
+            const panel = this.project.toJSON().panels.find((entry) => entry.id === this.panelId);
+            if (!panel)
+                throw new Error(`Panel not found: ${this.panelId}`);
+            const current = findLayer(panel.layers, this.layerId).transform;
+            this.project._updateLayer(this.panelId, this.layerId, { transform: { ...current, ...transform } });
+            return this;
+        }
+        this.project._updateElements(this.panelId, this.layerId, this.elementIds, (element) => transformElement(element, transform, options.pivot));
+        return this;
+    }
+    opacity(value) {
+        if (!this.layerId)
+            throw new Error("Selection.opacity() requires a layerId");
+        if (this.elementIds.length === 0)
+            this.project._updateLayer(this.panelId, this.layerId, { opacity: value });
+        else
+            this.project._updateElements(this.panelId, this.layerId, this.elementIds, (element) => ({ ...element, opacity: value }));
+        return this;
+    }
+    remove() { this.project._remove(this.panelId, this.layerId, this.elementIds); }
+}
+function findLayer(layers, id) {
+    for (const layer of layers) {
+        if (layer.id === id)
+            return layer;
+        if (layer.kind === "group") {
+            try {
+                return findLayer(layer.children, id);
+            }
+            catch { /* keep searching */ }
+        }
+    }
+    throw new Error(`Layer not found: ${id}`);
+}
+function transformElement(element, transform, pivot) {
+    return { ...element, matrix: multiplyMatrices(matrixFromTransform(transform, pivot), element.matrix ?? [1, 0, 0, 1, 0, 0]) };
+}
+//# sourceMappingURL=handles.js.map