tempest-react-sdk 0.37.0 → 0.38.1

package/README.md

@@ -1839,9 +1839,9 @@ npm run clean          # rm -rf dist coverage
 
 Snapshot of current health:
 
-- 3969 tests / 451 files — 98.6% lines, 97.2% statements, 97.0% functions, 94.3% branches (CI floors: 98/97/96/94).
-- What your app actually pays (brotli, tree-shaken slices measured by `npm run size`): `cn` alone 153 B · one `Button` 794 B · a typical app shell (5 components + router + providers + HTTP + auth + a hook) 6.88 KB · offline/PWA surface 4.34 KB · `AIChat` (LLM transcript, pulls `Markdown` + `CodeBlock`) 9.41 KB · `styles.css` 26.33 KB · the opt-in `utilities.css` 1.33 KB.
-- Full-barrel ceiling — nobody imports this, it is the no-tree-shaking worst case: 94.27 KB ESM / 113.46 KB CJS.
+- 4705 tests / 485 files — 98.7% lines, 97.4% statements, 97.1% functions, 94.6% branches (CI floors: 98/97/96/94).
+- What your app actually pays (brotli, tree-shaken slices measured by `npm run size`): `cn` alone 133 B · one `Button` 798 B · a typical app shell (5 components + router + providers + HTTP + auth + a hook) 6.88 KB · offline/PWA surface 4.41 KB · `AIChat` 9.76 KB · audio capture 5.59 KB · device capture (barcode + video + screen + speech) 5.28 KB · BR payment rails (Pix + boleto + NFe + holidays) 9.00 KB · passkeys 2.15 KB · `styles.css` 27.64 KB · the opt-in `utilities.css` 1.33 KB.
+- Full-barrel ceiling — nobody imports this, it is the no-tree-shaking worst case: 108.04 KB ESM / 129.51 KB CJS.
 - Husky pre-commit runs `lint-staged` (eslint --fix + prettier --write) on staged files.
 
 The demo gallery lives in `examples/gallery` and consumes the local SDK via `file:../..`:

package/dist/vision/core/graph.cjs

@@ -1,2 +1,2 @@
-function e(e){return e===void 0?[]:e.map(e=>e.isTensor?e.shape.map(e=>typeof e==`number`&&Number.isInteger(e)&&e>0?e:null):[])}function t(e){if(e.length!==4)return null;let t=e[2],n=e[3];return t==null||n==null?null:[n,t]}function n(e){let n=e.graphShape===void 0?null:t(e.graphShape),r=e.requested;return n===null?r??e.fallback:(r!==void 0&&(r[0]!==n[0]||r[1]!==n[1])&&console.warn(`[ort-vision-sdk] The model declares a ${n[0]}x${n[1]} input; ignoring the requested ${r[0]}x${r[1]}, which ONNX Runtime would reject.`),n)}exports.declaredShapesFrom=e,exports.resolveInputSize=n,exports.spatialInputSize=t;
+function e(e){return e===void 0?[]:e.map(e=>e.isTensor?e.shape.map(e=>typeof e==`number`&&Number.isInteger(e)&&e>0?e:null):[])}function t(e){if(e.length!==4)return null;let t=e[2],n=e[3];return t==null||n==null?null:[n,t]}function n(e){let t=e.filter(e=>e!==null&&e>1);if(t.length===0)return null;let n=Math.min(...t);return n<5?null:n-4}function r(e){let t=e[e.length-1];return t==null||t<1?null:t}function i(e){let n=e.graphShape===void 0?null:t(e.graphShape),r=e.requested;return n===null?r??e.fallback:(r!==void 0&&(r[0]!==n[0]||r[1]!==n[1])&&console.warn(`[ort-vision-sdk] The model declares a ${n[0]}x${n[1]} input; ignoring the requested ${r[0]}x${r[1]}, which ONNX Runtime would reject.`),n)}exports.classificationNumClasses=r,exports.declaredShapesFrom=e,exports.detectionNumClasses=n,exports.resolveInputSize=i,exports.spatialInputSize=t;
 //# sourceMappingURL=graph.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph.cjs","names":[],"sources":["../../../src/vision/core/graph.ts"],"sourcesContent":["/**\n * What the ONNX graph itself says about its inputs.\n *\n * The resolution a session must be fed at is a property of the exported model,\n * not of the configuration around it. Feeding a 640x640 tensor to a graph\n * exported at 224x224 makes ORT abort the run with\n * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the\n * caller has no way to see that coming from the outside — the number lives in\n * the file. So the SDK reads it from the graph and treats any configured size as\n * a fallback for when the graph leaves it open.\n */\n\nimport type * as ort from \"onnxruntime-web\";\n\n/**\n * One declared dimension: a number when the graph pins it, `null` when the\n * dimension is symbolic (dynamic).\n */\nexport type DeclaredDim = number | null;\n\n/** A declared input/output shape, dynamic axes appearing as `null`. */\nexport type DeclaredShape = readonly DeclaredDim[];\n\n/**\n * Convert ORT value metadata into declared shapes.\n *\n * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or\n *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).\n * @returns One shape per value, in declaration order. Non-tensor values and\n *   builds without metadata yield empty shapes, which read as \"nothing\n *   declared\" everywhere downstream.\n */\nexport function declaredShapesFrom(\n    metadata: readonly ort.InferenceSession.ValueMetadata[] | undefined,\n): readonly DeclaredShape[] {\n    if (metadata === undefined) return [];\n    return metadata.map((value) =>\n        value.isTensor\n            ? value.shape.map((dim) =>\n                  typeof dim === \"number\" && Number.isInteger(dim) && dim > 0 ? dim : null,\n              )\n            : [],\n    );\n}\n\n/**\n * Read the spatial input size out of a declared NCHW shape.\n *\n * @param shape The declared shape of the model's image input.\n * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or\n *   leaves either spatial axis dynamic — in which case the model accepts more\n *   than one resolution and there is nothing to correct.\n */\nexport function spatialInputSize(shape: DeclaredShape): readonly [number, number] | null {\n    if (shape.length !== 4) return null;\n    const height = shape[2];\n    const width = shape[3];\n    if (height === null || height === undefined || width === null || width === undefined)\n        return null;\n    return [width, height];\n}\n\nexport interface ResolveInputSizeOptions {\n    /** Declared shape of the model's image input, from {@link declaredShapesFrom}. */\n    readonly graphShape?: DeclaredShape;\n    /** Size the caller asked for, if any. */\n    readonly requested?: readonly [number, number];\n    /** Size to use when neither the graph nor the caller pins one. */\n    readonly fallback: readonly [number, number];\n}\n\n/**\n * Decide the input size a task will preprocess to.\n *\n * Precedence is graph → caller → fallback. The graph wins over an explicit\n * `inputSize` because a static shape is not a preference, it is what ORT will\n * accept: honoring the caller there would only turn a fixable mismatch into a\n * failed run. A disagreement is a configuration bug in the caller, so it is\n * reported through `console.warn` instead of being swallowed.\n *\n * @param options Graph shape, requested size and per-task fallback.\n * @returns The `[width, height]` to preprocess to.\n */\nexport function resolveInputSize(options: ResolveInputSizeOptions): readonly [number, number] {\n    const graph = options.graphShape === undefined ? null : spatialInputSize(options.graphShape);\n    const requested = options.requested;\n    if (graph === null) return requested ?? options.fallback;\n    if (requested !== undefined && (requested[0] !== graph[0] || requested[1] !== graph[1])) {\n        console.warn(\n            `[ort-vision-sdk] The model declares a ${graph[0]}x${graph[1]} input; ` +\n                `ignoring the requested ${requested[0]}x${requested[1]}, which ONNX Runtime would reject.`,\n        );\n    }\n    return graph;\n}\n"],"mappings":"AAgCA,SAAgB,EACZ,EACwB,CAExB,OADI,IAAa,IAAA,GAAkB,CAAC,EAC7B,EAAS,IAAK,GACjB,EAAM,SACA,EAAM,MAAM,IAAK,GACb,OAAO,GAAQ,UAAY,OAAO,UAAU,CAAG,GAAK,EAAM,EAAI,EAAM,IACxE,EACA,CAAC,CACX,CACJ,CAUA,SAAgB,EAAiB,EAAwD,CACrF,GAAI,EAAM,SAAW,EAAG,OAAO,KAC/B,IAAM,EAAS,EAAM,GACf,EAAQ,EAAM,GAGpB,OAFI,GAAW,MAAgC,GAAU,KAC9C,KACJ,CAAC,EAAO,CAAM,CACzB,CAuBA,SAAgB,EAAiB,EAA6D,CAC1F,IAAM,EAAQ,EAAQ,aAAe,IAAA,GAAY,KAAO,EAAiB,EAAQ,UAAU,EACrF,EAAY,EAAQ,UAQ1B,OAPI,IAAU,KAAa,GAAa,EAAQ,UAC5C,IAAc,IAAA,KAAc,EAAU,KAAO,EAAM,IAAM,EAAU,KAAO,EAAM,KAChF,QAAQ,KACJ,yCAAyC,EAAM,GAAG,GAAG,EAAM,GAAG,iCAChC,EAAU,GAAG,GAAG,EAAU,GAAG,mCAC/D,EAEG,EACX"}
+{"version":3,"file":"graph.cjs","names":[],"sources":["../../../src/vision/core/graph.ts"],"sourcesContent":["/**\n * What the ONNX graph itself says about its inputs.\n *\n * The resolution a session must be fed at is a property of the exported model,\n * not of the configuration around it. Feeding a 640x640 tensor to a graph\n * exported at 224x224 makes ORT abort the run with\n * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the\n * caller has no way to see that coming from the outside — the number lives in\n * the file. So the SDK reads it from the graph and treats any configured size as\n * a fallback for when the graph leaves it open.\n */\n\nimport type * as ort from \"onnxruntime-web\";\n\n/**\n * One declared dimension: a number when the graph pins it, `null` when the\n * dimension is symbolic (dynamic).\n */\nexport type DeclaredDim = number | null;\n\n/** A declared input/output shape, dynamic axes appearing as `null`. */\nexport type DeclaredShape = readonly DeclaredDim[];\n\n/**\n * Convert ORT value metadata into declared shapes.\n *\n * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or\n *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).\n * @returns One shape per value, in declaration order. Non-tensor values and\n *   builds without metadata yield empty shapes, which read as \"nothing\n *   declared\" everywhere downstream.\n */\nexport function declaredShapesFrom(\n    metadata: readonly ort.InferenceSession.ValueMetadata[] | undefined,\n): readonly DeclaredShape[] {\n    if (metadata === undefined) return [];\n    return metadata.map((value) =>\n        value.isTensor\n            ? value.shape.map((dim) =>\n                  typeof dim === \"number\" && Number.isInteger(dim) && dim > 0 ? dim : null,\n              )\n            : [],\n    );\n}\n\n/**\n * Read the spatial input size out of a declared NCHW shape.\n *\n * @param shape The declared shape of the model's image input.\n * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or\n *   leaves either spatial axis dynamic — in which case the model accepts more\n *   than one resolution and there is nothing to correct.\n */\nexport function spatialInputSize(shape: DeclaredShape): readonly [number, number] | null {\n    if (shape.length !== 4) return null;\n    const height = shape[2];\n    const width = shape[3];\n    if (height === null || height === undefined || width === null || width === undefined)\n        return null;\n    return [width, height];\n}\n\n/**\n * Infer how many classes a YOLO detection/segmentation head emits.\n *\n * Such a head declares `(B, 4 + nc, N)` — four box coordinates stacked above one\n * score per class, over `N` candidate anchors. `N` is in the thousands and the\n * batch is 1, so the channel axis is the smallest static axis above 1.\n *\n * @param shape Declared shape of the model's first output.\n * @returns The class count, or `null` when the shape leaves it undeterminable —\n *   fully dynamic, or too small to hold boxes plus at least one class.\n */\nexport function detectionNumClasses(shape: DeclaredShape): number | null {\n    const staticDims = shape.filter((dim): dim is number => dim !== null && dim > 1);\n    if (staticDims.length === 0) return null;\n    const channels = Math.min(...staticDims);\n    if (channels < 5) return null;\n    return channels - 4;\n}\n\n/**\n * Infer how many classes a classification head emits.\n *\n * A classifier declares `(B, nc)`, so the count is the last static axis.\n *\n * @param shape Declared shape of the model's first output.\n * @returns The class count, or `null` when the last axis is dynamic or absent.\n */\nexport function classificationNumClasses(shape: DeclaredShape): number | null {\n    const last = shape[shape.length - 1];\n    if (last === null || last === undefined || last < 1) return null;\n    return last;\n}\n\nexport interface ResolveInputSizeOptions {\n    /** Declared shape of the model's image input, from {@link declaredShapesFrom}. */\n    readonly graphShape?: DeclaredShape;\n    /** Size the caller asked for, if any. */\n    readonly requested?: readonly [number, number];\n    /** Size to use when neither the graph nor the caller pins one. */\n    readonly fallback: readonly [number, number];\n}\n\n/**\n * Decide the input size a task will preprocess to.\n *\n * Precedence is graph → caller → fallback. The graph wins over an explicit\n * `inputSize` because a static shape is not a preference, it is what ORT will\n * accept: honoring the caller there would only turn a fixable mismatch into a\n * failed run. A disagreement is a configuration bug in the caller, so it is\n * reported through `console.warn` instead of being swallowed.\n *\n * @param options Graph shape, requested size and per-task fallback.\n * @returns The `[width, height]` to preprocess to.\n */\nexport function resolveInputSize(options: ResolveInputSizeOptions): readonly [number, number] {\n    const graph = options.graphShape === undefined ? null : spatialInputSize(options.graphShape);\n    const requested = options.requested;\n    if (graph === null) return requested ?? options.fallback;\n    if (requested !== undefined && (requested[0] !== graph[0] || requested[1] !== graph[1])) {\n        console.warn(\n            `[ort-vision-sdk] The model declares a ${graph[0]}x${graph[1]} input; ` +\n                `ignoring the requested ${requested[0]}x${requested[1]}, which ONNX Runtime would reject.`,\n        );\n    }\n    return graph;\n}\n"],"mappings":"AAgCA,SAAgB,EACZ,EACwB,CAExB,OADI,IAAa,IAAA,GAAkB,CAAC,EAC7B,EAAS,IAAK,GACjB,EAAM,SACA,EAAM,MAAM,IAAK,GACb,OAAO,GAAQ,UAAY,OAAO,UAAU,CAAG,GAAK,EAAM,EAAI,EAAM,IACxE,EACA,CAAC,CACX,CACJ,CAUA,SAAgB,EAAiB,EAAwD,CACrF,GAAI,EAAM,SAAW,EAAG,OAAO,KAC/B,IAAM,EAAS,EAAM,GACf,EAAQ,EAAM,GAGpB,OAFI,GAAW,MAAgC,GAAU,KAC9C,KACJ,CAAC,EAAO,CAAM,CACzB,CAaA,SAAgB,EAAoB,EAAqC,CACrE,IAAM,EAAa,EAAM,OAAQ,GAAuB,IAAQ,MAAQ,EAAM,CAAC,EAC/E,GAAI,EAAW,SAAW,EAAG,OAAO,KACpC,IAAM,EAAW,KAAK,IAAI,GAAG,CAAU,EAEvC,OADI,EAAW,EAAU,KAClB,EAAW,CACtB,CAUA,SAAgB,EAAyB,EAAqC,CAC1E,IAAM,EAAO,EAAM,EAAM,OAAS,GAElC,OADI,GAAS,MAA8B,EAAO,EAAU,KACrD,CACX,CAuBA,SAAgB,EAAiB,EAA6D,CAC1F,IAAM,EAAQ,EAAQ,aAAe,IAAA,GAAY,KAAO,EAAiB,EAAQ,UAAU,EACrF,EAAY,EAAQ,UAQ1B,OAPI,IAAU,KAAa,GAAa,EAAQ,UAC5C,IAAc,IAAA,KAAc,EAAU,KAAO,EAAM,IAAM,EAAU,KAAO,EAAM,KAChF,QAAQ,KACJ,yCAAyC,EAAM,GAAG,GAAG,EAAM,GAAG,iCAChC,EAAU,GAAG,GAAG,EAAU,GAAG,mCAC/D,EAEG,EACX"}

