@adobe/data-gpu 0.9.75 → 0.9.77

package/src/material/definitions.ts

@@ -0,0 +1,427 @@
+import type { MaterialDefinition } from "./material-definition.js";
+import { StressStrainCurve } from "./stress-strain-curve/stress-strain-curve.js";
+
+const defaultSolid = {
+    friction: 0.5,
+    compliance: 1e-8,
+    normalScale: 1,
+    occlusionStrength: 1,
+    baseColorUrl: "",
+    metallicRoughnessUrl: "",
+    normalUrl: "",
+    occlusionUrl: "",
+    emissiveUrl: "",
+} as const satisfies Partial<MaterialDefinition>;
+
+const noSolidCurve = {
+    stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0,0],
+            tensileFractureStrainStress: [0,0],
+            compressiveYieldStrainStress: [0,0],
+            compressiveFractureStrainStress: [0,0],
+        }),
+};
+
+const metaMaterialBase: Omit<MaterialDefinition, "baseColorFactor"> = {
+    metallicFactor: 0.8,
+    roughnessFactor: 0.2,
+    irReflectance: 0.5,
+    irEmission: 0,
+    emissionMode: 0,
+    restitution: 0.35,
+    emissiveFactor: [0, 0, 0],
+    density: 1200,
+    viscosity: 0,
+    heatCapacity: Number.POSITIVE_INFINITY,
+    thermalConductivity: 100,
+    ...defaultSolid,
+    stressStrainCurve: StressStrainCurve.create({
+        tensileYieldStrainStress: [0.01333, 40],
+        tensileFractureStrainStress: [0.08, 48],
+        compressiveYieldStrainStress: [-0.015, -45],
+        compressiveFractureStrainStress: [-0.09, -52],
+    }),
+};
+
+export const definitions = {
+    air: {
+        baseColorFactor: [1,1,1,0],
+                metallicFactor: 0,
+        roughnessFactor: 0,
+        irReflectance: 0,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0,
+        emissiveFactor: [0,0,0],
+        density: 1.225,
+        viscosity: 0,
+        heatCapacity: 1006,
+        thermalConductivity: 0.024,
+        ...defaultSolid,
+        ...noSolidCurve,
+    },
+    water: {
+        baseColorFactor: [0,0,1,0.1],
+                metallicFactor: 0,
+        roughnessFactor: 0,
+        irReflectance: 0,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.05,
+        emissiveFactor: [0,0,0],
+        density: 997,
+        viscosity: 1,
+        heatCapacity: 4200,
+        thermalConductivity: 0.66,
+        ...defaultSolid,
+        ...noSolidCurve,
+    },
+    rock: {
+        baseColorFactor: [0.5,0.5,0.5,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.8,
+        irReflectance: 0.1,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.15,
+        emissiveFactor: [0,0,0],
+        density: 2650,
+        viscosity: 0,
+        heatCapacity: 800,
+        thermalConductivity: 4,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.0016,80],
+            tensileFractureStrainStress: [0.002,90],
+            compressiveYieldStrainStress: [-0.0026,-130],
+            compressiveFractureStrainStress: [-0.004,-160],
+        }),
+    },
+    ice: {
+        baseColorFactor: [0.8,0.8,1,0.5],
+                metallicFactor: 0,
+        roughnessFactor: 0.1,
+        irReflectance: 0.2,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.2,
+        emissiveFactor: [0,0,0],
+        density: 917,
+        viscosity: 0,
+        heatCapacity: 2040,
+        thermalConductivity: 2.18,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00156,15],
+            tensileFractureStrainStress: [0.002,18],
+            compressiveYieldStrainStress: [-0.00365,-35],
+            compressiveFractureStrainStress: [-0.005,-45],
+        }),
+    },
+    iron: {
+        baseColorFactor: [0.7,0.7,0.7,1],
+                metallicFactor: 1,
+        roughnessFactor: 0.3,
+        irReflectance: 0.4,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.45,
+        emissiveFactor: [0,0,0],
+        density: 7874,
+        viscosity: 0,
+        heatCapacity: 460,
+        thermalConductivity: 50,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.001,200],
+            tensileFractureStrainStress: [0.12,350],
+            compressiveYieldStrainStress: [-0.0011,-220],
+            compressiveFractureStrainStress: [-0.11,-400],
+        }),
+    },
+    dirt: {
+        baseColorFactor: [0.4,0.3,0.2,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.9,
+        irReflectance: 0.05,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.05,
+        emissiveFactor: [0,0,0],
+        density: 1510,
+        viscosity: 0,
+        heatCapacity: 800,
+        thermalConductivity: 0.25,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.04,2],
+            tensileFractureStrainStress: [0.08,4],
+            compressiveYieldStrainStress: [-0.12,-6],
+            compressiveFractureStrainStress: [-0.2,-10],
+        }),
+    },
+    sand: {
+        baseColorFactor: [0.9,0.8,0.6,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.8,
+        irReflectance: 0.1,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.15,
+        emissiveFactor: [0,0,0],
+        density: 2100,
+        viscosity: 0,
+        heatCapacity: 830,
+        thermalConductivity: 0.2,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.0125,1],
+            tensileFractureStrainStress: [0.025,2],
+            compressiveYieldStrainStress: [-0.05,-4],
+            compressiveFractureStrainStress: [-0.09,-7],
+        }),
+    },
+    woodHard: {
+        baseColorFactor: [0.6,0.4,0.2,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.7,
+        irReflectance: 0.05,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.3,
+        emissiveFactor: [0,0,0],
+        density: 650,
+        viscosity: 0,
+        heatCapacity: 2000,
+        thermalConductivity: 0.16,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00375,45],
+            tensileFractureStrainStress: [0.04,52],
+            compressiveYieldStrainStress: [-0.0048,-58],
+            compressiveFractureStrainStress: [-0.055,-68],
+        }),
+    },
+    woodSoft: {
+        baseColorFactor: [0.7,0.5,0.3,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.8,
+        irReflectance: 0.05,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.28,
+        emissiveFactor: [0,0,0],
+        density: 490,
+        viscosity: 0,
+        heatCapacity: 2300,
+        thermalConductivity: 0.12,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00389,35],
+            tensileFractureStrainStress: [0.045,42],
+            compressiveYieldStrainStress: [-0.00489,-44],
+            compressiveFractureStrainStress: [-0.055,-54],
+        }),
+    },
+    steel: {
+        baseColorFactor: [0.55,0.55,0.6,1],
+                metallicFactor: 1,
+        roughnessFactor: 0.2,
+        irReflectance: 0.3,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.55,
+        emissiveFactor: [0,0,0],
+        density: 7850,
+        viscosity: 0,
+        heatCapacity: 490,
+        thermalConductivity: 50,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00175,350],
+            tensileFractureStrainStress: [0.15,500],
+            compressiveYieldStrainStress: [-0.0019,-380],
+            compressiveFractureStrainStress: [-0.13,-520],
+        }),
+    },
+    concrete: {
+        baseColorFactor: [0.6,0.6,0.6,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.9,
+        irReflectance: 0.1,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.12,
+        emissiveFactor: [0,0,0],
+        density: 2400,
+        viscosity: 0,
+        heatCapacity: 880,
+        thermalConductivity: 1.4,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.000117,3.5],
+            tensileFractureStrainStress: [0.00015,4],
+            compressiveYieldStrainStress: [-0.00117,-35],
+            compressiveFractureStrainStress: [-0.003,-40],
+        }),
+    },
+    reinforcedConcrete: {
+        baseColorFactor: [0.55,0.55,0.55,1],
+                metallicFactor: 0.1,
+        roughnessFactor: 0.9,
+        irReflectance: 0.15,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.14,
+        emissiveFactor: [0,0,0],
+        density: 2500,
+        viscosity: 0,
+        heatCapacity: 880,
+        thermalConductivity: 2,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00015,4.5],
+            tensileFractureStrainStress: [0.00022,5.5],
+            compressiveYieldStrainStress: [-0.0015,-45],
+            compressiveFractureStrainStress: [-0.0035,-55],
+        }),
+    },
+    glass: {
+        baseColorFactor: [0.9,0.95,1,0.3],
+                metallicFactor: 0,
+        roughnessFactor: 0.05,
+        irReflectance: 0.1,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.18,
+        emissiveFactor: [0,0,0],
+        density: 2500,
+        viscosity: 0,
+        heatCapacity: 840,
+        thermalConductivity: 1,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00043,30],
+            tensileFractureStrainStress: [0.0007,35],
+            compressiveYieldStrainStress: [-0.005,-350],
+            compressiveFractureStrainStress: [-0.006,-400],
+        }),
+    },
+    temperedGlass: {
+        baseColorFactor: [0.5,0.55,0.6,0.4],
+                metallicFactor: 0,
+        roughnessFactor: 0.05,
+        irReflectance: 0.15,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.22,
+        emissiveFactor: [0,0,0],
+        density: 2500,
+        viscosity: 0,
+        heatCapacity: 840,
+        thermalConductivity: 1,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00171,120],
+            tensileFractureStrainStress: [0.004,200],
+            compressiveYieldStrainStress: [-0.00786,-550],
+            compressiveFractureStrainStress: [-0.0095,-620],
+        }),
+    },
+    meta: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.2,0.6,0.7,1],
+    },
+    marble: {
+        baseColorFactor: [0.9,0.9,0.9,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.3,
+        irReflectance: 0.2,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.12,
+        emissiveFactor: [0,0,0],
+        density: 2700,
+        viscosity: 0,
+        heatCapacity: 830,
+        thermalConductivity: 1.4,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.000455,25],
+            tensileFractureStrainStress: [0.00065,30],
+            compressiveYieldStrainStress: [-0.00173,-95],
+            compressiveFractureStrainStress: [-0.00273,-125],
+        }),
+    },
+    granite: {
+        baseColorFactor: [0.8,0.8,0.8,1],
+                metallicFactor: 0,
+        roughnessFactor: 0.6,
+        irReflectance: 0.15,
+        irEmission: 0,
+        emissionMode: 0,
+        restitution: 0.12,
+        emissiveFactor: [0,0,0],
+        density: 2700,
+        viscosity: 0,
+        heatCapacity: 830,
+        thermalConductivity: 1.4,
+        stressStrainCurve: StressStrainCurve.create({
+            tensileYieldStrainStress: [0.00222,100],
+            tensileFractureStrainStress: [0.0032,120],
+            compressiveYieldStrainStress: [-0.00422,-190],
+            compressiveFractureStrainStress: [-0.00555,-230],
+        }),
+    },
+    metaRed: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,0,0,1],
+    },
+    metaOrange: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,0.5,0,1],
+    },
+    metaYellow: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,1,0,1],
+    },
+    metaLime: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.5,1,0,1],
+    },
+    metaGreen: {
+        ...metaMaterialBase,
+        baseColorFactor: [0,1,0,1],
+    },
+    metaTeal: {
+        ...metaMaterialBase,
+        baseColorFactor: [0,1,0.5,1],
+    },
+    metaCyan: {
+        ...metaMaterialBase,
+        baseColorFactor: [0,1,1,1],
+    },
+    metaBlue: {
+        ...metaMaterialBase,
+        baseColorFactor: [0,0.5,1,1],
+    },
+    metaIndigo: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.25,0,1,1],
+    },
+    metaViolet: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.5,0,1,1],
+    },
+    metaPurple: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.75,0,1,1],
+    },
+    metaMagenta: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,0,1,1],
+    },
+    metaPink: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,0.5,0.75,1],
+    },
+    metaWhite: {
+        ...metaMaterialBase,
+        baseColorFactor: [1,1,1,1],
+    },
+    metaGray: {
+        ...metaMaterialBase,
+        baseColorFactor: [0.5,0.5,0.5,1],
+    },
+    metaBlack: {
+        ...metaMaterialBase,
+        baseColorFactor: [0,0,0,1],
+    },
+} as const satisfies Record<string, Partial<MaterialDefinition>>;

