@daidr/minecraft-skin-renderer 0.1.0

package/README.md

@@ -0,0 +1,247 @@
+# minecraft-skin-renderer
+
+[![npm version](https://img.shields.io/npm/v/minecraft-skin-renderer.svg)](https://www.npmjs.com/package/minecraft-skin-renderer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A high-performance, browser-based 3D Minecraft skin renderer with WebGL and WebGPU support.
+
+[Online Demo](https://mcskin.daidr.me)
+
+## Features
+
+- **Dual Rendering Backends** - WebGL2 for broad compatibility, WebGPU for modern performance
+- **Skin Variants** - Classic (4px arms) and slim (3px arms) model support
+- **Back Equipment** - Cape and elytra rendering
+- **Animations** - Built-in presets (idle, walk, run, fly) with custom animation support
+- **Camera Controls** - Orbit controls with zoom, rotation, and auto-rotate
+- **Panorama Backgrounds** - Equirectangular panorama support via plugin
+- **Screenshot Export** - Export renders as PNG or JPEG
+- **Tree-Shakable** - Plugin architecture for minimal bundle size
+
+## Quick Start
+
+### Installation
+
+```bash
+# npm
+npm install minecraft-skin-renderer
+
+# pnpm
+pnpm add minecraft-skin-renderer
+
+# yarn
+yarn add minecraft-skin-renderer
+
+# bun
+bun add minecraft-skin-renderer
+```
+
+### Basic Usage
+
+```typescript
+import { use, createSkinViewer } from 'minecraft-skin-renderer'
+import { WebGLRendererPlugin } from 'minecraft-skin-renderer/webgl'
+
+// Register renderer plugin (required before creating viewer)
+use(WebGLRendererPlugin)
+
+// Create viewer
+const viewer = await createSkinViewer({
+  canvas: document.getElementById('canvas') as HTMLCanvasElement,
+  skin: 'https://example.com/skin.png',
+})
+
+// Start rendering
+viewer.startRenderLoop()
+
+// Play animation
+viewer.playAnimation('walk')
+```
+
+## API Reference
+
+### `use(plugin)`
+
+Register a renderer or feature plugin. Must be called before `createSkinViewer()`.
+
+```typescript
+import { use } from 'minecraft-skin-renderer'
+import { WebGLRendererPlugin } from 'minecraft-skin-renderer/webgl'
+import { WebGPURendererPlugin } from 'minecraft-skin-renderer/webgpu'
+import { PanoramaPlugin } from 'minecraft-skin-renderer/panorama'
+
+use(WebGLRendererPlugin)
+use(WebGPURendererPlugin)
+use(PanoramaPlugin)
+```
+
+### `createSkinViewer(options)`
+
+Create and initialize a skin viewer instance.
+
+```typescript
+const viewer = await createSkinViewer({
+  canvas: HTMLCanvasElement,        // Required: canvas element
+  preferredBackend: 'auto',         // 'webgl' | 'webgpu' | 'auto'
+  antialias: true,                  // Enable antialiasing
+  pixelRatio: window.devicePixelRatio,
+  skin: 'url' | File | Blob,        // Skin texture source
+  cape: 'url' | File | Blob,        // Cape texture (64x32)
+  backEquipment: 'none',            // 'cape' | 'elytra' | 'none'
+  slim: false,                      // Use slim model variant
+  fov: 70,                          // Field of view in degrees
+  zoom: 60,                         // Initial zoom distance
+  enableRotate: true,               // Enable orbit rotation
+  enableZoom: true,                 // Enable zoom controls
+  autoRotate: false,                // Auto-rotate camera
+  autoRotateSpeed: 30,              // Degrees per second
+  panorama: 'url',                  // Panorama background (requires PanoramaPlugin)
+})
+```
+
+### SkinViewer Methods
+
+#### Textures
+
+```typescript
+await viewer.setSkin(source)        // Set skin texture
+await viewer.setCape(source)        // Set cape texture
+viewer.setSlim(true)                // Switch to slim model
+viewer.setBackEquipment('cape')     // 'cape' | 'elytra' | 'none'
+```
+
+#### Visibility
+
+```typescript
+// Get current visibility state
+const visibility = viewer.getPartsVisibility()
+
+// Set visibility for all parts
+viewer.setPartsVisibility({
+  head: { inner: true, outer: true },
+  body: { inner: true, outer: false },
+  // ...
+})
+
+// Set single part visibility
+viewer.setPartVisibility('head', 'outer', false)
+```
+
+#### Animation
+
+```typescript
+viewer.playAnimation('walk')        // Play animation
+viewer.playAnimation('walk', {      // With options
+  speed: 1.5,
+  amplitude: 1.0,
+})
+viewer.pauseAnimation()             // Pause
+viewer.resumeAnimation()            // Resume
+viewer.stopAnimation()              // Stop
+```
+
+#### Camera
+
+```typescript
+viewer.setRotation(theta, phi)      // Set camera angles
+const { theta, phi } = viewer.getRotation()
+viewer.setZoom(80)                  // Set zoom distance
+viewer.getZoom()                    // Get current zoom
+viewer.setAutoRotate(true)          // Toggle auto-rotate
+viewer.resetCamera()                // Reset to default
+```
+
+#### Rendering
+
+```typescript
+viewer.render()                     // Manual render
+viewer.startRenderLoop()            // Start RAF loop
+viewer.stopRenderLoop()             // Stop RAF loop
+viewer.resize(width, height)        // Resize canvas
+const dataUrl = viewer.screenshot('png', 0.9)  // Export
+```
+
+#### Lifecycle
+
+```typescript
+viewer.dispose()                    // Clean up resources
+```
+
+#### Properties
+
+```typescript
+viewer.backend                      // 'webgl' | 'webgpu' (readonly)
+viewer.isPlaying                    // Animation playing (readonly)
+viewer.currentAnimation             // Current animation name (readonly)
+viewer.backEquipment                // Current back equipment (readonly)
+```
+
+### Plugins
+
+| Plugin | Import Path | Description |
+|--------|-------------|-------------|
+| WebGL | `minecraft-skin-renderer/webgl` | WebGL2 rendering backend |
+| WebGPU | `minecraft-skin-renderer/webgpu` | WebGPU rendering backend |
+| Panorama | `minecraft-skin-renderer/panorama` | Panorama background support |
+
+### Built-in Animations
+
+| Name | Description |
+|------|-------------|
+| `idle` | Standing idle animation |
+| `walk` | Walking animation |
+| `run` | Running animation |
+| `fly` | Flying/gliding animation |
+
+## Development
+
+### Prerequisites
+
+- Node.js 18+ or Bun
+
+### Setup
+
+```bash
+# Install dependencies
+bun install
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `bun run build` | Build library with tsdown |
+| `bun dev` | Build in watch mode |
+| `bun dev:playground` | Run playground dev server |
+| `bun test` | Run tests |
+| `bun test:coverage` | Run tests with coverage |
+| `bun lint` | Lint with oxlint |
+| `bun lint:fix` | Lint and auto-fix |
+| `bun fmt` | Format with oxfmt |
+
+### Project Structure
+
+```
+src/
+├── core/
+│   ├── renderer/     # Renderer abstraction (WebGL/WebGPU)
+│   ├── math/         # Math utilities (Vec3, Mat4, Quat)
+│   ├── camera/       # Camera system
+│   └── plugins/      # Plugin registry
+├── model/            # Skeleton and geometry
+├── animation/        # Animation system
+├── viewer/           # Main SkinViewer
+└── plugins/          # Plugin implementations
+```
+
+### Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+[MIT](LICENSE)

package/dist/animation/AnimationController.d.mts

@@ -0,0 +1,15 @@
+import { PlayerSkeleton } from "../model/types.mjs";
+import { AnimationController } from "./types.mjs";
+
+//#region src/animation/AnimationController.d.ts
+/**
+ * Create animation controller
+ */
+declare function createAnimationController(skeleton: PlayerSkeleton): AnimationController;
+/**
+ * Update animation controller
+ */
+declare function updateAnimationController(controller: AnimationController, deltaTime: number): void;
+//#endregion
+export { createAnimationController, updateAnimationController };
+//# sourceMappingURL=AnimationController.d.mts.map

package/dist/animation/AnimationController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationController.d.mts","names":[],"sources":["../../src/animation/AnimationController.ts"],"mappings":";;;;;;;iBAyJgB,yBAAA,CAA0B,QAAA,EAAU,cAAA,GAAiB,mBAAA;;;;iBA6ErD,yBAAA,CACd,UAAA,EAAY,mBAAA,EACZ,SAAA"}

package/dist/animation/AnimationController.mjs

@@ -0,0 +1,146 @@
+import { vec3Lerp, vec3Zero } from "../core/math/vec3.mjs";
+import { quatIdentity, quatSlerp } from "../core/math/quat.mjs";
+import "../core/math/index.mjs";
+import { resetSkeleton, setBonePositionOffset, setBoneRotation } from "../model/PlayerModel.mjs";
+import { linear } from "./easing.mjs";
+import { AnimationPlayState, getAnimation } from "./types.mjs";
+import "./presets/index.mjs";
+
+//#region src/animation/AnimationController.ts
+/**
+* Animation controller implementation
+*/
+const controllerStates = /* @__PURE__ */ new WeakMap();
+/**
+* Binary search for keyframe index
+* Returns the index of the last keyframe with time <= target time
+*/
+function binarySearchKeyframe(keyframes, time) {
+	let low = 0;
+	let high = keyframes.length - 1;
+	if (time <= keyframes[0].time) return 0;
+	if (time >= keyframes[high].time) return high;
+	while (low < high) {
+		const mid = low + high + 1 >> 1;
+		if (keyframes[mid].time <= time) low = mid;
+		else high = mid - 1;
+	}
+	return low;
+}
+/**
+* Interpolate between keyframes using binary search
+*/
+function interpolateKeyframes(keyframes, normalizedTime, amplitude) {
+	if (keyframes.length === 0) return {};
+	if (keyframes.length === 1) {
+		const kf = keyframes[0];
+		const result = {};
+		if (kf.rotation) result.rotation = amplitude !== 1 ? quatSlerp(quatIdentity(), kf.rotation, amplitude) : kf.rotation;
+		if (kf.position) result.position = amplitude !== 1 ? vec3Lerp(vec3Zero(), kf.position, amplitude) : kf.position;
+		return result;
+	}
+	const prevIndex = binarySearchKeyframe(keyframes, normalizedTime);
+	const prevKeyframe = keyframes[prevIndex];
+	if (prevIndex >= keyframes.length - 1) {
+		const result = {};
+		if (prevKeyframe.rotation) result.rotation = amplitude !== 1 ? quatSlerp(quatIdentity(), prevKeyframe.rotation, amplitude) : prevKeyframe.rotation;
+		if (prevKeyframe.position) result.position = amplitude !== 1 ? vec3Lerp(vec3Zero(), prevKeyframe.position, amplitude) : prevKeyframe.position;
+		return result;
+	}
+	const nextKeyframe = keyframes[prevIndex + 1];
+	const segmentDuration = nextKeyframe.time - prevKeyframe.time;
+	const localT = segmentDuration > 0 ? (normalizedTime - prevKeyframe.time) / segmentDuration : 0;
+	const easedT = (nextKeyframe.easing ?? linear)(localT);
+	const result = {};
+	if (prevKeyframe.rotation && nextKeyframe.rotation) {
+		let rotation = quatSlerp(prevKeyframe.rotation, nextKeyframe.rotation, easedT);
+		if (amplitude !== 1) rotation = quatSlerp(quatIdentity(), rotation, amplitude);
+		result.rotation = rotation;
+	}
+	if (prevKeyframe.position && nextKeyframe.position) {
+		let position = vec3Lerp(prevKeyframe.position, nextKeyframe.position, easedT);
+		if (amplitude !== 1) position = vec3Lerp(vec3Zero(), position, amplitude);
+		result.position = position;
+	}
+	return result;
+}
+/**
+* Create animation controller
+*/
+function createAnimationController(skeleton) {
+	const state = {
+		skeleton,
+		current: null
+	};
+	const controller = {
+		get isPlaying() {
+			return state.current?.playState === AnimationPlayState.Playing;
+		},
+		get isPaused() {
+			return state.current?.playState === AnimationPlayState.Paused;
+		},
+		get currentAnimation() {
+			return state.current?.animation.name ?? null;
+		},
+		get progress() {
+			if (!state.current) return 0;
+			return state.current.time % state.current.animation.duration / state.current.animation.duration;
+		},
+		skeleton,
+		play(name, config) {
+			const animation = getAnimation(name);
+			if (!animation) {
+				console.warn(`Animation "${name}" not found`);
+				return;
+			}
+			resetSkeleton(skeleton);
+			state.current = {
+				animation,
+				config: {
+					speed: config?.speed ?? 1,
+					amplitude: config?.amplitude ?? 1
+				},
+				time: 0,
+				playState: AnimationPlayState.Playing
+			};
+		},
+		pause() {
+			if (state.current && state.current.playState === AnimationPlayState.Playing) state.current.playState = AnimationPlayState.Paused;
+		},
+		resume() {
+			if (state.current && state.current.playState === AnimationPlayState.Paused) state.current.playState = AnimationPlayState.Playing;
+		},
+		stop() {
+			state.current = null;
+			resetSkeleton(skeleton);
+		}
+	};
+	controllerStates.set(controller, state);
+	return controller;
+}
+/**
+* Update animation controller
+*/
+function updateAnimationController(controller, deltaTime) {
+	const state = controllerStates.get(controller);
+	if (!state || !state.current) return;
+	if (state.current.playState !== AnimationPlayState.Playing) return;
+	const { animation, config } = state.current;
+	state.current.time += deltaTime * (config.speed ?? 1);
+	if (animation.loop) state.current.time %= animation.duration;
+	else if (state.current.time >= animation.duration) {
+		state.current.time = animation.duration;
+		state.current.playState = AnimationPlayState.Stopped;
+	}
+	const normalizedTime = state.current.time / animation.duration;
+	const amplitude = config.amplitude ?? 1;
+	for (const track of animation.tracks) {
+		const result = interpolateKeyframes(track.keyframes, normalizedTime, amplitude);
+		if (result.rotation) setBoneRotation(controller.skeleton, track.boneIndex, result.rotation);
+		if (result.position) setBonePositionOffset(controller.skeleton, track.boneIndex, result.position);
+	}
+}
+
+//#endregion
+export { createAnimationController, updateAnimationController };
+//# sourceMappingURL=AnimationController.mjs.map

package/dist/animation/AnimationController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationController.mjs","names":[],"sources":["../../src/animation/AnimationController.ts"],"sourcesContent":["/**\n * Animation controller implementation\n */\n\nimport { quatIdentity, quatSlerp, vec3Lerp, vec3Zero } from \"../core/math\";\nimport type { Quat, Vec3 } from \"../core/math\";\nimport type { PlayerSkeleton } from \"../model/types\";\nimport { setBoneRotation, setBonePositionOffset, resetSkeleton } from \"../model/PlayerModel\";\nimport { linear } from \"./easing\";\nimport { getAnimation, AnimationPlayState } from \"./types\";\nimport type { Animation, AnimationConfig, AnimationController, Keyframe } from \"./types\";\n\n// Import presets to register them\nimport \"./presets\";\n\n/** Internal animation state */\ninterface AnimationState {\n  animation: Animation;\n  config: AnimationConfig;\n  time: number; // Current time in seconds\n  playState: AnimationPlayState;\n}\n\n/** Animation controller internal state */\ninterface ControllerState {\n  skeleton: PlayerSkeleton;\n  current: AnimationState | null;\n}\n\n// Internal state storage using WeakMap\nconst controllerStates = new WeakMap<AnimationController, ControllerState>();\n\n/** Result of keyframe interpolation */\ninterface InterpolationResult {\n  rotation?: Quat;\n  position?: Vec3;\n}\n\n/**\n * Binary search for keyframe index\n * Returns the index of the last keyframe with time <= target time\n */\nfunction binarySearchKeyframe(keyframes: Keyframe[], time: number): number {\n  let low = 0;\n  let high = keyframes.length - 1;\n\n  // Edge cases\n  if (time <= keyframes[0]!.time) return 0;\n  if (time >= keyframes[high]!.time) return high;\n\n  while (low < high) {\n    const mid = (low + high + 1) >> 1;\n    if (keyframes[mid]!.time <= time) {\n      low = mid;\n    } else {\n      high = mid - 1;\n    }\n  }\n\n  return low;\n}\n\n/**\n * Interpolate between keyframes using binary search\n */\nfunction interpolateKeyframes(\n  keyframes: Keyframe[],\n  normalizedTime: number,\n  amplitude: number,\n): InterpolationResult {\n  if (keyframes.length === 0) {\n    return {};\n  }\n\n  // Single keyframe fast path\n  if (keyframes.length === 1) {\n    const kf = keyframes[0]!;\n    const result: InterpolationResult = {};\n\n    if (kf.rotation) {\n      result.rotation =\n        amplitude !== 1.0 ? quatSlerp(quatIdentity(), kf.rotation, amplitude) : kf.rotation;\n    }\n    if (kf.position) {\n      result.position =\n        amplitude !== 1.0 ? vec3Lerp(vec3Zero(), kf.position, amplitude) : kf.position;\n    }\n\n    return result;\n  }\n\n  // Use binary search to find keyframe pair\n  const prevIndex = binarySearchKeyframe(keyframes, normalizedTime);\n  const prevKeyframe = keyframes[prevIndex]!;\n\n  // If at the last keyframe, return its values\n  if (prevIndex >= keyframes.length - 1) {\n    const result: InterpolationResult = {};\n\n    if (prevKeyframe.rotation) {\n      result.rotation =\n        amplitude !== 1.0\n          ? quatSlerp(quatIdentity(), prevKeyframe.rotation, amplitude)\n          : prevKeyframe.rotation;\n    }\n    if (prevKeyframe.position) {\n      result.position =\n        amplitude !== 1.0\n          ? vec3Lerp(vec3Zero(), prevKeyframe.position, amplitude)\n          : prevKeyframe.position;\n    }\n\n    return result;\n  }\n\n  const nextKeyframe = keyframes[prevIndex + 1]!;\n\n  // Calculate local interpolation factor\n  const segmentDuration = nextKeyframe.time - prevKeyframe.time;\n  const localT = segmentDuration > 0 ? (normalizedTime - prevKeyframe.time) / segmentDuration : 0;\n\n  // Apply easing\n  const easing = nextKeyframe.easing ?? linear;\n  const easedT = easing(localT);\n\n  const result: InterpolationResult = {};\n\n  // Interpolate rotation if present\n  if (prevKeyframe.rotation && nextKeyframe.rotation) {\n    let rotation = quatSlerp(prevKeyframe.rotation, nextKeyframe.rotation, easedT);\n    // Apply amplitude scaling (interpolate from identity)\n    if (amplitude !== 1.0) {\n      rotation = quatSlerp(quatIdentity(), rotation, amplitude);\n    }\n    result.rotation = rotation;\n  }\n\n  // Interpolate position if present\n  if (prevKeyframe.position && nextKeyframe.position) {\n    let position = vec3Lerp(prevKeyframe.position, nextKeyframe.position, easedT);\n    // Apply amplitude scaling\n    if (amplitude !== 1.0) {\n      position = vec3Lerp(vec3Zero(), position, amplitude);\n    }\n    result.position = position;\n  }\n\n  return result;\n}\n\n/**\n * Create animation controller\n */\nexport function createAnimationController(skeleton: PlayerSkeleton): AnimationController {\n  // Create state\n  const state: ControllerState = {\n    skeleton,\n    current: null,\n  };\n\n  const controller: AnimationController = {\n    get isPlaying() {\n      return state.current?.playState === AnimationPlayState.Playing;\n    },\n\n    get isPaused() {\n      return state.current?.playState === AnimationPlayState.Paused;\n    },\n\n    get currentAnimation() {\n      return state.current?.animation.name ?? null;\n    },\n\n    get progress() {\n      if (!state.current) return 0;\n      return (\n        (state.current.time % state.current.animation.duration) / state.current.animation.duration\n      );\n    },\n\n    skeleton,\n\n    play(name: string, config?: AnimationConfig) {\n      const animation = getAnimation(name);\n      if (!animation) {\n        console.warn(`Animation \"${name}\" not found`);\n        return;\n      }\n\n      // Reset skeleton to default pose before starting new animation\n      resetSkeleton(skeleton);\n\n      state.current = {\n        animation,\n        config: {\n          speed: config?.speed ?? 1.0,\n          amplitude: config?.amplitude ?? 1.0,\n        },\n        time: 0,\n        playState: AnimationPlayState.Playing,\n      };\n    },\n\n    pause() {\n      if (state.current && state.current.playState === AnimationPlayState.Playing) {\n        state.current.playState = AnimationPlayState.Paused;\n      }\n    },\n\n    resume() {\n      if (state.current && state.current.playState === AnimationPlayState.Paused) {\n        state.current.playState = AnimationPlayState.Playing;\n      }\n    },\n\n    stop() {\n      state.current = null;\n      resetSkeleton(skeleton);\n    },\n  };\n\n  // Store state in WeakMap\n  controllerStates.set(controller, state);\n\n  return controller;\n}\n\n/**\n * Update animation controller\n */\nexport function updateAnimationController(\n  controller: AnimationController,\n  deltaTime: number,\n): void {\n  const state = controllerStates.get(controller);\n  if (!state || !state.current) return;\n  if (state.current.playState !== AnimationPlayState.Playing) return;\n\n  const { animation, config } = state.current;\n\n  // Update time\n  state.current.time += deltaTime * (config.speed ?? 1.0);\n\n  // Handle looping\n  if (animation.loop) {\n    state.current.time %= animation.duration;\n  } else if (state.current.time >= animation.duration) {\n    state.current.time = animation.duration;\n    state.current.playState = AnimationPlayState.Stopped;\n  }\n\n  // Calculate normalized time (0-1)\n  const normalizedTime = state.current.time / animation.duration;\n\n  // Apply animation to each track\n  const amplitude = config.amplitude ?? 1.0;\n\n  for (const track of animation.tracks) {\n    const result = interpolateKeyframes(track.keyframes, normalizedTime, amplitude);\n    if (result.rotation) {\n      setBoneRotation(controller.skeleton, track.boneIndex, result.rotation);\n    }\n    if (result.position) {\n      setBonePositionOffset(controller.skeleton, track.boneIndex, result.position);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/animation/easing.mjs

@@ -0,0 +1,9 @@
+//#region src/animation/easing.ts
+/** Linear interpolation (no easing) */
+const linear = (t) => t;
+/** Ease in-out sine */
+const easeInOutSine = (t) => -(Math.cos(Math.PI * t) - 1) / 2;
+
+//#endregion
+export { easeInOutSine, linear };
+//# sourceMappingURL=easing.mjs.map

package/dist/animation/easing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.mjs","names":[],"sources":["../../src/animation/easing.ts"],"sourcesContent":["/**\n * Easing functions for animations\n */\n\nimport type { EasingFunction } from \"./types\";\n\n/** Linear interpolation (no easing) */\nexport const linear: EasingFunction = (t) => t;\n\n/** Ease in quadratic */\nexport const easeInQuad: EasingFunction = (t) => t * t;\n\n/** Ease out quadratic */\nexport const easeOutQuad: EasingFunction = (t) => t * (2 - t);\n\n/** Ease in-out quadratic */\nexport const easeInOutQuad: EasingFunction = (t) => (t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t);\n\n/** Ease in cubic */\nexport const easeInCubic: EasingFunction = (t) => t * t * t;\n\n/** Ease out cubic */\nexport const easeOutCubic: EasingFunction = (t) => {\n  const t1 = t - 1;\n  return t1 * t1 * t1 + 1;\n};\n\n/** Ease in-out cubic */\nexport const easeInOutCubic: EasingFunction = (t) =>\n  t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1;\n\n/** Ease in sine */\nexport const easeInSine: EasingFunction = (t) => 1 - Math.cos((t * Math.PI) / 2);\n\n/** Ease out sine */\nexport const easeOutSine: EasingFunction = (t) => Math.sin((t * Math.PI) / 2);\n\n/** Ease in-out sine */\nexport const easeInOutSine: EasingFunction = (t) => -(Math.cos(Math.PI * t) - 1) / 2;\n\n/** Smooth sine wave (for looping animations) */\nexport const sineWave: EasingFunction = (t) => Math.sin(t * Math.PI * 2);\n\n/** Half sine wave (0 to 1 to 0) */\nexport const halfSine: EasingFunction = (t) => Math.sin(t * Math.PI);\n\n/** Bounce effect */\nexport const bounce: EasingFunction = (t) => {\n  if (t < 1 / 2.75) {\n    return 7.5625 * t * t;\n  } else if (t < 2 / 2.75) {\n    const t2 = t - 1.5 / 2.75;\n    return 7.5625 * t2 * t2 + 0.75;\n  } else if (t < 2.5 / 2.75) {\n    const t2 = t - 2.25 / 2.75;\n    return 7.5625 * t2 * t2 + 0.9375;\n  } else {\n    const t2 = t - 2.625 / 2.75;\n    return 7.5625 * t2 * t2 + 0.984375;\n  }\n};\n\n/** Elastic bounce */\nexport const elastic: EasingFunction = (t) => {\n  if (t === 0 || t === 1) return t;\n  const p = 0.3;\n  const s = p / 4;\n  return Math.pow(2, -10 * t) * Math.sin(((t - s) * (2 * Math.PI)) / p) + 1;\n};\n"],"mappings":";;AAOA,MAAa,UAA0B,MAAM;;AA+B7C,MAAa,iBAAiC,MAAM,EAAE,KAAK,IAAI,KAAK,KAAK,EAAE,GAAG,KAAK"}

package/dist/animation/presets/fly.mjs

@@ -0,0 +1,176 @@
+import { quatFromEuler } from "../../core/math/quat.mjs";
+import { degToRad } from "../../core/math/utils.mjs";
+import "../../core/math/index.mjs";
+import { BoneIndex } from "../../model/types.mjs";
+import { easeInOutSine } from "../easing.mjs";
+import { registerAnimation } from "../types.mjs";
+import { createSpreadWingTracks, rot } from "./utils.mjs";
+
+//#region src/animation/presets/fly.ts
+/**
+* Fly animation preset (elytra flying pose)
+*/
+/** Create fly animation */
+function createFlyAnimation() {
+	const bodyPitch = 80;
+	const armAngle = 10;
+	const legAngle = 5;
+	const [leftWing, rightWing] = createSpreadWingTracks(20, 80);
+	return {
+		name: "fly",
+		duration: 1.5,
+		loop: true,
+		tracks: [
+			{
+				boneIndex: BoneIndex.Body,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(bodyPitch)
+					},
+					{
+						time: .5,
+						rotation: rot(bodyPitch + 3),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(bodyPitch),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.Head,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(-bodyPitch + 10)
+					},
+					{
+						time: .5,
+						rotation: rot(-bodyPitch + 5),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(-bodyPitch + 10),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.RightArm,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(armAngle, 0, -15)
+					},
+					{
+						time: .5,
+						rotation: rot(armAngle + 5, 0, -20),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(armAngle, 0, -15),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.LeftArm,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(armAngle, 0, 15)
+					},
+					{
+						time: .5,
+						rotation: rot(armAngle + 5, 0, 20),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(armAngle, 0, 15),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.RightLeg,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(legAngle, 0, -3)
+					},
+					{
+						time: .5,
+						rotation: rot(legAngle + 5, 0, -5),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(legAngle, 0, -3),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.LeftLeg,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(legAngle, 0, 3)
+					},
+					{
+						time: .5,
+						rotation: rot(legAngle + 5, 0, 5),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(legAngle, 0, 3),
+						easing: easeInOutSine
+					}
+				]
+			},
+			{
+				boneIndex: BoneIndex.Cape,
+				keyframes: [
+					{
+						time: 0,
+						rotation: rot(10)
+					},
+					{
+						time: .25,
+						rotation: quatFromEuler(degToRad(15), degToRad(2), 0),
+						easing: easeInOutSine
+					},
+					{
+						time: .5,
+						rotation: rot(5),
+						easing: easeInOutSine
+					},
+					{
+						time: .75,
+						rotation: quatFromEuler(degToRad(15), degToRad(-2), 0),
+						easing: easeInOutSine
+					},
+					{
+						time: 1,
+						rotation: rot(10),
+						easing: easeInOutSine
+					}
+				]
+			},
+			leftWing,
+			rightWing
+		]
+	};
+}
+registerAnimation(createFlyAnimation());
+
+//#endregion
+export { createFlyAnimation };
+//# sourceMappingURL=fly.mjs.map

