@webspatial/core-sdk 1.6.1 → 2.0.0

package/dist/motion/AnimationObject.js

@@ -0,0 +1,140 @@
+import {
+  ControlSpatializedElementAnimationJSBCommand,
+  CreateSpatializedElementAnimationJSBCommand
+} from "../JSBCommand";
+import { SpatialObject } from "../SpatialObject";
+import { SpatialWebEvent } from "../SpatialWebEvent";
+class AnimationObject extends SpatialObject {
+  elementId;
+  timeline;
+  callbacks = {};
+  _playState = "idle";
+  _finished = false;
+  started = false;
+  constructor(id, options) {
+    super(id);
+    this.elementId = options.elementId;
+    this.timeline = options.timeline;
+    SpatialWebEvent.addEventReceiver(id, (data) => this.onReceiveEvent(data));
+  }
+  static async create(options) {
+    const ret = await new CreateSpatializedElementAnimationJSBCommand({
+      elementId: options.elementId,
+      timeline: options.timeline
+    }).execute();
+    if (!ret.success) {
+      throw new Error(
+        ret.errorMessage ?? "CreateSpatializedElementAnimation command failed"
+      );
+    }
+    const data = ret.data;
+    const id = data?.id;
+    if (!id) {
+      throw new Error("CreateSpatializedElementAnimation did not return an id");
+    }
+    return new AnimationObject(id, options);
+  }
+  setCallbacks(callbacks) {
+    this.callbacks = callbacks;
+  }
+  get playState() {
+    return this._playState;
+  }
+  get isAnimating() {
+    return this._playState === "running" || this._playState === "queued";
+  }
+  get isPaused() {
+    return this._playState === "paused";
+  }
+  get finished() {
+    return this._finished;
+  }
+  play() {
+    return this.control("play");
+  }
+  pause() {
+    return this.control("pause");
+  }
+  stop() {
+    return this.control("stop");
+  }
+  reset() {
+    return this.control("reset");
+  }
+  finish() {
+    return this.control("finish");
+  }
+  onDestroy() {
+    SpatialWebEvent.removeEventReceiver(this.id);
+  }
+  async control(type) {
+    if (this.isDestroyed) return;
+    const ret = await new ControlSpatializedElementAnimationJSBCommand({
+      animationId: this.id,
+      type
+    }).execute();
+    if (!ret.success) {
+      throw new Error(
+        ret.errorMessage ?? `ControlSpatializedElementAnimation(${type}) command failed`
+      );
+    }
+  }
+  onReceiveEvent(data) {
+    const detail = data?.detail ?? data;
+    if (!this.isSpatialAnimationStateChangedDetail(detail)) return;
+    if (detail.animationId !== this.id) return;
+    this._playState = detail.playState;
+    this._finished = detail.finished;
+    if (detail.values) {
+      this.callbacks.onValuesChange?.(detail.values);
+    }
+    if (detail.action !== "start") {
+      this.callbacks.onStateChange?.();
+    }
+    if (detail.error) {
+      this.started = false;
+      this.callbacks.onError?.({
+        command: "play",
+        code: detail.error.code,
+        reason: detail.error.message
+      });
+      return;
+    }
+    if (detail.action === "start") {
+      if (!this.started) {
+        this.started = true;
+        this.callbacks.onStart?.();
+      }
+      return;
+    }
+    if (detail.action === "complete" || detail.action === "finish") {
+      this.started = false;
+      this.callbacks.onComplete?.(detail.values ?? {});
+      return;
+    }
+    if (detail.action === "stop") {
+      this.started = false;
+      this.callbacks.onStop?.(detail.values ?? {});
+      return;
+    }
+    if (detail.action === "reset") {
+      this.started = false;
+      this.callbacks.onReset?.(detail.values ?? {});
+      return;
+    }
+    if (detail.action === "destroy") {
+      this.started = false;
+      this.isDestroyed = true;
+      this.onDestroy();
+    }
+  }
+  isSpatialAnimationStateChangedDetail(detail) {
+    if (!detail || typeof detail !== "object") return false;
+    const candidate = detail;
+    return typeof candidate.animationId === "string" && typeof candidate.action === "string" && typeof candidate.playState === "string" && typeof candidate.finished === "boolean";
+  }
+}
+export {
+  AnimationObject
+};
+//# sourceMappingURL=AnimationObject.js.map

