@3driseai/3drise-viewer 0.1.24 → 0.1.26

package/dist/animationsV2/normalize.d.ts

@@ -0,0 +1,4 @@
+import type { AnimationClip, AnimationSequence } from './types';
+export declare function normalizeClip(row: any): AnimationClip;
+export declare function normalizeSequence(row: any): AnimationSequence;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/animationsV2/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/animationsV2/normalize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAkB,MAAM,SAAS,CAAC;AAKhF,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAarD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,iBAAiB,CAgC7D"}

package/dist/animationsV2/normalize.js

@@ -0,0 +1,49 @@
+import { DEFAULT_DRIVER_SETTINGS } from './types.js';
+const DRIVERS = ['time', 'mouseWheel', 'mouseX', 'mouseY'];
+export function normalizeClip(row) {
+    return {
+        id: row.id,
+        name: row.name ?? 'Clip',
+        key: row.key ?? '',
+        description: row.description ?? undefined,
+        duration: Number(row.duration) || 4,
+        fps: Number(row.fps) || 30,
+        loop: !!row.loop,
+        yoyo: !!row.yoyo,
+        endMode: row.endMode === 'restore' ? 'restore' : 'hold',
+        tracks: Array.isArray(row.tracks) ? row.tracks : [],
+    };
+}
+export function normalizeSequence(row) {
+    const steps = Array.isArray(row.steps) ? row.steps : [];
+    return {
+        id: row.id,
+        name: row.name ?? 'Sequence',
+        key: row.key ?? '',
+        description: row.description ?? undefined,
+        steps: steps.map((s, i) => ({
+            id: s?.id ?? `step-${i}`,
+            clips: Array.isArray(s?.clips)
+                ? s.clips
+                    .filter((c) => c && typeof c.clipId === 'string')
+                    .map((c, j) => ({
+                    id: c.id ?? `sc-${i}-${j}`,
+                    clipId: c.clipId,
+                    delay: Math.max(0, Number(c.delay) || 0),
+                    speed: Number(c.speed) > 0 ? Number(c.speed) : 1,
+                }))
+                : [],
+        })),
+        loop: !!row.loop,
+        yoyo: !!row.yoyo,
+        reverse: !!row.reverse,
+        endMode: row.endMode === 'restore' ? 'restore' : 'hold',
+        driver: DRIVERS.includes(row.driver) ? row.driver : 'time',
+        driverSettings: {
+            sensitivity: Number(row.driverSettings?.sensitivity) > 0 ? Number(row.driverSettings.sensitivity) : DEFAULT_DRIVER_SETTINGS.sensitivity,
+            smoothing: Number(row.driverSettings?.smoothing) >= 0 ? Number(row.driverSettings.smoothing) : DEFAULT_DRIVER_SETTINGS.smoothing,
+            invert: !!row.driverSettings?.invert,
+        },
+        autoplay: !!row.autoplay,
+    };
+}

package/dist/animationsV2/sequenceUtils.d.ts

