tempest-react-sdk 0.22.0 → 0.23.0

package/dist/vision/core/canvas.js

@@ -0,0 +1,41 @@
+import { ImageLoadError as c } from "./exceptions.js";
+import { RGBImage as d } from "../types.js";
+function l(e, t) {
+  if (typeof OffscreenCanvas < "u")
+    return new OffscreenCanvas(e, t);
+  if (typeof document < "u") {
+    const n = document.createElement("canvas");
+    return n.width = e, n.height = t, n;
+  }
+  throw new c("No canvas implementation available in this environment.");
+}
+function u(e) {
+  const t = e.getContext("2d");
+  if (t === null)
+    throw new c("Failed to obtain 2D rendering context.");
+  return t;
+}
+function w(e) {
+  const { data: t, width: n, height: a } = e;
+  if (t.length !== n * a * 4)
+    throw new c(
+      `Unexpected ImageData length ${t.length} for ${n}x${a} (expected ${n * a * 4}).`
+    );
+  const o = new Uint8Array(n * a * 3);
+  for (let r = 0, i = 0; r < t.length; r += 4, i += 3)
+    o[i] = t[r], o[i + 1] = t[r + 1], o[i + 2] = t[r + 2];
+  return new d(o, n, a);
+}
+function s(e) {
+  const t = new Uint8ClampedArray(e.width * e.height * 4);
+  for (let n = 0, a = 0; n < e.data.length; n += 3, a += 4)
+    t[a] = e.data[n], t[a + 1] = e.data[n + 1], t[a + 2] = e.data[n + 2], t[a + 3] = 255;
+  return new ImageData(t, e.width, e.height);
+}
+export {
+  l as createCanvas,
+  u as get2DContext,
+  w as imageDataToRGB,
+  s as rgbToImageData
+};
+//# sourceMappingURL=canvas.js.map

package/dist/vision/core/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sources":["../../../src/vision/core/canvas.ts"],"sourcesContent":["/**\n * Canvas plumbing shared by `io/image.ts` and `preprocess/image.ts`.\n *\n * Browsers and workers expose two canvas types (`HTMLCanvasElement` and\n * `OffscreenCanvas`) with slightly different surfaces. These helpers pick the\n * right one for the current environment, return a unified 2D context, and\n * convert between RGBA `ImageData` and the SDK's canonical HWC RGB\n * `RGBImage`.\n */\n\nimport { ImageLoadError } from \"./exceptions\";\nimport { RGBImage } from \"../types\";\n\nexport type Canvas2D = HTMLCanvasElement | OffscreenCanvas;\nexport type Context2D = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;\n\n/** Allocate a `Canvas2D`, preferring `OffscreenCanvas` when available. */\nexport function createCanvas(width: number, height: number): Canvas2D {\n    if (typeof OffscreenCanvas !== \"undefined\") {\n        return new OffscreenCanvas(width, height);\n    }\n    if (typeof document !== \"undefined\") {\n        const c = document.createElement(\"canvas\");\n        c.width = width;\n        c.height = height;\n        return c;\n    }\n    throw new ImageLoadError(\"No canvas implementation available in this environment.\");\n}\n\n/** Get a 2D context from a canvas, throwing a typed error if the browser refuses. */\nexport function get2DContext(canvas: Canvas2D): Context2D {\n    const ctx = canvas.getContext(\"2d\") as Context2D | null;\n    if (ctx === null) {\n        throw new ImageLoadError(\"Failed to obtain 2D rendering context.\");\n    }\n    return ctx;\n}\n\n/** Convert RGBA `ImageData` into the canonical HWC RGB `RGBImage`. */\nexport function imageDataToRGB(imageData: ImageData): RGBImage {\n    const { data, width, height } = imageData;\n    if (data.length !== width * height * 4) {\n        throw new ImageLoadError(\n            `Unexpected ImageData length ${data.length} for ${width}x${height} (expected ${\n                width * height * 4\n            }).`,\n        );\n    }\n    const rgb = new Uint8Array(width * height * 3);\n    for (let i = 0, j = 0; i < data.length; i += 4, j += 3) {\n        rgb[j] = data[i] as number;\n        rgb[j + 1] = data[i + 1] as number;\n        rgb[j + 2] = data[i + 2] as number;\n    }\n    return new RGBImage(rgb, width, height);\n}\n\n/** Convert an `RGBImage` into RGBA `ImageData` (alpha forced to 255). */\nexport function rgbToImageData(image: RGBImage): ImageData {\n    const data = new Uint8ClampedArray(image.width * image.height * 4);\n    for (let i = 0, j = 0; i < image.data.length; i += 3, j += 4) {\n        data[j] = image.data[i] as number;\n        data[j + 1] = image.data[i + 1] as number;\n        data[j + 2] = image.data[i + 2] as number;\n        data[j + 3] = 255;\n    }\n    return new ImageData(data, image.width, image.height);\n}\n"],"names":["createCanvas","width","height","c","ImageLoadError","get2DContext","canvas","ctx","imageDataToRGB","imageData","data","rgb","i","j","RGBImage","rgbToImageData","image"],"mappings":";;AAiBO,SAASA,EAAaC,GAAeC,GAA0B;AAClE,MAAI,OAAO,kBAAoB;AAC3B,WAAO,IAAI,gBAAgBD,GAAOC,CAAM;AAE5C,MAAI,OAAO,WAAa,KAAa;AACjC,UAAMC,IAAI,SAAS,cAAc,QAAQ;AACzC,WAAAA,EAAE,QAAQF,GACVE,EAAE,SAASD,GACJC;AAAA,EACX;AACA,QAAM,IAAIC,EAAe,yDAAyD;AACtF;AAGO,SAASC,EAAaC,GAA6B;AACtD,QAAMC,IAAMD,EAAO,WAAW,IAAI;AAClC,MAAIC,MAAQ;AACR,UAAM,IAAIH,EAAe,wCAAwC;AAErE,SAAOG;AACX;AAGO,SAASC,EAAeC,GAAgC;AAC3D,QAAM,EAAE,MAAAC,GAAM,OAAAT,GAAO,QAAAC,EAAA,IAAWO;AAChC,MAAIC,EAAK,WAAWT,IAAQC,IAAS;AACjC,UAAM,IAAIE;AAAA,MACN,+BAA+BM,EAAK,MAAM,QAAQT,CAAK,IAAIC,CAAM,cAC7DD,IAAQC,IAAS,CACrB;AAAA,IAAA;AAGR,QAAMS,IAAM,IAAI,WAAWV,IAAQC,IAAS,CAAC;AAC7C,WAASU,IAAI,GAAGC,IAAI,GAAGD,IAAIF,EAAK,QAAQE,KAAK,GAAGC,KAAK;AACjD,IAAAF,EAAIE,CAAC,IAAIH,EAAKE,CAAC,GACfD,EAAIE,IAAI,CAAC,IAAIH,EAAKE,IAAI,CAAC,GACvBD,EAAIE,IAAI,CAAC,IAAIH,EAAKE,IAAI,CAAC;AAE3B,SAAO,IAAIE,EAASH,GAAKV,GAAOC,CAAM;AAC1C;AAGO,SAASa,EAAeC,GAA4B;AACvD,QAAMN,IAAO,IAAI,kBAAkBM,EAAM,QAAQA,EAAM,SAAS,CAAC;AACjE,WAASJ,IAAI,GAAGC,IAAI,GAAGD,IAAII,EAAM,KAAK,QAAQJ,KAAK,GAAGC,KAAK;AACvD,IAAAH,EAAKG,CAAC,IAAIG,EAAM,KAAKJ,CAAC,GACtBF,EAAKG,IAAI,CAAC,IAAIG,EAAM,KAAKJ,IAAI,CAAC,GAC9BF,EAAKG,IAAI,CAAC,IAAIG,EAAM,KAAKJ,IAAI,CAAC,GAC9BF,EAAKG,IAAI,CAAC,IAAI;AAElB,SAAO,IAAI,UAAUH,GAAMM,EAAM,OAAOA,EAAM,MAAM;AACxD;"}

package/dist/vision/core/exceptions.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class r extends Error{constructor(o,a){super(o,a),this.name=new.target.name}}class s extends r{}class t extends r{}class n extends r{}class l extends r{}class d extends r{}exports.ImageLoadError=l;exports.InferenceError=t;exports.LabelMapError=d;exports.ModelLoadError=s;exports.OrtVisionError=r;exports.ProviderNotAvailableError=n;
+//# sourceMappingURL=exceptions.cjs.map