package/dist/vision/core/graph.js

@@ -8,10 +8,20 @@ function t(e) {
 	return t == null || n == null ? null : [n, t];
 }
 function n(e) {
+	let t = e.filter((e) => e !== null && e > 1);
+	if (t.length === 0) return null;
+	let n = Math.min(...t);
+	return n < 5 ? null : n - 4;
+}
+function r(e) {
+	let t = e[e.length - 1];
+	return t == null || t < 1 ? null : t;
+}
+function i(e) {
 	let n = e.graphShape === void 0 ? null : t(e.graphShape), r = e.requested;
 	return n === null ? r ?? e.fallback : (r !== void 0 && (r[0] !== n[0] || r[1] !== n[1]) && console.warn(`[ort-vision-sdk] The model declares a ${n[0]}x${n[1]} input; ignoring the requested ${r[0]}x${r[1]}, which ONNX Runtime would reject.`), n);
 }
 //#endregion
-export { e as declaredShapesFrom, n as resolveInputSize, t as spatialInputSize };
+export { r as classificationNumClasses, e as declaredShapesFrom, n as detectionNumClasses, i as resolveInputSize, t as spatialInputSize };
 
 //# sourceMappingURL=graph.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"graph.js","names":[],"sources":["../../../src/vision/core/graph.ts"],"sourcesContent":["/**\n * What the ONNX graph itself says about its inputs.\n *\n * The resolution a session must be fed at is a property of the exported model,\n * not of the configuration around it. Feeding a 640x640 tensor to a graph\n * exported at 224x224 makes ORT abort the run with\n * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the\n * caller has no way to see that coming from the outside — the number lives in\n * the file. So the SDK reads it from the graph and treats any configured size as\n * a fallback for when the graph leaves it open.\n */\n\nimport type * as ort from \"onnxruntime-web\";\n\n/**\n * One declared dimension: a number when the graph pins it, `null` when the\n * dimension is symbolic (dynamic).\n */\nexport type DeclaredDim = number | null;\n\n/** A declared input/output shape, dynamic axes appearing as `null`. */\nexport type DeclaredShape = readonly DeclaredDim[];\n\n/**\n * Convert ORT value metadata into declared shapes.\n *\n * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or\n *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).\n * @returns One shape per value, in declaration order. Non-tensor values and\n *   builds without metadata yield empty shapes, which read as \"nothing\n *   declared\" everywhere downstream.\n */\nexport function declaredShapesFrom(\n    metadata: readonly ort.InferenceSession.ValueMetadata[] | undefined,\n): readonly DeclaredShape[] {\n    if (metadata === undefined) return [];\n    return metadata.map((value) =>\n        value.isTensor\n            ? value.shape.map((dim) =>\n                  typeof dim === \"number\" && Number.isInteger(dim) && dim > 0 ? dim : null,\n              )\n            : [],\n    );\n}\n\n/**\n * Read the spatial input size out of a declared NCHW shape.\n *\n * @param shape The declared shape of the model's image input.\n * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or\n *   leaves either spatial axis dynamic — in which case the model accepts more\n *   than one resolution and there is nothing to correct.\n */\nexport function spatialInputSize(shape: DeclaredShape): readonly [number, number] | null {\n    if (shape.length !== 4) return null;\n    const height = shape[2];\n    const width = shape[3];\n    if (height === null || height === undefined || width === null || width === undefined)\n        return null;\n    return [width, height];\n}\n\nexport interface ResolveInputSizeOptions {\n    /** Declared shape of the model's image input, from {@link declaredShapesFrom}. */\n    readonly graphShape?: DeclaredShape;\n    /** Size the caller asked for, if any. */\n    readonly requested?: readonly [number, number];\n    /** Size to use when neither the graph nor the caller pins one. */\n    readonly fallback: readonly [number, number];\n}\n\n/**\n * Decide the input size a task will preprocess to.\n *\n * Precedence is graph → caller → fallback. The graph wins over an explicit\n * `inputSize` because a static shape is not a preference, it is what ORT will\n * accept: honoring the caller there would only turn a fixable mismatch into a\n * failed run. A disagreement is a configuration bug in the caller, so it is\n * reported through `console.warn` instead of being swallowed.\n *\n * @param options Graph shape, requested size and per-task fallback.\n * @returns The `[width, height]` to preprocess to.\n */\nexport function resolveInputSize(options: ResolveInputSizeOptions): readonly [number, number] {\n    const graph = options.graphShape === undefined ? null : spatialInputSize(options.graphShape);\n    const requested = options.requested;\n    if (graph === null) return requested ?? options.fallback;\n    if (requested !== undefined && (requested[0] !== graph[0] || requested[1] !== graph[1])) {\n        console.warn(\n            `[ort-vision-sdk] The model declares a ${graph[0]}x${graph[1]} input; ` +\n                `ignoring the requested ${requested[0]}x${requested[1]}, which ONNX Runtime would reject.`,\n        );\n    }\n    return graph;\n}\n"],"mappings":";AAgCA,SAAgB,EACZ,GACwB;CAExB,OADI,MAAa,KAAA,IAAkB,CAAC,IAC7B,EAAS,KAAK,MACjB,EAAM,WACA,EAAM,MAAM,KAAK,MACb,OAAO,KAAQ,YAAY,OAAO,UAAU,CAAG,KAAK,IAAM,IAAI,IAAM,IACxE,IACA,CAAC,CACX;AACJ;AAUA,SAAgB,EAAiB,GAAwD;CACrF,IAAI,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAM,IAAS,EAAM,IACf,IAAQ,EAAM;CAGpB,OAFI,KAAW,QAAgC,KAAU,OAC9C,OACJ,CAAC,GAAO,CAAM;AACzB;AAuBA,SAAgB,EAAiB,GAA6D;CAC1F,IAAM,IAAQ,EAAQ,eAAe,KAAA,IAAY,OAAO,EAAiB,EAAQ,UAAU,GACrF,IAAY,EAAQ;CAQ1B,OAPI,MAAU,OAAa,KAAa,EAAQ,YAC5C,MAAc,KAAA,MAAc,EAAU,OAAO,EAAM,MAAM,EAAU,OAAO,EAAM,OAChF,QAAQ,KACJ,yCAAyC,EAAM,GAAG,GAAG,EAAM,GAAG,iCAChC,EAAU,GAAG,GAAG,EAAU,GAAG,mCAC/D,GAEG;AACX"}
