@12ui/design 0.2.91 → 0.2.92

package/dist/branch-core/branch-planner.js

@@ -0,0 +1,441 @@
+// GENERATED — do not edit. Copied verbatim from
+// packages/layerdoc/src/branch-core by scripts/sync-improve-core.mjs.
+/**
+ * The branch director, ported from Design Lab's `branchPlanner.ts`. One strict
+ * JSON call over the approved design decides the semantic structure of the
+ * branch: what the product is for, what the approved screen already says,
+ * whether that screen already ends, and which pages or routes complete it.
+ *
+ * Header, footer, and page-ending chrome are NEVER asked of the model — they
+ * are derived here from the surface type and the screen's position, so the
+ * model spends its inference on the design problem alone.
+ */
+import { BRANCH_PAGE_TYPES, BRANCH_PLAN_SCHEMA_VERSION, BRANCH_SURFACE_TYPES, BRANCH_VIEWPORT_SLOT_TYPES, } from './branch-plan-model.js';
+/** The branch planner's model: one low-effort structured call per run (owner rule 2026-10-03: GPT-6.1 Sol, never GPT-6 Sol). */
+export const BUILD_PLAN_MODEL = 'gpt-6.1-sol';
+/** The planner's fixed system text, sent ahead of `buildBranchPlannerPrompt`. */
+export const BRANCH_PLANNER_SYSTEM_PROMPT = 'Plan the semantic structure of a website or application branched from one approved design. Obey the supplied JSON schema exactly and add no commentary.';
+/**
+ * The brief as the planner reads it: whitespace runs collapsed and the ends
+ * trimmed, exactly as the create route cleans a build request's concept.
+ */
+export const branchConceptText = (concept) => concept.replace(/\s+/gu, ' ').trim();
+export const MIN_BRANCH_ADDITIONAL_PAGES = 0;
+/** 12ui caps total cells at eight slots (a-h), so four pages of two fit. */
+export const MAX_BRANCH_ADDITIONAL_PAGES = 4;
+export const MIN_BRANCH_VIEWPORTS = 1;
+export const MAX_BRANCH_VIEWPORTS = 2;
+export const MAX_BRANCH_SOURCE_CONTINUATIONS = 2;
+export const MAX_EDITORIAL_BRANCH_SOURCE_CONTINUATIONS = 4;
+/** Slots a-h. The parser trims any plan that would exceed this. */
+export const MAX_BRANCH_CELLS = 8;
+const MAX_SITE_PURPOSE_TEXT = 240;
+const MAX_BRANCH_STATUS_UPDATE_TEXT = 500;
+const MAX_APPROVED_SUMMARY_TEXT = 600;
+const MAX_PAGE_PURPOSE_TEXT = 240;
+const MAX_PAGE_TITLE_TEXT = 120;
+const MAX_SCREEN_CONTENT_TEXT = 480;
+const viewportSchema = () => ({
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        content: {
+            type: 'string',
+            description: 'Concise semantic direction: what this screen contains and enables. Do not prescribe appearance, layout, colors, typography, spacing, imagery treatment, or composition.',
+        },
+        slotType: {
+            type: ['string', 'null'],
+            enum: [...BRANCH_VIEWPORT_SLOT_TYPES, null],
+            description: 'Editorial content role. Use text-column for sustained prose, text-with-graphic for prose with one necessary subject-specific diagram, conclusion-footer for closing prose plus one summary graphic and footer, and other only when those do not fit. Use null for non-editorial pages.',
+        },
+        targetWords: {
+            type: ['integer', 'null'],
+            description: 'Approximate replaceable prose capacity for an editorial viewport. Use null for non-editorial pages or when slotType is null.',
+        },
+    },
+    required: ['content', 'slotType', 'targetWords'],
+});
+const pageSchema = (maxViewports, source) => ({
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        title: { type: 'string' },
+        pageType: {
+            type: 'string',
+            enum: BRANCH_PAGE_TYPES,
+            description: 'Semantic page classification used to choose an appropriate information density.',
+        },
+        surfaceType: {
+            type: 'string',
+            enum: BRANCH_SURFACE_TYPES,
+            description: 'Structural screen model: a continuous webpage, a desktop web application, a mobile application, or an immersive full-screen experience.',
+        },
+        ...(source
+            ? {
+                sourceEndsHere: {
+                    type: 'boolean',
+                    description: 'Whether the approved source already reaches its natural ending. Use true when a webpage visibly closes with its footer, unless the original brief explicitly requests a long-form continuation on this same page; true otherwise requires no source continuations.',
+                },
+            }
+            : {}),
+        purpose: {
+            type: 'string',
+            description: 'The distinct job this page or application route performs, without visual direction.',
+        },
+        viewports: {
+            type: 'array',
+            description: source
+                ? `Continuations below the approved screen: up to ${MAX_EDITORIAL_BRANCH_SOURCE_CONTINUATIONS} when pageType is editorial, otherwise up to ${MAX_BRANCH_SOURCE_CONTINUATIONS}; empty when sourceEndsHere is true.`
+                : `${MIN_BRANCH_VIEWPORTS} to ${maxViewports} screens for this page or route.`,
+            items: viewportSchema(),
+        },
+    },
+    required: [
+        'title',
+        'pageType',
+        'surfaceType',
+        ...(source ? ['sourceEndsHere'] : []),
+        'purpose',
+        'viewports',
+    ],
+});
+export const branchPlanResponseSchema = () => ({
+    type: 'json_schema',
+    name: 'create_branch_plan',
+    strict: true,
+    schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            sitePurpose: {
+                type: 'string',
+                description: 'The core visitor or user value in one short sentence.',
+            },
+            statusUpdate: {
+                type: 'string',
+                description: 'One or two concise first-person sentences for the user explaining what this branch will build and how the planned pages or routes form a coherent site or app. Do not mention internal planning, models, generation mechanics, implementation, or visual details.',
+            },
+            approvedScreenSummary: {
+                type: 'string',
+                description: 'Semantic summary of content and actions already present in the approved source. This is context to subtract, not content to repeat.',
+            },
+            sourcePage: pageSchema(MAX_EDITORIAL_BRANCH_SOURCE_CONTINUATIONS, true),
+            additionalPages: {
+                type: 'array',
+                description: `${MIN_BRANCH_ADDITIONAL_PAGES} to ${MAX_BRANCH_ADDITIONAL_PAGES} further pages or routes, each performing a distinct job. Return an empty list for a source-only continuation; at least one generated viewport is required across the whole plan.`,
+                items: pageSchema(MAX_BRANCH_VIEWPORTS, false),
+            },
+        },
+        required: ['sitePurpose', 'statusUpdate', 'approvedScreenSummary', 'sourcePage', 'additionalPages'],
+    },
+});
+/**
+ * The screen cap the caller asked for, clamped to what 12ui can dispatch.
+ * `maxScreens` is a plan-shaping hint (the CLI's `--max-screens`), so an
+ * absent or out-of-range value simply falls back to the eight-slot ceiling.
+ */
+export const branchScreenCap = (maxScreens) => (Number.isSafeInteger(maxScreens) && maxScreens >= 1
+    ? Math.min(maxScreens, MAX_BRANCH_CELLS)
+    : MAX_BRANCH_CELLS);
+const oneScreenPlanShape = (maxScreens) => (branchScreenCap(maxScreens) === 1
+    ? [
+        'Exactly one generated screen can fit. Choose one source continuation with no additionalPages, or no source continuations and one additional page with one viewport, according to the brief.',
+    ]
+    : []);
+/** A footer is not an ending when the brief explicitly keeps one long article on this page. */
+export const branchBriefRequestsLongFormSamePage = (concept) => {
+    const normalized = concept.replace(/[‐‑‒–—]/gu, '-').replace(/\s+/gu, ' ').trim();
+    return (/\blong[- ]form\b.*\b(?:same|single)[ -]page\b/iu.test(normalized)
+        || /\b(?:same|single)[ -]page\b.*\blong[- ]form\b/iu.test(normalized));
+};
+export const buildBranchPlannerPrompt = (args) => {
+    if (branchBriefRequestsLongFormSamePage(args.concept) && branchScreenCap(args.maxScreens) === 1) {
+        throw new Error('An explicit long-form same-page branch needs more than the one-screen planning floor.');
+    }
+    return [
+        'The attached image is the complete approved source design for one website or application.',
+        `Original brief: ${args.concept.trim() || '(not available; infer the product purpose from the approved source)'}`,
+        'Plan a compact, coherent branch from that source. First decide whether the approved source already reaches its natural ending. If it visibly closes with a webpage footer, set sourceEndsHere to true and return no source continuations, unless the original brief explicitly requests a long-form continuation on this same page. Each additional page or route must perform a distinct job.',
+        ...(branchBriefRequestsLongFormSamePage(args.concept)
+            ? [
+                'The original brief explicitly requests a long-form continuation on the same editorial page. A visible footer in the approved source is not the ending: set sourceEndsHere to false and plan the requested source continuations below it.',
+                'When that brief calls for a prose section, a prose-with-graphic section, more sustained prose, and a conclusion with the real footer, keep them as four source continuations in this order: text-column, text-with-graphic, text-column, conclusion-footer. Do not combine the later prose and conclusion merely because the brief describes them together.',
+            ]
+            : []),
+        'Set statusUpdate to one or two concise first-person sentences explaining what you chose to build out from the approved screen and how the pages or routes form a coherent site or app. Speak directly to the user. Do not mention internal planning, models, generation mechanics, implementation details, or visual decisions.',
+        'The JSON schema separates content density, structural surface type, source completion, and short semantic content. Fill those fields only. Header, footer, and application-shell behavior will be derived deterministically from surfaceType.',
+        'Use web_page for one continuous scrolling document, web_app for complete desktop application routes or states with a recurring application shell, mobile_app for complete mobile application screens or states, and immersive for full-screen editors, canvases, maps, media, games, or kiosks without assumed global chrome.',
+        'Keep the branch on the form factor established by the approved source. Use mobile_app only when the approved source or original brief establishes a mobile product, not merely because one route could be imagined on a phone.',
+        `Plan at most ${branchScreenCap(args.maxScreens)} screens in total across the source continuations and the additional pages. Prefer fewer, stronger screens over filling the budget.`,
+        ...oneScreenPlanShape(args.maxScreens),
+        'The image generator will separately receive the complete approved source and will decide how every screen looks. Never prescribe visual style, layout, component appearance, colors, typography, materials, spacing, atmosphere, camera choices, image treatment, or composition. Do not put header, footer, or application-shell instructions inside content.',
+        'Treat the approved source as content already seen. Summarize it accurately, then avoid presenting its main promise, example subject, action, or featured image as new body content.',
+        'Give each page or route a distinct purpose and each screen one main concept or one necessary task state. Do not pack a complete mini-site or whole workflow into every screen.',
+        'Keep marketing and editorial screens restrained in information terms. Explanatory screens may contain one compact sequence. Directories, documentation, and applications may be denser only when choices, controls, results, evidence, or feedback are necessary to complete the task.',
+        `Editorial source pages may use up to ${MAX_EDITORIAL_BRANCH_SOURCE_CONTINUATIONS} continuations; every other source page remains limited to ${MAX_BRANCH_SOURCE_CONTINUATIONS}. For editorial viewports, set slotType and targetWords as a content-capacity contract. Use text-column for one sustained reading section, text-with-graphic only when the content names one concrete subject for a single diagram, conclusion-footer only for the closing passage and footer, and other only when none fits. For non-editorial viewports set both fields to null.`,
+        'When an explicit long-form same-page brief asks for several reading regions, keep each sustained prose section in its own text-column viewport, keep any one subject-specific diagram in a text-with-graphic viewport, and reserve conclusion-footer for the final closing passage. Preserve the requested prose capacity in targetWords rather than converting it into cards, dashboards, feature grids, or callouts.',
+        'Consecutive web_page sections must continue without repeating what was above. Consecutive web_app, mobile_app, or immersive states must preserve the selected item and entered context without restating the entire preceding state.',
+        'For a two-screen directory, first support browsing with a concrete representative inventory, then carry one explicitly named selection forward. Name the inventory whenever the image model would otherwise have to invent it.',
+        'When an ending routes into another page, explain why to continue and provide the onward action, but do not perform or preview the destination page\'s main task.',
+        'Use concrete example subjects, records, destinations, projects, or result sets when the screen needs them. Choose new examples instead of defaulting to a subject prominently featured in the approved source. A genuinely necessary recurring subject still requires newly generated page-specific imagery later.',
+        'Write each content field as one short natural paragraph, normally 20 to 45 words. Use ordinary language and never refer to page numbers, screen numbers, viewport ordinals, pixel coordinates, or visual layout.',
+        branchBriefRequestsLongFormSamePage(args.concept)
+            ? 'Follow the explicit same-page editorial direction in the original brief.'
+            : 'Follow the original brief when it specifies the expansion. For same-page continuations, keep additionalPages empty; choose additional routes only when they serve the requested product intent.',
+        'Return the exact JSON schema with no commentary.',
+    ].join('\n\n');
+};
+const record = (value, label) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${label} must be an object.`);
+    return value;
+};
+const text = (value, label, maximum) => {
+    if (typeof value !== 'string')
+        throw new Error(`${label} must be a string.`);
+    const normalized = value.replace(/\s+/gu, ' ').trim();
+    if (!normalized)
+        throw new Error(`${label} must not be empty.`);
+    // Over-length text is a recoverable representation defect: the decision the
+    // model made is intact, only its verbosity is not. Truncate rather than
+    // spend another paid call.
+    return normalized.length > maximum ? normalized.slice(0, maximum).trim() : normalized;
+};
+const pageTypeOf = (value) => (typeof value === 'string' && BRANCH_PAGE_TYPES.includes(value)
+    ? value
+    : 'other');
+const surfaceTypeOf = (value, label) => {
+    if (typeof value !== 'string' || !BRANCH_SURFACE_TYPES.includes(value)) {
+        throw new Error(`${label} must be a supported surface type.`);
+    }
+    return value;
+};
+const editorialSlotContract = (item, label) => {
+    if ((item.slotType === undefined && item.targetWords === undefined)
+        || (item.slotType === null && item.targetWords === null))
+        return {};
+    if (typeof item.slotType !== 'string'
+        || !BRANCH_VIEWPORT_SLOT_TYPES.includes(item.slotType)) {
+        throw new Error(`${label}.slotType must be a supported editorial slot type or null.`);
+    }
+    if (!Number.isSafeInteger(item.targetWords) || item.targetWords < 1) {
+        throw new Error(`${label}.targetWords must be a positive whole number when slotType is set.`);
+    }
+    return {
+        slotType: item.slotType,
+        targetWords: item.targetWords,
+    };
+};
+const parseViewports = (value, label, maximum, pageType, anomalies) => {
+    if (!Array.isArray(value))
+        throw new Error(`${label} must be an array.`);
+    const viewports = value.map((entry, index) => {
+        const item = record(entry, `${label}[${index}]`);
+        return {
+            content: text(item.content, `${label}[${index}].content`, MAX_SCREEN_CONTENT_TEXT),
+            ...(pageType === 'editorial'
+                ? editorialSlotContract(item, `${label}[${index}]`)
+                : {}),
+        };
+    });
+    if (viewports.length > maximum) {
+        anomalies.push(`${label} returned ${viewports.length} screens; kept the first ${maximum}.`);
+        return viewports.slice(0, maximum);
+    }
+    return viewports;
+};
+const parseRawPage = (value, kind, label, anomalies, longFormSamePage) => {
+    const item = record(value, label);
+    const title = text(item.title, `${label}.title`, MAX_PAGE_TITLE_TEXT);
+    const purpose = text(item.purpose, `${label}.purpose`, MAX_PAGE_PURPOSE_TEXT);
+    const pageType = pageTypeOf(item.pageType);
+    const surfaceType = surfaceTypeOf(item.surfaceType, `${label}.surfaceType`);
+    const maximum = kind === 'source' && pageType === 'editorial'
+        ? MAX_EDITORIAL_BRANCH_SOURCE_CONTINUATIONS
+        : kind === 'source'
+            ? MAX_BRANCH_SOURCE_CONTINUATIONS
+            : MAX_BRANCH_VIEWPORTS;
+    const viewports = parseViewports(item.viewports, `${label}.viewports`, maximum, pageType, anomalies);
+    if (kind === 'additional' && viewports.length < MIN_BRANCH_VIEWPORTS) {
+        throw new Error(`${label}.viewports must contain at least ${MIN_BRANCH_VIEWPORTS} screen.`);
+    }
+    if (kind === 'source') {
+        if (longFormSamePage) {
+            if (pageType !== 'editorial') {
+                throw new Error(`${label}.pageType must be editorial for an explicit long-form same-page brief.`);
+            }
+            if (viewports.length === 0) {
+                throw new Error(`${label}.viewports must continue an explicit long-form same-page brief.`);
+            }
+            if (viewports.some((viewport) => viewport.slotType === undefined || viewport.targetWords === undefined)) {
+                throw new Error(`${label}.viewports must carry slotType and targetWords for an explicit long-form same-page brief.`);
+            }
+        }
+        // Cross-field invariant resolved deterministically rather than rejected:
+        // the boolean is the model's decision, the array is its representation.
+        const declaredEnd = item.sourceEndsHere === true;
+        if (declaredEnd && viewports.length > 0 && !longFormSamePage) {
+            anomalies.push('sourcePage.sourceEndsHere was true with continuations; dropped the continuations.');
+            viewports.length = 0;
+        }
+        else if (declaredEnd && longFormSamePage) {
+            anomalies.push('sourcePage.sourceEndsHere was true but the explicit long-form same-page brief overrides the visible-footer shortcut.');
+        }
+        const sourceEndsHere = longFormSamePage ? false : declaredEnd || viewports.length === 0;
+        if (!declaredEnd && sourceEndsHere) {
+            anomalies.push('sourcePage returned no continuations; treated the approved screen as already complete.');
+        }
+        return {
+            kind,
+            title,
+            pageType,
+            surfaceType,
+            purpose,
+            sourceEndsHere,
+            viewports,
+        };
+    }
+    return { kind, title, pageType, surfaceType, purpose, viewports };
+};
+/**
+ * ARBITRATION: the branch may plan more screens than the run has slots — the
+ * eight-slot ceiling, or a smaller cap the caller asked for. This is the ONE
+ * trim policy; it removes trailing screens — the last viewport of the latest
+ * multi-viewport page first, then whole trailing pages — so every surviving
+ * page keeps at least one screen and the earliest, most load-bearing screens
+ * are preserved. The floor is the source page plus one further page, so a cap
+ * below that floor leaves the floor standing. Plans at or below the cap are
+ * returned untouched.
+ */
+const trimBranchPlanToCellCap = (pages, maxCells = MAX_BRANCH_CELLS) => {
+    const trimmed = pages.map((page) => ({ ...page, viewports: [...page.viewports] }));
+    const total = () => trimmed.reduce((sum, page) => sum + page.viewports.length, 0);
+    let removed = 0;
+    while (total() > maxCells) {
+        const multi = [...trimmed].reverse().find((page) => page.viewports.length > 1);
+        if (multi) {
+            multi.viewports.pop();
+            removed += 1;
+            continue;
+        }
+        // Every surviving page holds a single screen: drop whole trailing pages,
+        // never the source page and never the last remaining additional page.
+        if (trimmed.length <= 2)
+            break;
+        removed += trimmed[trimmed.length - 1].viewports.length;
+        trimmed.pop();
+    }
+    return { pages: trimmed, removed };
+};
+/**
+ * DERIVED CHROME. For web_page surfaces the header belongs to the first
+ * viewport of an ADDITIONAL page only (source continuations sit below an
+ * approved screen that already drew it), the footer belongs to the last
+ * viewport of every page, and pageEndsHere marks the last viewport of every
+ * page on every surface. Non-webpage surfaces carry null chrome.
+ */
+const withDerivedChrome = (page, index) => {
+    const webpage = page.surfaceType === 'web_page';
+    const startOrdinal = page.kind === 'source' ? 2 : 1;
+    return {
+        index,
+        kind: page.kind,
+        title: page.title,
+        pageType: page.pageType,
+        surfaceType: page.surfaceType,
+        purpose: page.purpose,
+        ...(page.kind === 'source' ? { sourceEndsHere: page.sourceEndsHere === true } : {}),
+        viewports: page.viewports.map((viewport, viewportIndex) => ({
+            viewportOrdinal: startOrdinal + viewportIndex,
+            content: viewport.content,
+            ...(viewport.slotType
+                ? { contentSlotId: `content-p${index}-v${startOrdinal + viewportIndex}` }
+                : {}),
+            ...(viewport.slotType ? { slotType: viewport.slotType } : {}),
+            ...(viewport.targetWords !== undefined ? { targetWords: viewport.targetWords } : {}),
+            header: webpage ? startOrdinal === 1 && viewportIndex === 0 : null,
+            footer: webpage ? viewportIndex === page.viewports.length - 1 : null,
+            pageEndsHere: viewportIndex === page.viewports.length - 1,
+        })),
+    };
+};
+/**
+ * Deterministic parse of the director's JSON. Structural defects (not JSON,
+ * missing required decisions, no generated screens) reject so the bounded
+ * retry can run; recoverable representation defects (over-length text or
+ * arrays, contradictory sourceEndsHere, more screens than slots) are
+ * canonicalized here and recorded in `anomalies`.
+ *
+ * The SOURCE PAGE IS ALWAYS PLAN POSITION 0, including when the approved
+ * screen already ends: it names the design the branch grew from, so the board
+ * and the site export can place that approved screen at index.html. When it
+ * ends it carries `viewports: []` and `sourceEndsHere: true` while keeping the
+ * model's own title, pageType, surfaceType, and purpose. (A page dropped here
+ * cost the site its winner page: the export refused, or the run reported
+ * success with the approved design missing.) Additional pages still require at
+ * least one screen each.
+ *
+ * `maxCells` is the caller's screen cap (the CLI's `--max-screens`), clamped
+ * to the eight dispatchable slots. Trimming to it happens BEFORE chrome
+ * derivation and slot assignment, so every surviving page keeps at least one
+ * screen and the footer seed and dependency chains are computed on the plan
+ * that actually ships.
+ */
+export const parseBranchPlan = (raw, options) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Branch planner returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const root = record(parsed, 'Branch plan');
+    const anomalies = [];
+    if (!Array.isArray(root.additionalPages)) {
+        throw new Error('additionalPages must be an array.');
+    }
+    let additional = root.additionalPages;
+    if (additional.length > MAX_BRANCH_ADDITIONAL_PAGES) {
+        anomalies.push(`additionalPages returned ${additional.length} pages; kept the first ${MAX_BRANCH_ADDITIONAL_PAGES}.`);
+        additional = additional.slice(0, MAX_BRANCH_ADDITIONAL_PAGES);
+    }
+    const longFormSamePage = options?.longFormSamePage === true;
+    const rawPages = [
+        parseRawPage(root.sourcePage, 'source', 'sourcePage', anomalies, longFormSamePage),
+        ...additional.map((page, index) => parseRawPage(page, 'additional', `additionalPages[${index}]`, anomalies, false)),
+    ];
+    const maxCells = branchScreenCap(options?.maxCells);
+    const trim = trimBranchPlanToCellCap(rawPages, maxCells);
+    if (trim.removed > 0) {
+        anomalies.push(`Trimmed ${trim.removed} planned screen(s) to the ${maxCells}-screen cap.`);
+    }
+    // `index` is the plan position, and position 0 is the source page whether or
+    // not it contributes screens of its own.
+    const pages = trim.pages.map((page, index) => withDerivedChrome(page, index));
+    const cellCount = pages.reduce((sum, page) => sum + page.viewports.length, 0);
+    if (cellCount < 1)
+        throw new Error('Branch plan contains no screens to generate.');
+    if (cellCount > maxCells) {
+        // The trim's floor — the source page plus one further page — outranks the
+        // requested cap; the caller's own guard may trim the dispatch further.
+        anomalies.push(`The ${maxCells}-screen cap is below the ${cellCount}-screen floor of a source page plus one further page; kept the floor.`);
+    }
+    return {
+        schemaVersion: BRANCH_PLAN_SCHEMA_VERSION,
+        sitePurpose: text(root.sitePurpose, 'sitePurpose', MAX_SITE_PURPOSE_TEXT),
+        statusUpdate: text(root.statusUpdate, 'statusUpdate', MAX_BRANCH_STATUS_UPDATE_TEXT),
+        approvedScreenSummary: text(root.approvedScreenSummary, 'approvedScreenSummary', MAX_APPROVED_SUMMARY_TEXT),
+        pages,
+        anomalies,
+    };
+};
+/**
+ * The options the planner's answer is parsed with for one brief and screen cap:
+ * the cap the director was asked for, and the long-form same-page rule the
+ * brief itself triggers.
+ */
+export const branchPlanParseOptions = (concept, maxScreens) => ({
+    ...(maxScreens === undefined ? {} : { maxCells: maxScreens }),
+    ...(branchBriefRequestsLongFormSamePage(concept) ? { longFormSamePage: true } : {}),
+});
+//# sourceMappingURL=branch-planner.js.map

package/dist/branch-core/branch-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-planner.js","sourceRoot":"","sources":["../../src/branch-core/branch-planner.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,sEAAsE;AAEtE;;;;;;;;;GASG;AAEH,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,GAM3B,MAAM,wBAAwB,CAAC;AAEhC,gIAAgI;AAChI,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE9C,iFAAiF;AACjF,MAAM,CAAC,MAAM,4BAA4B,GAAG,yJAAyJ,CAAC;AAEtM;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAEnG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC;AAC3D,mEAAmE;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAC1C,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,cAAc,GAAG,GAA4B,EAAE,CAAC,CAAC;IACrD,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yKAAyK;SACvL;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;YACxB,IAAI,EAAE,CAAC,GAAG,0BAA0B,EAAE,IAAI,CAAC;YAC3C,WAAW,EAAE,wRAAwR;SACtS;QACD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;YACzB,WAAW,EAAE,8HAA8H;SAC5I;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CACjB,YAAoB,EACpB,MAAe,EACU,EAAE,CAAC,CAAC;IAC7B,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,iFAAiF;SAC/F;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,yIAAyI;SACvJ;QACD,GAAG,CAAC,MAAM;YACR,CAAC,CAAC;gBACA,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,oQAAoQ;iBAClR;aACF;YACD,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qFAAqF;SACnG;QACD,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,MAAM;gBACjB,CAAC,CAAC,kDAAkD,yCAAyC,gDAAgD,+BAA+B,sCAAsC;gBAClN,CAAC,CAAC,GAAG,oBAAoB,OAAO,YAAY,kCAAkC;YAChF,KAAK,EAAE,cAAc,EAAE;SACxB;KACF;IACD,QAAQ,EAAE;QACR,OAAO;QACP,UAAU;QACV,aAAa;QACb,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,SAAS;QACT,WAAW;KACZ;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAA4B,EAAE,CAAC,CAAC;IACtE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mQAAmQ;aACjR;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qIAAqI;aACnJ;YACD,UAAU,EAAE,UAAU,CAAC,yCAAyC,EAAE,IAAI,CAAC;YACvE,eAAe,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,GAAG,2BAA2B,OAAO,2BAA2B,mLAAmL;gBAChQ,KAAK,EAAE,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,uBAAuB,EAAE,YAAY,EAAE,iBAAiB,CAAC;KACpG;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAmB,EAAU,EAAE,CAAC,CAC9D,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAK,UAAqB,IAAI,CAAC;IAC7D,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAoB,EAAE,gBAAgB,CAAC;IAClD,CAAC,CAAC,gBAAgB,CACrB,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,UAAmB,EAAY,EAAE,CAAC,CAC5D,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/B,CAAC,CAAC;QACA,6LAA6L;KAC9L;IACD,CAAC,CAAC,EAAE,CACP,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,OAAe,EAAW,EAAE;IAC9E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClF,OAAO,CACL,iDAAiD,CAAC,IAAI,CAAC,UAAU,CAAC;WAC/D,iDAAiD,CAAC,IAAI,CAAC,UAAU,CAAC,CACtE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAA8C,EAAU,EAAE;IACjG,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO;QACL,2FAA2F;QAC3F,mBAAmB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,qEAAqE,EAAE;QACjH,gYAAgY;QAChY,GAAG,CAAC,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC;YACnD,CAAC,CAAC;gBACA,0OAA0O;gBAC1O,6VAA6V;aAC9V;YACD,CAAC,CAAC,EAAE,CAAC;QACP,iUAAiU;QACjU,+OAA+O;QAC/O,+TAA+T;QAC/T,gOAAgO;QAChO,gBAAgB,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,qIAAqI;QACrL,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC;QACtC,gWAAgW;QAChW,qLAAqL;QACrL,gLAAgL;QAChL,wRAAwR;QACxR,wCAAwC,yCAAyC,8DAA8D,+BAA+B,oXAAoX;QACliB,wZAAwZ;QACxZ,sOAAsO;QACtO,gOAAgO;QAChO,kKAAkK;QAClK,oTAAoT;QACpT,kNAAkN;QAClN,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC;YAC/C,CAAC,CAAC,0EAA0E;YAC5E,CAAC,CAAC,iMAAiM;QACrM,kDAAkD;KACnD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,KAAa,EAA2B,EAAE;IACxE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IAChH,OAAO,KAAgC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe,EAAU,EAAE;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IAChE,4EAA4E;IAC5E,wEAAwE;IACxE,2BAA2B;IAC3B,OAAO,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AACxF,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAc,EAAkB,EAAE,CAAC,CACrD,OAAO,KAAK,KAAK,QAAQ,IAAK,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC;IACnF,CAAC,CAAC,KAAuB;IACzB,CAAC,CAAC,OAAO,CACZ,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAa,EAAqB,EAAE;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAE,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAA0B,CAAC;AACpC,CAAC,CAAC;AAkBF,MAAM,qBAAqB,GAAG,CAC5B,IAA6B,EAC7B,KAAa,EACkC,EAAE;IACjD,IACE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;WAC5D,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;QACxD,OAAO,EAAE,CAAC;IACZ,IACE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;WAC9B,CAAE,0BAAgD,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAC7E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4DAA4D,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,IAAK,IAAI,CAAC,WAAsB,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oEAAoE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAkC;QACjD,WAAW,EAAE,IAAI,CAAC,WAAqB;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,KAAc,EACd,KAAa,EACb,OAAe,EACf,QAAwB,EACxB,SAAmB,EACJ,EAAE;IACjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,WAAW,EAAE,uBAAuB,CAAC;YAClF,GAAG,CAAC,QAAQ,KAAK,WAAW;gBAC1B,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;gBACnD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,SAAS,CAAC,MAAM,4BAA4B,OAAO,GAAG,CAAC,CAAC;QAC5F,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,KAAc,EACd,IAA6B,EAC7B,KAAa,EACb,SAAmB,EACnB,gBAAyB,EAChB,EAAE;IACX,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,KAAK,QAAQ,IAAI,QAAQ,KAAK,WAAW;QAC3D,CAAC,CAAC,yCAAyC;QAC3C,CAAC,CAAC,IAAI,KAAK,QAAQ;YACjB,CAAC,CAAC,+BAA+B;YACjC,CAAC,CAAC,oBAAoB,CAAC;IAC3B,MAAM,SAAS,GAAG,cAAc,CAC9B,IAAI,CAAC,SAAS,EACd,GAAG,KAAK,YAAY,EACpB,OAAO,EACP,QAAQ,EACR,SAAS,CACV,CAAC;IACF,IAAI,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oCAAoC,oBAAoB,UAAU,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wEAAwE,CAAC,CAAC;YACpG,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iEAAiE,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,EAAE,CAAC;gBACxG,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2FAA2F,CAAC,CAAC;YACvH,CAAC;QACH,CAAC;QACD,yEAAyE;QACzE,wEAAwE;QACxE,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC;QACjD,IAAI,WAAW,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;YACpG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,WAAW,IAAI,gBAAgB,EAAE,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,sHAAsH,CAAC,CAAC;QACzI,CAAC;QACD,MAAM,cAAc,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;QACxF,IAAI,CAAC,WAAW,IAAI,cAAc,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO;YACL,IAAI;YACJ,KAAK;YACL,QAAQ;YACR,WAAW;YACX,OAAO;YACP,cAAc;YACd,SAAS;SACV,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,uBAAuB,GAAG,CAC9B,KAAgB,EAChB,QAAQ,GAAG,gBAAgB,EACY,EAAE;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1F,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/E,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;YAAE,MAAM;QAC/B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC,MAAM,CAAC;QACzD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CAAC,IAAa,EAAE,KAAa,EAAkB,EAAE;IACzE,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,KAAK,UAAU,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO;QACL,KAAK;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;YAC1D,eAAe,EAAE,YAAY,GAAG,aAAa;YAC7C,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,GAAG,CAAC,QAAQ,CAAC,QAAQ;gBACnB,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,KAAK,KAAK,YAAY,GAAG,aAAa,EAAE,EAAE;gBACzE,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;YAClE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;YACpE,YAAY,EAAE,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;SAC1D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAW,EACX,OAA2D,EAC/C,EAAE;IACd,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;QACpD,SAAS,CAAC,IAAI,CAAC,4BAA4B,UAAU,CAAC,MAAM,0BAA0B,2BAA2B,GAAG,CAAC,CAAC;QACtH,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5D,MAAM,QAAQ,GAAc;QAC1B,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,CAAC;QAClF,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAC7C,IAAI,EACJ,YAAY,EACZ,mBAAmB,KAAK,GAAG,EAC3B,SAAS,EACT,KAAK,CACN,CAAC;KACH,CAAC;IACF,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,6BAA6B,QAAQ,cAAc,CAAC,CAAC;IAC7F,CAAC;IACD,6EAA6E;IAC7E,yCAAyC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACnF,IAAI,SAAS,GAAG,QAAQ,EAAE,CAAC;QACzB,0EAA0E;QAC1E,uEAAuE;QACvE,SAAS,CAAC,IAAI,CAAC,OAAO,QAAQ,4BAA4B,SAAS,uEAAuE,CAAC,CAAC;IAC9I,CAAC;IACD,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,qBAAqB,CAAC;QACzE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,EAAE,6BAA6B,CAAC;QACpF,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,yBAAyB,CAAC;QAC3G,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAe,EACf,UAAmB,EACgC,EAAE,CAAC,CAAC;IACvD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC7D,GAAG,CAAC,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACpF,CAAC,CAAC"}

package/dist/branch-core/branch-prompt.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The per-screen image prompt, ported from Design Lab's
+ * `sessionBranchPrompt.ts`. It names what each attached image IS, states where
+ * the new screen sits in the page or application flow, carries the plan's
+ * semantic content, states the derived chrome contract, and forbids pasting
+ * reference pixels. It deliberately prescribes nothing visual: the approved
+ * source is the entire visual system.
+ */
+import type { BranchCellPlacement, BranchPlan, BranchSurfaceType, BranchViewportSlotType } from './branch-plan-model.js';
+export type BranchGenerationPromptInput = {
+    /** The plan's semantic direction for this one screen. */
+    content: string;
+    /** Editorial content role; absent on legacy and non-editorial plans. */
+    slotType?: BranchViewportSlotType;
+    /** Approximate replaceable prose capacity requested by the planner. */
+    targetWords?: number;
+    productPurpose: string;
+    pagePurpose: string;
+    pageKind: 'source' | 'additional';
+    pageTitle: string;
+    surfaceType: BranchSurfaceType;
+    viewportOrdinal: number;
+    lastViewportOrdinal: number;
+    pageEndsHere: boolean;
+    header: boolean | null;
+    footer: boolean | null;
+    hasDependencyReference: boolean;
+    hasFooterReference: boolean;
+};
+export declare const buildBranchGenerationPrompt: (input: BranchGenerationPromptInput) => string;
+/**
+ * One branch screen's image prompt from the plan and its placement. The
+ * reference flags say which images actually arrive with the call, so the
+ * dispatcher rebuilds this from the references the gate released.
+ */
+export declare const branchPromptFor: (plan: Pick<BranchPlan, "sitePurpose">, placement: BranchCellPlacement, references: {
+    hasDependencyReference: boolean;
+    hasFooterReference: boolean;
+}) => string;
+//# sourceMappingURL=branch-prompt.d.ts.map

package/dist/branch-core/branch-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-prompt.d.ts","sourceRoot":"","sources":["../../src/branch-core/branch-prompt.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,2BAA2B,GAAG;IACxC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAmJF,eAAO,MAAM,2BAA2B,GAAI,OAAO,2BAA2B,KAAG,MAgBhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,EACrC,WAAW,mBAAmB,EAC9B,YAAY;IAAE,sBAAsB,EAAE,OAAO,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,KAC3E,MAeD,CAAC"}