@hology/core 0.0.193 → 0.0.195

package/dist/effects/sequence/index.d.ts

@@ -1,8 +1,13 @@
 export * from './sequence-data.js';
+export * from './sequence-locator.js';
+export * from './sequence-definitions.js';
 export * from './sequence-event.js';
+export * from './sequence-ops.js';
 export * from './sequence-player.js';
 export * from './sequence-actor.js';
 export * from './sequencer.js';
 export * from './sequence-action.js';
 export * from './audio-parameters.js';
+export * from './sequence-value-lane.js';
+export * from './sequence-animation-retiming.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/effects/sequence/index.js

@@ -1,4 +1,4 @@
-export*from"./sequence-data.js";export*from"./sequence-event.js";export*from"./sequence-player.js";export*from"./sequence-actor.js";export*from"./sequencer.js";export*from"./sequence-action.js";export*from"./audio-parameters.js";/*
+export*from"./sequence-data.js";export*from"./sequence-locator.js";export*from"./sequence-definitions.js";export*from"./sequence-event.js";export*from"./sequence-ops.js";export*from"./sequence-player.js";export*from"./sequence-actor.js";export*from"./sequencer.js";export*from"./sequence-action.js";export*from"./audio-parameters.js";export*from"./sequence-value-lane.js";export*from"./sequence-animation-retiming.js";/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/effects/sequence/sequence-action.d.ts

@@ -1,10 +1,11 @@
 import { SequenceRole } from './sequence-data.js';
 import { BaseActor } from '../../gameplay/actors/actor.js';
 import { Object3D } from 'three';
+import { SequenceLocatorReader } from './sequence-locator.js';
 /**
  * SequenceAction is used to play, pause, stop, etc. a sequence.
  */