package/dist/vision/core/exceptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.cjs","sources":["../../../src/vision/core/exceptions.ts"],"sourcesContent":["/**\n * Exceptions raised by the SDK.\n *\n * All exceptions inherit from {@link OrtVisionError}, so callers can catch\n * the base class to handle any SDK-originated failure uniformly.\n */\n\nexport class OrtVisionError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = new.target.name;\n    }\n}\n\n/** Raised when an ONNX model cannot be loaded into an inference session. */\nexport class ModelLoadError extends OrtVisionError {}\n\n/** Raised when ONNX Runtime fails while executing a model. */\nexport class InferenceError extends OrtVisionError {}\n\n/** Raised when a requested execution provider is not available. */\nexport class ProviderNotAvailableError extends OrtVisionError {}\n\n/** Raised when an input image cannot be decoded into the canonical format. */\nexport class ImageLoadError extends OrtVisionError {}\n\n/** Raised when class labels cannot be resolved from the supplied spec. */\nexport class LabelMapError extends OrtVisionError {}\n"],"names":["OrtVisionError","message","options","ModelLoadError","InferenceError","ProviderNotAvailableError","ImageLoadError","LabelMapError"],"mappings":"gFAOO,MAAMA,UAAuB,KAAM,CACtC,YAAYC,EAAiBC,EAAwB,CACjD,MAAMD,EAASC,CAAO,EACtB,KAAK,KAAO,WAAW,IAC3B,CACJ,CAGO,MAAMC,UAAuBH,CAAe,CAAC,CAG7C,MAAMI,UAAuBJ,CAAe,CAAC,CAG7C,MAAMK,UAAkCL,CAAe,CAAC,CAGxD,MAAMM,UAAuBN,CAAe,CAAC,CAG7C,MAAMO,UAAsBP,CAAe,CAAC"}

package/dist/vision/core/exceptions.js

@@ -0,0 +1,24 @@
+class e extends Error {
+  constructor(s, a) {
+    super(s, a), this.name = new.target.name;
+  }
+}
+class o extends e {
+}
+class t extends e {
+}
+class n extends e {
+}
+class d extends e {
+}
+class l extends e {
+}
+export {
+  d as ImageLoadError,
+  t as InferenceError,
+  l as LabelMapError,
+  o as ModelLoadError,
+  e as OrtVisionError,
+  n as ProviderNotAvailableError
+};
+//# sourceMappingURL=exceptions.js.map

package/dist/vision/core/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sources":["../../../src/vision/core/exceptions.ts"],"sourcesContent":["/**\n * Exceptions raised by the SDK.\n *\n * All exceptions inherit from {@link OrtVisionError}, so callers can catch\n * the base class to handle any SDK-originated failure uniformly.\n */\n\nexport class OrtVisionError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = new.target.name;\n    }\n}\n\n/** Raised when an ONNX model cannot be loaded into an inference session. */\nexport class ModelLoadError extends OrtVisionError {}\n\n/** Raised when ONNX Runtime fails while executing a model. */\nexport class InferenceError extends OrtVisionError {}\n\n/** Raised when a requested execution provider is not available. */\nexport class ProviderNotAvailableError extends OrtVisionError {}\n\n/** Raised when an input image cannot be decoded into the canonical format. */\nexport class ImageLoadError extends OrtVisionError {}\n\n/** Raised when class labels cannot be resolved from the supplied spec. */\nexport class LabelMapError extends OrtVisionError {}\n"],"names":["OrtVisionError","message","options","ModelLoadError","InferenceError","ProviderNotAvailableError","ImageLoadError","LabelMapError"],"mappings":"AAOO,MAAMA,UAAuB,MAAM;AAAA,EACtC,YAAYC,GAAiBC,GAAwB;AACjD,UAAMD,GAASC,CAAO,GACtB,KAAK,OAAO,WAAW;AAAA,EAC3B;AACJ;AAGO,MAAMC,UAAuBH,EAAe;AAAC;AAG7C,MAAMI,UAAuBJ,EAAe;AAAC;AAG7C,MAAMK,UAAkCL,EAAe;AAAC;AAGxD,MAAMM,UAAuBN,EAAe;AAAC;AAG7C,MAAMO,UAAsBP,EAAe;AAAC;"}

package/dist/vision/core/providers.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=["webgpu","wasm"];function o(r){return r===void 0?[...e]:r.length===0?[...e]:[...r]}exports.DEFAULT_PROVIDERS=e;exports.resolveProviders=o;
+//# sourceMappingURL=providers.cjs.map

package/dist/vision/core/providers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.cjs","sources":["../../../src/vision/core/providers.ts"],"sourcesContent":["/**\n * Execution-provider defaults for ONNX Runtime Web sessions.\n *\n * Unlike Node ORT, the browser ORT cannot enumerate \"available providers\" at\n * runtime — `webgpu` either works or ORT silently falls back to the next\n * provider in the list. We just expose a sensible default order.\n */\n\n/**\n * Default execution provider preference order for browser ORT.\n *\n * `webgpu` is tried first when available; ORT-Web falls back to `wasm`\n * automatically when WebGPU is not supported by the browser or device.\n */\nexport const DEFAULT_PROVIDERS: readonly string[] = [\"webgpu\", \"wasm\"];\n\n/**\n * Resolve the execution providers to pass to `InferenceSession.create`.\n *\n * @param requested Explicit provider list in preference order; `undefined` returns the default.\n */\nexport function resolveProviders(requested?: readonly string[]): string[] {\n    if (requested === undefined) {\n        return [...DEFAULT_PROVIDERS];\n    }\n    if (requested.length === 0) {\n        return [...DEFAULT_PROVIDERS];\n    }\n    return [...requested];\n}\n"],"names":["DEFAULT_PROVIDERS","resolveProviders","requested"],"mappings":"gFAcO,MAAMA,EAAuC,CAAC,SAAU,MAAM,EAO9D,SAASC,EAAiBC,EAAyC,CACtE,OAAIA,IAAc,OACP,CAAC,GAAGF,CAAiB,EAE5BE,EAAU,SAAW,EACd,CAAC,GAAGF,CAAiB,EAEzB,CAAC,GAAGE,CAAS,CACxB"}

package/dist/vision/core/providers.js

@@ -0,0 +1,9 @@
+const n = ["webgpu", "wasm"];
+function o(r) {
+  return r === void 0 ? [...n] : r.length === 0 ? [...n] : [...r];
+}
+export {
+  n as DEFAULT_PROVIDERS,
+  o as resolveProviders
+};
+//# sourceMappingURL=providers.js.map

package/dist/vision/core/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sources":["../../../src/vision/core/providers.ts"],"sourcesContent":["/**\n * Execution-provider defaults for ONNX Runtime Web sessions.\n *\n * Unlike Node ORT, the browser ORT cannot enumerate \"available providers\" at\n * runtime — `webgpu` either works or ORT silently falls back to the next\n * provider in the list. We just expose a sensible default order.\n */\n\n/**\n * Default execution provider preference order for browser ORT.\n *\n * `webgpu` is tried first when available; ORT-Web falls back to `wasm`\n * automatically when WebGPU is not supported by the browser or device.\n */\nexport const DEFAULT_PROVIDERS: readonly string[] = [\"webgpu\", \"wasm\"];\n\n/**\n * Resolve the execution providers to pass to `InferenceSession.create`.\n *\n * @param requested Explicit provider list in preference order; `undefined` returns the default.\n */\nexport function resolveProviders(requested?: readonly string[]): string[] {\n    if (requested === undefined) {\n        return [...DEFAULT_PROVIDERS];\n    }\n    if (requested.length === 0) {\n        return [...DEFAULT_PROVIDERS];\n    }\n    return [...requested];\n}\n"],"names":["DEFAULT_PROVIDERS","resolveProviders","requested"],"mappings":"AAcO,MAAMA,IAAuC,CAAC,UAAU,MAAM;AAO9D,SAASC,EAAiBC,GAAyC;AACtE,SAAIA,MAAc,SACP,CAAC,GAAGF,CAAiB,IAE5BE,EAAU,WAAW,IACd,CAAC,GAAGF,CAAiB,IAEzB,CAAC,GAAGE,CAAS;AACxB;"}

package/dist/vision/core/session.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("onnxruntime-web"),o=require("./exceptions.cjs"),p=require("./providers.cjs");function l(s){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const t in s)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(s,t);Object.defineProperty(e,t,r.get?r:{enumerable:!0,get:()=>s[t]})}}return e.default=s,Object.freeze(e)}const a=l(f);class c{constructor(e,t){this._session=e,this.providers=t}_session;providers;static async create(e,t={}){const r=p.resolveProviders(t.providers),i={...t.sessionOptions??{},executionProviders:r};let n;try{typeof e=="string"?n=await a.InferenceSession.create(e,i):e instanceof Uint8Array?n=await a.InferenceSession.create(e,i):n=await a.InferenceSession.create(e,i)}catch(u){throw new o.ModelLoadError(`Failed to load ONNX model: ${u.message}`,{cause:u})}return new c(n,r)}get inputNames(){return this._session.inputNames}get inputName(){const e=this._session.inputNames[0];if(e===void 0)throw new o.InferenceError("Model has no inputs.");return e}get outputNames(){return this._session.outputNames}get raw(){return this._session}async run(e){try{return await this._session.run(e)}catch(t){throw new o.InferenceError(`Inference failed: ${t.message}`,{cause:t})}}}exports.OrtSession=c;
+//# sourceMappingURL=session.cjs.map