package/dist/motion/AnimationObject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/motion/AnimationObject.ts"],"sourcesContent":["import {\n  ControlSpatializedElementAnimationJSBCommand,\n  CreateSpatializedElementAnimationJSBCommand,\n} from '../JSBCommand'\nimport { SpatialObject } from '../SpatialObject'\nimport { SpatialWebEvent } from '../SpatialWebEvent'\nimport type {\n  ControlSpatializedElementAnimationCommand,\n  SpatialAnimationStateChangedDetail,\n  SpatialAnimationStateChangedMsg,\n} from '../types/motion/spatializedElementMotion'\nimport type { SpatializedPlaybackError } from '../types/motion/spatializedPlayback'\nimport type { SpatializedVisualValues } from '../types/motion/spatializedVisual'\nimport type {\n  SpatializedMotionTimeline,\n  SpatializedPlaybackApi,\n  SpatializedMotionPlayState,\n} from '../types/motion/spatializedMotion'\n\nexport interface AnimationObjectCreateOptions {\n  elementId: string\n  timeline: SpatializedMotionTimeline\n}\n\nexport interface AnimationObjectCallbacks {\n  onStart?: () => void\n  onComplete?: (values: SpatializedVisualValues) => void\n  onStop?: (values: SpatializedVisualValues) => void\n  onReset?: (values: SpatializedVisualValues) => void\n  onError?: (error: SpatializedPlaybackError) => void\n  onValuesChange?: (values: SpatializedVisualValues) => void\n  onStateChange?: () => void\n}\n\nexport class AnimationObject\n  extends SpatialObject\n  implements SpatializedPlaybackApi\n{\n  readonly elementId: string\n  readonly timeline: SpatializedMotionTimeline\n\n  private callbacks: AnimationObjectCallbacks = {}\n  private _playState: SpatializedMotionPlayState = 'idle'\n  private _finished = false\n  private started = false\n\n  constructor(id: string, options: AnimationObjectCreateOptions) {\n    super(id)\n    this.elementId = options.elementId\n    this.timeline = options.timeline\n\n    SpatialWebEvent.addEventReceiver(id, data => this.onReceiveEvent(data))\n  }\n\n  static async create(options: AnimationObjectCreateOptions) {\n    const ret = await new CreateSpatializedElementAnimationJSBCommand({\n      elementId: options.elementId,\n      timeline: options.timeline,\n    }).execute()\n    if (!ret.success) {\n      throw new Error(\n        ret.errorMessage ?? 'CreateSpatializedElementAnimation command failed',\n      )\n    }\n\n    const data = ret.data as { id?: string } | undefined\n    const id = data?.id\n    if (!id) {\n      throw new Error('CreateSpatializedElementAnimation did not return an id')\n    }\n\n    return new AnimationObject(id, options)\n  }\n\n  setCallbacks(callbacks: AnimationObjectCallbacks): void {\n    this.callbacks = callbacks\n  }\n\n  get playState() {\n    return this._playState\n  }\n\n  get isAnimating() {\n    return this._playState === 'running' || this._playState === 'queued'\n  }\n\n  get isPaused() {\n    return this._playState === 'paused'\n  }\n\n  get finished() {\n    return this._finished\n  }\n\n  play(): Promise<void> {\n    return this.control('play')\n  }\n\n  pause(): Promise<void> {\n    return this.control('pause')\n  }\n\n  stop(): Promise<void> {\n    return this.control('stop')\n  }\n\n  reset(): Promise<void> {\n    return this.control('reset')\n  }\n\n  finish(): Promise<void> {\n    return this.control('finish')\n  }\n\n  protected override onDestroy(): void {\n    SpatialWebEvent.removeEventReceiver(this.id)\n  }\n\n  private async control(\n    type: ControlSpatializedElementAnimationCommand['type'],\n  ): Promise<void> {\n    if (this.isDestroyed) return\n\n    const ret = await new ControlSpatializedElementAnimationJSBCommand({\n      animationId: this.id,\n      type,\n    }).execute()\n\n    if (!ret.success) {\n      throw new Error(\n        ret.errorMessage ??\n          `ControlSpatializedElementAnimation(${type}) command failed`,\n      )\n    }\n  }\n\n  onReceiveEvent(data: SpatialAnimationStateChangedMsg | { detail?: unknown }) {\n    const detail = data?.detail ?? data\n    if (!this.isSpatialAnimationStateChangedDetail(detail)) return\n    if (detail.animationId !== this.id) return\n\n    this._playState = detail.playState\n    this._finished = detail.finished\n\n    if (detail.values) {\n      this.callbacks.onValuesChange?.(detail.values)\n    }\n    if (detail.action !== 'start') {\n      this.callbacks.onStateChange?.()\n    }\n\n    if (detail.error) {\n      this.started = false\n      // Native currently emits asynchronous errors only when play cannot acquire the ownership mask.\n      this.callbacks.onError?.({\n        command: 'play',\n        code: detail.error.code,\n        reason: detail.error.message,\n      })\n      return\n    }\n\n    if (detail.action === 'start') {\n      if (!this.started) {\n        this.started = true\n        this.callbacks.onStart?.()\n      }\n      return\n    }\n\n    if (detail.action === 'complete' || detail.action === 'finish') {\n      this.started = false\n      this.callbacks.onComplete?.(detail.values ?? {})\n      return\n    }\n\n    if (detail.action === 'stop') {\n      this.started = false\n      this.callbacks.onStop?.(detail.values ?? {})\n      return\n    }\n\n    if (detail.action === 'reset') {\n      this.started = false\n      this.callbacks.onReset?.(detail.values ?? {})\n      return\n    }\n\n    if (detail.action === 'destroy') {\n      this.started = false\n      this.isDestroyed = true\n      this.onDestroy()\n    }\n  }\n\n  private isSpatialAnimationStateChangedDetail(\n    detail: unknown,\n  ): detail is SpatialAnimationStateChangedDetail {\n    if (!detail || typeof detail !== 'object') return false\n    const candidate = detail as Partial<SpatialAnimationStateChangedDetail>\n    return (\n      typeof candidate.animationId === 'string' &&\n      typeof candidate.action === 'string' &&\n      typeof candidate.playState === 'string' &&\n      typeof candidate.finished === 'boolean'\n    )\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/motion/compute/index.d.ts

@@ -0,0 +1,10 @@
+export { setMotionPropertyValue } from './motionPropertyValues.js';
+export { validateNormalizedMotionConfig, validateSpatializedMotionConfig } from './validate.js';
+export { desugarTimelineConfig, normalizeMotionConfig, segmentConfigToMotionConfig } from './normalize.js';
+import '../../types/motion/spatializedVisual.js';
+import '../../spatializedElementMotion-_0XWPQCE.js';
+import '../../types/motion/spatializedPlayback.js';
+import '../../types/global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';

package/dist/motion/compute/index.js

@@ -0,0 +1,19 @@
+import { setMotionPropertyValue } from "./motionPropertyValues";
+import {
+  validateNormalizedMotionConfig,
+  validateSpatializedMotionConfig
+} from "./validate";
+import {
+  desugarTimelineConfig,
+  normalizeMotionConfig,
+  segmentConfigToMotionConfig
+} from "./normalize";
+export {
+  desugarTimelineConfig,
+  normalizeMotionConfig,
+  segmentConfigToMotionConfig,
+  setMotionPropertyValue,
+  validateNormalizedMotionConfig,
+  validateSpatializedMotionConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/motion/compute/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/motion/compute/index.ts"],"sourcesContent":["export { setMotionPropertyValue } from './motionPropertyValues'\nexport {\n  validateNormalizedMotionConfig,\n  validateSpatializedMotionConfig,\n} from './validate'\nexport {\n  desugarTimelineConfig,\n  normalizeMotionConfig,\n  segmentConfigToMotionConfig,\n} from './normalize'\n"],"mappings":"AAAA,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/motion/compute/motionPropertyValues.d.ts

@@ -0,0 +1,19 @@
+import { SpatializedVisualValues } from '../../types/motion/spatializedVisual.js';
+import { a_ as SpatializedMotionProperty } from '../../spatializedElementMotion-_0XWPQCE.js';
+import '../../types/motion/spatializedPlayback.js';
+import '../../types/global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';
+
+/**
+ * Writes a sampled numeric track value into the corresponding
+ * SpatializedVisualValues field.
+ *
+ * @param visualValues Visual value object being populated for the sampled time.
+ * @param motionProperty Motion property path for the sampled track.
+ * @param sampledValue Numeric value sampled from the track at the current time.
+ */
+declare function setMotionPropertyValue(visualValues: SpatializedVisualValues, motionProperty: SpatializedMotionProperty, sampledValue: number): void;
+
+export { setMotionPropertyValue };

package/dist/motion/compute/motionPropertyValues.js

@@ -0,0 +1,50 @@
+function getTranslate(visualValues) {
+  const transform = visualValues.transform ??= {};
+  return transform.translate ??= {};
+}
+function getRotate(visualValues) {
+  const transform = visualValues.transform ??= {};
+  return transform.rotate ??= {};
+}
+function getScale(visualValues) {
+  const transform = visualValues.transform ??= {};
+  return transform.scale ??= {};
+}
+function setMotionPropertyValue(visualValues, motionProperty, sampledValue) {
+  switch (motionProperty) {
+    case "opacity":
+      visualValues.opacity = sampledValue;
+      return;
+    case "transform.translate.x":
+      getTranslate(visualValues).x = sampledValue;
+      return;
+    case "transform.translate.y":
+      getTranslate(visualValues).y = sampledValue;
+      return;
+    case "transform.translate.z":
+      getTranslate(visualValues).z = sampledValue;
+      return;
+    case "transform.rotate.x":
+      getRotate(visualValues).x = sampledValue;
+      return;
+    case "transform.rotate.y":
+      getRotate(visualValues).y = sampledValue;
+      return;
+    case "transform.rotate.z":
+      getRotate(visualValues).z = sampledValue;
+      return;
+    case "transform.scale.x":
+      getScale(visualValues).x = sampledValue;
+      return;
+    case "transform.scale.y":
+      getScale(visualValues).y = sampledValue;
+      return;
+    case "transform.scale.z":
+      getScale(visualValues).z = sampledValue;
+      return;
+  }
+}
+export {
+  setMotionPropertyValue
+};
+//# sourceMappingURL=motionPropertyValues.js.map

package/dist/motion/compute/motionPropertyValues.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/motion/compute/motionPropertyValues.ts"],"sourcesContent":["import type { SpatializedVisualValues } from '../../types/motion/spatializedVisual'\nimport type { SpatializedMotionProperty } from '../../types/motion/spatializedMotion'\n\nfunction getTranslate(\n  visualValues: SpatializedVisualValues,\n): NonNullable<NonNullable<SpatializedVisualValues['transform']>['translate']> {\n  const transform = (visualValues.transform ??= {})\n  return (transform.translate ??= {})\n}\n\nfunction getRotate(\n  visualValues: SpatializedVisualValues,\n): NonNullable<NonNullable<SpatializedVisualValues['transform']>['rotate']> {\n  const transform = (visualValues.transform ??= {})\n  return (transform.rotate ??= {})\n}\n\nfunction getScale(\n  visualValues: SpatializedVisualValues,\n): NonNullable<NonNullable<SpatializedVisualValues['transform']>['scale']> {\n  const transform = (visualValues.transform ??= {})\n  return (transform.scale ??= {})\n}\n\n/**\n * Writes a sampled numeric track value into the corresponding\n * SpatializedVisualValues field.\n *\n * @param visualValues Visual value object being populated for the sampled time.\n * @param motionProperty Motion property path for the sampled track.\n * @param sampledValue Numeric value sampled from the track at the current time.\n */\nexport function setMotionPropertyValue(\n  visualValues: SpatializedVisualValues,\n  motionProperty: SpatializedMotionProperty,\n  sampledValue: number,\n): void {\n  switch (motionProperty) {\n    case 'opacity':\n      visualValues.opacity = sampledValue\n      return\n    case 'transform.translate.x':\n      getTranslate(visualValues).x = sampledValue\n      return\n    case 'transform.translate.y':\n      getTranslate(visualValues).y = sampledValue\n      return\n    case 'transform.translate.z':\n      getTranslate(visualValues).z = sampledValue\n      return\n    case 'transform.rotate.x':\n      getRotate(visualValues).x = sampledValue\n      return\n    case 'transform.rotate.y':\n      getRotate(visualValues).y = sampledValue\n      return\n    case 'transform.rotate.z':\n      getRotate(visualValues).z = sampledValue\n      return\n    case 'transform.scale.x':\n      getScale(visualValues).x = sampledValue\n      return\n    case 'transform.scale.y':\n      getScale(visualValues).y = sampledValue\n      return\n    case 'transform.scale.z':\n      getScale(visualValues).z = sampledValue\n      return\n  }\n}\n"],"mappings":"AAGA,SAAS,aACP,cAC6E;AAC7E,QAAM,YAAa,aAAa,cAAc,CAAC;AAC/C,SAAQ,UAAU,cAAc,CAAC;AACnC;AAEA,SAAS,UACP,cAC0E;AAC1E,QAAM,YAAa,aAAa,cAAc,CAAC;AAC/C,SAAQ,UAAU,WAAW,CAAC;AAChC;AAEA,SAAS,SACP,cACyE;AACzE,QAAM,YAAa,aAAa,cAAc,CAAC;AAC/C,SAAQ,UAAU,UAAU,CAAC;AAC/B;AAUO,SAAS,uBACd,cACA,gBACA,cACM;AACN,UAAQ,gBAAgB;AAAA,IACtB,KAAK;AACH,mBAAa,UAAU;AACvB;AAAA,IACF,KAAK;AACH,mBAAa,YAAY,EAAE,IAAI;AAC/B;AAAA,IACF,KAAK;AACH,mBAAa,YAAY,EAAE,IAAI;AAC/B;AAAA,IACF,KAAK;AACH,mBAAa,YAAY,EAAE,IAAI;AAC/B;AAAA,IACF,KAAK;AACH,gBAAU,YAAY,EAAE,IAAI;AAC5B;AAAA,IACF,KAAK;AACH,gBAAU,YAAY,EAAE,IAAI;AAC5B;AAAA,IACF,KAAK;AACH,gBAAU,YAAY,EAAE,IAAI;AAC5B;AAAA,IACF,KAAK;AACH,eAAS,YAAY,EAAE,IAAI;AAC3B;AAAA,IACF,KAAK;AACH,eAAS,YAAY,EAAE,IAAI;AAC3B;AAAA,IACF,KAAK;AACH,eAAS,YAAY,EAAE,IAAI;AAC3B;AAAA,EACJ;AACF;","names":[]}

package/dist/motion/compute/normalize.d.ts

@@ -0,0 +1,31 @@
+import { an as SpatializedMotionTimelineConfig, a$ as NormalizedSpatializedMotionConfig, aj as SpatializedMotionConfig, am as SpatializedMotionSegmentConfig } from '../../spatializedElementMotion-_0XWPQCE.js';
+import '../../types/motion/spatializedVisual.js';
+import '../../types/motion/spatializedPlayback.js';
+import '../../types/global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';
+
+/**
+ * Desugars shorthand from/to motion config into canonical tracks.
+ *
+ * @param simple Shorthand segment config.
+ * @returns Canonical track-based motion config.
+ */
+declare function segmentConfigToMotionConfig(simple: SpatializedMotionSegmentConfig): NormalizedSpatializedMotionConfig;
+/**
+ * Desugars percentage-key timeline config into canonical tracks.
+ *
+ * @param config Timeline config using percentage keys.
+ * @returns Canonical track-based motion config.
+ */
+declare function desugarTimelineConfig(config: SpatializedMotionTimelineConfig): NormalizedSpatializedMotionConfig;
+/**
+ * Normalizes any supported motion config shape into canonical tracks.
+ *
+ * @param config Motion config in shorthand, timeline, or canonical form.
+ * @returns Canonical track-based motion config.
+ */
+declare function normalizeMotionConfig(config: SpatializedMotionConfig): NormalizedSpatializedMotionConfig;
+
+export { desugarTimelineConfig, normalizeMotionConfig, segmentConfigToMotionConfig };

package/dist/motion/compute/normalize.js

@@ -0,0 +1,201 @@
+function collectScalars(values, out) {
+  if (values.opacity !== void 0) {
+    out.push({ property: "opacity", value: values.opacity });
+  }
+  const tr = values.transform;
+  if (!tr) return;
+  for (const group of ["translate", "rotate", "scale"]) {
+    const part = tr[group];
+    if (!part) continue;
+    for (const axis of ["x", "y", "z"]) {
+      const v = part[axis];
+      if (v !== void 0) {
+        out.push({
+          property: `transform.${group}.${axis}`,
+          value: v
+        });
+      }
+    }
+  }
+}
+function parsePercentageKey(key) {
+  if (!/^\d+(\.\d+)?%$/.test(key)) {
+    throw new Error(`[SpatializedMotion] invalid timeline key "${key}"`);
+  }
+  const ratio = Number(key.slice(0, -1));
+  if (!Number.isFinite(ratio) || ratio < 0 || ratio > 100) {
+    throw new Error(`[SpatializedMotion] invalid timeline key "${key}"`);
+  }
+  return ratio / 100;
+}
+function segmentConfigToMotionConfig(simple) {
+  if (!simple.from || !simple.to) {
+    throw new Error(
+      "[SpatializedMotion] top-level from and to are both required"
+    );
+  }
+  const duration = simple.duration ?? 0.3;
+  const fromScalars = [];
+  const toScalars = [];
+  collectScalars(simple.from, fromScalars);
+  collectScalars(simple.to, toScalars);
+  const trackMap = /* @__PURE__ */ new Map();
+  const properties = /* @__PURE__ */ new Set([
+    ...fromScalars.map((entry) => entry.property),
+    ...toScalars.map((entry) => entry.property)
+  ]);
+  for (const property of properties) {
+    const fromEntry = fromScalars.find((f) => f.property === property);
+    const toEntry = toScalars.find((f) => f.property === property);
+    if (!fromEntry) {
+      throw new Error(
+        `[SpatializedMotion] missing start boundary for "${property}"`
+      );
+    }
+    if (!toEntry) {
+      throw new Error(
+        `[SpatializedMotion] missing end boundary for "${property}"`
+      );
+    }
+    trackMap.set(property, {
+      property,
+      timingFunction: simple.timingFunction,
+      keyframes: [
+        { at: 0, value: fromEntry.value },
+        { at: duration, value: toEntry.value }
+      ]
+    });
+  }
+  const tracks = [...trackMap.values()];
+  if (tracks.length === 0) {
+    throw new Error(
+      "[SpatializedMotion.simple] to must include at least one animatable field"
+    );
+  }
+  return {
+    duration,
+    tracks,
+    timingFunction: simple.timingFunction,
+    delay: simple.delay,
+    autoStart: simple.autoStart,
+    loop: simple.loop,
+    playbackRate: simple.playbackRate,
+    onStart: simple.onStart,
+    onComplete: simple.onComplete,
+    onStop: simple.onStop,
+    onReset: simple.onReset,
+    onError: simple.onError
+  };
+}
+function desugarTimelineConfig(config) {
+  if (Array.isArray(config.timeline) || !config.timeline) {
+    throw new Error("[SpatializedMotion] timeline must be an object");
+  }
+  const entries = Object.entries(config.timeline);
+  let hasPercentageKey = false;
+  const frames = entries.map(([key, values]) => {
+    if (!values || typeof values !== "object" || Array.isArray(values)) {
+      throw new Error(`[SpatializedMotion] invalid timeline frame "${key}"`);
+    }
+    if (key === "from") return { key, atRatio: 0, values };
+    if (key === "to") return { key, atRatio: 1, values };
+    hasPercentageKey = true;
+    return { key, atRatio: parsePercentageKey(key), values };
+  }).sort((a, b) => a.atRatio - b.atRatio);
+  if (config.from !== void 0 || config.to !== void 0) {
+    console.warn(
+      "[SpatializedMotion] top-level from/to are ignored because timeline is present"
+    );
+  }
+  const hasStartFrame = frames.some((frame) => frame.atRatio === 0);
+  const hasEndFrame = frames.some((frame) => frame.atRatio === 1);
+  if (!hasStartFrame) {
+    throw new Error(
+      "[SpatializedMotion] timeline must define a start frame (from or 0%)"
+    );
+  }
+  if (!hasEndFrame) {
+    throw new Error(
+      "[SpatializedMotion] timeline must define an end frame (to or 100%)"
+    );
+  }
+  if (hasPercentageKey && config.duration === void 0) {
+    throw new Error(
+      "[SpatializedMotion] duration is required when timeline uses percentage keys"
+    );
+  }
+  const duration = config.duration ?? 0.3;
+  const trackMap = /* @__PURE__ */ new Map();
+  const fromProperties = /* @__PURE__ */ new Set();
+  const zeroProperties = /* @__PURE__ */ new Set();
+  const toProperties = /* @__PURE__ */ new Set();
+  const hundredProperties = /* @__PURE__ */ new Set();
+  for (const frame of frames) {
+    const at = frame.atRatio * duration;
+    const scalars = [];
+    collectScalars(frame.values, scalars);
+    for (const scalar of scalars) {
+      if (frame.key === "from") fromProperties.add(scalar.property);
+      if (frame.key !== "from" && frame.atRatio === 0) {
+        zeroProperties.add(scalar.property);
+      }
+      if (frame.key === "to") toProperties.add(scalar.property);
+      if (frame.key !== "to" && frame.atRatio === 1) {
+        hundredProperties.add(scalar.property);
+      }
+      const keyframes = trackMap.get(scalar.property) ?? [];
+      const keyframe = {
+        at,
+        value: scalar.value,
+        ...frame.values.timingFunction !== void 0 ? { timingFunction: frame.values.timingFunction } : {}
+      };
+      keyframes.push(keyframe);
+      trackMap.set(scalar.property, keyframes);
+    }
+  }
+  const tracks = [...trackMap.entries()].map(([property, keyframes]) => {
+    const startCount = Number(fromProperties.has(property)) + Number(zeroProperties.has(property));
+    const endCount = Number(toProperties.has(property)) + Number(hundredProperties.has(property));
+    if (startCount > 1) {
+      throw new Error(
+        `[SpatializedMotion] duplicate start boundary for "${property}"`
+      );
+    }
+    if (endCount > 1) {
+      throw new Error(
+        `[SpatializedMotion] duplicate end boundary for "${property}"`
+      );
+    }
+    return {
+      property,
+      timingFunction: config.timingFunction,
+      keyframes
+    };
+  });
+  return {
+    duration,
+    tracks,
+    timingFunction: config.timingFunction,
+    delay: config.delay,
+    autoStart: config.autoStart,
+    loop: config.loop,
+    playbackRate: config.playbackRate,
+    onStart: config.onStart,
+    onComplete: config.onComplete,
+    onStop: config.onStop,
+    onReset: config.onReset,
+    onError: config.onError
+  };
+}
+function normalizeMotionConfig(config) {
+  if (config.timeline !== void 0) {
+    return desugarTimelineConfig(config);
+  }
+  return segmentConfigToMotionConfig(config);
+}
+export {
+  desugarTimelineConfig,
+  normalizeMotionConfig,
+  segmentConfigToMotionConfig
+};
+//# sourceMappingURL=normalize.js.map

package/dist/motion/compute/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/motion/compute/normalize.ts"],"sourcesContent":["import type { SpatializedVisualValues } from '../../types/motion/spatializedVisual'\nimport type { TimingFunction } from '../../types/animation'\nimport type {\n  NormalizedSpatializedMotionConfig,\n  SpatializedMotionConfig,\n  SpatializedMotionProperty,\n  SpatializedMotionSegmentConfig,\n  SpatializedMotionTrack,\n  SpatializedMotionTimelineConfig,\n} from '../../types/motion/spatializedMotion'\n\n/**\n * Flattens visual values into motion-property/value pairs.\n *\n * @param values Visual values to inspect.\n * @param out Collector for discovered motion property samples.\n */\nfunction collectScalars(\n  values: SpatializedVisualValues,\n  out: Array<{ property: SpatializedMotionProperty; value: number }>,\n): void {\n  if (values.opacity !== undefined) {\n    out.push({ property: 'opacity', value: values.opacity })\n  }\n  const tr = values.transform\n  if (!tr) return\n  for (const group of ['translate', 'rotate', 'scale'] as const) {\n    const part = tr[group]\n    if (!part) continue\n    for (const axis of ['x', 'y', 'z'] as const) {\n      const v = part[axis]\n      if (v !== undefined) {\n        out.push({\n          property: `transform.${group}.${axis}` as SpatializedMotionProperty,\n          value: v,\n        })\n      }\n    }\n  }\n}\n\n/**\n * Converts `0%`-style timeline keys into [0, 1] ratios.\n *\n * @param key Percentage key from the timeline config.\n * @returns The normalized ratio represented by the key.\n */\nfunction parsePercentageKey(key: string): number {\n  if (!/^\\d+(\\.\\d+)?%$/.test(key)) {\n    throw new Error(`[SpatializedMotion] invalid timeline key \"${key}\"`)\n  }\n  const ratio = Number(key.slice(0, -1))\n  if (!Number.isFinite(ratio) || ratio < 0 || ratio > 100) {\n    throw new Error(`[SpatializedMotion] invalid timeline key \"${key}\"`)\n  }\n  return ratio / 100\n}\n\n/**\n * Desugars shorthand from/to motion config into canonical tracks.\n *\n * @param simple Shorthand segment config.\n * @returns Canonical track-based motion config.\n */\nexport function segmentConfigToMotionConfig(\n  simple: SpatializedMotionSegmentConfig,\n): NormalizedSpatializedMotionConfig {\n  if (!simple.from || !simple.to) {\n    throw new Error(\n      '[SpatializedMotion] top-level from and to are both required',\n    )\n  }\n  const duration = simple.duration ?? 0.3\n  const fromScalars: Array<{\n    property: SpatializedMotionProperty\n    value: number\n  }> = []\n  const toScalars: Array<{\n    property: SpatializedMotionProperty\n    value: number\n  }> = []\n\n  collectScalars(simple.from, fromScalars)\n  collectScalars(simple.to, toScalars)\n\n  const trackMap = new Map<SpatializedMotionProperty, SpatializedMotionTrack>()\n  const properties = new Set([\n    ...fromScalars.map(entry => entry.property),\n    ...toScalars.map(entry => entry.property),\n  ])\n\n  for (const property of properties) {\n    const fromEntry = fromScalars.find(f => f.property === property)\n    const toEntry = toScalars.find(f => f.property === property)\n    if (!fromEntry) {\n      throw new Error(\n        `[SpatializedMotion] missing start boundary for \"${property}\"`,\n      )\n    }\n    if (!toEntry) {\n      throw new Error(\n        `[SpatializedMotion] missing end boundary for \"${property}\"`,\n      )\n    }\n    trackMap.set(property, {\n      property,\n      timingFunction: simple.timingFunction,\n      keyframes: [\n        { at: 0, value: fromEntry.value },\n        { at: duration, value: toEntry.value },\n      ],\n    })\n  }\n\n  const tracks = [...trackMap.values()]\n  if (tracks.length === 0) {\n    throw new Error(\n      '[SpatializedMotion.simple] to must include at least one animatable field',\n    )\n  }\n\n  return {\n    duration,\n    tracks,\n    timingFunction: simple.timingFunction,\n    delay: simple.delay,\n    autoStart: simple.autoStart,\n    loop: simple.loop,\n    playbackRate: simple.playbackRate,\n    onStart: simple.onStart,\n    onComplete: simple.onComplete,\n    onStop: simple.onStop,\n    onReset: simple.onReset,\n    onError: simple.onError,\n  }\n}\n\n/**\n * Desugars percentage-key timeline config into canonical tracks.\n *\n * @param config Timeline config using percentage keys.\n * @returns Canonical track-based motion config.\n */\nexport function desugarTimelineConfig(\n  config: SpatializedMotionTimelineConfig,\n): NormalizedSpatializedMotionConfig {\n  if (Array.isArray(config.timeline) || !config.timeline) {\n    throw new Error('[SpatializedMotion] timeline must be an object')\n  }\n\n  const entries = Object.entries(config.timeline)\n  let hasPercentageKey = false\n  const frames = entries\n    .map(([key, values]) => {\n      if (!values || typeof values !== 'object' || Array.isArray(values)) {\n        throw new Error(`[SpatializedMotion] invalid timeline frame \"${key}\"`)\n      }\n      if (key === 'from') return { key, atRatio: 0, values }\n      if (key === 'to') return { key, atRatio: 1, values }\n      hasPercentageKey = true\n      return { key, atRatio: parsePercentageKey(key), values }\n    })\n    .sort((a, b) => a.atRatio - b.atRatio)\n\n  // Dev warn: top-level from/to are ignored once a timeline is present.\n  if (config.from !== undefined || config.to !== undefined) {\n    console.warn(\n      '[SpatializedMotion] top-level from/to are ignored because timeline is present',\n    )\n  }\n\n  // Start/end boundary frames are required; this change does not fill missing\n  // boundaries from underlying element style.\n  const hasStartFrame = frames.some(frame => frame.atRatio === 0)\n  const hasEndFrame = frames.some(frame => frame.atRatio === 1)\n  if (!hasStartFrame) {\n    throw new Error(\n      '[SpatializedMotion] timeline must define a start frame (from or 0%)',\n    )\n  }\n  if (!hasEndFrame) {\n    throw new Error(\n      '[SpatializedMotion] timeline must define an end frame (to or 100%)',\n    )\n  }\n\n  if (hasPercentageKey && config.duration === undefined) {\n    throw new Error(\n      '[SpatializedMotion] duration is required when timeline uses percentage keys',\n    )\n  }\n  const duration = config.duration ?? 0.3\n\n  const trackMap = new Map<\n    SpatializedMotionProperty,\n    Array<{\n      at: number\n      value: number\n      timingFunction?: TimingFunction\n    }>\n  >()\n  const fromProperties = new Set<SpatializedMotionProperty>()\n  const zeroProperties = new Set<SpatializedMotionProperty>()\n  const toProperties = new Set<SpatializedMotionProperty>()\n  const hundredProperties = new Set<SpatializedMotionProperty>()\n\n  for (const frame of frames) {\n    const at = frame.atRatio * duration\n    const scalars: Array<{\n      property: SpatializedMotionProperty\n      value: number\n    }> = []\n    collectScalars(frame.values, scalars)\n    for (const scalar of scalars) {\n      if (frame.key === 'from') fromProperties.add(scalar.property)\n      if (frame.key !== 'from' && frame.atRatio === 0) {\n        zeroProperties.add(scalar.property)\n      }\n      if (frame.key === 'to') toProperties.add(scalar.property)\n      if (frame.key !== 'to' && frame.atRatio === 1) {\n        hundredProperties.add(scalar.property)\n      }\n      const keyframes = trackMap.get(scalar.property) ?? []\n      const keyframe = {\n        at,\n        value: scalar.value,\n        ...(frame.values.timingFunction !== undefined\n          ? { timingFunction: frame.values.timingFunction }\n          : {}),\n      }\n      keyframes.push(keyframe)\n      trackMap.set(scalar.property, keyframes)\n    }\n  }\n\n  const tracks = [...trackMap.entries()].map(([property, keyframes]) => {\n    const startCount =\n      Number(fromProperties.has(property)) +\n      Number(zeroProperties.has(property))\n    const endCount =\n      Number(toProperties.has(property)) +\n      Number(hundredProperties.has(property))\n    if (startCount > 1) {\n      throw new Error(\n        `[SpatializedMotion] duplicate start boundary for \"${property}\"`,\n      )\n    }\n    if (endCount > 1) {\n      throw new Error(\n        `[SpatializedMotion] duplicate end boundary for \"${property}\"`,\n      )\n    }\n    return {\n      property,\n      timingFunction: config.timingFunction,\n      keyframes,\n    }\n  })\n\n  return {\n    duration,\n    tracks,\n    timingFunction: config.timingFunction,\n    delay: config.delay,\n    autoStart: config.autoStart,\n    loop: config.loop,\n    playbackRate: config.playbackRate,\n    onStart: config.onStart,\n    onComplete: config.onComplete,\n    onStop: config.onStop,\n    onReset: config.onReset,\n    onError: config.onError,\n  }\n}\n\n/**\n * Normalizes any supported motion config shape into canonical tracks.\n *\n * @param config Motion config in shorthand, timeline, or canonical form.\n * @returns Canonical track-based motion config.\n */\nexport function normalizeMotionConfig(\n  config: SpatializedMotionConfig,\n): NormalizedSpatializedMotionConfig {\n  if (config.timeline !== undefined) {\n    return desugarTimelineConfig(config as SpatializedMotionTimelineConfig)\n  }\n  return segmentConfigToMotionConfig(config as SpatializedMotionSegmentConfig)\n}\n"],"mappings":"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","names":[]}

package/dist/motion/compute/validate.d.ts

@@ -0,0 +1,22 @@
+import { aj as SpatializedMotionConfig, a$ as NormalizedSpatializedMotionConfig } from '../../spatializedElementMotion-_0XWPQCE.js';
+import '../../types/motion/spatializedVisual.js';
+import '../../types/motion/spatializedPlayback.js';
+import '../../types/global.js';
+import '../../physicalMetrics-W5uZ5xKb.js';
+import '../../SpatialObject.js';
+import '../../reality/component/SpatialComponent.js';
+
+/**
+ * Validates any supported motion config shape before playback or serialization.
+ *
+ * @param config Motion config in any supported input shape.
+ */
+declare function validateSpatializedMotionConfig(config: SpatializedMotionConfig): void;
+/**
+ * Validates the canonical track-based motion config form.
+ *
+ * @param config Canonical motion config to validate.
+ */
+declare function validateNormalizedMotionConfig(config: NormalizedSpatializedMotionConfig): void;
+
+export { validateNormalizedMotionConfig, validateSpatializedMotionConfig };

package/dist/motion/compute/validate.js

@@ -0,0 +1,103 @@
+import { SPATIALIZED_MOTION_PROPERTIES } from "../../types/motion/spatializedMotion";
+import { normalizeMotionConfig } from "./normalize";
+const ALLOWED_PROPERTIES = new Set(
+  SPATIALIZED_MOTION_PROPERTIES
+);
+const FORBIDDEN_PREFIXES = [
+  "width",
+  "height",
+  "back",
+  "backOffset",
+  "depth"
+];
+function validateSpatializedMotionConfig(config) {
+  if (config.tracks !== void 0) {
+    throw new Error("[SpatializedMotion] tracks authoring is internal");
+  }
+  const normalized = normalizeMotionConfig(config);
+  validateNormalizedMotionConfig(normalized);
+}
+function validateNormalizedMotionConfig(config) {
+  const { duration, tracks } = config;
+  if (typeof duration !== "number" || !Number.isFinite(duration) || duration <= 0) {
+    throw new Error("[SpatializedMotion] duration must be a finite number > 0");
+  }
+  if (!Array.isArray(tracks) || tracks.length === 0) {
+    throw new Error("[SpatializedMotion] tracks must be a non-empty array");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const track of tracks) {
+    validateTrack(track, duration, seen);
+  }
+  if (config.delay !== void 0) {
+    const d = config.delay;
+    if (typeof d !== "number" || !Number.isFinite(d) || d < 0) {
+      throw new Error("[SpatializedMotion] delay must be >= 0 and finite");
+    }
+  }
+  if (config.playbackRate !== void 0) {
+    const r = config.playbackRate;
+    if (typeof r !== "number" || !Number.isFinite(r) || r <= 0) {
+      throw new Error("[SpatializedMotion] playbackRate must be > 0 and finite");
+    }
+  }
+}
+function validateTrack(track, duration, seen) {
+  const prop = track.property;
+  for (const forbidden of FORBIDDEN_PREFIXES) {
+    if (prop === forbidden || prop.startsWith(`${forbidden}.`)) {
+      throw new Error(
+        `[SpatializedMotion] property "${prop}" is not animatable`
+      );
+    }
+  }
+  if (!ALLOWED_PROPERTIES.has(track.property)) {
+    throw new Error(`[SpatializedMotion] unknown property "${prop}"`);
+  }
+  if (seen.has(prop)) {
+    throw new Error(`[SpatializedMotion] duplicate track for "${prop}"`);
+  }
+  seen.add(prop);
+  const kf = track.keyframes;
+  if (!Array.isArray(kf) || kf.length < 2) {
+    throw new Error(
+      `[SpatializedMotion] track "${prop}" needs at least 2 keyframes`
+    );
+  }
+  let prevAt = -Infinity;
+  for (const frame of kf) {
+    if (typeof frame.at !== "number" || !Number.isFinite(frame.at)) {
+      throw new Error(
+        `[SpatializedMotion] keyframe.at must be finite for "${prop}"`
+      );
+    }
+    if (frame.at < 0 || frame.at > duration) {
+      throw new Error(
+        `[SpatializedMotion] keyframe.at must be within [0, duration] for "${prop}"`
+      );
+    }
+    if (frame.at <= prevAt) {
+      throw new Error(
+        `[SpatializedMotion] keyframe times must be strictly increasing for "${prop}"`
+      );
+    }
+    prevAt = frame.at;
+    validateScalar(frame.value, track.property);
+  }
+}
+function validateScalar(value, property) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`[SpatializedMotion] invalid value for ${property}`);
+  }
+  if (property === "opacity" && (value < 0 || value > 1)) {
+    throw new Error("[SpatializedMotion] opacity must be in [0, 1]");
+  }
+  if (property.startsWith("transform.scale.") && value < 0) {
+    throw new Error("[SpatializedMotion] scale must be >= 0");
+  }
+}
+export {
+  validateNormalizedMotionConfig,
+  validateSpatializedMotionConfig
+};
+//# sourceMappingURL=validate.js.map