@triscope/core 0.4.0

package/dist/scene-introspect.js

@@ -0,0 +1,164 @@
+export function serializeScene(root, opts = {}) {
+    const maxNodes = opts.maxNodes ?? 120;
+    const getWP = opts.getWorldPosition ?? localPosition;
+    const all = [];
+    collectObjects(root, all);
+    const nodes = [];
+    const lights = [];
+    const MAX_LIGHTS = 64;
+    for (const o of all) {
+        if (o === root)
+            continue; // the scene root itself isn't interesting
+        // Lights go into their own array BEFORE the triangle sort/truncate so they
+        // are never dropped (they have 0 triangles). Duck-typed `isLight` flag —
+        // three sets it on every Light subclass; fakes can set it in tests.
+        if (o?.isLight === true && lights.length < MAX_LIGHTS) {
+            lights.push(describeLight(o, getWP, root));
+        }
+        nodes.push(describeNode(o, getWP, root));
+    }
+    nodes.sort((a, b) => b.triangleCount - a.triangleCount);
+    const total = nodes.length;
+    const truncated = total > maxNodes;
+    return { nodes: truncated ? nodes.slice(0, maxNodes) : nodes, lights, total, truncated };
+}
+function collectObjects(root, out) {
+    if (!root)
+        return;
+    // Real three exposes traverse(self + descendants); fakes use children DFS.
+    if (typeof root.traverse === 'function') {
+        root.traverse((o) => out.push(o));
+        return;
+    }
+    const stack = [root];
+    let guard = 0;
+    while (stack.length && guard++ < 100000) {
+        const o = stack.pop();
+        out.push(o);
+        const kids = o?.children;
+        if (Array.isArray(kids))
+            for (let i = kids.length - 1; i >= 0; i--)
+                stack.push(kids[i]);
+    }
+}
+function describeNode(o, getWP, root) {
+    const tag = o?.userData?.__tris;
+    const node = {
+        uuid: String(o?.uuid ?? ''),
+        name: o?.name ?? '',
+        type: o?.type ?? o?.constructor?.name ?? 'Object3D',
+        visible: o?.visible !== false,
+        worldPosition: round3(getWP(o)),
+        triangleCount: triangleCount(o),
+        parentChain: parentChain(o, root),
+    };
+    const mat = Array.isArray(o?.material) ? o.material[0] : o?.material;
+    if (mat) {
+        node.materialKind = mat.type ?? mat.constructor?.name;
+        const color = materialColor(mat);
+        if (color)
+            node.materialColor = color;
+        const names = uniformNames(mat);
+        if (names.length)
+            node.uniformNames = names;
+    }
+    if (tag?.source)
+        node.source = tag.source;
+    return node;
+}
+function describeLight(o, getWP, root) {
+    const tag = o?.userData?.__tris;
+    const klass = o?.type ?? o?.constructor?.name ?? 'Light';
+    const light = {
+        uuid: String(o?.uuid ?? ''),
+        name: o?.name ?? '',
+        type: klass,
+        lightType: klass,
+        visible: o?.visible !== false,
+        worldPosition: round3(getWP(o)),
+        parentChain: parentChain(o, root),
+    };
+    if (typeof o?.intensity === 'number')
+        light.intensity = +o.intensity.toFixed(3);
+    const color = hexColor(o?.color);
+    if (color)
+        light.color = color;
+    const ground = hexColor(o?.groundColor); // HemisphereLight
+    if (ground)
+        light.groundColor = ground;
+    if (typeof o?.distance === 'number')
+        light.distance = o.distance;
+    if (typeof o?.decay === 'number')
+        light.decay = o.decay;
+    if (typeof o?.angle === 'number')
+        light.angle = +o.angle.toFixed(4); // SpotLight cone
+    if (tag?.source)
+        light.source = tag.source;
+    return light;
+}
+export function triangleCount(o) {
+    const geo = o?.geometry;
+    if (!geo)
+        return 0;
+    try {
+        if (geo.index?.count)
+            return Math.floor(geo.index.count / 3);
+        const pos = geo.attributes?.position;
+        if (pos?.count)
+            return Math.floor(pos.count / 3);
+    }
+    catch {
+        /* exotic geometry — report 0 rather than throw */
+    }
+    return 0;
+}
+function materialColor(mat) {
+    return hexColor(mat?.color);
+}
+/** A THREE.Color → "#rrggbb", guarded (color access can throw on node materials). */
+function hexColor(c) {
+    try {
+        if (typeof c?.getHexString === 'function')
+            return `#${c.getHexString()}`;
+    }
+    catch {
+        /* never throw out of introspection */
+    }
+    return undefined;
+}
+function uniformNames(mat) {
+    // Legacy materials expose `.uniforms`; TSL node materials keep params in a
+    // private node graph (no stable public surface) — return nothing rather than
+    // reach into internals that change across three versions. Skip textures.
+    try {
+        if (mat?.uniforms && typeof mat.uniforms === 'object') {
+            return Object.keys(mat.uniforms).filter((k) => !mat.uniforms[k]?.value?.isTexture);
+        }
+    }
+    catch {
+        /* never throw out of introspection */
+    }
+    return [];
+}
+function parentChain(o, root) {
+    const chain = [];
+    let p = o?.parent;
+    let guard = 0;
+    while (p && p !== root && guard++ < 64) {
+        chain.push(p.name || p.type || p.constructor?.name || 'Object3D');
+        p = p.parent;
+    }
+    return chain.reverse();
+}
+function localPosition(o) {
+    const p = o?.position;
+    if (Array.isArray(p))
+        return [p[0] ?? 0, p[1] ?? 0, p[2] ?? 0];
+    if (p && typeof p === 'object')
+        return [+(p.x ?? 0), +(p.y ?? 0), +(p.z ?? 0)];
+    return [0, 0, 0];
+}
+function round3(v) {
+    return [+v[0].toFixed(3), +v[1].toFixed(3), +v[2].toFixed(3)];
+}
+//# sourceMappingURL=scene-introspect.js.map

