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

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

@@ -0,0 +1,345 @@
+/**
+ * @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 { aiBracketedFacts } from "../runtime/ai-doctrine-validators.js";
+import { aiStoredScrollTargets } from "../runtime/ai-page-links.js";
+/** Props that hold no words a visitor reads: an icon's drawing is path data. */ const NOT_WORDS = new Set([
+    'iconPath',
+    'iconId'
+]);
+/** The props a node's own words are in. */ const WORD_PROPS = [
+    'children',
+    'primary',
+    'secondary',
+    'label'
+];
+/** Elements that say something with no words of their own. */ const SPEAKS_ALONE = new Set([
+    'image',
+    'form',
+    'layoutSlot',
+    'reusableInstance',
+    'muiDrawerToggle',
+    'muiDrawer'
+]);
+const HEADING_VARIANTS = new Set([
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'overline'
+]);
+/** The violation code a gap is named by. */ export const AI_LAYOUT_GAP_CODE = 'layout-gap';
+/** Every string a value holds, however deep, its icon drawings aside. */ function stringsOf(value, key = '') {
+    if (NOT_WORDS.has(key)) return [];
+    if (typeof value === 'string') return [
+        value
+    ];
+    if (Array.isArray(value)) return value.flatMap((entry)=>stringsOf(entry));
+    if (value && typeof value === 'object') {
+        return Object.entries(value).flatMap(([name, entry])=>stringsOf(entry, name));
+    }
+    return [];
+}
+/** Each node whose words carry a gap, with the gaps it carries. */ function gapsOf(nodes) {
+    return Object.entries(nodes).flatMap(([id, node])=>{
+        var _node_props;
+        const texts = stringsOf((_node_props = node.props) != null ? _node_props : {});
+        const facts = aiBracketedFacts(texts);
+        return facts.length ? [
+            {
+                id,
+                facts,
+                text: texts.filter((text)=>aiBracketedFacts([
+                        text
+                    ]).length).join(' ')
+            }
+        ] : [];
+    });
+}
+/** The gaps a language-built page or frame carries, as the violation that asks again. */ export function aiLayoutGapViolations(nodes) {
+    const found = gapsOf(nodes);
+    if (!found.length) return [];
+    const facts = aiBracketedFacts(found.flatMap((entry)=>entry.facts));
+    return [
+        {
+            rule: 14,
+            code: AI_LAYOUT_GAP_CODE,
+            message: `${facts.join(', ')} ${facts.length === 1 ? 'is a gap' : 'are gaps'} for a fact the brief does not give, and this site is published exactly as written. Leave each fact out: write the sentence without it, and make no list line, card or contact row for it. Never write a gap in square brackets, and never invent the fact.`,
+            nodeIds: found.map((entry)=>entry.id)
+        }
+    ];
+}
+function parentsOf(nodes) {
+    var _node_nodes;
+    const parents = new Map();
+    for (const [id, node] of Object.entries(nodes))for (const child of (_node_nodes = node.nodes) != null ? _node_nodes : [])parents.set(child, id);
+    return parents;
+}
+function subtree(nodes, id) {
+    const ids = [];
+    const stack = [
+        id
+    ];
+    while(stack.length){
+        var _nodes_next_nodes;
+        const next = stack.pop();
+        if (!nodes[next] || ids.includes(next)) continue;
+        ids.push(next);
+        stack.push(...(_nodes_next_nodes = nodes[next].nodes) != null ? _nodes_next_nodes : []);
+    }
+    return ids;
+}
+function wordsOf(node) {
+    for (const prop of WORD_PROPS){
+        var _node_props;
+        const value = (_node_props = node.props) == null ? void 0 : _node_props[prop];
+        if (typeof value === 'string' && value.trim()) return value.trim();
+    }
+    return '';
+}
+function isHeading(node) {
+    var _ref, _ref1;
+    var _node_props, _node_props1;
+    if (node.componentId !== 'muiTypography') return false;
+    return HEADING_VARIANTS.has(String((_ref = (_node_props = node.props) == null ? void 0 : _node_props['variant']) != null ? _ref : '')) || /^h[1-6]$/.test(String((_ref1 = (_node_props1 = node.props) == null ? void 0 : _node_props1['component']) != null ? _ref1 : ''));
+}
+/** Whether anything under a node says something; with `beyondHeadings`, anything but a heading. */ function speaks(nodes, id, beyondHeadings = false) {
+    return subtree(nodes, id).some((each)=>{
+        const node = nodes[each];
+        const says = SPEAKS_ALONE.has(node.componentId) || !!wordsOf(node);
+        return says && !(beyondHeadings && isHeading(node));
+    });
+}
+/** A node's props, its component's prop values copied too, so a rewrite never reaches the input. */ function copyProps(props) {
+    const values = props['propValues'];
+    return values && typeof values === 'object' && !Array.isArray(values) ? _extends({}, props, {
+        propValues: _extends({}, values)
+    }) : _extends({}, props);
+}
+function cloneNodes(input) {
+    return Object.fromEntries(Object.entries(input).map(([id, node])=>[
+            id,
+            _extends({}, node, node.props ? {
+                props: copyProps(node.props)
+            } : {}, node.nodes ? {
+                nodes: [
+                    ...node.nodes
+                ]
+            } : {})
+        ]));
+}
+/**
+ * Takes each found node out, and each element above it left with nothing to
+ * say, up to its section; a section other than the page's first left with
+ * only its heading goes too, with any link that scrolled to it.
+ */ function pruneFound(nodes, rootId, found) {
+    var _ref;
+    var _nodes_rootId, _nodes_rootId_nodes, _nodes_rootId1;
+    const dropped = [];
+    const sections = new Set((_ref = (_nodes_rootId = nodes[rootId]) == null ? void 0 : _nodes_rootId.nodes) != null ? _ref : []);
+    const touched = new Set();
+    const remove = (id)=>{
+        var _nodes_parent_nodes;
+        const parent = parentsOf(nodes).get(id);
+        for (const each of subtree(nodes, id))delete nodes[each];
+        if (parent && nodes[parent]) nodes[parent].nodes = ((_nodes_parent_nodes = nodes[parent].nodes) != null ? _nodes_parent_nodes : []).filter((child)=>child !== id);
+    };
+    /** Takes a node out, and each element above it it leaves with nothing to say, short of a section. */ const prune = (id)=>{
+        const parents = parentsOf(nodes);
+        let section = id;
+        while(section && !sections.has(section))section = parents.get(section);
+        if (section && section !== id) touched.add(section);
+        let parent = parents.get(id);
+        remove(id);
+        while(parent && parent !== rootId && nodes[parent]){
+            if (sections.has(parent) || speaks(nodes, parent)) break;
+            const above = parentsOf(nodes).get(parent);
+            remove(parent);
+            parent = above;
+        }
+    };
+    for (const entry of found){
+        if (!nodes[entry.id]) continue;
+        dropped.push(entry.text);
+        prune(entry.id);
+    }
+    const first = (_nodes_rootId1 = nodes[rootId]) == null ? void 0 : (_nodes_rootId_nodes = _nodes_rootId1.nodes) == null ? void 0 : _nodes_rootId_nodes[0];
+    for (const section of touched){
+        var _ref1;
+        var _nodes_section_props;
+        if (section === first || !nodes[section] || speaks(nodes, section, true)) continue;
+        const label = String((_ref1 = (_nodes_section_props = nodes[section].props) == null ? void 0 : _nodes_section_props['ariaLabel']) != null ? _ref1 : section);
+        remove(section);
+        dropped.push(`the section "${label}", left with only its heading`);
+        for (const [id, node] of Object.entries(nodes)){
+            if (nodes[id] && aiStoredScrollTargets(node).includes(section)) {
+                dropped.push(`"${wordsOf(node)}", a link to that section`);
+                prune(id);
+            }
+        }
+    }
+    return dropped;
+}
+/** The page or frame with every gap taken out, and what was taken. */ export function aiLayoutWithoutGaps(input, rootId) {
+    const found = gapsOf(input);
+    if (!found.length) return {
+        nodes: input,
+        dropped: []
+    };
+    const nodes = cloneNodes(input);
+    const dropped = pruneFound(nodes, rootId, found);
+    return {
+        nodes: nodes,
+        dropped
+    };
+}
+/** The violation code an internal reference in copy is named by. */ export const AI_LAYOUT_REF_CODE = 'layout-internal-ref';
+/** A link's own notation, or a template token other than the site's own (`{{host.…}}`). */ const REF = /\b(?:page|new|form|component|screen):[A-Za-z0-9_-]+|\{\{(?!\s*host\.)[^{}]*\}\}/g;
+const PAGE_REF = /\bpage:([A-Za-z0-9_-]+)/g;
+/** The props whose words a visitor reads, and a component's prop values. */ const SHOWN_PROPS = [
+    ...WORD_PROPS,
+    'alt',
+    'title'
+];
+function shownTexts(node) {
+    var _node_props;
+    const props = (_node_props = node.props) != null ? _node_props : {};
+    const slots = [];
+    for (const prop of SHOWN_PROPS){
+        if (typeof props[prop] === 'string') slots.push({
+            get: ()=>props[prop],
+            set: (value)=>props[prop] = value
+        });
+    }
+    const values = props['propValues'];
+    if (values && typeof values === 'object' && !Array.isArray(values)) {
+        const record = values;
+        for (const name of Object.keys(record)){
+            if (typeof record[name] === 'string') slots.push({
+                get: ()=>record[name],
+                set: (value)=>record[name] = value
+            });
+        }
+    }
+    return slots;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function refsIn(text, names) {
+    var _text_match;
+    const found = ((_text_match = text.match(REF)) != null ? _text_match : []).map((ref)=>ref.trim());
+    for (const id of names.ids){
+        if (id.length >= 6 && new RegExp(`(^|[^A-Za-z0-9_-])${escapeRegExp(id)}($|[^A-Za-z0-9_-])`).test(text)) found.push(id);
+    }
+    return [
+        ...new Set(found)
+    ];
+}
+function refsOf(nodes, names) {
+    return Object.entries(nodes).flatMap(([id, node])=>{
+        const texts = shownTexts(node).map((slot)=>slot.get());
+        const refs = [
+            ...new Set(texts.flatMap((text)=>refsIn(text, names)))
+        ];
+        return refs.length ? [
+            {
+                id,
+                refs,
+                text: texts.filter((text)=>refsIn(text, names).length).join(' ')
+            }
+        ] : [];
+    });
+}
+/** Internal references in a language-built page's or frame's words, as the violation that asks again. */ export function aiLayoutRefViolations(nodes, names) {
+    const found = refsOf(nodes, names);
+    if (!found.length) return [];
+    const refs = [
+        ...new Set(found.flatMap((entry)=>entry.refs))
+    ].map((ref)=>`"${ref}"`);
+    return [
+        {
+            rule: 14,
+            code: AI_LAYOUT_REF_CODE,
+            message: `${refs.join(', ')} ${refs.length === 1 ? 'is a link reference' : 'are link references'} written into words a visitor reads. A reference goes only in a button's or a list item's to; in text, name the page by its title, or leave the reference out.`,
+            nodeIds: found.map((entry)=>entry.id)
+        }
+    ];
+}
+/**
+ * The page or frame with no internal reference in its words: a page's
+ * reference is written as that page's title, and a line that still names a
+ * reference is taken out, as a gap is. Returns what was rewritten and taken.
+ */ export function aiLayoutWithoutRefs(input, rootId, names) {
+    if (!refsOf(input, names).length) return {
+        nodes: input,
+        dropped: []
+    };
+    const nodes = cloneNodes(input);
+    const labels = new Map(names.pages.map((page)=>[
+            page.id,
+            page.label
+        ]));
+    const dropped = [];
+    for (const node of Object.values(nodes)){
+        for (const slot of shownTexts(node)){
+            const before = slot.get();
+            const after = before.replace(PAGE_REF, (ref, id)=>{
+                var _labels_get;
+                return (_labels_get = labels.get(id)) != null ? _labels_get : ref;
+            });
+            if (after !== before) {
+                slot.set(after);
+                dropped.push(`"${before}" written as "${after}"`);
+            }
+        }
+    }
+    dropped.push(...pruneFound(nodes, rootId, refsOf(nodes, names)));
+    return {
+        nodes: nodes,
+        dropped
+    };
+}
+/**
+ * A language-built page's or frame's words held to both (AGL-3660): before
+ * the last answer, each gap and each internal reference is a violation that
+ * asks again; in the last, they are taken out and the rest is kept.
+ */ export function aiLayoutCopyCheck(input, rootId, names, last) {
+    if (!last) {
+        return {
+            nodes: input,
+            dropped: [],
+            violations: [
+                ...aiLayoutRefViolations(input, names),
+                ...aiLayoutGapViolations(input)
+            ]
+        };
+    }
+    const refs = aiLayoutWithoutRefs(input, rootId, names);
+    const gaps = aiLayoutWithoutGaps(refs.nodes, rootId);
+    return {
+        nodes: gaps.nodes,
+        dropped: [
+            ...refs.dropped,
+            ...gaps.dropped
+        ],
+        violations: []
+    };
+}
+
+//# sourceMappingURL=ai-layout-gaps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-gaps.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 { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport { aiBracketedFacts, type AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport { aiStoredScrollTargets } from '../runtime/ai-page-links'\n\n/**\n * No gap on a published page (AGL-3660). A guided start publishes what it\n * builds, so a fact the brief never gave — a phone number, an address, the\n * opening hours — is left out of a page or a frame built in the layout\n * language, never written as the bracketed gap (\"[phone number]\") a draft a\n * person edits first may carry. An answer holding one is asked again; the\n * last answer a generation takes has each one taken out instead: the line\n * that carries it, the row or card it leaves with nothing to say, and a\n * section left with only its heading.\n */\n\ninterface GapNode {\n  componentId: string\n  props?: Record<string, unknown>\n  nodes?: string[]\n}\n\ntype GapNodes = Record<string, GapNode>\n\n/** Props that hold no words a visitor reads: an icon's drawing is path data. */\nconst NOT_WORDS = new Set(['iconPath', 'iconId'])\n\n/** The props a node's own words are in. */\nconst WORD_PROPS = ['children', 'primary', 'secondary', 'label'] as const\n\n/** Elements that say something with no words of their own. */\nconst SPEAKS_ALONE = new Set(['image', 'form', 'layoutSlot', 'reusableInstance', 'muiDrawerToggle', 'muiDrawer'])\n\nconst HEADING_VARIANTS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'overline'])\n\n/** The violation code a gap is named by. */\nexport const AI_LAYOUT_GAP_CODE = 'layout-gap'\n\n/** Every string a value holds, however deep, its icon drawings aside. */\nfunction stringsOf(value: unknown, key = ''): string[] {\n  if (NOT_WORDS.has(key)) return []\n  if (typeof value === 'string') return [value]\n  if (Array.isArray(value)) return value.flatMap((entry) => stringsOf(entry))\n  if (value && typeof value === 'object') {\n    return Object.entries(value as Record<string, unknown>).flatMap(([name, entry]) => stringsOf(entry, name))\n  }\n  return []\n}\n\n/** Each node whose words carry a gap, with the gaps it carries. */\nfunction gapsOf(nodes: GapNodes): Array<{ id: string; facts: string[]; text: string }> {\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = stringsOf(node.props ?? {})\n    const facts = aiBracketedFacts(texts)\n    return facts.length ? [{ id, facts, text: texts.filter((text) => aiBracketedFacts([text]).length).join(' ') }] : []\n  })\n}\n\n/** The gaps a language-built page or frame carries, as the violation that asks again. */\nexport function aiLayoutGapViolations(nodes: NodesMap): AiDoctrineViolation[] {\n  const found = gapsOf(nodes as unknown as GapNodes)\n  if (!found.length) return []\n  const facts = aiBracketedFacts(found.flatMap((entry) => entry.facts))\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_GAP_CODE,\n      message: `${facts.join(', ')} ${facts.length === 1 ? 'is a gap' : 'are gaps'} for a fact the brief does not give, and this site is published exactly as written. Leave each fact out: write the sentence without it, and make no list line, card or contact row for it. Never write a gap in square brackets, and never invent the fact.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\nfunction parentsOf(nodes: GapNodes): Map<string, string> {\n  const parents = new Map<string, string>()\n  for (const [id, node] of Object.entries(nodes)) for (const child of node.nodes ?? []) parents.set(child, id)\n  return parents\n}\n\nfunction subtree(nodes: GapNodes, id: string): string[] {\n  const ids: string[] = []\n  const stack = [id]\n  while (stack.length) {\n    const next = stack.pop() as string\n    if (!nodes[next] || ids.includes(next)) continue\n    ids.push(next)\n    stack.push(...(nodes[next].nodes ?? []))\n  }\n  return ids\n}\n\nfunction wordsOf(node: GapNode): string {\n  for (const prop of WORD_PROPS) {\n    const value = node.props?.[prop]\n    if (typeof value === 'string' && value.trim()) return value.trim()\n  }\n  return ''\n}\n\nfunction isHeading(node: GapNode): boolean {\n  if (node.componentId !== 'muiTypography') return false\n  return HEADING_VARIANTS.has(String(node.props?.['variant'] ?? '')) || /^h[1-6]$/.test(String(node.props?.['component'] ?? ''))\n}\n\n/** Whether anything under a node says something; with `beyondHeadings`, anything but a heading. */\nfunction speaks(nodes: GapNodes, id: string, beyondHeadings = false): boolean {\n  return subtree(nodes, id).some((each) => {\n    const node = nodes[each]\n    const says = SPEAKS_ALONE.has(node.componentId) || !!wordsOf(node)\n    return says && !(beyondHeadings && isHeading(node))\n  })\n}\n\n/** A node's props, its component's prop values copied too, so a rewrite never reaches the input. */\nfunction copyProps(props: Record<string, unknown>): Record<string, unknown> {\n  const values = props['propValues']\n  return values && typeof values === 'object' && !Array.isArray(values)\n    ? { ...props, propValues: { ...(values as Record<string, unknown>) } }\n    : { ...props }\n}\n\nfunction cloneNodes(input: NodesMap): GapNodes {\n  return Object.fromEntries(\n    Object.entries(input as unknown as GapNodes).map(([id, node]) => [\n      id,\n      {\n        ...node,\n        ...(node.props ? { props: copyProps(node.props) } : {}),\n        ...(node.nodes ? { nodes: [...node.nodes] } : {}),\n      },\n    ]),\n  )\n}\n\n/**\n * Takes each found node out, and each element above it left with nothing to\n * say, up to its section; a section other than the page's first left with\n * only its heading goes too, with any link that scrolled to it.\n */\nfunction pruneFound(nodes: GapNodes, rootId: string, found: ReadonlyArray<{ id: string; text: string }>): string[] {\n  const dropped: string[] = []\n  const sections = new Set(nodes[rootId]?.nodes ?? [])\n  const touched = new Set<string>()\n  const remove = (id: string) => {\n    const parent = parentsOf(nodes).get(id)\n    for (const each of subtree(nodes, id)) delete nodes[each]\n    if (parent && nodes[parent]) nodes[parent].nodes = (nodes[parent].nodes ?? []).filter((child) => child !== id)\n  }\n  /** Takes a node out, and each element above it it leaves with nothing to say, short of a section. */\n  const prune = (id: string) => {\n    const parents = parentsOf(nodes)\n    let section: string | undefined = id\n    while (section && !sections.has(section)) section = parents.get(section)\n    if (section && section !== id) touched.add(section)\n    let parent = parents.get(id)\n    remove(id)\n    while (parent && parent !== rootId && nodes[parent]) {\n      if (sections.has(parent) || speaks(nodes, parent)) break\n      const above = parentsOf(nodes).get(parent)\n      remove(parent)\n      parent = above\n    }\n  }\n  for (const entry of found) {\n    if (!nodes[entry.id]) continue\n    dropped.push(entry.text)\n    prune(entry.id)\n  }\n  const first = nodes[rootId]?.nodes?.[0]\n  for (const section of touched) {\n    if (section === first || !nodes[section] || speaks(nodes, section, true)) continue\n    const label = String(nodes[section].props?.['ariaLabel'] ?? section)\n    remove(section)\n    dropped.push(`the section \"${label}\", left with only its heading`)\n    for (const [id, node] of Object.entries(nodes)) {\n      if (nodes[id] && aiStoredScrollTargets(node).includes(section)) {\n        dropped.push(`\"${wordsOf(node)}\", a link to that section`)\n        prune(id)\n      }\n    }\n  }\n  return dropped\n}\n\n/** The page or frame with every gap taken out, and what was taken. */\nexport function aiLayoutWithoutGaps(input: NodesMap, rootId: string): { nodes: NodesMap; dropped: string[] } {\n  const found = gapsOf(input as unknown as GapNodes)\n  if (!found.length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const dropped = pruneFound(nodes, rootId, found)\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n// ── Internal references ─────────────────────────────────────────────────\n\n/**\n * What a link may name, which never belongs in words a visitor reads: the\n * site's pages, with the title a reference to one is written as, and every\n * other id the page or frame was built against (its forms, components and\n * sections).\n */\nexport interface AiLayoutRefNames {\n  pages: ReadonlyArray<{ id: string; label: string }>\n  ids: readonly string[]\n}\n\n/** The violation code an internal reference in copy is named by. */\nexport const AI_LAYOUT_REF_CODE = 'layout-internal-ref'\n\n/** A link's own notation, or a template token other than the site's own (`{{host.…}}`). */\nconst REF = /\\b(?:page|new|form|component|screen):[A-Za-z0-9_-]+|\\{\\{(?!\\s*host\\.)[^{}]*\\}\\}/g\nconst PAGE_REF = /\\bpage:([A-Za-z0-9_-]+)/g\n\n/** The props whose words a visitor reads, and a component's prop values. */\nconst SHOWN_PROPS = [...WORD_PROPS, 'alt', 'title']\n\nfunction shownTexts(node: GapNode): Array<{ get: () => string; set: (value: string) => void }> {\n  const props = node.props ?? {}\n  const slots: Array<{ get: () => string; set: (value: string) => void }> = []\n  for (const prop of SHOWN_PROPS) {\n    if (typeof props[prop] === 'string') slots.push({ get: () => props[prop] as string, set: (value) => (props[prop] = value) })\n  }\n  const values = props['propValues']\n  if (values && typeof values === 'object' && !Array.isArray(values)) {\n    const record = values as Record<string, unknown>\n    for (const name of Object.keys(record)) {\n      if (typeof record[name] === 'string') slots.push({ get: () => record[name] as string, set: (value) => (record[name] = value) })\n    }\n  }\n  return slots\n}\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\nfunction refsIn(text: string, names: AiLayoutRefNames): string[] {\n  const found = (text.match(REF) ?? []).map((ref) => ref.trim())\n  for (const id of names.ids) {\n    if (id.length >= 6 && new RegExp(`(^|[^A-Za-z0-9_-])${escapeRegExp(id)}($|[^A-Za-z0-9_-])`).test(text)) found.push(id)\n  }\n  return [...new Set(found)]\n}\n\nfunction refsOf(nodes: GapNodes, names: AiLayoutRefNames): Array<{ id: string; refs: string[]; text: string }> {\n  return Object.entries(nodes).flatMap(([id, node]) => {\n    const texts = shownTexts(node).map((slot) => slot.get())\n    const refs = [...new Set(texts.flatMap((text) => refsIn(text, names)))]\n    return refs.length ? [{ id, refs, text: texts.filter((text) => refsIn(text, names).length).join(' ') }] : []\n  })\n}\n\n/** Internal references in a language-built page's or frame's words, as the violation that asks again. */\nexport function aiLayoutRefViolations(nodes: NodesMap, names: AiLayoutRefNames): AiDoctrineViolation[] {\n  const found = refsOf(nodes as unknown as GapNodes, names)\n  if (!found.length) return []\n  const refs = [...new Set(found.flatMap((entry) => entry.refs))].map((ref) => `\"${ref}\"`)\n  return [\n    {\n      rule: 14,\n      code: AI_LAYOUT_REF_CODE,\n      message: `${refs.join(', ')} ${refs.length === 1 ? 'is a link reference' : 'are link references'} written into words a visitor reads. A reference goes only in a button's or a list item's to; in text, name the page by its title, or leave the reference out.`,\n      nodeIds: found.map((entry) => entry.id),\n    },\n  ]\n}\n\n/**\n * The page or frame with no internal reference in its words: a page's\n * reference is written as that page's title, and a line that still names a\n * reference is taken out, as a gap is. Returns what was rewritten and taken.\n */\nexport function aiLayoutWithoutRefs(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n): { nodes: NodesMap; dropped: string[] } {\n  if (!refsOf(input as unknown as GapNodes, names).length) return { nodes: input, dropped: [] }\n  const nodes = cloneNodes(input)\n  const labels = new Map(names.pages.map((page) => [page.id, page.label]))\n  const dropped: string[] = []\n  for (const node of Object.values(nodes)) {\n    for (const slot of shownTexts(node)) {\n      const before = slot.get()\n      const after = before.replace(PAGE_REF, (ref, id: string) => labels.get(id) ?? ref)\n      if (after !== before) {\n        slot.set(after)\n        dropped.push(`\"${before}\" written as \"${after}\"`)\n      }\n    }\n  }\n  dropped.push(...pruneFound(nodes, rootId, refsOf(nodes, names)))\n  return { nodes: nodes as unknown as NodesMap, dropped }\n}\n\n/**\n * A language-built page's or frame's words held to both (AGL-3660): before\n * the last answer, each gap and each internal reference is a violation that\n * asks again; in the last, they are taken out and the rest is kept.\n */\nexport function aiLayoutCopyCheck(\n  input: NodesMap,\n  rootId: string,\n  names: AiLayoutRefNames,\n  last: boolean,\n): { nodes: NodesMap; dropped: string[]; violations: AiDoctrineViolation[] } {\n  if (!last) {\n    return { nodes: input, dropped: [], violations: [...aiLayoutRefViolations(input, names), ...aiLayoutGapViolations(input)] }\n  }\n  const refs = aiLayoutWithoutRefs(input, rootId, names)\n  const gaps = aiLayoutWithoutGaps(refs.nodes, rootId)\n  return { nodes: gaps.nodes, dropped: [...refs.dropped, ...gaps.dropped], violations: [] }\n}\n"],"names":["aiBracketedFacts","aiStoredScrollTargets","NOT_WORDS","Set","WORD_PROPS","SPEAKS_ALONE","HEADING_VARIANTS","AI_LAYOUT_GAP_CODE","stringsOf","value","key","has","Array","isArray","flatMap","entry","Object","entries","name","gapsOf","nodes","id","node","texts","props","facts","length","text","filter","join","aiLayoutGapViolations","found","rule","code","message","nodeIds","map","parentsOf","parents","Map","child","set","subtree","ids","stack","next","pop","includes","push","wordsOf","prop","trim","isHeading","componentId","String","test","speaks","beyondHeadings","some","each","says","copyProps","values","propValues","cloneNodes","input","fromEntries","pruneFound","rootId","dropped","sections","touched","remove","parent","get","prune","section","add","above","first","label","aiLayoutWithoutGaps","AI_LAYOUT_REF_CODE","REF","PAGE_REF","SHOWN_PROPS","shownTexts","slots","record","keys","escapeRegExp","replace","refsIn","names","match","ref","RegExp","refsOf","slot","refs","aiLayoutRefViolations","aiLayoutWithoutRefs","labels","pages","page","before","after","aiLayoutCopyCheck","last","violations","gaps"],"mappings":"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"}

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

@@ -0,0 +1,161 @@
+/**
+ * @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 type { AiTool } from '../providers/contract';
+/**
+ * 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 declare const AI_LAYOUT_BLOCK_KINDS: readonly ["eyebrow", "heading", "lede", "text", "note", "list", "button", "image", "cards", "steps", "stats", "quotes", "faq", "form", "component"];
+export type AiLayoutBlockKind = (typeof AI_LAYOUT_BLOCK_KINDS)[number];
+/** The kinds that carry `items`. */
+export declare const AI_LAYOUT_GROUP_KINDS: ReadonlySet<AiLayoutBlockKind>;
+export declare const AI_LAYOUT_BANDS: readonly ["plain", "soft", "brand", "dark"];
+export type AiLayoutBand = (typeof AI_LAYOUT_BANDS)[number];
+export declare const AI_LAYOUT_ALIGNS: readonly ["start", "center"];
+export type AiLayoutAlign = (typeof AI_LAYOUT_ALIGNS)[number];
+export declare const AI_LAYOUT_STYLES: readonly ["primary", "secondary", "quiet", "large"];
+export type AiLayoutStyle = (typeof AI_LAYOUT_STYLES)[number];
+/** The most columns a row holds; a fifth is folded into the fourth. */
+export declare 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 declare const AI_LAYOUT_MAX_ITEMS = 7;
+/** The most quotes a group shows: each is a gap the owner fills with a real one. */
+export declare const AI_LAYOUT_MAX_QUOTES = 3;
+export interface AiLayoutItem {
+    title: string;
+    text: string;
+    to?: string;
+    icon?: string;
+}
+export interface AiLayoutBlock {
+    kind: AiLayoutBlockKind;
+    col?: number;
+    text?: string;
+    to?: string;
+    style?: AiLayoutStyle;
+    icon?: string;
+    items?: AiLayoutItem[];
+}
+export interface AiLayoutSection {
+    band?: AiLayoutBand;
+    cols?: number[];
+    align?: AiLayoutAlign;
+    blocks: AiLayoutBlock[];
+}
+/** A page: its plan's sections, in order. */
+export interface AiLayoutPageDoc {
+    sections: AiLayoutSection[];
+}
+/** A site's frame: the header and the footer every page renders between. */
+export interface AiLayoutFrameDoc {
+    header: AiLayoutSection;
+    footer: AiLayoutSection;
+}
+/** The page tool: every section of one page, in plan order, in one answer. */
+export declare const AI_LAYOUT_PAGE_TOOL: AiTool;
+/** The frame tool: the site's header and footer, in the same language. */
+export declare const AI_LAYOUT_FRAME_TOOL: AiTool;
+/**
+ * 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 declare const AI_LAYOUT_LANGUAGE_TEXT: string;
+/** What the reader settled on its own, for the job's record and the specs. */
+export interface AiLayoutSettlement {
+    /** Where: `sections[2].blocks[1]`, `header`. */
+    at: string;
+    what: string;
+}
+/** A section read from an answer, or `null` with why it could not be. */
+export declare function aiReadLayoutSection(raw: unknown, at: string, settled: AiLayoutSettlement[]): AiLayoutSection | null;
+/** A page answer read: the sections it gave, by plan position, and the positions it could not. */
+export interface AiLayoutPageReading {
+    /** One entry per planned section; `null` where the answer gave nothing usable. */
+    sections: Array<AiLayoutSection | null>;
+    settled: AiLayoutSettlement[];
+}
+/**
+ * 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 declare function aiReadLayoutPage(raw: unknown, planned: number): AiLayoutPageReading;
+/** A frame answer read: a header and a footer, either `null` where it was not usable. */
+export declare function aiReadLayoutFrame(raw: unknown): {
+    header: AiLayoutSection | null;
+    footer: AiLayoutSection | null;
+    settled: AiLayoutSettlement[];
+};