@aardworx/wombat.rendering 0.6.0 → 0.7.1

package/dist/core/bufferView.d.ts

@@ -1,15 +1,77 @@
-import type { IBuffer } from "./buffer.js";
+import type { aval } from "@aardworx/wombat.adaptive";
+import { IBuffer } from "./buffer.js";
+import { ElementType } from "./elementType.js";
+import type { ElementKind } from "./elementType.js";
 export interface BufferView {
-    readonly buffer: IBuffer;
-    /** Byte offset into `buffer` where the view starts. */
-    readonly offset: number;
-    /** Number of elements (not bytes) in the view. */
-    readonly count: number;
-    /** Stride between consecutive elements, in bytes. */
-    readonly stride: number;
-    /** Vertex format — used when bound as a vertex / instance attribute. */
-    readonly format: GPUVertexFormat | GPUIndexFormat;
-    /** Index format — used when bound as an index buffer. Overrides `format`. */
-    readonly indexFormat?: GPUIndexFormat;
+    /** Adaptive buffer source — content changes flow through this aval. */
+    readonly buffer: aval<IBuffer>;
+    /** Element kind (singleton from the `ElementType` namespace). */
+    readonly elementType: ElementType;
+    /** Byte offset into `buffer` where the view starts. Default 0. */
+    readonly offset?: number;
+    /** Stride between consecutive elements in bytes. 0 = tight (= `elementType.byteSize`). */
+    readonly stride?: number;
+    /** Integer attributes treated as normalized fixed-point floats. Default false. */
+    readonly normalized?: boolean;
+    /**
+     * Present iff this view was constructed from a single adaptive
+     * value (see `BufferView.ofValue`). Lets the backend lower the
+     * binding to a uniform instead of a per-vertex/per-instance
+     * attribute.
+     */
+    readonly singleValue?: aval<unknown>;
 }
+interface OfArrayOptions {
+    readonly elementType?: ElementType;
+    readonly offset?: number;
+    readonly stride?: number;
+    readonly normalized?: boolean;
+}
+interface OfBufferOptions {
+    readonly offset?: number;
+    readonly stride?: number;
+    readonly normalized?: boolean;
+}
+export declare const BufferView: {
+    /**
+     * Build a view from a wombat.base packed array (`V3fArray`,
+     * `Uint16Array`, …) or an `aval<…>` of one. The element kind is
+     * inferred from the array's constructor identity; pass it
+     * explicitly via `opts.elementType` for unusual cases (e.g. a
+     * `Float32Array` interpreted as packed `V4f` with `ElementType.V4f`).
+     */
+    readonly ofArray: <T>(a: aval<T> | T, opts?: OfArrayOptions) => BufferView;
+    /**
+     * Build a view that broadcasts a single adaptive value to every
+     * vertex / instance. The runtime detects the `singleValue` field
+     * and lowers it to a uniform binding instead of a per-element
+     * attribute. The `buffer` aval still carries packed bytes for
+     * backends that don't recognize the fast path.
+     *
+     * The `T` parameter on `ElementKind<T>` flows through to the
+     * value type — passing `ElementType.V4f` requires `T = V4f` here.
+     */
+    readonly ofValue: <T>(v: aval<T> | T, elementType: ElementKind<T>) => BufferView;
+    /**
+     * Build a view backed by a user-supplied `GPUBuffer`. The
+     * runtime binds it directly without an upload step.
+     */
+    readonly ofGPU: (buffer: aval<GPUBuffer> | GPUBuffer, elementType: ElementType, opts?: OfBufferOptions) => BufferView;
+    /**
+     * Wrap an already-built `aval<IBuffer>` with explicit element
+     * kind. Used by callers that compute their own `IBuffer` (e.g.
+     * compositing multiple attributes into one packed buffer).
+     */
+    readonly ofBuffer: (buffer: aval<IBuffer>, elementType: ElementType, opts?: OfBufferOptions) => BufferView;
+    /** Byte offset, defaulting to 0. */
+    readonly offsetOf: (v: BufferView) => number;
+    /**
+     * Stride in bytes — `v.stride` if set and non-zero, otherwise
+     * tight from `elementType.byteSize`.
+     */
+    readonly strideOf: (v: BufferView) => number;
+    /** Whether this view is a single-value broadcast. */
+    readonly isSingleValue: (v: BufferView) => boolean;
+};
+export {};
 //# sourceMappingURL=bufferView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bufferView.d.ts","sourceRoot":"","sources":["../../src/core/bufferView.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;CACvC"}
