videowright 0.1.0

package/dist/cli/ts_loader.js

@@ -0,0 +1,95 @@
+/**
+ * Runtime TS module loader for Node using tsx.
+ * Used by the CLI to import .ts config and timeline files without a build step.
+ */
+import { register } from "node:module";
+import { pathToFileURL } from "node:url";
+/**
+ * Inline ESM loader hooks that treat browser-only asset imports (.css, .svg,
+ * .png, font files, etc.) as empty modules.
+ *
+ * Consumer timeline.ts files typically import their style's tokens.css at the
+ * top level (e.g. `import '../../styles/modern/tokens.css'`). Vite handles
+ * this in the browser, but when the CLI loads timeline.ts via tsx for parsing,
+ * Node's ESM loader rejects the unknown extension. These hooks intercept such
+ * imports and return an empty module so the CLI can parse the timeline without
+ * needing the CSS content.
+ *
+ * The hooks are registered via `module.register()` with a data: URL to avoid
+ * filesystem path issues between source (TypeScript) and compiled (JavaScript)
+ * contexts.
+ */
+const ASSET_HOOKS_SOURCE = `
+const ASSET_EXTS = new Set([
+  '.css', '.scss', '.sass', '.less', '.styl', '.stylus',
+  '.svg', '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.ico',
+  '.woff', '.woff2', '.eot', '.ttf', '.otf',
+]);
+
+function isAsset(s) {
+  const q = s.indexOf('?');
+  const clean = q >= 0 ? s.slice(0, q) : s;
+  const dot = clean.lastIndexOf('.');
+  return dot >= 0 && ASSET_EXTS.has(clean.slice(dot).toLowerCase());
+}
+
+export async function resolve(specifier, context, nextResolve) {
+  if (isAsset(specifier)) {
+    return { url: 'asset-noop:' + specifier, shortCircuit: true };
+  }
+  return nextResolve(specifier, context);
+}
+
+export async function load(url, context, nextLoad) {
+  if (url.startsWith('asset-noop:')) {
+    return { format: 'module', source: 'export default {};', shortCircuit: true };
+  }
+  return nextLoad(url, context);
+}
+`;
+let assetHooksRegistered = false;
+function ensureAssetHooks() {
+    if (assetHooksRegistered)
+        return;
+    register(`data:text/javascript,${encodeURIComponent(ASSET_HOOKS_SOURCE)}`, import.meta.url);
+    assetHooksRegistered = true;
+}
+/**
+ * Dynamically import a TypeScript module from Node at runtime.
+ * Returns the module's namespace (use .default for default exports).
+ *
+ * ## tsx double-wrap heuristic
+ *
+ * When tsx loads a CommonJS-style module (or a module with `export default`),
+ * it may produce a namespace like:
+ *
+ *   { default: { __esModule: true, default: <actual-value> } }
+ *
+ * This happens because tsx transpiles `export default X` to
+ * `module.exports.default = X` + `module.exports.__esModule = true`, then
+ * the ESM interop layer wraps the whole `module.exports` as the default export.
+ *
+ * We detect this pattern (an object default with both __esModule and default keys)
+ * and unwrap it so callers always see `{ default: <actual-value>, ... }`.
+ *
+ * If tsx changes this behavior in future versions, the detection is conservative:
+ * we only unwrap when both sentinel keys are present, so a legitimate object
+ * with those keys would be the only false positive (extremely unlikely in practice).
+ */
+export async function loadModule(modulePath) {
+    ensureAssetHooks();
+    const { tsImport } = await import("tsx/esm/api");
+    const fileUrl = pathToFileURL(modulePath).href;
+    const mod = (await tsImport(fileUrl, import.meta.url));
+    // Unwrap tsx double-wrapping of default exports (see doc comment above)
+    const defaultExport = mod.default;
+    if (defaultExport &&
+        typeof defaultExport === "object" &&
+        "__esModule" in defaultExport &&
+        "default" in defaultExport) {
+        const inner = defaultExport;
+        return { ...mod, default: inner.default };
+    }
+    return mod;
+}
+//# sourceMappingURL=ts_loader.js.map

