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

package/src/lib/jobs/ai-layout-full-height.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */
+/**
+ * A layout at least as tall as the window (AGL-3596).
+ *
+ * A layout is header, page, footer, top to bottom, and on a page shorter than
+ * the window the footer used to end wherever the page did — on beta.230 a
+ * contact page left its footer floating halfway up the screen with blank page
+ * under it. So every layout the AI builds is written as one column at least
+ * the window's height, and the part of it that holds the Layout Slot takes
+ * the room left over: the footer sits at the bottom of a short page and
+ * follows the content of a long one.
+ *
+ * Written by the platform after the model answers and before the doctrine
+ * checks the tree, so the doctrine holds the column like anything else: it is
+ * a Stack with a style of its own, which no rule calls an empty wrapper.
+ */
+/** The id of the column the platform adds, when no node of the tree has it. */
+export declare const AI_LAYOUT_FRAME_ID = "aiLayoutFrame";
+/**
+ * The layout with its root's children in a column at least the window's
+ * height, and the child that holds the Layout Slot growing into the room
+ * left. A tree whose top already sets a minimum height is left as it came,
+ * and so is anything that is not a node map or holds no Layout Slot.
+ */
+export declare function aiLayoutWithFullHeight(tree: unknown): unknown;

package/src/lib/jobs/ai-layout-full-height.js

@@ -0,0 +1,82 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ /**
+ * A layout at least as tall as the window (AGL-3596).
+ *
+ * A layout is header, page, footer, top to bottom, and on a page shorter than
+ * the window the footer used to end wherever the page did — on beta.230 a
+ * contact page left its footer floating halfway up the screen with blank page
+ * under it. So every layout the AI builds is written as one column at least
+ * the window's height, and the part of it that holds the Layout Slot takes
+ * the room left over: the footer sits at the bottom of a short page and
+ * follows the content of a long one.
+ *
+ * Written by the platform after the model answers and before the doctrine
+ * checks the tree, so the doctrine holds the column like anything else: it is
+ * a Stack with a style of its own, which no rule calls an empty wrapper.
+ */ /** The id of the column the platform adds, when no node of the tree has it. */ export const AI_LAYOUT_FRAME_ID = 'aiLayoutFrame';
+const isRecord = (value)=>Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const childrenOf = (node)=>Array.isArray(node == null ? void 0 : node.nodes) ? node.nodes.filter((id)=>typeof id === 'string') : [];
+/**
+ * The layout with its root's children in a column at least the window's
+ * height, and the child that holds the Layout Slot growing into the room
+ * left. A tree whose top already sets a minimum height is left as it came,
+ * and so is anything that is not a node map or holds no Layout Slot.
+ */ export function aiLayoutWithFullHeight(tree) {
+    var _source_grower_sx;
+    var _source_top__sx;
+    if (!isRecord(tree) || !isRecord(tree['nodes'])) return tree;
+    const source = tree['nodes'];
+    const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null;
+    if (!rootId || !isRecord(source[rootId])) return tree;
+    const top = childrenOf(source[rootId]).filter((id)=>isRecord(source[id]));
+    if (!top.length) return tree;
+    if (top.length === 1 && ((_source_top__sx = source[top[0]].sx) == null ? void 0 : _source_top__sx['minHeight']) !== undefined) return tree;
+    const holdsSlot = (id, seen = new Set())=>{
+        if (seen.has(id) || !isRecord(source[id])) return false;
+        seen.add(id);
+        return source[id].componentId === 'layoutSlot' || childrenOf(source[id]).some((child)=>holdsSlot(child, seen));
+    };
+    const grower = top.find((id)=>holdsSlot(id));
+    if (!grower) return tree;
+    let frameId = AI_LAYOUT_FRAME_ID;
+    for(let n = 2; frameId in source; n += 1)frameId = `${AI_LAYOUT_FRAME_ID}${n}`;
+    const nodes = _extends({}, source, {
+        [rootId]: _extends({}, source[rootId], {
+            nodes: [
+                frameId
+            ]
+        }),
+        [frameId]: {
+            componentId: 'muiStack',
+            sx: {
+                minHeight: '100vh'
+            },
+            nodes: top
+        },
+        [grower]: _extends({}, source[grower], {
+            sx: _extends({}, (_source_grower_sx = source[grower].sx) != null ? _source_grower_sx : {}, {
+                flexGrow: 1
+            })
+        })
+    });
+    return _extends({}, tree, {
+        nodes
+    });
+}
+
+//# sourceMappingURL=ai-layout-full-height.js.map

