@adobe/data-gpu 0.9.75 → 0.9.76

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

@@ -0,0 +1,79 @@
+// © 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_FACTOR_PALETTE_ENTRIES, PALETTE_STRIDE, materialHasMaps, writePaletteLayer, } from "./material-palette.js";
+import { createFactorPaletteBindGroup } from "./palette-bind-group.js";
+/** Material rows the factor builder reads (PBR factors only — no map URLs). */
+const FACTOR_MATERIAL_COMPONENTS = [
+    "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength",
+    "irEmission", "emissionMode",
+    "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl",
+];
+/**
+ * materialPaletteGpu — uploads factor-only materials into a shared palette buffer.
+ * Materials with any map URL are skipped (no map upload path — use factor rows or glTF).
+ * Each factor material gets `_paletteIndex`; no texture arrays are allocated.
+ */
+export const materialPaletteGpu = Database.Plugin.create({
+    extends: Database.Plugin.combine(Material.plugin, core),
+    components: {
+        _paletteIndex: { ...U32.schema, nonPersistent: true },
+    },
+    resources: {
+        _factorPalette: { default: null, nonPersistent: true },
+        _factorPaletteBindGroup: { default: null, nonPersistent: true },
+    },
+    systems: {
+        materialPaletteGpuBuilder: {
+            schedule: { during: ["preRender"] },
+            create: db => {
+                let palette = null;
+                let nextIndex = 0;
+                return () => {
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    for (const arch of db.store.queryArchetypes(["name", ...FACTOR_MATERIAL_COMPONENTS], { exclude: ["_paletteIndex"] })) {
+                        const c = arch.columns;
+                        for (let i = arch.rowCount - 1; i >= 0; i--) {
+                            const urls = {
+                                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),
+                            };
+                            if (materialHasMaps(urls))
+                                continue;
+                            if (nextIndex >= MAX_FACTOR_PALETTE_ENTRIES)
+                                break;
+                            if (!palette) {
+                                palette = device.createBuffer({
+                                    size: MAX_FACTOR_PALETTE_ENTRIES * PALETTE_STRIDE,
+                                    usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+                                });
+                                db.store.resources._factorPalette = palette;
+                                db.store.resources._factorPaletteBindGroup = createFactorPaletteBindGroup(device, palette);
+                            }
+                            const index = nextIndex++;
+                            writePaletteLayer(device, palette, index, {
+                                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),
+                                irEmission: c.irEmission.get(i),
+                                emissionMode: c.emissionMode.get(i),
+                            });
+                            db.store.update(c.id.get(i), { _paletteIndex: index });
+                        }
+                    }
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=material-palette-gpu-plugin.js.map

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

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

package/dist/graphics/rendering/material-palette-gpu/material-palette-gpu.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/graphics/rendering/material-palette-gpu/material-palette-gpu.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { materialHasMaps } from "./material-palette.js";
+const emptyUrls = {
+    baseColorUrl: "",
+    metallicRoughnessUrl: "",
+    normalUrl: "",
+    occlusionUrl: "",
+    emissiveUrl: "",
+};
+describe("materialHasMaps", () => {
+    it("is false when all URLs are empty", () => {
+        expect(materialHasMaps(emptyUrls)).toBe(false);
+    });
+    it("is true when any URL is set", () => {
+        expect(materialHasMaps({ ...emptyUrls, baseColorUrl: "https://example.com/a.jpg" })).toBe(true);
+    });
+});
+//# sourceMappingURL=material-palette-gpu.test.js.map

package/dist/graphics/rendering/material-palette-gpu/material-palette-gpu.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-palette-gpu.test.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-palette-gpu/material-palette-gpu.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,SAAS,GAAG;IACd,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,EAAE;IACxB,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,EAAE;IAChB,WAAW,EAAE,EAAE;CAClB,CAAC;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,EAAE,YAAY,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/** Bytes per palette entry: 4 × vec4 (base, emissive/metal, rough/normal/occlusion/ir, emission meta). */
+export declare const PALETTE_STRIDE = 64;
+/** Factor-only materials — palette rows only, no map memory. */
+export declare const MAX_FACTOR_PALETTE_ENTRIES = 256;
+/** Per-material visible factors written into one palette row. */
+export interface MaterialFactors {
+    baseColorFactor: readonly number[];
+    emissiveFactor: readonly number[];
+    metallicFactor: number;
+    roughnessFactor: number;
+    normalScale: number;
+    occlusionStrength: number;
+    irEmission: number;
+    emissionMode: number;
+}
+export declare function writePaletteLayer(device: GPUDevice, palette: GPUBuffer, index: number, f: MaterialFactors): void;
+/** The five map source URLs for one material ("" = factor-only). */
+export interface MaterialMapUrls {
+    baseColorUrl: string;
+    metallicRoughnessUrl: string;
+    normalUrl: string;
+    occlusionUrl: string;
+    emissiveUrl: string;
+}
+export declare const materialHasMaps: (urls: MaterialMapUrls) => boolean;

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

@@ -0,0 +1,27 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/** Bytes per palette entry: 4 × vec4 (base, emissive/metal, rough/normal/occlusion/ir, emission meta). */
+export const PALETTE_STRIDE = 64;
+/** Factor-only materials — palette rows only, no map memory. */
+export const MAX_FACTOR_PALETTE_ENTRIES = 256;
+const _palette = new Float32Array(PALETTE_STRIDE / 4);
+export function writePaletteLayer(device, palette, index, 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] = f.irEmission;
+    _palette[12] = f.emissionMode;
+    _palette[13] = 0;
+    _palette[14] = 0;
+    _palette[15] = 0;
+    device.queue.writeBuffer(palette, index * PALETTE_STRIDE, _palette);
+}
+export const materialHasMaps = (urls) => !!(urls.baseColorUrl || urls.metallicRoughnessUrl || urls.normalUrl || urls.occlusionUrl || urls.emissiveUrl);
+//# sourceMappingURL=material-palette.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"material-palette.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-palette-gpu/material-palette.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAc9C,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,UAAU,CAAC;IAC9H,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACpF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,GAAG,cAAc,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC;AAWD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAqB,EAAW,EAAE,CAC9D,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Bind-group layout for factor PBR: palette storage buffer only (group 1). */
+export declare function createFactorPaletteBindGroupLayout(device: GPUDevice): GPUBindGroupLayout;
+export declare function createFactorPaletteBindGroup(device: GPUDevice, palette: GPUBuffer): GPUBindGroup;

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

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+const layoutByDevice = new WeakMap();
+/** Bind-group layout for factor PBR: palette storage buffer only (group 1). */
+export function createFactorPaletteBindGroupLayout(device) {
+    let layout = layoutByDevice.get(device);
+    if (!layout) {
+        layout = device.createBindGroupLayout({
+            entries: [
+                { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "read-only-storage" } },
+            ],
+        });
+        layoutByDevice.set(device, layout);
+    }
+    return layout;
+}
+export function createFactorPaletteBindGroup(device, palette) {
+    return device.createBindGroup({
+        layout: createFactorPaletteBindGroupLayout(device),
+        entries: [{ binding: 0, resource: { buffer: palette } }],
+    });
+}
+//# sourceMappingURL=palette-bind-group.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"palette-bind-group.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-palette-gpu/palette-bind-group.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,MAAM,cAAc,GAAG,IAAI,OAAO,EAAiC,CAAC;AAEpE,+EAA+E;AAC/E,MAAM,UAAU,kCAAkC,CAAC,MAAiB;IAChE,IAAI,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;YAClC,OAAO,EAAE;gBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;aAC7F;SACJ,CAAC,CAAC;QACH,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,OAAkB;IAC9E,OAAO,MAAM,CAAC,eAAe,CAAC;QAC1B,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC;QAClD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;KAC3D,CAAC,CAAC;AACP,CAAC"}