package/src/material/emission-mode.ts

@@ -0,0 +1,11 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+/** Visible emission interpretation (matches legacy material schema). */
+export const EmissionMode = {
+    /** UV fluorescence — emissive does not add to visible output. */
+    uvFluorescence: 0,
+    /** Visible luminescence — `emissiveFactor` + `irEmission` contribute to the lit color. */
+    visibleLuminescence: 1,
+} as const;
+
+export type EmissionMode = (typeof EmissionMode)[keyof typeof EmissionMode];

package/src/material/index.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+export * from "./public.js";

package/src/material/json/from-json-string.ts

@@ -0,0 +1,11 @@
+import { fromJson, type FromJsonResult } from "./from-json.js";
+
+export const fromJsonString = (text: string): FromJsonResult => {
+    let parsed: unknown;
+    try {
+        parsed = JSON.parse(text);
+    } catch {
+        return { ok: false, reason: "not_object" };
+    }
+    return fromJson(parsed);
+};

package/src/material/json/from-json.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+import { fromJson } from "./from-json.js";
+import { fromJsonString } from "./from-json-string.js";
+
+const airJson = {
+    baseColor: [1, 1, 1, 0],
+    metallic: 0,
+    roughness: 0,
+    irReflectance: 0,
+    irEmission: 0,
+    emissionRgb: [0, 0, 0],
+    emissionMode: 0,
+    density: 1.225,
+    viscosity: 0,
+    specificHeatCapacity: 1006,
+    thermalConductivity: 0.024,
+    stressStrainCurve: {
+        tensileYieldStrainStress: [0, 0],
+        tensileFractureStrainStress: [0, 0],
+        compressiveYieldStrainStress: [0, 0],
+        compressiveFractureStrainStress: [0, 0],
+    },
+    restitution: 0,
+} as const;
+
+describe("fromJson", () => {
+    it("parses a name → props library object", () => {
+        const result = fromJson({ air: airJson, rock: airJson });
+
+        expect(result.ok).toBe(true);
+        if (!result.ok) return;
+
+        expect(Object.keys(result.definitions)).toEqual(["air", "rock"]);
+        expect(result.definitions.air?.density).toBe(1.225);
+        expect(result.definitions.air?.heatCapacity).toBe(1006);
+        expect(result.definitions.air?.metallicFactor).toBe(0);
+    });
+
+    it("rejects invalid entries", () => {
+        const result = fromJson({ bad: { metallic: 1 } });
+        expect(result).toEqual({ ok: false, reason: "invalid_entry", name: "bad" });
+    });
+});
+
+describe("fromJsonString", () => {
+    it("parses JSON text", () => {
+        const result = fromJsonString(JSON.stringify({ air: airJson }));
+        expect(result.ok).toBe(true);
+    });
+});