+{"version":3,"file":"graph.js","names":[],"sources":["../../../src/vision/core/graph.ts"],"sourcesContent":["/**\n * What the ONNX graph itself says about its inputs.\n *\n * The resolution a session must be fed at is a property of the exported model,\n * not of the configuration around it. Feeding a 640x640 tensor to a graph\n * exported at 224x224 makes ORT abort the run with\n * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the\n * caller has no way to see that coming from the outside — the number lives in\n * the file. So the SDK reads it from the graph and treats any configured size as\n * a fallback for when the graph leaves it open.\n */\n\nimport type * as ort from \"onnxruntime-web\";\n\n/**\n * One declared dimension: a number when the graph pins it, `null` when the\n * dimension is symbolic (dynamic).\n */\nexport type DeclaredDim = number | null;\n\n/** A declared input/output shape, dynamic axes appearing as `null`. */\nexport type DeclaredShape = readonly DeclaredDim[];\n\n/**\n * Convert ORT value metadata into declared shapes.\n *\n * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or\n *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).\n * @returns One shape per value, in declaration order. Non-tensor values and\n *   builds without metadata yield empty shapes, which read as \"nothing\n *   declared\" everywhere downstream.\n */\nexport function declaredShapesFrom(\n    metadata: readonly ort.InferenceSession.ValueMetadata[] | undefined,\n): readonly DeclaredShape[] {\n    if (metadata === undefined) return [];\n    return metadata.map((value) =>\n        value.isTensor\n            ? value.shape.map((dim) =>\n                  typeof dim === \"number\" && Number.isInteger(dim) && dim > 0 ? dim : null,\n              )\n            : [],\n    );\n}\n\n/**\n * Read the spatial input size out of a declared NCHW shape.\n *\n * @param shape The declared shape of the model's image input.\n * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or\n *   leaves either spatial axis dynamic — in which case the model accepts more\n *   than one resolution and there is nothing to correct.\n */\nexport function spatialInputSize(shape: DeclaredShape): readonly [number, number] | null {\n    if (shape.length !== 4) return null;\n    const height = shape[2];\n    const width = shape[3];\n    if (height === null || height === undefined || width === null || width === undefined)\n        return null;\n    return [width, height];\n}\n\n/**\n * Infer how many classes a YOLO detection/segmentation head emits.\n *\n * Such a head declares `(B, 4 + nc, N)` — four box coordinates stacked above one\n * score per class, over `N` candidate anchors. `N` is in the thousands and the\n * batch is 1, so the channel axis is the smallest static axis above 1.\n *\n * @param shape Declared shape of the model's first output.\n * @returns The class count, or `null` when the shape leaves it undeterminable —\n *   fully dynamic, or too small to hold boxes plus at least one class.\n */\nexport function detectionNumClasses(shape: DeclaredShape): number | null {\n    const staticDims = shape.filter((dim): dim is number => dim !== null && dim > 1);\n    if (staticDims.length === 0) return null;\n    const channels = Math.min(...staticDims);\n    if (channels < 5) return null;\n    return channels - 4;\n}\n\n/**\n * Infer how many classes a classification head emits.\n *\n * A classifier declares `(B, nc)`, so the count is the last static axis.\n *\n * @param shape Declared shape of the model's first output.\n * @returns The class count, or `null` when the last axis is dynamic or absent.\n */\nexport function classificationNumClasses(shape: DeclaredShape): number | null {\n    const last = shape[shape.length - 1];\n    if (last === null || last === undefined || last < 1) return null;\n    return last;\n}\n\nexport interface ResolveInputSizeOptions {\n    /** Declared shape of the model's image input, from {@link declaredShapesFrom}. */\n    readonly graphShape?: DeclaredShape;\n    /** Size the caller asked for, if any. */\n    readonly requested?: readonly [number, number];\n    /** Size to use when neither the graph nor the caller pins one. */\n    readonly fallback: readonly [number, number];\n}\n\n/**\n * Decide the input size a task will preprocess to.\n *\n * Precedence is graph → caller → fallback. The graph wins over an explicit\n * `inputSize` because a static shape is not a preference, it is what ORT will\n * accept: honoring the caller there would only turn a fixable mismatch into a\n * failed run. A disagreement is a configuration bug in the caller, so it is\n * reported through `console.warn` instead of being swallowed.\n *\n * @param options Graph shape, requested size and per-task fallback.\n * @returns The `[width, height]` to preprocess to.\n */\nexport function resolveInputSize(options: ResolveInputSizeOptions): readonly [number, number] {\n    const graph = options.graphShape === undefined ? null : spatialInputSize(options.graphShape);\n    const requested = options.requested;\n    if (graph === null) return requested ?? options.fallback;\n    if (requested !== undefined && (requested[0] !== graph[0] || requested[1] !== graph[1])) {\n        console.warn(\n            `[ort-vision-sdk] The model declares a ${graph[0]}x${graph[1]} input; ` +\n                `ignoring the requested ${requested[0]}x${requested[1]}, which ONNX Runtime would reject.`,\n        );\n    }\n    return graph;\n}\n"],"mappings":";AAgCA,SAAgB,EACZ,GACwB;CAExB,OADI,MAAa,KAAA,IAAkB,CAAC,IAC7B,EAAS,KAAK,MACjB,EAAM,WACA,EAAM,MAAM,KAAK,MACb,OAAO,KAAQ,YAAY,OAAO,UAAU,CAAG,KAAK,IAAM,IAAI,IAAM,IACxE,IACA,CAAC,CACX;AACJ;AAUA,SAAgB,EAAiB,GAAwD;CACrF,IAAI,EAAM,WAAW,GAAG,OAAO;CAC/B,IAAM,IAAS,EAAM,IACf,IAAQ,EAAM;CAGpB,OAFI,KAAW,QAAgC,KAAU,OAC9C,OACJ,CAAC,GAAO,CAAM;AACzB;AAaA,SAAgB,EAAoB,GAAqC;CACrE,IAAM,IAAa,EAAM,QAAQ,MAAuB,MAAQ,QAAQ,IAAM,CAAC;CAC/E,IAAI,EAAW,WAAW,GAAG,OAAO;CACpC,IAAM,IAAW,KAAK,IAAI,GAAG,CAAU;CAEvC,OADI,IAAW,IAAU,OAClB,IAAW;AACtB;AAUA,SAAgB,EAAyB,GAAqC;CAC1E,IAAM,IAAO,EAAM,EAAM,SAAS;CAElC,OADI,KAAS,QAA8B,IAAO,IAAU,OACrD;AACX;AAuBA,SAAgB,EAAiB,GAA6D;CAC1F,IAAM,IAAQ,EAAQ,eAAe,KAAA,IAAY,OAAO,EAAiB,EAAQ,UAAU,GACrF,IAAY,EAAQ;CAQ1B,OAPI,MAAU,OAAa,KAAa,EAAQ,YAC5C,MAAc,KAAA,MAAc,EAAU,OAAO,EAAM,MAAM,EAAU,OAAO,EAAM,OAChF,QAAQ,KACJ,yCAAyC,EAAM,GAAG,GAAG,EAAM,GAAG,iCAChC,EAAU,GAAG,GAAG,EAAU,GAAG,mCAC/D,GAEG;AACX"}

package/dist/vision/core/metadata.cjs

@@ -0,0 +1,3 @@
+function e(e){let t=0,n=0;for(;e.pos<e.end;){let r=e.bytes[e.pos];if(e.pos+=1,t+=(r&127)*2**n,!(r&128))return t;if(n+=7,n>63)return null}return null}function t(t,n){switch(n){case 0:return e(t)!==null;case 1:return t.pos+=8,t.pos<=t.end;case 2:{let n=e(t);return n===null?!1:(t.pos+=n,t.pos<=t.end)}case 5:return t.pos+=4,t.pos<=t.end;default:return!1}}function n(t){let n=e(t);if(n===null||n>1048576)return null;let r=t.pos,i=r+n;return i>t.end?null:(t.pos=i,{start:r,end:i})}function r(r,i,a){let o={bytes:r,end:a,pos:i},s=new TextDecoder(`utf-8`,{fatal:!1}),c=null,l=null;for(;o.pos<a;){let i=e(o);if(i===null)return null;let a=i>>>3,u=i&7;if(u===2&&(a===1||a===2)){let e=n(o);if(e===null)return null;let t=s.decode(r.subarray(e.start,e.end));a===1?c=t:l=t;continue}if(!t(o,u))return null}return c===null||l===null?null:[c,l]}function i(i){let a=i instanceof Uint8Array?i:new Uint8Array(i),o={bytes:a,end:a.length,pos:0},s={};for(;o.pos<o.end;){let i=e(o);if(i===null)break;let c=i>>>3,l=i&7;if(c===14&&l===2){let e=n(o);if(e===null)break;let t=r(a,e.start,e.end);t&&(s[t[0]]=t[1]);continue}if(!t(o,l))break}return s}function a(e){let t=e?.names?.trim();if(!t||!t.startsWith(`{`)||!t.endsWith(`}`))return null;let n=t.slice(1,-1).trim();if(!n)return null;let r=new Map,i=/(-?\d+)\s*:\s*(?:'((?:[^'\\]|\\.)*)'|"((?:[^"\\]|\\.)*)")/g,a=0;for(let e of n.matchAll(i)){let t=Number(e[1]),n=e[2]??e[3];if(!Number.isInteger(t)||n===void 0)return null;r.set(t,o(n)),a+=e[0].length}if(r.size===0||n.length-a>r.size*3)return null;let s=[];for(let e=0;e<r.size;e+=1){let t=r.get(e);if(t===void 0)return null;s.push(t)}return s}function o(e){return e.replace(/\\(.)/g,(e,t)=>t===`n`?`
+`:t===`r`?`\r`:t===`t`?`	`:t)}exports.modelNames=a,exports.readModelMetadata=i;
+//# sourceMappingURL=metadata.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.cjs","names":[],"sources":["../../../src/vision/core/metadata.ts"],"sourcesContent":["/**\n * Read the metadata an exporter baked into a `.onnx` file.\n *\n * `onnxruntime-web` exposes input/output metadata but **not** the model's\n * custom metadata map, which is where Ultralytics writes `names`, `task` and\n * `imgsz`. The Python SDK gets it for free from\n * `InferenceSession.get_modelmeta().custom_metadata_map`; in the browser the\n * only way to the same information is to read it out of the file, so this\n * module walks just enough of the ModelProto wire format to collect\n * `metadata_props`.\n *\n * It never throws and never allocates unbounded: a truncated, hostile or\n * simply unexpected file yields an empty map, and every caller treats that as\n * \"the model says nothing\", falling back to what it was given.\n */\n\n/** Field number of `metadata_props` in `ModelProto` (repeated StringStringEntryProto). */\nconst MODEL_METADATA_PROPS_FIELD = 14;\n\n/** Field numbers of `key` and `value` in `StringStringEntryProto`. */\nconst ENTRY_KEY_FIELD = 1;\nconst ENTRY_VALUE_FIELD = 2;\n\n/** Protobuf wire types this reader understands. */\nconst WIRE_VARINT = 0;\nconst WIRE_FIXED64 = 1;\nconst WIRE_LENGTH_DELIMITED = 2;\nconst WIRE_FIXED32 = 5;\n\n/**\n * Hard ceiling on a single length-delimited field, as a guard against a corrupt\n * length turning into a huge slice. Model metadata values are strings — a class\n * name map for thousands of classes still fits well inside this.\n */\nconst MAX_FIELD_BYTES = 1 << 20;\n\n/** A cursor over a byte range, tracking its own position. */\ninterface Cursor {\n    readonly bytes: Uint8Array;\n    readonly end: number;\n    pos: number;\n}\n\n/**\n * Read a base-128 varint.\n *\n * @param cursor Cursor to advance.\n * @returns The value, or `null` when the varint is truncated or overlong\n *   (beyond the 64-bit range protobuf allows).\n */\nfunction readVarint(cursor: Cursor): number | null {\n    let result = 0;\n    let shift = 0;\n    while (cursor.pos < cursor.end) {\n        const byte = cursor.bytes[cursor.pos]!;\n        cursor.pos += 1;\n        result += (byte & 0x7f) * 2 ** shift;\n        if ((byte & 0x80) === 0) return result;\n        shift += 7;\n        if (shift > 63) return null;\n    }\n    return null;\n}\n\n/**\n * Skip a field whose contents are not needed.\n *\n * @param cursor Cursor to advance past the field's payload.\n * @param wireType Wire type read from the field's tag.\n * @returns `true` when the field was skipped, `false` when the stream is\n *   unreadable from here (unknown wire type or truncated payload).\n */\nfunction skipField(cursor: Cursor, wireType: number): boolean {\n    switch (wireType) {\n        case WIRE_VARINT:\n            return readVarint(cursor) !== null;\n        case WIRE_FIXED64:\n            cursor.pos += 8;\n            return cursor.pos <= cursor.end;\n        case WIRE_LENGTH_DELIMITED: {\n            const length = readVarint(cursor);\n            if (length === null) return false;\n            cursor.pos += length;\n            return cursor.pos <= cursor.end;\n        }\n        case WIRE_FIXED32:\n            cursor.pos += 4;\n            return cursor.pos <= cursor.end;\n        default:\n            return false;\n    }\n}\n\n/**\n * Read a length-delimited payload as a byte range.\n *\n * @param cursor Cursor to advance past the payload.\n * @returns Start and end offsets of the payload, or `null` when the length is\n *   truncated, overruns the buffer, or exceeds {@link MAX_FIELD_BYTES}.\n */\nfunction readLengthDelimited(cursor: Cursor): { start: number; end: number } | null {\n    const length = readVarint(cursor);\n    if (length === null || length > MAX_FIELD_BYTES) return null;\n    const start = cursor.pos;\n    const end = start + length;\n    if (end > cursor.end) return null;\n    cursor.pos = end;\n    return { start, end };\n}\n\n/**\n * Decode one `StringStringEntryProto` into a key/value pair.\n *\n * @param bytes The model buffer.\n * @param start Offset the entry's payload starts at.\n * @param end Offset the entry's payload ends at.\n * @returns The pair, or `null` when either half is missing or undecodable.\n */\nfunction readEntry(\n    bytes: Uint8Array,\n    start: number,\n    end: number,\n): readonly [string, string] | null {\n    const cursor: Cursor = { bytes, end, pos: start };\n    const decoder = new TextDecoder(\"utf-8\", { fatal: false });\n    let key: string | null = null;\n    let value: string | null = null;\n\n    while (cursor.pos < end) {\n        const tag = readVarint(cursor);\n        if (tag === null) return null;\n        const field = tag >>> 3;\n        const wireType = tag & 0x07;\n        if (\n            wireType === WIRE_LENGTH_DELIMITED &&\n            (field === ENTRY_KEY_FIELD || field === ENTRY_VALUE_FIELD)\n        ) {\n            const range = readLengthDelimited(cursor);\n            if (range === null) return null;\n            const text = decoder.decode(bytes.subarray(range.start, range.end));\n            if (field === ENTRY_KEY_FIELD) key = text;\n            else value = text;\n            continue;\n        }\n        if (!skipField(cursor, wireType)) return null;\n    }\n\n    if (key === null || value === null) return null;\n    return [key, value];\n}\n\n/**\n * Collect a model's custom metadata map straight out of its bytes.\n *\n * @param model The `.onnx` file contents.\n * @returns Key/value metadata — `names`, `task`, `imgsz`, ... for an\n *   Ultralytics export — or an empty object when the file carries none or\n *   cannot be walked.\n */\nexport function readModelMetadata(\n    model: Uint8Array | ArrayBufferLike,\n): Readonly<Record<string, string>> {\n    const bytes = model instanceof Uint8Array ? model : new Uint8Array(model);\n    const cursor: Cursor = { bytes, end: bytes.length, pos: 0 };\n    const metadata: Record<string, string> = {};\n\n    while (cursor.pos < cursor.end) {\n        const tag = readVarint(cursor);\n        if (tag === null) break;\n        const field = tag >>> 3;\n        const wireType = tag & 0x07;\n        if (field === MODEL_METADATA_PROPS_FIELD && wireType === WIRE_LENGTH_DELIMITED) {\n            const range = readLengthDelimited(cursor);\n            if (range === null) break;\n            const entry = readEntry(bytes, range.start, range.end);\n            if (entry) metadata[entry[0]] = entry[1];\n            continue;\n        }\n        if (!skipField(cursor, wireType)) break;\n    }\n\n    return metadata;\n}\n\n/**\n * Read the class names an export baked into the model metadata.\n *\n * Ultralytics writes `names` as the Python `repr` of a `dict[int, str]` — e.g.\n * `\"{0: 'deworm', 1: 'not_deworm'}\"`. The value is parsed structurally (never\n * evaluated), and anything unparseable, non-`dict`, or not keyed by contiguous\n * integers from zero is rejected whole rather than half-applied: a partial name\n * map would silently mislabel predictions.\n *\n * @param metadata A model's custom metadata map.\n * @returns Class names in class-id order, or `null` when the model carries no\n *   usable `names` entry.\n */\nexport function modelNames(\n    metadata: Readonly<Record<string, string>> | undefined,\n): readonly string[] | null {\n    const raw = metadata?.names?.trim();\n    if (!raw || !raw.startsWith(\"{\") || !raw.endsWith(\"}\")) return null;\n\n    const body = raw.slice(1, -1).trim();\n    if (!body) return null;\n\n    const names = new Map<number, string>();\n    const entryPattern = /(-?\\d+)\\s*:\\s*(?:'((?:[^'\\\\]|\\\\.)*)'|\"((?:[^\"\\\\]|\\\\.)*)\")/g;\n    let consumed = 0;\n    for (const match of body.matchAll(entryPattern)) {\n        const id = Number(match[1]);\n        const text = match[2] ?? match[3];\n        if (!Number.isInteger(id) || text === undefined) return null;\n        names.set(id, unescapeQuoted(text));\n        consumed += match[0].length;\n    }\n    if (names.size === 0) return null;\n\n    const separators = body.length - consumed;\n    if (separators > names.size * 3) return null;\n\n    const ordered: string[] = [];\n    for (let id = 0; id < names.size; id += 1) {\n        const name = names.get(id);\n        if (name === undefined) return null;\n        ordered.push(name);\n    }\n    return ordered;\n}\n\n/**\n * Resolve the backslash escapes Python's `repr` emits inside a quoted string.\n *\n * @param text The quoted string's contents, escapes intact.\n * @returns The same text with `\\\\`, `\\'`, `\\\"`, `\\n`, `\\r` and `\\t` resolved.\n */\nfunction unescapeQuoted(text: string): string {\n    return text.replace(/\\\\(.)/g, (_, char: string) => {\n        if (char === \"n\") return \"\\n\";\n        if (char === \"r\") return \"\\r\";\n        if (char === \"t\") return \"\\t\";\n        return char;\n    });\n}\n"],"mappings":"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"}

