@aglyn/plugins-ai 1.0.0-beta.285 → 1.0.0-beta.288

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

@@ -138,6 +138,36 @@ import type { AiBuildPlan } from '../model/ai-build-plan';
  *    where this module lists it ("gym" of "Synchronicity Gym"); and a
  *    training word's other senses (a railway's train, an elevator's lift, a
  *    newspaper's press, a boat's row) never fill a gym's picture.
+ * 10. **The trade, never a word of it** (the 2026-10-25 booth kit, AGL-4065:
+ *    six trades whose photos were race cars, cyclists, horses, a Honda
+ *    scooter, a canoe for "Parts for the ranch", hotel buffets for a taco
+ *    trailer and an office for a landscaper). A business named by two
+ *    things ("Motorcycle and dirt bike repair shop") is both; the craft
+ *    named first leads, never one named only in what a customer may ask
+ *    ("takes catering requests"); a hero's first tag and a broad search's
+ *    hit name the business's own world ({@link AiStockSiteTerms.lead}),
+ *    never any word of its type ("race" of "race car"); a two-word world
+ *    ("dirt bike") is named whole; a maker's name never shows; a sentence to
+ *    the reader, a job or an order is never a subject, and a part or gear is
+ *    searched only with its world; a record's cover is searched in its world
+ *    first; and a listed world widens only where the library knew nothing of
+ *    it, never an outdoor or a trade world to an office.
+ * 11. **The thing, the place and the trade** (the 2026-10-28 live check,
+ *    AGL-4092: a bare foot tagged "body part" for a parts shop's "Engine and
+ *    air", a transmission chain for its "Brake Pad Set", a cat tagged "hungry"
+ *    for a taco trailer's "Come hungry", a European alley for "Around town", a
+ *    taco bowl salad for "Race day", and a man posing with a street bike tagged
+ *    "susuki" in a motocross team's band of pictures). A picture of a thing is
+ *    held to the business's own world, never any word of its type; a feeling,
+ *    a time or a way of being somewhere is never a thing, and "around town" is
+ *    the business's customers out there; a broad search's photo is OF the
+ *    world among its first tags, never a "taco bowl"; an animal, a toy or a
+ *    bare body part never leads a photo naming nothing of the world; a trade's
+ *    things are held to the world it serves, never to "part"; a product takes
+ *    a shoot no other product shows; a motocross business's world is
+ *    off-road; and a maker is named one letter off ("susuki") and by its
+ *    gear's and tires' names. Still by the tags: a mark only the pixels show
+ *    is placed.
  *
  * 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
@@ -207,6 +237,9 @@ export declare function aiStockStem(word: string): string;
  * of an English noun phrase is at its end). "ceramic artist" from "a
  * portfolio for a ceramic artist who makes stoneware bowls"; "candle shop"
  * from "a small-batch candle shop selling hand-poured soy candles online".
+ * A business named by two things joined by "and" is its second noun phrase
+ * whole: "dirt bike repair shop" of "Motorcycle and dirt bike repair shop"
+ * (AGL-4065).
  */
 export declare function aiStockBusinessWords(businessType: string): string;
 /**
@@ -229,6 +262,28 @@ export interface AiStockSiteTerms {
      * held to it.
      */
     domain: string[];
+    /**
+     * The business's own world (AGL-4065): the listed crafts its own clause
+     * names, their names and kin, and its own words where no craft covers
+     * them, as stems and stem pairs ("dirt bike"). What a hero's first tag and a
+     * broad search's hit name. Its whole domain where no craft is listed.
+     */
+    lead?: string[];
+    /**
+     * The world a trade serves, as its type names it, where the craft is the
+     * trade ("dirt bike" for a parts shop's craft "part", AGL-4065): what its
+     * pictures are qualified by in place of the craft.
+     */
+    leadWord?: string;
+    /**
+     * What a trade's pictures of a thing must name, where the craft is the
+     * trade (AGL-4092): the names of the world it serves ("dirt bike",
+     * "motocross"), never its craft. A parts shop's "part" named a bare foot
+     * tagged "body part" and a transmission tagged "mechanical part".
+     */
+    held?: string[];
+    /** What a picture of the business out where it is asks for ({@link CRAFT_KIN}, AGL-4092). */
+    out?: string[];
     /** The searches for the site's world itself, broadest last. */
     broad: string[];
     /** The searches for its maker at work, for a story of the craft (AGL-3660); empty for a craft not listed. */