package/src/material/json/from-json.ts

@@ -0,0 +1,23 @@
+import type { MaterialDefinition } from "../material-definition.js";
+import { toDefinitionFromUnknown } from "./to-definition.js";
+
+export type FromJsonResult =
+    | { readonly ok: true; readonly definitions: Readonly<Record<string, MaterialDefinition>> }
+    | { readonly ok: false; readonly reason: "not_object" | "invalid_entry"; readonly name?: string };
+
+export const fromJson = (input: unknown): FromJsonResult => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        return { ok: false, reason: "not_object" };
+    }
+
+    const definitions: Record<string, MaterialDefinition> = {};
+    for (const [name, props] of Object.entries(input)) {
+        const definition = toDefinitionFromUnknown(props as Record<string, unknown>);
+        if (!definition) {
+            return { ok: false, reason: "invalid_entry", name };
+        }
+        definitions[name] = definition;
+    }
+
+    return { ok: true, definitions };
+};

package/src/material/json/is-properties-json.ts

@@ -0,0 +1,77 @@
+import type { PropertiesJson } from "./properties-json.js";
+
+const isNumber = (value: unknown): value is number =>
+    typeof value === "number" && Number.isFinite(value);
+
+const isVec2 = (value: unknown): value is readonly [number, number] =>
+    Array.isArray(value)
+    && value.length === 2
+    && isNumber(value[0])
+    && isNumber(value[1]);
+
+const isVec3 = (value: unknown): value is readonly [number, number, number] =>
+    Array.isArray(value)
+    && value.length === 3
+    && isNumber(value[0])
+    && isNumber(value[1])
+    && isNumber(value[2]);
+
+const isVec4 = (value: unknown): value is readonly [number, number, number, number] =>
+    Array.isArray(value)
+    && value.length === 4
+    && isNumber(value[0])
+    && isNumber(value[1])
+    && isNumber(value[2])
+    && isNumber(value[3]);
+
+const isStressStrainCurveJson = (
+    value: unknown,
+): value is PropertiesJson["stressStrainCurve"] => {
+    if (typeof value !== "object" || value === null) return false;
+    const curve = value as Record<string, unknown>;
+    return (
+        isVec2(curve.tensileYieldStrainStress)
+        && isVec2(curve.tensileFractureStrainStress)
+        && isVec2(curve.compressiveYieldStrainStress)
+        && isVec2(curve.compressiveFractureStrainStress)
+    );
+};
+
+const readVec4 = (props: Record<string, unknown>): readonly [number, number, number, number] | null => {
+    if (isVec4(props.baseColorFactor)) return props.baseColorFactor;
+    if (isVec4(props.baseColor)) return props.baseColor;
+    return null;
+};
+
+const readVec3 = (props: Record<string, unknown>): readonly [number, number, number] | null => {
+    if (isVec3(props.emissiveFactor)) return props.emissiveFactor;
+    if (isVec3(props.emissionRgb)) return props.emissionRgb;
+    return null;
+};
+
+const readNumber = (props: Record<string, unknown>, ...keys: string[]): number | null => {
+    for (const key of keys) {
+        if (isNumber(props[key])) return props[key];
+    }
+    return null;
+};
+
+export const isPropertiesJson = (value: unknown): value is PropertiesJson => {
+    if (typeof value !== "object" || value === null) return false;
+    const props = value as Record<string, unknown>;
+    return (
+        readVec4(props) !== null
+        && readVec3(props) !== null
+        && isNumber(props.metallicFactor ?? props.metallic)
+        && isNumber(props.roughnessFactor ?? props.roughness)
+        && isNumber(props.irReflectance)
+        && isNumber(props.irEmission)
+        && isNumber(props.emissionMode)
+        && isNumber(props.density)
+        && isNumber(props.viscosity)
+        && isNumber(props.heatCapacity ?? props.specificHeatCapacity)
+        && isNumber(props.thermalConductivity)
+        && isStressStrainCurveJson(props.stressStrainCurve)
+        && isNumber(props.restitution)
+    );
+};

