aigpu 0.3.1

package/dist/scene/geometry-src/torus-data.js

@@ -0,0 +1,38 @@
+import { pushVertex, toFlatTriangles } from "./primitive-data-utils.js";
+export function torusData(spec) {
+    const smooth = torusSmoothData(spec);
+    return spec.shading === "flat" ? toFlatTriangles(smooth) : smooth;
+}
+function torusSmoothData(spec) {
+    const { radius, tube, radialSegments, tubularSegments, arc } = spec;
+    const vertices = [];
+    const indices = [];
+    const row = radialSegments + 1;
+    for (let j = 0; j <= tubularSegments; j++) {
+        const u = j / tubularSegments;
+        const ring = u * arc;
+        const cosRing = Math.cos(ring);
+        const sinRing = Math.sin(ring);
+        for (let i = 0; i <= radialSegments; i++) {
+            const v = i / radialSegments;
+            const cross = v * Math.PI * 2;
+            const cosTube = Math.cos(cross);
+            const sinTube = Math.sin(cross);
+            const x = (radius + tube * cosTube) * cosRing;
+            const y = tube * sinTube;
+            const z = (radius + tube * cosTube) * sinRing;
+            pushVertex(vertices, x, y, z, cosTube * cosRing, sinTube, cosTube * sinRing, u, v);
+        }
+    }
+    for (let j = 0; j < tubularSegments; j++) {
+        for (let i = 0; i < radialSegments; i++) {
+            const a = j * row + i;
+            const b = a + 1;
+            const d = (j + 1) * row + i;
+            const c = d + 1;
+            indices.push(a, b, d, b, c, d);
+        }
+    }
+    return { vertices: new Float32Array(vertices), indices: new Uint16Array(indices), vertexCount: vertices.length / 8 };
+}
+//# sourceMappingURL=torus-data.js.map

package/dist/scene/geometry-src/torus-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"torus-data.js","sourceRoot":"","sources":["../../../src/scene/geometry-src/torus-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAqB,MAAM,2BAA2B,CAAC;AAW3F,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACpE,CAAC;AAED,SAAS,eAAe,CAAC,IAAmB;IAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACpE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,cAAc,GAAG,CAAC,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;YAC7B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;YAC9C,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;YAC9C,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AACvH,CAAC"}

package/dist/scene/geometry-src/vertex-layout.d.ts

@@ -0,0 +1,2 @@
+export type VertexLayoutKind = "position-only" | "position-normal" | "position-normal-uv";
+//# sourceMappingURL=vertex-layout.d.ts.map

package/dist/scene/geometry-src/vertex-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-layout.d.ts","sourceRoot":"","sources":["../../../src/scene/geometry-src/vertex-layout.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,iBAAiB,GAAG,oBAAoB,CAAC"}

package/dist/scene/geometry-src/vertex-layout.js

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

package/dist/scene/geometry-src/vertex-layout.js.map

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