package/src/lib/jobs/ai-layout-full-height.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-full-height.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\n/**\n * A layout at least as tall as the window (AGL-3596).\n *\n * A layout is header, page, footer, top to bottom, and on a page shorter than\n * the window the footer used to end wherever the page did — on beta.230 a\n * contact page left its footer floating halfway up the screen with blank page\n * under it. So every layout the AI builds is written as one column at least\n * the window's height, and the part of it that holds the Layout Slot takes\n * the room left over: the footer sits at the bottom of a short page and\n * follows the content of a long one.\n *\n * Written by the platform after the model answers and before the doctrine\n * checks the tree, so the doctrine holds the column like anything else: it is\n * a Stack with a style of its own, which no rule calls an empty wrapper.\n */\n\n/** The id of the column the platform adds, when no node of the tree has it. */\nexport const AI_LAYOUT_FRAME_ID = 'aiLayoutFrame'\n\ntype RawNode = { componentId?: unknown; props?: Record<string, unknown>; sx?: Record<string, unknown>; nodes?: unknown }\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n\nconst childrenOf = (node: RawNode | undefined): string[] =>\n  Array.isArray(node?.nodes) ? (node.nodes as unknown[]).filter((id): id is string => typeof id === 'string') : []\n\n/**\n * The layout with its root's children in a column at least the window's\n * height, and the child that holds the Layout Slot growing into the room\n * left. A tree whose top already sets a minimum height is left as it came,\n * and so is anything that is not a node map or holds no Layout Slot.\n */\nexport function aiLayoutWithFullHeight(tree: unknown): unknown {\n  if (!isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const source = tree['nodes'] as Record<string, RawNode>\n  const rootId = typeof tree['rootId'] === 'string' ? tree['rootId'] : null\n  if (!rootId || !isRecord(source[rootId])) return tree\n  const top = childrenOf(source[rootId]).filter((id) => isRecord(source[id]))\n  if (!top.length) return tree\n  if (top.length === 1 && source[top[0]].sx?.['minHeight'] !== undefined) return tree\n\n  const holdsSlot = (id: string, seen = new Set<string>()): boolean => {\n    if (seen.has(id) || !isRecord(source[id])) return false\n    seen.add(id)\n    return source[id].componentId === 'layoutSlot' || childrenOf(source[id]).some((child) => holdsSlot(child, seen))\n  }\n  const grower = top.find((id) => holdsSlot(id))\n  if (!grower) return tree\n\n  let frameId = AI_LAYOUT_FRAME_ID\n  for (let n = 2; frameId in source; n += 1) frameId = `${AI_LAYOUT_FRAME_ID}${n}`\n  const nodes: Record<string, RawNode> = {\n    ...source,\n    [rootId]: { ...source[rootId], nodes: [frameId] },\n    [frameId]: { componentId: 'muiStack', sx: { minHeight: '100vh' }, nodes: top },\n    [grower]: { ...source[grower], sx: { ...(source[grower].sx ?? {}), flexGrow: 1 } },\n  }\n  return { ...tree, nodes }\n}\n"],"names":["AI_LAYOUT_FRAME_ID","isRecord","value","Boolean","Array","isArray","childrenOf","node","nodes","filter","id","aiLayoutWithFullHeight","tree","source","rootId","top","length","sx","undefined","holdsSlot","seen","Set","has","add","componentId","some","child","grower","find","frameId","n","minHeight","flexGrow"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;CAcC,GAED,6EAA6E,GAC7E,OAAO,MAAMA,qBAAqB,gBAAe;AAIjD,MAAMC,WAAW,CAACC,QAChBC,QAAQD,UAAU,OAAOA,UAAU,YAAY,CAACE,MAAMC,OAAO,CAACH;AAEhE,MAAMI,aAAa,CAACC,OAClBH,MAAMC,OAAO,CAACE,wBAAAA,KAAMC,KAAK,IAAI,AAACD,KAAKC,KAAK,CAAeC,MAAM,CAAC,CAACC,KAAqB,OAAOA,OAAO,YAAY,EAAE;AAElH;;;;;CAKC,GACD,OAAO,SAASC,uBAAuBC,IAAa;QAuBPC;QAhBnBA;IANxB,IAAI,CAACZ,SAASW,SAAS,CAACX,SAASW,IAAI,CAAC,QAAQ,GAAG,OAAOA;IACxD,MAAMC,SAASD,IAAI,CAAC,QAAQ;IAC5B,MAAME,SAAS,OAAOF,IAAI,CAAC,SAAS,KAAK,WAAWA,IAAI,CAAC,SAAS,GAAG;IACrE,IAAI,CAACE,UAAU,CAACb,SAASY,MAAM,CAACC,OAAO,GAAG,OAAOF;IACjD,MAAMG,MAAMT,WAAWO,MAAM,CAACC,OAAO,EAAEL,MAAM,CAAC,CAACC,KAAOT,SAASY,MAAM,CAACH,GAAG;IACzE,IAAI,CAACK,IAAIC,MAAM,EAAE,OAAOJ;IACxB,IAAIG,IAAIC,MAAM,KAAK,KAAKH,EAAAA,kBAAAA,MAAM,CAACE,GAAG,CAAC,EAAE,CAAC,CAACE,EAAE,qBAAjBJ,eAAmB,CAAC,YAAY,MAAKK,WAAW,OAAON;IAE/E,MAAMO,YAAY,CAACT,IAAYU,OAAO,IAAIC,KAAa;QACrD,IAAID,KAAKE,GAAG,CAACZ,OAAO,CAACT,SAASY,MAAM,CAACH,GAAG,GAAG,OAAO;QAClDU,KAAKG,GAAG,CAACb;QACT,OAAOG,MAAM,CAACH,GAAG,CAACc,WAAW,KAAK,gBAAgBlB,WAAWO,MAAM,CAACH,GAAG,EAAEe,IAAI,CAAC,CAACC,QAAUP,UAAUO,OAAON;IAC5G;IACA,MAAMO,SAASZ,IAAIa,IAAI,CAAC,CAAClB,KAAOS,UAAUT;IAC1C,IAAI,CAACiB,QAAQ,OAAOf;IAEpB,IAAIiB,UAAU7B;IACd,IAAK,IAAI8B,IAAI,GAAGD,WAAWhB,QAAQiB,KAAK,EAAGD,UAAU,GAAG7B,qBAAqB8B,GAAG;IAChF,MAAMtB,QAAiC,aAClCK;QACH,CAACC,OAAO,EAAE,aAAKD,MAAM,CAACC,OAAO;YAAEN,OAAO;gBAACqB;aAAQ;;QAC/C,CAACA,QAAQ,EAAE;YAAEL,aAAa;YAAYP,IAAI;gBAAEc,WAAW;YAAQ;YAAGvB,OAAOO;QAAI;QAC7E,CAACY,OAAO,EAAE,aAAKd,MAAM,CAACc,OAAO;YAAEV,IAAI,cAAMJ,oBAAAA,MAAM,CAACc,OAAO,CAACV,EAAE,YAAjBJ,oBAAqB,CAAC;gBAAImB,UAAU;;;;IAE/E,OAAO,aAAKpB;QAAMJ;;AACpB"}

