@3driseai/3drise-viewer 0.1.39 → 0.1.41

package/dist/api/sceneHandle.d.ts

@@ -78,13 +78,47 @@ export interface SceneValues {
     /** Why `set` would fail, or undefined when it can write this path. */
     check(target: string, path: string): string | undefined;
 }
-export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd' | 'animationLoop';
+export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd' | 'animationLoop' | 'galleryChange';
 export interface SceneHandleEvent {
     type: SceneHandleEventType;
-    kind: 'action' | 'clip' | 'sequence';
+    kind: 'action' | 'clip' | 'sequence' | 'gallery';
     id: string;
     key?: string;
     name: string;
+    /** galleryChange: the picture now shown. */
+    index?: number;
+    count?: number;
+    url?: string;
+}
+export interface SceneGalleryInfo {
+    id: string;
+    key?: string;
+    name: string;
+    /** The picture shown now (0-based) and how many there are. */
+    index: number;
+    count: number;
+    /** True while a picture change is playing. */
+    busy: boolean;
+    /** Autoplay paused by pause(). */
+    paused: boolean;
+    url?: string;
+}
+/**
+ * The scene's galleries that can be driven (variants with navigation: carousel, …; the layout gallery has none) —
+ * drive them from your own buttons: `scene.galleries.next('hero')`, `scene.on('galleryChange', …)`.
+ */
+export interface SceneGalleries {
+    list(): SceneGalleryInfo[];
+    get(ref: string): SceneGalleryInfo | undefined;
+    next(ref: string): boolean;
+    prev(ref: string): boolean;
+    /** Change to picture i (wraps). */
+    goTo(ref: string, index: number): boolean;
+    /** Show picture i at once, without the change animation. */
+    jump(ref: string, index: number): boolean;
+    /** Pause / resume its autoplay. */
+    pause(ref: string): boolean;
+    resume(ref: string): boolean;
 }
 export interface SceneHandle {
     actions: {
@@ -98,6 +132,8 @@ export interface SceneHandle {
         reset(): void;
     };
     clips: ScenePlayback<SceneClipInfo>;
+    /** Galleries: next / prev / goTo and `on('galleryChange', …)`. */
+    galleries: SceneGalleries;
     sequences: ScenePlayback<SceneSequenceInfo> & {
         /**
          * Drive a sequence from your own input (page scroll, a slider…): its position,
@@ -123,11 +159,12 @@ export interface SceneHandleSource {
     actions: ActionSequence[];
     clips: AnimationClip[];
     sequences: AnimationSequence[];
-    /** The project's objects, to resolve a `values` target by key, id or name. */
+    /** The project's objects, to resolve a `values` or gallery target by key, id or name. */
     objects?: Array<{
         id: string;
         name?: string;
         key?: string;
+        type?: string;
     }>;
 }
 /**

package/dist/api/sceneHandle.d.ts.map

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

package/dist/api/sceneHandle.js

@@ -20,6 +20,7 @@
 //
 import { SceneActions } from '@3driseai/3drise-core';
 import ClipsRuntime from '../animationsV2/ClipsRuntime.js';
+import GalleryRuntime from '../galleryRuntime.js';
 import { runCommand } from '../triggers/index.js';
 import { clipMap, resolveSequence } from '../animationsV2/sequenceUtils.js';
 function resolve(items, ref, kind) {
@@ -203,6 +204,36 @@ export function createSceneHandle(getSource) {
         const current = ClipsRuntime.getLiveValue(state, m[1], node);
         return Array.isArray(current) ? { base: m[1], index: COMPONENT[m[2]] } : undefined;
     }
+    // ----- galleries -------------------------------------------------------------------
+    const galleryObjects = () => (getSource().objects ?? []).filter(o => GalleryRuntime.has(o.id));
+    const findGallery = (ref) => {
+        const list = galleryObjects();
+        return list.find(o => o.key === ref) ?? list.find(o => o.id === ref) ?? list.find(o => o.name === ref);
+    };
+    const galleryInfo = (o) => {
+        const g = GalleryRuntime.info(o.id);
+        return g ? { id: o.id, key: o.key, name: o.name ?? o.id, index: g.index, count: g.count, busy: g.busy, paused: g.paused, url: g.currentUrl } : undefined;
+    };
+    const galleryRun = (ref, command, index) => {
+        const o = findGallery(ref);
+        if (!o) {
+            console.warn(`[3drise] No gallery "${ref}" in this project. Known: ${galleryObjects().map(i => i.key || i.name || i.id).join(', ') || 'none'}`);
+            return false;
+        }
+        runCommand({ id: `code:gallery:${o.id}`, kind: 'gallery', ref: o.id, command, ...(index !== undefined ? { index } : {}) }, code({ id: o.id, key: o.key }));
+        return true;
+    };
+    const galleries = {
+        list: () => galleryObjects().map(galleryInfo).filter((g) => !!g),
+        get: (ref) => { const o = findGallery(ref); return o ? galleryInfo(o) : undefined; },
+        next: (ref) => galleryRun(ref, 'next'),
+        prev: (ref) => galleryRun(ref, 'prev'),
+        goTo: (ref, index) => galleryRun(ref, 'goTo', index),
+        jump: (ref, index) => { const o = findGallery(ref); const g = o && GalleryRuntime.get(o.id); if (!g)
+            return false; g.jump(index); return true; },
+        pause: (ref) => galleryRun(ref, 'pause'),
+        resume: (ref) => galleryRun(ref, 'resume'),
+    };
     const values = {
         check(ref, path) {
             const t = target(ref);
@@ -280,9 +311,18 @@ export function createSceneHandle(getSource) {
             },
         },
         clips: clipControls,
+        galleries,
         sequences: sequenceControls,
         run: (command) => runCommand(command, { source: { host: 'code', id: 'run' }, chain: [], catalog }),
         on(type, listener) {
+            if (type === 'galleryChange') {
+                return GalleryRuntime.on((e) => {
+                    // Only this project's galleries — another scene on the page shares the runtime.
+                    const o = (getSource().objects ?? []).find(x => x.id === e.id);
+                    if (o)
+                        listener({ type, kind: 'gallery', id: o.id, key: o.key, name: o.name ?? o.id, index: e.index, count: e.count, url: e.currentUrl });
+                });
+            }
             if (type === 'actionApplied' || type === 'actionReverted') {
                 return SceneActions.onEvent((e) => {
                     if (e.type === 'reset')

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

@@ -1 +1 @@
-{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAO7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyFvD,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA4FvD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/components/AnimatedObject.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
-import { useRef, useEffect, useCallback, useMemo, memo } from 'react';
+import { useRef, useEffect, useCallback, useMemo, memo, useContext } from 'react';
+import { EnabledContext } from './EnabledContext.js';
 import { objectEffectClipOf, objectEffectStepsOf, objectTakesVisualEffects, DEFAULT_EFFECT_SPREAD } from '@3driseai/3drise-core';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
 import { useObjectEffectLayers } from '../operations/useObjectEffectLayers.js';
@@ -36,8 +37,11 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
     // Pass the ref itself, not `groupRef.current`: the animation hooks read
     // `.current` inside useFrame, so the group resolves the moment React
     // attaches it — no scene lookup and no extra render needed.
+    // Disabled (hidden itself, or under a hidden group): its constant animations and mouse-move pause.
+    // They are time-based, so on enable they pick up where the clock is — no catch-up jump.
+    const enabled = useContext(EnabledContext) && visible;
     useObjectAnimation(createdObject, animateMaterial, {
-        enabled: createdObject.type !== 'gallery', // 
+        enabled: createdObject.type !== 'gallery' && enabled, // 
         hovered,
     }, groupRef);
     // Effects layered on the object (frost, metalize…) — switched on / off, held while on.

package/dist/components/EnabledContext.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether the scene object rendering here is enabled: its own `visible` AND every ancestor's.
+ *
+ * A group's enabled state overrides its children's, recursively, at runtime only — nothing is
+ * written to the children, so switching the group back on brings each child back to its own
+ * state (a child hidden on its own stays hidden). ObjectNode provides it per object (from the
+ * PRESENTED visibility, so a group whose effects follow its visibility plays them out before its
+ * children switch off); AnimatedObject reads it to pause the object's own constant animations
+ * and mouse-move while disabled. Pointer events skip hidden subtrees separately (shownInScene).
+ */
+export declare const EnabledContext: import("react").Context<boolean>;
+//# sourceMappingURL=EnabledContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnabledContext.d.ts","sourceRoot":"","sources":["../../src/components/EnabledContext.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,kCAAsB,CAAC"}

package/dist/components/EnabledContext.js

@@ -0,0 +1,12 @@
+import { createContext } from 'react';
+/**
+ * Whether the scene object rendering here is enabled: its own `visible` AND every ancestor's.
+ *
+ * A group's enabled state overrides its children's, recursively, at runtime only — nothing is
+ * written to the children, so switching the group back on brings each child back to its own
+ * state (a child hidden on its own stays hidden). ObjectNode provides it per object (from the
+ * PRESENTED visibility, so a group whose effects follow its visibility plays them out before its
+ * children switch off); AnimatedObject reads it to pause the object's own constant animations
+ * and mouse-move while disabled. Pointer events skip hidden subtrees separately (shownInScene).
+ */
+export const EnabledContext = createContext(true);

package/dist/components/GalleryObject.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { Object3D } from 'three';
+import type { ThreeEvent } from '@react-three/fiber';
+import type { ObjectReadyProps } from '../types/objectReady';
+type GalleryObjectProps = ObjectReadyProps & {
+    createdObject: CreatedObjectSettings;
+    /** A click on a frame (the layout gallery): the studio selects it and runs the interaction. */
+    handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
+};
+declare const GalleryObject: React.FC<GalleryObjectProps>;
+export default GalleryObject;
+//# sourceMappingURL=GalleryObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GalleryObject.d.ts","sourceRoot":"","sources":["../../src/components/GalleryObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAA2C,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IACzC,aAAa,EAAE,qBAAqB,CAAC;IACrC,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH,CAAC;AAiCF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAe/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/GalleryObject.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import GalleryLayout from './GalleryLayout.js';
+import { LightThreadsGallery, SilkGallery, ParticleShiftGallery, GlassPanesGallery, HaloGallery, LoomGallery, BasicCarouselGallery, PaperLanternsGallery, PinscreenGallery, DepthLayersGallery, ContourLinesGallery, PrismSplitGallery, EngravingGallery, SlatsGallery, FoldGallery, WireReliefGallery, TerracesGallery, ShadowBoxGallery, PopUpGallery, RidgelinesGallery, FlowLinesGallery, StrataGallery } from './gallery/index.js';
+/**
+ * The gallery variants' components by config.type. `layout` is the layout gallery (GalleryLayout: frames on a layout,
+ * driven by the shared transform effects, taking the material); every other variant is its own construction with
+ * the uniform contract (config, id, keyframes, mouseMove, ready callbacks) and registers with GalleryRuntime.
+ */
+const FAMILY = {
+    layout: GalleryLayout,
+    lightThreads: LightThreadsGallery,
+    silk: SilkGallery,
+    particleShift: ParticleShiftGallery,
+    glassPanes: GlassPanesGallery,
+    halo: HaloGallery,
+    loom: LoomGallery,
+    basicCarousel: BasicCarouselGallery,
+    paperLanterns: PaperLanternsGallery,
+    pinscreen: PinscreenGallery,
+    depthLayers: DepthLayersGallery,
+    contourLines: ContourLinesGallery,
+    prismSplit: PrismSplitGallery,
+    engraving: EngravingGallery,
+    slats: SlatsGallery,
+    fold: FoldGallery,
+    wireRelief: WireReliefGallery,
+    terraces: TerracesGallery,
+    shadowBox: ShadowBoxGallery,
+    popUp: PopUpGallery,
+    ridgelines: RidgelinesGallery,
+    flowLines: FlowLinesGallery,
+    strata: StrataGallery,
+};
+const GalleryObject = ({ createdObject, handleObjectClick, onObjectReady, onObjectDispose }) => {
+    const config = createdObject.config;
+    if (!config)
+        return null;
+    // A gallery saved before the family existed has no config.type: it is the layout gallery (migrateGalleryObject adds it on load).
+    const Component = FAMILY[config.type ?? 'layout'];
+    if (!Component)
+        return null;
+    // Every variant renders the same way: FAMILY is the only per-key entry. The layout gallery reads createdObject
+    // (its frames carry the material and the transform effects) and ignores the rest.
+    return _jsx(Component, { config: config, id: createdObject.id, createdObject: createdObject, handleObjectClick: handleObjectClick, keyframes: createdObject.animations?.gallery?.animations, mouseMove: createdObject.mouseMove?.gallery, onObjectReady: (_source, ref) => onObjectReady?.(createdObject, ref), onObjectDispose: (_source, ref) => onObjectDispose?.(createdObject, ref) });
+};
+export default GalleryObject;

package/dist/components/ImageObject.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../types/objectReady';
+type ImageObjectProps = ObjectReadyProps & {
+    createdObject: CreatedObjectSettings;
+};
+declare const ImageObject: React.FC<ImageObjectProps>;
+export default ImageObject;
+//# sourceMappingURL=ImageObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImageObject.d.ts","sourceRoot":"","sources":["../../src/components/ImageObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAA2C,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAiBF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAa3C,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/ImageObject.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ShardsImage, ProjectorImage, ReliefImage, PinscreenImage, PrismImage, LenticularImage, FrostImage, RollImage, ContourImage, EngravingImage } from './image/index.js';
+/** The image variants' components by config.type (shards, …). */
+const FAMILY = {
+    shards: ShardsImage,
+    projector: ProjectorImage,
+    relief: ReliefImage,
+    pinscreen: PinscreenImage,
+    prism: PrismImage,
+    lenticular: LenticularImage,
+    frost: FrostImage,
+    roll: RollImage,
+    contour: ContourImage,
+    engraving: EngravingImage,
+};
+const ImageObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
+    const config = createdObject.config;
+    if (!config)
+        return null;
+    const Component = FAMILY[config.type];
+    if (!Component)
+        return null;
+    // Every variant renders the same way: FAMILY is the only per-key entry.
+    return _jsx(Component, { config: config, id: createdObject.id, keyframes: createdObject.animations?.image?.animations, mouseMove: createdObject.mouseMove?.image, onObjectReady: (_source, ref) => onObjectReady?.(createdObject, ref), onObjectDispose: (_source, ref) => onObjectDispose?.(createdObject, ref) });
+};
+export default ImageObject;

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAqBA,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,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,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;AA4BF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA8IzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAuBA,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,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,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;AA8BF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmJzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -1,16 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useContext, useMemo } from "react";
 import { GroupMaterialContext, groupMaterialFor } from "./GroupMaterialContext.js";
