@vectoriox/iox-ui 5.55.0 → 5.56.1

package/fesm2022/vectoriox-iox-ui-generation-core.mjs

@@ -1,6 +1,7 @@
-import { NEW_NODE_STYLE_DEFAULTS, defaultElementStyleFor, elementStyleById, ownedTraitsOf, applyElementStyle, flavorPackById, parseHexColor, SPEC_AXES, LinkType, COLOR_SCHEMES, setColorScheme, resolveDesignChoices } from '@vectoriox/iox-ui/design-core';
-import { formPresetById } from '@vectoriox/iox-ui/forms-core';
+import { NEW_NODE_STYLE_DEFAULTS, defaultElementStyleFor, elementStyleById, ownedTraitsOf, applyElementStyle, flavorPackById, parseHexColor, SPEC_AXES, LinkType, COLOR_SCHEMES, setColorScheme, resolveDesignChoices, auditDesignContrast } from '@vectoriox/iox-ui/design-core';
+import { formPresetById, ControlType, FORM_NODE_TYPE, collectFormSpec, FIELD_NODE_TYPE } from '@vectoriox/iox-ui/forms-core';
 import { segmentedOptions, ITEM_OPEN_STATE, CardRole, CardLayout, CARD_LAYOUTS, CARD_PARTS, BADGE_TONES, buildCardRecipe, findByRole, buildSegmentedRecipe, AccordionRole, buildAccordionRecipe, ACCORDION_WORDS, accordionItems, accordionQuestionOf, accordionAnswerOf, ACCORDION_BIND_PROP, pickAccordionAutoBinds, ACCORDION_CONTENT_LIMIT, buildTabsRecipe, TABS_WORDS, tabsTriggers, tabLabelNodeOf, TABS_LABEL_BIND_PROP, tabsPanels, tabPanelTextOf, TABS_TEXT_BIND_PROP, tabPanelImageOf, pickTabsAutoBinds, tabsListOf, tabsPanelsOf, TABS_CONTENT_LIMIT, TABS_IMAGE_BIND_PROP, buildCarouselRecipe, SLIDE_TYPE, buildLightboxRecipe, LIGHTBOX_LABEL, SLIDE_TO_ROW } from '@vectoriox/iox-ui/composite-core';
+import { ELEMENT_ACTION_DESCRIPTORS, resolveActionAvailability } from '@vectoriox/iox-ui/actions-core';
 
 // GENERATED from iox-ai-guidance flavor-spec.v1.json — do not edit; re-run scripts/gen-flavor-spec.mjs
 // (npm run gen:flavor-spec). The JSON is itself generated by iox-ai-guidance
@@ -8927,7 +8928,7 @@ function stableHash(text) {
     return h.toString(36).padStart(7, '0').slice(-6);
 }
 const create = (id, type, props = {}, elementStyle) => createSerializedNode(id, type, props, elementStyle, COMPOSED);