package/dist/vision/core/session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.cjs","sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names, manages execution-provider\n * selection, and provides a typed {@link OrtSession.run} method.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list and pass-through `SessionOptions`.\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof model === \"string\") {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else if (model instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    model as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"names":["OrtSession","_session","providers","model","options","resolveProviders","sessionOptions","session","ortRuntime","err","ModelLoadError","name","InferenceError","feeds"],"mappings":"wcA0BO,MAAMA,CAAW,CACZ,YACaC,EACDC,EAClB,CAFmB,KAAA,SAAAD,EACD,KAAA,UAAAC,CACjB,CAFkB,SACD,UAUpB,aAAa,OAAOC,EAAoBC,EAA6B,GAAyB,CAC1F,MAAMF,EAAYG,EAAAA,iBAAiBD,EAAQ,SAAS,EAC9CE,EAAsD,CACxD,GAAIF,EAAQ,gBAAkB,CAAA,EAC9B,mBACIF,CAAA,EAGR,IAAIK,EACJ,GAAI,CACI,OAAOJ,GAAU,SACjBI,EAAU,MAAMC,EAAW,iBAAiB,OAAOL,EAAOG,CAAc,EACjEH,aAAiB,WACxBI,EAAU,MAAMC,EAAW,iBAAiB,OAAOL,EAAOG,CAAc,EAExEC,EAAU,MAAMC,EAAW,iBAAiB,OACxCL,EACAG,CAAA,CAGZ,OAASG,EAAK,CACV,MAAM,IAAIC,EAAAA,eAAe,8BAA+BD,EAAc,OAAO,GAAI,CAC7E,MAAOA,CAAA,CACV,CACL,CAEA,OAAO,IAAIT,EAAWO,EAASL,CAAS,CAC5C,CAGA,IAAI,YAAgC,CAChC,OAAO,KAAK,SAAS,UACzB,CAGA,IAAI,WAAoB,CACpB,MAAMS,EAAO,KAAK,SAAS,WAAW,CAAC,EACvC,GAAIA,IAAS,OACT,MAAM,IAAIC,EAAAA,eAAe,sBAAsB,EAEnD,OAAOD,CACX,CAGA,IAAI,aAAiC,CACjC,OAAO,KAAK,SAAS,WACzB,CAGA,IAAI,KAA4B,CAC5B,OAAO,KAAK,QAChB,CAQA,MAAM,IAAIE,EAAwE,CAC9E,GAAI,CAEA,OADe,MAAM,KAAK,SAAS,IAAIA,CAAK,CAEhD,OAASJ,EAAK,CACV,MAAM,IAAIG,EAAAA,eAAe,qBAAsBH,EAAc,OAAO,GAAI,CAAE,MAAOA,EAAK,CAC1F,CACJ,CACJ"}

package/dist/vision/core/session.js

@@ -0,0 +1,71 @@
+import * as n from "onnxruntime-web";
+import { ModelLoadError as u, InferenceError as a } from "./exceptions.js";
+import { resolveProviders as p } from "./providers.js";
+class c {
+  constructor(e, s) {
+    this._session = e, this.providers = s;
+  }
+  _session;
+  providers;
+  /**
+   * Load an ONNX model into an ORT inference session.
+   *
+   * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.
+   * @param options Provider list and pass-through `SessionOptions`.
+   * @throws {@link ModelLoadError} if the model cannot be loaded.
+   */
+  static async create(e, s = {}) {
+    const i = p(s.providers), t = {
+      ...s.sessionOptions ?? {},
+      executionProviders: i
+    };
+    let r;
+    try {
+      typeof e == "string" ? r = await n.InferenceSession.create(e, t) : e instanceof Uint8Array ? r = await n.InferenceSession.create(e, t) : r = await n.InferenceSession.create(
+        e,
+        t
+      );
+    } catch (o) {
+      throw new u(`Failed to load ONNX model: ${o.message}`, {
+        cause: o
+      });
+    }
+    return new c(r, i);
+  }
+  /** Names of the model's inputs, in declaration order. */
+  get inputNames() {
+    return this._session.inputNames;
+  }
+  /** Name of the first (and usually only) input. */
+  get inputName() {
+    const e = this._session.inputNames[0];
+    if (e === void 0)
+      throw new a("Model has no inputs.");
+    return e;
+  }
+  /** Names of the model's outputs, in declaration order. */
+  get outputNames() {
+    return this._session.outputNames;
+  }
+  /** The underlying `onnxruntime-web` session, for advanced use cases. */
+  get raw() {
+    return this._session;
+  }
+  /**
+   * Run inference and return all outputs.
+   *
+   * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.
+   * @throws {@link InferenceError} if ORT raises any error during execution.
+   */
+  async run(e) {
+    try {
+      return await this._session.run(e);
+    } catch (s) {
+      throw new a(`Inference failed: ${s.message}`, { cause: s });
+    }
+  }
+}
+export {
+  c as OrtSession
+};
+//# sourceMappingURL=session.js.map

package/dist/vision/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names, manages execution-provider\n * selection, and provides a typed {@link OrtSession.run} method.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list and pass-through `SessionOptions`.\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof model === \"string\") {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else if (model instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    model as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"names":["OrtSession","_session","providers","model","options","resolveProviders","sessionOptions","session","ortRuntime","err","ModelLoadError","name","InferenceError","feeds"],"mappings":";;;AA0BO,MAAMA,EAAW;AAAA,EACZ,YACaC,GACDC,GAClB;AAFmB,SAAA,WAAAD,GACD,KAAA,YAAAC;AAAA,EACjB;AAAA,EAFkB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUpB,aAAa,OAAOC,GAAoBC,IAA6B,IAAyB;AAC1F,UAAMF,IAAYG,EAAiBD,EAAQ,SAAS,GAC9CE,IAAsD;AAAA,MACxD,GAAIF,EAAQ,kBAAkB,CAAA;AAAA,MAC9B,oBACIF;AAAA,IAAA;AAGR,QAAIK;AACJ,QAAI;AACA,MAAI,OAAOJ,KAAU,WACjBI,IAAU,MAAMC,EAAW,iBAAiB,OAAOL,GAAOG,CAAc,IACjEH,aAAiB,aACxBI,IAAU,MAAMC,EAAW,iBAAiB,OAAOL,GAAOG,CAAc,IAExEC,IAAU,MAAMC,EAAW,iBAAiB;AAAA,QACxCL;AAAA,QACAG;AAAA,MAAA;AAAA,IAGZ,SAASG,GAAK;AACV,YAAM,IAAIC,EAAe,8BAA+BD,EAAc,OAAO,IAAI;AAAA,QAC7E,OAAOA;AAAA,MAAA,CACV;AAAA,IACL;AAEA,WAAO,IAAIT,EAAWO,GAASL,CAAS;AAAA,EAC5C;AAAA;AAAA,EAGA,IAAI,aAAgC;AAChC,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,YAAoB;AACpB,UAAMS,IAAO,KAAK,SAAS,WAAW,CAAC;AACvC,QAAIA,MAAS;AACT,YAAM,IAAIC,EAAe,sBAAsB;AAEnD,WAAOD;AAAA,EACX;AAAA;AAAA,EAGA,IAAI,cAAiC;AACjC,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,MAA4B;AAC5B,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAIE,GAAwE;AAC9E,QAAI;AAEA,aADe,MAAM,KAAK,SAAS,IAAIA,CAAK;AAAA,IAEhD,SAASJ,GAAK;AACV,YAAM,IAAIG,EAAe,qBAAsBH,EAAc,OAAO,IAAI,EAAE,OAAOA,GAAK;AAAA,IAC1F;AAAA,EACJ;AACJ;"}

package/dist/vision/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="0.2.1";exports.VERSION=e;
+//# sourceMappingURL=index.cjs.map

package/dist/vision/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/vision/index.ts"],"sourcesContent":["/**\n * `tempest-react-sdk/vision` — browser computer-vision inference with ONNX\n * Runtime Web (classification, detection, segmentation).\n *\n * Vendored from `@mauriciobenjamin700/ort-vision-sdk-web@0.2.1` (MIT, same\n * author) so it ships inside this SDK without an extra package install.\n * `onnxruntime-web` stays an optional peer dependency — install it (and ship\n * the matching `.wasm` files) only when you use this subpath.\n *\n * Do not hand-edit — regenerate with `npm run vendor:vision`.\n */\n\nexport {\n    BoundingBox,\n    Mask,\n    RGBImage,\n    type ClassProbability,\n    type ClassificationResult,\n    type DetectionResult,\n    type SegmentationResult,\n} from \"./types\";\n\nexport {\n    Boxes,\n    ClassificationResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport { COCO_CLASSES, type LabelSpec, type ResolveLabelsOptions, resolveLabels } from \"./labels\";\n\nexport {\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport { type ModelSource, type OrtSessionOptions, OrtSession } from \"./core/session\";\nexport { DEFAULT_PROVIDERS, resolveProviders } from \"./core/providers\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    type LetterboxResult,\n    fromCv2,\n    letterbox,\n    normalize,\n    resize,\n    toCHW,\n    toCv2,\n    toFloat32,\n    toFloat32Tensor,\n    toTensor,\n} from \"./preprocess/image\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodeYoloV8AnchorsOptions,\n    type DecodeYoloV8Options,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    decodeYoloV8,\n    decodeYoloV8Anchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodeYoloV8SegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n    decodeYoloV8Seg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectorHead,\n    type DetectorOptions,\n    type DetectorPredictOptions,\n    Detector,\n} from \"./tasks/detector\";\nexport {\n    type SegmenterHead,\n    type SegmenterOptions,\n    type SegmenterPredictOptions,\n    Segmenter,\n} from \"./tasks/segmenter\";\n\nexport const VERSION: string = \"0.2.1\";\n"],"names":["VERSION"],"mappings":"gFAwGO,MAAMA,EAAkB"}

