@dxo/vision 0.0.0 → 0.0.12

package/README.md

@@ -1,3 +1,20 @@
 # @dxo/vision
 
-Placeholder package (0.0.0). Reserved for the DXO project.
+**Developer preview — API unstable.** Not a closed `vision-classify` gate.
+
+Composable vision surface: `ResNet` (backbone / features), `LinearHead` / `Classifier` / `compose` (logits), `defineLabelSpace` / `decodeClassification` (labels).
+
+ResNet-18 uses **DXO-native** state keys (`stem.*`, `stage{n}.block{i}.*`). Preview `forward` supports `32×32` NCHW → `[N,512]` features.
+
+```bash
+pnpm add @dxo/vision
+```
+
+```ts
+import { ResNet, LinearHead, compose } from '@dxo/vision';
+
+const backbone = new ResNet({ depth: 18 });
+const model = compose(backbone, new LinearHead({ output: 10 }));
+```
+
+Pretrained weight assets / torch→DXO conversion live in the separate `@dxo/resnet` package.

package/dist/basic-block.d.ts

@@ -0,0 +1,27 @@
+import type { Tensor } from '@dxo/core';
+import type { TensorStateSlice } from '@dxo/nn';
+import { BatchNorm2d, Conv2d, Module, Relu } from '@dxo/nn';
+/**
+ * DXO-native BasicBlock (not a torchvision key mirror).
+ * Keys: `{prefix}.conv1|bn1|conv2|bn2[.weight|.bias]` and optional `{prefix}.down.conv|bn`.
+ */
+export declare class BasicBlock extends Module {
+    readonly conv1: Conv2d;
+    readonly bn1: BatchNorm2d;
+    readonly conv2: Conv2d;
+    readonly bn2: BatchNorm2d;
+    readonly relu: Relu;
+    readonly downConv: Conv2d | null;
+    readonly downBn: BatchNorm2d | null;
+    readonly prefix: string;
+    constructor(prefix: string, inChannels: number, outChannels: number, opts?: {
+        stride?: number;
+        requiresGrad?: boolean;
+    });
+    forward(x: Tensor): Tensor;
+    state(): Promise<Record<string, TensorStateSlice>>;
+    loadState(saved: Record<string, TensorStateSlice>, opts?: {
+        requiresGrad?: boolean;
+    }): void;
+}
+//# sourceMappingURL=basic-block.d.ts.map

package/dist/basic-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-block.d.ts","sourceRoot":"","sources":["../src/basic-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5D;;;GAGG;AACH,qBAAa,UAAW,SAAQ,MAAM;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO;IAmB3H,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAUpB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IA2BxD,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;CAiBlG"}

package/dist/basic-block.js

