tempest-react-sdk 0.78.0 → 0.79.0

package/dist/vision/fusion.js.map

@@ -1 +1 @@
-{"version":3,"file":"fusion.js","names":[],"sources":["../../src/vision/fusion.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * The contract a fused pipeline carries inside its own `.onnx` file.\n *\n * A pipeline built by the Python SDK's `ort_vision_sdk.compose` is a single\n * graph that already contains the detector, the crop-and-resize bridge and the\n * classifier. Everything the runtime needs to drive it — the letterbox\n * resolution, the crop resolution, where the crops come from, how many\n * detections the graph emits, the class names of both stages — was decided at\n * fusion time and written into the model's metadata.\n *\n * This module reads it back. It is the browser half of a contract whose other\n * half lives in `ort_vision_sdk/fusion.py`: the same keys, the same encodings,\n * the same fallbacks. A pipeline fused once therefore runs identically in\n * Python and in a browser tab, off the same file.\n *\n * Building a pipeline stays a Python-side build step — there is no ONNX\n * protobuf writer here, and there is no reason for one: fusing is something you\n * do once next to your export pipeline, not in a page load.\n */\n\nimport { parseNames } from \"./core/metadata\";\n\n/**\n * Which tensor the bridge crops the detected boxes out of.\n *\n * - `\"detector_input\"`: the letterboxed tensor already fed to the detector.\n *   The fused graph then has a **single** image input, but a small object is\n *   cropped out of its downscaled copy.\n * - `\"original\"`: a second, full-resolution image input. The bridge undoes the\n *   letterbox transform in-graph and crops at native resolution. Two tensors to\n *   feed, still one session and one model load.\n */\nexport type CropSource = \"detector_input\" | \"original\";\n\n/** Value of the `ovs.kind` metadata key for a detector→classifier pipeline. */\nexport const FUSION_KIND_DETECT_CLASSIFY = \"detect_classify\";\n\n/**\n * Value of `ovs.kind` for a detector→segmenter→classifier pipeline.\n *\n * The segmenter runs inside each crop rather than over the whole frame: the\n * detector finds the boxes, the bridge cuts them out, and the segmenter turns\n * each crop into a foreground mask that gates the pixels the classifier sees.\n * Fusing one is a build step on the Python side; the browser only loads the\n * result.\n */\nexport const FUSION_KIND_DETECT_SEGMENT_CLASSIFY = \"detect_segment_classify\";\n\n/**\n * Namespace for every metadata key the fusion writes.\n *\n * Namespaced on purpose: the detector's own Ultralytics metadata (`names`,\n * `task`, `imgsz`) is carried over into the fused model, and an un-prefixed key\n * would either collide with it or be mistaken for it.\n */\nexport const METADATA_PREFIX = \"ovs.\";\n\n/** Name of the fused graph's letterboxed detector input, `[1, 3, H, W]` float32 in `[0, 1]`. */\nexport const INPUT_IMAGE = \"images\";\n\n/** Name of the full-resolution input. Present only when `cropSource === \"original\"`. */\nexport const INPUT_SOURCE = \"source_image\";\n\n/** Name of the `[1]` float32 letterbox scale factor. Only with `cropSource === \"original\"`. */\nexport const INPUT_SCALE = \"letterbox_scale\";\n\n/** Name of the `[2]` float32 `[padLeft, padTop]`. Only with `cropSource === \"original\"`. */\nexport const INPUT_PAD = \"letterbox_pad\";\n\n/**\n * Name of the `[K, 4]` float32 xyxy output, in **letterboxed** input pixels.\n *\n * A file fused by `ort-vision-sdk` 0.9.0 or later reports the box that was\n * actually classified: clamped to the image the crop came from, exactly as\n * RoiAlign received it. Older files report the raw box, so one that ran off the\n * frame draws a rectangle wider than the region the classifier saw.\n */\nexport const OUTPUT_BOXES = \"boxes\";\n\n/** Name of the `[K]` float32 detection-confidence output. */\nexport const OUTPUT_SCORES = \"scores\";\n\n/** Name of the `[K]` int64 detector-class output. */\nexport const OUTPUT_CLASSES = \"classes\";\n\n/** Name of the `[1]` int64 output holding how many of the `K` rows are real. */\nexport const OUTPUT_NUM_DETECTIONS = \"num_detections\";\n\n/** Name of the `[K, numClassifierClasses]` float32 classifier output, one row per box. */\n/**\n * Name of the `(K, 1, cropH, cropW)` float32 mask output. Only on a\n * `detect_segment_classify` pipeline.\n *\n * The mask lives in the **crop's** coordinate space, not the original image's,\n * because that is where the segmenter computed it. Values are 0 or 1 after\n * thresholding; padded rows are all-zero, like every other output.\n */\nexport const OUTPUT_MASKS = \"masks\";\n\nexport const OUTPUT_PROBS = \"probs\";\n\n/** Everything a fused pipeline declares about how it must be driven. */\nexport interface FusionSpec {\n    /** Pipeline family — {@link FUSION_KIND_DETECT_CLASSIFY} or {@link FUSION_KIND_DETECT_SEGMENT_CLASSIFY}. */\n    readonly kind: string;\n    /** `[width, height]` the detector stage expects — the resolution to letterbox to. */\n    readonly inputSize: readonly [number, number];\n    /** `[width, height]` every crop is resampled to inside the graph. */\n    readonly cropSize: readonly [number, number];\n    /** Which tensor the crops are taken from. */\n    readonly cropSource: CropSource;\n    /**\n     * Fixed number of rows `K` every output carries, surplus zero-padded and\n     * counted by {@link OUTPUT_NUM_DETECTIONS}. `null` means the graph emits\n     * exactly as many rows as survived NMS.\n     */\n    readonly maxDetections: number | null;\n    /** Score threshold baked into the graph's NMS node. */\n    readonly confThreshold: number;\n    /** IoU threshold baked into the graph's NMS node. */\n    readonly iouThreshold: number;\n    /** Whether the classifier stage emits logits that still need a softmax. */\n    readonly applySoftmax: boolean;\n    /** Detector class names in class-id order, or `null` when the fusion recorded none. */\n    readonly detectorNames: readonly string[] | null;\n    /** Classifier class names in class-id order, or `null`. */\n    readonly classifierNames: readonly string[] | null;\n    /** Version of `ort-vision-sdk` that produced the file. */\n    readonly sdkVersion: string;\n    /** Whether driving this pipeline requires feeding the full-resolution input. */\n    readonly needsSourceImage: boolean;\n    /** Whether this pipeline emits a {@link OUTPUT_MASKS} tensor. */\n    readonly hasMasks: boolean;\n    /** Class id → name for the segmenter's channels, or `null`. */\n    readonly segmenterNames: readonly string[] | null;\n    /**\n     * Probability above which a segmenter pixel counted as foreground.\n     *\n     * Baked into the graph at fusion time; reported so a caller can say what the\n     * masks mean.\n     */\n    readonly maskThreshold: number;\n    /** Whether the mask gated the crop before the classifier saw it. */\n    readonly maskApplied: boolean;\n}\n\nconst KEY_KIND = \"kind\";\nconst KEY_SDK_VERSION = \"sdk_version\";\nconst KEY_INPUT_SIZE = \"input_size\";\nconst KEY_CROP_SIZE = \"crop_size\";\nconst KEY_CROP_SOURCE = \"crop_source\";\nconst KEY_MAX_DETECTIONS = \"max_detections\";\nconst KEY_CONF_THRESHOLD = \"conf_threshold\";\nconst KEY_IOU_THRESHOLD = \"iou_threshold\";\nconst KEY_APPLY_SOFTMAX = \"apply_softmax\";\nconst KEY_DETECTOR_NAMES = \"detector_names\";\nconst KEY_CLASSIFIER_NAMES = \"classifier_names\";\nconst KEY_SEGMENTER_NAMES = \"segmenter_names\";\nconst KEY_MASK_THRESHOLD = \"mask_threshold\";\nconst KEY_MASK_APPLIED = \"mask_applied\";\n\nconst DYNAMIC = \"dynamic\";\n\n/**\n * Decode a `\"640,640\"` pair.\n *\n * @param raw The encoded pair.\n * @returns `[width, height]`, or `null` when the value is missing or malformed.\n */\nfunction decodeSize(raw: string | undefined): readonly [number, number] | null {\n    if (!raw) return null;\n    const parts = raw.split(\",\");\n    if (parts.length !== 2) return null;\n    const width = Number(parts[0]);\n    const height = Number(parts[1]);\n    if (!Number.isInteger(width) || !Number.isInteger(height)) return null;\n    if (width < 1 || height < 1) return null;\n    return [width, height];\n}\n\n/**\n * Decode a float, falling back when the value is missing or malformed.\n *\n * @param raw The encoded value.\n * @param fallback Value to use when `raw` cannot be read.\n * @returns The parsed number, or `fallback`.\n */\nfunction decodeFloat(raw: string | undefined, fallback: number): number {\n    if (!raw) return fallback;\n    const value = Number(raw);\n    return Number.isFinite(value) ? value : fallback;\n}\n\n/**\n * Read a pipeline spec out of a model's custom metadata.\n *\n * Individual malformed entries fall back to the value a fusion would have used\n * by default — a single bad float is not a reason to reject an otherwise\n * loadable pipeline. A malformed resolution is fatal, because there is no safe\n * default for one.\n *\n * @param metadata A model's custom metadata map, as read by\n *   {@link readModelMetadata}.\n * @returns The decoded spec, or `null` when the model is not a fused pipeline —\n *   it carries no `ovs.kind` entry, or one naming a pipeline kind this version\n *   does not know how to drive.\n */\nexport function readFusionSpec(\n    metadata: Readonly<Record<string, string>> | undefined,\n): FusionSpec | null {\n    if (!metadata) return null;\n\n    const read: Record<string, string> = {};\n    for (const [key, value] of Object.entries(metadata)) {\n        if (key.startsWith(METADATA_PREFIX)) read[key.slice(METADATA_PREFIX.length)] = value;\n    }\n    const kind = read[KEY_KIND];\n    if (kind !== FUSION_KIND_DETECT_CLASSIFY && kind !== FUSION_KIND_DETECT_SEGMENT_CLASSIFY) {\n        return null;\n    }\n\n    const inputSize = decodeSize(read[KEY_INPUT_SIZE]);\n    const cropSize = decodeSize(read[KEY_CROP_SIZE]);\n    if (inputSize === null || cropSize === null) return null;\n\n    const rawMax = read[KEY_MAX_DETECTIONS] ?? DYNAMIC;\n    const parsedMax = Number(rawMax);\n    const maxDetections =\n        rawMax === DYNAMIC || !Number.isInteger(parsedMax) || parsedMax < 1 ? null : parsedMax;\n\n    const cropSource: CropSource =\n        read[KEY_CROP_SOURCE] === \"original\" ? \"original\" : \"detector_input\";\n\n    return {\n        kind,\n        inputSize,\n        cropSize,\n        cropSource,\n        maxDetections,\n        confThreshold: decodeFloat(read[KEY_CONF_THRESHOLD], 0.25),\n        iouThreshold: decodeFloat(read[KEY_IOU_THRESHOLD], 0.45),\n        applySoftmax: (read[KEY_APPLY_SOFTMAX] ?? \"1\") !== \"0\",\n        detectorNames: parseNames(read[KEY_DETECTOR_NAMES]),\n        classifierNames: parseNames(read[KEY_CLASSIFIER_NAMES]),\n        sdkVersion: read[KEY_SDK_VERSION] ?? \"\",\n        needsSourceImage: cropSource === \"original\",\n        hasMasks: kind === FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n        segmenterNames: parseNames(read[KEY_SEGMENTER_NAMES]),\n        maskThreshold: decodeFloat(read[KEY_MASK_THRESHOLD], 0.5),\n        maskApplied: (read[KEY_MASK_APPLIED] ?? \"1\") !== \"0\",\n    };\n}\n"],"mappings":";;AAoCA,IAAa,IAA8B,mBAW9B,IAAsC,2BAStC,IAAkB,QAGlB,IAAc,UAGd,IAAe,gBAGf,IAAc,mBAGd,IAAY,iBAUZ,IAAe,SAGf,IAAgB,UAGhB,IAAiB,WAGjB,IAAwB,kBAWxB,IAAe,SAEf,IAAe,SA+CtB,IAAW,QACX,IAAkB,eAClB,IAAiB,cACjB,IAAgB,aAChB,IAAkB,eAClB,IAAqB,kBACrB,IAAqB,kBACrB,IAAoB,iBACpB,IAAoB,iBACpB,IAAqB,kBACrB,IAAuB,oBACvB,IAAsB,mBACtB,IAAqB,kBACrB,IAAmB,gBAEnB,IAAU;AAQhB,SAAS,EAAW,GAA2D;CAC3E,IAAI,CAAC,GAAK,OAAO;CACjB,IAAM,IAAQ,EAAI,MAAM,GAAG;CAC3B,IAAI,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAM,IAAQ,OAAO,EAAM,EAAE,GACvB,IAAS,OAAO,EAAM,EAAE;CAG9B,OAFI,CAAC,OAAO,UAAU,CAAK,KAAK,CAAC,OAAO,UAAU,CAAM,KACpD,IAAQ,KAAK,IAAS,IAAU,OAC7B,CAAC,GAAO,CAAM;AACzB;AASA,SAAS,EAAY,GAAyB,GAA0B;CACpE,IAAI,CAAC,GAAK,OAAO;CACjB,IAAM,IAAQ,OAAO,CAAG;CACxB,OAAO,OAAO,SAAS,CAAK,IAAI,IAAQ;AAC5C;AAgBA,SAAgB,EACZ,GACiB;CACjB,IAAI,CAAC,GAAU,OAAO;CAEtB,IAAM,IAA+B,CAAC;CACtC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAQ,GAC9C,AAAI,EAAI,WAAA,MAA0B,MAAG,EAAK,EAAI,MAAM,CAAsB,KAAK;CAEnF,IAAM,IAAO,EAAK;CAClB,IAAI,MAAA,qBAAwC,MAAA,2BACxC,OAAO;CAGX,IAAM,IAAY,EAAW,EAAK,EAAe,GAC3C,IAAW,EAAW,EAAK,EAAc;CAC/C,IAAI,MAAc,QAAQ,MAAa,MAAM,OAAO;CAEpD,IAAM,IAAS,EAAK,MAAuB,GACrC,IAAY,OAAO,CAAM,GACzB,IACF,MAAW,KAAW,CAAC,OAAO,UAAU,CAAS,KAAK,IAAY,IAAI,OAAO,GAE3E,IACF,EAAK,OAAqB,aAAa,aAAa;CAExD,OAAO;EACH;EACA;EACA;EACA;EACA;EACA,eAAe,EAAY,EAAK,IAAqB,GAAI;EACzD,cAAc,EAAY,EAAK,IAAoB,GAAI;EACvD,eAAe,EAAK,MAAsB,SAAS;EACnD,eAAe,EAAW,EAAK,EAAmB;EAClD,iBAAiB,EAAW,EAAK,EAAqB;EACtD,YAAY,EAAK,MAAoB;EACrC,kBAAkB,MAAe;EACjC,UAAU,MAAS;EACnB,gBAAgB,EAAW,EAAK,EAAoB;EACpD,eAAe,EAAY,EAAK,IAAqB,EAAG;EACxD,cAAc,EAAK,MAAqB,SAAS;CACrD;AACJ"}
+{"version":3,"file":"fusion.js","names":["FUSION_KIND_DETECT_CLASSIFY","FUSION_KIND_DETECT_SEGMENT_CLASSIFY","METADATA_PREFIX","INPUT_IMAGE","INPUT_SOURCE","INPUT_SCALE","INPUT_PAD","OUTPUT_BOXES","OUTPUT_SCORES","OUTPUT_CLASSES","OUTPUT_NUM_DETECTIONS","OUTPUT_MASKS","OUTPUT_PROBS","KEY_KIND","KEY_SDK_VERSION","KEY_INPUT_SIZE","KEY_CROP_SIZE","KEY_CROP_SOURCE","KEY_MAX_DETECTIONS","KEY_CONF_THRESHOLD","KEY_IOU_THRESHOLD","KEY_APPLY_SOFTMAX","KEY_DETECTOR_NAMES","KEY_CLASSIFIER_NAMES","KEY_SEGMENTER_NAMES","KEY_MASK_THRESHOLD","KEY_MASK_APPLIED","DYNAMIC","decodeSize","raw","parts","width","height","decodeFloat","fallback","value","readFusionSpec","metadata","read","key","kind","inputSize","cropSize","rawMax","parsedMax","maxDetections","cropSource","parseNames"],"sources":["../../src/vision/fusion.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * The contract a fused pipeline carries inside its own `.onnx` file.\n *\n * A pipeline built by the Python SDK's `ort_vision_sdk.compose` is a single\n * graph that already contains the detector, the crop-and-resize bridge and the\n * classifier. Everything the runtime needs to drive it — the letterbox\n * resolution, the crop resolution, where the crops come from, how many\n * detections the graph emits, the class names of both stages — was decided at\n * fusion time and written into the model's metadata.\n *\n * This module reads it back. It is the browser half of a contract whose other\n * half lives in `ort_vision_sdk/fusion.py`: the same keys, the same encodings,\n * the same fallbacks. A pipeline fused once therefore runs identically in\n * Python and in a browser tab, off the same file.\n *\n * Building a pipeline stays a Python-side build step — there is no ONNX\n * protobuf writer here, and there is no reason for one: fusing is something you\n * do once next to your export pipeline, not in a page load.\n */\n\nimport { parseNames } from \"./core/metadata\";\n\n/**\n * Which tensor the bridge crops the detected boxes out of.\n *\n * - `\"detector_input\"`: the letterboxed tensor already fed to the detector.\n *   The fused graph then has a **single** image input, but a small object is\n *   cropped out of its downscaled copy.\n * - `\"original\"`: a second, full-resolution image input. The bridge undoes the\n *   letterbox transform in-graph and crops at native resolution. Two tensors to\n *   feed, still one session and one model load.\n */\nexport type CropSource = \"detector_input\" | \"original\";\n\n/** Value of the `ovs.kind` metadata key for a detector→classifier pipeline. */\nexport const FUSION_KIND_DETECT_CLASSIFY = \"detect_classify\";\n\n/**\n * Value of `ovs.kind` for a detector→segmenter→classifier pipeline.\n *\n * The segmenter runs inside each crop rather than over the whole frame: the\n * detector finds the boxes, the bridge cuts them out, and the segmenter turns\n * each crop into a foreground mask that gates the pixels the classifier sees.\n * Fusing one is a build step on the Python side; the browser only loads the\n * result.\n */\nexport const FUSION_KIND_DETECT_SEGMENT_CLASSIFY = \"detect_segment_classify\";\n\n/**\n * Namespace for every metadata key the fusion writes.\n *\n * Namespaced on purpose: the detector's own Ultralytics metadata (`names`,\n * `task`, `imgsz`) is carried over into the fused model, and an un-prefixed key\n * would either collide with it or be mistaken for it.\n */\nexport const METADATA_PREFIX = \"ovs.\";\n\n/** Name of the fused graph's letterboxed detector input, `[1, 3, H, W]` float32 in `[0, 1]`. */\nexport const INPUT_IMAGE = \"images\";\n\n/** Name of the full-resolution input. Present only when `cropSource === \"original\"`. */\nexport const INPUT_SOURCE = \"source_image\";\n\n/** Name of the `[1]` float32 letterbox scale factor. Only with `cropSource === \"original\"`. */\nexport const INPUT_SCALE = \"letterbox_scale\";\n\n/** Name of the `[2]` float32 `[padLeft, padTop]`. Only with `cropSource === \"original\"`. */\nexport const INPUT_PAD = \"letterbox_pad\";\n\n/**\n * Name of the `[K, 4]` float32 xyxy output, in **letterboxed** input pixels.\n *\n * A file fused by `ort-vision-sdk` 0.9.0 or later reports the box that was\n * actually classified: clamped to the image the crop came from, exactly as\n * RoiAlign received it. Older files report the raw box, so one that ran off the\n * frame draws a rectangle wider than the region the classifier saw.\n */\nexport const OUTPUT_BOXES = \"boxes\";\n\n/** Name of the `[K]` float32 detection-confidence output. */\nexport const OUTPUT_SCORES = \"scores\";\n\n/** Name of the `[K]` int64 detector-class output. */\nexport const OUTPUT_CLASSES = \"classes\";\n\n/** Name of the `[1]` int64 output holding how many of the `K` rows are real. */\nexport const OUTPUT_NUM_DETECTIONS = \"num_detections\";\n\n/** Name of the `[K, numClassifierClasses]` float32 classifier output, one row per box. */\n/**\n * Name of the `(K, 1, cropH, cropW)` float32 mask output. Only on a\n * `detect_segment_classify` pipeline.\n *\n * The mask lives in the **crop's** coordinate space, not the original image's,\n * because that is where the segmenter computed it. Values are 0 or 1 after\n * thresholding; padded rows are all-zero, like every other output.\n */\nexport const OUTPUT_MASKS = \"masks\";\n\nexport const OUTPUT_PROBS = \"probs\";\n\n/** Everything a fused pipeline declares about how it must be driven. */\nexport interface FusionSpec {\n    /** Pipeline family — {@link FUSION_KIND_DETECT_CLASSIFY} or {@link FUSION_KIND_DETECT_SEGMENT_CLASSIFY}. */\n    readonly kind: string;\n    /** `[width, height]` the detector stage expects — the resolution to letterbox to. */\n    readonly inputSize: readonly [number, number];\n    /** `[width, height]` every crop is resampled to inside the graph. */\n    readonly cropSize: readonly [number, number];\n    /** Which tensor the crops are taken from. */\n    readonly cropSource: CropSource;\n    /**\n     * Fixed number of rows `K` every output carries, surplus zero-padded and\n     * counted by {@link OUTPUT_NUM_DETECTIONS}. `null` means the graph emits\n     * exactly as many rows as survived NMS.\n     */\n    readonly maxDetections: number | null;\n    /** Score threshold baked into the graph's NMS node. */\n    readonly confThreshold: number;\n    /** IoU threshold baked into the graph's NMS node. */\n    readonly iouThreshold: number;\n    /** Whether the classifier stage emits logits that still need a softmax. */\n    readonly applySoftmax: boolean;\n    /** Detector class names in class-id order, or `null` when the fusion recorded none. */\n    readonly detectorNames: readonly string[] | null;\n    /** Classifier class names in class-id order, or `null`. */\n    readonly classifierNames: readonly string[] | null;\n    /** Version of `ort-vision-sdk` that produced the file. */\n    readonly sdkVersion: string;\n    /** Whether driving this pipeline requires feeding the full-resolution input. */\n    readonly needsSourceImage: boolean;\n    /** Whether this pipeline emits a {@link OUTPUT_MASKS} tensor. */\n    readonly hasMasks: boolean;\n    /** Class id → name for the segmenter's channels, or `null`. */\n    readonly segmenterNames: readonly string[] | null;\n    /**\n     * Probability above which a segmenter pixel counted as foreground.\n     *\n     * Baked into the graph at fusion time; reported so a caller can say what the\n     * masks mean.\n     */\n    readonly maskThreshold: number;\n    /** Whether the mask gated the crop before the classifier saw it. */\n    readonly maskApplied: boolean;\n}\n\nconst KEY_KIND = \"kind\";\nconst KEY_SDK_VERSION = \"sdk_version\";\nconst KEY_INPUT_SIZE = \"input_size\";\nconst KEY_CROP_SIZE = \"crop_size\";\nconst KEY_CROP_SOURCE = \"crop_source\";\nconst KEY_MAX_DETECTIONS = \"max_detections\";\nconst KEY_CONF_THRESHOLD = \"conf_threshold\";\nconst KEY_IOU_THRESHOLD = \"iou_threshold\";\nconst KEY_APPLY_SOFTMAX = \"apply_softmax\";\nconst KEY_DETECTOR_NAMES = \"detector_names\";\nconst KEY_CLASSIFIER_NAMES = \"classifier_names\";\nconst KEY_SEGMENTER_NAMES = \"segmenter_names\";\nconst KEY_MASK_THRESHOLD = \"mask_threshold\";\nconst KEY_MASK_APPLIED = \"mask_applied\";\n\nconst DYNAMIC = \"dynamic\";\n\n/**\n * Decode a `\"640,640\"` pair.\n *\n * @param raw The encoded pair.\n * @returns `[width, height]`, or `null` when the value is missing or malformed.\n */\nfunction decodeSize(raw: string | undefined): readonly [number, number] | null {\n    if (!raw) return null;\n    const parts = raw.split(\",\");\n    if (parts.length !== 2) return null;\n    const width = Number(parts[0]);\n    const height = Number(parts[1]);\n    if (!Number.isInteger(width) || !Number.isInteger(height)) return null;\n    if (width < 1 || height < 1) return null;\n    return [width, height];\n}\n\n/**\n * Decode a float, falling back when the value is missing or malformed.\n *\n * @param raw The encoded value.\n * @param fallback Value to use when `raw` cannot be read.\n * @returns The parsed number, or `fallback`.\n */\nfunction decodeFloat(raw: string | undefined, fallback: number): number {\n    if (!raw) return fallback;\n    const value = Number(raw);\n    return Number.isFinite(value) ? value : fallback;\n}\n\n/**\n * Read a pipeline spec out of a model's custom metadata.\n *\n * Individual malformed entries fall back to the value a fusion would have used\n * by default — a single bad float is not a reason to reject an otherwise\n * loadable pipeline. A malformed resolution is fatal, because there is no safe\n * default for one.\n *\n * @param metadata A model's custom metadata map, as read by\n *   {@link readModelMetadata}.\n * @returns The decoded spec, or `null` when the model is not a fused pipeline —\n *   it carries no `ovs.kind` entry, or one naming a pipeline kind this version\n *   does not know how to drive.\n */\nexport function readFusionSpec(\n    metadata: Readonly<Record<string, string>> | undefined,\n): FusionSpec | null {\n    if (!metadata) return null;\n\n    const read: Record<string, string> = {};\n    for (const [key, value] of Object.entries(metadata)) {\n        if (key.startsWith(METADATA_PREFIX)) read[key.slice(METADATA_PREFIX.length)] = value;\n    }\n    const kind = read[KEY_KIND];\n    if (kind !== FUSION_KIND_DETECT_CLASSIFY && kind !== FUSION_KIND_DETECT_SEGMENT_CLASSIFY) {\n        return null;\n    }\n\n    const inputSize = decodeSize(read[KEY_INPUT_SIZE]);\n    const cropSize = decodeSize(read[KEY_CROP_SIZE]);\n    if (inputSize === null || cropSize === null) return null;\n\n    const rawMax = read[KEY_MAX_DETECTIONS] ?? DYNAMIC;\n    const parsedMax = Number(rawMax);\n    const maxDetections =\n        rawMax === DYNAMIC || !Number.isInteger(parsedMax) || parsedMax < 1 ? null : parsedMax;\n\n    const cropSource: CropSource =\n        read[KEY_CROP_SOURCE] === \"original\" ? \"original\" : \"detector_input\";\n\n    return {\n        kind,\n        inputSize,\n        cropSize,\n        cropSource,\n        maxDetections,\n        confThreshold: decodeFloat(read[KEY_CONF_THRESHOLD], 0.25),\n        iouThreshold: decodeFloat(read[KEY_IOU_THRESHOLD], 0.45),\n        applySoftmax: (read[KEY_APPLY_SOFTMAX] ?? \"1\") !== \"0\",\n        detectorNames: parseNames(read[KEY_DETECTOR_NAMES]),\n        classifierNames: parseNames(read[KEY_CLASSIFIER_NAMES]),\n        sdkVersion: read[KEY_SDK_VERSION] ?? \"\",\n        needsSourceImage: cropSource === \"original\",\n        hasMasks: kind === FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n        segmenterNames: parseNames(read[KEY_SEGMENTER_NAMES]),\n        maskThreshold: decodeFloat(read[KEY_MASK_THRESHOLD], 0.5),\n        maskApplied: (read[KEY_MASK_APPLIED] ?? \"1\") !== \"0\",\n    };\n}\n"],"mappings":";;AAoCA,IAAaA,IAA8B,mBAW9BC,IAAsC,2BAStCC,IAAkB,QAGlBC,IAAc,UAGdC,IAAe,gBAGfC,IAAc,mBAGdC,IAAY,iBAUZC,IAAe,SAGfC,IAAgB,UAGhBC,IAAiB,WAGjBC,IAAwB,kBAWxBC,IAAe,SAEfC,IAAe,SA+CtBC,IAAW,QACXC,IAAkB,eAClBC,IAAiB,cACjBC,IAAgB,aAChBC,IAAkB,eAClBC,IAAqB,kBACrBC,IAAqB,kBACrBC,IAAoB,iBACpBC,IAAoB,iBACpBC,IAAqB,kBACrBC,IAAuB,oBACvBC,IAAsB,mBACtBC,IAAqB,kBACrBC,IAAmB,gBAEnBC,IAAU;AAQhB,SAASC,EAAW,GAA2D;CAC3E,IAAI,CAACC,GAAK,OAAO;CACjB,IAAMC,IAAQD,EAAI,MAAM,GAAG;CAC3B,IAAIC,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAMC,IAAQ,OAAOD,EAAM,EAAE,GACvBE,IAAS,OAAOF,EAAM,EAAE;CAG9B,OAFI,CAAC,OAAO,UAAUC,CAAK,KAAK,CAAC,OAAO,UAAUC,CAAM,KACpDD,IAAQ,KAAKC,IAAS,IAAU,OAC7B,CAACD,GAAOC,CAAM;AACzB;AASA,SAASC,EAAY,GAAyB,GAA0B;CACpE,IAAI,CAACJ,GAAK,OAAOK;CACjB,IAAMC,IAAQ,OAAON,CAAG;CACxB,OAAO,OAAO,SAASM,CAAK,IAAIA,IAAQD;AAC5C;AAgBA,SAAgBE,EACZ,GACiB;CACjB,IAAI,CAACC,GAAU,OAAO;CAEtB,IAAMC,IAA+B,CAAC;CACtC,KAAK,IAAM,CAACC,GAAKJ,MAAU,OAAO,QAAQE,CAAQ,GAC9C,AAAIE,EAAI,WAAA,MAA0B,MAAG,EAAKA,EAAI,MAAM,CAAsB,KAAKJ;CAEnF,IAAMK,IAAOF,EAAKzB;CAClB,IAAI2B,MAAA,qBAAwCA,MAAA,2BACxC,OAAO;CAGX,IAAMC,IAAYb,EAAWU,EAAKvB,EAAe,GAC3C2B,IAAWd,EAAWU,EAAKtB,EAAc;CAC/C,IAAIyB,MAAc,QAAQC,MAAa,MAAM,OAAO;CAEpD,IAAMC,IAASL,EAAKpB,MAAuBS,GACrCiB,IAAY,OAAOD,CAAM,GACzBE,IACFF,MAAWhB,KAAW,CAAC,OAAO,UAAUiB,CAAS,KAAKA,IAAY,IAAI,OAAOA,GAE3EE,IACFR,EAAKrB,OAAqB,aAAa,aAAa;CAExD,OAAO;EACH;EACA;EACA;EACA;EACA;EACA,eAAegB,EAAYK,EAAKnB,IAAqB,GAAI;EACzD,cAAcc,EAAYK,EAAKlB,IAAoB,GAAI;EACvD,eAAekB,EAAKjB,MAAsB,SAAS;EACnD,eAAe0B,EAAWT,EAAKhB,EAAmB;EAClD,iBAAiByB,EAAWT,EAAKf,EAAqB;EACtD,YAAYe,EAAKxB,MAAoB;EACrC,kBAAkBgC,MAAe;EACjC,UAAUN,MAASvC;EACnB,gBAAgB8C,EAAWT,EAAKd,EAAoB;EACpD,eAAeS,EAAYK,EAAKb,IAAqB,EAAG;EACxD,cAAca,EAAKZ,MAAqB,SAAS;CACrD;AACJ"}

