tempest-react-sdk 0.23.0 → 0.24.0

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

@@ -1 +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;"}
+{"version":3,"file":"session.js","names":[],"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"],"mappings":";;;;AA0BA,IAAa,IAAb,MAAa,EAAW;CAEC;CACD;CAFpB,YACI,GACA,GACF;EADkB,AADC,KAAA,WAAA,GACD,KAAA,YAAA;CACjB;CASH,aAAa,OAAO,GAAoB,IAA6B,CAAC,GAAwB;EAC1F,IAAM,IAAY,EAAiB,EAAQ,SAAS,GAC9C,IAAsD;GACxD,GAAI,EAAQ,kBAAkB,CAAC;GAC/B,oBACI;EACR,GAEI;EACJ,IAAI;GACA,AAKI,KALA,OAAO,KAAU,YAEV,aAAiB,YADd,MAAM,EAAW,iBAAiB,OAAO,GAAO,CAAc;EAShF,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,8BAA+B,EAAc,WAAW,EAC7E,OAAO,EACX,CAAC;EACL;EAEA,OAAO,IAAI,EAAW,GAAS,CAAS;CAC5C;CAGA,IAAI,aAAgC;EAChC,OAAO,KAAK,SAAS;CACzB;CAGA,IAAI,YAAoB;EACpB,IAAM,IAAO,KAAK,SAAS,WAAW;EACtC,IAAI,MAAS,KAAA,GACT,MAAM,IAAI,EAAe,sBAAsB;EAEnD,OAAO;CACX;CAGA,IAAI,cAAiC;EACjC,OAAO,KAAK,SAAS;CACzB;CAGA,IAAI,MAA4B;EAC5B,OAAO,KAAK;CAChB;CAQA,MAAM,IAAI,GAAwE;EAC9E,IAAI;GAEA,OAAO,MADc,KAAK,SAAS,IAAI,CAAK;EAEhD,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,qBAAsB,EAAc,WAAW,EAAE,OAAO,EAAI,CAAC;EAC1F;CACJ;AACJ"}

package/dist/vision/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="0.2.1";exports.VERSION=e;
-//# sourceMappingURL=index.cjs.map
+const e=require("./core/exceptions.cjs"),t=require("./types.cjs"),n=require("./results.cjs"),r=require("./labels.cjs"),i=require("./core/providers.cjs"),a=require("./core/session.cjs"),o=require("./io/image.cjs"),s=require("./preprocess/image.cjs"),c=require("./postprocess/classification.cjs"),l=require("./postprocess/detection.cjs"),u=require("./postprocess/segmentation.cjs"),d=require("./tasks/base.cjs"),f=require("./tasks/classifier.cjs"),p=require("./tasks/detector.cjs"),m=require("./tasks/segmenter.cjs");var h=`0.2.1`;exports.BoundingBox=t.BoundingBox,exports.Boxes=n.Boxes,exports.COCO_CLASSES=r.COCO_CLASSES,exports.ClassificationResults=n.ClassificationResults,exports.Classifier=f.Classifier,exports.DEFAULT_PROVIDERS=i.DEFAULT_PROVIDERS,exports.DetectionResults=n.DetectionResults,exports.Detector=p.Detector,exports.ImageLoadError=e.ImageLoadError,exports.InferenceError=e.InferenceError,exports.LabelMapError=e.LabelMapError,exports.Mask=t.Mask,exports.Masks=n.Masks,exports.ModelLoadError=e.ModelLoadError,exports.OrtSession=a.OrtSession,exports.OrtVisionError=e.OrtVisionError,exports.Probs=n.Probs,exports.ProviderNotAvailableError=e.ProviderNotAvailableError,exports.RGBImage=t.RGBImage,exports.SegmentationResults=n.SegmentationResults,exports.Segmenter=m.Segmenter,exports.VERSION=h,exports.VisionTask=d.VisionTask,exports.batchedNms=l.batchedNms,exports.decodeYolo=l.decodeYolo,exports.decodeYoloAnchors=l.decodeYoloAnchors,exports.decodeYoloSeg=u.decodeYoloSeg,exports.decodeYoloV8=l.decodeYoloV8,exports.decodeYoloV8Anchors=l.decodeYoloV8Anchors,exports.decodeYoloV8Seg=u.decodeYoloV8Seg,exports.fromCv2=s.fromCv2,exports.letterbox=s.letterbox,exports.loadImage=o.loadImage,exports.nms=l.nms,exports.normalize=s.normalize,exports.resize=s.resize,exports.resolveLabels=r.resolveLabels,exports.resolveProviders=i.resolveProviders,exports.softmax=c.softmax,exports.toCHW=s.toCHW,exports.toCv2=s.toCv2,exports.toFloat32=s.toFloat32,exports.toFloat32Tensor=s.toFloat32Tensor,exports.toTensor=s.toTensor,exports.topK=c.topK;
+//# sourceMappingURL=index.cjs.map

