@aglyn/plugins-ai 1.0.0-beta.230 → 1.0.0-beta.231

package/src/lib/layout-language/ai-layout-language.js

@@ -0,0 +1,446 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_ICON_WORDS } from "../runtime/ai-icon-library.js";
+/**
+ * The compact layout language (AGL-3660): what a model designs a page, and a
+ * site's header and footer, in — and the one place its shape is declared.
+ *
+ * ── Why a language, not a tree ───────────────────────────────────────────
+ *
+ * A page used to be asked for as a raw element tree, packed as escaped JSON
+ * text inside a tool call and held to the doctrine's building rules: Grid
+ * items sized as strings, every child attached, one h1, a destination on
+ * every button, headings under their ceiling. A real model kept about half
+ * of a page's sections on the first try, and a Free section was cut off at
+ * its token ceiling. The founder chose a language over a library of section
+ * templates (10/7): every page is designed for its own request, so no two
+ * sites come out alike, and the rules hold because CODE writes the tree.
+ *
+ * So the model says WHAT each section is and how it is arranged, in a few
+ * words of structure, and writes every word a visitor reads; the compiler
+ * (`ai-layout-compiler.ts`) turns that into the element tree with the
+ * palette's elements and the theme's tokens, by construction.
+ *
+ * ── The shape ────────────────────────────────────────────────────────────
+ *
+ * A page is its plan's sections, in order. A SECTION is
+ *  - `band`  — its background: `plain` (the page), `soft` (a paper band),
+ *              `brand` (the brand color) or `dark` (always dark);
+ *  - `cols`  — a row of columns by relative width, as `[7, 5]` or `[1, 1, 1]`,
+ *              up to four; absent, one column;
+ *  - `align` — `start` or `center`;
+ *  - `blocks` — what it shows, top to bottom.
+ *
+ * A BLOCK is one thing a visitor reads or uses. Its `kind` is one of
+ * `AI_LAYOUT_BLOCK_KINDS`; `col` places it in a column of the row (0 first),
+ * and a block with no `col` spans the section — above the row when it comes
+ * before the first placed block, below it when it comes after. `text` is its
+ * words, `to` where it goes, `style` its emphasis and `icon` a word from the
+ * icon library. A group — `list`, `cards`, `steps`, `stats`, `quotes`,
+ * `faq` — carries its `items`, each a `title`, a `text`, and optionally its
+ * own `to` and `icon`.
+ *
+ * Where a block goes (`to`): `page:<id>` for a page of this site (its label
+ * works too), `#<n>` for section n of this page, `form` for the site's form,
+ * a form's or a component's id for a `form` or `component` block, or an
+ * `https:` address the brief gave.
+ *
+ * A site's header and footer are two sections in the same language
+ * (`AI_LAYOUT_FRAME_TOOL`): the header's brand and navigation are the
+ * site's own and written by the compiler, so the model gives the header its
+ * band, its alignment and an optional call-to-action button; the footer is
+ * a section like any other.
+ *
+ * ── Cheap by shape ───────────────────────────────────────────────────────
+ *
+ * The schema is a structured object in the tool input (never JSON text in a
+ * string), small enough for a strict tool (`tool-schema-limits.spec.ts`), and
+ * the language's instructions ride in the cached prefix. A section is a few
+ * dozen words of structure beside its copy, so a whole page is one answer.
+ */ /** Every kind of block, in the order the schema lists them. */ export const AI_LAYOUT_BLOCK_KINDS = [
+    'eyebrow',
+    'heading',
+    'lede',
+    'text',
+    'note',
+    'list',
+    'button',
+    'image',
+    'cards',
+    'steps',
+    'stats',
+    'quotes',
+    'faq',
+    'form',
+    'component'
+];
+/** The kinds that carry `items`. */ export const AI_LAYOUT_GROUP_KINDS = new Set([
+    'list',
+    'cards',
+    'steps',
+    'stats',
+    'quotes',
+    'faq'
+]);
+export const AI_LAYOUT_BANDS = [
+    'plain',
+    'soft',
+    'brand',
+    'dark'
+];
+export const AI_LAYOUT_ALIGNS = [
+    'start',
+    'center'
+];
+export const AI_LAYOUT_STYLES = [
+    'primary',
+    'secondary',
+    'quiet',
+    'large'
+];
+/** The most columns a row holds; a fifth is folded into the fourth. */ export const AI_LAYOUT_MAX_COLS = 4;
+/**
+ * The most items a group shows: one under the eight copies rule 8 reads as a
+ * list typed out by hand, which belongs in a dataset.
+ */ export const AI_LAYOUT_MAX_ITEMS = 7;
+/** The most quotes a group shows: each is a gap the owner fills with a real one. */ export const AI_LAYOUT_MAX_QUOTES = 3;
+const ITEM_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'title',
+        'text',
+        'to',
+        'icon'
+    ],
+    properties: {
+        title: {
+            type: 'string'
+        },
+        text: {
+            type: 'string'
+        },
+        to: {
+            type: 'string'
+        },
+        icon: {
+            type: 'string'
+        }
+    }
+};
+const BLOCK_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'kind',
+        'col',
+        'text',
+        'to',
+        'style',
+        'icon',
+        'items'
+    ],
+    properties: {
+        kind: {
+            type: 'string',
+            enum: [
+                ...AI_LAYOUT_BLOCK_KINDS
+            ]
+        },
+        col: {
+            type: 'integer'
+        },
+        text: {
+            type: 'string'
+        },
+        to: {
+            type: 'string'
+        },
+        style: {
+            type: 'string',
+            enum: [
+                ...AI_LAYOUT_STYLES,
+                'none'
+            ]
+        },
+        icon: {
+            type: 'string'
+        },
+        items: {
+            type: 'array',
+            items: ITEM_SCHEMA
+        }
+    }
+};
+const SECTION_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'band',
+        'cols',
+        'align',
+        'blocks'
+    ],
+    properties: {
+        band: {
+            type: 'string',
+            enum: [
+                ...AI_LAYOUT_BANDS
+            ]
+        },
+        cols: {
+            type: 'array',
+            items: {
+                type: 'integer'
+            }
+        },
+        align: {
+            type: 'string',
+            enum: [
+                ...AI_LAYOUT_ALIGNS
+            ]
+        },
+        blocks: {
+            type: 'array',
+            items: BLOCK_SCHEMA
+        }
+    }
+};
+/** The page tool: every section of one page, in plan order, in one answer. */ export const AI_LAYOUT_PAGE_TOOL = {
+    name: 'submit_page',
+    description: 'Submit the page: one entry in sections for each planned section, in order, in the layout language.',
+    strict: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: [
+            'sections'
+        ],
+        properties: {
+            sections: {
+                type: 'array',
+                items: SECTION_SCHEMA
+            }
+        }
+    }
+};
+/** The frame tool: the site's header and footer, in the same language. */ export const AI_LAYOUT_FRAME_TOOL = {
+    name: 'submit_frame',
+    description: "Submit the site's header and footer, each as a section in the layout language.",
+    strict: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        required: [
+            'header',
+            'footer'
+        ],
+        properties: {
+            header: SECTION_SCHEMA,
+            footer: SECTION_SCHEMA
+        }
+    }
+};
+/**
+ * The language as a model is taught it: the cached instructions both doors
+ * share. Every word of copy is the model's; this says only how a design is
+ * written down and what each word becomes.
+ */ export const AI_LAYOUT_LANGUAGE_TEXT = [
+    "You design web pages in a compact layout language. You decide the structure and write every word; the platform turns your design into the page, with the site's theme, spacing and type, so never describe styling beyond the words below.",
+    '',
+    'A page is a list of sections, one for each section the plan names, in that order. A section has:',
+    '- band: plain (the page background), soft (a light band), brand (the brand color) or dark (always dark). Vary the bands down a page so neighboring sections read apart; keep brand and dark to one or two sections a page.',
+    '- cols: relative column widths for a row, such as [1, 1] for halves, [7, 5] for a wide and a narrow column, or [1, 1, 1]; at most 4. [] for one column.',
+    '- align: start or center.',
+    '- blocks: what the section shows, top to bottom. A block with col 0 or more goes in that column of the row (0 is the first); a block with col -1 spans the whole section, above the row when it comes first and below it when it comes last.',
+    'Every field is always written: a block that does not use one writes "" (text, to, icon), "none" (style), -1 (col) or [] (items); an item that does not use one writes "".',
+    '',
+    'Block kinds:',
+    "- eyebrow: a short label above a heading. heading: a heading; the first heading of the page's first section is the page's title, and the first heading of every other section is that section's heading. lede: the larger sentence under a heading. text: a paragraph. note: small print.",
+    '- button: text is the label and to says where it goes; style primary, secondary or quiet. Two buttons in a row read as a pair.',
+    '- image: text describes the picture to place, which becomes its alt text; the owner adds the picture. icon names a drawing to show until then.',
+    '- list: items are the lines (title only; text may be empty).',
+    "- cards, steps, stats, faq: items, each with a title and a text. cards are features or services; steps are numbered; stats are a figure (title) with its label (text), only for figures the brief gives; faq items are a question (title) and its answer (text). Use no quotes block: the site has no customer's words to show.",
+    "- form: places a saved form by its id in to. component: places a reusable component by its id in to; its items fill the component's props, title the prop name and text the value.",
+    '- style large on a heading makes the page title display-sized. icon (on a block or an item) is one of: ' + AI_ICON_WORDS.join(', ') + '.',
+    '',
+    "Where a link goes (to): page:<page id> for a page of this site; #<n> for section n of this page (counted from 1); form for the site's form; or an https: address the brief gives. A button the page has nowhere to send is left out. A to value is never written into words: in text, name a page by its title.",
+    '',
+    "Writing: plain, specific copy in the site's voice, from the brief, the business and its audience, never filler. Keep a page title under 70 characters and a section heading under 80. The site is published exactly as you write it, so where the brief leaves out a fact such as a price, a figure, a name, a phone number, an email, an address or opening hours, leave it out: write the sentence without it, and make no list line, card or contact row for it. Never write a placeholder or a gap in square brackets, and never invent the fact. Never invent a customer, a review, an award or a statistic.",
+    '',
+    'Design each page for this business and this request: choose the bands, the rows and the blocks that tell its story best, so no two sites read alike.'
+].join('\n');
+// ── Reading an answer ────────────────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function text(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function oneOf(value, values) {
+    return typeof value === 'string' && values.includes(value) ? value : undefined;
+}
+function readItem(raw) {
+    if (!isRecord(raw)) return null;
+    const item = {
+        title: typeof raw['title'] === 'string' ? raw['title'] : '',
+        text: typeof raw['text'] === 'string' ? raw['text'] : ''
+    };
+    if (!item.title.trim() && !item.text.trim()) return null;
+    const to = text(raw['to']);
+    const icon = text(raw['icon']);
+    return _extends({}, item, to ? {
+        to
+    } : {}, icon ? {
+        icon
+    } : {});
+}
+function readBlock(raw, at, settled) {
+    var _block_items;
+    if (!isRecord(raw)) {
+        settled.push({
+            at,
+            what: 'not a block; left out'
+        });
+        return null;
+    }
+    const kind = oneOf(raw['kind'], AI_LAYOUT_BLOCK_KINDS);
+    if (!kind) {
+        var _raw_kind;
+        settled.push({
+            at,
+            what: `unknown kind ${JSON.stringify((_raw_kind = raw['kind']) != null ? _raw_kind : null)}; left out`
+        });
+        return null;
+    }
+    const block = {
+        kind
+    };
+    if (typeof raw['col'] === 'number' && Number.isInteger(raw['col']) && raw['col'] >= 0) block.col = raw['col'];
+    const words = text(raw['text']);
+    if (words) block.text = words;
+    const to = text(raw['to']);
+    if (to) block.to = to.trim();
+    const style = oneOf(raw['style'], AI_LAYOUT_STYLES);
+    if (style) block.style = style;
+    const icon = text(raw['icon']);
+    if (icon) block.icon = icon.trim().toLowerCase();
+    if (AI_LAYOUT_GROUP_KINDS.has(kind) || kind === 'component') {
+        const items = (Array.isArray(raw['items']) ? raw['items'] : []).map(readItem).filter((item)=>!!item);
+        const most = kind === 'quotes' ? AI_LAYOUT_MAX_QUOTES : kind === 'component' ? Infinity : AI_LAYOUT_MAX_ITEMS;
+        if (items.length > most) settled.push({
+            at,
+            what: `${items.length} items; the first ${most} kept`
+        });
+        if (items.length) block.items = items.slice(0, most);
+    }
+    // A block with nothing to show is no block: a group with no items, words
+    // with no words. A form or a component may name its record alone.
+    const empty = AI_LAYOUT_GROUP_KINDS.has(kind) ? !((_block_items = block.items) == null ? void 0 : _block_items.length) : kind === 'form' || kind === 'component' ? false : !block.text;
+    if (empty) {
+        settled.push({
+            at,
+            what: `an empty ${kind}; left out`
+        });
+        return null;
+    }
+    return block;
+}
+/** A section read from an answer, or `null` with why it could not be. */ export function aiReadLayoutSection(raw, at, settled) {
+    if (!isRecord(raw)) return null;
+    const section = {
+        blocks: []
+    };
+    const band = oneOf(raw['band'], AI_LAYOUT_BANDS);
+    if (band) section.band = band;
+    const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS);
+    if (align) section.align = align;
+    if (Array.isArray(raw['cols'])) {
+        const cols = raw['cols'].filter((value)=>typeof value === 'number' && Number.isFinite(value) && value > 0);
+        if (cols.length > AI_LAYOUT_MAX_COLS) {
+            settled.push({
+                at: `${at}.cols`,
+                what: `${cols.length} columns; the first ${AI_LAYOUT_MAX_COLS} kept`
+            });
+        }
+        if (cols.length >= 2) section.cols = cols.slice(0, AI_LAYOUT_MAX_COLS).map((value)=>Math.min(12, Math.max(1, Math.round(value))));
+    }
+    const blocks = Array.isArray(raw['blocks']) ? raw['blocks'] : [];
+    blocks.forEach((entry, index)=>{
+        const block = readBlock(entry, `${at}.blocks[${index}]`, settled);
+        if (!block) return;
+        if (block.col !== undefined && section.cols && block.col >= section.cols.length) {
+            settled.push({
+                at: `${at}.blocks[${index}]`,
+                what: `column ${block.col} of ${section.cols.length}; placed in the last`
+            });
+            block.col = section.cols.length - 1;
+        }
+        if (block.col !== undefined && !section.cols) delete block.col;
+        section.blocks.push(block);
+    });
+    return section.blocks.length ? section : null;
+}
+/**
+ * The page an answer describes, against the number of sections its plan
+ * names: each planned section takes the answer's section at its position,
+ * an answer's extra sections are left out, and a planned section the answer
+ * left empty or out is `null` — the one thing a re-ask asks for again.
+ */ export function aiReadLayoutPage(raw, planned) {
+    const settled = [];
+    const given = isRecord(raw) && Array.isArray(raw['sections']) ? raw['sections'] : [];
+    if (given.length > planned) {
+        settled.push({
+            at: 'sections',
+            what: `${given.length} sections for a plan of ${planned}; the extra left out`
+        });
+    }
+    const sections = Array.from({
+        length: planned
+    }, (_, index)=>aiReadLayoutSection(given[index], `sections[${index}]`, settled));
+    return {
+        sections,
+        settled
+    };
+}
+/** A frame answer read: a header and a footer, either `null` where it was not usable. */ export function aiReadLayoutFrame(raw) {
+    var _aiReadLayoutSection;
+    const settled = [];
+    const record = isRecord(raw) ? raw : {};
+    // A header needs no block of its own: its brand and navigation are the
+    // site's, so an empty one is a plain bar.
+    const header = isRecord(record['header']) ? (_aiReadLayoutSection = aiReadLayoutSection(record['header'], 'header', settled)) != null ? _aiReadLayoutSection : readBare(record['header']) : null;
+    const footer = aiReadLayoutSection(record['footer'], 'footer', settled);
+    return {
+        header,
+        footer,
+        settled
+    };
+}
+/** A section with no usable block, keeping only its band and alignment. */ function readBare(raw) {
+    const band = oneOf(raw['band'], AI_LAYOUT_BANDS);
+    const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS);
+    return _extends({}, band ? {
+        band
+    } : {}, align ? {
+        align
+    } : {}, {
+        blocks: []
+    });
+}
+
+//# sourceMappingURL=ai-layout-language.js.map