package/dist/cli/ts_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts_loader.js","sourceRoot":"","sources":["../../src/cli/ts_loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1B,CAAC;AAEF,IAAI,oBAAoB,GAAG,KAAK,CAAC;AAEjC,SAAS,gBAAgB;IACxB,IAAI,oBAAoB;QAAE,OAAO;IACjC,QAAQ,CAAC,wBAAwB,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5F,oBAAoB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IAClD,gBAAgB,EAAE,CAAC;IACnB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAC/C,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAA4B,CAAC;IAElF,wEAAwE;IACxE,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC;IAClC,IACC,aAAa;QACb,OAAO,aAAa,KAAK,QAAQ;QACjC,YAAY,IAAI,aAAa;QAC7B,SAAS,IAAI,aAAa,EACzB,CAAC;QACF,MAAM,KAAK,GAAG,aAAwC,CAAC;QACvD,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/cli/vite_helpers.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared Vite helpers used by dev.ts and render.ts.
+ * Extracted to avoid coupling dev.ts internals to render.ts.
+ */
+import type { Plugin } from "vite";
+import type { ProjectInfo } from "../types.js";
+/**
+ * Find the videowright package root by walking up from __dirname.
+ * Needed to locate the entry HTML which ships in src/cli/entry/.
+ */
+export declare function findPackageRoot(): string;
+/**
+ * Vite plugin that forces a full page reload on every file change,
+ * bypassing HMR module replacement. The player + hash routing handles
+ * restoring position after reload.
+ */
+export declare function fullReloadPlugin(): Plugin;
+/**
+ * Shape of globals injected into entry files via the virtual module.
+ */
+export interface VwGlobals {
+    timelinePath: string;
+    consumerRoot: string;
+    audioFile?: string;
+    resolvedTiming?: Record<string, number[]>;
+    audioTrackNone?: boolean;
+    renderFps?: number;
+}
+/**
+ * Vite plugin that provides a virtual module `virtual:vw-globals`.
+ * The module exports concrete values that were previously injected via
+ * Vite's `define:` config. Using a virtual module avoids text-substitution
+ * issues where `define` would rewrite `declare const` lines.
+ */
+export declare function globalsVirtualModulePlugin(globals: VwGlobals): Plugin;
+/**
+ * Vite plugin that provides a virtual module `virtual:vw-segments`.
+ * The module exports a glob-style Record<string, () => Promise<Module>>
+ * with explicit dynamic imports for each discovered segment, avoiding
+ * the alias-in-glob issue with import.meta.glob.
+ */
+export declare function segmentDiscoveryPlugin(consumerRoot: string): Plugin;
+/**
+ * Vite plugin that provides a virtual module `virtual:videowright/project`.
+ * The module exports the `ProjectInfo` object as a default export so the
+ * browser can import it synchronously with no fetch waterfall.
+ *
+ * When `onReload` is provided, timeline.ts changes trigger a re-discovery
+ * and full page reload so the homepage reflects updated metadata.
+ */
+export declare function projectVirtualModulePlugin(initialProjectInfo: ProjectInfo, opts?: {
+    consumerRoot: string;
+    onReload: () => Promise<ProjectInfo>;
+}): Plugin;
+/**
+ * Vite plugin that routes `/video/<slug>` requests to `video.html`.
+ * Replaces the old SPA fallback plugin. Serves a 404 for unknown routes.
+ *
+ * @param getKnownSlugs - getter returning the current list of valid video slugs
+ */
+export declare function videoRouteMiddlewarePlugin(getKnownSlugs: () => string[]): Plugin;
+//# sourceMappingURL=vite_helpers.d.ts.map

package/dist/cli/vite_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite_helpers.d.ts","sourceRoot":"","sources":["../../src/cli/vite_helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAW,MAAM,EAAiB,MAAM,MAAM,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAgBxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CA2BrE;AAoCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA2CnE;AAOD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,kBAAkB,EAAE,WAAW,EAC/B,IAAI,CAAC,EAAE;IACN,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC,GACC,MAAM,CAqCR;AAYD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,MAAM,EAAE,GAAG,MAAM,CAkEhF"}

package/dist/cli/vite_helpers.js

