tempest-react-sdk 0.23.0 → 0.25.0

package/dist/vision/results.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class l{constructor(s,t,i,e){this.xyxy=s,this.cls=t,this.conf=i,this.origShape=e}xyxy;cls;conf;origShape;get length(){return this.cls.length}get shape(){return[this.length,4]}get xywh(){const s=new Float32Array(this.xyxy.length);for(let t=0;t<this.length;t++){const i=this.xyxy[t*4],e=this.xyxy[t*4+1],r=this.xyxy[t*4+2],h=this.xyxy[t*4+3];s[t*4]=(i+r)/2,s[t*4+1]=(e+h)/2,s[t*4+2]=r-i,s[t*4+3]=h-e}return s}get xyxyn(){const[s,t]=this.origShape,i=new Float32Array(this.xyxy.length);if(this.length===0||t<=0||s<=0)return i;for(let e=0;e<this.length;e++)i[e*4]=this.xyxy[e*4]/t,i[e*4+1]=this.xyxy[e*4+1]/s,i[e*4+2]=this.xyxy[e*4+2]/t,i[e*4+3]=this.xyxy[e*4+3]/s;return i}get xywhn(){const s=this.xywh,[t,i]=this.origShape;if(this.length===0||i<=0||t<=0)return s;for(let e=0;e<this.length;e++)s[e*4]=s[e*4]/i,s[e*4+1]=s[e*4+1]/t,s[e*4+2]=s[e*4+2]/i,s[e*4+3]=s[e*4+3]/t;return s}get data(){const s=new Float32Array(this.length*6);for(let t=0;t<this.length;t++)s[t*6]=this.xyxy[t*4],s[t*6+1]=this.xyxy[t*4+1],s[t*6+2]=this.xyxy[t*4+2],s[t*6+3]=this.xyxy[t*4+3],s[t*6+4]=this.conf[t],s[t*6+5]=this.cls[t];return s}}class g{constructor(s){this.data=s}data;get length(){return this.data.length}get shape(){return[this.length]}get top1(){if(this.data.length===0)return 0;let s=0,t=this.data[0];for(let i=1;i<this.data.length;i++){const e=this.data[i];e>t&&(s=i,t=e)}return s}get top1conf(){return this.data.length===0?0:this.data[this.top1]}get top5(){return this._topK(5).indices}get top5conf(){return this._topK(5).values}_topK(s){const t=Math.min(s,this.data.length),i=[];for(let h=0;h<this.data.length;h++)i.push(h);i.sort((h,n)=>this.data[n]-this.data[h]);const e=new Int32Array(t),r=new Float32Array(t);for(let h=0;h<t;h++)e[h]=i[h],r[h]=this.data[i[h]];return{indices:e,values:r}}}class c{constructor(s,t,i){this.data=s,this.xyxy=t,this.origShape=i}data;xyxy;origShape;get length(){return this.data.length}get shape(){return[this.length]}[Symbol.iterator](){return this.data[Symbol.iterator]()}}class u{constructor(s,t,i,e,r,h=null,n={}){this.boxes=s,this.detections=t,this.names=i,this.origImg=e,this.origShape=r,this.path=h,this.speed=n}boxes;detections;names;origImg;origShape;path;speed;get length(){return this.detections.length}get(s){return this.detections[s]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}}class y{constructor(s,t,i,e,r,h=null,n={}){this.probs=s,this.result=t,this.names=i,this.origImg=e,this.origShape=r,this.path=h,this.speed=n}probs;result;names;origImg;origShape;path;speed;get cls(){return this.probs.top1}get conf(){return this.probs.top1conf}get name(){return this.names[this.cls]??`class_${this.cls}`}get probabilities(){return this.result.probabilities}}class x{constructor(s,t,i,e,r,h,n=null,a={}){this.boxes=s,this.masks=t,this.detections=i,this.names=e,this.origImg=r,this.origShape=h,this.path=n,this.speed=a}boxes;masks;detections;names;origImg;origShape;path;speed;get length(){return this.detections.length}get(s){return this.detections[s]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}}exports.Boxes=l;exports.ClassificationResults=y;exports.DetectionResults=u;exports.Masks=c;exports.Probs=g;exports.SegmentationResults=x;
-//# sourceMappingURL=results.cjs.map
+var e=class{xyxy;cls;conf;origShape;constructor(e,t,n,r){this.xyxy=e,this.cls=t,this.conf=n,this.origShape=r}get length(){return this.cls.length}get shape(){return[this.length,4]}get xywh(){let e=new Float32Array(this.xyxy.length);for(let t=0;t<this.length;t++){let n=this.xyxy[t*4],r=this.xyxy[t*4+1],i=this.xyxy[t*4+2],a=this.xyxy[t*4+3];e[t*4]=(n+i)/2,e[t*4+1]=(r+a)/2,e[t*4+2]=i-n,e[t*4+3]=a-r}return e}get xyxyn(){let[e,t]=this.origShape,n=new Float32Array(this.xyxy.length);if(this.length===0||t<=0||e<=0)return n;for(let r=0;r<this.length;r++)n[r*4]=this.xyxy[r*4]/t,n[r*4+1]=this.xyxy[r*4+1]/e,n[r*4+2]=this.xyxy[r*4+2]/t,n[r*4+3]=this.xyxy[r*4+3]/e;return n}get xywhn(){let e=this.xywh,[t,n]=this.origShape;if(this.length===0||n<=0||t<=0)return e;for(let r=0;r<this.length;r++)e[r*4]=e[r*4]/n,e[r*4+1]=e[r*4+1]/t,e[r*4+2]=e[r*4+2]/n,e[r*4+3]=e[r*4+3]/t;return e}get data(){let e=new Float32Array(this.length*6);for(let t=0;t<this.length;t++)e[t*6]=this.xyxy[t*4],e[t*6+1]=this.xyxy[t*4+1],e[t*6+2]=this.xyxy[t*4+2],e[t*6+3]=this.xyxy[t*4+3],e[t*6+4]=this.conf[t],e[t*6+5]=this.cls[t];return e}},t=class{data;constructor(e){this.data=e}get length(){return this.data.length}get shape(){return[this.length]}get top1(){if(this.data.length===0)return 0;let e=0,t=this.data[0];for(let n=1;n<this.data.length;n++){let r=this.data[n];r>t&&(e=n,t=r)}return e}get top1conf(){return this.data.length===0?0:this.data[this.top1]}get top5(){return this._topK(5).indices}get top5conf(){return this._topK(5).values}_topK(e){let t=Math.min(e,this.data.length),n=[];for(let e=0;e<this.data.length;e++)n.push(e);n.sort((e,t)=>this.data[t]-this.data[e]);let r=new Int32Array(t),i=new Float32Array(t);for(let e=0;e<t;e++)r[e]=n[e],i[e]=this.data[n[e]];return{indices:r,values:i}}},n=class{data;xyxy;origShape;constructor(e,t,n){this.data=e,this.xyxy=t,this.origShape=n}get length(){return this.data.length}get shape(){return[this.length]}[Symbol.iterator](){return this.data[Symbol.iterator]()}},r=class{boxes;detections;names;origImg;origShape;path;speed;constructor(e,t,n,r,i,a=null,o={}){this.boxes=e,this.detections=t,this.names=n,this.origImg=r,this.origShape=i,this.path=a,this.speed=o}get length(){return this.detections.length}get(e){return this.detections[e]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}},i=class{probs;result;names;origImg;origShape;path;speed;constructor(e,t,n,r,i,a=null,o={}){this.probs=e,this.result=t,this.names=n,this.origImg=r,this.origShape=i,this.path=a,this.speed=o}get cls(){return this.probs.top1}get conf(){return this.probs.top1conf}get name(){return this.names[this.cls]??`class_${this.cls}`}get probabilities(){return this.result.probabilities}},a=class{boxes;masks;detections;names;origImg;origShape;path;speed;constructor(e,t,n,r,i,a,o=null,s={}){this.boxes=e,this.masks=t,this.detections=n,this.names=r,this.origImg=i,this.origShape=a,this.path=o,this.speed=s}get length(){return this.detections.length}get(e){return this.detections[e]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}};exports.Boxes=e,exports.ClassificationResults=i,exports.DetectionResults=r,exports.Masks=n,exports.Probs=t,exports.SegmentationResults=a;
+//# sourceMappingURL=results.cjs.map