@@ -0,0 +1,88 @@
+import { BatchNorm2d, Conv2d, Module, Relu } from '@dxo/nn';
+/**
+ * DXO-native BasicBlock (not a torchvision key mirror).
+ * Keys: `{prefix}.conv1|bn1|conv2|bn2[.weight|.bias]` and optional `{prefix}.down.conv|bn`.
+ */
+export class BasicBlock extends Module {
+    conv1;
+    bn1;
+    conv2;
+    bn2;
+    relu;
+    downConv;
+    downBn;
+    prefix;
+    constructor(prefix, inChannels, outChannels, opts = {}) {
+        super();
+        this.prefix = prefix;
+        const stride = opts.stride ?? 1;
+        const rg = opts.requiresGrad ?? true;
+        this.conv1 = new Conv2d(inChannels, outChannels, 3, { stride, padding: 1, requiresGrad: rg });
+        this.bn1 = new BatchNorm2d(outChannels, { requiresGrad: rg });
+        this.conv2 = new Conv2d(outChannels, outChannels, 3, { padding: 1, requiresGrad: rg });
+        this.bn2 = new BatchNorm2d(outChannels, { requiresGrad: rg });
+        this.relu = new Relu();
+        if (stride !== 1 || inChannels !== outChannels) {
+            this.downConv = new Conv2d(inChannels, outChannels, 1, { stride, requiresGrad: rg });
+            this.downBn = new BatchNorm2d(outChannels, { requiresGrad: rg });
+        }
+        else {
+            this.downConv = null;
+            this.downBn = null;
+        }
+    }
+    forward(x) {
+        let h = this.relu.forward(this.bn1.forward(this.conv1.forward(x)));
+        h = this.bn2.forward(this.conv2.forward(h));
+        let skip = x;
+        if (this.downConv && this.downBn) {
+            skip = this.downBn.forward(this.downConv.forward(x));
+        }
+        return this.relu.forward(h.add(skip));
+    }
+    async state() {
+        const p = this.prefix;
+        const c1 = await this.conv1.state();
+        const b1 = await this.bn1.state();
+        const c2 = await this.conv2.state();
+        const b2 = await this.bn2.state();
+        const out = {
+            [`${p}.conv1.weight`]: c1.weight,
+            [`${p}.conv1.bias`]: c1.bias,
+            [`${p}.bn1.weight`]: b1.weight,
+            [`${p}.bn1.bias`]: b1.bias,
+            [`${p}.conv2.weight`]: c2.weight,
+            [`${p}.conv2.bias`]: c2.bias,
+            [`${p}.bn2.weight`]: b2.weight,
+            [`${p}.bn2.bias`]: b2.bias,
+        };
+        if (this.downConv && this.downBn) {
+            const dc = await this.downConv.state();
+            const db = await this.downBn.state();
+            out[`${p}.down.conv.weight`] = dc.weight;
+            out[`${p}.down.conv.bias`] = dc.bias;
+            out[`${p}.down.bn.weight`] = db.weight;
+            out[`${p}.down.bn.bias`] = db.bias;
+        }
+        return out;
+    }
+    loadState(saved, opts = {}) {
+        const p = this.prefix;
+        const rg = opts.requiresGrad ?? true;
+        const need = (k) => {
+            const s = saved[k];
+            if (!s)
+                throw new Error(`BasicBlock.loadState: missing '${k}'`);
+            return s;
+        };
+        this.conv1.loadState({ weight: need(`${p}.conv1.weight`), bias: need(`${p}.conv1.bias`) }, { requiresGrad: rg });
+        this.bn1.loadState({ weight: need(`${p}.bn1.weight`), bias: need(`${p}.bn1.bias`) }, { requiresGrad: rg });
+        this.conv2.loadState({ weight: need(`${p}.conv2.weight`), bias: need(`${p}.conv2.bias`) }, { requiresGrad: rg });
+        this.bn2.loadState({ weight: need(`${p}.bn2.weight`), bias: need(`${p}.bn2.bias`) }, { requiresGrad: rg });
+        if (this.downConv && this.downBn) {
+            this.downConv.loadState({ weight: need(`${p}.down.conv.weight`), bias: need(`${p}.down.conv.bias`) }, { requiresGrad: rg });
+            this.downBn.loadState({ weight: need(`${p}.down.bn.weight`), bias: need(`${p}.down.bn.bias`) }, { requiresGrad: rg });
+        }
+    }
+}
+//# sourceMappingURL=basic-block.js.map

package/dist/basic-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-block.js","sourceRoot":"","sources":["../src/basic-block.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5D;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,MAAM;IACzB,KAAK,CAAS;IACd,GAAG,CAAc;IACjB,KAAK,CAAS;IACd,GAAG,CAAc;IACjB,IAAI,CAAO;IACX,QAAQ,CAAgB;IACxB,MAAM,CAAqB;IAC3B,MAAM,CAAS;IAExB,YAAY,MAAc,EAAE,UAAkB,EAAE,WAAmB,EAAE,OAAoD,EAAE;QACvH,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,KAAK,CAAC,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;YACrF,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO,CAAC,CAAS;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,GAAG,GAAqC;YAC1C,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,MAAM;YAChC,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,IAAI;YAC5B,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,MAAM;YAC9B,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI;YAC1B,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,MAAM;YAChC,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,IAAI;YAC5B,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,MAAM;YAC9B,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI;SAC7B,CAAC;QACF,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACvC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;YACzC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YACrC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QACvC,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAuC,EAAE,OAAmC,EAAE;QACpF,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;YACvB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO,CAAC,CAAC;QACb,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACjH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3G,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACjH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5H,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1H,CAAC;IACL,CAAC;CACJ"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/** Structured vision error with stable `code` for callers / verify. */
+export declare class VisionError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function unsupported(op: string, detail?: string): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,qBAAa,WAAY,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAG9D"}

package/dist/errors.js

