@adobe/data-gpu 0.10.23 → 0.10.25

package/dist/graphics/rendering/material-gpu/material-arrays.d.ts

@@ -1,47 +0,0 @@
-/**
- * The shared GPU material set: five `texture_2d_array`s (one per PBR map) plus
- * a palette storage buffer of per-layer factors. Every material occupies one
- * layer across all five arrays; a drawable selects its material with a single
- * per-instance layer index. Built once and grown by layer — materials are
- * added rarely and edited never, so nothing here is rebuilt per frame.
- */
-export interface MaterialArrays {
-    baseColor: GPUTexture;
-    metallicRoughness: GPUTexture;
-    normal: GPUTexture;
-    occlusion: GPUTexture;
-    emissive: GPUTexture;
-}
-/** Fixed layer size every material map is resampled to. */
-export declare const MATERIAL_TEXTURE_SIZE = 512;
-/** Maximum distinct materials (array layers). 16 × 512² × 5 maps ≈ 80 MB. */
-export declare const MAX_MATERIAL_LAYERS = 16;
-/** Bytes per palette entry: baseColor(vec4) + emissive/metallic(vec4) + rough/normal/occlusion(vec4). */
-export declare const PALETTE_STRIDE = 48;
-export declare function createMaterialArrays(device: GPUDevice): MaterialArrays;
-/** Per-material visible factors written into one palette layer. */
-export interface MaterialFactors {
-    baseColorFactor: readonly number[];
-    emissiveFactor: readonly number[];
-    metallicFactor: number;
-    roughnessFactor: number;
-    normalScale: number;
-    occlusionStrength: number;
-}
-export declare function writePaletteLayer(device: GPUDevice, palette: GPUBuffer, layer: number, f: MaterialFactors): void;
-/** The five map source URLs for one material ("" = leave the neutral layer). */
-export interface MaterialMapUrls {
-    baseColorUrl: string;
-    metallicRoughnessUrl: string;
-    normalUrl: string;
-    occlusionUrl: string;
-    emissiveUrl: string;
-}
-/**
- * Fetches a material's maps and blits them (resampled to the layer size) into
- * its array layer. Fire-and-forget: each map resolves independently, so a body
- * renders (neutral) immediately and sharpens as textures arrive. URLs shared
- * across maps (e.g. an ARM image used for both metallicRoughness and occlusion)
- * are fetched once and copied to each target.
- */
-export declare function loadMaterialMaps(device: GPUDevice, arrays: MaterialArrays, layer: number, urls: MaterialMapUrls): void;

package/dist/graphics/rendering/material-gpu/material-arrays.js

@@ -1,83 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-/** Fixed layer size every material map is resampled to. */
-export const MATERIAL_TEXTURE_SIZE = 512;
-/** Maximum distinct materials (array layers). 16 × 512² × 5 maps ≈ 80 MB. */
-export const MAX_MATERIAL_LAYERS = 16;
-/** Bytes per palette entry: baseColor(vec4) + emissive/metallic(vec4) + rough/normal/occlusion(vec4). */
-export const PALETTE_STRIDE = 48;
-export function createMaterialArrays(device) {
-    const make = (format) => device.createTexture({
-        size: [MATERIAL_TEXTURE_SIZE, MATERIAL_TEXTURE_SIZE, MAX_MATERIAL_LAYERS],
-        dimension: "2d",
-        format,
-        // RENDER_ATTACHMENT is required by copyExternalImageToTexture.
-        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
-    });
-    return {
-        baseColor: make("rgba8unorm-srgb"),
-        metallicRoughness: make("rgba8unorm"),
-        normal: make("rgba8unorm"),
-        occlusion: make("rgba8unorm"),
-        emissive: make("rgba8unorm-srgb"),
-    };
-}
-const _palette = new Float32Array(PALETTE_STRIDE / 4);
-export function writePaletteLayer(device, palette, layer, f) {
-    _palette[0] = f.baseColorFactor[0];
-    _palette[1] = f.baseColorFactor[1];
-    _palette[2] = f.baseColorFactor[2];
-    _palette[3] = f.baseColorFactor[3];
-    _palette[4] = f.emissiveFactor[0];
-    _palette[5] = f.emissiveFactor[1];
-    _palette[6] = f.emissiveFactor[2];
-    _palette[7] = f.metallicFactor;
-    _palette[8] = f.roughnessFactor;
-    _palette[9] = f.normalScale;
-    _palette[10] = f.occlusionStrength;
-    _palette[11] = 0;
-    device.queue.writeBuffer(palette, layer * PALETTE_STRIDE, _palette);
-}
-/**
- * Fetches a material's maps and blits them (resampled to the layer size) into
- * its array layer. Fire-and-forget: each map resolves independently, so a body
- * renders (neutral) immediately and sharpens as textures arrive. URLs shared
- * across maps (e.g. an ARM image used for both metallicRoughness and occlusion)
- * are fetched once and copied to each target.
- */
-export function loadMaterialMaps(device, arrays, layer, urls) {
-    const targets = [
-        { url: urls.baseColorUrl, tex: arrays.baseColor },
-        { url: urls.metallicRoughnessUrl, tex: arrays.metallicRoughness },
-        { url: urls.normalUrl, tex: arrays.normal },
-        { url: urls.occlusionUrl, tex: arrays.occlusion },
-        { url: urls.emissiveUrl, tex: arrays.emissive },
-    ];
-    const byUrl = new Map();
-    for (const t of targets) {
-        if (!t.url)
-            continue;
-        const list = byUrl.get(t.url);
-        if (list)
-            list.push(t.tex);
-        else
-            byUrl.set(t.url, [t.tex]);
-    }
-    for (const [url, texes] of byUrl) {
-        fetch(url)
-            .then(r => { if (!r.ok)
-            throw new Error(`material map ${r.status}: ${url}`); return r.blob(); })
-            .then(blob => createImageBitmap(blob, {
-            resizeWidth: MATERIAL_TEXTURE_SIZE,
-            resizeHeight: MATERIAL_TEXTURE_SIZE,
-            colorSpaceConversion: "none",
-        }))
-            .then(bitmap => {
-            for (const tex of texes) {
-                device.queue.copyExternalImageToTexture({ source: bitmap }, { texture: tex, origin: [0, 0, layer] }, [MATERIAL_TEXTURE_SIZE, MATERIAL_TEXTURE_SIZE, 1]);
-            }
-            bitmap.close();
-        })
-            .catch(err => console.warn("[materialGpu] map load failed", err));
-    }
-}
-//# sourceMappingURL=material-arrays.js.map