package/dist/scene-introspect.js.map

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

package/dist/scene-registry.d.ts

@@ -0,0 +1,36 @@
+import type { CameraSpec, Element, Knob } from './types.js';
+export interface RegistryEntry {
+    name: string;
+    element: Element;
+}
+export declare function nsKey(elementName: string, key: string, namespaced: boolean): string;
+export declare function splitNs(key: string, namespaced: boolean): {
+    element: string | null;
+    local: string;
+};
+export interface CameraBinding {
+    spec: CameraSpec;
+    element: string;
+    local: string;
+}
+export interface KnobBinding {
+    spec: Knob;
+    element: string;
+    local: string;
+}
+export declare function buildCameraMap(active: RegistryEntry[], namespaced: boolean): Record<string, CameraBinding>;
+export declare function buildKnobMap(active: RegistryEntry[], namespaced: boolean): Record<string, KnobBinding>;
+export interface SceneRegistry {
+    available: () => string[];
+    mounted: () => string[];
+    isMounted: (name: string) => boolean;
+    /** Mark a registered element mounted; returns its entry, or null if unknown/already mounted. */
+    mount: (name: string) => RegistryEntry | null;
+    /** Mark a mounted element unmounted; returns false if it wasn't mounted. */
+    unmount: (name: string) => boolean;
+    /** Mounted entries, in registry declaration order. */
+    activeEntries: () => RegistryEntry[];
+    entry: (name: string) => RegistryEntry | undefined;
+}
+export declare function createSceneRegistry(entries: RegistryEntry[], initial?: string[]): SceneRegistry;
+//# sourceMappingURL=scene-registry.d.ts.map

package/dist/scene-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-registry.d.ts","sourceRoot":"","sources":["../src/scene-registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAEnF;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,OAAO,GAClB;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,OAAO,GAClB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAU/B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,OAAO,GAClB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAQ7B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,gGAAgG;IAChG,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;IAC9C,4EAA4E;IAC5E,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,sDAAsD;IACtD,aAAa,EAAE,MAAM,aAAa,EAAE,CAAC;IACrC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,CAsB/F"}