package/dist/vision/index.cjs.map

@@ -1 +1 @@
-{"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.12.0` (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    DetectClassifyResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport {\n    COCO_CLASSES,\n    type LabelSpec,\n    type ResolveLabelsOptions,\n    defaultLabels,\n    resolveLabels,\n} from \"./labels\";\n\nexport {\n    FusionError,\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    NoDetectionsError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport {\n    DEFAULT_MODEL_CACHE,\n    GRAPH_OPTIMIZATION_KEY,\n    type ModelSource,\n    type OrtSessionOptions,\n    OrtSession,\n    QUANTIZATION_KEY,\n} from \"./core/session\";\nexport {\n    type DeclaredDim,\n    type DeclaredShape,\n    type ResolveInputSizeOptions,\n    classificationNumClasses,\n    declaredShapesFrom,\n    detectionNumClasses,\n    resolveInputSize,\n    spatialInputSize,\n} from \"./core/graph\";\nexport {\n    DEFAULT_TENSOR_TYPE,\n    type Float16ArrayLike,\n    asFloat32Array,\n    hasFloat16Array,\n    tensorTypeFor,\n} from \"./core/dtypes\";\nexport { modelNames, parseNames, readModelInputTypes, readModelMetadata } from \"./core/metadata\";\nexport {\n    DEFAULT_PROVIDERS,\n    type ProviderSpec,\n    detectProviders,\n    resolveProviders,\n} from \"./core/providers\";\nexport { type Speed, SpeedTimer } from \"./core/timing\";\nexport {\n    CUSTOM_NORMALIZATION,\n    IDENTITY_MEAN,\n    IDENTITY_STD,\n    IMAGENET_MEAN,\n    IMAGENET_STD,\n    type Normalization,\n    type ResolvedNormalization,\n    isUltralyticsClassifier,\n    resolveNormalization,\n} from \"./normalization\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    FUSION_KIND_DETECT_CLASSIFY,\n    FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n    INPUT_IMAGE,\n    INPUT_PAD,\n    INPUT_SCALE,\n    INPUT_SOURCE,\n    METADATA_PREFIX,\n    OUTPUT_BOXES,\n    OUTPUT_CLASSES,\n    OUTPUT_MASKS,\n    OUTPUT_NUM_DETECTIONS,\n    OUTPUT_PROBS,\n    OUTPUT_SCORES,\n    type CropSource,\n    type FusionSpec,\n    readFusionSpec,\n} from \"./fusion\";\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 {\n    type FusedLetterboxResult,\n    type FusedResizeResult,\n    LetterboxPipeline,\n    ResizePipeline,\n    letterboxToTensorData,\n    resizeToTensorData,\n    writePlanarFloat32,\n    zeroTensorData,\n} from \"./preprocess/pipeline\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask, requireDetections } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectClassifyOptions,\n    type DetectClassifyPredictOptions,\n    DetectClassify,\n} from \"./tasks/detectClassify\";\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.12.0\";\n"],"mappings":"0wBAwLA,IAAa,EAAkB"}
+{"version":3,"file":"index.cjs","names":["require_exceptions","require_types","require_timing","require_results","require_labels","require_dtypes","require_graph","require_metadata","require_providers","require_session","require_normalization","require_image","require_fusion","require_image$1","require_pipeline","require_classification","require_detection","require_segmentation","require_base","require_classifier","require_detectClassify","require_detector","require_segmenter","VERSION"],"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.12.0` (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    DetectClassifyResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport {\n    COCO_CLASSES,\n    type LabelSpec,\n    type ResolveLabelsOptions,\n    defaultLabels,\n    resolveLabels,\n} from \"./labels\";\n\nexport {\n    FusionError,\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    NoDetectionsError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport {\n    DEFAULT_MODEL_CACHE,\n    GRAPH_OPTIMIZATION_KEY,\n    type ModelSource,\n    type OrtSessionOptions,\n    OrtSession,\n    QUANTIZATION_KEY,\n} from \"./core/session\";\nexport {\n    type DeclaredDim,\n    type DeclaredShape,\n    type ResolveInputSizeOptions,\n    classificationNumClasses,\n    declaredShapesFrom,\n    detectionNumClasses,\n    resolveInputSize,\n    spatialInputSize,\n} from \"./core/graph\";\nexport {\n    DEFAULT_TENSOR_TYPE,\n    type Float16ArrayLike,\n    asFloat32Array,\n    hasFloat16Array,\n    tensorTypeFor,\n} from \"./core/dtypes\";\nexport { modelNames, parseNames, readModelInputTypes, readModelMetadata } from \"./core/metadata\";\nexport {\n    DEFAULT_PROVIDERS,\n    type ProviderSpec,\n    detectProviders,\n    resolveProviders,\n} from \"./core/providers\";\nexport { type Speed, SpeedTimer } from \"./core/timing\";\nexport {\n    CUSTOM_NORMALIZATION,\n    IDENTITY_MEAN,\n    IDENTITY_STD,\n    IMAGENET_MEAN,\n    IMAGENET_STD,\n    type Normalization,\n    type ResolvedNormalization,\n    isUltralyticsClassifier,\n    resolveNormalization,\n} from \"./normalization\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    FUSION_KIND_DETECT_CLASSIFY,\n    FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n    INPUT_IMAGE,\n    INPUT_PAD,\n    INPUT_SCALE,\n    INPUT_SOURCE,\n    METADATA_PREFIX,\n    OUTPUT_BOXES,\n    OUTPUT_CLASSES,\n    OUTPUT_MASKS,\n    OUTPUT_NUM_DETECTIONS,\n    OUTPUT_PROBS,\n    OUTPUT_SCORES,\n    type CropSource,\n    type FusionSpec,\n    readFusionSpec,\n} from \"./fusion\";\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 {\n    type FusedLetterboxResult,\n    type FusedResizeResult,\n    LetterboxPipeline,\n    ResizePipeline,\n    letterboxToTensorData,\n    resizeToTensorData,\n    writePlanarFloat32,\n    zeroTensorData,\n} from \"./preprocess/pipeline\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask, requireDetections } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectClassifyOptions,\n    type DetectClassifyPredictOptions,\n    DetectClassify,\n} from \"./tasks/detectClassify\";\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.12.0\";\n"],"mappings":"A,0wBAwLA,IAAauB,EAAkB,S"}