package/dist/animation/presets/fly.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fly.mjs","names":[],"sources":["../../../src/animation/presets/fly.ts"],"sourcesContent":["/**\n * Fly animation preset (elytra flying pose)\n */\n\nimport { degToRad, quatFromEuler } from \"../../core/math\";\nimport { BoneIndex } from \"../../model/types\";\nimport { easeInOutSine } from \"../easing\";\nimport { registerAnimation } from \"../types\";\nimport type { Animation } from \"../types\";\nimport { createSpreadWingTracks, rot } from \"./utils\";\n\n/** Create fly animation */\nfunction createFlyAnimation(): Animation {\n  const bodyPitch = 80;\n  const armAngle = 10;\n  const legAngle = 5;\n\n  const [leftWing, rightWing] = createSpreadWingTracks(20, 80);\n\n  return {\n    name: \"fly\",\n    duration: 1.5,\n    loop: true,\n    tracks: [\n      // Body pitched forward\n      {\n        boneIndex: BoneIndex.Body,\n        keyframes: [\n          { time: 0, rotation: rot(bodyPitch) },\n          { time: 0.5, rotation: rot(bodyPitch + 3), easing: easeInOutSine },\n          { time: 1, rotation: rot(bodyPitch), easing: easeInOutSine },\n        ],\n      },\n      // Head compensates for body pitch\n      {\n        boneIndex: BoneIndex.Head,\n        keyframes: [\n          { time: 0, rotation: rot(-bodyPitch + 10) },\n          { time: 0.5, rotation: rot(-bodyPitch + 5), easing: easeInOutSine },\n          { time: 1, rotation: rot(-bodyPitch + 10), easing: easeInOutSine },\n        ],\n      },\n      // Arms slightly back and out\n      {\n        boneIndex: BoneIndex.RightArm,\n        keyframes: [\n          { time: 0, rotation: rot(armAngle, 0, -15) },\n          { time: 0.5, rotation: rot(armAngle + 5, 0, -20), easing: easeInOutSine },\n          { time: 1, rotation: rot(armAngle, 0, -15), easing: easeInOutSine },\n        ],\n      },\n      {\n        boneIndex: BoneIndex.LeftArm,\n        keyframes: [\n          { time: 0, rotation: rot(armAngle, 0, 15) },\n          { time: 0.5, rotation: rot(armAngle + 5, 0, 20), easing: easeInOutSine },\n          { time: 1, rotation: rot(armAngle, 0, 15), easing: easeInOutSine },\n        ],\n      },\n      // Legs stretched back\n      {\n        boneIndex: BoneIndex.RightLeg,\n        keyframes: [\n          { time: 0, rotation: rot(legAngle, 0, -3) },\n          { time: 0.5, rotation: rot(legAngle + 5, 0, -5), easing: easeInOutSine },\n          { time: 1, rotation: rot(legAngle, 0, -3), easing: easeInOutSine },\n        ],\n      },\n      {\n        boneIndex: BoneIndex.LeftLeg,\n        keyframes: [\n          { time: 0, rotation: rot(legAngle, 0, 3) },\n          { time: 0.5, rotation: rot(legAngle + 5, 0, 5), easing: easeInOutSine },\n          { time: 1, rotation: rot(legAngle, 0, 3), easing: easeInOutSine },\n        ],\n      },\n      // Cape flows behind\n      {\n        boneIndex: BoneIndex.Cape,\n        keyframes: [\n          { time: 0, rotation: rot(10) },\n          {\n            time: 0.25,\n            rotation: quatFromEuler(degToRad(15), degToRad(2), 0),\n            easing: easeInOutSine,\n          },\n          { time: 0.5, rotation: rot(5), easing: easeInOutSine },\n          {\n            time: 0.75,\n            rotation: quatFromEuler(degToRad(15), degToRad(-2), 0),\n            easing: easeInOutSine,\n          },\n          { time: 1, rotation: rot(10), easing: easeInOutSine },\n        ],\n      },\n      leftWing,\n      rightWing,\n    ],\n  };\n}\n\nregisterAnimation(createFlyAnimation());\n\nexport { createFlyAnimation };\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAS,qBAAgC;CACvC,MAAM,YAAY;CAClB,MAAM,WAAW;CACjB,MAAM,WAAW;CAEjB,MAAM,CAAC,UAAU,aAAa,uBAAuB,IAAI,GAAG;AAE5D,QAAO;EACL,MAAM;EACN,UAAU;EACV,MAAM;EACN,QAAQ;GAEN;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU;MAAE;KACrC;MAAE,MAAM;MAAK,UAAU,IAAI,YAAY,EAAE;MAAE,QAAQ;MAAe;KAClE;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU;MAAE,QAAQ;MAAe;KAC7D;IACF;GAED;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,CAAC,YAAY,GAAG;MAAE;KAC3C;MAAE,MAAM;MAAK,UAAU,IAAI,CAAC,YAAY,EAAE;MAAE,QAAQ;MAAe;KACnE;MAAE,MAAM;MAAG,UAAU,IAAI,CAAC,YAAY,GAAG;MAAE,QAAQ;MAAe;KACnE;IACF;GAED;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,IAAI;MAAE;KAC5C;MAAE,MAAM;MAAK,UAAU,IAAI,WAAW,GAAG,GAAG,IAAI;MAAE,QAAQ;MAAe;KACzE;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,IAAI;MAAE,QAAQ;MAAe;KACpE;IACF;GACD;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,GAAG;MAAE;KAC3C;MAAE,MAAM;MAAK,UAAU,IAAI,WAAW,GAAG,GAAG,GAAG;MAAE,QAAQ;MAAe;KACxE;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,GAAG;MAAE,QAAQ;MAAe;KACnE;IACF;GAED;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,GAAG;MAAE;KAC3C;MAAE,MAAM;MAAK,UAAU,IAAI,WAAW,GAAG,GAAG,GAAG;MAAE,QAAQ;MAAe;KACxE;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,GAAG;MAAE,QAAQ;MAAe;KACnE;IACF;GACD;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,EAAE;MAAE;KAC1C;MAAE,MAAM;MAAK,UAAU,IAAI,WAAW,GAAG,GAAG,EAAE;MAAE,QAAQ;MAAe;KACvE;MAAE,MAAM;MAAG,UAAU,IAAI,UAAU,GAAG,EAAE;MAAE,QAAQ;MAAe;KAClE;IACF;GAED;IACE,WAAW,UAAU;IACrB,WAAW;KACT;MAAE,MAAM;MAAG,UAAU,IAAI,GAAG;MAAE;KAC9B;MACE,MAAM;MACN,UAAU,cAAc,SAAS,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE;MACrD,QAAQ;MACT;KACD;MAAE,MAAM;MAAK,UAAU,IAAI,EAAE;MAAE,QAAQ;MAAe;KACtD;MACE,MAAM;MACN,UAAU,cAAc,SAAS,GAAG,EAAE,SAAS,GAAG,EAAE,EAAE;MACtD,QAAQ;MACT;KACD;MAAE,MAAM;MAAG,UAAU,IAAI,GAAG;MAAE,QAAQ;MAAe;KACtD;IACF;GACD;GACA;GACD;EACF;;AAGH,kBAAkB,oBAAoB,CAAC"}