package/dist/vision/core/metadata.js

@@ -0,0 +1,99 @@
+function e(e) {
+	let t = 0, n = 0;
+	for (; e.pos < e.end;) {
+		let r = e.bytes[e.pos];
+		if (e.pos += 1, t += (r & 127) * 2 ** n, !(r & 128)) return t;
+		if (n += 7, n > 63) return null;
+	}
+	return null;
+}
+function t(t, n) {
+	switch (n) {
+		case 0: return e(t) !== null;
+		case 1: return t.pos += 8, t.pos <= t.end;
+		case 2: {
+			let n = e(t);
+			return n === null ? !1 : (t.pos += n, t.pos <= t.end);
+		}
+		case 5: return t.pos += 4, t.pos <= t.end;
+		default: return !1;
+	}
+}
+function n(t) {
+	let n = e(t);
+	if (n === null || n > 1048576) return null;
+	let r = t.pos, i = r + n;
+	return i > t.end ? null : (t.pos = i, {
+		start: r,
+		end: i
+	});
+}
+function r(r, i, a) {
+	let o = {
+		bytes: r,
+		end: a,
+		pos: i
+	}, s = new TextDecoder("utf-8", { fatal: !1 }), c = null, l = null;
+	for (; o.pos < a;) {
+		let i = e(o);
+		if (i === null) return null;
+		let a = i >>> 3, u = i & 7;
+		if (u === 2 && (a === 1 || a === 2)) {
+			let e = n(o);
+			if (e === null) return null;
+			let t = s.decode(r.subarray(e.start, e.end));
+			a === 1 ? c = t : l = t;
+			continue;
+		}
+		if (!t(o, u)) return null;
+	}
+	return c === null || l === null ? null : [c, l];
+}
+function i(i) {
+	let a = i instanceof Uint8Array ? i : new Uint8Array(i), o = {
+		bytes: a,
+		end: a.length,
+		pos: 0
+	}, s = {};
+	for (; o.pos < o.end;) {
+		let i = e(o);
+		if (i === null) break;
+		let c = i >>> 3, l = i & 7;
+		if (c === 14 && l === 2) {
+			let e = n(o);
+			if (e === null) break;
+			let t = r(a, e.start, e.end);
+			t && (s[t[0]] = t[1]);
+			continue;
+		}
+		if (!t(o, l)) break;
+	}
+	return s;
+}
+function a(e) {
+	let t = e?.names?.trim();
+	if (!t || !t.startsWith("{") || !t.endsWith("}")) return null;
+	let n = t.slice(1, -1).trim();
+	if (!n) return null;
+	let r = /* @__PURE__ */ new Map(), i = /(-?\d+)\s*:\s*(?:'((?:[^'\\]|\\.)*)'|"((?:[^"\\]|\\.)*)")/g, a = 0;
+	for (let e of n.matchAll(i)) {
+		let t = Number(e[1]), n = e[2] ?? e[3];
+		if (!Number.isInteger(t) || n === void 0) return null;
+		r.set(t, o(n)), a += e[0].length;
+	}
+	if (r.size === 0 || n.length - a > r.size * 3) return null;
+	let s = [];
+	for (let e = 0; e < r.size; e += 1) {
+		let t = r.get(e);
+		if (t === void 0) return null;
+		s.push(t);
+	}
+	return s;
+}
+function o(e) {
+	return e.replace(/\\(.)/g, (e, t) => t === "n" ? "\n" : t === "r" ? "\r" : t === "t" ? "	" : t);
+}
+//#endregion
+export { a as modelNames, i as readModelMetadata };
+
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","names":[],"sources":["../../../src/vision/core/metadata.ts"],"sourcesContent":["/**\n * Read the metadata an exporter baked into a `.onnx` file.\n *\n * `onnxruntime-web` exposes input/output metadata but **not** the model's\n * custom metadata map, which is where Ultralytics writes `names`, `task` and\n * `imgsz`. The Python SDK gets it for free from\n * `InferenceSession.get_modelmeta().custom_metadata_map`; in the browser the\n * only way to the same information is to read it out of the file, so this\n * module walks just enough of the ModelProto wire format to collect\n * `metadata_props`.\n *\n * It never throws and never allocates unbounded: a truncated, hostile or\n * simply unexpected file yields an empty map, and every caller treats that as\n * \"the model says nothing\", falling back to what it was given.\n */\n\n/** Field number of `metadata_props` in `ModelProto` (repeated StringStringEntryProto). */\nconst MODEL_METADATA_PROPS_FIELD = 14;\n\n/** Field numbers of `key` and `value` in `StringStringEntryProto`. */\nconst ENTRY_KEY_FIELD = 1;\nconst ENTRY_VALUE_FIELD = 2;\n\n/** Protobuf wire types this reader understands. */\nconst WIRE_VARINT = 0;\nconst WIRE_FIXED64 = 1;\nconst WIRE_LENGTH_DELIMITED = 2;\nconst WIRE_FIXED32 = 5;\n\n/**\n * Hard ceiling on a single length-delimited field, as a guard against a corrupt\n * length turning into a huge slice. Model metadata values are strings — a class\n * name map for thousands of classes still fits well inside this.\n */\nconst MAX_FIELD_BYTES = 1 << 20;\n\n/** A cursor over a byte range, tracking its own position. */\ninterface Cursor {\n    readonly bytes: Uint8Array;\n    readonly end: number;\n    pos: number;\n}\n\n/**\n * Read a base-128 varint.\n *\n * @param cursor Cursor to advance.\n * @returns The value, or `null` when the varint is truncated or overlong\n *   (beyond the 64-bit range protobuf allows).\n */\nfunction readVarint(cursor: Cursor): number | null {\n    let result = 0;\n    let shift = 0;\n    while (cursor.pos < cursor.end) {\n        const byte = cursor.bytes[cursor.pos]!;\n        cursor.pos += 1;\n        result += (byte & 0x7f) * 2 ** shift;\n        if ((byte & 0x80) === 0) return result;\n        shift += 7;\n        if (shift > 63) return null;\n    }\n    return null;\n}\n\n/**\n * Skip a field whose contents are not needed.\n *\n * @param cursor Cursor to advance past the field's payload.\n * @param wireType Wire type read from the field's tag.\n * @returns `true` when the field was skipped, `false` when the stream is\n *   unreadable from here (unknown wire type or truncated payload).\n */\nfunction skipField(cursor: Cursor, wireType: number): boolean {\n    switch (wireType) {\n        case WIRE_VARINT:\n            return readVarint(cursor) !== null;\n        case WIRE_FIXED64:\n            cursor.pos += 8;\n            return cursor.pos <= cursor.end;\n        case WIRE_LENGTH_DELIMITED: {\n            const length = readVarint(cursor);\n            if (length === null) return false;\n            cursor.pos += length;\n            return cursor.pos <= cursor.end;\n        }\n        case WIRE_FIXED32:\n            cursor.pos += 4;\n            return cursor.pos <= cursor.end;\n        default:\n            return false;\n    }\n}\n\n/**\n * Read a length-delimited payload as a byte range.\n *\n * @param cursor Cursor to advance past the payload.\n * @returns Start and end offsets of the payload, or `null` when the length is\n *   truncated, overruns the buffer, or exceeds {@link MAX_FIELD_BYTES}.\n */\nfunction readLengthDelimited(cursor: Cursor): { start: number; end: number } | null {\n    const length = readVarint(cursor);\n    if (length === null || length > MAX_FIELD_BYTES) return null;\n    const start = cursor.pos;\n    const end = start + length;\n    if (end > cursor.end) return null;\n    cursor.pos = end;\n    return { start, end };\n}\n\n/**\n * Decode one `StringStringEntryProto` into a key/value pair.\n *\n * @param bytes The model buffer.\n * @param start Offset the entry's payload starts at.\n * @param end Offset the entry's payload ends at.\n * @returns The pair, or `null` when either half is missing or undecodable.\n */\nfunction readEntry(\n    bytes: Uint8Array,\n    start: number,\n    end: number,\n): readonly [string, string] | null {\n    const cursor: Cursor = { bytes, end, pos: start };\n    const decoder = new TextDecoder(\"utf-8\", { fatal: false });\n    let key: string | null = null;\n    let value: string | null = null;\n\n    while (cursor.pos < end) {\n        const tag = readVarint(cursor);\n        if (tag === null) return null;\n        const field = tag >>> 3;\n        const wireType = tag & 0x07;\n        if (\n            wireType === WIRE_LENGTH_DELIMITED &&\n            (field === ENTRY_KEY_FIELD || field === ENTRY_VALUE_FIELD)\n        ) {\n            const range = readLengthDelimited(cursor);\n            if (range === null) return null;\n            const text = decoder.decode(bytes.subarray(range.start, range.end));\n            if (field === ENTRY_KEY_FIELD) key = text;\n            else value = text;\n            continue;\n        }\n        if (!skipField(cursor, wireType)) return null;\n    }\n\n    if (key === null || value === null) return null;\n    return [key, value];\n}\n\n/**\n * Collect a model's custom metadata map straight out of its bytes.\n *\n * @param model The `.onnx` file contents.\n * @returns Key/value metadata — `names`, `task`, `imgsz`, ... for an\n *   Ultralytics export — or an empty object when the file carries none or\n *   cannot be walked.\n */\nexport function readModelMetadata(\n    model: Uint8Array | ArrayBufferLike,\n): Readonly<Record<string, string>> {\n    const bytes = model instanceof Uint8Array ? model : new Uint8Array(model);\n    const cursor: Cursor = { bytes, end: bytes.length, pos: 0 };\n    const metadata: Record<string, string> = {};\n\n    while (cursor.pos < cursor.end) {\n        const tag = readVarint(cursor);\n        if (tag === null) break;\n        const field = tag >>> 3;\n        const wireType = tag & 0x07;\n        if (field === MODEL_METADATA_PROPS_FIELD && wireType === WIRE_LENGTH_DELIMITED) {\n            const range = readLengthDelimited(cursor);\n            if (range === null) break;\n            const entry = readEntry(bytes, range.start, range.end);\n            if (entry) metadata[entry[0]] = entry[1];\n            continue;\n        }\n        if (!skipField(cursor, wireType)) break;\n    }\n\n    return metadata;\n}\n\n/**\n * Read the class names an export baked into the model metadata.\n *\n * Ultralytics writes `names` as the Python `repr` of a `dict[int, str]` — e.g.\n * `\"{0: 'deworm', 1: 'not_deworm'}\"`. The value is parsed structurally (never\n * evaluated), and anything unparseable, non-`dict`, or not keyed by contiguous\n * integers from zero is rejected whole rather than half-applied: a partial name\n * map would silently mislabel predictions.\n *\n * @param metadata A model's custom metadata map.\n * @returns Class names in class-id order, or `null` when the model carries no\n *   usable `names` entry.\n */\nexport function modelNames(\n    metadata: Readonly<Record<string, string>> | undefined,\n): readonly string[] | null {\n    const raw = metadata?.names?.trim();\n    if (!raw || !raw.startsWith(\"{\") || !raw.endsWith(\"}\")) return null;\n\n    const body = raw.slice(1, -1).trim();\n    if (!body) return null;\n\n    const names = new Map<number, string>();\n    const entryPattern = /(-?\\d+)\\s*:\\s*(?:'((?:[^'\\\\]|\\\\.)*)'|\"((?:[^\"\\\\]|\\\\.)*)\")/g;\n    let consumed = 0;\n    for (const match of body.matchAll(entryPattern)) {\n        const id = Number(match[1]);\n        const text = match[2] ?? match[3];\n        if (!Number.isInteger(id) || text === undefined) return null;\n        names.set(id, unescapeQuoted(text));\n        consumed += match[0].length;\n    }\n    if (names.size === 0) return null;\n\n    const separators = body.length - consumed;\n    if (separators > names.size * 3) return null;\n\n    const ordered: string[] = [];\n    for (let id = 0; id < names.size; id += 1) {\n        const name = names.get(id);\n        if (name === undefined) return null;\n        ordered.push(name);\n    }\n    return ordered;\n}\n\n/**\n * Resolve the backslash escapes Python's `repr` emits inside a quoted string.\n *\n * @param text The quoted string's contents, escapes intact.\n * @returns The same text with `\\\\`, `\\'`, `\\\"`, `\\n`, `\\r` and `\\t` resolved.\n */\nfunction unescapeQuoted(text: string): string {\n    return text.replace(/\\\\(.)/g, (_, char: string) => {\n        if (char === \"n\") return \"\\n\";\n        if (char === \"r\") return \"\\r\";\n        if (char === \"t\") return \"\\t\";\n        return char;\n    });\n}\n"],"mappings":"AAkDA,SAAS,EAAW,GAA+B;CAC/C,IAAI,IAAS,GACT,IAAQ;CACZ,OAAO,EAAO,MAAM,EAAO,MAAK;EAC5B,IAAM,IAAO,EAAO,MAAM,EAAO;EAGjC,IAFA,EAAO,OAAO,GACd,MAAW,IAAO,OAAQ,KAAK,GAC/B,EAAK,IAAO,MAAa,OAAO;EAEhC,IADA,KAAS,GACL,IAAQ,IAAI,OAAO;CAC3B;CACA,OAAO;AACX;AAUA,SAAS,EAAU,GAAgB,GAA2B;CAC1D,QAAQ,GAAR;EACI,KAAK,GACD,OAAO,EAAW,CAAM,MAAM;EAClC,KAAK,GAED,OADA,EAAO,OAAO,GACP,EAAO,OAAO,EAAO;EAChC,KAAK,GAAuB;GACxB,IAAM,IAAS,EAAW,CAAM;GAGhC,OAFI,MAAW,OAAa,MAC5B,EAAO,OAAO,GACP,EAAO,OAAO,EAAO;EAChC;EACA,KAAK,GAED,OADA,EAAO,OAAO,GACP,EAAO,OAAO,EAAO;EAChC,SACI,OAAO;CACf;AACJ;AASA,SAAS,EAAoB,GAAuD;CAChF,IAAM,IAAS,EAAW,CAAM;CAChC,IAAI,MAAW,QAAQ,IAAS,SAAiB,OAAO;CACxD,IAAM,IAAQ,EAAO,KACf,IAAM,IAAQ;CAGpB,OAFI,IAAM,EAAO,MAAY,QAC7B,EAAO,MAAM,GACN;EAAE;EAAO;CAAI;AACxB;AAUA,SAAS,EACL,GACA,GACA,GACgC;CAChC,IAAM,IAAiB;EAAE;EAAO;EAAK,KAAK;CAAM,GAC1C,IAAU,IAAI,YAAY,SAAS,EAAE,OAAO,GAAM,CAAC,GACrD,IAAqB,MACrB,IAAuB;CAE3B,OAAO,EAAO,MAAM,IAAK;EACrB,IAAM,IAAM,EAAW,CAAM;EAC7B,IAAI,MAAQ,MAAM,OAAO;EACzB,IAAM,IAAQ,MAAQ,GAChB,IAAW,IAAM;EACvB,IACI,MAAa,MACZ,MAAU,KAAmB,MAAU,IAC1C;GACE,IAAM,IAAQ,EAAoB,CAAM;GACxC,IAAI,MAAU,MAAM,OAAO;GAC3B,IAAM,IAAO,EAAQ,OAAO,EAAM,SAAS,EAAM,OAAO,EAAM,GAAG,CAAC;GAClE,AAAI,MAAU,IAAiB,IAAM,IAChC,IAAQ;GACb;EACJ;EACA,IAAI,CAAC,EAAU,GAAQ,CAAQ,GAAG,OAAO;CAC7C;CAGA,OADI,MAAQ,QAAQ,MAAU,OAAa,OACpC,CAAC,GAAK,CAAK;AACtB;AAUA,SAAgB,EACZ,GACgC;CAChC,IAAM,IAAQ,aAAiB,aAAa,IAAQ,IAAI,WAAW,CAAK,GAClE,IAAiB;EAAE;EAAO,KAAK,EAAM;EAAQ,KAAK;CAAE,GACpD,IAAmC,CAAC;CAE1C,OAAO,EAAO,MAAM,EAAO,MAAK;EAC5B,IAAM,IAAM,EAAW,CAAM;EAC7B,IAAI,MAAQ,MAAM;EAClB,IAAM,IAAQ,MAAQ,GAChB,IAAW,IAAM;EACvB,IAAI,MAAU,MAA8B,MAAa,GAAuB;GAC5E,IAAM,IAAQ,EAAoB,CAAM;GACxC,IAAI,MAAU,MAAM;GACpB,IAAM,IAAQ,EAAU,GAAO,EAAM,OAAO,EAAM,GAAG;GACrD,AAAI,MAAO,EAAS,EAAM,MAAM,EAAM;GACtC;EACJ;EACA,IAAI,CAAC,EAAU,GAAQ,CAAQ,GAAG;CACtC;CAEA,OAAO;AACX;AAeA,SAAgB,EACZ,GACwB;CACxB,IAAM,IAAM,GAAU,OAAO,KAAK;CAClC,IAAI,CAAC,KAAO,CAAC,EAAI,WAAW,GAAG,KAAK,CAAC,EAAI,SAAS,GAAG,GAAG,OAAO;CAE/D,IAAM,IAAO,EAAI,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK;CACnC,IAAI,CAAC,GAAM,OAAO;CAElB,IAAM,oBAAQ,IAAI,IAAoB,GAChC,IAAe,8DACjB,IAAW;CACf,KAAK,IAAM,KAAS,EAAK,SAAS,CAAY,GAAG;EAC7C,IAAM,IAAK,OAAO,EAAM,EAAE,GACpB,IAAO,EAAM,MAAM,EAAM;EAC/B,IAAI,CAAC,OAAO,UAAU,CAAE,KAAK,MAAS,KAAA,GAAW,OAAO;EAExD,AADA,EAAM,IAAI,GAAI,EAAe,CAAI,CAAC,GAClC,KAAY,EAAM,EAAE,CAAC;CACzB;CAIA,IAHI,EAAM,SAAS,KAEA,EAAK,SAAS,IAChB,EAAM,OAAO,GAAG,OAAO;CAExC,IAAM,IAAoB,CAAC;CAC3B,KAAK,IAAI,IAAK,GAAG,IAAK,EAAM,MAAM,KAAM,GAAG;EACvC,IAAM,IAAO,EAAM,IAAI,CAAE;EACzB,IAAI,MAAS,KAAA,GAAW,OAAO;EAC/B,EAAQ,KAAK,CAAI;CACrB;CACA,OAAO;AACX;AAQA,SAAS,EAAe,GAAsB;CAC1C,OAAO,EAAK,QAAQ,WAAW,GAAG,MAC1B,MAAS,MAAY,OACrB,MAAS,MAAY,OACrB,MAAS,MAAY,MAClB,CACV;AACL"}