package/dist/vision/index.js

@@ -0,0 +1,5 @@
+const o = "0.2.1";
+export {
+  o as VERSION
+};
+//# sourceMappingURL=index.js.map

package/dist/vision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/vision/index.ts"],"sourcesContent":["/**\n * `tempest-react-sdk/vision` — browser computer-vision inference with ONNX\n * Runtime Web (classification, detection, segmentation).\n *\n * Vendored from `@mauriciobenjamin700/ort-vision-sdk-web@0.2.1` (MIT, same\n * author) so it ships inside this SDK without an extra package install.\n * `onnxruntime-web` stays an optional peer dependency — install it (and ship\n * the matching `.wasm` files) only when you use this subpath.\n *\n * Do not hand-edit — regenerate with `npm run vendor:vision`.\n */\n\nexport {\n    BoundingBox,\n    Mask,\n    RGBImage,\n    type ClassProbability,\n    type ClassificationResult,\n    type DetectionResult,\n    type SegmentationResult,\n} from \"./types\";\n\nexport {\n    Boxes,\n    ClassificationResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport { COCO_CLASSES, type LabelSpec, type ResolveLabelsOptions, resolveLabels } from \"./labels\";\n\nexport {\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport { type ModelSource, type OrtSessionOptions, OrtSession } from \"./core/session\";\nexport { DEFAULT_PROVIDERS, resolveProviders } from \"./core/providers\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    type LetterboxResult,\n    fromCv2,\n    letterbox,\n    normalize,\n    resize,\n    toCHW,\n    toCv2,\n    toFloat32,\n    toFloat32Tensor,\n    toTensor,\n} from \"./preprocess/image\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodeYoloV8AnchorsOptions,\n    type DecodeYoloV8Options,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    decodeYoloV8,\n    decodeYoloV8Anchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodeYoloV8SegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n    decodeYoloV8Seg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectorHead,\n    type DetectorOptions,\n    type DetectorPredictOptions,\n    Detector,\n} from \"./tasks/detector\";\nexport {\n    type SegmenterHead,\n    type SegmenterOptions,\n    type SegmenterPredictOptions,\n    Segmenter,\n} from \"./tasks/segmenter\";\n\nexport const VERSION: string = \"0.2.1\";\n"],"names":["VERSION"],"mappings":"AAwGO,MAAMA,IAAkB;"}

package/dist/vision/io/image.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("../core/canvas.cjs"),r=require("../core/exceptions.cjs"),l=require("../types.cjs");async function g(e){if(e instanceof l.RGBImage)return e;if(typeof ImageData<"u"&&e instanceof ImageData)return f.imageDataToRGB(e);if(typeof e=="string")return s(e);if(typeof Blob<"u"&&e instanceof Blob)return m(e);if(typeof HTMLImageElement<"u"&&e instanceof HTMLImageElement)return await c(e),i(e,e.naturalWidth,e.naturalHeight);if(typeof HTMLCanvasElement<"u"&&e instanceof HTMLCanvasElement||typeof OffscreenCanvas<"u"&&e instanceof OffscreenCanvas||typeof ImageBitmap<"u"&&e instanceof ImageBitmap)return i(e,e.width,e.height);throw new r.ImageLoadError(`Unsupported image source type: ${Object.prototype.toString.call(e)}`)}async function s(e){let t;try{t=await fetch(e)}catch(n){throw new r.ImageLoadError(`Failed to fetch image from ${e}: ${n.message}`,{cause:n})}if(!t.ok)throw new r.ImageLoadError(`Failed to fetch image from ${e}: HTTP ${t.status} ${t.statusText}`);const a=await t.blob();return m(a)}async function m(e){let t;try{t=await createImageBitmap(e)}catch(a){throw new r.ImageLoadError(`Failed to decode image blob: ${a.message}`,{cause:a})}try{return i(t,t.width,t.height)}finally{t.close()}}function c(e){return e.complete&&e.naturalWidth>0?Promise.resolve():new Promise((t,a)=>{const n=()=>{d(),t()},o=()=>{d(),a(new r.ImageLoadError("Failed to load HTMLImageElement (load event errored)"))},d=()=>{e.removeEventListener("load",n),e.removeEventListener("error",o)};e.addEventListener("load",n,{once:!0}),e.addEventListener("error",o,{once:!0})})}function i(e,t,a){if(t===0||a===0)throw new r.ImageLoadError(`Cannot load image with zero dimension (${t}x${a}).`);const n=f.createCanvas(t,a),o=f.get2DContext(n);o.drawImage(e,0,0);const d=o.getImageData(0,0,t,a);return f.imageDataToRGB(d)}exports.loadImage=g;
+//# sourceMappingURL=image.cjs.map

