@hyperframes/core 0.6.110 → 0.6.111

package/dist/storyboard/parseStoryboard.js

@@ -0,0 +1,275 @@
+import { DEFAULT_FRAME_STATUS, FRAME_STATUSES, } from "./types.js";
+/**
+ * Lenient parser for `STORYBOARD.md`.
+ *
+ * The canonical (structured) format is:
+ *
+ * ```markdown
+ * ---
+ * format: 1920x1080
+ * message: "Ship a launch video in an afternoon"
+ * arc: Problem → Solution
+ * audience: indie devs on X
+ * ---
+ *
+ * ## Frame 3 — The feature in action
+ * - duration: 6s
+ * - transition_in: crossfade
+ * - status: animated
+ * - src: compositions/frames/03-feature.html
+ *
+ * The diff animates line by line as the narration says "...".
+ * ```
+ *
+ * The parser is deliberately tolerant: it never throws, it accepts freeform
+ * narrative, it recognizes `Frame` / `Beat` / `Scene` section headings at H2 or
+ * H3, and it records anything surprising as a {@link StoryboardWarning} rather
+ * than failing. Unknown frontmatter / metadata keys are preserved in `extra`.
+ */
+export function parseStoryboard(source) {
+    const warnings = [];
+    const { globals, bodyStartLine, body } = parseFrontmatter(source, warnings);
+    const frames = parseFrames(body, bodyStartLine, warnings);
+    return { globals, frames, warnings };
+}
+// Headings that begin a frame section: `## Frame N`, `### Beat 1.1`, `## Scene 2`.
+// Detection-only (ends at the keyword) — the title is sliced off in code. A single
+// `[ \t]+` before the required keyword stays linear; avoids the polynomial backtracking
+// a trailing `[\s…]*(.*)$` would add on tab-heavy input (CodeQL js/polynomial-redos).
+export const FRAME_HEADING_RE = /^(#{2,3})[ \t]+(?:frame|beat|scene)\b/i;
+/** Leading separators between the frame keyword and its title text. */
+const FRAME_TITLE_SEP_RE = /^[\s.:—-]+/;
+/** Any markdown heading; captures the `#` run so section depth can be compared. */
+const HEADING_LEVEL_RE = /^(#{1,6})\s+/;
+/** A metadata list item: `- key: value` or `* key: value`. */
+const META_RE = /^\s*[-*]\s+([A-Za-z_][\w-]*)\s*:\s*(.+?)\s*$/;
+/** Leading integer of a frame label, e.g. `3` in `3 — Title` or `1` in `1.1`. */
+const LEADING_INT_RE = /^(\d+)/;
+/** First numeric token in a duration string, e.g. `6` in `6s`, `6.5` in `6.5 sec`. */
+const DURATION_NUM_RE = /(\d+(?:\.\d+)?)/;
+/** Metadata keys that all map to the transition-in field. */
+const TRANSITION_KEYS = new Set(["transition_in", "transitionin", "transition"]);
+/** Metadata keys that all map to the one-line scene description. */
+const SCENE_KEYS = new Set(["scene", "description", "summary", "caption"]);
+/**
+ * Aliases that all map to the voiceover/narration line. The single source of
+ * truth — `editStoryboard.ts` imports this so the read and write sides can't
+ * drift (one would silently fail to match the other's field name).
+ */
+export const VOICEOVER_ALIASES = ["voiceover", "vo", "voice_over", "narration"];
+const VOICEOVER_KEYS = new Set(VOICEOVER_ALIASES);
+function emptyGlobals() {
+    return { extra: {} };
+}
+function isFrameStatus(value) {
+    return FRAME_STATUSES.includes(value);
+}
+// ── Frontmatter ───────────────────────────────────────────────────────────────
+/** Locate the `---`-delimited frontmatter block, or null when there is none. */
+function findFrontmatterRange(lines, warnings) {
+    let start = 0;
+    while (start < lines.length && (lines[start] ?? "").trim() === "")
+        start++;
+    if ((lines[start] ?? "").trim() !== "---")
+        return null;
+    for (let i = start + 1; i < lines.length; i++) {
+        if ((lines[i] ?? "").trim() === "---")
+            return { start, end: i };
+    }
+    warnings.push({
+        message: "Frontmatter opening '---' has no closing '---'; treating whole file as body.",
+        line: start + 1,
+    });
+    return null;
+}
+function parseFrontmatterEntries(lines, start, end, warnings) {
+    const globals = emptyGlobals();
+    for (let i = start + 1; i < end; i++) {
+        const raw = lines[i] ?? "";
+        if (raw.trim() === "")
+            continue;
+        const colon = raw.indexOf(":");
+        if (colon === -1) {
+            warnings.push({
+                message: `Ignored non key:value frontmatter line: "${raw.trim()}"`,
+                line: i + 1,
+            });
+            continue;
+        }
+        const key = raw.slice(0, colon).trim().toLowerCase();
+        assignGlobal(globals, key, stripQuotes(raw.slice(colon + 1).trim()));
+    }
+    return globals;
+}
+function parseFrontmatter(source, warnings) {
+    const lines = source.split(/\r?\n/);
+    const range = findFrontmatterRange(lines, warnings);
+    if (!range)
+        return { globals: emptyGlobals(), bodyStartLine: 1, body: source };
+    const globals = parseFrontmatterEntries(lines, range.start, range.end, warnings);
+    const body = lines.slice(range.end + 1).join("\n");
+    return { globals, bodyStartLine: range.end + 2, body };
+}
+function assignGlobal(globals, key, value) {
+    switch (key) {
+        case "format":
+            globals.format = value;
+            break;
+        case "message":
+            globals.message = value;
+            break;
+        case "arc":
+            globals.arc = value;
+            break;
+        case "audience":
+            globals.audience = value;
+            break;
+        default:
+            globals.extra[key] = value;
+    }
+}
+/** Open a new frame section if `line` is a frame heading, else null. */
+function openFrameSection(line, headingLine) {
+    const match = FRAME_HEADING_RE.exec(line);
+    if (!match)
+        return null;
+    const headingText = line.slice(match[0].length).replace(FRAME_TITLE_SEP_RE, "").trim();
+    return { headingText, headingLine, level: (match[1] ?? "##").length, lines: [] };
+}
+/**
+ * Whether `line` ends the current frame: a non-frame heading at the same or
+ * shallower depth (e.g. a sibling `## Fonts`). Deeper sub-headings (e.g.
+ * `#### Beats`) stay part of the frame's narrative.
+ */
+function endsFrameSection(line, current) {
+    if (!current)
+        return false;
+    const heading = HEADING_LEVEL_RE.exec(line);
+    return heading !== null && (heading[1] ?? "").length <= current.level;
+}
+function parseFrames(body, bodyStartLine, warnings) {
+    const lines = body.split(/\r?\n/);
+    const sections = [];
+    let current = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        const opened = openFrameSection(line, bodyStartLine + i);
+        if (opened) {
+            sections.push(opened);
+            current = opened;
+        }
+        else if (endsFrameSection(line, current)) {
+            current = null;
+        }
+        else if (current) {
+            current.lines.push(line);
+        }
+    }
+    return sections.map((section, idx) => buildFrame(section, idx + 1, warnings));
+}
+function buildFrame(section, index, warnings) {
+    const frame = { index, status: DEFAULT_FRAME_STATUS, narrative: "", extra: {} };
+    const { number, title } = parseHeading(section.headingText);
+    if (number !== undefined)
+        frame.number = number;
+    if (title)
+        frame.title = title;
+    const narrativeLines = [];
+    for (const line of section.lines) {
+        const meta = META_RE.exec(line);
+        if (meta) {
+            applyMeta(frame, (meta[1] ?? "").toLowerCase(), (meta[2] ?? "").trim(), section.headingLine, warnings);
+        }
+        else {
+            narrativeLines.push(line);
+        }
+    }
+    frame.narrative = narrativeLines.join("\n").trim();
+    return frame;
+}
+function parseHeading(text) {
+    if (!text)
+        return {};
+    const intMatch = LEADING_INT_RE.exec(text);
+    if (!intMatch)
+        return { title: text };
+    const number = Number.parseInt(intMatch[1] ?? "", 10);
+    const rest = text
+        .slice((intMatch[0] ?? "").length)
+        .replace(/^[\s.:—-]+/, "")
+        .trim();
+    return { number, title: rest || undefined };
+}
+/** Map of metadata key (and aliases) → setter. Keeps {@link applyMeta} a flat dispatch. */
+const META_SETTERS = new Map([
+    ["duration", applyDuration],
+    ["status", applyStatus],
+    ["poster", applyPoster],
+    [
+        "src",
+        (frame, value) => {
+            frame.src = value;
+        },
+    ],
+    ...keyedSetters(TRANSITION_KEYS, (frame, value) => {
+        frame.transitionIn = value;
+    }),
+    ...keyedSetters(SCENE_KEYS, (frame, value) => {
+        frame.scene = value;
+    }),
+    ...keyedSetters(VOICEOVER_KEYS, (frame, value) => {
+        frame.voiceover = stripQuotes(value);
+    }),
+]);
+function keyedSetters(keys, setter) {
+    return [...keys].map((key) => [key, setter]);
+}
+function applyMeta(frame, key, value, headingLine, warnings) {
+    const setter = META_SETTERS.get(key);
+    if (setter)
+        setter(frame, value, headingLine, warnings);
+    else
+        frame.extra[key] = value;
+}
+function applyPoster(frame, value) {
+    const num = DURATION_NUM_RE.exec(value);
+    if (num)
+        frame.poster = Number.parseFloat(num[1] ?? "");
+}
+function applyDuration(frame, value, headingLine, warnings) {
+    frame.duration = value;
+    const num = DURATION_NUM_RE.exec(value);
+    if (num) {
+        frame.durationSeconds = Number.parseFloat(num[1] ?? "");
+        return;
+    }
+    warnings.push({
+        message: `Frame ${frame.index}: could not parse duration "${value}".`,
+        line: headingLine,
+        frameIndex: frame.index,
+    });
+}
+function applyStatus(frame, value, headingLine, warnings) {
+    const normalized = value.toLowerCase();
+    if (isFrameStatus(normalized)) {
+        frame.status = normalized;
+        return;
+    }
+    frame.extra.status = value;
+    warnings.push({
+        message: `Frame ${frame.index}: unknown status "${value}"; defaulting to "${DEFAULT_FRAME_STATUS}".`,
+        line: headingLine,
+        frameIndex: frame.index,
+    });
+}
+function stripQuotes(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=parseStoryboard.js.map

package/dist/storyboard/parseStoryboard.js.map

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

package/dist/storyboard/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Storyboard data model.
+ *
+ * A storyboard is the plan for a video before any animation work happens: an
+ * ordered set of frames (key moments) plus their narrative/script. It is
+ * authored as a single canonical markdown file (`STORYBOARD.md`) and parsed
+ * into this normalized shape for the Studio's storyboard view and for agents.
+ *
+ * See PRD: "Storyboarding in HyperFrames". The markdown stays canonical; this
+ * is the derived structure the parser produces.
+ */
+/** Canonical filename for the storyboard manifest at a project root. */
+export declare const STORYBOARD_FILENAME = "STORYBOARD.md";
+/**
+ * Canonical filename for the companion narration script. Holds the full
+ * voiceover script (voice settings, per-line delivery + timing). Optional —
+ * frames can also carry an inline `voiceover` line in {@link STORYBOARD_FILENAME}.
+ */
+export declare const SCRIPT_FILENAME = "SCRIPT.md";
+/**
+ * Lifecycle of a single frame. The agent advances each frame
+ * `outline → built → animated`; the Studio renders progress from this.
+ */
+export type FrameStatus = "outline" | "built" | "animated";
+/** The set of recognized {@link FrameStatus} values. */
+export declare const FRAME_STATUSES: readonly FrameStatus[];
+/** Default status when a frame omits one (it is still just an outline). */
+export declare const DEFAULT_FRAME_STATUS: FrameStatus;
+/** Global direction for the whole video, parsed from the frontmatter. */
+export interface StoryboardGlobals {
+    /** Canvas format as authored, e.g. `"1920x1080"`. */
+    format?: string;
+    /** One-line message / thesis of the video. */
+    message?: string;
+    /** Narrative arc, e.g. `"Problem → Solution"`. */
+    arc?: string;
+    /** Target audience, e.g. `"indie devs on X"`. */
+    audience?: string;
+    /** Any frontmatter keys outside the known set, preserved verbatim. */
+    extra: Record<string, string>;
+}
+/** A single frame: one key moment in the video. */
+export interface StoryboardFrame {
+    /** 1-based order within the storyboard, assigned by document order. */
+    index: number;
+    /** Frame number as authored (the `N` in `Frame N`), when present. */
+    number?: number;
+    /** Frame title (the text after the number), when present. */
+    title?: string;
+    /** Lifecycle status; defaults to {@link DEFAULT_FRAME_STATUS}. */
+    status: FrameStatus;
+    /** Project-relative path to the frame's HTML sub-composition, when linked. */
+    src?: string;
+    /** Duration in seconds, parsed from e.g. `"6s"`. Undefined when unparseable. */
+    durationSeconds?: number;
+    /** Raw duration string as authored, e.g. `"6s"`. */
+    duration?: string;
+    /** Transition into this frame, e.g. `"crossfade"`. */
+    transitionIn?: string;
+    /** One-line description of the key moment (the contact-sheet caption). */
+    scene?: string;
+    /** Voiceover / narration line spoken over this frame. */
+    voiceover?: string;
+    /**
+     * Representative time (seconds) to show this frame at in the contact sheet —
+     * a "poster" frame past the intro animation. Falls back to a heuristic.
+     */
+    poster?: number;
+    /** Narrative / script markdown for this frame (everything below the metadata). */
+    narrative: string;
+    /** Metadata keys outside the known set, preserved verbatim. */
+    extra: Record<string, string>;
+}
+/** A non-fatal issue encountered while parsing. The parser never throws. */
+export interface StoryboardWarning {
+    message: string;
+    /** 1-based source line number, when known. */
+    line?: number;
+    /** 1-based frame index the warning relates to, when applicable. */
+    frameIndex?: number;
+}
+/** Fully parsed storyboard manifest. */
+export interface StoryboardManifest {
+    globals: StoryboardGlobals;
+    frames: StoryboardFrame[];
+    /** Non-fatal parse issues (unknown status, unparseable duration, etc.). */
+    warnings: StoryboardWarning[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storyboard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storyboard/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3D,wDAAwD;AACxD,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAAqC,CAAC;AAEvF,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,EAAE,WAAuB,CAAC;AAE3D,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B"}

package/dist/storyboard/types.js

@@ -0,0 +1,24 @@
+/**
+ * Storyboard data model.
+ *
+ * A storyboard is the plan for a video before any animation work happens: an
+ * ordered set of frames (key moments) plus their narrative/script. It is
+ * authored as a single canonical markdown file (`STORYBOARD.md`) and parsed
+ * into this normalized shape for the Studio's storyboard view and for agents.
+ *
+ * See PRD: "Storyboarding in HyperFrames". The markdown stays canonical; this
+ * is the derived structure the parser produces.
+ */
+/** Canonical filename for the storyboard manifest at a project root. */
+export const STORYBOARD_FILENAME = "STORYBOARD.md";
+/**
+ * Canonical filename for the companion narration script. Holds the full
+ * voiceover script (voice settings, per-line delivery + timing). Optional —
+ * frames can also carry an inline `voiceover` line in {@link STORYBOARD_FILENAME}.
+ */
+export const SCRIPT_FILENAME = "SCRIPT.md";
+/** The set of recognized {@link FrameStatus} values. */
+export const FRAME_STATUSES = ["outline", "built", "animated"];
+/** Default status when a frame omits one (it is still just an outline). */
+export const DEFAULT_FRAME_STATUS = "outline";
+//# sourceMappingURL=types.js.map

package/dist/storyboard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storyboard/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAQ3C,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAA2B,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAEvF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAgB,SAAS,CAAC"}

package/dist/studio-api/createStudioApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStudioApi.d.ts","sourceRoot":"","sources":["../../src/studio-api/createStudioApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWnD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAc/D"}
+{"version":3,"file":"createStudioApi.d.ts","sourceRoot":"","sources":["../../src/studio-api/createStudioApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAYnD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAe/D"}

package/dist/studio-api/createStudioApi.js

@@ -1,5 +1,6 @@
 import { Hono } from "hono";
 import { registerProjectRoutes } from "./routes/projects.js";
+import { registerStoryboardRoutes } from "./routes/storyboard.js";
 import { registerFileRoutes } from "./routes/files.js";
 import { registerPreviewRoutes } from "./routes/preview.js";
 import { registerLintRoutes } from "./routes/lint.js";
@@ -17,6 +18,7 @@ import { registerRegistryRoutes } from "./routes/registry.js";
 export function createStudioApi(adapter) {
     const api = new Hono();
     registerProjectRoutes(api, adapter);
+    registerStoryboardRoutes(api, adapter);
     registerFileRoutes(api, adapter);
     registerPreviewRoutes(api, adapter);
     registerLintRoutes(api, adapter);

package/dist/studio-api/createStudioApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStudioApi.js","sourceRoot":"","sources":["../../src/studio-api/createStudioApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"createStudioApi.js","sourceRoot":"","sources":["../../src/studio-api/createStudioApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/studio-api/routes/storyboard.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from "hono";
+import type { StudioApiAdapter } from "../types.js";
+export declare function registerStoryboardRoutes(api: Hono, adapter: StudioApiAdapter): void;
+//# sourceMappingURL=storyboard.d.ts.map

package/dist/studio-api/routes/storyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard.d.ts","sourceRoot":"","sources":["../../../src/studio-api/routes/storyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAuCpD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAsCnF"}

package/dist/studio-api/routes/storyboard.js

@@ -0,0 +1,65 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolveWithinProject } from "../helpers/safePath.js";
+import { parseStoryboard, SCRIPT_FILENAME, STORYBOARD_FILENAME, } from "../../storyboard/index.js";
+function resolveFrames(projectDir, frames) {
+    return frames.map((frame) => {
+        let srcExists = false;
+        if (frame.src) {
+            const abs = resolveWithinProject(projectDir, frame.src);
+            srcExists = abs ? existsSync(abs) : false;
+        }
+        return { ...frame, srcExists };
+    });
+}
+/** Read the companion SCRIPT.md narration doc if it exists alongside the storyboard. */
+function readScript(projectDir) {
+    const abs = resolveWithinProject(projectDir, SCRIPT_FILENAME);
+    if (abs && existsSync(abs)) {
+        try {
+            return { exists: true, path: SCRIPT_FILENAME, content: readFileSync(abs, "utf-8") };
+        }
+        catch {
+            /* fall through to absent */
+        }
+    }
+    return { exists: false, path: SCRIPT_FILENAME, content: "" };
+}
+export function registerStoryboardRoutes(api, adapter) {
+    // Parsed storyboard manifest for a project. Markdown (STORYBOARD.md) stays
+    // canonical on disk; this returns the derived, normalized structure. When the
+    // file is absent we return `exists: false` with empty frames rather than 404,
+    // so the Studio can render an opt-in empty state.
+    api.get("/projects/:id/storyboard", async (c) => {
+        const project = await adapter.resolveProject(c.req.param("id"));
+        if (!project)
+            return c.json({ error: "not found" }, 404);
+        const abs = resolveWithinProject(project.dir, STORYBOARD_FILENAME);
+        if (!abs || !existsSync(abs)) {
+            return c.json({
+                exists: false,
+                path: STORYBOARD_FILENAME,
+                globals: { extra: {} },
+                frames: [],
+                warnings: [],
+                script: readScript(project.dir),
+            });
+        }
+        let source;
+        try {
+            source = readFileSync(abs, "utf-8");
+        }
+        catch {
+            return c.json({ error: "failed to read storyboard" }, 500);
+        }
+        const manifest = parseStoryboard(source);
+        return c.json({
+            exists: true,
+            path: STORYBOARD_FILENAME,
+            globals: manifest.globals,
+            frames: resolveFrames(project.dir, manifest.frames),
+            warnings: manifest.warnings,
+            script: readScript(project.dir),
+        });
+    });
+}
+//# sourceMappingURL=storyboard.js.map

package/dist/studio-api/routes/storyboard.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.6.110",
+  "version": "0.6.111",
   "description": "",
   "repository": {
     "type": "git",