@sealpixel/core 1.0.0-rc.0

package/dist/inline-renderer.d.ts

@@ -0,0 +1,28 @@
+import { type RgbaBuffer, type SealpixelWasm } from '@sealpixel/wasm';
+import type { Renderer } from './renderer.js';
+import { RendererCore, type RendererCoreOptions } from './renderer-core.js';
+import type { SourceDescriptor } from './types.js';
+/** Runs the renderer on the calling thread. Fallback where Workers are unavailable, and the server's renderer. */
+export declare class InlineRenderer implements Renderer {
+    private core;
+    private readonly ready;
+    constructor(options: RendererCoreOptions & {
+        wasm?: SealpixelWasm;
+    });
+    init(): Promise<{
+        coreVersion: string;
+        plugins: Record<string, number>;
+    }>;
+    load(bytes: Uint8Array, id: string): Promise<import("./renderer-core.js").LoadedSource>;
+    loadProxy(proxy: RgbaBuffer, descriptor: SourceDescriptor): Promise<import("./renderer-core.js").LoadedSource>;
+    loadProxyEncoded(bytes: Uint8Array, descriptor: SourceDescriptor): Promise<import("./renderer-core.js").LoadedSource>;
+    render(req: Parameters<Renderer['render']>[0]): Promise<RgbaBuffer>;
+    export(req: Parameters<Renderer['export']>[0]): Promise<import("./renderer-core.js").ExportResult>;
+    geometry(req: Parameters<Renderer['geometry']>[0]): Promise<import("./plan.js").Geometry>;
+    unload(): Promise<void>;
+    putAsset(id: string, bytes: Uint8Array): Promise<void>;
+    dispose(): void;
+    /** For tests. */
+    coreForTest(): Promise<RendererCore>;
+}
+//# sourceMappingURL=inline-renderer.d.ts.map

package/dist/inline-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-renderer.d.ts","sourceRoot":"","sources":["../src/inline-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,kHAAkH;AAClH,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAElC,OAAO,EAAE,mBAAmB,GAAG;QAAE,IAAI,CAAC,EAAE,aAAa,CAAA;KAAE;IAS7D,IAAI;;;;IAGJ,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM;IAGlC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB;IAGzD,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB;IAGhE,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAG7C,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAG7C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAGjD,MAAM;IAGN,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;IAG5C,OAAO;IAGP,iBAAiB;IACX,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;CAG3C"}

package/dist/inline-renderer.js

@@ -0,0 +1,48 @@
+import { loadSealpixelWasm } from '@sealpixel/wasm';
+import { RendererCore } from './renderer-core.js';
+/** Runs the renderer on the calling thread. Fallback where Workers are unavailable, and the server's renderer. */
+export class InlineRenderer {
+    core = null;
+    ready;
+    constructor(options) {
+        this.ready = (options.wasm ? Promise.resolve(options.wasm) : loadSealpixelWasm()).then((wasm) => {
+            this.core = new RendererCore(wasm, options);
+            return this.core;
+        });
+    }
+    async init() {
+        return (await this.ready).info();
+    }
+    async load(bytes, id) {
+        return (await this.ready).load(bytes, id);
+    }
+    async loadProxy(proxy, descriptor) {
+        return (await this.ready).loadProxy(proxy, descriptor);
+    }
+    async loadProxyEncoded(bytes, descriptor) {
+        return (await this.ready).loadProxyEncoded(bytes, descriptor);
+    }
+    async render(req) {
+        return (await this.ready).render(req);
+    }
+    async export(req) {
+        return (await this.ready).export(req);
+    }
+    async geometry(req) {
+        return (await this.ready).geometry(req.log, req.target, req.upTo);
+    }
+    async unload() {
+        (await this.ready).unload();
+    }
+    async putAsset(id, bytes) {
+        (await this.ready).putAsset(id, bytes);
+    }
+    dispose() {
+        this.core?.unload();
+    }
+    /** For tests. */
+    async coreForTest() {
+        return this.ready;
+    }
+}
+//# sourceMappingURL=inline-renderer.js.map