package/src/lib/jobs/ai-layout-site-facts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @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 { AiDoctrineTree, AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
+/**
+ * What a layout may say about the business it frames (AGL-3596).
+ *
+ * A layout's header and footer are on every page, so a fact in them is
+ * published everywhere at once. Two went wrong on beta.230: the model coined
+ * a name for the business ("Austin Paws Grooming" for a site called Hillside
+ * Dog Grooming), and a footer is exactly where a model reaches for a phone
+ * number, an email or opening hours the brief never gave.
+ *
+ * - The site's name is the brand, and it is written as the host token that
+ *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every
+ *   page rather than leaving the name it was built under
+ *   (`aiLayoutWithSiteName`).
+ * - A contact detail the brief does not give is refused by the layout's own
+ *   check (`aiLayoutInventedContactViolations`), so the model is asked again
+ *   to leave it out: an email, a phone number, a street address or opening
+ *   hours appear in the layout only when the brief has them.
+ */
+/** The host token that reads a site's own name at render. */
+export declare const AI_SITE_NAME_TOKEN = "{{host.businessName}}";
+/**
+ * The tree with every written occurrence of the site's name — the brand, the
+ * copyright line — replaced by the host token that reads it. Matched whole,
+ * ignoring case and runs of spaces. Anything that is not a node map, and a
+ * name too short to match safely, leaves the tree as it came.
+ */
+export declare function aiLayoutWithSiteName(tree: unknown, siteName: string | null | undefined): unknown;
+/**
+ * Rule 14 for a layout: every email address, phone number, street address
+ * and opening time its words carry is one the brief gives. A number is read
+ * by its digits, so a brief's "512.555.0142" admits "(512) 555-0142"; a year
+ * or a price is not a phone number, so only a run of seven digits or more is
+ * read as one. An address is matched by its house number and first street
+ * word; hours are admitted when the brief gives any, since a brief that names
+ * its hours is spelled a dozen ways a footer may fairly reword.
+ */
+export declare function aiLayoutInventedContactViolations(tree: AiDoctrineTree, brief: string): AiDoctrineViolation[];

package/src/lib/jobs/ai-layout-site-facts.js

@@ -0,0 +1,153 @@
+/**
+ * @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 { walkTree } from "../runtime/ai-doctrine-validators.js";
+/**
+ * What a layout may say about the business it frames (AGL-3596).
+ *
+ * A layout's header and footer are on every page, so a fact in them is
+ * published everywhere at once. Two went wrong on beta.230: the model coined
+ * a name for the business ("Austin Paws Grooming" for a site called Hillside
+ * Dog Grooming), and a footer is exactly where a model reaches for a phone
+ * number, an email or opening hours the brief never gave.
+ *
+ * - The site's name is the brand, and it is written as the host token that
+ *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every
+ *   page rather than leaving the name it was built under
+ *   (`aiLayoutWithSiteName`).
+ * - A contact detail the brief does not give is refused by the layout's own
+ *   check (`aiLayoutInventedContactViolations`), so the model is asked again
+ *   to leave it out: an email, a phone number, a street address or opening
+ *   hours appear in the layout only when the brief has them.
+ */ /** The host token that reads a site's own name at render. */ export const AI_SITE_NAME_TOKEN = '{{host.businessName}}';
+const isRecord = (value)=>Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * The tree with every written occurrence of the site's name — the brand, the
+ * copyright line — replaced by the host token that reads it. Matched whole,
+ * ignoring case and runs of spaces. Anything that is not a node map, and a
+ * name too short to match safely, leaves the tree as it came.
+ */ export function aiLayoutWithSiteName(tree, siteName) {
+    const name = (siteName != null ? siteName : '').replace(/\s+/g, ' ').trim();
+    if (name.length < 3 || !isRecord(tree) || !isRecord(tree['nodes'])) return tree;
+    const pattern = new RegExp(`(?<![\\p{L}\\p{N}])${escapeRegExp(name).replace(/ /g, '\\s+')}(?![\\p{L}\\p{N}])`, 'giu');
+    let changed = false;
+    const nodes = {};
+    for (const [id, node] of Object.entries(tree['nodes'])){
+        if (!isRecord(node) || !isRecord(node['props'])) {
+            nodes[id] = node;
+            continue;
+        }
+        const props = {};
+        let touched = false;
+        for (const [key, value] of Object.entries(node['props'])){
+            const next = typeof value === 'string' ? value.replace(pattern, AI_SITE_NAME_TOKEN) : value;
+            if (next !== value) touched = true;
+            props[key] = next;
+        }
+        nodes[id] = touched ? _extends({}, node, {
+            props
+        }) : node;
+        changed || (changed = touched);
+    }
+    return changed ? _extends({}, tree, {
+        nodes
+    }) : tree;
+}
+const EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+/** A phone number as people write one: seven or more digits, with the usual separators between them. */ const PHONE = /(?:\+?\(?\d[\d\s().-]{5,}\d)/g;
+const digitsOf = (value)=>value.replace(/\D/g, '');
+const STREET_SUFFIX = 'Street|St|Avenue|Ave|Road|Rd|Boulevard|Blvd|Lane|Ln|Drive|Dr|Way|Court|Ct|Place|Pl|Parkway|Pkwy|Highway|Hwy|Trail|Trl|Circle|Cir|Square|Sq';
+/** A street address as a footer writes one: a house number, one to four words, and a street suffix. */ const ADDRESS = new RegExp(`\\b\\d{1,6}\\s+(?:[A-Z0-9][\\w'.-]*\\s+){1,4}(?:${STREET_SUFFIX})\\b\\.?`, 'g');
+const DAY = '(?:Mon(?:day)?|Tue(?:s|sday)?|Wed(?:nesday)?|Thu(?:r|rs|rsday)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?)';
+/**
+ * Opening hours: a time of day ("9am", "8:30 PM") or a range of days
+ * ("Mon–Fri", "Monday through Saturday"). A bare "9–5" is left alone, since
+ * "2–3 weeks" is written the same way.
+ */ const HOURS = new RegExp([
+    '\\b\\d{1,2}(?::\\d{2})?\\s?(?:[ap]\\.?m\\.?)(?![a-z])',
+    `\\b${DAY}\\s?(?:[–—-]|to|through|thru)\\s?${DAY}\\b`
+].join('|'), 'gi');
+/** SVG path data: a move command, then only commands and numbers. */ const SVG_PATH_DATA = /^\s*[Mm][\s\d.,eE+-]*[\d.][\s\d.,eE+\-MmLlHhVvCcSsQqTtAaZz]*$/;
+/** The words of an address, as a brief and a layout can both spell them. */ const addressKey = (value)=>{
+    var _value_toLowerCase_match;
+    const [number, word] = (_value_toLowerCase_match = value.toLowerCase().match(/[a-z0-9]+/g)) != null ? _value_toLowerCase_match : [];
+    return `${number != null ? number : ''} ${word != null ? word : ''}`;
+};
+/**
+ * The contact details a brief gives: its email addresses, the digits of its
+ * phone numbers, the house number and first word of its street addresses,
+ * and whether it gives opening hours at all.
+ */ function briefFacts(brief) {
+    var _brief_match, _brief_match1;
+    return {
+        emails: new Set(((_brief_match = brief.match(EMAIL)) != null ? _brief_match : []).map((email)=>email.toLowerCase())),
+        digits: digitsOf(brief),
+        addresses: new Set(((_brief_match1 = brief.match(ADDRESS)) != null ? _brief_match1 : []).map(addressKey)),
+        hours: new RegExp(HOURS.source, 'i').test(brief)
+    };
+}
+/**
+ * Rule 14 for a layout: every email address, phone number, street address
+ * and opening time its words carry is one the brief gives. A number is read
+ * by its digits, so a brief's "512.555.0142" admits "(512) 555-0142"; a year
+ * or a price is not a phone number, so only a run of seven digits or more is
+ * read as one. An address is matched by its house number and first street
+ * word; hours are admitted when the brief gives any, since a brief that names
+ * its hours is spelled a dozen ways a footer may fairly reword.
+ */ export function aiLayoutInventedContactViolations(tree, brief) {
+    const given = briefFacts(brief);
+    const invented = [];
+    const nodeIds = [];
+    for (const { id, node } of walkTree(tree)){
+        var _node_props;
+        for (const value of Object.values((_node_props = node.props) != null ? _node_props : {})){
+            // An icon's drawing (`iconPath`) is SVG path data, whose coordinates read as phone numbers.
+            if (typeof value !== 'string' || SVG_PATH_DATA.test(value)) continue;
+            const matches = (pattern)=>{
+                var _value_match;
+                return [
+                    ...(_value_match = value.match(pattern)) != null ? _value_match : []
+                ];
+            };
+            const found = [
+                ...matches(EMAIL).filter((email)=>!given.emails.has(email.toLowerCase())),
+                ...matches(PHONE).filter((phone)=>{
+                    const digits = digitsOf(phone);
+                    return digits.length >= 7 && !given.digits.includes(digits);
+                }),
+                ...matches(ADDRESS).filter((address)=>!given.addresses.has(addressKey(address))),
+                ...given.hours ? [] : matches(HOURS)
+            ];
+            if (!found.length) continue;
+            invented.push(...found.map((fact)=>fact.trim()));
+            if (!nodeIds.includes(id)) nodeIds.push(id);
+        }
+    }
+    if (!invented.length) return [];
+    return [
+        {
+            rule: 14,
+            code: 'contact-not-in-brief',
+            message: `${[
+                ...new Set(invented)
+            ].map((fact)=>`"${fact}"`).join(', ')} is not in the brief. A layout shows only the contact details the brief gives: leave this out, and never invent one.`,
+            nodeIds
+        }
+    ];
+}
+
+//# sourceMappingURL=ai-layout-site-facts.js.map

package/src/lib/jobs/ai-layout-site-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-site-facts.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 { AiDoctrineNode, AiDoctrineTree, AiDoctrineViolation } from '../runtime/ai-doctrine-validators'\nimport { walkTree } from '../runtime/ai-doctrine-validators'\n\n/**\n * What a layout may say about the business it frames (AGL-3596).\n *\n * A layout's header and footer are on every page, so a fact in them is\n * published everywhere at once. Two went wrong on beta.230: the model coined\n * a name for the business (\"Austin Paws Grooming\" for a site called Hillside\n * Dog Grooming), and a footer is exactly where a model reaches for a phone\n * number, an email or opening hours the brief never gave.\n *\n * - The site's name is the brand, and it is written as the host token that\n *   reads it (`{{host.businessName}}`), so a rename in Setup follows on every\n *   page rather than leaving the name it was built under\n *   (`aiLayoutWithSiteName`).\n * - A contact detail the brief does not give is refused by the layout's own\n *   check (`aiLayoutInventedContactViolations`), so the model is asked again\n *   to leave it out: an email, a phone number, a street address or opening\n *   hours appear in the layout only when the brief has them.\n */\n\n/** The host token that reads a site's own name at render. */\nexport const AI_SITE_NAME_TOKEN = '{{host.businessName}}'\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n\nconst escapeRegExp = (value: string) => value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n\n/**\n * The tree with every written occurrence of the site's name — the brand, the\n * copyright line — replaced by the host token that reads it. Matched whole,\n * ignoring case and runs of spaces. Anything that is not a node map, and a\n * name too short to match safely, leaves the tree as it came.\n */\nexport function aiLayoutWithSiteName(tree: unknown, siteName: string | null | undefined): unknown {\n  const name = (siteName ?? '').replace(/\\s+/g, ' ').trim()\n  if (name.length < 3 || !isRecord(tree) || !isRecord(tree['nodes'])) return tree\n  const pattern = new RegExp(`(?<![\\\\p{L}\\\\p{N}])${escapeRegExp(name).replace(/ /g, '\\\\s+')}(?![\\\\p{L}\\\\p{N}])`, 'giu')\n  let changed = false\n  const nodes: Record<string, unknown> = {}\n  for (const [id, node] of Object.entries(tree['nodes'])) {\n    if (!isRecord(node) || !isRecord(node['props'])) {\n      nodes[id] = node\n      continue\n    }\n    const props: Record<string, unknown> = {}\n    let touched = false\n    for (const [key, value] of Object.entries(node['props'])) {\n      const next = typeof value === 'string' ? value.replace(pattern, AI_SITE_NAME_TOKEN) : value\n      if (next !== value) touched = true\n      props[key] = next\n    }\n    nodes[id] = touched ? { ...node, props } : node\n    changed ||= touched\n  }\n  return changed ? { ...tree, nodes } : tree\n}\n\nconst EMAIL = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}/g\n/** A phone number as people write one: seven or more digits, with the usual separators between them. */\nconst PHONE = /(?:\\+?\\(?\\d[\\d\\s().-]{5,}\\d)/g\n\nconst digitsOf = (value: string) => value.replace(/\\D/g, '')\n\nconst STREET_SUFFIX =\n  'Street|St|Avenue|Ave|Road|Rd|Boulevard|Blvd|Lane|Ln|Drive|Dr|Way|Court|Ct|Place|Pl|Parkway|Pkwy|Highway|Hwy|Trail|Trl|Circle|Cir|Square|Sq'\n/** A street address as a footer writes one: a house number, one to four words, and a street suffix. */\nconst ADDRESS = new RegExp(`\\\\b\\\\d{1,6}\\\\s+(?:[A-Z0-9][\\\\w'.-]*\\\\s+){1,4}(?:${STREET_SUFFIX})\\\\b\\\\.?`, 'g')\nconst DAY = '(?:Mon(?:day)?|Tue(?:s|sday)?|Wed(?:nesday)?|Thu(?:r|rs|rsday)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?)'\n/**\n * Opening hours: a time of day (\"9am\", \"8:30 PM\") or a range of days\n * (\"Mon–Fri\", \"Monday through Saturday\"). A bare \"9–5\" is left alone, since\n * \"2–3 weeks\" is written the same way.\n */\nconst HOURS = new RegExp(\n  [\n    '\\\\b\\\\d{1,2}(?::\\\\d{2})?\\\\s?(?:[ap]\\\\.?m\\\\.?)(?![a-z])',\n    `\\\\b${DAY}\\\\s?(?:[–—-]|to|through|thru)\\\\s?${DAY}\\\\b`,\n  ].join('|'),\n  'gi',\n)\n\n/** SVG path data: a move command, then only commands and numbers. */\nconst SVG_PATH_DATA = /^\\s*[Mm][\\s\\d.,eE+-]*[\\d.][\\s\\d.,eE+\\-MmLlHhVvCcSsQqTtAaZz]*$/\n\n/** The words of an address, as a brief and a layout can both spell them. */\nconst addressKey = (value: string) => {\n  const [number, word] = value.toLowerCase().match(/[a-z0-9]+/g) ?? []\n  return `${number ?? ''} ${word ?? ''}`\n}\n\n/**\n * The contact details a brief gives: its email addresses, the digits of its\n * phone numbers, the house number and first word of its street addresses,\n * and whether it gives opening hours at all.\n */\nfunction briefFacts(brief: string): { emails: Set<string>; digits: string; addresses: Set<string>; hours: boolean } {\n  return {\n    emails: new Set((brief.match(EMAIL) ?? []).map((email) => email.toLowerCase())),\n    digits: digitsOf(brief),\n    addresses: new Set((brief.match(ADDRESS) ?? []).map(addressKey)),\n    hours: new RegExp(HOURS.source, 'i').test(brief),\n  }\n}\n\n/**\n * Rule 14 for a layout: every email address, phone number, street address\n * and opening time its words carry is one the brief gives. A number is read\n * by its digits, so a brief's \"512.555.0142\" admits \"(512) 555-0142\"; a year\n * or a price is not a phone number, so only a run of seven digits or more is\n * read as one. An address is matched by its house number and first street\n * word; hours are admitted when the brief gives any, since a brief that names\n * its hours is spelled a dozen ways a footer may fairly reword.\n */\nexport function aiLayoutInventedContactViolations(tree: AiDoctrineTree, brief: string): AiDoctrineViolation[] {\n  const given = briefFacts(brief)\n  const invented: string[] = []\n  const nodeIds: string[] = []\n  for (const { id, node } of walkTree(tree)) {\n    for (const value of Object.values((node as AiDoctrineNode).props ?? {})) {\n      // An icon's drawing (`iconPath`) is SVG path data, whose coordinates read as phone numbers.\n      if (typeof value !== 'string' || SVG_PATH_DATA.test(value)) continue\n      const matches = (pattern: RegExp): string[] => [...(value.match(pattern) ?? [])]\n      const found: string[] = [\n        ...matches(EMAIL).filter((email) => !given.emails.has(email.toLowerCase())),\n        ...matches(PHONE).filter((phone) => {\n          const digits = digitsOf(phone)\n          return digits.length >= 7 && !given.digits.includes(digits)\n        }),\n        ...matches(ADDRESS).filter((address) => !given.addresses.has(addressKey(address))),\n        ...(given.hours ? [] : matches(HOURS)),\n      ]\n      if (!found.length) continue\n      invented.push(...found.map((fact) => fact.trim()))\n      if (!nodeIds.includes(id)) nodeIds.push(id)\n    }\n  }\n  if (!invented.length) return []\n  return [\n    {\n      rule: 14,\n      code: 'contact-not-in-brief',\n      message: `${[...new Set(invented)].map((fact) => `\"${fact}\"`).join(', ')} is not in the brief. A layout shows only the contact details the brief gives: leave this out, and never invent one.`,\n      nodeIds,\n    },\n  ]\n}\n"],"names":["walkTree","AI_SITE_NAME_TOKEN","isRecord","value","Boolean","Array","isArray","escapeRegExp","replace","aiLayoutWithSiteName","tree","siteName","name","trim","length","pattern","RegExp","changed","nodes","id","node","Object","entries","props","touched","key","next","EMAIL","PHONE","digitsOf","STREET_SUFFIX","ADDRESS","DAY","HOURS","join","SVG_PATH_DATA","addressKey","number","word","toLowerCase","match","briefFacts","brief","emails","Set","map","email","digits","addresses","hours","source","test","aiLayoutInventedContactViolations","given","invented","nodeIds","values","matches","found","filter","has","phone","includes","address","push","fact","rule","code","message"],"mappings":"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"}

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

@@ -0,0 +1,145 @@
+/**
+ * @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 AiIconLibraryEntry } from '../runtime/ai-icon-library';
+import { type AiLayoutBand, type AiLayoutBlock, type AiLayoutSection, type AiLayoutSettlement } from './ai-layout-language';
+import { type AiLayoutDestination, type AiLayoutLinkScope, type AiLayoutTargets } from './ai-layout-links';
+import { AiLayoutTreeBuilder, type AiLayoutRawTree } from './ai-layout-tree';
+/**
+ * The layout language compiler (AGL-3660): a page designed in the language
+ * (`ai-layout-language.ts`) becomes the element tree the page stores — built
+ * from the palette's elements and the theme's tokens only, so the doctrine's
+ * building rules hold by construction rather than by a re-ask.
+ *
+ * What the compiler decides, so no model has to:
+ *
+ *  - STRUCTURE. A section is a semantic `section` band around a Container at
+ *    a stock width, its content a Stack on the spacing scale; a row of
+ *    columns is a Grid container whose items are sized `xs:12 md:N` from the
+ *    relative widths, full width on a phone; a group of cards is a Grid of
+ *    sized items, or a Stack where it would be one column.
+ *  - THE OUTLINE. The first section's first heading is the page's one h1 (the
+ *    plan's title stands in where it gave none); every other section opens at
+ *    h2; a card's title is one level under its section's heading.
+ *  - TOKENS. Colors are palette roles, never values: a `brand` band is
+ *    `primary.main` with its contrast text, a `dark` band pins the site's dark
+ *    scheme, a `soft` band is the paper surface. So a band reads in the
+ *    visitor's light or dark mode alike.
+ *  - LINKS. A button goes to a real page id, a section of this page through
+ *    the platform's Scroll to element interaction, or an address the brief
+ *    gave (`ai-layout-links.ts`); one with nowhere to go is left out.
+ *  - THE PLAN. A form or a component the plan places in a section is placed
+ *    there, by its id, whether or not the answer remembered it.
+ *  - RULE 1. Where the workspace keeps reusable components, a section's
+ *    repeated items are instances of the component its plan places; with
+ *    none to place they are drawn in their compact form, a title over its
+ *    text, which is smaller than a block worth a component. A workspace that
+ *    keeps none (Free) draws its repeats in full.
+ *  - RULES 8, 9, 14, 16. Seven items a group at most; every picture carries
+ *    its description as alt text; copy fitted to its place at a clean
+ *    boundary, with any phone number or email the brief did not give written
+ *    as a gap; no wrapper around a lone wrapper, no empty element, and no
+ *    multi-key inline style repeated across a page.
+ */
+export interface AiLayoutPagePlan {
+    /** The page's title in its plan: the h1 where the first section names none. */
+    title: string;
+    sections: ReadonlyArray<{
+        name: string;
+        uses: readonly string[];
+        items: number;
+    }>;
+}
+export interface AiLayoutCompileOptions {
+    /**
+     * Whether the workspace keeps reusable components (AGL-3030). Where it does,
+     * rule 1 holds: repeated items are instances of a component the plan
+     * places, or drawn in their compact form.
+     */
+    reusableComponents: boolean;
+    /**
+     * The ids the page stores its sections under, in plan order
+     * (`aiPageSectionNodeId`): each section root is written under its own, and
+     * a link to a section scrolls to it. Absent, `section-<n>`.
+     */
+    sectionIds?: readonly string[];
+}
+export interface AiLayoutCompiledPage {
+    tree: AiLayoutRawTree;
+    /** Each plan section's root, by its compiled id, in plan order. */
+    sectionRoots: string[];
+    /** A button's compiled id → the plan section a click scrolls to. */
+    scrollTo: Record<string, number>;
+    settled: AiLayoutSettlement[];
+}
+/** The most pictures a page carries; each beyond it is one more empty slot to fill. */
+export declare const AI_LAYOUT_MAX_IMAGES = 3;
+/** The most `brand` or `dark` bands a page shows; more and none stands out. */
+export declare const AI_LAYOUT_MAX_STRONG_BANDS = 2;
+/** Everything one page's compile shares. */
+export interface PageScope {
+    tree: AiLayoutTreeBuilder;
+    plan: AiLayoutPagePlan;
+    targets: AiLayoutTargets;
+    options: AiLayoutCompileOptions;
+    settled: AiLayoutSettlement[];
+    scrollTo: Record<string, number>;
+    images: number;
+    strong: Record<'brand' | 'dark', number>;
+    /** The section of this page that places the site's form, if one does. */
+    formSection: number | null;
+    /** The icon a picture shows until the owner places one, when its block names none. */
+    pageIcon: AiIconLibraryEntry;
+    /** The forms this page already places, each once. */
+    formsPlaced: Set<string>;
+}
+/** Everything one section's compile shares. */
+export interface SectionScope {
+    page: PageScope;
+    index: number;
+    at: string;
+    band: AiLayoutBand;
+    centered: boolean;
+    /** The level of the section's own heading: 1 on the first section, 2 after. */
+    level: number;
+    /**
+     * A section of the site's frame — its footer — whose headings are labels:
+     * a layout carries no heading outline of its own, since every page brings
+     * its own (rule 11).
+     */
+    frame?: boolean;
+    /** Whether the section's own heading has been written. */
+    headed: boolean;
+    link: AiLayoutLinkScope;
+    /** Like items the section may still show (rule 8), across its groups. */
+    itemsLeft: number;
+}
+/** Compiles a page designed in the layout language into the tree it stores. */
+export declare function aiCompileLayoutPage(sections: readonly AiLayoutSection[], plan: AiLayoutPagePlan, targets: AiLayoutTargets, options: AiLayoutCompileOptions): AiLayoutCompiledPage;
+/** A band's own colors, as palette roles: the dark band pins the scheme instead. */
+export declare function bandSx(band: AiLayoutBand): Record<string, unknown> | null;
+/** Spans out of twelve for relative widths: each at least three, summing to twelve. */
+export declare function aiLayoutSpans(weights: readonly number[]): number[];
+export declare function compileRow(scope: SectionScope, columns: Array<{
+    column: AiLayoutBlock[];
+    weight: number;
+}>): string;
+export type Room = 'full' | 'half' | 'narrow';
+/** A column of blocks, top to bottom, with buttons side by side; `null` when nothing in it compiles. */
+export declare function compileFlow(scope: SectionScope, blocks: readonly AiLayoutBlock[], room: Room): string | null;
+export declare function destinationProps(destination: AiLayoutDestination): Record<string, unknown>;
+/** The id the compiled page's root is stored under. */
+export declare const AI_LAYOUT_PAGE_ROOT_ID = "_@_";