package/src/lib/layout-language/ai-layout-language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-language.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { AiTool } from '../providers/contract'\nimport { AI_ICON_WORDS } from '../runtime/ai-icon-library'\n\n/**\n * The compact layout language (AGL-3660): what a model designs a page, and a\n * site's header and footer, in — and the one place its shape is declared.\n *\n * ── Why a language, not a tree ───────────────────────────────────────────\n *\n * A page used to be asked for as a raw element tree, packed as escaped JSON\n * text inside a tool call and held to the doctrine's building rules: Grid\n * items sized as strings, every child attached, one h1, a destination on\n * every button, headings under their ceiling. A real model kept about half\n * of a page's sections on the first try, and a Free section was cut off at\n * its token ceiling. The founder chose a language over a library of section\n * templates (10/7): every page is designed for its own request, so no two\n * sites come out alike, and the rules hold because CODE writes the tree.\n *\n * So the model says WHAT each section is and how it is arranged, in a few\n * words of structure, and writes every word a visitor reads; the compiler\n * (`ai-layout-compiler.ts`) turns that into the element tree with the\n * palette's elements and the theme's tokens, by construction.\n *\n * ── The shape ────────────────────────────────────────────────────────────\n *\n * A page is its plan's sections, in order. A SECTION is\n *  - `band`  — its background: `plain` (the page), `soft` (a paper band),\n *              `brand` (the brand color) or `dark` (always dark);\n *  - `cols`  — a row of columns by relative width, as `[7, 5]` or `[1, 1, 1]`,\n *              up to four; absent, one column;\n *  - `align` — `start` or `center`;\n *  - `blocks` — what it shows, top to bottom.\n *\n * A BLOCK is one thing a visitor reads or uses. Its `kind` is one of\n * `AI_LAYOUT_BLOCK_KINDS`; `col` places it in a column of the row (0 first),\n * and a block with no `col` spans the section — above the row when it comes\n * before the first placed block, below it when it comes after. `text` is its\n * words, `to` where it goes, `style` its emphasis and `icon` a word from the\n * icon library. A group — `list`, `cards`, `steps`, `stats`, `quotes`,\n * `faq` — carries its `items`, each a `title`, a `text`, and optionally its\n * own `to` and `icon`.\n *\n * Where a block goes (`to`): `page:<id>` for a page of this site (its label\n * works too), `#<n>` for section n of this page, `form` for the site's form,\n * a form's or a component's id for a `form` or `component` block, or an\n * `https:` address the brief gave.\n *\n * A site's header and footer are two sections in the same language\n * (`AI_LAYOUT_FRAME_TOOL`): the header's brand and navigation are the\n * site's own and written by the compiler, so the model gives the header its\n * band, its alignment and an optional call-to-action button; the footer is\n * a section like any other.\n *\n * ── Cheap by shape ───────────────────────────────────────────────────────\n *\n * The schema is a structured object in the tool input (never JSON text in a\n * string), small enough for a strict tool (`tool-schema-limits.spec.ts`), and\n * the language's instructions ride in the cached prefix. A section is a few\n * dozen words of structure beside its copy, so a whole page is one answer.\n */\n\n/** Every kind of block, in the order the schema lists them. */\nexport const AI_LAYOUT_BLOCK_KINDS = [\n  'eyebrow',\n  'heading',\n  'lede',\n  'text',\n  'note',\n  'list',\n  'button',\n  'image',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n  'form',\n  'component',\n] as const\n\nexport type AiLayoutBlockKind = (typeof AI_LAYOUT_BLOCK_KINDS)[number]\n\n/** The kinds that carry `items`. */\nexport const AI_LAYOUT_GROUP_KINDS: ReadonlySet<AiLayoutBlockKind> = new Set([\n  'list',\n  'cards',\n  'steps',\n  'stats',\n  'quotes',\n  'faq',\n])\n\nexport const AI_LAYOUT_BANDS = ['plain', 'soft', 'brand', 'dark'] as const\nexport type AiLayoutBand = (typeof AI_LAYOUT_BANDS)[number]\n\nexport const AI_LAYOUT_ALIGNS = ['start', 'center'] as const\nexport type AiLayoutAlign = (typeof AI_LAYOUT_ALIGNS)[number]\n\nexport const AI_LAYOUT_STYLES = [\n  'primary',\n  'secondary',\n  'quiet',\n  'large',\n] as const\nexport type AiLayoutStyle = (typeof AI_LAYOUT_STYLES)[number]\n\n/** The most columns a row holds; a fifth is folded into the fourth. */\nexport const AI_LAYOUT_MAX_COLS = 4\n\n/**\n * The most items a group shows: one under the eight copies rule 8 reads as a\n * list typed out by hand, which belongs in a dataset.\n */\nexport const AI_LAYOUT_MAX_ITEMS = 7\n\n/** The most quotes a group shows: each is a gap the owner fills with a real one. */\nexport const AI_LAYOUT_MAX_QUOTES = 3\n\nexport interface AiLayoutItem {\n  title: string\n  text: string\n  to?: string\n  icon?: string\n}\n\nexport interface AiLayoutBlock {\n  kind: AiLayoutBlockKind\n  col?: number\n  text?: string\n  to?: string\n  style?: AiLayoutStyle\n  icon?: string\n  items?: AiLayoutItem[]\n}\n\nexport interface AiLayoutSection {\n  band?: AiLayoutBand\n  cols?: number[]\n  align?: AiLayoutAlign\n  blocks: AiLayoutBlock[]\n}\n\n/** A page: its plan's sections, in order. */\nexport interface AiLayoutPageDoc {\n  sections: AiLayoutSection[]\n}\n\n/** A site's frame: the header and the footer every page renders between. */\nexport interface AiLayoutFrameDoc {\n  header: AiLayoutSection\n  footer: AiLayoutSection\n}\n\nconst ITEM_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['title', 'text', 'to', 'icon'],\n  properties: {\n    title: { type: 'string' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    icon: { type: 'string' },\n  },\n} as const\n\nconst BLOCK_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['kind', 'col', 'text', 'to', 'style', 'icon', 'items'],\n  properties: {\n    kind: { type: 'string', enum: [...AI_LAYOUT_BLOCK_KINDS] },\n    col: { type: 'integer' },\n    text: { type: 'string' },\n    to: { type: 'string' },\n    style: { type: 'string', enum: [...AI_LAYOUT_STYLES, 'none'] },\n    icon: { type: 'string' },\n    items: { type: 'array', items: ITEM_SCHEMA },\n  },\n} as const\n\nconst SECTION_SCHEMA = {\n  type: 'object',\n  additionalProperties: false,\n  required: ['band', 'cols', 'align', 'blocks'],\n  properties: {\n    band: { type: 'string', enum: [...AI_LAYOUT_BANDS] },\n    cols: { type: 'array', items: { type: 'integer' } },\n    align: { type: 'string', enum: [...AI_LAYOUT_ALIGNS] },\n    blocks: { type: 'array', items: BLOCK_SCHEMA },\n  },\n} as const\n\n/** The page tool: every section of one page, in plan order, in one answer. */\nexport const AI_LAYOUT_PAGE_TOOL: AiTool = {\n  name: 'submit_page',\n  description:\n    'Submit the page: one entry in sections for each planned section, in order, in the layout language.',\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['sections'],\n    properties: { sections: { type: 'array', items: SECTION_SCHEMA } },\n  },\n}\n\n/** The frame tool: the site's header and footer, in the same language. */\nexport const AI_LAYOUT_FRAME_TOOL: AiTool = {\n  name: 'submit_frame',\n  description:\n    \"Submit the site's header and footer, each as a section in the layout language.\",\n  strict: true,\n  inputSchema: {\n    type: 'object',\n    additionalProperties: false,\n    required: ['header', 'footer'],\n    properties: { header: SECTION_SCHEMA, footer: SECTION_SCHEMA },\n  },\n}\n\n/**\n * The language as a model is taught it: the cached instructions both doors\n * share. Every word of copy is the model's; this says only how a design is\n * written down and what each word becomes.\n */\nexport const AI_LAYOUT_LANGUAGE_TEXT = [\n  \"You design web pages in a compact layout language. You decide the structure and write every word; the platform turns your design into the page, with the site's theme, spacing and type, so never describe styling beyond the words below.\",\n  '',\n  'A page is a list of sections, one for each section the plan names, in that order. A section has:',\n  '- band: plain (the page background), soft (a light band), brand (the brand color) or dark (always dark). Vary the bands down a page so neighboring sections read apart; keep brand and dark to one or two sections a page.',\n  '- cols: relative column widths for a row, such as [1, 1] for halves, [7, 5] for a wide and a narrow column, or [1, 1, 1]; at most 4. [] for one column.',\n  '- align: start or center.',\n  '- blocks: what the section shows, top to bottom. A block with col 0 or more goes in that column of the row (0 is the first); a block with col -1 spans the whole section, above the row when it comes first and below it when it comes last.',\n  'Every field is always written: a block that does not use one writes \"\" (text, to, icon), \"none\" (style), -1 (col) or [] (items); an item that does not use one writes \"\".',\n  '',\n  'Block kinds:',\n  \"- eyebrow: a short label above a heading. heading: a heading; the first heading of the page's first section is the page's title, and the first heading of every other section is that section's heading. lede: the larger sentence under a heading. text: a paragraph. note: small print.\",\n  '- button: text is the label and to says where it goes; style primary, secondary or quiet. Two buttons in a row read as a pair.',\n  '- image: text describes the picture to place, which becomes its alt text; the owner adds the picture. icon names a drawing to show until then.',\n  '- list: items are the lines (title only; text may be empty).',\n  \"- cards, steps, stats, faq: items, each with a title and a text. cards are features or services; steps are numbered; stats are a figure (title) with its label (text), only for figures the brief gives; faq items are a question (title) and its answer (text). Use no quotes block: the site has no customer's words to show.\",\n  \"- form: places a saved form by its id in to. component: places a reusable component by its id in to; its items fill the component's props, title the prop name and text the value.\",\n  '- style large on a heading makes the page title display-sized. icon (on a block or an item) is one of: ' +\n    AI_ICON_WORDS.join(', ') +\n    '.',\n  '',\n  \"Where a link goes (to): page:<page id> for a page of this site; #<n> for section n of this page (counted from 1); form for the site's form; or an https: address the brief gives. A button the page has nowhere to send is left out. A to value is never written into words: in text, name a page by its title.\",\n  '',\n  \"Writing: plain, specific copy in the site's voice, from the brief, the business and its audience, never filler. Keep a page title under 70 characters and a section heading under 80. The site is published exactly as you write it, so where the brief leaves out a fact such as a price, a figure, a name, a phone number, an email, an address or opening hours, leave it out: write the sentence without it, and make no list line, card or contact row for it. Never write a placeholder or a gap in square brackets, and never invent the fact. Never invent a customer, a review, an award or a statistic.\",\n  '',\n  'Design each page for this business and this request: choose the bands, the rows and the blocks that tell its story best, so no two sites read alike.',\n].join('\\n')\n\n// ── Reading an answer ────────────────────────────────────────────────────\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction text(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value : undefined\n}\n\nfunction oneOf<T extends string>(\n  value: unknown,\n  values: readonly T[],\n): T | undefined {\n  return typeof value === 'string' &&\n    (values as readonly string[]).includes(value)\n    ? (value as T)\n    : undefined\n}\n\n/** What the reader settled on its own, for the job's record and the specs. */\nexport interface AiLayoutSettlement {\n  /** Where: `sections[2].blocks[1]`, `header`. */\n  at: string\n  what: string\n}\n\nfunction readItem(raw: unknown): AiLayoutItem | null {\n  if (!isRecord(raw)) return null\n  const item: AiLayoutItem = {\n    title: typeof raw['title'] === 'string' ? raw['title'] : '',\n    text: typeof raw['text'] === 'string' ? raw['text'] : '',\n  }\n  if (!item.title.trim() && !item.text.trim()) return null\n  const to = text(raw['to'])\n  const icon = text(raw['icon'])\n  return { ...item, ...(to ? { to } : {}), ...(icon ? { icon } : {}) }\n}\n\nfunction readBlock(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutBlock | null {\n  if (!isRecord(raw)) {\n    settled.push({ at, what: 'not a block; left out' })\n    return null\n  }\n  const kind = oneOf(raw['kind'], AI_LAYOUT_BLOCK_KINDS)\n  if (!kind) {\n    settled.push({\n      at,\n      what: `unknown kind ${JSON.stringify(raw['kind'] ?? null)}; left out`,\n    })\n    return null\n  }\n  const block: AiLayoutBlock = { kind }\n  if (\n    typeof raw['col'] === 'number' &&\n    Number.isInteger(raw['col']) &&\n    raw['col'] >= 0\n  )\n    block.col = raw['col']\n  const words = text(raw['text'])\n  if (words) block.text = words\n  const to = text(raw['to'])\n  if (to) block.to = to.trim()\n  const style = oneOf(raw['style'], AI_LAYOUT_STYLES)\n  if (style) block.style = style\n  const icon = text(raw['icon'])\n  if (icon) block.icon = icon.trim().toLowerCase()\n  if (AI_LAYOUT_GROUP_KINDS.has(kind) || kind === 'component') {\n    const items = (Array.isArray(raw['items']) ? raw['items'] : [])\n      .map(readItem)\n      .filter((item): item is AiLayoutItem => !!item)\n    const most =\n      kind === 'quotes'\n        ? AI_LAYOUT_MAX_QUOTES\n        : kind === 'component'\n          ? Infinity\n          : AI_LAYOUT_MAX_ITEMS\n    if (items.length > most)\n      settled.push({\n        at,\n        what: `${items.length} items; the first ${most} kept`,\n      })\n    if (items.length) block.items = items.slice(0, most)\n  }\n  // A block with nothing to show is no block: a group with no items, words\n  // with no words. A form or a component may name its record alone.\n  const empty = AI_LAYOUT_GROUP_KINDS.has(kind)\n    ? !block.items?.length\n    : kind === 'form' || kind === 'component'\n      ? false\n      : !block.text\n  if (empty) {\n    settled.push({ at, what: `an empty ${kind}; left out` })\n    return null\n  }\n  return block\n}\n\n/** A section read from an answer, or `null` with why it could not be. */\nexport function aiReadLayoutSection(\n  raw: unknown,\n  at: string,\n  settled: AiLayoutSettlement[],\n): AiLayoutSection | null {\n  if (!isRecord(raw)) return null\n  const section: AiLayoutSection = { blocks: [] }\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  if (band) section.band = band\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  if (align) section.align = align\n  if (Array.isArray(raw['cols'])) {\n    const cols = raw['cols'].filter(\n      (value): value is number =>\n        typeof value === 'number' && Number.isFinite(value) && value > 0,\n    )\n    if (cols.length > AI_LAYOUT_MAX_COLS) {\n      settled.push({\n        at: `${at}.cols`,\n        what: `${cols.length} columns; the first ${AI_LAYOUT_MAX_COLS} kept`,\n      })\n    }\n    if (cols.length >= 2)\n      section.cols = cols\n        .slice(0, AI_LAYOUT_MAX_COLS)\n        .map((value) => Math.min(12, Math.max(1, Math.round(value))))\n  }\n  const blocks = Array.isArray(raw['blocks']) ? raw['blocks'] : []\n  blocks.forEach((entry, index) => {\n    const block = readBlock(entry, `${at}.blocks[${index}]`, settled)\n    if (!block) return\n    if (\n      block.col !== undefined &&\n      section.cols &&\n      block.col >= section.cols.length\n    ) {\n      settled.push({\n        at: `${at}.blocks[${index}]`,\n        what: `column ${block.col} of ${section.cols.length}; placed in the last`,\n      })\n      block.col = section.cols.length - 1\n    }\n    if (block.col !== undefined && !section.cols) delete block.col\n    section.blocks.push(block)\n  })\n  return section.blocks.length ? section : null\n}\n\n/** A page answer read: the sections it gave, by plan position, and the positions it could not. */\nexport interface AiLayoutPageReading {\n  /** One entry per planned section; `null` where the answer gave nothing usable. */\n  sections: Array<AiLayoutSection | null>\n  settled: AiLayoutSettlement[]\n}\n\n/**\n * The page an answer describes, against the number of sections its plan\n * names: each planned section takes the answer's section at its position,\n * an answer's extra sections are left out, and a planned section the answer\n * left empty or out is `null` — the one thing a re-ask asks for again.\n */\nexport function aiReadLayoutPage(\n  raw: unknown,\n  planned: number,\n): AiLayoutPageReading {\n  const settled: AiLayoutSettlement[] = []\n  const given =\n    isRecord(raw) && Array.isArray(raw['sections']) ? raw['sections'] : []\n  if (given.length > planned) {\n    settled.push({\n      at: 'sections',\n      what: `${given.length} sections for a plan of ${planned}; the extra left out`,\n    })\n  }\n  const sections = Array.from({ length: planned }, (_, index) =>\n    aiReadLayoutSection(given[index], `sections[${index}]`, settled),\n  )\n  return { sections, settled }\n}\n\n/** A frame answer read: a header and a footer, either `null` where it was not usable. */\nexport function aiReadLayoutFrame(raw: unknown): {\n  header: AiLayoutSection | null\n  footer: AiLayoutSection | null\n  settled: AiLayoutSettlement[]\n} {\n  const settled: AiLayoutSettlement[] = []\n  const record = isRecord(raw) ? raw : {}\n  // A header needs no block of its own: its brand and navigation are the\n  // site's, so an empty one is a plain bar.\n  const header = isRecord(record['header'])\n    ? (aiReadLayoutSection(record['header'], 'header', settled) ??\n      readBare(record['header']))\n    : null\n  const footer = aiReadLayoutSection(record['footer'], 'footer', settled)\n  return { header, footer, settled }\n}\n\n/** A section with no usable block, keeping only its band and alignment. */\nfunction readBare(raw: Record<string, unknown>): AiLayoutSection {\n  const band = oneOf(raw['band'], AI_LAYOUT_BANDS)\n  const align = oneOf(raw['align'], AI_LAYOUT_ALIGNS)\n  return { ...(band ? { band } : {}), ...(align ? { align } : {}), blocks: [] }\n}\n"],"names":["AI_ICON_WORDS","AI_LAYOUT_BLOCK_KINDS","AI_LAYOUT_GROUP_KINDS","Set","AI_LAYOUT_BANDS","AI_LAYOUT_ALIGNS","AI_LAYOUT_STYLES","AI_LAYOUT_MAX_COLS","AI_LAYOUT_MAX_ITEMS","AI_LAYOUT_MAX_QUOTES","ITEM_SCHEMA","type","additionalProperties","required","properties","title","text","to","icon","BLOCK_SCHEMA","kind","enum","col","style","items","SECTION_SCHEMA","band","cols","align","blocks","AI_LAYOUT_PAGE_TOOL","name","description","strict","inputSchema","sections","AI_LAYOUT_FRAME_TOOL","header","footer","AI_LAYOUT_LANGUAGE_TEXT","join","isRecord","value","Array","isArray","trim","undefined","oneOf","values","includes","readItem","raw","item","readBlock","at","settled","block","push","what","JSON","stringify","Number","isInteger","words","toLowerCase","has","map","filter","most","Infinity","length","slice","empty","aiReadLayoutSection","section","isFinite","Math","min","max","round","forEach","entry","index","aiReadLayoutPage","planned","given","from","_","aiReadLayoutFrame","record","readBare"],"mappings":"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"}