package/dist/scene-registry.js

@@ -0,0 +1,64 @@
+// Pure bookkeeping for a multi-element scene with runtime mount/unmount — the
+// data layer behind runSceneLab + add_element/remove_element. No `three` or DOM
+// here; the harness drives the actual mount/dispose and grid rebuild. Camera +
+// knob keys are namespaced as `<element>.<key>` for multi-element scenes (so two
+// elements declaring `top` don't collide) and left bare for a single
+// non-namespaced lab (backward-compatible with runLab).
+import { autoCameras } from './scene-cameras.js';
+export function nsKey(elementName, key, namespaced) {
+    return namespaced ? `${elementName}.${key}` : key;
+}
+export function splitNs(key, namespaced) {
+    if (!namespaced)
+        return { element: null, local: key };
+    const i = key.indexOf('.');
+    if (i < 0)
+        return { element: null, local: key };
+    return { element: key.slice(0, i), local: key.slice(i + 1) };
+}
+export function buildCameraMap(active, namespaced) {
+    const out = {};
+    for (const { name, element } of active) {
+        const specs = element.cameras === 'auto' ? autoCameras(element.bounds) : (element.cameras ?? {});
+        for (const [local, spec] of Object.entries(specs)) {
+            out[nsKey(name, local, namespaced)] = { spec, element: name, local };
+        }
+    }
+    return out;
+}
+export function buildKnobMap(active, namespaced) {
+    const out = {};
+    for (const { name, element } of active) {
+        for (const [local, spec] of Object.entries(element.knobs ?? {})) {
+            out[nsKey(name, local, namespaced)] = { spec, element: name, local };
+        }
+    }
+    return out;
+}
+export function createSceneRegistry(entries, initial) {
+    const byName = new Map();
+    for (const e of entries)
+        byName.set(e.name, e);
+    const order = entries.map((e) => e.name);
+    const mountedSet = new Set((initial ?? order).filter((n) => byName.has(n)));
+    return {
+        available: () => [...byName.keys()],
+        mounted: () => order.filter((n) => mountedSet.has(n)),
+        isMounted: (name) => mountedSet.has(name),
+        mount: (name) => {
+            if (!byName.has(name) || mountedSet.has(name))
+                return null;
+            mountedSet.add(name);
+            return byName.get(name) ?? null;
+        },
+        unmount: (name) => {
+            if (!mountedSet.has(name))
+                return false;
+            mountedSet.delete(name);
+            return true;
+        },
+        activeEntries: () => order.filter((n) => mountedSet.has(n)).map((n) => byName.get(n)),
+        entry: (name) => byName.get(name),
+    };
+}
+//# sourceMappingURL=scene-registry.js.map

package/dist/scene-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-registry.js","sourceRoot":"","sources":["../src/scene-registry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,qEAAqE;AACrE,wDAAwD;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,MAAM,UAAU,KAAK,CAAC,WAAmB,EAAE,GAAW,EAAE,UAAmB;IACzE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,GAAW,EACX,UAAmB;IAEnB,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACtD,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAaD,MAAM,UAAU,cAAc,CAC5B,MAAuB,EACvB,UAAmB;IAEnB,MAAM,GAAG,GAAkC,EAAE,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,MAAM,EAAE,CAAC;QACvC,MAAM,KAAK,GACT,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAuB,EACvB,UAAmB;IAEnB,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,MAAM,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAeD,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,OAAkB;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QACzC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3D,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACxC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;QACtF,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/scene-view.d.ts