package/dist/vision/core/session.cjs

@@ -1,2 +1,2 @@
-const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("./exceptions.cjs"),n=require("./graph.cjs"),r=require("./providers.cjs");let i=require("onnxruntime-web");i=e.__toESM(i,1);var a=class e{_session;providers;constructor(e,t){this._session=e,this.providers=t}static async create(n,a={}){let o=r.resolveProviders(a.providers),s={...a.sessionOptions??{},executionProviders:o},c;try{c=(typeof n==`string`||n instanceof Uint8Array,await i.InferenceSession.create(n,s))}catch(e){throw new t.ModelLoadError(`Failed to load ONNX model: ${e.message}`,{cause:e})}return new e(c,o)}get inputNames(){return this._session.inputNames}get inputName(){let e=this._session.inputNames[0];if(e===void 0)throw new t.InferenceError(`Model has no inputs.`);return e}get outputNames(){return this._session.outputNames}get inputShapes(){return n.declaredShapesFrom(this._session.inputMetadata)}get inputShape(){return this.inputShapes[0]??[]}async release(){await this._session.release().catch(()=>void 0)}get raw(){return this._session}async run(e){try{return await this._session.run(e)}catch(e){throw new t.InferenceError(`Inference failed: ${e.message}`,{cause:e})}}};exports.OrtSession=a;
+const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("./exceptions.cjs"),n=require("./graph.cjs"),r=require("./metadata.cjs"),i=require("./providers.cjs");let a=require("onnxruntime-web");a=e.__toESM(a,1);async function o(e){try{let t=await fetch(e);return t.ok?new Uint8Array(await t.arrayBuffer()):e}catch{return e}}var s=class e{_session;providers;_metadata;constructor(e,t,n){this._session=e,this.providers=t,this._metadata=n}static async create(n,s={}){let c=i.resolveProviders(s.providers),l={...s.sessionOptions??{},executionProviders:c},u=s.readMetadata!==!1,d=typeof n==`string`&&u?await o(n):n,f=u&&typeof d!=`string`?r.readModelMetadata(d):{},p;try{p=(typeof d==`string`||d instanceof Uint8Array,await a.InferenceSession.create(d,l))}catch(e){throw new t.ModelLoadError(`Failed to load ONNX model: ${e.message}`,{cause:e})}return new e(p,c,f)}get inputNames(){return this._session.inputNames}get inputName(){let e=this._session.inputNames[0];if(e===void 0)throw new t.InferenceError(`Model has no inputs.`);return e}get outputNames(){return this._session.outputNames}get inputShapes(){return n.declaredShapesFrom(this._session.inputMetadata)}get inputShape(){return this.inputShapes[0]??[]}get outputShapes(){return n.declaredShapesFrom(this._session.outputMetadata)}get outputShape(){return this.outputShapes[0]??[]}get metadata(){return this._metadata}async release(){await this._session.release().catch(()=>void 0)}get raw(){return this._session}async run(e){try{return await this._session.run(e)}catch(e){throw new t.InferenceError(`Inference failed: ${e.message}`,{cause:e})}}};exports.OrtSession=s;
 //# sourceMappingURL=session.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.cjs","names":[],"sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { type DeclaredShape, declaredShapesFrom } from \"./graph\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names and the shapes the graph declares,\n * manages execution-provider selection, provides a typed {@link OrtSession.run}\n * method, and releases the native session through {@link OrtSession.release}.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list and pass-through `SessionOptions`.\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof model === \"string\") {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else if (model instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    model as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /**\n     * Shapes the graph declares for its inputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime\n     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`\n     * older than 1.21, which predates input metadata.\n     */\n    get inputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.inputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first input, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get inputShape(): DeclaredShape {\n        return this.inputShapes[0] ?? [];\n    }\n\n    /**\n     * Release the native session and free its memory.\n     *\n     * Call it when a session is discarded while the page lives on — rebuilding a\n     * task at a different input size, swapping in a newer model. A failure from\n     * the runtime is ignored: a session being torn down has nothing left to fail\n     * at, and the caller is already moving on.\n     */\n    async release(): Promise<void> {\n        await this._session.release().catch(() => undefined);\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"mappings":"8LA4BA,IAAa,EAAb,MAAa,CAAW,CAEC,SACD,UAFpB,YACI,EACA,EACF,CAFmB,KAAA,SAAA,EACD,KAAA,UAAA,CACjB,CASH,aAAa,OAAO,EAAoB,EAA6B,CAAC,EAAwB,CAC1F,IAAM,EAAY,EAAA,iBAAiB,EAAQ,SAAS,EAC9C,EAAsD,CACxD,GAAI,EAAQ,gBAAkB,CAAC,EAC/B,mBACI,CACR,EAEI,EACJ,GAAI,CACA,AAKI,GALA,OAAO,GAAU,UAEV,aAAiB,WADd,MAAM,EAAW,iBAAiB,OAAO,EAAO,CAAc,EAShF,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,8BAA+B,EAAc,UAAW,CAC7E,MAAO,CACX,CAAC,CACL,CAEA,OAAO,IAAI,EAAW,EAAS,CAAS,CAC5C,CAGA,IAAI,YAAgC,CAChC,OAAO,KAAK,SAAS,UACzB,CAGA,IAAI,WAAoB,CACpB,IAAM,EAAO,KAAK,SAAS,WAAW,GACtC,GAAI,IAAS,IAAA,GACT,MAAM,IAAI,EAAA,eAAe,sBAAsB,EAEnD,OAAO,CACX,CAGA,IAAI,aAAiC,CACjC,OAAO,KAAK,SAAS,WACzB,CASA,IAAI,aAAwC,CACxC,OAAO,EAAA,mBACH,KAAK,SAAS,aAElB,CACJ,CAOA,IAAI,YAA4B,CAC5B,OAAO,KAAK,YAAY,IAAM,CAAC,CACnC,CAUA,MAAM,SAAyB,CAC3B,MAAM,KAAK,SAAS,QAAQ,CAAC,CAAC,UAAY,IAAA,EAAS,CACvD,CAGA,IAAI,KAA4B,CAC5B,OAAO,KAAK,QAChB,CAQA,MAAM,IAAI,EAAwE,CAC9E,GAAI,CAEA,OAAO,MADc,KAAK,SAAS,IAAI,CAAK,CAEhD,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,qBAAsB,EAAc,UAAW,CAAE,MAAO,CAAI,CAAC,CAC1F,CACJ,CACJ"}