package/dist/vision/index.js.map

@@ -1 +1 @@
-{"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.12.0` (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    DetectClassifyResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport {\n    COCO_CLASSES,\n    type LabelSpec,\n    type ResolveLabelsOptions,\n    defaultLabels,\n    resolveLabels,\n} from \"./labels\";\n\nexport {\n    FusionError,\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    NoDetectionsError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport {\n    DEFAULT_MODEL_CACHE,\n    GRAPH_OPTIMIZATION_KEY,\n    type ModelSource,\n    type OrtSessionOptions,\n    OrtSession,\n    QUANTIZATION_KEY,\n} from \"./core/session\";\nexport {\n    type DeclaredDim,\n    type DeclaredShape,\n    type ResolveInputSizeOptions,\n    classificationNumClasses,\n    declaredShapesFrom,\n    detectionNumClasses,\n    resolveInputSize,\n    spatialInputSize,\n} from \"./core/graph\";\nexport {\n    DEFAULT_TENSOR_TYPE,\n    type Float16ArrayLike,\n    asFloat32Array,\n    hasFloat16Array,\n    tensorTypeFor,\n} from \"./core/dtypes\";\nexport { modelNames, parseNames, readModelInputTypes, readModelMetadata } from \"./core/metadata\";\nexport {\n    DEFAULT_PROVIDERS,\n    type ProviderSpec,\n    detectProviders,\n    resolveProviders,\n} from \"./core/providers\";\nexport { type Speed, SpeedTimer } from \"./core/timing\";\nexport {\n    CUSTOM_NORMALIZATION,\n    IDENTITY_MEAN,\n    IDENTITY_STD,\n    IMAGENET_MEAN,\n    IMAGENET_STD,\n    type Normalization,\n    type ResolvedNormalization,\n    isUltralyticsClassifier,\n    resolveNormalization,\n} from \"./normalization\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    FUSION_KIND_DETECT_CLASSIFY,\n    FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n    INPUT_IMAGE,\n    INPUT_PAD,\n    INPUT_SCALE,\n    INPUT_SOURCE,\n    METADATA_PREFIX,\n    OUTPUT_BOXES,\n    OUTPUT_CLASSES,\n    OUTPUT_MASKS,\n    OUTPUT_NUM_DETECTIONS,\n    OUTPUT_PROBS,\n    OUTPUT_SCORES,\n    type CropSource,\n    type FusionSpec,\n    readFusionSpec,\n} from \"./fusion\";\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 {\n    type FusedLetterboxResult,\n    type FusedResizeResult,\n    LetterboxPipeline,\n    ResizePipeline,\n    letterboxToTensorData,\n    resizeToTensorData,\n    writePlanarFloat32,\n    zeroTensorData,\n} from \"./preprocess/pipeline\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask, requireDetections } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectClassifyOptions,\n    type DetectClassifyPredictOptions,\n    DetectClassify,\n} from \"./tasks/detectClassify\";\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.12.0\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwLA,IAAa,KAAkB"}
+{"version":3,"file":"index.js","names":["VERSION","BoundingBox","Boxes","COCO_CLASSES","CUSTOM_NORMALIZATION","ClassificationResults","Classifier","DEFAULT_MODEL_CACHE","DEFAULT_PROVIDERS","DEFAULT_TENSOR_TYPE","DetectClassify","DetectClassifyResults","DetectionResults","Detector","FUSION_KIND_DETECT_CLASSIFY","FUSION_KIND_DETECT_SEGMENT_CLASSIFY","FusionError","GRAPH_OPTIMIZATION_KEY","IDENTITY_MEAN","IDENTITY_STD","IMAGENET_MEAN","IMAGENET_STD","INPUT_IMAGE","INPUT_PAD","INPUT_SCALE","INPUT_SOURCE","ImageLoadError","InferenceError","LabelMapError","LetterboxPipeline","METADATA_PREFIX","Mask","Masks","ModelLoadError","NoDetectionsError","OUTPUT_BOXES","OUTPUT_CLASSES","OUTPUT_MASKS","OUTPUT_NUM_DETECTIONS","OUTPUT_PROBS","OUTPUT_SCORES","OrtSession","OrtVisionError","Probs","ProviderNotAvailableError","QUANTIZATION_KEY","RGBImage","ResizePipeline","SegmentationResults","Segmenter","SpeedTimer","VisionTask","asFloat32Array","batchedNms","classificationNumClasses","declaredShapesFrom","decodeYolo","decodeYoloAnchors","decodeYoloSeg","defaultLabels","detectProviders","detectionNumClasses","fromCv2","hasFloat16Array","isUltralyticsClassifier","letterbox","letterboxToTensorData","loadImage","modelNames","nms","normalize","parseNames","readFusionSpec","readModelInputTypes","readModelMetadata","requireDetections","resize","resizeToTensorData","resolveInputSize","resolveLabels","resolveNormalization","resolveProviders","softmax","spatialInputSize","tensorTypeFor","toCHW","toCv2","toFloat32","toFloat32Tensor","toTensor","topK","writePlanarFloat32","zeroTensorData"],"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.12.0` (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    DetectClassifyResults,\n    DetectionResults,\n    Masks,\n    Probs,\n    SegmentationResults,\n} from \"./results\";\n\nexport {\n    COCO_CLASSES,\n    type LabelSpec,\n    type ResolveLabelsOptions,\n    defaultLabels,\n    resolveLabels,\n} from \"./labels\";\n\nexport {\n    FusionError,\n    ImageLoadError,\n    InferenceError,\n    LabelMapError,\n    ModelLoadError,\n    NoDetectionsError,\n    OrtVisionError,\n    ProviderNotAvailableError,\n} from \"./core/exceptions\";\n\nexport {\n    DEFAULT_MODEL_CACHE,\n    GRAPH_OPTIMIZATION_KEY,\n    type ModelSource,\n    type OrtSessionOptions,\n    OrtSession,\n    QUANTIZATION_KEY,\n} from \"./core/session\";\nexport {\n    type DeclaredDim,\n    type DeclaredShape,\n    type ResolveInputSizeOptions,\n    classificationNumClasses,\n    declaredShapesFrom,\n    detectionNumClasses,\n    resolveInputSize,\n    spatialInputSize,\n} from \"./core/graph\";\nexport {\n    DEFAULT_TENSOR_TYPE,\n    type Float16ArrayLike,\n    asFloat32Array,\n    hasFloat16Array,\n    tensorTypeFor,\n} from \"./core/dtypes\";\nexport { modelNames, parseNames, readModelInputTypes, readModelMetadata } from \"./core/metadata\";\nexport {\n    DEFAULT_PROVIDERS,\n    type ProviderSpec,\n    detectProviders,\n    resolveProviders,\n} from \"./core/providers\";\nexport { type Speed, SpeedTimer } from \"./core/timing\";\nexport {\n    CUSTOM_NORMALIZATION,\n    IDENTITY_MEAN,\n    IDENTITY_STD,\n    IMAGENET_MEAN,\n    IMAGENET_STD,\n    type Normalization,\n    type ResolvedNormalization,\n    isUltralyticsClassifier,\n    resolveNormalization,\n} from \"./normalization\";\n\nexport { type ImageInput, loadImage } from \"./io/image\";\n\nexport {\n    FUSION_KIND_DETECT_CLASSIFY,\n    FUSION_KIND_DETECT_SEGMENT_CLASSIFY,\n    INPUT_IMAGE,\n    INPUT_PAD,\n    INPUT_SCALE,\n    INPUT_SOURCE,\n    METADATA_PREFIX,\n    OUTPUT_BOXES,\n    OUTPUT_CLASSES,\n    OUTPUT_MASKS,\n    OUTPUT_NUM_DETECTIONS,\n    OUTPUT_PROBS,\n    OUTPUT_SCORES,\n    type CropSource,\n    type FusionSpec,\n    readFusionSpec,\n} from \"./fusion\";\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 {\n    type FusedLetterboxResult,\n    type FusedResizeResult,\n    LetterboxPipeline,\n    ResizePipeline,\n    letterboxToTensorData,\n    resizeToTensorData,\n    writePlanarFloat32,\n    zeroTensorData,\n} from \"./preprocess/pipeline\";\n\nexport { type TopKResult, softmax, topK } from \"./postprocess/classification\";\n\nexport {\n    type DecodeYoloAnchorsOptions,\n    type DecodeYoloOptions,\n    type DecodedAnchors,\n    type DecodedDetection,\n    batchedNms,\n    decodeYolo,\n    decodeYoloAnchors,\n    nms,\n} from \"./postprocess/detection\";\n\nexport {\n    type DecodeYoloSegOptions,\n    type DecodedSegmentation,\n    decodeYoloSeg,\n} from \"./postprocess/segmentation\";\n\nexport { VisionTask, requireDetections } from \"./tasks/base\";\nexport {\n    type ClassifierOptions,\n    type ClassifierPredictOptions,\n    Classifier,\n} from \"./tasks/classifier\";\nexport {\n    type DetectClassifyOptions,\n    type DetectClassifyPredictOptions,\n    DetectClassify,\n} from \"./tasks/detectClassify\";\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.12.0\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwLA,IAAaA,KAAkB"}

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

