@3driseai/3drise-viewer 0.1.15 → 0.1.17

package/dist/components/HyperbolicGrid.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useObjectReady } from '../hooks/useObjectReady.js';
+import { useGridSurface } from '../hooks/useGridSurface.js';
+import { HyperbolicGridMaterial } from '@3driseai/3drise-core';
+// Side-effect import registers <hyperbolicGridMaterial> via extend().
+void HyperbolicGridMaterial;
+/** HyperbolicGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+export const defaultHyperbolicGridConfig = {
+    cellSize: 22,
+    size: 50,
+    flat: true,
+    segments: undefined,
+    lineMode: 1,
+    cellMode: 2,
+    lineWidth: 1.4,
+    sectionSize: 3,
+    sectionWidth: 1,
+    animSpeed: 1,
+    animScale: 1.2,
+    animIntensity: 0.7,
+    fadeDistance: undefined,
+    fadeStrength: 0.2,
+    displace: 0,
+    sides: 7,
+    valence: 3,
+    drift: 0.5,
+    lineColor: '#c9a4ff',
+    sectionColor: '#ffd9f2',
+    cellColor: '#2a1446',
+    glowColor: '#b07cff',
+    bgColor: '#07030c',
+    bgOpacity: 0,
+    followMouse: false,
+    reveal: 1,
+    revealDuration: 0,
+};
+/**
+ * An Escher-style {p,q} tiling of the Poincare disk. A slow Mobius translation glides the tiling through itself, and the tiles shrink without end toward the rim.
+ */
+export function HyperbolicGrid({ config = defaultHyperbolicGridConfig, groupProps, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    const meshRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const { cellSize, size, segments, flat, lineMode, cellMode, lineWidth, sectionSize, sectionWidth, animSpeed, animScale, animIntensity, fadeDistance, fadeStrength, displace, sides, valence, drift, lineColor, sectionColor, cellColor, glowColor, bgColor, bgOpacity, followMouse, reveal, revealDuration, } = config;
+    // the ripple is fine-grained relative to the disk
+    const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 64)) : 1);
+    const fade = fadeDistance ?? size * 0.5;
+    const colors = useMemo(() => ({
+        line: new THREE.Color(lineColor),
+        section: new THREE.Color(sectionColor),
+        cell: new THREE.Color(cellColor),
+        glow: new THREE.Color(glowColor),
+        bg: new THREE.Color(bgColor),
+    }), [lineColor, sectionColor, cellColor, glowColor, bgColor]);
+    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("hyperbolicGridMaterial", { ref: matRef, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide, u_cellSize: cellSize, u_lineWidth: lineWidth, u_sectionSize: sectionSize, u_sectionWidth: sectionWidth, u_lineMode: lineMode, u_cellMode: cellMode, u_animSpeed: animSpeed, u_animScale: animScale, u_animIntensity: animIntensity, u_fadeDistance: fade, u_fadeStrength: fadeStrength, u_displace: displace, u_sides: sides, u_valence: valence, u_drift: drift, u_lineColor: colors.line, u_sectionColor: colors.section, u_cellColor: colors.cell, u_glowColor: colors.glow, u_bgColor: colors.bg, u_bgOpacity: bgOpacity }, HyperbolicGridMaterial.key)] }) }));
+}
+export default HyperbolicGrid;

package/dist/components/LayoutInstances.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+import type { Object3D } from 'three';
+import type { ThreeEvent } from '@react-three/fiber';
+import type { CreatedObjectSettings, ObjectLayoutSettings } from '@3driseai/3drise-core';
+export interface LayoutInstancesProps {
+    createdObject: CreatedObjectSettings;
+    layout: ObjectLayoutSettings;
+    render: (slot: number) => ReactNode;
+    handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
+}
+declare const LayoutInstances: import("react").MemoExoticComponent<({ createdObject, layout, render, handleObjectClick }: LayoutInstancesProps) => import("react").JSX.Element>;
+export default LayoutInstances;
+//# sourceMappingURL=LayoutInstances.d.ts.map

package/dist/components/LayoutInstances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutInstances.d.ts","sourceRoot":"","sources":["../../src/components/LayoutInstances.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAc,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAErG,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,qBAAqB,CAAC;IACrC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IACpC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAmCD,QAAA,MAAM,eAAe,6FAA+D,oBAAoB,iCAmBtG,CAAC;AAGH,eAAe,eAAe,CAAC"}

