@mauriciobenjamin700/ort-vision-sdk-web 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,92 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-08-03
+
+### Added
+
+- **Tasks read their input resolution off the model instead of trusting
+  configuration.** `Classifier`, `Detector` and `Segmenter` now ask the ONNX
+  graph what shape it declares and preprocess to that. The resolution a session
+  must be fed at is a property of the export — feeding a 640x640 tensor to a
+  graph exported at 224x224 makes ORT abort mid-run with:
+
+  ```text
+  Inference failed: failed to call OrtRun(). ERROR_CODE: 2, ERROR_MESSAGE: Got
+  invalid dimensions for input: images for the following indices index: 2
+  Got: 640 Expected: 224
+  ```
+
+  A caller had no way to see that coming: the number lives in the file. So it is
+  read from there now.
+
+  ```typescript
+  // An Ultralytics -cls export is 224; nothing to configure, nothing to get wrong
+  const clf = await Classifier.create("/models/classify.onnx", { labels: LABELS });
+  console.log(clf.inputSize); // [224, 224]
+  ```
+
+  `inputSize` is now a *fallback*, used only when the graph leaves its spatial
+  axes dynamic. Passing a size that contradicts a static graph logs a warning
+  and the graph wins — honoring the caller there would only turn a fixable
+  mismatch into a failed run.
+
+- **`inputSize` getter on every task**, so callers can read back the resolution
+  inference actually runs at rather than the one they asked for.
+
+- **`OrtSession.inputShapes` / `OrtSession.inputShape`** expose what the graph
+  declares, with dynamic axes as `null`. Empty when the runtime reports no
+  metadata (`onnxruntime-web` older than 1.21).
+
+- **`OrtSession.release()`** frees the native session. Needed whenever a session
+  is discarded while the page lives on — rebuilding a task at a different input
+  size, swapping in a newer model — which previously required reaching into
+  `session.raw`.
+
+- **`declaredShapesFrom`, `spatialInputSize`, `resolveInputSize`** (plus the
+  `DeclaredShape` / `DeclaredDim` types): the pure helpers behind the above,
+  exported so callers building their own pipeline can reuse the same precedence
+  rules without importing `onnxruntime-web` types themselves.
+
+## [0.3.0] - 2026-08-02
+
+### Added
+
+- **`predict()` now reports where the time went.** Every `Results` envelope
+  already carried a `speed` field, mirroring Ultralytics' `results[0].speed` —
+  and it was always empty, because no task ever filled it. `Classifier`,
+  `Detector` and `Segmenter` now time each stage and hand the breakdown to the
+  envelope:
+
+  ```typescript
+  const results = await det.predict("/images/street.jpg");
+  console.log(results[0].speed);
+  // { load: 84.2, preprocess: 11.7, inference: 118.9, postprocess: 6.4 }
+  ```
+
+  Four keys instead of Ultralytics' three: `preprocess`, `inference` and
+  `postprocess` measure the same boundaries Ultralytics does, and `load` covers
+  the fetch/decode this SDK performs inside `predict()` — on a cold cache it
+  dominates everything else, and folding it into `preprocess` would misreport
+  where the cost is.
+
+  New exports `Speed` (the four-key breakdown) and `SpeedTimer` (the stage
+  accumulator) let callers time their own pipeline stages around the SDK calls
+  using the same boundaries.
+
+### Changed
+
+- `Results.speed` is typed `Readonly<Speed>` instead of
+  `Readonly<Record<string, number>>`, so `speed.inference` is a `number` rather
+  than `number | undefined`. Envelopes built by hand default to all-zeros.
+
+### Deprecated
+
+- The `decodeYoloV8` / `decodeYoloV8Anchors` / `decodeYoloV8Seg` aliases were
+  announced for removal in `0.3.0`. They survive this release — dropping them
+  would break `tempest-react-sdk`, which re-exports all three from its vendored
+  copy. The warning now points at `0.4.0`.
+
 ## [0.2.1] - 2026-05-03
 
 First **published** release on npm. The previous `0.2.0` tag never produced a