@@ -1 +1 @@
-{"version":3,"file":"image.cjs","names":[],"sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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, imageDataToRGBChecked } 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    | HTMLVideoElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | VideoFrame\n    | ImageData\n    | RGBImage;\n\n/**\n * A decoded input, plus what the tasks can reuse from decoding it.\n *\n * Internal to the SDK: the tasks need more than {@link loadImage} returns, and\n * the extra fields are about avoiding work, not about the image itself.\n */\nexport interface LoadedImage {\n    /** The input as the canonical HWC RGB image. */\n    readonly image: RGBImage;\n    /**\n     * A full-resolution canvas holding exactly {@link image}'s pixels, or `null`.\n     *\n     * Decoding any drawable already paints it onto a canvas to read it back.\n     * Handing that canvas to a preprocessing pipeline lets it `drawImage` the\n     * frame straight into the model input, instead of rebuilding RGBA from\n     * {@link image} and `putImageData`-ing it onto a canvas of its own — two\n     * full-resolution passes and an allocation the size of the frame. Only set\n     * when every pixel was opaque: a translucent pixel composites differently\n     * from the RGB that dropping its alpha kept.\n     */\n    readonly canvas: CanvasImageSource | null;\n    /**\n     * Whether {@link image}'s buffer was allocated here rather than passed in.\n     *\n     * An `RGBImage` the caller handed over is theirs, and a video loop may well\n     * refill the same buffer every frame. Anything derived from it lazily would\n     * then read a later frame, so lazy crops are only taken on owned buffers.\n     */\n    readonly owned: boolean;\n}\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * A video element must have its current frame available (`readyState >= 2`);\n * the frame showing at the time of the call is the one decoded. A `VideoFrame`\n * is read but not closed — it belongs to the caller.\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    return (await loadImageSource(source)).image;\n}\n\n/**\n * Decode an input like {@link loadImage}, keeping what preprocessing can reuse.\n *\n * @param source Any {@link ImageInput}.\n * @returns The image, the canvas it was painted on (when reusable), and\n *   whether the SDK owns the pixel buffer.\n * @throws {@link ImageLoadError} if the source cannot be decoded.\n */\nexport async function loadImageSource(source: ImageInput): Promise<LoadedImage> {\n    if (source instanceof RGBImage) {\n        return { image: source, canvas: null, owned: false };\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return { image: imageDataToRGBChecked(source).image, canvas: null, owned: true };\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 HTMLVideoElement !== \"undefined\" && source instanceof HTMLVideoElement) {\n        if (source.readyState < 2) {\n            throw new ImageLoadError(\n                \"HTMLVideoElement has no current frame yet (readyState < HAVE_CURRENT_DATA). \" +\n                    \"Wait for its 'loadeddata' event before predicting on it.\",\n            );\n        }\n        return drawableToRGB(source, source.videoWidth, source.videoHeight, isLiveStream(source));\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    if (typeof VideoFrame !== \"undefined\" && source instanceof VideoFrame) {\n        return drawableToRGB(\n            source,\n            source.displayWidth,\n            source.displayHeight,\n            source.format !== null && OPAQUE_FRAME_FORMATS.has(source.format),\n        );\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<LoadedImage> {\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<LoadedImage> {\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, blob.type === \"image/jpeg\");\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\n/**\n * `VideoFrame` pixel formats that carry no alpha channel.\n *\n * The `A`-suffixed planar formats and `RGBA`/`BGRA` do; a frame in one of\n * these never has a translucent pixel.\n */\nconst OPAQUE_FRAME_FORMATS: ReadonlySet<string> = new Set([\n    \"I420\",\n    \"I422\",\n    \"I444\",\n    \"NV12\",\n    \"RGBX\",\n    \"BGRX\",\n]);\n\n/**\n * Whether a video element is playing a live capture (camera, screen).\n *\n * `MediaStream` video tracks carry no alpha, so every frame is opaque. A video\n * playing a file may not be — VP9 with alpha exists — so it gets no such\n * promise.\n *\n * @param video The element.\n */\nfunction isLiveStream(video: HTMLVideoElement): boolean {\n    return typeof MediaStream !== \"undefined\" && video.srcObject instanceof MediaStream;\n}\n\n/**\n * Paint a drawable onto a fresh canvas and read it back as RGB.\n *\n * When the source is known to be opaque without looking — a JPEG, a camera\n * frame, an alpha-less `VideoFrame` — the read-back is deferred: the image's\n * pixels come out of the canvas the first time something reads `data`. The\n * canvas is this call's own, so it still holds the frame of this moment\n * however late that read happens. Preprocessing draws from the canvas and\n * never reads `data`, so a loop that only consumes boxes skips the\n * full-resolution `getImageData` altogether.\n *\n * Any other source is read back now, because whether its canvas may stand in\n * for the RGB image depends on every pixel being opaque, and only the read\n * tells.\n *\n * @param drawable The source to decode.\n * @param width Its intrinsic width.\n * @param height Its intrinsic height.\n * @param knownOpaque Whether the source cannot contain a translucent pixel.\n * @returns The decoded image, with the canvas attached when it is opaque.\n * @throws {@link ImageLoadError} for a zero-sized source.\n */\nfunction drawableToRGB(\n    drawable: CanvasImageSource,\n    width: number,\n    height: number,\n    knownOpaque: boolean = false,\n): LoadedImage {\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, width, height);\n    if (knownOpaque) {\n        const image = RGBImage.deferred(\n            width,\n            height,\n            () => imageDataToRGBChecked(ctx.getImageData(0, 0, width, height)).image.data,\n        );\n        return { image, canvas, owned: true };\n    }\n    const { image, opaque } = imageDataToRGBChecked(ctx.getImageData(0, 0, width, height));\n    return { image, canvas: opaque ? canvas : null, owned: true };\n}\n"],"mappings":"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"}
+{"version":3,"file":"image.cjs","names":["RGBImage","imageDataToRGBChecked","ImageLoadError","createCanvas","get2DContext","require_exceptions","require_types","require_canvas","loadImage","loadImageSource","source","loadFromUrl","loadFromBlob","waitForImageElement","drawableToRGB","isLiveStream","OPAQUE_FRAME_FORMATS","response","url","err","bitmap","blob","img","onLoad","cleanup","resolve","onError","reject","video","width","height","canvas","ctx","drawable","knownOpaque","opaque"],"sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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, imageDataToRGBChecked } 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    | HTMLVideoElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | VideoFrame\n    | ImageData\n    | RGBImage;\n\n/**\n * A decoded input, plus what the tasks can reuse from decoding it.\n *\n * Internal to the SDK: the tasks need more than {@link loadImage} returns, and\n * the extra fields are about avoiding work, not about the image itself.\n */\nexport interface LoadedImage {\n    /** The input as the canonical HWC RGB image. */\n    readonly image: RGBImage;\n    /**\n     * A full-resolution canvas holding exactly {@link image}'s pixels, or `null`.\n     *\n     * Decoding any drawable already paints it onto a canvas to read it back.\n     * Handing that canvas to a preprocessing pipeline lets it `drawImage` the\n     * frame straight into the model input, instead of rebuilding RGBA from\n     * {@link image} and `putImageData`-ing it onto a canvas of its own — two\n     * full-resolution passes and an allocation the size of the frame. Only set\n     * when every pixel was opaque: a translucent pixel composites differently\n     * from the RGB that dropping its alpha kept.\n     */\n    readonly canvas: CanvasImageSource | null;\n    /**\n     * Whether {@link image}'s buffer was allocated here rather than passed in.\n     *\n     * An `RGBImage` the caller handed over is theirs, and a video loop may well\n     * refill the same buffer every frame. Anything derived from it lazily would\n     * then read a later frame, so lazy crops are only taken on owned buffers.\n     */\n    readonly owned: boolean;\n}\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * A video element must have its current frame available (`readyState >= 2`);\n * the frame showing at the time of the call is the one decoded. A `VideoFrame`\n * is read but not closed — it belongs to the caller.\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    return (await loadImageSource(source)).image;\n}\n\n/**\n * Decode an input like {@link loadImage}, keeping what preprocessing can reuse.\n *\n * @param source Any {@link ImageInput}.\n * @returns The image, the canvas it was painted on (when reusable), and\n *   whether the SDK owns the pixel buffer.\n * @throws {@link ImageLoadError} if the source cannot be decoded.\n */\nexport async function loadImageSource(source: ImageInput): Promise<LoadedImage> {\n    if (source instanceof RGBImage) {\n        return { image: source, canvas: null, owned: false };\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return { image: imageDataToRGBChecked(source).image, canvas: null, owned: true };\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 HTMLVideoElement !== \"undefined\" && source instanceof HTMLVideoElement) {\n        if (source.readyState < 2) {\n            throw new ImageLoadError(\n                \"HTMLVideoElement has no current frame yet (readyState < HAVE_CURRENT_DATA). \" +\n                    \"Wait for its 'loadeddata' event before predicting on it.\",\n            );\n        }\n        return drawableToRGB(source, source.videoWidth, source.videoHeight, isLiveStream(source));\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    if (typeof VideoFrame !== \"undefined\" && source instanceof VideoFrame) {\n        return drawableToRGB(\n            source,\n            source.displayWidth,\n            source.displayHeight,\n            source.format !== null && OPAQUE_FRAME_FORMATS.has(source.format),\n        );\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<LoadedImage> {\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<LoadedImage> {\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, blob.type === \"image/jpeg\");\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\n/**\n * `VideoFrame` pixel formats that carry no alpha channel.\n *\n * The `A`-suffixed planar formats and `RGBA`/`BGRA` do; a frame in one of\n * these never has a translucent pixel.\n */\nconst OPAQUE_FRAME_FORMATS: ReadonlySet<string> = new Set([\n    \"I420\",\n    \"I422\",\n    \"I444\",\n    \"NV12\",\n    \"RGBX\",\n    \"BGRX\",\n]);\n\n/**\n * Whether a video element is playing a live capture (camera, screen).\n *\n * `MediaStream` video tracks carry no alpha, so every frame is opaque. A video\n * playing a file may not be — VP9 with alpha exists — so it gets no such\n * promise.\n *\n * @param video The element.\n */\nfunction isLiveStream(video: HTMLVideoElement): boolean {\n    return typeof MediaStream !== \"undefined\" && video.srcObject instanceof MediaStream;\n}\n\n/**\n * Paint a drawable onto a fresh canvas and read it back as RGB.\n *\n * When the source is known to be opaque without looking — a JPEG, a camera\n * frame, an alpha-less `VideoFrame` — the read-back is deferred: the image's\n * pixels come out of the canvas the first time something reads `data`. The\n * canvas is this call's own, so it still holds the frame of this moment\n * however late that read happens. Preprocessing draws from the canvas and\n * never reads `data`, so a loop that only consumes boxes skips the\n * full-resolution `getImageData` altogether.\n *\n * Any other source is read back now, because whether its canvas may stand in\n * for the RGB image depends on every pixel being opaque, and only the read\n * tells.\n *\n * @param drawable The source to decode.\n * @param width Its intrinsic width.\n * @param height Its intrinsic height.\n * @param knownOpaque Whether the source cannot contain a translucent pixel.\n * @returns The decoded image, with the canvas attached when it is opaque.\n * @throws {@link ImageLoadError} for a zero-sized source.\n */\nfunction drawableToRGB(\n    drawable: CanvasImageSource,\n    width: number,\n    height: number,\n    knownOpaque: boolean = false,\n): LoadedImage {\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, width, height);\n    if (knownOpaque) {\n        const image = RGBImage.deferred(\n            width,\n            height,\n            () => imageDataToRGBChecked(ctx.getImageData(0, 0, width, height)).image.data,\n        );\n        return { image, canvas, owned: true };\n    }\n    const { image, opaque } = imageDataToRGBChecked(ctx.getImageData(0, 0, width, height));\n    return { image, canvas: opaque ? canvas : null, owned: true };\n}\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","names":[],"sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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, imageDataToRGBChecked } 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    | HTMLVideoElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | VideoFrame\n    | ImageData\n    | RGBImage;\n\n/**\n * A decoded input, plus what the tasks can reuse from decoding it.\n *\n * Internal to the SDK: the tasks need more than {@link loadImage} returns, and\n * the extra fields are about avoiding work, not about the image itself.\n */\nexport interface LoadedImage {\n    /** The input as the canonical HWC RGB image. */\n    readonly image: RGBImage;\n    /**\n     * A full-resolution canvas holding exactly {@link image}'s pixels, or `null`.\n     *\n     * Decoding any drawable already paints it onto a canvas to read it back.\n     * Handing that canvas to a preprocessing pipeline lets it `drawImage` the\n     * frame straight into the model input, instead of rebuilding RGBA from\n     * {@link image} and `putImageData`-ing it onto a canvas of its own — two\n     * full-resolution passes and an allocation the size of the frame. Only set\n     * when every pixel was opaque: a translucent pixel composites differently\n     * from the RGB that dropping its alpha kept.\n     */\n    readonly canvas: CanvasImageSource | null;\n    /**\n     * Whether {@link image}'s buffer was allocated here rather than passed in.\n     *\n     * An `RGBImage` the caller handed over is theirs, and a video loop may well\n     * refill the same buffer every frame. Anything derived from it lazily would\n     * then read a later frame, so lazy crops are only taken on owned buffers.\n     */\n    readonly owned: boolean;\n}\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * A video element must have its current frame available (`readyState >= 2`);\n * the frame showing at the time of the call is the one decoded. A `VideoFrame`\n * is read but not closed — it belongs to the caller.\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    return (await loadImageSource(source)).image;\n}\n\n/**\n * Decode an input like {@link loadImage}, keeping what preprocessing can reuse.\n *\n * @param source Any {@link ImageInput}.\n * @returns The image, the canvas it was painted on (when reusable), and\n *   whether the SDK owns the pixel buffer.\n * @throws {@link ImageLoadError} if the source cannot be decoded.\n */\nexport async function loadImageSource(source: ImageInput): Promise<LoadedImage> {\n    if (source instanceof RGBImage) {\n        return { image: source, canvas: null, owned: false };\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return { image: imageDataToRGBChecked(source).image, canvas: null, owned: true };\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 HTMLVideoElement !== \"undefined\" && source instanceof HTMLVideoElement) {\n        if (source.readyState < 2) {\n            throw new ImageLoadError(\n                \"HTMLVideoElement has no current frame yet (readyState < HAVE_CURRENT_DATA). \" +\n                    \"Wait for its 'loadeddata' event before predicting on it.\",\n            );\n        }\n        return drawableToRGB(source, source.videoWidth, source.videoHeight, isLiveStream(source));\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    if (typeof VideoFrame !== \"undefined\" && source instanceof VideoFrame) {\n        return drawableToRGB(\n            source,\n            source.displayWidth,\n            source.displayHeight,\n            source.format !== null && OPAQUE_FRAME_FORMATS.has(source.format),\n        );\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<LoadedImage> {\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<LoadedImage> {\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, blob.type === \"image/jpeg\");\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\n/**\n * `VideoFrame` pixel formats that carry no alpha channel.\n *\n * The `A`-suffixed planar formats and `RGBA`/`BGRA` do; a frame in one of\n * these never has a translucent pixel.\n */\nconst OPAQUE_FRAME_FORMATS: ReadonlySet<string> = new Set([\n    \"I420\",\n    \"I422\",\n    \"I444\",\n    \"NV12\",\n    \"RGBX\",\n    \"BGRX\",\n]);\n\n/**\n * Whether a video element is playing a live capture (camera, screen).\n *\n * `MediaStream` video tracks carry no alpha, so every frame is opaque. A video\n * playing a file may not be — VP9 with alpha exists — so it gets no such\n * promise.\n *\n * @param video The element.\n */\nfunction isLiveStream(video: HTMLVideoElement): boolean {\n    return typeof MediaStream !== \"undefined\" && video.srcObject instanceof MediaStream;\n}\n\n/**\n * Paint a drawable onto a fresh canvas and read it back as RGB.\n *\n * When the source is known to be opaque without looking — a JPEG, a camera\n * frame, an alpha-less `VideoFrame` — the read-back is deferred: the image's\n * pixels come out of the canvas the first time something reads `data`. The\n * canvas is this call's own, so it still holds the frame of this moment\n * however late that read happens. Preprocessing draws from the canvas and\n * never reads `data`, so a loop that only consumes boxes skips the\n * full-resolution `getImageData` altogether.\n *\n * Any other source is read back now, because whether its canvas may stand in\n * for the RGB image depends on every pixel being opaque, and only the read\n * tells.\n *\n * @param drawable The source to decode.\n * @param width Its intrinsic width.\n * @param height Its intrinsic height.\n * @param knownOpaque Whether the source cannot contain a translucent pixel.\n * @returns The decoded image, with the canvas attached when it is opaque.\n * @throws {@link ImageLoadError} for a zero-sized source.\n */\nfunction drawableToRGB(\n    drawable: CanvasImageSource,\n    width: number,\n    height: number,\n    knownOpaque: boolean = false,\n): LoadedImage {\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, width, height);\n    if (knownOpaque) {\n        const image = RGBImage.deferred(\n            width,\n            height,\n            () => imageDataToRGBChecked(ctx.getImageData(0, 0, width, height)).image.data,\n        );\n        return { image, canvas, owned: true };\n    }\n    const { image, opaque } = imageDataToRGBChecked(ctx.getImageData(0, 0, width, height));\n    return { image, canvas: opaque ? canvas : null, owned: true };\n}\n"],"mappings":"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"}
+{"version":3,"file":"image.js","names":["loadImage","loadImageSource","source","RGBImage","imageDataToRGBChecked","loadFromUrl","loadFromBlob","waitForImageElement","drawableToRGB","ImageLoadError","isLiveStream","OPAQUE_FRAME_FORMATS","response","url","err","bitmap","blob","img","onLoad","cleanup","resolve","onError","reject","video","width","height","canvas","createCanvas","ctx","get2DContext","drawable","knownOpaque","opaque"],"sources":["../../../src/vision/io/image.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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, imageDataToRGBChecked } 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    | HTMLVideoElement\n    | HTMLCanvasElement\n    | OffscreenCanvas\n    | ImageBitmap\n    | VideoFrame\n    | ImageData\n    | RGBImage;\n\n/**\n * A decoded input, plus what the tasks can reuse from decoding it.\n *\n * Internal to the SDK: the tasks need more than {@link loadImage} returns, and\n * the extra fields are about avoiding work, not about the image itself.\n */\nexport interface LoadedImage {\n    /** The input as the canonical HWC RGB image. */\n    readonly image: RGBImage;\n    /**\n     * A full-resolution canvas holding exactly {@link image}'s pixels, or `null`.\n     *\n     * Decoding any drawable already paints it onto a canvas to read it back.\n     * Handing that canvas to a preprocessing pipeline lets it `drawImage` the\n     * frame straight into the model input, instead of rebuilding RGBA from\n     * {@link image} and `putImageData`-ing it onto a canvas of its own — two\n     * full-resolution passes and an allocation the size of the frame. Only set\n     * when every pixel was opaque: a translucent pixel composites differently\n     * from the RGB that dropping its alpha kept.\n     */\n    readonly canvas: CanvasImageSource | null;\n    /**\n     * Whether {@link image}'s buffer was allocated here rather than passed in.\n     *\n     * An `RGBImage` the caller handed over is theirs, and a video loop may well\n     * refill the same buffer every frame. Anything derived from it lazily would\n     * then read a later frame, so lazy crops are only taken on owned buffers.\n     */\n    readonly owned: boolean;\n}\n\n/**\n * Load an image from any supported source into a HWC uint8 RGB array.\n *\n * A video element must have its current frame available (`readyState >= 2`);\n * the frame showing at the time of the call is the one decoded. A `VideoFrame`\n * is read but not closed — it belongs to the caller.\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    return (await loadImageSource(source)).image;\n}\n\n/**\n * Decode an input like {@link loadImage}, keeping what preprocessing can reuse.\n *\n * @param source Any {@link ImageInput}.\n * @returns The image, the canvas it was painted on (when reusable), and\n *   whether the SDK owns the pixel buffer.\n * @throws {@link ImageLoadError} if the source cannot be decoded.\n */\nexport async function loadImageSource(source: ImageInput): Promise<LoadedImage> {\n    if (source instanceof RGBImage) {\n        return { image: source, canvas: null, owned: false };\n    }\n\n    if (typeof ImageData !== \"undefined\" && source instanceof ImageData) {\n        return { image: imageDataToRGBChecked(source).image, canvas: null, owned: true };\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 HTMLVideoElement !== \"undefined\" && source instanceof HTMLVideoElement) {\n        if (source.readyState < 2) {\n            throw new ImageLoadError(\n                \"HTMLVideoElement has no current frame yet (readyState < HAVE_CURRENT_DATA). \" +\n                    \"Wait for its 'loadeddata' event before predicting on it.\",\n            );\n        }\n        return drawableToRGB(source, source.videoWidth, source.videoHeight, isLiveStream(source));\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    if (typeof VideoFrame !== \"undefined\" && source instanceof VideoFrame) {\n        return drawableToRGB(\n            source,\n            source.displayWidth,\n            source.displayHeight,\n            source.format !== null && OPAQUE_FRAME_FORMATS.has(source.format),\n        );\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<LoadedImage> {\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<LoadedImage> {\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, blob.type === \"image/jpeg\");\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\n/**\n * `VideoFrame` pixel formats that carry no alpha channel.\n *\n * The `A`-suffixed planar formats and `RGBA`/`BGRA` do; a frame in one of\n * these never has a translucent pixel.\n */\nconst OPAQUE_FRAME_FORMATS: ReadonlySet<string> = new Set([\n    \"I420\",\n    \"I422\",\n    \"I444\",\n    \"NV12\",\n    \"RGBX\",\n    \"BGRX\",\n]);\n\n/**\n * Whether a video element is playing a live capture (camera, screen).\n *\n * `MediaStream` video tracks carry no alpha, so every frame is opaque. A video\n * playing a file may not be — VP9 with alpha exists — so it gets no such\n * promise.\n *\n * @param video The element.\n */\nfunction isLiveStream(video: HTMLVideoElement): boolean {\n    return typeof MediaStream !== \"undefined\" && video.srcObject instanceof MediaStream;\n}\n\n/**\n * Paint a drawable onto a fresh canvas and read it back as RGB.\n *\n * When the source is known to be opaque without looking — a JPEG, a camera\n * frame, an alpha-less `VideoFrame` — the read-back is deferred: the image's\n * pixels come out of the canvas the first time something reads `data`. The\n * canvas is this call's own, so it still holds the frame of this moment\n * however late that read happens. Preprocessing draws from the canvas and\n * never reads `data`, so a loop that only consumes boxes skips the\n * full-resolution `getImageData` altogether.\n *\n * Any other source is read back now, because whether its canvas may stand in\n * for the RGB image depends on every pixel being opaque, and only the read\n * tells.\n *\n * @param drawable The source to decode.\n * @param width Its intrinsic width.\n * @param height Its intrinsic height.\n * @param knownOpaque Whether the source cannot contain a translucent pixel.\n * @returns The decoded image, with the canvas attached when it is opaque.\n * @throws {@link ImageLoadError} for a zero-sized source.\n */\nfunction drawableToRGB(\n    drawable: CanvasImageSource,\n    width: number,\n    height: number,\n    knownOpaque: boolean = false,\n): LoadedImage {\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, width, height);\n    if (knownOpaque) {\n        const image = RGBImage.deferred(\n            width,\n            height,\n            () => imageDataToRGBChecked(ctx.getImageData(0, 0, width, height)).image.data,\n        );\n        return { image, canvas, owned: true };\n    }\n    const { image, opaque } = imageDataToRGBChecked(ctx.getImageData(0, 0, width, height));\n    return { image, canvas: opaque ? canvas : null, owned: true };\n}\n"],"mappings":"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"}

