@aglyn/plugins-ai 1.0.0-beta.247 → 1.0.0-beta.250

package/src/lib/jobs/ai-layout-stock-photos.d.ts

@@ -415,6 +415,12 @@ export interface AiLayoutStockPhotoSourceInput {
      * language is searched by, in place of its business type and its alt texts.
      */
     photoWords?: string;
+    /**
+     * The English name of the kind of site the person picked (AGL-3771): what a
+     * site in another language whose plan gave no photo words is searched by,
+     * rather than its business type in its own language.
+     */
+    kindWords?: string;
     /** The page's section names, by plan index. */
     sectionNames: readonly string[];
     /**
@@ -433,10 +439,34 @@ export interface AiLayoutStockPhotoDeps {
     ingest?: () => PluginMediaIngest | null;
     budgetMs?: number;
 }
-/** A job's language and English photo words (AGL-3760), as a stock photo source takes them. */
+/**
+ * A job's language and English photo words (AGL-3760), and the English name
+ * of its kind of site (AGL-3771), as a stock photo source takes them.
+ */
 export declare function aiStockPhotoWordsOf(job: {
     plan?: Pick<AiBuildPlan, 'language' | 'photoWords'> | null;
-}): Pick<AiLayoutStockPhotoSourceInput, 'language' | 'photoWords'>;
+    inputs?: Readonly<Record<string, unknown>> | null;
+}): Pick<AiLayoutStockPhotoSourceInput, 'language' | 'photoWords' | 'kindWords'>;
+/**
+ * The subject a plan's photo words lead with (AGL-3769): its first word that
+ * is not filler, with the place or person words that follow it — "bakery" of
+ * "bakery pan dulce conchas", "candle shop" of "candle shop soy candles",
+ * "ceramic artist" of "ceramic artist stoneware bowls". The words are subject
+ * first, never an English noun phrase with its head last, and what follows
+ * the subject may be the brief's own names in English letters: Panaderia La
+ * Espiga Dorada's "pan dulce conchas" read as the business, made "concha" its
+ * craft, and placed purple ceanothus flowers, tagged "ceanothus concha", as
+ * its hero. Empty when every word is filler.
+ */
+export declare function aiStockPhotoWordsSubject(photoWords: string): string;
+/**
+ * What a source's photos are searched and judged by (AGL-3760, AGL-3769): a
+ * site in another language by the subject of its plan's English photo words,
+ * every other site by its business type. One reading for every slot of every
+ * source — hero, background, gallery, card, product, post — so no slot
+ * searches by words another slot is held against.
+ */
+export declare function aiStockSourceTerms(input: Pick<AiLayoutStockPhotoSourceInput, 'business' | 'language' | 'photoWords' | 'kindWords'>): AiStockSiteTerms;
 /**
  * The source for one page, or `null` when this deployment has no stock
  * photo library or no media door, which leaves every slot to the starters.

package/src/lib/jobs/ai-layout-stock-photos.js

@@ -19,6 +19,7 @@ import { STOCK_PHOTO_QUERY_MAX_CHARS, stockPhotoProvider, stockPhotoSourceKey }
 import { aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
 import { aiStorefrontSays } from "../layout-language/ai-layout-storefront.js";
 import { aiLayoutSpeaksOtherThanEnglish } from "../layout-language/ai-layout-labels.js";
+import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
  *
@@ -1769,19 +1770,65 @@ const EXTENSIONS = {
     'image/png': 'png',
     'image/webp': 'webp'
 };
-/** A job's language and English photo words (AGL-3760), as a stock photo source takes them. */ export function aiStockPhotoWordsOf(job) {
+/**
+ * A job's language and English photo words (AGL-3760), and the English name
+ * of its kind of site (AGL-3771), as a stock photo source takes them.
+ */ export function aiStockPhotoWordsOf(job) {
     const plan = job.plan;
+    const kind = job.inputs ? aiSiteKindOfInputs(job.inputs) : null;
+    // "Restaurant & café" searches as "restaurant cafe".
+    const kindWords = kind ? kind.label.normalize('NFD').replace(/[\u0300-\u036f]/g, '').replace(/&/g, ' ').replace(/\s+/g, ' ').trim().toLowerCase() : '';
     return _extends({}, (plan == null ? void 0 : plan.language) ? {
         language: plan.language
     } : {}, (plan == null ? void 0 : plan.photoWords) ? {
         photoWords: plan.photoWords
+    } : {}, kindWords ? {
+        kindWords
     } : {});
 }
+/**
+ * The subject a plan's photo words lead with (AGL-3769): its first word that
+ * is not filler, with the place or person words that follow it — "bakery" of
+ * "bakery pan dulce conchas", "candle shop" of "candle shop soy candles",
+ * "ceramic artist" of "ceramic artist stoneware bowls". The words are subject
+ * first, never an English noun phrase with its head last, and what follows
+ * the subject may be the brief's own names in English letters: Panaderia La
+ * Espiga Dorada's "pan dulce conchas" read as the business, made "concha" its
+ * craft, and placed purple ceanothus flowers, tagged "ceanothus concha", as
+ * its hero. Empty when every word is filler.
+ */ export function aiStockPhotoWordsSubject(photoWords) {
+    const list = contentWords(photoWords);
+    const start = list.findIndex((word)=>!FILLER.has(word) && !SITE_KINDS.has(word));
+    if (start < 0) return '';
+    let end = start + 1;
+    while(end < list.length && (VENUES.has(list[end]) || ROLES.has(list[end])))end += 1;
+    return list.slice(start, end).join(' ');
+}
+/**
+ * What a source's photos are searched and judged by (AGL-3760, AGL-3769): a
+ * site in another language by the subject of its plan's English photo words,
+ * every other site by its business type. One reading for every slot of every
+ * source — hero, background, gallery, card, product, post — so no slot
+ * searches by words another slot is held against.
+ */ export function aiStockSourceTerms(input) {
+    return aiStockSiteTerms(aiStockSourceSubject(input) || input.business);
+}
+/**
+ * What a site in another language is searched by ({@link aiStockSourceTerms}):
+ * its photo words' subject, else, where its plan gave none, the English name
+ * of its kind of site (AGL-3771) — Panaderia El Trigal's plan gave no photo
+ * words, and its pages searched "con pan dulce" again and placed the Río
+ * Dulce beside its story. Empty for every other site.
+ */ function aiStockSourceSubject(input) {
+    var _input_photoWords, _input_kindWords;
+    if (!aiLayoutSpeaksOtherThanEnglish(input.language)) return '';
+    return aiStockPhotoWordsSubject((_input_photoWords = input.photoWords) != null ? _input_photoWords : '') || ((_input_kindWords = input.kindWords) != null ? _input_kindWords : '').trim();
+}
 /**
  * The source for one page, or `null` when this deployment has no stock
  * photo library or no media door, which leaves every slot to the starters.
  */ export function aiLayoutStockPhotoSource(input, deps = {}) {
-    var _deps_provider, _deps_ingest, _input_photoWords;
+    var _deps_provider, _deps_ingest;
     const provider = ((_deps_provider = deps.provider) != null ? _deps_provider : stockPhotoProvider)();
     const ingest = ((_deps_ingest = deps.ingest) != null ? _deps_ingest : pluginMediaIngest)();
     if (!provider || !ingest || !input.hostId || !input.uid) return null;
@@ -1789,10 +1836,10 @@ const EXTENSIONS = {
     // "Una panadería familiar de San Antonio con pan dulce…", read as the
     // business "con pan dulce", and its hero searched that and placed the Río
     // Dulce at dusk; a site in another language is searched by its plan's
-    // English photo words, and its slots' alt texts, in its own language, name
-    // no subject a search could use.
-    const english = aiLayoutSpeaksOtherThanEnglish(input.language) ? ((_input_photoWords = input.photoWords) != null ? _input_photoWords : '').trim() : '';
-    const terms = aiStockSiteTerms(english || input.business);
+    // English photo words' subject ({@link aiStockSourceTerms}), and its slots'
+    // alt texts, in its own language, name no subject a search could use.
+    const english = aiStockSourceSubject(input);
+    const terms = aiStockSourceTerms(input);
     return async (slots)=>{
         var _deps_budgetMs, _input_avoid;
         const timeout = AbortSignal.timeout((_deps_budgetMs = deps.budgetMs) != null ? _deps_budgetMs : AI_LAYOUT_STOCK_PHOTOS_BUDGET_MS);