package/dist/vision/index.cjs.map

@@ -1 +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"}
+{"version":3,"file":"index.cjs","names":[],"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"],"mappings":"mgBAwGA,IAAa,EAAkB"}

package/dist/vision/index.js

@@ -1,5 +1,21 @@
-const o = "0.2.1";
-export {
-  o as VERSION
-};
-//# sourceMappingURL=index.js.map
+import { ImageLoadError as e, InferenceError as t, LabelMapError as n, ModelLoadError as r, OrtVisionError as i, ProviderNotAvailableError as a } from "./core/exceptions.js";
+import { BoundingBox as o, Mask as s, RGBImage as c } from "./types.js";
+import { Boxes as l, ClassificationResults as u, DetectionResults as d, Masks as f, Probs as p, SegmentationResults as m } from "./results.js";
+import { COCO_CLASSES as h, resolveLabels as g } from "./labels.js";
+import { DEFAULT_PROVIDERS as _, resolveProviders as v } from "./core/providers.js";
+import { OrtSession as y } from "./core/session.js";
+import { loadImage as b } from "./io/image.js";
+import { fromCv2 as x, letterbox as S, normalize as C, resize as w, toCHW as T, toCv2 as E, toFloat32 as D, toFloat32Tensor as O, toTensor as k } from "./preprocess/image.js";
+import { softmax as A, topK as j } from "./postprocess/classification.js";
+import { batchedNms as M, decodeYolo as N, decodeYoloAnchors as P, decodeYoloV8 as F, decodeYoloV8Anchors as I, nms as L } from "./postprocess/detection.js";
+import { decodeYoloSeg as R, decodeYoloV8Seg as z } from "./postprocess/segmentation.js";
+import { VisionTask as B } from "./tasks/base.js";
+import { Classifier as V } from "./tasks/classifier.js";
+import { Detector as H } from "./tasks/detector.js";
+import { Segmenter as U } from "./tasks/segmenter.js";
+//#region src/vision/index.ts
+var W = "0.2.1";
+//#endregion
+export { o as BoundingBox, l as Boxes, h as COCO_CLASSES, u as ClassificationResults, V as Classifier, _ as DEFAULT_PROVIDERS, d as DetectionResults, H as Detector, e as ImageLoadError, t as InferenceError, n as LabelMapError, s as Mask, f as Masks, r as ModelLoadError, y as OrtSession, i as OrtVisionError, p as Probs, a as ProviderNotAvailableError, c as RGBImage, m as SegmentationResults, U as Segmenter, W as VERSION, B as VisionTask, M as batchedNms, N as decodeYolo, P as decodeYoloAnchors, R as decodeYoloSeg, F as decodeYoloV8, I as decodeYoloV8Anchors, z as decodeYoloV8Seg, x as fromCv2, S as letterbox, b as loadImage, L as nms, C as normalize, w as resize, g as resolveLabels, v as resolveProviders, A as softmax, T as toCHW, E as toCv2, D as toFloat32, O as toFloat32Tensor, k as toTensor, j as topK };
+
+//# sourceMappingURL=index.js.map

package/dist/vision/index.js.map

@@ -1 +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;"}
+{"version":3,"file":"index.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;AAwGA,IAAa,IAAkB"}