package/dist/inline-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-renderer.js","sourceRoot":"","sources":["../src/inline-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuC,MAAM,iBAAiB,CAAC;AAEzF,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAG5E,kHAAkH;AAClH,MAAM,OAAO,cAAc;IACjB,IAAI,GAAwB,IAAI,CAAC;IACxB,KAAK,CAAwB;IAE9C,YAAY,OAAuD;QACjE,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CACpF,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAiB,EAAE,EAAU;QACtC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,KAAK,CAAC,SAAS,CAAC,KAAiB,EAAE,UAA4B;QAC7D,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,KAAiB,EAAE,UAA4B;QACpE,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAsC;QACjD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,GAAsC;QACjD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,GAAwC;QACrD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,KAAK,CAAC,MAAM;QACV,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,KAAiB;QAC1C,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IACD,iBAAiB;IACjB,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/options.d.ts

@@ -0,0 +1,13 @@
+import type { AnyPlugin } from './plugin.js';
+/** `{ pluginId: partialOptions }`, as accepted by the element, the wrappers and the server. */
+export type PluginOptionsMap = Readonly<Record<string, unknown>>;
+/**
+ * Applies `options[plugin.id]` to each plugin through its `configure()`.
+ * Plugins without an entry are returned as they are. An entry for an unknown
+ * plugin id, or for a plugin without options, is an error: silently ignoring
+ * it would hide a typo in a security-relevant constraint.
+ */
+export declare function configurePlugins(plugins: readonly AnyPlugin[], options: PluginOptionsMap | null | undefined): readonly AnyPlugin[];
+/** The resolved options of every plugin that has any, keyed by id. */
+export declare function pluginOptionsOf(plugins: readonly AnyPlugin[]): Record<string, unknown>;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,SAAS,SAAS,EAAE,CAsBtB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAItF"}

package/dist/options.js

