@sealpixel/plugin-assist 1.0.0-rc.8

package/LICENSE.md

@@ -0,0 +1,59 @@
+# Business Source License 1.1
+
+## Parameters
+
+**Licensor:** nine feet UG (haftungsbeschränkt), Germany (https://9feet.io)
+
+**Licensed Work:** Sealpixel, in every version the Licensor publishes: the source code, the npm packages under the `@sealpixel` scope and the unscoped `sealpixel` package, the Rust crates, the WebAssembly binaries, the documentation and the example projects. The Licensed Work is (c) 2026 nine feet UG (haftungsbeschränkt).
+
+**Additional Use Grant:** You may make production use of the Licensed Work if you are a Small User. You are a Small User if you are a natural person acting for yourself, or if the organization you act for had less than EUR 1,000,000 of gross revenue in its most recent completed financial year. Revenue is counted across the whole group: the organization, everything that controls it, everything it controls, and everything under common control with it. Where the work is done for a client, the client's revenue decides.
+
+This Additional Use Grant does not permit offering the Licensed Work, or a work that includes or is derived from it, to third parties as a product or service whose primary purpose is image editing, image cropping, annotation, redaction, watermarking or server-side image rendering.
+
+**Change Date:** Four years after the date on which the Licensor first publishes a specific version of the Licensed Work.
+
+**Change License:** Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work, please visit: https://sealpixel.dev/pricing
+
+Organizations, and anyone who develops with the Licensed Work for an organization, obtain the commercial license this License refers to as developer seats under the Sealpixel Developer Seat License, published at https://sealpixel.dev/license#seats and as `LICENSE-COMMERCIAL.md` in the source repository.
+
+## Notice
+
+The Business Source License (this document, or the "License") is not an Open Source license. However, the Licensed Work will eventually be made available under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved. "Business Source License" is a trademark of MariaDB Corporation Ab.
+
+---
+
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work. The Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly available distribution of a specific version of the Licensed Work under this License, whichever comes first, the Licensor hereby grants you rights under the terms of the Change License, and the rights granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently in effect as described in this License, you must purchase a commercial license from the Licensor, its affiliated entities, or authorized resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of the Licensed Work, are subject to this License. This License applies separately for each version of the Licensed Work and the Change Date may vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of the Licensed Work. If you receive the Licensed Work in original or modified form from a third party, the terms and conditions set forth in this License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically terminate your rights under this License for the current and all other versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor or its affiliates (provided that you may use a trademark or logo of Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license your works, and to refer to it using the trademark "Business Source License", as long as you comply with the Covenants of Licensor below.
+
+## Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business Source License" name and trademark, Licensor covenants to MariaDB, and to all other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version, or a license that is compatible with GPL Version 2.0 or a later version, where "compatible" means that software provided under the Change License can be included in a program with software provided under GPL Version 2.0 or a later version. Licensor may specify additional Change Licenses without limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not impose any additional restriction on the right granted in this License, as the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,32 @@
+# @sealpixel/plugin-assist
+
+Assisted redaction. A detector proposes regions on the proxy, a person accepts
+or rejects them, and acceptance dispatches an ordinary `redact.add`. The
+suggestions live in the UI tool, never in the edit log, so a render never needs
+the model again.
+
+The plugin itself declares no operations and does no kernel work; it gives the
+editor a plugin id for the toolbar button and the options. It is not in
+`defaultPlugins`: a host registers it, installs the tool from `@sealpixel/ui`
+(`createAssistTool`) and supplies a detector — its own, or the one from the
+`/plates` entry of this package:
+
+```ts
+import { createAssistTool, defaultPlugins } from '@sealpixel/element';
+import { assistPlugin } from '@sealpixel/plugins';
+import { createPlateDetector } from '@sealpixel/plugin-assist/plates';
+
+editor.plugins = [...defaultPlugins, assistPlugin];
+editor.tools = { assist: createAssistTool(createPlateDetector()) };
+editor.pluginOptions = {
+  assist: { model: { url: '/models/plate.onnx', sha256: '…' }, wasmPaths: '/ort/' },
+};
+```
+
+`/plates` runs onnxruntime-web in a worker and imports it on the first
+detection. `onnxruntime-web` is an optional peer dependency: install it and
+serve its `.wasm` files and your model yourself. The SDK ships no weights.
+
+Options: `run`, `timeoutMs`, `classes`, `minScore`, `maxSuggestions`, `model`,
+`wasmPaths`, `padding`, `mode`, `amount`, `acceptAbove`, `badge`, `showScore`,
+`adjust`, `bulk`. See the guide at docs.sealpixel.dev for the full contract.

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Assisted redaction.
+ *
+ * A detector proposes regions on the proxy; a person accepts or rejects them;
+ * acceptance dispatches an ordinary `redact.add`. The suggestions live in the
+ * UI tool, never in the edit log: the log holds decisions, not guesses, and a
+ * render must never need the model again. This plugin therefore declares no
+ * operations and does no kernel work. It exists so the editor has a plugin id
+ * to hang a toolbar button and options on.
+ *
+ * Nothing here knows about a model. `@sealpixel/plugin-assist/plates` ships a
+ * licence-plate detector on top of onnxruntime-web, loaded only when asked.
+ */
+import type { Rect, RgbaBuffer } from '@sealpixel/core';
+import { z } from 'zod';
+/** One proposed region, in `image` space: 0..1 over the source. */
+export interface Detection {
+    rect: Rect;
+    /** 0..1, higher is more confident. */
+    score: number;
+    /** What the detector thinks it found, for the UI only. */
+    label: string;
+}
+/**
+ * What a host injects. `image` is the unedited proxy (RGBA8, straight alpha).
+ * `options` are the resolved plugin options, so a detector can read its model
+ * location from the same JSON the host configured.
+ */
+export interface Detector {
+    detect(image: RgbaBuffer, ctx: {
+        signal: AbortSignal;
+        options: AssistOptions;
+    }): Promise<Detection[]>;
+}
+/** When the detector runs: on selecting the tool, right after an image loads, or only on request. */
+export type AssistRun = 'select' | 'load' | 'manual';
+export interface AssistOptions {
+    /** When the detector runs. `load` fetches runtime and model at load time. */
+    run: AssistRun;
+    /** A detection that takes longer fails with a message instead of waiting forever. */
+    timeoutMs: number;
+    /** Labels to ask for and keep; empty means everything the detector offers. */
+    classes: string[];
+    /**
+     * Proposals below this score are dropped. The default sits between the
+     * lowest true plate (0.72) and the highest false positive (0.59) of the
+     * measured set; a host with a different detector sets its own.
+     */
+    minScore: number;
+    /** At most this many proposals, best first. */
+    maxSuggestions: number;
+    /** Where the detector fetches its model, pinned by sha256; `inputSize` picks the export. */
+    model: {
+        url: string;
+        sha256: string;
+        inputSize?: number | undefined;
+    } | null;
+    /** Directory the ML runtime loads its WebAssembly from, with a trailing slash. */
+    wasmPaths: string | null;
+    /** Grown around each proposed rect before it becomes a redaction, in image units. */
+    padding: number;
+    /** Mode of an accepted proposal; null takes the redact plugin's default. */
+    mode: 'pixelate' | 'blur' | null;
+    /** Amount of an accepted proposal in source px; null takes the redact plugin's default. */
+    amount: number | null;
+    /** Proposals at or above this score are accepted without review; null keeps every decision human. */
+    acceptAbove: number | null;
+    /** Count of open proposals on the toolbar button. */
+    badge: boolean;
+    /** Score chip on each proposed box. */
+    showScore: boolean;
+    /** Proposals can be moved before they are accepted. */
+    adjust: boolean;
+    /** "Accept all" and "Reject all" in the panel. */
+    bulk: boolean;
+}
+export declare const AssistOptionsSchema: z.ZodObject<{
+    run: z.ZodEnum<{
+        select: "select";
+        load: "load";
+        manual: "manual";
+    }>;
+    timeoutMs: z.ZodNumber;
+    classes: z.ZodArray<z.ZodString>;
+    minScore: z.ZodNumber;
+    maxSuggestions: z.ZodNumber;
+    model: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        sha256: z.ZodString;
+        inputSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    wasmPaths: z.ZodNullable<z.ZodString>;
+    padding: z.ZodNumber;
+    mode: z.ZodNullable<z.ZodEnum<{
+        pixelate: "pixelate";
+        blur: "blur";
+    }>>;
+    amount: z.ZodNullable<z.ZodNumber>;
+    acceptAbove: z.ZodNullable<z.ZodNumber>;
+    badge: z.ZodBoolean;
+    showScore: z.ZodBoolean;
+    adjust: z.ZodBoolean;
+    bulk: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const ASSIST_DEFAULT_OPTIONS: AssistOptions;
+export type AssistDoc = Record<string, never>;
+declare module '@sealpixel/core' {
+    interface DocumentRegistry {
+        assist: AssistDoc;
+    }
+}
+/** Grows a rect by `padding` on every side and clamps it to the image. */
+export declare function padRect(rect: Rect, padding: number): Rect;
+/**
+ * Keeps what passes the options: the wanted classes (all, when `classes` is
+ * empty), at or above `minScore`, best first, at most `maxSuggestions`.
+ */
+export declare function filterDetections(list: readonly Detection[], options: Pick<AssistOptions, 'minScore' | 'classes' | 'maxSuggestions'>): Detection[];
+/** The redact options an accepted suggestion takes its mode and amount from. */
+export interface RedactDefaults {
+    defaultMode: 'pixelate' | 'blur';
+    defaultAmount: number;
+}
+/**
+ * The operation an accepted suggestion becomes. Exactly the fields a
+ * hand-drawn rectangle carries — nothing about a model, a score or a label —
+ * so the log cannot tell the two apart.
+ */
+export declare function toRedactAdd(rect: Rect, redact: RedactDefaults, id: string, override?: Pick<AssistOptions, 'mode' | 'amount'>): {
+    type: 'redact.add';
+    id: string;
+    region: {
+        kind: 'rect';
+        rect: Rect;
+    };
+    mode: 'pixelate' | 'blur';
+    amount: number;
+};
+/** Smallest side a region keeps; the redact schema requires `> 0`. */
+export declare const MIN_SIDE = 0.002;
+export declare const assistPlugin: import("@sealpixel/plugin-sdk").ConfigurablePlugin<"assist", AssistDoc, AssistOptions>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,117 @@
+import { definePlugin } from '@sealpixel/plugin-sdk';
+import { z } from 'zod';
+const score = z.number().min(0).max(1);
+export const AssistOptionsSchema = z
+    .object({
+    run: z.enum(['select', 'load', 'manual']),
+    timeoutMs: z.number().int().positive(),
+    classes: z.array(z.string().min(1)),
+    minScore: score,
+    maxSuggestions: z.number().int().positive(),
+    model: z
+        .object({
+        url: z.string().min(1),
+        sha256: z.string().regex(/^[0-9a-f]{64}$/),
+        inputSize: z.number().int().positive().optional(),
+    })
+        .strict()
+        .nullable(),
+    wasmPaths: z.string().endsWith('/').nullable(),
+    padding: z.number().min(0).max(0.5),
+    mode: z.enum(['pixelate', 'blur']).nullable(),
+    amount: z.number().gt(0).max(4096).nullable(),
+    acceptAbove: score.nullable(),
+    badge: z.boolean(),
+    showScore: z.boolean(),
+    adjust: z.boolean(),
+    bulk: z.boolean(),
+})
+    .strict();
+export const ASSIST_DEFAULT_OPTIONS = {
+    run: 'select',
+    timeoutMs: 20_000,
+    classes: [],
+    minScore: 0.6,
+    maxSuggestions: 50,
+    model: null,
+    wasmPaths: null,
+    padding: 0.02,
+    mode: null,
+    amount: null,
+    acceptAbove: null,
+    badge: true,
+    showScore: true,
+    adjust: true,
+    bulk: true,
+};
+/** Grows a rect by `padding` on every side and clamps it to the image. */
+export function padRect(rect, padding) {
+    const x = clamp01(rect.x - padding);
+    const y = clamp01(rect.y - padding);
+    const right = clamp01(rect.x + rect.width + padding);
+    const bottom = clamp01(rect.y + rect.height + padding);
+    return { x, y, width: Math.max(right - x, MIN_SIDE), height: Math.max(bottom - y, MIN_SIDE) };
+}
+/**
+ * Keeps what passes the options: the wanted classes (all, when `classes` is
+ * empty), at or above `minScore`, best first, at most `maxSuggestions`.
+ */
+export function filterDetections(list, options) {
+    return list
+        .filter((d) => d.score >= options.minScore)
+        .filter((d) => options.classes.length === 0 || options.classes.includes(d.label))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, options.maxSuggestions);
+}
+/**
+ * The operation an accepted suggestion becomes. Exactly the fields a
+ * hand-drawn rectangle carries — nothing about a model, a score or a label —
+ * so the log cannot tell the two apart.
+ */
+export function toRedactAdd(rect, redact, id, override = { mode: null, amount: null }) {
+    return {
+        type: 'redact.add',
+        id,
+        region: { kind: 'rect', rect },
+        mode: override.mode ?? redact.defaultMode,
+        amount: override.amount ?? redact.defaultAmount,
+    };
+}
+/** Smallest side a region keeps; the redact schema requires `> 0`. */
+export const MIN_SIDE = 0.002;
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+export const assistPlugin = definePlugin({
+    id: 'assist',
+    version: 1,
+    operations: [],
+    initialDocument: {},
+    // Before redact, where the accepted regions land. Never planned: `toPlan`
+    // returns null, so no stage exists and the kernel never runs.
+    stage: { name: 'assist', order: 190 },
+    toPlan: () => null,
+    kernel: { kind: 'js', run: (image) => image },
+    options: {
+        schema: AssistOptionsSchema,
+        defaults: ASSIST_DEFAULT_OPTIONS,
+        describe: {
+            run: 'When the detector runs: select (the tool is chosen), load (right after an image loads; fetches runtime and model then), manual (only on request).',
+            timeoutMs: 'A detection that takes longer fails with a message instead of waiting forever.',
+            classes: 'Labels to ask for and keep; empty means everything the detector offers.',
+            minScore: 'Proposals below this score are dropped (0..1).',
+            maxSuggestions: 'At most this many proposals, best first.',
+            model: 'Where the detector fetches its model: { url, sha256, inputSize? }. The SDK ships no weights.',
+            wasmPaths: 'Directory the ML runtime loads its WebAssembly from, with a trailing slash.',
+            padding: 'Grown around each proposed rect before it becomes a redaction, in image units.',
+            mode: 'Mode of an accepted proposal; null takes the redact default.',
+            amount: 'Amount of an accepted proposal in source px; null takes the redact default.',
+            acceptAbove: 'Proposals at or above this score are accepted without review; null keeps every decision human.',
+            badge: 'Count of open proposals on the toolbar button.',
+            showScore: 'Score chip on each proposed box.',
+            adjust: 'Proposals can be moved before they are accepted.',
+            bulk: '"Accept all" and "Reject all" in the panel.',
+        },
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/plates/engine.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The part of the plate detector that touches onnxruntime-web. It runs inside
+ * the worker, or on the calling thread where workers do not exist. Nothing in
+ * here imports the runtime statically: `loader` brings it in on first use, so
+ * a bundle that never calls `detect` never contains it.
+ */
+import type { RgbaBuffer } from '@sealpixel/core';
+import type { Detection } from '../index.js';
+import { letterboxGeometry } from './letterbox.js';
+export interface EngineConfig {
+    modelUrl: string;
+    /** Lower-case hex sha256 the fetched model must match. */
+    modelSha256: string;
+    /** Absolute URL of the directory holding the runtime's .wasm and .mjs files. */
+    wasmPaths: string;
+    /** Model input side length in pixels; the model file decides, the host states it. */
+    inputSize: number;
+}
+/** Errors this module raises, by `name`. Hosts match on the name, not the text. */
+export type PlateErrorName = 'DETECTOR_UNAVAILABLE' | 'MODEL_UNAVAILABLE' | 'MODEL_MISMATCH';
+export declare class PlateError extends Error {
+    readonly name: PlateErrorName;
+    constructor(name: PlateErrorName, message: string);
+}
+/** The slice of onnxruntime-web this engine uses; the package's own types stay out of the public .d.ts. */
+export interface OrtLike {
+    env: {
+        wasm: {
+            wasmPaths: string;
+            numThreads: number;
+        };
+    };
+    Tensor: new (type: 'float32', data: Float32Array, dims: number[]) => TensorLike;
+    InferenceSession: {
+        create: (model: Uint8Array, options: {
+            executionProviders: string[];
+        }) => Promise<SessionLike>;
+    };
+}
+export interface TensorLike {
+    data: Float32Array | Int32Array | BigInt64Array;
+    dims: readonly number[];
+}
+export interface SessionLike {
+    inputNames: readonly string[];
+    outputNames: readonly string[];
+    run: (feeds: Record<string, TensorLike>) => Promise<Record<string, TensorLike>>;
+}
+export type OrtLoader = () => Promise<unknown>;
+/** Loads the WASM build of onnxruntime-web; the host may substitute another. */
+export declare const defaultLoader: OrtLoader;
+export declare class PlateEngine {
+    private readonly config;
+    private readonly loader;
+    private ort;
+    private session;
+    private ready;
+    constructor(config: EngineConfig, loader?: OrtLoader);
+    /** Imports the runtime, fetches and verifies the model, creates the session. Once. */
+    init(): Promise<void>;
+    private load;
+    detect(image: RgbaBuffer, signal?: AbortSignal): Promise<Detection[]>;
+}
+/**
+ * The end2end export emits rows of `batch, x1, y1, x2, y2, class, score`
+ * (seven columns) or the same without the batch column, in input pixels.
+ */
+export declare function decode(tensor: TensorLike, geometry: ReturnType<typeof letterboxGeometry>, width: number, height: number): Detection[];
+//# sourceMappingURL=engine.d.ts.map

package/dist/plates/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/plates/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAQ,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAqC,MAAM,gBAAgB,CAAC;AAEtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAE7F,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAkB,IAAI,EAAE,cAAc,CAAC;gBAC3B,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;CAIlD;AAED,2GAA2G;AAC3G,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACzD,MAAM,EAAE,KAAK,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,UAAU,CAAC;IAChF,gBAAgB,EAAE;QAChB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;YAAE,kBAAkB,EAAE,MAAM,EAAE,CAAA;SAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;KAChG,CAAC;CACH;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;IAChD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AACD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CACjF;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/C,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,SAAgD,CAAC;AAE7E,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA8B;gBAGxB,MAAM,EAAE,YAAY,EACpB,MAAM,GAAE,SAAyB;IAGpD,sFAAsF;IACtF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YASP,IAAI;IAoCZ,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAsB5E;AAwBD;;;GAGG;AACH,wBAAgB,MAAM,CACpB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC9C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,SAAS,EAAE,CAwBb"}

package/dist/plates/engine.js

@@ -0,0 +1,130 @@
+import { letterboxGeometry, PAD_GREY, rgbaToNchw, unletterbox } from './letterbox.js';
+export class PlateError extends Error {
+    name;
+    constructor(name, message) {
+        super(message);
+        this.name = name;
+    }
+}
+/** Loads the WASM build of onnxruntime-web; the host may substitute another. */
+export const defaultLoader = () => import('onnxruntime-web/wasm');
+export class PlateEngine {
+    config;
+    loader;
+    ort = null;
+    session = null;
+    ready = null;
+    constructor(config, loader = defaultLoader) {
+        this.config = config;
+        this.loader = loader;
+    }
+    /** Imports the runtime, fetches and verifies the model, creates the session. Once. */
+    init() {
+        this.ready ??= this.load().catch((error) => {
+            // A failed init must not stick: the next call tries again.
+            this.ready = null;
+            throw error;
+        });
+        return this.ready;
+    }
+    async load() {
+        let ort;
+        try {
+            ort = (await this.loader());
+        }
+        catch (error) {
+            throw new PlateError('DETECTOR_UNAVAILABLE', `onnxruntime-web is not installed or failed to load: ${error.message}`);
+        }
+        ort.env.wasm.wasmPaths = this.config.wasmPaths;
+        // One thread: multi-threading needs cross-origin isolation, which few hosts have.
+        ort.env.wasm.numThreads = 1;
+        let bytes;
+        try {
+            const res = await fetch(this.config.modelUrl);
+            if (!res.ok)
+                throw new Error(`${res.status} ${res.statusText}`);
+            bytes = new Uint8Array(await res.arrayBuffer());
+        }
+        catch (error) {
+            throw new PlateError('MODEL_UNAVAILABLE', `could not fetch the model from ${this.config.modelUrl}: ${error.message}`);
+        }
+        const digest = await sha256Hex(bytes);
+        if (digest !== this.config.modelSha256) {
+            throw new PlateError('MODEL_MISMATCH', `the model at ${this.config.modelUrl} hashes to ${digest}, not the pinned ${this.config.modelSha256}`);
+        }
+        this.session = await ort.InferenceSession.create(bytes, { executionProviders: ['wasm'] });
+        this.ort = ort;
+    }
+    async detect(image, signal) {
+        await this.init();
+        const ort = this.ort;
+        const session = this.session;
+        if (!ort || !session)
+            throw new PlateError('DETECTOR_UNAVAILABLE', 'engine did not initialise');
+        signal?.throwIfAborted();
+        const size = this.config.inputSize;
+        const geometry = letterboxGeometry(image.width, image.height, size);
+        const input = rgbaToNchw(await letterbox(image, geometry), size);
+        signal?.throwIfAborted();
+        const inputName = session.inputNames[0];
+        const outputName = session.outputNames[0];
+        const out = await session.run({
+            [inputName]: new ort.Tensor('float32', input, [1, 3, size, size]),
+        });
+        const tensor = out[outputName];
+        if (!tensor)
+            throw new PlateError('DETECTOR_UNAVAILABLE', `model has no output "${outputName}"`);
+        return decode(tensor, geometry, image.width, image.height);
+    }
+}
+/**
+ * Draws the image letterboxed onto a square canvas of the model's input size.
+ * Uses `OffscreenCanvas`, which exists in workers and on the main thread.
+ */
+async function letterbox(image, geometry) {
+    const { size } = geometry;
+    const canvas = new OffscreenCanvas(size, size);
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    if (!ctx)
+        throw new PlateError('DETECTOR_UNAVAILABLE', 'no 2d canvas context');
+    ctx.fillStyle = `rgb(${PAD_GREY},${PAD_GREY},${PAD_GREY})`;
+    ctx.fillRect(0, 0, size, size);
+    const pixels = new Uint8ClampedArray(image.data.byteLength);
+    pixels.set(image.data);
+    const bitmap = await createImageBitmap(new ImageData(pixels, image.width, image.height));
+    ctx.drawImage(bitmap, geometry.padX, geometry.padY, geometry.scaledWidth, geometry.scaledHeight);
+    bitmap.close();
+    return ctx.getImageData(0, 0, size, size).data;
+}
+/**
+ * The end2end export emits rows of `batch, x1, y1, x2, y2, class, score`
+ * (seven columns) or the same without the batch column, in input pixels.
+ */
+export function decode(tensor, geometry, width, height) {
+    const cols = tensor.dims[tensor.dims.length - 1] ?? 0;
+    const offset = cols === 7 ? 1 : cols === 6 ? 0 : -1;
+    if (offset < 0) {
+        throw new PlateError('DETECTOR_UNAVAILABLE', `unexpected model output shape ${JSON.stringify(tensor.dims)}`);
+    }
+    const data = tensor.data;
+    const rows = data.length / cols;
+    const detections = [];
+    for (let r = 0; r < rows; r++) {
+        const base = r * cols + offset;
+        const box = [
+            data[base],
+            data[base + 1],
+            data[base + 2],
+            data[base + 3],
+        ];
+        const rect = unletterbox(box, geometry, width, height);
+        if (rect)
+            detections.push({ rect, score: data[base + 5], label: 'plate' });
+    }
+    return detections;
+}
+async function sha256Hex(bytes) {
+    const digest = await crypto.subtle.digest('SHA-256', bytes);
+    return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+//# sourceMappingURL=engine.js.map

package/dist/plates/engine.js.map

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

package/dist/plates/index.d.ts

@@ -0,0 +1,19 @@
+import type { Detector } from '../index.js';
+import { type OrtLoader } from './engine.js';
+export { decode, type EngineConfig, PlateEngine, PlateError, type PlateErrorName, } from './engine.js';
+export { iou, letterboxGeometry, unletterbox } from './letterbox.js';
+export interface PlateDetectorOptions {
+    /** Model input side when the options name none; the open-image-models exports are 256, 384 or 512. */
+    inputSize?: number;
+    /** Run on the calling thread even where workers exist. */
+    inline?: boolean;
+    /** Replaces the dynamic import of onnxruntime-web, for tests and custom builds. */
+    loader?: OrtLoader;
+}
+/**
+ * A `Detector` that reads its model location from the assist options at call
+ * time. The engine is created once per option set; changing `model` or
+ * `wasmPaths` starts a fresh one.
+ */
+export declare function createPlateDetector(opts?: PlateDetectorOptions): Detector;
+//# sourceMappingURL=index.d.ts.map

package/dist/plates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plates/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAA4B,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAqB,KAAK,SAAS,EAA2B,MAAM,aAAa,CAAC;AAMzF,OAAO,EACL,MAAM,EACN,KAAK,YAAY,EACjB,WAAW,EACX,UAAU,EACV,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,oBAAyB,GAAG,QAAQ,CAoB7E"}

package/dist/plates/index.js

@@ -0,0 +1,110 @@
+import { PlateEngine, PlateError } from './engine.js';
+export { decode, PlateEngine, PlateError, } from './engine.js';
+export { iou, letterboxGeometry, unletterbox } from './letterbox.js';
+/**
+ * A `Detector` that reads its model location from the assist options at call
+ * time. The engine is created once per option set; changing `model` or
+ * `wasmPaths` starts a fresh one.
+ */
+export function createPlateDetector(opts = {}) {
+    const inputSize = opts.inputSize ?? 384;
+    let backend = null;
+    let backendKey = '';
+    return {
+        async detect(image, ctx) {
+            const config = configFrom(ctx.options, ctx.options.model?.inputSize ?? inputSize);
+            const key = JSON.stringify(config);
+            if (!backend || backendKey !== key) {
+                backend?.dispose();
+                backend =
+                    !opts.inline && typeof Worker !== 'undefined' && !opts.loader
+                        ? new WorkerBackend(config)
+                        : new InlineBackend(config, opts.loader);
+                backendKey = key;
+            }
+            return backend.detect(image, ctx.signal);
+        },
+    };
+}
+function configFrom(options, inputSize) {
+    if (!options.model) {
+        throw new PlateError('MODEL_UNAVAILABLE', 'assist options carry no model: set model.url and model.sha256');
+    }
+    if (!options.wasmPaths) {
+        throw new PlateError('DETECTOR_UNAVAILABLE', 'assist options carry no wasmPaths for the runtime');
+    }
+    // Absolute on the main thread: a worker would resolve a relative path against its own script.
+    const base = typeof location !== 'undefined' ? location.href : undefined;
+    return {
+        modelUrl: new URL(options.model.url, base).href,
+        modelSha256: options.model.sha256.toLowerCase(),
+        wasmPaths: new URL(options.wasmPaths, base).href,
+        inputSize,
+    };
+}
+class InlineBackend {
+    engine;
+    constructor(config, loader) {
+        this.engine = new PlateEngine(config, loader);
+    }
+    detect(image, signal) {
+        return this.engine.detect(image, signal);
+    }
+    dispose() { }
+}
+/** Runs the engine in a dedicated worker; an abort rejects the caller and drops the late result. */
+class WorkerBackend {
+    worker;
+    pending = new Map();
+    nextId = 1;
+    ready;
+    constructor(config) {
+        this.worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' });
+        this.worker.addEventListener('message', (e) => {
+            const entry = this.pending.get(e.data.id);
+            if (!entry)
+                return;
+            this.pending.delete(e.data.id);
+            if (e.data.ok)
+                entry.resolve(e.data.result ?? []);
+            else
+                entry.reject(rehydrate(e.data.error));
+        });
+        this.worker.addEventListener('error', (e) => {
+            const error = new PlateError('DETECTOR_UNAVAILABLE', e.message || 'detector worker failed');
+            for (const entry of this.pending.values())
+                entry.reject(error);
+            this.pending.clear();
+        });
+        this.ready = this.call({ type: 'init', config }).then(() => undefined);
+    }
+    async detect(image, signal) {
+        await this.ready;
+        signal.throwIfAborted();
+        // A copy: the caller keeps its pixels, the worker gets its own.
+        const copy = { ...image, data: new Uint8Array(image.data) };
+        const result = this.call({ type: 'detect', image: copy }, [copy.data.buffer]);
+        return new Promise((resolve, reject) => {
+            const onAbort = () => reject(signal.reason ?? new DOMException('aborted', 'AbortError'));
+            signal.addEventListener('abort', onAbort, { once: true });
+            result.then(resolve, reject).finally(() => signal.removeEventListener('abort', onAbort));
+        });
+    }
+    dispose() {
+        this.worker.terminate();
+        this.pending.clear();
+    }
+    call(req, transfer = []) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.worker.postMessage({ ...req, id }, transfer);
+        });
+    }
+}
+function rehydrate(error) {
+    const names = ['DETECTOR_UNAVAILABLE', 'MODEL_UNAVAILABLE', 'MODEL_MISMATCH'];
+    const name = names.find((n) => n === error.name);
+    return name ? new PlateError(name, error.message) : new Error(error.message);
+}
+//# sourceMappingURL=index.js.map

package/dist/plates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plates/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqC,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzF,OAAO,EACL,MAAM,EAEN,WAAW,EACX,UAAU,GAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAWrE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B,EAAE;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACxC,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAiB,EAAE,GAAoD;YAClF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;YAClF,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM;wBAC3D,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC;wBAC3B,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7C,UAAU,GAAG,GAAG,CAAC;YACnB,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAsB,EAAE,SAAiB;IAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAClB,mBAAmB,EACnB,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAClB,sBAAsB,EACtB,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,8FAA8F;IAC9F,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO;QACL,QAAQ,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI;QAC/C,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE;QAC/C,SAAS,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI;QAChD,SAAS;KACV,CAAC;AACJ,CAAC;AAOD,MAAM,aAAa;IACA,MAAM,CAAc;IACrC,YAAY,MAAoB,EAAE,MAAkB;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,KAAiB,EAAE,MAAmB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAU,CAAC;CACnB;AAED,oGAAoG;AACpG,MAAM,aAAa;IACA,MAAM,CAAS;IACf,OAAO,GAAG,IAAI,GAAG,EAG/B,CAAC;IACI,MAAM,GAAG,CAAC,CAAC;IACF,KAAK,CAAgB;IAEtC,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAA+B,EAAE,EAAE;YAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE;gBAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;;gBAC7C,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC,OAAO,IAAI,wBAAwB,CAAC,CAAC;YAC5F,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAiB,EAAE,MAAmB;QACjD,MAAM,IAAI,CAAC,KAAK,CAAC;QACjB,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,gEAAgE;QAChE,MAAM,IAAI,GAAe,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;YACzF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,IAAI,CAAC,GAAa,EAAE,WAA2B,EAAE;QACvD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAwC;IACzD,MAAM,KAAK,GAAG,CAAC,sBAAsB,EAAE,mBAAmB,EAAE,gBAAgB,CAAU,CAAC;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/E,CAAC"}

package/dist/plates/letterbox.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Letterbox geometry for a square model input, and the way back.
+ *
+ * The proxy is scaled uniformly so its longer side fits `size`, centred on a
+ * grey canvas. Boxes come back in input pixels and are mapped to the proxy's
+ * normalised `image` space, which is also the redact operation's space.
+ */
+import type { Rect } from '@sealpixel/core';
+export interface Letterbox {
+    /** Model input side length in pixels. */
+    size: number;
+    /** Uniform scale from source pixels to input pixels. */
+    scale: number;
+    /** Scaled image size inside the input. */
+    scaledWidth: number;
+    scaledHeight: number;
+    /** Offset of the scaled image inside the input. */
+    padX: number;
+    padY: number;
+}
+/** Grey used by YOLO letterboxing, in 0..255. */
+export declare const PAD_GREY = 114;
+export declare function letterboxGeometry(width: number, height: number, size: number): Letterbox;
+/**
+ * Converts letterboxed RGBA pixels (`size` × `size`, straight alpha ignored)
+ * into a planar float32 NCHW tensor in 0..1, RGB order.
+ */
+export declare function rgbaToNchw(rgba: Uint8ClampedArray | Uint8Array, size: number): Float32Array;
+/**
+ * Maps an `x1, y1, x2, y2` box in input pixels back to a normalised rect over
+ * the source. Returns `null` when the box collapses below the smallest region
+ * the redact schema accepts.
+ */
+export declare function unletterbox(box: readonly [number, number, number, number], geometry: Letterbox, width: number, height: number): Rect | null;
+/** Smallest normalised side worth proposing; `RectSchema` needs `> 0`. */
+export declare const MIN_SIDE = 0.002;
+/** Intersection over union of two normalised rects. */
+export declare function iou(a: Rect, b: Rect): number;
+//# sourceMappingURL=letterbox.d.ts.map

package/dist/plates/letterbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"letterbox.d.ts","sourceRoot":"","sources":["../../src/plates/letterbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iDAAiD;AACjD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAYxF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9C,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,IAAI,CASb;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAM9B,uDAAuD;AACvD,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAQ5C"}

package/dist/plates/letterbox.js

@@ -0,0 +1,69 @@
+/**
+ * Letterbox geometry for a square model input, and the way back.
+ *
+ * The proxy is scaled uniformly so its longer side fits `size`, centred on a
+ * grey canvas. Boxes come back in input pixels and are mapped to the proxy's
+ * normalised `image` space, which is also the redact operation's space.
+ */
+/** Grey used by YOLO letterboxing, in 0..255. */
+export const PAD_GREY = 114;
+export function letterboxGeometry(width, height, size) {
+    const scale = Math.min(size / width, size / height);
+    const scaledWidth = Math.round(width * scale);
+    const scaledHeight = Math.round(height * scale);
+    return {
+        size,
+        scale,
+        scaledWidth,
+        scaledHeight,
+        padX: Math.floor((size - scaledWidth) / 2),
+        padY: Math.floor((size - scaledHeight) / 2),
+    };
+}
+/**
+ * Converts letterboxed RGBA pixels (`size` × `size`, straight alpha ignored)
+ * into a planar float32 NCHW tensor in 0..1, RGB order.
+ */
+export function rgbaToNchw(rgba, size) {
+    const plane = size * size;
+    const out = new Float32Array(3 * plane);
+    for (let i = 0; i < plane; i++) {
+        const o = i * 4;
+        out[i] = rgba[o] / 255;
+        out[plane + i] = rgba[o + 1] / 255;
+        out[2 * plane + i] = rgba[o + 2] / 255;
+    }
+    return out;
+}
+/**
+ * Maps an `x1, y1, x2, y2` box in input pixels back to a normalised rect over
+ * the source. Returns `null` when the box collapses below the smallest region
+ * the redact schema accepts.
+ */
+export function unletterbox(box, geometry, width, height) {
+    const [x1, y1, x2, y2] = box;
+    const left = clamp01((x1 - geometry.padX) / geometry.scale / width);
+    const top = clamp01((y1 - geometry.padY) / geometry.scale / height);
+    const right = clamp01((x2 - geometry.padX) / geometry.scale / width);
+    const bottom = clamp01((y2 - geometry.padY) / geometry.scale / height);
+    const rect = { x: left, y: top, width: right - left, height: bottom - top };
+    if (rect.width <= MIN_SIDE || rect.height <= MIN_SIDE)
+        return null;
+    return rect;
+}
+/** Smallest normalised side worth proposing; `RectSchema` needs `> 0`. */
+export const MIN_SIDE = 0.002;
+function clamp01(v) {
+    return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+/** Intersection over union of two normalised rects. */
+export function iou(a, b) {
+    const x1 = Math.max(a.x, b.x);
+    const y1 = Math.max(a.y, b.y);
+    const x2 = Math.min(a.x + a.width, b.x + b.width);
+    const y2 = Math.min(a.y + a.height, b.y + b.height);
+    const inter = Math.max(0, x2 - x1) * Math.max(0, y2 - y1);
+    const union = a.width * a.height + b.width * b.height - inter;
+    return union > 0 ? inter / union : 0;
+}
+//# sourceMappingURL=letterbox.js.map

package/dist/plates/letterbox.js.map

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

package/dist/plates/worker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Worker entry for the plate detector: one engine per worker, requests
+ * correlated by id, pixels handed over as transferables.
+ */
+import type { RgbaBuffer } from '@sealpixel/core';
+import type { Detection } from '../index.js';
+import { type EngineConfig } from './engine.js';
+export type WorkerRequest = {
+    id: number;
+    type: 'init';
+    config: EngineConfig;
+} | {
+    id: number;
+    type: 'detect';
+    image: RgbaBuffer;
+};
+export type WorkerResponse = {
+    id: number;
+    ok: true;
+    result: Detection[] | null;
+} | {
+    id: number;
+    ok: false;
+    error: {
+        name: string;
+        message: string;
+    };
+};
+//# sourceMappingURL=worker.d.ts.map

package/dist/plates/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/plates/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AACtD,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC"}

package/dist/plates/worker.js

@@ -0,0 +1,29 @@
+import { PlateEngine } from './engine.js';
+let engine = null;
+self.addEventListener('message', async (event) => {
+    const req = event.data;
+    try {
+        let result = null;
+        if (req.type === 'init') {
+            engine = new PlateEngine(req.config);
+            await engine.init();
+        }
+        else {
+            if (!engine)
+                throw new Error('detect before init');
+            result = await engine.detect(req.image);
+        }
+        const response = { id: req.id, ok: true, result };
+        self.postMessage(response);
+    }
+    catch (error) {
+        const e = error;
+        const response = {
+            id: req.id,
+            ok: false,
+            error: { name: e.name, message: e.message },
+        };
+        self.postMessage(response);
+    }
+});
+//# sourceMappingURL=worker.js.map

package/dist/plates/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/plates/worker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAS7D,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,KAAkC,EAAE,EAAE;IAC5E,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,MAAM,GAAuB,IAAI,CAAC;QACtC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnD,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,QAAQ,GAAmB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAAc,CAAC;QACzB,MAAM,QAAQ,GAAmB;YAC/B,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;SAC5C,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@sealpixel/plugin-assist",
+  "version": "1.0.0-rc.8",
+  "description": "Assisted redaction: a detector proposes regions on the proxy, the user accepts or rejects, acceptance dispatches a plain redact.add. No operations, no kernel work; the ML runtime loads only from the /plates entry, and only on demand.",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/9feet/sealpixel.git",
+    "directory": "packages/plugins/assist"
+  },
+  "homepage": "https://docs.sealpixel.dev",
+  "bugs": "https://github.com/9feet/sealpixel/issues",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "sealpixel-plugin"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plates": {
+      "types": "./dist/plates/index.d.ts",
+      "default": "./dist/plates/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@sealpixel/plugin-sdk": "1.0.0-rc.7"
+  },
+  "peerDependencies": {
+    "@sealpixel/core": "1.0.0-rc.7",
+    "onnxruntime-web": "^1.27.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "onnxruntime-web": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@sealpixel/config": "0.0.0",
+    "@sealpixel/core": "1.0.0-rc.7",
+    "@sealpixel/plugin-redact": "1.0.0-rc.7",
+    "@types/node": "^24.0.0",
+    "onnxruntime-web": "1.27.0",
+    "typescript": "^6.0.0",
+    "vitest": "^5.0.0",
+    "zod": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}