package/dist/components/LayoutInstances.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+// =============================================================================
+// LayoutInstances — repeat one scene object across a gallery layout
+// =============================================================================
+//
+// ObjectNode hands this the object's own renderer; each slot is a plain group at the
+// transform LayoutCreator computed for it, and the renderer output goes inside.
+//
+// Rules (see the project doc claude/object-layout-plan.md):
+// - Only slot 0 reports readiness. The render callback receives the slot index and
+//   ObjectNode passes no ready callbacks for the others, so one object still reports
+//   once and ObjectsRenderer's aggregate count stays right.
+// - Slot groups never set userData.id, so findById(id) keeps returning the
+//   CreatedObject group that owns the transform.
+// - Clicks are per slot: zoom / glow / vanish target the copy that was clicked, the
+//   same way gallery frames behave.
+// - Motion stays on the CreatedObject group, so the whole layout animates as one.
+import { memo, useMemo, useRef } from 'react';
+import { generateLayoutSlots } from '@3driseai/3drise-core';
+const LayoutSlotGroup = ({ slot, index, createdObject, handleObjectClick, children }) => {
+    const ref = useRef(null);
+    const onClick = handleObjectClick
+        ? (e) => {
+            if (!ref.current)
+                return;
+            e.stopPropagation();
+            handleObjectClick(createdObject, ref.current, e);
+        }
+        : undefined;
+    return (_jsx("group", { ref: ref, name: `layout-slot-${index}`, position: slot.position, rotation: slot.rotation ?? [0, 0, 0], scale: slot.scale ?? [1, 1, 1], userData: { layoutSlot: index }, onClick: onClick, children: children }));
+};
+const LayoutInstances = memo(({ createdObject, layout, render, handleObjectClick }) => {
+    // ObjectNode normalises the block on every render, so key on its contents.
+    const layoutKey = JSON.stringify(layout);
+    const slots = useMemo(() => generateLayoutSlots(layout.count, layout), [layoutKey]);
+    return (_jsx(_Fragment, { children: slots.map((slot, index) => (_jsx(LayoutSlotGroup, { slot: slot, index: index, createdObject: createdObject, handleObjectClick: handleObjectClick, children: render(index) }, index))) }));
+});
+LayoutInstances.displayName = 'LayoutInstances';
+export default LayoutInstances;

package/dist/components/ModelBoundary.d.ts

@@ -0,0 +1,28 @@
+import { Component } from 'react';
+import type { ErrorInfo, ReactNode } from 'react';
+interface ModelBoundaryProps {
+    children: ReactNode;
+    /** Rendered while the model's GLTF is in flight. Null keeps the scene from jumping. */
+    fallback?: ReactNode;
+    /** Identifies the offending object in the console when a load fails. */
+    label?: string;
+}
+interface ModelBoundaryState {
+    failed: boolean;
+}
+/**
+ * Suspense + error boundary around a single model leaf.
+ *
+ * Both halves are required. The cache re-throws a rejected load on every subsequent read,
+ * and a throw that reaches a bare `<Suspense>` unmounts everything under it — one model
+ * behind a dead URL would blank the rest of the scene. Here a failed model renders nothing
+ * and its siblings carry on.
+ */
+declare class ModelBoundary extends Component<ModelBoundaryProps, ModelBoundaryState> {
+    state: ModelBoundaryState;
+    static getDerivedStateFromError(): ModelBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export default ModelBoundary;
+//# sourceMappingURL=ModelBoundary.d.ts.map

package/dist/components/ModelBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ModelBoundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAY,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,UAAU,kBAAkB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IACxB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,cAAM,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACzE,KAAK,EAAE,kBAAkB,CAAqB;IAE9C,MAAM,CAAC,wBAAwB,IAAI,kBAAkB;IAIrD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAQtD,MAAM,IAAI,SAAS;CAItB;AAED,eAAe,aAAa,CAAC"}

package/dist/components/ModelBoundary.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component, Suspense } from 'react';
+/**
+ * Suspense + error boundary around a single model leaf.
+ *
+ * Both halves are required. The cache re-throws a rejected load on every subsequent read,
+ * and a throw that reaches a bare `<Suspense>` unmounts everything under it — one model
+ * behind a dead URL would blank the rest of the scene. Here a failed model renders nothing
+ * and its siblings carry on.
+ */
+class ModelBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError() {
+        return { failed: true };
+    }
+    componentDidCatch(error, info) {
+        console.error(`[ModelBoundary] Model failed to load${this.props.label ? `: ${this.props.label}` : ''}`, error, info.componentStack);
+    }
+    render() {
+        if (this.state.failed)
+            return null;
+        return _jsx(Suspense, { fallback: this.props.fallback ?? null, children: this.props.children });
+    }
+}
+export default ModelBoundary;

