tempest-react-sdk 0.23.0 → 0.25.0

package/dist/vision/labels.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"labels.cjs","sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"names":["COCO_CLASSES","PRESETS","resolveLabels","spec","options","labels","resolve","LabelMapError","numClasses","_","i","preset","map","ids","k","maxId"],"mappings":"yHAwBaA,EAAkC,OAAO,OAAO,CACzD,SACA,UACA,MACA,aACA,WACA,MACA,QACA,QACA,OACA,gBACA,eACA,YACA,gBACA,QACA,OACA,MACA,MACA,QACA,QACA,MACA,WACA,OACA,QACA,UACA,WACA,WACA,UACA,MACA,WACA,UACA,OACA,YACA,cACA,OACA,eACA,iBACA,aACA,YACA,gBACA,SACA,aACA,MACA,OACA,QACA,QACA,OACA,SACA,QACA,WACA,SACA,WACA,SACA,UACA,QACA,QACA,OACA,QACA,QACA,eACA,MACA,eACA,SACA,KACA,SACA,QACA,SACA,WACA,aACA,YACA,OACA,UACA,OACA,eACA,OACA,QACA,OACA,WACA,aACA,aACA,YACJ,CAAC,EAEKC,EAAuD,CACzD,KAAMD,CACV,EAkBO,SAASE,EACZC,EACAC,EAAgC,GACf,CACjB,MAAMC,EAASC,EAAQH,EAAMC,EAAQ,UAAU,EAC/C,GAAIA,EAAQ,aAAe,QAAaC,EAAO,SAAWD,EAAQ,WAC9D,MAAM,IAAIG,EAAAA,cACN,YAAYF,EAAO,MAAM,6BAA6BD,EAAQ,UAAU,WAAA,EAGhF,OAAOC,CACX,CAEA,SAASC,EAAQH,EAAiBK,EAAmD,CACjF,GAAIL,GAAS,KAA4B,CACrC,GAAIK,IAAe,OACf,MAAM,IAAID,EAAAA,cACN,6FAAA,EAGR,OAAO,MAAM,KAAK,CAAE,OAAQC,CAAA,EAAc,CAACC,EAAGC,IAAM,SAASA,CAAC,EAAE,CACpE,CAEA,GAAI,MAAM,QAAQP,CAAI,EAClB,MAAO,CAAC,GAAGA,CAAI,EAGnB,GAAI,OAAOA,GAAS,SAAU,CAC1B,MAAMQ,EAASV,EAAQE,CAAI,EAC3B,GAAIQ,IAAW,OACX,OAAOA,EAEX,MAAM,IAAIJ,EAAAA,cACN,0BAA0B,KAAK,UAAUJ,CAAI,CAAC,oBAAoB,OAAO,KAAKF,CAAO,EAAE,KAAK,IAAI,CAAC,GAAA,CAEzG,CAEA,GAAI,OAAOE,GAAS,SAAU,CAC1B,MAAMS,EAAMT,EACNU,EAAM,OAAO,KAAKD,CAAG,EAAE,IAAKE,GAAM,OAAOA,CAAC,CAAC,EACjD,GAAID,EAAI,SAAW,EACf,MAAO,CAAA,EAEX,MAAME,EAAQ,KAAK,IAAI,GAAGF,CAAG,EAC7B,OAAO,MAAM,KAAK,CAAE,OAAQE,EAAQ,CAAA,EAAK,CAACN,EAAGC,IAAME,EAAIF,CAAC,GAAK,SAASA,CAAC,EAAE,CAC7E,CAEA,MAAM,IAAIH,EAAAA,cAAc,iCAAiC,OAAOJ,CAAI,GAAG,CAC3E"}
+{"version":3,"file":"labels.cjs","names":[],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"mappings":"yCAwBA,IAAa,EAAkC,OAAO,OAAO,wnBAiF7D,CAAC,EAEK,EAAuD,CACzD,KAAM,CACV,EAkBA,SAAgB,EACZ,EACA,EAAgC,CAAC,EAChB,CACjB,IAAM,EAAS,EAAQ,EAAM,EAAQ,UAAU,EAC/C,GAAI,EAAQ,aAAe,IAAA,IAAa,EAAO,SAAW,EAAQ,WAC9D,MAAM,IAAI,EAAA,cACN,YAAY,EAAO,OAAO,4BAA4B,EAAQ,WAAW,UAC7E,EAEJ,OAAO,CACX,CAEA,SAAS,EAAQ,EAAiB,EAAmD,CACjF,GAAI,GAAS,KAA4B,CACrC,GAAI,IAAe,IAAA,GACf,MAAM,IAAI,EAAA,cACN,6FACJ,EAEJ,OAAO,MAAM,KAAK,CAAE,OAAQ,CAAW,GAAI,EAAG,IAAM,SAAS,GAAG,CACpE,CAEA,GAAI,MAAM,QAAQ,CAAI,EAClB,MAAO,CAAC,GAAG,CAAI,EAGnB,GAAI,OAAO,GAAS,SAAU,CAC1B,IAAM,EAAS,EAAQ,GACvB,GAAI,IAAW,IAAA,GACX,OAAO,EAEX,MAAM,IAAI,EAAA,cACN,0BAA0B,KAAK,UAAU,CAAI,EAAE,mBAAmB,OAAO,KAAK,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG,CACJ,CAEA,GAAI,OAAO,GAAS,SAAU,CAC1B,IAAM,EAAM,EACN,EAAM,OAAO,KAAK,CAAG,CAAC,CAAC,IAAK,GAAM,OAAO,CAAC,CAAC,EACjD,GAAI,EAAI,SAAW,EACf,MAAO,CAAC,EAEZ,IAAM,EAAQ,KAAK,IAAI,GAAG,CAAG,EAC7B,OAAO,MAAM,KAAK,CAAE,OAAQ,EAAQ,CAAE,GAAI,EAAG,IAAM,EAAI,IAAM,SAAS,GAAG,CAC7E,CAEA,MAAM,IAAI,EAAA,cAAc,iCAAiC,OAAO,EAAK,EAAE,CAC3E"}

package/dist/vision/labels.js