package/dist/vision/io/image.cjs

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

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

@@ -1 +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"}
+{"version":3,"file":"image.cjs","names":[],"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"],"mappings":"oGA4BA,eAAsB,EAAU,EAAuC,CACnE,GAAI,aAAkB,EAAA,SAClB,OAAO,EAGX,GAAI,OAAO,UAAc,KAAe,aAAkB,UACtD,OAAO,EAAA,eAAe,CAAM,EAGhC,GAAI,OAAO,GAAW,SAClB,OAAO,EAAY,CAAM,EAG7B,GAAI,OAAO,KAAS,KAAe,aAAkB,KACjD,OAAO,EAAa,CAAM,EAG9B,GAAI,OAAO,iBAAqB,KAAe,aAAkB,iBAE7D,OADA,MAAM,EAAoB,CAAM,EACzB,EAAc,EAAQ,EAAO,aAAc,EAAO,aAAa,EAW1E,GARI,OAAO,kBAAsB,KAAe,aAAkB,mBAI9D,OAAO,gBAAoB,KAAe,aAAkB,iBAI5D,OAAO,YAAgB,KAAe,aAAkB,YACxD,OAAO,EAAc,EAAQ,EAAO,MAAO,EAAO,MAAM,EAG5D,MAAM,IAAI,EAAA,eACN,kCAAkC,OAAO,UAAU,SAAS,KAAK,CAAM,GAC3E,CACJ,CAEA,eAAe,EAAY,EAAgC,CACvD,IAAI,EACJ,GAAI,CACA,EAAW,MAAM,MAAM,CAAG,CAC9B,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,8BAA8B,EAAI,IAAK,EAAc,UAAW,CACrF,MAAO,CACX,CAAC,CACL,CACA,GAAI,CAAC,EAAS,GACV,MAAM,IAAI,EAAA,eACN,8BAA8B,EAAI,SAAS,EAAS,OAAO,GAAG,EAAS,YAC3E,EAGJ,OAAO,EAAa,MADD,EAAS,KAAK,CACT,CAC5B,CAEA,eAAe,EAAa,EAA+B,CACvD,IAAI,EACJ,GAAI,CACA,EAAS,MAAM,kBAAkB,CAAI,CACzC,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,gCAAiC,EAAc,UAAW,CAC/E,MAAO,CACX,CAAC,CACL,CACA,GAAI,CACA,OAAO,EAAc,EAAQ,EAAO,MAAO,EAAO,MAAM,CAC5D,QAAU,CACN,EAAO,MAAM,CACjB,CACJ,CAEA,SAAS,EAAoB,EAAsC,CAI/D,OAHI,EAAI,UAAY,EAAI,aAAe,EAC5B,QAAQ,QAAQ,EAEpB,IAAI,SAAe,EAAS,IAAW,CAC1C,IAAM,MAAqB,CACvB,EAAQ,EACR,EAAQ,CACZ,EACM,MAAsB,CACxB,EAAQ,EACR,EAAO,IAAI,EAAA,eAAe,sDAAsD,CAAC,CACrF,EACM,MAAsB,CACxB,EAAI,oBAAoB,OAAQ,CAAM,EACtC,EAAI,oBAAoB,QAAS,CAAO,CAC5C,EACA,EAAI,iBAAiB,OAAQ,EAAQ,CAAE,KAAM,EAAK,CAAC,EACnD,EAAI,iBAAiB,QAAS,EAAS,CAAE,KAAM,EAAK,CAAC,CACzD,CAAC,CACL,CAEA,SAAS,EAAc,EAA6B,EAAe,EAA0B,CACzF,GAAI,IAAU,GAAK,IAAW,EAC1B,MAAM,IAAI,EAAA,eAAe,0CAA0C,EAAM,GAAG,EAAO,GAAG,EAG1F,IAAM,EAAM,EAAA,aADG,EAAA,aAAa,EAAO,CACV,CAAM,EAG/B,OAFA,EAAI,UAAU,EAAU,EAAG,CAAC,EAErB,EAAA,eADW,EAAI,aAAa,EAAG,EAAG,EAAO,CAC1B,CAAS,CACnC"}