@@ -0,0 +1,57 @@
+import type { AnimationClip, AnimationSequence, StepClip } from './types';
+export interface ScheduledClip {
+    /** `${stepClip.id}` — stable across re-resolves of the same sequence. */
+    id: string;
+    stepIndex: number;
+    /** Row within the step. */
+    row: number;
+    stepClip: StepClip;
+    clip: AnimationClip;
+    /** Sequence seconds. */
+    start: number;
+    end: number;
+}
+export interface SequenceSchedule {
+    /** In priority order (schedule index = activation order). */
+    entries: ScheduledClip[];
+    steps: {
+        start: number;
+        end: number;
+    }[];
+    duration: number;
+}
+export type ClipLookup = ReadonlyMap<string, AnimationClip> | ((id: string) => AnimationClip | undefined);
+export declare const clipMap: (clips: readonly AnimationClip[]) => Map<string, AnimationClip>;
+/** Step clips whose clip is missing (deleted, not loaded) are skipped. */
+export declare function resolveSequence(seq: AnimationSequence, clips: ClipLookup): SequenceSchedule;
+/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T. */
+export declare function entryLocalTime(entry: ScheduledClip, T: number): number;
+/**
+ * Whether an entry writes at sequence time T: from its start on, and after its end
+ * only if its clip holds ('hold'); a 'restore' clip lets go at its end.
+ */
+export declare function isEntryActive(entry: ScheduledClip, T: number): boolean;
+export interface StepConflict {
+    stepIndex: number;
+    /** The upper row — its animation is hidden while the other drives the property. */
+    masked: StepClip;
+    /** The lower row — it wins. */
+    winner: StepClip;
+    state: string;
+    node?: string;
+    path: string;
+}
+/**
+ * Same-step clips that drive the same property at the same time. A pair conflicts
+ * when the upper row is still ANIMATING while the lower row is active (animating,
+ * or holding its end value) — then the lower row hides it. An upper row that only
+ * holds under a lower one animating is the expected override, not a conflict.
+ */
+export declare function findSequenceConflicts(seq: AnimationSequence, clips: ClipLookup): StepConflict[];
+/** Step-clip ids involved in any conflict (row markers). */
+export declare function conflictedStepClipIds(conflicts: readonly StepConflict[]): Set<string>;
+export declare function newSequence(name: string, key: string): AnimationSequence;
+export declare function newStepClip(clipId: string): StepClip;
+/** Deep copy with fresh ids (duplicate). */
+export declare function cloneSequence(seq: AnimationSequence, name: string, key: string): AnimationSequence;
+//# sourceMappingURL=sequenceUtils.d.ts.map

package/dist/animationsV2/sequenceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequenceUtils.d.ts","sourceRoot":"","sources":["../../src/animationsV2/sequenceUtils.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAI1E,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC,CAAC;AAK1G,eAAO,MAAM,OAAO,GAAI,OAAO,SAAS,aAAa,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAC/C,CAAC;AAKrC,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAqB3F;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAGtE;AAID,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,MAAM,EAAE,QAAQ,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,EAAE,CAuC/F;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAIrF;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAMxE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEpD;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CASlG"}

package/dist/animationsV2/sequenceUtils.js