package/dist/vision/labels.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"labels.cjs","names":[],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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 */\n/**\n * Pick the fallback label spec for a model that declares no class names.\n *\n * The COCO preset is the right default for a stock YOLO export and an\n * impossible one for anything else: it names exactly 80 classes, so handing it\n * to a 3-class head makes {@link resolveLabels} throw `Resolved 80 labels but\n * the model has 3 classes` and the task cannot be created at all. A custom\n * model without baked-in `names` is an ordinary thing to have — it should come\n * up as `class_0`, `class_1`, ..., not as a failure.\n *\n * @param numClasses Classes the model predicts, or `undefined` when the output\n *   shape does not say.\n * @returns `\"coco\"` when the preset can describe the model, otherwise `null`,\n *   which makes {@link resolveLabels} generate `class_N` names.\n */\nexport function defaultLabels(numClasses: number | undefined): LabelSpec {\n    if (numClasses === undefined || numClasses === COCO_CLASSES.length) {\n        return \"coco\";\n    }\n    return null;\n}\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":"yCAyBA,IAAa,EAAkC,OAAO,OAAO,wnBAiF7D,CAAC,EAEK,EAAuD,CACzD,KAAM,CACV,EAiCA,SAAgB,EAAc,EAA2C,CAIrE,OAHI,IAAe,IAAA,IAAa,IAAe,EAAa,OACjD,OAEJ,IACX,CAEA,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"}
+{"version":3,"file":"labels.cjs","names":["LabelMapError","require_exceptions","COCO_CLASSES","PRESETS","defaultLabels","numClasses","resolveLabels","labels","resolve","spec","options","i","preset","map","ids","k","maxId"],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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 */\n/**\n * Pick the fallback label spec for a model that declares no class names.\n *\n * The COCO preset is the right default for a stock YOLO export and an\n * impossible one for anything else: it names exactly 80 classes, so handing it\n * to a 3-class head makes {@link resolveLabels} throw `Resolved 80 labels but\n * the model has 3 classes` and the task cannot be created at all. A custom\n * model without baked-in `names` is an ordinary thing to have — it should come\n * up as `class_0`, `class_1`, ..., not as a failure.\n *\n * @param numClasses Classes the model predicts, or `undefined` when the output\n *   shape does not say.\n * @returns `\"coco\"` when the preset can describe the model, otherwise `null`,\n *   which makes {@link resolveLabels} generate `class_N` names.\n */\nexport function defaultLabels(numClasses: number | undefined): LabelSpec {\n    if (numClasses === undefined || numClasses === COCO_CLASSES.length) {\n        return \"coco\";\n    }\n    return null;\n}\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":"A,yCAyBA,IAAaE,EAAkC,OAAO,OAAO,wnBAiF7D,CAAC,EAEKC,EAAuD,CACzD,KAAMD,CACV,EAiCA,SAAgBE,EAAc,EAA2C,CAIrE,OAHIC,IAAe,IAAA,IAAaA,IAAeH,EAAa,OACjD,OAEJ,IACX,CAEA,SAAgBI,EACZ,EACA,EAAgC,CAAC,EAChB,CACjB,IAAMC,EAASC,EAAQC,EAAMC,EAAQ,UAAU,EAC/C,GAAIA,EAAQ,aAAe,IAAA,IAAaH,EAAO,SAAWG,EAAQ,WAC9D,MAAM,IAAIV,EAAAA,cACN,YAAYO,EAAO,OAAO,4BAA4BG,EAAQ,WAAW,UAC7E,EAEJ,OAAOH,CACX,CAEA,SAASC,EAAQ,EAAiB,EAAmD,CACjF,GAAIC,GAAS,KAA4B,CACrC,GAAIJ,IAAe,IAAA,GACf,MAAM,IAAIL,EAAAA,cACN,6FACJ,EAEJ,OAAO,MAAM,KAAK,CAAE,OAAQK,CAAW,GAAI,EAAG,IAAM,SAASM,GAAG,CACpE,CAEA,GAAI,MAAM,QAAQF,CAAI,EAClB,MAAO,CAAC,GAAGA,CAAI,EAGnB,GAAI,OAAOA,GAAS,SAAU,CAC1B,IAAMG,EAAST,EAAQM,GACvB,GAAIG,IAAW,IAAA,GACX,OAAOA,EAEX,MAAM,IAAIZ,EAAAA,cACN,0BAA0B,KAAK,UAAUS,CAAI,EAAE,mBAAmB,OAAO,KAAKN,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG,CACJ,CAEA,GAAI,OAAOM,GAAS,SAAU,CAC1B,IAAMI,EAAMJ,EACNK,EAAM,OAAO,KAAKD,CAAG,CAAC,CAAC,IAAK,GAAM,OAAOE,CAAC,CAAC,EACjD,GAAID,EAAI,SAAW,EACf,MAAO,CAAC,EAEZ,IAAME,EAAQ,KAAK,IAAI,GAAGF,CAAG,EAC7B,OAAO,MAAM,KAAK,CAAE,OAAQE,EAAQ,CAAE,GAAI,EAAG,IAAMH,EAAIF,IAAM,SAASA,GAAG,CAC7E,CAEA,MAAM,IAAIX,EAAAA,cAAc,iCAAiC,OAAOS,EAAK,EAAE,CAC3E,C"}

package/dist/vision/labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"labels.js","names":[],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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 */\n/**\n * Pick the fallback label spec for a model that declares no class names.\n *\n * The COCO preset is the right default for a stock YOLO export and an\n * impossible one for anything else: it names exactly 80 classes, so handing it\n * to a 3-class head makes {@link resolveLabels} throw `Resolved 80 labels but\n * the model has 3 classes` and the task cannot be created at all. A custom\n * model without baked-in `names` is an ordinary thing to have — it should come\n * up as `class_0`, `class_1`, ..., not as a failure.\n *\n * @param numClasses Classes the model predicts, or `undefined` when the output\n *   shape does not say.\n * @returns `\"coco\"` when the preset can describe the model, otherwise `null`,\n *   which makes {@link resolveLabels} generate `class_N` names.\n */\nexport function defaultLabels(numClasses: number | undefined): LabelSpec {\n    if (numClasses === undefined || numClasses === COCO_CLASSES.length) {\n        return \"coco\";\n    }\n    return null;\n}\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":";;AAyBA,IAAa,IAAkC,OAAO,OAAO,woBAiF7D,CAAC,GAEK,IAAuD,EACzD,MAAM,EACV;AAiCA,SAAgB,EAAc,GAA2C;CAIrE,OAHI,MAAe,KAAA,KAAa,MAAe,EAAa,SACjD,SAEJ;AACX;AAEA,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"}
+{"version":3,"file":"labels.js","names":["COCO_CLASSES","PRESETS","defaultLabels","numClasses","resolveLabels","labels","resolve","spec","options","LabelMapError","i","preset","map","ids","k","maxId"],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\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 */\n/**\n * Pick the fallback label spec for a model that declares no class names.\n *\n * The COCO preset is the right default for a stock YOLO export and an\n * impossible one for anything else: it names exactly 80 classes, so handing it\n * to a 3-class head makes {@link resolveLabels} throw `Resolved 80 labels but\n * the model has 3 classes` and the task cannot be created at all. A custom\n * model without baked-in `names` is an ordinary thing to have — it should come\n * up as `class_0`, `class_1`, ..., not as a failure.\n *\n * @param numClasses Classes the model predicts, or `undefined` when the output\n *   shape does not say.\n * @returns `\"coco\"` when the preset can describe the model, otherwise `null`,\n *   which makes {@link resolveLabels} generate `class_N` names.\n */\nexport function defaultLabels(numClasses: number | undefined): LabelSpec {\n    if (numClasses === undefined || numClasses === COCO_CLASSES.length) {\n        return \"coco\";\n    }\n    return null;\n}\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":";;AAyBA,IAAaA,IAAkC,OAAO,OAAO,woBAiF7D,CAAC,GAEKC,IAAuD,EACzD,MAAMD,EACV;AAiCA,SAAgBE,EAAc,GAA2C;CAIrE,OAHIC,MAAe,KAAA,KAAaA,MAAeH,EAAa,SACjD,SAEJ;AACX;AAEA,SAAgBI,EACZ,GACA,IAAgC,CAAC,GAChB;CACjB,IAAMC,IAASC,EAAQC,GAAMC,EAAQ,UAAU;CAC/C,IAAIA,EAAQ,eAAe,KAAA,KAAaH,EAAO,WAAWG,EAAQ,YAC9D,MAAM,IAAIC,EACN,YAAYJ,EAAO,OAAO,4BAA4BG,EAAQ,WAAW,UAC7E;CAEJ,OAAOH;AACX;AAEA,SAASC,EAAQ,GAAiB,GAAmD;CACjF,IAAIC,KAAS,MAA4B;EACrC,IAAIJ,MAAe,KAAA,GACf,MAAM,IAAIM,EACN,6FACJ;EAEJ,OAAO,MAAM,KAAK,EAAE,QAAQN,EAAW,IAAI,GAAG,MAAM,SAASO,GAAG;CACpE;CAEA,IAAI,MAAM,QAAQH,CAAI,GAClB,OAAO,CAAC,GAAGA,CAAI;CAGnB,IAAI,OAAOA,KAAS,UAAU;EAC1B,IAAMI,IAASV,EAAQM;EACvB,IAAII,MAAW,KAAA,GACX,OAAOA;EAEX,MAAM,IAAIF,EACN,0BAA0B,KAAK,UAAUF,CAAI,EAAE,mBAAmB,OAAO,KAAKN,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG;CACJ;CAEA,IAAI,OAAOM,KAAS,UAAU;EAC1B,IAAMK,IAAML,GACNM,IAAM,OAAO,KAAKD,CAAG,CAAC,CAAC,KAAK,MAAM,OAAOE,CAAC,CAAC;EACjD,IAAID,EAAI,WAAW,GACf,OAAO,CAAC;EAEZ,IAAME,IAAQ,KAAK,IAAI,GAAGF,CAAG;EAC7B,OAAO,MAAM,KAAK,EAAE,QAAQE,IAAQ,EAAE,IAAI,GAAG,MAAMH,EAAIF,MAAM,SAASA,GAAG;CAC7E;CAEA,MAAM,IAAID,EAAc,iCAAiC,OAAOF,EAAK,EAAE;AAC3E"}

package/dist/vision/luminance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"luminance.cjs","names":[],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * frame (`<img>`, `<video>`, `<canvas>`, `ImageBitmap` or `OffscreenCanvas`) so\n * a UI can reject underexposed captures before paying the cost of downstream\n * inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/**\n * Drawable source we can sample luminance from.\n *\n * The list tracks what `CanvasRenderingContext2D.drawImage` accepts and we can\n * read a pixel size off, which is what the implementation actually needs.\n * `ImageBitmap` matters for the decode-downscaled path: `createImageBitmap(blob,\n * { resizeWidth })` is how a caller avoids materialising a full-resolution\n * phone photo, and the frame it hands back is the frame whose brightness has to\n * be checked.\n */\nexport type LuminanceSource =\n    HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas;\n\n/**\n * Natural pixel size of the source (`0`/`0` while it is still unloaded).\n *\n * `ImageBitmap` and `OffscreenCanvas` both expose plain `width`/`height`, so\n * they fall through to the same branch as a canvas — but they are named\n * explicitly rather than left to the `naturalWidth || width` fallback, which\n * only reads as intentional for an `<img>`.\n */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLImageElement) {\n        return {\n            width: source.naturalWidth || source.width,\n            height: source.naturalHeight || source.height,\n        };\n    }\n    return { width: source.width, height: source.height };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded frame,\n * scaled to `0..255`. See {@link LuminanceSource} for what counts as one.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the decoded frame to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":"AAkBA,IAAa,EAA4B,IAuBzC,SAAS,EAAW,EAA4D,CAU5E,OATI,aAAkB,iBACX,CAAE,MAAO,EAAO,WAAY,OAAQ,EAAO,WAAY,EAE9D,aAAkB,iBACX,CACH,MAAO,EAAO,cAAgB,EAAO,MACrC,OAAQ,EAAO,eAAiB,EAAO,MAC3C,EAEG,CAAE,MAAO,EAAO,MAAO,OAAQ,EAAO,MAAO,CACxD,CAmBA,SAAgB,EACZ,EACA,EACM,CACN,GAAM,CAAE,MAAO,EAAM,OAAQ,GAAS,EAAW,CAAM,EACvD,GAAI,IAAS,GAAK,IAAS,EAAG,MAAO,GAErC,IAAM,EAAQ,KAAK,IAAI,EAAA,IAA+B,KAAK,IAAI,EAAM,CAAI,CAAC,EACpE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,EAAO,CAAK,CAAC,EACxC,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,EAAO,CAAK,CAAC,EAExC,EAAS,GAAkB,SAAS,cAAc,QAAQ,EAChE,EAAO,MAAQ,EACf,EAAO,OAAS,EAChB,IAAM,EAAM,EAAO,WAAW,KAAM,CAAE,mBAAoB,EAAK,CAAC,EAChE,GAAI,CAAC,EAAK,MAAO,GACjB,EAAI,UAAU,EAAQ,EAAG,EAAG,EAAG,CAAC,EAEhC,IAAM,EAAO,EAAI,aAAa,EAAG,EAAG,EAAG,CAAC,CAAC,CAAC,KACtC,EAAM,EACJ,EAAa,EAAI,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,GAAK,EAClC,GAAO,MAAS,EAAK,GAAK,MAAS,EAAK,EAAI,GAAK,MAAS,EAAK,EAAI,GAEvE,OAAO,EAAM,CACjB,CAcA,SAAgB,EAAsB,EAAmB,EAA4B,CACjF,OAAO,GAAa,CACxB,CAOA,IAAa,EAAb,cAAuC,KAAM,CAEzC,UAEA,UAMA,YAAY,EAAmB,EAAmB,CAC9C,MAAM,wEAAwE,EAC9E,KAAK,KAAO,oBACZ,KAAK,UAAY,EACjB,KAAK,UAAY,CACrB,CACJ"}
+{"version":3,"file":"luminance.cjs","names":["LUMINANCE_SAMPLE_MAX_EDGE","sourceSize","source","computeImageLuminance","srcW","srcH","scale","w","h","canvas","reusableCanvas","ctx","data","sum","pixelCount","i","isLuminanceAcceptable","luminance","threshold","LowLuminanceError"],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * frame (`<img>`, `<video>`, `<canvas>`, `ImageBitmap` or `OffscreenCanvas`) so\n * a UI can reject underexposed captures before paying the cost of downstream\n * inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/**\n * Drawable source we can sample luminance from.\n *\n * The list tracks what `CanvasRenderingContext2D.drawImage` accepts and we can\n * read a pixel size off, which is what the implementation actually needs.\n * `ImageBitmap` matters for the decode-downscaled path: `createImageBitmap(blob,\n * { resizeWidth })` is how a caller avoids materialising a full-resolution\n * phone photo, and the frame it hands back is the frame whose brightness has to\n * be checked.\n */\nexport type LuminanceSource =\n    HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas;\n\n/**\n * Natural pixel size of the source (`0`/`0` while it is still unloaded).\n *\n * `ImageBitmap` and `OffscreenCanvas` both expose plain `width`/`height`, so\n * they fall through to the same branch as a canvas — but they are named\n * explicitly rather than left to the `naturalWidth || width` fallback, which\n * only reads as intentional for an `<img>`.\n */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLImageElement) {\n        return {\n            width: source.naturalWidth || source.width,\n            height: source.naturalHeight || source.height,\n        };\n    }\n    return { width: source.width, height: source.height };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded frame,\n * scaled to `0..255`. See {@link LuminanceSource} for what counts as one.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the decoded frame to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":"AAkBA,IAAaA,EAA4B,IAuBzC,SAASC,EAAW,EAA4D,CAU5E,OATIC,aAAkB,iBACX,CAAE,MAAOA,EAAO,WAAY,OAAQA,EAAO,WAAY,EAE9DA,aAAkB,iBACX,CACH,MAAOA,EAAO,cAAgBA,EAAO,MACrC,OAAQA,EAAO,eAAiBA,EAAO,MAC3C,EAEG,CAAE,MAAOA,EAAO,MAAO,OAAQA,EAAO,MAAO,CACxD,CAmBA,SAAgBC,EACZ,EACA,EACM,CACN,GAAM,CAAE,MAAOC,EAAM,OAAQC,GAASJ,EAAWC,CAAM,EACvD,GAAIE,IAAS,GAAKC,IAAS,EAAG,MAAO,GAErC,IAAMC,EAAQ,KAAK,IAAI,EAAA,IAA+B,KAAK,IAAIF,EAAMC,CAAI,CAAC,EACpEE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOE,CAAK,CAAC,EACxCE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOC,CAAK,CAAC,EAExCG,EAASC,GAAkB,SAAS,cAAc,QAAQ,EAChE,EAAO,MAAQH,EACf,EAAO,OAASC,EAChB,IAAMG,EAAMF,EAAO,WAAW,KAAM,CAAE,mBAAoB,EAAK,CAAC,EAChE,GAAI,CAACE,EAAK,MAAO,GACjBA,EAAI,UAAUT,EAAQ,EAAG,EAAGK,EAAGC,CAAC,EAEhC,IAAMI,EAAOD,EAAI,aAAa,EAAG,EAAGJ,EAAGC,CAAC,CAAC,CAAC,KACtCK,EAAM,EACJC,EAAaP,EAAIC,EACvB,IAAK,IAAIO,EAAI,EAAGA,EAAIH,EAAK,OAAQ,GAAK,EAClC,GAAO,MAASA,EAAKG,GAAK,MAASH,EAAKG,EAAI,GAAK,MAASH,EAAKG,EAAI,GAEvE,OAAOF,EAAMC,CACjB,CAcA,SAAgBE,EAAsB,EAAmB,EAA4B,CACjF,OAAOC,GAAaC,CACxB,CAOA,IAAaC,EAAb,cAAuC,KAAM,CAEzC,UAEA,UAMA,YAAY,EAAmB,EAAmB,CAC9C,MAAM,wEAAwE,EAC9E,KAAK,KAAO,oBACZ,KAAK,UAAYF,EACjB,KAAK,UAAYC,CACrB,CACJ,E"}

package/dist/vision/luminance.js.map

@@ -1 +1 @@
-{"version":3,"file":"luminance.js","names":[],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * frame (`<img>`, `<video>`, `<canvas>`, `ImageBitmap` or `OffscreenCanvas`) so\n * a UI can reject underexposed captures before paying the cost of downstream\n * inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/**\n * Drawable source we can sample luminance from.\n *\n * The list tracks what `CanvasRenderingContext2D.drawImage` accepts and we can\n * read a pixel size off, which is what the implementation actually needs.\n * `ImageBitmap` matters for the decode-downscaled path: `createImageBitmap(blob,\n * { resizeWidth })` is how a caller avoids materialising a full-resolution\n * phone photo, and the frame it hands back is the frame whose brightness has to\n * be checked.\n */\nexport type LuminanceSource =\n    HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas;\n\n/**\n * Natural pixel size of the source (`0`/`0` while it is still unloaded).\n *\n * `ImageBitmap` and `OffscreenCanvas` both expose plain `width`/`height`, so\n * they fall through to the same branch as a canvas — but they are named\n * explicitly rather than left to the `naturalWidth || width` fallback, which\n * only reads as intentional for an `<img>`.\n */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLImageElement) {\n        return {\n            width: source.naturalWidth || source.width,\n            height: source.naturalHeight || source.height,\n        };\n    }\n    return { width: source.width, height: source.height };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded frame,\n * scaled to `0..255`. See {@link LuminanceSource} for what counts as one.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the decoded frame to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":";AAkBA,IAAa,IAA4B;AAuBzC,SAAS,EAAW,GAA4D;CAU5E,OATI,aAAkB,mBACX;EAAE,OAAO,EAAO;EAAY,QAAQ,EAAO;CAAY,IAE9D,aAAkB,mBACX;EACH,OAAO,EAAO,gBAAgB,EAAO;EACrC,QAAQ,EAAO,iBAAiB,EAAO;CAC3C,IAEG;EAAE,OAAO,EAAO;EAAO,QAAQ,EAAO;CAAO;AACxD;AAmBA,SAAgB,EACZ,GACA,GACM;CACN,IAAM,EAAE,OAAO,GAAM,QAAQ,MAAS,EAAW,CAAM;CACvD,IAAI,MAAS,KAAK,MAAS,GAAG,OAAO;CAErC,IAAM,IAAQ,KAAK,IAAI,GAAA,MAA+B,KAAK,IAAI,GAAM,CAAI,CAAC,GACpE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,IAAO,CAAK,CAAC,GACxC,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,IAAO,CAAK,CAAC,GAExC,IAAS,KAAkB,SAAS,cAAc,QAAQ;CAEhE,AADA,EAAO,QAAQ,GACf,EAAO,SAAS;CAChB,IAAM,IAAM,EAAO,WAAW,MAAM,EAAE,oBAAoB,GAAK,CAAC;CAChE,IAAI,CAAC,GAAK,OAAO;CACjB,EAAI,UAAU,GAAQ,GAAG,GAAG,GAAG,CAAC;CAEhC,IAAM,IAAO,EAAI,aAAa,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,MACtC,IAAM,GACJ,IAAa,IAAI;CACvB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAK,QAAQ,KAAK,GAClC,KAAO,QAAS,EAAK,KAAK,QAAS,EAAK,IAAI,KAAK,QAAS,EAAK,IAAI;CAEvE,OAAO,IAAM;AACjB;AAcA,SAAgB,EAAsB,GAAmB,GAA4B;CACjF,OAAO,KAAa;AACxB;AAOA,IAAa,IAAb,cAAuC,MAAM;CAEzC;CAEA;CAMA,YAAY,GAAmB,GAAmB;EAI9C,AAHA,MAAM,wEAAwE,GAC9E,KAAK,OAAO,qBACZ,KAAK,YAAY,GACjB,KAAK,YAAY;CACrB;AACJ"}
+{"version":3,"file":"luminance.js","names":["LUMINANCE_SAMPLE_MAX_EDGE","sourceSize","source","computeImageLuminance","srcW","srcH","scale","w","h","canvas","reusableCanvas","ctx","data","sum","pixelCount","i","isLuminanceAcceptable","luminance","threshold","LowLuminanceError"],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * frame (`<img>`, `<video>`, `<canvas>`, `ImageBitmap` or `OffscreenCanvas`) so\n * a UI can reject underexposed captures before paying the cost of downstream\n * inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/**\n * Drawable source we can sample luminance from.\n *\n * The list tracks what `CanvasRenderingContext2D.drawImage` accepts and we can\n * read a pixel size off, which is what the implementation actually needs.\n * `ImageBitmap` matters for the decode-downscaled path: `createImageBitmap(blob,\n * { resizeWidth })` is how a caller avoids materialising a full-resolution\n * phone photo, and the frame it hands back is the frame whose brightness has to\n * be checked.\n */\nexport type LuminanceSource =\n    HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas;\n\n/**\n * Natural pixel size of the source (`0`/`0` while it is still unloaded).\n *\n * `ImageBitmap` and `OffscreenCanvas` both expose plain `width`/`height`, so\n * they fall through to the same branch as a canvas — but they are named\n * explicitly rather than left to the `naturalWidth || width` fallback, which\n * only reads as intentional for an `<img>`.\n */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLImageElement) {\n        return {\n            width: source.naturalWidth || source.width,\n            height: source.naturalHeight || source.height,\n        };\n    }\n    return { width: source.width, height: source.height };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded frame,\n * scaled to `0..255`. See {@link LuminanceSource} for what counts as one.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the decoded frame to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":";AAkBA,IAAaA,IAA4B;AAuBzC,SAASC,EAAW,GAA4D;CAU5E,OATIC,aAAkB,mBACX;EAAE,OAAOA,EAAO;EAAY,QAAQA,EAAO;CAAY,IAE9DA,aAAkB,mBACX;EACH,OAAOA,EAAO,gBAAgBA,EAAO;EACrC,QAAQA,EAAO,iBAAiBA,EAAO;CAC3C,IAEG;EAAE,OAAOA,EAAO;EAAO,QAAQA,EAAO;CAAO;AACxD;AAmBA,SAAgBC,EACZ,GACA,GACM;CACN,IAAM,EAAE,OAAOC,GAAM,QAAQC,MAASJ,EAAWC,CAAM;CACvD,IAAIE,MAAS,KAAKC,MAAS,GAAG,OAAO;CAErC,IAAMC,IAAQ,KAAK,IAAI,GAAA,MAA+B,KAAK,IAAIF,GAAMC,CAAI,CAAC,GACpEE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAMH,IAAOE,CAAK,CAAC,GACxCE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAMH,IAAOC,CAAK,CAAC,GAExCG,IAASC,KAAkB,SAAS,cAAc,QAAQ;CAEhE,AADA,EAAO,QAAQH,GACf,EAAO,SAASC;CAChB,IAAMG,IAAMF,EAAO,WAAW,MAAM,EAAE,oBAAoB,GAAK,CAAC;CAChE,IAAI,CAACE,GAAK,OAAO;CACjB,EAAI,UAAUT,GAAQ,GAAG,GAAGK,GAAGC,CAAC;CAEhC,IAAMI,IAAOD,EAAI,aAAa,GAAG,GAAGJ,GAAGC,CAAC,CAAC,CAAC,MACtCK,IAAM,GACJC,IAAaP,IAAIC;CACvB,KAAK,IAAIO,IAAI,GAAGA,IAAIH,EAAK,QAAQ,KAAK,GAClC,KAAO,QAASA,EAAKG,KAAK,QAASH,EAAKG,IAAI,KAAK,QAASH,EAAKG,IAAI;CAEvE,OAAOF,IAAMC;AACjB;AAcA,SAAgBE,EAAsB,GAAmB,GAA4B;CACjF,OAAOC,KAAaC;AACxB;AAOA,IAAaC,IAAb,cAAuC,MAAM;CAEzC;CAEA;CAMA,YAAY,GAAmB,GAAmB;EAI9C,AAHA,MAAM,wEAAwE,GAC9E,KAAK,OAAO,qBACZ,KAAK,YAAYF,GACjB,KAAK,YAAYC;CACrB;AACJ"}

package/dist/vision/normalization.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"normalization.cjs","names":[],"sources":["../../src/vision/normalization.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Which preprocessing a classifier expects its input to have had.\n *\n * A classifier is trained on a specific tensor, and feeding it a differently\n * prepared one degrades it silently — no exception, no warning, just worse\n * predictions. The two families this SDK sees most disagree completely:\n * torchvision-style models want the ImageNet mean and deviation subtracted and\n * divided out, while an Ultralytics classification head consumes raw `[0, 1]`.\n *\n * Guessing wrong is not detectable from the outside, but it is not a guess: an\n * Ultralytics export stamps `author` and `task` into its own metadata, and every\n * task in this SDK already reads that map for the class names.\n *\n * Mirrors `ort_vision_sdk.normalization` in the Python SDK; the two must agree,\n * because the same model file is driven by both.\n */\n\n/**\n * Which preprocessing the classifier expects its input to have had.\n *\n * - `\"auto\"` (the default wherever it is accepted) reads the model's own export\n *   metadata and picks. An Ultralytics classification head gets\n *   `\"ultralytics\"`; anything else gets `\"imagenet\"`.\n * - `\"imagenet\"` subtracts the ImageNet mean and divides by the ImageNet\n *   deviation — the torchvision convention.\n * - `\"ultralytics\"` leaves the image in `[0, 1]`. Ultralytics' own classifier\n *   applies no mean/std at all, so anything else feeds it images it never saw\n *   in training.\n * - `\"none\"` is the same arithmetic as `\"ultralytics\"` — identity — under a\n *   name that says \"this model wants raw `[0, 1]`\" rather than naming a vendor.\n */\nexport type Normalization = \"auto\" | \"imagenet\" | \"ultralytics\" | \"none\";\n\n/** Per-channel RGB mean of ImageNet, the torchvision preprocessing convention. */\nexport const IMAGENET_MEAN: readonly [number, number, number] = [0.485, 0.456, 0.406];\n\n/** Per-channel RGB standard deviation of ImageNet. */\nexport const IMAGENET_STD: readonly [number, number, number] = [0.229, 0.224, 0.225];\n\n/** Mean that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_MEAN: readonly [number, number, number] = [0, 0, 0];\n\n/** Deviation that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_STD: readonly [number, number, number] = [1, 1, 1];\n\n/** Name reported when the caller supplied `mean`/`std` directly. */\nexport const CUSTOM_NORMALIZATION = \"custom\";\n\nconst PRESETS: Readonly<\n    Record<string, readonly [readonly [number, number, number], readonly [number, number, number]]>\n> = {\n    imagenet: [IMAGENET_MEAN, IMAGENET_STD],\n    ultralytics: [IDENTITY_MEAN, IDENTITY_STD],\n    none: [IDENTITY_MEAN, IDENTITY_STD],\n};\n\n/** What {@link resolveNormalization} settled on. */\nexport interface ResolvedNormalization {\n    /** The preset name, or `\"custom\"` when the caller supplied the values. */\n    readonly name: string;\n    /** Per-channel mean to subtract. */\n    readonly mean: readonly [number, number, number];\n    /** Per-channel deviation to divide by. */\n    readonly std: readonly [number, number, number];\n}\n\n/**\n * Whether a metadata map came out of `YOLO(...).export(format=\"onnx\")`.\n *\n * Every Ultralytics export stamps `author` and `task` into its metadata, and the\n * pair is unambiguous: `\"Ultralytics\"` plus `\"classify\"` is a classification head\n * from that codebase and nothing else.\n *\n * @param metadata The model's custom metadata map.\n */\nexport function isUltralyticsClassifier(metadata: Readonly<Record<string, string>>): boolean {\n    return (\n        (metadata.author ?? \"\").trim().toLowerCase() === \"ultralytics\" &&\n        (metadata.task ?? \"\").trim().toLowerCase() === \"classify\"\n    );\n}\n\n/**\n * Settle which `mean`/`std` to apply, and what to call the choice.\n *\n * Explicit `mean`/`std` always win — they are the escape hatch for a model whose\n * preprocessing neither preset describes. Anything they leave open falls back to\n * the preset, so passing only a `mean` does not silently reset the deviation\n * to 1.\n *\n * Warns (via `console.warn`) when the model is an Ultralytics export and the\n * supplied values are not the identity it was trained with. Nothing fails in\n * that case: the prediction has the right shape and is simply less accurate,\n * which is exactly why it is worth saying out loud.\n *\n * @param metadata The model's custom metadata map, read to detect the family.\n * @param options The preset asked for, plus any explicit `mean`/`std`.\n * @throws {RangeError} If `normalization` is not a known preset, or names one\n *   while `mean`/`std` are also supplied — two answers to the same question.\n */\nexport function resolveNormalization(\n    metadata: Readonly<Record<string, string>>,\n    options: {\n        readonly normalization?: Normalization;\n        readonly mean?: readonly [number, number, number];\n        readonly std?: readonly [number, number, number];\n    } = {},\n): ResolvedNormalization {\n    const normalization = options.normalization ?? \"auto\";\n    const explicit = options.mean !== undefined || options.std !== undefined;\n\n    if (normalization !== \"auto\" && PRESETS[normalization] === undefined) {\n        throw new RangeError(\n            `normalization must be one of 'auto', 'imagenet', 'ultralytics', 'none'; ` +\n                `got ${JSON.stringify(normalization)}.`,\n        );\n    }\n    if (explicit && normalization !== \"auto\") {\n        throw new RangeError(\n            `Pass either normalization=${JSON.stringify(normalization)} or explicit mean/std, not both.`,\n        );\n    }\n\n    const ultralytics = isUltralyticsClassifier(metadata);\n    const preset =\n        normalization === \"auto\" ? (ultralytics ? \"ultralytics\" : \"imagenet\") : normalization;\n    const [presetMean, presetStd] = PRESETS[preset] as readonly [\n        readonly [number, number, number],\n        readonly [number, number, number],\n    ];\n\n    if (!explicit) {\n        return { name: preset, mean: presetMean, std: presetStd };\n    }\n\n    const mean = options.mean ?? presetMean;\n    const std = options.std ?? presetStd;\n    if (ultralytics && !(isIdentity(mean, IDENTITY_MEAN) && isIdentity(std, IDENTITY_STD))) {\n        console.warn(\n            \"The classifier is an Ultralytics export, whose classification head is trained on raw \" +\n                `[0, 1] images, but mean=${JSON.stringify(mean)} / std=${JSON.stringify(std)} was ` +\n                \"requested. It will be fed images normalized in a way it never saw in training, which \" +\n                \"degrades accuracy without raising anything. Drop mean/std to let normalization='auto' \" +\n                \"pick the identity.\",\n        );\n    }\n    return { name: CUSTOM_NORMALIZATION, mean, std };\n}\n\n/**\n * Whether two channel triples are equal.\n *\n * @param value The triple to check.\n * @param reference The triple to compare against.\n */\nfunction isIdentity(\n    value: readonly [number, number, number],\n    reference: readonly [number, number, number],\n): boolean {\n    return value.every((entry, index) => entry === reference[index]);\n}\n"],"mappings":"AAmCA,IAAa,EAAmD,CAAC,KAAO,KAAO,IAAK,EAGvE,EAAkD,CAAC,KAAO,KAAO,IAAK,EAGtE,EAAmD,CAAC,EAAG,EAAG,CAAC,EAG3D,EAAkD,CAAC,EAAG,EAAG,CAAC,EAG1D,EAAuB,SAE9B,EAEF,CACA,SAAU,CAAC,EAAe,CAAY,EACtC,YAAa,CAAC,EAAe,CAAY,EACzC,KAAM,CAAC,EAAe,CAAY,CACtC,EAqBA,SAAgB,EAAwB,EAAqD,CACzF,OACK,EAAS,QAAU,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,IAAM,gBAChD,EAAS,MAAQ,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,IAAM,UAEvD,CAoBA,SAAgB,EACZ,EACA,EAII,CAAC,EACgB,CACrB,IAAM,EAAgB,EAAQ,eAAiB,OACzC,EAAW,EAAQ,OAAS,IAAA,IAAa,EAAQ,MAAQ,IAAA,GAE/D,GAAI,IAAkB,QAAU,EAAQ,KAAmB,IAAA,GACvD,MAAU,WACN,+EACW,KAAK,UAAU,CAAa,EAAE,EAC7C,EAEJ,GAAI,GAAY,IAAkB,OAC9B,MAAU,WACN,6BAA6B,KAAK,UAAU,CAAa,EAAE,iCAC/D,EAGJ,IAAM,EAAc,EAAwB,CAAQ,EAC9C,EACF,IAAkB,OAAU,EAAc,cAAgB,WAAc,EACtE,CAAC,EAAY,GAAa,EAAQ,GAKxC,GAAI,CAAC,EACD,MAAO,CAAE,KAAM,EAAQ,KAAM,EAAY,IAAK,CAAU,EAG5D,IAAM,EAAO,EAAQ,MAAQ,EACvB,EAAM,EAAQ,KAAO,EAU3B,OATI,GAAe,EAAE,EAAW,EAAM,CAAa,GAAK,EAAW,EAAK,CAAY,IAChF,QAAQ,KACJ,gHAC+B,KAAK,UAAU,CAAI,EAAE,SAAS,KAAK,UAAU,CAAG,EAAE,mMAIrF,EAEG,CAAE,KAAM,EAAsB,OAAM,KAAI,CACnD,CAQA,SAAS,EACL,EACA,EACO,CACP,OAAO,EAAM,OAAO,EAAO,IAAU,IAAU,EAAU,EAAM,CACnE"}
+{"version":3,"file":"normalization.cjs","names":["IMAGENET_MEAN","IMAGENET_STD","IDENTITY_MEAN","IDENTITY_STD","CUSTOM_NORMALIZATION","PRESETS","isUltralyticsClassifier","metadata","resolveNormalization","normalization","options","explicit","ultralytics","preset","presetMean","presetStd","mean","std","isIdentity","value","entry","reference","index"],"sources":["../../src/vision/normalization.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Which preprocessing a classifier expects its input to have had.\n *\n * A classifier is trained on a specific tensor, and feeding it a differently\n * prepared one degrades it silently — no exception, no warning, just worse\n * predictions. The two families this SDK sees most disagree completely:\n * torchvision-style models want the ImageNet mean and deviation subtracted and\n * divided out, while an Ultralytics classification head consumes raw `[0, 1]`.\n *\n * Guessing wrong is not detectable from the outside, but it is not a guess: an\n * Ultralytics export stamps `author` and `task` into its own metadata, and every\n * task in this SDK already reads that map for the class names.\n *\n * Mirrors `ort_vision_sdk.normalization` in the Python SDK; the two must agree,\n * because the same model file is driven by both.\n */\n\n/**\n * Which preprocessing the classifier expects its input to have had.\n *\n * - `\"auto\"` (the default wherever it is accepted) reads the model's own export\n *   metadata and picks. An Ultralytics classification head gets\n *   `\"ultralytics\"`; anything else gets `\"imagenet\"`.\n * - `\"imagenet\"` subtracts the ImageNet mean and divides by the ImageNet\n *   deviation — the torchvision convention.\n * - `\"ultralytics\"` leaves the image in `[0, 1]`. Ultralytics' own classifier\n *   applies no mean/std at all, so anything else feeds it images it never saw\n *   in training.\n * - `\"none\"` is the same arithmetic as `\"ultralytics\"` — identity — under a\n *   name that says \"this model wants raw `[0, 1]`\" rather than naming a vendor.\n */\nexport type Normalization = \"auto\" | \"imagenet\" | \"ultralytics\" | \"none\";\n\n/** Per-channel RGB mean of ImageNet, the torchvision preprocessing convention. */\nexport const IMAGENET_MEAN: readonly [number, number, number] = [0.485, 0.456, 0.406];\n\n/** Per-channel RGB standard deviation of ImageNet. */\nexport const IMAGENET_STD: readonly [number, number, number] = [0.229, 0.224, 0.225];\n\n/** Mean that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_MEAN: readonly [number, number, number] = [0, 0, 0];\n\n/** Deviation that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_STD: readonly [number, number, number] = [1, 1, 1];\n\n/** Name reported when the caller supplied `mean`/`std` directly. */\nexport const CUSTOM_NORMALIZATION = \"custom\";\n\nconst PRESETS: Readonly<\n    Record<string, readonly [readonly [number, number, number], readonly [number, number, number]]>\n> = {\n    imagenet: [IMAGENET_MEAN, IMAGENET_STD],\n    ultralytics: [IDENTITY_MEAN, IDENTITY_STD],\n    none: [IDENTITY_MEAN, IDENTITY_STD],\n};\n\n/** What {@link resolveNormalization} settled on. */\nexport interface ResolvedNormalization {\n    /** The preset name, or `\"custom\"` when the caller supplied the values. */\n    readonly name: string;\n    /** Per-channel mean to subtract. */\n    readonly mean: readonly [number, number, number];\n    /** Per-channel deviation to divide by. */\n    readonly std: readonly [number, number, number];\n}\n\n/**\n * Whether a metadata map came out of `YOLO(...).export(format=\"onnx\")`.\n *\n * Every Ultralytics export stamps `author` and `task` into its metadata, and the\n * pair is unambiguous: `\"Ultralytics\"` plus `\"classify\"` is a classification head\n * from that codebase and nothing else.\n *\n * @param metadata The model's custom metadata map.\n */\nexport function isUltralyticsClassifier(metadata: Readonly<Record<string, string>>): boolean {\n    return (\n        (metadata.author ?? \"\").trim().toLowerCase() === \"ultralytics\" &&\n        (metadata.task ?? \"\").trim().toLowerCase() === \"classify\"\n    );\n}\n\n/**\n * Settle which `mean`/`std` to apply, and what to call the choice.\n *\n * Explicit `mean`/`std` always win — they are the escape hatch for a model whose\n * preprocessing neither preset describes. Anything they leave open falls back to\n * the preset, so passing only a `mean` does not silently reset the deviation\n * to 1.\n *\n * Warns (via `console.warn`) when the model is an Ultralytics export and the\n * supplied values are not the identity it was trained with. Nothing fails in\n * that case: the prediction has the right shape and is simply less accurate,\n * which is exactly why it is worth saying out loud.\n *\n * @param metadata The model's custom metadata map, read to detect the family.\n * @param options The preset asked for, plus any explicit `mean`/`std`.\n * @throws {RangeError} If `normalization` is not a known preset, or names one\n *   while `mean`/`std` are also supplied — two answers to the same question.\n */\nexport function resolveNormalization(\n    metadata: Readonly<Record<string, string>>,\n    options: {\n        readonly normalization?: Normalization;\n        readonly mean?: readonly [number, number, number];\n        readonly std?: readonly [number, number, number];\n    } = {},\n): ResolvedNormalization {\n    const normalization = options.normalization ?? \"auto\";\n    const explicit = options.mean !== undefined || options.std !== undefined;\n\n    if (normalization !== \"auto\" && PRESETS[normalization] === undefined) {\n        throw new RangeError(\n            `normalization must be one of 'auto', 'imagenet', 'ultralytics', 'none'; ` +\n                `got ${JSON.stringify(normalization)}.`,\n        );\n    }\n    if (explicit && normalization !== \"auto\") {\n        throw new RangeError(\n            `Pass either normalization=${JSON.stringify(normalization)} or explicit mean/std, not both.`,\n        );\n    }\n\n    const ultralytics = isUltralyticsClassifier(metadata);\n    const preset =\n        normalization === \"auto\" ? (ultralytics ? \"ultralytics\" : \"imagenet\") : normalization;\n    const [presetMean, presetStd] = PRESETS[preset] as readonly [\n        readonly [number, number, number],\n        readonly [number, number, number],\n    ];\n\n    if (!explicit) {\n        return { name: preset, mean: presetMean, std: presetStd };\n    }\n\n    const mean = options.mean ?? presetMean;\n    const std = options.std ?? presetStd;\n    if (ultralytics && !(isIdentity(mean, IDENTITY_MEAN) && isIdentity(std, IDENTITY_STD))) {\n        console.warn(\n            \"The classifier is an Ultralytics export, whose classification head is trained on raw \" +\n                `[0, 1] images, but mean=${JSON.stringify(mean)} / std=${JSON.stringify(std)} was ` +\n                \"requested. It will be fed images normalized in a way it never saw in training, which \" +\n                \"degrades accuracy without raising anything. Drop mean/std to let normalization='auto' \" +\n                \"pick the identity.\",\n        );\n    }\n    return { name: CUSTOM_NORMALIZATION, mean, std };\n}\n\n/**\n * Whether two channel triples are equal.\n *\n * @param value The triple to check.\n * @param reference The triple to compare against.\n */\nfunction isIdentity(\n    value: readonly [number, number, number],\n    reference: readonly [number, number, number],\n): boolean {\n    return value.every((entry, index) => entry === reference[index]);\n}\n"],"mappings":"AAmCA,IAAaA,EAAmD,CAAC,KAAO,KAAO,IAAK,EAGvEC,EAAkD,CAAC,KAAO,KAAO,IAAK,EAGtEC,EAAmD,CAAC,EAAG,EAAG,CAAC,EAG3DC,EAAkD,CAAC,EAAG,EAAG,CAAC,EAG1DC,EAAuB,SAE9BC,EAEF,CACA,SAAU,CAACL,EAAeC,CAAY,EACtC,YAAa,CAACC,EAAeC,CAAY,EACzC,KAAM,CAACD,EAAeC,CAAY,CACtC,EAqBA,SAAgBG,EAAwB,EAAqD,CACzF,OACKC,EAAS,QAAU,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,IAAM,gBAChDA,EAAS,MAAQ,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,IAAM,UAEvD,CAoBA,SAAgBC,EACZ,EACA,EAII,CAAC,EACgB,CACrB,IAAMC,EAAgBC,EAAQ,eAAiB,OACzCC,EAAWD,EAAQ,OAAS,IAAA,IAAaA,EAAQ,MAAQ,IAAA,GAE/D,GAAID,IAAkB,QAAUJ,EAAQI,KAAmB,IAAA,GACvD,MAAU,WACN,+EACW,KAAK,UAAUA,CAAa,EAAE,EAC7C,EAEJ,GAAIE,GAAYF,IAAkB,OAC9B,MAAU,WACN,6BAA6B,KAAK,UAAUA,CAAa,EAAE,iCAC/D,EAGJ,IAAMG,EAAcN,EAAwBC,CAAQ,EAC9CM,EACFJ,IAAkB,OAAUG,EAAc,cAAgB,WAAcH,EACtE,CAACK,EAAYC,GAAaV,EAAQQ,GAKxC,GAAI,CAACF,EACD,MAAO,CAAE,KAAME,EAAQ,KAAMC,EAAY,IAAKC,CAAU,EAG5D,IAAMC,EAAON,EAAQ,MAAQI,EACvBG,EAAMP,EAAQ,KAAOK,EAU3B,OATIH,GAAe,EAAEM,EAAWF,EAAMd,CAAa,GAAKgB,EAAWD,EAAKd,CAAY,IAChF,QAAQ,KACJ,gHAC+B,KAAK,UAAUa,CAAI,EAAE,SAAS,KAAK,UAAUC,CAAG,EAAE,mMAIrF,EAEG,CAAE,KAAMb,EAAsB,OAAM,KAAI,CACnD,CAQA,SAASc,EACL,EACA,EACO,CACP,OAAOC,EAAM,OAAO,EAAO,IAAUC,IAAUC,EAAUC,EAAM,CACnE,C"}

package/dist/vision/normalization.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalization.js","names":[],"sources":["../../src/vision/normalization.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Which preprocessing a classifier expects its input to have had.\n *\n * A classifier is trained on a specific tensor, and feeding it a differently\n * prepared one degrades it silently — no exception, no warning, just worse\n * predictions. The two families this SDK sees most disagree completely:\n * torchvision-style models want the ImageNet mean and deviation subtracted and\n * divided out, while an Ultralytics classification head consumes raw `[0, 1]`.\n *\n * Guessing wrong is not detectable from the outside, but it is not a guess: an\n * Ultralytics export stamps `author` and `task` into its own metadata, and every\n * task in this SDK already reads that map for the class names.\n *\n * Mirrors `ort_vision_sdk.normalization` in the Python SDK; the two must agree,\n * because the same model file is driven by both.\n */\n\n/**\n * Which preprocessing the classifier expects its input to have had.\n *\n * - `\"auto\"` (the default wherever it is accepted) reads the model's own export\n *   metadata and picks. An Ultralytics classification head gets\n *   `\"ultralytics\"`; anything else gets `\"imagenet\"`.\n * - `\"imagenet\"` subtracts the ImageNet mean and divides by the ImageNet\n *   deviation — the torchvision convention.\n * - `\"ultralytics\"` leaves the image in `[0, 1]`. Ultralytics' own classifier\n *   applies no mean/std at all, so anything else feeds it images it never saw\n *   in training.\n * - `\"none\"` is the same arithmetic as `\"ultralytics\"` — identity — under a\n *   name that says \"this model wants raw `[0, 1]`\" rather than naming a vendor.\n */\nexport type Normalization = \"auto\" | \"imagenet\" | \"ultralytics\" | \"none\";\n\n/** Per-channel RGB mean of ImageNet, the torchvision preprocessing convention. */\nexport const IMAGENET_MEAN: readonly [number, number, number] = [0.485, 0.456, 0.406];\n\n/** Per-channel RGB standard deviation of ImageNet. */\nexport const IMAGENET_STD: readonly [number, number, number] = [0.229, 0.224, 0.225];\n\n/** Mean that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_MEAN: readonly [number, number, number] = [0, 0, 0];\n\n/** Deviation that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_STD: readonly [number, number, number] = [1, 1, 1];\n\n/** Name reported when the caller supplied `mean`/`std` directly. */\nexport const CUSTOM_NORMALIZATION = \"custom\";\n\nconst PRESETS: Readonly<\n    Record<string, readonly [readonly [number, number, number], readonly [number, number, number]]>\n> = {\n    imagenet: [IMAGENET_MEAN, IMAGENET_STD],\n    ultralytics: [IDENTITY_MEAN, IDENTITY_STD],\n    none: [IDENTITY_MEAN, IDENTITY_STD],\n};\n\n/** What {@link resolveNormalization} settled on. */\nexport interface ResolvedNormalization {\n    /** The preset name, or `\"custom\"` when the caller supplied the values. */\n    readonly name: string;\n    /** Per-channel mean to subtract. */\n    readonly mean: readonly [number, number, number];\n    /** Per-channel deviation to divide by. */\n    readonly std: readonly [number, number, number];\n}\n\n/**\n * Whether a metadata map came out of `YOLO(...).export(format=\"onnx\")`.\n *\n * Every Ultralytics export stamps `author` and `task` into its metadata, and the\n * pair is unambiguous: `\"Ultralytics\"` plus `\"classify\"` is a classification head\n * from that codebase and nothing else.\n *\n * @param metadata The model's custom metadata map.\n */\nexport function isUltralyticsClassifier(metadata: Readonly<Record<string, string>>): boolean {\n    return (\n        (metadata.author ?? \"\").trim().toLowerCase() === \"ultralytics\" &&\n        (metadata.task ?? \"\").trim().toLowerCase() === \"classify\"\n    );\n}\n\n/**\n * Settle which `mean`/`std` to apply, and what to call the choice.\n *\n * Explicit `mean`/`std` always win — they are the escape hatch for a model whose\n * preprocessing neither preset describes. Anything they leave open falls back to\n * the preset, so passing only a `mean` does not silently reset the deviation\n * to 1.\n *\n * Warns (via `console.warn`) when the model is an Ultralytics export and the\n * supplied values are not the identity it was trained with. Nothing fails in\n * that case: the prediction has the right shape and is simply less accurate,\n * which is exactly why it is worth saying out loud.\n *\n * @param metadata The model's custom metadata map, read to detect the family.\n * @param options The preset asked for, plus any explicit `mean`/`std`.\n * @throws {RangeError} If `normalization` is not a known preset, or names one\n *   while `mean`/`std` are also supplied — two answers to the same question.\n */\nexport function resolveNormalization(\n    metadata: Readonly<Record<string, string>>,\n    options: {\n        readonly normalization?: Normalization;\n        readonly mean?: readonly [number, number, number];\n        readonly std?: readonly [number, number, number];\n    } = {},\n): ResolvedNormalization {\n    const normalization = options.normalization ?? \"auto\";\n    const explicit = options.mean !== undefined || options.std !== undefined;\n\n    if (normalization !== \"auto\" && PRESETS[normalization] === undefined) {\n        throw new RangeError(\n            `normalization must be one of 'auto', 'imagenet', 'ultralytics', 'none'; ` +\n                `got ${JSON.stringify(normalization)}.`,\n        );\n    }\n    if (explicit && normalization !== \"auto\") {\n        throw new RangeError(\n            `Pass either normalization=${JSON.stringify(normalization)} or explicit mean/std, not both.`,\n        );\n    }\n\n    const ultralytics = isUltralyticsClassifier(metadata);\n    const preset =\n        normalization === \"auto\" ? (ultralytics ? \"ultralytics\" : \"imagenet\") : normalization;\n    const [presetMean, presetStd] = PRESETS[preset] as readonly [\n        readonly [number, number, number],\n        readonly [number, number, number],\n    ];\n\n    if (!explicit) {\n        return { name: preset, mean: presetMean, std: presetStd };\n    }\n\n    const mean = options.mean ?? presetMean;\n    const std = options.std ?? presetStd;\n    if (ultralytics && !(isIdentity(mean, IDENTITY_MEAN) && isIdentity(std, IDENTITY_STD))) {\n        console.warn(\n            \"The classifier is an Ultralytics export, whose classification head is trained on raw \" +\n                `[0, 1] images, but mean=${JSON.stringify(mean)} / std=${JSON.stringify(std)} was ` +\n                \"requested. It will be fed images normalized in a way it never saw in training, which \" +\n                \"degrades accuracy without raising anything. Drop mean/std to let normalization='auto' \" +\n                \"pick the identity.\",\n        );\n    }\n    return { name: CUSTOM_NORMALIZATION, mean, std };\n}\n\n/**\n * Whether two channel triples are equal.\n *\n * @param value The triple to check.\n * @param reference The triple to compare against.\n */\nfunction isIdentity(\n    value: readonly [number, number, number],\n    reference: readonly [number, number, number],\n): boolean {\n    return value.every((entry, index) => entry === reference[index]);\n}\n"],"mappings":";AAmCA,IAAa,IAAmD;CAAC;CAAO;CAAO;AAAK,GAGvE,IAAkD;CAAC;CAAO;CAAO;AAAK,GAGtE,IAAmD;CAAC;CAAG;CAAG;AAAC,GAG3D,IAAkD;CAAC;CAAG;CAAG;AAAC,GAG1D,IAAuB,UAE9B,IAEF;CACA,UAAU,CAAC,GAAe,CAAY;CACtC,aAAa,CAAC,GAAe,CAAY;CACzC,MAAM,CAAC,GAAe,CAAY;AACtC;AAqBA,SAAgB,EAAwB,GAAqD;CACzF,QACK,EAAS,UAAU,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,MAAM,kBAChD,EAAS,QAAQ,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,MAAM;AAEvD;AAoBA,SAAgB,EACZ,GACA,IAII,CAAC,GACgB;CACrB,IAAM,IAAgB,EAAQ,iBAAiB,QACzC,IAAW,EAAQ,SAAS,KAAA,KAAa,EAAQ,QAAQ,KAAA;CAE/D,IAAI,MAAkB,UAAU,EAAQ,OAAmB,KAAA,GACvD,MAAU,WACN,+EACW,KAAK,UAAU,CAAa,EAAE,EAC7C;CAEJ,IAAI,KAAY,MAAkB,QAC9B,MAAU,WACN,6BAA6B,KAAK,UAAU,CAAa,EAAE,iCAC/D;CAGJ,IAAM,IAAc,EAAwB,CAAQ,GAC9C,IACF,MAAkB,SAAU,IAAc,gBAAgB,aAAc,GACtE,CAAC,GAAY,KAAa,EAAQ;CAKxC,IAAI,CAAC,GACD,OAAO;EAAE,MAAM;EAAQ,MAAM;EAAY,KAAK;CAAU;CAG5D,IAAM,IAAO,EAAQ,QAAQ,GACvB,IAAM,EAAQ,OAAO;CAU3B,OATI,KAAe,EAAE,EAAW,GAAM,CAAa,KAAK,EAAW,GAAK,CAAY,MAChF,QAAQ,KACJ,gHAC+B,KAAK,UAAU,CAAI,EAAE,SAAS,KAAK,UAAU,CAAG,EAAE,mMAIrF,GAEG;EAAE,MAAM;EAAsB;EAAM;CAAI;AACnD;AAQA,SAAS,EACL,GACA,GACO;CACP,OAAO,EAAM,OAAO,GAAO,MAAU,MAAU,EAAU,EAAM;AACnE"}
+{"version":3,"file":"normalization.js","names":["IMAGENET_MEAN","IMAGENET_STD","IDENTITY_MEAN","IDENTITY_STD","CUSTOM_NORMALIZATION","PRESETS","isUltralyticsClassifier","metadata","resolveNormalization","normalization","options","explicit","ultralytics","preset","presetMean","presetStd","mean","std","isIdentity","value","entry","reference","index"],"sources":["../../src/vision/normalization.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Which preprocessing a classifier expects its input to have had.\n *\n * A classifier is trained on a specific tensor, and feeding it a differently\n * prepared one degrades it silently — no exception, no warning, just worse\n * predictions. The two families this SDK sees most disagree completely:\n * torchvision-style models want the ImageNet mean and deviation subtracted and\n * divided out, while an Ultralytics classification head consumes raw `[0, 1]`.\n *\n * Guessing wrong is not detectable from the outside, but it is not a guess: an\n * Ultralytics export stamps `author` and `task` into its own metadata, and every\n * task in this SDK already reads that map for the class names.\n *\n * Mirrors `ort_vision_sdk.normalization` in the Python SDK; the two must agree,\n * because the same model file is driven by both.\n */\n\n/**\n * Which preprocessing the classifier expects its input to have had.\n *\n * - `\"auto\"` (the default wherever it is accepted) reads the model's own export\n *   metadata and picks. An Ultralytics classification head gets\n *   `\"ultralytics\"`; anything else gets `\"imagenet\"`.\n * - `\"imagenet\"` subtracts the ImageNet mean and divides by the ImageNet\n *   deviation — the torchvision convention.\n * - `\"ultralytics\"` leaves the image in `[0, 1]`. Ultralytics' own classifier\n *   applies no mean/std at all, so anything else feeds it images it never saw\n *   in training.\n * - `\"none\"` is the same arithmetic as `\"ultralytics\"` — identity — under a\n *   name that says \"this model wants raw `[0, 1]`\" rather than naming a vendor.\n */\nexport type Normalization = \"auto\" | \"imagenet\" | \"ultralytics\" | \"none\";\n\n/** Per-channel RGB mean of ImageNet, the torchvision preprocessing convention. */\nexport const IMAGENET_MEAN: readonly [number, number, number] = [0.485, 0.456, 0.406];\n\n/** Per-channel RGB standard deviation of ImageNet. */\nexport const IMAGENET_STD: readonly [number, number, number] = [0.229, 0.224, 0.225];\n\n/** Mean that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_MEAN: readonly [number, number, number] = [0, 0, 0];\n\n/** Deviation that leaves an image untouched — what an Ultralytics classifier expects. */\nexport const IDENTITY_STD: readonly [number, number, number] = [1, 1, 1];\n\n/** Name reported when the caller supplied `mean`/`std` directly. */\nexport const CUSTOM_NORMALIZATION = \"custom\";\n\nconst PRESETS: Readonly<\n    Record<string, readonly [readonly [number, number, number], readonly [number, number, number]]>\n> = {\n    imagenet: [IMAGENET_MEAN, IMAGENET_STD],\n    ultralytics: [IDENTITY_MEAN, IDENTITY_STD],\n    none: [IDENTITY_MEAN, IDENTITY_STD],\n};\n\n/** What {@link resolveNormalization} settled on. */\nexport interface ResolvedNormalization {\n    /** The preset name, or `\"custom\"` when the caller supplied the values. */\n    readonly name: string;\n    /** Per-channel mean to subtract. */\n    readonly mean: readonly [number, number, number];\n    /** Per-channel deviation to divide by. */\n    readonly std: readonly [number, number, number];\n}\n\n/**\n * Whether a metadata map came out of `YOLO(...).export(format=\"onnx\")`.\n *\n * Every Ultralytics export stamps `author` and `task` into its metadata, and the\n * pair is unambiguous: `\"Ultralytics\"` plus `\"classify\"` is a classification head\n * from that codebase and nothing else.\n *\n * @param metadata The model's custom metadata map.\n */\nexport function isUltralyticsClassifier(metadata: Readonly<Record<string, string>>): boolean {\n    return (\n        (metadata.author ?? \"\").trim().toLowerCase() === \"ultralytics\" &&\n        (metadata.task ?? \"\").trim().toLowerCase() === \"classify\"\n    );\n}\n\n/**\n * Settle which `mean`/`std` to apply, and what to call the choice.\n *\n * Explicit `mean`/`std` always win — they are the escape hatch for a model whose\n * preprocessing neither preset describes. Anything they leave open falls back to\n * the preset, so passing only a `mean` does not silently reset the deviation\n * to 1.\n *\n * Warns (via `console.warn`) when the model is an Ultralytics export and the\n * supplied values are not the identity it was trained with. Nothing fails in\n * that case: the prediction has the right shape and is simply less accurate,\n * which is exactly why it is worth saying out loud.\n *\n * @param metadata The model's custom metadata map, read to detect the family.\n * @param options The preset asked for, plus any explicit `mean`/`std`.\n * @throws {RangeError} If `normalization` is not a known preset, or names one\n *   while `mean`/`std` are also supplied — two answers to the same question.\n */\nexport function resolveNormalization(\n    metadata: Readonly<Record<string, string>>,\n    options: {\n        readonly normalization?: Normalization;\n        readonly mean?: readonly [number, number, number];\n        readonly std?: readonly [number, number, number];\n    } = {},\n): ResolvedNormalization {\n    const normalization = options.normalization ?? \"auto\";\n    const explicit = options.mean !== undefined || options.std !== undefined;\n\n    if (normalization !== \"auto\" && PRESETS[normalization] === undefined) {\n        throw new RangeError(\n            `normalization must be one of 'auto', 'imagenet', 'ultralytics', 'none'; ` +\n                `got ${JSON.stringify(normalization)}.`,\n        );\n    }\n    if (explicit && normalization !== \"auto\") {\n        throw new RangeError(\n            `Pass either normalization=${JSON.stringify(normalization)} or explicit mean/std, not both.`,\n        );\n    }\n\n    const ultralytics = isUltralyticsClassifier(metadata);\n    const preset =\n        normalization === \"auto\" ? (ultralytics ? \"ultralytics\" : \"imagenet\") : normalization;\n    const [presetMean, presetStd] = PRESETS[preset] as readonly [\n        readonly [number, number, number],\n        readonly [number, number, number],\n    ];\n\n    if (!explicit) {\n        return { name: preset, mean: presetMean, std: presetStd };\n    }\n\n    const mean = options.mean ?? presetMean;\n    const std = options.std ?? presetStd;\n    if (ultralytics && !(isIdentity(mean, IDENTITY_MEAN) && isIdentity(std, IDENTITY_STD))) {\n        console.warn(\n            \"The classifier is an Ultralytics export, whose classification head is trained on raw \" +\n                `[0, 1] images, but mean=${JSON.stringify(mean)} / std=${JSON.stringify(std)} was ` +\n                \"requested. It will be fed images normalized in a way it never saw in training, which \" +\n                \"degrades accuracy without raising anything. Drop mean/std to let normalization='auto' \" +\n                \"pick the identity.\",\n        );\n    }\n    return { name: CUSTOM_NORMALIZATION, mean, std };\n}\n\n/**\n * Whether two channel triples are equal.\n *\n * @param value The triple to check.\n * @param reference The triple to compare against.\n */\nfunction isIdentity(\n    value: readonly [number, number, number],\n    reference: readonly [number, number, number],\n): boolean {\n    return value.every((entry, index) => entry === reference[index]);\n}\n"],"mappings":";AAmCA,IAAaA,IAAmD;CAAC;CAAO;CAAO;AAAK,GAGvEC,IAAkD;CAAC;CAAO;CAAO;AAAK,GAGtEC,IAAmD;CAAC;CAAG;CAAG;AAAC,GAG3DC,IAAkD;CAAC;CAAG;CAAG;AAAC,GAG1DC,IAAuB,UAE9BC,IAEF;CACA,UAAU,CAACL,GAAeC,CAAY;CACtC,aAAa,CAACC,GAAeC,CAAY;CACzC,MAAM,CAACD,GAAeC,CAAY;AACtC;AAqBA,SAAgBG,EAAwB,GAAqD;CACzF,QACKC,EAAS,UAAU,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,MAAM,kBAChDA,EAAS,QAAQ,GAAA,CAAI,KAAK,CAAC,CAAC,YAAY,MAAM;AAEvD;AAoBA,SAAgBC,EACZ,GACA,IAII,CAAC,GACgB;CACrB,IAAMC,IAAgBC,EAAQ,iBAAiB,QACzCC,IAAWD,EAAQ,SAAS,KAAA,KAAaA,EAAQ,QAAQ,KAAA;CAE/D,IAAID,MAAkB,UAAUJ,EAAQI,OAAmB,KAAA,GACvD,MAAU,WACN,+EACW,KAAK,UAAUA,CAAa,EAAE,EAC7C;CAEJ,IAAIE,KAAYF,MAAkB,QAC9B,MAAU,WACN,6BAA6B,KAAK,UAAUA,CAAa,EAAE,iCAC/D;CAGJ,IAAMG,IAAcN,EAAwBC,CAAQ,GAC9CM,IACFJ,MAAkB,SAAUG,IAAc,gBAAgB,aAAcH,GACtE,CAACK,GAAYC,KAAaV,EAAQQ;CAKxC,IAAI,CAACF,GACD,OAAO;EAAE,MAAME;EAAQ,MAAMC;EAAY,KAAKC;CAAU;CAG5D,IAAMC,IAAON,EAAQ,QAAQI,GACvBG,IAAMP,EAAQ,OAAOK;CAU3B,OATIH,KAAe,EAAEM,EAAWF,GAAMd,CAAa,KAAKgB,EAAWD,GAAKd,CAAY,MAChF,QAAQ,KACJ,gHAC+B,KAAK,UAAUa,CAAI,EAAE,SAAS,KAAK,UAAUC,CAAG,EAAE,mMAIrF,GAEG;EAAE,MAAMb;EAAsB;EAAM;CAAI;AACnD;AAQA,SAASc,EACL,GACA,GACO;CACP,OAAOC,EAAM,OAAO,GAAO,MAAUC,MAAUC,EAAUC,EAAM;AACnE"}

package/dist/vision/postprocess/classification.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"classification.cjs","names":[],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":"AAMA,SAAgB,EAAQ,EAAwD,CAC5E,IAAM,EAAI,EAAO,OACX,EAAM,IAAI,aAAa,CAAC,EAC1B,EAAM,KACV,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,CACxB,IAAM,EAAI,EAAO,GACb,EAAI,IAAK,EAAM,EACvB,CACA,IAAI,EAAM,EACV,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,CACxB,IAAM,EAAI,KAAK,IAAK,EAAO,GAAgB,CAAG,EAC9C,EAAI,GAAK,EACT,GAAO,CACX,CACA,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IACnB,EAAI,GAAM,EAAI,GAAgB,EAElC,OAAO,CACX,CAYA,SAAgB,EAAK,EAA6B,EAA8B,CAC5E,IAAM,EAAI,EAAc,OAClB,EAAO,IAAM,KAAO,EAAI,KAAK,IAAI,KAAK,IAAI,EAAG,CAAC,EAAG,CAAC,EAElD,EAAU,MAAc,CAAC,EAC/B,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,EAAI,GAAK,EACrC,EAAI,MAAM,EAAG,IAAO,EAAc,GAAiB,EAAc,EAAa,EAE9E,IAAM,EAAU,IAAI,WAAW,CAAI,EAC7B,EAAS,IAAI,aAAa,CAAI,EACpC,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,IAAK,CAC3B,IAAM,EAAI,EAAI,GACd,EAAQ,GAAK,EACb,EAAO,GAAK,EAAc,EAC9B,CACA,MAAO,CAAE,UAAS,QAAO,CAC7B"}
+{"version":3,"file":"classification.cjs","names":["softmax","n","logits","out","max","i","v","sum","e","topK","probabilities","kEff","k","idx","b","a","indices","values","j"],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":"AAMA,SAAgBA,EAAQ,EAAwD,CAC5E,IAAMC,EAAIC,EAAO,OACXC,EAAM,IAAI,aAAaF,CAAC,EAC1BG,EAAM,KACV,IAAK,IAAIC,EAAI,EAAGA,EAAIJ,EAAG,IAAK,CACxB,IAAMK,EAAIJ,EAAOG,GACbC,EAAIF,IAAK,EAAME,EACvB,CACA,IAAIC,EAAM,EACV,IAAK,IAAIF,EAAI,EAAGA,EAAIJ,EAAG,IAAK,CACxB,IAAMO,EAAI,KAAK,IAAKN,EAAOG,GAAgBD,CAAG,EAC9C,EAAIC,GAAKG,EACT,GAAOA,CACX,CACA,IAAK,IAAIH,EAAI,EAAGA,EAAIJ,EAAG,IACnB,EAAII,GAAMF,EAAIE,GAAgBE,EAElC,OAAOJ,CACX,CAYA,SAAgBM,EAAK,EAA6B,EAA8B,CAC5E,IAAM,EAAIC,EAAc,OAClBC,EAAOC,IAAM,KAAO,EAAI,KAAK,IAAI,KAAK,IAAI,EAAGA,CAAC,EAAG,CAAC,EAElDC,EAAU,MAAc,CAAC,EAC/B,IAAK,IAAIR,EAAI,EAAGA,EAAI,EAAG,IAAK,EAAIA,GAAKA,EACrCQ,EAAI,MAAM,EAAG,IAAOH,EAAcI,GAAiBJ,EAAcK,EAAa,EAE9E,IAAMC,EAAU,IAAI,WAAWL,CAAI,EAC7BM,EAAS,IAAI,aAAaN,CAAI,EACpC,IAAK,IAAIN,EAAI,EAAGA,EAAIM,EAAM,IAAK,CAC3B,IAAMO,EAAIL,EAAIR,GACd,EAAQA,GAAKa,EACb,EAAOb,GAAKK,EAAcQ,EAC9B,CACA,MAAO,CAAE,UAAS,QAAO,CAC7B,C"}

package/dist/vision/postprocess/classification.js.map

@@ -1 +1 @@
-{"version":3,"file":"classification.js","names":[],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":";AAMA,SAAgB,EAAQ,GAAwD;CAC5E,IAAM,IAAI,EAAO,QACX,IAAM,IAAI,aAAa,CAAC,GAC1B,IAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EACxB,IAAM,IAAI,EAAO;EACjB,AAAI,IAAI,MAAK,IAAM;CACvB;CACA,IAAI,IAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EACxB,IAAM,IAAI,KAAK,IAAK,EAAO,KAAgB,CAAG;EAE9C,AADA,EAAI,KAAK,GACT,KAAO;CACX;CACA,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACnB,EAAI,KAAM,EAAI,KAAgB;CAElC,OAAO;AACX;AAYA,SAAgB,EAAK,GAA6B,GAA8B;CAC5E,IAAM,IAAI,EAAc,QAClB,IAAO,MAAM,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,GAElD,IAAU,MAAc,CAAC;CAC/B,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK,EAAI,KAAK;CACrC,EAAI,MAAM,GAAG,MAAO,EAAc,KAAiB,EAAc,EAAa;CAE9E,IAAM,IAAU,IAAI,WAAW,CAAI,GAC7B,IAAS,IAAI,aAAa,CAAI;CACpC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAM,KAAK;EAC3B,IAAM,IAAI,EAAI;EAEd,AADA,EAAQ,KAAK,GACb,EAAO,KAAK,EAAc;CAC9B;CACA,OAAO;EAAE;EAAS;CAAO;AAC7B"}
+{"version":3,"file":"classification.js","names":["softmax","n","logits","out","max","i","v","sum","e","topK","probabilities","kEff","k","idx","b","a","indices","values","j"],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":";AAMA,SAAgBA,EAAQ,GAAwD;CAC5E,IAAMC,IAAIC,EAAO,QACXC,IAAM,IAAI,aAAaF,CAAC,GAC1BG,IAAM;CACV,KAAK,IAAIC,IAAI,GAAGA,IAAIJ,GAAG,KAAK;EACxB,IAAMK,IAAIJ,EAAOG;EACjB,AAAIC,IAAIF,MAAK,IAAME;CACvB;CACA,IAAIC,IAAM;CACV,KAAK,IAAIF,IAAI,GAAGA,IAAIJ,GAAG,KAAK;EACxB,IAAMO,IAAI,KAAK,IAAKN,EAAOG,KAAgBD,CAAG;EAE9C,AADA,EAAIC,KAAKG,GACT,KAAOA;CACX;CACA,KAAK,IAAIH,IAAI,GAAGA,IAAIJ,GAAG,KACnB,EAAII,KAAMF,EAAIE,KAAgBE;CAElC,OAAOJ;AACX;AAYA,SAAgBM,EAAK,GAA6B,GAA8B;CAC5E,IAAM,IAAIC,EAAc,QAClBC,IAAOC,MAAM,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,GAAGA,CAAC,GAAG,CAAC,GAElDC,IAAU,MAAc,CAAC;CAC/B,KAAK,IAAIR,IAAI,GAAGA,IAAI,GAAG,KAAK,EAAIA,KAAKA;CACrC,EAAI,MAAM,GAAG,MAAOK,EAAcI,KAAiBJ,EAAcK,EAAa;CAE9E,IAAMC,IAAU,IAAI,WAAWL,CAAI,GAC7BM,IAAS,IAAI,aAAaN,CAAI;CACpC,KAAK,IAAIN,IAAI,GAAGA,IAAIM,GAAM,KAAK;EAC3B,IAAMO,IAAIL,EAAIR;EAEd,AADA,EAAQA,KAAKa,GACb,EAAOb,KAAKK,EAAcQ;CAC9B;CACA,OAAO;EAAE;EAAS;CAAO;AAC7B"}