@aglyn/plugins-ai 1.0.0-beta.239 → 1.0.0-beta.241

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

@@ -17,6 +17,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ import { pluginMediaIngest } from "@aglyn/aglyn/plugin-manager/plugin-media-ingest";
 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";
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
  *
@@ -70,6 +71,17 @@ import { aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
  *    ranked: the object in the hit's first tags (what the photo is OF) over
  *    a mention in its last, the subject's other words, the domain. Among
  *    equals the job's seed picks, so two sites differ and one job repeats.
+ *    What the beta.239 Ember & Oak start added: "hand-poured", "handmade"
+ *    and "by hand" never make "hands" a subject, and a story of the craft
+ *    asks for the maker at work ("candle making"); a hit carrying a topic
+ *    the brief never named (a cross, a grave, a flag, a gun, wine, a child,
+ *    a mannequin) never fills anything; a product, and a collection tile,
+ *    take only a hit naming its head noun among the first tags, held to the
+ *    shop's category; and an object whose word is not enough ("melt") is
+ *    named and searched by its kin ("wax melt", "melt warmer"), never by the
+ *    category alone. And from the Kiln & Clover portfolio: nudity never fills
+ *    anything, for any business; a hit naming a rival craft (glass, for a
+ *    potter) counts only when it names the craft's own words too.
  * 4. **Never twice.** A photo is placed once per job: not twice on a page,
  *    and not on a page when another page (or another pass, in this process)
  *    of the same job already placed it. The caller hands in what the job's
@@ -98,12 +110,17 @@ import { aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
  * The unit job input naming the screen drafts the job's other pages were
  * written to, whose photos a page does not place again (AGL-3660).
  */ export const AI_STOCK_PHOTO_PAGES_INPUT = 'stockPhotoPages';
+/**
+ * The unit job input naming library photos (`media:` references) another
+ * part of the job already shows outside its pages — a dataset's records
+ * (AGL-3616) — which a page does not place again.
+ */ export const AI_STOCK_PHOTO_AVOID_INPUT = 'stockPhotoAvoid';
 const words = (list)=>new Set(list.trim().split(/\s+/));
 /** Words that carry no subject. */ const STOPWORDS = words('a an the and or of in on at to for with from by into onto over under near our your their my his her its ' + 'this that these those is are be being was were who whom which where while as about than then very just ' + 'small local best new top quality premium family-owned family owned independent professional ' + 'business company services service page photo picture image showing shows show ' + 'someone people person one two three some many several');
 /**
  * Words that describe a picture's look, not what it shows, dropped from a
  * subject. A word that is as often a noun ("light", "set") is not one.
- */ const FILLER = words('beautiful beautifully stunning gorgeous lovely pretty elegant modern contemporary rustic cozy cosy warm cool ' + 'soft bright natural simple minimal minimalist delicate unique special artisan artisanal handmade ' + 'hand-made hand-thrown handthrown hand-crafted handcrafted crafted hand-built handbuilt hand-poured ' + 'hand-painted hand-dyed hand-stitched poured finished styled perfect ' + 'fresh clean calm serene quiet peaceful vibrant colorful colourful sunlit sunny golden glossy matte textured ' + 'close-up closeup up view views detail details detailed shot shots overhead flat lay flatlay flat-lay ' + 'top-down wide angle featuring featured displayed arranged sitting resting placed standing lined ' + 'single pair collection assortment selection group few various array range large tiny big little ' + 'tall short wide narrow everyday classic signature original favorite favourite bestselling best-selling ' + 'small-batch batch limited edition custom bespoke ' + 'white black grey gray beige cream ivory brown tan blue green red pink yellow orange purple speckled ' + 'gentle airy inviting welcoming cheerful happy smiling friendly');
+ */ const FILLER = words('beautiful beautifully stunning gorgeous lovely pretty elegant modern contemporary rustic cozy cosy warm cool ' + 'soft bright natural simple minimal minimalist delicate unique special artisan artisanal handmade ' + 'hand-made hand-thrown handthrown hand-crafted handcrafted crafted hand-built handbuilt hand-poured ' + 'hand-painted hand-dyed hand-stitched poured finished styled perfect wheel-thrown wheelthrown thrown ' + 'fresh clean calm serene quiet peaceful vibrant colorful colourful sunlit sunny golden glossy matte textured ' + 'close-up closeup up view views detail details detailed shot shots overhead flat lay flatlay flat-lay ' + 'top-down wide angle featuring featured displayed arranged sitting resting placed standing lined ' + 'single pair collection assortment selection group few various array range large tiny big little ' + 'tall short wide narrow everyday classic signature original favorite favourite bestselling best-selling ' + 'small-batch batch limited edition custom bespoke ' + 'white black grey gray beige cream ivory brown tan blue green red pink yellow orange purple speckled ' + 'gentle airy inviting welcoming cheerful happy smiling friendly');
 /** 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');
@@ -119,6 +136,345 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
  * an empty frame on the page (the Juniper Clay hero), a template or a
  * graphic is not a photo of anything.
  */ const REJECTED_TAGS = words('mockup mock-up mock blank template templates clipart clip-art illustration vector logo icon ' + 'ai-generated generated render rendering 3d');
+/**
+ * Topics a business's photos never carry unless its own words name them
+ * (AGL-3660, the beta.239 Ember & Oak start, whose "Gifts for melt fans" tile
+ * showed devotional candles with crosses and names). A hit tagged with any
+ * word of a topic is rejected unless the site's business type or brief says
+ * one of the topic's words or its `allow` words. The last topic is not
+ * sensitive but is never the thing: the same start's story band showed bronze
+ * mannequin hands tagged "wax".
+ */ const SENSITIVE_TOPICS = [
+    {
+        // Religion.
+        words: [
+            'cross',
+            'crosses',
+            'crucifix',
+            'church',
+            'chapel',
+            'cathedral',
+            'jesus',
+            'christ',
+            'christian',
+            'christianity',
+            'god',
+            'bible',
+            'rosary',
+            'prayer',
+            'pray',
+            'praying',
+            'worship',
+            'worships',
+            'religion',
+            'religious',
+            'faith',
+            'islam',
+            'islamic',
+            'muslim',
+            'mosque',
+            'quran',
+            'temple',
+            'buddha',
+            'buddhism',
+            'buddhist',
+            'hindu',
+            'hinduism',
+            'synagogue',
+            'jewish',
+            'judaism',
+            'ecclesiastical',
+            'saint',
+            'altar',
+            'sacrificial',
+            'nativity',
+            'priest',
+            'nun',
+            'monk'
+        ],
+        allow: [
+            'ministry',
+            'parish',
+            'congregation',
+            'wedding'
+        ]
+    },
+    {
+        // Death and mourning.
+        words: [
+            'funeral',
+            'memorial',
+            'grave',
+            'gravestone',
+            'cemetery',
+            'tomb',
+            'death',
+            'dead',
+            'grief',
+            'mourning',
+            'condolence',
+            'coffin',
+            'skull'
+        ],
+        allow: [
+            'hospice',
+            'mortuary',
+            'cremation',
+            'obituary',
+            'halloween'
+        ]
+    },
+    {
+        // Politics.
+        words: [
+            'political',
+            'politics',
+            'protest',
+            'protester',
+            'demonstration',
+            'rally',
+            'flag',
+            'election',
+            'vote',
+            'voting',
+            'parliament',
+            'government'
+        ],
+        allow: [
+            'advocacy',
+            'campaign',
+            'candidate',
+            'council',
+            'nonprofit'
+        ]
+    },
+    {
+        // Weapons and war.
+        words: [
+            'gun',
+            'rifle',
+            'pistol',
+            'weapon',
+            'firearm',
+            'ammunition',
+            'bullet',
+            'sword',
+            'war',
+            'military',
+            'army',
+            'soldier'
+        ],
+        allow: [
+            'hunting',
+            'archery',
+            'martial',
+            'fencing',
+            'veteran'
+        ]
+    },
+    {
+        // Alcohol, for a business that does not serve it.
+        words: [
+            'alcohol',
+            'wine',
+            'beer',
+            'whiskey',
+            'whisky',
+            'vodka',
+            'cocktail',
+            'liquor',
+            'rum',
+            'gin',
+            'champagne',
+            'drunk'
+        ],
+        allow: [
+            'winery',
+            'vineyard',
+            'brewery',
+            'distillery',
+            'pub',
+            'tavern',
+            'taproom',
+            'bartender',
+            'sommelier',
+            'spirits'
+        ]
+    },
+    {
+        // Tobacco and drugs.
+        words: [
+            'cigarette',
+            'smoking',
+            'tobacco',
+            'cannabis',
+            'marijuana',
+            'drug',
+            'drugs'
+        ],
+        allow: [
+            'dispensary',
+            'vape',
+            'cigar'
+        ]
+    },
+    {
+        // Children, for a business that is not about them.
+        words: [
+            'child',
+            'children',
+            'kid',
+            'kids',
+            'baby',
+            'babies',
+            'toddler',
+            'infant'
+        ],
+        allow: [
+            'nursery',
+            'daycare',
+            'preschool',
+            'kindergarten',
+            'school',
+            'tutor',
+            'tutoring',
+            'parent',
+            'parents',
+            'parenting',
+            'family',
+            'families',
+            'pediatric',
+            'paediatric',
+            'newborn',
+            'maternity'
+        ]
+    },
+    {
+        // Nudity, for every business: no word of a brief lets it in (Kiln &
+        // Clover, 2026-10-10: a nude torso sculpture filled "About the artist").
+        // Never bare "body": a skincare shop's body lotion is its product.
+        words: [
+            'nude',
+            'nudes',
+            'nudity',
+            'naked',
+            'torso',
+            'breast',
+            'breasts',
+            'erotic',
+            'sensual',
+            'lingerie',
+            'bikini'
+        ],
+        allow: [],
+        always: true
+    },
+    {
+        // Figures, never the maker: mannequin hands are not a candlemaker's.
+        words: [
+            'mannequin',
+            'mannequins',
+            'dummy',
+            'statue',
+            'sculpture',
+            'figurine',
+            'doll',
+            'dolls',
+            'waxwork'
+        ],
+        allow: [
+            'sculptor',
+            'museum',
+            'fashion',
+            'boutique',
+            'clothing',
+            'apparel',
+            'toy',
+            'toys'
+        ]
+    }
+];
+/** Each topic's words and the words that allow it, as stems. */ const SENSITIVE_STEMS = SENSITIVE_TOPICS.map((topic)=>{
+    var _topic_allow;
+    return {
+        words: new Set(topic.words.map(aiStockStem)),
+        allow: new Set(topic.always ? [] : [
+            ...topic.words,
+            ...(_topic_allow = topic.allow) != null ? _topic_allow : []
+        ].map(aiStockStem))
+    };
+});
+/**
+ * Hands are never a picture's subject (AGL-3660): "hand-poured", "handmade"
+ * and "by hand" say how a thing was made, and a search for "hands" found
+ * bronze mannequin hands for the beta.239 Ember & Oak story band. Each of
+ * these is dropped from a picture's words; a hand only stays where it names
+ * a thing sold for hands ("hand cream").
+ */ const HAND_IDIOMS = [
+    /\b(?:made\s+|poured\s+|crafted\s+|finished\s+|done\s+)?by\s+(?:our\s+|my\s+|their\s+)?(?:own\s+)?hands?\b/g,
+    /\bwith\s+(?:our|my|their)\s+(?:own\s+)?(?:two\s+)?hands\b/g,
+    /\bhand[- ]?(?:poured|made|crafted|thrown|built|painted|dyed|stitched|sewn|knit|knitted|carved|tied|lettered|blown|bound|rolled|dipped|picked|forged|woven|cut|finished|mixed|cast|formed|shaped|pressed|printed|wrapped|selected|blended|turned|glazed)\b/g,
+    /\bhands?\b(?!\s+(?:creams?|soaps?|lotions?|wash|towels?|saniti[sz]ers?|salves?|balms?|tools?|saws?|planes?|drills?|mixers?|puppets?|bags?|warmers?))/g
+];
+/** A text without its hands. */ function withoutHands(text) {
+    return HAND_IDIOMS.reduce((out, idiom)=>out.replace(idiom, ' '), text.toLowerCase());
+}
+/** Whether a text says how a thing was made by hand: a maker at work. */ function saysMadeByHand(text) {
+    const lower = text.toLowerCase();
+    return HAND_IDIOMS.some((idiom)=>{
+        idiom.lastIndex = 0;
+        const found = idiom.test(lower);
+        idiom.lastIndex = 0;
+        return found;
+    });
+}
+/**
+ * The kin of a few objects whose own word is not enough (AGL-3660): a "melt"
+ * is any melting thing (the beta.239 "Wax melts" tile showed resin fluid
+ * art), so a wax melt names one of these phrases. `within` is the world they
+ * are of; `qualifier` the word a search adds; `queries` the searches for the
+ * object itself, which stand in for the shop's category alone: a candle is
+ * not a wax melt.
+ */ const OBJECT_KIN = [
+    {
+        objects: [
+            'melt',
+            'tart',
+            'cube'
+        ],
+        within: [
+            'wax',
+            'candle',
+            'soy'
+        ],
+        qualifier: 'wax',
+        kin: [
+            'wax melt',
+            'wax melts',
+            'wax cube',
+            'wax cubes',
+            'wax tart',
+            'wax tarts',
+            'melt warmer',
+            'wax warmer',
+            'tart warmer',
+            'oil burner',
+            'oil warmer',
+            'aroma burner',
+            'scent warmer',
+            'fragrance warmer'
+        ],
+        queries: [
+            'wax melts',
+            'wax melt warmer',
+            'scented wax cubes'
+        ]
+    }
+];
+/** An object's kin where the site or the subject is of its world, else `null`. */ function objectKin(object, world) {
+    var _OBJECT_KIN_find;
+    return (_OBJECT_KIN_find = OBJECT_KIN.find((entry)=>entry.objects.some((word)=>aiStockStem(word) === object) && entry.within.some((word)=>world.includes(aiStockStem(word))))) != null ? _OBJECT_KIN_find : null;
+}
 /**
  * The kin of a few common crafts: the words a photo of that world is
  * tagged with, and the broad searches that find it. A craft not listed
@@ -150,6 +506,33 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'handmade ceramics',
             'pottery'
+        ],
+        rivals: {
+            words: [
+                'glass',
+                'glassware',
+                'glasswork',
+                'glassblowing',
+                'blown',
+                'stained',
+                'murano',
+                'crystal'
+            ],
+            core: [
+                'ceramic',
+                'ceramics',
+                'pottery',
+                'potter',
+                'stoneware',
+                'porcelain',
+                'earthenware',
+                'clay',
+                'terracotta'
+            ]
+        },
+        making: [
+            'pottery wheel',
+            'potter at work'
         ]
     },
     {
@@ -171,6 +554,10 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'handmade candles',
             'scented candles'
+        ],
+        making: [
+            'candle making',
+            'pouring wax'
         ]
     },
     {
@@ -196,6 +583,10 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'handmade jewelry',
             'jewelry'
+        ],
+        making: [
+            'jewelry making',
+            'jeweler at work'
         ]
     },
     {
@@ -216,6 +607,9 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'handmade soap',
             'natural skincare'
+        ],
+        making: [
+            'soap making'
         ]
     },
     {
@@ -242,6 +636,10 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'woodworking',
             'wooden furniture'
+        ],
+        making: [
+            'woodworking workshop',
+            'carpenter at work'
         ]
     },
     {
@@ -266,6 +664,10 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'bakery',
             'fresh bread'
+        ],
+        making: [
+            'baker kneading dough',
+            'baking bread'
         ]
     },
     {
@@ -288,6 +690,9 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'coffee shop',
             'coffee'
+        ],
+        making: [
+            'barista making coffee'
         ]
     },
     {
@@ -307,6 +712,9 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'florist',
             'flower bouquet'
+        ],
+        making: [
+            'florist arranging flowers'
         ]
     },
     {
@@ -336,6 +744,10 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'handmade textiles',
             'yarn'
+        ],
+        making: [
+            'knitting',
+            'weaving loom'
         ]
     },
     {
@@ -354,6 +766,9 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         broad: [
             'leather craft',
             'leather goods'
+        ],
+        making: [
+            'leather crafting'
         ]
     }
 ];
@@ -440,7 +855,8 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         // What it makes names its world by what the things are made of, never
         // the things: "stoneware" of "stoneware bowls", "soy" of "soy candles".
         // A bowl is not a ceramic world; a robin's food bowl is not pottery.
-        const world = making ? kept.slice(0, -1) : kept;
+        // A set or a gift is never a world: "gift" of "gift sets" is not one.
+        const world = (making ? kept.slice(0, -1) : kept).filter((word)=>!WRAPPERS.has(word));
         for (const word of world)for (const stem of stemList(word))domain.add(stem);
         if (making) for (const word of kept.slice(-1))for (const stem of stemList(word))made.add(stem);
     }
@@ -448,10 +864,17 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
     // A business named only by what it sells ("a shop selling pottery") is of that world.
     if (!domain.size) for (const stem of made)domain.add(stem);
     const broad = [];
+    const makingSearches = [];
+    const rivals = [];
     for (const group of CRAFT_KIN){
         if (!group.match.some((word)=>domain.has(aiStockStem(word)) || made.has(aiStockStem(word)))) continue;
         for (const word of group.kin)domain.add(aiStockStem(word));
         broad.push(...group.broad);
+        makingSearches.push(...group.making);
+        if (group.rivals) rivals.push({
+            words: group.rivals.words.map(aiStockStem),
+            core: group.rivals.core.map(aiStockStem)
+        });
     }
     if (!broad.length) broad.push(business, craft);
     return {
@@ -462,7 +885,14 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
         ].filter((stem)=>stem.length > 1),
         broad: [
             ...new Set(broad.map((query)=>query.trim()).filter(Boolean))
-        ]
+        ],
+        making: [
+            ...new Set(makingSearches)
+        ],
+        named: [
+            ...new Set(stemList(businessType))
+        ],
+        rivals
     };
 }
 /** A phrase's content words without its filler; all filler, and nothing is left. */ function subjectOf(list) {
@@ -474,11 +904,12 @@ const words = (list)=>new Set(list.trim().split(/\s+/));
  * preposition starts the setting, filler dropped, its last three words (the
  * head noun is the last) — else its section's name.
  */ export function aiStockSubjectWords(alt, sectionName) {
-    for (const clause of alt.toLowerCase().split(CLAUSE_BREAK)){
+    // "Hand-poured", "by hand" and "hands" say how it was made, never what it shows.
+    for (const clause of withoutHands(alt).split(CLAUSE_BREAK)){
         const found = subjectOf(contentWords(clause != null ? clause : ''));
         if (found.length) return found.slice(-3).join(' ');
     }
-    return subjectOf(contentWords(sectionName)).slice(0, 2).join(' ');
+    return subjectOf(contentWords(withoutHands(sectionName))).slice(0, 2).join(' ');
 }
 /**
  * The thing a subject shows, one singular word: its last word that is not
@@ -499,6 +930,19 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     if (aspect < 0.87) return 'vertical';
     return 'any';
 }
+/**
+ * A slot's part (AGL-3660): a tile of a collections band is product-like,
+ * held to the shop's category and its own object; a picture of a story of
+ * the craft, or of a thing made by hand, shows the maker at work.
+ */ export function aiStockSlotPart(slot, sectionName) {
+    if (slot.role === 'hero') return undefined;
+    if (slot.role === 'gallery' && aiStorefrontSays('collections', sectionName)) return 'collection';
+    if (aiStorefrontSays('story', sectionName) || saysMadeByHand(slot.alt) || saysMadeByHand(sectionName)) return 'story';
+    return undefined;
+}
+/** An object's kin phrases as stems, or none. */ const kinStems = (entry)=>entry ? [
+        ...new Set(entry.kin.map((phrase)=>stemList(phrase).join(' ')))
+    ] : [];
 /**
  * A product's searches (AGL-3676), most specific first: each of its subjects
  * — its name's noun phrase, then its photo's — with the shop's category
@@ -507,8 +951,15 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
  * hit naming the category, so no product is ever filled with a lifestyle shot
  * of something else: the beta.237 Willow Wick start put a laptop and roses
  * under "Candle Wick Trimmer" and an antique tea set under "Candle Gift Set".
- */ export function aiStockProductSearches(slot, craft) {
-    var _ref;
+ *
+ * And every one must find a hit naming the product's own head noun among its
+ * first tags (AGL-3660): the beta.239 Ember & Oak start put a bed with a book,
+ * a mug and a camera (its candle a last tag) under "Hand-Poured Soy Candle".
+ * An object whose own word is not enough ({@link OBJECT_KIN}) is searched by
+ * its kin instead of the category alone, and named by them: a single taper
+ * candle filled "Wax Melt Gift Set".
+ */ export function aiStockProductSearches(slot, craft, domain = []) {
+    var _ref, _subjects_, _subjects_1;
     var _slot_product;
     const orientation = aiStockOrientation(slot.aspect);
     const size = orientation === 'vertical' ? {
@@ -517,19 +968,37 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
         minWidth: 900
     };
     const craftStems = stemList(craft);
+    const subjects = ((_ref = (_slot_product = slot.product) == null ? void 0 : _slot_product.subjects) != null ? _ref : []).map((raw)=>aiStockSubjectWords(raw, '')).filter(Boolean);
+    // The product's head noun is its name's: "candle" of "Hand-Poured Soy Candle".
+    const object = aiStockObjectWord((_subjects_ = subjects[0]) != null ? _subjects_ : '');
+    const kin = object ? objectKin(object, [
+        ...craftStems,
+        ...domain,
+        ...stemList(subjects.join(' '))
+    ]) : null;
+    const kinPhrases = kinStems(kin);
     const queries = [];
-    for (const raw of (_ref = (_slot_product = slot.product) == null ? void 0 : _slot_product.subjects) != null ? _ref : []){
-        const subject = aiStockSubjectWords(raw, '');
-        if (!subject) continue;
-        const says = craftStems.every((stem)=>stemList(subject).includes(stem));
+    for (const subject of subjects){
+        const stems = stemList(subject);
+        const query = kin ? stems.includes(aiStockStem(kin.qualifier)) ? subject : `${kin.qualifier} ${subject}` : craft && !craftStems.every((stem)=>stems.includes(stem)) ? `${craft} ${subject}` : subject;
         queries.push({
-            query: craft && !says ? `${craft} ${subject}` : subject,
-            subject
+            query,
+            subject,
+            object
         });
     }
-    if (craft) queries.push({
+    // The category alone stands in only for a thing that is no more than of it.
+    // Its hits are still scored by the product's own words: a soy candle over a taper.
+    const own = (_subjects_1 = subjects[0]) != null ? _subjects_1 : '';
+    if (kin) for (const query of kin.queries)queries.push({
+        query,
+        subject: own || query,
+        object
+    });
+    else if (craft) queries.push({
         query: craft,
-        subject: craft
+        subject: own || craft,
+        object: craft
     });
     const seen = new Set();
     const searches = [];
@@ -541,14 +1010,20 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
             query,
             orientation
         }, size, {
-            subject: entry.subject
-        }, craft ? {
+            subject: entry.subject,
+            lead: true
+        }, entry.object ? {
+            object: entry.object
+        } : {}, kinPhrases.length ? {
+            kin: kinPhrases
+        } : {}, craft ? {
             requires: craft
         } : {}));
     }
     return searches;
 }
-/** The searches a slot tries, in order, most specific first, each distinct. */ export function aiStockSearchesFor(slot, terms, subject) {
+/** The searches a slot tries, in order, most specific first, each distinct. */ export function aiStockSearchesFor(slot, terms, subject, part) {
+    var _terms_making;
     const orientation = aiStockOrientation(slot.aspect);
     const size = slot.role === 'hero' ? {
         minWidth: 1600
@@ -560,13 +1035,44 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     const domain = new Set(terms.domain);
     const object = aiStockObjectWord(subject);
     const subjectStems = stemList(subject);
+    const kin = object ? objectKin(object, [
+        ...terms.domain,
+        ...subjectStems
+    ]) : null;
+    const kinPhrases = kinStems(kin);
     // The craft qualifies a subject that does not already name the site's world.
     const namesWorld = subjectStems.some((stem)=>domain.has(stem));
     const qualify = (phrase)=>terms.craft && !namesWorld && !stemList(phrase).includes(terms.craft) ? `${terms.craft} ${phrase}` : phrase;
-    const broad = terms.broad.map((query)=>({
+    // A collection tile is product-like: held to the shop's category and its
+    // own object among the first tags, and searched by its object's kin, never
+    // the category's world alone (AGL-3660).
+    const collection = part === 'collection' && Boolean(terms.craft);
+    const broad = kin && collection ? [] : terms.broad.map((query)=>({
             query,
-            broad: true
+            broad: true,
+            category: collection
+        }));
+    // The maker at work, held to the craft: never "hands" (AGL-3660).
+    const making = ((_terms_making = terms.making) != null ? _terms_making : []).map((query)=>({
+            query,
+            broad: true,
+            category: true
         }));
+    const thing = subject ? [
+        {
+            query: qualify(subject),
+            held: true
+        },
+        ...kin ? kin.queries.map((query)=>({
+                query,
+                held: true
+            })) : [
+            {
+                query: qualify(object),
+                held: true
+            }
+        ]
+    ] : [];
     const queries = slot.role === 'hero' ? [
         {
             query: terms.business,
@@ -574,6 +1080,7 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
         },
         ...broad
     ] : slot.role === 'about' ? [
+        ...part === 'story' ? making : [],
         {
             query: `${terms.business} ${subject}`,
             broad: true,
@@ -584,16 +1091,13 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
             broad: true,
             people: true
         },
+        ...part === 'story' ? [] : making,
         ...broad
-    ] : subject ? [
-        {
-            query: qualify(subject)
-        },
-        {
-            query: qualify(object)
-        },
+    ] : [
+        ...part === 'story' ? making : [],
+        ...thing,
         ...broad
-    ] : broad;
+    ];
     const seen = new Set();
     const searches = [];
     for (const raw of queries){
@@ -601,6 +1105,7 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
         const key = `${query}|${raw.people === true}`;
         if (!query || seen.has(key)) continue;
         seen.add(key);
+        const held = raw.held === true && (collection || kinPhrases.length > 0);
         searches.push(_extends({
             query,
             orientation
@@ -608,6 +1113,12 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
             people: true
         } : {}, raw.broad ? {
             broad: true
+        } : {}, held && kinPhrases.length ? {
+            kin: kinPhrases
+        } : {}, held && collection ? {
+            lead: true
+        } : {}, terms.craft && (raw.category || raw.held && collection) ? {
+            requires: terms.craft
         } : {}));
     }
     return searches;
@@ -622,7 +1133,7 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     }
 }
 /** A hit's words: the first few (what it is OF), every one, and each tag's phrase. */ function hitWords(photo) {
-    var _photo_tags, _photo_alt, _photo_alt1;
+    var _photo_tags, _photo_alt, _photo_alt1, _photo_alt2;
     const slug = pageSlug(photo.pageUrl);
     const tags = ((_photo_tags = photo.tags) != null ? _photo_tags : []).map((tag)=>tag.toLowerCase().trim()).filter(Boolean);
     const lead = new Set(stemList([
@@ -639,17 +1150,42 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
         stemList((_photo_alt1 = photo.alt) != null ? _photo_alt1 : '').join(' '),
         stemList(slug).join(' ')
     ];
+    const leadPhrases = [
+        ...tags.slice(0, 3).map((tag)=>stemList(tag).join(' ')),
+        stemList(slug).join(' ')
+    ];
     const rejected = tags.some((tag)=>REJECTED_TAGS.has(tag) || tag.split(/\s+/).some((word)=>REJECTED_TAGS.has(word)));
+    // Whole words only, a hyphenated one kept whole: "cross-stitch" is not a cross.
+    const words = new Set([
+        ...tags,
+        ((_photo_alt2 = photo.alt) != null ? _photo_alt2 : '').toLowerCase()
+    ].join(' ').split(/[^a-zÀ-ɏ-]+/).filter((word)=>word.length > 1).map(aiStockStem));
     return {
         lead,
         all,
         phrases,
-        rejected
+        leadPhrases,
+        rejected,
+        words
     };
 }
+/** Whether a phrase is among a hit's phrases, word for word. */ const among = (phrases, phrase)=>phrases.some((found)=>` ${found} `.includes(` ${phrase} `));
+/**
+ * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):
+ * a cross, a grave, a flag, a gun, a glass of wine, a child, a mannequin.
+ */ export function aiStockSensitive(photo, named = []) {
+    const { words: found } = hitWords(photo);
+    const site = new Set(named);
+    return SENSITIVE_STEMS.some((topic)=>[
+            ...topic.words
+        ].some((word)=>found.has(word)) && ![
+            ...topic.allow
+        ].some((word)=>site.has(word)));
+}
 /**
  * How well a hit shows what a slot needs (AGL-3660), or 0 when it must not
- * fill it: a mockup or a blank never; a picture of a thing only when the hit
+ * fill it: a mockup or a blank never; a topic the site never named never
+ * ({@link aiStockSensitive}); a picture of a thing only when the hit
  * names its object AND either the site's world or the subject's own
  * two-word phrase ("bud vase", "wick trimmer"); anything else only when it
  * names the site's world (when the site names one). Among the accepted, the
@@ -657,25 +1193,38 @@ 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_requires, _judgement_subject, _judgement_domain;
+    var _judgement_rivals, _judgement_kin, _judgement_requires, _judgement_subject, _judgement_object, _judgement_domain;
     const hit = hitWords(photo);
     if (hit.rejected) return 0;
+    if (aiStockSensitive(photo, judgement.named)) return 0;
+    // Glass art is not pottery: a rival craft's photo names this craft's own words.
+    for (const rival of (_judgement_rivals = judgement.rivals) != null ? _judgement_rivals : [])if (rival.words.some((word)=>hit.all.has(word)) && !rival.core.some((word)=>hit.all.has(word))) return 0;
+    const kin = (_judgement_kin = judgement.kin) != null ? _judgement_kin : [];
+    const kinNamed = kin.some((phrase)=>among(hit.phrases, phrase));
+    const kinLead = kin.some((phrase)=>among(hit.leadPhrases, phrase));
     const required = stemList((_judgement_requires = judgement.requires) != null ? _judgement_requires : '');
-    if (required.some((stem)=>!hit.all.has(stem))) return 0;
+    // An object's kin stands for the category: a wax melt is the candle shop's.
+    if (!kinNamed && required.some((stem)=>!hit.all.has(stem))) return 0;
     const subject = stemList((_judgement_subject = judgement.subject) != null ? _judgement_subject : '');
-    const object = judgement.subject ? aiStockObjectWord(judgement.subject) : '';
+    const object = (_judgement_object = judgement.object) != null ? _judgement_object : judgement.subject ? aiStockObjectWord(judgement.subject) : '';
     const domain = ((_judgement_domain = judgement.domain) != null ? _judgement_domain : []).filter((stem)=>stem !== object);
     // A hit naming the word it must name is of the site's world: a product's
     // category is that world even where it is the product's own object.
-    const world = required.length > 0 || domain.some((stem)=>hit.all.has(stem));
-    const worldLead = required.length > 0 && required.every((stem)=>hit.lead.has(stem)) || domain.some((stem)=>hit.lead.has(stem));
+    const world = required.length > 0 || kinNamed || domain.some((stem)=>hit.all.has(stem));
+    const worldLead = required.length > 0 && required.every((stem)=>hit.lead.has(stem)) || kinLead || domain.some((stem)=>hit.lead.has(stem));
     const pair = subject.length >= 2 ? subject.slice(-2).join(' ') : '';
-    const phrased = Boolean(pair) && hit.phrases.some((phrase)=>` ${phrase} `.includes(` ${pair} `));
+    const phrased = Boolean(pair) && among(hit.phrases, pair);
     let score = 0;
     if (judgement.strict && object) {
-        if (!hit.all.has(object)) return 0;
+        // An object with kin is named only by them: "melt" alone is resin art.
+        const named = kin.length ? kinNamed : hit.all.has(object);
+        if (!named) return 0;
+        const leading = kin.length ? kinLead : hit.lead.has(object);
+        // A lifestyle scene whose object is a last tag is not a photo OF it.
+        if (judgement.lead && !leading) return 0;
         if (domain.length && !world && !phrased) return 0;
-        score += hit.lead.has(object) ? 4 : 2;
+        score += leading ? 4 : 2;
+        if (kinNamed) score += 3;
     } else if (domain.length) {
         if (!world) return 0;
     }
@@ -793,6 +1342,9 @@ const EXTENSIONS = {
             delete request.broad;
             delete request.subject;
             delete request.requires;
+            delete request.object;
+            delete request.kin;
+            delete request.lead;
             const key = JSON.stringify([
                 request.query,
                 request.orientation,
@@ -894,9 +1446,10 @@ const EXTENSIONS = {
                 choices.push(null);
                 continue;
             }
-            const subject = aiStockSubjectWords(slot.alt, (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '');
+            const sectionName = (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : '';
+            const subject = aiStockSubjectWords(slot.alt, sectionName);
             let choice = null;
-            const requests = slot.product ? aiStockProductSearches(slot, terms.craft) : aiStockSearchesFor(slot, terms, subject);
+            const requests = slot.product ? aiStockProductSearches(slot, terms.craft, terms.domain) : aiStockSearchesFor(slot, terms, subject, aiStockSlotPart(slot, sectionName));
             for (const request of requests){
                 var _request_subject;
                 if (choice || signal.aborted) break;
@@ -910,9 +1463,17 @@ const EXTENSIONS = {
                 const ranked = aiStockRank(found, blocked, `${input.seed}:${index}:${request.query}`, _extends({
                     subject: (_request_subject = request.subject) != null ? _request_subject : request.broad ? '' : subject,
                     domain: terms.domain,
-                    strict: slot.role === 'gallery' && !request.broad || !!request.requires
+                    strict: slot.role === 'gallery' && !request.broad || !!request.requires,
+                    named: terms.named,
+                    rivals: terms.rivals
                 }, request.requires ? {
                     requires: request.requires
+                } : {}, request.object ? {
+                    object: request.object
+                } : {}, request.kin ? {
+                    kin: request.kin
+                } : {}, request.lead ? {
+                    lead: true
                 } : {}));
                 if (!ranked.length) continue;
                 const first = ranked[0];