package/dist/vision/results.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"results.cjs","sources":["../../src/vision/results.ts"],"sourcesContent":["/**\n * Per-image result envelopes — Ultralytics-style `Results` for the SDK.\n *\n * Each `predict()` call returns a 1-element array of these envelopes,\n * mirroring `YOLO(\"img.jpg\")`. Each envelope holds:\n *\n * - A bulk-array view of the predictions (`Boxes`, `Probs`, `Masks`) with\n *   the exact attribute names Ultralytics uses (`xyxy`, `xywh`, `xyxyn`,\n *   `xywhn`, `cls`, `conf`, `data`, `top1`, `top5`).\n * - Per-instance dataclasses (`DetectionResult`, `SegmentationResult`,\n *   `ClassProbability`) for callers who prefer the OO interface.\n * - `names`: `Record<number, string>` matching Ultralytics' `model.names`.\n * - `origImg` / `origShape` / `path`: provenance for the original input.\n */\n\nimport {\n    type ClassificationResult,\n    type DetectionResult,\n    type RGBImage,\n    type SegmentationResult,\n} from \"./types\";\n\n/**\n * Bulk numpy-style view of detected boxes for a single image.\n *\n * Mirrors Ultralytics' `Boxes` interface. Coordinates in {@link xyxy} and\n * {@link xywh} are absolute pixels in the original image; the `*n` variants\n * are normalized to `[0, 1]` using `origShape`.\n */\nexport class Boxes {\n    /**\n     * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.\n     * @param cls One class index per box, length `N`.\n     * @param conf One confidence per box, length `N`.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly xyxy: Float32Array,\n        public readonly cls: Int32Array,\n        public readonly conf: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of detected boxes. */\n    get length(): number {\n        return this.cls.length;\n    }\n\n    /** `[N, 4]` shape of the `xyxy` view. */\n    get shape(): readonly [number, number] {\n        return [this.length, 4];\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */\n    get xywh(): Float32Array {\n        const out = new Float32Array(this.xyxy.length);\n        for (let i = 0; i < this.length; i++) {\n            const x1 = this.xyxy[i * 4] as number;\n            const y1 = this.xyxy[i * 4 + 1] as number;\n            const x2 = this.xyxy[i * 4 + 2] as number;\n            const y2 = this.xyxy[i * 4 + 3] as number;\n            out[i * 4] = (x1 + x2) / 2;\n            out[i * 4 + 1] = (y1 + y2) / 2;\n            out[i * 4 + 2] = x2 - x1;\n            out[i * 4 + 3] = y2 - y1;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */\n    get xyxyn(): Float32Array {\n        const [h, w] = this.origShape;\n        const out = new Float32Array(this.xyxy.length);\n        if (this.length === 0 || w <= 0 || h <= 0) return out;\n        for (let i = 0; i < this.length; i++) {\n            out[i * 4] = (this.xyxy[i * 4] as number) / w;\n            out[i * 4 + 1] = (this.xyxy[i * 4 + 1] as number) / h;\n            out[i * 4 + 2] = (this.xyxy[i * 4 + 2] as number) / w;\n            out[i * 4 + 3] = (this.xyxy[i * 4 + 3] as number) / h;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */\n    get xywhn(): Float32Array {\n        const xywh = this.xywh;\n        const [h, w] = this.origShape;\n        if (this.length === 0 || w <= 0 || h <= 0) return xywh;\n        for (let i = 0; i < this.length; i++) {\n            xywh[i * 4] = (xywh[i * 4] as number) / w;\n            xywh[i * 4 + 1] = (xywh[i * 4 + 1] as number) / h;\n            xywh[i * 4 + 2] = (xywh[i * 4 + 2] as number) / w;\n            xywh[i * 4 + 3] = (xywh[i * 4 + 3] as number) / h;\n        }\n        return xywh;\n    }\n\n    /**\n     * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.\n     *\n     * Matches Ultralytics' `boxes.data`.\n     */\n    get data(): Float32Array {\n        const out = new Float32Array(this.length * 6);\n        for (let i = 0; i < this.length; i++) {\n            out[i * 6] = this.xyxy[i * 4] as number;\n            out[i * 6 + 1] = this.xyxy[i * 4 + 1] as number;\n            out[i * 6 + 2] = this.xyxy[i * 4 + 2] as number;\n            out[i * 6 + 3] = this.xyxy[i * 4 + 3] as number;\n            out[i * 6 + 4] = this.conf[i] as number;\n            out[i * 6 + 5] = this.cls[i] as number;\n        }\n        return out;\n    }\n}\n\n/**\n * Top-k classification probabilities for a single image.\n *\n * Mirrors Ultralytics' `Probs` interface.\n */\nexport class Probs {\n    /** @param data `[numClasses]` per-class probabilities, indexed by class id. */\n    constructor(public readonly data: Float32Array) {}\n\n    /** Number of classes. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[numClasses]` shape of the underlying vector. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    /** Index of the most probable class. */\n    get top1(): number {\n        if (this.data.length === 0) return 0;\n        let best = 0;\n        let bestVal = this.data[0] as number;\n        for (let i = 1; i < this.data.length; i++) {\n            const v = this.data[i] as number;\n            if (v > bestVal) {\n                best = i;\n                bestVal = v;\n            }\n        }\n        return best;\n    }\n\n    /** Probability of the top-1 class. */\n    get top1conf(): number {\n        if (this.data.length === 0) return 0;\n        return this.data[this.top1] as number;\n    }\n\n    /** Indices of the top-5 most probable classes, descending. */\n    get top5(): Int32Array {\n        return this._topK(5).indices;\n    }\n\n    /** Probabilities of the top-5 classes, descending. */\n    get top5conf(): Float32Array {\n        return this._topK(5).values;\n    }\n\n    private _topK(k: number): { indices: Int32Array; values: Float32Array } {\n        const n = Math.min(k, this.data.length);\n        const order: number[] = [];\n        for (let i = 0; i < this.data.length; i++) order.push(i);\n        order.sort((a, b) => (this.data[b] as number) - (this.data[a] as number));\n        const indices = new Int32Array(n);\n        const values = new Float32Array(n);\n        for (let i = 0; i < n; i++) {\n            indices[i] = order[i] as number;\n            values[i] = this.data[order[i] as number] as number;\n        }\n        return { indices, values };\n    }\n}\n\n/**\n * Per-instance binary masks for a single image.\n *\n * Each mask is cropped to its instance's bounding box. To paint masks onto\n * a full-image canvas, use `xyxy[i]` as the top-left target.\n */\nexport class Masks {\n    /**\n     * @param data Per-instance binary masks (`Mask` objects from `types.ts`).\n     * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly data: ReadonlyArray<{\n            readonly data: Uint8Array;\n            readonly width: number;\n            readonly height: number;\n        }>,\n        public readonly xyxy: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of instance masks. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[N]` shape of the masks collection. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    [Symbol.iterator](): Iterator<{\n        readonly data: Uint8Array;\n        readonly width: number;\n        readonly height: number;\n    }> {\n        return this.data[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image detection envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link DetectionResult} entries, so legacy\n * code that did `for (const d of detector.predict(img))` only needs an\n * extra `[0]` to bridge:\n *\n * ```typescript\n * for (const d of (await detector.predict(img))[0]) {\n *   console.log(d.cls, d.conf, d.box.xyxy);\n * }\n * ```\n *\n * For numpy-style bulk access, use the `boxes` collection.\n */\nexport class DetectionResults implements Iterable<DetectionResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly detections: readonly DetectionResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving detections. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance detections. */\n    get(index: number): DetectionResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<DetectionResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image classification envelope (Ultralytics-style `Results`).\n */\nexport class ClassificationResults {\n    constructor(\n        public readonly probs: Probs,\n        public readonly result: ClassificationResult,\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Top-1 class index (Ultralytics-style alias). */\n    get cls(): number {\n        return this.probs.top1;\n    }\n\n    /** Top-1 confidence (Ultralytics-style alias). */\n    get conf(): number {\n        return this.probs.top1conf;\n    }\n\n    /** Top-1 class name. */\n    get name(): string {\n        return this.names[this.cls] ?? `class_${this.cls}`;\n    }\n\n    /** Per-class probability list, sorted descending (legacy field). */\n    get probabilities(): readonly ClassificationResult[\"probabilities\"][number][] {\n        return this.result.probabilities;\n    }\n}\n\n/**\n * Per-image instance-segmentation envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link SegmentationResult} entries. `boxes`\n * and `masks` mirror Ultralytics' bulk-array views.\n */\nexport class SegmentationResults implements Iterable<SegmentationResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly masks: Masks,\n        public readonly detections: readonly SegmentationResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving instances. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance results. */\n    get(index: number): SegmentationResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<SegmentationResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n"],"names":["Boxes","xyxy","cls","conf","origShape","out","i","x1","y1","x2","y2","h","w","xywh","Probs","data","best","bestVal","v","k","n","order","a","b","indices","values","Masks","DetectionResults","boxes","detections","names","origImg","path","speed","index","ClassificationResults","probs","result","SegmentationResults","masks"],"mappings":"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"}
+{"version":3,"file":"results.cjs","names":[],"sources":["../../src/vision/results.ts"],"sourcesContent":["/**\n * Per-image result envelopes — Ultralytics-style `Results` for the SDK.\n *\n * Each `predict()` call returns a 1-element array of these envelopes,\n * mirroring `YOLO(\"img.jpg\")`. Each envelope holds:\n *\n * - A bulk-array view of the predictions (`Boxes`, `Probs`, `Masks`) with\n *   the exact attribute names Ultralytics uses (`xyxy`, `xywh`, `xyxyn`,\n *   `xywhn`, `cls`, `conf`, `data`, `top1`, `top5`).\n * - Per-instance dataclasses (`DetectionResult`, `SegmentationResult`,\n *   `ClassProbability`) for callers who prefer the OO interface.\n * - `names`: `Record<number, string>` matching Ultralytics' `model.names`.\n * - `origImg` / `origShape` / `path`: provenance for the original input.\n */\n\nimport {\n    type ClassificationResult,\n    type DetectionResult,\n    type RGBImage,\n    type SegmentationResult,\n} from \"./types\";\n\n/**\n * Bulk numpy-style view of detected boxes for a single image.\n *\n * Mirrors Ultralytics' `Boxes` interface. Coordinates in {@link xyxy} and\n * {@link xywh} are absolute pixels in the original image; the `*n` variants\n * are normalized to `[0, 1]` using `origShape`.\n */\nexport class Boxes {\n    /**\n     * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.\n     * @param cls One class index per box, length `N`.\n     * @param conf One confidence per box, length `N`.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly xyxy: Float32Array,\n        public readonly cls: Int32Array,\n        public readonly conf: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of detected boxes. */\n    get length(): number {\n        return this.cls.length;\n    }\n\n    /** `[N, 4]` shape of the `xyxy` view. */\n    get shape(): readonly [number, number] {\n        return [this.length, 4];\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */\n    get xywh(): Float32Array {\n        const out = new Float32Array(this.xyxy.length);\n        for (let i = 0; i < this.length; i++) {\n            const x1 = this.xyxy[i * 4] as number;\n            const y1 = this.xyxy[i * 4 + 1] as number;\n            const x2 = this.xyxy[i * 4 + 2] as number;\n            const y2 = this.xyxy[i * 4 + 3] as number;\n            out[i * 4] = (x1 + x2) / 2;\n            out[i * 4 + 1] = (y1 + y2) / 2;\n            out[i * 4 + 2] = x2 - x1;\n            out[i * 4 + 3] = y2 - y1;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */\n    get xyxyn(): Float32Array {\n        const [h, w] = this.origShape;\n        const out = new Float32Array(this.xyxy.length);\n        if (this.length === 0 || w <= 0 || h <= 0) return out;\n        for (let i = 0; i < this.length; i++) {\n            out[i * 4] = (this.xyxy[i * 4] as number) / w;\n            out[i * 4 + 1] = (this.xyxy[i * 4 + 1] as number) / h;\n            out[i * 4 + 2] = (this.xyxy[i * 4 + 2] as number) / w;\n            out[i * 4 + 3] = (this.xyxy[i * 4 + 3] as number) / h;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */\n    get xywhn(): Float32Array {\n        const xywh = this.xywh;\n        const [h, w] = this.origShape;\n        if (this.length === 0 || w <= 0 || h <= 0) return xywh;\n        for (let i = 0; i < this.length; i++) {\n            xywh[i * 4] = (xywh[i * 4] as number) / w;\n            xywh[i * 4 + 1] = (xywh[i * 4 + 1] as number) / h;\n            xywh[i * 4 + 2] = (xywh[i * 4 + 2] as number) / w;\n            xywh[i * 4 + 3] = (xywh[i * 4 + 3] as number) / h;\n        }\n        return xywh;\n    }\n\n    /**\n     * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.\n     *\n     * Matches Ultralytics' `boxes.data`.\n     */\n    get data(): Float32Array {\n        const out = new Float32Array(this.length * 6);\n        for (let i = 0; i < this.length; i++) {\n            out[i * 6] = this.xyxy[i * 4] as number;\n            out[i * 6 + 1] = this.xyxy[i * 4 + 1] as number;\n            out[i * 6 + 2] = this.xyxy[i * 4 + 2] as number;\n            out[i * 6 + 3] = this.xyxy[i * 4 + 3] as number;\n            out[i * 6 + 4] = this.conf[i] as number;\n            out[i * 6 + 5] = this.cls[i] as number;\n        }\n        return out;\n    }\n}\n\n/**\n * Top-k classification probabilities for a single image.\n *\n * Mirrors Ultralytics' `Probs` interface.\n */\nexport class Probs {\n    /** @param data `[numClasses]` per-class probabilities, indexed by class id. */\n    constructor(public readonly data: Float32Array) {}\n\n    /** Number of classes. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[numClasses]` shape of the underlying vector. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    /** Index of the most probable class. */\n    get top1(): number {\n        if (this.data.length === 0) return 0;\n        let best = 0;\n        let bestVal = this.data[0] as number;\n        for (let i = 1; i < this.data.length; i++) {\n            const v = this.data[i] as number;\n            if (v > bestVal) {\n                best = i;\n                bestVal = v;\n            }\n        }\n        return best;\n    }\n\n    /** Probability of the top-1 class. */\n    get top1conf(): number {\n        if (this.data.length === 0) return 0;\n        return this.data[this.top1] as number;\n    }\n\n    /** Indices of the top-5 most probable classes, descending. */\n    get top5(): Int32Array {\n        return this._topK(5).indices;\n    }\n\n    /** Probabilities of the top-5 classes, descending. */\n    get top5conf(): Float32Array {\n        return this._topK(5).values;\n    }\n\n    private _topK(k: number): { indices: Int32Array; values: Float32Array } {\n        const n = Math.min(k, this.data.length);\n        const order: number[] = [];\n        for (let i = 0; i < this.data.length; i++) order.push(i);\n        order.sort((a, b) => (this.data[b] as number) - (this.data[a] as number));\n        const indices = new Int32Array(n);\n        const values = new Float32Array(n);\n        for (let i = 0; i < n; i++) {\n            indices[i] = order[i] as number;\n            values[i] = this.data[order[i] as number] as number;\n        }\n        return { indices, values };\n    }\n}\n\n/**\n * Per-instance binary masks for a single image.\n *\n * Each mask is cropped to its instance's bounding box. To paint masks onto\n * a full-image canvas, use `xyxy[i]` as the top-left target.\n */\nexport class Masks {\n    /**\n     * @param data Per-instance binary masks (`Mask` objects from `types.ts`).\n     * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly data: ReadonlyArray<{\n            readonly data: Uint8Array;\n            readonly width: number;\n            readonly height: number;\n        }>,\n        public readonly xyxy: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of instance masks. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[N]` shape of the masks collection. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    [Symbol.iterator](): Iterator<{\n        readonly data: Uint8Array;\n        readonly width: number;\n        readonly height: number;\n    }> {\n        return this.data[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image detection envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link DetectionResult} entries, so legacy\n * code that did `for (const d of detector.predict(img))` only needs an\n * extra `[0]` to bridge:\n *\n * ```typescript\n * for (const d of (await detector.predict(img))[0]) {\n *   console.log(d.cls, d.conf, d.box.xyxy);\n * }\n * ```\n *\n * For numpy-style bulk access, use the `boxes` collection.\n */\nexport class DetectionResults implements Iterable<DetectionResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly detections: readonly DetectionResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving detections. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance detections. */\n    get(index: number): DetectionResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<DetectionResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image classification envelope (Ultralytics-style `Results`).\n */\nexport class ClassificationResults {\n    constructor(\n        public readonly probs: Probs,\n        public readonly result: ClassificationResult,\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Top-1 class index (Ultralytics-style alias). */\n    get cls(): number {\n        return this.probs.top1;\n    }\n\n    /** Top-1 confidence (Ultralytics-style alias). */\n    get conf(): number {\n        return this.probs.top1conf;\n    }\n\n    /** Top-1 class name. */\n    get name(): string {\n        return this.names[this.cls] ?? `class_${this.cls}`;\n    }\n\n    /** Per-class probability list, sorted descending (legacy field). */\n    get probabilities(): readonly ClassificationResult[\"probabilities\"][number][] {\n        return this.result.probabilities;\n    }\n}\n\n/**\n * Per-image instance-segmentation envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link SegmentationResult} entries. `boxes`\n * and `masks` mirror Ultralytics' bulk-array views.\n */\nexport class SegmentationResults implements Iterable<SegmentationResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly masks: Masks,\n        public readonly detections: readonly SegmentationResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving instances. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance results. */\n    get(index: number): SegmentationResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<SegmentationResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n"],"mappings":"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"}