package/dist/graphics/rendering/material-gpu/material-arrays.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"material-arrays.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-gpu/material-arrays.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAiBvD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,yGAAyG;AACzG,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IAClD,MAAM,IAAI,GAAG,CAAC,MAAwB,EAAc,EAAE,CAClD,MAAM,CAAC,aAAa,CAAC;QACjB,IAAI,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC;QACzE,SAAS,EAAE,IAAI;QACf,MAAM;QACN,+DAA+D;QAC/D,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,QAAQ,GAAG,eAAe,CAAC,iBAAiB;KACxG,CAAC,CAAC;IACP,OAAO;QACH,SAAS,EAAU,IAAI,CAAC,iBAAiB,CAAC;QAC1C,iBAAiB,EAAE,IAAI,CAAC,YAAY,CAAC;QACrC,MAAM,EAAa,IAAI,CAAC,YAAY,CAAC;QACrC,SAAS,EAAU,IAAI,CAAC,YAAY,CAAC;QACrC,QAAQ,EAAW,IAAI,CAAC,iBAAiB,CAAC;KAC7C,CAAC;AACN,CAAC;AAYD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;AAEtD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAkB,EAAE,KAAa,EAAE,CAAkB;IACtG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/I,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;IACxI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACnH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,GAAG,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAsB,EAAE,KAAa,EAAE,IAAqB;IAC5G,MAAM,OAAO,GAAuC;QAChD,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAU,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE;QACzD,EAAE,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,MAAM,CAAC,iBAAiB,EAAE;QACjE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAa,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE;QACtD,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAU,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE;QACzD,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAW,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE;KAC3D,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;;YACtB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC;aACL,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;aAC/F,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE;YAClC,WAAW,EAAE,qBAAqB;YAClC,YAAY,EAAE,qBAAqB;YACnC,oBAAoB,EAAE,MAAM;SAC/B,CAAC,CAAC;aACF,IAAI,CAAC,MAAM,CAAC,EAAE;YACX,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,CAAC,0BAA0B,CACnC,EAAE,MAAM,EAAE,MAAM,EAAE,EAClB,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,EACvC,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,CAAC,CAAC,CACpD,CAAC;YACN,CAAC;YACD,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;AACL,CAAC"}

package/dist/graphics/rendering/material-gpu/material-bind-group.d.ts