@@ -266,20 +321,39 @@ export interface AiStockSiteTerms {
      */
     work?: AiStockScene[];
 }
-/** The site's terms, read from its business type. */
+/**
+ * The site's terms, read from its business type.
+ *
+ * Two worlds are read (AGL-4065). Its DOMAIN is everything its words name
+ * of its world, what a picture of a thing is held to. Its LEAD is the
+ * business's own world: the listed crafts its own clause names (and the
+ * craft's), their names and kin, and the clause's own words where no craft
+ * covers them, never a word that names a world only beside another ("race",
+ * "team") nor what a customer is asked to do. A hero's first tag and a broad
+ * search's hit name the lead: the Rut Runners heroes, held to every word of
+ * "Amateur motocross race team: rider profiles, race schedule…", took race
+ * cars because "race car" named "race". Of the crafts its words list, the one
+ * named first leads (a taco trailer that "takes catering requests" is a taco
+ * trailer), and a craft named only in what a customer may ask for gives the
+ * site no searches of its own.
+ */
 export declare function aiStockSiteTerms(businessType: string): AiStockSiteTerms;
 /**
  * A picture's subject in a few words (AGL-3660): the noun phrase its alt
  * text opens with — its first clause holding more than filler, cut where a
  * preposition starts the setting, filler dropped, its last three words (the
- * head noun is the last) — else its section's name.
+ * head noun is the last) — else its section's name. A word or two joined by
+ * "and" to a longer noun phrase only modify its head: the subject of "Potato
+ * and egg breakfast taco" is "egg breakfast taco", never "potato" (AGL-4065).
  */
 export declare function aiStockSubjectWords(alt: string, sectionName: string): string;
 /**
  * The thing a subject shows, one singular word: its last word that is not
  * a set or a wrapper of it — "bowl" from "nesting bowl set", "candle" from
  * "candle gift set", "vase" from "bud vase". Its last word when every word
- * is one ("gift set").
+ * is one ("gift set"). A feeling, a time or a way of being somewhere is
+ * never one ({@link NON_THINGS}, AGL-4092): "Come hungry" and "Around town"
+ * show no thing, and "Race day" is of the race.
  */
 export declare function aiStockObjectWord(subject: string): string;
 /** The frame's orientation: a wide frame wants a landscape photo, a tall one a portrait. */
@@ -309,6 +383,25 @@ 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 one of the hit's first tags must be OF the business's own world
+     * ({@link AiStockSiteTerms.lead}, AGL-4092): naming it, and ending in a word
+     * of it. "Taco bowl" is a bowl and "body part" a part: a taco trailer's
+     * "Race day" took a chicken salad tagged "taco bowl".
+     */
+    leadOwn?: boolean;
+    /**
+     * Stems of things a picture is never OF unless its words or the brief name
+     * them, refused among a hit's first tags where those name nothing of the
+     * business's own world ({@link aiStockOddLeads}, AGL-4092): a cat, a bare foot.
+     */
+    oddLeads?: readonly string[];
+    /**
+     * The world a trade serves, one of whose names every hit names, its kin or
+     * not ({@link AiStockSiteTerms.held}, AGL-4092): a dirt bike shop's "Brake
+     * Pad Set" is never a railway wagon's brake wheel tagged "brake".
+     */
+    served?: readonly string[];
     /**
      * 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
@@ -436,6 +529,10 @@ export interface AiStockProductFallback {
     broad?: readonly string[];
     /** The words a photo of the craft itself names ({@link AiStockSiteTerms.core}). */
     core?: readonly string[];