package/src/material/json/library-json.ts

@@ -0,0 +1,4 @@
+import type { MaterialDefinition } from "../material-definition.js";
+
+/** name → material property bundle, as authored in a JSON library file. */
+export type LibraryJson = Readonly<Record<string, MaterialDefinition>>;

package/src/material/json/load-json.ts

@@ -0,0 +1,15 @@
+import { fromJsonString } from "./from-json-string.js";
+import type { FromJsonResult } from "./from-json.js";
+
+export type LoadJsonResult =
+    | FromJsonResult
+    | { readonly ok: false; readonly reason: "fetch_failed"; readonly status: number };
+
+export const loadJson = async (url: string): Promise<LoadJsonResult> => {
+    const response = await fetch(url);
+    if (!response.ok) {
+        return { ok: false, reason: "fetch_failed", status: response.status };
+    }
+    const text = await response.text();
+    return fromJsonString(text);
+};

package/src/material/json/properties-json.ts

@@ -0,0 +1,25 @@
+/** One material entry in a material library JSON file. */
+export type PropertiesJson = {
+    readonly baseColorFactor: readonly [number, number, number, number];
+    readonly emissiveFactor: readonly [number, number, number];
+    readonly metallicFactor: number;
+    readonly roughnessFactor: number;
+    readonly irReflectance: number;
+    readonly irEmission: number;
+    readonly emissionMode: number;
+    readonly density: number;
+    readonly viscosity: number;
+    readonly heatCapacity: number;
+    readonly thermalConductivity: number;
+    readonly restitution: number;
+    readonly friction?: number;
+    readonly compliance?: number;
+    readonly normalScale?: number;
+    readonly occlusionStrength?: number;
+    readonly stressStrainCurve: {
+        readonly tensileYieldStrainStress: readonly [number, number];
+        readonly tensileFractureStrainStress: readonly [number, number];
+        readonly compressiveYieldStrainStress: readonly [number, number];
+        readonly compressiveFractureStrainStress: readonly [number, number];
+    };
+};

package/src/material/json/public.ts

@@ -0,0 +1,9 @@
+export type { LibraryJson } from "./library-json.js";
+export type { PropertiesJson } from "./properties-json.js";
+export type { FromJsonResult } from "./from-json.js";
+export type { LoadJsonResult } from "./load-json.js";
+export { isPropertiesJson } from "./is-properties-json.js";
+export { toDefinition } from "./to-definition.js";
+export { fromJson } from "./from-json.js";
+export { fromJsonString } from "./from-json-string.js";
+export { loadJson } from "./load-json.js";