@@ -1,9 +0,0 @@
-import type { MaterialArrays } from "./material-arrays.js";
-/**
- * Bind-group layout for the shared material set: palette storage buffer +
- * five `texture_2d_array`s + a filtering sampler. The renderer's primitive
- * pipeline builds its pipeline layout from this; `createMaterialBindGroup`
- * builds the matching bind group. Cached per device.
- */
-export declare function createMaterialBindGroupLayout(device: GPUDevice): GPUBindGroupLayout;
-export declare function createMaterialBindGroup(device: GPUDevice, arrays: MaterialArrays, palette: GPUBuffer): GPUBindGroup;

package/dist/graphics/rendering/material-gpu/material-bind-group.js

@@ -1,52 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-const cacheByDevice = new WeakMap();
-function deviceCache(device) {
-    let c = cacheByDevice.get(device);
-    if (!c) {
-        const tex = (binding) => ({
-            binding, visibility: GPUShaderStage.FRAGMENT,
-            texture: { sampleType: "float", viewDimension: "2d-array" },
-        });
-        c = {
-            layout: device.createBindGroupLayout({
-                entries: [
-                    { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "read-only-storage" } },
-                    tex(1), tex(2), tex(3), tex(4), tex(5),
-                    { binding: 6, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
-                ],
-            }),
-            sampler: device.createSampler({
-                magFilter: "linear", minFilter: "linear", mipmapFilter: "linear",
-                addressModeU: "repeat", addressModeV: "repeat",
-            }),
-        };
-        cacheByDevice.set(device, c);
-    }
-    return c;
-}
-/**
- * Bind-group layout for the shared material set: palette storage buffer +
- * five `texture_2d_array`s + a filtering sampler. The renderer's primitive
- * pipeline builds its pipeline layout from this; `createMaterialBindGroup`
- * builds the matching bind group. Cached per device.
- */
-export function createMaterialBindGroupLayout(device) {
-    return deviceCache(device).layout;
-}
-export function createMaterialBindGroup(device, arrays, palette) {
-    const { layout, sampler } = deviceCache(device);
-    const view = (t) => t.createView({ dimension: "2d-array" });
-    return device.createBindGroup({
-        layout,
-        entries: [
-            { binding: 0, resource: { buffer: palette } },
-            { binding: 1, resource: view(arrays.baseColor) },
-            { binding: 2, resource: view(arrays.metallicRoughness) },
-            { binding: 3, resource: view(arrays.normal) },
-            { binding: 4, resource: view(arrays.occlusion) },
-            { binding: 5, resource: view(arrays.emissive) },
-            { binding: 6, resource: sampler },
-        ],
-    });
-}
-//# sourceMappingURL=material-bind-group.js.map

package/dist/graphics/rendering/material-gpu/material-bind-group.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"material-bind-group.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-gpu/material-bind-group.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAQvD,MAAM,aAAa,GAAG,IAAI,OAAO,EAA0B,CAAC;AAE5D,SAAS,WAAW,CAAC,MAAiB;IAClC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,GAAG,GAAG,CAAC,OAAe,EAA2B,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ;YAC5C,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE;SAC9D,CAAC,CAAC;QACH,CAAC,GAAG;YACA,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;gBACjC,OAAO,EAAE;oBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;oBAC1F,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBACtC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;iBACtF;aACJ,CAAC;YACF,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC;gBAC1B,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;gBAChE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;aACjD,CAAC;SACL,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC3D,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAsB,EAAE,OAAkB;IACjG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAa,EAAkB,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,eAAe,CAAC;QAC1B,MAAM;QACN,OAAO,EAAE;YACL,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC7C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAChD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE;YACxD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC7C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAChD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC/C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE;SACpC;KACJ,CAAC,CAAC;AACP,CAAC"}

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.d.ts

