@haiyue/extensions 0.1.0 → 0.2.0

package/src/animation/Animation2DComponent.ts

@@ -1,135 +0,0 @@
-import type { AnimationSource, ParsedAnimation } from '@haiyue/animation-spec';
-import { parseAnimation } from '@haiyue/animation-spec';
-import { Component, type Entity, type World } from '@haiyue/engine';
-import { ComponentLifecycleFlags, UniqueCheckType } from '@haiyue/engine/ecs';
-import type { Animation2DRuntime } from './Animation2DRuntime';
-import type { Animation2DExtensionRegistry } from './Animation2DExtensionRegistry';
-
-export interface Animation2DComponentOptions {
-  autoplay?: boolean;
-  loop?: boolean;
-  speed?: number;
-  startTime?: number;
-  runtimeExtensions?: Animation2DExtensionRegistry;
-}
-
-export interface Animation2DRuntimeStats {
-  readonly nodeCount: number;
-  readonly visualCount: number;
-  readonly unsupportedComponentCount: number;
-  readonly pendingResourceCount: number;
-  readonly failedResourceCount: number;
-  readonly textCount: number;
-  readonly particleCount: number;
-  readonly audioCount: number;
-}
-
-export class Animation2DComponent extends Component {
-  static override UniqueCheckType = UniqueCheckType.SYMBOL | UniqueCheckType.REPLACE;
-  static override UniqueSymbol = Symbol.for('Animation2DComponent');
-  static override Lifecycle = ComponentLifecycleFlags.EntityRemoveComponent | ComponentLifecycleFlags.EntityRemoveFromWorld;
-
-  readonly animation: ParsedAnimation;
-  playing: boolean;
-  loop: boolean;
-  speed: number;
-  currentTime: number;
-  completed = false;
-  readonly runtimeExtensions: Animation2DExtensionRegistry | undefined;
-  _runtime: Animation2DRuntime | null = null;
-  _needsApply = true;
-  _forceParticleSeek = false;
-
-  constructor(source: AnimationSource | ParsedAnimation, options: Animation2DComponentOptions = {}) {
-    super('Animation2DComponent');
-    this.animation = isParsed(source) ? source : parseAnimation(source);
-    this.playing = options.autoplay ?? true;
-    this.loop = options.loop ?? this.animation.endBehavior === 'loop';
-    this.speed = finiteSpeed(options.speed ?? 1);
-    this.currentTime = clampTime(options.startTime ?? 0, this.animation.duration);
-    this.runtimeExtensions = options.runtimeExtensions;
-  }
-
-  get runtimeStats(): Animation2DRuntimeStats {
-    return this._runtime?.stats ?? {
-      nodeCount: 0,
-      visualCount: 0,
-      unsupportedComponentCount: 0,
-      pendingResourceCount: 0,
-      failedResourceCount: 0,
-      textCount: 0,
-      particleCount: 0,
-      audioCount: 0,
-    };
-  }
-
-  play(): this {
-    if (this.completed) {
-      this.currentTime = 0;
-      this._needsApply = true;
-      this._forceParticleSeek = true;
-    }
-    this.playing = true;
-    this.completed = false;
-    this._runtime?.setPlaying(true);
-    return this;
-  }
-
-  pause(): this {
-    this.playing = false;
-    this._runtime?.setPlaying(false);
-    return this;
-  }
-
-  seek(seconds: number): this {
-    this.currentTime = clampTime(seconds, this.animation.duration);
-    this.completed = false;
-    this._needsApply = true;
-    this._forceParticleSeek = true;
-    return this;
-  }
-
-  setSpeed(speed: number): this {
-    this.speed = finiteSpeed(speed);
-    return this;
-  }
-
-  onEntityRemoveComponent(_entity: Entity, component: Component): void {
-    if (component === this) this._disposeRuntime();
-  }
-
-  onEntityRemoveFromWorld(_entity: Entity, _world: World): void {
-    this._disposeRuntime();
-  }
-
-  override clone(): Animation2DComponent {
-    const clone = new Animation2DComponent(this.animation, {
-      autoplay: this.playing,
-      loop: this.loop,
-      speed: this.speed,
-      startTime: this.currentTime,
-      ...(this.runtimeExtensions ? { runtimeExtensions: this.runtimeExtensions } : {}),
-    });
-    clone.disabled = this.disabled;
-    return clone;
-  }
-
-  _disposeRuntime(): void {
-    this._runtime?.destroy();
-    this._runtime = null;
-  }
-}
-
-function isParsed(source: AnimationSource | ParsedAnimation): source is ParsedAnimation {
-  return typeof source === 'object' && source !== null && 'source' in source;
-}
-
-function finiteSpeed(value: number): number {
-  if (!Number.isFinite(value) || value < 0) throw new RangeError('Animation2DComponent speed must be finite and non-negative.');
-  return value;
-}
-
-function clampTime(value: number, duration: number): number {
-  if (!Number.isFinite(value)) throw new RangeError('Animation2DComponent time must be finite.');
-  return Math.max(0, Math.min(duration, value));
-}

package/src/animation/Animation2DExtensionRegistry.ts

@@ -1,52 +0,0 @@
-import type {
-  AnimationComponent,
-  AnimationNode,
-  ParsedAnimation,
-} from '@haiyue/animation-spec';
-import type { Entity } from '@haiyue/engine';
-
-export interface Animation2DExtensionContext {
-  readonly animation: ParsedAnimation;
-  readonly node: Readonly<AnimationNode>;
-  readonly component: Readonly<AnimationComponent>;
-  /** Anchor-adjusted parent for entities created by the extension. */
-  readonly parent: Entity;
-}
-
-export interface Animation2DExtensionInstance {
-  /** Deterministic composition-time update; implementations must tolerate seeks and loop wrap. */
-  apply?(timeSeconds: number, opacity: number): void;
-  setOpacity?(opacity: number): void;
-  destroy?(): void;
-}
-
-export interface Animation2DExtensionHandler {
-  /** Component type or namespaced extension id implemented by this handler. */
-  readonly id: string;
-  create(context: Animation2DExtensionContext): Animation2DExtensionInstance | void;
-}
-
-/** Instance-owned registry; unregister tokens only remove the handler that created them. */
-export class Animation2DExtensionRegistry {
-  private readonly _handlers = new Map<string, Animation2DExtensionHandler>();
-
-  register(handler: Animation2DExtensionHandler): () => void {
-    if (!handler.id.trim()) throw new TypeError('Animation runtime extension id must not be empty.');
-    if (this._handlers.has(handler.id)) throw new Error(`Animation runtime extension "${handler.id}" is already registered.`);
-    this._handlers.set(handler.id, handler);
-    let active = true;
-    return () => {
-      if (!active) return;
-      active = false;
-      if (this._handlers.get(handler.id) === handler) this._handlers.delete(handler.id);
-    };
-  }
-
-  get(id: string): Animation2DExtensionHandler | undefined {
-    return this._handlers.get(id);
-  }
-
-  has(id: string): boolean {
-    return this._handlers.has(id);
-  }
-}