+    /** The world a trade serves, which its products name in place of the craft ({@link AiStockSiteTerms.held}, AGL-4092). */
+    held?: readonly string[];
+    /** The word a trade's product is searched with in place of its craft ({@link AiStockSiteTerms.leadWord}, AGL-4092). */
+    leadWord?: string;
 }
 /**
  * A product's searches (AGL-3676), most specific first: each of its subjects
@@ -490,7 +587,7 @@ export declare function aiStockProductSearches(slot: Pick<AiLayoutPictureSlot, '
  * asks first for the role its words or its list's name (`sectionName`) say,
  * in the site's world: "teacher classroom" for a "Math instructor" (AGL-3856).
  */
-export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect' | 'people' | 'record' | 'product'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'> & Partial<Pick<AiStockSiteTerms, 'making' | 'core' | 'scenes' | 'setting' | 'maker' | 'work'>>, subject: string, part?: AiStockSlotPart, sectionName?: string): AiStockSearch[];
+export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect' | 'people' | 'record' | 'product'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'> & Partial<Pick<AiStockSiteTerms, 'making' | 'core' | 'scenes' | 'setting' | 'maker' | 'work' | 'leadWord' | 'held' | 'out'>>, subject: string, part?: AiStockSlotPart, sectionName?: string): AiStockSearch[];
 /**
  * Whether a picture of a craft's site whose pictures are people at a moment
  * shows that work wherever a page would show the maker (AGL-3942): an about
@@ -513,6 +610,12 @@ export interface AiStockJudgement {
     subject?: string;
     /** The site's domain stems ({@link AiStockSiteTerms.domain}). */
     domain?: readonly string[];
+    /**
+     * The business's own world ({@link AiStockSiteTerms.lead}, AGL-4065): what a
+     * hero's first tag and a hit of a search that is not of a thing name. The
+     * domain where absent.
+     */
+    world?: readonly string[];
     /**
      * Whether a hit must name the subject's object. A broad search, a hero
      * and an about picture need only name the domain.
@@ -530,6 +633,12 @@ export interface AiStockJudgement {
     lead?: boolean;
     /** Whether the hit's first tags must name the site's world ({@link AiStockSearch.leadWorld}). */
     leadWorld?: boolean;
+    /** Whether one of the hit's first tags must be OF the business's own world ({@link AiStockSearch.leadOwn}, AGL-4092). */
+    leadOwn?: boolean;
+    /** Stems no hit's first tags lead with while they name nothing of the business's own world ({@link AiStockSearch.oddLeads}, AGL-4092). */
+    oddLeads?: readonly string[];
+    /** The world a trade serves, which every hit names ({@link AiStockSearch.served}, AGL-4092). */
+    served?: readonly string[];
     /** 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}). */
@@ -562,6 +671,17 @@ export interface AiStockJudgement {
     /** Stems of the places the picture is not set in, which none of a hit's first tags may name ({@link AiStockSearch.away}). */
     away?: readonly string[];
 }
+/**
+ * What a picture of a business's world is never OF unless its words name it
+ * (AGL-4092): an animal or a toy (as a portfolio's record never is,
+ * {@link RECORD_ODD_LEADS}), or a bare body part. Each group is let in whole
+ * by any of its words in `said` — the slot's words, its section's, the
+ * brief's — so a dog groomer's pictures show dogs and cats alike. As stems;
+ * the body's left out where `body` is false (a portrait's face).
+ */
+export declare function aiStockOddLeads(said: readonly string[], options?: {
+    body?: boolean;
+}): string[];
 /**
  * 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.
@@ -596,9 +716,13 @@ export declare function aiStockSameShoot(a: Pick<StockPhoto, 'id' | 'photographe
  * A search's ranked hits with those of a shoot no slot shows yet first among
  * the best (AGL-3856): a team's three cards are three people where the
  * library has them, never one model three times while another fits as well.
- * Every other order is kept.
+ * Every other order is kept. A product's are of a shoot no slot shows yet
+ * first among ALL its accepted hits (`whole`, AGL-4092): Berm & Bolt's two
+ * tires were one contributor's shoot, 32 uploads apart.
  */