@@ -0,0 +1,273 @@
+/**
+ * Shared Vite helpers used by dev.ts and render.ts.
+ * Extracted to avoid coupling dev.ts internals to render.ts.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, extname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Find the videowright package root by walking up from __dirname.
+ * Needed to locate the entry HTML which ships in src/cli/entry/.
+ */
+export function findPackageRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        const pkgPath = resolve(dir, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+                if (pkg.name === "videowright")
+                    return dir;
+            }
+            catch {
+                // keep going
+            }
+        }
+        dir = dirname(dir);
+    }
+    // Fallback: assume __dirname is inside dist/cli/ or src/cli/
+    return resolve(__dirname, "../..");
+}
+/**
+ * Vite plugin that forces a full page reload on every file change,
+ * bypassing HMR module replacement. The player + hash routing handles
+ * restoring position after reload.
+ */
+export function fullReloadPlugin() {
+    return {
+        name: "videowright-full-reload",
+        handleHotUpdate({ server }) {
+            server.ws.send({ type: "full-reload" });
+            return [];
+        },
+    };
+}
+const VIRTUAL_GLOBALS_ID = "virtual:vw-globals";
+const RESOLVED_VIRTUAL_GLOBALS_ID = `\0${VIRTUAL_GLOBALS_ID}`;
+/**
+ * Vite plugin that provides a virtual module `virtual:vw-globals`.
+ * The module exports concrete values that were previously injected via
+ * Vite's `define:` config. Using a virtual module avoids text-substitution
+ * issues where `define` would rewrite `declare const` lines.
+ */
+export function globalsVirtualModulePlugin(globals) {
+    return {
+        name: "videowright-globals",
+        resolveId(id) {
+            if (id === VIRTUAL_GLOBALS_ID)
+                return RESOLVED_VIRTUAL_GLOBALS_ID;
+        },
+        load(id) {
+            if (id !== RESOLVED_VIRTUAL_GLOBALS_ID)
+                return;
+            const lines = [];
+            lines.push(`export const timelinePath = ${JSON.stringify(globals.timelinePath)};`);
+            lines.push(`export const consumerRoot = ${JSON.stringify(globals.consumerRoot)};`);
+            lines.push(`export const audioFile = ${globals.audioFile !== undefined ? JSON.stringify(globals.audioFile) : "undefined"};`);
+            lines.push(`export const resolvedTiming = ${globals.resolvedTiming !== undefined ? JSON.stringify(globals.resolvedTiming) : "undefined"};`);
+            lines.push(`export const audioTrackNone = ${globals.audioTrackNone !== undefined ? JSON.stringify(globals.audioTrackNone) : "undefined"};`);
+            lines.push(`export const renderFps = ${globals.renderFps !== undefined ? JSON.stringify(globals.renderFps) : "undefined"};`);
+            return `${lines.join("\n")}\n`;
+        },
+    };
+}
+const VIRTUAL_SEGMENTS_ID = "virtual:vw-segments";
+const RESOLVED_VIRTUAL_SEGMENTS_ID = `\0${VIRTUAL_SEGMENTS_ID}`;
+/**
+ * Scan the consumer's segments/ directory and return segment ids.
+ * Each segments/<id>/index.ts becomes a discovered segment.
+ */
+function discoverSegmentIds(consumerRoot) {
+    const segmentsDir = join(consumerRoot, "segments");
+    if (!existsSync(segmentsDir))
+        return [];
+    const ids = [];
+    let entries;
+    try {
+        entries = readdirSync(segmentsDir);
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const entryPath = join(segmentsDir, entry);
+        try {
+            if (!statSync(entryPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (existsSync(join(entryPath, "index.ts"))) {
+            ids.push(entry);
+        }
+    }
+    return ids.sort();
+}
+/**
+ * Vite plugin that provides a virtual module `virtual:vw-segments`.
+ * The module exports a glob-style Record<string, () => Promise<Module>>
+ * with explicit dynamic imports for each discovered segment, avoiding
+ * the alias-in-glob issue with import.meta.glob.
+ */
+export function segmentDiscoveryPlugin(consumerRoot) {
+    return {
+        name: "videowright-segment-discovery",
+        resolveId(id) {
+            if (id === VIRTUAL_SEGMENTS_ID)
+                return RESOLVED_VIRTUAL_SEGMENTS_ID;
+        },
+        load(id) {
+            if (id !== RESOLVED_VIRTUAL_SEGMENTS_ID)
+                return;
+            const segmentIds = discoverSegmentIds(consumerRoot);
+            const imports = segmentIds
+                .map((segId) => `  "/segments/${segId}/index.ts": () => import("@consumer/segments/${segId}/index.ts")`)
+                .join(",\n");
+            return `export default {\n${imports}\n};\n`;
+        },
+        configureServer(server) {
+            const segmentsDir = join(consumerRoot, "segments");
+            const invalidate = () => {
+                const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_SEGMENTS_ID);
+                if (mod) {
+                    server.moduleGraph.invalidateModule(mod);
+                    server.ws.send({ type: "full-reload" });
+                }
+            };
+            server.watcher.add(segmentsDir);
+            server.watcher.on("add", (path) => {
+                if (path.endsWith("/index.ts") && path.includes(`${segmentsDir}/`)) {
+                    invalidate();
+                }
+            });
+            server.watcher.on("unlink", (path) => {
+                if (path.endsWith("/index.ts") && path.includes(`${segmentsDir}/`)) {
+                    invalidate();
+                }
+            });
+        },
+    };
+}
+// ---- Project virtual module plugin ----
+const VIRTUAL_PROJECT_ID = "virtual:videowright/project";
+const RESOLVED_VIRTUAL_PROJECT_ID = `\0${VIRTUAL_PROJECT_ID}`;
+/**
+ * Vite plugin that provides a virtual module `virtual:videowright/project`.
+ * The module exports the `ProjectInfo` object as a default export so the
+ * browser can import it synchronously with no fetch waterfall.
+ *
+ * When `onReload` is provided, timeline.ts changes trigger a re-discovery
+ * and full page reload so the homepage reflects updated metadata.
+ */
+export function projectVirtualModulePlugin(initialProjectInfo, opts) {
+    let projectInfo = initialProjectInfo;
+    return {
+        name: "videowright-project-info",
+        resolveId(id) {
+            if (id === VIRTUAL_PROJECT_ID)
+                return RESOLVED_VIRTUAL_PROJECT_ID;
+        },
+        load(id) {
+            if (id !== RESOLVED_VIRTUAL_PROJECT_ID)
+                return;
+            return `export default ${JSON.stringify(projectInfo)};`;
+        },
+        configureServer(server) {
+            if (!opts)
+                return;
+            const videosDir = join(opts.consumerRoot, "videos");
+            const reload = async () => {
+                projectInfo = await opts.onReload();
+                const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_PROJECT_ID);
+                if (mod) {
+                    server.moduleGraph.invalidateModule(mod);
+                }
+                server.ws.send({ type: "full-reload" });
+            };
+            const onTimelineChange = (path) => {
+                if (path.endsWith("timeline.ts") && path.includes(`${videosDir}/`)) {
+                    reload();
+                }
+            };
+            server.watcher.add(videosDir);
+            server.watcher.on("change", onTimelineChange);
+            server.watcher.on("add", onTimelineChange);
+            server.watcher.on("unlink", onTimelineChange);
+        },
+    };
+}
+// ---- Video route middleware plugin ----
+/** Paths that should never be intercepted by the routing middleware. */
+const VITE_INTERNAL_PREFIXES = ["/@vite/", "/@fs/", "/@id/", "/node_modules/", "/__vite"];
+/** Minimal 404 HTML served for unknown routes. */
+const NOT_FOUND_HTML = "<!doctype html><html><head><title>Not found</title></head>" +
+    '<body><h1>Not found</h1><p><a href="/">Back to videos</a></p></body></html>';
+/**
+ * Vite plugin that routes `/video/<slug>` requests to `video.html`.
+ * Replaces the old SPA fallback plugin. Serves a 404 for unknown routes.
+ *
+ * @param getKnownSlugs - getter returning the current list of valid video slugs
+ */
+export function videoRouteMiddlewarePlugin(getKnownSlugs) {
+    return {
+        name: "videowright-video-route",
+        configureServer(server) {
+            // Registered early (before Vite's static-serve middleware) so we can
+            // intercept `/video/<slug>` requests and rewrite them to video.html
+            // before Vite tries to resolve them as filesystem paths. Asset and
+            // internal paths are passed through via explicit checks below.
+            server.middlewares.use((req, res, next) => {
+                if (!req.url || req.method !== "GET") {
+                    next();
+                    return;
+                }
+                const url = req.url.split("?")[0];
+                // Exact root — let Vite serve index.html
+                if (url === "/" || url === "/index.html") {
+                    next();
+                    return;
+                }
+                // Known HTML entries — pass through
+                if (url === "/video.html" || url === "/render.html") {
+                    next();
+                    return;
+                }
+                // Vite internal paths — pass through
+                for (const prefix of VITE_INTERNAL_PREFIXES) {
+                    if (url.startsWith(prefix)) {
+                        next();
+                        return;
+                    }
+                }
+                // Paths with file extensions (assets) — pass through
+                if (extname(url)) {
+                    next();
+                    return;
+                }
+                // Video route: /video/<slug> or /video/<slug>/
+                const videoMatch = url.match(/^\/video\/([^/]+)\/?$/);
+                if (videoMatch) {
+                    const slug = decodeURIComponent(videoMatch[1]);
+                    if (getKnownSlugs().includes(slug)) {
+                        // Rewrite to video.html so Vite serves it; browser URL stays the same
+                        req.url = "/video.html";
+                        next();
+                        return;
+                    }
+                    // Unknown slug — 404
+                    res.statusCode = 404;
+                    res.setHeader("Content-Type", "text/html");
+                    res.end(NOT_FOUND_HTML);
+                    return;
+                }
+                // Anything else — 404
+                res.statusCode = 404;
+                res.setHeader("Content-Type", "text/html");
+                res.end(NOT_FOUND_HTML);
+            });
+        },
+    };
+}
+//# sourceMappingURL=vite_helpers.js.map

package/dist/cli/vite_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite_helpers.js","sourceRoot":"","sources":["../../src/cli/vite_helpers.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { PlayerContext, SegmentSpec, Segment, TimelineEntry, TimelineMeta, ResolvedTimelineMeta, Timeline, Timing, Voiceover, AudioTrack, Transition, TransitionContext, Config, VideoSummary, ProjectInfo, } from "./types.js";
+export { SEGMENT_BRAND } from "./types.js";
+export { defineSegment } from "./segment/index.js";
+export { defineConfig } from "./segment/index.js";
+export { buildSegmentLoaderMap, buildTransitionLoaderMap, validateTimeline, applyMetaDefaults, } from "./timeline/index.js";
+export type { SegmentLoaderMap, TransitionLoaderMap, TimelineError, TimelineValidationResult, } from "./timeline/index.js";
+export { cut, fade, slideLeft, slideRight, slideUp, slideDown, } from "./player/transitions/index.js";
+export { script } from "./script/index.js";
+export { Player } from "./player/index.js";
+export type { PlayerOptions } from "./player/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACX,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,GACxB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,GAAG,EACH,IAAI,EACJ,SAAS,EACT,UAAU,EACV,OAAO,EACP,SAAS,GACT,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Public API barrel -- exports added as modules are implemented.
+export { SEGMENT_BRAND } from "./types.js";
+// Segment authoring
+export { defineSegment } from "./segment/index.js";
+export { defineConfig } from "./segment/index.js";
+// Timeline loader
+export { buildSegmentLoaderMap, buildTransitionLoaderMap, validateTimeline, applyMetaDefaults, } from "./timeline/index.js";
+// Built-in transitions
+export { cut, fade, slideLeft, slideRight, slideUp, slideDown, } from "./player/transitions/index.js";
+// Script helper
+export { script } from "./script/index.js";
+// Player
+export { Player } from "./player/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAoBjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,kBAAkB;AAClB,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAQ7B,uBAAuB;AACvB,OAAO,EACN,GAAG,EACH,IAAI,EACJ,SAAS,EACT,UAAU,EACV,OAAO,EACP,SAAS,GACT,MAAM,+BAA+B,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/player/hash_router.d.ts

@@ -0,0 +1,23 @@
+/**
+ * URL hash routing for the player.
+ * Format: #/<segmentId>/<beat>
+ */
+export interface HashState {
+    segmentId: string;
+    beat: number;
+}
+/** Parse location.hash into a HashState, or null if absent/malformed. */
+export declare function read(): HashState | null;
+/** Write a HashState to the URL via replaceState (no history entry). */
+export declare function write(state: HashState): void;
+/**
+ * Read ?to=<id> query parameter. If present, returns the id,
+ * removes the query, and replaces history. Returns null if absent.
+ */
+export declare function readQueryFallback(): string | null;
+/**
+ * Listen for hashchange events. Calls handler with the parsed HashState
+ * when the hash changes to a valid state. Returns an unsubscribe function.
+ */
+export declare function onChange(handler: (s: HashState) => void): () => void;
+//# sourceMappingURL=hash_router.d.ts.map

package/dist/player/hash_router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash_router.d.ts","sourceRoot":"","sources":["../../src/player/hash_router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAID,yEAAyE;AACzE,wBAAgB,IAAI,IAAI,SAAS,GAAG,IAAI,CAMvC;AAED,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAUjD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CASpE"}

package/dist/player/hash_router.js

@@ -0,0 +1,49 @@
+/**
+ * URL hash routing for the player.
+ * Format: #/<segmentId>/<beat>
+ */
+const HASH_RE = /^#\/([^/]+)\/(\d+)$/;
+/** Parse location.hash into a HashState, or null if absent/malformed. */
+export function read() {
+    const hash = location.hash;
+    if (!hash)
+        return null;
+    const m = hash.match(HASH_RE);
+    if (!m)
+        return null;
+    return { segmentId: m[1], beat: Number(m[2]) };
+}
+/** Write a HashState to the URL via replaceState (no history entry). */
+export function write(state) {
+    history.replaceState(null, "", `#/${state.segmentId}/${state.beat}`);
+}
+/**
+ * Read ?to=<id> query parameter. If present, returns the id,
+ * removes the query, and replaces history. Returns null if absent.
+ */
+export function readQueryFallback() {
+    const params = new URLSearchParams(location.search);
+    const toId = params.get("to");
+    if (!toId)
+        return null;
+    params.delete("to");
+    const remaining = params.toString();
+    const newUrl = location.pathname + (remaining ? `?${remaining}` : "") + location.hash;
+    history.replaceState(null, "", newUrl);
+    return toId;
+}
+/**
+ * Listen for hashchange events. Calls handler with the parsed HashState
+ * when the hash changes to a valid state. Returns an unsubscribe function.
+ */
+export function onChange(handler) {
+    const listener = () => {
+        const state = read();
+        if (state) {
+            handler(state);
+        }
+    };
+    window.addEventListener("hashchange", listener);
+    return () => window.removeEventListener("hashchange", listener);
+}
+//# sourceMappingURL=hash_router.js.map

package/dist/player/hash_router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash_router.js","sourceRoot":"","sources":["../../src/player/hash_router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,yEAAyE;AACzE,MAAM,UAAU,IAAI;IACnB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,KAAK,CAAC,KAAgB;IACrC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAChC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;IACtF,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA+B;IACvD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,IAAI,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC"}

package/dist/player/hud.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dev-mode HUD overlay.
+ * Shows segment info, timing, voiceover, mode, keyboard reference, errors.
+ */
+export interface HudState {
+    segmentId: string;
+    beat: number;
+    segmentTime: number;
+    totalTime: number;
+    voiceover?: string;
+    mode: "interactive" | "render";
+    ended: boolean;
+    error?: {
+        segmentId: string;
+        message: string;
+        stack?: string;
+    };
+    playbackMode?: "idle" | "playing";
+}
+export interface HudOptions {
+    onPlayToggle?: () => void;
+}
+export interface Hud {
+    el: HTMLDivElement;
+    update(state: HudState): void;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    destroy(): void;
+    readonly visible: boolean;
+}
+export declare function createHud(options?: HudOptions): Hud;
+//# sourceMappingURL=hud.d.ts.map

package/dist/player/hud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud.d.ts","sourceRoot":"","sources":["../../src/player/hud.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,GAAG;IACnB,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAoMD,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,GAAG,CA6InD"}