package/dist/vision/io/image.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.cjs","sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/**\n * Image loading utilities — convert any supported source into the canonical\n * {@link RGBImage} format.\n *\n * Browser-only: uses `fetch`, `createImageBitmap`, and a Canvas 2D context to\n * decode arbitrary inputs into a tightly-packed `Uint8Array` of HWC RGB pixels.\n */\n\nimport { createCanvas, get2DContext, imageDataToRGB } from \"../core/canvas\";\nimport { ImageLoadError } from \"../core/exceptions\";\nimport { RGBImage } from \"../types\";\n\n/** Anything {@link loadImage} accepts as an image input. */\nexport type ImageInput =\n    | string\n    | Blob\n    | HTMLImageElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | ImageData\n    | RGBImage;\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * @throws {@link ImageLoadError} if the source cannot be decoded or has an unsupported shape.\n */\nexport async function loadImage(source: ImageInput): Promise<RGBImage> {\n    if (source instanceof RGBImage) {\n        return source;\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return imageDataToRGB(source);\n    }\n\n    if (typeof source === \"string\") {\n        return loadFromUrl(source);\n    }\n\n    if (typeof Blob !== \"undefined\" && source instanceof Blob) {\n        return loadFromBlob(source);\n    }\n\n    if (typeof HTMLImageElement !== \"undefined\" && source instanceof HTMLImageElement) {\n        await waitForImageElement(source);\n        return drawableToRGB(source, source.naturalWidth, source.naturalHeight);\n    }\n\n    if (typeof HTMLCanvasElement !== \"undefined\" && source instanceof HTMLCanvasElement) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    if (typeof OffscreenCanvas !== \"undefined\" && source instanceof OffscreenCanvas) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    if (typeof ImageBitmap !== \"undefined\" && source instanceof ImageBitmap) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    throw new ImageLoadError(\n        `Unsupported image source type: ${Object.prototype.toString.call(source)}`,\n    );\n}\n\nasync function loadFromUrl(url: string): Promise<RGBImage> {\n    let response: Response;\n    try {\n        response = await fetch(url);\n    } catch (err) {\n        throw new ImageLoadError(`Failed to fetch image from ${url}: ${(err as Error).message}`, {\n            cause: err,\n        });\n    }\n    if (!response.ok) {\n        throw new ImageLoadError(\n            `Failed to fetch image from ${url}: HTTP ${response.status} ${response.statusText}`,\n        );\n    }\n    const blob = await response.blob();\n    return loadFromBlob(blob);\n}\n\nasync function loadFromBlob(blob: Blob): Promise<RGBImage> {\n    let bitmap: ImageBitmap;\n    try {\n        bitmap = await createImageBitmap(blob);\n    } catch (err) {\n        throw new ImageLoadError(`Failed to decode image blob: ${(err as Error).message}`, {\n            cause: err,\n        });\n    }\n    try {\n        return drawableToRGB(bitmap, bitmap.width, bitmap.height);\n    } finally {\n        bitmap.close();\n    }\n}\n\nfunction waitForImageElement(img: HTMLImageElement): Promise<void> {\n    if (img.complete && img.naturalWidth > 0) {\n        return Promise.resolve();\n    }\n    return new Promise<void>((resolve, reject) => {\n        const onLoad = (): void => {\n            cleanup();\n            resolve();\n        };\n        const onError = (): void => {\n            cleanup();\n            reject(new ImageLoadError(\"Failed to load HTMLImageElement (load event errored)\"));\n        };\n        const cleanup = (): void => {\n            img.removeEventListener(\"load\", onLoad);\n            img.removeEventListener(\"error\", onError);\n        };\n        img.addEventListener(\"load\", onLoad, { once: true });\n        img.addEventListener(\"error\", onError, { once: true });\n    });\n}\n\nfunction drawableToRGB(drawable: CanvasImageSource, width: number, height: number): RGBImage {\n    if (width === 0 || height === 0) {\n        throw new ImageLoadError(`Cannot load image with zero dimension (${width}x${height}).`);\n    }\n    const canvas = createCanvas(width, height);\n    const ctx = get2DContext(canvas);\n    ctx.drawImage(drawable, 0, 0);\n    const imageData = ctx.getImageData(0, 0, width, height);\n    return imageDataToRGB(imageData);\n}\n"],"names":["loadImage","source","RGBImage","imageDataToRGB","loadFromUrl","loadFromBlob","waitForImageElement","drawableToRGB","ImageLoadError","url","response","err","blob","bitmap","img","resolve","reject","onLoad","cleanup","onError","drawable","width","height","canvas","createCanvas","ctx","get2DContext","imageData"],"mappings":"oLA4BA,eAAsBA,EAAUC,EAAuC,CACnE,GAAIA,aAAkBC,EAAAA,SAClB,OAAOD,EAGX,GAAI,OAAO,UAAc,KAAeA,aAAkB,UACtD,OAAOE,EAAAA,eAAeF,CAAM,EAGhC,GAAI,OAAOA,GAAW,SAClB,OAAOG,EAAYH,CAAM,EAG7B,GAAI,OAAO,KAAS,KAAeA,aAAkB,KACjD,OAAOI,EAAaJ,CAAM,EAG9B,GAAI,OAAO,iBAAqB,KAAeA,aAAkB,iBAC7D,aAAMK,EAAoBL,CAAM,EACzBM,EAAcN,EAAQA,EAAO,aAAcA,EAAO,aAAa,EAW1E,GARI,OAAO,kBAAsB,KAAeA,aAAkB,mBAI9D,OAAO,gBAAoB,KAAeA,aAAkB,iBAI5D,OAAO,YAAgB,KAAeA,aAAkB,YACxD,OAAOM,EAAcN,EAAQA,EAAO,MAAOA,EAAO,MAAM,EAG5D,MAAM,IAAIO,EAAAA,eACN,kCAAkC,OAAO,UAAU,SAAS,KAAKP,CAAM,CAAC,EAAA,CAEhF,CAEA,eAAeG,EAAYK,EAAgC,CACvD,IAAIC,EACJ,GAAI,CACAA,EAAW,MAAM,MAAMD,CAAG,CAC9B,OAASE,EAAK,CACV,MAAM,IAAIH,EAAAA,eAAe,8BAA8BC,CAAG,KAAME,EAAc,OAAO,GAAI,CACrF,MAAOA,CAAA,CACV,CACL,CACA,GAAI,CAACD,EAAS,GACV,MAAM,IAAIF,EAAAA,eACN,8BAA8BC,CAAG,UAAUC,EAAS,MAAM,IAAIA,EAAS,UAAU,EAAA,EAGzF,MAAME,EAAO,MAAMF,EAAS,KAAA,EAC5B,OAAOL,EAAaO,CAAI,CAC5B,CAEA,eAAeP,EAAaO,EAA+B,CACvD,IAAIC,EACJ,GAAI,CACAA,EAAS,MAAM,kBAAkBD,CAAI,CACzC,OAASD,EAAK,CACV,MAAM,IAAIH,EAAAA,eAAe,gCAAiCG,EAAc,OAAO,GAAI,CAC/E,MAAOA,CAAA,CACV,CACL,CACA,GAAI,CACA,OAAOJ,EAAcM,EAAQA,EAAO,MAAOA,EAAO,MAAM,CAC5D,QAAA,CACIA,EAAO,MAAA,CACX,CACJ,CAEA,SAASP,EAAoBQ,EAAsC,CAC/D,OAAIA,EAAI,UAAYA,EAAI,aAAe,EAC5B,QAAQ,QAAA,EAEZ,IAAI,QAAc,CAACC,EAASC,IAAW,CAC1C,MAAMC,EAAS,IAAY,CACvBC,EAAA,EACAH,EAAA,CACJ,EACMI,EAAU,IAAY,CACxBD,EAAA,EACAF,EAAO,IAAIR,iBAAe,sDAAsD,CAAC,CACrF,EACMU,EAAU,IAAY,CACxBJ,EAAI,oBAAoB,OAAQG,CAAM,EACtCH,EAAI,oBAAoB,QAASK,CAAO,CAC5C,EACAL,EAAI,iBAAiB,OAAQG,EAAQ,CAAE,KAAM,GAAM,EACnDH,EAAI,iBAAiB,QAASK,EAAS,CAAE,KAAM,GAAM,CACzD,CAAC,CACL,CAEA,SAASZ,EAAca,EAA6BC,EAAeC,EAA0B,CACzF,GAAID,IAAU,GAAKC,IAAW,EAC1B,MAAM,IAAId,EAAAA,eAAe,0CAA0Ca,CAAK,IAAIC,CAAM,IAAI,EAE1F,MAAMC,EAASC,EAAAA,aAAaH,EAAOC,CAAM,EACnCG,EAAMC,EAAAA,aAAaH,CAAM,EAC/BE,EAAI,UAAUL,EAAU,EAAG,CAAC,EAC5B,MAAMO,EAAYF,EAAI,aAAa,EAAG,EAAGJ,EAAOC,CAAM,EACtD,OAAOnB,EAAAA,eAAewB,CAAS,CACnC"}

package/dist/vision/io/image.js

@@ -0,0 +1,75 @@
+import { imageDataToRGB as m, createCanvas as l, get2DContext as g } from "../core/canvas.js";
+import { ImageLoadError as o } from "../core/exceptions.js";
+import { RGBImage as s } from "../types.js";
+async function v(e) {
+  if (e instanceof s)
+    return e;
+  if (typeof ImageData < "u" && e instanceof ImageData)
+    return m(e);
+  if (typeof e == "string")
+    return p(e);
+  if (typeof Blob < "u" && e instanceof Blob)
+    return d(e);
+  if (typeof HTMLImageElement < "u" && e instanceof HTMLImageElement)
+    return await c(e), i(e, e.naturalWidth, e.naturalHeight);
+  if (typeof HTMLCanvasElement < "u" && e instanceof HTMLCanvasElement || typeof OffscreenCanvas < "u" && e instanceof OffscreenCanvas || typeof ImageBitmap < "u" && e instanceof ImageBitmap)
+    return i(e, e.width, e.height);
+  throw new o(
+    `Unsupported image source type: ${Object.prototype.toString.call(e)}`
+  );
+}
+async function p(e) {
+  let t;
+  try {
+    t = await fetch(e);
+  } catch (a) {
+    throw new o(`Failed to fetch image from ${e}: ${a.message}`, {
+      cause: a
+    });
+  }
+  if (!t.ok)
+    throw new o(
+      `Failed to fetch image from ${e}: HTTP ${t.status} ${t.statusText}`
+    );
+  const n = await t.blob();
+  return d(n);
+}
+async function d(e) {
+  let t;
+  try {
+    t = await createImageBitmap(e);
+  } catch (n) {
+    throw new o(`Failed to decode image blob: ${n.message}`, {
+      cause: n
+    });
+  }
+  try {
+    return i(t, t.width, t.height);
+  } finally {
+    t.close();
+  }
+}
+function c(e) {
+  return e.complete && e.naturalWidth > 0 ? Promise.resolve() : new Promise((t, n) => {
+    const a = () => {
+      f(), t();
+    }, r = () => {
+      f(), n(new o("Failed to load HTMLImageElement (load event errored)"));
+    }, f = () => {
+      e.removeEventListener("load", a), e.removeEventListener("error", r);
+    };
+    e.addEventListener("load", a, { once: !0 }), e.addEventListener("error", r, { once: !0 });
+  });
+}
+function i(e, t, n) {
+  if (t === 0 || n === 0)
+    throw new o(`Cannot load image with zero dimension (${t}x${n}).`);
+  const a = l(t, n), r = g(a);
+  r.drawImage(e, 0, 0);
+  const f = r.getImageData(0, 0, t, n);
+  return m(f);
+}
+export {
+  v as loadImage
+};
+//# sourceMappingURL=image.js.map

