@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/jobs/ai-job-component-checks.js

@@ -0,0 +1,442 @@
+/**
+ * @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 { COMPONENT_PROP_NAME_PATTERN, NODE_HIDE_IF_PROP, NODE_HIDE_UNLESS_PROP, REUSABLE_INSTANCE_COMPONENT_ID, REUSABLE_INSTANCE_PROP_VALUES_KEY } from "@aglyn/aglyn/app-utils/reusable-component-keys";
+import { REUSABLE_PROP_KINDS, reusablePropValueShape } from "@aglyn/aglyn/foundation/definitions/property-kinds";
+import { AI_COMPONENT_COPY_KINDS, aiComponentKindBindsTo, aiComponentPropBindsToField, aiComponentPropNamesIn, aiComponentUnofferedAnswers, isAiComponentPropToken } from "../runtime/ai-component-bindings.js";
+import { aiHeadingLevel, detectOffVoiceCopy, walkTree } from "../runtime/ai-doctrine-validators.js";
+import { AI_INSTANCE_REF_PROP } from "../runtime/ai-node-tree.js";
+import { AI_PALETTE } from "../runtime/ai-palette.generated.js";
+import { readAiComponentProps } from "../tools/ai-component-tool.js";
+import { aiModelNodeIds, aiPlacedComponentIds, aiPlanCreation, aiPlanReuseViolations } from "./ai-job-generation.js";
+/**
+ * The component door's own checks (AGL-2908): what a generated reusable
+ * component is held to beyond the doctrine, on a tree the doctrine admitted
+ * and the properties the same answer declared.
+ *
+ * - every token names a property the component declares, and every declared
+ *   property is bound, so no field a page sets changes nothing;
+ * - a property binds only to a field that holds its kind of value
+ *   (`runtime/ai-component-bindings.ts`): a switch takes a Yes / no, a
+ *   dropdown a Choice whose answers it lists, a screen picker a Link
+ *   (AGL-2871), an icon picker an Icon;
+ * - an icon is an Icon the site owner picks, never words (AGL-3054): a copy
+ *   property named or labeled as an icon, shown as copy, is refused;
+ * - its headings start at h3 (AGL-3057): a component is placed inside a page
+ *   section, which opens with its own h2, and a page's outline check sees an
+ *   instance as one node, never the headings it grafts in;
+ * - an optional part is switched off by a Yes / no labeled `Hide …` that
+ *   defaults to No, bound to `hideIf` on that part and never on the whole
+ *   component;
+ * - a default is what the component shows until a page sets it, in the
+ *   site's voice (rule 14), and fits the field it fills;
+ * - what the confirmed plan names is there: the components it reuses, and
+ *   the properties it lists for this component, an icon as an icon (rule 7).
+ *
+ * Pure: no Firestore and no provider, so the component step, the eval
+ * harness and their specs read one definition of a component's checks.
+ */ /** The label a Yes / no that hides a part opens with, so a page reads what it does. */ const HIDE_LABEL = /^Hide\b/;
+/** The kinds of a placed component's property that copy fills as text. */ const COPY_FIELD_KINDS = new Set([
+    'text',
+    'richText'
+]);
+/**
+ * The highest heading a component may carry (AGL-3057): a page section opens
+ * with its own h2, and whatever the section places sits under it.
+ */ export const AI_COMPONENT_TOP_HEADING_LEVEL = 3;
+/** A word naming an icon, in a label or in a name split at its capitals and underscores. */ const ICON_WORD = /\bicons?\b/i;
+/** The fields the confirmed plan lists for its component, read from `name:type`, each name once. */ export function aiPlannedComponentFields(plan) {
+    var _ref;
+    var _aiPlanCreation;
+    const fields = new Map();
+    for (const field of (_ref = (_aiPlanCreation = aiPlanCreation(plan, 'component')) == null ? void 0 : _aiPlanCreation.fields) != null ? _ref : []){
+        const [name = '', type = ''] = field.split(':').map((part)=>part.trim());
+        if (COMPONENT_PROP_NAME_PATTERN.test(name) && !fields.has(name)) fields.set(name, {
+            name,
+            type
+        });
+    }
+    return [
+        ...fields.values()
+    ];
+}
+/** The property names the confirmed plan lists for its component, from its `name:type` fields. */ export function aiPlannedComponentProps(plan) {
+    return aiPlannedComponentFields(plan).map((field)=>field.name);
+}
+/** A property's kind as a sentence names one: "an Image", "a Yes / no". */ function aKind(type) {
+    var _ref;
+    var _REUSABLE_PROP_KINDS_;
+    const label = (_ref = (_REUSABLE_PROP_KINDS_ = REUSABLE_PROP_KINDS[type != null ? type : 'text']) == null ? void 0 : _REUSABLE_PROP_KINDS_.label) != null ? _ref : REUSABLE_PROP_KINDS.text.label;
+    return `${/^[AEIOU]/i.test(label) ? 'an' : 'a'} ${label}`;
+}
+function fieldPhrase(componentId, field) {
+    var _ref;
+    var _AI_PALETTE_componentId;
+    return `the ${(_ref = (_AI_PALETTE_componentId = AI_PALETTE[componentId]) == null ? void 0 : _AI_PALETTE_componentId.displayName) != null ? _ref : componentId}’s ${field}`;
+}
+const tokenOf = (name)=>`{{prop.${name}}}`;
+/** Whether a property's name or label says it is an icon. */ function namedAsIcon(prop) {
+    var _prop_label;
+    const words = prop.name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/_/g, ' ');
+    return ICON_WORD.test(words) || ICON_WORD.test((_prop_label = prop.label) != null ? _prop_label : '');
+}
+/** "{{prop.a}} is" or "{{prop.a}}, {{prop.b}} are", for a finding that names its properties. */ function tokensAre(names) {
+    const tokens = [
+        ...new Set(names)
+    ].map(tokenOf);
+    return `${tokens.slice(0, 3).join(', ')} ${tokens.length === 1 ? 'is' : 'are'}`;
+}
+/**
+ * Whether a property handed on to a placed component fits the property it
+ * fills there: copy into copy, whole or inside a sentence; a picture or a
+ * link only into its own kind, whole; any other kind into one whose value has
+ * its shape.
+ */ function handsOnTo(prop, placedType, whole) {
+    var _prop_type;
+    const type = (_prop_type = prop.type) != null ? _prop_type : 'text';
+    if (AI_COMPONENT_COPY_KINDS.has(type) && COPY_FIELD_KINDS.has(placedType)) return true;
+    if (!whole) return false;
+    if ([
+        type,
+        placedType
+    ].some((kind)=>kind === 'image' || kind === 'href')) return type === placedType;
+    return reusablePropValueShape(prop) === reusablePropValueShape({
+        type: placedType
+    });
+}
+/**
+ * The component door's check of its bindings, on a tree the doctrine admitted
+ * and the properties the same answer declared: every token names a declared
+ * property on a field of its kind, every property is bound, an icon is never
+ * shown as words, a part is hidden by a `Hide …` Yes / no that defaults to No,
+ * and a default fits the field it fills. `refused` names properties the answer
+ * declared and the reading refused, which are reported there and not again
+ * here.
+ */ export function aiComponentBindingViolations(tree, props, inventory, refused = []) {
+    var _ref;
+    var _root_nodes;
+    const declared = new Map(props.map((prop)=>[
+            prop.name,
+            prop
+        ]));
+    const skipped = new Set(refused);
+    const placedProps = new Map(((_ref = inventory == null ? void 0 : inventory.components) != null ? _ref : []).map((component)=>[
+            component.id,
+            component.props
+        ]));
+    const nodes = tree.nodes;
+    // The whole component: its root, and the one element a document wrapper holds.
+    const whole = new Set([
+        tree.rootId
+    ]);
+    const root = nodes[tree.rootId];
+    if ((root == null ? void 0 : root.componentId) === 'div' && ((_root_nodes = root.nodes) == null ? void 0 : _root_nodes.length) === 1) whole.add(root.nodes[0]);
+    const bound = new Set();
+    const undeclared = [];
+    const unfit = [];
+    const unoffered = [];
+    const tooLong = [];
+    const iconAsText = [];
+    const hidesWhole = [];
+    const hideForm = [];
+    const named = (id, name)=>{
+        const prop = declared.get(name);
+        if (prop) {
+            bound.add(name);
+            return prop;
+        }
+        if (!skipped.has(name)) undeclared.push({
+            id,
+            name
+        });
+        return null;
+    };
+    for (const { id, node } of walkTree({
+        rootId: tree.rootId,
+        nodes
+    })){
+        var _node_props, _placedProps_get;
+        var _node_props1, _node_props2;
+        const entry = AI_PALETTE[node.componentId];
+        for (const [field, value] of Object.entries((_node_props = node.props) != null ? _node_props : {})){
+            const placement = isAiComponentPropToken(value) ? 'whole' : 'inside';
+            for (const name of aiComponentPropNamesIn(value)){
+                const prop = named(id, name);
+                if (!prop) continue;
+                if (!aiComponentPropBindsToField(prop, entry, field, placement)) {
+                    unfit.push({
+                        id,
+                        name,
+                        at: fieldPhrase(node.componentId, field)
+                    });
+                    continue;
+                }
+                if (field === NODE_HIDE_IF_PROP || field === NODE_HIDE_UNLESS_PROP) {
+                    var _prop_label;
+                    if (whole.has(id)) hidesWhole.push({
+                        id,
+                        name
+                    });
+                    if (field === NODE_HIDE_IF_PROP && (!HIDE_LABEL.test((_prop_label = prop.label) != null ? _prop_label : '') || prop.defaultValue === true)) {
+                        hideForm.push({
+                            id,
+                            name
+                        });
+                    }
+                    continue;
+                }
+                // Copy the tree shows as words is the wrong home for an icon: the
+                // words a page types in are drawn as text, never as the icon.
+                if ((entry == null ? void 0 : entry.propRoles[field]) === 'text' && namedAsIcon(prop)) iconAsText.push({
+                    id,
+                    name
+                });
+                const values = aiComponentUnofferedAnswers(prop, entry, field);
+                if (values.length) unoffered.push({
+                    id,
+                    name,
+                    at: fieldPhrase(node.componentId, field),
+                    values
+                });
+                const limit = entry == null ? void 0 : entry.textLimits[field];
+                if (placement === 'whole' && limit !== undefined && typeof prop.defaultValue === 'string' && prop.defaultValue.length > limit) {
+                    tooLong.push({
+                        id,
+                        name,
+                        at: fieldPhrase(node.componentId, field),
+                        limit
+                    });
+                }
+            }
+        }
+        // A property handed on to a component this one places.
+        const refId = (_node_props1 = node.props) == null ? void 0 : _node_props1[AI_INSTANCE_REF_PROP];
+        const handed = (_node_props2 = node.props) == null ? void 0 : _node_props2[REUSABLE_INSTANCE_PROP_VALUES_KEY];
+        if (node.componentId !== REUSABLE_INSTANCE_COMPONENT_ID || typeof refId !== 'string' || !handed || typeof handed !== 'object' || Array.isArray(handed)) {
+            continue;
+        }
+        const types = (_placedProps_get = placedProps.get(refId)) != null ? _placedProps_get : {};
+        for (const [field, value] of Object.entries(handed)){
+            const wholeValue = isAiComponentPropToken(value);
+            for (const name of aiComponentPropNamesIn(value)){
+                var _types_field;
+                const prop = named(id, name);
+                if (prop && !handsOnTo(prop, (_types_field = types[field]) != null ? _types_field : 'text', wholeValue)) {
+                    unfit.push({
+                        id,
+                        name,
+                        at: `the placed component’s ${field}`
+                    });
+                }
+            }
+        }
+    }
+    const at = (list)=>aiModelNodeIds([
+            ...new Set(list.map((entry)=>entry.id))
+        ], tree.sourceIds);
+    const violations = [];
+    if (undeclared.length) {
+        const tokens = [
+            ...new Set(undeclared.map((entry)=>tokenOf(entry.name)))
+        ];
+        violations.push({
+            rule: 1,
+            code: 'prop-undeclared',
+            message: `The tree binds ${tokens.slice(0, 3).join(', ')}, which the component does not declare. Declare every property the tree binds.`,
+            nodeIds: at(undeclared)
+        });
+    }
+    if (unfit.length) {
+        var _declared_get;
+        const [first] = unfit;
+        violations.push({
+            rule: 1,
+            code: 'binding-field',
+            message: `${tokenOf(first.name)} is ${aKind((_declared_get = declared.get(first.name)) == null ? void 0 : _declared_get.type)} property bound to ${first.at}, which does not take one. Bind each property only to a field that holds its kind of value.`,
+            nodeIds: at(unfit)
+        });
+    }
+    const shownAsWords = iconAsText.filter((entry)=>{
+        var _ref;
+        var _declared_get;
+        return AI_COMPONENT_COPY_KINDS.has((_ref = (_declared_get = declared.get(entry.name)) == null ? void 0 : _declared_get.type) != null ? _ref : 'text');
+    });
+    if (shownAsWords.length) {
+        const one = new Set(shownAsWords.map((entry)=>entry.name)).size === 1;
+        violations.push({
+            rule: 1,
+            code: 'icon-as-text',
+            message: `${tokensAre(shownAsWords.map((entry)=>entry.name))} named as an icon and shown as words. Make ${one ? 'it an icon property' : 'each an icon property'} ("type": "icon", "defaultValue": "") bound whole to an Icon element’s iconId, for the site owner to pick.`,
+            nodeIds: at(shownAsWords)
+        });
+    }
+    if (unoffered.length) {
+        const [first] = unoffered;
+        violations.push({
+            rule: 1,
+            code: 'binding-answers',
+            message: `${tokenOf(first.name)} offers ${first.values.map((value)=>`"${value}"`).join(', ')}, which ${first.at} does not list. Give a Choice only answers whose values the field lists.`,
+            nodeIds: at(unoffered)
+        });
+    }
+    if (tooLong.length) {
+        const [first] = tooLong;
+        violations.push({
+            rule: 1,
+            code: 'prop-default-too-long',
+            message: `The default of ${tokenOf(first.name)} is longer than ${first.at} holds (${first.limit} characters). Shorten it.`,
+            nodeIds: at(tooLong)
+        });
+    }
+    if (hidesWhole.length) {
+        violations.push({
+            rule: 1,
+            code: 'hide-whole-component',
+            message: 'The whole component is hidden by one of its own properties, so a page could place it and show nothing. Put hideIf on the optional part instead.',
+            nodeIds: at(hidesWhole)
+        });
+    }
+    if (hideForm.length) {
+        const tokens = [
+            ...new Set(hideForm.map((entry)=>tokenOf(entry.name)))
+        ];
+        violations.push({
+            rule: 1,
+            code: 'hide-label',
+            message: `${tokens.join(', ')} ${tokens.length === 1 ? 'hides a part, so it is' : 'hide parts, so each is'} a Yes / no labeled "Hide …" whose default is false: the part shows until a page hides it.`,
+            nodeIds: at(hideForm)
+        });
+    }
+    const unbound = props.filter((prop)=>!bound.has(prop.name));
+    if (unbound.length) {
+        const one = unbound.length === 1;
+        // Where each unbound kind goes, once a kind, so the re-ask says what to write.
+        const kinds = [
+            ...new Set(unbound.map((prop)=>{
+                var _prop_type;
+                return (_prop_type = prop.type) != null ? _prop_type : 'text';
+            }))
+        ];
+        violations.push({
+            rule: 1,
+            code: 'prop-unbound',
+            message: `The component declares ${unbound.slice(0, 3).map((prop)=>tokenOf(prop.name)).join(', ')} and binds ${one ? 'it' : 'them'} nowhere, so a page that sets ${one ? 'it' : 'them'} changes nothing. Bind every property you declare where its kind goes: ${kinds.map((type)=>`${aKind(type)} to ${aiComponentKindBindsTo(type)}`).join('; ')}.`
+        });
+    }
+    return violations;
+}
+/**
+ * Rule 7: the properties the confirmed plan lists for the component are
+ * declared, and a field the plan lists as an icon is an icon property, so
+ * the plan and the binding checks ask for the same thing (AGL-3054).
+ */ export function aiPlannedPropViolations(plan, props) {
+    const declared = new Map(props.map((prop)=>[
+            prop.name,
+            prop
+        ]));
+    const planned = aiPlannedComponentFields(plan);
+    const violations = [];
+    const missing = planned.filter((field)=>!declared.has(field.name)).map((field)=>field.name);
+    if (missing.length) {
+        const one = missing.length === 1;
+        violations.push({
+            rule: 7,
+            code: 'plan-prop-missing',
+            message: `The confirmed plan lists the ${one ? 'property' : 'properties'} ${missing.map((name)=>`"${name}"`).join(', ')}, and the component does not declare ${one ? 'it' : 'them'}. Declare every property the plan lists.`
+        });
+    }
+    // A property refused on its reading carries no kind, and is reported there.
+    const notIcons = planned.filter((field)=>{
+        var _declared_get;
+        const type = (_declared_get = declared.get(field.name)) == null ? void 0 : _declared_get.type;
+        return field.type === 'icon' && type !== undefined && type !== 'icon';
+    });
+    if (notIcons.length) {
+        var _declared_get;
+        const [first] = notIcons;
+        violations.push({
+            rule: 7,
+            code: 'plan-prop-kind',
+            message: `The confirmed plan lists "${first.name}" as an icon, and the component declares it as ${aKind((_declared_get = declared.get(first.name)) == null ? void 0 : _declared_get.type)}. Declare it as an icon property ("type": "icon", "defaultValue": "") bound whole to an Icon element’s iconId.`
+        });
+    }
+    return violations;
+}
+/**
+ * Rule 11 on a component's own outline (AGL-3057). A page's outline check
+ * reads an instance as one node, and the site inventory carries no component
+ * tree to read in its place, so a component's h2 renders beside the h2 that
+ * opens the section placing it, and the page reads h2, h2, h2. The component
+ * is held to headings a section can hold instead: h3 or below. A component
+ * that would be a whole section, its own h2 and all, is refused the same way:
+ * that section is built on the page.
+ */ export function aiComponentHeadingViolations(tree) {
+    const nodes = tree.nodes;
+    const high = walkTree({
+        rootId: tree.rootId,
+        nodes
+    }).filter(({ node })=>{
+        const level = aiHeadingLevel(node);
+        return level !== null && level < AI_COMPONENT_TOP_HEADING_LEVEL;
+    }).map((visit)=>visit.id);
+    if (!high.length) return [];
+    return [
+        {
+            rule: 11,
+            code: 'component-heading-level',
+            message: `A component sits inside a page section that opens with its own h2, so its headings start at h${AI_COMPONENT_TOP_HEADING_LEVEL}. Set each heading’s Typography "component" to "h${AI_COMPONENT_TOP_HEADING_LEVEL}" or lower.`,
+            nodeIds: aiModelNodeIds(high, tree.sourceIds)
+        }
+    ];
+}
+/** Rule 14 on the copy a component shows until a page sets it. */ export function aiComponentDefaultCopyViolations(props) {
+    return detectOffVoiceCopy(props.flatMap((prop, index)=>(prop.type === 'text' || prop.type === 'richText') && typeof prop.defaultValue === 'string' ? [
+            {
+                at: `props[${index}].defaultValue`,
+                text: prop.defaultValue
+            }
+        ] : []));
+}
+/**
+ * Every check the component door adds to the doctrine's, on a tree it
+ * admitted and the answer the tree came in. `onProps` receives the properties
+ * that answer declared, so the step keeps the declaration of the answer the
+ * loop keeps — the last one it checked.
+ */ export function aiComponentCheck(input) {
+    var _ref;
+    var _input_inventory;
+    const screenIds = new Set(((_ref = (_input_inventory = input.inventory) == null ? void 0 : _input_inventory.screens) != null ? _ref : []).map((screen)=>screen.id));
+    return (tree, answer)=>{
+        const reading = readAiComponentProps(answer, {
+            screenIds
+        });
+        input.onProps(reading.props);
+        return [
+            ...reading.violations,
+            ...aiComponentBindingViolations(tree, reading.props, input.inventory, reading.refused),
+            ...aiComponentHeadingViolations(tree),
+            ...aiComponentDefaultCopyViolations(reading.props),
+            ...aiPlanReuseViolations(input.inventory, input.plan, aiPlacedComponentIds(tree), 'component'),
+            ...aiPlannedPropViolations(input.plan, [
+                ...reading.props,
+                ...reading.refused.map((name)=>({
+                        name
+                    }))
+            ])
+        ];
+    };
+}
+
+//# sourceMappingURL=ai-job-component-checks.js.map