package/dist/vision/io/image.js

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

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

@@ -1 +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;"}
+{"version":3,"file":"image.js","names":[],"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"],"mappings":";;;;AA4BA,eAAsB,EAAU,GAAuC;CACnE,IAAI,aAAkB,GAClB,OAAO;CAGX,IAAI,OAAO,YAAc,OAAe,aAAkB,WACtD,OAAO,EAAe,CAAM;CAGhC,IAAI,OAAO,KAAW,UAClB,OAAO,EAAY,CAAM;CAG7B,IAAI,OAAO,OAAS,OAAe,aAAkB,MACjD,OAAO,EAAa,CAAM;CAG9B,IAAI,OAAO,mBAAqB,OAAe,aAAkB,kBAE7D,OADA,MAAM,EAAoB,CAAM,GACzB,EAAc,GAAQ,EAAO,cAAc,EAAO,aAAa;CAW1E,IARI,OAAO,oBAAsB,OAAe,aAAkB,qBAI9D,OAAO,kBAAoB,OAAe,aAAkB,mBAI5D,OAAO,cAAgB,OAAe,aAAkB,aACxD,OAAO,EAAc,GAAQ,EAAO,OAAO,EAAO,MAAM;CAG5D,MAAM,IAAI,EACN,kCAAkC,OAAO,UAAU,SAAS,KAAK,CAAM,GAC3E;AACJ;AAEA,eAAe,EAAY,GAAgC;CACvD,IAAI;CACJ,IAAI;EACA,IAAW,MAAM,MAAM,CAAG;CAC9B,SAAS,GAAK;EACV,MAAM,IAAI,EAAe,8BAA8B,EAAI,IAAK,EAAc,WAAW,EACrF,OAAO,EACX,CAAC;CACL;CACA,IAAI,CAAC,EAAS,IACV,MAAM,IAAI,EACN,8BAA8B,EAAI,SAAS,EAAS,OAAO,GAAG,EAAS,YAC3E;CAGJ,OAAO,EAAa,MADD,EAAS,KAAK,CACT;AAC5B;AAEA,eAAe,EAAa,GAA+B;CACvD,IAAI;CACJ,IAAI;EACA,IAAS,MAAM,kBAAkB,CAAI;CACzC,SAAS,GAAK;EACV,MAAM,IAAI,EAAe,gCAAiC,EAAc,WAAW,EAC/E,OAAO,EACX,CAAC;CACL;CACA,IAAI;EACA,OAAO,EAAc,GAAQ,EAAO,OAAO,EAAO,MAAM;CAC5D,UAAU;EACN,EAAO,MAAM;CACjB;AACJ;AAEA,SAAS,EAAoB,GAAsC;CAI/D,OAHI,EAAI,YAAY,EAAI,eAAe,IAC5B,QAAQ,QAAQ,IAEpB,IAAI,SAAe,GAAS,MAAW;EAC1C,IAAM,UAAqB;GAEvB,AADA,EAAQ,GACR,EAAQ;EACZ,GACM,UAAsB;GAExB,AADA,EAAQ,GACR,EAAO,IAAI,EAAe,sDAAsD,CAAC;EACrF,GACM,UAAsB;GAExB,AADA,EAAI,oBAAoB,QAAQ,CAAM,GACtC,EAAI,oBAAoB,SAAS,CAAO;EAC5C;EAEA,AADA,EAAI,iBAAiB,QAAQ,GAAQ,EAAE,MAAM,GAAK,CAAC,GACnD,EAAI,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC;CACzD,CAAC;AACL;AAEA,SAAS,EAAc,GAA6B,GAAe,GAA0B;CACzF,IAAI,MAAU,KAAK,MAAW,GAC1B,MAAM,IAAI,EAAe,0CAA0C,EAAM,GAAG,EAAO,GAAG;CAG1F,IAAM,IAAM,EADG,EAAa,GAAO,CACV,CAAM;CAG/B,OAFA,EAAI,UAAU,GAAU,GAAG,CAAC,GAErB,EADW,EAAI,aAAa,GAAG,GAAG,GAAO,CAC1B,CAAS;AACnC"}