+import { EnabledContext } from "./EnabledContext.js";
 import CustomPrimitive from "./CustomPrimitive.js";
 import CreatedObject from "./CreatedObject.js";
 import PathRenderer from './PathRenderer.js';
-import GalleryLayout from './GalleryLayout.js';
 import EffectsGenerator from './EffectsGenerator.js';
 import ParticlesGenerator from './ParticlesGenerator.js';
 import LightObject from "./LightObject.js";
 import EnvironmentObject from "./EnvironmentObject.js";
 import LandObject from "./LandObject.js";
 import TextGenerator from "./TextGenerator.js";
+import ImageObject from "./ImageObject.js";
+import GalleryObject from "./GalleryObject.js";
 import Galaxy from "./Galaxy.js";
 import GridGenerator from "./GridsGenerator.js";
 import OceanBuilder from "./OceanBuilder.js";
@@ -19,7 +21,7 @@ import LayoutInstances from "./LayoutInstances.js";
 import { useRuntimeSettings } from "../hooks/useRuntimeSettings.js";
 import { usePresentedVisibility } from "../operations/usePresentedVisibility.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
-import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig } from "@3driseai/3drise-core";
+import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig, isGalleryObjectConfig, galleryTakesMaterial } 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
@@ -46,7 +48,9 @@ const GroupWithChildren = ({ createdObject, children, onObjectReady, onObjectDis
     const isGroup = createdObject.type === 'group';
     // Generative particle objects own their shaders, like effects do.
     const selfManagedMaterial = SELF_MANAGED_MATERIAL.has(createdObject.type)
-        || (createdObject.type === 'particles' && isGenerativeParticlesConfig(createdObject.config));
+        || (createdObject.type === 'particles' && isGenerativeParticlesConfig(createdObject.config))
+        // Gallery variants with their own shaders (carousel, …); the layout gallery's frames take the material.
+        || (createdObject.type === 'gallery' && isGalleryObjectConfig(createdObject.config) && !galleryTakesMaterial(createdObject.config));
     // A group's material (Apply on) goes to the objects inside it — see GroupMaterialContext.
     const parentMaterial = useContext(GroupMaterialContext);
     const ms = createdObject.materialSettings;
@@ -66,6 +70,9 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
     const runtimeObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
     // An object whose effects follow its visibility stays drawn until they have played out.
     const createdObject = usePresentedVisibility(runtimeObject);
+    // Enabled = its own (presented) visibility and every ancestor's — see EnabledContext.
+    const parentEnabled = useContext(EnabledContext);
+    const enabled = parentEnabled && createdObject?.meshSettings?.visible !== false;
     // Children describe themselves with their own settings; the scene above
     // knows them by the node's createdObject, so relabel on the way up.
     const relabel = useCallback((obj) => ({
@@ -133,11 +140,14 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         effect: (obj, _onObjectReady, slot = 0) => (_jsx(EffectsGenerator, { settings: {
                 config: obj.config,
             }, id: obj.id /* every layout slot: each copy registers its live handle, so clips and drags reach the whole layout */, keyframes: obj.animations?.effect?.animations, mouseMove: obj.mouseMove?.effect, ...(slot === 0 ? relabel(obj) : NO_READY) }, obj.id)),
-        gallery: (obj, onObjectReady) => (_jsx(GalleryLayout, { createdObject: obj, handleObjectClick: handleObjectClick, ...relabel(obj) })),
+        // Gallery variants by config.type (layout = GalleryLayout, carousel, …) through GalleryObject's FAMILY table.
+        gallery: (obj, onObjectReady) => (_jsx(GalleryObject, { createdObject: obj, handleObjectClick: handleObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         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 })),
         land: (obj, onObjectReady) => (_jsx(LandObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
+        // Image variants (config.type: shards, …): one picture at a time from config.imageUrls, every change animated.
+        image: (obj, onObjectReady) => (_jsx(ImageObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         // rain: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
         //     <Rain
         //         settings={obj}
@@ -180,13 +190,14 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
     const shouldRenderAsGroup = hasChildren || createdObject.type === 'group' || createdObject.type === 'effect';
     const renderedObject = shouldRenderAsGroup
         ? _jsx(GroupWithChildren, { createdObject: createdObject, children: children, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, renderObject: renderObject })
-        : _jsx(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !SELF_MANAGED_MATERIAL.has(createdObject.type), children: renderObject(createdObject) }, createdObject.id);
+        : _jsx(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !(SELF_MANAGED_MATERIAL.has(createdObject.type) || (createdObject.type === 'gallery' && isGalleryObjectConfig(createdObject.config) && !galleryTakesMaterial(createdObject.config))), children: renderObject(createdObject) }, createdObject.id);
     // createdObject.effects
     //     ? <>
     //         {renderObject(createdObject)}
     //         {/* <EffectsLayer effects={createdObject.effects} /> */}
     //     </>
     //     : renderObject(createdObject);
-    return renderedObject;
+    // Always the Provider (same element type whatever the value), so toggling never remounts the subtree.
+    return _jsx(EnabledContext.Provider, { value: enabled, children: renderedObject });
 };
 export default ObjectNode;

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAgGlD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAY,MAAM,oBAAoB,CAAC;AAE/D,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAuGlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/ObjectsRenderer.js

@@ -10,6 +10,8 @@ import { installStallLog } from '../utils/stallLog.js';
 import { findById } from '../utils/sceneQuery.js';
 import { commandsOf, sceneReadiness } from '../triggers/index.js';
 import { useObjectReady } from '../hooks/useObjectReady.js';
+import { useThree } from "@react-three/fiber";
+import { shownHits } from '../utils/shownInScene.js';
 const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSettings, onObjectsReady, onObjectReady, onObjectDispose, handleObjectClick, sequences = [], clips = [], actionSequences = [], }) => {
     const groupRef = useRef(null);
     const objectsTree = useMemo(() => buildObjectTree(createdObjects), [createdObjects]);
@@ -30,6 +32,13 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
         readyObjectsCount.current = Math.max(0, readyObjectsCount.current - 1);
         onObjectDispose && onObjectDispose(object, ref);
     }, [onObjectDispose]);
+    // Pointer events reach only what is shown: R3F (like three's Raycaster) ignores `visible`, so
+    // objects inside a disabled group would still take hover / click and block what is behind them.
+    const setEvents = useThree(s => s.setEvents);
+    useEffect(() => {
+        setEvents({ filter: (hits) => shownHits(hits) });
+        return () => setEvents({ filter: undefined });
+    }, [setEvents]);
     // The wrapper group itself is an Object3D the parent may want to transform.
     useObjectReady(groupRef, generalObjectSettings, onObjectReady, onObjectDispose);
     function filterInteractionsByEvent(interactions, mouseEvent) {

package/dist/components/ProjectLoader.d.ts

@@ -13,6 +13,8 @@ declare const ProjectLoader: React.ForwardRefExoticComponent<ObjectReadyProps &
     ui?: boolean;
     /** CSS appended to every UI layer after its own — restyle the generic rise-* classes or set --rise-* variables. */
     uiStyles?: string;
+    /** Keyboard control as the project's keyPadSettings sets it (default true). `false` leaves the page's keys alone. */
+    keyboard?: boolean;
     onSceneInitialized?: () => void;
     /**
      * Called once the project is loaded and its canvas exists, with the handle for

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAInE,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;AAqB7D,QAAA,MAAM,aAAa;eAlBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;IACtE,oHAAoH;SAC/G,OAAO;IACZ,mHAAmH;eACxG,MAAM;yBACI,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA6D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAInE,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;AAuB7D,QAAA,MAAM,aAAa;eApBJ,MAAM;uBACE,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI;oBACrF,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI;IACtE,oHAAoH;SAC/G,OAAO;IACZ,mHAAmH;eACxG,MAAM;IACjB,qHAAqH;eAC1G,OAAO;yBACG,MAAM,IAAI;IAC/B;;;;OAIG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;qCA6D7C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/ProjectLoader.js

@@ -7,7 +7,7 @@ import { migrateObject } from '@3driseai/3drise-core';
 import LoadingIndicator from "./LoadingIndicator.js";
 import { useMeshController } from "../hooks/useMeshController.js";
 import { installCdnUrls } from "../utils/cdnUrls.js";
-const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, ui = true, uiStyles, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
+const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, ui = true, uiStyles, keyboard = true, onSceneInitialized, onSceneReady, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }, ref) => {
     const [project, setProject] = useState(null);
     const meshController = useMeshController();
     useEffect(() => {
@@ -61,7 +61,7 @@ const ProjectLoader = forwardRef(({ projectId, onObjectClick, onObjectHover, ui
                 flexDirection: 'column', gap: '1rem'
             }, children: loadingIndicator });
     }
-    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, loadingIndicator: loadingIndicator, onSceneInitialized: onSceneInitialized, ui: ui, uiStyles: uiStyles, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
+    return _jsx(_Fragment, { children: _jsx(SceneBuilder, { ref: ref, project: project, onSceneReady: onSceneReady, loadingIndicator: loadingIndicator, onSceneInitialized: onSceneInitialized, ui: ui, uiStyles: uiStyles, keyboard: keyboard, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
 });
 ProjectLoader.displayName = 'ProjectLoader';
 export default ProjectLoader;

package/dist/components/SceneBuilder.d.ts

@@ -16,6 +16,11 @@ export type SceneBuilderViewerProps = SceneBuilderProps & ObjectReadyProps & {
     uiLayers?: UiLayer[];
     /** Extra CSS appended to every UI layer after its own, to restyle them. */
     uiStyles?: string;
+    /**
+     * Keyboard control (arrows / Ctrl / Alt / + − / Home) as the project's
+     * sceneSettings.keyPadSettings sets it (default true). `false` leaves the page's keys alone.
+     */
+    keyboard?: boolean;
 };
 declare const SceneBuilder: React.ForwardRefExoticComponent<SceneBuilderProps & ObjectReadyProps & {
     /**
@@ -31,6 +36,11 @@ declare const SceneBuilder: React.ForwardRefExoticComponent<SceneBuilderProps &
     uiLayers?: UiLayer[];
     /** Extra CSS appended to every UI layer after its own, to restyle them. */
     uiStyles?: string;
+    /**
+     * Keyboard control (arrows / Ctrl / Alt / + − / Home) as the project's
+     * sceneSettings.keyPadSettings sets it (default true). `false` leaves the page's keys alone.
+     */
+    keyboard?: boolean;
 } & React.RefAttributes<SceneHandle>>;
 export default SceneBuilder;
 //# sourceMappingURL=SceneBuilder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,WAAW,EAA0B,MAAM,oBAAoB,CAAC;AAGjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG;IACzE;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,oEAAoE;IACpE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,YAAY;IAfd;;;OAGG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAC3C,mFAAmF;uBAChE,KAAK,CAAC,SAAS;IAClC,oEAAoE;SAC/D,OAAO;IACZ,qFAAqF;eAC1E,OAAO,EAAE;IACpB,2EAA2E;eAChE,MAAM;qCA6LnB,CAAC;AAIH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,WAAW,EAA0B,MAAM,oBAAoB,CAAC;AAGjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAO7D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG;IACzE;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5C,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,oEAAoE;IACpE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,QAAA,MAAM,YAAY;IApBd;;;OAGG;mBACY,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAC3C,mFAAmF;uBAChE,KAAK,CAAC,SAAS;IAClC,oEAAoE;SAC/D,OAAO;IACZ,qFAAqF;eAC1E,OAAO,EAAE;IACpB,2EAA2E;eAChE,MAAM;IACjB;;;OAGG;eACQ,OAAO;qCA8LpB,CAAC;AAIH,eAAe,YAAY,CAAC"}

package/dist/components/SceneBuilder.js

@@ -21,7 +21,8 @@ import UiLayers from "../ui/UiLayers.js";
 import { sceneReadiness, useSceneReady } from "../triggers/readiness.js";
 import { resetSunSystemLive } from "../animationsV2/sunSystemLive.js";
 import UiAnchorUpdater from "../ui/UiAnchorUpdater.js";
-const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onSceneReady, loadingIndicator, ui = true, uiLayers, uiStyles, onObjectClick, onObjectReady, onObjectDispose, }, ref) => {
+import KeyPadControls from "../keyPad/KeyPadControls.js";
+const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", style = {}, className = "", onSceneInitialized, onSceneReady, loadingIndicator, ui = true, uiLayers, uiStyles, keyboard = true, onObjectClick, onObjectReady, onObjectDispose, }, ref) => {
     const sceneSettings = (project.sceneSettingsData || {});
     // const meshController = useMeshController();
     const [isThreeJsMounted, setIsThreeJsMounted] = useState(false);
@@ -189,7 +190,7 @@ const SceneBuilder = forwardRef(({ project, width = "100%", height = "100vh", st
                                 clouds: environment?.clouds,
                                 ocean: environment?.ocean,
                                 terrain: environment?.terrain,
-                            }) }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(UiAnchorUpdater, {})] }) }), ui && _jsx(UiLayers, { layers: uiLayers ?? project.uiLayers, scene: sceneHandle, extraCss: uiStyles }), (!started || !ready) && (_jsx("div", { style: { position: 'absolute', inset: 0, zIndex: 1000, backgroundColor, display: 'flex', alignItems: 'center', justifyContent: 'center' }, children: loadingIndicator }))] }));
+                            }) }), _jsx(CursorController, { effects: project.cursor?.effects, clickActions: project.cursor?.clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(UiAnchorUpdater, {})] }) }), ui && _jsx(UiLayers, { layers: uiLayers ?? project.uiLayers, scene: sceneHandle, extraCss: uiStyles }), keyboard && ready && _jsx(KeyPadControls, { settings: sceneSettings.keyPadSettings, clips: animationClips, sequences: animationSequences, homePosition: position }), (!started || !ready) && (_jsx("div", { style: { position: 'absolute', inset: 0, zIndex: 1000, backgroundColor, display: 'flex', alignItems: 'center', justifyContent: 'center' }, children: loadingIndicator }))] }));
 });
 SceneBuilder.displayName = 'SceneBuilder';
 /** Readiness entry for "the canvas exists" (its renderer is what compiles the shaders). */