@@ -0,0 +1,120 @@
+import { DEFAULT_DRIVER_SETTINGS } from './types.js';
+import { uid } from './clipUtils.js';
+const lookup = (clips, id) => (typeof clips === 'function' ? clips(id) : clips.get(id));
+export const clipMap = (clips) => new Map(clips.map(c => [c.id, c]));
+const safeSpeed = (s) => (Number.isFinite(s) && s > 0 ? s : 1);
+const safeDelay = (d) => (Number.isFinite(d) && d > 0 ? d : 0);
+/** Step clips whose clip is missing (deleted, not loaded) are skipped. */
+export function resolveSequence(seq, clips) {
+    const entries = [];
+    const steps = [];
+    let cursor = 0;
+    seq.steps.forEach((step, stepIndex) => {
+        const stepStart = cursor;
+        let stepEnd = stepStart;
+        step.clips.forEach((stepClip, row) => {
+            const clip = lookup(clips, stepClip.clipId);
+            if (!clip)
+                return;
+            const start = stepStart + safeDelay(stepClip.delay);
+            const end = start + Math.max(0, clip.duration) / safeSpeed(stepClip.speed);
+            entries.push({ id: stepClip.id, stepIndex, row, stepClip, clip, start, end });
+            stepEnd = Math.max(stepEnd, end);
+        });
+        steps.push({ start: stepStart, end: stepEnd });
+        cursor = stepEnd;
+    });
+    return { entries, steps, duration: cursor };
+}
+/** Clip-local time (seconds, 0..clip.duration) of an entry at sequence time T. */
+export function entryLocalTime(entry, T) {
+    const local = (T - entry.start) * safeSpeed(entry.stepClip.speed);
+    return Math.min(entry.clip.duration, Math.max(0, local));
+}
+/**
+ * Whether an entry writes at sequence time T: from its start on, and after its end
+ * only if its clip holds ('hold'); a 'restore' clip lets go at its end.
+ */
+export function isEntryActive(entry, T) {
+    if (T < entry.start)
+        return false;
+    return T <= entry.end || entry.clip.endMode !== 'restore';
+}
+const targetKey = (state, node, path) => `${state}|${node ?? ''}|${path}`;
+/**
+ * Same-step clips that drive the same property at the same time. A pair conflicts
+ * when the upper row is still ANIMATING while the lower row is active (animating,
+ * or holding its end value) — then the lower row hides it. An upper row that only
+ * holds under a lower one animating is the expected override, not a conflict.
+ */
+export function findSequenceConflicts(seq, clips) {
+    const { entries } = resolveSequence(seq, clips);
+    const out = [];
+    const byStep = new Map();
+    entries.forEach(e => {
+        const list = byStep.get(e.stepIndex) ?? [];
+        list.push(e);
+        byStep.set(e.stepIndex, list);
+    });
+    for (const [stepIndex, list] of byStep) {
+        for (let i = 0; i < list.length; i++) {
+            const upper = list[i];
+            if (upper.end <= upper.start)
+                continue; // nothing animates
+            const upperTargets = new Map();
+            upper.clip.tracks.forEach(t => {
+                if (!t.muted && t.keys.length)
+                    upperTargets.set(targetKey(t.state, t.node, t.path), t);
+            });
+            if (!upperTargets.size)
+                continue;
+            for (let j = i + 1; j < list.length; j++) {
+                const lower = list[j];
+                const lowerEnd = lower.clip.endMode === 'restore' ? lower.end : Infinity;
+                const overlaps = upper.start < lowerEnd && lower.start < upper.end;
+                if (!overlaps)
+                    continue;
+                const seen = new Set();
+                lower.clip.tracks.forEach(t => {
+                    if (t.muted || !t.keys.length)
+                        return;
+                    const k = targetKey(t.state, t.node, t.path);
+                    const hit = upperTargets.get(k);
+                    if (!hit || seen.has(k))
+                        return;
+                    seen.add(k);
+                    out.push({ stepIndex, masked: upper.stepClip, winner: lower.stepClip, state: hit.state, node: hit.node, path: hit.path });
+                });
+            }
+        }
+    }
+    return out;
+}
+/** Step-clip ids involved in any conflict (row markers). */
+export function conflictedStepClipIds(conflicts) {
+    const ids = new Set();
+    conflicts.forEach(c => { ids.add(c.masked.id); ids.add(c.winner.id); });
+    return ids;
+}
+// --- builders ----------------------------------------------------------------------
+export function newSequence(name, key) {
+    return {
+        id: uid('seq'), name, key, steps: [{ id: uid('step'), clips: [] }],
+        loop: false, yoyo: false, reverse: false, endMode: 'hold',
+        driver: 'time', driverSettings: { ...DEFAULT_DRIVER_SETTINGS }, autoplay: false,
+    };
+}
+export function newStepClip(clipId) {
+    return { id: uid('sc'), clipId, delay: 0, speed: 1 };
+}
+/** Deep copy with fresh ids (duplicate). */
+export function cloneSequence(seq, name, key) {
+    return {
+        ...seq,
+        id: uid('seq'),
+        name,
+        key,
+        isDirty: undefined,
+        steps: seq.steps.map(s => ({ id: uid('step'), clips: s.clips.map(c => ({ ...c, id: uid('sc') })) })),
+    };
+}

package/dist/animationsV2/types.d.ts