@@ -1,259 +0,0 @@
-import { type MaterialArrays } from "./material-arrays.js";
-/**
- * materialGpu — derives the shared GPU material set from the `Material`
- * registry. Each authored material is assigned one array layer; its factors go
- * into the palette buffer and its maps are fetched + blitted into that layer.
- *
- * Incremental and cached: the arrays / palette / bind group are built once, and
- * a layer is assigned only to a material that doesn't have one yet (`_layerIndex`
- * excluded). Materials are added rarely and edited never, so steady state does
- * no work. The renderer (P3) binds `_materialBindGroup` once and selects a
- * material per instance by `_layerIndex`.
- */
-export declare const materialGpu: {
-    readonly components: {} & {
-        readonly material: {
-            readonly type: "integer";
-            readonly minimum: -2147483648;
-            readonly maximum: 2147483647;
-            readonly default: number;
-        };
-        readonly name: {
-            readonly type: "string";
-        };
-        readonly density: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly restitution: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly friction: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly compliance: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly heatCapacity: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly baseColorFactor: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly minItems: 4;
-            readonly maxItems: 4;
-            readonly default: readonly [0, 0, 0, 0];
-        };
-        readonly emissiveFactor: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly minItems: 3;
-            readonly maxItems: 3;
-            readonly default: readonly [0, 0, 0];
-        };
-        readonly metallicFactor: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly roughnessFactor: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly normalScale: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly occlusionStrength: {
-            readonly type: "number";
-            readonly precision: 1;
-            readonly default: number;
-        };
-        readonly baseColorUrl: {
-            readonly type: "string";
-        };
-        readonly metallicRoughnessUrl: {
-            readonly type: "string";
-        };
-        readonly normalUrl: {
-            readonly type: "string";
-        };
-        readonly occlusionUrl: {
-            readonly type: "string";
-        };
-        readonly emissiveUrl: {
-            readonly type: "string";
-        };
-    } & {
-        readonly _layerIndex: {
-            readonly type: "integer";
-            readonly minimum: 0;
-            readonly maximum: 4294967295;
-            readonly default: number;
-        };
-    };
-    readonly resources: {
-        readonly frameTime: {
-            readonly default: import("../../../core/frame-time/public.js");
-            readonly nonPersistent: true;
-        };
-    } & {
-        readonly schedulerState: {
-            readonly default: import("@adobe/data/ecs").SchedulerState;
-        };
-    } & {
-        readonly device: {
-            readonly default: GPUDevice | null;
-            readonly nonPersistent: true;
-        };
-        readonly commandEncoder: {
-            readonly default: GPUCommandEncoder | null;
-            readonly nonPersistent: true;
-        };
-    } & {
-        readonly materials: {
-            readonly default: Record<string, number>;
-        };
-    } & {
-        readonly _materialArrays: {
-            readonly default: MaterialArrays | null;
-            readonly nonPersistent: true;
-        };
-        readonly _materialPalette: {
-            readonly default: GPUBuffer | null;
-            readonly nonPersistent: true;
-        };
-        readonly _materialBindGroup: {
-            readonly default: GPUBindGroup | null;
-            readonly nonPersistent: true;
-        };
-    };
-    readonly archetypes: {} & {
-        readonly Material: readonly ["name", "density", "restitution", "friction", "compliance", "heatCapacity", "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength", "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl"];
-    } & {};
-    readonly transactions: {} & {} & {
-        readonly seedStandardMaterials: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{
-            readonly material: {
-                readonly type: "integer";
-                readonly minimum: -2147483648;
-                readonly maximum: 2147483647;
-                readonly default: number;
-            };
-            readonly name: {
-                readonly type: "string";
-            };
-            readonly density: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly restitution: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly friction: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly compliance: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly heatCapacity: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly baseColorFactor: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "number";
-                    readonly precision: 1;
-                    readonly default: number;
-                };
-                readonly minItems: 4;
-                readonly maxItems: 4;
-                readonly default: readonly [0, 0, 0, 0];
-            };
-            readonly emissiveFactor: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "number";
-                    readonly precision: 1;
-                    readonly default: number;
-                };
-                readonly minItems: 3;
-                readonly maxItems: 3;
-                readonly default: readonly [0, 0, 0];
-            };
-            readonly metallicFactor: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly roughnessFactor: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly normalScale: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly occlusionStrength: {
-                readonly type: "number";
-                readonly precision: 1;
-                readonly default: number;
-            };
-            readonly baseColorUrl: {
-                readonly type: "string";
-            };
-            readonly metallicRoughnessUrl: {
-                readonly type: "string";
-            };
-            readonly normalUrl: {
-                readonly type: "string";
-            };
-            readonly occlusionUrl: {
-                readonly type: "string";
-            };
-            readonly emissiveUrl: {
-                readonly type: "string";
-            };
-        }>, import("@adobe/data/schema").FromSchemas<{
-            readonly materials: {
-                readonly default: Record<string, number>;
-            };
-        }>, {
-            readonly Material: readonly ["name", "density", "restitution", "friction", "compliance", "heatCapacity", "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength", "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl"];
-        }, {}>) => void;
-    } & {};
-    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"_frameTime" | "update" | "schedulerSystem" | "input" | "preUpdate" | "postUpdate" | "physics" | "preRender" | "render" | "postRender" | "materialGpuBuilder">;
-    readonly actions: {};
-    readonly services: {};
-    readonly computed: {};
-    readonly indexes: {} & {} & {};
-};

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.js