package/dist/components/ModelPrimitive.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+interface ModelPrimitiveProps extends ObjectReadyProps {
+    createdObject: CreatedObjectSettings;
+    /** Layout slot. Slot 0 is the object itself; the rest are unregistered clones. */
+    slot?: number;
+    children?: ReactNode;
+}
+/**
+ * Mounts the Object3D behind a `type: 'model'` scene object, and hands it to the host
+ * application.
+ *
+ * Split out of CustomPrimitive because this is the component that suspends: it must sit
+ * under its own boundary so one slow or broken model does not hold up its siblings.
+ *
+ * ## Readiness
+ *
+ * `onObjectReady` fires here, with the loaded model root - that Object3D is the whole point
+ * of the object API, so it has to arrive on both paths: preloaded (mounts in the same
+ * commit as its parent) and suspended (mounts whenever the GLTF lands, which may be several
+ * frames later).
+ *
+ * CustomPrimitive cannot report it any more. When this component suspends, CustomPrimitive
+ * commits first with its ref still empty, its layout effect finds nothing to report, and it
+ * never re-renders once the asset resolves. Its `meshRef` now stays null for a model, so its
+ * own call is a no-op rather than a second, conflicting report.
+ *
+ * The report is driven by a callback ref rather than a layout effect: R3F runs it the moment
+ * it attaches the object and again with null when it detaches, so the pair fires exactly on
+ * attach/detach no matter how many renders the suspension cost.
+ *
+ * `dispose={null}` is not optional. Geometry and textures here are shared with the cache
+ * master and every other instance of the same URL; letting R3F free them on unmount breaks
+ * all of them.
+ */
+declare const ModelPrimitive: React.FC<ModelPrimitiveProps>;
+export default ModelPrimitive;
+//# sourceMappingURL=ModelPrimitive.d.ts.map

package/dist/components/ModelPrimitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/ModelPrimitive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,aAAa,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA8BhD,CAAC;AAIH,eAAe,cAAc,CAAC"}

package/dist/components/ModelPrimitive.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo, useCallback, useRef } from 'react';
+import { useModelObject } from '../hooks/useModelObject.js';
+import { useObjectReadyReporter } from '../hooks/useObjectReady.js';
+/**
+ * Mounts the Object3D behind a `type: 'model'` scene object, and hands it to the host
+ * application.
+ *
+ * Split out of CustomPrimitive because this is the component that suspends: it must sit
+ * under its own boundary so one slow or broken model does not hold up its siblings.
+ *
+ * ## Readiness
+ *
+ * `onObjectReady` fires here, with the loaded model root - that Object3D is the whole point
+ * of the object API, so it has to arrive on both paths: preloaded (mounts in the same
+ * commit as its parent) and suspended (mounts whenever the GLTF lands, which may be several
+ * frames later).
+ *
+ * CustomPrimitive cannot report it any more. When this component suspends, CustomPrimitive
+ * commits first with its ref still empty, its layout effect finds nothing to report, and it
+ * never re-renders once the asset resolves. Its `meshRef` now stays null for a model, so its
+ * own call is a no-op rather than a second, conflicting report.
+ *
+ * The report is driven by a callback ref rather than a layout effect: R3F runs it the moment
+ * it attaches the object and again with null when it detaches, so the pair fires exactly on
+ * attach/detach no matter how many renders the suspension cost.
+ *
+ * `dispose={null}` is not optional. Geometry and textures here are shared with the cache
+ * master and every other instance of the same URL; letting R3F free them on unmount breaks
+ * all of them.
+ */
+const ModelPrimitive = memo(({ createdObject, slot = 0, onObjectReady, onObjectDispose, children }) => {
+    const attachedRef = useRef(null);
+    const object = useModelObject(createdObject, slot);
+    const { report, reportDisposed } = useObjectReadyReporter(createdObject, onObjectReady, onObjectDispose);
+    const setObjectRef = useCallback((instance) => {
+        if (instance) {
+            attachedRef.current = instance;
+            report(instance);
+            return;
+        }
+        if (attachedRef.current) {
+            reportDisposed(attachedRef.current);
+            attachedRef.current = null;
+        }
+    }, [report, reportDisposed]);
+    if (!object)
+        return null;
+    return (_jsx("primitive", { ref: setObjectRef, name: createdObject.name, object: object, dispose: null, children: children }, `${createdObject.id}:${slot}`));
+});
+ModelPrimitive.displayName = 'ModelPrimitive';
+export default ModelPrimitive;