@@ -0,0 +1,95 @@
+/** Easing of the segment leaving a key. Names match core's easingUtils, plus 'step'. */
+export type EaseName = 'linear' | 'step' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic' | 'easeInQuart' | 'easeOutQuart' | 'easeInOutQuart' | 'easeInSine' | 'easeOutSine' | 'easeInOutSine' | 'easeInExpo' | 'easeOutExpo' | 'easeInOutExpo' | 'easeInBack' | 'easeOutBack' | 'easeInOutBack' | 'easeOutElastic' | 'easeOutBounce';
+export type KeyValue = number | number[] | string | boolean;
+export interface Keyframe {
+    /** Stable within the track — selection and drag follow it, not the index. */
+    id: string;
+    /** Seconds from clip start. */
+    t: number;
+    value: KeyValue;
+    /** Easing of the segment LEAVING this key. */
+    ease?: EaseName;
+}
+export interface Track {
+    id: string;
+    /** Object id, or 'camera'. (sky / clouds / ocean come later.) */
+    state: string;
+    /**
+     * A node inside a `model` object (its ModelTree key: the node name). When set,
+     * `path` is relative to that node: 'position' | 'rotation' | 'scale' | 'visible' |
+     * 'material.<color|opacity|roughness|metalness|emissive|emissiveIntensity>' —
+     * the same fields a node override (config.nodeOverrides) carries.
+     */
+    node?: string;
+    /** Settings path on that element ('meshSettings.position', 'materialSettings.opacity', 'config.intensity'…), or node-relative when `node` is set. */
+    path: string;
+    /** Sorted by t. */
+    keys: Keyframe[];
+    muted?: boolean;
+}
+export interface AnimationClip {
+    id: string;
+    name: string;
+    key: string;
+    description?: string;
+    /** Seconds. */
+    duration: number;
+    /** Timeline frame rate — display and snapping only; playback samples real time. */
+    fps: number;
+    loop: boolean;
+    yoyo: boolean;
+    /** When a non-looping clip finishes: keep the last values, or return to authored. */
+    endMode: 'hold' | 'restore';
+    tracks: Track[];
+    /** Unsaved changes (save bookkeeping, never sent). */
+    isDirty?: boolean;
+}
+/** One clip inside a step. Plays once, forward — loop / yoyo / reverse are the sequence's. */
+export interface StepClip {
+    id: string;
+    /** AnimationClip id. */
+    clipId: string;
+    /** Seconds after the step starts (>= 0). */
+    delay: number;
+    /** 1 = authored speed. */
+    speed: number;
+}
+/** Clips that start together. The step ends when its longest clip ends; then the next step starts. */
+export interface SequenceStep {
+    id: string;
+    clips: StepClip[];
+}
+/** What moves a sequence's clock: time (it plays), or an input that scrubs it. */
+export type SequenceDriver = 'time' | 'mouseWheel' | 'mouseX' | 'mouseY';
+export interface SequenceDriverSettings {
+    /** mouseWheel: progress per wheel pixel is sensitivity / 1000 (1 ≈ one long scroll for the whole sequence). */
+    sensitivity: number;
+    /** 0 = follows the input exactly; higher = eases toward it (≈ seconds to settle). */
+    smoothing: number;
+    /** Flip the direction: right-to-left, bottom-to-top, wheel up = forward. */
+    invert: boolean;
+}
+export declare const DEFAULT_DRIVER_SETTINGS: SequenceDriverSettings;
+export interface AnimationSequence {
+    id: string;
+    name: string;
+    key: string;
+    description?: string;
+    /** Run in order. */
+    steps: SequenceStep[];
+    /** Whole-sequence playback. */
+    loop: boolean;
+    yoyo: boolean;
+    reverse: boolean;
+    endMode: 'hold' | 'restore';
+    /** What moves the clock. Input drivers scrub the sequence instead of playing it. */
+    driver: SequenceDriver;
+    driverSettings: SequenceDriverSettings;
+    /** Start when the project loads (published viewer; the studio never autoplays). */
+    autoplay: boolean;
+    /** Unsaved changes (save bookkeeping, never sent). */
+    isDirty?: boolean;
+}
+export declare const DEFAULT_EASE: EaseName;
+export declare const FPS_PRESETS: readonly [24, 25, 30, 60];
+//# sourceMappingURL=types.d.ts.map

package/dist/animationsV2/types.d.ts.map

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

package/dist/animationsV2/types.js