+{"version":3,"file":"session.cjs","names":[],"sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { type DeclaredShape, declaredShapesFrom } from \"./graph\";\nimport { readModelMetadata } from \"./metadata\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\n/**\n * Fetch a model URL as bytes so its metadata can be read.\n *\n * Falls back to the URL itself when the fetch fails, letting ORT try its own\n * load path: losing the metadata map is a downgrade, but failing to load a model\n * that ORT could have fetched would be a regression.\n *\n * @param url Where the `.onnx` lives.\n * @returns The model bytes, or the original URL when they could not be fetched.\n */\nasync function fetchModel(url: string): Promise<Uint8Array | string> {\n    try {\n        const response = await fetch(url);\n        if (!response.ok) return url;\n        return new Uint8Array(await response.arrayBuffer());\n    } catch {\n        return url;\n    }\n}\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n    /**\n     * Whether to read the model's custom metadata map (`names`, `task`, `imgsz`).\n     * Defaults to `true`.\n     *\n     * The runtime does not expose that map, so it is read from the file itself —\n     * which means a URL model is fetched here and handed to ORT as bytes instead\n     * of letting ORT fetch it. That is the same single download either way, and\n     * it is what lets a task resolve its labels off the model. Set to `false` to\n     * keep the URL path untouched and leave {@link OrtSession.metadata} empty.\n     *\n     * `false` is also the escape hatch when a device cannot afford the bytes: the\n     * fetched buffer is dropped before ORT builds the graph (see\n     * {@link OrtSession.create}), but ORT's own load path still keeps the model out\n     * of reach of anything the SDK holds. A session built this way resolves its\n     * input size from the graph as usual — only the class names are lost, so a\n     * caller taking this route has to pass `labels` itself.\n     */\n    readonly readMetadata?: boolean;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names and the shapes the graph declares,\n * manages execution-provider selection, provides a typed {@link OrtSession.run}\n * method, and releases the native session through {@link OrtSession.release}.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n        private readonly _metadata: Readonly<Record<string, string>>,\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * The metadata map is read **before** the session is built, and that order is\n     * load-bearing on memory-constrained devices. ORT copies the model into its\n     * WASM heap and then allocates the graph and the weights on top of that copy;\n     * a `readModelMetadata` call placed after `InferenceSession.create` keeps the\n     * JavaScript-side buffer reachable across the whole build, so a 5 MB model\n     * costs 5 MB of JS heap plus 5 MB of WASM heap plus the weights at the same\n     * instant. Reading first makes the buffer collectable as soon as ORT has copied\n     * it — on a phone that was the difference between a session and\n     * `Can't create a session. failed to allocate a buffer of size N`.\n     *\n     * @param model Either a URL string, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list, pass-through `SessionOptions`, and whether to\n     *   read the model's metadata map (see {@link OrtSessionOptions.readMetadata}).\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n        const wantsMetadata = options.readMetadata !== false;\n        const source = typeof model === \"string\" && wantsMetadata ? await fetchModel(model) : model;\n        const metadata =\n            wantsMetadata && typeof source !== \"string\" ? readModelMetadata(source) : {};\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof source === \"string\") {\n                session = await ortRuntime.InferenceSession.create(source, sessionOptions);\n            } else if (source instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(source, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    source as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers, metadata);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /**\n     * Shapes the graph declares for its inputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime\n     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`\n     * older than 1.21, which predates input metadata.\n     */\n    get inputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.inputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first input, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get inputShape(): DeclaredShape {\n        return this.inputShapes[0] ?? [];\n    }\n\n    /**\n     * Shapes the graph declares for its outputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Reading them is how a task can\n     * tell how many classes a head emits without being told.\n     */\n    get outputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.outputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first output, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get outputShape(): DeclaredShape {\n        return this.outputShapes[0] ?? [];\n    }\n\n    /**\n     * The model's custom metadata map — `names`, `task`, `imgsz`, ... for an\n     * Ultralytics export.\n     *\n     * Read from the model's bytes at load time, since the runtime does not expose\n     * it. Empty when the session was created with `readMetadata: false`, from a\n     * URL that could not be fetched here, or from a model carrying no metadata.\n     */\n    get metadata(): Readonly<Record<string, string>> {\n        return this._metadata;\n    }\n\n    /**\n     * Release the native session and free its memory.\n     *\n     * Call it when a session is discarded while the page lives on — rebuilding a\n     * task at a different input size, swapping in a newer model. A failure from\n     * the runtime is ignored: a session being torn down has nothing left to fail\n     * at, and the caller is already moving on.\n     */\n    async release(): Promise<void> {\n        await this._session.release().catch(() => undefined);\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"mappings":"0NAyBA,eAAe,EAAW,EAA2C,CACjE,GAAI,CACA,IAAM,EAAW,MAAM,MAAM,CAAG,EAEhC,OADK,EAAS,GACP,IAAI,WAAW,MAAM,EAAS,YAAY,CAAC,EADzB,CAE7B,MAAQ,CACJ,OAAO,CACX,CACJ,CAkCA,IAAa,EAAb,MAAa,CAAW,CAEC,SACD,UACC,UAHrB,YACI,EACA,EACA,EACF,CAHmB,KAAA,SAAA,EACD,KAAA,UAAA,EACC,KAAA,UAAA,CAClB,CAoBH,aAAa,OAAO,EAAoB,EAA6B,CAAC,EAAwB,CAC1F,IAAM,EAAY,EAAA,iBAAiB,EAAQ,SAAS,EAC9C,EAAsD,CACxD,GAAI,EAAQ,gBAAkB,CAAC,EAC/B,mBACI,CACR,EACM,EAAgB,EAAQ,eAAiB,GACzC,EAAS,OAAO,GAAU,UAAY,EAAgB,MAAM,EAAW,CAAK,EAAI,EAChF,EACF,GAAiB,OAAO,GAAW,SAAW,EAAA,kBAAkB,CAAM,EAAI,CAAC,EAE3E,EACJ,GAAI,CACA,AAKI,GALA,OAAO,GAAW,UAEX,aAAkB,WADf,MAAM,EAAW,iBAAiB,OAAO,EAAQ,CAAc,EASjF,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,8BAA+B,EAAc,UAAW,CAC7E,MAAO,CACX,CAAC,CACL,CAEA,OAAO,IAAI,EAAW,EAAS,EAAW,CAAQ,CACtD,CAGA,IAAI,YAAgC,CAChC,OAAO,KAAK,SAAS,UACzB,CAGA,IAAI,WAAoB,CACpB,IAAM,EAAO,KAAK,SAAS,WAAW,GACtC,GAAI,IAAS,IAAA,GACT,MAAM,IAAI,EAAA,eAAe,sBAAsB,EAEnD,OAAO,CACX,CAGA,IAAI,aAAiC,CACjC,OAAO,KAAK,SAAS,WACzB,CASA,IAAI,aAAwC,CACxC,OAAO,EAAA,mBACH,KAAK,SAAS,aAElB,CACJ,CAOA,IAAI,YAA4B,CAC5B,OAAO,KAAK,YAAY,IAAM,CAAC,CACnC,CAQA,IAAI,cAAyC,CACzC,OAAO,EAAA,mBACH,KAAK,SAAS,cAElB,CACJ,CAOA,IAAI,aAA6B,CAC7B,OAAO,KAAK,aAAa,IAAM,CAAC,CACpC,CAUA,IAAI,UAA6C,CAC7C,OAAO,KAAK,SAChB,CAUA,MAAM,SAAyB,CAC3B,MAAM,KAAK,SAAS,QAAQ,CAAC,CAAC,UAAY,IAAA,EAAS,CACvD,CAGA,IAAI,KAA4B,CAC5B,OAAO,KAAK,QAChB,CAQA,MAAM,IAAI,EAAwE,CAC9E,GAAI,CAEA,OAAO,MADc,KAAK,SAAS,IAAI,CAAK,CAEhD,OAAS,EAAK,CACV,MAAM,IAAI,EAAA,eAAe,qBAAsB,EAAc,UAAW,CAAE,MAAO,CAAI,CAAC,CAC1F,CACJ,CACJ"}

package/dist/vision/core/session.js

@@ -1,25 +1,35 @@
 import { InferenceError as e, ModelLoadError as t } from "./exceptions.js";
 import { declaredShapesFrom as n } from "./graph.js";
-import { resolveProviders as r } from "./providers.js";
-import * as i from "onnxruntime-web";
+import { readModelMetadata as r } from "./metadata.js";
+import { resolveProviders as i } from "./providers.js";
+import * as a from "onnxruntime-web";
 //#region src/vision/core/session.ts
-var a = class a {
+async function o(e) {
+	try {
+		let t = await fetch(e);
+		return t.ok ? new Uint8Array(await t.arrayBuffer()) : e;
+	} catch {
+		return e;
+	}
+}
+var s = class s {
 	_session;
 	providers;
-	constructor(e, t) {
-		this._session = e, this.providers = t;
+	_metadata;
+	constructor(e, t, n) {
+		this._session = e, this.providers = t, this._metadata = n;
 	}
 	static async create(e, n = {}) {
-		let o = r(n.providers), s = {
+		let c = i(n.providers), l = {
 			...n.sessionOptions ?? {},
-			executionProviders: o
-		}, c;
+			executionProviders: c
+		}, u = n.readMetadata !== !1, d = typeof e == "string" && u ? await o(e) : e, f = u && typeof d != "string" ? r(d) : {}, p;
 		try {
-			c = (typeof e == "string" || e instanceof Uint8Array, await i.InferenceSession.create(e, s));
+			p = (typeof d == "string" || d instanceof Uint8Array, await a.InferenceSession.create(d, l));
 		} catch (e) {
 			throw new t(`Failed to load ONNX model: ${e.message}`, { cause: e });
 		}
-		return new a(c, o);
+		return new s(p, c, f);
 	}
 	get inputNames() {
 		return this._session.inputNames;
@@ -38,6 +48,15 @@ var a = class a {
 	get inputShape() {
 		return this.inputShapes[0] ?? [];
 	}
+	get outputShapes() {
+		return n(this._session.outputMetadata);
+	}
+	get outputShape() {
+		return this.outputShapes[0] ?? [];
+	}
+	get metadata() {
+		return this._metadata;
+	}
 	async release() {
 		await this._session.release().catch(() => void 0);
 	}
@@ -53,6 +72,6 @@ var a = class a {
 	}
 };
 //#endregion
-export { a as OrtSession };
+export { s as OrtSession };
 
 //# sourceMappingURL=session.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.js","names":[],"sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { type DeclaredShape, declaredShapesFrom } from \"./graph\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names and the shapes the graph declares,\n * manages execution-provider selection, provides a typed {@link OrtSession.run}\n * method, and releases the native session through {@link OrtSession.release}.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list and pass-through `SessionOptions`.\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof model === \"string\") {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else if (model instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(model, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    model as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /**\n     * Shapes the graph declares for its inputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime\n     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`\n     * older than 1.21, which predates input metadata.\n     */\n    get inputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.inputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first input, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get inputShape(): DeclaredShape {\n        return this.inputShapes[0] ?? [];\n    }\n\n    /**\n     * Release the native session and free its memory.\n     *\n     * Call it when a session is discarded while the page lives on — rebuilding a\n     * task at a different input size, swapping in a newer model. A failure from\n     * the runtime is ignored: a session being torn down has nothing left to fail\n     * at, and the caller is already moving on.\n     */\n    async release(): Promise<void> {\n        await this._session.release().catch(() => undefined);\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"mappings":";;;;;AA4BA,IAAa,IAAb,MAAa,EAAW;CAEC;CACD;CAFpB,YACI,GACA,GACF;EADkB,AADC,KAAA,WAAA,GACD,KAAA,YAAA;CACjB;CASH,aAAa,OAAO,GAAoB,IAA6B,CAAC,GAAwB;EAC1F,IAAM,IAAY,EAAiB,EAAQ,SAAS,GAC9C,IAAsD;GACxD,GAAI,EAAQ,kBAAkB,CAAC;GAC/B,oBACI;EACR,GAEI;EACJ,IAAI;GACA,AAKI,KALA,OAAO,KAAU,YAEV,aAAiB,YADd,MAAM,EAAW,iBAAiB,OAAO,GAAO,CAAc;EAShF,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,8BAA+B,EAAc,WAAW,EAC7E,OAAO,EACX,CAAC;EACL;EAEA,OAAO,IAAI,EAAW,GAAS,CAAS;CAC5C;CAGA,IAAI,aAAgC;EAChC,OAAO,KAAK,SAAS;CACzB;CAGA,IAAI,YAAoB;EACpB,IAAM,IAAO,KAAK,SAAS,WAAW;EACtC,IAAI,MAAS,KAAA,GACT,MAAM,IAAI,EAAe,sBAAsB;EAEnD,OAAO;CACX;CAGA,IAAI,cAAiC;EACjC,OAAO,KAAK,SAAS;CACzB;CASA,IAAI,cAAwC;EACxC,OAAO,EACH,KAAK,SAAS,aAElB;CACJ;CAOA,IAAI,aAA4B;EAC5B,OAAO,KAAK,YAAY,MAAM,CAAC;CACnC;CAUA,MAAM,UAAyB;EAC3B,MAAM,KAAK,SAAS,QAAQ,CAAC,CAAC,YAAY,KAAA,CAAS;CACvD;CAGA,IAAI,MAA4B;EAC5B,OAAO,KAAK;CAChB;CAQA,MAAM,IAAI,GAAwE;EAC9E,IAAI;GAEA,OAAO,MADc,KAAK,SAAS,IAAI,CAAK;EAEhD,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,qBAAsB,EAAc,WAAW,EAAE,OAAO,EAAI,CAAC;EAC1F;CACJ;AACJ"}
+{"version":3,"file":"session.js","names":[],"sources":["../../../src/vision/core/session.ts"],"sourcesContent":["/**\n * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.\n */\n\nimport type * as ort from \"onnxruntime-web\";\nimport * as ortRuntime from \"onnxruntime-web\";\n\nimport { InferenceError, ModelLoadError } from \"./exceptions\";\nimport { type DeclaredShape, declaredShapesFrom } from \"./graph\";\nimport { readModelMetadata } from \"./metadata\";\nimport { resolveProviders } from \"./providers\";\n\n/** Anything `InferenceSession.create` accepts. */\nexport type ModelSource = string | ArrayBufferLike | Uint8Array;\n\n/**\n * Fetch a model URL as bytes so its metadata can be read.\n *\n * Falls back to the URL itself when the fetch fails, letting ORT try its own\n * load path: losing the metadata map is a downgrade, but failing to load a model\n * that ORT could have fetched would be a regression.\n *\n * @param url Where the `.onnx` lives.\n * @returns The model bytes, or the original URL when they could not be fetched.\n */\nasync function fetchModel(url: string): Promise<Uint8Array | string> {\n    try {\n        const response = await fetch(url);\n        if (!response.ok) return url;\n        return new Uint8Array(await response.arrayBuffer());\n    } catch {\n        return url;\n    }\n}\n\nexport interface OrtSessionOptions {\n    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */\n    readonly providers?: readonly string[];\n    /** Optional ORT session options forwarded to `InferenceSession.create`. */\n    readonly sessionOptions?: ort.InferenceSession.SessionOptions;\n    /**\n     * Whether to read the model's custom metadata map (`names`, `task`, `imgsz`).\n     * Defaults to `true`.\n     *\n     * The runtime does not expose that map, so it is read from the file itself —\n     * which means a URL model is fetched here and handed to ORT as bytes instead\n     * of letting ORT fetch it. That is the same single download either way, and\n     * it is what lets a task resolve its labels off the model. Set to `false` to\n     * keep the URL path untouched and leave {@link OrtSession.metadata} empty.\n     *\n     * `false` is also the escape hatch when a device cannot afford the bytes: the\n     * fetched buffer is dropped before ORT builds the graph (see\n     * {@link OrtSession.create}), but ORT's own load path still keeps the model out\n     * of reach of anything the SDK holds. A session built this way resolves its\n     * input size from the graph as usual — only the class names are lost, so a\n     * caller taking this route has to pass `labels` itself.\n     */\n    readonly readMetadata?: boolean;\n}\n\n/**\n * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.\n *\n * The wrapper exposes input/output names and the shapes the graph declares,\n * manages execution-provider selection, provides a typed {@link OrtSession.run}\n * method, and releases the native session through {@link OrtSession.release}.\n */\nexport class OrtSession {\n    private constructor(\n        private readonly _session: ort.InferenceSession,\n        public readonly providers: readonly string[],\n        private readonly _metadata: Readonly<Record<string, string>>,\n    ) {}\n\n    /**\n     * Load an ONNX model into an ORT inference session.\n     *\n     * The metadata map is read **before** the session is built, and that order is\n     * load-bearing on memory-constrained devices. ORT copies the model into its\n     * WASM heap and then allocates the graph and the weights on top of that copy;\n     * a `readModelMetadata` call placed after `InferenceSession.create` keeps the\n     * JavaScript-side buffer reachable across the whole build, so a 5 MB model\n     * costs 5 MB of JS heap plus 5 MB of WASM heap plus the weights at the same\n     * instant. Reading first makes the buffer collectable as soon as ORT has copied\n     * it — on a phone that was the difference between a session and\n     * `Can't create a session. failed to allocate a buffer of size N`.\n     *\n     * @param model Either a URL string, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.\n     * @param options Provider list, pass-through `SessionOptions`, and whether to\n     *   read the model's metadata map (see {@link OrtSessionOptions.readMetadata}).\n     * @throws {@link ModelLoadError} if the model cannot be loaded.\n     */\n    static async create(model: ModelSource, options: OrtSessionOptions = {}): Promise<OrtSession> {\n        const providers = resolveProviders(options.providers);\n        const sessionOptions: ort.InferenceSession.SessionOptions = {\n            ...(options.sessionOptions ?? {}),\n            executionProviders:\n                providers as ort.InferenceSession.SessionOptions[\"executionProviders\"],\n        };\n        const wantsMetadata = options.readMetadata !== false;\n        const source = typeof model === \"string\" && wantsMetadata ? await fetchModel(model) : model;\n        const metadata =\n            wantsMetadata && typeof source !== \"string\" ? readModelMetadata(source) : {};\n\n        let session: ort.InferenceSession;\n        try {\n            if (typeof source === \"string\") {\n                session = await ortRuntime.InferenceSession.create(source, sessionOptions);\n            } else if (source instanceof Uint8Array) {\n                session = await ortRuntime.InferenceSession.create(source, sessionOptions);\n            } else {\n                session = await ortRuntime.InferenceSession.create(\n                    source as ArrayBuffer,\n                    sessionOptions,\n                );\n            }\n        } catch (err) {\n            throw new ModelLoadError(`Failed to load ONNX model: ${(err as Error).message}`, {\n                cause: err,\n            });\n        }\n\n        return new OrtSession(session, providers, metadata);\n    }\n\n    /** Names of the model's inputs, in declaration order. */\n    get inputNames(): readonly string[] {\n        return this._session.inputNames;\n    }\n\n    /** Name of the first (and usually only) input. */\n    get inputName(): string {\n        const name = this._session.inputNames[0];\n        if (name === undefined) {\n            throw new InferenceError(\"Model has no inputs.\");\n        }\n        return name;\n    }\n\n    /** Names of the model's outputs, in declaration order. */\n    get outputNames(): readonly string[] {\n        return this._session.outputNames;\n    }\n\n    /**\n     * Shapes the graph declares for its inputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime\n     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`\n     * older than 1.21, which predates input metadata.\n     */\n    get inputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.inputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first input, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get inputShape(): DeclaredShape {\n        return this.inputShapes[0] ?? [];\n    }\n\n    /**\n     * Shapes the graph declares for its outputs, in declaration order.\n     *\n     * Dynamic (symbolic) axes appear as `null`. Reading them is how a task can\n     * tell how many classes a head emits without being told.\n     */\n    get outputShapes(): readonly DeclaredShape[] {\n        return declaredShapesFrom(\n            this._session.outputMetadata as\n                readonly ort.InferenceSession.ValueMetadata[] | undefined,\n        );\n    }\n\n    /**\n     * Shape the graph declares for its first output, dynamic axes as `null`.\n     *\n     * Empty when the runtime reports no metadata for it.\n     */\n    get outputShape(): DeclaredShape {\n        return this.outputShapes[0] ?? [];\n    }\n\n    /**\n     * The model's custom metadata map — `names`, `task`, `imgsz`, ... for an\n     * Ultralytics export.\n     *\n     * Read from the model's bytes at load time, since the runtime does not expose\n     * it. Empty when the session was created with `readMetadata: false`, from a\n     * URL that could not be fetched here, or from a model carrying no metadata.\n     */\n    get metadata(): Readonly<Record<string, string>> {\n        return this._metadata;\n    }\n\n    /**\n     * Release the native session and free its memory.\n     *\n     * Call it when a session is discarded while the page lives on — rebuilding a\n     * task at a different input size, swapping in a newer model. A failure from\n     * the runtime is ignored: a session being torn down has nothing left to fail\n     * at, and the caller is already moving on.\n     */\n    async release(): Promise<void> {\n        await this._session.release().catch(() => undefined);\n    }\n\n    /** The underlying `onnxruntime-web` session, for advanced use cases. */\n    get raw(): ort.InferenceSession {\n        return this._session;\n    }\n\n    /**\n     * Run inference and return all outputs.\n     *\n     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.\n     * @throws {@link InferenceError} if ORT raises any error during execution.\n     */\n    async run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>> {\n        try {\n            const result = await this._session.run(feeds);\n            return result as Record<string, ort.Tensor>;\n        } catch (err) {\n            throw new InferenceError(`Inference failed: ${(err as Error).message}`, { cause: err });\n        }\n    }\n}\n"],"mappings":";;;;;;AAyBA,eAAe,EAAW,GAA2C;CACjE,IAAI;EACA,IAAM,IAAW,MAAM,MAAM,CAAG;EAEhC,OADK,EAAS,KACP,IAAI,WAAW,MAAM,EAAS,YAAY,CAAC,IADzB;CAE7B,QAAQ;EACJ,OAAO;CACX;AACJ;AAkCA,IAAa,IAAb,MAAa,EAAW;CAEC;CACD;CACC;CAHrB,YACI,GACA,GACA,GACF;EADmB,AAFA,KAAA,WAAA,GACD,KAAA,YAAA,GACC,KAAA,YAAA;CAClB;CAoBH,aAAa,OAAO,GAAoB,IAA6B,CAAC,GAAwB;EAC1F,IAAM,IAAY,EAAiB,EAAQ,SAAS,GAC9C,IAAsD;GACxD,GAAI,EAAQ,kBAAkB,CAAC;GAC/B,oBACI;EACR,GACM,IAAgB,EAAQ,iBAAiB,IACzC,IAAS,OAAO,KAAU,YAAY,IAAgB,MAAM,EAAW,CAAK,IAAI,GAChF,IACF,KAAiB,OAAO,KAAW,WAAW,EAAkB,CAAM,IAAI,CAAC,GAE3E;EACJ,IAAI;GACA,AAKI,KALA,OAAO,KAAW,YAEX,aAAkB,YADf,MAAM,EAAW,iBAAiB,OAAO,GAAQ,CAAc;EASjF,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,8BAA+B,EAAc,WAAW,EAC7E,OAAO,EACX,CAAC;EACL;EAEA,OAAO,IAAI,EAAW,GAAS,GAAW,CAAQ;CACtD;CAGA,IAAI,aAAgC;EAChC,OAAO,KAAK,SAAS;CACzB;CAGA,IAAI,YAAoB;EACpB,IAAM,IAAO,KAAK,SAAS,WAAW;EACtC,IAAI,MAAS,KAAA,GACT,MAAM,IAAI,EAAe,sBAAsB;EAEnD,OAAO;CACX;CAGA,IAAI,cAAiC;EACjC,OAAO,KAAK,SAAS;CACzB;CASA,IAAI,cAAwC;EACxC,OAAO,EACH,KAAK,SAAS,aAElB;CACJ;CAOA,IAAI,aAA4B;EAC5B,OAAO,KAAK,YAAY,MAAM,CAAC;CACnC;CAQA,IAAI,eAAyC;EACzC,OAAO,EACH,KAAK,SAAS,cAElB;CACJ;CAOA,IAAI,cAA6B;EAC7B,OAAO,KAAK,aAAa,MAAM,CAAC;CACpC;CAUA,IAAI,WAA6C;EAC7C,OAAO,KAAK;CAChB;CAUA,MAAM,UAAyB;EAC3B,MAAM,KAAK,SAAS,QAAQ,CAAC,CAAC,YAAY,KAAA,CAAS;CACvD;CAGA,IAAI,MAA4B;EAC5B,OAAO,KAAK;CAChB;CAQA,MAAM,IAAI,GAAwE;EAC9E,IAAI;GAEA,OAAO,MADc,KAAK,SAAS,IAAI,CAAK;EAEhD,SAAS,GAAK;GACV,MAAM,IAAI,EAAe,qBAAsB,EAAc,WAAW,EAAE,OAAO,EAAI,CAAC;EAC1F;CACJ;AACJ"}

package/dist/vision/index.cjs

@@ -1,2 +1,2 @@
-const e=require("./core/exceptions.cjs"),t=require("./types.cjs"),n=require("./core/timing.cjs"),r=require("./results.cjs"),i=require("./labels.cjs"),a=require("./core/graph.cjs"),o=require("./core/providers.cjs"),s=require("./core/session.cjs"),c=require("./io/image.cjs"),l=require("./preprocess/image.cjs"),u=require("./postprocess/classification.cjs"),d=require("./postprocess/detection.cjs"),f=require("./postprocess/segmentation.cjs"),p=require("./tasks/base.cjs"),m=require("./tasks/classifier.cjs"),h=require("./tasks/detector.cjs"),g=require("./tasks/segmenter.cjs");var _=`0.4.0`;exports.BoundingBox=t.BoundingBox,exports.Boxes=r.Boxes,exports.COCO_CLASSES=i.COCO_CLASSES,exports.ClassificationResults=r.ClassificationResults,exports.Classifier=m.Classifier,exports.DEFAULT_PROVIDERS=o.DEFAULT_PROVIDERS,exports.DetectionResults=r.DetectionResults,exports.Detector=h.Detector,exports.ImageLoadError=e.ImageLoadError,exports.InferenceError=e.InferenceError,exports.LabelMapError=e.LabelMapError,exports.Mask=t.Mask,exports.Masks=r.Masks,exports.ModelLoadError=e.ModelLoadError,exports.OrtSession=s.OrtSession,exports.OrtVisionError=e.OrtVisionError,exports.Probs=r.Probs,exports.ProviderNotAvailableError=e.ProviderNotAvailableError,exports.RGBImage=t.RGBImage,exports.SegmentationResults=r.SegmentationResults,exports.Segmenter=g.Segmenter,exports.SpeedTimer=n.SpeedTimer,exports.VERSION=_,exports.VisionTask=p.VisionTask,exports.batchedNms=d.batchedNms,exports.declaredShapesFrom=a.declaredShapesFrom,exports.decodeYolo=d.decodeYolo,exports.decodeYoloAnchors=d.decodeYoloAnchors,exports.decodeYoloSeg=f.decodeYoloSeg,exports.decodeYoloV8=d.decodeYoloV8,exports.decodeYoloV8Anchors=d.decodeYoloV8Anchors,exports.decodeYoloV8Seg=f.decodeYoloV8Seg,exports.fromCv2=l.fromCv2,exports.letterbox=l.letterbox,exports.loadImage=c.loadImage,exports.nms=d.nms,exports.normalize=l.normalize,exports.resize=l.resize,exports.resolveInputSize=a.resolveInputSize,exports.resolveLabels=i.resolveLabels,exports.resolveProviders=o.resolveProviders,exports.softmax=u.softmax,exports.spatialInputSize=a.spatialInputSize,exports.toCHW=l.toCHW,exports.toCv2=l.toCv2,exports.toFloat32=l.toFloat32,exports.toFloat32Tensor=l.toFloat32Tensor,exports.toTensor=l.toTensor,exports.topK=u.topK;
+const e=require("./core/exceptions.cjs"),t=require("./types.cjs"),n=require("./core/timing.cjs"),r=require("./results.cjs"),i=require("./labels.cjs"),a=require("./core/graph.cjs"),o=require("./core/metadata.cjs"),s=require("./core/providers.cjs"),c=require("./core/session.cjs"),l=require("./io/image.cjs"),u=require("./preprocess/image.cjs"),d=require("./postprocess/classification.cjs"),f=require("./postprocess/detection.cjs"),p=require("./postprocess/segmentation.cjs"),m=require("./tasks/base.cjs"),h=require("./tasks/classifier.cjs"),g=require("./tasks/detector.cjs"),_=require("./tasks/segmenter.cjs");var v=`0.5.1`;exports.BoundingBox=t.BoundingBox,exports.Boxes=r.Boxes,exports.COCO_CLASSES=i.COCO_CLASSES,exports.ClassificationResults=r.ClassificationResults,exports.Classifier=h.Classifier,exports.DEFAULT_PROVIDERS=s.DEFAULT_PROVIDERS,exports.DetectionResults=r.DetectionResults,exports.Detector=g.Detector,exports.ImageLoadError=e.ImageLoadError,exports.InferenceError=e.InferenceError,exports.LabelMapError=e.LabelMapError,exports.Mask=t.Mask,exports.Masks=r.Masks,exports.ModelLoadError=e.ModelLoadError,exports.OrtSession=c.OrtSession,exports.OrtVisionError=e.OrtVisionError,exports.Probs=r.Probs,exports.ProviderNotAvailableError=e.ProviderNotAvailableError,exports.RGBImage=t.RGBImage,exports.SegmentationResults=r.SegmentationResults,exports.Segmenter=_.Segmenter,exports.SpeedTimer=n.SpeedTimer,exports.VERSION=v,exports.VisionTask=m.VisionTask,exports.batchedNms=f.batchedNms,exports.classificationNumClasses=a.classificationNumClasses,exports.declaredShapesFrom=a.declaredShapesFrom,exports.decodeYolo=f.decodeYolo,exports.decodeYoloAnchors=f.decodeYoloAnchors,exports.decodeYoloSeg=p.decodeYoloSeg,exports.decodeYoloV8=f.decodeYoloV8,exports.decodeYoloV8Anchors=f.decodeYoloV8Anchors,exports.decodeYoloV8Seg=p.decodeYoloV8Seg,exports.detectionNumClasses=a.detectionNumClasses,exports.fromCv2=u.fromCv2,exports.letterbox=u.letterbox,exports.loadImage=l.loadImage,exports.modelNames=o.modelNames,exports.nms=f.nms,exports.normalize=u.normalize,exports.readModelMetadata=o.readModelMetadata,exports.resize=u.resize,exports.resolveInputSize=a.resolveInputSize,exports.resolveLabels=i.resolveLabels,exports.resolveProviders=s.resolveProviders,exports.softmax=d.softmax,exports.spatialInputSize=a.spatialInputSize,exports.toCHW=u.toCHW,exports.toCv2=u.toCv2,exports.toFloat32=u.toFloat32,exports.toFloat32Tensor=u.toFloat32Tensor,exports.toTensor=u.toTensor,exports.topK=d.topK;
 //# sourceMappingURL=index.cjs.map

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

package/dist/vision/index.js

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

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

package/dist/vision/tasks/classifier.cjs

@@ -1,2 +1,2 @@
-const e=require("../core/timing.cjs"),t=require("../results.cjs"),n=require("../labels.cjs"),r=require("../core/graph.cjs"),i=require("../core/session.cjs"),a=require("../io/image.cjs"),o=require("../preprocess/image.cjs"),s=require("../postprocess/classification.cjs"),c=require("./base.cjs");var l=[.485,.456,.406],u=[.229,.224,.225],d=class d extends c.VisionTask{_labels;_names;_inputSize;_mean;_std;_applySoftmax;constructor(e,t,n,r,i,a,o){super(e),this._labels=t,this._names=n,this._inputSize=r,this._mean=i,this._std=a,this._applySoftmax=o}static async create(e,t){let a=await i.OrtSession.create(e,t),o=n.resolveLabels(t.labels,{numClasses:t.numClasses}),s={};for(let e=0;e<o.length;e++)s[e]=o[e];return new d(a,o,s,r.resolveInputSize({graphShape:a.inputShape,requested:t.inputSize,fallback:[224,224]}),t.mean??l,t.std??u,t.applySoftmax??!0)}get labels(){return this._labels}get names(){return this._names}get inputSize(){return this._inputSize}get numClasses(){return this._labels.length}async call(e,t={}){return this.predict(e,t)}async predict(n,r={}){let i=new e.SpeedTimer,o=typeof n==`string`?n:null,c=await a.loadImage(n);i.stage(`load`);let l=this._preprocess(c);i.stage(`preprocess`);let u=await this._session.run({[this._session.inputName]:l});i.stage(`inference`);let d=this._session.outputNames[0];if(d===void 0)throw Error(`Classifier model has no outputs.`);let f=u[d];if(f===void 0)throw Error(`Classifier model output ${d} missing from run() result.`);let p=this._postprocess(f.data),{indices:m,values:h}=s.topK(p,r.topK??null),g=[];for(let e=0;e<m.length;e++){let t=m[e],n=this._labels[t]??`class_${t}`;g.push({classId:t,className:n,probability:h[e],cls:t,name:n,conf:h[e]})}if(g.length===0)throw Error(`Classifier produced no probabilities (empty output).`);let _=g[0],v={classId:_.classId,className:_.className,confidence:_.probability,cls:_.classId,name:_.className,conf:_.probability,image:c,probabilities:g},y=[c.height,c.width],b=new t.Probs(p);return i.stage(`postprocess`),[new t.ClassificationResults(b,v,this._names,c,y,o,i.speed())]}_preprocess(e){let[t,n]=this._inputSize,r=o.resize(e,t,n);return o.toFloat32Tensor(o.toCHW(o.normalize(r,this._mean,this._std),r.width,r.height,3),[1,3,r.height,r.width])}_postprocess(e){return this._applySoftmax?s.softmax(e):new Float32Array(e)}};exports.Classifier=d;
+const e=require("../core/timing.cjs"),t=require("../results.cjs"),n=require("../labels.cjs"),r=require("../core/graph.cjs"),i=require("../core/metadata.cjs"),a=require("../core/session.cjs"),o=require("../io/image.cjs"),s=require("../preprocess/image.cjs"),c=require("../postprocess/classification.cjs"),l=require("./base.cjs");var u=[.485,.456,.406],d=[.229,.224,.225],f=class f extends l.VisionTask{_labels;_names;_inputSize;_mean;_std;_applySoftmax;constructor(e,t,n,r,i,a,o){super(e),this._labels=t,this._names=n,this._inputSize=r,this._mean=i,this._std=a,this._applySoftmax=o}static async create(e,t={}){let o=await a.OrtSession.create(e,t),s=t.numClasses??r.classificationNumClasses(o.outputShape)??void 0,c=n.resolveLabels(t.labels??i.modelNames(o.metadata),{numClasses:s}),l={};for(let e=0;e<c.length;e++)l[e]=c[e];return new f(o,c,l,r.resolveInputSize({graphShape:o.inputShape,requested:t.inputSize,fallback:[224,224]}),t.mean??u,t.std??d,t.applySoftmax??!0)}get labels(){return this._labels}get names(){return this._names}get inputSize(){return this._inputSize}get numClasses(){return this._labels.length}async call(e,t={}){return this.predict(e,t)}async predict(n,r={}){let i=new e.SpeedTimer,a=typeof n==`string`?n:null,s=await o.loadImage(n);i.stage(`load`);let l=this._preprocess(s);i.stage(`preprocess`);let u=await this._session.run({[this._session.inputName]:l});i.stage(`inference`);let d=this._session.outputNames[0];if(d===void 0)throw Error(`Classifier model has no outputs.`);let f=u[d];if(f===void 0)throw Error(`Classifier model output ${d} missing from run() result.`);let p=this._postprocess(f.data),{indices:m,values:h}=c.topK(p,r.topK??null),g=[];for(let e=0;e<m.length;e++){let t=m[e],n=this._labels[t]??`class_${t}`;g.push({classId:t,className:n,probability:h[e],cls:t,name:n,conf:h[e]})}if(g.length===0)throw Error(`Classifier produced no probabilities (empty output).`);let _=g[0],v={classId:_.classId,className:_.className,confidence:_.probability,cls:_.classId,name:_.className,conf:_.probability,image:s,probabilities:g},y=[s.height,s.width],b=new t.Probs(p);return i.stage(`postprocess`),[new t.ClassificationResults(b,v,this._names,s,y,a,i.speed())]}_preprocess(e){let[t,n]=this._inputSize,r=s.resize(e,t,n);return s.toFloat32Tensor(s.toCHW(s.normalize(r,this._mean,this._std),r.width,r.height,3),[1,3,r.height,r.width])}_postprocess(e){return this._applySoftmax?c.softmax(e):new Float32Array(e)}};exports.Classifier=f;
 //# sourceMappingURL=classifier.cjs.map