package/dist/vision/labels.cjs

@@ -1,2 +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
+const e=require("./core/exceptions.cjs");var t=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`.split(`.`)),n={coco:t};function r(t,n={}){let r=i(t,n.numClasses);if(n.numClasses!==void 0&&r.length!==n.numClasses)throw new e.LabelMapError(`Resolved ${r.length} labels but the model has ${n.numClasses} classes.`);return r}function i(t,r){if(t==null){if(r===void 0)throw new e.LabelMapError(`Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.`);return Array.from({length:r},(e,t)=>`class_${t}`)}if(Array.isArray(t))return[...t];if(typeof t==`string`){let r=n[t];if(r!==void 0)return r;throw new e.LabelMapError(`Unknown labels preset: ${JSON.stringify(t)}. Known presets: ${Object.keys(n).join(`, `)}.`)}if(typeof t==`object`){let e=t,n=Object.keys(e).map(e=>Number(e));if(n.length===0)return[];let r=Math.max(...n);return Array.from({length:r+1},(t,n)=>e[n]??`class_${n}`)}throw new e.LabelMapError(`Unsupported labels spec type: ${typeof t}.`)}exports.COCO_CLASSES=t,exports.resolveLabels=r;
+//# sourceMappingURL=labels.cjs.map

package/dist/vision/labels.cjs.map

@@ -1 +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"}
+{"version":3,"file":"labels.cjs","names":[],"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"],"mappings":"yCAwBA,IAAa,EAAkC,OAAO,OAAO,wnBAiF7D,CAAC,EAEK,EAAuD,CACzD,KAAM,CACV,EAkBA,SAAgB,EACZ,EACA,EAAgC,CAAC,EAChB,CACjB,IAAM,EAAS,EAAQ,EAAM,EAAQ,UAAU,EAC/C,GAAI,EAAQ,aAAe,IAAA,IAAa,EAAO,SAAW,EAAQ,WAC9D,MAAM,IAAI,EAAA,cACN,YAAY,EAAO,OAAO,4BAA4B,EAAQ,WAAW,UAC7E,EAEJ,OAAO,CACX,CAEA,SAAS,EAAQ,EAAiB,EAAmD,CACjF,GAAI,GAAS,KAA4B,CACrC,GAAI,IAAe,IAAA,GACf,MAAM,IAAI,EAAA,cACN,6FACJ,EAEJ,OAAO,MAAM,KAAK,CAAE,OAAQ,CAAW,GAAI,EAAG,IAAM,SAAS,GAAG,CACpE,CAEA,GAAI,MAAM,QAAQ,CAAI,EAClB,MAAO,CAAC,GAAG,CAAI,EAGnB,GAAI,OAAO,GAAS,SAAU,CAC1B,IAAM,EAAS,EAAQ,GACvB,GAAI,IAAW,IAAA,GACX,OAAO,EAEX,MAAM,IAAI,EAAA,cACN,0BAA0B,KAAK,UAAU,CAAI,EAAE,mBAAmB,OAAO,KAAK,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG,CACJ,CAEA,GAAI,OAAO,GAAS,SAAU,CAC1B,IAAM,EAAM,EACN,EAAM,OAAO,KAAK,CAAG,CAAC,CAAC,IAAK,GAAM,OAAO,CAAC,CAAC,EACjD,GAAI,EAAI,SAAW,EACf,MAAO,CAAC,EAEZ,IAAM,EAAQ,KAAK,IAAI,GAAG,CAAG,EAC7B,OAAO,MAAM,KAAK,CAAE,OAAQ,EAAQ,CAAE,GAAI,EAAG,IAAM,EAAI,IAAM,SAAS,GAAG,CAC7E,CAEA,MAAM,IAAI,EAAA,cAAc,iCAAiC,OAAO,EAAK,EAAE,CAC3E"}

package/dist/vision/labels.js

@@ -1,125 +1,31 @@
-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;
+import { LabelMapError as e } from "./core/exceptions.js";
+//#region src/vision/labels.ts
+var t = Object.freeze(/* @__PURE__ */ "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".split(".")), n = { coco: t };
+function r(t, n = {}) {
+	let r = i(t, n.numClasses);
+	if (n.numClasses !== void 0 && r.length !== n.numClasses) throw new e(`Resolved ${r.length} labels but the model has ${n.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}.`);
+function i(t, r) {
+	if (t == null) {
+		if (r === void 0) throw new e("Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.");
+		return Array.from({ length: r }, (e, t) => `class_${t}`);
+	}
+	if (Array.isArray(t)) return [...t];
+	if (typeof t == "string") {
+		let r = n[t];
+		if (r !== void 0) return r;
+		throw new e(`Unknown labels preset: ${JSON.stringify(t)}. Known presets: ${Object.keys(n).join(", ")}.`);
+	}
+	if (typeof t == "object") {
+		let e = t, n = Object.keys(e).map((e) => Number(e));
+		if (n.length === 0) return [];
+		let r = Math.max(...n);
+		return Array.from({ length: r + 1 }, (t, n) => e[n] ?? `class_${n}`);
+	}
+	throw new e(`Unsupported labels spec type: ${typeof t}.`);
 }
-export {
-  b as COCO_CLASSES,
-  f as resolveLabels
-};
-//# sourceMappingURL=labels.js.map
+//#endregion
+export { t as COCO_CLASSES, r as resolveLabels };
+
+//# sourceMappingURL=labels.js.map

package/dist/vision/labels.js.map

@@ -1 +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;"}
+{"version":3,"file":"labels.js","names":[],"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"],"mappings":";;AAwBA,IAAa,IAAkC,OAAO,OAAO,woBAiF7D,CAAC,GAEK,IAAuD,EACzD,MAAM,EACV;AAkBA,SAAgB,EACZ,GACA,IAAgC,CAAC,GAChB;CACjB,IAAM,IAAS,EAAQ,GAAM,EAAQ,UAAU;CAC/C,IAAI,EAAQ,eAAe,KAAA,KAAa,EAAO,WAAW,EAAQ,YAC9D,MAAM,IAAI,EACN,YAAY,EAAO,OAAO,4BAA4B,EAAQ,WAAW,UAC7E;CAEJ,OAAO;AACX;AAEA,SAAS,EAAQ,GAAiB,GAAmD;CACjF,IAAI,KAAS,MAA4B;EACrC,IAAI,MAAe,KAAA,GACf,MAAM,IAAI,EACN,6FACJ;EAEJ,OAAO,MAAM,KAAK,EAAE,QAAQ,EAAW,IAAI,GAAG,MAAM,SAAS,GAAG;CACpE;CAEA,IAAI,MAAM,QAAQ,CAAI,GAClB,OAAO,CAAC,GAAG,CAAI;CAGnB,IAAI,OAAO,KAAS,UAAU;EAC1B,IAAM,IAAS,EAAQ;EACvB,IAAI,MAAW,KAAA,GACX,OAAO;EAEX,MAAM,IAAI,EACN,0BAA0B,KAAK,UAAU,CAAI,EAAE,mBAAmB,OAAO,KAAK,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG;CACJ;CAEA,IAAI,OAAO,KAAS,UAAU;EAC1B,IAAM,IAAM,GACN,IAAM,OAAO,KAAK,CAAG,CAAC,CAAC,KAAK,MAAM,OAAO,CAAC,CAAC;EACjD,IAAI,EAAI,WAAW,GACf,OAAO,CAAC;EAEZ,IAAM,IAAQ,KAAK,IAAI,GAAG,CAAG;EAC7B,OAAO,MAAM,KAAK,EAAE,QAAQ,IAAQ,EAAE,IAAI,GAAG,MAAM,EAAI,MAAM,SAAS,GAAG;CAC7E;CAEA,MAAM,IAAI,EAAc,iCAAiC,OAAO,EAAK,EAAE;AAC3E"}