package/dist/vision/io/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/**\n * Image loading utilities — convert any supported source into the canonical\n * {@link RGBImage} format.\n *\n * Browser-only: uses `fetch`, `createImageBitmap`, and a Canvas 2D context to\n * decode arbitrary inputs into a tightly-packed `Uint8Array` of HWC RGB pixels.\n */\n\nimport { createCanvas, get2DContext, imageDataToRGB } from \"../core/canvas\";\nimport { ImageLoadError } from \"../core/exceptions\";\nimport { RGBImage } from \"../types\";\n\n/** Anything {@link loadImage} accepts as an image input. */\nexport type ImageInput =\n    | string\n    | Blob\n    | HTMLImageElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | ImageData\n    | RGBImage;\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * @throws {@link ImageLoadError} if the source cannot be decoded or has an unsupported shape.\n */\nexport async function loadImage(source: ImageInput): Promise<RGBImage> {\n    if (source instanceof RGBImage) {\n        return source;\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return imageDataToRGB(source);\n    }\n\n    if (typeof source === \"string\") {\n        return loadFromUrl(source);\n    }\n\n    if (typeof Blob !== \"undefined\" && source instanceof Blob) {\n        return loadFromBlob(source);\n    }\n\n    if (typeof HTMLImageElement !== \"undefined\" && source instanceof HTMLImageElement) {\n        await waitForImageElement(source);\n        return drawableToRGB(source, source.naturalWidth, source.naturalHeight);\n    }\n\n    if (typeof HTMLCanvasElement !== \"undefined\" && source instanceof HTMLCanvasElement) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    if (typeof OffscreenCanvas !== \"undefined\" && source instanceof OffscreenCanvas) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    if (typeof ImageBitmap !== \"undefined\" && source instanceof ImageBitmap) {\n        return drawableToRGB(source, source.width, source.height);\n    }\n\n    throw new ImageLoadError(\n        `Unsupported image source type: ${Object.prototype.toString.call(source)}`,\n    );\n}\n\nasync function loadFromUrl(url: string): Promise<RGBImage> {\n    let response: Response;\n    try {\n        response = await fetch(url);\n    } catch (err) {\n        throw new ImageLoadError(`Failed to fetch image from ${url}: ${(err as Error).message}`, {\n            cause: err,\n        });\n    }\n    if (!response.ok) {\n        throw new ImageLoadError(\n            `Failed to fetch image from ${url}: HTTP ${response.status} ${response.statusText}`,\n        );\n    }\n    const blob = await response.blob();\n    return loadFromBlob(blob);\n}\n\nasync function loadFromBlob(blob: Blob): Promise<RGBImage> {\n    let bitmap: ImageBitmap;\n    try {\n        bitmap = await createImageBitmap(blob);\n    } catch (err) {\n        throw new ImageLoadError(`Failed to decode image blob: ${(err as Error).message}`, {\n            cause: err,\n        });\n    }\n    try {\n        return drawableToRGB(bitmap, bitmap.width, bitmap.height);\n    } finally {\n        bitmap.close();\n    }\n}\n\nfunction waitForImageElement(img: HTMLImageElement): Promise<void> {\n    if (img.complete && img.naturalWidth > 0) {\n        return Promise.resolve();\n    }\n    return new Promise<void>((resolve, reject) => {\n        const onLoad = (): void => {\n            cleanup();\n            resolve();\n        };\n        const onError = (): void => {\n            cleanup();\n            reject(new ImageLoadError(\"Failed to load HTMLImageElement (load event errored)\"));\n        };\n        const cleanup = (): void => {\n            img.removeEventListener(\"load\", onLoad);\n            img.removeEventListener(\"error\", onError);\n        };\n        img.addEventListener(\"load\", onLoad, { once: true });\n        img.addEventListener(\"error\", onError, { once: true });\n    });\n}\n\nfunction drawableToRGB(drawable: CanvasImageSource, width: number, height: number): RGBImage {\n    if (width === 0 || height === 0) {\n        throw new ImageLoadError(`Cannot load image with zero dimension (${width}x${height}).`);\n    }\n    const canvas = createCanvas(width, height);\n    const ctx = get2DContext(canvas);\n    ctx.drawImage(drawable, 0, 0);\n    const imageData = ctx.getImageData(0, 0, width, height);\n    return imageDataToRGB(imageData);\n}\n"],"names":["loadImage","source","RGBImage","imageDataToRGB","loadFromUrl","loadFromBlob","waitForImageElement","drawableToRGB","ImageLoadError","url","response","err","blob","bitmap","img","resolve","reject","onLoad","cleanup","onError","drawable","width","height","canvas","createCanvas","ctx","get2DContext","imageData"],"mappings":";;;AA4BA,eAAsBA,EAAUC,GAAuC;AACnE,MAAIA,aAAkBC;AAClB,WAAOD;AAGX,MAAI,OAAO,YAAc,OAAeA,aAAkB;AACtD,WAAOE,EAAeF,CAAM;AAGhC,MAAI,OAAOA,KAAW;AAClB,WAAOG,EAAYH,CAAM;AAG7B,MAAI,OAAO,OAAS,OAAeA,aAAkB;AACjD,WAAOI,EAAaJ,CAAM;AAG9B,MAAI,OAAO,mBAAqB,OAAeA,aAAkB;AAC7D,iBAAMK,EAAoBL,CAAM,GACzBM,EAAcN,GAAQA,EAAO,cAAcA,EAAO,aAAa;AAW1E,MARI,OAAO,oBAAsB,OAAeA,aAAkB,qBAI9D,OAAO,kBAAoB,OAAeA,aAAkB,mBAI5D,OAAO,cAAgB,OAAeA,aAAkB;AACxD,WAAOM,EAAcN,GAAQA,EAAO,OAAOA,EAAO,MAAM;AAG5D,QAAM,IAAIO;AAAA,IACN,kCAAkC,OAAO,UAAU,SAAS,KAAKP,CAAM,CAAC;AAAA,EAAA;AAEhF;AAEA,eAAeG,EAAYK,GAAgC;AACvD,MAAIC;AACJ,MAAI;AACA,IAAAA,IAAW,MAAM,MAAMD,CAAG;AAAA,EAC9B,SAASE,GAAK;AACV,UAAM,IAAIH,EAAe,8BAA8BC,CAAG,KAAME,EAAc,OAAO,IAAI;AAAA,MACrF,OAAOA;AAAA,IAAA,CACV;AAAA,EACL;AACA,MAAI,CAACD,EAAS;AACV,UAAM,IAAIF;AAAA,MACN,8BAA8BC,CAAG,UAAUC,EAAS,MAAM,IAAIA,EAAS,UAAU;AAAA,IAAA;AAGzF,QAAME,IAAO,MAAMF,EAAS,KAAA;AAC5B,SAAOL,EAAaO,CAAI;AAC5B;AAEA,eAAeP,EAAaO,GAA+B;AACvD,MAAIC;AACJ,MAAI;AACA,IAAAA,IAAS,MAAM,kBAAkBD,CAAI;AAAA,EACzC,SAASD,GAAK;AACV,UAAM,IAAIH,EAAe,gCAAiCG,EAAc,OAAO,IAAI;AAAA,MAC/E,OAAOA;AAAA,IAAA,CACV;AAAA,EACL;AACA,MAAI;AACA,WAAOJ,EAAcM,GAAQA,EAAO,OAAOA,EAAO,MAAM;AAAA,EAC5D,UAAA;AACI,IAAAA,EAAO,MAAA;AAAA,EACX;AACJ;AAEA,SAASP,EAAoBQ,GAAsC;AAC/D,SAAIA,EAAI,YAAYA,EAAI,eAAe,IAC5B,QAAQ,QAAA,IAEZ,IAAI,QAAc,CAACC,GAASC,MAAW;AAC1C,UAAMC,IAAS,MAAY;AACvB,MAAAC,EAAA,GACAH,EAAA;AAAA,IACJ,GACMI,IAAU,MAAY;AACxB,MAAAD,EAAA,GACAF,EAAO,IAAIR,EAAe,sDAAsD,CAAC;AAAA,IACrF,GACMU,IAAU,MAAY;AACxB,MAAAJ,EAAI,oBAAoB,QAAQG,CAAM,GACtCH,EAAI,oBAAoB,SAASK,CAAO;AAAA,IAC5C;AACA,IAAAL,EAAI,iBAAiB,QAAQG,GAAQ,EAAE,MAAM,IAAM,GACnDH,EAAI,iBAAiB,SAASK,GAAS,EAAE,MAAM,IAAM;AAAA,EACzD,CAAC;AACL;AAEA,SAASZ,EAAca,GAA6BC,GAAeC,GAA0B;AACzF,MAAID,MAAU,KAAKC,MAAW;AAC1B,UAAM,IAAId,EAAe,0CAA0Ca,CAAK,IAAIC,CAAM,IAAI;AAE1F,QAAMC,IAASC,EAAaH,GAAOC,CAAM,GACnCG,IAAMC,EAAaH,CAAM;AAC/B,EAAAE,EAAI,UAAUL,GAAU,GAAG,CAAC;AAC5B,QAAMO,IAAYF,EAAI,aAAa,GAAG,GAAGJ,GAAOC,CAAM;AACtD,SAAOnB,EAAewB,CAAS;AACnC;"}

