@anvpx/motion-scenes 0.1.0 → 0.1.1

package/dist/custom.js

@@ -1,6 +1,7 @@
 import { isAbsolute, posix, relative, resolve } from "node:path";
 import { SceneEntryBaseSchema, } from "@anvpx/motion-schema";
 import { rootElement, safePadding } from "./define-scene.js";
+import { isSharedModulePath } from "./runtime-files.js";
 /** The storyboard `type` that means "the author wrote this scene". */
 export const CUSTOM_SCENE_TYPE = "custom";
 /** The bare specifiers a scene script may import; everything else must be a relative path. */
@@ -77,6 +78,11 @@ export const readRelativeClosure = async (entryJs, read) => {
         for (const specifier of scan.escaping)
             escaping.add(specifier);
         for (const specifier of scan.paths) {
+            // Shared modules are virtual build outputs, never reads from the source
+            // filesystem. Resolve from the same scenes/<id>/ location used by emit.
+            const emitted = posix.normalize(posix.join("scenes/custom", item.base, specifier));
+            if (isSharedModulePath(emitted))
+                continue;
             const path = resolveRelative(item.base, specifier);
             if (path === undefined) {
                 escaping.add(specifier);

package/dist/runtime/compose.d.ts

@@ -0,0 +1,21 @@
+export { clamp01, ease } from "./easing.js";
+/**
+ * Normalized interval in seconds. A zero duration is an instantaneous cut;
+ * negative durations are invalid. No prior samples or DOM state are read.
+ * @param {number} time
+ * @param {number} start
+ * @param {number} duration
+ */
+export declare const progress: (time: number, start: number, duration: number) => number;
+/** Numeric interpolation; amount may overshoot for spring or anticipation.
+ * @param {number} from
+ * @param {number} to
+ * @param {number} amount
+ */
+export declare const interpolate: (from: number, to: number, amount: number) => number;
+/** Start time for an item. A negative step expresses a reversed order.
+ * @param {number} index non-negative integer
+ * @param {number} step seconds between items
+ * @param {number} [start=0] first item's time
+ */
+export declare const stagger: (index: number, step: number, start?: number) => number;

package/dist/runtime/compose.js

@@ -0,0 +1,43 @@
+// @ts-check
+// Style-neutral authoring helpers. Every sample depends only on its inputs.
+export { clamp01, ease } from "./easing.js";
+/** @param {number[]} values */
+const finite = (...values) => {
+    if (!values.every(Number.isFinite))
+        throw new RangeError("composition inputs must be finite");
+};
+/**
+ * Normalized interval in seconds. A zero duration is an instantaneous cut;
+ * negative durations are invalid. No prior samples or DOM state are read.
+ * @param {number} time
+ * @param {number} start
+ * @param {number} duration
+ */
+export const progress = (time, start, duration) => {
+    finite(time, start, duration);
+    if (duration < 0)
+        throw new RangeError("duration must be non-negative");
+    if (duration === 0)
+        return time < start ? 0 : 1;
+    return Math.max(0, Math.min(1, (time - start) / duration));
+};
+/** Numeric interpolation; amount may overshoot for spring or anticipation.
+ * @param {number} from
+ * @param {number} to
+ * @param {number} amount
+ */
+export const interpolate = (from, to, amount) => {
+    finite(from, to, amount);
+    return from + (to - from) * amount;
+};
+/** Start time for an item. A negative step expresses a reversed order.
+ * @param {number} index non-negative integer
+ * @param {number} step seconds between items
+ * @param {number} [start=0] first item's time
+ */
+export const stagger = (index, step, start = 0) => {
+    if (!Number.isInteger(index) || index < 0)
+        throw new RangeError("index must be a non-negative integer");
+    finite(step, start);
+    return start + index * step;
+};

package/dist/runtime-files.d.ts

@@ -1,2 +1,4 @@
+/** True only for a browser module that this package emits; does not read disk. */
+export declare const isSharedModulePath: (path: string) => boolean;
 /** Shared browser modules; the build emits them once under `runtime/` and `shared/`. */
 export declare const runtimeFiles: () => Map<string, string>;

package/dist/runtime-files.js

@@ -1,7 +1,10 @@
 import { readText } from "./text-file.js";
-const RUNTIME_MODULES = ["easing.js", "timeline.js", "mount.js"];
+const RUNTIME_MODULES = ["easing.js", "timeline.js", "mount.js", "compose.js"];
 /** Pure helpers shared with emit time; they import `../runtime/easing.js`, so they sit beside it. */
 const SHARED_MODULES = ["motion.js", "format.js"];
+/** True only for a browser module that this package emits; does not read disk. */
+export const isSharedModulePath = (path) => RUNTIME_MODULES.some((name) => path === `runtime/${name}`) ||
+    SHARED_MODULES.some((name) => path === `shared/${name}`);
 /** Shared browser modules; the build emits them once under `runtime/` and `shared/`. */
 export const runtimeFiles = () => new Map([
     ...RUNTIME_MODULES.map((name) => [

package/dist/scenes/scene3d/index.js

@@ -32,6 +32,7 @@ const copy = (props) => {
 };
 const render = (props) => {
     const data = [
+        `data-model="${esc(props.model ?? "knot")}"`,
         `data-post="${esc(props.post)}"`,
         `data-light="${esc(props.light)}"`,
         `data-material="${esc(props.material)}"`,
@@ -45,7 +46,7 @@ export const scene3dScene = defineScene({
     type: "scene3d",
     configSchema,
     meta: {
-        purpose: "WebGL diorama (vendored three.js): post, light, material, environment presets; flat 2D canvas fallback without WebGL. 3D output is machine+GPU stable, not portable.",
+        purpose: "WebGL diorama (vendored three.js): post, light, material, environment presets; model presets knot|gem|sphere|torus; flat 2D canvas fallback without WebGL. 3D output is machine+GPU stable, not portable.",
         example: { title: "Orbit" },
     },
     style: readText("./style.css", import.meta.url),

package/dist/scenes/scene3d/scene.js

@@ -43,6 +43,25 @@ const MATERIAL = {
     metal: { roughness: 0.3, metalness: 1, emissiveIntensity: 0 },
     emissive: { roughness: 0.45, metalness: 0, emissiveIntensity: 1.6 },
 };
+/**
+ * Hero geometry per `model` preset. These are procedural shapes, not loaded
+ * GLB files: the scene stays offline and deterministic. `gem` is a faceted
+ * low-poly stone; unknown names fall back to the knot.
+ * @param {string} name
+ * @returns {any}
+ */
+const modelGeometry = (name) => {
+    switch (name) {
+        case "gem":
+            return new THREE.OctahedronGeometry(1.28, 0);
+        case "sphere":
+            return new THREE.SphereGeometry(0.95, 48, 32);
+        case "torus":
+            return new THREE.TorusGeometry(0.95, 0.28, 32, 96);
+        default:
+            return new THREE.TorusKnotGeometry(0.82, 0.27, 160, 32);
+    }
+};
 /**
  * @param {Record<string, any>} table
  * @param {string | undefined} name
@@ -241,7 +260,7 @@ const flatStage = (canvas, presets, duration) => {
  * library) returns null so the caller falls back to the 2D diorama instead of a black frame.
  * @param {HTMLCanvasElement} canvas
  * @param {HTMLElement} root
- * @param {{ post: any, light: any, material: any, env: any }} presets
+ * @param {{ post: any, light: any, material: any, model?: string, env: any }} presets
  * @param {number} duration
  */
 const glStage = (canvas, root, presets, duration) => {
@@ -293,14 +312,17 @@ const glStage = (canvas, root, presets, duration) => {
     floor.receiveShadow = true;
     scene.add(floor);
     const surface = presets.material;
+    const modelName = presets.model ?? "knot";
+    const geometry = modelGeometry(modelName);
     const heroMaterial = new THREE.MeshStandardMaterial({
         color: new THREE.Color(accent),
         roughness: surface.roughness,
         metalness: surface.metalness,
         emissive: new THREE.Color(accent2),
         emissiveIntensity: surface.emissiveIntensity * 0.35,
+        flatShading: modelName === "gem",
     });
-    const hero = new THREE.Mesh(new THREE.TorusKnotGeometry(0.82, 0.27, 160, 32), heroMaterial);
+    const hero = new THREE.Mesh(geometry, heroMaterial);
     hero.position.y = 0.12;
     hero.castShadow = true;
     scene.add(hero);
@@ -386,6 +408,7 @@ export function createScene(root, config, ctx) {
         post: pick(POST, box?.dataset.post) ?? POST.cinematic,
         light: pick(LIGHT, box?.dataset.light) ?? LIGHT.studio,
         material: pick(MATERIAL, box?.dataset.material) ?? MATERIAL.clay,
+        model: box?.dataset.model ?? "knot",
         env,
         bg: env.bg,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvpx/motion-scenes",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scene registry and browser renderer for @anvpx/motion storyboards.",
   "license": "MIT",
   "author": "anvpx",
@@ -28,9 +28,9 @@
     "dist/**/*.css"
   ],
   "dependencies": {
-    "@anvpx/motion-assets": "0.1.0",
-    "@anvpx/motion-schema": "0.1.0",
-    "@anvpx/motion-themes": "0.1.0",
+    "@anvpx/motion-assets": "0.1.1",
+    "@anvpx/motion-schema": "0.1.1",
+    "@anvpx/motion-themes": "0.1.1",
     "postprocessing": "6.39.5",
     "three": "0.186.0",
     "zod": "4.6.7"