@@ -1,125 +1,31 @@
-import { LabelMapError as o } from "./core/exceptions.js";
-const b = Object.freeze([
-  "person",
-  "bicycle",
-  "car",
-  "motorcycle",
-  "airplane",
-  "bus",
-  "train",
-  "truck",
-  "boat",
-  "traffic light",
-  "fire hydrant",
-  "stop sign",
-  "parking meter",
-  "bench",
-  "bird",
-  "cat",
-  "dog",
-  "horse",
-  "sheep",
-  "cow",
-  "elephant",
-  "bear",
-  "zebra",
-  "giraffe",
-  "backpack",
-  "umbrella",
-  "handbag",
-  "tie",
-  "suitcase",
-  "frisbee",
-  "skis",
-  "snowboard",
-  "sports ball",
-  "kite",
-  "baseball bat",
-  "baseball glove",
-  "skateboard",
-  "surfboard",
-  "tennis racket",
-  "bottle",
-  "wine glass",
-  "cup",
-  "fork",
-  "knife",
-  "spoon",
-  "bowl",
-  "banana",
-  "apple",
-  "sandwich",
-  "orange",
-  "broccoli",
-  "carrot",
-  "hot dog",
-  "pizza",
-  "donut",
-  "cake",
-  "chair",
-  "couch",
-  "potted plant",
-  "bed",
-  "dining table",
-  "toilet",
-  "tv",
-  "laptop",
-  "mouse",
-  "remote",
-  "keyboard",
-  "cell phone",
-  "microwave",
-  "oven",
-  "toaster",
-  "sink",
-  "refrigerator",
-  "book",
-  "clock",
-  "vase",
-  "scissors",
-  "teddy bear",
-  "hair drier",
-  "toothbrush"
-]), l = {
-  coco: b
-};
-function f(e, t = {}) {
-  const r = c(e, t.numClasses);
-  if (t.numClasses !== void 0 && r.length !== t.numClasses)
-    throw new o(
-      `Resolved ${r.length} labels but the model has ${t.numClasses} classes.`
-    );
-  return r;
+import { LabelMapError as e } from "./core/exceptions.js";
+//#region src/vision/labels.ts
+var t = Object.freeze(/* @__PURE__ */ "person.bicycle.car.motorcycle.airplane.bus.train.truck.boat.traffic light.fire hydrant.stop sign.parking meter.bench.bird.cat.dog.horse.sheep.cow.elephant.bear.zebra.giraffe.backpack.umbrella.handbag.tie.suitcase.frisbee.skis.snowboard.sports ball.kite.baseball bat.baseball glove.skateboard.surfboard.tennis racket.bottle.wine glass.cup.fork.knife.spoon.bowl.banana.apple.sandwich.orange.broccoli.carrot.hot dog.pizza.donut.cake.chair.couch.potted plant.bed.dining table.toilet.tv.laptop.mouse.remote.keyboard.cell phone.microwave.oven.toaster.sink.refrigerator.book.clock.vase.scissors.teddy bear.hair drier.toothbrush".split(".")), n = { coco: t };
+function r(t, n = {}) {
+	let r = i(t, n.numClasses);
+	if (n.numClasses !== void 0 && r.length !== n.numClasses) throw new e(`Resolved ${r.length} labels but the model has ${n.numClasses} classes.`);
+	return r;
 }
-function c(e, t) {
-  if (e == null) {
-    if (t === void 0)
-      throw new o(
-        "Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses."
-      );
-    return Array.from({ length: t }, (r, a) => `class_${a}`);
-  }
-  if (Array.isArray(e))
-    return [...e];
-  if (typeof e == "string") {
-    const r = l[e];
-    if (r !== void 0)
-      return r;
-    throw new o(
-      `Unknown labels preset: ${JSON.stringify(e)}. Known presets: ${Object.keys(l).join(", ")}.`
-    );
-  }
-  if (typeof e == "object") {
-    const r = e, a = Object.keys(r).map((s) => Number(s));
-    if (a.length === 0)
-      return [];
-    const i = Math.max(...a);
-    return Array.from({ length: i + 1 }, (s, n) => r[n] ?? `class_${n}`);
-  }
-  throw new o(`Unsupported labels spec type: ${typeof e}.`);
+function i(t, r) {
+	if (t == null) {
+		if (r === void 0) throw new e("Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.");
+		return Array.from({ length: r }, (e, t) => `class_${t}`);
+	}
+	if (Array.isArray(t)) return [...t];
+	if (typeof t == "string") {
+		let r = n[t];
+		if (r !== void 0) return r;
+		throw new e(`Unknown labels preset: ${JSON.stringify(t)}. Known presets: ${Object.keys(n).join(", ")}.`);
+	}
+	if (typeof t == "object") {
+		let e = t, n = Object.keys(e).map((e) => Number(e));
+		if (n.length === 0) return [];
+		let r = Math.max(...n);
+		return Array.from({ length: r + 1 }, (t, n) => e[n] ?? `class_${n}`);
+	}
+	throw new e(`Unsupported labels spec type: ${typeof t}.`);
 }
-export {
-  b as COCO_CLASSES,
-  f as resolveLabels
-};
-//# sourceMappingURL=labels.js.map
+//#endregion
+export { t as COCO_CLASSES, r as resolveLabels };
+
+//# sourceMappingURL=labels.js.map

package/dist/vision/labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"labels.js","sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"names":["COCO_CLASSES","PRESETS","resolveLabels","spec","options","labels","resolve","LabelMapError","numClasses","_","i","preset","map","ids","k","maxId"],"mappings":";AAwBO,MAAMA,IAAkC,OAAO,OAAO;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC,GAEKC,IAAuD;AAAA,EACzD,MAAMD;AACV;AAkBO,SAASE,EACZC,GACAC,IAAgC,IACf;AACjB,QAAMC,IAASC,EAAQH,GAAMC,EAAQ,UAAU;AAC/C,MAAIA,EAAQ,eAAe,UAAaC,EAAO,WAAWD,EAAQ;AAC9D,UAAM,IAAIG;AAAA,MACN,YAAYF,EAAO,MAAM,6BAA6BD,EAAQ,UAAU;AAAA,IAAA;AAGhF,SAAOC;AACX;AAEA,SAASC,EAAQH,GAAiBK,GAAmD;AACjF,MAAIL,KAAS,MAA4B;AACrC,QAAIK,MAAe;AACf,YAAM,IAAID;AAAA,QACN;AAAA,MAAA;AAGR,WAAO,MAAM,KAAK,EAAE,QAAQC,EAAA,GAAc,CAACC,GAAGC,MAAM,SAASA,CAAC,EAAE;AAAA,EACpE;AAEA,MAAI,MAAM,QAAQP,CAAI;AAClB,WAAO,CAAC,GAAGA,CAAI;AAGnB,MAAI,OAAOA,KAAS,UAAU;AAC1B,UAAMQ,IAASV,EAAQE,CAAI;AAC3B,QAAIQ,MAAW;AACX,aAAOA;AAEX,UAAM,IAAIJ;AAAA,MACN,0BAA0B,KAAK,UAAUJ,CAAI,CAAC,oBAAoB,OAAO,KAAKF,CAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAEzG;AAEA,MAAI,OAAOE,KAAS,UAAU;AAC1B,UAAMS,IAAMT,GACNU,IAAM,OAAO,KAAKD,CAAG,EAAE,IAAI,CAACE,MAAM,OAAOA,CAAC,CAAC;AACjD,QAAID,EAAI,WAAW;AACf,aAAO,CAAA;AAEX,UAAME,IAAQ,KAAK,IAAI,GAAGF,CAAG;AAC7B,WAAO,MAAM,KAAK,EAAE,QAAQE,IAAQ,EAAA,GAAK,CAACN,GAAGC,MAAME,EAAIF,CAAC,KAAK,SAASA,CAAC,EAAE;AAAA,EAC7E;AAEA,QAAM,IAAIH,EAAc,iCAAiC,OAAOJ,CAAI,GAAG;AAC3E;"}
+{"version":3,"file":"labels.js","names":[],"sources":["../../src/vision/labels.ts"],"sourcesContent":["/**\n * Class label resolution: presets, lists, dicts, or auto-generated.\n *\n * Tasks call {@link resolveLabels} once at construction time to turn whatever\n * the caller passed (preset name, array, dict, or `null`) into an ordered\n * array of class names indexed by class id.\n *\n * In the browser there is no filesystem, so this module does not load labels\n * from a path — fetch the file yourself and pass an array.\n */\n\nimport { LabelMapError } from \"./core/exceptions\";\n\n/**\n * Anything accepted by {@link resolveLabels}.\n *\n * - `string[]` / `readonly string[]`: explicit names indexed by class id.\n * - `Record<number, string>`: sparse mapping (gaps filled with `class_<id>`).\n * - `string`: a preset name (e.g. `\"coco\"`).\n * - `null` / `undefined`: auto-generate `class_0` ... `class_{numClasses-1}`.\n */\nexport type LabelSpec = readonly string[] | Record<number, string> | string | null | undefined;\n\n/** COCO 2017 80-class labels in canonical class-id order. */\nexport const COCO_CLASSES: readonly string[] = Object.freeze([\n    \"person\",\n    \"bicycle\",\n    \"car\",\n    \"motorcycle\",\n    \"airplane\",\n    \"bus\",\n    \"train\",\n    \"truck\",\n    \"boat\",\n    \"traffic light\",\n    \"fire hydrant\",\n    \"stop sign\",\n    \"parking meter\",\n    \"bench\",\n    \"bird\",\n    \"cat\",\n    \"dog\",\n    \"horse\",\n    \"sheep\",\n    \"cow\",\n    \"elephant\",\n    \"bear\",\n    \"zebra\",\n    \"giraffe\",\n    \"backpack\",\n    \"umbrella\",\n    \"handbag\",\n    \"tie\",\n    \"suitcase\",\n    \"frisbee\",\n    \"skis\",\n    \"snowboard\",\n    \"sports ball\",\n    \"kite\",\n    \"baseball bat\",\n    \"baseball glove\",\n    \"skateboard\",\n    \"surfboard\",\n    \"tennis racket\",\n    \"bottle\",\n    \"wine glass\",\n    \"cup\",\n    \"fork\",\n    \"knife\",\n    \"spoon\",\n    \"bowl\",\n    \"banana\",\n    \"apple\",\n    \"sandwich\",\n    \"orange\",\n    \"broccoli\",\n    \"carrot\",\n    \"hot dog\",\n    \"pizza\",\n    \"donut\",\n    \"cake\",\n    \"chair\",\n    \"couch\",\n    \"potted plant\",\n    \"bed\",\n    \"dining table\",\n    \"toilet\",\n    \"tv\",\n    \"laptop\",\n    \"mouse\",\n    \"remote\",\n    \"keyboard\",\n    \"cell phone\",\n    \"microwave\",\n    \"oven\",\n    \"toaster\",\n    \"sink\",\n    \"refrigerator\",\n    \"book\",\n    \"clock\",\n    \"vase\",\n    \"scissors\",\n    \"teddy bear\",\n    \"hair drier\",\n    \"toothbrush\",\n]);\n\nconst PRESETS: Readonly<Record<string, readonly string[]>> = {\n    coco: COCO_CLASSES,\n};\n\nexport interface ResolveLabelsOptions {\n    /**\n     * Expected number of classes.\n     *\n     * - When `spec` is `null`/`undefined`, this is required to auto-generate names.\n     * - When `spec` is provided, it validates that the resolved length matches.\n     */\n    readonly numClasses?: number;\n}\n\n/**\n * Resolve a labels specification into an ordered array of class names.\n *\n * @throws {@link LabelMapError} if the spec is invalid, the preset is unknown,\n *   or the resolved length disagrees with `numClasses`.\n */\nexport function resolveLabels(\n    spec: LabelSpec,\n    options: ResolveLabelsOptions = {},\n): readonly string[] {\n    const labels = resolve(spec, options.numClasses);\n    if (options.numClasses !== undefined && labels.length !== options.numClasses) {\n        throw new LabelMapError(\n            `Resolved ${labels.length} labels but the model has ${options.numClasses} classes.`,\n        );\n    }\n    return labels;\n}\n\nfunction resolve(spec: LabelSpec, numClasses: number | undefined): readonly string[] {\n    if (spec === null || spec === undefined) {\n        if (numClasses === undefined) {\n            throw new LabelMapError(\n                \"Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.\",\n            );\n        }\n        return Array.from({ length: numClasses }, (_, i) => `class_${i}`);\n    }\n\n    if (Array.isArray(spec)) {\n        return [...spec];\n    }\n\n    if (typeof spec === \"string\") {\n        const preset = PRESETS[spec];\n        if (preset !== undefined) {\n            return preset;\n        }\n        throw new LabelMapError(\n            `Unknown labels preset: ${JSON.stringify(spec)}. Known presets: ${Object.keys(PRESETS).join(\", \")}.`,\n        );\n    }\n\n    if (typeof spec === \"object\") {\n        const map = spec as Record<number, string>;\n        const ids = Object.keys(map).map((k) => Number(k));\n        if (ids.length === 0) {\n            return [];\n        }\n        const maxId = Math.max(...ids);\n        return Array.from({ length: maxId + 1 }, (_, i) => map[i] ?? `class_${i}`);\n    }\n\n    throw new LabelMapError(`Unsupported labels spec type: ${typeof spec}.`);\n}\n"],"mappings":";;AAwBA,IAAa,IAAkC,OAAO,OAAO,woBAiF7D,CAAC,GAEK,IAAuD,EACzD,MAAM,EACV;AAkBA,SAAgB,EACZ,GACA,IAAgC,CAAC,GAChB;CACjB,IAAM,IAAS,EAAQ,GAAM,EAAQ,UAAU;CAC/C,IAAI,EAAQ,eAAe,KAAA,KAAa,EAAO,WAAW,EAAQ,YAC9D,MAAM,IAAI,EACN,YAAY,EAAO,OAAO,4BAA4B,EAAQ,WAAW,UAC7E;CAEJ,OAAO;AACX;AAEA,SAAS,EAAQ,GAAiB,GAAmD;CACjF,IAAI,KAAS,MAA4B;EACrC,IAAI,MAAe,KAAA,GACf,MAAM,IAAI,EACN,6FACJ;EAEJ,OAAO,MAAM,KAAK,EAAE,QAAQ,EAAW,IAAI,GAAG,MAAM,SAAS,GAAG;CACpE;CAEA,IAAI,MAAM,QAAQ,CAAI,GAClB,OAAO,CAAC,GAAG,CAAI;CAGnB,IAAI,OAAO,KAAS,UAAU;EAC1B,IAAM,IAAS,EAAQ;EACvB,IAAI,MAAW,KAAA,GACX,OAAO;EAEX,MAAM,IAAI,EACN,0BAA0B,KAAK,UAAU,CAAI,EAAE,mBAAmB,OAAO,KAAK,CAAO,CAAC,CAAC,KAAK,IAAI,EAAE,EACtG;CACJ;CAEA,IAAI,OAAO,KAAS,UAAU;EAC1B,IAAM,IAAM,GACN,IAAM,OAAO,KAAK,CAAG,CAAC,CAAC,KAAK,MAAM,OAAO,CAAC,CAAC;EACjD,IAAI,EAAI,WAAW,GACf,OAAO,CAAC;EAEZ,IAAM,IAAQ,KAAK,IAAI,GAAG,CAAG;EAC7B,OAAO,MAAM,KAAK,EAAE,QAAQ,IAAQ,EAAE,IAAI,GAAG,MAAM,EAAI,MAAM,SAAS,GAAG;CAC7E;CAEA,MAAM,IAAI,EAAc,iCAAiC,OAAO,EAAK,EAAE;AAC3E"}

package/dist/vision/luminance.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=256;function g(t){return t instanceof HTMLVideoElement?{width:t.videoWidth,height:t.videoHeight}:t instanceof HTMLCanvasElement?{width:t.width,height:t.height}:{width:t.naturalWidth||t.width,height:t.naturalHeight||t.height}}function L(t,e){const{width:n,height:o}=g(t);if(n===0||o===0)return 0;const u=Math.min(1,s/Math.max(n,o)),i=Math.max(1,Math.round(n*u)),r=Math.max(1,Math.round(o*u)),c=e??document.createElement("canvas");c.width=i,c.height=r;const m=c.getContext("2d",{willReadFrequently:!0});if(!m)return 0;m.drawImage(t,0,0,i,r);const h=m.getImageData(0,0,i,r).data;let d=0;const l=i*r;for(let a=0;a<h.length;a+=4)d+=.2126*h[a]+.7152*h[a+1]+.0722*h[a+2];return d/l}function E(t,e){return t>=e}class M extends Error{luminance;threshold;constructor(e,n){super("Image is too dark to analyse. Capture again in a brighter environment."),this.name="LowLuminanceError",this.luminance=e,this.threshold=n}}exports.LUMINANCE_SAMPLE_MAX_EDGE=s;exports.LowLuminanceError=M;exports.computeImageLuminance=L;exports.isLuminanceAcceptable=E;
-//# sourceMappingURL=luminance.cjs.map
+var e=256;function t(e){return e instanceof HTMLVideoElement?{width:e.videoWidth,height:e.videoHeight}:e instanceof HTMLCanvasElement?{width:e.width,height:e.height}:{width:e.naturalWidth||e.width,height:e.naturalHeight||e.height}}function n(e,n){let{width:r,height:i}=t(e);if(r===0||i===0)return 0;let a=Math.min(1,256/Math.max(r,i)),o=Math.max(1,Math.round(r*a)),s=Math.max(1,Math.round(i*a)),c=n??document.createElement(`canvas`);c.width=o,c.height=s;let l=c.getContext(`2d`,{willReadFrequently:!0});if(!l)return 0;l.drawImage(e,0,0,o,s);let u=l.getImageData(0,0,o,s).data,d=0,f=o*s;for(let e=0;e<u.length;e+=4)d+=.2126*u[e]+.7152*u[e+1]+.0722*u[e+2];return d/f}function r(e,t){return e>=t}var i=class extends Error{luminance;threshold;constructor(e,t){super(`Image is too dark to analyse. Capture again in a brighter environment.`),this.name=`LowLuminanceError`,this.luminance=e,this.threshold=t}};exports.LUMINANCE_SAMPLE_MAX_EDGE=e,exports.LowLuminanceError=i,exports.computeImageLuminance=n,exports.isLuminanceAcceptable=r;
+//# sourceMappingURL=luminance.cjs.map

package/dist/vision/luminance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"luminance.cjs","sources":["../../src/vision/luminance.ts"],"sourcesContent":["/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * `<img>`, `<video>` or `<canvas>` so a UI can reject underexposed captures\n * before paying the cost of downstream inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/** Drawable source we can sample luminance from — image, video, or canvas. */\nexport type LuminanceSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement;\n\n/** Natural pixel size of the source (`0`/`0` while it is still unloaded). */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLCanvasElement) {\n        return { width: source.width, height: source.height };\n    }\n    return {\n        width: source.naturalWidth || source.width,\n        height: source.naturalHeight || source.height,\n    };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded\n * `<img>`, `<video>` or `<canvas>`, scaled to `0..255`.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the image/video/canvas to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"names":["LUMINANCE_SAMPLE_MAX_EDGE","sourceSize","source","computeImageLuminance","reusableCanvas","srcW","srcH","scale","w","h","canvas","ctx","data","sum","pixelCount","i","isLuminanceAcceptable","luminance","threshold","LowLuminanceError"],"mappings":"gFAgBO,MAAMA,EAA4B,IAMzC,SAASC,EAAWC,EAA4D,CAC5E,OAAIA,aAAkB,iBACX,CAAE,MAAOA,EAAO,WAAY,OAAQA,EAAO,WAAA,EAElDA,aAAkB,kBACX,CAAE,MAAOA,EAAO,MAAO,OAAQA,EAAO,MAAA,EAE1C,CACH,MAAOA,EAAO,cAAgBA,EAAO,MACrC,OAAQA,EAAO,eAAiBA,EAAO,MAAA,CAE/C,CAmBO,SAASC,EACZD,EACAE,EACM,CACN,KAAM,CAAE,MAAOC,EAAM,OAAQC,CAAA,EAASL,EAAWC,CAAM,EACvD,GAAIG,IAAS,GAAKC,IAAS,EAAG,MAAO,GAErC,MAAMC,EAAQ,KAAK,IAAI,EAAGP,EAA4B,KAAK,IAAIK,EAAMC,CAAI,CAAC,EACpEE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOE,CAAK,CAAC,EACxCE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAMH,EAAOC,CAAK,CAAC,EAExCG,EAASN,GAAkB,SAAS,cAAc,QAAQ,EAChEM,EAAO,MAAQF,EACfE,EAAO,OAASD,EAChB,MAAME,EAAMD,EAAO,WAAW,KAAM,CAAE,mBAAoB,GAAM,EAChE,GAAI,CAACC,EAAK,MAAO,GACjBA,EAAI,UAAUT,EAAQ,EAAG,EAAGM,EAAGC,CAAC,EAEhC,MAAMG,EAAOD,EAAI,aAAa,EAAG,EAAGH,EAAGC,CAAC,EAAE,KAC1C,IAAII,EAAM,EACV,MAAMC,EAAaN,EAAIC,EACvB,QAASM,EAAI,EAAGA,EAAIH,EAAK,OAAQG,GAAK,EAClCF,GAAO,MAASD,EAAKG,CAAC,EAAI,MAASH,EAAKG,EAAI,CAAC,EAAI,MAASH,EAAKG,EAAI,CAAC,EAExE,OAAOF,EAAMC,CACjB,CAcO,SAASE,EAAsBC,EAAmBC,EAA4B,CACjF,OAAOD,GAAaC,CACxB,CAOO,MAAMC,UAA0B,KAAM,CAEhC,UAEA,UAMT,YAAYF,EAAmBC,EAAmB,CAC9C,MAAM,wEAAwE,EAC9E,KAAK,KAAO,oBACZ,KAAK,UAAYD,EACjB,KAAK,UAAYC,CACrB,CACJ"}
+{"version":3,"file":"luminance.cjs","names":[],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * `<img>`, `<video>` or `<canvas>` so a UI can reject underexposed captures\n * before paying the cost of downstream inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/** Drawable source we can sample luminance from — image, video, or canvas. */\nexport type LuminanceSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement;\n\n/** Natural pixel size of the source (`0`/`0` while it is still unloaded). */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLCanvasElement) {\n        return { width: source.width, height: source.height };\n    }\n    return {\n        width: source.naturalWidth || source.width,\n        height: source.naturalHeight || source.height,\n    };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded\n * `<img>`, `<video>` or `<canvas>`, scaled to `0..255`.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the image/video/canvas to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":"AAgBA,IAAa,EAA4B,IAMzC,SAAS,EAAW,EAA4D,CAO5E,OANI,aAAkB,iBACX,CAAE,MAAO,EAAO,WAAY,OAAQ,EAAO,WAAY,EAE9D,aAAkB,kBACX,CAAE,MAAO,EAAO,MAAO,OAAQ,EAAO,MAAO,EAEjD,CACH,MAAO,EAAO,cAAgB,EAAO,MACrC,OAAQ,EAAO,eAAiB,EAAO,MAC3C,CACJ,CAmBA,SAAgB,EACZ,EACA,EACM,CACN,GAAM,CAAE,MAAO,EAAM,OAAQ,GAAS,EAAW,CAAM,EACvD,GAAI,IAAS,GAAK,IAAS,EAAG,MAAO,GAErC,IAAM,EAAQ,KAAK,IAAI,EAAA,IAA+B,KAAK,IAAI,EAAM,CAAI,CAAC,EACpE,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,EAAO,CAAK,CAAC,EACxC,EAAI,KAAK,IAAI,EAAG,KAAK,MAAM,EAAO,CAAK,CAAC,EAExC,EAAS,GAAkB,SAAS,cAAc,QAAQ,EAChE,EAAO,MAAQ,EACf,EAAO,OAAS,EAChB,IAAM,EAAM,EAAO,WAAW,KAAM,CAAE,mBAAoB,EAAK,CAAC,EAChE,GAAI,CAAC,EAAK,MAAO,GACjB,EAAI,UAAU,EAAQ,EAAG,EAAG,EAAG,CAAC,EAEhC,IAAM,EAAO,EAAI,aAAa,EAAG,EAAG,EAAG,CAAC,CAAC,CAAC,KACtC,EAAM,EACJ,EAAa,EAAI,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,GAAK,EAClC,GAAO,MAAS,EAAK,GAAK,MAAS,EAAK,EAAI,GAAK,MAAS,EAAK,EAAI,GAEvE,OAAO,EAAM,CACjB,CAcA,SAAgB,EAAsB,EAAmB,EAA4B,CACjF,OAAO,GAAa,CACxB,CAOA,IAAa,EAAb,cAAuC,KAAM,CAEzC,UAEA,UAMA,YAAY,EAAmB,EAAmB,CAC9C,MAAM,wEAAwE,EAC9E,KAAK,KAAO,oBACZ,KAAK,UAAY,EACjB,KAAK,UAAY,CACrB,CACJ"}

package/dist/vision/luminance.js

@@ -1,45 +1,40 @@
-const g = 256;
-function u(t) {
-  return t instanceof HTMLVideoElement ? { width: t.videoWidth, height: t.videoHeight } : t instanceof HTMLCanvasElement ? { width: t.width, height: t.height } : {
-    width: t.naturalWidth || t.width,
-    height: t.naturalHeight || t.height
-  };
+//#region src/vision/luminance.ts
+var e = 256;
+function t(e) {
+	return e instanceof HTMLVideoElement ? {
+		width: e.videoWidth,
+		height: e.videoHeight
+	} : e instanceof HTMLCanvasElement ? {
+		width: e.width,
+		height: e.height
+	} : {
+		width: e.naturalWidth || e.width,
+		height: e.naturalHeight || e.height
+	};
 }
-function E(t, n) {
-  const { width: e, height: o } = u(t);
-  if (e === 0 || o === 0) return 0;
-  const m = Math.min(1, 256 / Math.max(e, o)), i = Math.max(1, Math.round(e * m)), h = Math.max(1, Math.round(o * m)), c = n ?? document.createElement("canvas");
-  c.width = i, c.height = h;
-  const d = c.getContext("2d", { willReadFrequently: !0 });
-  if (!d) return 0;
-  d.drawImage(t, 0, 0, i, h);
-  const r = d.getImageData(0, 0, i, h).data;
-  let s = 0;
-  const l = i * h;
-  for (let a = 0; a < r.length; a += 4)
-    s += 0.2126 * r[a] + 0.7152 * r[a + 1] + 0.0722 * r[a + 2];
-  return s / l;
+function n(e, n) {
+	let { width: r, height: i } = t(e);
+	if (r === 0 || i === 0) return 0;
+	let a = Math.min(1, 256 / Math.max(r, i)), o = Math.max(1, Math.round(r * a)), s = Math.max(1, Math.round(i * a)), c = n ?? document.createElement("canvas");
+	c.width = o, c.height = s;
+	let l = c.getContext("2d", { willReadFrequently: !0 });
+	if (!l) return 0;
+	l.drawImage(e, 0, 0, o, s);
+	let u = l.getImageData(0, 0, o, s).data, d = 0, f = o * s;
+	for (let e = 0; e < u.length; e += 4) d += .2126 * u[e] + .7152 * u[e + 1] + .0722 * u[e + 2];
+	return d / f;
 }
-function M(t, n) {
-  return t >= n;
+function r(e, t) {
+	return e >= t;
 }
-class w extends Error {
-  /** Measured mean luminance, `0..255`. */
-  luminance;
-  /** Threshold that was checked against, `0..255`. */
-  threshold;
-  /**
-   * @param luminance - the measured mean luminance in `0..255`.
-   * @param threshold - the threshold the measurement failed to reach.
-   */
-  constructor(n, e) {
-    super("Image is too dark to analyse. Capture again in a brighter environment."), this.name = "LowLuminanceError", this.luminance = n, this.threshold = e;
-  }
-}
-export {
-  g as LUMINANCE_SAMPLE_MAX_EDGE,
-  w as LowLuminanceError,
-  E as computeImageLuminance,
-  M as isLuminanceAcceptable
+var i = class extends Error {
+	luminance;
+	threshold;
+	constructor(e, t) {
+		super("Image is too dark to analyse. Capture again in a brighter environment."), this.name = "LowLuminanceError", this.luminance = e, this.threshold = t;
+	}
 };
-//# sourceMappingURL=luminance.js.map
+//#endregion
+export { e as LUMINANCE_SAMPLE_MAX_EDGE, i as LowLuminanceError, n as computeImageLuminance, r as isLuminanceAcceptable };
+
+//# sourceMappingURL=luminance.js.map

package/dist/vision/luminance.js.map

@@ -1 +1 @@
-{"version":3,"file":"luminance.js","sources":["../../src/vision/luminance.ts"],"sourcesContent":["/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * `<img>`, `<video>` or `<canvas>` so a UI can reject underexposed captures\n * before paying the cost of downstream inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/** Drawable source we can sample luminance from — image, video, or canvas. */\nexport type LuminanceSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement;\n\n/** Natural pixel size of the source (`0`/`0` while it is still unloaded). */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLCanvasElement) {\n        return { width: source.width, height: source.height };\n    }\n    return {\n        width: source.naturalWidth || source.width,\n        height: source.naturalHeight || source.height,\n    };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded\n * `<img>`, `<video>` or `<canvas>`, scaled to `0..255`.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the image/video/canvas to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"names":["LUMINANCE_SAMPLE_MAX_EDGE","sourceSize","source","computeImageLuminance","reusableCanvas","srcW","srcH","scale","w","canvas","ctx","data","sum","pixelCount","i","isLuminanceAcceptable","luminance","threshold","LowLuminanceError"],"mappings":"AAgBO,MAAMA,IAA4B;AAMzC,SAASC,EAAWC,GAA4D;AAC5E,SAAIA,aAAkB,mBACX,EAAE,OAAOA,EAAO,YAAY,QAAQA,EAAO,YAAA,IAElDA,aAAkB,oBACX,EAAE,OAAOA,EAAO,OAAO,QAAQA,EAAO,OAAA,IAE1C;AAAA,IACH,OAAOA,EAAO,gBAAgBA,EAAO;AAAA,IACrC,QAAQA,EAAO,iBAAiBA,EAAO;AAAA,EAAA;AAE/C;AAmBO,SAASC,EACZD,GACAE,GACM;AACN,QAAM,EAAE,OAAOC,GAAM,QAAQC,EAAA,IAASL,EAAWC,CAAM;AACvD,MAAIG,MAAS,KAAKC,MAAS,EAAG,QAAO;AAErC,QAAMC,IAAQ,KAAK,IAAI,GAAG,MAA4B,KAAK,IAAIF,GAAMC,CAAI,CAAC,GACpEE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAMH,IAAOE,CAAK,CAAC,GACxC,IAAI,KAAK,IAAI,GAAG,KAAK,MAAMD,IAAOC,CAAK,CAAC,GAExCE,IAASL,KAAkB,SAAS,cAAc,QAAQ;AAChE,EAAAK,EAAO,QAAQD,GACfC,EAAO,SAAS;AAChB,QAAMC,IAAMD,EAAO,WAAW,MAAM,EAAE,oBAAoB,IAAM;AAChE,MAAI,CAACC,EAAK,QAAO;AACjB,EAAAA,EAAI,UAAUR,GAAQ,GAAG,GAAGM,GAAG,CAAC;AAEhC,QAAMG,IAAOD,EAAI,aAAa,GAAG,GAAGF,GAAG,CAAC,EAAE;AAC1C,MAAII,IAAM;AACV,QAAMC,IAAaL,IAAI;AACvB,WAASM,IAAI,GAAGA,IAAIH,EAAK,QAAQG,KAAK;AAClC,IAAAF,KAAO,SAASD,EAAKG,CAAC,IAAI,SAASH,EAAKG,IAAI,CAAC,IAAI,SAASH,EAAKG,IAAI,CAAC;AAExE,SAAOF,IAAMC;AACjB;AAcO,SAASE,EAAsBC,GAAmBC,GAA4B;AACjF,SAAOD,KAAaC;AACxB;AAOO,MAAMC,UAA0B,MAAM;AAAA;AAAA,EAEhC;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,YAAYF,GAAmBC,GAAmB;AAC9C,UAAM,wEAAwE,GAC9E,KAAK,OAAO,qBACZ,KAAK,YAAYD,GACjB,KAAK,YAAYC;AAAA,EACrB;AACJ;"}
+{"version":3,"file":"luminance.js","names":[],"sources":["../../src/vision/luminance.ts"],"sourcesContent":["/**\n * Frame-brightness helpers — measure the mean luminance of an already-decoded\n * `<img>`, `<video>` or `<canvas>` so a UI can reject underexposed captures\n * before paying the cost of downstream inference.\n *\n * These are framework-agnostic pure functions; {@link useLiveLuminance} wires\n * {@link computeImageLuminance} into a React `requestAnimationFrame` loop for\n * live camera feedback.\n */\n\n/**\n * Longest edge (in pixels) the source is downsampled to before sampling.\n * Averaging over a small downsample is statistically equivalent for a\n * brightness threshold and orders of magnitude faster than reading every pixel\n * of a full-resolution camera frame.\n */\nexport const LUMINANCE_SAMPLE_MAX_EDGE = 256;\n\n/** Drawable source we can sample luminance from — image, video, or canvas. */\nexport type LuminanceSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement;\n\n/** Natural pixel size of the source (`0`/`0` while it is still unloaded). */\nfunction sourceSize(source: LuminanceSource): { width: number; height: number } {\n    if (source instanceof HTMLVideoElement) {\n        return { width: source.videoWidth, height: source.videoHeight };\n    }\n    if (source instanceof HTMLCanvasElement) {\n        return { width: source.width, height: source.height };\n    }\n    return {\n        width: source.naturalWidth || source.width,\n        height: source.naturalHeight || source.height,\n    };\n}\n\n/**\n * Mean BT.709 luminance (`0.2126*R + 0.7152*G + 0.0722*B`) of a decoded\n * `<img>`, `<video>` or `<canvas>`, scaled to `0..255`.\n *\n * The source is downsampled so its longest edge is at most\n * {@link LUMINANCE_SAMPLE_MAX_EDGE} before pixels are read. The 2D context is\n * created with `willReadFrequently` so repeated sampling (live feedback) stays\n * on the fast path.\n *\n * Pass `reusableCanvas` to avoid allocating a fresh canvas every frame in a hot\n * loop; when omitted a one-shot detached canvas is created.\n *\n * @param source - the image/video/canvas to sample.\n * @param reusableCanvas - optional canvas reused across frames to avoid GC churn.\n * @returns The mean luminance in `0..255`, or `0` when the source is unloaded\n *   (zero-sized) or a 2D context is unavailable.\n */\nexport function computeImageLuminance(\n    source: LuminanceSource,\n    reusableCanvas?: HTMLCanvasElement,\n): number {\n    const { width: srcW, height: srcH } = sourceSize(source);\n    if (srcW === 0 || srcH === 0) return 0;\n\n    const scale = Math.min(1, LUMINANCE_SAMPLE_MAX_EDGE / Math.max(srcW, srcH));\n    const w = Math.max(1, Math.round(srcW * scale));\n    const h = Math.max(1, Math.round(srcH * scale));\n\n    const canvas = reusableCanvas ?? document.createElement(\"canvas\");\n    canvas.width = w;\n    canvas.height = h;\n    const ctx = canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) return 0;\n    ctx.drawImage(source, 0, 0, w, h);\n\n    const data = ctx.getImageData(0, 0, w, h).data;\n    let sum = 0;\n    const pixelCount = w * h;\n    for (let i = 0; i < data.length; i += 4) {\n        sum += 0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2];\n    }\n    return sum / pixelCount;\n}\n\n/**\n * Whether a measured luminance clears a brightness threshold.\n *\n * `threshold` is intentionally required — a sensible value is\n * application-specific (it depends on the model, the lighting the model was\n * trained on, and the acceptable false-reject rate), so the SDK does not bake\n * in a default.\n *\n * @param luminance - measured mean luminance in `0..255`.\n * @param threshold - minimum acceptable luminance in `0..255`.\n * @returns `true` when `luminance >= threshold`.\n */\nexport function isLuminanceAcceptable(luminance: number, threshold: number): boolean {\n    return luminance >= threshold;\n}\n\n/**\n * Error raised when a captured frame is too dark to be analysed reliably.\n * Carries the measured luminance and the threshold it failed so callers can\n * surface actionable feedback.\n */\nexport class LowLuminanceError extends Error {\n    /** Measured mean luminance, `0..255`. */\n    readonly luminance: number;\n    /** Threshold that was checked against, `0..255`. */\n    readonly threshold: number;\n\n    /**\n     * @param luminance - the measured mean luminance in `0..255`.\n     * @param threshold - the threshold the measurement failed to reach.\n     */\n    constructor(luminance: number, threshold: number) {\n        super(\"Image is too dark to analyse. Capture again in a brighter environment.\");\n        this.name = \"LowLuminanceError\";\n        this.luminance = luminance;\n        this.threshold = threshold;\n    }\n}\n"],"mappings":";AAgBA,IAAa,IAA4B;AAMzC,SAAS,EAAW,GAA4D;CAO5E,OANI,aAAkB,mBACX;EAAE,OAAO,EAAO;EAAY,QAAQ,EAAO;CAAY,IAE9D,aAAkB,oBACX;EAAE,OAAO,EAAO;EAAO,QAAQ,EAAO;CAAO,IAEjD;EACH,OAAO,EAAO,gBAAgB,EAAO;EACrC,QAAQ,EAAO,iBAAiB,EAAO;CAC3C;AACJ;AAmBA,SAAgB,EACZ,GACA,GACM;CACN,IAAM,EAAE,OAAO,GAAM,QAAQ,MAAS,EAAW,CAAM;CACvD,IAAI,MAAS,KAAK,MAAS,GAAG,OAAO;CAErC,IAAM,IAAQ,KAAK,IAAI,GAAA,MAA+B,KAAK,IAAI,GAAM,CAAI,CAAC,GACpE,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,IAAO,CAAK,CAAC,GACxC,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,IAAO,CAAK,CAAC,GAExC,IAAS,KAAkB,SAAS,cAAc,QAAQ;CAEhE,AADA,EAAO,QAAQ,GACf,EAAO,SAAS;CAChB,IAAM,IAAM,EAAO,WAAW,MAAM,EAAE,oBAAoB,GAAK,CAAC;CAChE,IAAI,CAAC,GAAK,OAAO;CACjB,EAAI,UAAU,GAAQ,GAAG,GAAG,GAAG,CAAC;CAEhC,IAAM,IAAO,EAAI,aAAa,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,MACtC,IAAM,GACJ,IAAa,IAAI;CACvB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAK,QAAQ,KAAK,GAClC,KAAO,QAAS,EAAK,KAAK,QAAS,EAAK,IAAI,KAAK,QAAS,EAAK,IAAI;CAEvE,OAAO,IAAM;AACjB;AAcA,SAAgB,EAAsB,GAAmB,GAA4B;CACjF,OAAO,KAAa;AACxB;AAOA,IAAa,IAAb,cAAuC,MAAM;CAEzC;CAEA;CAMA,YAAY,GAAmB,GAAmB;EAI9C,AAHA,MAAM,wEAAwE,GAC9E,KAAK,OAAO,qBACZ,KAAK,YAAY,GACjB,KAAK,YAAY;CACrB;AACJ"}

package/dist/vision/postprocess/classification.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(e){const c=e.length,o=new Float32Array(c);let f=-1/0;for(let t=0;t<c;t++){const r=e[t];r>f&&(f=r)}let a=0;for(let t=0;t<c;t++){const r=Math.exp(e[t]-f);o[t]=r,a+=r}for(let t=0;t<c;t++)o[t]=o[t]/a;return o}function u(e,c){const o=e.length,f=c===null?o:Math.min(Math.max(0,c),o),a=new Array(o);for(let n=0;n<o;n++)a[n]=n;a.sort((n,s)=>e[s]-e[n]);const t=new Int32Array(f),r=new Float32Array(f);for(let n=0;n<f;n++){const s=a[n];t[n]=s,r[n]=e[s]}return{indices:t,values:r}}exports.softmax=l;exports.topK=u;
-//# sourceMappingURL=classification.cjs.map
+function e(e){let t=e.length,n=new Float32Array(t),r=-1/0;for(let n=0;n<t;n++){let t=e[n];t>r&&(r=t)}let i=0;for(let a=0;a<t;a++){let t=Math.exp(e[a]-r);n[a]=t,i+=t}for(let e=0;e<t;e++)n[e]=n[e]/i;return n}function t(e,t){let n=e.length,r=t===null?n:Math.min(Math.max(0,t),n),i=Array(n);for(let e=0;e<n;e++)i[e]=e;i.sort((t,n)=>e[n]-e[t]);let a=new Int32Array(r),o=new Float32Array(r);for(let t=0;t<r;t++){let n=i[t];a[t]=n,o[t]=e[n]}return{indices:a,values:o}}exports.softmax=e,exports.topK=t;
+//# sourceMappingURL=classification.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"classification.cjs","sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"names":["softmax","logits","n","out","max","i","v","sum","e","topK","probabilities","k","kEff","idx","a","b","indices","values","j"],"mappings":"gFAKO,SAASA,EAAQC,EAAwD,CAC5E,MAAMC,EAAID,EAAO,OACXE,EAAM,IAAI,aAAaD,CAAC,EAC9B,IAAIE,EAAM,KACV,QAASC,EAAI,EAAGA,EAAIH,EAAGG,IAAK,CACxB,MAAMC,EAAIL,EAAOI,CAAC,EACdC,EAAIF,IAAKA,EAAME,EACvB,CACA,IAAIC,EAAM,EACV,QAASF,EAAI,EAAGA,EAAIH,EAAGG,IAAK,CACxB,MAAMG,EAAI,KAAK,IAAKP,EAAOI,CAAC,EAAeD,CAAG,EAC9CD,EAAIE,CAAC,EAAIG,EACTD,GAAOC,CACX,CACA,QAASH,EAAI,EAAGA,EAAIH,EAAGG,IACnBF,EAAIE,CAAC,EAAKF,EAAIE,CAAC,EAAeE,EAElC,OAAOJ,CACX,CAYO,SAASM,EAAKC,EAA6BC,EAA8B,CAC5E,MAAMT,EAAIQ,EAAc,OAClBE,EAAOD,IAAM,KAAOT,EAAI,KAAK,IAAI,KAAK,IAAI,EAAGS,CAAC,EAAGT,CAAC,EAElDW,EAAM,IAAI,MAAcX,CAAC,EAC/B,QAASG,EAAI,EAAGA,EAAIH,EAAGG,IAAKQ,EAAIR,CAAC,EAAIA,EACrCQ,EAAI,KAAK,CAACC,EAAGC,IAAOL,EAAcK,CAAC,EAAgBL,EAAcI,CAAC,CAAY,EAE9E,MAAME,EAAU,IAAI,WAAWJ,CAAI,EAC7BK,EAAS,IAAI,aAAaL,CAAI,EACpC,QAASP,EAAI,EAAGA,EAAIO,EAAMP,IAAK,CAC3B,MAAMa,EAAIL,EAAIR,CAAC,EACfW,EAAQX,CAAC,EAAIa,EACbD,EAAOZ,CAAC,EAAIK,EAAcQ,CAAC,CAC/B,CACA,MAAO,CAAE,QAAAF,EAAS,OAAAC,CAAA,CACtB"}
+{"version":3,"file":"classification.cjs","names":[],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":"AAKA,SAAgB,EAAQ,EAAwD,CAC5E,IAAM,EAAI,EAAO,OACX,EAAM,IAAI,aAAa,CAAC,EAC1B,EAAM,KACV,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,CACxB,IAAM,EAAI,EAAO,GACb,EAAI,IAAK,EAAM,EACvB,CACA,IAAI,EAAM,EACV,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,CACxB,IAAM,EAAI,KAAK,IAAK,EAAO,GAAgB,CAAG,EAC9C,EAAI,GAAK,EACT,GAAO,CACX,CACA,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IACnB,EAAI,GAAM,EAAI,GAAgB,EAElC,OAAO,CACX,CAYA,SAAgB,EAAK,EAA6B,EAA8B,CAC5E,IAAM,EAAI,EAAc,OAClB,EAAO,IAAM,KAAO,EAAI,KAAK,IAAI,KAAK,IAAI,EAAG,CAAC,EAAG,CAAC,EAElD,EAAU,MAAc,CAAC,EAC/B,IAAK,IAAI,EAAI,EAAG,EAAI,EAAG,IAAK,EAAI,GAAK,EACrC,EAAI,MAAM,EAAG,IAAO,EAAc,GAAiB,EAAc,EAAa,EAE9E,IAAM,EAAU,IAAI,WAAW,CAAI,EAC7B,EAAS,IAAI,aAAa,CAAI,EACpC,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,IAAK,CAC3B,IAAM,EAAI,EAAI,GACd,EAAQ,GAAK,EACb,EAAO,GAAK,EAAc,EAC9B,CACA,MAAO,CAAE,UAAS,QAAO,CAC7B"}

package/dist/vision/postprocess/classification.js

@@ -1,32 +1,33 @@
-function l(e) {
-  const c = e.length, o = new Float32Array(c);
-  let f = -1 / 0;
-  for (let n = 0; n < c; n++) {
-    const r = e[n];
-    r > f && (f = r);
-  }
-  let a = 0;
-  for (let n = 0; n < c; n++) {
-    const r = Math.exp(e[n] - f);
-    o[n] = r, a += r;
-  }
-  for (let n = 0; n < c; n++)
-    o[n] = o[n] / a;
-  return o;
+//#region src/vision/postprocess/classification.ts
+function e(e) {
+	let t = e.length, n = new Float32Array(t), r = -Infinity;
+	for (let n = 0; n < t; n++) {
+		let t = e[n];
+		t > r && (r = t);
+	}
+	let i = 0;
+	for (let a = 0; a < t; a++) {
+		let t = Math.exp(e[a] - r);
+		n[a] = t, i += t;
+	}
+	for (let e = 0; e < t; e++) n[e] = n[e] / i;
+	return n;
 }
-function u(e, c) {
-  const o = e.length, f = c === null ? o : Math.min(Math.max(0, c), o), a = new Array(o);
-  for (let t = 0; t < o; t++) a[t] = t;
-  a.sort((t, s) => e[s] - e[t]);
-  const n = new Int32Array(f), r = new Float32Array(f);
-  for (let t = 0; t < f; t++) {
-    const s = a[t];
-    n[t] = s, r[t] = e[s];
-  }
-  return { indices: n, values: r };
+function t(e, t) {
+	let n = e.length, r = t === null ? n : Math.min(Math.max(0, t), n), i = Array(n);
+	for (let e = 0; e < n; e++) i[e] = e;
+	i.sort((t, n) => e[n] - e[t]);
+	let a = new Int32Array(r), o = new Float32Array(r);
+	for (let t = 0; t < r; t++) {
+		let n = i[t];
+		a[t] = n, o[t] = e[n];
+	}
+	return {
+		indices: a,
+		values: o
+	};
 }
-export {
-  l as softmax,
-  u as topK
-};
-//# sourceMappingURL=classification.js.map
+//#endregion
+export { e as softmax, t as topK };
+
+//# sourceMappingURL=classification.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"classification.js","sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"names":["softmax","logits","n","out","max","i","v","sum","e","topK","probabilities","k","kEff","idx","a","b","indices","values","j"],"mappings":"AAKO,SAASA,EAAQC,GAAwD;AAC5E,QAAMC,IAAID,EAAO,QACXE,IAAM,IAAI,aAAaD,CAAC;AAC9B,MAAIE,IAAM;AACV,WAASC,IAAI,GAAGA,IAAIH,GAAGG,KAAK;AACxB,UAAMC,IAAIL,EAAOI,CAAC;AAClB,IAAIC,IAAIF,MAAKA,IAAME;AAAA,EACvB;AACA,MAAIC,IAAM;AACV,WAASF,IAAI,GAAGA,IAAIH,GAAGG,KAAK;AACxB,UAAMG,IAAI,KAAK,IAAKP,EAAOI,CAAC,IAAeD,CAAG;AAC9C,IAAAD,EAAIE,CAAC,IAAIG,GACTD,KAAOC;AAAA,EACX;AACA,WAASH,IAAI,GAAGA,IAAIH,GAAGG;AACnB,IAAAF,EAAIE,CAAC,IAAKF,EAAIE,CAAC,IAAeE;AAElC,SAAOJ;AACX;AAYO,SAASM,EAAKC,GAA6BC,GAA8B;AAC5E,QAAMT,IAAIQ,EAAc,QAClBE,IAAOD,MAAM,OAAOT,IAAI,KAAK,IAAI,KAAK,IAAI,GAAGS,CAAC,GAAGT,CAAC,GAElDW,IAAM,IAAI,MAAcX,CAAC;AAC/B,WAASG,IAAI,GAAGA,IAAIH,GAAGG,IAAK,CAAAQ,EAAIR,CAAC,IAAIA;AACrC,EAAAQ,EAAI,KAAK,CAACC,GAAGC,MAAOL,EAAcK,CAAC,IAAgBL,EAAcI,CAAC,CAAY;AAE9E,QAAME,IAAU,IAAI,WAAWJ,CAAI,GAC7BK,IAAS,IAAI,aAAaL,CAAI;AACpC,WAASP,IAAI,GAAGA,IAAIO,GAAMP,KAAK;AAC3B,UAAMa,IAAIL,EAAIR,CAAC;AACf,IAAAW,EAAQX,CAAC,IAAIa,GACbD,EAAOZ,CAAC,IAAIK,EAAcQ,CAAC;AAAA,EAC/B;AACA,SAAO,EAAE,SAAAF,GAAS,QAAAC,EAAA;AACtB;"}
+{"version":3,"file":"classification.js","names":[],"sources":["../../../src/vision/postprocess/classification.ts"],"sourcesContent":["/**\n * Classification head postprocessing — softmax + top-k.\n */\n\n/** Apply numerically-stable softmax to a 1-D vector of logits. */\nexport function softmax(logits: Float32Array | readonly number[]): Float32Array {\n    const n = logits.length;\n    const out = new Float32Array(n);\n    let max = -Infinity;\n    for (let i = 0; i < n; i++) {\n        const v = logits[i] as number;\n        if (v > max) max = v;\n    }\n    let sum = 0;\n    for (let i = 0; i < n; i++) {\n        const e = Math.exp((logits[i] as number) - max);\n        out[i] = e;\n        sum += e;\n    }\n    for (let i = 0; i < n; i++) {\n        out[i] = (out[i] as number) / sum;\n    }\n    return out;\n}\n\nexport interface TopKResult {\n    readonly indices: Int32Array;\n    readonly values: Float32Array;\n}\n\n/**\n * Return the top-k entries of a 1-D probability vector, sorted descending.\n *\n * @param k Number of entries to return; `null` returns all entries.\n */\nexport function topK(probabilities: Float32Array, k: number | null): TopKResult {\n    const n = probabilities.length;\n    const kEff = k === null ? n : Math.min(Math.max(0, k), n);\n\n    const idx = new Array<number>(n);\n    for (let i = 0; i < n; i++) idx[i] = i;\n    idx.sort((a, b) => (probabilities[b] as number) - (probabilities[a] as number));\n\n    const indices = new Int32Array(kEff);\n    const values = new Float32Array(kEff);\n    for (let i = 0; i < kEff; i++) {\n        const j = idx[i] as number;\n        indices[i] = j;\n        values[i] = probabilities[j] as number;\n    }\n    return { indices, values };\n}\n"],"mappings":";AAKA,SAAgB,EAAQ,GAAwD;CAC5E,IAAM,IAAI,EAAO,QACX,IAAM,IAAI,aAAa,CAAC,GAC1B,IAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EACxB,IAAM,IAAI,EAAO;EACjB,AAAI,IAAI,MAAK,IAAM;CACvB;CACA,IAAI,IAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EACxB,IAAM,IAAI,KAAK,IAAK,EAAO,KAAgB,CAAG;EAE9C,AADA,EAAI,KAAK,GACT,KAAO;CACX;CACA,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACnB,EAAI,KAAM,EAAI,KAAgB;CAElC,OAAO;AACX;AAYA,SAAgB,EAAK,GAA6B,GAA8B;CAC5E,IAAM,IAAI,EAAc,QAClB,IAAO,MAAM,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,GAElD,IAAU,MAAc,CAAC;CAC/B,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK,EAAI,KAAK;CACrC,EAAI,MAAM,GAAG,MAAO,EAAc,KAAiB,EAAc,EAAa;CAE9E,IAAM,IAAU,IAAI,WAAW,CAAI,GAC7B,IAAS,IAAI,aAAa,CAAI;CACpC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAM,KAAK;EAC3B,IAAM,IAAI,EAAI;EAEd,AADA,EAAQ,KAAK,GACb,EAAO,KAAK,EAAc;CAC9B;CACA,OAAO;EAAE;EAAS;CAAO;AAC7B"}

package/dist/vision/postprocess/detection.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const L=require("../types.cjs");function H(n,a,y){const c=a.length;if(c===0)return new Int32Array(0);const h=new Float32Array(c);for(let o=0;o<c;o++){const d=n[o*4],A=n[o*4+1],l=n[o*4+2],w=n[o*4+3];h[o]=Math.max(0,l-d)*Math.max(0,w-A)}const t=new Array(c);for(let o=0;o<c;o++)t[o]=o;t.sort((o,d)=>a[d]-a[o]);const s=new Uint8Array(c),r=[];for(let o=0;o<t.length;o++){const d=t[o];if(s[d])continue;r.push(d);const A=n[d*4],l=n[d*4+1],w=n[d*4+2],C=n[d*4+3],E=h[d];for(let u=o+1;u<t.length;u++){const f=t[u];if(s[f])continue;const b=n[f*4],v=n[f*4+1],F=n[f*4+2],k=n[f*4+3],m=Math.max(A,b),V=Math.max(l,v),x=Math.min(w,F),$=Math.min(C,k),T=Math.max(0,x-m),e=Math.max(0,$-V),i=T*e,g=E+h[f]-i;(g>0?i/g:0)>y&&(s[f]=1)}}return Int32Array.from(r)}function J(n,a,y,c){if(a.length===0)return new Int32Array(0);const h=new Map;for(let s=0;s<y.length;s++){const r=y[s],o=h.get(r);o===void 0?h.set(r,[s]):o.push(s)}const t=[];for(const s of h.values()){const r=s.length,o=new Float32Array(r*4),d=new Float32Array(r);for(let l=0;l<r;l++){const w=s[l];o[l*4]=n[w*4],o[l*4+1]=n[w*4+1],o[l*4+2]=n[w*4+2],o[l*4+3]=n[w*4+3],d[l]=a[w]}const A=H(o,d,c);for(let l=0;l<A.length;l++)t.push(s[A[l]])}return t.sort((s,r)=>a[r]-a[s]),Int32Array.from(t)}function j(n,a,y){let c=a;if(c.length===3){if(c[0]!==1)throw new Error(`decodeYoloAnchors: expected batch size 1, got ${c[0]}.`);c=[c[1],c[2]]}if(c.length!==2)throw new Error(`decodeYoloAnchors: expected 2-D output after batch removal, got dims=${JSON.stringify(a)}.`);const h=c[0],t=c[1],{numClasses:s,originalWidth:r,originalHeight:o,padLeft:d,padTop:A,scale:l,confThreshold:w,iouThreshold:C,maxDetections:E}=y;if(s<1||s+4>h)throw new Error(`decodeYoloAnchors: invalid numClasses=${s} for channels=${h}.`);if(n.length!==h*t)throw new Error(`decodeYoloAnchors: data length ${n.length} does not match channels*numAnchors=${h*t}.`);const u=[];for(let e=0;e<t;e++){let i=0,g=-1/0;for(let X=0;X<s;X++){const B=n[(4+X)*t+e];B!==void 0&&B>g&&(g=B,i=X)}if(g<w)continue;const S=n[e],N=n[t+e],z=n[2*t+e],D=n[3*t+e];let p=S-z/2,I=N-D/2,Y=S+z/2,M=N+D/2;p=(p-d)/l,I=(I-A)/l,Y=(Y-d)/l,M=(M-A)/l,p=Math.max(0,Math.min(r,p)),I=Math.max(0,Math.min(o,I)),Y=Math.max(0,Math.min(r,Y)),M=Math.max(0,Math.min(o,M)),u.push({anchorIdx:e,x1:p,y1:I,x2:Y,y2:M,classId:i,confidence:g})}if(u.length===0)return O();const f=new Float32Array(u.length*4),b=new Float32Array(u.length),v=new Int32Array(u.length);for(let e=0;e<u.length;e++){const i=u[e];f[e*4]=i.x1,f[e*4+1]=i.y1,f[e*4+2]=i.x2,f[e*4+3]=i.y2,b[e]=i.confidence,v[e]=i.classId}const F=J(f,b,v,C);if(F.length===0)return O();const k=Array.from(F).slice(0,E),m=k.length,V=new Int32Array(m),x=new Float32Array(m*4),$=new Int32Array(m),T=new Float32Array(m);for(let e=0;e<m;e++){const i=u[k[e]];V[e]=i.anchorIdx,x[e*4]=i.x1,x[e*4+1]=i.y1,x[e*4+2]=i.x2,x[e*4+3]=i.y2,$[e]=i.classId,T[e]=i.confidence}return{anchorIndices:V,boxesXyxy:x,classIds:$,confidences:T}}function O(){return{anchorIndices:new Int32Array(0),boxesXyxy:new Float32Array(0),classIds:new Int32Array(0),confidences:new Float32Array(0)}}function K(n,a,y){const c=a.length===3?a[1]:a[0];if(c===void 0||c<5)throw new Error(`decodeYolo: invalid output channel count ${c} (expected >= 5).`);const h=c-4,t=j(n,a,{numClasses:h,...y}),s=[];for(let r=0;r<t.classIds.length;r++)s.push({bbox:new L.BoundingBox(t.boxesXyxy[r*4],t.boxesXyxy[r*4+1],t.boxesXyxy[r*4+2],t.boxesXyxy[r*4+3]),classId:t.classIds[r],confidence:t.confidences[r]});return s}let _=!1,q=!1;function P(n,a,y){return _||(_=!0,console.warn("[@ort-vision-sdk/web] decodeYoloV8 is deprecated since 0.2.0; use decodeYolo. The alias will be removed in 0.3.0.")),K(n,a,y)}function U(n,a,y){return q||(q=!0,console.warn("[@ort-vision-sdk/web] decodeYoloV8Anchors is deprecated since 0.2.0; use decodeYoloAnchors. The alias will be removed in 0.3.0.")),j(n,a,y)}exports.batchedNms=J;exports.decodeYolo=K;exports.decodeYoloAnchors=j;exports.decodeYoloV8=P;exports.decodeYoloV8Anchors=U;exports.nms=H;
-//# sourceMappingURL=detection.cjs.map
+const e=require("../types.cjs");function t(e,t,n){let r=t.length;if(r===0)return new Int32Array;let i=new Float32Array(r);for(let t=0;t<r;t++){let n=e[t*4],r=e[t*4+1],a=e[t*4+2],o=e[t*4+3];i[t]=Math.max(0,a-n)*Math.max(0,o-r)}let a=Array(r);for(let e=0;e<r;e++)a[e]=e;a.sort((e,n)=>t[n]-t[e]);let o=new Uint8Array(r),s=[];for(let t=0;t<a.length;t++){let r=a[t];if(o[r])continue;s.push(r);let c=e[r*4],l=e[r*4+1],u=e[r*4+2],d=e[r*4+3],f=i[r];for(let r=t+1;r<a.length;r++){let t=a[r];if(o[t])continue;let s=e[t*4],p=e[t*4+1],m=e[t*4+2],h=e[t*4+3],g=Math.max(c,s),_=Math.max(l,p),v=Math.min(u,m),y=Math.min(d,h),b=Math.max(0,v-g)*Math.max(0,y-_),x=f+i[t]-b;(x>0?b/x:0)>n&&(o[t]=1)}}return Int32Array.from(s)}function n(e,n,r,i){if(n.length===0)return new Int32Array;let a=new Map;for(let e=0;e<r.length;e++){let t=r[e],n=a.get(t);n===void 0?a.set(t,[e]):n.push(e)}let o=[];for(let r of a.values()){let a=r.length,s=new Float32Array(a*4),c=new Float32Array(a);for(let t=0;t<a;t++){let i=r[t];s[t*4]=e[i*4],s[t*4+1]=e[i*4+1],s[t*4+2]=e[i*4+2],s[t*4+3]=e[i*4+3],c[t]=n[i]}let l=t(s,c,i);for(let e=0;e<l.length;e++)o.push(r[l[e]])}return o.sort((e,t)=>n[t]-n[e]),Int32Array.from(o)}function r(e,t,r){let a=t;if(a.length===3){if(a[0]!==1)throw Error(`decodeYoloAnchors: expected batch size 1, got ${a[0]}.`);a=[a[1],a[2]]}if(a.length!==2)throw Error(`decodeYoloAnchors: expected 2-D output after batch removal, got dims=${JSON.stringify(t)}.`);let o=a[0],s=a[1],{numClasses:c,originalWidth:l,originalHeight:u,padLeft:d,padTop:f,scale:p,confThreshold:m,iouThreshold:h,maxDetections:g}=r;if(c<1||c+4>o)throw Error(`decodeYoloAnchors: invalid numClasses=${c} for channels=${o}.`);if(e.length!==o*s)throw Error(`decodeYoloAnchors: data length ${e.length} does not match channels*numAnchors=${o*s}.`);let _=[];for(let t=0;t<s;t++){let n=0,r=-1/0;for(let i=0;i<c;i++){let a=e[(4+i)*s+t];a!==void 0&&a>r&&(r=a,n=i)}if(r<m)continue;let i=e[t],a=e[s+t],o=e[2*s+t],h=e[3*s+t],g=i-o/2,v=a-h/2,y=i+o/2,b=a+h/2;g=(g-d)/p,v=(v-f)/p,y=(y-d)/p,b=(b-f)/p,g=Math.max(0,Math.min(l,g)),v=Math.max(0,Math.min(u,v)),y=Math.max(0,Math.min(l,y)),b=Math.max(0,Math.min(u,b)),_.push({anchorIdx:t,x1:g,y1:v,x2:y,y2:b,classId:n,confidence:r})}if(_.length===0)return i();let v=new Float32Array(_.length*4),y=new Float32Array(_.length),b=new Int32Array(_.length);for(let e=0;e<_.length;e++){let t=_[e];v[e*4]=t.x1,v[e*4+1]=t.y1,v[e*4+2]=t.x2,v[e*4+3]=t.y2,y[e]=t.confidence,b[e]=t.classId}let x=n(v,y,b,h);if(x.length===0)return i();let S=Array.from(x).slice(0,g),C=S.length,w=new Int32Array(C),T=new Float32Array(C*4),E=new Int32Array(C),D=new Float32Array(C);for(let e=0;e<C;e++){let t=_[S[e]];w[e]=t.anchorIdx,T[e*4]=t.x1,T[e*4+1]=t.y1,T[e*4+2]=t.x2,T[e*4+3]=t.y2,E[e]=t.classId,D[e]=t.confidence}return{anchorIndices:w,boxesXyxy:T,classIds:E,confidences:D}}function i(){return{anchorIndices:new Int32Array,boxesXyxy:new Float32Array,classIds:new Int32Array,confidences:new Float32Array}}function a(t,n,i){let a=n.length===3?n[1]:n[0];if(a===void 0||a<5)throw Error(`decodeYolo: invalid output channel count ${a} (expected >= 5).`);let o=r(t,n,{numClasses:a-4,...i}),s=[];for(let t=0;t<o.classIds.length;t++)s.push({bbox:new e.BoundingBox(o.boxesXyxy[t*4],o.boxesXyxy[t*4+1],o.boxesXyxy[t*4+2],o.boxesXyxy[t*4+3]),classId:o.classIds[t],confidence:o.confidences[t]});return s}var o=!1,s=!1;function c(e,t,n){return o||(o=!0,console.warn(`[@ort-vision-sdk/web] decodeYoloV8 is deprecated since 0.2.0; use decodeYolo. The alias will be removed in 0.3.0.`)),a(e,t,n)}function l(e,t,n){return s||(s=!0,console.warn(`[@ort-vision-sdk/web] decodeYoloV8Anchors is deprecated since 0.2.0; use decodeYoloAnchors. The alias will be removed in 0.3.0.`)),r(e,t,n)}exports.batchedNms=n,exports.decodeYolo=a,exports.decodeYoloAnchors=r,exports.decodeYoloV8=c,exports.decodeYoloV8Anchors=l,exports.nms=t;
+//# sourceMappingURL=detection.cjs.map