@@ -1,90 +0,0 @@
-// © 2026 Adobe. MIT License. See /LICENSE for details.
-import { Database } from "@adobe/data/ecs";
-import { U32 } from "@adobe/data/math";
-import { core } from "../../../core/core-plugin.js";
-import { Material } from "../../../material/material.js";
-import { MAX_MATERIAL_LAYERS, PALETTE_STRIDE, createMaterialArrays, writePaletteLayer, loadMaterialMaps, } from "./material-arrays.js";
-import { createMaterialBindGroup } from "./material-bind-group.js";
-/** Material rows the builder reads to fill a layer (factors + map URLs). */
-const MATERIAL_COMPONENTS = [
-    "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength",
-    "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl",
-];
-/**
- * materialGpu — derives the shared GPU material set from the `Material`
- * registry. Each authored material is assigned one array layer; its factors go
- * into the palette buffer and its maps are fetched + blitted into that layer.
- *
- * Incremental and cached: the arrays / palette / bind group are built once, and
- * a layer is assigned only to a material that doesn't have one yet (`_layerIndex`
- * excluded). Materials are added rarely and edited never, so steady state does
- * no work. The renderer (P3) binds `_materialBindGroup` once and selects a
- * material per instance by `_layerIndex`.
- */
-export const materialGpu = Database.Plugin.create({
-    extends: Database.Plugin.combine(Material.plugin, core),
-    components: {
-        _layerIndex: U32.schema,
-    },
-    resources: {
-        _materialArrays: { default: null, nonPersistent: true },
-        _materialPalette: { default: null, nonPersistent: true },
-        _materialBindGroup: { default: null, nonPersistent: true },
-    },
-    systems: {
-        materialGpuBuilder: {
-            schedule: { during: ["preRender"] },
-            create: db => {
-                let arrays = null;
-                let palette = null;
-                let nextLayer = 0;
-                return () => {
-                    const { device } = db.store.resources;
-                    if (!device)
-                        return;
-                    // Assign a layer to each material that lacks one. Tail→head:
-                    // every visited row migrates out (gains _layerIndex), so the
-                    // removal is always from the tail — no hole-fill shift. The GPU
-                    // arrays are created lazily on the first material, so glTF-only
-                    // scenes (no materials) allocate nothing.
-                    for (const arch of db.store.queryArchetypes(["name", ...MATERIAL_COMPONENTS], { exclude: ["_layerIndex"] })) {
-                        const c = arch.columns;
-                        for (let i = arch.rowCount - 1; i >= 0; i--) {
-                            if (nextLayer >= MAX_MATERIAL_LAYERS)
-                                break;
-                            if (!arrays || !palette) {
-                                arrays = createMaterialArrays(device);
-                                palette = device.createBuffer({
-                                    size: MAX_MATERIAL_LAYERS * PALETTE_STRIDE,
-                                    usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
-                                });
-                                db.store.resources._materialArrays = arrays;
-                                db.store.resources._materialPalette = palette;
-                                db.store.resources._materialBindGroup = createMaterialBindGroup(device, arrays, palette);
-                            }
-                            const id = c.id.get(i);
-                            const layer = nextLayer++;
-                            writePaletteLayer(device, palette, layer, {
-                                baseColorFactor: c.baseColorFactor.get(i),
-                                emissiveFactor: c.emissiveFactor.get(i),
-                                metallicFactor: c.metallicFactor.get(i),
-                                roughnessFactor: c.roughnessFactor.get(i),
-                                normalScale: c.normalScale.get(i),
-                                occlusionStrength: c.occlusionStrength.get(i),
-                            });
-                            loadMaterialMaps(device, arrays, layer, {
-                                baseColorUrl: c.baseColorUrl.get(i),
-                                metallicRoughnessUrl: c.metallicRoughnessUrl.get(i),
-                                normalUrl: c.normalUrl.get(i),
-                                occlusionUrl: c.occlusionUrl.get(i),
-                                emissiveUrl: c.emissiveUrl.get(i),
-                            });
-                            db.store.update(id, { _layerIndex: layer });
-                        }
-                    }
-                };
-            },
-        },
-    },
-});
-//# sourceMappingURL=material-gpu-plugin.js.map

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.js.map

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

package/dist/graphics/rendering/pbr-render/pbr-array-shader.wgsl.d.ts

@@ -1,10 +0,0 @@
-/**
- * Unified PBR shader for instanced primitives (and, after convergence, glTF).
- * Materials come from the shared `materialGpu` set — five `texture_2d_array`s +
- * a palette of per-layer factors (group 1) — selected by a per-instance layer
- * index (group 3, binding 1). Shading is identical Cook-Torrance + split-sum
- * IBL to the per-material `ibl-shader`; only the material *source* differs.
- */
-export declare function buildPbrArrayShader(options: {
-    prefilteredMipCount: number;
-}): string;