-export declare function aiStockFreshShootsFirst(ranked: readonly StockPhoto[], shown: readonly StockPhoto[], judgement: AiStockJudgement): StockPhoto[];
+export declare function aiStockFreshShootsFirst(ranked: readonly StockPhoto[], shown: readonly StockPhoto[], judgement: AiStockJudgement, options?: {
+    whole?: boolean;
+}): StockPhoto[];
 /** The pick among a search's hits: the first {@link aiStockRank} would try, or `null`. */
 export declare function aiStockPick(photos: readonly StockPhoto[], used: ReadonlySet<string>, seed: string, judgement?: AiStockJudgement): StockPhoto | null;
 /**
@@ -841,10 +965,12 @@ export declare function aiStockWorldIsUnlisted(terms: Pick<AiStockSiteTerms, 'bu
  * "freelencing", which no library tags, so its cover hero searched it, found
  * nothing, and shipped a flat dark band with no photo.
  */
-export declare function aiStockWiderTerms(terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'broad' | 'domain'>, kind: string): Array<{
+export declare function aiStockWiderTerms(terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'broad' | 'domain'> & Partial<Pick<AiStockSiteTerms, 'lead'>>, kind: string): Array<{
     rung: 'kind' | 'starter' | 'generic';
     terms: AiStockSiteTerms;
 }>;
+/** Whether a site's own world is outdoors, on a vehicle, with tools or over food ({@link OUTDOOR_AND_TRADE_STEMS}). */
+export declare function aiStockWorldIsOutdoorOrTrade(terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain'> & Partial<Pick<AiStockSiteTerms, 'lead'>>): boolean;
 /**
  * The first word of a text that names a craft {@link CRAFT_KIN} lists, as
  * its table writes it: "gym" of "Synchronicity Gym", "law" of "Hartwell
@@ -852,6 +978,28 @@ export declare function aiStockWiderTerms(terms: Pick<AiStockSiteTerms, 'busines
  * name ("Hillside") never becomes a world.
  */
 export declare function aiStockListedCraft(text: string): string;
+/**
+ * How a search's hits are judged for a slot (AGL-3660), as the source judges
+ * them: by the search's own words, held to the world it was asked for — the
+ * site's own (`site`), or a wider one where the site's found nothing
+ * (`world`, AGL-3923). What lets a sensitive topic, an animal or a body part
+ * in is always the site's own words. On a site for adults alone no hit names
+ * a child; a portrait of one of the business's people names an adult, never
+ * leads with a child, and is preferred in its role (AGL-3856). Any other
+ * picture never leads with an animal, a toy or a bare body part its words
+ * and the brief do not name, unless its first tags name the business's own
+ * world too (AGL-4092): Pit Row Tacos' "Come hungry" took a cat. Pure.
+ */
+export declare function aiStockJudgementFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'people' | 'product'>, request: AiStockSearch, subject: string, site: AiStockSiteTerms, sectionName?: string, world?: AiStockSiteTerms): AiStockJudgement;
+/**
+ * The craft's own photos, the last thing a slot of a craft's site is filled
+ * from (AGL-3660): its broad searches, any hit naming the craft itself. Never
+ * a desk, a laptop or a living room for a soap shop. A picture that is not a
+ * hero nor a product takes only a photo OF the business's own world among its
+ * first tags (AGL-4092): a taco trailer's "Race day" took a chicken salad
+ * tagged "taco bowl". Pure.
+ */
+export declare function aiStockCraftSearches(slot: Pick<AiLayoutPictureSlot, 'role' | 'aspect' | 'record' | 'people' | 'product'>, world: AiStockSiteTerms): AiStockSearch[];
 /**
  * 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.