@aglyn/plugins-ai 1.0.0-beta.269 → 1.0.0-beta.271

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

@@ -14,6 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { AiSiteContact } from '../model/ai-site-details';
 import type { AiLayoutListing } from './ai-layout-listings';
 /**
  * Where a link the layout language names goes (AGL-3660), resolved by code to
@@ -70,6 +71,13 @@ export interface AiLayoutTargets {
      * `ai-layout-listings.ts`). Absent or empty, a page shows only its words.
      */
     listings?: readonly AiLayoutListing[];
+    /**
+     * The business's phone number and email, where the job was given them
+     * (AGL-3979): a link to `phone` calls the number and one to `email` writes
+     * to the address, and the footer and the page that places the site's form
+     * show them. Absent, neither link goes anywhere.
+     */
+    contact?: AiSiteContact | null;
 }
 /** Where a link resolved to. */
 export type AiLayoutDestination = {
@@ -92,6 +100,11 @@ export type AiLayoutDestination = {
     href: string;
     standsInFor?: string;
     label?: string;
+}
+/** The business's phone (`tel:`) or email (`mailto:`) the job was given (AGL-3979). */
+ | {
+    kind: 'contact';
+    href: string;
 };
 /**
  * A link's words for where it now goes (AGL-3676): a button that named a

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

@@ -126,6 +126,10 @@ function resolveNamed(to, label, scope, targets) {
             href: to
         } : null;
     }
+    // A call or an email goes only to the number and the address the job was
+    // given (AGL-3979), however the link spells them.
+    const contact = contactDestination(lower, targets.contact);
+    if (contact !== undefined) return contact;
     const section = lower.startsWith('#') ? to.slice(1) : lower.startsWith('section:') ? to.slice(8) : null;
     if (section !== null) {
         const number = Number(section.trim());
@@ -138,5 +142,31 @@ function resolveNamed(to, label, scope, targets) {
     const page = pageNamed(lower.startsWith('page:') ? to.slice(5) : to, targets);
     return pageDestination(page, label, targets);
 }
+/**
+ * Where a link to the business's phone or email goes (AGL-3979): `phone`,
+ * `call` or a `tel:` link with the given number's digits is the number;
+ * `email` or a `mailto:` link to the given address is the address. `null` is
+ * such a link with nothing given to go to, which is left out; `undefined` is
+ * a link that names neither.
+ */ function contactDestination(lower, contact) {
+    const digits = (value)=>value.replace(/\D/g, '');
+    if (lower === 'phone' || lower === 'call' || lower === 'tel' || lower.startsWith('tel:')) {
+        if (!(contact == null ? void 0 : contact.phoneHref)) return null;
+        if (lower.startsWith('tel:') && digits(lower) !== digits(contact.phoneHref)) return null;
+        return {
+            kind: 'contact',
+            href: contact.phoneHref
+        };
+    }
+    if (lower === 'email' || lower === 'mail' || lower.startsWith('mailto:')) {
+        if (!(contact == null ? void 0 : contact.emailHref)) return null;
+        if (lower.startsWith('mailto:') && lower.slice(7).split('?')[0] !== contact.email.toLowerCase()) return null;
+        return {
+            kind: 'contact',
+            href: contact.emailHref
+        };
+    }
+    return undefined;
+}
 
 //# sourceMappingURL=ai-layout-links.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-links.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 { aiAsksToGetInTouch } from '../runtime/ai-doctrine-validators'\nimport { aiPageLinkSection } from '../runtime/ai-page-links'\nimport type { AiLayoutListing } from './ai-layout-listings'\n\n/**\n * Where a link the layout language names goes (AGL-3660), resolved by code to\n * a destination rule 10 admits: a page of this site by its id, a section of\n * this page by the platform's Scroll to element interaction, or an `https:`\n * address the brief itself gave. A destination that resolves to nothing, or\n * to the home page under words that do not say home, is no destination, and\n * the compiler leaves the button out rather than shipping a dead control.\n */\n\n/** A page of the site a link may go to: built, or minted on a guided start's plan. */\nexport interface AiLayoutPage {\n  id: string\n  label: string\n  slug: string\n  /**\n   * A destination on the site that is no page of its own, linked by its path:\n   * the blog a guided start writes its posts into (AGL-3660), whose `id` is\n   * no screen. Absent for every page.\n   */\n  href?: string\n  /**\n   * The title of a planned page merged into this destination (AGL-3676): a\n   * page that stood in for the blog, kept only so links to it go to the blog.\n   * A link to it is named for the blog, not for the page it replaced.\n   */\n  standsInFor?: string\n}\n\n/** Everything a page's links resolve against. */\nexport interface AiLayoutTargets {\n  /** The page being built, which no link of its own goes to. */\n  pageId?: string | null\n  /** The site's pages a link may go to. */\n  pages: readonly AiLayoutPage[]\n  /** The site's home pages, which only words that say home link (rule 10). */\n  homeIds: readonly string[]\n  /** The saved forms a page may place. */\n  forms: readonly { id: string; name: string }[]\n  /** The page that places the site's form, where that is another page. */\n  formPageId?: string | null\n  /** The reusable components a page may place, with the props each fills. */\n  components: readonly {\n    id: string\n    name: string\n    props: Record<string, string>\n  }[]\n  /** Every word the job was given: the brief, the site's answers, its profile. */\n  facts: string\n  /**\n   * The kinds of record the site keeps that its pages show — its catalog,\n   * its blog — and the sections that place each (AGL-3676,\n   * `ai-layout-listings.ts`). Absent or empty, a page shows only its words.\n   */\n  listings?: readonly AiLayoutListing[]\n}\n\n/** Where a link resolved to. */\nexport type AiLayoutDestination =\n  | { kind: 'page'; screenId: string }\n  | { kind: 'section'; index: number }\n  | { kind: 'href'; href: string }\n  /**\n   * A path on this site that is no page of its own, such as the blog\n   * (AGL-3660); reached through a planned page merged into it, the title\n   * that page had and the name it now goes by (AGL-3676).\n   */\n  | { kind: 'path'; href: string; standsInFor?: string; label?: string }\n\n/**\n * A link's words for where it now goes (AGL-3676): a button that named a\n * page merged into the blog — \"Read the articles\" — names the blog instead,\n * \"Read the blog\". Words that name neither are kept.\n */\nexport function aiLayoutRenamedLabel(label: string, destination: AiLayoutDestination): string {\n  if (destination.kind !== 'path' || !destination.standsInFor || !destination.label) return label\n  const name = destination.label.toLowerCase()\n  const words = wordsOf(destination.standsInFor)\n  if (!words.length) return label\n  // The page's own name, or its words alone, singular or plural, whole: a\n  // letter in any script continues a word (AGL-3791). `\\b` reads \"ú\" or \"í\"\n  // as no letter, so it never matched \"Menú\" and matched \"art\" inside\n  // \"artículos\".\n  const stems = words.map((word) => word.replace(/s$/, ''))\n  const pattern = new RegExp(\n    `(?<![\\\\p{L}\\\\p{M}\\\\p{N}])(?:${stems.map((stem) => stem.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')).join('\\\\s+')})s?(?![\\\\p{L}\\\\p{M}\\\\p{N}])`,\n    'giu',\n  )\n  const renamed = label.replace(pattern, (found) => (found[0] === found[0].toUpperCase() ? destination.label as string : name))\n  return renamed\n}\n\n/** The words of a label or a name, as they are compared. */\nfunction wordsOf(text: string): string[] {\n  return text\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n}\n\nfunction slugOf(slug: string): string {\n  return `/${slug.replace(/^\\/+|\\/+$/g, '')}`.toLowerCase()\n}\n\nconst HOME_WORDS = /\\bhome(?:\\s?page)?\\b/i\n\n/** Words that ask a visitor to get in touch, which the site's form answers: rule 10's own list (AGL-3729). */\nconst CONTACT_WORDS = { test: aiAsksToGetInTouch }\n\nexport interface AiLayoutLinkScope {\n  /** The page's section names in plan order. */\n  sections: readonly string[]\n  /** The section the link sits in, which it does not scroll to. */\n  from: number\n  /** The section of this page that places the site's form, if one does. */\n  formSection: number | null\n}\n\n/** The page a word names: an id, a label or an address. */\nfunction pageNamed(\n  word: string,\n  targets: AiLayoutTargets,\n): AiLayoutPage | null {\n  const value = word.trim()\n  if (!value) return null\n  const byId = targets.pages.find((page) => page.id === value)\n  if (byId) return byId\n  const lower = value.toLowerCase()\n  if (lower.startsWith('/'))\n    return (\n      targets.pages.find((page) => slugOf(page.slug) === slugOf(lower)) ?? null\n    )\n  const words = wordsOf(value).join(' ')\n  return (\n    targets.pages.find((page) => wordsOf(page.label).join(' ') === words) ??\n    // A page merged into the blog is still named by the title it had (AGL-3676).\n    targets.pages.find((page) => page.standsInFor && wordsOf(page.standsInFor).join(' ') === words) ??\n    null\n  )\n}\n\n/** A destination rule 10 admits, from the page it names, for the words a link shows. */\nfunction pageDestination(\n  page: AiLayoutPage | null,\n  label: string,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (!page || page.id === targets.pageId) return null\n  // A link home says so, in English or by the home page's own title: a\n  // Spanish site's home is \"Inicio\" (AGL-3760).\n  const saysHome = HOME_WORDS.test(label) || (wordsOf(label).join(' ') !== '' && wordsOf(label).join(' ') === wordsOf(page.label).join(' '))\n  if (targets.homeIds.includes(page.id) && !saysHome && !isHomeSlug(page.slug)) return null\n  if (isHomeSlug(page.slug) && !saysHome) return null\n  if (page.href) return { kind: 'path', href: page.href, ...(page.standsInFor ? { standsInFor: page.standsInFor, label: page.label } : {}) }\n  return { kind: 'page', screenId: page.id }\n}\n\nfunction isHomeSlug(slug: string): boolean {\n  return slugOf(slug) === '/'\n}\n\n/** Where the site's form is: a section of this page, else the page that places it. */\nfunction formDestination(\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (scope.formSection !== null && scope.formSection !== scope.from)\n    return { kind: 'section', index: scope.formSection }\n  if (targets.formPageId && targets.formPageId !== targets.pageId) {\n    return { kind: 'page', screenId: targets.formPageId }\n  }\n  return null\n}\n\n/**\n * Where a link goes: the destination its `to` names, read the language's\n * way; failing that, for words that ask a visitor to get in touch, the site's\n * form; failing that, a page whose name the words say. `null` is a link with\n * nowhere to go, which is left out.\n */\nexport function aiLayoutResolveLink(\n  to: string | undefined,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const named = to ? resolveNamed(to.trim(), label, scope, targets) : null\n  if (named) return named\n  if (CONTACT_WORDS.test(label)) {\n    const form = formDestination(scope, targets)\n    if (form) return form\n    const contact = targets.pages.find(\n      (page) =>\n        page.id !== targets.pageId &&\n        !isHomeSlug(page.slug) &&\n        CONTACT_WORDS.test(page.label),\n    )\n    if (contact) return { kind: 'page', screenId: contact.id }\n  }\n  const labelWords = new Set(wordsOf(label))\n  const said = targets.pages.filter(\n    (page) =>\n      page.id !== targets.pageId &&\n      !isHomeSlug(page.slug) &&\n      wordsOf(page.label).length > 0 &&\n      wordsOf(page.label).every((word) => labelWords.has(word)),\n  )\n  return said.length === 1 ? { kind: 'page', screenId: said[0].id } : null\n}\n\nfunction resolveNamed(\n  to: string,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const lower = to.toLowerCase()\n  if (\n    lower === 'form' ||\n    lower.startsWith('form:') ||\n    targets.forms.some((form) => form.id === to)\n  ) {\n    return formDestination(scope, targets)\n  }\n  if (lower.startsWith('https://')) {\n    return targets.facts.includes(to) ? { kind: 'href', href: to } : null\n  }\n  const section = lower.startsWith('#')\n    ? to.slice(1)\n    : lower.startsWith('section:')\n      ? to.slice(8)\n      : null\n  if (section !== null) {\n    const number = Number(section.trim())\n    const index =\n      Number.isInteger(number) && number >= 1 && number <= scope.sections.length\n        ? number - 1\n        : aiPageLinkSection(section, scope.sections)\n    return index !== null && index !== scope.from\n      ? { kind: 'section', index }\n      : null\n  }\n  const page = pageNamed(lower.startsWith('page:') ? to.slice(5) : to, targets)\n  return pageDestination(page, label, targets)\n}\n"],"names":["aiAsksToGetInTouch","aiPageLinkSection","aiLayoutRenamedLabel","label","destination","kind","standsInFor","name","toLowerCase","words","wordsOf","length","stems","map","word","replace","pattern","RegExp","stem","join","renamed","found","toUpperCase","text","split","filter","Boolean","slugOf","slug","HOME_WORDS","CONTACT_WORDS","test","pageNamed","targets","value","trim","byId","pages","find","page","id","lower","startsWith","pageDestination","pageId","saysHome","homeIds","includes","isHomeSlug","href","screenId","formDestination","scope","formSection","from","index","formPageId","aiLayoutResolveLink","to","named","resolveNamed","form","contact","labelWords","Set","said","every","has","forms","some","facts","section","slice","number","Number","isInteger","sections"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/layout-language/ai-layout-links.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 { aiAsksToGetInTouch } from '../runtime/ai-doctrine-validators'\nimport { aiPageLinkSection } from '../runtime/ai-page-links'\nimport type { AiSiteContact } from '../model/ai-site-details'\nimport type { AiLayoutListing } from './ai-layout-listings'\n\n/**\n * Where a link the layout language names goes (AGL-3660), resolved by code to\n * a destination rule 10 admits: a page of this site by its id, a section of\n * this page by the platform's Scroll to element interaction, or an `https:`\n * address the brief itself gave. A destination that resolves to nothing, or\n * to the home page under words that do not say home, is no destination, and\n * the compiler leaves the button out rather than shipping a dead control.\n */\n\n/** A page of the site a link may go to: built, or minted on a guided start's plan. */\nexport interface AiLayoutPage {\n  id: string\n  label: string\n  slug: string\n  /**\n   * A destination on the site that is no page of its own, linked by its path:\n   * the blog a guided start writes its posts into (AGL-3660), whose `id` is\n   * no screen. Absent for every page.\n   */\n  href?: string\n  /**\n   * The title of a planned page merged into this destination (AGL-3676): a\n   * page that stood in for the blog, kept only so links to it go to the blog.\n   * A link to it is named for the blog, not for the page it replaced.\n   */\n  standsInFor?: string\n}\n\n/** Everything a page's links resolve against. */\nexport interface AiLayoutTargets {\n  /** The page being built, which no link of its own goes to. */\n  pageId?: string | null\n  /** The site's pages a link may go to. */\n  pages: readonly AiLayoutPage[]\n  /** The site's home pages, which only words that say home link (rule 10). */\n  homeIds: readonly string[]\n  /** The saved forms a page may place. */\n  forms: readonly { id: string; name: string }[]\n  /** The page that places the site's form, where that is another page. */\n  formPageId?: string | null\n  /** The reusable components a page may place, with the props each fills. */\n  components: readonly {\n    id: string\n    name: string\n    props: Record<string, string>\n  }[]\n  /** Every word the job was given: the brief, the site's answers, its profile. */\n  facts: string\n  /**\n   * The kinds of record the site keeps that its pages show — its catalog,\n   * its blog — and the sections that place each (AGL-3676,\n   * `ai-layout-listings.ts`). Absent or empty, a page shows only its words.\n   */\n  listings?: readonly AiLayoutListing[]\n  /**\n   * The business's phone number and email, where the job was given them\n   * (AGL-3979): a link to `phone` calls the number and one to `email` writes\n   * to the address, and the footer and the page that places the site's form\n   * show them. Absent, neither link goes anywhere.\n   */\n  contact?: AiSiteContact | null\n}\n\n/** Where a link resolved to. */\nexport type AiLayoutDestination =\n  | { kind: 'page'; screenId: string }\n  | { kind: 'section'; index: number }\n  | { kind: 'href'; href: string }\n  /**\n   * A path on this site that is no page of its own, such as the blog\n   * (AGL-3660); reached through a planned page merged into it, the title\n   * that page had and the name it now goes by (AGL-3676).\n   */\n  | { kind: 'path'; href: string; standsInFor?: string; label?: string }\n  /** The business's phone (`tel:`) or email (`mailto:`) the job was given (AGL-3979). */\n  | { kind: 'contact'; href: string }\n\n/**\n * A link's words for where it now goes (AGL-3676): a button that named a\n * page merged into the blog — \"Read the articles\" — names the blog instead,\n * \"Read the blog\". Words that name neither are kept.\n */\nexport function aiLayoutRenamedLabel(label: string, destination: AiLayoutDestination): string {\n  if (destination.kind !== 'path' || !destination.standsInFor || !destination.label) return label\n  const name = destination.label.toLowerCase()\n  const words = wordsOf(destination.standsInFor)\n  if (!words.length) return label\n  // The page's own name, or its words alone, singular or plural, whole: a\n  // letter in any script continues a word (AGL-3791). `\\b` reads \"ú\" or \"í\"\n  // as no letter, so it never matched \"Menú\" and matched \"art\" inside\n  // \"artículos\".\n  const stems = words.map((word) => word.replace(/s$/, ''))\n  const pattern = new RegExp(\n    `(?<![\\\\p{L}\\\\p{M}\\\\p{N}])(?:${stems.map((stem) => stem.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')).join('\\\\s+')})s?(?![\\\\p{L}\\\\p{M}\\\\p{N}])`,\n    'giu',\n  )\n  const renamed = label.replace(pattern, (found) => (found[0] === found[0].toUpperCase() ? destination.label as string : name))\n  return renamed\n}\n\n/** The words of a label or a name, as they are compared. */\nfunction wordsOf(text: string): string[] {\n  return text\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n}\n\nfunction slugOf(slug: string): string {\n  return `/${slug.replace(/^\\/+|\\/+$/g, '')}`.toLowerCase()\n}\n\nconst HOME_WORDS = /\\bhome(?:\\s?page)?\\b/i\n\n/** Words that ask a visitor to get in touch, which the site's form answers: rule 10's own list (AGL-3729). */\nconst CONTACT_WORDS = { test: aiAsksToGetInTouch }\n\nexport interface AiLayoutLinkScope {\n  /** The page's section names in plan order. */\n  sections: readonly string[]\n  /** The section the link sits in, which it does not scroll to. */\n  from: number\n  /** The section of this page that places the site's form, if one does. */\n  formSection: number | null\n}\n\n/** The page a word names: an id, a label or an address. */\nfunction pageNamed(\n  word: string,\n  targets: AiLayoutTargets,\n): AiLayoutPage | null {\n  const value = word.trim()\n  if (!value) return null\n  const byId = targets.pages.find((page) => page.id === value)\n  if (byId) return byId\n  const lower = value.toLowerCase()\n  if (lower.startsWith('/'))\n    return (\n      targets.pages.find((page) => slugOf(page.slug) === slugOf(lower)) ?? null\n    )\n  const words = wordsOf(value).join(' ')\n  return (\n    targets.pages.find((page) => wordsOf(page.label).join(' ') === words) ??\n    // A page merged into the blog is still named by the title it had (AGL-3676).\n    targets.pages.find((page) => page.standsInFor && wordsOf(page.standsInFor).join(' ') === words) ??\n    null\n  )\n}\n\n/** A destination rule 10 admits, from the page it names, for the words a link shows. */\nfunction pageDestination(\n  page: AiLayoutPage | null,\n  label: string,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (!page || page.id === targets.pageId) return null\n  // A link home says so, in English or by the home page's own title: a\n  // Spanish site's home is \"Inicio\" (AGL-3760).\n  const saysHome = HOME_WORDS.test(label) || (wordsOf(label).join(' ') !== '' && wordsOf(label).join(' ') === wordsOf(page.label).join(' '))\n  if (targets.homeIds.includes(page.id) && !saysHome && !isHomeSlug(page.slug)) return null\n  if (isHomeSlug(page.slug) && !saysHome) return null\n  if (page.href) return { kind: 'path', href: page.href, ...(page.standsInFor ? { standsInFor: page.standsInFor, label: page.label } : {}) }\n  return { kind: 'page', screenId: page.id }\n}\n\nfunction isHomeSlug(slug: string): boolean {\n  return slugOf(slug) === '/'\n}\n\n/** Where the site's form is: a section of this page, else the page that places it. */\nfunction formDestination(\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  if (scope.formSection !== null && scope.formSection !== scope.from)\n    return { kind: 'section', index: scope.formSection }\n  if (targets.formPageId && targets.formPageId !== targets.pageId) {\n    return { kind: 'page', screenId: targets.formPageId }\n  }\n  return null\n}\n\n/**\n * Where a link goes: the destination its `to` names, read the language's\n * way; failing that, for words that ask a visitor to get in touch, the site's\n * form; failing that, a page whose name the words say. `null` is a link with\n * nowhere to go, which is left out.\n */\nexport function aiLayoutResolveLink(\n  to: string | undefined,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const named = to ? resolveNamed(to.trim(), label, scope, targets) : null\n  if (named) return named\n  if (CONTACT_WORDS.test(label)) {\n    const form = formDestination(scope, targets)\n    if (form) return form\n    const contact = targets.pages.find(\n      (page) =>\n        page.id !== targets.pageId &&\n        !isHomeSlug(page.slug) &&\n        CONTACT_WORDS.test(page.label),\n    )\n    if (contact) return { kind: 'page', screenId: contact.id }\n  }\n  const labelWords = new Set(wordsOf(label))\n  const said = targets.pages.filter(\n    (page) =>\n      page.id !== targets.pageId &&\n      !isHomeSlug(page.slug) &&\n      wordsOf(page.label).length > 0 &&\n      wordsOf(page.label).every((word) => labelWords.has(word)),\n  )\n  return said.length === 1 ? { kind: 'page', screenId: said[0].id } : null\n}\n\nfunction resolveNamed(\n  to: string,\n  label: string,\n  scope: AiLayoutLinkScope,\n  targets: AiLayoutTargets,\n): AiLayoutDestination | null {\n  const lower = to.toLowerCase()\n  if (\n    lower === 'form' ||\n    lower.startsWith('form:') ||\n    targets.forms.some((form) => form.id === to)\n  ) {\n    return formDestination(scope, targets)\n  }\n  if (lower.startsWith('https://')) {\n    return targets.facts.includes(to) ? { kind: 'href', href: to } : null\n  }\n  // A call or an email goes only to the number and the address the job was\n  // given (AGL-3979), however the link spells them.\n  const contact = contactDestination(lower, targets.contact)\n  if (contact !== undefined) return contact\n  const section = lower.startsWith('#')\n    ? to.slice(1)\n    : lower.startsWith('section:')\n      ? to.slice(8)\n      : null\n  if (section !== null) {\n    const number = Number(section.trim())\n    const index =\n      Number.isInteger(number) && number >= 1 && number <= scope.sections.length\n        ? number - 1\n        : aiPageLinkSection(section, scope.sections)\n    return index !== null && index !== scope.from\n      ? { kind: 'section', index }\n      : null\n  }\n  const page = pageNamed(lower.startsWith('page:') ? to.slice(5) : to, targets)\n  return pageDestination(page, label, targets)\n}\n\n/**\n * Where a link to the business's phone or email goes (AGL-3979): `phone`,\n * `call` or a `tel:` link with the given number's digits is the number;\n * `email` or a `mailto:` link to the given address is the address. `null` is\n * such a link with nothing given to go to, which is left out; `undefined` is\n * a link that names neither.\n */\nfunction contactDestination(\n  lower: string,\n  contact: AiSiteContact | null | undefined,\n): AiLayoutDestination | null | undefined {\n  const digits = (value: string) => value.replace(/\\D/g, '')\n  if (lower === 'phone' || lower === 'call' || lower === 'tel' || lower.startsWith('tel:')) {\n    if (!contact?.phoneHref) return null\n    if (lower.startsWith('tel:') && digits(lower) !== digits(contact.phoneHref)) return null\n    return { kind: 'contact', href: contact.phoneHref }\n  }\n  if (lower === 'email' || lower === 'mail' || lower.startsWith('mailto:')) {\n    if (!contact?.emailHref) return null\n    if (lower.startsWith('mailto:') && lower.slice(7).split('?')[0] !== contact.email.toLowerCase()) return null\n    return { kind: 'contact', href: contact.emailHref }\n  }\n  return undefined\n}\n"],"names":["aiAsksToGetInTouch","aiPageLinkSection","aiLayoutRenamedLabel","label","destination","kind","standsInFor","name","toLowerCase","words","wordsOf","length","stems","map","word","replace","pattern","RegExp","stem","join","renamed","found","toUpperCase","text","split","filter","Boolean","slugOf","slug","HOME_WORDS","CONTACT_WORDS","test","pageNamed","targets","value","trim","byId","pages","find","page","id","lower","startsWith","pageDestination","pageId","saysHome","homeIds","includes","isHomeSlug","href","screenId","formDestination","scope","formSection","from","index","formPageId","aiLayoutResolveLink","to","named","resolveNamed","form","contact","labelWords","Set","said","every","has","forms","some","facts","contactDestination","undefined","section","slice","number","Number","isInteger","sections","digits","phoneHref","emailHref","email"],"mappings":"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"}

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

@@ -24,13 +24,19 @@ import type { NodesMap } from '@aglyn/aglyn/types/nodes';
  * stored page — it finds each empty slot, decides what kind of picture the
  * slot is, and fills it with a photo the site can serve from its own origin.
  *
- * Two sources fill a slot, in order:
+ * Three sources fill a slot, in order:
  *
  * 1. A stock photo searched for by the slot's own description and copied into
  *    the site's media library (`jobs/ai-layout-stock-photos.ts`), when the
  *    deployment has a stock-photo key.
- * 2. Where the library cannot be asked at all — no stock-photo key, the
- *    library down, refusing or out of time before it answered — one of the
+ * 2. Where the library failed the slot — down, refusing, out of time, or its
+ *    photo not copied — one of the photos the same job already placed on
+ *    this site, on its other pages or its datasets' records
+ *    ({@link aiLayoutJobPhotoPicks}, AGL-3988): each was found for the
+ *    site's own world, so a wedding photographer's home page shows a wedding
+ *    and never an office.
+ * 3. Where the job has no photo of its own — no stock-photo key, or the
+ *    library failed it from the start — one of the
  *    STARTER PHOTOS every new site is born with (`DEFAULT_SITE_IMAGES`,
  *    served at `/_static/starter/` by the tenant and the console alike,
  *    credited in the CREDITS file beside them). They are the platform's own
@@ -190,6 +196,14 @@ export declare function aiLayoutSeedNumber(seed: string): number;
  * people; a gallery picture never takes it, even to avoid a repeat.
  */
 export declare function aiLayoutStarterPhotos(slots: readonly AiLayoutPictureSlot[], seed: string): AiLayoutPicturePhoto[];
+/**
+ * A neutral starter for each of a list's records (AGL-3988), where the site
+ * has a library and the job has no photo of its own: the two taken in turn
+ * from the seed, so no record shows the photo of the one beside it. A card
+ * of a listing cannot drop its frame as a page's picture does, so every
+ * record takes one. Pure.
+ */
+export declare function aiLayoutNeutralStarterRun(count: number, seed: string): AiLayoutPicturePhoto[];
 /**
  * A neutral starter for each slot a library could not fill, where the site
  * has a library (AGL-3923): each at most once on a page, the hero served
@@ -198,6 +212,25 @@ export declare function aiLayoutStarterPhotos(slots: readonly AiLayoutPictureSlo
  * none keeps the no-photo treatment.
  */
 export declare function aiLayoutNeutralStarterPhotos(slots: readonly AiLayoutPictureSlot[], seed: string): Array<AiLayoutPicturePhoto | null>;
+/**
+ * The job's own photos for the slots a library could not fill (AGL-3988):
+ * the photos THIS job already placed on this site — on its other pages, on
+ * its datasets' records, and on this page — which were each found for the
+ * site's own world, before any starter. The beta.270 Sugar Hollow
+ * Photography start (2026-10-19) opened a wedding photographer's home page
+ * on the starters' desk and an office team, and filed five wedding galleries
+ * under a workbench, a windowsill and the same office, while the library
+ * had already given the job three wedding and family photos.
+ *
+ * Each slot `need` names takes the one that fits it best: one this page does
+ * not show yet before one it does, a wide photo for a hero, the shape
+ * nearest its frame, and the most words shared with what the slot says it
+ * shows; never the photo of the slot beside it. A product's photo and a
+ * portrait of the business's people are of one named thing, which no other
+ * photo is, so they take none. Among equals the seed picks, so one job
+ * always picks the same. `null` for a slot given none. Pure.
+ */
+export declare function aiLayoutJobPhotoPicks(slots: readonly AiLayoutPictureSlot[], need: readonly boolean[], jobPhotos: readonly AiLayoutPicturePhoto[], placed: ReadonlyArray<AiLayoutPicturePhoto | null | undefined>, seed: string): Array<AiLayoutPicturePhoto | null>;
 /**
  * The page with each slot filled by its photo: the `image` given its source,
  * its intrinsic size and how it loads (the hero eagerly, as the starter home
@@ -232,9 +265,13 @@ export type AiLayoutPictureSource = (slots: readonly AiLayoutPictureSlot[]) => P
 /**
  * Fills a stored page's empty picture slots (AGL-3660): from `source` where
  * one is given and it answers; a slot it answers with nothing fitting stays
- * without a photo and is taken out ({@link aiLayoutDropEmptyPictures}); every
- * other slot takes a starter photo, described by its own words (AGL-3831). Never throws, and never leaves a page worse than it
- * came: a picture is decoration, and a job never fails over one.
+ * without a photo and is taken out ({@link aiLayoutDropEmptyPictures}). A
+ * slot it could not answer — the library down, out of time, or its photo not
+ * copied — takes one of the photos the job already placed on this site
+ * (`jobPhotos`, {@link aiLayoutJobPhotoPicks}, AGL-3988), and only where the
+ * job has none of its own, a starter photo described by its own words
+ * (AGL-3831). Never throws, and never leaves a page worse than it came: a
+ * picture is decoration, and a job never fails over one.
  */
 export declare function aiResolveLayoutPictures(nodes: NodesMap, input: {
     rootId: string;
@@ -243,6 +280,12 @@ export declare function aiResolveLayoutPictures(nodes: NodesMap, input: {
     /** A per-job word, so two sites do not open with the same photo. */
     seed: string;
     source?: AiLayoutPictureSource | null;
+    /**
+     * The photos this job already placed on this site (AGL-3988): its other
+     * pages' and its datasets' records', each found for the site's world.
+     * Taken before any starter where `source` could not fill a slot.
+     */
+    jobPhotos?: readonly AiLayoutPicturePhoto[];
     /** The site's language (AGL-3750); a starter photo's English words are not its own. */
     language?: string;
 }): Promise<NodesMap>;

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

@@ -244,6 +244,26 @@ function rotate(list, by) {
     'hero',
     'desk'
 ];
+/**
+ * A neutral starter for each of a list's records (AGL-3988), where the site
+ * has a library and the job has no photo of its own: the two taken in turn
+ * from the seed, so no record shows the photo of the one beside it. A card
+ * of a listing cannot drop its frame as a page's picture does, so every
+ * record takes one. Pure.
+ */ export function aiLayoutNeutralStarterRun(count, seed) {
+    const pool = rotate(NEUTRAL_STARTERS, aiLayoutSeedNumber(seed));
+    return Array.from({
+        length: Math.max(0, count)
+    }, (_, index)=>{
+        const photo = AI_LAYOUT_STARTER_PHOTOS[pool[index % pool.length]];
+        return {
+            src: photo.src,
+            width: photo.width,
+            height: photo.height,
+            alt: photo.alt
+        };
+    });
+}
 /**
  * A neutral starter for each slot a library could not fill, where the site
  * has a library (AGL-3923): each at most once on a page, the hero served
@@ -275,6 +295,77 @@ function rotate(list, by) {
     });
     return photos;
 }
+/** A text's words a photo's own words may share: lowercase, four letters or more. */ const wordsOf = (text)=>new Set(text.toLowerCase().split(/[^a-zÀ-ɏ]+/).filter((word)=>word.length >= 4));
+/**
+ * The job's own photos for the slots a library could not fill (AGL-3988):
+ * the photos THIS job already placed on this site — on its other pages, on
+ * its datasets' records, and on this page — which were each found for the
+ * site's own world, before any starter. The beta.270 Sugar Hollow
+ * Photography start (2026-10-19) opened a wedding photographer's home page
+ * on the starters' desk and an office team, and filed five wedding galleries
+ * under a workbench, a windowsill and the same office, while the library
+ * had already given the job three wedding and family photos.
+ *
+ * Each slot `need` names takes the one that fits it best: one this page does
+ * not show yet before one it does, a wide photo for a hero, the shape
+ * nearest its frame, and the most words shared with what the slot says it
+ * shows; never the photo of the slot beside it. A product's photo and a
+ * portrait of the business's people are of one named thing, which no other
+ * photo is, so they take none. Among equals the seed picks, so one job
+ * always picks the same. `null` for a slot given none. Pure.
+ */ export function aiLayoutJobPhotoPicks(slots, need, jobPhotos, placed, seed) {
+    const seen = new Set();
+    const pool = jobPhotos.filter((photo)=>{
+        if (!photo.src || !(photo.width > 0) || !(photo.height > 0) || seen.has(photo.src)) return false;
+        seen.add(photo.src);
+        return true;
+    });
+    const picks = slots.map(()=>null);
+    if (!pool.length) return picks;
+    const shown = slots.map((_slot, index)=>{
+        var _placed_index;
+        return ((_placed_index = placed[index]) == null ? void 0 : _placed_index.src) || '';
+    });
+    const order = [
+        'hero',
+        'about',
+        'gallery'
+    ];
+    const served = slots.map((slot, index)=>({
+            slot,
+            index
+        })).filter(({ slot, index })=>need[index] && !slot.product && !slot.people).sort((a, b)=>order.indexOf(a.slot.role) - order.indexOf(b.slot.role) || a.index - b.index);
+    const turn = aiLayoutSeedNumber(seed);
+    for (const { slot, index } of served){
+        const beside = new Set([
+            shown[index - 1],
+            shown[index + 1]
+        ].filter(Boolean));
+        const says = wordsOf(slot.alt);
+        let best = null;
+        for (const [at, photo] of pool.entries()){
+            var _photo_alt;
+            if (beside.has(photo.src)) continue;
+            const aspect = photo.width / photo.height;
+            const uses = shown.filter((src)=>src === photo.src).length;
+            const shared = [
+                ...wordsOf((_photo_alt = photo.alt) != null ? _photo_alt : '')
+            ].filter((word)=>says.has(word)).length;
+            const score = -100 * uses + (slot.role === 'hero' && aspect >= 1.3 ? 20 : 0) - 10 * Math.abs(Math.log(aspect / (slot.aspect > 0 ? slot.aspect : 1))) + 4 * shared;
+            // The seed turns the pool, so equals are taken in a per-job order.
+            const rank = (at - turn % pool.length + pool.length) % pool.length;
+            if (!best || score > best.score || score === best.score && rank < best.rank) best = {
+                photo,
+                score,
+                rank
+            };
+        }
+        if (!best) continue;
+        picks[index] = _extends({}, best.photo);
+        shown[index] = best.photo.src;
+    }
+    return picks;
+}
 /**
  * The page with each slot filled by its photo: the `image` given its source,
  * its intrinsic size and how it loads (the hero eagerly, as the starter home
@@ -290,7 +381,7 @@ function rotate(list, by) {
     const lead = slots.findIndex((_, index)=>Boolean(photos[index] && next[slots[index].imageId]));
     slots.forEach((slot, index)=>{
         var _node_props;
-        var _photo_alt, _photo_alt1;
+        var _photo_alt;
         const photo = photos[index];
         const node = next[slot.imageId];
         if (!photo || !node) return;
@@ -298,14 +389,18 @@ function rotate(list, by) {
         delete props['loading'];
         // A photo placed is described by its words, never hidden from a screen
         // reader: a stand-in was decorative only while it showed nothing (AGL-3856).
-        if ((_photo_alt = photo.alt) == null ? void 0 : _photo_alt.trim()) delete props['decorative'];
+        // One that brings no words of its own, such as an owner's upload with no
+        // alt text, keeps the slot's (AGL-3979): a picture a visitor sees always
+        // has a description.
+        const alt = ((_photo_alt = photo.alt) == null ? void 0 : _photo_alt.trim()) || (typeof props['alt'] === 'string' ? props['alt'].trim() : '');
+        if (alt) delete props['decorative'];
         next[slot.imageId] = _extends({}, node, {
             props: _extends({}, props, {
                 src: photo.src,
                 intrinsicWidth: photo.width,
                 intrinsicHeight: photo.height
-            }, ((_photo_alt1 = photo.alt) == null ? void 0 : _photo_alt1.trim()) ? {
-                alt: photo.alt.trim()
+            }, alt ? {
+                alt
             } : {}, index === lead && slot.role === 'hero' ? {
                 loading: 'eager'
             } : {})
@@ -404,11 +499,16 @@ function rotate(list, by) {
 /**
  * Fills a stored page's empty picture slots (AGL-3660): from `source` where
  * one is given and it answers; a slot it answers with nothing fitting stays
- * without a photo and is taken out ({@link aiLayoutDropEmptyPictures}); every
- * other slot takes a starter photo, described by its own words (AGL-3831). Never throws, and never leaves a page worse than it
- * came: a picture is decoration, and a job never fails over one.
+ * without a photo and is taken out ({@link aiLayoutDropEmptyPictures}). A
+ * slot it could not answer — the library down, out of time, or its photo not
+ * copied — takes one of the photos the job already placed on this site
+ * (`jobPhotos`, {@link aiLayoutJobPhotoPicks}, AGL-3988), and only where the
+ * job has none of its own, a starter photo described by its own words
+ * (AGL-3831). Never throws, and never leaves a page worse than it came: a
+ * picture is decoration, and a job never fails over one.
  */ export async function aiResolveLayoutPictures(nodes, input) {
     try {
+        var _input_jobPhotos;
         const slots = aiLayoutPictureSlots(nodes, input.rootId, {
             ids: input.sectionIds,
             names: input.sectionNames
@@ -419,7 +519,7 @@ function rotate(list, by) {
             try {
                 found = await input.source(slots);
             } catch (error) {
-                console.warn('ai layout pictures: the stock source failed; starter photos fill the page', {
+                console.warn('ai layout pictures: the stock source failed; the job’s own photos or starters fill the page', {
                     error
                 });
                 found = [];
@@ -431,28 +531,51 @@ function rotate(list, by) {
         const said = (photo)=>otherLanguage ? _extends({}, photo, {
                 alt: aiLayoutLabel('illustrativePhoto', input.language)
             }) : photo;
-        // With a library, a starter is only ever a neutral one (AGL-3923): the
-        // beta.267 Brightvale start, whose library refused its copies, showed a
-        // pottery bench and a coffee shop's owner as a marketer's pictures.
-        const starters = (input.source ? aiLayoutNeutralStarterPhotos(slots, input.seed) : aiLayoutStarterPhotos(slots, input.seed)).map((photo)=>photo ? said(photo) : null);
+        /** The slots the source could not answer: no library, or it failed them. */ const unanswered = slots.map((_slot, index)=>!found[index]);
         const photos = slots.map((_slot, index)=>{
-            var _starters_index;
             const answer = found[index];
-            if (answer) return answer.src ? answer : null;
-            return (_starters_index = starters[index]) != null ? _starters_index : null;
+            return (answer == null ? void 0 : answer.src) ? answer : null;
         });
+        // With a library, the job's own photos come before any starter (AGL-3988),
+        // and a starter is only ever a neutral one (AGL-3923): the beta.267
+        // Brightvale start, whose library refused its copies, showed a pottery
+        // bench and a coffee shop's owner as a marketer's pictures.
+        const own = input.source ? ((_input_jobPhotos = input.jobPhotos) != null ? _input_jobPhotos : []).filter((photo)=>photo.src && photo.width > 0 && photo.height > 0) : [];
+        if (own.length) {
+            aiLayoutJobPhotoPicks(slots, unanswered, own, photos, input.seed).forEach((pick, index)=>{
+                if (pick && unanswered[index]) photos[index] = pick;
+            });
+        } else {
+            const starters = input.source ? aiLayoutNeutralStarterPhotos(slots, input.seed) : aiLayoutStarterPhotos(slots, input.seed);
+            starters.forEach((photo, index)=>{
+                if (photo && unanswered[index]) photos[index] = said(photo);
+            });
+        }
         // The page floor (AGL-3923; Zach, 2026-10-12: a starter photo before no
         // photo at all): a page the library answered that would show no picture
-        // keeps one neutral starter, in its hero, else its first slot.
+        // keeps one, in its hero, else its first slot: one of the job's own
+        // photos where it has any (AGL-3988), else a neutral starter.
         if (input.source && !photos.some((photo)=>photo == null ? void 0 : photo.src)) {
             const at = Math.max(0, slots.findIndex((slot)=>slot.role === 'hero'));
+            const lead = _extends({}, slots[at], {
+                product: undefined,
+                people: undefined
+            });
+            const [pick] = aiLayoutJobPhotoPicks([
+                lead
+            ], [
+                true
+            ], own, [
+                null
+            ], input.seed);
             const [floor] = rotate(NEUTRAL_STARTERS, aiLayoutSeedNumber(input.seed));
-            const photo = floor ? AI_LAYOUT_STARTER_PHOTOS[floor] : null;
-            if (photo) photos[at] = said({
-                src: photo.src,
-                width: photo.width,
-                height: photo.height,
-                alt: photo.alt
+            const starter = floor ? AI_LAYOUT_STARTER_PHOTOS[floor] : null;
+            if (pick) photos[at] = pick;
+            else if (starter) photos[at] = said({
+                src: starter.src,
+                width: starter.width,
+                height: starter.height,
+                alt: starter.alt
             });
         }
         return aiLayoutDropEmptyPictures(aiLayoutPlacePictures(nodes, slots, photos), slots, photos, input.sectionIds);