@@ -0,0 +1,52 @@
+import * as THREE from 'three/webgpu';
+import { type CommonLabOptions, type LabHandle } from './harness.js';
+import { type Bounds } from './scene-cameras.js';
+import type { CameraSpec, Element, Knob, MountHandle } from './types.js';
+/** A target the harness can render: an object, a builder, or a mounted handle. */
+export type SceneViewTarget = THREE.Object3D | (() => THREE.Object3D | {
+    root: THREE.Object3D;
+    dispose?: () => void;
+}) | {
+    root: THREE.Object3D;
+    dispose?: () => void;
+};
+export interface SceneViewOptions extends Partial<CommonLabOptions> {
+    /** Element name (telemetry `project`). Defaults to the object's `.name` or "scene". */
+    name?: string;
+    /** Camera presets, or 'auto' (default) to fit 4 presets from the object's bounds. */
+    cameras?: Record<string, CameraSpec> | 'auto';
+    /** Explicit knobs (merged over autoKnobs when both are present). */
+    knobs?: Record<string, Knob>;
+    /** Knob handler. Defaults to the autoKnobs router when autoKnobs is on. */
+    onKnob?: Element['onKnob'];
+    /**
+     * Reflect named meshes' material props (roughness/metalness/opacity/color/
+     * emissive) and named lights' intensity/color into knobs, routed live via the
+     * same path as set_uniform. NOTE: only NAMED objects; TSL node-material params
+     * aren't reflectable (use set_uniform for those). Off by default.
+     */
+    autoKnobs?: boolean;
+}
+/**
+ * World-space AABB of an object tree → {min,max}; unit box if empty/non-finite.
+ * Computed manually (8 corners of each child geometry's bounding box × its world
+ * matrix) to avoid depending on Box3, which three/webgpu's .d.ts doesn't surface.
+ */
+export declare function computeObjectBounds(obj: THREE.Object3D): Bounds;
+/**
+ * Derive knobs by reflecting an object tree's NAMED materials + lights. Returns
+ * the knob specs + an onKnob that applies them live via writeUniformValue (the
+ * exact path set_uniform uses, so "name.prop" addressing matches).
+ * NOTE: an `opacity` knob has no visible effect on a material without
+ * `transparent: true` (Three.js ignores opacity on opaque materials).
+ */
+export declare function autoKnobsFromObject(root: THREE.Object3D): {
+    knobs: Record<string, Knob>;
+    onKnob: (handle: MountHandle, key: string, value: number | string | boolean) => void;
+};
+/**
+ * Boot a triscope lab around an existing object with (near) zero boilerplate.
+ * Returns the same LabHandle as runLab.
+ */
+export declare function runSceneView(target: SceneViewTarget, opts?: SceneViewOptions): Promise<LabHandle>;
+//# sourceMappingURL=scene-view.d.ts.map

package/dist/scene-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-view.d.ts","sourceRoot":"","sources":["../src/scene-view.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAU,MAAM,cAAc,CAAC;AAE7E,OAAO,EAAe,KAAK,MAAM,EAAe,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzE,kFAAkF;AAClF,MAAM,MAAM,eAAe,GACvB,KAAK,CAAC,QAAQ,GACd,CAAC,MAAM,KAAK,CAAC,QAAQ,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,GACvE;IAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IACjE,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC;IAC9C,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAsC/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;CACtF,CA0CA;AAgBD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,SAAS,CAAC,CA2CpB"}

package/dist/scene-view.js