package/dist/vision/labels.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./core/exceptions.cjs"),i=Object.freeze(["person","bicycle","car","motorcycle","airplane","bus","train","truck","boat","traffic light","fire hydrant","stop sign","parking meter","bench","bird","cat","dog","horse","sheep","cow","elephant","bear","zebra","giraffe","backpack","umbrella","handbag","tie","suitcase","frisbee","skis","snowboard","sports ball","kite","baseball bat","baseball glove","skateboard","surfboard","tennis racket","bottle","wine glass","cup","fork","knife","spoon","bowl","banana","apple","sandwich","orange","broccoli","carrot","hot dog","pizza","donut","cake","chair","couch","potted plant","bed","dining table","toilet","tv","laptop","mouse","remote","keyboard","cell phone","microwave","oven","toaster","sink","refrigerator","book","clock","vase","scissors","teddy bear","hair drier","toothbrush"]),l={coco:i};function c(e,a={}){const r=u(e,a.numClasses);if(a.numClasses!==void 0&&r.length!==a.numClasses)throw new o.LabelMapError(`Resolved ${r.length} labels but the model has ${a.numClasses} classes.`);return r}function u(e,a){if(e==null){if(a===void 0)throw new o.LabelMapError("Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.");return Array.from({length:a},(r,t)=>`class_${t}`)}if(Array.isArray(e))return[...e];if(typeof e=="string"){const r=l[e];if(r!==void 0)return r;throw new o.LabelMapError(`Unknown labels preset: ${JSON.stringify(e)}. Known presets: ${Object.keys(l).join(", ")}.`)}if(typeof e=="object"){const r=e,t=Object.keys(r).map(s=>Number(s));if(t.length===0)return[];const b=Math.max(...t);return Array.from({length:b+1},(s,n)=>r[n]??`class_${n}`)}throw new o.LabelMapError(`Unsupported labels spec type: ${typeof e}.`)}exports.COCO_CLASSES=i;exports.resolveLabels=c;
+//# sourceMappingURL=labels.cjs.map

package/dist/vision/labels.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.cjs","sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"names":["COCO_CLASSES","PRESETS","resolveLabels","spec","options","labels","resolve","LabelMapError","numClasses","_","i","preset","map","ids","k","maxId"],"mappings":"yHAwBaA,EAAkC,OAAO,OAAO,CACzD,SACA,UACA,MACA,aACA,WACA,MACA,QACA,QACA,OACA,gBACA,eACA,YACA,gBACA,QACA,OACA,MACA,MACA,QACA,QACA,MACA,WACA,OACA,QACA,UACA,WACA,WACA,UACA,MACA,WACA,UACA,OACA,YACA,cACA,OACA,eACA,iBACA,aACA,YACA,gBACA,SACA,aACA,MACA,OACA,QACA,QACA,OACA,SACA,QACA,WACA,SACA,WACA,SACA,UACA,QACA,QACA,OACA,QACA,QACA,eACA,MACA,eACA,SACA,KACA,SACA,QACA,SACA,WACA,aACA,YACA,OACA,UACA,OACA,eACA,OACA,QACA,OACA,WACA,aACA,aACA,YACJ,CAAC,EAEKC,EAAuD,CACzD,KAAMD,CACV,EAkBO,SAASE,EACZC,EACAC,EAAgC,GACf,CACjB,MAAMC,EAASC,EAAQH,EAAMC,EAAQ,UAAU,EAC/C,GAAIA,EAAQ,aAAe,QAAaC,EAAO,SAAWD,EAAQ,WAC9D,MAAM,IAAIG,EAAAA,cACN,YAAYF,EAAO,MAAM,6BAA6BD,EAAQ,UAAU,WAAA,EAGhF,OAAOC,CACX,CAEA,SAASC,EAAQH,EAAiBK,EAAmD,CACjF,GAAIL,GAAS,KAA4B,CACrC,GAAIK,IAAe,OACf,MAAM,IAAID,EAAAA,cACN,6FAAA,EAGR,OAAO,MAAM,KAAK,CAAE,OAAQC,CAAA,EAAc,CAACC,EAAGC,IAAM,SAASA,CAAC,EAAE,CACpE,CAEA,GAAI,MAAM,QAAQP,CAAI,EAClB,MAAO,CAAC,GAAGA,CAAI,EAGnB,GAAI,OAAOA,GAAS,SAAU,CAC1B,MAAMQ,EAASV,EAAQE,CAAI,EAC3B,GAAIQ,IAAW,OACX,OAAOA,EAEX,MAAM,IAAIJ,EAAAA,cACN,0BAA0B,KAAK,UAAUJ,CAAI,CAAC,oBAAoB,OAAO,KAAKF,CAAO,EAAE,KAAK,IAAI,CAAC,GAAA,CAEzG,CAEA,GAAI,OAAOE,GAAS,SAAU,CAC1B,MAAMS,EAAMT,EACNU,EAAM,OAAO,KAAKD,CAAG,EAAE,IAAKE,GAAM,OAAOA,CAAC,CAAC,EACjD,GAAID,EAAI,SAAW,EACf,MAAO,CAAA,EAEX,MAAME,EAAQ,KAAK,IAAI,GAAGF,CAAG,EAC7B,OAAO,MAAM,KAAK,CAAE,OAAQE,EAAQ,CAAA,EAAK,CAACN,EAAGC,IAAME,EAAIF,CAAC,GAAK,SAASA,CAAC,EAAE,CAC7E,CAEA,MAAM,IAAIH,EAAAA,cAAc,iCAAiC,OAAOJ,CAAI,GAAG,CAC3E"}

package/dist/vision/labels.js

@@ -0,0 +1,125 @@
+import { LabelMapError as o } from "./core/exceptions.js";
+const b = Object.freeze([
+  "person",
+  "bicycle",
+  "car",
+  "motorcycle",
+  "airplane",
+  "bus",
+  "train",
+  "truck",
+  "boat",
+  "traffic light",
+  "fire hydrant",
+  "stop sign",
+  "parking meter",
+  "bench",
+  "bird",
+  "cat",
+  "dog",
+  "horse",
+  "sheep",
+  "cow",
+  "elephant",
+  "bear",
+  "zebra",
+  "giraffe",
+  "backpack",
+  "umbrella",
+  "handbag",
+  "tie",
+  "suitcase",
+  "frisbee",
+  "skis",
+  "snowboard",
+  "sports ball",
+  "kite",
+  "baseball bat",
+  "baseball glove",
+  "skateboard",
+  "surfboard",
+  "tennis racket",
+  "bottle",
+  "wine glass",
+  "cup",
+  "fork",
+  "knife",
+  "spoon",
+  "bowl",
+  "banana",
+  "apple",
+  "sandwich",
+  "orange",
+  "broccoli",
+  "carrot",
+  "hot dog",
+  "pizza",
+  "donut",
+  "cake",
+  "chair",
+  "couch",
+  "potted plant",
+  "bed",
+  "dining table",
+  "toilet",
+  "tv",
+  "laptop",
+  "mouse",
+  "remote",
+  "keyboard",
+  "cell phone",
+  "microwave",
+  "oven",
+  "toaster",
+  "sink",
+  "refrigerator",
+  "book",
+  "clock",
+  "vase",
+  "scissors",
+  "teddy bear",
+  "hair drier",
+  "toothbrush"
+]), l = {
+  coco: b
+};
+function f(e, t = {}) {
+  const r = c(e, t.numClasses);
+  if (t.numClasses !== void 0 && r.length !== t.numClasses)
+    throw new o(
+      `Resolved ${r.length} labels but the model has ${t.numClasses} classes.`
+    );
+  return r;
+}
+function c(e, t) {
+  if (e == null) {
+    if (t === void 0)
+      throw new o(
+        "Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses."
+      );
+    return Array.from({ length: t }, (r, a) => `class_${a}`);
+  }
+  if (Array.isArray(e))
+    return [...e];
+  if (typeof e == "string") {
+    const r = l[e];
+    if (r !== void 0)
+      return r;
+    throw new o(
+      `Unknown labels preset: ${JSON.stringify(e)}. Known presets: ${Object.keys(l).join(", ")}.`
+    );
+  }
+  if (typeof e == "object") {
+    const r = e, a = Object.keys(r).map((s) => Number(s));
+    if (a.length === 0)
+      return [];
+    const i = Math.max(...a);
+    return Array.from({ length: i + 1 }, (s, n) => r[n] ?? `class_${n}`);
+  }
+  throw new o(`Unsupported labels spec type: ${typeof e}.`);
+}
+export {
+  b as COCO_CLASSES,
+  f as resolveLabels
+};
+//# sourceMappingURL=labels.js.map