package/src/lib/jobs/ai-job-component-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-component-checks.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 {\n  COMPONENT_PROP_NAME_PATTERN,\n  NODE_HIDE_IF_PROP,\n  NODE_HIDE_UNLESS_PROP,\n  REUSABLE_INSTANCE_COMPONENT_ID,\n  REUSABLE_INSTANCE_PROP_VALUES_KEY,\n} from '@aglyn/aglyn/app-utils/reusable-component-keys'\nimport type {\n  ReusableComponentProp,\n  ReusableComponentPropType,\n} from '@aglyn/aglyn/foundation/definitions/platform.types'\nimport {\n  REUSABLE_PROP_KINDS,\n  reusablePropValueShape,\n} from '@aglyn/aglyn/foundation/definitions/property-kinds'\nimport type { AiJobPlan } from '../model/ai-jobs.types'\nimport type { AiSiteInventory } from '../model/ai-site-inventory'\nimport {\n  AI_COMPONENT_COPY_KINDS,\n  aiComponentKindBindsTo,\n  aiComponentPropBindsToField,\n  aiComponentPropNamesIn,\n  aiComponentUnofferedAnswers,\n  isAiComponentPropToken,\n} from '../runtime/ai-component-bindings'\nimport type { AiValidatedTree } from '../runtime/ai-doctrine'\nimport {\n  aiHeadingLevel,\n  detectOffVoiceCopy,\n  walkTree,\n  type AiDoctrineNode,\n  type AiDoctrineViolation,\n} from '../runtime/ai-doctrine-validators'\nimport { AI_INSTANCE_REF_PROP } from '../runtime/ai-node-tree'\nimport { AI_PALETTE } from '../runtime/ai-palette.generated'\nimport { readAiComponentProps } from '../tools/ai-component-tool'\nimport {\n  aiModelNodeIds,\n  aiPlacedComponentIds,\n  aiPlanCreation,\n  aiPlanReuseViolations,\n} from './ai-job-generation'\n\n/**\n * The component door's own checks (AGL-2908): what a generated reusable\n * component is held to beyond the doctrine, on a tree the doctrine admitted\n * and the properties the same answer declared.\n *\n * - every token names a property the component declares, and every declared\n *   property is bound, so no field a page sets changes nothing;\n * - a property binds only to a field that holds its kind of value\n *   (`runtime/ai-component-bindings.ts`): a switch takes a Yes / no, a\n *   dropdown a Choice whose answers it lists, a screen picker a Link\n *   (AGL-2871), an icon picker an Icon;\n * - an icon is an Icon the site owner picks, never words (AGL-3054): a copy\n *   property named or labeled as an icon, shown as copy, is refused;\n * - its headings start at h3 (AGL-3057): a component is placed inside a page\n *   section, which opens with its own h2, and a page's outline check sees an\n *   instance as one node, never the headings it grafts in;\n * - an optional part is switched off by a Yes / no labeled `Hide …` that\n *   defaults to No, bound to `hideIf` on that part and never on the whole\n *   component;\n * - a default is what the component shows until a page sets it, in the\n *   site's voice (rule 14), and fits the field it fills;\n * - what the confirmed plan names is there: the components it reuses, and\n *   the properties it lists for this component, an icon as an icon (rule 7).\n *\n * Pure: no Firestore and no provider, so the component step, the eval\n * harness and their specs read one definition of a component's checks.\n */\n\n/** The label a Yes / no that hides a part opens with, so a page reads what it does. */\nconst HIDE_LABEL = /^Hide\\b/\n\n/** The kinds of a placed component's property that copy fills as text. */\nconst COPY_FIELD_KINDS: ReadonlySet<string> = new Set(['text', 'richText'])\n\n/**\n * The highest heading a component may carry (AGL-3057): a page section opens\n * with its own h2, and whatever the section places sits under it.\n */\nexport const AI_COMPONENT_TOP_HEADING_LEVEL = 3\n\n/** A word naming an icon, in a label or in a name split at its capitals and underscores. */\nconst ICON_WORD = /\\bicons?\\b/i\n\n/** One `name:type` field of the confirmed plan's component; `type` is empty when the field names none. */\nexport interface AiPlannedComponentField {\n  name: string\n  type: string\n}\n\n/** The fields the confirmed plan lists for its component, read from `name:type`, each name once. */\nexport function aiPlannedComponentFields(plan: AiJobPlan | null): AiPlannedComponentField[] {\n  const fields = new Map<string, AiPlannedComponentField>()\n  for (const field of aiPlanCreation(plan, 'component')?.fields ?? []) {\n    const [name = '', type = ''] = field.split(':').map((part) => part.trim())\n    if (COMPONENT_PROP_NAME_PATTERN.test(name) && !fields.has(name)) fields.set(name, { name, type })\n  }\n  return [...fields.values()]\n}\n\n/** The property names the confirmed plan lists for its component, from its `name:type` fields. */\nexport function aiPlannedComponentProps(plan: AiJobPlan | null): string[] {\n  return aiPlannedComponentFields(plan).map((field) => field.name)\n}\n\ninterface BindingFinding {\n  id: string\n  name: string\n}\n\n/** A property's kind as a sentence names one: \"an Image\", \"a Yes / no\". */\nfunction aKind(type: string | undefined): string {\n  const label =\n    REUSABLE_PROP_KINDS[(type ?? 'text') as ReusableComponentPropType]?.label ??\n    REUSABLE_PROP_KINDS.text.label\n  return `${/^[AEIOU]/i.test(label) ? 'an' : 'a'} ${label}`\n}\n\nfunction fieldPhrase(componentId: string, field: string): string {\n  return `the ${AI_PALETTE[componentId]?.displayName ?? componentId}’s ${field}`\n}\n\nconst tokenOf = (name: string): string => `{{prop.${name}}}`\n\n/** Whether a property's name or label says it is an icon. */\nfunction namedAsIcon(prop: Pick<ReusableComponentProp, 'name' | 'label'>): boolean {\n  const words = prop.name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/_/g, ' ')\n  return ICON_WORD.test(words) || ICON_WORD.test(prop.label ?? '')\n}\n\n/** \"{{prop.a}} is\" or \"{{prop.a}}, {{prop.b}} are\", for a finding that names its properties. */\nfunction tokensAre(names: readonly string[]): string {\n  const tokens = [...new Set(names)].map(tokenOf)\n  return `${tokens.slice(0, 3).join(', ')} ${tokens.length === 1 ? 'is' : 'are'}`\n}\n\n/**\n * Whether a property handed on to a placed component fits the property it\n * fills there: copy into copy, whole or inside a sentence; a picture or a\n * link only into its own kind, whole; any other kind into one whose value has\n * its shape.\n */\nfunction handsOnTo(prop: ReusableComponentProp, placedType: string, whole: boolean): boolean {\n  const type = prop.type ?? 'text'\n  if (AI_COMPONENT_COPY_KINDS.has(type) && COPY_FIELD_KINDS.has(placedType)) return true\n  if (!whole) return false\n  if ([type, placedType].some((kind) => kind === 'image' || kind === 'href')) return type === placedType\n  return (\n    reusablePropValueShape(prop) ===\n    reusablePropValueShape({ type: placedType as ReusableComponentPropType })\n  )\n}\n\n/**\n * The component door's check of its bindings, on a tree the doctrine admitted\n * and the properties the same answer declared: every token names a declared\n * property on a field of its kind, every property is bound, an icon is never\n * shown as words, a part is hidden by a `Hide …` Yes / no that defaults to No,\n * and a default fits the field it fills. `refused` names properties the answer\n * declared and the reading refused, which are reported there and not again\n * here.\n */\nexport function aiComponentBindingViolations(\n  tree: Pick<AiValidatedTree, 'rootId' | 'nodes' | 'sourceIds'>,\n  props: readonly ReusableComponentProp[],\n  inventory: AiSiteInventory | null,\n  refused: readonly string[] = [],\n): AiDoctrineViolation[] {\n  const declared = new Map(props.map((prop) => [prop.name, prop]))\n  const skipped = new Set(refused)\n  const placedProps = new Map(\n    (inventory?.components ?? []).map((component) => [component.id, component.props]),\n  )\n  const nodes = tree.nodes as unknown as Record<string, AiDoctrineNode>\n  // The whole component: its root, and the one element a document wrapper holds.\n  const whole = new Set([tree.rootId])\n  const root = nodes[tree.rootId]\n  if (root?.componentId === 'div' && root.nodes?.length === 1) whole.add(root.nodes[0])\n\n  const bound = new Set<string>()\n  const undeclared: BindingFinding[] = []\n  const unfit: Array<BindingFinding & { at: string }> = []\n  const unoffered: Array<BindingFinding & { at: string; values: string[] }> = []\n  const tooLong: Array<BindingFinding & { at: string; limit: number }> = []\n  const iconAsText: BindingFinding[] = []\n  const hidesWhole: BindingFinding[] = []\n  const hideForm: BindingFinding[] = []\n  const named = (id: string, name: string): ReusableComponentProp | null => {\n    const prop = declared.get(name)\n    if (prop) {\n      bound.add(name)\n      return prop\n    }\n    if (!skipped.has(name)) undeclared.push({ id, name })\n    return null\n  }\n\n  for (const { id, node } of walkTree({ rootId: tree.rootId, nodes })) {\n    const entry = AI_PALETTE[node.componentId]\n    for (const [field, value] of Object.entries(node.props ?? {})) {\n      const placement = isAiComponentPropToken(value) ? 'whole' : 'inside'\n      for (const name of aiComponentPropNamesIn(value)) {\n        const prop = named(id, name)\n        if (!prop) continue\n        if (!aiComponentPropBindsToField(prop, entry, field, placement)) {\n          unfit.push({ id, name, at: fieldPhrase(node.componentId, field) })\n          continue\n        }\n        if (field === NODE_HIDE_IF_PROP || field === NODE_HIDE_UNLESS_PROP) {\n          if (whole.has(id)) hidesWhole.push({ id, name })\n          if (\n            field === NODE_HIDE_IF_PROP &&\n            (!HIDE_LABEL.test(prop.label ?? '') || prop.defaultValue === true)\n          ) {\n            hideForm.push({ id, name })\n          }\n          continue\n        }\n        // Copy the tree shows as words is the wrong home for an icon: the\n        // words a page types in are drawn as text, never as the icon.\n        if (entry?.propRoles[field] === 'text' && namedAsIcon(prop)) iconAsText.push({ id, name })\n        const values = aiComponentUnofferedAnswers(prop, entry, field)\n        if (values.length) unoffered.push({ id, name, at: fieldPhrase(node.componentId, field), values })\n        const limit = entry?.textLimits[field]\n        if (\n          placement === 'whole' &&\n          limit !== undefined &&\n          typeof prop.defaultValue === 'string' &&\n          prop.defaultValue.length > limit\n        ) {\n          tooLong.push({ id, name, at: fieldPhrase(node.componentId, field), limit })\n        }\n      }\n    }\n    // A property handed on to a component this one places.\n    const refId = node.props?.[AI_INSTANCE_REF_PROP]\n    const handed = node.props?.[REUSABLE_INSTANCE_PROP_VALUES_KEY]\n    if (\n      node.componentId !== REUSABLE_INSTANCE_COMPONENT_ID ||\n      typeof refId !== 'string' ||\n      !handed ||\n      typeof handed !== 'object' ||\n      Array.isArray(handed)\n    ) {\n      continue\n    }\n    const types = placedProps.get(refId) ?? {}\n    for (const [field, value] of Object.entries(handed as Record<string, unknown>)) {\n      const wholeValue = isAiComponentPropToken(value)\n      for (const name of aiComponentPropNamesIn(value)) {\n        const prop = named(id, name)\n        if (prop && !handsOnTo(prop, types[field] ?? 'text', wholeValue)) {\n          unfit.push({ id, name, at: `the placed component’s ${field}` })\n        }\n      }\n    }\n  }\n\n  const at = (list: ReadonlyArray<{ id: string }>): string[] =>\n    aiModelNodeIds([...new Set(list.map((entry) => entry.id))], tree.sourceIds)\n  const violations: AiDoctrineViolation[] = []\n  if (undeclared.length) {\n    const tokens = [...new Set(undeclared.map((entry) => tokenOf(entry.name)))]\n    violations.push({\n      rule: 1,\n      code: 'prop-undeclared',\n      message: `The tree binds ${tokens.slice(0, 3).join(', ')}, which the component does not declare. Declare every property the tree binds.`,\n      nodeIds: at(undeclared),\n    })\n  }\n  if (unfit.length) {\n    const [first] = unfit\n    violations.push({\n      rule: 1,\n      code: 'binding-field',\n      message: `${tokenOf(first.name)} is ${aKind(declared.get(first.name)?.type)} property bound to ${first.at}, which does not take one. Bind each property only to a field that holds its kind of value.`,\n      nodeIds: at(unfit),\n    })\n  }\n  const shownAsWords = iconAsText.filter((entry) => AI_COMPONENT_COPY_KINDS.has(declared.get(entry.name)?.type ?? 'text'))\n  if (shownAsWords.length) {\n    const one = new Set(shownAsWords.map((entry) => entry.name)).size === 1\n    violations.push({\n      rule: 1,\n      code: 'icon-as-text',\n      message: `${tokensAre(shownAsWords.map((entry) => entry.name))} named as an icon and shown as words. Make ${\n        one ? 'it an icon property' : 'each an icon property'\n      } (\"type\": \"icon\", \"defaultValue\": \"\") bound whole to an Icon element’s iconId, for the site owner to pick.`,\n      nodeIds: at(shownAsWords),\n    })\n  }\n  if (unoffered.length) {\n    const [first] = unoffered\n    violations.push({\n      rule: 1,\n      code: 'binding-answers',\n      message: `${tokenOf(first.name)} offers ${first.values.map((value) => `\"${value}\"`).join(', ')}, which ${first.at} does not list. Give a Choice only answers whose values the field lists.`,\n      nodeIds: at(unoffered),\n    })\n  }\n  if (tooLong.length) {\n    const [first] = tooLong\n    violations.push({\n      rule: 1,\n      code: 'prop-default-too-long',\n      message: `The default of ${tokenOf(first.name)} is longer than ${first.at} holds (${first.limit} characters). Shorten it.`,\n      nodeIds: at(tooLong),\n    })\n  }\n  if (hidesWhole.length) {\n    violations.push({\n      rule: 1,\n      code: 'hide-whole-component',\n      message:\n        'The whole component is hidden by one of its own properties, so a page could place it and show nothing. Put hideIf on the optional part instead.',\n      nodeIds: at(hidesWhole),\n    })\n  }\n  if (hideForm.length) {\n    const tokens = [...new Set(hideForm.map((entry) => tokenOf(entry.name)))]\n    violations.push({\n      rule: 1,\n      code: 'hide-label',\n      message: `${tokens.join(', ')} ${tokens.length === 1 ? 'hides a part, so it is' : 'hide parts, so each is'} a Yes / no labeled \"Hide …\" whose default is false: the part shows until a page hides it.`,\n      nodeIds: at(hideForm),\n    })\n  }\n  const unbound = props.filter((prop) => !bound.has(prop.name))\n  if (unbound.length) {\n    const one = unbound.length === 1\n    // Where each unbound kind goes, once a kind, so the re-ask says what to write.\n    const kinds = [...new Set(unbound.map((prop) => prop.type ?? 'text'))]\n    violations.push({\n      rule: 1,\n      code: 'prop-unbound',\n      message: `The component declares ${unbound\n        .slice(0, 3)\n        .map((prop) => tokenOf(prop.name))\n        .join(', ')} and binds ${one ? 'it' : 'them'} nowhere, so a page that sets ${one ? 'it' : 'them'} changes nothing. Bind every property you declare where its kind goes: ${kinds\n        .map((type) => `${aKind(type)} to ${aiComponentKindBindsTo(type)}`)\n        .join('; ')}.`,\n    })\n  }\n  return violations\n}\n\n/**\n * Rule 7: the properties the confirmed plan lists for the component are\n * declared, and a field the plan lists as an icon is an icon property, so\n * the plan and the binding checks ask for the same thing (AGL-3054).\n */\nexport function aiPlannedPropViolations(\n  plan: AiJobPlan | null,\n  props: readonly Pick<ReusableComponentProp, 'name' | 'type'>[],\n): AiDoctrineViolation[] {\n  const declared = new Map(props.map((prop) => [prop.name, prop]))\n  const planned = aiPlannedComponentFields(plan)\n  const violations: AiDoctrineViolation[] = []\n  const missing = planned.filter((field) => !declared.has(field.name)).map((field) => field.name)\n  if (missing.length) {\n    const one = missing.length === 1\n    violations.push({\n      rule: 7,\n      code: 'plan-prop-missing',\n      message: `The confirmed plan lists the ${one ? 'property' : 'properties'} ${missing\n        .map((name) => `\"${name}\"`)\n        .join(', ')}, and the component does not declare ${one ? 'it' : 'them'}. Declare every property the plan lists.`,\n    })\n  }\n  // A property refused on its reading carries no kind, and is reported there.\n  const notIcons = planned.filter((field) => {\n    const type = declared.get(field.name)?.type\n    return field.type === 'icon' && type !== undefined && type !== 'icon'\n  })\n  if (notIcons.length) {\n    const [first] = notIcons\n    violations.push({\n      rule: 7,\n      code: 'plan-prop-kind',\n      message: `The confirmed plan lists \"${first.name}\" as an icon, and the component declares it as ${aKind(\n        declared.get(first.name)?.type,\n      )}. Declare it as an icon property (\"type\": \"icon\", \"defaultValue\": \"\") bound whole to an Icon element’s iconId.`,\n    })\n  }\n  return violations\n}\n\n/**\n * Rule 11 on a component's own outline (AGL-3057). A page's outline check\n * reads an instance as one node, and the site inventory carries no component\n * tree to read in its place, so a component's h2 renders beside the h2 that\n * opens the section placing it, and the page reads h2, h2, h2. The component\n * is held to headings a section can hold instead: h3 or below. A component\n * that would be a whole section, its own h2 and all, is refused the same way:\n * that section is built on the page.\n */\nexport function aiComponentHeadingViolations(\n  tree: Pick<AiValidatedTree, 'rootId' | 'nodes' | 'sourceIds'>,\n): AiDoctrineViolation[] {\n  const nodes = tree.nodes as unknown as Record<string, AiDoctrineNode>\n  const high = walkTree({ rootId: tree.rootId, nodes })\n    .filter(({ node }) => {\n      const level = aiHeadingLevel(node)\n      return level !== null && level < AI_COMPONENT_TOP_HEADING_LEVEL\n    })\n    .map((visit) => visit.id)\n  if (!high.length) return []\n  return [\n    {\n      rule: 11,\n      code: 'component-heading-level',\n      message: `A component sits inside a page section that opens with its own h2, so its headings start at h${AI_COMPONENT_TOP_HEADING_LEVEL}. Set each heading’s Typography \"component\" to \"h${AI_COMPONENT_TOP_HEADING_LEVEL}\" or lower.`,\n      nodeIds: aiModelNodeIds(high, tree.sourceIds),\n    },\n  ]\n}\n\n/** Rule 14 on the copy a component shows until a page sets it. */\nexport function aiComponentDefaultCopyViolations(props: readonly ReusableComponentProp[]): AiDoctrineViolation[] {\n  return detectOffVoiceCopy(\n    props.flatMap((prop, index) =>\n      (prop.type === 'text' || prop.type === 'richText') && typeof prop.defaultValue === 'string'\n        ? [{ at: `props[${index}].defaultValue`, text: prop.defaultValue }]\n        : [],\n    ),\n  )\n}\n\n/**\n * Every check the component door adds to the doctrine's, on a tree it\n * admitted and the answer the tree came in. `onProps` receives the properties\n * that answer declared, so the step keeps the declaration of the answer the\n * loop keeps — the last one it checked.\n */\nexport function aiComponentCheck(input: {\n  inventory: AiSiteInventory | null\n  plan: AiJobPlan | null\n  onProps: (props: ReusableComponentProp[]) => void\n}): (tree: AiValidatedTree, answer: Record<string, unknown>) => AiDoctrineViolation[] {\n  const screenIds = new Set((input.inventory?.screens ?? []).map((screen) => screen.id))\n  return (tree, answer) => {\n    const reading = readAiComponentProps(answer, { screenIds })\n    input.onProps(reading.props)\n    return [\n      ...reading.violations,\n      ...aiComponentBindingViolations(tree, reading.props, input.inventory, reading.refused),\n      ...aiComponentHeadingViolations(tree),\n      ...aiComponentDefaultCopyViolations(reading.props),\n      ...aiPlanReuseViolations(input.inventory, input.plan, aiPlacedComponentIds(tree), 'component'),\n      ...aiPlannedPropViolations(input.plan, [\n        ...reading.props,\n        ...reading.refused.map((name) => ({ name })),\n      ]),\n    ]\n  }\n}\n"],"names":["COMPONENT_PROP_NAME_PATTERN","NODE_HIDE_IF_PROP","NODE_HIDE_UNLESS_PROP","REUSABLE_INSTANCE_COMPONENT_ID","REUSABLE_INSTANCE_PROP_VALUES_KEY","REUSABLE_PROP_KINDS","reusablePropValueShape","AI_COMPONENT_COPY_KINDS","aiComponentKindBindsTo","aiComponentPropBindsToField","aiComponentPropNamesIn","aiComponentUnofferedAnswers","isAiComponentPropToken","aiHeadingLevel","detectOffVoiceCopy","walkTree","AI_INSTANCE_REF_PROP","AI_PALETTE","readAiComponentProps","aiModelNodeIds","aiPlacedComponentIds","aiPlanCreation","aiPlanReuseViolations","HIDE_LABEL","COPY_FIELD_KINDS","Set","AI_COMPONENT_TOP_HEADING_LEVEL","ICON_WORD","aiPlannedComponentFields","plan","fields","Map","field","name","type","split","map","part","trim","test","has","set","values","aiPlannedComponentProps","aKind","label","text","fieldPhrase","componentId","displayName","tokenOf","namedAsIcon","prop","words","replace","tokensAre","names","tokens","slice","join","length","handsOnTo","placedType","whole","some","kind","aiComponentBindingViolations","tree","props","inventory","refused","root","declared","skipped","placedProps","components","component","id","nodes","rootId","add","bound","undeclared","unfit","unoffered","tooLong","iconAsText","hidesWhole","hideForm","named","get","push","node","entry","value","Object","entries","placement","at","defaultValue","propRoles","limit","textLimits","undefined","refId","handed","Array","isArray","types","wholeValue","list","sourceIds","violations","rule","code","message","nodeIds","first","shownAsWords","filter","one","size","unbound","kinds","aiPlannedPropViolations","planned","missing","notIcons","aiComponentHeadingViolations","high","level","visit","aiComponentDefaultCopyViolations","flatMap","index","aiComponentCheck","input","screenIds","screens","screen","answer","reading","onProps"],"mappings":"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"}

package/src/lib/jobs/ai-job-component-step.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @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 { duplicateResource } from '@aglyn/tenant-data-admin/server/duplicate-resource';
+import type { AiJob, AiJobPlan } from '../model/ai-jobs.types';
+import type { AiSystemBlock } from '../runtime/ai-runtime';
+import { readSiteInventory } from '../runtime/site-inventory';
+import { type AiJobAdmission } from './ai-job-admission';
+import type { AiJobStepRunner } from './ai-job-text-step';
+/**
+ * The component step (AGL-2908): the generation step of a `component` job,
+ * run once a member confirmed the job's plan.
+ *
+ * It builds ONE reusable component from the brief — its tree, and the typed
+ * properties each page that places it fills in — through
+ * `runValidatedGeneration('component', …)`, so every building rule holds on
+ * the tree before it is kept. The tree binds each property with
+ * `{{prop.<name>}}`; the palette validator keeps those tokens as written
+ * (`definesComponent`), and the step's own check, through `extend`, holds
+ * each binding to what the Properties dialog and the Attributes panel allow
+ * (`ai-job-component-checks.ts`).
+ *
+ * The component lands as a new draft (`ai-job-drafts.ts`) that no page
+ * places, and gets its first version when a member opens it, as every
+ * component created outside the besigner does. A plan that starts from a copy
+ * of a component the site has gets that copy, through the platform's
+ * duplicate module, and nothing generated.
+ *
+ * A generation step runs on the job beat, never at an inline door: it
+ * registers the least time its lookup rounds, its answer and its re-ask need
+ * (AGL-3035), runs without extended thinking, and asks for no more of the
+ * ceiling the layout and template steps keep than fits that time on the model
+ * it runs. The step's spec measures the request and the answer against it.
+ */
+/** The longest answer a component may run to; the tree is held to the component budget either way. */
+export declare const AI_JOB_COMPONENT_MAX_TOKENS: number;
+/**
+ * The component step's time (AGL-3035, AGL-3036): its two inventory-lookup
+ * rounds, its answer and its re-ask at the routing table's ceiling on the tier
+ * `job.component` is served from, fitted to what a beat can give a step.
+ */
+export declare const AI_JOB_COMPONENT_STEP_BUDGET: import("./ai-job-budget").AiJobStepBudget;
+/** The least time one component step needs before it starts. */
+export declare const AI_JOB_COMPONENT_STEP_MINIMUM_MS: number;
+/** A component's name when the plan names none. */
+export declare const AI_JOB_COMPONENT_DEFAULT_NAME = "Component";
+/** The component step's own instructions, cached after the doctrine and before the catalog. */
+export declare const AI_JOB_COMPONENT_INSTRUCTIONS: readonly AiSystemBlock[];
+/** The component job as the generation's user turn: the name, the brief, the confirmed plan. */
+export declare function aiJobComponentPrompt(job: Pick<AiJob, 'brief'>, plan: AiJobPlan | null, name: string): string;
+/** A component job is admitted for a site of the job's own org whose plan includes reusable components. */
+export declare const aiComponentJobAdmission: AiJobAdmission;
+export interface AiJobComponentStepDeps {
+    /** The inventory reader; specs hand in a fake. */
+    readInventory?: typeof readSiteInventory;
+    /** The platform's duplicate module, for a plan that starts from a copy. */
+    duplicate?: typeof duplicateResource;
+}
+export declare function createAiJobComponentStep(deps?: AiJobComponentStepDeps): AiJobStepRunner;
+export declare const runAiJobComponentStep: AiJobStepRunner;
+/** Registers the component step and the check a component job passes before it is created or resumed. */
+export declare function registerAiComponentJob(): void;