@mauriciobenjamin700/ort-vision-sdk-web 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,128 @@
+# Changelog
+
+All notable changes to `@mauriciobenjamin700/ort-vision-sdk-web` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.1] - 2026-05-03
+
+First **published** release on npm. The previous `0.2.0` tag never produced a
+package because the CI smoke-install step still referenced the old
+`@ort-vision-sdk/web` scope after the rename to
+`@mauriciobenjamin700/ort-vision-sdk-web`. No public API changes.
+
+### Changed
+
+- README rewritten with badges, GitHub repo links, npm install snippets and
+  imports updated to the new `@mauriciobenjamin700/ort-vision-sdk-web` scope.
+
+### Fixed
+
+- CI smoke-install step now captures the packed tarball name dynamically and
+  resolves the package name via `package.json`, so it survives future
+  package-name changes.
+
+## [0.2.0] - 2026-05-02
+
+This release brings the public API in line with the Ultralytics / PyTorch
+idiom, mirroring the Python `ort-vision-sdk` 0.2.0 changes.
+
+### Added
+
+- **Per-image `Results` envelopes** (`DetectionResults`, `ClassificationResults`,
+  `SegmentationResults`) returned by every `predict()` call as a 1-element
+  array, mirroring `YOLO("img.jpg")`. Each envelope holds:
+  - `boxes` / `probs` / `masks` — bulk typed-array views with Ultralytics-style
+    accessors (`xyxy`, `xywh`, `xyxyn`, `xywhn`, `cls`, `conf`, `data`,
+    `top1`, `top1conf`, `top5`, `top5conf`).
+  - `detections` — array of per-instance objects (the previous return type).
+  - `names` — `Record<number, string>` matching `model.names`.
+  - `origImg`, `origShape`, `path`, `speed`.
+  - `[Symbol.iterator]` — `for (const d of results[0])` works directly.
+- **Ultralytics-style aliases** on `BoundingBox`, `ClassProbability`,
+  `ClassificationResult`, `DetectionResult`, `SegmentationResult`:
+  `cls`, `conf`, `name`, `box`, `xyxy`, `xywh` (center coords),
+  plus `xyxyn(origShape)` / `xywhn(origShape)` methods on `BoundingBox`.
+- **`call(image)` method** on every task class — delegates to `predict()`,
+  for parity with PyTorch `nn.Module.__call__`.
+- **`names: Record<number, string>` getter** on every task class alongside
+  `labels: readonly string[]`.
+- **`batchedNms(boxes, scores, idxs, iouThreshold)`** matching
+  `torchvision.ops.batched_nms`.
+- **Generic YOLO decoder names**: `decodeYolo`, `decodeYoloAnchors`,
+  `decodeYoloSeg` — same code, accurate name (covers v8/v9/v10/v11/v12).
+- **Preprocess helpers** mirroring torchvision/OpenCV:
+  - `toTensor(image)` → CHW `Float32Array / 255` (ToTensor parity).
+  - `fromCv2(bgr, w, h)` / `toCv2(image)` — channel-order bridges.
+- **Explicit `head` option** on `Detector.create()` and `Segmenter.create()`
+  — caller declares which decoder family the model uses (`"yolo"` for
+  detect heads of v8/v9/v10/v11/v12/v26; `"yolo-seg"` for the matching seg
+  heads). The SDK does **not** auto-detect — passing an unsupported head
+  throws. New types `DetectorHead`, `SegmenterHead`.
+- **`classes` filter** on `Detector.predict()`/`call()` and
+  `Segmenter.predict()`/`call()` predict-options — keeps only results
+  whose `classId` is in the supplied array, matching Ultralytics'
+  `model.predict(img, classes=[0, 16])`.
+
+### Changed
+
+- `Detector.predict(img)` now returns `Promise<DetectionResults[]>` (1
+  element) instead of `Promise<DetectionResult[]>`. Iterate the envelope
+  to recover the old shape: `for (const d of (await det.predict(img))[0]) ...`.
+- `Classifier.predict(img)` now returns `Promise<ClassificationResults[]>`.
+- `Segmenter.predict(img)` now returns `Promise<SegmentationResults[]>`.
+- The detection decoder is funnelled through `batchedNms` instead of an
+  inline per-class loop.
+
+### Deprecated
+
+- `decodeYoloV8`, `decodeYoloV8Anchors`, `decodeYoloV8Seg` — log a one-time
+  `console.warn` and delegate to the generic `decodeYolo*` versions.
+  Will be removed in 0.3.0. The corresponding option types
+  (`DecodeYoloV8Options`, `DecodeYoloV8AnchorsOptions`,
+  `DecodeYoloV8SegOptions`) are now type aliases of the new names.
+
+### Migration
+
+```typescript
+// Before (0.1.0)
+const detections = await det.predict("street.jpg");
+for (const d of detections) {
+  console.log(d.classId, d.className, d.confidence, d.bbox.asXyxy());
+}
+
+// After (0.2.0)
+const results = await det.predict("street.jpg");  // length 1
+const r = results[0];
+
+// Per-instance entries (legacy fields still present):
+for (const d of r) {
+  console.log(d.classId, d.className, d.confidence, d.bbox.asXyxy());
+}
+// or with the new short aliases:
+for (const d of r) {
+  console.log(d.cls, d.name, d.conf, d.box.xyxy);
+}
+
+// Bulk typed-array access (matches Ultralytics):
+console.log(r.boxes.xyxy, r.boxes.cls, r.boxes.conf, r.names);
+```
+
+## [0.1.0] - 2026-05-02
+
+### Added
+
+- Initial alpha release.
+- `Classifier` and `Detector` task classes wrapping `onnxruntime-web` sessions.
+- Browser-friendly image loading (`loadImage`) accepting URLs, `Blob`, `File`, `HTMLImageElement`, `HTMLCanvasElement`, `OffscreenCanvas`, `ImageBitmap`, `ImageData`, and `RGBImage`.
+- Preprocessing helpers: `letterbox`, `resize`, `normalize`, `toCHW`, `toFloat32`, `toFloat32Tensor`.
+- Postprocessing helpers: `softmax`, `topK`, `decodeYoloV8`, `nms`.
+- Execution-provider resolution defaulting to `["webgpu", "wasm"]`.
+- Public types mirroring the Python SDK: `BoundingBox`, `ClassProbability`, `ClassificationResult`, `DetectionResult`, `RGBImage`.
+
+[Unreleased]: https://github.com/mauriciobenjamin700/ort-vision-sdk/compare/web-v0.2.0...HEAD
+[0.2.0]: https://github.com/mauriciobenjamin700/ort-vision-sdk/releases/tag/web-v0.2.0
+[0.1.0]: https://github.com/mauriciobenjamin700/ort-vision-sdk/releases/tag/web-v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mauricio Benjamin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @mauriciobenjamin700/ort-vision-sdk-web
+
+[![npm](https://img.shields.io/npm/v/@mauriciobenjamin700/ort-vision-sdk-web.svg)](https://www.npmjs.com/package/@mauriciobenjamin700/ort-vision-sdk-web)
+[![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)
+
+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`).
+
+## Installation
+
+```bash
+npm install @mauriciobenjamin700/ort-vision-sdk-web onnxruntime-web
+```
+
+`onnxruntime-web` is a peer dependency — you bring your own version and ship the matching `.wasm` files yourself.
+
+## Quick start
+
+### Image classification
+
+```typescript
+import { Classifier } from "@mauriciobenjamin700/ort-vision-sdk-web";
+
+const clf = await Classifier.create("/models/resnet50.onnx", {
+  labels: ["tench", "goldfish", /* ... 1000 ImageNet labels */],
+});
+
+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.
+```
+
+### Object detection
+
+```typescript
+import { Detector } from "@mauriciobenjamin700/ort-vision-sdk-web";
+
+// labels defaults to "coco" (80 classes)
+const det = await Detector.create("/models/yolov8n.onnx");
+
+const detections = await det.predict("/images/street.jpg", {
+  confThreshold: 0.4,
+});
+
+for (const d of detections) {
+  console.log(d.className, d.confidence, d.bbox.asXyxy());
+  // d.croppedImage is an RGBImage of just that bounding box region.
+}
+```
+
+## Accepted image inputs
+
+`predict(image)` and `loadImage(image)` both accept:
+
+- `string` — a URL fetched via `fetch()`.
+- `Blob` / `File` — for `<input type="file">` uploads.
+- `HTMLImageElement` — an existing `<img>` tag.
+- `HTMLCanvasElement` / `OffscreenCanvas` — already-rendered canvas.
+- `ImageBitmap` — from `createImageBitmap()`.
+- `ImageData` — raw pixel buffer (RGBA from canvas `getImageData()`).
+- `RGBImage` — the SDK's canonical HWC RGB Uint8Array wrapper.
+
+## Execution providers
+
+The default provider order is `["webgpu", "wasm"]` — ONNX Runtime tries WebGPU first and silently falls back to WebAssembly if WebGPU isn't available. You can override per task:
+
+```typescript
+const clf = await Classifier.create(model, {
+  labels,
+  providers: ["wasm"], // force CPU
+});
+```
+
+For WebGPU to actually engage you need a recent ORT-Web build, a Chromium-based browser with WebGPU enabled, and either secure context (`https://` or `localhost`) or the right COOP/COEP headers if you also want SharedArrayBuffer-based wasm threading.
+
+## Status
+
+This project is **alpha** — the public API is stable enough to build against, but minor versions may introduce breaking changes during the pre-1.0 phase. Pin the version range you build against.
+
+- Source code & issues: <https://github.com/mauriciobenjamin700/ort-vision-sdk>
+- Changelog: <https://github.com/mauriciobenjamin700/ort-vision-sdk/blob/main/sdk-js-web/CHANGELOG.md>
+- Python counterpart: [`ort-vision-sdk`](https://pypi.org/project/ort-vision-sdk/)
+
+## License
+
+MIT — see [LICENSE](https://github.com/mauriciobenjamin700/ort-vision-sdk/blob/main/sdk-js-web/LICENSE).

package/dist/core/canvas.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canvas plumbing shared by `io/image.ts` and `preprocess/image.ts`.
+ *
+ * Browsers and workers expose two canvas types (`HTMLCanvasElement` and
+ * `OffscreenCanvas`) with slightly different surfaces. These helpers pick the
+ * right one for the current environment, return a unified 2D context, and
+ * convert between RGBA `ImageData` and the SDK's canonical HWC RGB
+ * `RGBImage`.
+ */
+import { RGBImage } from "../types.js";
+export type Canvas2D = HTMLCanvasElement | OffscreenCanvas;
+export type Context2D = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
+/** Allocate a `Canvas2D`, preferring `OffscreenCanvas` when available. */
+export declare function createCanvas(width: number, height: number): Canvas2D;
+/** Get a 2D context from a canvas, throwing a typed error if the browser refuses. */
+export declare function get2DContext(canvas: Canvas2D): Context2D;
+/** Convert RGBA `ImageData` into the canonical HWC RGB `RGBImage`. */
+export declare function imageDataToRGB(imageData: ImageData): RGBImage;
+/** Convert an `RGBImage` into RGBA `ImageData` (alpha forced to 255). */
+export declare function rgbToImageData(image: RGBImage): ImageData;
+//# sourceMappingURL=canvas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/core/canvas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAC3D,MAAM,MAAM,SAAS,GACjB,wBAAwB,GACxB,iCAAiC,CAAC;AAEtC,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAWpE;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAMxD;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAgB7D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CASzD"}

package/dist/core/canvas.js

@@ -0,0 +1,58 @@
+/**
+ * Canvas plumbing shared by `io/image.ts` and `preprocess/image.ts`.
+ *
+ * Browsers and workers expose two canvas types (`HTMLCanvasElement` and
+ * `OffscreenCanvas`) with slightly different surfaces. These helpers pick the
+ * right one for the current environment, return a unified 2D context, and
+ * convert between RGBA `ImageData` and the SDK's canonical HWC RGB
+ * `RGBImage`.
+ */
+import { ImageLoadError } from "./exceptions.js";
+import { RGBImage } from "../types.js";
+/** Allocate a `Canvas2D`, preferring `OffscreenCanvas` when available. */
+export function createCanvas(width, height) {
+    if (typeof OffscreenCanvas !== "undefined") {
+        return new OffscreenCanvas(width, height);
+    }
+    if (typeof document !== "undefined") {
+        const c = document.createElement("canvas");
+        c.width = width;
+        c.height = height;
+        return c;
+    }
+    throw new ImageLoadError("No canvas implementation available in this environment.");
+}
+/** Get a 2D context from a canvas, throwing a typed error if the browser refuses. */
+export function get2DContext(canvas) {
+    const ctx = canvas.getContext("2d");
+    if (ctx === null) {
+        throw new ImageLoadError("Failed to obtain 2D rendering context.");
+    }
+    return ctx;
+}
+/** Convert RGBA `ImageData` into the canonical HWC RGB `RGBImage`. */
+export function imageDataToRGB(imageData) {
+    const { data, width, height } = imageData;
+    if (data.length !== width * height * 4) {
+        throw new ImageLoadError(`Unexpected ImageData length ${data.length} for ${width}x${height} (expected ${width * height * 4}).`);
+    }
+    const rgb = new Uint8Array(width * height * 3);
+    for (let i = 0, j = 0; i < data.length; i += 4, j += 3) {
+        rgb[j] = data[i];
+        rgb[j + 1] = data[i + 1];
+        rgb[j + 2] = data[i + 2];
+    }
+    return new RGBImage(rgb, width, height);
+}
+/** Convert an `RGBImage` into RGBA `ImageData` (alpha forced to 255). */
+export function rgbToImageData(image) {
+    const data = new Uint8ClampedArray(image.width * image.height * 4);
+    for (let i = 0, j = 0; i < image.data.length; i += 3, j += 4) {
+        data[j] = image.data[i];
+        data[j + 1] = image.data[i + 1];
+        data[j + 2] = image.data[i + 2];
+        data[j + 3] = 255;
+    }
+    return new ImageData(data, image.width, image.height);
+}
+//# sourceMappingURL=canvas.js.map

package/dist/core/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../src/core/canvas.ts"],"names":[],"mappings":"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"}

package/dist/core/exceptions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Exceptions raised by the SDK.
+ *
+ * All exceptions inherit from {@link OrtVisionError}, so callers can catch
+ * the base class to handle any SDK-originated failure uniformly.
+ */
+export declare class OrtVisionError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Raised when an ONNX model cannot be loaded into an inference session. */
+export declare class ModelLoadError extends OrtVisionError {
+}
+/** Raised when ONNX Runtime fails while executing a model. */
+export declare class InferenceError extends OrtVisionError {
+}
+/** Raised when a requested execution provider is not available. */
+export declare class ProviderNotAvailableError extends OrtVisionError {
+}
+/** Raised when an input image cannot be decoded into the canonical format. */
+export declare class ImageLoadError extends OrtVisionError {
+}
+/** Raised when class labels cannot be resolved from the supplied spec. */
+export declare class LabelMapError extends OrtVisionError {
+}
+//# sourceMappingURL=exceptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,4EAA4E;AAC5E,qBAAa,cAAe,SAAQ,cAAc;CAAG;AAErD,8DAA8D;AAC9D,qBAAa,cAAe,SAAQ,cAAc;CAAG;AAErD,mEAAmE;AACnE,qBAAa,yBAA0B,SAAQ,cAAc;CAAG;AAEhE,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,cAAc;CAAG;AAErD,0EAA0E;AAC1E,qBAAa,aAAc,SAAQ,cAAc;CAAG"}

package/dist/core/exceptions.js

@@ -0,0 +1,28 @@
+/**
+ * Exceptions raised by the SDK.
+ *
+ * All exceptions inherit from {@link OrtVisionError}, so callers can catch
+ * the base class to handle any SDK-originated failure uniformly.
+ */
+export class OrtVisionError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+/** Raised when an ONNX model cannot be loaded into an inference session. */
+export class ModelLoadError extends OrtVisionError {
+}
+/** Raised when ONNX Runtime fails while executing a model. */
+export class InferenceError extends OrtVisionError {
+}
+/** Raised when a requested execution provider is not available. */
+export class ProviderNotAvailableError extends OrtVisionError {
+}
+/** Raised when an input image cannot be decoded into the canonical format. */
+export class ImageLoadError extends OrtVisionError {
+}
+/** Raised when class labels cannot be resolved from the supplied spec. */
+export class LabelMapError extends OrtVisionError {
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/core/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/core/exceptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,OAAO,cAAe,SAAQ,cAAc;CAAG;AAErD,8DAA8D;AAC9D,MAAM,OAAO,cAAe,SAAQ,cAAc;CAAG;AAErD,mEAAmE;AACnE,MAAM,OAAO,yBAA0B,SAAQ,cAAc;CAAG;AAEhE,8EAA8E;AAC9E,MAAM,OAAO,cAAe,SAAQ,cAAc;CAAG;AAErD,0EAA0E;AAC1E,MAAM,OAAO,aAAc,SAAQ,cAAc;CAAG"}

package/dist/core/providers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Execution-provider defaults for ONNX Runtime Web sessions.
+ *
+ * Unlike Node ORT, the browser ORT cannot enumerate "available providers" at
+ * runtime — `webgpu` either works or ORT silently falls back to the next
+ * provider in the list. We just expose a sensible default order.
+ */
+/**
+ * Default execution provider preference order for browser ORT.
+ *
+ * `webgpu` is tried first when available; ORT-Web falls back to `wasm`
+ * automatically when WebGPU is not supported by the browser or device.
+ */
+export declare const DEFAULT_PROVIDERS: readonly string[];
+/**
+ * Resolve the execution providers to pass to `InferenceSession.create`.
+ *
+ * @param requested Explicit provider list in preference order; `undefined` returns the default.
+ */
+export declare function resolveProviders(requested?: readonly string[]): string[];
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/core/providers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAuB,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAQxE"}

package/dist/core/providers.js

@@ -0,0 +1,29 @@
+/**
+ * Execution-provider defaults for ONNX Runtime Web sessions.
+ *
+ * Unlike Node ORT, the browser ORT cannot enumerate "available providers" at
+ * runtime — `webgpu` either works or ORT silently falls back to the next
+ * provider in the list. We just expose a sensible default order.
+ */
+/**
+ * Default execution provider preference order for browser ORT.
+ *
+ * `webgpu` is tried first when available; ORT-Web falls back to `wasm`
+ * automatically when WebGPU is not supported by the browser or device.
+ */
+export const DEFAULT_PROVIDERS = ["webgpu", "wasm"];
+/**
+ * Resolve the execution providers to pass to `InferenceSession.create`.
+ *
+ * @param requested Explicit provider list in preference order; `undefined` returns the default.
+ */
+export function resolveProviders(requested) {
+    if (requested === undefined) {
+        return [...DEFAULT_PROVIDERS];
+    }
+    if (requested.length === 0) {
+        return [...DEFAULT_PROVIDERS];
+    }
+    return [...requested];
+}
+//# sourceMappingURL=providers.js.map

package/dist/core/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/core/providers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA6B;IAC5D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Thin wrapper around `onnxruntime-web` `InferenceSession` with typed metadata.
+ */
+import type * as ort from "onnxruntime-web";
+/** Anything `InferenceSession.create` accepts. */
+export type ModelSource = string | ArrayBufferLike | Uint8Array;
+export interface OrtSessionOptions {
+    /** Execution providers in preference order. `undefined` uses {@link DEFAULT_PROVIDERS}. */
+    readonly providers?: readonly string[];
+    /** Optional ORT session options forwarded to `InferenceSession.create`. */
+    readonly sessionOptions?: ort.InferenceSession.SessionOptions;
+}
+/**
+ * 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.
+ */
+export declare class OrtSession {
+    private readonly _session;
+    readonly providers: readonly string[];
+    private constructor();
+    /**
+     * Load an ONNX model into an ORT inference session.
+     *
+     * @param model Either a URL string fetched by ORT, or a `Uint8Array`/`ArrayBuffer` containing the model bytes.
+     * @param options Provider list and pass-through `SessionOptions`.
+     * @throws {@link ModelLoadError} if the model cannot be loaded.
+     */
+    static create(model: ModelSource, options?: OrtSessionOptions): Promise<OrtSession>;
+    /** Names of the model's inputs, in declaration order. */
+    get inputNames(): readonly string[];
+    /** Name of the first (and usually only) input. */
+    get inputName(): string;
+    /** Names of the model's outputs, in declaration order. */
+    get outputNames(): readonly string[];
+    /** The underlying `onnxruntime-web` session, for advanced use cases. */
+    get raw(): ort.InferenceSession;
+    /**
+     * Run inference and return all outputs.
+     *
+     * @param feeds Map of input name to `ort.Tensor`. Keys must match {@link inputNames}.
+     * @throws {@link InferenceError} if ORT raises any error during execution.
+     */
+    run(feeds: Record<string, ort.Tensor>): Promise<Record<string, ort.Tensor>>;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/session.js

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

package/dist/core/session.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @ort-vision-sdk/web — high-level TypeScript SDK for browser computer
+ * vision inference with ONNX Runtime Web.
+ */
+export { BoundingBox, Mask, RGBImage, type ClassProbability, type ClassificationResult, type DetectionResult, type SegmentationResult, } from "./types.js";
+export { Boxes, ClassificationResults, DetectionResults, Masks, Probs, SegmentationResults, } from "./results.js";
+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 { DEFAULT_PROVIDERS, resolveProviders } from "./core/providers.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";
+export { type DecodeYoloAnchorsOptions, type DecodeYoloOptions, type DecodeYoloV8AnchorsOptions, type DecodeYoloV8Options, type DecodedAnchors, type DecodedDetection, batchedNms, decodeYolo, decodeYoloAnchors, decodeYoloV8, decodeYoloV8Anchors, nms, } from "./postprocess/detection.js";
+export { type DecodeYoloSegOptions, type DecodeYoloV8SegOptions, type DecodedSegmentation, decodeYoloSeg, decodeYoloV8Seg, } from "./postprocess/segmentation.js";
+export { VisionTask } from "./tasks/base.js";
+export { type ClassifierOptions, type ClassifierPredictOptions, Classifier, } from "./tasks/classifier.js";
+export { type DetectorHead, type DetectorOptions, type DetectorPredictOptions, Detector, } from "./tasks/detector.js";
+export { type SegmenterHead, type SegmenterOptions, type SegmenterPredictOptions, Segmenter, } from "./tasks/segmenter.js";
+export declare const VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}