package/dist/components/gallery/BasicCarouselGallery.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { AnimationOptions, MouseMoveDomain, BasicCarouselGalleryConfig } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface BasicCarouselGalleryProps extends ObjectReadyProps {
+    config: BasicCarouselGalleryConfig;
+    /** Scene object id: the live-edit handle and the gallery's runtime entry are found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.gallery.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.gallery). */
+    mouseMove?: MouseMoveDomain;
+}
+/**
+ * A coverflow carousel of framed pictures on a damped scroll with drag, throw and snap, a lifted centre frame and a soft floor reflection; the cursor tilts or lifts the frames. Use for portfolios, product lines and photo sets.
+ */
+declare const BasicCarouselGallery: React.FC<BasicCarouselGalleryProps>;
+export default BasicCarouselGallery;
+//# sourceMappingURL=BasicCarouselGallery.d.ts.map

package/dist/components/gallery/BasicCarouselGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicCarouselGallery.d.ts","sourceRoot":"","sources":["../../../src/components/gallery/BasicCarouselGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAShE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,MAAM,EAAE,0BAA0B,CAAC;IACnC,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAG7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/gallery/BasicCarouselGallery.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_GALLERY_OBJECTS, GALLERY_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import GalleryVariant from './kit/GalleryVariant.js';
+import * as LOOK from './looks/basicCarousel.js';
+/**
+ * A coverflow carousel of framed pictures on a damped scroll with drag, throw and snap, a lifted centre frame and a soft floor reflection; the cursor tilts or lifts the frames. Use for portfolios, product lines and photo sets.
+ */
+const BasicCarouselGallery = ({ config, ...rest }) => (_jsx(GalleryVariant, { look: LOOK, defaults: DEFAULT_GALLERY_OBJECTS.basicCarousel, animatable: GALLERY_OBJECTS_ANIMATABLE.basicCarousel, config: config, ...rest }));
+export default BasicCarouselGallery;