-function nonEmpty(v) {
+function nonEmpty$1(v) {
     return typeof v === 'string' && v.trim() !== '';
 }
 /** A pattern's own words with the compose-time variables filled: `{year}`, `{business.name}`. */
@@ -8939,16 +8940,16 @@ function fillVariables(text, ctx) {
 function chooseText(pn, ctx) {
     const fact = pn.ph && FACT_KEYS.includes(pn.ph) ? pn.ph : null;
     const slotValue = pn.slot ? ctx.section?.slots?.[pn.slot] : undefined;
-    if (nonEmpty(slotValue))
+    if (nonEmpty$1(slotValue))
         return { value: slotValue };
     if (pn.fromBusiness) {
         const v = ctx.plan.business[pn.fromBusiness];
-        if (nonEmpty(v))
+        if (nonEmpty$1(v))
             return { value: v };
     }
     if (fact) {
         const given = ctx.plan.business.facts?.[fact];
-        return nonEmpty(given) ? { value: given } : { value: SITE_FACT_LABELS[fact], placeholder: { kind: PlaceholderKind.Fact, fact } };
+        return nonEmpty$1(given) ? { value: given } : { value: SITE_FACT_LABELS[fact], placeholder: { kind: PlaceholderKind.Fact, fact } };
     }
     const own = pn.text === undefined ? undefined : fillVariables(pn.text, ctx);
     if (pn.ph === PatternPlaceholder.Copy)
@@ -9656,7 +9657,7 @@ function composeSite(plan, context) {
     const issues = [];
     const routes = new Set(plan.pages.map(p => p.route));
     const relatives = new Map(plan.dataSources.map(d => [d.alias, d.type === PlanDataSourceType.Relative ? { type: d.type, of: d.of, op: d.op } : { type: d.type }]));
-    const email = nonEmpty(plan.business.facts?.email) ? plan.business.facts.email.trim() : null;
+    const email = nonEmpty$1(plan.business.facts?.email) ? plan.business.facts.email.trim() : null;
     const base = { plan, placeholders, issues, routes, year: context.year, email, navPage: null };
     const pages = plan.pages.map(page => {
         const nextAlias = page.routeSource ? nextSourceOf(relatives, page.routeSource) : null;
@@ -9730,14 +9731,14 @@ function navPagePlans(pages) {
  * no /contact page: an email to the business, else removed), and the pattern's phone shape. Pure.
  */
 function composeNavHeader(input, options) {
-    if (!nonEmpty(options?.id))
+    if (!nonEmpty$1(options?.id))
         throw new ComposeError('composeNavHeader needs the header id');
     const pattern = patternById(SITE_HEADER_PATTERN);
     const all = navPagePlans(input.pages);
     const navRoutes = new Set(siteNavPages(input.pages).map(p => p.route));
     const pages = all.map(p => ({ ...p, inNav: navRoutes.has(p.route) }));
     const plan = { business: input.business, pages, dataSources: [], contentTypes: [] };
-    const email = nonEmpty(input.business.facts?.email) ? input.business.facts.email.trim() : null;
+    const email = nonEmpty$1(input.business.facts?.email) ? input.business.facts.email.trim() : null;
     const issues = [];
     const ctx = {
         owner: GlobalSlot.Header, page: null, section: null, plan, year: 0, email, navPage: null, nextAlias: null,
@@ -9761,7 +9762,7 @@ const PRICING_PATTERN = 'pricing.tiers';
  * words, unlinked, for the author to link. Pure.
  */
 function composeSection(patternId, input, options) {
-    if (!nonEmpty(options?.id))
+    if (!nonEmpty$1(options?.id))
         throw new ComposeError('composeSection needs the section id');
     const pattern = patternById(patternId);
     if (!pattern)
@@ -9771,7 +9772,7 @@ function composeSection(patternId, input, options) {
     const business = input.business ?? { name: '' };
     const pages = navPagePlans(input.pages ?? []);
     const plan = { business, pages, dataSources: [], contentTypes: [] };
-    const email = nonEmpty(business.facts?.email) ? business.facts.email.trim() : null;
+    const email = nonEmpty$1(business.facts?.email) ? business.facts.email.trim() : null;
     const placeholders = [];
     const issues = [];
     const ctx = {
@@ -9935,6 +9936,8 @@ var BuildStep;
     BuildStep["Preflight"] = "preflight";
     BuildStep["ContentTypes"] = "content-types";
     BuildStep["SampleImages"] = "sample-images";
+    /** I2: the curated stock photos the plan's empty picture slots take, copied into the studio (never hot-linked). */
+    BuildStep["StockPhotos"] = "stock-photos";
     BuildStep["Items"] = "items";
     BuildStep["DataSources"] = "data-sources";
     BuildStep["Pages"] = "pages";
@@ -9956,6 +9959,8 @@ var CreatedKind;
     /** Fields the build added to a content type it found (types are shared by every organization of a studio). */
     CreatedKind["ContentTypeFields"] = "content-type-fields";
     CreatedKind["SampleImage"] = "sample-image";
+    /** A stock photo copied into the studio's storage (`media/stock/…`), with its assets row. */
+    CreatedKind["StockPhoto"] = "stock-photo";
     CreatedKind["Item"] = "item";
     CreatedKind["DataSource"] = "data-source";
     CreatedKind["Page"] = "page";
@@ -9977,6 +9982,8 @@ var BuildNoticeCode;
     BuildNoticeCode["NoStorage"] = "no-storage";
     /** A content type the build reuses is not public in this studio: the site will not show its items. */
     BuildNoticeCode["ContentTypeNotPublic"] = "content-type-not-public";
+    /** The stock library could not be read: the picture slots keep the empty box, and the run says so. */
+    BuildNoticeCode["StockUnavailable"] = "stock-unavailable";
 })(BuildNoticeCode || (BuildNoticeCode = {}));
 var PreflightRefusalCode;
 (function (PreflightRefusalCode) {
@@ -10008,6 +10015,7 @@ const buildKeys = {
     contentTypeFields: (name) => `schema-fields:${name}`,
     item: (contentType, n) => `item:${contentType}:${n}`,
     sampleImage: (n) => `sample-image:${n}`,
+    stockPhoto: (libraryKey) => `stock-photo:${libraryKey}`,
     dataSource: (alias) => `data-source:${alias}`,
     page: (key) => `page:${key}`,
     global: (nodeId) => `global:${nodeId}`,
@@ -10927,6 +10935,417 @@ function planWordIssues(plan, ctx) {
     return issues;
 }
 
+/**
+ * THE Publishable gate (AI plan §3e, M1-7): ONE pure function over a snapshot of a site — its pages, globals, the
+ * connectors' health, the look's token rows, what a build left to fill — run by the Publish dialog, the builder's
+ * Needs attention and the server on publish (iox-cms refuses with the same findings). Works on any site, generated
+ * or hand-built. Severity is decision D8: an unfilled fact, a policy placeholder or an action that points at nothing
+ * BLOCKS; samples, copy placeholders and stock photos ASK ("Publish anyway"); the rest WARN. Design advice
+ * (harness-core `lintDesign`) is not one of the eight — the caller adds it, and it never blocks.
+ */
+var SiteCheckId;
+(function (SiteCheckId) {
+    SiteCheckId["Navigation"] = "navigation";
+    SiteCheckId["Forms"] = "forms";
+    SiteCheckId["Consent"] = "consent";
+    SiteCheckId["Seo"] = "seo";
+    SiteCheckId["Facts"] = "facts";
+    SiteCheckId["Accessibility"] = "accessibility";
+    SiteCheckId["Tokens"] = "tokens";
+    SiteCheckId["Actions"] = "actions";
+})(SiteCheckId || (SiteCheckId = {}));
+/** The eight, in §3e's order. */
+const SITE_CHECKS = Object.values(SiteCheckId);
+var CheckSeverity;
+(function (CheckSeverity) {
+    CheckSeverity["Block"] = "block";
+    CheckSeverity["Ask"] = "ask";
+    CheckSeverity["Warn"] = "warn";
+})(CheckSeverity || (CheckSeverity = {}));
+var SiteFindingCode;
+(function (SiteFindingCode) {
+    SiteFindingCode["NoHeader"] = "no-header";
+    SiteFindingCode["NoPhoneMenu"] = "no-phone-menu";
+    SiteFindingCode["FormWithoutId"] = "form-without-id";
+    SiteFindingCode["EmailNeedsMailer"] = "email-needs-mailer";
+    SiteFindingCode["TrackerWithoutBanner"] = "tracker-without-banner";
+    SiteFindingCode["NoTitle"] = "no-title";
+    SiteFindingCode["NoDescription"] = "no-description";
+    SiteFindingCode["UnfilledFact"] = "unfilled-fact";
+    SiteFindingCode["CopyPlaceholder"] = "copy-placeholder";
+    SiteFindingCode["SampleItems"] = "sample-items";
+    SiteFindingCode["StockPhoto"] = "stock-photo";
+    SiteFindingCode["NoPrivacyPage"] = "no-privacy-page";
+    SiteFindingCode["PrivacyPagePlaceholder"] = "privacy-page-placeholder";
+    SiteFindingCode["LowContrast"] = "low-contrast";
+    SiteFindingCode["HeadingOrder"] = "heading-order";
+    SiteFindingCode["ImageWithoutAlt"] = "image-without-alt";
+    SiteFindingCode["LiteralColour"] = "literal-colour";
+    SiteFindingCode["DeadLink"] = "dead-link";
+    SiteFindingCode["DeadDialogTarget"] = "dead-dialog-target";
+    SiteFindingCode["ActionNeedsConnector"] = "action-needs-connector";
+})(SiteFindingCode || (SiteFindingCode = {}));
+/** Each finding's severity — one table (D8), never decided at a call site. */
+const FINDING_SEVERITY = {
+    [SiteFindingCode.NoHeader]: CheckSeverity.Warn,
+    [SiteFindingCode.NoPhoneMenu]: CheckSeverity.Warn,
+    [SiteFindingCode.FormWithoutId]: CheckSeverity.Block,
+    [SiteFindingCode.EmailNeedsMailer]: CheckSeverity.Warn,
+    [SiteFindingCode.TrackerWithoutBanner]: CheckSeverity.Warn,
+    [SiteFindingCode.NoTitle]: CheckSeverity.Warn,
+    [SiteFindingCode.NoDescription]: CheckSeverity.Warn,
+    [SiteFindingCode.UnfilledFact]: CheckSeverity.Block,
+    [SiteFindingCode.CopyPlaceholder]: CheckSeverity.Ask,
+    [SiteFindingCode.SampleItems]: CheckSeverity.Ask,
+    [SiteFindingCode.StockPhoto]: CheckSeverity.Ask,
+    [SiteFindingCode.NoPrivacyPage]: CheckSeverity.Ask,
+    [SiteFindingCode.PrivacyPagePlaceholder]: CheckSeverity.Block,
+    [SiteFindingCode.LowContrast]: CheckSeverity.Warn,
+    [SiteFindingCode.HeadingOrder]: CheckSeverity.Warn,
+    [SiteFindingCode.ImageWithoutAlt]: CheckSeverity.Warn,
+    [SiteFindingCode.LiteralColour]: CheckSeverity.Warn,
+    [SiteFindingCode.DeadLink]: CheckSeverity.Block,
+    [SiteFindingCode.DeadDialogTarget]: CheckSeverity.Block,
+    [SiteFindingCode.ActionNeedsConnector]: CheckSeverity.Block,
+};
+const CHECK_OF = {
+    [SiteFindingCode.NoHeader]: SiteCheckId.Navigation,
+    [SiteFindingCode.NoPhoneMenu]: SiteCheckId.Navigation,
+    [SiteFindingCode.FormWithoutId]: SiteCheckId.Forms,
+    [SiteFindingCode.EmailNeedsMailer]: SiteCheckId.Forms,
+    [SiteFindingCode.TrackerWithoutBanner]: SiteCheckId.Consent,
+    [SiteFindingCode.NoTitle]: SiteCheckId.Seo,
+    [SiteFindingCode.NoDescription]: SiteCheckId.Seo,
+    [SiteFindingCode.UnfilledFact]: SiteCheckId.Facts,
+    [SiteFindingCode.CopyPlaceholder]: SiteCheckId.Facts,
+    [SiteFindingCode.SampleItems]: SiteCheckId.Facts,
+    [SiteFindingCode.StockPhoto]: SiteCheckId.Facts,
+    [SiteFindingCode.NoPrivacyPage]: SiteCheckId.Facts,
+    [SiteFindingCode.PrivacyPagePlaceholder]: SiteCheckId.Facts,
+    [SiteFindingCode.LowContrast]: SiteCheckId.Accessibility,
+    [SiteFindingCode.HeadingOrder]: SiteCheckId.Accessibility,
+    [SiteFindingCode.ImageWithoutAlt]: SiteCheckId.Accessibility,
+    [SiteFindingCode.LiteralColour]: SiteCheckId.Tokens,
+    [SiteFindingCode.DeadLink]: SiteCheckId.Actions,
+    [SiteFindingCode.DeadDialogTarget]: SiteCheckId.Actions,
+    [SiteFindingCode.ActionNeedsConnector]: SiteCheckId.Actions,
+};
+const LINKING_TYPES = new Set(['Link', 'Heading', 'Button', 'ButtonBlock', 'LinkedContainer', 'Image']);
+const PAGE_LINK = 'page';
+const PERSONAL_CONTROLS = new Set([ControlType.Email, ControlType.Tel, ControlType.Text, ControlType.Textarea]);
+const PRIVACY_PAGE = /privacy|פרטיות|מדיניות/i;
+const MAILER = 'mailer';
+const EMAIL_DELIVERY = 'email';
+const LITERAL_COLOUR = /#[0-9a-f]{3,8}\b|rgba?\(|hsla?\(/i;
+const COLOUR_TRAITS = /color|Color|^background$|boxShadow|textShadow/;
+const HEADING_LEVEL = /^h([1-6])$/;
+const DIALOG_TYPE = 'Dialog';
+const SELF = 'self';
+/** A route pattern (`/work/:slug`) matches a concrete path (`/work/blue-bowl`). */
+function routeMatches(pattern, path) {
+    const a = pattern.split('/').filter(Boolean);
+    const b = String(path ?? '').split(/[?#]/)[0].split('/').filter(Boolean);
+    return a.length === b.length && a.every((seg, i) => seg.startsWith(':') || seg === b[i]);
+}
+const nonEmpty = (v) => typeof v === 'string' && v.trim() !== '';
+/** A stored SEO field (a string, or `{ override, binding, auto }`) has a value, or may be derived. */
+function seoField(raw, derivable) {
+    if (nonEmpty(raw))
+        return true;
+    if (raw && typeof raw === 'object') {
+        const v = raw;
+        if (nonEmpty(v.override) || v.binding)
+            return true;
+        if (v.auto === false)
+            return false;
+    }
+    return derivable;
+}
+function hasContent(layout, type) {
+    let found = false;
+    walkSerialized(layout, n => {
+        if (n.type !== type || found)
+            return;
+        found = nonEmpty(n.props['content']) || n.bindings.some(b => b.prop === 'content');
+    });
+    return found;
+}
+function add(ctx, code, message, where = {}) {
+    ctx.out.push({ check: CHECK_OF[code], severity: FINDING_SEVERITY[code], code, message, ...where });
+}
+/** Every node of a page or a global, with where it lives. */
+function eachNode(snapshot, pages, visit) {
+    for (const page of pages)
+        walkSerialized(page.layout, n => visit(n, { pageId: page.id }));
+    for (const global of snapshot.globals) {
+        const owner = global.globalPosition === PatternGlobalPosition.Before ? 'header' : 'footer';
+        walkSerialized([global], n => visit(n, { owner }));
+    }
+}
+function checkNavigation(ctx, snapshot) {
+    const header = snapshot.globals.find(g => g.globalPosition === PatternGlobalPosition.Before);
+    if (!header)
+        return add(ctx, SiteFindingCode.NoHeader, 'The site has no header, so visitors have no menu to move around with.');
+    if (!navShapeOf(snapshot.globals))
+        add(ctx, SiteFindingCode.NoPhoneMenu, 'The header has no phone menu — on a phone its links are hard to reach.', { owner: 'header', nodeId: header.id });
+}
+function checkForms(ctx, snapshot, pages) {
+    let personal = false;
+    eachNode(snapshot, pages, (n, where) => {
+        if (n.type !== FORM_NODE_TYPE)
+            return;
+        const spec = collectFormSpec(n);
+        if (!spec || !nonEmpty(spec.formId))
+            add(ctx, SiteFindingCode.FormWithoutId, 'A form has no id, so what visitors send is never stored.', { ...where, nodeId: n.id });
+        if (spec?.actions.some(a => a.type === EMAIL_DELIVERY) && snapshot.connectors[MAILER] !== true) {
+            add(ctx, SiteFindingCode.EmailNeedsMailer, 'A form emails what visitors send, but Email is not connected — it is stored and never sent.', { ...where, nodeId: n.id });
+        }
+        walkSerialized(n.children ?? [], f => {
+            if (f.type === FIELD_NODE_TYPE && PERSONAL_CONTROLS.has(String(f.props['control'] ?? ControlType.Text)))
+                personal = true;
+        });
+    });
+    return personal;
+}
+function checkConsent(ctx, snapshot) {
+    if (!snapshot.trackers?.length)
+        return;
+    let banner = false;
+    for (const g of snapshot.globals)
+        walkSerialized([g], n => { if (n.type === DIALOG_TYPE && n.props['consentRole'] === true)
+            banner = true; });
+    if (!banner)
+        add(ctx, SiteFindingCode.TrackerWithoutBanner, `${snapshot.trackers.join(', ')} is connected, but the site has no cookie banner — it stays off for every visitor.`);
+}
+function checkSeo(ctx, pages) {
+    for (const page of pages) {
+        const seo = (page.seo ?? {});
+        if (!seoField(seo['title'], hasContent(page.layout, 'Heading')))
+            add(ctx, SiteFindingCode.NoTitle, `"${page.name}" has no title for search results.`, { pageId: page.id });
+        if (!seoField(seo['description'], hasContent(page.layout, 'Text')))
+            add(ctx, SiteFindingCode.NoDescription, `"${page.name}" has no description for search results.`, { pageId: page.id });
+    }
+}
+function checkFacts(ctx, snapshot, pages, personal) {
+    const inScope = (p) => !p.pageId || pages.some(page => page.id === p.pageId);
+    for (const p of (snapshot.placeholders ?? []).filter(p => !p.filled && inScope(p))) {
+        const where = { pageId: p.pageId, nodeId: p.nodeId, ...(p.pageId ? {} : { owner: p.owner }) };
+        if (blocksPublish(p.kind))
+            add(ctx, SiteFindingCode.UnfilledFact, `"${p.text || p.fact || p.kind}" is still blank — fill it in before the site goes live.`, where);
+        else if (p.kind === PlaceholderKind.Copy)
+            add(ctx, SiteFindingCode.CopyPlaceholder, 'Some words are still the template\'s.', where);
+    }
+    for (const s of snapshot.samples ?? [])
+        add(ctx, SiteFindingCode.SampleItems, `"${s.label ?? s.id}" is a sample — replace or remove it.`, { nodeId: s.id });
+    for (const s of (snapshot.stock ?? []).filter(inScope))
+        add(ctx, SiteFindingCode.StockPhoto, 'A stock photo stands in for one of yours.', { pageId: s.pageId, nodeId: s.nodeId, owner: s.owner });
+    if (!personal)
+        return;
+    const privacy = snapshot.pages.find(p => PRIVACY_PAGE.test(p.route) || PRIVACY_PAGE.test(p.name));
+    if (!privacy)
+        return add(ctx, SiteFindingCode.NoPrivacyPage, 'A form asks for personal details, and the site has no privacy page saying what you do with them.');
+    if ((snapshot.placeholders ?? []).some(p => p.pageId === privacy.id && !p.filled)) {
+        add(ctx, SiteFindingCode.PrivacyPagePlaceholder, 'The privacy page still holds template words — only you can write it.', { pageId: privacy.id });
+    }
+}
+function checkAccessibility(ctx, snapshot, pages) {
+    for (const mode of snapshot.design?.modes ?? []) {
+        const failing = auditDesignContrast(snapshot.design.rows, mode).filter(f => !f.pass);
+        if (failing.length)
+            add(ctx, SiteFindingCode.LowContrast, `${failing.length} text and background pair(s) are hard to read in ${mode} mode.`);
+    }
+    for (const page of pages) {
+        let last = 0;
+        let h1 = 0;
+        walkSerialized(page.layout, n => {
+            const level = n.type === 'Heading' ? HEADING_LEVEL.exec(String(n.props['level'] ?? ''))?.[1] : undefined;
+            if (!level)
+                return;
+            const l = Number(level);
+            if (l === 1)
+                h1++;
+            if (last && l > last + 1)
+                add(ctx, SiteFindingCode.HeadingOrder, `A heading on "${page.name}" skips a level (h${last} → h${l}).`, { pageId: page.id, nodeId: n.id });
+            last = l;
+        });
+        if (h1 > 1)
+            add(ctx, SiteFindingCode.HeadingOrder, `"${page.name}" has ${h1} main headings (h1); one is clearer.`, { pageId: page.id });
+    }
+    eachNode(snapshot, pages, (n, where) => {
+        if (n.type !== 'Image')
+            return;
+        const decorative = n.props['alt'] === '' && n.props['decorative'] === true;
+        const bound = n.bindings.some(b => b.prop === 'alt');
+        if (!decorative && !bound && !nonEmpty(n.props['alt']))
+            add(ctx, SiteFindingCode.ImageWithoutAlt, 'A picture has no description for people who cannot see it.', { ...where, nodeId: n.id });
+    });
+}
+function checkTokens(ctx, snapshot, pages) {
+    eachNode(snapshot, pages, (n, where) => {
+        if (!n.elementStyle)
+            return;
+        const maps = [n.styleProps, ...Object.values(n.stateStyles ?? {}), ...Object.values(n.responsive ?? {}).map(l => l?.styleProps)];
+        const literal = maps.some(map => Object.entries(map ?? {}).some(([k, v]) => COLOUR_TRAITS.test(k) && LITERAL_COLOUR.test(String(v)) && !(k === 'borderColor' && n.styleProps['borderWidth'] === '0px')));
+        if (literal)
+            add(ctx, SiteFindingCode.LiteralColour, 'An element paints a fixed colour, so a new look will not reach it.', { ...where, nodeId: n.id });
+    });
+}
+function checkActions(ctx, snapshot, pages) {
+    const routeExists = (route) => typeof route === 'string' && ctx.routes.some(r => routeMatches(r, route));
+    eachNode(snapshot, pages, (n, where) => {
+        if (LINKING_TYPES.has(n.type) && n.props['linkType'] === PAGE_LINK && !routeExists(n.props['pageRoute'])) {
+            add(ctx, SiteFindingCode.DeadLink, `"${String(n.props['label'] ?? n.props['content'] ?? n.label ?? n.type)}" links to ${String(n.props['pageRoute'] || 'no page')}, which is not a page of the site.`, { ...where, nodeId: n.id });
+        }
+        for (const ix of (n.interactions ?? [])) {
+            for (const action of ix?.actions ?? []) {
+                if (!action || action.disabled)
+                    continue;
+                const descriptor = ELEMENT_ACTION_DESCRIPTORS.find(d => d.type === action.type);
+                if (!descriptor)
+                    continue;
+                const types = descriptor.target?.types;
+                if (descriptor.target?.required && action.target !== SELF) {
+                    const targetType = action.target ? ctx.nodeIds.get(action.target) : undefined;
+                    if (!targetType || (types && !types.includes(targetType))) {
+                        add(ctx, SiteFindingCode.DeadDialogTarget, `"${n.label ?? n.type}" opens something that is no longer on the site.`, { ...where, nodeId: n.id });
+                    }
+                }
+                if (action.type === 'navigate' && action.params?.['navigateTo'] === PAGE_LINK && !routeExists(action.params?.['page'])) {
+                    add(ctx, SiteFindingCode.DeadLink, `"${n.label ?? n.type}" goes to a page the site does not have.`, { ...where, nodeId: n.id });
+                }
+                // A connector the snapshot does not say is usable is not: unknown is never "fine".
+                const connectors = descriptor.connector ? { [descriptor.connector]: snapshot.connectors[descriptor.connector] === true } : {};
+                const availability = resolveActionAvailability(descriptor, { connectors });
+                if (availability.state === 'connector-missing') {
+                    add(ctx, SiteFindingCode.ActionNeedsConnector, `"${n.label ?? n.type}" needs ${availability.connector} connected.`, { ...where, nodeId: n.id });
+                }
+            }
+        }
+    });
+}
+/** Run the eight checks. `pageId` narrows the page checks to the page being published; site-wide ones always run. */
+function auditSite(snapshot, options = {}) {
+    const pages = options.pageId ? snapshot.pages.filter(p => p.id === options.pageId) : snapshot.pages;
+    const nodeIds = new Map();
+    eachNode(snapshot, snapshot.pages, n => nodeIds.set(n.id, n.type));
+    const ctx = { out: [], routes: snapshot.pages.map(p => p.route), nodeIds };
+    checkNavigation(ctx, snapshot);
+    const personal = checkForms(ctx, snapshot, pages);
+    checkConsent(ctx, snapshot);
+    checkSeo(ctx, pages);
+    checkFacts(ctx, snapshot, pages, personal);
+    checkAccessibility(ctx, snapshot, pages);
+    checkTokens(ctx, snapshot, pages);
+    checkActions(ctx, snapshot, pages);
+    const checks = SITE_CHECKS.map(id => {
+        const findings = ctx.out.filter(f => f.check === id);
+        return { id, passed: !findings.some(f => f.severity !== CheckSeverity.Warn), findings };
+    });
+    return {
+        checks,
+        blocking: ctx.out.filter(f => f.severity === CheckSeverity.Block).length,
+        asking: ctx.out.filter(f => f.severity === CheckSeverity.Ask).length,
+    };
+}
+/** What a publish request must acknowledge: every ASK finding's code (a BLOCK cannot be acknowledged). */
+function requiredAcknowledgements(audit) {
+    return [...new Set(audit.checks.flatMap(c => c.findings).filter(f => f.severity === CheckSeverity.Ask).map(f => f.code))];
+}
+/** The publish verdict: blocked (never acknowledgeable), needs these acknowledgements, or free to go. */
+function publishVerdict(audit, acknowledged = []) {
+    const missing = requiredAcknowledgements(audit).filter(code => !acknowledged.includes(code));
+    const blocked = audit.blocking > 0;
+    return { ok: !blocked && missing.length === 0, blocked, missing };
+}
+
+/**
+ * Stock photos in a built site (AI plan §3g / §3m, I2): a FREE picture from the platform's curated library, copied
+ * into the studio's own storage (never hot-linked), placed only in an EMPTY picture slot of a section that may show
+ * one — never the owner's work (a collection, a detail page, a gallery: what the nine portfolio types sell is theirs),
+ * never a person (testimonials, the team), never anywhere when the business type says `stock: false`. Its alt text is
+ * the provider's description of what it shows (never a claim), and the credit line its licence requires is placed in
+ * the footer. Pure: the build step does the copying.
+ */
+/** Where a stock photo comes from (the library's provider). */
+var StockProviderId;
+(function (StockProviderId) {
+    StockProviderId["Magnific"] = "magnific";
+})(StockProviderId || (StockProviderId = {}));
+/** The section families a stock photo may stand in for a picture in. */
+const STOCK_FAMILIES = new Set(['hero', 'feature', 'content', 'story', 'cta', 'contact', 'header']);
+/** The empty picture slots of a composed site a stock photo may fill, in page and section order. */
+function stockSlots(plan, composed) {
+    const empty = new Set(composed.placeholders.filter(p => p.kind === PlaceholderKind.Image).map(p => p.nodeId));
+    const out = [];
+    composed.pages.forEach((page, p) => {
+        page.layout.forEach((root, s) => {
+            const pattern = plan.pages[p]?.sections[s]?.pattern;
+            const family = patternById(pattern)?.family;
+            if (!pattern || !family || !STOCK_FAMILIES.has(family))
+                return;
+            walkSerialized([root], n => {
+                if (n.type === 'Image' && empty.has(n.id) && !n.bindings.length)
+                    out.push({ nodeId: n.id, owner: page.key, pattern });
+            });
+        });
+    });
+    return out;
+}
+/** Which photo goes where: the library's photos in order, one per slot, never twice; none when the type says no stock. */
+function planStockPhotos(slots, photos, stockAllowed) {
+    if (!stockAllowed)
+        return [];
+    return slots.slice(0, photos.length).map((slot, i) => ({ ...slot, photo: photos[i] }));
+}
+/** A placed photo's copy in the studio's storage: the key the build writes it under. */
+function stockCopyKey(photo) {
+    return `media/stock/${photo.key.replace(/[^a-zA-Z0-9._-]+/g, '-')}`;
+}
+/** Put the studio's copy of each photo into its slot (src + the provider's alt). Returns the nodes changed. */
+function applyStockPhotos(trees, placed) {
+    const byId = new Map(placed.map(p => [p.nodeId, p]));
+    let changed = 0;
+    walkSerialized(trees, n => {
+        const p = byId.get(n.id);
+        if (!p || n.type !== 'Image')
+            return;
+        n.props['src'] = p.url;
+        n.props['alt'] = p.alt;
+        changed++;
+    });
+    return changed;
+}
+/** The credit lines a set of photos needs — one per distinct line (a free Magnific photo: "Designed by Magnific"). */
+function stockCreditLines(photos) {
+    const seen = new Map();
+    for (const p of photos)
+        if (!seen.has(p.credit.line))
+            seen.set(p.credit.line, p.credit.lineUrl);
+    return [...seen.entries()].map(([line, url]) => ({ line, url }));
+}
+/** The footer node id of a credit line (stable — a build that runs twice finds it). */
+const stockCreditNodeId = (index) => `stock-credit-${index + 1}`;
+/**
+ * The credit line, as the builder would create a Link (a plain node the owner may move or restyle): the licence's words,
+ * linking where it asks, opening in a new tab. Placed at the end of the footer — the place the licence names for a site.
+ */
+function stockCreditNode(index, credit) {
+    return createSerializedNode(stockCreditNodeId(index), 'Link', { label: credit.line, linkType: 'external', url: credit.url, target: '_blank' }, 'link');
+}
+/** Append the credit lines to the footer root (once each). Returns how many it added. */
+function addStockCredits(footer, credits) {
+    footer.children ??= [];
+    let added = 0;
+    credits.forEach((credit, i) => {
+        const id = stockCreditNodeId(i);
+        if (footer.children.some(c => c.id === id))
+            return;
+        footer.children.push(stockCreditNode(i, credit));
+        added++;
+    });
+    return added;
+}
+
 /**
  * @vectoriox/iox-ui/generation-core — the shared, FRAMEWORK-FREE site-plan core (design-system plan
  * §6b, W1): the Site Plan shape + its validator, the pattern library and the Studio template (both
@@ -10943,5 +11362,5 @@ function planWordIssues(plan, ctx) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiGenerationStage, AiKeyMode, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CREDITS_PER_USD, CardBindTarget, ComposeError, ComposeIssueCode, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, FINAL_GENERATION_STAGES, GlobalSlot, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PLAN_EDITS_ANSWER_SHAPE, PLAN_EDITS_SCHEMA_NAME, PLAN_EDIT_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanWordIssueCode, PreflightRefusalCode, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_SCHEMA_NAME, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SitePlanWireKey, SiteTemplateError, SiteTemplateId, StepState, addBarItem, altSourceScopes, applyPlanEdits, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypeFromWire, contentTypeJsonSchema, costUsd, createSerializedNode, creditsOfUsd, dataSourceJsonSchema, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, failedBuildStep, fieldJsonSchema, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageJsonSchema, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planEditsFromWire, planEditsJsonSchema, planFromTemplate, planNavShape, planWordIssues, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, sectionEntrances, sectionFromWire, sectionJsonSchema, sectionPatternIds, setStyleProps, shapeKeys, siteNavPages, sitePlanFromWire, sitePlanJsonSchema, sitePlanToWire, staggerDelay, validatePlanEdits, validateSitePlan, walkSerialized, wordPattern, writtenTexts };
+export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiGenerationStage, AiKeyMode, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, FINAL_GENERATION_STAGES, FINDING_SEVERITY, GlobalSlot, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PLAN_EDITS_ANSWER_SHAPE, PLAN_EDITS_SCHEMA_NAME, PLAN_EDIT_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanWordIssueCode, PreflightRefusalCode, RelativeOp, SAMPLE_IMAGE_REF, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_SCHEMA_NAME, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SitePlanWireKey, SiteTemplateError, SiteTemplateId, StepState, StockProviderId, addBarItem, addStockCredits, altSourceScopes, applyPlanEdits, applyStockPhotos, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypeFromWire, contentTypeJsonSchema, costUsd, createSerializedNode, creditsOfUsd, dataSourceJsonSchema, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, failedBuildStep, fieldJsonSchema, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, pageJsonSchema, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planEditsFromWire, planEditsJsonSchema, planFromTemplate, planNavShape, planStockPhotos, planWordIssues, publishVerdict, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, routeMatches, routeParams, sampleImageRef, sectionEntrances, sectionFromWire, sectionJsonSchema, sectionPatternIds, setStyleProps, shapeKeys, siteNavPages, sitePlanFromWire, sitePlanJsonSchema, sitePlanToWire, staggerDelay, stockCopyKey, stockCreditLines, stockCreditNode, stockCreditNodeId, stockSlots, validatePlanEdits, validateSitePlan, walkSerialized, wordPattern, writtenTexts };
 //# sourceMappingURL=vectoriox-iox-ui-generation-core.mjs.map