@aglyn/plugins-ai 1.0.0-beta.246 → 1.0.0-beta.249

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

@@ -18,6 +18,7 @@ import { type PluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media
 import { type StockPhoto, type StockPhotoOrientation, type StockPhotoProvider, type StockPhotoSearchRequest } from '@aglyn/aglyn/plugin-manager/stock-photo-provider';
 import type { NodesMap } from '@aglyn/aglyn/types/nodes';
 import { type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-language/ai-layout-pictures';
+import type { AiBuildPlan } from '../model/ai-build-plan';
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
  *
@@ -241,6 +242,13 @@ export interface AiStockSearch extends StockPhotoSearchRequest {
     lead?: boolean;
     /** Whether the hit's first tags must name the site's world, where the object need not lead (AGL-3660). */
     leadWorld?: boolean;
+    /**
+     * Whether the hit's FIRST tag must name the site's world (AGL-3760): what
+     * the photo is of, most of all. A hero is the site's opening picture; the
+     * copper-fern-candle-co start (beta.246) took a latte with a candle behind
+     * it, its tags "coffee, mobile wallpaper 4k, latte art, …, candle".
+     */
+    first?: boolean;
     /** Phrases (as stems) of which one must be among the hit's first tags: a borrowed photo is OF the product's category (AGL-3660). */
     leadAny?: readonly string[];
     /** Whether it fills a product: no room, no scene, no fragrance bottle ({@link PRODUCT_SCENES}, AGL-3660). */
@@ -342,6 +350,8 @@ export interface AiStockJudgement {
     lead?: boolean;
     /** Whether the hit's first tags must name the site's world ({@link AiStockSearch.leadWorld}). */
     leadWorld?: boolean;
+    /** Whether the hit's first tag must name the site's world ({@link AiStockSearch.first}). */
+    first?: boolean;
     /** The stems of the site's business type or brief, which let a sensitive topic in ({@link AiStockSiteTerms.named}). */
     named?: readonly string[];
     /** Rival crafts: a hit naming one is rejected unless it names the site's core words ({@link AiStockSiteTerms.rivals}). */
@@ -398,6 +408,13 @@ export interface AiLayoutStockPhotoSourceInput {
     seed: string;
     /** The site's business type, else the job's brief. */
     business: string;
+    /** The site's language, from its plan (AGL-3750); absent, English. */
+    language?: string;
+    /**
+     * The plan's photo words, in English (AGL-3760): what a site in another
+     * language is searched by, in place of its business type and its alt texts.
+     */
+    photoWords?: string;
     /** The page's section names, by plan index. */
     sectionNames: readonly string[];
     /**
@@ -416,6 +433,30 @@ 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. */
+export declare function aiStockPhotoWordsOf(job: {
+    plan?: Pick<AiBuildPlan, 'language' | 'photoWords'> | null;
+}): Pick<AiLayoutStockPhotoSourceInput, 'language' | 'photoWords'>;
+/**
+ * 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'>): 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

@@ -18,6 +18,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { STOCK_PHOTO_QUERY_MAX_CHARS, stockPhotoProvider, stockPhotoSourceKey } from "@aglyn/aglyn/plugin-manager/stock-photo-provider";
 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";
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
  *
@@ -1525,6 +1526,8 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
             ]
         } : {}) : {}, slot.role === 'hero' && core.length ? {
             category: core
+        } : {}, slot.role === 'hero' ? {
+            first: true
         } : {}));
     }
     return searches;
@@ -1650,6 +1653,20 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     const world = demanded || kinNamed || domain.some((stem)=>hit.all.has(stem));
     const worldLead = (anyOf.length ? anyOf.some((stem)=>hit.lead.has(stem)) : required.length > 0 && required.every((stem)=>hit.lead.has(stem))) || kinLead || domain.some((stem)=>hit.lead.has(stem));
     if (judgement.leadWorld && !worldLead) return 0;
+    // The first tag alone, never the page's address: Pixabay's slug repeats a
+    // late tag ("coffee-latte-art-candle-…"). A site whose words name no world
+    // holds its hero to none.
+    const worldStems = new Set([
+        ...anyOf,
+        ...required,
+        ...domain
+    ]);
+    if (judgement.first && (worldStems.size || kin.length)) {
+        const firstWorld = hit.firstPhrase.split(' ').some((stem)=>worldStems.has(stem)) || kin.some((phrase)=>among([
+                hit.firstPhrase
+            ], phrase));
+        if (!firstWorld) return 0;
+    }
     // What the photo is most of all: its first tag names the object, its kin or what it must be OF.
     const firstNamed = (phrases)=>phrases.some((phrase)=>Boolean(phrase) && among([
                 hit.firstPhrase
@@ -1752,6 +1769,45 @@ 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) {
+    const plan = job.plan;
+    return _extends({}, (plan == null ? void 0 : plan.language) ? {
+        language: plan.language
+    } : {}, (plan == null ? void 0 : plan.photoWords) ? {
+        photoWords: plan.photoWords
+    } : {});
+}
+/**
+ * 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);
+}
+/** The photo words' subject a site in another language is searched by ({@link aiStockSourceTerms}); empty for every other site. */ function aiStockSourceSubject(input) {
+    var _input_photoWords;
+    return aiLayoutSpeaksOtherThanEnglish(input.language) ? aiStockPhotoWordsSubject((_input_photoWords = input.photoWords) != null ? _input_photoWords : '') : '';
+}
 /**
  * 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.
@@ -1760,7 +1816,14 @@ const EXTENSIONS = {
     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;
-    const terms = aiStockSiteTerms(input.business);
+    // The libraries are tagged in English (AGL-3760). A Spanish bakery's type,
+    // "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' 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);
@@ -1792,6 +1855,7 @@ const EXTENSIONS = {
             delete request.kin;
             delete request.lead;
             delete request.leadWorld;
+            delete request.first;
             delete request.category;
             const key = JSON.stringify([
                 request.query,
@@ -1917,6 +1981,8 @@ const EXTENSIONS = {
                 lead: true
             } : {}, request.leadWorld ? {
                 leadWorld: true
+            } : {}, request.first ? {
+                first: true
             } : {});
         };
         /**
@@ -1939,7 +2005,9 @@ const EXTENSIONS = {
                 }, size, {
                     broad: true,
                     category: terms.core
-                }, slot.product ? {
+                }, slot.role === 'hero' ? {
+                    first: true
+                } : {}, slot.product ? {
                     product: true,
                     tier: 'weak'
                 } : {}));
@@ -1954,7 +2022,7 @@ const EXTENSIONS = {
                 continue;
             }
             const sectionName = (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '';
-            const subject = aiStockSubjectWords(slot.alt, sectionName);
+            const subject = english ? '' : aiStockSubjectWords(slot.alt, sectionName);
             let choice = null;
             const requests = [
                 ...slot.product ? aiStockProductSearches(slot, terms.craft, terms.domain, {