package/dist/scene/geometry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Mesh recipes: pure CPU values (`{ kind, props }`) that carry their own upload.
+ *
+ * Each factory imports exactly one generator and closes over it, so the module graph — not a
+ * registry — decides what a program pays for: `box()` links `mesh-box.ts` and nothing else, and
+ * `geometry(gpu, recipe)` needs no knowledge of any primitive to expand it. The values stay frozen,
+ * device-free and lazy, which keeps them safe to store in a scene node and to fingerprint by
+ * `kind` + `props`.
+ */
+import { type GeometryRecipeOf } from "./geometry-recipe.ts";
+import type { BoxSpec, CapsuleSpec, ConeSpec, CylinderSpec, DiskSpec, FullscreenQuadSpec, IcosphereSpec, PlaneSpec, PolyhedronSpec, RingSpec, SphereSpec, TorusSpec } from "./geometry-src/index.ts";
+export type { GeometryRecipe } from "./geometry-recipe.ts";
+/** Removes Device and makes render-domain spec fields optional so scene descriptors stay pure. */
+type WithoutDevice<T> = Partial<Omit<T, "device">>;
+export type BoxOptions = WithoutDevice<BoxSpec>;
+export type CapsuleOptions = WithoutDevice<CapsuleSpec>;
+export type ConeOptions = WithoutDevice<ConeSpec>;
+export type CylinderOptions = WithoutDevice<CylinderSpec>;
+export type DiskOptions = WithoutDevice<DiskSpec>;
+export type FullscreenQuadOptions = WithoutDevice<FullscreenQuadSpec>;
+export type IcosphereOptions = WithoutDevice<IcosphereSpec>;
+export type PlaneOptions = WithoutDevice<PlaneSpec>;
+export type PolyhedronOptions = WithoutDevice<PolyhedronSpec>;
+export type RingOptions = WithoutDevice<RingSpec>;
+export type SphereOptions = WithoutDevice<SphereSpec>;
+export type TorusOptions = WithoutDevice<TorusSpec>;
+type RecipeProps = {
+    readonly box: BoxOptions;
+    readonly capsule: CapsuleOptions;
+    readonly cone: ConeOptions;
+    readonly cylinder: CylinderOptions;
+    readonly disk: DiskOptions;
+    readonly dodecahedron: PolyhedronOptions;
+    readonly fullscreenQuad: FullscreenQuadOptions;
+    readonly icosahedron: PolyhedronOptions;
+    readonly icosphere: IcosphereOptions;
+    readonly octahedron: PolyhedronOptions;
+    readonly plane: PlaneOptions;
+    readonly ring: RingOptions;
+    readonly sphere: SphereOptions;
+    readonly tetrahedron: PolyhedronOptions;
+    readonly torus: TorusOptions;
+};
+export type GeometryKind = keyof RecipeProps;
+export type SceneGeometryOfKind<K extends GeometryKind> = Extract<SceneGeometry, {
+    readonly kind: K;
+}>;
+/**
+ * Any of the 15 recipes. Still `{ kind, props }` for consumers that inspect or store it — the
+ * `build()` it also carries is internal, and is what lets `geometry()` expand it without a table.
+ */
+export type SceneGeometry = {
+    [K in GeometryKind]: GeometryRecipeOf<K, RecipeProps[K]>;
+}[GeometryKind];
+export declare function box(options?: BoxOptions): SceneGeometryOfKind<"box">;
+export declare function capsule(options?: CapsuleOptions): SceneGeometryOfKind<"capsule">;
+export declare function cone(options?: ConeOptions): SceneGeometryOfKind<"cone">;
+export declare function cylinder(options?: CylinderOptions): SceneGeometryOfKind<"cylinder">;
+export declare function disk(options?: DiskOptions): SceneGeometryOfKind<"disk">;
+export declare function dodecahedron(options?: PolyhedronOptions): SceneGeometryOfKind<"dodecahedron">;
+export declare function fullscreenQuad(options?: FullscreenQuadOptions): SceneGeometryOfKind<"fullscreenQuad">;
+export declare function icosahedron(options?: PolyhedronOptions): SceneGeometryOfKind<"icosahedron">;
+export declare function icosphere(options?: IcosphereOptions): SceneGeometryOfKind<"icosphere">;
+export declare function octahedron(options?: PolyhedronOptions): SceneGeometryOfKind<"octahedron">;
+export declare function plane(options?: PlaneOptions): SceneGeometryOfKind<"plane">;
+export declare function ring(options?: RingOptions): SceneGeometryOfKind<"ring">;
+export declare function sphere(options?: SphereOptions): SceneGeometryOfKind<"sphere">;
+export declare function tetrahedron(options?: PolyhedronOptions): SceneGeometryOfKind<"tetrahedron">;
+export declare function torus(options?: TorusOptions): SceneGeometryOfKind<"torus">;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/scene/geometry.d.ts.map

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

package/dist/scene/geometry.js