@@ -0,0 +1,171 @@
+// runSceneView — the near-zero-boilerplate adoption entry. Wrap ANY existing
+// THREE.Object3D (or a builder, or a {root,dispose} handle) into the triscope
+// harness so the MCP tools (capture_views/inspect_scene/read_uniform/set_uniform
+// + knobs) work, WITHOUT hand-authoring an Element. Cameras auto-fit from the
+// object's bounds; optionally auto-derive knobs from its materials/lights.
+//
+//   import { runSceneView } from '@triscope/core';
+//   runSceneView(myGroup);                 // read-only observability, ~1 line
+//   runSceneView(buildScene, { autoKnobs: true });
+import * as THREE from 'three/webgpu';
+import { runLab } from './harness.js';
+import { mountLabDom } from './lab/dom.js';
+import { UNIT_BOUNDS } from './scene-cameras.js';
+import { writeUniformValue } from './uniform-access.js';
+/**
+ * World-space AABB of an object tree → {min,max}; unit box if empty/non-finite.
+ * Computed manually (8 corners of each child geometry's bounding box × its world
+ * matrix) to avoid depending on Box3, which three/webgpu's .d.ts doesn't surface.
+ */
+export function computeObjectBounds(obj) {
+    try {
+        obj.updateWorldMatrix(true, true);
+        const min = [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY];
+        const max = [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY];
+        let found = false;
+        const v = new THREE.Vector3();
+        obj.traverse((o) => {
+            const geo = o?.geometry;
+            if (!geo)
+                return;
+            if (!geo.boundingBox && typeof geo.computeBoundingBox === 'function')
+                geo.computeBoundingBox();
+            const bb = geo.boundingBox;
+            if (!bb)
+                return;
+            for (let i = 0; i < 8; i++) {
+                v.set(i & 1 ? bb.max.x : bb.min.x, i & 2 ? bb.max.y : bb.min.y, i & 4 ? bb.max.z : bb.min.z);
+                // applyMatrix4 is missing from three/webgpu's partial .d.ts (runtime ok).
+                // biome-ignore lint/suspicious/noExplicitAny: three/webgpu .d.ts gap
+                v.applyMatrix4(o.matrixWorld);
+                if (!Number.isFinite(v.x) || !Number.isFinite(v.y) || !Number.isFinite(v.z))
+                    continue;
+                min[0] = Math.min(min[0], v.x);
+                min[1] = Math.min(min[1], v.y);
+                min[2] = Math.min(min[2], v.z);
+                max[0] = Math.max(max[0], v.x);
+                max[1] = Math.max(max[1], v.y);
+                max[2] = Math.max(max[2], v.z);
+                found = true;
+            }
+        });
+        if (!found)
+            return UNIT_BOUNDS;
+        return { min: [min[0], min[1], min[2]], max: [max[0], max[1], max[2]] };
+    }
+    catch {
+        return UNIT_BOUNDS;
+    }
+}
+/**
+ * Derive knobs by reflecting an object tree's NAMED materials + lights. Returns
+ * the knob specs + an onKnob that applies them live via writeUniformValue (the
+ * exact path set_uniform uses, so "name.prop" addressing matches).
+ * NOTE: an `opacity` knob has no visible effect on a material without
+ * `transparent: true` (Three.js ignores opacity on opaque materials).
+ */
+export function autoKnobsFromObject(root) {
+    const knobs = {};
+    const hex = (c) => {
+        try {
+            return typeof c?.getHexString === 'function' ? `#${c.getHexString()}` : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    root.traverse((o) => {
+        const name = o?.name;
+        if (!name || typeof name !== 'string')
+            return; // only addressable (named) objects
+        if (o.isLight) {
+            if (typeof o.intensity === 'number') {
+                knobs[`${name}.intensity`] = {
+                    type: 'number',
+                    min: 0,
+                    max: Math.max(o.intensity * 3, 5),
+                    step: 0.01,
+                    default: o.intensity,
+                };
+            }
+            const lc = hex(o.color);
+            if (lc)
+                knobs[`${name}.color`] = { type: 'color', default: lc };
+            return;
+        }
+        const mat = Array.isArray(o.material) ? o.material[0] : o.material;
+        if (!mat)
+            return;
+        for (const p of ['roughness', 'metalness', 'opacity']) {
+            if (typeof mat[p] === 'number') {
+                knobs[`${name}.${p}`] = { type: 'number', min: 0, max: 1, step: 0.01, default: mat[p] };
+            }
+        }
+        for (const p of ['color', 'emissive']) {
+            const mc = hex(mat[p]);
+            if (mc)
+                knobs[`${name}.${p}`] = { type: 'color', default: mc };
+        }
+    });
+    const onKnob = (handle, key, value) => {
+        if (handle?.root)
+            writeUniformValue(handle.root, key, value);
+    };
+    return { knobs, onKnob };
+}
+function resolveTarget(target) {
+    const t = typeof target === 'function' ? target() : target;
+    if (t && t.isObject3D)
+        return { obj: t };
+    if (t && t.root?.isObject3D) {
+        return { obj: t.root, dispose: t.dispose };
+    }
+    throw new Error('runSceneView: target must be a THREE.Object3D, a () => Object3D, or a { root, dispose } handle');
+}
+/**
+ * Boot a triscope lab around an existing object with (near) zero boilerplate.
+ * Returns the same LabHandle as runLab.
+ */
+export async function runSceneView(target, opts = {}) {
+    const { obj, dispose: targetDispose } = resolveTarget(target);
+    // Build the DOM if no canvas was supplied (a bare <body> + script is enough).
+    const dom = opts.canvas ? null : mountLabDom();
+    const canvas = opts.canvas ?? dom?.canvas;
+    if (!canvas)
+        throw new Error('runSceneView: no canvas (and DOM creation unavailable)');
+    const auto = opts.autoKnobs
+        ? autoKnobsFromObject(obj)
+        : { knobs: {}, onKnob: undefined };
+    const knobs = { ...auto.knobs, ...(opts.knobs ?? {}) };
+    const element = {
+        name: opts.name ?? obj.name ?? 'scene',
+        bounds: computeObjectBounds(obj),
+        cameras: opts.cameras ?? 'auto',
+        knobs: Object.keys(knobs).length ? knobs : undefined,
+        onKnob: opts.onKnob ?? auto.onKnob,
+        mount: ({ parent }) => {
+            parent.add(obj);
+            return {
+                root: obj,
+                dispose: () => {
+                    parent.remove(obj);
+                    targetDispose?.();
+                },
+                userData: {},
+            };
+        },
+    };
+    return runLab({
+        element,
+        canvas,
+        hud: dom?.hud ?? opts.hud ?? null,
+        labelContainer: dom?.labelContainer ?? opts.labelContainer ?? null,
+        editorContainer: dom?.editorContainer ?? opts.editorContainer ?? null,
+        bootOverlay: dom?.boot ?? opts.bootOverlay ?? null,
+        clearColor: opts.clearColor,
+        captureSize: opts.captureSize,
+        telemetryIntervalMs: opts.telemetryIntervalMs,
+        knobPollMs: opts.knobPollMs,
+    });
+}
+//# sourceMappingURL=scene-view.js.map

package/dist/scene-view.js.map

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

package/dist/source-tag.d.ts

@@ -0,0 +1,34 @@
+export interface SourceFrame {
+    file: string;
+    line: number;
+    col: number;
+    fn?: string;
+}
+export interface SourceTag {
+    source: SourceFrame | null;
+    stack: SourceFrame[];
+    type: string;
+    geometry?: string;
+    material?: {
+        color?: string;
+        map?: string | null;
+    };
+    name?: string;
+    /**
+     * Names of ancestor objects in the scene tree, root-first. Populated
+     * lazily when the picker reads the tag (parents may change after
+     * .add() if the user re-parents). Useful as a tie-breaker when the
+     * source-line attribution drifts (see note below).
+     */
+    parentChain?: string[];
+}
+export declare function installSourceTagPatch(): boolean;
+export declare const FRAME_RE: RegExp;
+export declare const SKIP_PATTERNS: RegExp[];
+export declare function parseUserStack(raw: string, max?: number): SourceFrame[];
+export declare function stripUrl(u: string): string;
+export declare function extractMaterialHint(material: unknown): {
+    color?: string;
+    map?: string | null;
+};
+//# sourceMappingURL=source-tag.d.ts.map

package/dist/source-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-tag.d.ts","sourceRoot":"","sources":["../src/source-tag.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAeD,wBAAgB,qBAAqB,IAAI,OAAO,CAgC/C;AAED,eAAO,MAAM,QAAQ,QAAyE,CAAC;AAE/F,eAAO,MAAM,aAAa,UAQzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,WAAW,EAAE,CAgBlE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAc9F"}