-export interface SequenceAction {
+export interface SequenceAction extends SequenceLocatorReader {
     /** Bind a role to a runtime target for dynamic actor binding */
     bindRole(role: SequenceRole, target: BaseActor | Object3D): void;
     play(): void;

package/dist/effects/sequence/sequence-actor.d.ts

@@ -5,6 +5,7 @@ import { Asset } from '../../scene/model.js';
 import { Subject } from 'rxjs';
 import { Object3D } from 'three';
 import { SequenceAction } from './sequence-action.js';
+import { SequenceLocatorSnapshot } from './sequence-locator.js';
 /**
  * SequenceActor is an actor that plays a sequence in the world.
  *
@@ -70,6 +71,12 @@ export declare class SequenceActor extends BaseActor implements SequenceAction {
      */
     get externalTimeControl(): boolean;
     set externalTimeControl(value: boolean);
+    /**
+     * When true, editor-only sequence events are allowed to fire.
+     * This should only be enabled for editor preview playback.
+     */
+    get inEditor(): boolean;
+    set inEditor(value: boolean);
     readonly onComplete: Subject<void>;
     readonly onLoop: Subject<number>;
     private player;
@@ -105,6 +112,8 @@ export declare class SequenceActor extends BaseActor implements SequenceAction {
      * Bind a scene object by ID to a target
      */
     bindObject(objectId: string, target: Object3D | BaseActor): void;
+    getLocator(bindingId: string): SequenceLocatorSnapshot | null;
+    getLocators(bindingId: string): SequenceLocatorSnapshot[];
     /**
      * Start or resume playback
      */

package/dist/effects/sequence/sequence-actor.js

@@ -1,4 +1,4 @@
-import{__decorate as e,__metadata as t}from"tslib";import{Actor as s,BaseActor as r}from"../../gameplay/actors/actor.js";import{inject as a}from"../../gameplay/inject.js";import{ViewController as i}from"../../gameplay/services/render.js";import{AssetLoader as o}from"../../gameplay/services/asset-loader.js";import{World as l}from"../../gameplay/services/world.js";import{ActorFactory as p}from"../../gameplay/actors/factory.js";import{VfxService as n}from"../../effects/vfx/vfx-service.js";import{Parameter as h}from"../../shader/parameter.js";import{createSequenceData as c}from"./sequence-data.js";import{SequencePlayer as y,SequencePlaybackState as d}from"./sequence-player.js";import{Subject as m,takeUntil as u}from"rxjs";let f=class extends r{constructor(){super(...arguments),this.sequenceData=c(),this.sequenceAssetId=null,this.onComplete=new m,this.onLoop=new m,this.player=new y,this.viewController=a(i),this.assetLoader=a(o),this.world=a(l),this.actorFactory=a(p),this.vfxService=a(n),this.sourceAsset=null}get timescale(){return this.player.timescale}set timescale(e){this.player.timescale=e}get loop(){return this.player.loop}set loop(e){this.player.loop=e}get state(){return this.player.state}get time(){return this.player.time}get duration(){return this.player.duration}get paused(){return this.player.state===d.Paused}get externalTimeControl(){return this.player.externalTimeControl}set externalTimeControl(e){this.player.externalTimeControl=e}async onInit(){this.player.setWorld(this.world),this.player.setAudioListener(this.viewController.audioListener),this.player.setAssetLoader(this.assetLoader),this.player.setActorFactory(this.actorFactory),this.player.setVfxService(this.vfxService),this.viewController.onUpdate(this).pipe(u(this.disposed)).subscribe(e=>this.player.update(e)),this.player.onComplete.pipe(u(this.disposed)).subscribe(()=>this.onComplete.next()),this.player.onLoop.pipe(u(this.disposed)).subscribe(e=>this.onLoop.next(e)),this.sequenceAssetId?await this.loadFromAssetId(this.sequenceAssetId):this.sequenceData&&this.player.load(this.sequenceData)}async loadFromAsset(e){if("sequence"!==e.type)throw new Error(`Asset must be a sequence asset but is ${e.type}`);this.sourceAsset=e,this.sourceAsset.sequence&&(this.sequenceData=this.sourceAsset.sequence,this.player.load(this.sequenceData))}async loadFromAssetId(e){const t=await this.assetLoader.getAsset(e);t&&await this.loadFromAsset(t)}setSequenceData(e){this.sequenceData=e,this.player.load(e)}bindRole(e,t){this.player.bindRole(e,t)}bindObject(e,t){this.player.bindObject(e,t)}play(){this.player.play()}pause(){this.player.pause()}stop(){this.player.stop()}restart(){this.player.restart()}seek(e){this.player.seek(e)}refreshAsset(e){this.player.refreshAsset(e)}onUpdate(e){}onEndPlay(){this.player.dispose()}dispose(){this.world.removeActor(this)}};e([h({label:"Sequence Data"}),t("design:type",Object)],f.prototype,"sequenceData",void 0),f=e([s()],f);export{f as SequenceActor};/*
+import{__decorate as e,__metadata as t}from"tslib";import{Actor as s,BaseActor as r}from"../../gameplay/actors/actor.js";import{inject as i}from"../../gameplay/inject.js";import{ViewController as a}from"../../gameplay/services/render.js";import{AssetLoader as o}from"../../gameplay/services/asset-loader.js";import{World as l}from"../../gameplay/services/world.js";import{ActorFactory as p}from"../../gameplay/actors/factory.js";import{VfxService as n}from"../../effects/vfx/vfx-service.js";import{Parameter as h}from"../../shader/parameter.js";import{createSequenceData as c}from"./sequence-data.js";import{SequencePlayer as y,SequencePlaybackState as d}from"./sequence-player.js";import{Subject as m,takeUntil as u}from"rxjs";let f=class extends r{constructor(){super(...arguments),this.sequenceData=c(),this.sequenceAssetId=null,this.onComplete=new m,this.onLoop=new m,this.player=new y,this.viewController=i(a),this.assetLoader=i(o),this.world=i(l),this.actorFactory=i(p),this.vfxService=i(n),this.sourceAsset=null}get timescale(){return this.player.timescale}set timescale(e){this.player.timescale=e}get loop(){return this.player.loop}set loop(e){this.player.loop=e}get state(){return this.player.state}get time(){return this.player.time}get duration(){return this.player.duration}get paused(){return this.player.state===d.Paused}get externalTimeControl(){return this.player.externalTimeControl}set externalTimeControl(e){this.player.externalTimeControl=e}get inEditor(){return this.player.inEditor}set inEditor(e){this.player.inEditor=e}async onInit(){this.player.setWorld(this.world),this.player.setAudioListener(this.viewController.audioListener),this.player.setAssetLoader(this.assetLoader),this.player.setActorFactory(this.actorFactory),this.player.setVfxService(this.vfxService),this.viewController.onUpdate(this).pipe(u(this.disposed)).subscribe(e=>this.player.update(e)),this.player.onComplete.pipe(u(this.disposed)).subscribe(()=>this.onComplete.next()),this.player.onLoop.pipe(u(this.disposed)).subscribe(e=>this.onLoop.next(e)),this.sequenceAssetId?await this.loadFromAssetId(this.sequenceAssetId):this.sequenceData&&this.player.load(this.sequenceData)}async loadFromAsset(e){if("sequence"!==e.type)throw new Error(`Asset must be a sequence asset but is ${e.type}`);this.sourceAsset=e,this.sourceAsset.sequence&&(this.sequenceData=this.sourceAsset.sequence,this.player.load(this.sequenceData))}async loadFromAssetId(e){const t=await this.assetLoader.getAsset(e);t&&await this.loadFromAsset(t)}setSequenceData(e){this.sequenceData=e,this.player.load(e)}bindRole(e,t){this.player.bindRole(e,t)}bindObject(e,t){this.player.bindObject(e,t)}getLocator(e){return this.player.getLocator(e)}getLocators(e){return this.player.getLocators(e)}play(){this.player.play()}pause(){this.player.pause()}stop(){this.player.stop()}restart(){this.player.restart()}seek(e){this.player.seek(e)}refreshAsset(e){this.player.refreshAsset(e)}onUpdate(e){}onEndPlay(){this.player.dispose()}dispose(){this.world.removeActor(this)}};e([h({label:"Sequence Data"}),t("design:type",Object)],f.prototype,"sequenceData",void 0),f=e([s()],f);export{f as SequenceActor};/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/effects/sequence/sequence-animation-retiming.d.ts

@@ -0,0 +1,15 @@
+import * as THREE from 'three';
+import { AnimationClipInstance, AnimationClipRetiming, AnimationClipRetimingMode, AnimationClipRetimingPoint } from './sequence-data.js';
+export declare const MAX_ANIMATION_CLIP_RETIME_POINTS = 3;
+export interface AnimationClipRetimingControlPoint extends AnimationClipRetimingPoint {
+    implicit: boolean;
+}
+export declare function getAnimationClipRetimingMode(retiming: AnimationClipRetiming | null | undefined): AnimationClipRetimingMode;
+export declare function isAnimationClipUsingRetiming(clip: Pick<AnimationClipInstance, 'retiming'>): boolean;
+export declare function normalizeAnimationClipRetiming(retiming: AnimationClipRetiming | null | undefined): AnimationClipRetiming;
+export declare function getAnimationClipRetimingControlPoints(retiming: AnimationClipRetiming | null | undefined): AnimationClipRetimingControlPoint[];
+export declare function evaluateAnimationClipSourceProgress(retiming: AnimationClipRetiming | null | undefined, clipProgress: number): number;
+export declare function evaluateAnimationClipOutputProgress(retiming: AnimationClipRetiming | null | undefined, sourceProgress: number): number;
+export declare function getAnimationClipRetimingSignature(clip: Pick<AnimationClipInstance, 'duration' | 'clipStartOffset' | 'clipEndOffset' | 'retiming' | 'rootMotion'>): string;
+export declare function buildRetimedAnimationClip(sourceClip: THREE.AnimationClip, clip: AnimationClipInstance): THREE.AnimationClip;
+//# sourceMappingURL=sequence-animation-retiming.d.ts.map

package/dist/effects/sequence/sequence-animation-retiming.js

@@ -0,0 +1,4 @@
+import*as t from"three";const i=1e-4;export const MAX_ANIMATION_CLIP_RETIME_POINTS=3;export function getAnimationClipRetimingMode(t){return t?.mode??"uniform"}export function isAnimationClipUsingRetiming(t){return"uniform"!==getAnimationClipRetimingMode(t.retiming)}export function normalizeAnimationClipRetiming(t){const e=getAnimationClipRetimingMode(t),r="impact"===e?1:3,s=(Array.isArray(t?.points)?t.points:[]).map((t,i)=>({id:"string"==typeof t?.id&&t.id.trim().length>0?t.id:`retime-${i}`,clipProgress:n(t?.clipProgress,.5),sourceProgress:n(t?.sourceProgress,.5)})).sort((t,i)=>t.clipProgress-i.clipProgress||t.sourceProgress-i.sourceProgress).slice(0,r),u=[];let c=0,l=0;for(let t=0;t<s.length;t++){const e=s[t],n=s.length-t-1,r=1-i*(n+1),m=o(e.clipProgress,c+i,r),a=o(e.sourceProgress,l+i,r);u.push({id:e.id,clipProgress:m,sourceProgress:a}),c=m,l=a}return{mode:e,points:u}}export function getAnimationClipRetimingControlPoints(t){return[{id:"retime-start",clipProgress:0,sourceProgress:0,implicit:!0},...normalizeAnimationClipRetiming(t).points.map(t=>({...t,implicit:!1})),{id:"retime-end",clipProgress:1,sourceProgress:1,implicit:!0}]}export function evaluateAnimationClipSourceProgress(t,i){return e(getAnimationClipRetimingControlPoints(t),r(i),"clipProgress","sourceProgress")}export function evaluateAnimationClipOutputProgress(t,i){return e(getAnimationClipRetimingControlPoints(t),r(i),"sourceProgress","clipProgress")}export function getAnimationClipRetimingSignature(t){const i=normalizeAnimationClipRetiming(t.retiming);return JSON.stringify({duration:u(t.duration),clipStartOffset:u(t.clipStartOffset),clipEndOffset:u(t.clipEndOffset),rootMotion:t.rootMotion,retiming:i})}export function buildRetimedAnimationClip(n,u){const l=Math.max(0,n.duration),m=o(u.clipStartOffset,0,l),a=o(l-u.clipEndOffset,m,l),p=Math.max(0,a-m),g=Math.max(i,u.duration),f=getAnimationClipRetimingControlPoints(u.retiming),P=n.tracks.map(t=>{const n=t.clone(),o=t.getValueSize(),u=function(t,n,o,u,c,l,m){const a=function(t,i,e){const n=new Set([s(i),s(e)]);for(const r of t.times)r>=i&&r<=e&&n.add(s(r));return[...n].sort((t,i)=>t-i)}(t,n,o);if(0===a.length)return{times:[],values:[]};const p=t.createInterpolant(),g=[],f=[];for(const t of a){const o=e(l,u<=i?0:r((t-n)/u),"sourceProgress","clipProgress");g.push(s(c*o));const a=p.evaluate(t);if(1===m&&!Array.isArray(a)&&"object"!=typeof a){f.push(a);continue}const P=Array.from(a);for(let t=0;t<m;t++)f.push(P[t]??P[P.length-1]??0)}if(1===g.length&&c>i){g.push(c);for(let t=0;t<m;t++)f.push(f[t])}return{times:g,values:f}}(t,m,a,p,g,f,o);if(0===u.times.length)return null;const l=n;return l.times=c(l.TimeBufferType,u.times),l.values=c(l.ValueBufferType,u.values),l}).filter(Boolean);return new t.AnimationClip(n.name,g,P,n.blendMode)}function e(t,e,n,o){const s=r(e);for(let e=1;e<t.length;e++){const u=t[e-1],c=t[e],l=c[n];if(s>l&&e<t.length-1)continue;const m=u[n],a=u[o],p=c[o],g=l-m;if(g<=i)return r(p);const f=r((s-m)/g);return r(a+(p-a)*f)}return r(t[t.length-1][o])}function n(t,i){return"number"==typeof t&&Number.isFinite(t)?t:i}function r(t){return o(t,0,1)}function o(t,i,e){return Math.min(Math.max(t,i),e)}function s(t){return Math.round(1e6*t)/1e6}function u(t){return Math.round(1e5*t)/1e5}function c(t,i){return t===Array?i.slice():new t(i)}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/effects/sequence/sequence-data.d.ts

@@ -35,7 +35,7 @@ export declare enum SequenceRole {
     /** Secondary actor (e.g., companion, summoned entity) */
     Secondary = "secondary"
 }
-export type SequenceTrackType = 'object' | 'camera' | 'audio' | 'vfx' | 'spawn' | 'group';
+export type SequenceTrackType = 'object' | 'locator' | 'camera' | 'audio' | 'vfx' | 'spawn' | 'group';
 /**
  * Base interface for all track types
  */
@@ -75,6 +75,15 @@ export interface ObjectTrack extends BaseTrack {
      */
     role: SequenceRole | null;
 }
+/**
+ * Locator track - a lightweight named transform source owned by the sequence.
+ * Useful for authored spawn points, attachment pivots, and gameplay query points.
+ */
+export interface LocatorTrack extends BaseTrack {
+    type: 'locator';
+    /** Optional gameplay-facing identifier used for runtime lookup. */
+    bindingId?: string;
+}
 /**
  * Camera track - controls a sequence-owned camera
  */
@@ -147,7 +156,7 @@ export interface GroupTrack extends BaseTrack {
     /** Child tracks within this group */
     childTracks: SequenceTrack[];
 }
-export type SequenceTrack = ObjectTrack | CameraTrack | AudioTrack | VfxTrack | SpawnTrack | GroupTrack;
+export type SequenceTrack = ObjectTrack | LocatorTrack | CameraTrack | AudioTrack | VfxTrack | SpawnTrack | GroupTrack;
 export type SubTrackType = 'transform' | 'animation' | 'property' | 'material' | 'visibility' | 'event' | 'audioParameter';
 /**
  * Base interface for sub-tracks
@@ -237,6 +246,25 @@ export interface AudioParameterSubTrack extends BaseSubTrack {
     keyframes: PropertyKeyframe[];
 }
 export type SubTrack = TransformSubTrack | AnimationSubTrack | PropertySubTrack | MaterialSubTrack | VisibilitySubTrack | EventSubTrack | AudioParameterSubTrack;
+export type SequenceValueSubTrack = PropertySubTrack | MaterialSubTrack | AudioParameterSubTrack;
+export type SequenceKeyframeSubTrack = TransformSubTrack | PropertySubTrack | MaterialSubTrack | VisibilitySubTrack | AudioParameterSubTrack;
+export type SequenceDirectClipTrack = AudioTrack | VfxTrack | SpawnTrack;
+export type SequenceAnimationHostTrack = ObjectTrack | CameraTrack | SpawnTrack;
+export type AnimationClipRetimingMode = 'uniform' | 'impact' | 'advanced';
+export interface AnimationClipRetimingPoint {
+    /** Unique identifier */
+    id: string;
+    /** Progress through the placed sequence clip (0-1) */
+    clipProgress: number;
+    /** Progress through the trimmed source clip span (0-1) */
+    sourceProgress: number;
+}
+export interface AnimationClipRetiming {
+    /** Retiming UI mode */
+    mode: AnimationClipRetimingMode;
+    /** Internal control points. Endpoints (0,0) and (1,1) are implicit. */
+    points: AnimationClipRetimingPoint[];
+}
 /**
  * Interpolation mode for keyframes
  */
@@ -302,6 +330,8 @@ export interface AnimationClipInstance {
     playbackRate: number;
     /** Fade in duration */
     fadeInDuration: number;
+    /** Optional retiming controls for redistributing time within the clip */
+    retiming?: AnimationClipRetiming;
     /** Blend out duration */
     /** Whether this animation has root motion enabled */
     rootMotion: boolean;
@@ -379,6 +409,8 @@ export interface SequenceEventData {
     id: string;
     /** Time in seconds to trigger the event */
     time: number;
+    /** When true, the event only fires during editor playback/preview */
+    editorOnly?: boolean;
     /** Name of the function to call on the target */
     functionName: string;
     /** Arguments to pass to the function */
@@ -432,6 +464,14 @@ export declare function createAudioParameterSubTrack(parameter?: AudioParameterI
  * Creates a new property sub-track
  */
 export declare function createPropertySubTrack(propertyPath?: string, propertyType?: SerializedParamType): PropertySubTrack;
+/**
+ * Creates a new material sub-track
+ */
+export declare function createMaterialSubTrack(uniformName?: string, uniformType?: SerializedParamType, materialSlot?: string | number): MaterialSubTrack;
+/**
+ * Creates a new visibility sub-track
+ */
+export declare function createVisibilitySubTrack(name?: string): VisibilitySubTrack;
 /**
  * Creates a new transform keyframe
  */
@@ -444,6 +484,8 @@ export declare function createPropertyKeyframe(time: number, value?: CustomParam
  * Creates a new animation clip instance
  */
 export declare function createAnimationClipInstance(animationClipAssetId: AssetId | null, startTime: number, duration: number): AnimationClipInstance;
+export declare function createAnimationClipRetimingPoint(clipProgress?: number, sourceProgress?: number): AnimationClipRetimingPoint;
+export declare function createAnimationClipRetiming(mode?: AnimationClipRetimingMode, points?: AnimationClipRetimingPoint[]): AnimationClipRetiming;
 /**
  * Creates a new audio clip instance
  */
@@ -460,4 +502,8 @@ export declare function createEventSubTrack(name?: string): EventSubTrack;
  * Creates a new sequence event
  */
 export declare function createSequenceEventData(time: number, functionName?: string): SequenceEventData;
+/**
+ * Creates a new locator track
+ */
+export declare function createLocatorTrack(name?: string): LocatorTrack;
 //# sourceMappingURL=sequence-data.d.ts.map

package/dist/effects/sequence/sequence-data.js

@@ -1,4 +1,4 @@
-import{SerializedParamType as e}from"../../scene/model.js";import{randomString as t}from"../../utils/math.js";import{getAudioParameterDefinition as r}from"./audio-parameters.js";export class Sequence{constructor(e){this.data=e}}export var SequenceRole;!function(e){e.Self="self",e.Target="target",e.Target2="target2",e.Target3="target3",e.Secondary="secondary"}(SequenceRole||(SequenceRole={}));export function createSequenceData(){return{duration:5,loop:!1,playbackRate:1,tracks:[]}}export function createObjectTrack(e="Object Track"){return{id:t(),name:e,type:"object",muted:!1,locked:!1,targetId:null,role:null,subTracks:[]}}export function createCameraTrack(e="Camera Track"){return{id:t(),name:e,type:"camera",muted:!1,locked:!1,cameraSettings:{fov:60,near:.1,far:1e3},subTracks:[]}}export function createAudioTrack(e="Audio Track"){return{id:t(),name:e,type:"audio",muted:!1,locked:!1,clips:[],subTracks:[],volume:1,spatial:!1}}export function createVfxTrack(e="VFX Track"){return{id:t(),name:e,type:"vfx",muted:!1,locked:!1,clips:[],position:[0,0,0],rotation:[0,0,0],scale:[1,1,1],subTracks:[]}}export function createSpawnTrack(e="Spawn Track"){return{id:t(),name:e,type:"spawn",muted:!1,locked:!1,spawnType:"mesh",role:null,clips:[],subTracks:[]}}export function createSpawnClipInstance(e,r){return{id:t(),startTime:e,duration:r}}export function createGroupTrack(e="Group"){return{id:t(),name:e,type:"group",muted:!1,locked:!1,collapsed:!1,childTracks:[],subTracks:[]}}export function createTransformSubTrack(){return{id:t(),name:"Transform",type:"transform",muted:!1,components:{position:!0,rotation:!0,scale:!0},keyframes:[]}}export function createAnimationSubTrack(e="Animation"){return{id:t(),name:e,type:"animation",muted:!1,clips:[]}}export function createAudioParameterSubTrack(e="volume"){const a=r(e);return{id:t(),name:a.displayName,type:"audioParameter",muted:!1,parameter:e,keyframes:[]}}export function createPropertySubTrack(r="",a=e.Number){return{id:t(),name:r||"Property",type:"property",muted:!1,propertyPath:r,propertyType:a,keyframes:[]}}export function createTransformKeyframe(e){return{id:t(),time:e,position:[0,0,0],rotation:[0,0,0],scale:[1,1,1],interpolation:"cubic"}}export function createPropertyKeyframe(r,a={type:e.Number,value:0}){return{id:t(),time:r,value:a,interpolation:"linear"}}export function createAnimationClipInstance(e,r,a){return{id:t(),animationClipAssetId:e,startTime:r,duration:a,clipStartOffset:0,clipEndOffset:0,playbackRate:1,fadeInDuration:.2,rootMotion:!1}}export function createAudioClipInstance(e,r,a){return{id:t(),audioAssetId:e,startTime:r,duration:a,clipStartOffset:0,playbackRate:1,volume:1,fadeInDuration:0,fadeOutDuration:0,volumeRandomization:0,pitchRandomization:0}}export function createVfxClipInstance(e,r,a){return{id:t(),vfxAssetId:e,startTime:r,duration:a,endBehavior:"finish",expireWithinSeconds:.25}}export function createEventSubTrack(e="Events"){return{id:t(),name:e,type:"event",muted:!1,events:[]}}export function createSequenceEventData(e,r=""){return{id:t(),time:e,functionName:r,arguments:[]}}/*
+import{SerializedParamType as e}from"../../scene/model.js";import{randomString as t}from"../../utils/math.js";import{getAudioParameterDefinition as r}from"./audio-parameters.js";export class Sequence{constructor(e){this.data=e}}export var SequenceRole;!function(e){e.Self="self",e.Target="target",e.Target2="target2",e.Target3="target3",e.Secondary="secondary"}(SequenceRole||(SequenceRole={}));export function createSequenceData(){return{duration:5,loop:!1,playbackRate:1,tracks:[]}}export function createObjectTrack(e="Object Track"){return{id:t(),name:e,type:"object",muted:!1,locked:!1,targetId:null,role:null,subTracks:[]}}export function createCameraTrack(e="Camera Track"){return{id:t(),name:e,type:"camera",muted:!1,locked:!1,cameraSettings:{fov:60,near:.1,far:1e3},subTracks:[]}}export function createAudioTrack(e="Audio Track"){return{id:t(),name:e,type:"audio",muted:!1,locked:!1,clips:[],subTracks:[],volume:1,spatial:!1}}export function createVfxTrack(e="VFX Track"){return{id:t(),name:e,type:"vfx",muted:!1,locked:!1,clips:[],position:[0,0,0],rotation:[0,0,0],scale:[1,1,1],subTracks:[]}}export function createSpawnTrack(e="Spawn Track"){return{id:t(),name:e,type:"spawn",muted:!1,locked:!1,spawnType:"mesh",role:null,clips:[],subTracks:[]}}export function createSpawnClipInstance(e,r){return{id:t(),startTime:e,duration:r}}export function createGroupTrack(e="Group"){return{id:t(),name:e,type:"group",muted:!1,locked:!1,collapsed:!1,childTracks:[],subTracks:[]}}export function createTransformSubTrack(){return{id:t(),name:"Transform",type:"transform",muted:!1,components:{position:!0,rotation:!0,scale:!0},keyframes:[]}}export function createAnimationSubTrack(e="Animation"){return{id:t(),name:e,type:"animation",muted:!1,clips:[]}}export function createAudioParameterSubTrack(e="volume"){const a=r(e);return{id:t(),name:a.displayName,type:"audioParameter",muted:!1,parameter:e,keyframes:[]}}export function createPropertySubTrack(r="",a=e.Number){return{id:t(),name:r||"Property",type:"property",muted:!1,propertyPath:r,propertyType:a,keyframes:[]}}export function createMaterialSubTrack(r="",a=e.Number,n=0){return{id:t(),name:r||"Material",type:"material",muted:!1,materialSlot:n,uniformName:r,uniformType:a,keyframes:[]}}export function createVisibilitySubTrack(e="Visibility"){return{id:t(),name:e,type:"visibility",muted:!1,keyframes:[]}}export function createTransformKeyframe(e){return{id:t(),time:e,position:[0,0,0],rotation:[0,0,0],scale:[1,1,1],interpolation:"cubic"}}export function createPropertyKeyframe(r,a={type:e.Number,value:0}){return{id:t(),time:r,value:a,interpolation:"linear"}}export function createAnimationClipInstance(e,r,a){return{id:t(),animationClipAssetId:e,startTime:r,duration:a,clipStartOffset:0,clipEndOffset:0,playbackRate:1,fadeInDuration:.2,retiming:void 0,rootMotion:!1}}export function createAnimationClipRetimingPoint(e=.35,r=.55){return{id:t(),clipProgress:e,sourceProgress:r}}export function createAnimationClipRetiming(e="impact",t=("uniform"===e?[]:[createAnimationClipRetimingPoint()])){return{mode:e,points:t}}export function createAudioClipInstance(e,r,a){return{id:t(),audioAssetId:e,startTime:r,duration:a,clipStartOffset:0,playbackRate:1,volume:1,fadeInDuration:0,fadeOutDuration:0,volumeRandomization:0,pitchRandomization:0}}export function createVfxClipInstance(e,r,a){return{id:t(),vfxAssetId:e,startTime:r,duration:a,endBehavior:"finish",expireWithinSeconds:.25}}export function createEventSubTrack(e="Events"){return{id:t(),name:e,type:"event",muted:!1,events:[]}}export function createSequenceEventData(e,r=""){return{id:t(),time:e,editorOnly:!1,functionName:r,arguments:[]}}export function createLocatorTrack(e="Locator"){return{id:t(),name:e,type:"locator",muted:!1,locked:!1,subTracks:[]}}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/effects/sequence/sequence-definitions.d.ts

@@ -0,0 +1,53 @@
+import { AnimationClipInstance, SequenceTrack, SequenceTrackType, SubTrack, SubTrackType } from './sequence-data.js';
+import { AudioParameterId } from './audio-parameters.js';
+export type SequenceTrackRuntimeEvaluator = 'object' | 'locator' | 'camera' | 'audio' | 'vfx' | 'spawn' | 'group';
+export type SequenceSubTrackRuntimeEvaluator = 'transform' | 'animation' | 'visibility' | 'parameter' | 'event';
+export type SequenceSubTrackLaneKind = 'keyframes' | 'clips' | 'events';
+type DirectTrackClip = SequenceTrack extends infer TTrack ? TTrack extends {
+    clips: Array<infer TClip>;
+} ? TClip : never : never;
+export interface SequenceTrackDefinition<TTrack extends SequenceTrack = SequenceTrack> {
+    type: TTrack['type'];
+    label: string;
+    icon: string;
+    runtimeEvaluator: SequenceTrackRuntimeEvaluator;
+    createTrack: (startTime?: number, defaultDuration?: number) => TTrack;
+    createDirectClip?: (startTime?: number, defaultDuration?: number) => DirectTrackClip;
+    allowedSubTrackTypes: readonly SubTrackType[];
+    supportsParenting?: boolean;
+    exposedInEditor?: boolean;
+}
+export interface SequenceSubTrackDefinition<TSubTrack extends SubTrack = SubTrack> {
+    type: TSubTrack['type'];
+    label: string;
+    icon: string;
+    laneKind: SequenceSubTrackLaneKind;
+    runtimeEvaluator: SequenceSubTrackRuntimeEvaluator;
+    createSubTrack: (options?: {
+        parameter?: AudioParameterId;
+    }) => TSubTrack;
+    createClip?: (startTime?: number, defaultDuration?: number) => AnimationClipInstance;
+    supportedTrackTypes: readonly SequenceTrackType[];
+    allowMultiple?: boolean;
+    exposedInEditor?: boolean;
+    valueLane?: {
+        kind: 'number' | 'customParam';
+    };
+}
+export interface AudioParameterSubTrackOption {
+    parameter: AudioParameterId;
+    label: string;
+    icon: string;
+}
+export declare const audioParameterSubTrackOptions: AudioParameterSubTrackOption[];
+export declare function getSequenceTrackDefinitions(): SequenceTrackDefinition[];
+export declare function getSequenceSubTrackDefinitions(): SequenceSubTrackDefinition[];
+export declare function getSequenceTrackDefinition(type: SequenceTrackType): SequenceTrackDefinition;
+export declare function getSequenceSubTrackDefinition(type: SubTrackType): SequenceSubTrackDefinition;
+export declare function getEditorSequenceTrackDefinitions(): SequenceTrackDefinition[];
+export declare function getEditorSequenceSubTrackDefinitions(track: SequenceTrack): SequenceSubTrackDefinition[];
+export declare function canTrackAddSubTrack(track: SequenceTrack, type: SubTrackType, options?: {
+    parameter?: AudioParameterId;
+}): boolean;
+export {};
+//# sourceMappingURL=sequence-definitions.d.ts.map

package/dist/effects/sequence/sequence-definitions.js

@@ -0,0 +1,4 @@
+import{createAnimationClipInstance as e,createAnimationSubTrack as a,createAudioClipInstance as r,createAudioParameterSubTrack as t,createAudioTrack as n,createCameraTrack as o,createEventSubTrack as i,createGroupTrack as l,createLocatorTrack as p,createMaterialSubTrack as c,createObjectTrack as u,createPropertySubTrack as s,createSpawnClipInstance as m,createSpawnTrack as d,createTransformSubTrack as T,createVfxClipInstance as b,createVfxTrack as k,createVisibilitySubTrack as y}from"./sequence-data.js";const f=[{type:"object",label:"Object Track",icon:"mdil-hexagon",runtimeEvaluator:"object",createTrack:()=>u(),allowedSubTrackTypes:["transform","animation","property","material","visibility","event"],supportsParenting:!0,exposedInEditor:!1},{type:"locator",label:"Locator",icon:"mdil-map-marker-radius",runtimeEvaluator:"locator",createTrack:()=>p(),allowedSubTrackTypes:["transform"],supportsParenting:!0,exposedInEditor:!0},{type:"camera",label:"Camera Track",icon:"mdil-camcorder",runtimeEvaluator:"camera",createTrack:(r=0,t=2)=>{const n=o(),i=a();return i.clips.push(e(null,r,t)),n.subTracks.push(i),n},allowedSubTrackTypes:["transform","animation","property","event"],exposedInEditor:!0},{type:"audio",label:"Audio Track",icon:"mdil-volume-high",runtimeEvaluator:"audio",createTrack:(e=0,a=2)=>{const t=n();return t.clips.push(r(null,e,a)),t},createDirectClip:(e=0,a=2)=>r(null,e,a),allowedSubTrackTypes:["audioParameter"],supportsParenting:!0,exposedInEditor:!0},{type:"vfx",label:"VFX Track",icon:"mdil-star",runtimeEvaluator:"vfx",createTrack:(e=0,a=2)=>{const r=k();return r.clips.push(b(null,e,a)),r},createDirectClip:(e=0,a=2)=>b(null,e,a),allowedSubTrackTypes:["transform"],supportsParenting:!0,exposedInEditor:!0},{type:"spawn",label:"Spawn Track",icon:"mdil-plus-box",runtimeEvaluator:"spawn",createTrack:(e=0,a=2)=>{const r=d();return r.clips.push(m(e,a)),r},createDirectClip:(e=0,a=2)=>m(e,a),allowedSubTrackTypes:["transform","animation","property","event"],supportsParenting:!0,exposedInEditor:!0},{type:"group",label:"Group",icon:"mdil-folder",runtimeEvaluator:"group",createTrack:()=>l(),allowedSubTrackTypes:[],exposedInEditor:!1}],v=[{type:"transform",label:"Transform",icon:"mdil-move-resize",laneKind:"keyframes",runtimeEvaluator:"transform",createSubTrack:()=>T(),supportedTrackTypes:["object","locator","camera","spawn","vfx"],exposedInEditor:!0},{type:"animation",label:"Animation",icon:"mdil-run",laneKind:"clips",runtimeEvaluator:"animation",createSubTrack:()=>a(),createClip:(a=0,r=2)=>e(null,a,r),supportedTrackTypes:["object","camera","spawn"],exposedInEditor:!0},{type:"property",label:"Property",icon:"mdil-tune",laneKind:"keyframes",runtimeEvaluator:"parameter",createSubTrack:()=>s(),supportedTrackTypes:["object","camera","spawn"],exposedInEditor:!1,valueLane:{kind:"customParam"}},{type:"material",label:"Material",icon:"mdil-palette",laneKind:"keyframes",runtimeEvaluator:"parameter",createSubTrack:()=>c(),supportedTrackTypes:["object","spawn"],exposedInEditor:!1,valueLane:{kind:"customParam"}},{type:"visibility",label:"Visibility",icon:"mdil-eye",laneKind:"keyframes",runtimeEvaluator:"visibility",createSubTrack:()=>y(),supportedTrackTypes:["object","spawn","vfx"],exposedInEditor:!1},{type:"event",label:"Events",icon:"mdil-flash-outline",laneKind:"events",runtimeEvaluator:"event",createSubTrack:()=>i(),supportedTrackTypes:["object","spawn","camera"],exposedInEditor:!0},{type:"audioParameter",label:"Audio Parameter",icon:"mdil-tune",laneKind:"keyframes",runtimeEvaluator:"parameter",createSubTrack:e=>t(e?.parameter),supportedTrackTypes:["audio"],allowMultiple:!0,exposedInEditor:!0,valueLane:{kind:"number"}}];export const audioParameterSubTrackOptions=[{parameter:"volume",label:"Volume",icon:"mdil-tune"},{parameter:"detune",label:"Detune",icon:"mdil-music-note"},{parameter:"pan",label:"Pan",icon:"mdil-panorama-horizontal"},{parameter:"spatialBlend",label:"Spatial Blend",icon:"mdil-cube-outline"},{parameter:"lowpass",label:"Low Pass Filter",icon:"mdil-filter-variant"},{parameter:"highpass",label:"High Pass Filter",icon:"mdil-filter-variant"}];const E=new Map(f.map(e=>[e.type,e])),x=new Map(v.map(e=>[e.type,e]));export function getSequenceTrackDefinitions(){return f}export function getSequenceSubTrackDefinitions(){return v}export function getSequenceTrackDefinition(e){return E.get(e)}export function getSequenceSubTrackDefinition(e){return x.get(e)}export function getEditorSequenceTrackDefinitions(){return f.filter(e=>!1!==e.exposedInEditor)}export function getEditorSequenceSubTrackDefinitions(e){return v.filter(a=>!1!==a.exposedInEditor&&a.supportedTrackTypes.some(a=>a===e.type))}export function canTrackAddSubTrack(e,a,r){if(e.locked)return!1;const t=getSequenceSubTrackDefinition(a);return!!t.supportedTrackTypes.some(a=>a===e.type)&&("audioParameter"===a?!!r?.parameter&&!e.subTracks.some(e=>"audioParameter"===e.type&&e.parameter===r.parameter):!!t.allowMultiple||!e.subTracks.some(e=>e.type===a))}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/effects/sequence/sequence-event.d.ts

@@ -1,4 +1,5 @@
 import 'reflect-metadata';
+import type { ParameterOptions, ParameterType, PropertyParameter } from '../../shader/parameter.js';
 import { Type } from '../../utils/type.js';
 /**
  * Metadata about a sequence event method on an actor
@@ -8,6 +9,17 @@ export interface SequenceEventInfo {
     name: string;
     /** Actual method name on the actor class */
     methodName: string;
+    /** Configurable parameters that are passed to the method in declaration order */
+    parameters: PropertyParameter[];
+}
+export interface SequenceEventParameterDefinition {
+    name?: string;
+    type?: ParameterType;
+    options?: ParameterOptions;
+}
+export interface SequenceEventOptions {
+    displayName?: string;
+    parameters?: SequenceEventParameterDefinition[];
 }
 /**
  * Decorator to mark an actor method as callable from sequences.
@@ -23,9 +35,20 @@ export interface SequenceEventInfo {
  *   onSequenceHit() {
  *     // Handle hit event
  *   }
+ *
+ *   @SequenceEvent({
+ *     displayName: 'Fire Projectile',
+ *     parameters: [
+ *       { name: 'origin', type: Vector3, options: { label: 'Spawn Position' } },
+ *       { name: 'speed', type: Number, options: { range: [0, 100], stepSize: 0.1 } }
+ *     ]
+ *   })
+ *   fireProjectile(origin: Vector3, speed: number) {
+ *     // Handle projectile spawning
+ *   }
  * }
  */
-export declare function SequenceEvent(displayName?: string): (target: Object, methodName: string) => void;
+export declare function SequenceEvent(displayNameOrOptions?: string | SequenceEventOptions): (target: Object, methodName: string) => void;
 /**
  * Extract all sequence events from an actor class and its parent classes.
  * This is used by the editor to populate the event function dropdown.

package/dist/effects/sequence/sequence-event.js

@@ -1,4 +1,4 @@
-import"reflect-metadata";import{ArrayMap as e}from"../../utils/collections.js";const t=new e;export function SequenceEvent(e){return function(n,o){null!=n&&t.push(n.constructor,{name:e??o?.replace(/^on/,""),methodName:o})}}export function extractSequenceEvents(e){if(null==e)return[];const n=t.get(e)||[];return[...extractSequenceEvents(Object.getPrototypeOf(e)).filter(e=>n.every(t=>t.methodName!==e.methodName)),...n]}/*
+import"reflect-metadata";import{ArrayMap as e}from"../../utils/collections.js";const t=new e;export function SequenceEvent(e){let a;return a=null==e?{}:"string"==typeof e?{displayName:e}:e,function(e,n){null!=e&&t.push(e.constructor,{name:a.displayName??n?.replace(/^on/,""),methodName:n,parameters:a.parameters})}}export function extractSequenceEvents(e){if(null==e)return[];const n=(t.get(e)||[]).map(t=>({name:t.name,methodName:t.methodName,parameters:a(e,t.methodName,t.parameters)}));return[...extractSequenceEvents(Object.getPrototypeOf(e)).filter(e=>n.every(t=>t.methodName!==e.methodName)),...n]}function a(e,t,a){const r=Reflect.getMetadata("sequence:paramnames",e.prototype,t)??[],o=Reflect.getMetadata("design:paramtypes",e.prototype,t)??[],p=Reflect.getMetadata("prefab:paramtypes",e.prototype,t)??[],l=Math.max(r.length,o.length,a?.length??0),m=[];for(let e=0;e<l;e++){const t=a?.[e],l=t?.type??o[e];if(null==l)continue;const c=r[e],s=t?.name??c??`arg${e+1}`,u={...t?.options??{}};u.prefabOf??(u.prefabOf=p[e]??void 0),null==u.label&&(u.label=n(c??s)),m.push({name:s,type:l,options:u})}return m}function n(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[_-]+/g," ").replace(/^\w/,e=>e.toUpperCase())}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/effects/sequence/sequence-locator.d.ts

@@ -0,0 +1,14 @@
+import { Quaternion, Vector3 } from 'three';
+export interface SequenceLocatorSnapshot {
+    trackId: string;
+    name: string;
+    bindingId?: string;
+    position: Vector3;
+    rotation: Quaternion;
+    scale: Vector3;
+}
+export interface SequenceLocatorReader {
+    getLocator(bindingId: string): SequenceLocatorSnapshot | null;
+    getLocators(bindingId: string): SequenceLocatorSnapshot[];
+}
+//# sourceMappingURL=sequence-locator.d.ts.map

package/dist/effects/sequence/sequence-locator.js

@@ -0,0 +1,4 @@
+export{};/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/effects/sequence/sequence-ops.d.ts

@@ -0,0 +1,48 @@
+import { AnimationClipInstance, PropertyKeyframe, SequenceData, SequenceEventData, SequenceTrack, SubTrack, SubTrackType, TransformKeyframe, VisibilityKeyframe } from './sequence-data.js';
+export interface SequenceTrackReference {
+    trackId: string;
+}
+export interface SequenceSubTrackReference extends SequenceTrackReference {
+    subTrackId: string;
+}
+export interface SequenceClipReference extends SequenceSubTrackReference {
+    clipId: string;
+}
+export interface SequenceDirectClipReference extends SequenceTrackReference {
+    clipId: string;
+}
+export interface SequenceKeyframeReference extends SequenceSubTrackReference {
+    keyframeId: string;
+    keyframeIndex: number;
+    subTrackType: SubTrackType;
+    time: number;
+}
+export interface SequenceOperationResult<TReference = void> {
+    data: SequenceData;
+    ref?: TReference;
+}
+type EditableKeyframe = TransformKeyframe | PropertyKeyframe | VisibilityKeyframe;
+type EditableTimedItem = EditableKeyframe | SequenceEventData;
+type DirectTrackClip = SequenceTrack extends infer TTrack ? TTrack extends {
+    clips: Array<infer TClip>;
+} ? TClip : never : never;
+export declare function addTrack(data: SequenceData, track: SequenceTrack): SequenceData;
+export declare function updateTrack(data: SequenceData, trackId: string, updater: (track: SequenceTrack) => SequenceTrack): SequenceData;
+export declare function removeTrack(data: SequenceData, trackId: string): SequenceData;
+export declare function moveTrack(data: SequenceData, trackId: string, direction: 'up' | 'down'): SequenceData;
+export declare function duplicateTrack(data: SequenceData, trackId: string): SequenceOperationResult<SequenceTrackReference>;
+export declare function addSubTrack(data: SequenceData, trackId: string, subTrack: SubTrack): SequenceOperationResult<SequenceSubTrackReference>;
+export declare function updateSubTrack(data: SequenceData, trackId: string, subTrackId: string, updater: (subTrack: SubTrack) => SubTrack): SequenceData;
+export declare function removeSubTrack(data: SequenceData, trackId: string, subTrackId: string): SequenceData;
+export declare function addTrackClip(data: SequenceData, trackId: string, clip: DirectTrackClip): SequenceOperationResult<SequenceDirectClipReference>;
+export declare function updateTrackClip(data: SequenceData, trackId: string, clipId: string, updater: (clip: DirectTrackClip) => DirectTrackClip): SequenceData;
+export declare function removeTrackClip(data: SequenceData, trackId: string, clipId: string): SequenceData;
+export declare function addAnimationClip(data: SequenceData, trackId: string, subTrackId: string, clip: AnimationClipInstance): SequenceOperationResult<SequenceClipReference>;
+export declare function updateAnimationClip(data: SequenceData, trackId: string, subTrackId: string, clipId: string, updater: (clip: AnimationClipInstance) => AnimationClipInstance): SequenceData;
+export declare function removeAnimationClip(data: SequenceData, trackId: string, subTrackId: string, clipId: string): SequenceData;
+export declare function addSubTrackKeyframe(data: SequenceData, trackId: string, subTrackId: string, keyframe: EditableTimedItem): SequenceOperationResult<SequenceKeyframeReference>;
+export declare function updateSubTrackKeyframe(data: SequenceData, trackId: string, subTrackId: string, keyframeId: string, updater: (keyframe: EditableTimedItem) => EditableTimedItem): SequenceOperationResult<SequenceKeyframeReference>;
+export declare function removeSubTrackKeyframe(data: SequenceData, trackId: string, subTrackId: string, keyframeId: string): SequenceData;
+export declare function cloneTrackWithFreshIds(track: SequenceTrack): SequenceTrack;
+export {};
+//# sourceMappingURL=sequence-ops.d.ts.map

package/dist/effects/sequence/sequence-ops.js

@@ -0,0 +1,4 @@
+import{randomString as r}from"../../utils/math.js";import{sortTimedSequenceItems as e}from"./sequence-value-lane.js";export function addTrack(r,e){return{...r,tracks:[...r.tracks,e]}}export function updateTrack(r,e,t){return{...r,tracks:r.tracks.map(r=>r.id===e?t(r):r)}}export function removeTrack(r,e){return{...r,tracks:r.tracks.filter(r=>r.id!==e)}}export function moveTrack(r,e,t){const a=r.tracks.findIndex(r=>r.id===e);if(a<0)return r;const n="up"===t?a-1:a+1;if(n<0||n>=r.tracks.length)return r;const i=[...r.tracks];return[i[a],i[n]]=[i[n],i[a]],{...r,tracks:i}}export function duplicateTrack(r,e){const t=r.tracks.findIndex(r=>r.id===e);if(t<0)return{data:r};const a=cloneTrackWithFreshIds(r.tracks[t]);a.name=`${r.tracks[t].name} (Copy)`;const n=[...r.tracks];return n.splice(t+1,0,a),{data:{...r,tracks:n},ref:{trackId:a.id}}}export function addSubTrack(r,e,t){return{data:updateTrack(r,e,r=>({...r,subTracks:[...r.subTracks,t]})),ref:{trackId:e,subTrackId:t.id}}}export function updateSubTrack(r,e,t,a){return updateTrack(r,e,r=>({...r,subTracks:r.subTracks.map(r=>r.id===t?a(r):r)}))}export function removeSubTrack(r,e,t){return updateTrack(r,e,r=>({...r,subTracks:r.subTracks.filter(r=>r.id!==t)}))}export function addTrackClip(r,e,t){return{data:updateTrack(r,e,r=>i(r)?{...r,clips:[...r.clips,t]}:r),ref:{trackId:e,clipId:t.id}}}export function updateTrackClip(r,e,t,a){return updateTrack(r,e,r=>i(r)?{...r,clips:r.clips.map(r=>r.id===t?a(r):r)}:r)}export function removeTrackClip(r,e,t){return updateTrack(r,e,r=>i(r)?{...r,clips:r.clips.filter(r=>r.id!==t)}:r)}export function addAnimationClip(r,e,t,a){return{data:n(r,e,t,r=>({...r,clips:[...r.clips,a]})),ref:{trackId:e,subTrackId:t,clipId:a.id}}}export function updateAnimationClip(r,e,t,a,i){return n(r,e,t,r=>({...r,clips:r.clips.map(r=>r.id===a?i(r):r)}))}export function removeAnimationClip(r,e,t,a){return n(r,e,t,r=>({...r,clips:r.clips.filter(r=>r.id!==a)}))}export function addSubTrackKeyframe(r,t,a,n){let i=-1,p="transform";return{data:updateSubTrack(r,t,a,r=>{if(p=r.type,u(r)&&d(n)){const t=e([...r.events,n]);return i=t.findIndex(r=>r.id===n.id),{...r,events:t}}if(c(r)&&!d(n)){const t=e([...r.keyframes,n]);return i=t.findIndex(r=>r.id===n.id),{...r,keyframes:t}}return r}),ref:-1===i?void 0:{trackId:t,subTrackId:a,keyframeId:n.id,keyframeIndex:i,subTrackType:p,time:n.time}}}export function updateSubTrackKeyframe(r,t,a,n,i){let d;return{data:updateSubTrack(r,t,a,r=>{if(u(r)){const c=e(r.events.map(r=>r.id===n?i(r):r)),u=c.findIndex(r=>r.id===n);return u>=0&&(d={trackId:t,subTrackId:a,keyframeId:n,keyframeIndex:u,subTrackType:r.type,time:c[u].time}),{...r,events:c}}if(c(r)){const c=e(r.keyframes.map(r=>r.id===n?i(r):r)),u=c.findIndex(r=>r.id===n);return u>=0&&(d={trackId:t,subTrackId:a,keyframeId:n,keyframeIndex:u,subTrackType:r.type,time:c[u].time}),{...r,keyframes:c}}return r}),ref:d}}export function removeSubTrackKeyframe(r,e,t,a){return updateSubTrack(r,e,t,r=>u(r)?{...r,events:r.events.filter(r=>r.id!==a)}:c(r)?{...r,keyframes:r.keyframes.filter(r=>r.id!==a)}:r)}export function cloneTrackWithFreshIds(r){return t(JSON.parse(JSON.stringify(r)))}function t(e){return e.id=r(),e.subTracks=e.subTracks.map(a),"group"===e.type&&(e.childTracks=e.childTracks.map(r=>t(r))),i(e)&&(e.clips=e.clips.map(e=>({...e,id:r()}))),e}function a(e){return e.id=r(),"animation"===e.type?(e.clips=e.clips.map(e=>({...e,id:r()})),e):"event"===e.type?(e.events=e.events.map(e=>({...e,id:r()})),e):(c(e)&&(e.keyframes=e.keyframes.map(e=>({...e,id:r()}))),e)}function n(r,e,t,a){return updateSubTrack(r,e,t,r=>"animation"===r.type?a(r):r)}function i(r){return"audio"===r.type||"vfx"===r.type||"spawn"===r.type}function c(r){return"transform"===r.type||"property"===r.type||"audioParameter"===r.type||"material"===r.type||"visibility"===r.type}function u(r){return"event"===r.type}function d(r){return"arguments"in r}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/effects/sequence/sequence-player.d.ts

@@ -8,6 +8,7 @@ import { AssetLoader } from '../../gameplay/services/asset-loader.js';
 import { World } from '../../gameplay/services/world.js';
 import { PrefabInstance } from '../../scene/objects/prefab.js';
 import { SequenceData, SequenceRole, SequenceTrack } from './sequence-data.js';
+import { SequenceLocatorReader, SequenceLocatorSnapshot } from './sequence-locator.js';
 import { CharacterAnimationComponent } from '../../gameplay/actors/index.js';
 /**
  * Playback state of the sequence
@@ -79,13 +80,14 @@ export type SpawnedInstance = ({
  * SequencePlayer is the runtime system that plays a sequence.
  * It manages track bindings, playback state, and updates.
  */
-export declare class SequencePlayer {
+export declare class SequencePlayer implements SequenceLocatorReader {
     private _state;
     private _time;
     private _duration;
     private _timescale;
     private _loop;
     private _externalTimeControl;
+    private _inEditor;
     private bindings;
     private roleBindings;
     private sequenceData;
@@ -101,6 +103,7 @@ export declare class SequencePlayer {
     private loadingAudioBuffers;
     private animationClips;
     private loadingAnimationClips;
+    private retimedAnimationClips;
     private audioByClip;
     private activeAudioClips;
     private audioGainNodes;
@@ -116,10 +119,15 @@ export declare class SequencePlayer {
     private pendingSpawns;
     private vfxActors;
     private activeVfxClips;
+    private locatorMarkers;
     private clearCounter;
     private audioFilters;
     private audioPannerNodes;
     private firedEvents;
+    private readonly sequenceEventSyncResolvers;
+    private readonly sequenceEventAsyncResolvers;
+    private readonly trackRuntimeEvaluators;
+    private readonly subTrackRuntimeEvaluators;
     constructor();
     /**
      * Current playback state
@@ -150,6 +158,12 @@ export declare class SequencePlayer {
      */
     get externalTimeControl(): boolean;
     set externalTimeControl(value: boolean);
+    /**
+     * When true, editor-only sequence events are allowed to fire.
+     * Runtime gameplay should leave this as false.
+     */
+    get inEditor(): boolean;
+    set inEditor(value: boolean);
     /**
      * Set world dependency
      */
@@ -171,8 +185,11 @@ export declare class SequencePlayer {
      * Load sequence data and prepare for playback
      */
     load(data: SequenceData): void;
+    private preloadSequenceResources;
     private getAudioAssetIdsForSequence;
     private preloadAudioBuffersForSequence;
+    private getAnimationClipAssetIdsForSequence;
+    private preloadAnimationClipsForSequence;
     /**
      * Bind a role to a runtime target.
      * This allows tracks with a role to target a different actor at runtime.
@@ -186,10 +203,16 @@ export declare class SequencePlayer {
      * Bind a scene object by ID to a target
      */
     bindObject(objectId: string, target: Object3D | BaseActor): void;
+    getLocator(bindingId: string): SequenceLocatorSnapshot | null;
+    getLocators(bindingId: string): SequenceLocatorSnapshot[];
     /**
      * Resolve all track bindings based on current proxy bindings and scene references
      */
     private resolveBindings;
+    private initializeLocatorBindings;
+    private clearLocatorBindings;
+    private updateLocatorMarkerVisibility;
+    private disableLocatorInteraction;
     private resolveTrackBinding;
     private createBinding;
     /**
@@ -225,11 +248,13 @@ export declare class SequencePlayer {
     private evaluate;
     private evaluateTrack;
     private evaluateObjectTrack;
+    private evaluateLocatorTrack;
     private evaluateSubTracks;
     private evaluateTransformSubTrack;
     private evaluateAnimationSubTrack;
     private evaluateVisibilitySubTrack;
     private evaluatePropertySubTrack;
+    private evaluateParameterSubTrack;
     private evaluateEventSubTrack;
     private evaluateCameraTrack;
     private evaluateAudioTrack;
@@ -300,9 +325,14 @@ export declare class SequencePlayer {
      * Spawn for clip (async wrapper)
      */
     private spawnForClip;
-    private findKeyframes;
-    private applyInterpolation;
+    private getPlayableObject;
+    private applyResolvedPropertyValue;
+    private applyResolvedMaterialValue;
     private ensureAnimationClip;
+    private prepareAnimationPlayback;
+    private getPlayableAnimationClip;
+    private getAnimationPlaybackLocalTime;
+    private clearRetimedAnimationClipCache;
     private captureOriginalTransforms;
     private restoreOriginalTransforms;
     private stopAllAnimations;
@@ -322,5 +352,9 @@ export declare class SequencePlayer {
     private evaluateAudioSubTracks;
     private stringToRandom;
     refreshAsset(assetId: string): void;
+    private invokeSequenceEvent;
+    private resolveSequenceEventActorReference;
+    private resolveSequenceEventSequence;
+    private resolveSequenceEventAnimationClip;
 }
 //# sourceMappingURL=sequence-player.d.ts.map