@@ -0,0 +1,71 @@
+/**
+ * Mesh recipes: pure CPU values (`{ kind, props }`) that carry their own upload.
+ *
+ * Each factory imports exactly one generator and closes over it, so the module graph — not a
+ * registry — decides what a program pays for: `box()` links `mesh-box.ts` and nothing else, and
+ * `geometry(gpu, recipe)` needs no knowledge of any primitive to expand it. The values stay frozen,
+ * device-free and lazy, which keeps them safe to store in a scene node and to fingerprint by
+ * `kind` + `props`.
+ */
+import { recipe } from "./geometry-recipe.js";
+import { box as generateBox } from "./geometry-src/mesh-box.js";
+import { capsule as generateCapsule } from "./geometry-src/mesh-capsule.js";
+import { cone as generateCone } from "./geometry-src/mesh-cone.js";
+import { cylinder as generateCylinder } from "./geometry-src/mesh-cylinder.js";
+import { disk as generateDisk } from "./geometry-src/mesh-disk.js";
+import { dodecahedron as generateDodecahedron } from "./geometry-src/mesh-dodecahedron.js";
+import { fullscreenQuad as generateFullscreenQuad } from "./geometry-src/mesh-fullscreen-quad.js";
+import { icosahedron as generateIcosahedron } from "./geometry-src/mesh-icosahedron.js";
+import { icosphere as generateIcosphere } from "./geometry-src/mesh-icosphere.js";
+import { octahedron as generateOctahedron } from "./geometry-src/mesh-octahedron.js";
+import { plane as generatePlane } from "./geometry-src/mesh-plane.js";
+import { ring as generateRing } from "./geometry-src/mesh-ring.js";
+import { sphere as generateSphere } from "./geometry-src/mesh-sphere.js";
+import { tetrahedron as generateTetrahedron } from "./geometry-src/mesh-tetrahedron.js";
+import { torus as generateTorus } from "./geometry-src/mesh-torus.js";
+export function box(options = {}) {
+    return recipe("box", options, (device, props) => generateBox({ device, ...props }));
+}
+export function capsule(options = {}) {
+    return recipe("capsule", options, (device, props) => generateCapsule({ device, radius: 0.5, height: 1, ...props }));
+}
+export function cone(options = {}) {
+    return recipe("cone", options, (device, props) => generateCone({ device, radius: 0.5, height: 1, ...props }));
+}
+export function cylinder(options = {}) {
+    return recipe("cylinder", options, (device, props) => generateCylinder({ device, radius: 0.5, height: 1, ...props }));
+}
+export function disk(options = {}) {
+    return recipe("disk", options, (device, props) => generateDisk({ device, radius: 0.5, ...props }));
+}
+export function dodecahedron(options = {}) {
+    return recipe("dodecahedron", options, (device, props) => generateDodecahedron({ device, radius: 0.5, ...props }));
+}
+export function fullscreenQuad(options = {}) {
+    return recipe("fullscreenQuad", options, (device, props) => generateFullscreenQuad({ device, ...props }));
+}
+export function icosahedron(options = {}) {
+    return recipe("icosahedron", options, (device, props) => generateIcosahedron({ device, radius: 0.5, ...props }));
+}
+export function icosphere(options = {}) {
+    return recipe("icosphere", options, (device, props) => generateIcosphere({ device, radius: 0.5, ...props }));
+}
+export function octahedron(options = {}) {
+    return recipe("octahedron", options, (device, props) => generateOctahedron({ device, radius: 0.5, ...props }));
+}
+export function plane(options = {}) {
+    return recipe("plane", options, (device, props) => generatePlane({ device, ...props }));
+}
+export function ring(options = {}) {
+    return recipe("ring", options, (device, props) => generateRing({ device, innerRadius: 0.25, outerRadius: 0.5, ...props }));
+}
+export function sphere(options = {}) {
+    return recipe("sphere", options, (device, props) => generateSphere({ device, ...props }));
+}
+export function tetrahedron(options = {}) {
+    return recipe("tetrahedron", options, (device, props) => generateTetrahedron({ device, radius: 0.5, ...props }));
+}
+export function torus(options = {}) {
+    return recipe("torus", options, (device, props) => generateTorus({ device, radius: 0.5, tube: 0.2, ...props }));
+}
+//# sourceMappingURL=geometry.js.map

package/dist/scene/geometry.js.map

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

package/dist/scene/orbit.d.ts

@@ -0,0 +1,9 @@
+export type Mat4 = Float32Array;
+export interface OrbitOptions {
+    readonly radius?: number;
+    readonly height?: number;
+    readonly speed?: number;
+}
+/** Returns a column-major model matrix orbiting around the Y axis using explicit JS time. */
+export declare function orbit(time: number, options?: OrbitOptions): Mat4;
+//# sourceMappingURL=orbit.d.ts.map

package/dist/scene/orbit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.d.ts","sourceRoot":"","sources":["../../src/scene/orbit.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,YAAY,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CAYpE"}

package/dist/scene/orbit.js

@@ -0,0 +1,15 @@
+/** Returns a column-major model matrix orbiting around the Y axis using explicit JS time. */
+export function orbit(time, options = {}) {
+    const angle = time * (options.speed ?? 1);
+    const radius = options.radius ?? 1;
+    const y = options.height ?? 0;
+    const c = Math.cos(angle);
+    const s = Math.sin(angle);
+    return new Float32Array([
+        c, 0, -s, 0,
+        0, 1, 0, 0,
+        s, 0, c, 0,
+        c * radius, y, s * radius, 1,
+    ]);
+}
+//# sourceMappingURL=orbit.js.map

