@aglyn/plugins-ai 1.0.0-beta.260 → 1.0.0-beta.262

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

@@ -117,6 +117,19 @@ import type { AiBuildPlan } from '../model/ai-build-plan';
  *    its own. No product shows a room or a scene, a fragrance bottle, or what
  *    its kin shuns (a pump for a bar) unless it names it; "bath" in a bath
  *    gift set is what the set is for; a size is never the product.
+ * 8. **What the photo is OF** (the beta.259 starts, AGL-3856: a typewriter
+ *    printing "terms of service" as a family law firm's hero, a yoga pose on
+ *    a beach and a heart-shaped potato as a strength gym's events, a horse's
+ *    head of a "western film" as a photographer's "Film" card). A listed
+ *    craft may name what its photos are never OF among their first tags
+ *    (`shunLead`: a document for a law practice, yoga for a strength gym) and
+ *    its rival worlds (a movie's for a photographer's film); a comma after a
+ *    place goes on naming the place ("Columbus, Ohio"), never the world; an
+ *    event's or a lesson's word ("basics", "class", "session") is never its
+ *    object; a word the table does not list beside a craft it does
+ *    ("wedding" of "a wedding and portrait photographer") is not the craft;
+ *    and a hero whose second tag names the world too leads one whose first
+ *    alone does.
  *
  * A slot the library could not fill because it never answered — down, or
  * out of time before its first answer — or because the site's library
@@ -203,6 +216,8 @@ export interface AiStockSiteTerms {
     core: string[];
     /** Words no photo of the site's craft carries unless the slot or the brief names them ({@link CRAFT_KIN}). */
     shun: string[];
+    /** Words no photo of the site's craft is OF, among its first tags, unless the slot or the brief names them ({@link CRAFT_KIN}). */
+    shunLead: string[];
 }
 /** The site's terms, read from its business type. */
 export declare function aiStockSiteTerms(businessType: string): AiStockSiteTerms;
@@ -370,6 +385,8 @@ export interface AiStockJudgement {
     product?: boolean;
     /** Words a hit never carries unless the subject or the brief names them ({@link AiStockSiteTerms.shun}). */
     shun?: readonly string[];
+    /** Words a hit's first tags never carry unless the subject or the brief names them ({@link AiStockSiteTerms.shunLead}). */
+    shunLead?: readonly string[];
 }
 /**
  * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):
@@ -406,7 +423,15 @@ export declare function aiStockPlacedSrcs(nodes: NodesMap | null | undefined): s
 /** Forgets every job's placed photos; for specs. */
 export declare function aiStockForgetJobPhotos(): void;
 /**
- * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805).
+ * A photo described from its own tags (AGL-3856): its first few that name a
+ * thing, a phrase another one holds dropped ("wedding" beside "wedding
+ * dress"), as an English phrase — "A wedding dress and a bride", "A hammer,
+ * books and law" — never the comma-separated list the library keeps. `null`
+ * where none names a thing.
+ */
+export declare function aiStockTagsAlt(tags: readonly string[], proper?: ReadonlySet<string>): string | null;
+/**
+ * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805, AGL-3856).
  *
  * A slot's alt text is the model's, written for the picture the page asked
  * for before any photo was found, and a slot is filled by whatever the
@@ -420,21 +445,28 @@ export declare function aiStockForgetJobPhotos(): void;
  * dulce", a plate of macarons the shop's display case.
  *
  * So the photo placed answers for its own words. `null` keeps the slot's: on
- * an English site whose words name what the photo is OF — a word of their
- * subject (`aiStockSubjectWords`: the noun phrase they open with, before any
- * setting) among the hit's first tags or its page's address, so "conchas on
- * a tray at the bakery counter" is never kept for a loaf tagged "bakery".
- * Otherwise the photo is described by the
+ * an English site whose words name the thing the photo is OF — their
+ * subject's object (`aiStockSubjectWords`, a trailing "speaking calmly"
+ * dropped) among the hit's first two tags. Any word of the subject among its
+ * first three was not enough: the beta.259 Hartwell Reyes Family Law hero kept
+ * "Two attorneys speaking calmly with a client in a bright Columbus office"
+ * for a typewriter whose third tag was "attorney" (AGL-3856). A stand-in's
+ * words ({@link AiLayoutPictureSlot.standIn}) are a search's, never a
+ * description, and are never kept. Otherwise the photo is described by the
  * library's own words: its description where it writes one (a Pexels hit's
- * `alt`), else its first tags, the things it shows. The libraries write in
- * English, and no model translates them, so a site in another language takes
- * the platform's own words for an illustrative photo in its language
- * (`aiLayoutLabel`), true of any photo, as does a hit with no words at all.
+ * `alt`), else its first tags as an English phrase ({@link aiStockTagsAlt}),
+ * never the library's tag list. The libraries write in English, and no model
+ * translates them, so a site in another language takes the platform's own
+ * words for an illustrative photo in its language (`aiLayoutLabel`), true of
+ * any photo, as does a hit whose words name no thing.
  */
-export declare function aiStockPhotoAlt(photo: Pick<StockPhoto, 'tags' | 'alt' | 'pageUrl'>, slot: Pick<AiLayoutPictureSlot, 'alt' | 'product'>, input?: {
+export declare function aiStockPhotoAlt(photo: Pick<StockPhoto, 'tags' | 'alt' | 'pageUrl'>, slot: Pick<AiLayoutPictureSlot, 'alt' | 'product' | 'standIn'>, input?: {
     language?: string;
     sectionName?: string;
+    proper?: ReadonlySet<string>;
 }): string | null;
+/** The names a business type writes with a capital, lowercased: "columbus", "ohio" (AGL-3856). */
+export declare function aiStockProperWords(businessType: string): Set<string>;
 export interface AiLayoutStockPhotoSourceInput {
     hostId: string;
     /** The member the photos are stored as: the job's creator. */

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

@@ -119,6 +119,19 @@ import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
  *    its own. No product shows a room or a scene, a fragrance bottle, or what
  *    its kin shuns (a pump for a bar) unless it names it; "bath" in a bath
  *    gift set is what the set is for; a size is never the product.
+ * 8. **What the photo is OF** (the beta.259 starts, AGL-3856: a typewriter
+ *    printing "terms of service" as a family law firm's hero, a yoga pose on
+ *    a beach and a heart-shaped potato as a strength gym's events, a horse's
+ *    head of a "western film" as a photographer's "Film" card). A listed
+ *    craft may name what its photos are never OF among their first tags
+ *    (`shunLead`: a document for a law practice, yoga for a strength gym) and
+ *    its rival worlds (a movie's for a photographer's film); a comma after a
+ *    place goes on naming the place ("Columbus, Ohio"), never the world; an
+ *    event's or a lesson's word ("basics", "class", "session") is never its
+ *    object; a word the table does not list beside a craft it does
+ *    ("wedding" of "a wedding and portrait photographer") is not the craft;
+ *    and a hero whose second tag names the world too leads one whose first
+ *    alone does.
  *
  * A slot the library could not fill because it never answered — down, or
  * out of time before its first answer — or because the site's library
@@ -155,13 +168,15 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
 /** The nouns that name a place of business, not its craft: "studio" in "ceramics studio". */ const VENUES = words('studio studios shop shops store stores boutique company co workshop gallery atelier agency brand practice ' + 'salon house collective lab market services service firm clinic center centre parlor parlour bar ' + 'class classes lessons school academy');
 /** The person who does the craft, not the craft: "artist" in "ceramic artist". */ const ROLES = words('artist artists maker makers artisan artisans owner owners founder founders creator creators');
 /** Words naming what kind of SITE it is, never what it shows: "portfolio" in "a portfolio for a ceramic artist". */ const SITE_KINDS = words('portfolio portfolios website websites site sites blog blogs online web webshop ecommerce e-commerce ' + 'landing personal homepage storefront');
-/** Verbs a business type uses to say what it does; what follows them is its domain, never its business. */ const DOING = /(?<![\w-])(?:makes?|making|made|sells?|selling|sold|offers?|offering|creates?|creating|specializ(?:es|ing)|specialis(?:es|ing)|provides?|providing|featuring|showcasing)(?![\w-])/g;
+/** Verbs a business type uses to say what it does; what follows them is its domain, never its business. */ const DOING = /(?<![\w-])(?:makes?|making|made|sells?|selling|sold|offers?|offering|creates?|creating|specializ(?:es|ing)|specialis(?:es|ing)|provides?|providing|featuring|showcasing|shoots?|shooting)(?![\w-])/g;
 /** Where a business type's own clause ends. */ const BUSINESS_BREAK = /[,;:.()]|\s[-–—]\s|\b(?:in|for|near|serving|based|located|that|which|who|with|from|since|and|&)\b/;
 /** A clause after one of these says where or for whom, never what: "in Austin", "for busy parents". */ const PLACE_OR_AUDIENCE = /^(?:in|near|serving|based|located|across|around|throughout|for)$/;
 /**
  * Words naming a set or a wrapper of a thing, never the thing: the OBJECT
  * of "nesting bowl set" is the bowl, of "candle gift set" the candle.
- */ const WRAPPERS = words('set sets kit kits gift gifts bundle bundles pack packs box boxes trio duo pair collection sampler assortment ' + 'series range line group lot bunch');
+ */ const WRAPPERS = words('set sets kit kits gift gifts bundle bundles pack packs box boxes trio duo pair collection sampler assortment ' + 'series range line group lot bunch ' + // What an event or a lesson is, never what it shows (AGL-3856): "Intro to
+// barbell basics" is of a barbell, "Small-group strength class" of strength.
+'class classes session sessions lesson lessons course courses workshop workshops seminar seminars ' + 'meetup meetups program programs programme programmes basics intro introduction fundamentals');
 /**
  * A hit tagged with any of these is never placed: a mockup's blank panel is
  * an empty frame on the page (the Juniper Clay hero), a template or a
@@ -1076,6 +1091,186 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         making: [
             'leather crafting'
         ]
+    },
+    {
+        // A law practice is its people and its office: never a document, a
+        // statute or a statue of justice (the beta.259 Hartwell Reyes hero).
+        match: [
+            'law',
+            'legal',
+            'lawyer',
+            'attorney',
+            'solicitor',
+            'barrister',
+            'paralegal',
+            'notary'
+        ],
+        kin: [
+            'law',
+            'legal',
+            'lawyer',
+            'attorney',
+            'counsel',
+            'office',
+            'client',
+            'consultation',
+            'meeting',
+            'advice',
+            'mediation'
+        ],
+        broad: [
+            'lawyer office',
+            'lawyer client meeting'
+        ],
+        making: [
+            'lawyer meeting client',
+            'lawyer office'
+        ],
+        // Policing is not a family firm's; a statue of justice is a symbol, not its people.
+        shun: [
+            'police',
+            'policeman',
+            'cop',
+            'handcuffs',
+            'prisoner',
+            'arrest',
+            'crime',
+            'criminal',
+            'justitia',
+            'themis',
+            'goddess'
+        ],
+        shunLead: [
+            'term',
+            'condition',
+            'paragraph',
+            'codex',
+            'regulation',
+            'statute',
+            'document',
+            'contract',
+            'typewriter',
+            'constitution',
+            'certificate'
+        ]
+    },
+    {
+        // A strength gym's photos are of lifting and training; a yoga pose on a
+        // beach is tagged "strength" too (the beta.259 Ironline Strength Studio
+        // events).
+        match: [
+            'gym',
+            'fitness',
+            'strength',
+            'barbell',
+            'crossfit',
+            'weightlifting',
+            'powerlifting',
+            'bodybuilding',
+            'kettlebell'
+        ],
+        kin: [
+            'gym',
+            'fitness',
+            'workout',
+            'training',
+            'exercise',
+            'barbell',
+            'dumbbell',
+            'weight',
+            'weightlifting',
+            'deadlift',
+            'squat',
+            'kettlebell',
+            'athlete',
+            'strength',
+            'muscle'
+        ],
+        broad: [
+            'gym',
+            'weight training'
+        ],
+        making: [
+            'coach training athlete',
+            'barbell training'
+        ],
+        shunLead: [
+            'yoga',
+            'pilates',
+            'meditation',
+            'ballet',
+            'ballerina',
+            'dance',
+            'dancer',
+            'karate',
+            'kickboxing',
+            'boxing',
+            'boxer',
+            'beach',
+            'circus',
+            // Another sport's ball, never "medicine ball": a basketball court covered a deadlift night (AGL-3864).
+            'basketball',
+            'football',
+            'soccer',
+            'baseball',
+            'volleyball',
+            'tennis',
+            'golf',
+            'rugby',
+            'hockey'
+        ]
+    },
+    {
+        // A photographer's own photos are of a camera or a shoot; "film" is a
+        // movie's word too, and "western film" a horse (the beta.259 Juniper and
+        // Rye Photography "Film" card).
+        match: [
+            'photographer',
+            'photography',
+            'photo',
+            'photograph'
+        ],
+        kin: [
+            'photographer',
+            'photography',
+            'photo',
+            'photograph',
+            'photoshoot',
+            'camera',
+            'lens'
+        ],
+        broad: [
+            'photographer camera',
+            'photography'
+        ],
+        making: [
+            'photographer at work',
+            'photographer camera'
+        ],
+        rivals: {
+            words: [
+                'movie',
+                'cinema',
+                'cinematography',
+                'filmmaking',
+                'filming',
+                'videography',
+                'video',
+                'actor',
+                'projector',
+                'hollywood',
+                'western'
+            ],
+            core: [
+                'camera',
+                'photograph',
+                'photography',
+                'photographer',
+                'photo',
+                'photoshoot',
+                'analog'
+            ]
+        }
     }
 ];
 /** Lowercase words, letters only, without stopwords. */ function contentWords(text) {
@@ -1150,13 +1345,20 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
     /** The last word of the first clause that names the world: "soap" of "for handmade cold-process soap". */ let firstWorld = '';
     let named = false;
     let making = false;
+    let place = false;
     for (const { opener, words: clause } of businessClauses(businessType)){
         if (opener === '|') making = true;
         // Where it is, and who it is for, are not its world — once something has named it.
         if (named && PLACE_OR_AUDIENCE.test(opener)) {
             making = false;
+            place = true;
             continue;
         }
+        // A comma goes on naming the place (AGL-3856): "Ohio" of "in Columbus,
+        // Ohio" and "North Carolina" of "in Asheville, North Carolina" are not
+        // the business's world.
+        if (place && opener === ',') continue;
+        place = false;
         const kept = businessOf(clause).filter((word)=>!VENUES.has(word) && !ROLES.has(word));
         if (kept.length) named = true;
         // What it makes names its world by what the things are made of, never
@@ -1183,6 +1385,12 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
             ...made
         ][0] || '';
         if (craft && !stemList(business).includes(craft)) business = `${craft} ${business}`.trim();
+    } else if (groups[0] && !groups.some((group)=>group.match.some((word)=>aiStockStem(word) === craft))) {
+        var _groups__match_map_find;
+        // A word the table does not list, beside a craft it does, says what kind
+        // of that craft it is (AGL-3856): "wedding" of "a wedding and portrait
+        // photographer" is a photographer's subject, never a craft to search by.
+        craft = (_groups__match_map_find = groups[0].match.map(aiStockStem).find((stem)=>domain.has(stem) || made.has(stem))) != null ? _groups__match_map_find : craft;
     }
     if (craft) domain.add(craft);
     const broad = [];
@@ -1192,9 +1400,11 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         craft
     ] : []);
     const shun = new Set();
+    const shunLead = new Set();
     for (const group of groups){
-        var _group_shun;
+        var _group_shun, _group_shunLead;
         for (const word of (_group_shun = group.shun) != null ? _group_shun : [])shun.add(aiStockStem(word));
+        for (const word of (_group_shunLead = group.shunLead) != null ? _group_shunLead : [])shunLead.add(aiStockStem(word));
         for (const word of group.match)core.add(aiStockStem(word));
         for (const word of group.kin)domain.add(aiStockStem(word));
         broad.push(...group.broad);
@@ -1226,6 +1436,9 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         ],
         shun: [
             ...shun
+        ],
+        shunLead: [
+            ...shunLead
         ]
     };
 }
@@ -1683,7 +1896,7 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
  * the subject's two-word phrase 3, each of its other words 1, and the
  * site's world 1, plus a quarter when it is among the first tags.
  */ export function aiStockRelevance(photo, judgement) {
-    var _judgement_rivals, _judgement_subject, _judgement_named, _judgement_shun, _judgement_leadAny, _judgement_kin, _judgement_requires, _judgement_category, _judgement_object, _judgement_domain;
+    var _judgement_rivals, _judgement_subject, _judgement_named, _judgement_shun, _judgement_shunLead, _judgement_leadAny, _judgement_kin, _judgement_requires, _judgement_category, _judgement_object, _judgement_domain;
     const hit = hitWords(photo);
     if (hit.rejected) return 0;
     if (aiStockSensitive(photo, judgement.named)) return 0;
@@ -1697,6 +1910,8 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     ]);
     // A dispenser is not a soapmaker's, nor a pump a bar's (AGL-3660).
     if (((_judgement_shun = judgement.shun) != null ? _judgement_shun : []).some((word)=>hit.all.has(word) && !owned.has(word))) return 0;