package/README.md

@@ -4,6 +4,11 @@
 [![GitHub](https://img.shields.io/badge/github-mauriciobenjamin700%2Fort--vision--sdk-181717?logo=github)](https://github.com/mauriciobenjamin700/ort-vision-sdk)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/mauriciobenjamin700/ort-vision-sdk/blob/main/sdk-js-web/LICENSE)
 
+> **Documentation / Docs (bilingual):**
+> [Português (BR)](https://mauriciobenjamin700.github.io/ort-vision-sdk/) ·
+> [English (US)](https://mauriciobenjamin700.github.io/ort-vision-sdk/en/) —
+> use the PT-BR / EN-US selector at the top of the site to switch language.
+
 High-level TypeScript SDK for browser computer vision inference on top of [ONNX Runtime Web](https://onnxruntime.ai/docs/get-started/with-javascript/web.html).
 
 Mirrors the Python [`ort-vision-sdk`](https://pypi.org/project/ort-vision-sdk/) API: task-oriented classes (`Classifier`, `Detector`) that handle image loading, preprocessing, execution-provider selection and postprocessing. Output is the same typed shape as the Python version (`ClassificationResult`, `DetectionResult`, `BoundingBox`).
@@ -32,8 +37,17 @@ const result = await clf.predict("/images/dog.jpg", { topK: 5 });
 console.log(result.className, result.confidence);
 console.log(result.probabilities);
 // result.image is an RGBImage (HWC RGB Uint8Array) — the original input.
+console.log(clf.inputSize);
+// [224, 224] — read from the .onnx graph, not configured.
 ```
 
+> **The model decides its input size.** `inputSize` is optional: the resolution
+> the graph declares always wins, because it is the only shape ONNX Runtime will
+> accept. An Ultralytics `-cls` export is 224x224 while a detector is 640x640 —
+> get it wrong and ORT aborts with `Got invalid dimensions for input: images`.
+> Read it back with `task.inputSize`, or inspect `session.inputShape`. See
+> [O modelo manda / The model decides](https://mauriciobenjamin700.github.io/ort-vision-sdk/en/guia/modelo/).
+
 ### Object detection
 
 ```typescript
@@ -52,6 +66,18 @@ for (const d of detections) {
 }
 ```
 
+## Inference speed
+
+Every result envelope carries a per-stage timing breakdown:
+
+```typescript
+const results = await det.predict("/images/street.jpg");
+console.log(results[0].speed);
+// { load: 84.2, preprocess: 11.7, inference: 118.9, postprocess: 6.4 }
+```
+
+Milliseconds. `preprocess` / `inference` / `postprocess` measure the same boundaries Ultralytics reports; `load` is the fetch/decode this SDK does inside `predict()`, which on a cold cache dominates everything else. Loading the model is *not* included — that is startup cost. Export `SpeedTimer` to time your own pipeline stages with the same boundaries.
+
 ## Accepted image inputs
 
 `predict(image)` and `loadImage(image)` both accept:

package/dist/core/graph.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What the ONNX graph itself says about its inputs.
+ *
+ * The resolution a session must be fed at is a property of the exported model,
+ * not of the configuration around it. Feeding a 640x640 tensor to a graph
+ * exported at 224x224 makes ORT abort the run with
+ * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the
+ * caller has no way to see that coming from the outside — the number lives in
+ * the file. So the SDK reads it from the graph and treats any configured size as
+ * a fallback for when the graph leaves it open.
+ */
+import type * as ort from "onnxruntime-web";
+/**
+ * One declared dimension: a number when the graph pins it, `null` when the
+ * dimension is symbolic (dynamic).
+ */
+export type DeclaredDim = number | null;
+/** A declared input/output shape, dynamic axes appearing as `null`. */
+export type DeclaredShape = readonly DeclaredDim[];
+/**
+ * Convert ORT value metadata into declared shapes.
+ *
+ * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or
+ *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).
+ * @returns One shape per value, in declaration order. Non-tensor values and
+ *   builds without metadata yield empty shapes, which read as "nothing
+ *   declared" everywhere downstream.
+ */
+export declare function declaredShapesFrom(metadata: readonly ort.InferenceSession.ValueMetadata[] | undefined): readonly DeclaredShape[];
+/**
+ * Read the spatial input size out of a declared NCHW shape.
+ *
+ * @param shape The declared shape of the model's image input.
+ * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or
+ *   leaves either spatial axis dynamic — in which case the model accepts more
+ *   than one resolution and there is nothing to correct.
+ */
+export declare function spatialInputSize(shape: DeclaredShape): readonly [number, number] | null;
+export interface ResolveInputSizeOptions {
+    /** Declared shape of the model's image input, from {@link declaredShapesFrom}. */
+    readonly graphShape?: DeclaredShape;
+    /** Size the caller asked for, if any. */
+    readonly requested?: readonly [number, number];
+    /** Size to use when neither the graph nor the caller pins one. */
+    readonly fallback: readonly [number, number];
+}
+/**
+ * Decide the input size a task will preprocess to.
+ *
+ * Precedence is graph → caller → fallback. The graph wins over an explicit
+ * `inputSize` because a static shape is not a preference, it is what ORT will
+ * accept: honoring the caller there would only turn a fixable mismatch into a
+ * failed run. A disagreement is a configuration bug in the caller, so it is
+ * reported through `console.warn` instead of being swallowed.
+ *
+ * @param options Graph shape, requested size and per-task fallback.
+ * @returns The `[width, height]` to preprocess to.
+ */
+export declare function resolveInputSize(options: ResolveInputSizeOptions): readonly [number, number];
+//# sourceMappingURL=graph.d.ts.map

package/dist/core/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/core/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG,SAAS,WAAW,EAAE,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,SAAS,GAClE,SAAS,aAAa,EAAE,CAO1B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAMvF;AAED,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5F"}

package/dist/core/graph.js

@@ -0,0 +1,68 @@
+/**
+ * What the ONNX graph itself says about its inputs.
+ *
+ * The resolution a session must be fed at is a property of the exported model,
+ * not of the configuration around it. Feeding a 640x640 tensor to a graph
+ * exported at 224x224 makes ORT abort the run with
+ * `Got invalid dimensions for input: images ... Got: 640 Expected: 224`, and the
+ * caller has no way to see that coming from the outside — the number lives in
+ * the file. So the SDK reads it from the graph and treats any configured size as
+ * a fallback for when the graph leaves it open.
+ */
+/**
+ * Convert ORT value metadata into declared shapes.
+ *
+ * @param metadata Metadata as reported by `InferenceSession.inputMetadata`, or
+ *   `undefined` on ORT builds that predate it (added in onnxruntime 1.21).
+ * @returns One shape per value, in declaration order. Non-tensor values and
+ *   builds without metadata yield empty shapes, which read as "nothing
+ *   declared" everywhere downstream.
+ */
+export function declaredShapesFrom(metadata) {
+    if (metadata === undefined)
+        return [];
+    return metadata.map((value) => value.isTensor
+        ? value.shape.map((dim) => (typeof dim === "number" && Number.isInteger(dim) && dim > 0 ? dim : null))
+        : []);
+}
+/**
+ * Read the spatial input size out of a declared NCHW shape.
+ *
+ * @param shape The declared shape of the model's image input.
+ * @returns `[width, height]` in pixels, or `null` when the shape is not 4D or
+ *   leaves either spatial axis dynamic — in which case the model accepts more
+ *   than one resolution and there is nothing to correct.
+ */
+export function spatialInputSize(shape) {
+    if (shape.length !== 4)
+        return null;
+    const height = shape[2];
+    const width = shape[3];
+    if (height === null || height === undefined || width === null || width === undefined)
+        return null;
+    return [width, height];
+}
+/**
+ * Decide the input size a task will preprocess to.
+ *
+ * Precedence is graph → caller → fallback. The graph wins over an explicit
+ * `inputSize` because a static shape is not a preference, it is what ORT will
+ * accept: honoring the caller there would only turn a fixable mismatch into a
+ * failed run. A disagreement is a configuration bug in the caller, so it is
+ * reported through `console.warn` instead of being swallowed.
+ *
+ * @param options Graph shape, requested size and per-task fallback.
+ * @returns The `[width, height]` to preprocess to.
+ */
+export function resolveInputSize(options) {
+    const graph = options.graphShape === undefined ? null : spatialInputSize(options.graphShape);
+    const requested = options.requested;
+    if (graph === null)
+        return requested ?? options.fallback;
+    if (requested !== undefined && (requested[0] !== graph[0] || requested[1] !== graph[1])) {
+        console.warn(`[ort-vision-sdk] The model declares a ${graph[0]}x${graph[1]} input; ` +
+            `ignoring the requested ${requested[0]}x${requested[1]}, which ONNX Runtime would reject.`);
+    }
+    return graph;
+}
+//# sourceMappingURL=graph.js.map

package/dist/core/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/core/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAmE;IAEnE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5B,KAAK,CAAC,QAAQ;QACZ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtG,CAAC,CAAC,EAAE,CACP,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAClG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACzB,CAAC;AAWD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IACzD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,CAAC,IAAI,CACV,yCAAyC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU;YACrE,0BAA0B,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,oCAAoC,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/session.d.ts

@@ -2,6 +2,7 @@
  * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.
  */
 import type * as ort from "onnxruntime-web";
+import { type DeclaredShape } from "./graph.js";
 /** Anything `InferenceSession.create` accepts. */
 export type ModelSource = string | ArrayBufferLike | Uint8Array;
 export interface OrtSessionOptions {
@@ -13,8 +14,9 @@ export interface OrtSessionOptions {
 /**
  * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.
  *
- * The wrapper exposes input/output names, manages execution-provider
- * selection, and provides a typed {@link OrtSession.run} method.
+ * The wrapper exposes input/output names and the shapes the graph declares,
+ * manages execution-provider selection, provides a typed {@link OrtSession.run}
+ * method, and releases the native session through {@link OrtSession.release}.
  */
 export declare class OrtSession {
     private readonly _session;
@@ -34,6 +36,29 @@ export declare class OrtSession {
     get inputName(): string;
     /** Names of the model's outputs, in declaration order. */
     get outputNames(): readonly string[];
+    /**
+     * Shapes the graph declares for its inputs, in declaration order.
+     *
+     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime
+     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`
+     * older than 1.21, which predates input metadata.
+     */
+    get inputShapes(): readonly DeclaredShape[];
+    /**
+     * Shape the graph declares for its first input, dynamic axes as `null`.
+     *
+     * Empty when the runtime reports no metadata for it.
+     */
+    get inputShape(): DeclaredShape;
+    /**
+     * Release the native session and free its memory.
+     *
+     * Call it when a session is discarded while the page lives on — rebuilding a
+     * task at a different input size, swapping in a newer model. A failure from
+     * the runtime is ignored: a session being torn down has nothing left to fail
+     * at, and the caller is already moving on.
+     */
+    release(): Promise<void>;
     /** The underlying `onnxruntime-web` session, for advanced use cases. */
     get raw(): ort.InferenceSession;
     /**

package/dist/core/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAM5C,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,cAAc,CAAC;CAC/D;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;aACT,SAAS,EAAE,SAAS,MAAM,EAAE;IAF9C,OAAO;IAKP;;;;;;OAMG;WACU,MAAM,CACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC;IA6BtB,yDAAyD;IACzD,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAElC;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,CAMtB;IAED,0DAA0D;IAC1D,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAEnC;IAED,wEAAwE;IACxE,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAE9B;IAED;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAWvC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,YAAY,CAAC;AAGpE,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,cAAc,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;aACT,SAAS,EAAE,SAAS,MAAM,EAAE;IAF9C,OAAO;IAKP;;;;;;OAMG;WACU,MAAM,CACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC;IA6BtB,yDAAyD;IACzD,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAElC;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,CAMtB;IAED,0DAA0D;IAC1D,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAEnC;IAED;;;;;;OAMG;IACH,IAAI,WAAW,IAAI,SAAS,aAAa,EAAE,CAM1C;IAED;;;;OAIG;IACH,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,wEAAwE;IACxE,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAE9B;IAED;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAWvC"}

package/dist/core/session.js

@@ -3,12 +3,14 @@
  */
 import * as ortRuntime from "onnxruntime-web";
 import { InferenceError, ModelLoadError } from "./exceptions.js";
+import { declaredShapesFrom } from "./graph.js";
 import { resolveProviders } from "./providers.js";
 /**
  * Wrap an ONNX Runtime Web `InferenceSession` with convenient metadata access.
  *
- * The wrapper exposes input/output names, manages execution-provider
- * selection, and provides a typed {@link OrtSession.run} method.
+ * The wrapper exposes input/output names and the shapes the graph declares,
+ * manages execution-provider selection, provides a typed {@link OrtSession.run}
+ * method, and releases the native session through {@link OrtSession.release}.
  */
 export class OrtSession {
     _session;
@@ -63,6 +65,35 @@ export class OrtSession {
     get outputNames() {
         return this._session.outputNames;
     }
+    /**
+     * Shapes the graph declares for its inputs, in declaration order.
+     *
+     * Dynamic (symbolic) axes appear as `null`. Empty shapes mean the runtime
+     * reported no metadata — either a non-tensor input, or an `onnxruntime-web`
+     * older than 1.21, which predates input metadata.
+     */
+    get inputShapes() {
+        return declaredShapesFrom(this._session.inputMetadata);
+    }
+    /**
+     * Shape the graph declares for its first input, dynamic axes as `null`.
+     *
+     * Empty when the runtime reports no metadata for it.
+     */
+    get inputShape() {
+        return this.inputShapes[0] ?? [];
+    }
+    /**
+     * Release the native session and free its memory.
+     *
+     * Call it when a session is discarded while the page lives on — rebuilding a
+     * task at a different input size, swapping in a newer model. A failure from
+     * the runtime is ignored: a session being torn down has nothing left to fail
+     * at, and the caller is already moving on.
+     */
+    async release() {
+        await this._session.release().catch(() => undefined);
+    }
     /** The underlying `onnxruntime-web` session, for advanced use cases. */
     get raw() {
         return this._session;

package/dist/core/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYlD;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IAEF;IACD;IAFlB,YACmB,QAA8B,EAC/B,SAA4B;QAD3B,aAAQ,GAAR,QAAQ,CAAsB;QAC/B,cAAS,GAAT,SAAS,CAAmB;IAC3C,CAAC;IAEJ;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,KAAkB,EAClB,UAA6B,EAAE;QAE/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,cAAc,GAAwC;YAC1D,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;YACjC,kBAAkB,EAAE,SAAsE;SAC3F,CAAC;QAEF,IAAI,OAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAC5E,CAAC;iBAAM,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;gBACvC,OAAO,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAChD,KAAoB,EACpB,cAAc,CACf,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,cAAc,CACtB,8BAA+B,GAAa,CAAC,OAAO,EAAE,EACtD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,yDAAyD;IACzD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAClC,CAAC;IAED,kDAAkD;IAClD,IAAI,SAAS;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;IACnC,CAAC;IAED,wEAAwE;IACxE,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CACP,KAAiC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAoC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,cAAc,CACtB,qBAAsB,GAAa,CAAC,OAAO,EAAE,EAC7C,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"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"}

package/dist/core/timing.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Per-stage timing for a single `predict()` call.
+ *
+ * Populates the `speed` field every `Results` envelope carries, mirroring
+ * Ultralytics' `results[0].speed`. All values are milliseconds measured with
+ * `performance.now()`.
+ */
+/**
+ * Stage durations of one inference, in milliseconds.
+ *
+ * `preprocess`, `inference` and `postprocess` are the three keys Ultralytics
+ * reports, measured over the same boundaries. `load` is specific to this SDK:
+ * `predict()` accepts a URL, `Blob` or DOM element and decodes it internally,
+ * so the fetch/decode cost would otherwise be invisible — and on a cold cache
+ * it dominates everything else.
+ */
+export interface Speed {
+    /** Fetching and decoding the input into an `RGBImage`. */
+    load: number;
+    /** Letterbox/resize, normalization and tensor packing. */
+    preprocess: number;
+    /** The ONNX Runtime forward pass. */
+    inference: number;
+    /** Decoding raw outputs into results (NMS, mask assembly, top-k). */
+    postprocess: number;
+}
+/**
+ * Accumulate stage durations while a `predict()` call runs.
+ *
+ * Each `stage()` call closes the previous stage: the elapsed time since the
+ * last boundary is attributed to the name given. This keeps the call sites
+ * free of paired start/stop bookkeeping and guarantees the four stages tile
+ * the whole call without gaps.
+ */
+export declare class SpeedTimer {
+    private _last;
+    private readonly _speed;
+    constructor();
+    /**
+     * Attribute the time elapsed since the previous boundary to `stage`.
+     *
+     * @param stage Which stage just finished.
+     */
+    stage(stage: keyof Speed): void;
+    /**
+     * The accumulated durations.
+     *
+     * @returns The `speed` object to hand to the `Results` envelope.
+     */
+    speed(): Speed;
+}
+//# sourceMappingURL=timing.d.ts.map

package/dist/core/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/core/timing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKrB;;IAMF;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,IAAI;IAM/B;;;;OAIG;IACH,KAAK,IAAI,KAAK;CAGf"}

package/dist/core/timing.js

@@ -0,0 +1,46 @@
+/**
+ * Per-stage timing for a single `predict()` call.
+ *
+ * Populates the `speed` field every `Results` envelope carries, mirroring
+ * Ultralytics' `results[0].speed`. All values are milliseconds measured with
+ * `performance.now()`.
+ */
+/**
+ * Accumulate stage durations while a `predict()` call runs.
+ *
+ * Each `stage()` call closes the previous stage: the elapsed time since the
+ * last boundary is attributed to the name given. This keeps the call sites
+ * free of paired start/stop bookkeeping and guarantees the four stages tile
+ * the whole call without gaps.
+ */
+export class SpeedTimer {
+    _last;
+    _speed = {
+        load: 0,
+        preprocess: 0,
+        inference: 0,
+        postprocess: 0,
+    };
+    constructor() {
+        this._last = performance.now();
+    }
+    /**
+     * Attribute the time elapsed since the previous boundary to `stage`.
+     *
+     * @param stage Which stage just finished.
+     */
+    stage(stage) {
+        const now = performance.now();
+        this._speed[stage] += now - this._last;
+        this._last = now;
+    }
+    /**
+     * The accumulated durations.
+     *
+     * @returns The `speed` object to hand to the `Results` envelope.
+     */
+    speed() {
+        return { ...this._speed };
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/core/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/core/timing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,CAAS;IACL,MAAM,GAAU;QAC/B,IAAI,EAAE,CAAC;QACP,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;KACf,CAAC;IAEF;QACE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAkB;QACtB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -7,7 +7,9 @@ export { Boxes, ClassificationResults, DetectionResults, Masks, Probs, Segmentat
 export { COCO_CLASSES, type LabelSpec, type ResolveLabelsOptions, resolveLabels, } from "./labels.js";
 export { ImageLoadError, InferenceError, LabelMapError, ModelLoadError, OrtVisionError, ProviderNotAvailableError, } from "./core/exceptions.js";
 export { type ModelSource, type OrtSessionOptions, OrtSession, } from "./core/session.js";
+export { type DeclaredDim, type DeclaredShape, type ResolveInputSizeOptions, declaredShapesFrom, resolveInputSize, spatialInputSize, } from "./core/graph.js";
 export { DEFAULT_PROVIDERS, resolveProviders } from "./core/providers.js";
+export { type Speed, SpeedTimer } from "./core/timing.js";
 export { type ImageInput, loadImage } from "./io/image.js";
 export { type LetterboxResult, fromCv2, letterbox, normalize, resize, toCHW, toCv2, toFloat32, toFloat32Tensor, toTensor, } from "./preprocess/image.js";
 export { type TopKResult, softmax, topK, } from "./postprocess/classification.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EACL,KAAK,eAAe,EACpB,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,UAAU,EACf,OAAO,EACP,IAAI,GACL,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,GAAG,GACJ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,KAAK,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EACL,KAAK,eAAe,EACpB,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,UAAU,EACf,OAAO,EACP,IAAI,GACL,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,GAAG,GACJ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}

package/dist/index.js

@@ -7,7 +7,9 @@ export { Boxes, ClassificationResults, DetectionResults, Masks, Probs, Segmentat
 export { COCO_CLASSES, resolveLabels, } from "./labels.js";
 export { ImageLoadError, InferenceError, LabelMapError, ModelLoadError, OrtVisionError, ProviderNotAvailableError, } from "./core/exceptions.js";
 export { OrtSession, } from "./core/session.js";
+export { declaredShapesFrom, resolveInputSize, spatialInputSize, } from "./core/graph.js";
 export { DEFAULT_PROVIDERS, resolveProviders } from "./core/providers.js";
+export { SpeedTimer } from "./core/timing.js";
 export { loadImage } from "./io/image.js";
 export { fromCv2, letterbox, normalize, resize, toCHW, toCv2, toFloat32, toFloat32Tensor, toTensor, } from "./preprocess/image.js";
 export { softmax, topK, } from "./postprocess/classification.js";
@@ -17,5 +19,5 @@ export { VisionTask } from "./tasks/base.js";
 export { Classifier, } from "./tasks/classifier.js";
 export { Detector, } from "./tasks/detector.js";
 export { Segmenter, } from "./tasks/segmenter.js";
-export const VERSION = "0.2.1";
+export const VERSION = "0.4.0";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,GAKT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EAGZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAEL,OAAO,EACP,IAAI,GACL,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAOL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,GAAG,GACJ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAIL,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAGL,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,GAKT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EAGZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAc,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAEL,OAAO,EACP,IAAI,GACL,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAOL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,GAAG,GACJ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAIL,aAAa,EACb,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAGL,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC"}

package/dist/postprocess/detection.d.ts

@@ -98,11 +98,11 @@ export interface DecodedDetection {
 export declare function decodeYolo(output: Float32Array, outputDims: readonly number[], options: DecodeYoloOptions): DecodedDetection[];
 /**
  * @deprecated since 0.2.0 — use {@link decodeYolo}. Same behavior; the
- * decoder covers v8/v9/v10/v11/v12 detect heads. Will be removed in 0.3.0.
+ * decoder covers v8/v9/v10/v11/v12 detect heads. Will be removed in 0.4.0.
  */
 export declare function decodeYoloV8(output: Float32Array, outputDims: readonly number[], options: DecodeYoloOptions): DecodedDetection[];
 /**
- * @deprecated since 0.2.0 — use {@link decodeYoloAnchors}. Will be removed in 0.3.0.
+ * @deprecated since 0.2.0 — use {@link decodeYoloAnchors}. Will be removed in 0.4.0.
  */
 export declare function decodeYoloV8Anchors(data: Float32Array, dims: readonly number[], options: DecodeYoloAnchorsOptions): DecodedAnchors;
 /** @deprecated since 0.2.0 — use {@link DecodeYoloAnchorsOptions}. */

package/dist/postprocess/detection.js

@@ -259,24 +259,24 @@ let _warnedDecodeYoloV8 = false;
 let _warnedDecodeYoloV8Anchors = false;
 /**
  * @deprecated since 0.2.0 — use {@link decodeYolo}. Same behavior; the
- * decoder covers v8/v9/v10/v11/v12 detect heads. Will be removed in 0.3.0.
+ * decoder covers v8/v9/v10/v11/v12 detect heads. Will be removed in 0.4.0.
  */
 export function decodeYoloV8(output, outputDims, options) {
     if (!_warnedDecodeYoloV8) {
         _warnedDecodeYoloV8 = true;
         console.warn("[@ort-vision-sdk/web] decodeYoloV8 is deprecated since 0.2.0; use decodeYolo. " +
-            "The alias will be removed in 0.3.0.");
+            "The alias will be removed in 0.4.0.");
     }
     return decodeYolo(output, outputDims, options);
 }
 /**
- * @deprecated since 0.2.0 — use {@link decodeYoloAnchors}. Will be removed in 0.3.0.
+ * @deprecated since 0.2.0 — use {@link decodeYoloAnchors}. Will be removed in 0.4.0.
  */
 export function decodeYoloV8Anchors(data, dims, options) {
     if (!_warnedDecodeYoloV8Anchors) {
         _warnedDecodeYoloV8Anchors = true;
         console.warn("[@ort-vision-sdk/web] decodeYoloV8Anchors is deprecated since 0.2.0; use decodeYoloAnchors. " +
-            "The alias will be removed in 0.3.0.");
+            "The alias will be removed in 0.4.0.");
     }
     return decodeYoloAnchors(data, dims, options);
 }

package/dist/postprocess/segmentation.d.ts

@@ -54,7 +54,7 @@ export interface DecodedSegmentation {
  * @param prototypeDims Dims as reported by ORT, e.g. `[1, 32, 160, 160]`.
  */
 export declare function decodeYoloSeg(perAnchorData: Float32Array, perAnchorDims: readonly number[], prototypeData: Float32Array, prototypeDims: readonly number[], options: DecodeYoloSegOptions): DecodedSegmentation[];
-/** @deprecated since 0.2.0 — use {@link decodeYoloSeg}. Will be removed in 0.3.0. */
+/** @deprecated since 0.2.0 — use {@link decodeYoloSeg}. Will be removed in 0.4.0. */
 export declare function decodeYoloV8Seg(perAnchorData: Float32Array, perAnchorDims: readonly number[], prototypeData: Float32Array, prototypeDims: readonly number[], options: DecodeYoloSegOptions): DecodedSegmentation[];
 /** @deprecated since 0.2.0 — use {@link DecodeYoloSegOptions}. */
 export type DecodeYoloV8SegOptions = DecodeYoloSegOptions;

package/dist/postprocess/segmentation.js

@@ -140,12 +140,12 @@ function sigmoid(x) {
     return e / (1 + e);
 }
 let _warnedDecodeYoloV8Seg = false;
-/** @deprecated since 0.2.0 — use {@link decodeYoloSeg}. Will be removed in 0.3.0. */
+/** @deprecated since 0.2.0 — use {@link decodeYoloSeg}. Will be removed in 0.4.0. */
 export function decodeYoloV8Seg(perAnchorData, perAnchorDims, prototypeData, prototypeDims, options) {
     if (!_warnedDecodeYoloV8Seg) {
         _warnedDecodeYoloV8Seg = true;
         console.warn("[@ort-vision-sdk/web] decodeYoloV8Seg is deprecated since 0.2.0; use decodeYoloSeg. " +
-            "The alias will be removed in 0.3.0.");
+            "The alias will be removed in 0.4.0.");
     }
     return decodeYoloSeg(perAnchorData, perAnchorDims, prototypeData, prototypeDims, options);
 }