package/dist/vision/results.js

@@ -1,213 +1,165 @@
-class l {
-  /**
-   * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.
-   * @param cls One class index per box, length `N`.
-   * @param conf One confidence per box, length `N`.
-   * @param origShape `[height, width]` of the original image.
-   */
-  constructor(s, t, i, e) {
-    this.xyxy = s, this.cls = t, this.conf = i, this.origShape = e;
-  }
-  xyxy;
-  cls;
-  conf;
-  origShape;
-  /** Number of detected boxes. */
-  get length() {
-    return this.cls.length;
-  }
-  /** `[N, 4]` shape of the `xyxy` view. */
-  get shape() {
-    return [this.length, 4];
-  }
-  /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */
-  get xywh() {
-    const s = new Float32Array(this.xyxy.length);
-    for (let t = 0; t < this.length; t++) {
-      const i = this.xyxy[t * 4], e = this.xyxy[t * 4 + 1], r = this.xyxy[t * 4 + 2], h = this.xyxy[t * 4 + 3];
-      s[t * 4] = (i + r) / 2, s[t * 4 + 1] = (e + h) / 2, s[t * 4 + 2] = r - i, s[t * 4 + 3] = h - e;
-    }
-    return s;
-  }
-  /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */
-  get xyxyn() {
-    const [s, t] = this.origShape, i = new Float32Array(this.xyxy.length);
-    if (this.length === 0 || t <= 0 || s <= 0) return i;
-    for (let e = 0; e < this.length; e++)
-      i[e * 4] = this.xyxy[e * 4] / t, i[e * 4 + 1] = this.xyxy[e * 4 + 1] / s, i[e * 4 + 2] = this.xyxy[e * 4 + 2] / t, i[e * 4 + 3] = this.xyxy[e * 4 + 3] / s;
-    return i;
-  }
-  /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */
-  get xywhn() {
-    const s = this.xywh, [t, i] = this.origShape;
-    if (this.length === 0 || i <= 0 || t <= 0) return s;
-    for (let e = 0; e < this.length; e++)
-      s[e * 4] = s[e * 4] / i, s[e * 4 + 1] = s[e * 4 + 1] / t, s[e * 4 + 2] = s[e * 4 + 2] / i, s[e * 4 + 3] = s[e * 4 + 3] / t;
-    return s;
-  }
-  /**
-   * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.
-   *
-   * Matches Ultralytics' `boxes.data`.
-   */
-  get data() {
-    const s = new Float32Array(this.length * 6);
-    for (let t = 0; t < this.length; t++)
-      s[t * 6] = this.xyxy[t * 4], s[t * 6 + 1] = this.xyxy[t * 4 + 1], s[t * 6 + 2] = this.xyxy[t * 4 + 2], s[t * 6 + 3] = this.xyxy[t * 4 + 3], s[t * 6 + 4] = this.conf[t], s[t * 6 + 5] = this.cls[t];
-    return s;
-  }
-}
-class g {
-  /** @param data `[numClasses]` per-class probabilities, indexed by class id. */
-  constructor(s) {
-    this.data = s;
-  }
-  data;
-  /** Number of classes. */
-  get length() {
-    return this.data.length;
-  }
-  /** `[numClasses]` shape of the underlying vector. */
-  get shape() {
-    return [this.length];
-  }
-  /** Index of the most probable class. */
-  get top1() {
-    if (this.data.length === 0) return 0;
-    let s = 0, t = this.data[0];
-    for (let i = 1; i < this.data.length; i++) {
-      const e = this.data[i];
-      e > t && (s = i, t = e);
-    }
-    return s;
-  }
-  /** Probability of the top-1 class. */
-  get top1conf() {
-    return this.data.length === 0 ? 0 : this.data[this.top1];
-  }
-  /** Indices of the top-5 most probable classes, descending. */
-  get top5() {
-    return this._topK(5).indices;
-  }
-  /** Probabilities of the top-5 classes, descending. */
-  get top5conf() {
-    return this._topK(5).values;
-  }
-  _topK(s) {
-    const t = Math.min(s, this.data.length), i = [];
-    for (let h = 0; h < this.data.length; h++) i.push(h);
-    i.sort((h, n) => this.data[n] - this.data[h]);
-    const e = new Int32Array(t), r = new Float32Array(t);
-    for (let h = 0; h < t; h++)
-      e[h] = i[h], r[h] = this.data[i[h]];
-    return { indices: e, values: r };
-  }
-}
-class c {
-  /**
-   * @param data Per-instance binary masks (`Mask` objects from `types.ts`).
-   * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.
-   * @param origShape `[height, width]` of the original image.
-   */
-  constructor(s, t, i) {
-    this.data = s, this.xyxy = t, this.origShape = i;
-  }
-  data;
-  xyxy;
-  origShape;
-  /** Number of instance masks. */
-  get length() {
-    return this.data.length;
-  }
-  /** `[N]` shape of the masks collection. */
-  get shape() {
-    return [this.length];
-  }
-  [Symbol.iterator]() {
-    return this.data[Symbol.iterator]();
-  }
-}
-class y {
-  constructor(s, t, i, e, r, h = null, n = {}) {
-    this.boxes = s, this.detections = t, this.names = i, this.origImg = e, this.origShape = r, this.path = h, this.speed = n;
-  }
-  boxes;
-  detections;
-  names;
-  origImg;
-  origShape;
-  path;
-  speed;
-  /** Number of surviving detections. */
-  get length() {
-    return this.detections.length;
-  }
-  /** Index into the per-instance detections. */
-  get(s) {
-    return this.detections[s];
-  }
-  [Symbol.iterator]() {
-    return this.detections[Symbol.iterator]();
-  }
-}
-class u {
-  constructor(s, t, i, e, r, h = null, n = {}) {
-    this.probs = s, this.result = t, this.names = i, this.origImg = e, this.origShape = r, this.path = h, this.speed = n;
-  }
-  probs;
-  result;
-  names;
-  origImg;
-  origShape;
-  path;
-  speed;
-  /** Top-1 class index (Ultralytics-style alias). */
-  get cls() {
-    return this.probs.top1;
-  }
-  /** Top-1 confidence (Ultralytics-style alias). */
-  get conf() {
-    return this.probs.top1conf;
-  }
-  /** Top-1 class name. */
-  get name() {
-    return this.names[this.cls] ?? `class_${this.cls}`;
-  }
-  /** Per-class probability list, sorted descending (legacy field). */
-  get probabilities() {
-    return this.result.probabilities;
-  }
-}
-class x {
-  constructor(s, t, i, e, r, h, n = null, a = {}) {
-    this.boxes = s, this.masks = t, this.detections = i, this.names = e, this.origImg = r, this.origShape = h, this.path = n, this.speed = a;
-  }
-  boxes;
-  masks;
-  detections;
-  names;
-  origImg;
-  origShape;
-  path;
-  speed;
-  /** Number of surviving instances. */
-  get length() {
-    return this.detections.length;
-  }
-  /** Index into the per-instance results. */
-  get(s) {
-    return this.detections[s];
-  }
-  [Symbol.iterator]() {
-    return this.detections[Symbol.iterator]();
-  }
-}
-export {
-  l as Boxes,
-  u as ClassificationResults,
-  y as DetectionResults,
-  c as Masks,
-  g as Probs,
-  x as SegmentationResults
+//#region src/vision/results.ts
+var e = class {
+	xyxy;
+	cls;
+	conf;
+	origShape;
+	constructor(e, t, n, r) {
+		this.xyxy = e, this.cls = t, this.conf = n, this.origShape = r;
+	}
+	get length() {
+		return this.cls.length;
+	}
+	get shape() {
+		return [this.length, 4];
+	}
+	get xywh() {
+		let e = new Float32Array(this.xyxy.length);
+		for (let t = 0; t < this.length; t++) {
+			let n = this.xyxy[t * 4], r = this.xyxy[t * 4 + 1], i = this.xyxy[t * 4 + 2], a = this.xyxy[t * 4 + 3];
+			e[t * 4] = (n + i) / 2, e[t * 4 + 1] = (r + a) / 2, e[t * 4 + 2] = i - n, e[t * 4 + 3] = a - r;
+		}
+		return e;
+	}
+	get xyxyn() {
+		let [e, t] = this.origShape, n = new Float32Array(this.xyxy.length);
+		if (this.length === 0 || t <= 0 || e <= 0) return n;
+		for (let r = 0; r < this.length; r++) n[r * 4] = this.xyxy[r * 4] / t, n[r * 4 + 1] = this.xyxy[r * 4 + 1] / e, n[r * 4 + 2] = this.xyxy[r * 4 + 2] / t, n[r * 4 + 3] = this.xyxy[r * 4 + 3] / e;
+		return n;
+	}
+	get xywhn() {
+		let e = this.xywh, [t, n] = this.origShape;
+		if (this.length === 0 || n <= 0 || t <= 0) return e;
+		for (let r = 0; r < this.length; r++) e[r * 4] = e[r * 4] / n, e[r * 4 + 1] = e[r * 4 + 1] / t, e[r * 4 + 2] = e[r * 4 + 2] / n, e[r * 4 + 3] = e[r * 4 + 3] / t;
+		return e;
+	}
+	get data() {
+		let e = new Float32Array(this.length * 6);
+		for (let t = 0; t < this.length; t++) e[t * 6] = this.xyxy[t * 4], e[t * 6 + 1] = this.xyxy[t * 4 + 1], e[t * 6 + 2] = this.xyxy[t * 4 + 2], e[t * 6 + 3] = this.xyxy[t * 4 + 3], e[t * 6 + 4] = this.conf[t], e[t * 6 + 5] = this.cls[t];
+		return e;
+	}
+}, t = class {
+	data;
+	constructor(e) {
+		this.data = e;
+	}
+	get length() {
+		return this.data.length;
+	}
+	get shape() {
+		return [this.length];
+	}
+	get top1() {
+		if (this.data.length === 0) return 0;
+		let e = 0, t = this.data[0];
+		for (let n = 1; n < this.data.length; n++) {
+			let r = this.data[n];
+			r > t && (e = n, t = r);
+		}
+		return e;
+	}
+	get top1conf() {
+		return this.data.length === 0 ? 0 : this.data[this.top1];
+	}
+	get top5() {
+		return this._topK(5).indices;
+	}
+	get top5conf() {
+		return this._topK(5).values;
+	}
+	_topK(e) {
+		let t = Math.min(e, this.data.length), n = [];
+		for (let e = 0; e < this.data.length; e++) n.push(e);
+		n.sort((e, t) => this.data[t] - this.data[e]);
+		let r = new Int32Array(t), i = new Float32Array(t);
+		for (let e = 0; e < t; e++) r[e] = n[e], i[e] = this.data[n[e]];
+		return {
+			indices: r,
+			values: i
+		};
+	}
+}, n = class {
+	data;
+	xyxy;
+	origShape;
+	constructor(e, t, n) {
+		this.data = e, this.xyxy = t, this.origShape = n;
+	}
+	get length() {
+		return this.data.length;
+	}
+	get shape() {
+		return [this.length];
+	}
+	[Symbol.iterator]() {
+		return this.data[Symbol.iterator]();
+	}
+}, r = class {
+	boxes;
+	detections;
+	names;
+	origImg;
+	origShape;
+	path;
+	speed;
+	constructor(e, t, n, r, i, a = null, o = {}) {
+		this.boxes = e, this.detections = t, this.names = n, this.origImg = r, this.origShape = i, this.path = a, this.speed = o;
+	}
+	get length() {
+		return this.detections.length;
+	}
+	get(e) {
+		return this.detections[e];
+	}
+	[Symbol.iterator]() {
+		return this.detections[Symbol.iterator]();
+	}
+}, i = class {
+	probs;
+	result;
+	names;
+	origImg;
+	origShape;
+	path;
+	speed;
+	constructor(e, t, n, r, i, a = null, o = {}) {
+		this.probs = e, this.result = t, this.names = n, this.origImg = r, this.origShape = i, this.path = a, this.speed = o;
+	}
+	get cls() {
+		return this.probs.top1;
+	}
+	get conf() {
+		return this.probs.top1conf;
+	}
+	get name() {
+		return this.names[this.cls] ?? `class_${this.cls}`;
+	}
+	get probabilities() {
+		return this.result.probabilities;
+	}
+}, a = class {
+	boxes;
+	masks;
+	detections;
+	names;
+	origImg;
+	origShape;
+	path;
+	speed;
+	constructor(e, t, n, r, i, a, o = null, s = {}) {
+		this.boxes = e, this.masks = t, this.detections = n, this.names = r, this.origImg = i, this.origShape = a, this.path = o, this.speed = s;
+	}
+	get length() {
+		return this.detections.length;
+	}
+	get(e) {
+		return this.detections[e];
+	}
+	[Symbol.iterator]() {
+		return this.detections[Symbol.iterator]();
+	}
 };
-//# sourceMappingURL=results.js.map
+//#endregion
+export { e as Boxes, i as ClassificationResults, r as DetectionResults, n as Masks, t as Probs, a as SegmentationResults };
+
+//# sourceMappingURL=results.js.map

package/dist/vision/results.js.map

@@ -1 +1 @@
-{"version":3,"file":"results.js","sources":["../../src/vision/results.ts"],"sourcesContent":["/**\n * Per-image result envelopes — Ultralytics-style `Results` for the SDK.\n *\n * Each `predict()` call returns a 1-element array of these envelopes,\n * mirroring `YOLO(\"img.jpg\")`. Each envelope holds:\n *\n * - A bulk-array view of the predictions (`Boxes`, `Probs`, `Masks`) with\n *   the exact attribute names Ultralytics uses (`xyxy`, `xywh`, `xyxyn`,\n *   `xywhn`, `cls`, `conf`, `data`, `top1`, `top5`).\n * - Per-instance dataclasses (`DetectionResult`, `SegmentationResult`,\n *   `ClassProbability`) for callers who prefer the OO interface.\n * - `names`: `Record<number, string>` matching Ultralytics' `model.names`.\n * - `origImg` / `origShape` / `path`: provenance for the original input.\n */\n\nimport {\n    type ClassificationResult,\n    type DetectionResult,\n    type RGBImage,\n    type SegmentationResult,\n} from \"./types\";\n\n/**\n * Bulk numpy-style view of detected boxes for a single image.\n *\n * Mirrors Ultralytics' `Boxes` interface. Coordinates in {@link xyxy} and\n * {@link xywh} are absolute pixels in the original image; the `*n` variants\n * are normalized to `[0, 1]` using `origShape`.\n */\nexport class Boxes {\n    /**\n     * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.\n     * @param cls One class index per box, length `N`.\n     * @param conf One confidence per box, length `N`.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly xyxy: Float32Array,\n        public readonly cls: Int32Array,\n        public readonly conf: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of detected boxes. */\n    get length(): number {\n        return this.cls.length;\n    }\n\n    /** `[N, 4]` shape of the `xyxy` view. */\n    get shape(): readonly [number, number] {\n        return [this.length, 4];\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */\n    get xywh(): Float32Array {\n        const out = new Float32Array(this.xyxy.length);\n        for (let i = 0; i < this.length; i++) {\n            const x1 = this.xyxy[i * 4] as number;\n            const y1 = this.xyxy[i * 4 + 1] as number;\n            const x2 = this.xyxy[i * 4 + 2] as number;\n            const y2 = this.xyxy[i * 4 + 3] as number;\n            out[i * 4] = (x1 + x2) / 2;\n            out[i * 4 + 1] = (y1 + y2) / 2;\n            out[i * 4 + 2] = x2 - x1;\n            out[i * 4 + 3] = y2 - y1;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */\n    get xyxyn(): Float32Array {\n        const [h, w] = this.origShape;\n        const out = new Float32Array(this.xyxy.length);\n        if (this.length === 0 || w <= 0 || h <= 0) return out;\n        for (let i = 0; i < this.length; i++) {\n            out[i * 4] = (this.xyxy[i * 4] as number) / w;\n            out[i * 4 + 1] = (this.xyxy[i * 4 + 1] as number) / h;\n            out[i * 4 + 2] = (this.xyxy[i * 4 + 2] as number) / w;\n            out[i * 4 + 3] = (this.xyxy[i * 4 + 3] as number) / h;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */\n    get xywhn(): Float32Array {\n        const xywh = this.xywh;\n        const [h, w] = this.origShape;\n        if (this.length === 0 || w <= 0 || h <= 0) return xywh;\n        for (let i = 0; i < this.length; i++) {\n            xywh[i * 4] = (xywh[i * 4] as number) / w;\n            xywh[i * 4 + 1] = (xywh[i * 4 + 1] as number) / h;\n            xywh[i * 4 + 2] = (xywh[i * 4 + 2] as number) / w;\n            xywh[i * 4 + 3] = (xywh[i * 4 + 3] as number) / h;\n        }\n        return xywh;\n    }\n\n    /**\n     * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.\n     *\n     * Matches Ultralytics' `boxes.data`.\n     */\n    get data(): Float32Array {\n        const out = new Float32Array(this.length * 6);\n        for (let i = 0; i < this.length; i++) {\n            out[i * 6] = this.xyxy[i * 4] as number;\n            out[i * 6 + 1] = this.xyxy[i * 4 + 1] as number;\n            out[i * 6 + 2] = this.xyxy[i * 4 + 2] as number;\n            out[i * 6 + 3] = this.xyxy[i * 4 + 3] as number;\n            out[i * 6 + 4] = this.conf[i] as number;\n            out[i * 6 + 5] = this.cls[i] as number;\n        }\n        return out;\n    }\n}\n\n/**\n * Top-k classification probabilities for a single image.\n *\n * Mirrors Ultralytics' `Probs` interface.\n */\nexport class Probs {\n    /** @param data `[numClasses]` per-class probabilities, indexed by class id. */\n    constructor(public readonly data: Float32Array) {}\n\n    /** Number of classes. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[numClasses]` shape of the underlying vector. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    /** Index of the most probable class. */\n    get top1(): number {\n        if (this.data.length === 0) return 0;\n        let best = 0;\n        let bestVal = this.data[0] as number;\n        for (let i = 1; i < this.data.length; i++) {\n            const v = this.data[i] as number;\n            if (v > bestVal) {\n                best = i;\n                bestVal = v;\n            }\n        }\n        return best;\n    }\n\n    /** Probability of the top-1 class. */\n    get top1conf(): number {\n        if (this.data.length === 0) return 0;\n        return this.data[this.top1] as number;\n    }\n\n    /** Indices of the top-5 most probable classes, descending. */\n    get top5(): Int32Array {\n        return this._topK(5).indices;\n    }\n\n    /** Probabilities of the top-5 classes, descending. */\n    get top5conf(): Float32Array {\n        return this._topK(5).values;\n    }\n\n    private _topK(k: number): { indices: Int32Array; values: Float32Array } {\n        const n = Math.min(k, this.data.length);\n        const order: number[] = [];\n        for (let i = 0; i < this.data.length; i++) order.push(i);\n        order.sort((a, b) => (this.data[b] as number) - (this.data[a] as number));\n        const indices = new Int32Array(n);\n        const values = new Float32Array(n);\n        for (let i = 0; i < n; i++) {\n            indices[i] = order[i] as number;\n            values[i] = this.data[order[i] as number] as number;\n        }\n        return { indices, values };\n    }\n}\n\n/**\n * Per-instance binary masks for a single image.\n *\n * Each mask is cropped to its instance's bounding box. To paint masks onto\n * a full-image canvas, use `xyxy[i]` as the top-left target.\n */\nexport class Masks {\n    /**\n     * @param data Per-instance binary masks (`Mask` objects from `types.ts`).\n     * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly data: ReadonlyArray<{\n            readonly data: Uint8Array;\n            readonly width: number;\n            readonly height: number;\n        }>,\n        public readonly xyxy: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of instance masks. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[N]` shape of the masks collection. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    [Symbol.iterator](): Iterator<{\n        readonly data: Uint8Array;\n        readonly width: number;\n        readonly height: number;\n    }> {\n        return this.data[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image detection envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link DetectionResult} entries, so legacy\n * code that did `for (const d of detector.predict(img))` only needs an\n * extra `[0]` to bridge:\n *\n * ```typescript\n * for (const d of (await detector.predict(img))[0]) {\n *   console.log(d.cls, d.conf, d.box.xyxy);\n * }\n * ```\n *\n * For numpy-style bulk access, use the `boxes` collection.\n */\nexport class DetectionResults implements Iterable<DetectionResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly detections: readonly DetectionResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving detections. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance detections. */\n    get(index: number): DetectionResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<DetectionResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image classification envelope (Ultralytics-style `Results`).\n */\nexport class ClassificationResults {\n    constructor(\n        public readonly probs: Probs,\n        public readonly result: ClassificationResult,\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Top-1 class index (Ultralytics-style alias). */\n    get cls(): number {\n        return this.probs.top1;\n    }\n\n    /** Top-1 confidence (Ultralytics-style alias). */\n    get conf(): number {\n        return this.probs.top1conf;\n    }\n\n    /** Top-1 class name. */\n    get name(): string {\n        return this.names[this.cls] ?? `class_${this.cls}`;\n    }\n\n    /** Per-class probability list, sorted descending (legacy field). */\n    get probabilities(): readonly ClassificationResult[\"probabilities\"][number][] {\n        return this.result.probabilities;\n    }\n}\n\n/**\n * Per-image instance-segmentation envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link SegmentationResult} entries. `boxes`\n * and `masks` mirror Ultralytics' bulk-array views.\n */\nexport class SegmentationResults implements Iterable<SegmentationResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly masks: Masks,\n        public readonly detections: readonly SegmentationResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving instances. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance results. */\n    get(index: number): SegmentationResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<SegmentationResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n"],"names":["Boxes","xyxy","cls","conf","origShape","out","i","x1","y1","x2","y2","h","w","xywh","Probs","data","best","bestVal","v","k","n","order","a","b","indices","values","Masks","DetectionResults","boxes","detections","names","origImg","path","speed","index","ClassificationResults","probs","result","SegmentationResults","masks"],"mappings":"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"}
+{"version":3,"file":"results.js","names":[],"sources":["../../src/vision/results.ts"],"sourcesContent":["/**\n * Per-image result envelopes — Ultralytics-style `Results` for the SDK.\n *\n * Each `predict()` call returns a 1-element array of these envelopes,\n * mirroring `YOLO(\"img.jpg\")`. Each envelope holds:\n *\n * - A bulk-array view of the predictions (`Boxes`, `Probs`, `Masks`) with\n *   the exact attribute names Ultralytics uses (`xyxy`, `xywh`, `xyxyn`,\n *   `xywhn`, `cls`, `conf`, `data`, `top1`, `top5`).\n * - Per-instance dataclasses (`DetectionResult`, `SegmentationResult`,\n *   `ClassProbability`) for callers who prefer the OO interface.\n * - `names`: `Record<number, string>` matching Ultralytics' `model.names`.\n * - `origImg` / `origShape` / `path`: provenance for the original input.\n */\n\nimport {\n    type ClassificationResult,\n    type DetectionResult,\n    type RGBImage,\n    type SegmentationResult,\n} from \"./types\";\n\n/**\n * Bulk numpy-style view of detected boxes for a single image.\n *\n * Mirrors Ultralytics' `Boxes` interface. Coordinates in {@link xyxy} and\n * {@link xywh} are absolute pixels in the original image; the `*n` variants\n * are normalized to `[0, 1]` using `origShape`.\n */\nexport class Boxes {\n    /**\n     * @param xyxy Flat array of length `4 * N` in `[x1, y1, x2, y2, ...]` order.\n     * @param cls One class index per box, length `N`.\n     * @param conf One confidence per box, length `N`.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly xyxy: Float32Array,\n        public readonly cls: Int32Array,\n        public readonly conf: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of detected boxes. */\n    get length(): number {\n        return this.cls.length;\n    }\n\n    /** `[N, 4]` shape of the `xyxy` view. */\n    get shape(): readonly [number, number] {\n        return [this.length, 4];\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` flat array in absolute pixels. */\n    get xywh(): Float32Array {\n        const out = new Float32Array(this.xyxy.length);\n        for (let i = 0; i < this.length; i++) {\n            const x1 = this.xyxy[i * 4] as number;\n            const y1 = this.xyxy[i * 4 + 1] as number;\n            const x2 = this.xyxy[i * 4 + 2] as number;\n            const y2 = this.xyxy[i * 4 + 3] as number;\n            out[i * 4] = (x1 + x2) / 2;\n            out[i * 4 + 1] = (y1 + y2) / 2;\n            out[i * 4 + 2] = x2 - x1;\n            out[i * 4 + 3] = y2 - y1;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[x1, y1, x2, y2]` normalized to `[0, 1]`. */\n    get xyxyn(): Float32Array {\n        const [h, w] = this.origShape;\n        const out = new Float32Array(this.xyxy.length);\n        if (this.length === 0 || w <= 0 || h <= 0) return out;\n        for (let i = 0; i < this.length; i++) {\n            out[i * 4] = (this.xyxy[i * 4] as number) / w;\n            out[i * 4 + 1] = (this.xyxy[i * 4 + 1] as number) / h;\n            out[i * 4 + 2] = (this.xyxy[i * 4 + 2] as number) / w;\n            out[i * 4 + 3] = (this.xyxy[i * 4 + 3] as number) / h;\n        }\n        return out;\n    }\n\n    /** Boxes as `[N, 4]` `[cx, cy, w, h]` normalized to `[0, 1]`. */\n    get xywhn(): Float32Array {\n        const xywh = this.xywh;\n        const [h, w] = this.origShape;\n        if (this.length === 0 || w <= 0 || h <= 0) return xywh;\n        for (let i = 0; i < this.length; i++) {\n            xywh[i * 4] = (xywh[i * 4] as number) / w;\n            xywh[i * 4 + 1] = (xywh[i * 4 + 1] as number) / h;\n            xywh[i * 4 + 2] = (xywh[i * 4 + 2] as number) / w;\n            xywh[i * 4 + 3] = (xywh[i * 4 + 3] as number) / h;\n        }\n        return xywh;\n    }\n\n    /**\n     * Concatenated `[N, 6]` array of `[x1, y1, x2, y2, conf, cls]`.\n     *\n     * Matches Ultralytics' `boxes.data`.\n     */\n    get data(): Float32Array {\n        const out = new Float32Array(this.length * 6);\n        for (let i = 0; i < this.length; i++) {\n            out[i * 6] = this.xyxy[i * 4] as number;\n            out[i * 6 + 1] = this.xyxy[i * 4 + 1] as number;\n            out[i * 6 + 2] = this.xyxy[i * 4 + 2] as number;\n            out[i * 6 + 3] = this.xyxy[i * 4 + 3] as number;\n            out[i * 6 + 4] = this.conf[i] as number;\n            out[i * 6 + 5] = this.cls[i] as number;\n        }\n        return out;\n    }\n}\n\n/**\n * Top-k classification probabilities for a single image.\n *\n * Mirrors Ultralytics' `Probs` interface.\n */\nexport class Probs {\n    /** @param data `[numClasses]` per-class probabilities, indexed by class id. */\n    constructor(public readonly data: Float32Array) {}\n\n    /** Number of classes. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[numClasses]` shape of the underlying vector. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    /** Index of the most probable class. */\n    get top1(): number {\n        if (this.data.length === 0) return 0;\n        let best = 0;\n        let bestVal = this.data[0] as number;\n        for (let i = 1; i < this.data.length; i++) {\n            const v = this.data[i] as number;\n            if (v > bestVal) {\n                best = i;\n                bestVal = v;\n            }\n        }\n        return best;\n    }\n\n    /** Probability of the top-1 class. */\n    get top1conf(): number {\n        if (this.data.length === 0) return 0;\n        return this.data[this.top1] as number;\n    }\n\n    /** Indices of the top-5 most probable classes, descending. */\n    get top5(): Int32Array {\n        return this._topK(5).indices;\n    }\n\n    /** Probabilities of the top-5 classes, descending. */\n    get top5conf(): Float32Array {\n        return this._topK(5).values;\n    }\n\n    private _topK(k: number): { indices: Int32Array; values: Float32Array } {\n        const n = Math.min(k, this.data.length);\n        const order: number[] = [];\n        for (let i = 0; i < this.data.length; i++) order.push(i);\n        order.sort((a, b) => (this.data[b] as number) - (this.data[a] as number));\n        const indices = new Int32Array(n);\n        const values = new Float32Array(n);\n        for (let i = 0; i < n; i++) {\n            indices[i] = order[i] as number;\n            values[i] = this.data[order[i] as number] as number;\n        }\n        return { indices, values };\n    }\n}\n\n/**\n * Per-instance binary masks for a single image.\n *\n * Each mask is cropped to its instance's bounding box. To paint masks onto\n * a full-image canvas, use `xyxy[i]` as the top-left target.\n */\nexport class Masks {\n    /**\n     * @param data Per-instance binary masks (`Mask` objects from `types.ts`).\n     * @param xyxy Flat `[N, 4]` of bounding-box coordinates in original pixels.\n     * @param origShape `[height, width]` of the original image.\n     */\n    constructor(\n        public readonly data: ReadonlyArray<{\n            readonly data: Uint8Array;\n            readonly width: number;\n            readonly height: number;\n        }>,\n        public readonly xyxy: Float32Array,\n        public readonly origShape: readonly [number, number],\n    ) {}\n\n    /** Number of instance masks. */\n    get length(): number {\n        return this.data.length;\n    }\n\n    /** `[N]` shape of the masks collection. */\n    get shape(): readonly [number] {\n        return [this.length];\n    }\n\n    [Symbol.iterator](): Iterator<{\n        readonly data: Uint8Array;\n        readonly width: number;\n        readonly height: number;\n    }> {\n        return this.data[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image detection envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link DetectionResult} entries, so legacy\n * code that did `for (const d of detector.predict(img))` only needs an\n * extra `[0]` to bridge:\n *\n * ```typescript\n * for (const d of (await detector.predict(img))[0]) {\n *   console.log(d.cls, d.conf, d.box.xyxy);\n * }\n * ```\n *\n * For numpy-style bulk access, use the `boxes` collection.\n */\nexport class DetectionResults implements Iterable<DetectionResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly detections: readonly DetectionResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving detections. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance detections. */\n    get(index: number): DetectionResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<DetectionResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n\n/**\n * Per-image classification envelope (Ultralytics-style `Results`).\n */\nexport class ClassificationResults {\n    constructor(\n        public readonly probs: Probs,\n        public readonly result: ClassificationResult,\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Top-1 class index (Ultralytics-style alias). */\n    get cls(): number {\n        return this.probs.top1;\n    }\n\n    /** Top-1 confidence (Ultralytics-style alias). */\n    get conf(): number {\n        return this.probs.top1conf;\n    }\n\n    /** Top-1 class name. */\n    get name(): string {\n        return this.names[this.cls] ?? `class_${this.cls}`;\n    }\n\n    /** Per-class probability list, sorted descending (legacy field). */\n    get probabilities(): readonly ClassificationResult[\"probabilities\"][number][] {\n        return this.result.probabilities;\n    }\n}\n\n/**\n * Per-image instance-segmentation envelope (Ultralytics-style `Results`).\n *\n * Iterating yields per-instance {@link SegmentationResult} entries. `boxes`\n * and `masks` mirror Ultralytics' bulk-array views.\n */\nexport class SegmentationResults implements Iterable<SegmentationResult> {\n    constructor(\n        public readonly boxes: Boxes,\n        public readonly masks: Masks,\n        public readonly detections: readonly SegmentationResult[],\n        public readonly names: Readonly<Record<number, string>>,\n        public readonly origImg: RGBImage,\n        public readonly origShape: readonly [number, number],\n        public readonly path: string | null = null,\n        public readonly speed: Readonly<Record<string, number>> = {},\n    ) {}\n\n    /** Number of surviving instances. */\n    get length(): number {\n        return this.detections.length;\n    }\n\n    /** Index into the per-instance results. */\n    get(index: number): SegmentationResult | undefined {\n        return this.detections[index];\n    }\n\n    [Symbol.iterator](): Iterator<SegmentationResult> {\n        return this.detections[Symbol.iterator]();\n    }\n}\n"],"mappings":"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"}

package/dist/vision/tasks/base.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class e{constructor(s){this._session=s}_session;get session(){return this._session}}exports.VisionTask=e;
-//# sourceMappingURL=base.cjs.map
+var e=class{_session;constructor(e){this._session=e}get session(){return this._session}};exports.VisionTask=e;
+//# sourceMappingURL=base.cjs.map

package/dist/vision/tasks/base.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base.cjs","sources":["../../../src/vision/tasks/base.ts"],"sourcesContent":["/**\n * Common foundation for task-oriented vision SDK objects.\n *\n * The base only owns the {@link OrtSession} — label resolution lives in each\n * subclass because how `numClasses` is read from the model differs per task.\n */\n\nimport type { OrtSession } from \"../core/session\";\n\nexport abstract class VisionTask {\n    protected constructor(protected readonly _session: OrtSession) {}\n\n    /** The underlying {@link OrtSession} used to run inference. */\n    get session(): OrtSession {\n        return this._session;\n    }\n}\n"],"names":["VisionTask","_session"],"mappings":"gFASO,MAAeA,CAAW,CACnB,YAA+BC,EAAsB,CAAtB,KAAA,SAAAA,CAAuB,CAAvB,SAGzC,IAAI,SAAsB,CACtB,OAAO,KAAK,QAChB,CACJ"}
+{"version":3,"file":"base.cjs","names":[],"sources":["../../../src/vision/tasks/base.ts"],"sourcesContent":["/**\n * Common foundation for task-oriented vision SDK objects.\n *\n * The base only owns the {@link OrtSession} — label resolution lives in each\n * subclass because how `numClasses` is read from the model differs per task.\n */\n\nimport type { OrtSession } from \"../core/session\";\n\nexport abstract class VisionTask {\n    protected constructor(protected readonly _session: OrtSession) {}\n\n    /** The underlying {@link OrtSession} used to run inference. */\n    get session(): OrtSession {\n        return this._session;\n    }\n}\n"],"mappings":"AASA,IAAsB,EAAtB,KAAiC,CACY,SAAzC,YAAsB,EAAyC,CAAtB,KAAA,SAAA,CAAuB,CAGhE,IAAI,SAAsB,CACtB,OAAO,KAAK,QAChB,CACJ"}