+    // What the photo is OF: a typewriter's terms of service are not a law firm's.
+    if (((_judgement_shunLead = judgement.shunLead) != null ? _judgement_shunLead : []).some((word)=>hit.lead.has(word) && !owned.has(word))) return 0;
     if (judgement.product) {
         // A sauna, a bathroom shelf: a room is never the product.
         for (const word of hit.lead)if (PRODUCT_SCENES.has(word) && !owned.has(word)) return 0;
@@ -1773,6 +1988,13 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     if (phrased) score += 3;
     for (const word of new Set(subject))if (word !== object && hit.all.has(word)) score += 1;
     if (world) score += worldLead ? 1.25 : 1;
+    // A hero is most of all what its first tags say: "law office, lawyer,
+    // attorney" over "lawyers, personal injury, accident" (AGL-3856): a second
+    // of them naming its world says it is of that world, not of something else.
+    if (judgement.first && worldStems.size) {
+        const said = hit.leadPhrases.slice(0, -1).filter((phrase)=>phrase.split(' ').some((stem)=>worldStems.has(stem)));
+        if (said.length >= 2) score += 0.25;
+    }
     return Math.max(score, 0.5);
 }
 /**
@@ -1845,7 +2067,71 @@ function jobPhotos(key) {
 }
 /** The longest description of a photo written from the library's own words. */ const AI_STOCK_ALT_MAX = 160;
 /**
- * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805).
+ * Words a tag uses for how a photo looks or feels, never a thing it shows
+ * (AGL-3856): "extravagant" of "wedding dress, bride, extravagant".
+ */ const DESCRIBING = words('love romance romantic luxury luxurious fancy extravagant happiness happy beauty emotion emotions mood lifestyle ' + 'concept aesthetic wallpaper background retro vintage antique old young cute sexy fun funny sad positive healthy fit ' + 'strong powerful homemade tasty yummy sweet sweetness nice dark bw monochrome macro sporty active married bridal ' + 'female male');
+/** What a tag names that takes no article: "law" of "hammer, books, law". */ const MASS_NOUNS = words('food coffee tea bread wood water law fitness wax soap clay nature money fabric yarn wool furniture jewelry jewellery ' + 'pottery glass paper music art sport health business meat grass snow sand gold silver leather cotton hair makeup ' + 'skincare justice equipment technology work architecture decor fashion wildlife marriage photography exercise ' + 'scenery weather traffic education advocacy wine beer chocolate rice sugar flour milk cheese honey oil ice fire ' + 'light sunlight dough sourdough pastry dessert strength crossfit people');
+/** Words ending in "-ing" that are things, and take an article: "a wedding", "a ring". */ const COUNTED_ING = words('wedding ring earring building painting drawing ceiling string swing king sibling wing');
+/**
+ * A tag as a phrase of an English description (AGL-3856): "a wedding dress",
+ * "an attorney", "books", "law", "Columbus"; `null` for a tag that names no
+ * thing ("extravagant", "beautiful") or is too long to be one.
+ */ function describedTag(tag, proper) {
+    const describing = (word)=>FILLER.has(word) || DESCRIBING.has(word) || /(?:ous|ful)$/.test(word) || word.length > 4 && /[^e]ed$/.test(word);
+    const all = tag.toLowerCase().replace(/[^a-zÀ-ɏ\s'-]/g, ' ').split(/\s+/).filter(Boolean);
+    // "Beautiful flowers" shows flowers; "roasted" shows nothing.
+    const list = all.filter((word)=>!describing(word));
+    if (!list.length || all.length > 3) return null;
+    // A phrase of no thing ("up close") or a doing ("take pictures", "to lift", "work out") is not what it shows.
+    if (list.every((word)=>STOPWORDS.has(word) && word !== 'people' && word !== 'person')) return null;
+    if (/^(?:to|take|taking|make|making|get|do|go|lie)$/.test(list[0])) return null;
+    if (/^(?:out|up|off|down|away|on|in)$/.test(list[list.length - 1])) return null;
+    if (list.every((word)=>proper.has(word))) return list.map((word)=>`${word.charAt(0).toUpperCase()}${word.slice(1)}`).join(' ');
+    const phrase = list.join(' ');
+    const last = list[list.length - 1];
+    const plural = aiStockStem(last) !== last && !/^(?:lens|canvas|atlas|gas|bus)$/.test(last);
+    const uncounted = MASS_NOUNS.has(last) || last.endsWith('ing') && !COUNTED_ING.has(last);
+    if (plural || uncounted || STOPWORDS.has(list[0]) && list[0] !== 'person') return phrase;
+    return `${/^(?:[aeio]|u(?!ni|s[eu]))/.test(phrase) ? 'an' : 'a'} ${phrase}`;
+}
+/**
+ * A photo described from its own tags (AGL-3856): its first few that name a
+ * thing, a phrase another one holds dropped ("wedding" beside "wedding
+ * dress"), as an English phrase — "A wedding dress and a bride", "A hammer,
+ * books and law" — never the comma-separated list the library keeps. `null`
+ * where none names a thing.
+ */ export function aiStockTagsAlt(tags, proper = new Set()) {
+    const kept = [];
+    for (const tag of tags.slice(0, 6)){
+        if (kept.length >= 3) break;
+        const said = describedTag(tag, proper);
+        if (!said) continue;
+        const stems = stemList(said.replace(/^an?\s+/, ''));
+        if (kept.some((entry)=>stems.every((stem)=>entry.stems.includes(stem)))) continue;
+        // A longer phrase takes the place of one it holds: "wedding dress" for "wedding".
+        const within = kept.findIndex((entry)=>entry.stems.every((stem)=>stems.includes(stem)));
+        if (within >= 0) kept.splice(within, 1, {
+            stems,
+            said
+        });
+        else kept.push({
+            stems,
+            said
+        });
+    }
+    if (!kept.length) return null;
+    const said = kept.map((entry)=>entry.said);
+    const joined = said.length > 1 ? `${said.slice(0, -1).join(', ')} and ${said[said.length - 1]}` : said[0];
+    const out = `${joined.charAt(0).toUpperCase()}${joined.slice(1)}`;
+    return out.length > AI_STOCK_ALT_MAX ? out.slice(0, AI_STOCK_ALT_MAX).replace(/[\s,]+\S*$/, '') : out;
+}
+/** The thing a description names: its subject's object, a trailing "speaking calmly" or "dusted" dropped. */ function describedObject(text, sectionName) {
+    const list = aiStockSubjectWords(text, sectionName).split(/\s+/).filter(Boolean);
+    while(list.length > 1 && /(?:ing|ed|ly)$/.test(list[list.length - 1]))list.pop();
+    return aiStockObjectWord(list.join(' '));
+}
+/**
+ * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805, AGL-3856).
  *
  * A slot's alt text is the model's, written for the picture the page asked
  * for before any photo was found, and a slot is filled by whatever the
@@ -1859,37 +2145,44 @@ function jobPhotos(key) {
  * dulce", a plate of macarons the shop's display case.
  *
  * So the photo placed answers for its own words. `null` keeps the slot's: on
- * an English site whose words name what the photo is OF — a word of their
- * subject (`aiStockSubjectWords`: the noun phrase they open with, before any
- * setting) among the hit's first tags or its page's address, so "conchas on
- * a tray at the bakery counter" is never kept for a loaf tagged "bakery".
- * Otherwise the photo is described by the
+ * an English site whose words name the thing the photo is OF — their
+ * subject's object (`aiStockSubjectWords`, a trailing "speaking calmly"
+ * dropped) among the hit's first two tags. Any word of the subject among its
+ * first three was not enough: the beta.259 Hartwell Reyes Family Law hero kept
+ * "Two attorneys speaking calmly with a client in a bright Columbus office"
+ * for a typewriter whose third tag was "attorney" (AGL-3856). A stand-in's
+ * words ({@link AiLayoutPictureSlot.standIn}) are a search's, never a
+ * description, and are never kept. Otherwise the photo is described by the
  * library's own words: its description where it writes one (a Pexels hit's
- * `alt`), else its first tags, the things it shows. The libraries write in
- * English, and no model translates them, so a site in another language takes
- * the platform's own words for an illustrative photo in its language
- * (`aiLayoutLabel`), true of any photo, as does a hit with no words at all.
+ * `alt`), else its first tags as an English phrase ({@link aiStockTagsAlt}),
+ * never the library's tag list. The libraries write in English, and no model
+ * translates them, so a site in another language takes the platform's own
+ * words for an illustrative photo in its language (`aiLayoutLabel`), true of
+ * any photo, as does a hit whose words name no thing.
  */ export function aiStockPhotoAlt(photo, slot, input = {}) {
-    var _ref, _photo_alt, _photo_tags;
-    var _slot_product;
+    var _photo_alt, _aiStockTagsAlt, _photo_tags;
     if (aiLayoutSpeaksOtherThanEnglish(input.language)) return aiLayoutLabel('illustrativePhoto', input.language);
-    const { lead } = hitWords(photo);
-    const named = [
-        slot.alt,
-        ...(_ref = (_slot_product = slot.product) == null ? void 0 : _slot_product.subjects) != null ? _ref : []
-    ].flatMap((words)=>{
-        var _input_sectionName;
-        return stemList(aiStockSubjectWords(words, (_input_sectionName = input.sectionName) != null ? _input_sectionName : ''));
-    });
-    if (named.some((word)=>lead.has(word))) return null;
+    if (!slot.standIn) {
+        var _photo_tags1, _ref;
+        var _slot_product;
+        const first = new Set(stemList(((_photo_tags1 = photo.tags) != null ? _photo_tags1 : []).slice(0, 2).join(' ')));
+        const objects = [
+            slot.alt,
+            ...(_ref = (_slot_product = slot.product) == null ? void 0 : _slot_product.subjects) != null ? _ref : []
+        ].map((text)=>{
+            var _input_sectionName;
+            return describedObject(text, (_input_sectionName = input.sectionName) != null ? _input_sectionName : '');
+        });
+        if (objects.some((object)=>object && first.has(object))) return null;
+    }
     const own = ((_photo_alt = photo.alt) != null ? _photo_alt : '').replace(/\s+/g, ' ').trim();
     if (own) return own.length > AI_STOCK_ALT_MAX ? `${own.slice(0, AI_STOCK_ALT_MAX).replace(/\s+\S*$/, '')}…` : own;
-    const tags = [
-        ...new Set(((_photo_tags = photo.tags) != null ? _photo_tags : []).map((tag)=>tag.replace(/\s+/g, ' ').trim().toLowerCase()).filter(Boolean))
-    ].slice(0, 3);
-    if (!tags.length) return aiLayoutLabel('illustrativePhoto', input.language);
-    const said = tags.join(', ');
-    return `${said.charAt(0).toUpperCase()}${said.slice(1)}`;
+    return (_aiStockTagsAlt = aiStockTagsAlt((_photo_tags = photo.tags) != null ? _photo_tags : [], input.proper)) != null ? _aiStockTagsAlt : aiLayoutLabel('illustrativePhoto', input.language);
+}
+/** The names a business type writes with a capital, lowercased: "columbus", "ohio" (AGL-3856). */ export function aiStockProperWords(businessType) {
+    const found = new Set();
+    for (const [index, word] of businessType.split(/[^A-Za-zÀ-ɏ'-]+/).filter(Boolean).entries())if (index > 0 && /^[A-ZÀ-Þ]/.test(word)) found.add(word.toLowerCase());
+    return found;
 }
 const EXTENSIONS = {
     'image/jpeg': 'jpg',
@@ -1980,6 +2273,7 @@ const EXTENSIONS = {
     // alt texts, in its own language, name no subject a search could use.
     const english = aiStockSourceSubject(input);
     const terms = aiStockSourceTerms(input);
+    const proper = aiStockProperWords(input.business);
     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);
@@ -2038,7 +2332,8 @@ const EXTENSIONS = {
             return aiStockPhotoAlt(photo, slot, _extends({}, input.language ? {
                 language: input.language
             } : {}, {
-                sectionName: (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : ''
+                sectionName: (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '',
+                proper
             }));
         };
         /** The photo placed in the site's library, a copy it holds or a new one; `null` when it cannot be placed. */ const keep = async (photo, slot, query, repeat = false)=>{
@@ -2135,6 +2430,8 @@ const EXTENSIONS = {
                         ...(_request_shun = request.shun) != null ? _request_shun : []
                     ])
                 ]
+            } : {}, terms.shunLead.length ? {
+                shunLead: terms.shunLead
             } : {}, request.product ? {
                 product: true
             } : {}, ((_request_leadAny = request.leadAny) == null ? void 0 : _request_leadAny.length) ? {