@anvpx/motion-scenes 0.0.0-stage → 0.1.1

package/dist/test-fixtures.js

@@ -0,0 +1,22 @@
+import { toJsonPointer } from "@anvpx/motion-schema";
+import { resolveTheme } from "@anvpx/motion-themes";
+export const emitContext = (overrides = {}) => ({
+    theme: resolveTheme("default"),
+    fps: 30,
+    width: 1920,
+    height: 1080,
+    duration: 6,
+    assetResolver: (ref) => ref,
+    ...overrides,
+});
+export const entryOf = (type, props, extra = {}) => ({ id: `${type}-1`, type, props, ...extra });
+/** Issues as `<json-pointer>: <message>` lines. */
+export const issuesOf = (schema, value) => {
+    const result = schema.safeParse(value);
+    return result.success
+        ? []
+        : result.error.issues.map((issue) => `${toJsonPointer(issue.path)}: ${issue.message}`);
+};
+export const words = (count) => Array.from({ length: count }, (_, i) => `w${i}`).join(" ");
+/** Markup and quotes that must never reach the fragment unescaped. */
+export const HOSTILE = '<script>alert("x")</script>';

package/dist/text-file.d.ts

@@ -0,0 +1 @@
+export declare const readText: (relative: string, base: string) => string;

package/dist/text-file.js

@@ -0,0 +1,3 @@
+/** Reads a sibling source file as LF-normalised text (browser code is shipped as text). */
+import { readFileSync } from "node:fs";
+export const readText = (relative, base) => readFileSync(new URL(relative, base), "utf8").replaceAll("\r\n", "\n");

package/dist/words.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const MAX_SCENE_WORDS = 40;
+type Props = Record<string, unknown>;
+/** On-screen words of a scene's props (used for reading time and auto duration). */
+export declare const sceneWords: (props: Props, type?: string) => number;
+/** Text fields that count towards the per-scene word budget. */
+export declare const present: (...texts: readonly (string | number | undefined)[]) => string[];
+/** Adds the "<= 40 words per scene" rule (PLAN 5b) to a scene schema. */
+export declare const limitWords: <S extends z.ZodType>(schema: S, textsOf: (value: z.output<S>) => readonly string[]) => S;
+export declare const text: z.ZodString;
+export {};

package/dist/words.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { CUSTOM_SCENE_TYPE } from "./custom.js";
+export const MAX_SCENE_WORDS = 40;
+const wordsIn = (text) => text.split(/\s+/).filter(Boolean).length;
+const countWords = (texts) => wordsIn(texts.join(" "));
+/** Keys whose values are structure, not on-screen text. */
+const STRUCTURAL_KEYS = new Set([
+    "id",
+    "from",
+    "to",
+    "direction",
+    // layout and style options (enums and counts), never read by the viewer
+    "cols",
+    "layout",
+    "mode",
+    "active",
+    "marker",
+    "winner",
+    "align",
+    "scope",
+    "color",
+    "orient",
+    "state",
+    "trend",
+    "good",
+    "lang",
+    "reveal",
+    "opacity",
+    "device",
+    "motion",
+    "rank",
+    "highlight",
+    "rating",
+    "kind",
+    "x",
+    "y",
+]);
+const countValue = (value) => {
+    if (typeof value === "string")
+        return wordsIn(value);
+    if (typeof value === "number")
+        return 1;
+    if (Array.isArray(value))
+        return value.reduce((sum, item) => sum + countValue(item), 0);
+    if (typeof value === "object" && value !== null)
+        return countRecord(value);
+    return 0;
+};
+const countRecord = (record) => Object.entries(record)
+    .filter(([key]) => !STRUCTURAL_KEYS.has(key))
+    .reduce((sum, [, value]) => sum + countValue(value), 0);
+const strings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+const field = (value, key) => typeof value === "object" && value !== null ? value[key] : undefined;
+const fieldStrings = (list, key) => (Array.isArray(list) ? list : []).flatMap((item) => strings([field(item, key)]));
+const NUMERIC_CELL = /^[^\p{L}\d]{0,2}\d[\d,.]*\s?(?:%|[KMBkmbx])?$/u;
+/** Data points are looked at, not read: only titles, labels and captions count. */
+const READ_TEXTS = {
+    chart: (p) => [
+        ...strings([p.title, p.unit, p.caption]),
+        ...fieldStrings(p.data, "label"),
+        ...strings(p.x),
+        ...fieldStrings(p.series, "name"),
+    ],
+    table: (p) => [
+        ...strings([p.title]),
+        ...strings(p.columns),
+        ...(Array.isArray(p.rows) ? p.rows : []).flatMap((row) => strings([Array.isArray(row) ? row[0] : undefined]).filter((cell) => !NUMERIC_CELL.test(cell))),
+    ],
+    "kpi-grid": (p) => [...strings([p.title]), ...fieldStrings(p.items, "label")],
+    waveform: (p) => strings([p.label]),
+};
+/** Code is skimmed: about 1.5 words per line, whatever the tokens. */
+const CODE_WORDS_PER_LINE = 1.5;
+/** On-screen words of a scene's props (used for reading time and auto duration). */
+export const sceneWords = (props, type) => {
+    // An authored scene's props carry a directory, not copy: its text is unknowable here.
+    if (type === CUSTOM_SCENE_TYPE)
+        return 0;
+    if (type === "code")
+        return Math.ceil(strings(props.lines).length * CODE_WORDS_PER_LINE);
+    const texts = type === undefined ? undefined : READ_TEXTS[type];
+    return texts ? countWords(texts(props)) : countRecord(props);
+};
+/** Text fields that count towards the per-scene word budget. */
+export const present = (...texts) => texts.filter((text) => text !== undefined).map(String);
+/** Adds the "<= 40 words per scene" rule (PLAN 5b) to a scene schema. */
+export const limitWords = (schema, textsOf) => schema.superRefine((value, ctx) => {
+    const count = countWords(textsOf(value));
+    if (count > MAX_SCENE_WORDS) {
+        ctx.addIssue({ code: "custom", message: `scene has ${count} words; max ${MAX_SCENE_WORDS}` });
+    }
+});
+export const text = z.string().min(1, "must not be empty");

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@anvpx/motion-scenes",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Scene registry and browser renderer for @anvpx/motion storyboards.",
+  "license": "MIT",
+  "author": "anvpx",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "motion-kit",
+    "scenes",
+    "animation",
+    "hyperframes",
+    "video"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.css"
+  ],
+  "dependencies": {
+    "@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"
+  },
+  "scripts": {}
 }