package/src/lib/layout-language/ai-layout-links.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Where a link the layout language names goes (AGL-3660), resolved by code to
+ * a destination rule 10 admits: a page of this site by its id, a section of
+ * this page by the platform's Scroll to element interaction, or an `https:`
+ * address the brief itself gave. A destination that resolves to nothing, or
+ * to the home page under words that do not say home, is no destination, and
+ * the compiler leaves the button out rather than shipping a dead control.
+ */
+/** A page of the site a link may go to: built, or minted on a guided start's plan. */
+export interface AiLayoutPage {
+    id: string;
+    label: string;
+    slug: string;
+}
+/** Everything a page's links resolve against. */
+export interface AiLayoutTargets {
+    /** The page being built, which no link of its own goes to. */
+    pageId?: string | null;
+    /** The site's pages a link may go to. */
+    pages: readonly AiLayoutPage[];
+    /** The site's home pages, which only words that say home link (rule 10). */
+    homeIds: readonly string[];
+    /** The saved forms a page may place. */
+    forms: readonly {
+        id: string;
+        name: string;
+    }[];
+    /** The page that places the site's form, where that is another page. */
+    formPageId?: string | null;
+    /** The reusable components a page may place, with the props each fills. */
+    components: readonly {
+        id: string;
+        name: string;
+        props: Record<string, string>;
+    }[];
+    /** Every word the job was given: the brief, the site's answers, its profile. */
+    facts: string;
+}
+/** Where a link resolved to. */
+export type AiLayoutDestination = {
+    kind: 'page';
+    screenId: string;
+} | {
+    kind: 'section';
+    index: number;
+} | {
+    kind: 'href';
+    href: string;
+};
+export interface AiLayoutLinkScope {
+    /** The page's section names in plan order. */
+    sections: readonly string[];
+    /** The section the link sits in, which it does not scroll to. */
+    from: number;
+    /** The section of this page that places the site's form, if one does. */
+    formSection: number | null;
+}
+/**
+ * Where a link goes: the destination its `to` names, read the language's
+ * way; failing that, for words that ask a visitor to get in touch, the site's
+ * form; failing that, a page whose name the words say. `null` is a link with
+ * nowhere to go, which is left out.
+ */
+export declare function aiLayoutResolveLink(to: string | undefined, label: string, scope: AiLayoutLinkScope, targets: AiLayoutTargets): AiLayoutDestination | null;