package/dist/scene/orbit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.js","sourceRoot":"","sources":["../../src/scene/orbit.ts"],"names":[],"mappings":"AAQA,6FAA6F;AAC7F,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,UAAwB,EAAE;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,IAAI,YAAY,CAAC;QACtB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACX,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/scene/tree/errors.d.ts

@@ -0,0 +1,4 @@
+import { AIGpuError } from "../../errors.ts";
+export declare function sceneCycleError(where: string, label: string | undefined): AIGpuError;
+export declare function sceneValueError(where: string, name: string, expected: string): AIGpuError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/scene/tree/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/scene/tree/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAQpF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAOzF"}

package/dist/scene/tree/errors.js

@@ -0,0 +1,19 @@
+import { AIGpuError } from "../../errors.js";
+export function sceneCycleError(where, label) {
+    const name = label ? `'${label}'` : "the node";
+    return new AIGpuError({
+        code: "AIGPU-SCENE-CYCLE",
+        message: `add() would make ${name} an ancestor of itself.`,
+        fix: "Remove the node from the ancestor chain first, or add a different node.",
+        where,
+    });
+}
+export function sceneValueError(where, name, expected) {
+    return new AIGpuError({
+        code: "AIGPU-SCENE-VALUE-INVALID",
+        message: `\`${name}\` is invalid; expected ${expected}.`,
+        fix: `Pass ${expected} for \`${name}\`.`,
+        where,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/scene/tree/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/scene/tree/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAyB;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/C,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,oBAAoB,IAAI,yBAAyB;QAC1D,GAAG,EAAE,yEAAyE;QAC9E,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,IAAY,EAAE,QAAgB;IAC3E,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,KAAK,IAAI,2BAA2B,QAAQ,GAAG;QACxD,GAAG,EAAE,QAAQ,QAAQ,UAAU,IAAI,KAAK;QACxC,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/scene/tree/light.d.ts

@@ -0,0 +1,42 @@
+import { SceneNode, type NodeOptions, type NodeTransformValues, type Vec3Like } from "./node.ts";
+export interface DirectionalLightOptions extends NodeOptions {
+    /** World-space direction the light travels toward. Defaults to `[0, -1, 0]`. */
+    readonly direction?: Vec3Like;
+    /** Linear RGB color. Defaults to white. */
+    readonly color?: Vec3Like;
+    readonly intensity?: number;
+}
+export interface DirectionalLightValues extends NodeTransformValues {
+    readonly direction?: Vec3Like;
+    readonly color?: Vec3Like;
+    readonly intensity?: number;
+}
+export interface AmbientLightOptions extends NodeOptions {
+    readonly color?: Vec3Like;
+    readonly intensity?: number;
+}
+export interface AmbientLightValues extends NodeTransformValues {
+    readonly color?: Vec3Like;
+    readonly intensity?: number;
+}
+/** Directional (sun-style) light node. Direction is explicit, not transform-derived. */
+export declare class DirectionalLight extends SceneNode {
+    #private;
+    constructor(options?: DirectionalLightOptions);
+    set(values: DirectionalLightValues): this;
+    /** World-space travel direction. Stable array identity; mutate via `set()`. */
+    get direction(): Float32Array;
+    get color(): Float32Array;
+    get intensity(): number;
+}
+/** Ambient fill light node applied uniformly to lit materials. */
+export declare class AmbientLight extends SceneNode {
+    #private;
+    constructor(options?: AmbientLightOptions);
+    set(values: AmbientLightValues): this;
+    get color(): Float32Array;
+    get intensity(): number;
+}
+export declare function directionalLight(options?: DirectionalLightOptions): DirectionalLight;
+export declare function ambientLight(options?: AmbientLightOptions): AmbientLight;
+//# sourceMappingURL=light.d.ts.map

package/dist/scene/tree/light.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light.d.ts","sourceRoot":"","sources":["../../../src/scene/tree/light.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjG,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wFAAwF;AACxF,qBAAa,gBAAiB,SAAQ,SAAS;;gBAKjC,OAAO,GAAE,uBAA4B;IAQxC,GAAG,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAMlD,+EAA+E;IAC/E,IAAI,SAAS,IAAI,YAAY,CAE5B;IAED,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;CAQF;AAED,kEAAkE;AAClE,qBAAa,YAAa,SAAQ,SAAS;;gBAI7B,OAAO,GAAE,mBAAwB;IAOpC,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAM9C,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;CAOF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAE5E"}

package/dist/scene/tree/light.js

@@ -0,0 +1,102 @@
+import { sceneValueError } from "./errors.js";
+import { SceneNode } from "./node.js";
+/** Directional (sun-style) light node. Direction is explicit, not transform-derived. */
+export class DirectionalLight extends SceneNode {
+    #direction = new Float32Array([0, -1, 0]);
+    #color = new Float32Array([1, 1, 1]);
+    #intensity = 1;
+    constructor(options = {}) {
+        // Validate before super(): SceneNode's constructor reparents `options.children`, so a
+        // throw after it would strand them on a light nobody can reach.
+        validateLightOptions(`${options.label ?? "directional-light"}.set`, options);
+        super("directional-light", options);
+        this.#apply(options);
+    }
+    set(values) {
+        super.set(values);
+        this.#apply(values);
+        return this;
+    }
+    /** World-space travel direction. Stable array identity; mutate via `set()`. */
+    get direction() {
+        return this.#direction;
+    }
+    get color() {
+        return this.#color;
+    }
+    get intensity() {
+        return this.#intensity;
+    }
+    #apply(values) {
+        const where = `${this.label ?? this.kind}.set`;
+        if (values.direction !== undefined)
+            writeVec3(this.#direction, values.direction, "direction", where);
+        if (values.color !== undefined)
+            writeVec3(this.#color, values.color, "color", where);
+        if (values.intensity !== undefined)
+            this.#intensity = requireNonNegative(where, values.intensity);
+    }
+}
+/** Ambient fill light node applied uniformly to lit materials. */
+export class AmbientLight extends SceneNode {
+    #color = new Float32Array([1, 1, 1]);
+    #intensity = 1;
+    constructor(options = {}) {
+        // Validate before super(): see DirectionalLight.
+        validateLightOptions(`${options.label ?? "ambient-light"}.set`, options);
+        super("ambient-light", options);
+        this.#apply(options);
+    }
+    set(values) {
+        super.set(values);
+        this.#apply(values);
+        return this;
+    }
+    get color() {
+        return this.#color;
+    }
+    get intensity() {
+        return this.#intensity;
+    }
+    #apply(values) {
+        const where = `${this.label ?? this.kind}.set`;
+        if (values.color !== undefined)
+            writeVec3(this.#color, values.color, "color", where);
+        if (values.intensity !== undefined)
+            this.#intensity = requireNonNegative(where, values.intensity);
+    }
+}
+export function directionalLight(options = {}) {
+    return new DirectionalLight(options);
+}
+export function ambientLight(options = {}) {
+    return new AmbientLight(options);
+}
+function writeVec3(out, value, name, where) {
+    if (value.length !== 3)
+        throw sceneValueError(where, name, "an array of 3 numbers");
+    out[0] = value[0];
+    out[1] = value[1];
+    out[2] = value[2];
+}
+/**
+ * Raw-option check runnable before `super()` (no `this`). `#apply()` re-runs the same
+ * checks after construction, so the two paths cannot drift.
+ */
+function validateLightOptions(where, options) {
+    const direction = options.direction;
+    if (direction !== undefined && direction.length !== 3) {
+        throw sceneValueError(where, "direction", "an array of 3 numbers");
+    }
+    if (options.color !== undefined && options.color.length !== 3) {
+        throw sceneValueError(where, "color", "an array of 3 numbers");
+    }
+    if (options.intensity !== undefined)
+        requireNonNegative(where, options.intensity);
+}
+function requireNonNegative(where, value) {
+    if (!(value >= 0))
+        throw sceneValueError(where, "intensity", "a number greater than or equal to 0");
+    return value;
+}
+//# sourceMappingURL=light.js.map

package/dist/scene/tree/light.js.map

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

package/dist/scene/tree/material.d.ts

@@ -0,0 +1,79 @@
+import type { Vec3Like } from "./node.ts";
+export type SceneMaterialKind = "unlit" | "normal" | "lambert" | "shader";
+/** Blend preset shared with `DrawOptions.blend`. */
+export type MaterialBlend = "alpha" | "additive" | "premultiplied";
+/**
+ * Pure material descriptor consumed by the scene renderer. Holds shading parameters only —
+ * no GPU resources; pipelines are compiled when a tree is bound with `gpu.scene()`.
+ */
+export declare abstract class SceneMaterial {
+    /**
+     * Set by the base constructor (not by a subclass field) so it is already readable while
+     * a subclass constructor validates its options — subclass fields are installed only
+     * after `super()` returns, which used to make validation errors report `undefined.set`.
+     */
+    readonly kind: SceneMaterialKind;
+    label: string | undefined;
+    blend: MaterialBlend | undefined;
+    constructor(kind: SceneMaterialKind);
+}
+export interface ColorMaterialOptions {
+    /** Linear RGB color; pass `srgb("#…")` for hex input. Defaults to white. */
+    readonly color?: Vec3Like;
+    readonly opacity?: number;
+    readonly blend?: MaterialBlend;
+    readonly label?: string;
+}
+export interface ColorMaterialValues {
+    readonly color?: Vec3Like;
+    readonly opacity?: number;
+}
+declare abstract class ColorMaterial extends SceneMaterial {
+    #private;
+    constructor(kind: SceneMaterialKind, options?: ColorMaterialOptions);
+    set(values: ColorMaterialValues): this;
+    /** Linear RGB color. Stable array identity; mutate via `set()`. */
+    get color(): Float32Array;
+    get opacity(): number;
+}
+/** Flat-color material; renders without lights. */
+export declare class UnlitMaterial extends ColorMaterial {
+    readonly kind: "unlit";
+    constructor(options?: ColorMaterialOptions);
+}
+/** N·L diffuse material lit by scene lights (uses `@aigpu/wgsl-std/light` lambert). */
+export declare class LambertMaterial extends ColorMaterial {
+    readonly kind: "lambert";
+    constructor(options?: ColorMaterialOptions);
+}
+/** Debug material that shades world-space normals; needs no lights or parameters. */
+export declare class NormalMaterial extends SceneMaterial {
+    readonly kind: "normal";
+    constructor();
+}
+export interface ShaderMaterialOptions {
+    /** Initial binding values keyed by WGSL variable name, like `draw.set()`. */
+    readonly set?: Record<string, unknown>;
+    readonly blend?: MaterialBlend;
+    readonly label?: string;
+}
+/**
+ * Custom material: a WGSL fragment stage compiled against the scene renderer's vertex
+ * contract. Scene globals live in `@group(0)` (renderer-owned); material bindings start
+ * at `@group(1)`.
+ */
+export declare class ShaderMaterial extends SceneMaterial {
+    #private;
+    readonly kind: "shader";
+    readonly source: string;
+    constructor(source: string, options?: ShaderMaterialOptions);
+    /** Merges binding values per top-level key; the renderer forwards them to `draw.set()`. */
+    set(values: Record<string, unknown>): this;
+    get values(): Readonly<Record<string, unknown>>;
+}
+export declare function unlitMaterial(options?: ColorMaterialOptions): UnlitMaterial;
+export declare function lambertMaterial(options?: ColorMaterialOptions): LambertMaterial;
+export declare function normalMaterial(): NormalMaterial;
+export declare function shaderMaterial(source: string, options?: ShaderMaterialOptions): ShaderMaterial;
+export {};
+//# sourceMappingURL=material.d.ts.map

package/dist/scene/tree/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../../src/scene/tree/material.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;AAEnE;;;GAGG;AACH,8BAAsB,aAAa;IACjC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;gBAErB,IAAI,EAAE,iBAAiB;CAGpC;AAED,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,uBAAe,aAAc,SAAQ,aAAa;;gBAIpC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB;IAOvE,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAKtC,mEAAmE;IACnE,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CAeF;AAED,mDAAmD;AACnD,qBAAa,aAAc,SAAQ,aAAa;IAE9C,SAAiB,IAAI,EAAE,OAAO,CAAC;gBAEnB,OAAO,GAAE,oBAAyB;CAG/C;AAED,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,aAAa;IAChD,SAAiB,IAAI,EAAE,SAAS,CAAC;gBAErB,OAAO,GAAE,oBAAyB;CAG/C;AAED,qFAAqF;AACrF,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAiB,IAAI,EAAE,QAAQ,CAAC;;CAKjC;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,aAAa;;IAC/C,SAAiB,IAAI,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGZ,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IAQ/D,2FAA2F;IAC3F,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU1C,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE9C;CACF;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAE/E;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAEnF;AAED,wBAAgB,cAAc,IAAI,cAAc,CAE/C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAElG"}