@@ -0,0 +1,14 @@
+/** Structured vision error with stable `code` for callers / verify. */
+export class VisionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'VisionError';
+        this.code = code;
+    }
+}
+export function unsupported(op, detail) {
+    const suffix = detail ? `: ${detail}` : '';
+    throw new VisionError('UNSUPPORTED', `@dxo/vision ${op} is not implemented yet${suffix}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,OAAO,WAAY,SAAQ,KAAK;IACzB,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAED,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,MAAe;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE,eAAe,EAAE,0BAA0B,MAAM,EAAE,CAAC,CAAC;AAC9F,CAAC"}

package/dist/heads.d.ts

@@ -0,0 +1,36 @@
+import type { Tensor } from '@dxo/core';
+import { Module } from '@dxo/nn';
+import type { ResNet } from './resnet.js';
+import type { TensorPort } from './types.js';
+export type LinearHeadOptions = {
+    /** Feature dim; inferred from `input` port or by `compose` when omitted. */
+    input?: number | TensorPort;
+    /** Logits dim — class count for the head only, not ResNet. */
+    output: number;
+    bias?: boolean;
+};
+/** Feature → logits only; no label names / language. */
+export declare class LinearHead extends Module {
+    #private;
+    readonly outFeatures: number;
+    constructor(options: LinearHeadOptions);
+    get inFeatures(): number | undefined;
+    /** Wire feature size (used by `compose` when ctor omitted `input`). */
+    bindInput(inFeatures: number): void;
+    forward(features: Tensor): Tensor;
+    parameters(): Tensor[];
+}
+export type ClassifierOptions = {
+    backbone: ResNet;
+    head: LinearHead;
+};
+/** Backbone + head; `forward` returns logits Tensor. */
+export declare class Classifier extends Module {
+    readonly backbone: ResNet;
+    readonly head: LinearHead;
+    constructor(options: ClassifierOptions);
+    forward(image: Tensor): Tensor;
+}
+/** Compose ResNet + LinearHead into a Classifier. */
+export declare function compose(backbone: ResNet, head: LinearHead): Classifier;
+//# sourceMappingURL=heads.d.ts.map

package/dist/heads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heads.d.ts","sourceRoot":"","sources":["../src/heads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAU,MAAM,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAC5B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AASF,wDAAwD;AACxD,qBAAa,UAAW,SAAQ,MAAM;;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAIjB,OAAO,EAAE,iBAAiB;IAQtC,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,uEAAuE;IACvE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IASnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAWxB,UAAU,IAAI,MAAM,EAAE;CAGlC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF,wDAAwD;AACxD,qBAAa,UAAW,SAAQ,MAAM;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;gBAEd,OAAO,EAAE,iBAAiB;IAMtC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAIjC;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAWtE"}

package/dist/heads.js

@@ -0,0 +1,77 @@
+import { Linear, Module } from '@dxo/nn';
+import { VisionError } from './errors.js';
+function resolveInFeatures(input) {
+    if (typeof input === 'number')
+        return input;
+    const last = input.shape[input.shape.length - 1];
+    if (typeof last === 'number')
+        return last;
+    throw new VisionError('INVALID_HEAD_INPUT', 'LinearHead input port must end with a fixed feature dimension');
+}
+/** Feature → logits only; no label names / language. */
+export class LinearHead extends Module {
+    outFeatures;
+    #inFeatures;
+    #linear;
+    constructor(options) {
+        super();
+        this.outFeatures = options.output;
+        if (options.input !== undefined) {
+            this.bindInput(resolveInFeatures(options.input));
+        }
+    }
+    get inFeatures() {
+        return this.#inFeatures;
+    }
+    /** Wire feature size (used by `compose` when ctor omitted `input`). */
+    bindInput(inFeatures) {
+        if (this.#inFeatures !== undefined && this.#inFeatures !== inFeatures) {
+            throw new VisionError('HEAD_FEATURE_MISMATCH', `LinearHead already bound to inFeatures=${this.#inFeatures}, got ${inFeatures}`);
+        }
+        if (this.#linear && this.#inFeatures === inFeatures)
+            return;
+        this.#inFeatures = inFeatures;
+        this.#linear = new Linear(inFeatures, this.outFeatures);
+    }
+    forward(features) {
+        if (!this.#linear) {
+            const last = features.shape[features.shape.length - 1];
+            if (typeof last !== 'number') {
+                throw new VisionError('INVALID_HEAD_INPUT', 'cannot infer LinearHead input from features');
+            }
+            this.bindInput(last);
+        }
+        return this.#linear.forward(features);
+    }
+    parameters() {
+        return this.#linear ? this.#linear.parameters() : [];
+    }
+}
+/** Backbone + head; `forward` returns logits Tensor. */
+export class Classifier extends Module {
+    backbone;
+    head;
+    constructor(options) {
+        super();
+        this.backbone = options.backbone;
+        this.head = options.head;
+    }
+    forward(image) {
+        const features = this.backbone.forward(image);
+        return this.head.forward(features);
+    }
+}
+/** Compose ResNet + LinearHead into a Classifier. */
+export function compose(backbone, head) {
+    const expected = backbone.features();
+    const last = expected.shape[expected.shape.length - 1];
+    if (typeof last !== 'number') {
+        throw new VisionError('INVALID_BACKBONE', 'backbone features port must end with a fixed dim');
+    }
+    if (head.inFeatures !== undefined && head.inFeatures !== last) {
+        throw new VisionError('HEAD_FEATURE_MISMATCH', `LinearHead inFeatures=${head.inFeatures} does not match backbone features=${last}`);
+    }
+    head.bindInput(last);
+    return new Classifier({ backbone, head });
+}
+//# sourceMappingURL=heads.js.map

package/dist/heads.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @dxo/vision — developer preview (API unstable).
+ * Image types + ResNet backbone / heads / label decode.
+ * Not a closed vision-classify gate. Weights live in external `@dxo/resnet`.
+ */
+import type { ImageBuffer, Tensor } from '@dxo/core';
+export type { TensorStateSlice } from '@dxo/nn';
+export { VisionError } from './errors.js';
+export { Classifier, type ClassifierOptions, compose, LinearHead, type LinearHeadOptions, } from './heads.js';
+export { type ClassificationDecode, type ClassificationTopK, type DecodeClassificationOptions, decodeClassification, defineLabelSpace, type LabelSpace, type LabelSpaceOptions, } from './labels.js';
+export type { Neural, NeuralSignature } from './neural.js';
+export { defineResNet, ResNet } from './resnet.js';
+export type { Device, ResNetDepth, ResNetOptions, ResNetSignature, TensorPort, WeightSource, } from './types.js';
+export { resnetFeatureChannels } from './types.js';
+export type ColorSpace = 'rgb' | 'rgba' | 'gray' | 'bgr';
+export type ImageLayout = 'HWC' | 'CHW' | 'nchw' | 'nhwc';
+export type ImageDtype = 'u8' | 'u16' | 'f32';
+export type ImageTensorSpec = {
+    layout: 'nchw' | 'nhwc';
+    dtype: 'f32';
+    channels: 1 | 3 | 4;
+};
+export type ImageToTensorOptions = {
+    device?: 'cpu' | 'cuda' | 'metal';
+    copy?: boolean;
+    /** Target model layout; vision may transpose/cast before buffer view. */
+    layout?: 'nchw' | 'nhwc';
+};
+/**
+ * User-facing image with vision metadata. Does not own a parallel native engine.
+ * Pixel carrier is `@dxo/core` ImageBuffer (colorSpace/alphaMode on the buffer).
+ */
+export interface Image {
+    readonly width: number;
+    readonly height: number;
+    readonly channels: number;
+    readonly colorSpace: ColorSpace;
+    readonly layout: ImageLayout;
+    readonly dtype: ImageDtype;
+    readonly alpha: boolean;
+    readonly source?: {
+        kind: string;
+        uri?: string;
+    };
+    /** Underlying typed host buffer when available (no domain semantics). */
+    buffer(): ImageBuffer | undefined;
+    toTensor(options?: ImageToTensorOptions): Tensor;
+    dispose(): void;
+    ready(): Promise<void>;
+}
+export interface ImageBatch {
+    readonly size: number;
+    readonly images: readonly Image[];
+    toTensor(options?: ImageToTensorOptions): Tensor;
+    dispose(): void;
+}
+/** @deprecated Prefer {@link ImageTensorSpec} + {@link Image}. */
+export type LegacyImageTensorSpec = ImageTensorSpec;
+export declare function visionVersion(): string;
+export declare function unsupportedVisionApi(name: string): never;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @dxo/vision — developer preview (API unstable).
+ * Image types + ResNet backbone / heads / label decode.
+ * Not a closed vision-classify gate. Weights live in external `@dxo/resnet`.
+ */
+export { VisionError } from './errors.js';
+export { Classifier, compose, LinearHead, } from './heads.js';
+export { decodeClassification, defineLabelSpace, } from './labels.js';
+export { defineResNet, ResNet } from './resnet.js';
+export { resnetFeatureChannels } from './types.js';
+export function visionVersion() {
+    return 'dxo-vision@developer-preview';
+}
+export function unsupportedVisionApi(name) {
+    throw new Error(`@dxo/vision ${name} is not wired yet on this developer preview surface`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACH,UAAU,EAEV,OAAO,EACP,UAAU,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAIH,oBAAoB,EACpB,gBAAgB,GAGnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAkDnD,MAAM,UAAU,aAAa;IACzB,OAAO,8BAA8B,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC7C,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,qDAAqD,CAAC,CAAC;AAC9F,CAAC"}

package/dist/labels.d.ts

@@ -0,0 +1,30 @@
+import type { Tensor } from '@dxo/core';
+export type LabelSpace = {
+    id: string;
+    labels: readonly string[];
+    size: number;
+};
+export type LabelSpaceOptions = {
+    id: string;
+    labels: readonly string[];
+};
+export declare function defineLabelSpace(options: LabelSpaceOptions): LabelSpace;
+export type ClassificationTopK = {
+    index: number;
+    score: number;
+    label: string;
+};
+export type ClassificationDecode = {
+    labelSpaceId: string;
+    topK: ClassificationTopK[];
+};
+export type DecodeClassificationOptions = {
+    labels: LabelSpace;
+    topK?: number;
+};
+/**
+ * Decode logits with an external label space.
+ * Same logits may be decoded with different LabelSpaces (e.g. EN vs ZH).
+ */
+export declare function decodeClassification(logits: Tensor, options: DecodeClassificationOptions): Promise<ClassificationDecode>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAYvE;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6B9H"}

package/dist/labels.js

@@ -0,0 +1,47 @@
+import { VisionError } from './errors.js';
+export function defineLabelSpace(options) {
+    if (!options.id) {
+        throw new VisionError('INVALID_LABEL_SPACE', 'defineLabelSpace requires a non-empty id');
+    }
+    if (!Array.isArray(options.labels) || options.labels.length === 0) {
+        throw new VisionError('INVALID_LABEL_SPACE', 'defineLabelSpace requires a non-empty labels array');
+    }
+    return {
+        id: options.id,
+        labels: Object.freeze([...options.labels]),
+        size: options.labels.length,
+    };
+}
+/**
+ * Decode logits with an external label space.
+ * Same logits may be decoded with different LabelSpaces (e.g. EN vs ZH).
+ */
+export async function decodeClassification(logits, options) {
+    const { labels } = options;
+    const k = Math.max(1, Math.min(options.topK ?? 5, labels.size));
+    const shape = logits.shape;
+    if (shape.length < 1) {
+        throw new VisionError('INVALID_LOGITS', 'logits must be at least rank 1');
+    }
+    const classDim = shape[shape.length - 1];
+    if (classDim !== labels.size) {
+        throw new VisionError('LABEL_SIZE_MISMATCH', `logits class dim=${classDim} does not match labelSpace size=${labels.size}`);
+    }
+    const data = await logits.toArray();
+    // Use last row for batched [N, C]; full vector for [C].
+    const offset = shape.length === 1 ? 0 : (shape[0] - 1) * classDim;
+    const scores = data.slice(offset, offset + classDim);
+    const order = scores
+        .map((score, index) => ({ score, index }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, k);
+    return {
+        labelSpaceId: labels.id,
+        topK: order.map(({ score, index }) => ({
+            index,
+            score,
+            label: labels.labels[index],
+        })),
+    };
+}
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa1C,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACvD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,WAAW,CAAC,qBAAqB,EAAE,0CAA0C,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,WAAW,CAAC,qBAAqB,EAAE,oDAAoD,CAAC,CAAC;IACvG,CAAC;IACD,OAAO;QACH,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;KAC9B,CAAC;AACN,CAAC;AAkBD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc,EAAE,OAAoC;IAC3F,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAC1C,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CAAC,qBAAqB,EAAE,oBAAoB,QAAQ,mCAAmC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/H,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACpC,wDAAwD;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjB,OAAO;QACH,YAAY,EAAE,MAAM,CAAC,EAAE;QACvB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACnC,KAAK;YACL,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAE;SAC/B,CAAC,CAAC;KACN,CAAC;AACN,CAAC"}

package/dist/neural.d.ts

@@ -0,0 +1,19 @@
+import type { Tensor } from '@dxo/core';
+import type { TensorStateSlice } from '@dxo/nn';
+import type { TensorPort } from './types.js';
+/** Soft ports for graph connectivity — no labels / language. */
+export type NeuralSignature = {
+    input: Record<string, TensorPort>;
+    output: Record<string, TensorPort>;
+};
+/**
+ * Public DXO compute contract (Living `14`).
+ * `@dxo/nn` `Module` may remain as an implementation base; cross-package APIs use Neural.
+ */
+export interface Neural<I = Tensor, O = Tensor> {
+    forward(input: I): O;
+    readonly signature: NeuralSignature;
+    parameters(): Iterable<Tensor>;
+    state(): Promise<Record<string, TensorStateSlice>>;
+}
+//# sourceMappingURL=neural.d.ts.map

package/dist/neural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural.d.ts","sourceRoot":"","sources":["../src/neural.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM;IAC1C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,UAAU,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACtD"}

package/dist/neural.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=neural.js.map

package/dist/neural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural.js","sourceRoot":"","sources":["../src/neural.ts"],"names":[],"mappings":""}

package/dist/resnet.d.ts

@@ -0,0 +1,44 @@
+import type { Tensor } from '@dxo/core';
+import { BatchNorm2d, Conv2d, MaxPool2d, Module, Relu, type TensorStateSlice } from '@dxo/nn';
+import { BasicBlock } from './basic-block.js';
+import type { Neural } from './neural.js';
+import { type ResNetDepth, type ResNetOptions, type ResNetSignature, type TensorPort, type WeightSource } from './types.js';
+/**
+ * ResNet backbone Neural — `forward` yields feature Tensor, never labels.
+ * DXO-native parameter names (`stem.*` / `stageN.blockM.*`); not a torchvision key mirror.
+ * depth=18 is wired; other depths throw `UNSUPPORTED` on forward/state.
+ * Extends `@dxo/nn` Module for parameter walk; public contract is Neural.
+ */
+export declare class ResNet extends Module implements Neural<Tensor, Tensor> {
+    #private;
+    readonly depth: ResNetDepth;
+    readonly inChannels: number;
+    readonly zeroInitResidual: boolean;
+    readonly norm: 'batchnorm';
+    readonly device: ResNetOptions['device'];
+    readonly signature: ResNetSignature;
+    /** Present only when depth === 18. */
+    stemConv: Conv2d | null;
+    stemBn: BatchNorm2d | null;
+    stemRelu: Relu | null;
+    stemPool: MaxPool2d | null;
+    stages: BasicBlock[][] | null;
+    constructor(options?: ResNetOptions);
+    features(): TensorPort;
+    freeze(): void;
+    unfreeze(): void;
+    get trainable(): boolean;
+    /** Flat DXO state keys (depth=18 only). */
+    parameterNames(): string[];
+    state(): Promise<Record<string, TensorStateSlice>>;
+    loadState(saved: Record<string, TensorStateSlice>, opts?: {
+        requiresGrad?: boolean;
+    }): void;
+    forward(image: Tensor): Tensor;
+    load(_weights: WeightSource, _options?: {
+        scope?: 'all' | 'backbone';
+    }): Promise<void>;
+    ready(): Promise<void>;
+}
+export declare function defineResNet(options?: ResNetOptions): ResNet;
+//# sourceMappingURL=resnet.d.ts.map

package/dist/resnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resnet.d.ts","sourceRoot":"","sources":["../src/resnet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,UAAU,EACf,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AA0BpB;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAO,YAAW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;IAChE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAIpC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAClC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC7B,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAQ;IAClC,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAQ;gBAEzB,OAAO,GAAE,aAAkB;IAuCvC,QAAQ,IAAI,UAAU;IAItB,MAAM,IAAI,IAAI;IAId,QAAQ,IAAI,IAAI;IAIhB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,2CAA2C;IAC3C,cAAc,IAAI,MAAM,EAAE;IA2BpB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAoBxD,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAmB/F,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA2BxB,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAE5D"}

package/dist/resnet.js

@@ -0,0 +1,190 @@
+import { BatchNorm2d, Conv2d, MaxPool2d, Module, Relu } from '@dxo/nn';
+import { BasicBlock } from './basic-block.js';
+import { unsupported, VisionError } from './errors.js';
+import { resnetFeatureChannels, } from './types.js';
+/** DXO-native ResNet-18 layout: stages [2,2,2,2], channels 64→512. No classification `fc`. */
+const RESNET18_BLOCKS = [2, 2, 2, 2];
+const RESNET18_CHANNELS = [64, 128, 256, 512];
+function buildSignature(depth, inChannels) {
+    const features = resnetFeatureChannels(depth);
+    return {
+        input: {
+            image: {
+                name: 'image',
+                dtype: 'f32',
+                shape: ['batch', inChannels, 'height', 'width'],
+            },
+        },
+        output: {
+            features: {
+                name: 'features',
+                dtype: 'f32',
+                shape: ['batch', features],
+            },
+        },
+    };
+}
+/**
+ * ResNet backbone Neural — `forward` yields feature Tensor, never labels.
+ * DXO-native parameter names (`stem.*` / `stageN.blockM.*`); not a torchvision key mirror.
+ * depth=18 is wired; other depths throw `UNSUPPORTED` on forward/state.
+ * Extends `@dxo/nn` Module for parameter walk; public contract is Neural.
+ */
+export class ResNet extends Module {
+    depth;
+    inChannels;
+    zeroInitResidual;
+    norm;
+    device;
+    signature;
+    #trainable;
+    #ready = true;
+    /** Present only when depth === 18. */
+    stemConv = null;
+    stemBn = null;
+    stemRelu = null;
+    stemPool = null;
+    stages = null;
+    constructor(options = {}) {
+        super();
+        this.depth = options.depth ?? 18;
+        this.inChannels = options.inChannels ?? 3;
+        this.zeroInitResidual = options.zeroInitResidual ?? false;
+        this.norm = options.norm ?? 'batchnorm';
+        this.device = options.device ?? 'cpu';
+        this.#trainable = options.trainable ?? true;
+        this.signature = buildSignature(this.depth, this.inChannels);
+        if (options.weights && options.weights !== 'none') {
+            this.#ready = false;
+        }
+        if (this.depth === 18) {
+            this.#buildResNet18(options.trainable ?? true);
+        }
+    }
+    #buildResNet18(requiresGrad) {
+        const rg = requiresGrad;
+        this.stemConv = new Conv2d(this.inChannels, 64, 7, { stride: 2, padding: 3, requiresGrad: rg });
+        this.stemBn = new BatchNorm2d(64, { requiresGrad: rg });
+        this.stemRelu = new Relu();
+        this.stemPool = new MaxPool2d(3, { stride: 2, padding: 1 });
+        const stages = [];
+        let inCh = 64;
+        for (let s = 0; s < RESNET18_BLOCKS.length; s++) {
+            const outCh = RESNET18_CHANNELS[s];
+            const nBlocks = RESNET18_BLOCKS[s];
+            const stage = [];
+            for (let b = 0; b < nBlocks; b++) {
+                const stride = s > 0 && b === 0 ? 2 : 1;
+                stage.push(new BasicBlock(`stage${s + 1}.block${b}`, inCh, outCh, { stride, requiresGrad: rg }));
+                inCh = outCh;
+            }
+            stages.push(stage);
+        }
+        this.stages = stages;
+    }
+    features() {
+        return this.signature.output.features;
+    }
+    freeze() {
+        this.#trainable = false;
+    }
+    unfreeze() {
+        this.#trainable = true;
+    }
+    get trainable() {
+        return this.#trainable;
+    }
+    /** Flat DXO state keys (depth=18 only). */
+    parameterNames() {
+        if (this.depth !== 18 || !this.stages) {
+            return [];
+        }
+        // Synchronous name list without reading tensor data.
+        const names = ['stem.conv.weight', 'stem.conv.bias', 'stem.bn.weight', 'stem.bn.bias'];
+        for (const stage of this.stages) {
+            for (const block of stage) {
+                const p = block.prefix;
+                names.push(`${p}.conv1.weight`, `${p}.conv1.bias`, `${p}.bn1.weight`, `${p}.bn1.bias`, `${p}.conv2.weight`, `${p}.conv2.bias`, `${p}.bn2.weight`, `${p}.bn2.bias`);
+                if (block.downConv) {
+                    names.push(`${p}.down.conv.weight`, `${p}.down.conv.bias`, `${p}.down.bn.weight`, `${p}.down.bn.bias`);
+                }
+            }
+        }
+        return names;
+    }
+    async state() {
+        if (this.depth !== 18 || !this.stemConv || !this.stemBn || !this.stages) {
+            unsupported('ResNet.state', `depth=${this.depth}; only depth=18 state schema is wired`);
+        }
+        const c = await this.stemConv.state();
+        const b = await this.stemBn.state();
+        const out = {
+            'stem.conv.weight': c.weight,
+            'stem.conv.bias': c.bias,
+            'stem.bn.weight': b.weight,
+            'stem.bn.bias': b.bias,
+        };
+        for (const stage of this.stages) {
+            for (const block of stage) {
+                Object.assign(out, await block.state());
+            }
+        }
+        return out;
+    }
+    loadState(saved, opts = {}) {
+        if (this.depth !== 18 || !this.stemConv || !this.stemBn || !this.stages) {
+            unsupported('ResNet.loadState', `depth=${this.depth}; only depth=18 state schema is wired`);
+        }
+        const rg = opts.requiresGrad ?? true;
+        const need = (k) => {
+            const s = saved[k];
+            if (!s)
+                throw new VisionError('MISSING_STATE_KEY', `ResNet.loadState: missing '${k}'`);
+            return s;
+        };
+        this.stemConv.loadState({ weight: need('stem.conv.weight'), bias: need('stem.conv.bias') }, { requiresGrad: rg });
+        this.stemBn.loadState({ weight: need('stem.bn.weight'), bias: need('stem.bn.bias') }, { requiresGrad: rg });
+        for (const stage of this.stages) {
+            for (const block of stage) {
+                block.loadState(saved, { requiresGrad: rg });
+            }
+        }
+    }
+    forward(image) {
+        if (this.depth !== 18 || !this.stemConv || !this.stemBn || !this.stemRelu || !this.stemPool || !this.stages) {
+            unsupported('ResNet.forward', `depth=${this.depth}; only depth=18 forward is wired`);
+        }
+        if (image.shape.length !== 4) {
+            throw new VisionError('MODEL_INPUT_SHAPE_MISMATCH', `ResNet.forward expects NCHW rank 4, got [${image.shape.join(',')}]`);
+        }
+        if (image.shape[1] !== this.inChannels) {
+            throw new VisionError('MODEL_INPUT_SHAPE_MISMATCH', `ResNet.forward expected ${this.inChannels} channels, got ${image.shape[1]}`);
+        }
+        let h = this.stemRelu.forward(this.stemBn.forward(this.stemConv.forward(image)));
+        h = this.stemPool.forward(h);
+        for (const stage of this.stages) {
+            for (const block of stage) {
+                h = block.forward(h);
+            }
+        }
+        const n = h.shape[0];
+        const c = h.shape[1];
+        const spatial = (h.shape[2] ?? 1) * (h.shape[3] ?? 1);
+        if (spatial !== 1) {
+            unsupported('ResNet.forward', `final spatial ${h.shape[2]}x${h.shape[3]} != 1x1 (use 32x32 input for depth=18 without avgPool)`);
+        }
+        return h.reshape([n, c]);
+    }
+    async load(_weights, _options) {
+        unsupported('ResNet.load', 'use loadWeights in a later preview; remote sources not wired');
+    }
+    async ready() {
+        if (!this.#ready) {
+            unsupported('ResNet.ready', 'deferred weight load not wired');
+        }
+    }
+}
+export function defineResNet(options) {
+    return new ResNet(options);
+}
+//# sourceMappingURL=resnet.js.map

package/dist/resnet.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,44 @@
+import type { Device } from '@dxo/core';
+import type { NeuralSignature } from './neural.js';
+/** Soft graph port — connectivity only; no labels / language. */
+export type TensorPort = {
+    name: string;
+    dtype: 'f32';
+    /** Symbolic dims; numbers are fixed, strings are dynamic axes. */
+    shape: ReadonlyArray<number | string>;
+};
+/** External weight locator (resolved by hub / external `@dxo/resnet` later). */
+export type WeightSource = {
+    provider: string;
+    repo: string;
+    revision?: string;
+    path: string;
+} | {
+    path: string;
+};
+export type { Device };
+export type ResNetDepth = 18 | 34 | 50 | 101 | 152;
+/**
+ * ResNet constructor options.
+ * Intentionally has **no** `classes` / `numClasses` / label fields.
+ */
+export type ResNetOptions = {
+    depth?: ResNetDepth;
+    inChannels?: number;
+    zeroInitResidual?: boolean;
+    norm?: 'batchnorm';
+    weights?: WeightSource | 'none';
+    device?: Device;
+    trainable?: boolean;
+};
+export type ResNetSignature = NeuralSignature & {
+    input: {
+        image: TensorPort;
+    };
+    output: {
+        features: TensorPort;
+    };
+};
+/** Feature channel count after GAP for classic ResNet depths. */
+export declare function resnetFeatureChannels(depth: ResNetDepth): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACzC,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAClB;IACI,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvB,YAAY,EAAE,MAAM,EAAE,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC5C,KAAK,EAAE;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;IAC7B,MAAM,EAAE;QAAE,QAAQ,EAAE,UAAU,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAchE"}

package/dist/types.js

@@ -0,0 +1,17 @@
+/** Feature channel count after GAP for classic ResNet depths. */
+export function resnetFeatureChannels(depth) {
+    switch (depth) {
+        case 18:
+        case 34:
+            return 512;
+        case 50:
+        case 101:
+        case 152:
+            return 2048;
+        default: {
+            const _exhaustive = depth;
+            return _exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4CA,iEAAiE;AACjE,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACpD,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,EAAE,CAAC;QACR,KAAK,EAAE;YACH,OAAO,GAAG,CAAC;QACf,KAAK,EAAE,CAAC;QACR,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACJ,OAAO,IAAI,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,OAAO,WAAW,CAAC;QACvB,CAAC;IACL,CAAC;AACL,CAAC"}

package/package.json

@@ -1,10 +1,47 @@
 {
-  "name": "@dxo/vision",
-  "version": "0.0.0",
-  "description": "DXO placeholder — not for production use.",
-  "license": "MIT",
-  "private": false,
-  "files": [
-    "README.md"
-  ]
+    "name": "@dxo/vision",
+    "version": "0.0.12",
+    "type": "module",
+    "description": "DXO vision models and task adapters (developer preview, API unstable)",
+    "license": "Apache-2.0",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.json"
+    },
+    "dependencies": {
+        "@dxo/core": "0.0.12",
+        "@dxo/nn": "0.0.12"
+    },
+    "keywords": [
+        "dxo",
+        "vision",
+        "resnet",
+        "image",
+        "typescript",
+        "deep-learning",
+        "developer-preview"
+    ],
+    "homepage": "https://github.com/ai4waifu/dxo-framework#readme",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/ai4waifu/dxo-framework.git",
+        "directory": "projects/runtimes/dxo-vision"
+    },
+    "bugs": {
+        "url": "https://github.com/ai4waifu/dxo-framework/issues"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
 }