package/dist/components/gallery/ContourLinesGallery.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { AnimationOptions, MouseMoveDomain, ContourLinesGalleryConfig } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface ContourLinesGalleryProps extends ObjectReadyProps {
+    config: ContourLinesGalleryConfig;
+    /** Scene object id: the live-edit handle and the gallery's runtime entry are found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.gallery.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.gallery). */
+    mouseMove?: MouseMoveDomain;
+}
+/**
+ * Pictures drawn as the contour lines of their own brightness, like a topographic map: inactive ones are a few thin grey lines, the active one fills in as a soft wave thickens the lines into the solid picture; the cursor lifts the contours into relief. Use for architecture, data and graphic showcases.
+ */
+declare const ContourLinesGallery: React.FC<ContourLinesGalleryProps>;
+export default ContourLinesGallery;
+//# sourceMappingURL=ContourLinesGallery.d.ts.map

package/dist/components/gallery/ContourLinesGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContourLinesGallery.d.ts","sourceRoot":"","sources":["../../../src/components/gallery/ContourLinesGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAShE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,MAAM,EAAE,yBAAyB,CAAC;IAClC,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAG3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/components/gallery/ContourLinesGallery.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_GALLERY_OBJECTS, GALLERY_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import GalleryVariant from './kit/GalleryVariant.js';
+import * as LOOK from './looks/contourLines.js';
+/**
+ * Pictures drawn as the contour lines of their own brightness, like a topographic map: inactive ones are a few thin grey lines, the active one fills in as a soft wave thickens the lines into the solid picture; the cursor lifts the contours into relief. Use for architecture, data and graphic showcases.
+ */
+const ContourLinesGallery = ({ config, ...rest }) => (_jsx(GalleryVariant, { look: LOOK, defaults: DEFAULT_GALLERY_OBJECTS.contourLines, animatable: GALLERY_OBJECTS_ANIMATABLE.contourLines, config: config, ...rest }));
+export default ContourLinesGallery;