package/dist/vision/tasks/base.js

@@ -1,14 +1,14 @@
-class o {
-  constructor(s) {
-    this._session = s;
-  }
-  _session;
-  /** The underlying {@link OrtSession} used to run inference. */
-  get session() {
-    return this._session;
-  }
-}
-export {
-  o as VisionTask
+//#region src/vision/tasks/base.ts
+var e = class {
+	_session;
+	constructor(e) {
+		this._session = e;
+	}
+	get session() {
+		return this._session;
+	}
 };
-//# sourceMappingURL=base.js.map
+//#endregion
+export { e as VisionTask };
+
+//# sourceMappingURL=base.js.map

package/dist/vision/tasks/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sources":["../../../src/vision/tasks/base.ts"],"sourcesContent":["/**\n * Common foundation for task-oriented vision SDK objects.\n *\n * The base only owns the {@link OrtSession} — label resolution lives in each\n * subclass because how `numClasses` is read from the model differs per task.\n */\n\nimport type { OrtSession } from \"../core/session\";\n\nexport abstract class VisionTask {\n    protected constructor(protected readonly _session: OrtSession) {}\n\n    /** The underlying {@link OrtSession} used to run inference. */\n    get session(): OrtSession {\n        return this._session;\n    }\n}\n"],"names":["VisionTask","_session"],"mappings":"AASO,MAAeA,EAAW;AAAA,EACnB,YAA+BC,GAAsB;AAAtB,SAAA,WAAAA;AAAA,EAAuB;AAAA,EAAvB;AAAA;AAAA,EAGzC,IAAI,UAAsB;AACtB,WAAO,KAAK;AAAA,EAChB;AACJ;"}
+{"version":3,"file":"base.js","names":[],"sources":["../../../src/vision/tasks/base.ts"],"sourcesContent":["/**\n * Common foundation for task-oriented vision SDK objects.\n *\n * The base only owns the {@link OrtSession} — label resolution lives in each\n * subclass because how `numClasses` is read from the model differs per task.\n */\n\nimport type { OrtSession } from \"../core/session\";\n\nexport abstract class VisionTask {\n    protected constructor(protected readonly _session: OrtSession) {}\n\n    /** The underlying {@link OrtSession} used to run inference. */\n    get session(): OrtSession {\n        return this._session;\n    }\n}\n"],"mappings":";AASA,IAAsB,IAAtB,MAAiC;CACY;CAAzC,YAAsB,GAAyC;EAAtB,KAAA,WAAA;CAAuB;CAGhE,IAAI,UAAsB;EACtB,OAAO,KAAK;CAChB;AACJ"}