package/dist/components/ObjectNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAgBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAqHzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAgBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAiIzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -15,7 +15,23 @@ import Galaxy from "./Galaxy.js";
 import GridGenerator from "./GridsGenerator.js";
 import OceanBuilder from "./OceanBuilder.js";
 import LandscapeObject from "./LandscapeObject.js";
+import LayoutInstances from "./LayoutInstances.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
+import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout } from "@3driseai/3drise-core";
+// Slots after the first render with no ready callbacks: one object reports once.
+const NO_READY = {};
+// A point light's shadow is six extra renders; only slot 0 keeps it. Cached per settings
+// object so the copies do not re-run their shadow effect on every render.
+const noShadowCache = new WeakMap();
+const withoutShadow = (obj) => {
+    let copy = noShadowCache.get(obj);
+    if (!copy) {
+        const config = (obj.config ?? {});
+        copy = { ...obj, config: { ...config, shadow: { ...config.shadow, enabled: false } } };
+        noShadowCache.set(obj, copy);
+    }
+    return copy;
+};
 // const EffectsLayer: React.FC<{ effects: CreatedObjectSettings['effects'] }> = ({ effects }) =>
 //     effects?.length ? (
 //         <>
@@ -40,7 +56,9 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
     // Specialized renderers for each object type
     const renderers = useMemo(() => ({
         group: () => null,
-        mesh: (obj, onObjectReady) => (_jsx(CustomPrimitive, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick }, obj.id)),
+        // mesh / model / effect / light take a layout slot as the third argument
+        // (see LayoutInstances); slot 0 is also the no-layout case.
+        mesh: (obj, _onObjectReady, slot = 0) => (_jsx(CustomPrimitive, { createdObject: obj, ...(slot === 0 ? { onObjectReady, onObjectDispose } : NO_READY), handleObjectClick: handleObjectClick }, obj.id)),
         // water: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
         //     <Ocean
         //         settings={obj}
@@ -56,7 +74,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         //         settings={obj}
         //     />
         // ),
-        model: (obj, onObjectReady) => (_jsx(CustomPrimitive, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick }, obj.id)),
+        model: (obj, _onObjectReady, slot = 0) => (_jsx(CustomPrimitive, { createdObject: obj, slot: slot, ...(slot === 0 ? { onObjectReady, onObjectDispose } : NO_READY), handleObjectClick: handleObjectClick }, obj.id)),
         // custom_primitive: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
         //     <CustomPrimitive
         //         key={obj.id}
@@ -87,11 +105,11 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         // LandscapeConnector instead; this one is a diorama, a floating island or
         // a game tile, and gets its transform from the CreatedObject wrapper.
         landscape: (obj, onObjectReady) => (_jsx(LandscapeObject, { settings: obj, ...relabel(obj) }, obj.id)),
-        effect: (obj) => (_jsx(EffectsGenerator, { settings: {
+        effect: (obj, _onObjectReady, slot = 0) => (_jsx(EffectsGenerator, { settings: {
                 config: obj.config,
-            }, ...relabel(obj) }, obj.id)),
+            }, ...(slot === 0 ? relabel(obj) : NO_READY) }, obj.id)),
         gallery: (obj, onObjectReady) => (_jsx(GalleryLayout, { createdObject: obj, handleObjectClick: handleObjectClick, ...relabel(obj) })),
-        light: (obj, onObjectReady) => (_jsx(LightObject, { createdObject: obj, ...relabel(obj) })),
+        light: (obj, _onObjectReady, slot = 0) => (_jsx(LightObject, { createdObject: slot === 0 ? obj : withoutShadow(obj), ...(slot === 0 ? relabel(obj) : NO_READY) })),
         environment: (obj, onObjectReady) => (_jsx(EnvironmentObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         space: (obj, onObjectReady) => (_jsx(Galaxy, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         // rain: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
@@ -115,10 +133,20 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         //     />
         // ),
     }), [handleObjectClick, onObjectReady, onObjectDispose, relabel]);
-    const renderObject = useCallback((obj, handleObjectClick) => {
+    const renderObject = useCallback((obj, _handleObjectClick) => {
         const renderer = renderers[obj.type];
-        return renderer?.(obj, onObjectReady) ?? null;
-    }, [onObjectReady, renderers]);
+        if (!renderer)
+            return null;
+        // meshSettings.layout: repeat the renderer output across a gallery layout.
+        // Absent on every object saved before layouts existed, which renders as before.
+        const layout = LAYOUT_CAPABLE_TYPES.has(obj.type) ? normalizeObjectLayout(obj.meshSettings?.layout) : null;
+        const support = layout?.enabled ? getObjectLayoutSupport(obj) : null;
+        if (layout && support?.allowed) {
+            const capped = layout.count > support.maxCount ? { ...layout, count: support.maxCount } : layout;
+            return (_jsx(LayoutInstances, { createdObject: obj, layout: capped, handleObjectClick: handleObjectClick, render: (slot) => renderer(obj, onObjectReady, slot) }));
+        }
+        return renderer(obj, onObjectReady) ?? null;
+    }, [onObjectReady, renderers, handleObjectClick]);
     if (!createdObject) {
         return null;
     }

package/dist/components/ObjectNodeApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectNodeApi.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNodeApi.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAkB,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAc/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ObjectNodeApi.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNodeApi.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAAkB,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAmB/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/ObjectNodeApi.js

@@ -9,11 +9,16 @@ const ObjectNodeApi = ({ objectId, onObjectReady, onObjectDispose, handleObjectC
     // too — SceneBuilder is not in this tree to do it.
     useRegisterScene();
     const [node, setNode] = useState(null);
+    // No asset pre-pass here on purpose. Every model leaf under this tree loads itself
+    // through the shared URL cache under its own Suspense boundary (see useModelObject),
+    // however deeply it is nested, so this component only has to fetch the tree.
     useEffect(() => {
         fetch(`${dataCenterServer}scene-objects/${objectId}/tree`)
             .then(res => res.ok ? res.json() : Promise.reject(res.status))
             .then(({ tree }) => setNode(tree))
-            .catch(() => { });
+            .catch(error => {
+            console.error(`[ObjectNodeApi] Failed to load object tree ${objectId}:`, error);
+        });
     }, [objectId]);
     if (!node)
         return null;

package/dist/components/ProjectLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,KAAK,YAAY,GAAG,gBAAgB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAqDzC,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,KAAK,YAAY,GAAG,gBAAgB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAsDzC,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/ProjectLoader.js

@@ -22,6 +22,7 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
                     "Content-Type": "application/json",
                 },
             });
+            console.log(response);
             if (!response.ok) {
                 if (response.status === 404) {
                     throw new Error("Project not found");

package/dist/components/ReactionDiffusionGrid.d.ts

@@ -0,0 +1,15 @@
+import type { ThreeElements } from '@react-three/fiber';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { ReactionDiffusionGridConfig } from '../types/gridConfigs';
+export interface ReactionDiffusionGridProps extends ObjectReadyProps {
+    config?: ReactionDiffusionGridConfig;
+    groupProps?: ThreeElements['group'];
+}
+/** ReactionDiffusionGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+export declare const defaultReactionDiffusionGridConfig: ReactionDiffusionGridConfig;
+/**
+ * A Gray-Scott reaction-diffusion field simulated on the GPU and sampled by the plane: coral, labyrinths and dividing spots grow, merge and keep evolving, wrapped seamlessly as a torus.
+ */
+export declare function ReactionDiffusionGrid({ config, groupProps, onObjectReady, onObjectDispose }: ReactionDiffusionGridProps): import("react").JSX.Element;
+export default ReactionDiffusionGrid;
+//# sourceMappingURL=ReactionDiffusionGrid.d.ts.map

package/dist/components/ReactionDiffusionGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactionDiffusionGrid.d.ts","sourceRoot":"","sources":["../../src/components/ReactionDiffusionGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGxE,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAChE,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACvC;AAKD,wGAAwG;AACxG,eAAO,MAAM,kCAAkC,EAAE,2BA6BhD,CAAC;AAuTF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,MAA2C,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,0BAA0B,+BAgF5J;AAED,eAAe,qBAAqB,CAAC"}