+{"version":3,"file":"bufferView.d.ts","sourceRoot":"","sources":["../../src/core/bufferView.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;CACtC;AAMD,UAAU,cAAc;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAgBD,eAAO,MAAM,UAAU;IACrB;;;;;;OAMG;uBACK,CAAC,KACJ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SACR,cAAc,KACnB,UAAU;IAmBb;;;;;;;;;OASG;uBACK,CAAC,KACJ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eACD,WAAW,CAAC,CAAC,CAAC,KAC1B,UAAU;IAeb;;;OAGG;6BAEO,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,eACtB,WAAW,SAClB,eAAe,KACpB,UAAU;IAYb;;;;OAIG;gCAEO,IAAI,CAAC,OAAO,CAAC,eACR,WAAW,SAClB,eAAe,KACpB,UAAU;IAYb,oCAAoC;2BACxB,UAAU,KAAG,MAAM;IAC/B;;;OAGG;2BACS,UAAU,KAAG,MAAM;IAK/B,qDAAqD;gCACpC,UAAU,KAAG,OAAO;CAG7B,CAAC"}

package/dist/core/bufferView.js

@@ -1,12 +1,190 @@
 // BufferView — a typed slice of an `IBuffer` used as a vertex
-// attribute, instance attribute, or index source. The buffer
-// itself can be a real GPU buffer or host-side memory; the
-// runtime handles upload transparently.
+// attribute, instance attribute, or index source. Mirrors
+// Aardvark.Rendering's `BufferView`:
 //
-// `format` carries the WebGPU vertex format when this view is
-// bound as a vertex / instance attribute. `indexFormat` is set
-// when the view is bound as an index buffer; in that case
-// `format` is ignored. Both are optional so callers don't have
-// to fill in the irrelevant one.
-export {};
+//   - `buffer` is `aval<IBuffer>` so per-frame content changes flow
+//     through normal aval marking without reshaping the view.
+//   - `elementType` is a singleton token from the `ElementType`
+//     namespace (e.g. `ElementType.V3f`, `ElementType.U16`); the
+//     backend reads `byteSize` / `vertexFormat` / `indexFormat`
+//     directly off it.
+//   - `singleValue` is set when the view was constructed from a
+//     single adaptive value broadcast to all instances/vertices —
+//     the runtime can lower it to a uniform binding instead of a
+//     per-vertex/per-instance attribute.
+//
+// The view itself is plain (not wrapped in `aval`). Structural
+// fields are eager so the binding plan / pipeline layout can be
+// computed without forcing.
+import { AVal } from "@aardworx/wombat.adaptive";
+import { IBuffer } from "./buffer.js";
+import { ElementType } from "./elementType.js";
+function isAval(v) {
+    return typeof v === "object" && v !== null
+        && typeof v.getValue === "function";
+}
+function arrayToHostBytes(arr) {
+    // wombat.base packed array types expose `.buffer: ArrayBuffer`.
+    const a = arr;
+    if (a.buffer instanceof ArrayBuffer)
+        return a.buffer;
+    // Native TypedArray.
+    if (ArrayBuffer.isView(arr))
+        return arr;
+    throw new Error("BufferView.ofArray: unsupported array source");
+}
+export const BufferView = {
+    /**
+     * Build a view from a wombat.base packed array (`V3fArray`,
+     * `Uint16Array`, …) or an `aval<…>` of one. The element kind is
+     * inferred from the array's constructor identity; pass it
+     * explicitly via `opts.elementType` for unusual cases (e.g. a
+     * `Float32Array` interpreted as packed `V4f` with `ElementType.V4f`).
+     */
+    ofArray(a, opts = {}) {
+        const adaptive = isAval(a) ? a : AVal.constant(a);
+        // One-time element-kind discovery from the source's constructor.
+        // Marked allow-force: structural-eager, runs at construction only;
+        // per-frame content changes flow through `buffer` without re-running.
+        const sample = adaptive.force( /* allow-force */);
+        const elementType = opts.elementType ?? ElementType.fromArray(sample);
+        const buffer = adaptive.map((arr) => IBuffer.fromHost(arrayToHostBytes(arr)));
+        return {
+            buffer,
+            elementType,
+            ...(opts.offset !== undefined ? { offset: opts.offset } : {}),
+            ...(opts.stride !== undefined ? { stride: opts.stride } : {}),
+            ...(opts.normalized !== undefined ? { normalized: opts.normalized } : {}),
+        };
+    },
+    /**
+     * Build a view that broadcasts a single adaptive value to every
+     * vertex / instance. The runtime detects the `singleValue` field
+     * and lowers it to a uniform binding instead of a per-element
+     * attribute. The `buffer` aval still carries packed bytes for
+     * backends that don't recognize the fast path.
+     *
+     * The `T` parameter on `ElementKind<T>` flows through to the
+     * value type — passing `ElementType.V4f` requires `T = V4f` here.
+     */
+    ofValue(v, elementType) {
+        const adaptive = isAval(v) ? v : AVal.constant(v);
+        const buffer = adaptive.map((value) => {
+            const bytes = elementType.byteSize;
+            const ab = new ArrayBuffer(bytes);
+            packSingle(value, elementType, ab);
+            return IBuffer.fromHost(ab);
+        });
+        return {
+            buffer,
+            elementType,
+            singleValue: adaptive,
+        };
+    },
+    /**
+     * Build a view backed by a user-supplied `GPUBuffer`. The
+     * runtime binds it directly without an upload step.
+     */
+    ofGPU(buffer, elementType, opts = {}) {
+        const adaptive = isAval(buffer) ? buffer : AVal.constant(buffer);
+        const ibuffer = adaptive.map((b) => IBuffer.fromGPU(b));
+        return {
+            buffer: ibuffer,
+            elementType,
+            ...(opts.offset !== undefined ? { offset: opts.offset } : {}),
+            ...(opts.stride !== undefined ? { stride: opts.stride } : {}),
+            ...(opts.normalized !== undefined ? { normalized: opts.normalized } : {}),
+        };
+    },
+    /**
+     * Wrap an already-built `aval<IBuffer>` with explicit element
+     * kind. Used by callers that compute their own `IBuffer` (e.g.
+     * compositing multiple attributes into one packed buffer).
+     */
+    ofBuffer(buffer, elementType, opts = {}) {
+        return {
+            buffer,
+            elementType,
+            ...(opts.offset !== undefined ? { offset: opts.offset } : {}),
+            ...(opts.stride !== undefined ? { stride: opts.stride } : {}),
+            ...(opts.normalized !== undefined ? { normalized: opts.normalized } : {}),
+        };
+    },
+    // ---------- accessors ----------
+    /** Byte offset, defaulting to 0. */
+    offsetOf(v) { return v.offset ?? 0; },
+    /**
+     * Stride in bytes — `v.stride` if set and non-zero, otherwise
+     * tight from `elementType.byteSize`.
+     */
+    strideOf(v) {
+        return v.stride !== undefined && v.stride > 0
+            ? v.stride
+            : v.elementType.byteSize;
+    },
+    /** Whether this view is a single-value broadcast. */
+    isSingleValue(v) {
+        return v.singleValue !== undefined;
+    },
+};
+// ---------------------------------------------------------------------------
+// Single-value packing — write one element of `t` into a fresh
+// ArrayBuffer. The runtime usually shortcuts this via `singleValue`
+// (lifted to a uniform); this path runs only for backends that
+// don't recognise the broadcast.
+// ---------------------------------------------------------------------------
+function packSingle(value, t, dst) {
+    const v = value;
+    if (v._data !== undefined) {
+        const src = v._data;
+        // Match by name on the singleton — concise and minifier-safe
+        // since the names are baked at the singleton's construction.
+        const name = t.name;
+        if (name === "f32"
+            || name.startsWith("v") && name.endsWith("f")
+            || name.startsWith("m") && name.endsWith("f")) {
+            const out = new Float32Array(dst);
+            for (let i = 0; i < src.length; i++)
+                out[i] = src[i];
+            return;
+        }
+        if (name === "i32" || (name.startsWith("v") && name.endsWith("i"))) {
+            const out = new Int32Array(dst);
+            for (let i = 0; i < src.length; i++)
+                out[i] = src[i];
+            return;
+        }
+        if (name === "u32" || (name.startsWith("v") && name.endsWith("u"))) {
+            const out = new Uint32Array(dst);
+            for (let i = 0; i < src.length; i++)
+                out[i] = src[i];
+            return;
+        }
+    }
+    // Scalars and unbranded values.
+    switch (t.name) {
+        case "f32":
+            new Float32Array(dst)[0] = value;
+            return;
+        case "u32":
+            new Uint32Array(dst)[0] = value;
+            return;
+        case "i32":
+            new Int32Array(dst)[0] = value;
+            return;
+        case "u16":
+            new Uint16Array(dst)[0] = value;
+            return;
+        case "i16":
+            new Int16Array(dst)[0] = value;
+            return;
+        case "u8":
+            new Uint8Array(dst)[0] = value;
+            return;
+        case "i8":
+            new Int8Array(dst)[0] = value;
+            return;
+    }
+    throw new Error(`BufferView.ofValue: cannot pack ${typeof value} as ${t.name}`);
+}
 //# sourceMappingURL=bufferView.js.map

package/dist/core/bufferView.js.map

@@ -1 +1 @@
-{"version":3,"file":"bufferView.js","sourceRoot":"","sources":["../../src/core/bufferView.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,6DAA6D;AAC7D,2DAA2D;AAC3D,wCAAwC;AACxC,EAAE;AACF,8DAA8D;AAC9D,+DAA+D;AAC/D,0DAA0D;AAC1D,+DAA+D;AAC/D,iCAAiC"}
+{"version":3,"file":"bufferView.js","sourceRoot":"","sources":["../../src/core/bufferView.ts"],"names":[],"mappings":"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"}

package/dist/core/elementType.d.ts

@@ -0,0 +1,81 @@
+import type { V2f, V3f, V4f, M22f, M33f, M44f, V2i, V3i, V4i } from "@aardworx/wombat.base";
+/**
+ * Phantom-typed token describing a single element's data type. The
+ * `T` parameter is a brand only — it carries the source-side type
+ * (V3f, M44f, number, …) into the type system at zero runtime cost.
+ *
+ * Identity equality is the equality used everywhere in the renderer
+ * (group keys, bind plans). All instances are singletons under the
+ * `ElementType` namespace below.
+ */
+export declare class ElementKind<T> {
+    /** Short human-readable tag (e.g. `"v3f"`, `"u16"`). */
+    readonly name: string;
+    /** Size of one element in bytes. */
+    readonly byteSize: number;
+    /** GPUVertexFormat for use as a vertex attribute. `undefined` for matrix and non-vertex types. */
+    readonly vertexFormat: GPUVertexFormat | undefined;
+    /** GPUIndexFormat when used as an index buffer. `undefined` unless the type is `u16` / `u32`. */
+    readonly indexFormat: GPUIndexFormat | undefined;
+    constructor(
+    /** Short human-readable tag (e.g. `"v3f"`, `"u16"`). */
+    name: string, 
+    /** Size of one element in bytes. */
+    byteSize: number, 
+    /** GPUVertexFormat for use as a vertex attribute. `undefined` for matrix and non-vertex types. */
+    vertexFormat: GPUVertexFormat | undefined, 
+    /** GPUIndexFormat when used as an index buffer. `undefined` unless the type is `u16` / `u32`. */
+    indexFormat: GPUIndexFormat | undefined);
+    /** Phantom — never read at runtime. Forces TS to track T. */
+    readonly _brand: T;
+    toString(): string;
+}
+/**
+ * `ElementType` doubles as a type alias (the structural shape) and
+ * a value namespace (the singleton tokens). `ElementType` in type
+ * position is `ElementKind<unknown>`; in value position it's the
+ * collection of singletons below.
+ */
+export type ElementType = ElementKind<unknown>;
+/**
+ * Construct a vertex view; throws if the kind has no vertex format
+ * (matrix / unsupported type).
+ */
+declare function asVertexFormat(t: ElementType): GPUVertexFormat;
+declare function asIndexFormat(t: ElementType): GPUIndexFormat;
+declare function fromArray(arr: unknown): ElementType;
+/**
+ * Singleton tokens + helpers. Most call sites use the singleton
+ * directly (`ElementType.V3f`); the helpers are kept on the
+ * namespace so `import { ElementType }` is the only import you
+ * need.
+ */
+export declare const ElementType: {
+    readonly V2f: ElementKind<V2f>;
+    readonly V3f: ElementKind<V3f>;
+    readonly V4f: ElementKind<V4f>;
+    readonly M22f: ElementKind<M22f>;
+    readonly M33f: ElementKind<M33f>;
+    readonly M44f: ElementKind<M44f>;
+    readonly V2i: ElementKind<V2i>;
+    readonly V3i: ElementKind<V3i>;
+    readonly V4i: ElementKind<V4i>;
+    readonly V2u: ElementKind<V2i>;
+    readonly V3u: ElementKind<V3i>;
+    readonly V4u: ElementKind<V4i>;
+    readonly F32: ElementKind<number>;
+    readonly U32: ElementKind<number>;
+    readonly I32: ElementKind<number>;
+    readonly U16: ElementKind<number>;
+    readonly I16: ElementKind<number>;
+    readonly U8: ElementKind<number>;
+    readonly I8: ElementKind<number>;
+    /** Infer from a wombat.base packed array or a native TypedArray. */
+    readonly fromArray: typeof fromArray;
+    /** GPUVertexFormat for `t`; throws if `t` has no vertex form. */
+    readonly toVertexFormat: typeof asVertexFormat;
+    /** GPUIndexFormat for `t`; throws if `t` is not `u16` / `u32`. */
+    readonly toIndexFormat: typeof asIndexFormat;
+};
+export {};
+//# sourceMappingURL=elementType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elementType.d.ts","sourceRoot":"","sources":["../../src/core/elementType.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAC/C,MAAM,uBAAuB,CAAC;AAW/B;;;;;;;;GAQG;AACH,qBAAa,WAAW,CAAC,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,kGAAkG;IAClG,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS;IAClD,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,SAAS;;IAPhD,wDAAwD;IAC/C,IAAI,EAAE,MAAM;IACrB,oCAAoC;IAC3B,QAAQ,EAAE,MAAM;IACzB,kGAAkG;IACzF,YAAY,EAAE,eAAe,GAAG,SAAS;IAClD,iGAAiG;IACxF,WAAW,EAAE,cAAc,GAAG,SAAS;IAGlD,6DAA6D;IAC7D,SAAiB,MAAM,EAAE,CAAC,CAAC;IAE3B,QAAQ,IAAI,MAAM;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AA0B/C;;;GAGG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,eAAe,CAQvD;AAED,iBAAS,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,cAAc,CAKrD;AAuBD,iBAAS,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAc5C;AAMD;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;IAatB,oEAAoE;;IAEpE,iEAAiE;;IAEjE,kEAAkE;;CAE1D,CAAC"}

package/dist/core/elementType.js

@@ -0,0 +1,151 @@
+// ElementType — runtime token + structural metadata for the data
+// type of a single element in a `BufferView`. The TypeScript-side
+// equivalent of F#'s `typeof<T>` / `System.Type`: a value (not a
+// string tag) carrying byte size, vertex / index format, and a
+// phantom type parameter that flows through to `BufferView<T>`-
+// generic call sites.
+//
+// All entries are exposed as singleton properties on `ElementType`:
+//
+//   ElementType.V3f         // ElementKind<V3f>
+//   ElementType.U16         // ElementKind<number>
+//   ElementType.M44f        // ElementKind<M44f>
+//
+// `BufferView.ofArray` infers the kind from the source array's
+// constructor identity (V3fArray → ElementType.V3f, Float32Array →
+// ElementType.F32, etc.) so the explicit second argument is rarely
+// needed.
+import { V2fArray, V3fArray, V4fArray, V2iArray, V3iArray, V4iArray, V2uiArray, V3uiArray, V4uiArray, } from "@aardworx/wombat.base";
+// ---------------------------------------------------------------------------
+// ElementKind<T>
+// ---------------------------------------------------------------------------
+/**
+ * Phantom-typed token describing a single element's data type. The
+ * `T` parameter is a brand only — it carries the source-side type
+ * (V3f, M44f, number, …) into the type system at zero runtime cost.
+ *
+ * Identity equality is the equality used everywhere in the renderer
+ * (group keys, bind plans). All instances are singletons under the
+ * `ElementType` namespace below.
+ */
+export class ElementKind {
+    name;
+    byteSize;
+    vertexFormat;
+    indexFormat;
+    constructor(
+    /** Short human-readable tag (e.g. `"v3f"`, `"u16"`). */
+    name, 
+    /** Size of one element in bytes. */
+    byteSize, 
+    /** GPUVertexFormat for use as a vertex attribute. `undefined` for matrix and non-vertex types. */
+    vertexFormat, 
+    /** GPUIndexFormat when used as an index buffer. `undefined` unless the type is `u16` / `u32`. */
+    indexFormat) {
+        this.name = name;
+        this.byteSize = byteSize;
+        this.vertexFormat = vertexFormat;
+        this.indexFormat = indexFormat;
+    }
+    toString() { return this.name; }
+}
+// ---------------------------------------------------------------------------
+// Singleton tokens
+// ---------------------------------------------------------------------------
+const _V2f = new ElementKind("v2f", 8, "float32x2", undefined);
+const _V3f = new ElementKind("v3f", 12, "float32x3", undefined);
+const _V4f = new ElementKind("v4f", 16, "float32x4", undefined);
+const _M22f = new ElementKind("m22f", 16, undefined, undefined);
+const _M33f = new ElementKind("m33f", 36, undefined, undefined);
+const _M44f = new ElementKind("m44f", 64, undefined, undefined);
+const _V2i = new ElementKind("v2i", 8, "sint32x2", undefined);
+const _V3i = new ElementKind("v3i", 12, "sint32x3", undefined);
+const _V4i = new ElementKind("v4i", 16, "sint32x4", undefined);
+const _V2u = new ElementKind("v2u", 8, "uint32x2", undefined);
+const _V3u = new ElementKind("v3u", 12, "uint32x3", undefined);
+const _V4u = new ElementKind("v4u", 16, "uint32x4", undefined);
+const _F32 = new ElementKind("f32", 4, "float32", undefined);
+const _U32 = new ElementKind("u32", 4, "uint32", "uint32");
+const _I32 = new ElementKind("i32", 4, "sint32", undefined);
+const _U16 = new ElementKind("u16", 2, undefined, "uint16");
+const _I16 = new ElementKind("i16", 2, undefined, undefined);
+const _U8 = new ElementKind("u8", 1, undefined, undefined);
+const _I8 = new ElementKind("i8", 1, undefined, undefined);
+/**
+ * Construct a vertex view; throws if the kind has no vertex format
+ * (matrix / unsupported type).
+ */
+function asVertexFormat(t) {
+    if (t.vertexFormat === undefined) {
+        throw new Error(`ElementType.${t.name}: no GPUVertexFormat (matrices must be split into column attributes; ` +
+            `unsupported types must be repacked first)`);
+    }
+    return t.vertexFormat;
+}
+function asIndexFormat(t) {
+    if (t.indexFormat === undefined) {
+        throw new Error(`ElementType.${t.name}: not a valid index type (use ElementType.U16 or ElementType.U32)`);
+    }
+    return t.indexFormat;
+}
+// ---------------------------------------------------------------------------
+// Constructor → ElementType registry — drives `BufferView.ofArray`
+// auto-inference. Keyed on class identity (V3fArray, Float32Array,
+// …) so it survives minification.
+// ---------------------------------------------------------------------------
+const FROM_CTOR = new Map([
+    // wombat.base packed arrays
+    [V2fArray, _V2f], [V3fArray, _V3f], [V4fArray, _V4f],
+    [V2iArray, _V2i], [V3iArray, _V3i], [V4iArray, _V4i],
+    [V2uiArray, _V2u], [V3uiArray, _V3u], [V4uiArray, _V4u],
+    // native typed arrays (interpreted as scalars)
+    [Float32Array, _F32],
+    [Uint32Array, _U32],
+    [Int32Array, _I32],
+    [Uint16Array, _U16],
+    [Int16Array, _I16],
+    [Uint8Array, _U8],
+    [Int8Array, _I8],
+]);
+function fromArray(arr) {
+    const ctor = arr.constructor;
+    if (ctor === undefined) {
+        throw new Error("ElementType.fromArray: input has no constructor");
+    }
+    const et = FROM_CTOR.get(ctor);
+    if (et === undefined) {
+        const name = ctor.name ?? "<anonymous>";
+        throw new Error(`ElementType.fromArray: cannot infer ElementType from ${name}; ` +
+            `pass the kind explicitly (e.g. ElementType.V3f)`);
+    }
+    return et;
+}
+// ---------------------------------------------------------------------------
+// Public namespace
+// ---------------------------------------------------------------------------
+/**
+ * Singleton tokens + helpers. Most call sites use the singleton
+ * directly (`ElementType.V3f`); the helpers are kept on the
+ * namespace so `import { ElementType }` is the only import you
+ * need.
+ */
+export const ElementType = {
+    // Float vectors
+    V2f: _V2f, V3f: _V3f, V4f: _V4f,
+    // Float matrices (square)
+    M22f: _M22f, M33f: _M33f, M44f: _M44f,
+    // Signed-int vectors
+    V2i: _V2i, V3i: _V3i, V4i: _V4i,
+    // Unsigned-int vectors
+    V2u: _V2u, V3u: _V3u, V4u: _V4u,
+    // Scalars
+    F32: _F32, U32: _U32, I32: _I32,
+    U16: _U16, I16: _I16, U8: _U8, I8: _I8,
+    /** Infer from a wombat.base packed array or a native TypedArray. */
+    fromArray,
+    /** GPUVertexFormat for `t`; throws if `t` has no vertex form. */
+    toVertexFormat: asVertexFormat,
+    /** GPUIndexFormat for `t`; throws if `t` is not `u16` / `u32`. */
+    toIndexFormat: asIndexFormat,
+};
+//# sourceMappingURL=elementType.js.map

package/dist/core/elementType.js.map

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

package/dist/core/index.d.ts

@@ -1,6 +1,7 @@
 export { IBuffer, } from "./buffer.js";
 export type { HostBufferSource, } from "./buffer.js";
-export type { BufferView, } from "./bufferView.js";
+export { BufferView, } from "./bufferView.js";
+export { ElementType, ElementKind, } from "./elementType.js";
 export type { ClearColor, ClearValues, } from "./clear.js";
 export type { Command, CopySpec, BufferCopy, TextureCopy, BufferCopyRange, } from "./command.js";
 export type { DrawCall, IndexedDrawCall, NonIndexedDrawCall, } from "./drawCall.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/core/index.js

@@ -4,6 +4,8 @@
 // `prepareRenderObject`, `runRenderTask`, etc. live in higher
 // packages (`resources`, `commands`, `runtime`).
 export { IBuffer, } from "./buffer.js";
+export { BufferView, } from "./bufferView.js";
+export { ElementType, ElementKind, } from "./elementType.js";
 export { PipelineState } from "./pipelineState.js";
 export { RenderTree, } from "./renderTree.js";
 export { ISampler, } from "./sampler.js";

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,2DAA2D;AAC3D,8DAA8D;AAC9D,iDAAiD;AAEjD,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AAyDrB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AA4BtB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,2DAA2D;AAC3D,8DAA8D;AAC9D,iDAAiD;AAEjD,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAkD1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AA4BtB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/core/renderObject.d.ts

@@ -33,9 +33,9 @@ export interface RenderObject {
      * individual buffer values are reactive. The shader's required-input
      * set is fixed at compile; the map must contain at least those names.
      */
-    readonly vertexAttributes: HashMap<string, aval<BufferView>>;
+    readonly vertexAttributes: HashMap<string, BufferView>;
     /** name → instance buffer view; e.g. "modelMatrix", "instanceColor". */
-    readonly instanceAttributes?: HashMap<string, aval<BufferView>>;
+    readonly instanceAttributes?: HashMap<string, BufferView>;
     /** name → uniform value; runtime packs into UBO based on shader layout. */
     readonly uniforms: HashMap<string, aval<unknown>>;
     /** name → texture source (CPU image or pre-built GPUTexture). */
@@ -45,7 +45,7 @@ export interface RenderObject {
     /** name → storage buffer source. */
     readonly storageBuffers?: HashMap<string, aval<IBuffer>>;
     /** Index buffer for indexed draws. */
-    readonly indices?: aval<BufferView>;
+    readonly indices?: BufferView;
     readonly drawCall: aval<DrawCall>;
 }
 //# sourceMappingURL=renderObject.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"renderObject.d.ts","sourceRoot":"","sources":["../../src/core/renderObject.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzD,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACnC"}
+{"version":3,"file":"renderObject.d.ts","sourceRoot":"","sources":["../../src/core/renderObject.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzD,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACnC"}