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

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

@@ -130,6 +130,14 @@ import type { AiBuildPlan } from '../model/ai-build-plan';
  *    ("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.
+ * 9. **A world from the name** (the beta.261 Synchronicity Gym start,
+ *    AGL-3856: its business type "a local service business" named no world,
+ *    so its hero searched nothing and was left a black scrim, and its
+ *    closing band's "Ready to train" took a subway train). A business type
+ *    that names no world takes the craft its name, else its audience, names
+ *    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.
  *
  * 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
@@ -200,6 +208,8 @@ export interface AiStockSiteTerms {
     broad: string[];
     /** The searches for its maker at work, for a story of the craft (AGL-3660); empty for a craft not listed. */
     making: string[];
+    /** Whether a picture naming people at a moment is searched by its scene ({@link aiStockScene}, AGL-3856). */
+    scenes?: boolean;
     /** Every stem of the business type or brief: what lets a sensitive topic in ({@link SENSITIVE_TOPICS}). */
     named: string[];
     /** Rival crafts' words, each with the words that must then be named too ({@link CRAFT_KIN}). */
@@ -271,6 +281,14 @@ export interface AiStockSearch extends StockPhotoSearchRequest {
     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 its hits must name its object, whatever the slot's role: a scene's people (AGL-3856). */
+    strict?: boolean;
+    /** Words its hits never carry, whatever the brief names: a bride in a family session ({@link aiStockScene}). */
+    refuse?: readonly string[];
+    /** Stems of which every hit names one, whatever else it names: a scene's people, never roses alone ({@link aiStockScene}). */
+    needs?: readonly string[];
+    /** Stems its own words name, which let a topic in as the brief's do: a family session's children ({@link aiStockScene}). */
+    allow?: readonly string[];
     /** Whether it fills a product: no room, no scene, no fragrance bottle ({@link PRODUCT_SCENES}, AGL-3660). */
     product?: boolean;
     /** Words its hits never carry unless the slot or the brief names them ({@link AiStockSiteTerms.shun}). */
@@ -291,6 +309,29 @@ export type AiStockSlotPart = 'collection' | 'story';
  * the craft, or of a thing made by hand, shows the maker at work.
  */
 export declare function aiStockSlotPart(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt'>, sectionName: string): AiStockSlotPart | undefined;
+/** What a picture of a moment shows ({@link aiStockScene}). */
+export interface AiStockScene {
+    /** The searches that ask for it, the people and their setting first. */
+    queries: string[];
+    /** The words its photo is scored by: the people, and the setting. */
+    subject: string;
+    /** The thing a photo of it leads with, and its kin. */
+    object: string;
+    lead: string[];
+    /** Words of which a photo of it names one. */
+    people: string[];
+    shun: string[];
+    /** The stems of its words, which let in what they name: a family's children. */
+    named: string[];
+}
+/**
+ * The scene a picture's words name (AGL-3856): the people at a moment, and
+ * where — "Ridgetop Elopement" a couple in the mountains, "Mountain Wedding
+ * Day" a wedding couple in the mountains, "Family Session in the Fall" a
+ * family in autumn — read from every word, never only the first clause.
+ * `null` where it names no people.
+ */
+export declare function aiStockScene(text: string): AiStockScene | null;
 /** What a product falls back to once its own searches find nothing ({@link aiStockProductSearches}). */
 export interface AiStockProductFallback {
     /** The site's broad searches ({@link AiStockSiteTerms.broad}): "handmade soap". */
@@ -346,7 +387,7 @@ export interface AiStockProductFallback {
  */
 export declare function aiStockProductSearches(slot: Pick<AiLayoutPictureSlot, 'aspect' | 'product'>, craft: string, domain?: readonly string[], fallback?: AiStockProductFallback): AiStockSearch[];
 /** The searches a slot tries, in order, most specific first, each distinct. */
-export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'> & Partial<Pick<AiStockSiteTerms, 'making' | 'core'>>, subject: string, part?: AiStockSlotPart): AiStockSearch[];
+export declare function aiStockSearchesFor(slot: Pick<AiLayoutPictureSlot, 'role' | 'alt' | 'aspect'>, terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'domain' | 'broad'> & Partial<Pick<AiStockSiteTerms, 'making' | 'core' | 'scenes'>>, subject: string, part?: AiStockSlotPart): AiStockSearch[];
 /** What a hit is judged by. */
 export interface AiStockJudgement {
     /** The words the picture is of; empty for a picture of the site's world. */
@@ -387,6 +428,10 @@ export interface AiStockJudgement {
     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[];
+    /** Words a hit never carries, whatever the brief names ({@link AiStockSearch.refuse}). */
+    refuse?: readonly string[];
+    /** Stems of which a hit names one ({@link AiStockSearch.needs}). */
+    needs?: readonly string[];
 }
 /**
  * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):
@@ -423,11 +468,14 @@ export declare function aiStockPlacedSrcs(nodes: NodesMap | null | undefined): s
 /** Forgets every job's placed photos; for specs. */
 export declare function aiStockForgetJobPhotos(): void;
 /**
- * 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.
+ * A photo described from its own tags (AGL-3856): a short English phrase of
+ * what its first tags show — one or two things, or a thing and where it is,
+ * one person at most — never the library's comma-separated list: "A train at
+ * a station", "A confident lawyer in court", "A portrait of a businessman",
+ * "A board and chalk". A tag of how it looks is said before the thing it
+ * qualifies; an idea ("law", "feedback") is left out; a word inside another
+ * ("law" of "lawyer", "man" of "businessman") gives way to it; a mass noun
+ * takes no article. `null` where no tag names a thing.
  */
 export declare function aiStockTagsAlt(tags: readonly string[], proper?: ReadonlySet<string>): string | null;
 /**
@@ -455,7 +503,8 @@ export declare function aiStockTagsAlt(tags: readonly string[], proper?: Readonl
  * 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 as an English phrase ({@link aiStockTagsAlt}),
- * never the library's tag list. The libraries write in English, and no model
+ * never the library's tag list, and where no tag names a thing, the slot's
+ * own subject: its words, else its section's name. 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.
@@ -491,6 +540,20 @@ export interface AiLayoutStockPhotoSourceInput {
      * gave no photo words, rather than its business type in its own language.
      */
     kindWords?: string;
+    /**
+     * The business's name, as the person typed it (AGL-3856): what an English
+     * site is searched by when its business type names no world ("a local
+     * service business") and its name names a craft this module lists
+     * ("Synchronicity Gym"). Never its world otherwise.
+     */
+    name?: string;
+    /** Who the site is for, as the person typed it: searched as the name is, after it (AGL-3856). */
+    audience?: string;
+    /**
+     * The id of the kind of site the person picked ("education"): what a site
+     * is searched by when nothing else names its world (AGL-3856).
+     */
+    kind?: string;
     /** The page's section names, by plan index. */
     sectionNames: readonly string[];
     /**
@@ -510,13 +573,14 @@ export interface AiLayoutStockPhotoDeps {
     budgetMs?: number;
 }
 /**
- * A job's language and English photo words (AGL-3760), and the English name
- * of its kind of site (AGL-3771), as a stock photo source takes them.
+ * A job's language and English photo words (AGL-3760), the English name of
+ * its kind of site (AGL-3771), and the business's name and audience as the
+ * person typed them (AGL-3856), as a stock photo source takes them.
  */
 export declare function aiStockPhotoWordsOf(job: {
     plan?: Pick<AiBuildPlan, 'language' | 'photoWords'> | null;
     inputs?: Readonly<Record<string, unknown>> | null;
-}): Pick<AiLayoutStockPhotoSourceInput, 'language' | 'photoWords' | 'kindWords'>;
+}): Pick<AiLayoutStockPhotoSourceInput, 'language' | 'photoWords' | 'kindWords' | 'name' | 'audience' | 'kind'>;
 /**
  * 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
@@ -537,7 +601,23 @@ export declare function aiStockPhotoWordsSubject(photoWords: string): string;
  * every slot of every source — hero, background, gallery, card, product,
  * post — so no slot searches by words another slot is held against.
  */
-export declare function aiStockSourceTerms(input: Pick<AiLayoutStockPhotoSourceInput, 'business' | 'language' | 'photoWords' | 'kindWords'>): AiStockSiteTerms;
+export declare function aiStockSourceTerms(input: Pick<AiLayoutStockPhotoSourceInput, 'business' | 'language' | 'photoWords' | 'kindWords' | 'name' | 'audience' | 'kind'>): AiStockSiteTerms;
+/**
+ * Whether a business type is only an abbreviation the libraries do not know
+ * (AGL-3856): "LMS", "CRM", "B2B". Its letters are no world to search.
+ */
+export declare function aiStockIsAbbreviation(businessType: string): boolean;
+/** The kind of site a business's name or audience names ({@link NAMED_KINDS}), or empty. */
+export declare function aiStockNamedKind(text: string): string;
+/** What a kind of site's pictures are searched and judged by ({@link KIND_SUBJECTS}); `null` for a kind not listed. */
+export declare function aiStockKindTerms(kind: string): AiStockSiteTerms | null;
+/**
+ * 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
+ * Reyes Family Law". Empty where it names none, so a name that is only a
+ * name ("Hillside") never becomes a world.
+ */
+export declare function aiStockListedCraft(text: string): string;
 /**
  * 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.