@@ -0,0 +1,8 @@
+// =============================================================================
+// Animations V2 — timeline clips and sequences (project docs
+// claude/animations-v2-design.md, claude/animations-v2-sequences-plan.md).
+// Shared by the studio (client) and the published viewer (ProjectLoader).
+// =============================================================================
+export const DEFAULT_DRIVER_SETTINGS = { sensitivity: 1, smoothing: 0.25, invert: false };
+export const DEFAULT_EASE = 'easeInOutCubic';
+export const FPS_PRESETS = [24, 25, 30, 60];

package/dist/api/sceneHandle.d.ts

@@ -0,0 +1,102 @@
+import type { ActionSequence } from '@3driseai/3drise-core';
+import type { AnimationClip, AnimationSequence } from '../animationsV2/types';
+export interface SceneActionInfo {
+    id: string;
+    key?: string;
+    name: string;
+    description?: string;
+    applied: boolean;
+}
+export interface SceneClipInfo {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    /** Seconds, one pass. */
+    duration: number;
+    loop: boolean;
+    yoyo: boolean;
+    endMode: 'hold' | 'restore';
+    playing: boolean;
+}
+export interface SceneSequenceInfo {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    /** Seconds, one pass through every step. */
+    duration: number;
+    steps: number;
+    loop: boolean;
+    yoyo: boolean;
+    reverse: boolean;
+    endMode: 'hold' | 'restore';
+    /** 'time' plays; 'mouseWheel' | 'mouseX' | 'mouseY' — the input scrubs it once played. */
+    driver: 'time' | 'mouseWheel' | 'mouseX' | 'mouseY';
+    autoplay: boolean;
+    playing: boolean;
+}
+export interface ScenePlayOptions {
+    /** Playback rate, 1 = authored. */
+    speed?: number;
+    /** Play backwards. For a sequence this overrides its own `reverse` for this run. */
+    reverse?: boolean;
+    /** Where to start, 0–1 of the duration. */
+    from?: number;
+}
+/** The same controls for clips and for sequences. */
+export interface ScenePlayback<Info> {
+    list(): Info[];
+    play(ref: string, options?: ScenePlayOptions): boolean;
+    pause(ref: string): boolean;
+    resume(ref: string): boolean;
+    /** Stop and put everything it animated back to the authored scene. */
+    stop(ref: string): boolean;
+    /** Jump to a point, 0–1 of the duration. */
+    seek(ref: string, progress: number): boolean;
+    isPlaying(ref: string): boolean;
+}
+export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd' | 'animationLoop';
+export interface SceneHandleEvent {
+    type: SceneHandleEventType;
+    kind: 'action' | 'clip' | 'sequence';
+    id: string;
+    key?: string;
+    name: string;
+}
+export interface SceneHandle {
+    actions: {
+        list(): SceneActionInfo[];
+        apply(ref: string): boolean;
+        revert(ref: string): boolean;
+        /** Returns true when it applied, false when it reverted (or the action was not found). */
+        toggle(ref: string): boolean;
+        isApplied(ref: string): boolean;
+        /** Revert every applied action of this project — back to the authored scene. */
+        reset(): void;
+    };
+    clips: ScenePlayback<SceneClipInfo>;
+    sequences: ScenePlayback<SceneSequenceInfo> & {
+        /**
+         * Drive a sequence from your own input (page scroll, a slider…): its position,
+         * 0–1 along its own direction. A running input-driven sequence eases there with
+         * its smoothing; otherwise it is posed there at once.
+         */
+        setProgress(ref: string, progress: number): boolean;
+        /** Current position, 0–1 along its own direction. */
+        getProgress(ref: string): number;
+    };
+    /** Subscribe to this project's action / clip / sequence events. Returns the unsubscribe. */
+    on(type: SceneHandleEventType, listener: (event: SceneHandleEvent) => void): () => void;
+}
+export interface SceneHandleSource {
+    actions: ActionSequence[];
+    clips: AnimationClip[];
+    sequences: AnimationSequence[];
+}
+/**
+ * Build a handle over one project's actions, clips and sequences. `getSource` is
+ * read on every call, so the handle stays valid if the project data is replaced.
+ */
+export declare function createSceneHandle(getSource: () => SceneHandleSource): SceneHandle;
+//# sourceMappingURL=sceneHandle.d.ts.map

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

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