@@ -0,0 +1,35 @@
+import { SealpixelError } from './errors.js';
+/**
+ * Applies `options[plugin.id]` to each plugin through its `configure()`.
+ * Plugins without an entry are returned as they are. An entry for an unknown
+ * plugin id, or for a plugin without options, is an error: silently ignoring
+ * it would hide a typo in a security-relevant constraint.
+ */
+export function configurePlugins(plugins, options) {
+    if (!options || Object.keys(options).length === 0)
+        return plugins;
+    const ids = new Set(plugins.map((p) => p.id));
+    for (const id of Object.keys(options)) {
+        if (!ids.has(id)) {
+            throw new SealpixelError('INVALID_REQUEST', `pluginOptions: plugin "${id}" is not registered`);
+        }
+    }
+    return plugins.map((plugin) => {
+        const partial = options[plugin.id];
+        if (partial === undefined)
+            return plugin;
+        if (!plugin.configure) {
+            throw new SealpixelError('INVALID_REQUEST', `pluginOptions: plugin "${plugin.id}" has no options`);
+        }
+        return plugin.configure(partial);
+    });
+}
+/** The resolved options of every plugin that has any, keyed by id. */
+export function pluginOptionsOf(plugins) {
+    const out = {};
+    for (const p of plugins)
+        if (p.options !== undefined)
+            out[p.id] = p.options;
+    return out;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA6B,EAC7B,OAA4C;IAE5C,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,cAAc,CACtB,iBAAiB,EACjB,0BAA0B,EAAE,qBAAqB,CAClD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,cAAc,CACtB,iBAAiB,EACjB,0BAA0B,MAAM,CAAC,EAAE,kBAAkB,CACtD,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAC,OAA2C,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC3D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IAC5E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/plan.d.ts

@@ -0,0 +1,16 @@
+import type { RenderPlan, Stage } from './generated/plan.js';
+import type { EditLog } from './types.js';
+export type { Geometry, Size, StageGeometry } from './generated/geometry.js';
+export type { ChromaSubsampling, Format as CoreFormat, OutputOptions as CoreOutputOptions, } from './generated/output.js';
+export type { ColorStage, CropStage, Fit, Rect as PlanRect, RenderPlan, ResizeStage, SourceInfo, Stage, } from './generated/plan.js';
+/** Mirrors `sealpixel_core::plan::PLAN_VERSION`. */
+export declare const PLAN_VERSION = 1;
+/**
+ * Builds the plan for `log` executed on a buffer of `actual` size. Until the
+ * plugin registry lands (S1.9) every log compiles to the identity plan.
+ */
+export declare function toRenderPlan(log: EditLog, actual: {
+    width: number;
+    height: number;
+}, stages?: Stage[]): RenderPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EACV,iBAAiB,EACjB,MAAM,IAAI,UAAU,EACpB,aAAa,IAAI,iBAAiB,GACnC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,UAAU,EACV,SAAS,EACT,GAAG,EACH,IAAI,IAAI,QAAQ,EAChB,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,GACN,MAAM,qBAAqB,CAAC;AAE7B,oDAAoD;AACpD,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,MAAM,GAAE,KAAK,EAAO,GACnB,UAAU,CAOZ"}

package/dist/plan.js

@@ -0,0 +1,15 @@
+/** Mirrors `sealpixel_core::plan::PLAN_VERSION`. */
+export const PLAN_VERSION = 1;
+/**
+ * Builds the plan for `log` executed on a buffer of `actual` size. Until the
+ * plugin registry lands (S1.9) every log compiles to the identity plan.
+ */
+export function toRenderPlan(log, actual, stages = []) {
+    return {
+        version: PLAN_VERSION,
+        source: { width: log.source.width, height: log.source.height },
+        proxyScale: actual.width / log.source.width,
+        stages,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAoBA,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAY,EACZ,MAAyC,EACzC,SAAkB,EAAE;IAEpB,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE;QAC9D,UAAU,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK;QAC3C,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Plugin contract. These are types only; `@sealpixel/plugin-sdk` provides the
+ * `definePlugin` / `defineOperation` helpers and deterministic math, and
+ * `@sealpixel/core` provides the registry that consumes plugins.
+ */
+import type { RgbaBuffer } from '@sealpixel/wasm';
+import type { Size, Stage } from './plan.js';
+import type { Operation, OperationBase, SourceDescriptor } from './types.js';
+/** Augmented by plugins: `declare module '@sealpixel/core' { interface DocumentRegistry { finetune: FinetuneDoc } }`. */
+export interface DocumentRegistry {
+}
+/** Derived state: one slice per plugin, keyed by plugin id. */
+export type Document = {
+    [K in keyof DocumentRegistry]: DocumentRegistry[K];
+};
+/** Runtime validator for one operation. Structural so any zod-like schema works. */
+export interface OperationSchema<Op> {
+    /** Returns the parsed value or throws. */
+    parse(value: unknown): Op;
+    /** Optional non-throwing variant used for aggregated error reporting. */
+    safeParse?(value: unknown): {
+        success: true;
+        data: Op;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+export interface OperationDef<Doc, Op extends OperationBase<string> = OperationBase<string>> {
+    type: Op['type'];
+    schema: OperationSchema<Op>;
+    /** Pure: returns the plugin's next document slice. */
+    reduce: (slice: Doc, op: Op) => Doc;
+    /**
+     * Upgrades an op written by an older plugin version. Called with the raw
+     * value before validation. Return the op in the current shape.
+     */
+    migrate?: (fromVersion: number, op: unknown) => unknown;
+}
+export interface PlanContext {
+    /** The plugin's resolved options (see `SealpixelPlugin.options`). */
+    options?: unknown;
+    /** Logical (full-resolution) size at this stage's input. */
+    logical: Size;
+    /** Actual buffer size at this stage's input. */
+    actual: Size;
+    /** `actual.width / logical.width`. */
+    scale: number;
+    /** `truth` or `preview`. Plugins may cheapen work in preview. */
+    mode: 'truth' | 'preview';
+}
+/**
+ * Parameters a plugin contributes to its stage. For a core kernel this is the
+ * core stage minus `kind`; stages with the same name are shallow-merged in
+ * plugin order, which is how finetune and filter share one `color` stage.
+ */
+export type StageParams = Record<string, unknown>;
+export interface KernelContext {
+    logical: Size;
+    actual: Size;
+    scale: number;
+    mode: 'truth' | 'preview';
+    /** Resolves a declared asset by id; throws if unknown or hash mismatch. */
+    asset: (id: string) => Uint8Array;
+    signal: AbortSignal;
+}
+export type KernelDef = 
+/** First-party only: the kernel is compiled into the core wasm. */
+{
+    kind: 'core';
+}
+/** Plain JavaScript. Determinism is the author's responsibility. */
+ | {
+    kind: 'js';
+    run: (image: RgbaBuffer, params: StageParams, ctx: KernelContext) => RgbaBuffer | Promise<RgbaBuffer>;
+}
+/** Separate WebAssembly module implementing the kernel ABI. */
+ | {
+    kind: 'wasm';
+    module: () => Promise<WebAssembly.Module>;
+    export?: string;
+};
+export interface AssetDeclaration {
+    id: string;
+    /** sha256 of the bytes; the resolver verifies it on both client and server. */
+    hash: string;
+    /** Where the default resolver fetches it from. */
+    url?: string;
+}
+/**
+ * UI contribution. Consumed by `@sealpixel/ui`, which calls the functions with
+ * its `UiToolContext`. Parameters are typed `never` here so a plugin can
+ * declare the context shape it needs without depending on the UI package.
+ */
+export interface ToolDef {
+    id?: string;
+    icon: unknown;
+    /** i18n key or literal label. */
+    label: string;
+    panel: (ctx: never) => unknown;
+    overlay?: (ctx: never) => unknown;
+    activate?: (ctx: never) => void;
+    deactivate?: (ctx: never) => void;
+    shortcuts?: Record<string, (ctx: never) => void>;
+    preview?: (ctx: never) => PreviewHint;
+}
+export type PreviewHint = {
+    css: string;
+} | {
+    none: true;
+};
+export interface ToolContext {
+    document: Document;
+    dispatch: (op: Operation) => void;
+    t: (key: string, params?: Record<string, string | number>) => string;
+}
+/** Runtime validator for a plugin's options. Structural so any zod-like schema works. */
+export interface OptionsSchema<Options> {
+    parse(value: unknown): Options;
+    safeParse?(value: unknown): {
+        success: true;
+        data: Options;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+/** Context handed to `validate`: the resolved options and the slice before the op. */
+export interface ValidateContext<Doc, Options> {
+    options: Options;
+    slice: Doc;
+    /** All slices as reduced so far. */
+    document: Document;
+    /** The source image the log belongs to (dimensions in pixels). */
+    source: SourceDescriptor;
+}
+export interface ValidateDocumentContext<Options> {
+    options: Options;
+    document: Document;
+    source: SourceDescriptor;
+}
+export interface SealpixelPlugin<Id extends string = string, Doc = unknown, Options = unknown> {
+    /** Namespaced id such as `acme.invert`. Op types are `<id>.<verb>`. */
+    id: Id;
+    /** Bumped when the op schema or the kernel output changes. */
+    version: number;
+    operations: ReadonlyArray<OperationDef<Doc, any>>;
+    initialDocument: Doc;
+    stage: {
+        name: string;
+        order: number;
+    };
+    /** Returns this plugin's stage parameters, or `null` to contribute nothing. */
+    toPlan: (slice: Doc, ctx: PlanContext) => StageParams | null;
+    kernel: KernelDef;
+    tool?: () => Promise<ToolDef>;
+    assets?: AssetDeclaration[];
+    /**
+     * Resolved options: defaults merged with what `configure()` received.
+     * Options tune behaviour and constrain edits; they never carry pixel data
+     * so a render never depends on them.
+     */
+    options?: Options;
+    /** Validates a full options object. Used by `configure()` and the docs generator. */
+    optionsSchema?: OptionsSchema<Options>;
+    /** One-line descriptions per top-level option key, for generated documentation. */
+    optionsDescribe?: Readonly<Record<string, string>>;
+    /** The defaults `configure()` merges over. */
+    optionsDefaults?: Options;
+    /** Returns a new plugin instance with `partial` merged over the current options. */
+    configure?: (partial: Partial<Options>) => SealpixelPlugin<Id, Doc, Options>;
+    /**
+     * Constraint check for one operation against the options. Return a message
+     * to reject the op (`OPTION_VIOLATION`), or null to accept. Runs in
+     * `parseEditLog`, in `session.dispatch` and on the server.
+     */
+    validate?: (op: Operation, ctx: ValidateContext<Doc, Options>) => string | null;
+    /**
+     * Constraint check for the final state, for example a locked watermark that
+     * must be present. Runs before export and before every server render.
+     */
+    validateDocument?: (slice: Doc, ctx: ValidateDocumentContext<Options>) => string | null;
+    /**
+     * Operations the editor dispatches when a source loads with an empty log,
+     * so option defaults (a default preset, a locked watermark) become part of
+     * the log instead of hidden state. Ids are assigned by the caller.
+     */
+    initialOps?: (ctx: {
+        options: Options;
+        source: SourceDescriptor;
+    }) => Omit<Operation, 'id'>[];
+}
+/**
+ * A plugin with its document type erased. Registries accept this so plugins
+ * with concrete `Doc` types can be mixed in one array.
+ */
+export type AnyPlugin = SealpixelPlugin<string, any, any>;
+/** Core stage kinds a `kernel: { kind: 'core' }` plugin may target. */
+export type CoreStageName = Stage['kind'];
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,58 @@
+import type { AnyPlugin, Document, OperationDef } from './plugin.js';
+import type { EditLog, Operation, SourceDescriptor } from './types.js';
+export interface ParseOptions {
+    /**
+     * Keep ops whose type is unknown instead of failing. They are ignored by
+     * `compile`. Only for forward-compatible previews; servers must not set it.
+     */
+    tolerateUnknown?: boolean;
+}
+export interface ParseIssue {
+    /** Index into `ops`, or -1 for a top-level problem. */
+    index: number;
+    code: 'INVALID_EDIT_LOG' | 'UNKNOWN_PLUGIN' | 'UNKNOWN_OPERATION' | 'OPTION_VIOLATION';
+    message: string;
+}
+export type ParseResult = {
+    ok: true;
+    log: EditLog;
+} | {
+    ok: false;
+    issues: ParseIssue[];
+};
+export interface RegisteredOperation {
+    plugin: AnyPlugin;
+    def: OperationDef<any, any>;
+}
+/** Plugins plus everything derived from them: schemas, reducers, stage order. */
+export interface Registry {
+    /** Sorted by stage order, then id. */
+    readonly plugins: readonly AnyPlugin[];
+    readonly byId: ReadonlyMap<string, AnyPlugin>;
+    readonly byOpType: ReadonlyMap<string, RegisteredOperation>;
+    /** `{ pluginId: version }` for every registered plugin. */
+    pluginVersions(): Record<string, number>;
+    initialDocument(): Document;
+    /** Validates and migrates an unknown value into an `EditLog`. Throws `SealpixelError`. */
+    parseEditLog(value: unknown, options?: ParseOptions): EditLog;
+    safeParseEditLog(value: unknown, options?: ParseOptions): ParseResult;
+    /**
+     * Runs the owning plugin's `validate` for one op against the document it
+     * would apply to. Returns the violation message, or null.
+     */
+    validateOperation(op: Operation, document: Document, source: SourceDescriptor): string | null;
+    /**
+     * Runs every plugin's `validateDocument` over a compiled document. Returns
+     * all violations; empty when the state satisfies the configured options.
+     */
+    validateDocument(document: Document, source: SourceDescriptor): {
+        plugin: string;
+        message: string;
+    }[];
+    /** `{ pluginId: options }` for every plugin with options. */
+    pluginOptions(): Record<string, unknown>;
+    /** Ops that seed an empty log from option defaults, in stage order. */
+    initialOps(source: SourceDescriptor): Omit<Operation, 'id'>[];
+}
+export declare function createRegistry(plugins: readonly AnyPlugin[]): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAoB,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,CAAC;IAElB,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5D,2DAA2D;IAC3D,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,eAAe,IAAI,QAAQ,CAAC;IAC5B,0FAA0F;IAC1F,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAC9D,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;IACtE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9F;;;OAGG;IACH,gBAAgB,CACd,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,gBAAgB,GACvB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,6DAA6D;IAC7D,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;CAC/D;AA6BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,QAAQ,CAiKtE"}

package/dist/registry.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+import { SealpixelError } from './errors.js';
+const SourceSchema = z.object({
+    id: z.string().min(1),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    hash: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/)
+        .optional(),
+    mimeType: z.string().optional(),
+});
+const AssetSchema = z
+    .object({
+    id: z.string().min(1),
+    hash: z.string().regex(/^[0-9a-f]{64}$/),
+    url: z.string().min(1).optional(),
+})
+    .strict();
+const LogShape = z.object({
+    version: z.literal(1),
+    source: SourceSchema,
+    plugins: z.record(z.string(), z.number().int().positive()).default({}),
+    assets: z.array(AssetSchema).max(1000).optional(),
+    ops: z.array(z.unknown()).default([]),
+});
+export function createRegistry(plugins) {
+    const byId = new Map();
+    const byOpType = new Map();
+    for (const plugin of plugins) {
+        if (byId.has(plugin.id)) {
+            throw new SealpixelError('INVALID_EDIT_LOG', `plugin "${plugin.id}" registered twice`);
+        }
+        byId.set(plugin.id, plugin);
+        for (const def of plugin.operations) {
+            if (byOpType.has(def.type)) {
+                throw new SealpixelError('INVALID_EDIT_LOG', `operation "${def.type}" registered twice`);
+            }
+            byOpType.set(def.type, { plugin, def });
+        }
+    }
+    const sorted = [...plugins].sort((a, b) => a.stage.order - b.stage.order || a.id.localeCompare(b.id));
+    const initialDocument = () => Object.fromEntries(sorted.map((p) => [p.id, p.initialDocument]));
+    const validateOperation = (op, document, source) => {
+        const entry = byOpType.get(op.type);
+        if (!entry?.plugin.validate)
+            return null;
+        const slice = document[entry.plugin.id];
+        return entry.plugin.validate(op, { options: entry.plugin.options, slice, document, source });
+    };
+    const validateDocument = (document, source) => {
+        const out = [];
+        for (const plugin of sorted) {
+            if (!plugin.validateDocument)
+                continue;
+            const slice = document[plugin.id];
+            const message = plugin.validateDocument(slice, { options: plugin.options, document, source });
+            if (message)
+                out.push({ plugin: plugin.id, message });
+        }
+        return out;
+    };
+    const safeParseEditLog = (value, options = {}) => {
+        const shape = LogShape.safeParse(value);
+        if (!shape.success) {
+            return {
+                ok: false,
+                issues: shape.error.issues.map((i) => ({
+                    index: -1,
+                    code: 'INVALID_EDIT_LOG',
+                    message: `${i.path.join('.') || '(root)'}: ${i.message}`,
+                })),
+            };
+        }
+        const issues = [];
+        const ops = [];
+        // Slices reduced so far, so constraints can look at the state an op applies to.
+        const document = initialDocument();
+        shape.data.ops.forEach((raw, index) => {
+            const type = typeof raw === 'object' && raw !== null ? raw.type : undefined;
+            if (typeof type !== 'string') {
+                issues.push({ index, code: 'INVALID_EDIT_LOG', message: 'op has no string "type"' });
+                return;
+            }
+            const entry = byOpType.get(type);
+            if (!entry) {
+                if (options.tolerateUnknown) {
+                    ops.push(raw);
+                    return;
+                }
+                const pluginId = type.slice(0, type.lastIndexOf('.'));
+                issues.push(byId.has(pluginId)
+                    ? { index, code: 'UNKNOWN_OPERATION', message: `unknown operation "${type}"` }
+                    : { index, code: 'UNKNOWN_PLUGIN', message: `plugin "${pluginId}" is not registered` });
+                return;
+            }
+            const written = shape.data.plugins[entry.plugin.id];
+            let candidate = raw;
+            if (written !== undefined && written < entry.plugin.version) {
+                if (!entry.def.migrate) {
+                    issues.push({
+                        index,
+                        code: 'INVALID_EDIT_LOG',
+                        message: `op "${type}" was written by ${entry.plugin.id} v${written}; v${entry.plugin.version} has no migration`,
+                    });
+                    return;
+                }
+                candidate = entry.def.migrate(written, raw);
+            }
+            const parsed = entry.def.schema.safeParse
+                ? entry.def.schema.safeParse(candidate)
+                : tryParse(entry.def.schema.parse, candidate);
+            if (parsed.success) {
+                const op = parsed.data;
+                const violation = validateOperation(op, document, stripUndefined(shape.data.source));
+                if (violation) {
+                    issues.push({ index, code: 'OPTION_VIOLATION', message: `op "${type}": ${violation}` });
+                    return;
+                }
+                ops.push(op);
+                document[entry.plugin.id] = entry.def.reduce(document[entry.plugin.id], op);
+            }
+            else {
+                issues.push({
+                    index,
+                    code: 'INVALID_EDIT_LOG',
+                    message: `op "${type}": ${describeError(parsed.error)}`,
+                });
+            }
+        });
+        if (issues.length > 0)
+            return { ok: false, issues };
+        const log = {
+            version: 1,
+            source: stripUndefined(shape.data.source),
+            plugins: { ...shape.data.plugins },
+            ...(shape.data.assets
+                ? { assets: shape.data.assets.map((a) => stripUndefined(a)) }
+                : {}),
+            ops,
+        };
+        return { ok: true, log };
+    };
+    return {
+        plugins: sorted,
+        byId,
+        byOpType,
+        pluginVersions: () => Object.fromEntries(sorted.map((p) => [p.id, p.version])),
+        pluginOptions: () => Object.fromEntries(sorted.filter((p) => p.options !== undefined).map((p) => [p.id, p.options])),
+        initialDocument,
+        initialOps: (source) => sorted.flatMap((p) => p.initialOps?.({ options: p.options, source }) ?? []),
+        validateOperation,
+        validateDocument,
+        safeParseEditLog,
+        parseEditLog: (value, options) => {
+            const result = safeParseEditLog(value, options);
+            if (result.ok)
+                return result.log;
+            const first = result.issues[0];
+            const code = result.issues.every((i) => i.code === 'UNKNOWN_PLUGIN')
+                ? 'UNKNOWN_PLUGIN'
+                : result.issues.some((i) => i.code === 'OPTION_VIOLATION')
+                    ? 'OPTION_VIOLATION'
+                    : 'INVALID_EDIT_LOG';
+            throw new SealpixelError(code, first ? `${first.message}` : 'invalid edit log', result.issues);
+        },
+    };
+}
+function tryParse(parse, value) {
+    try {
+        return { success: true, data: parse(value) };
+    }
+    catch (error) {
+        return { success: false, error };
+    }
+}
+function describeError(error) {
+    if (error && typeof error === 'object' && 'issues' in error) {
+        const issues = error.issues;
+        return issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ');
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+function stripUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=registry.js.map