package/dist/vision/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"names":["COCO_CLASSES","PRESETS","resolveLabels","spec","options","labels","resolve","LabelMapError","numClasses","_","i","preset","map","ids","k","maxId"],"mappings":";AAwBO,MAAMA,IAAkC,OAAO,OAAO;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC,GAEKC,IAAuD;AAAA,EACzD,MAAMD;AACV;AAkBO,SAASE,EACZC,GACAC,IAAgC,IACf;AACjB,QAAMC,IAASC,EAAQH,GAAMC,EAAQ,UAAU;AAC/C,MAAIA,EAAQ,eAAe,UAAaC,EAAO,WAAWD,EAAQ;AAC9D,UAAM,IAAIG;AAAA,MACN,YAAYF,EAAO,MAAM,6BAA6BD,EAAQ,UAAU;AAAA,IAAA;AAGhF,SAAOC;AACX;AAEA,SAASC,EAAQH,GAAiBK,GAAmD;AACjF,MAAIL,KAAS,MAA4B;AACrC,QAAIK,MAAe;AACf,YAAM,IAAID;AAAA,QACN;AAAA,MAAA;AAGR,WAAO,MAAM,KAAK,EAAE,QAAQC,EAAA,GAAc,CAACC,GAAGC,MAAM,SAASA,CAAC,EAAE;AAAA,EACpE;AAEA,MAAI,MAAM,QAAQP,CAAI;AAClB,WAAO,CAAC,GAAGA,CAAI;AAGnB,MAAI,OAAOA,KAAS,UAAU;AAC1B,UAAMQ,IAASV,EAAQE,CAAI;AAC3B,QAAIQ,MAAW;AACX,aAAOA;AAEX,UAAM,IAAIJ;AAAA,MACN,0BAA0B,KAAK,UAAUJ,CAAI,CAAC,oBAAoB,OAAO,KAAKF,CAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAEzG;AAEA,MAAI,OAAOE,KAAS,UAAU;AAC1B,UAAMS,IAAMT,GACNU,IAAM,OAAO,KAAKD,CAAG,EAAE,IAAI,CAACE,MAAM,OAAOA,CAAC,CAAC;AACjD,QAAID,EAAI,WAAW;AACf,aAAO,CAAA;AAEX,UAAME,IAAQ,KAAK,IAAI,GAAGF,CAAG;AAC7B,WAAO,MAAM,KAAK,EAAE,QAAQE,IAAQ,EAAA,GAAK,CAACN,GAAGC,MAAME,EAAIF,CAAC,KAAK,SAASA,CAAC,EAAE;AAAA,EAC7E;AAEA,QAAM,IAAIH,EAAc,iCAAiC,OAAOJ,CAAI,GAAG;AAC3E;"}

package/dist/vision/luminance.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=256;function g(t){return t instanceof HTMLVideoElement?{width:t.videoWidth,height:t.videoHeight}:t instanceof HTMLCanvasElement?{width:t.width,height:t.height}:{width:t.naturalWidth||t.width,height:t.naturalHeight||t.height}}function L(t,e){const{width:n,height:o}=g(t);if(n===0||o===0)return 0;const u=Math.min(1,s/Math.max(n,o)),i=Math.max(1,Math.round(n*u)),r=Math.max(1,Math.round(o*u)),c=e??document.createElement("canvas");c.width=i,c.height=r;const m=c.getContext("2d",{willReadFrequently:!0});if(!m)return 0;m.drawImage(t,0,0,i,r);const h=m.getImageData(0,0,i,r).data;let d=0;const l=i*r;for(let a=0;a<h.length;a+=4)d+=.2126*h[a]+.7152*h[a+1]+.0722*h[a+2];return d/l}function E(t,e){return t>=e}class M extends Error{luminance;threshold;constructor(e,n){super("Image is too dark to analyse. Capture again in a brighter environment."),this.name="LowLuminanceError",this.luminance=e,this.threshold=n}}exports.LUMINANCE_SAMPLE_MAX_EDGE=s;exports.LowLuminanceError=M;exports.computeImageLuminance=L;exports.isLuminanceAcceptable=E;
+//# sourceMappingURL=luminance.cjs.map

package/dist/vision/luminance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"luminance.cjs","sources":["../../src/vision/luminance.ts"],"sourcesContent":["/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * `<img>`, `<video>` or `<canvas>` so a UI can reject underexposed captures\n * before paying the cost of downstream inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/** Drawable source we can sample luminance from — image, video, or canvas. */\nexport type LuminanceSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement;\n\n/** Natural pixel size of the source (`0`/`0` while it is still unloaded). */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLCanvasElement) {\n        return { width: source.width, height: source.height };\n    }\n    return {\n        width: source.naturalWidth || source.width,\n        height: source.naturalHeight || source.height,\n    };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded\n * `<img>`, `<video>` or `<canvas>`, scaled to `0..255`.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the image/video/canvas to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"names":["LUMINANCE_SAMPLE_MAX_EDGE","sourceSize","source","computeImageLuminance","reusableCanvas","srcW","srcH","scale","w","h","canvas","ctx","data","sum","pixelCount","i","isLuminanceAcceptable","luminance","threshold","LowLuminanceError"],"mappings":"gFAgBO,MAAMA,EAA4B,IAMzC,SAASC,EAAWC,EAA4D,CAC5E,OAAIA,aAAkB,iBACX,CAAE,MAAOA,EAAO,WAAY,OAAQA,EAAO,WAAA,EAElDA,aAAkB,kBACX,CAAE,MAAOA,EAAO,MAAO,OAAQA,EAAO,MAAA,EAE1C,CACH,MAAOA,EAAO,cAAgBA,EAAO,MACrC,OAAQA,EAAO,eAAiBA,EAAO,MAAA,CAE/C,CAmBO,SAASC,EACZD,EACAE,EACM,CACN,KAAM,CAAE,MAAOC,EAAM,OAAQC,CAAA,EAASL,EAAWC,CAAM,EACvD,GAAIG,IAAS,GAAKC,IAAS,EAAG,MAAO,GAErC,MAAMC,EAAQ,KAAK,IAAI,EAAGP,EAA4B,KAAK,IAAIK,EAAMC,CAAI,CAAC,EACpEE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOE,CAAK,CAAC,EACxCE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOC,CAAK,CAAC,EAExCG,EAASN,GAAkB,SAAS,cAAc,QAAQ,EAChEM,EAAO,MAAQF,EACfE,EAAO,OAASD,EAChB,MAAME,EAAMD,EAAO,WAAW,KAAM,CAAE,mBAAoB,GAAM,EAChE,GAAI,CAACC,EAAK,MAAO,GACjBA,EAAI,UAAUT,EAAQ,EAAG,EAAGM,EAAGC,CAAC,EAEhC,MAAMG,EAAOD,EAAI,aAAa,EAAG,EAAGH,EAAGC,CAAC,EAAE,KAC1C,IAAII,EAAM,EACV,MAAMC,EAAaN,EAAIC,EACvB,QAASM,EAAI,EAAGA,EAAIH,EAAK,OAAQG,GAAK,EAClCF,GAAO,MAASD,EAAKG,CAAC,EAAI,MAASH,EAAKG,EAAI,CAAC,EAAI,MAASH,EAAKG,EAAI,CAAC,EAExE,OAAOF,EAAMC,CACjB,CAcO,SAASE,EAAsBC,EAAmBC,EAA4B,CACjF,OAAOD,GAAaC,CACxB,CAOO,MAAMC,UAA0B,KAAM,CAEhC,UAEA,UAMT,YAAYF,EAAmBC,EAAmB,CAC9C,MAAM,wEAAwE,EAC9E,KAAK,KAAO,oBACZ,KAAK,UAAYD,EACjB,KAAK,UAAYC,CACrB,CACJ"}

package/dist/vision/luminance.js

@@ -0,0 +1,45 @@
+const g = 256;
+function u(t) {
+  return t instanceof HTMLVideoElement ? { width: t.videoWidth, height: t.videoHeight } : t instanceof HTMLCanvasElement ? { width: t.width, height: t.height } : {
+    width: t.naturalWidth || t.width,
+    height: t.naturalHeight || t.height
+  };
+}
+function E(t, n) {
+  const { width: e, height: o } = u(t);
+  if (e === 0 || o === 0) return 0;
+  const m = Math.min(1, 256 / Math.max(e, o)), i = Math.max(1, Math.round(e * m)), h = Math.max(1, Math.round(o * m)), c = n ?? document.createElement("canvas");
+  c.width = i, c.height = h;
+  const d = c.getContext("2d", { willReadFrequently: !0 });
+  if (!d) return 0;
+  d.drawImage(t, 0, 0, i, h);
+  const r = d.getImageData(0, 0, i, h).data;
+  let s = 0;
+  const l = i * h;
+  for (let a = 0; a < r.length; a += 4)
+    s += 0.2126 * r[a] + 0.7152 * r[a + 1] + 0.0722 * r[a + 2];
+  return s / l;
+}
+function M(t, n) {
+  return t >= n;
+}
+class w extends Error {
+  /** Measured mean luminance, `0..255`. */
+  luminance;
+  /** Threshold that was checked against, `0..255`. */
+  threshold;
+  /**
+   * @param luminance - the measured mean luminance in `0..255`.
+   * @param threshold - the threshold the measurement failed to reach.
+   */
+  constructor(n, e) {
+    super("Image is too dark to analyse. Capture again in a brighter environment."), this.name = "LowLuminanceError", this.luminance = n, this.threshold = e;
+  }
+}
+export {
+  g as LUMINANCE_SAMPLE_MAX_EDGE,
+  w as LowLuminanceError,
+  E as computeImageLuminance,
+  M as isLuminanceAcceptable
+};
+//# sourceMappingURL=luminance.js.map