@aglyn/plugins-ai 1.0.0-beta.263 → 1.0.0-beta.266

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}). */
@@ -218,6 +228,12 @@ export interface AiStockSiteTerms {
     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[];
+    /** Whether the site is for adults alone, so no photo of a child is placed on it ({@link aiStockAdultsOnly}, AGL-3856). */
+    adults?: boolean;
+    /** Where the site's own words set its pictures ({@link aiStockSetting}): a record's moment is set there where its words say nowhere (AGL-3856). */
+    setting?: string;
+    /** The craft's maker and tools as stems, which a record of its work never leads with ({@link CRAFT_KIN}, AGL-3856). */
+    maker?: string[];
 }
 /** The site's terms, read from its business type. */
 export declare function aiStockSiteTerms(businessType: string): AiStockSiteTerms;
@@ -271,6 +287,18 @@ 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[];
+    /** Stems no hit's first tags carry: a photographer or a camera on a portfolio's record, a toy frog ({@link aiStockRecordScene}, AGL-3856). */
+    refuseLead?: readonly string[];
+    /** Whether its hits are held to no world of the site's: a portfolio's record is of its subject, never of the craft (AGL-3856). */
+    worldless?: boolean;
     /** 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 +319,69 @@ 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;
+/** A role {@link aiStockPeopleRole} reads: its kin's stems, its search word, and whether a photo must name it. */
+export interface AiStockPeopleRole {
+    kin: string[];
+    query: string;
+    required: boolean;
+    /** Stems of the role being done, one of which a photo's first tags name ({@link AI_STOCK_ROLE_TAGS_READ}). */
+    scene?: string[];
+    /** Stems of something else being done, which none of a photo's first tags name. */
+    refuse?: string[];
+}
+/** How many of a photo's first tags show a role being done: "teacher, presentation, education, man, students" (AGL-3856). */
+export declare const AI_STOCK_ROLE_TAGS_READ = 6;
+/**
+ * The role a person's words say, else the first of the other texts that names
+ * one (their list's name): "Online learning coach" of the "Instructors" list
+ * is a coach. `null` where none names a listed role.
+ */
+export declare function aiStockPeopleRole(...texts: readonly string[]): AiStockPeopleRole | null;
+/** A role's refusals, less what the person's own words name: a "Drawing instructor" may be drawing. */
+export declare function aiStockRoleRefusals(role: Pick<AiStockPeopleRole, 'refuse'>, words: string): string[];
+/**
+ * Whether a site is for adults alone (AGL-3856), as its audience, its name
+ * or its business type says: "Adults finishing a high school diploma",
+ * "Brightpath Adult Learning Center". Then no photo of a child is placed
+ * anywhere on it, whatever else its words name ("school").
+ */
+export declare function aiStockAdultsOnly(texts: ReadonlyArray<string | undefined>): boolean;
+/** 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;
+/** Where a text's words set a picture ({@link SCENE_SETTINGS}): "mountains" of "Couples planning mountain weddings"; empty for none. */
+export declare function aiStockSetting(text: string): string;
+/**
+ * The moment a portfolio's record shows (AGL-3856): read from the record's
+ * own name first, then from what it is filed under, then as a portrait, and
+ * set where its name, its category or else the site's own words say. A
+ * photographer's "Getting Ready" filed under "Weddings and elopements" is a
+ * wedding couple in the mountains; "Milestone Portraits" filed under "Family
+ * portraits" a family. Its searches end on the people alone ("couple"), so a
+ * moment no photo shows in its setting still shows its people. `null` where
+ * neither names people at a moment nor a portrait.
+ */
+export declare function aiStockRecordScene(name: string, category?: string, siteSetting?: 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". */
@@ -345,8 +436,21 @@ export interface AiStockProductFallback {
  * Size" is a bath gift set.
  */
 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[];
+/**
+ * The searches a slot tries, in order, most specific first, each distinct.
+ * A portrait of one of the business's people ({@link AiLayoutPictureSlot.people})
+ * 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'>>, subject: string, part?: AiStockSlotPart, sectionName?: string): AiStockSearch[];
+/**
+ * Whether a slot is a portfolio's record of a craft whose work is people at a
+ * moment (AGL-3856): a photographer's "Mountain Elopements" shows an
+ * elopement, never the photographer. Searched by the moment its words and its
+ * category name, held to no world of the craft, and never led by the craft's
+ * own words, an animal or a toy unless the record names them.
+ */
+export declare function aiStockShowsTheWork(slot: Pick<AiLayoutPictureSlot, 'record' | 'role' | 'people' | 'product'>, terms: Partial<Pick<AiStockSiteTerms, 'scenes'>>): boolean;
 /** 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 +491,18 @@ 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[];
+    /** Stems no hit's first tags carry: a child, for a portrait of one of the business's people (AGL-3856). */
+    refuseLead?: readonly string[];
+    /** Stems naming the role a portrait shows, which a hit is preferred for naming, most of all first (AGL-3856). */
+    roles?: readonly string[];
+    /** Stems of the role being done, one of which a hit's first tags must name ({@link AiStockPeopleRole.scene}). */
+    roleScene?: readonly string[];
+    /** Stems of something else being done, which none of a hit's first tags may name ({@link AiStockPeopleRole.refuse}). */
+    roleRefuse?: readonly string[];
 }
 /**
  * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):
@@ -412,6 +528,19 @@ export declare function aiStockRelevance(photo: Pick<StockPhoto, 'tags' | 'alt'
  * the hits that score alike, so two jobs differ and one job repeats itself.
  */
 export declare function aiStockRank(photos: readonly StockPhoto[], used: ReadonlySet<string>, seed: string, judgement?: AiStockJudgement): StockPhoto[];
+/**
+ * Whether two hits are of one shoot (AGL-3856): one contributor's photos a few
+ * uploads apart, as Pixabay numbers them — the beta.265 Granite Peak Barbell
+ * coaches were four of one model, 728223 to 728229 — else one page address.
+ */
+export declare function aiStockSameShoot(a: Pick<StockPhoto, 'id' | 'photographer' | 'pageUrl'>, b: Pick<StockPhoto, 'id' | 'photographer' | 'pageUrl'>): boolean;
+/**
+ * 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.
+ */
+export declare function aiStockFreshShootsFirst(ranked: readonly StockPhoto[], shown: readonly StockPhoto[], judgement: AiStockJudgement): 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;
 /**
@@ -423,11 +552,27 @@ 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
+ * concrete things, never the library's comma-separated list: "A train at a
+ * station", "A confident lawyer in court", "A portrait of a businessman", "A
+ * photographer with a camera on a beach", "A kettlebell in a gym", "An analog
+ * camera". It says one person at most (a role over a man or a woman, an adult
+ * over a girl), what they hold or wear, or one or two things, and where:
+ *
+ * - an idea or a doing ("law", "feedback", "training", "a read",
+ *   "participation"), a maker's name ("sony"), a word for the photo itself
+ *   ("photo", "spot") and a look ("moody", "analog" alone, a season) are left
+ *   out; a quality ("elderly", "analog") is said before the one thing it
+ *   qualifies;
+ * - of two words for one thing the first tag's stays ("book" over
+ *   "bookwork", "camera" over "photo-camera"), unless the later phrase holds
+ *   it whole ("wedding dress" over "wedding");
+ * - a second thing comes only from the first two tags and where no place is
+ *   said, what a person holds only from the first three, where it is set
+ *   from the first ten;
+ * - no word is said twice: never "an elderly couple and an elderly".
+ *
+ * `null` where no tag names a thing.
  */
 export declare function aiStockTagsAlt(tags: readonly string[], proper?: ReadonlySet<string>): string | null;
 /**
@@ -455,7 +600,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 +637,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 +670,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
@@ -535,9 +696,26 @@ export declare function aiStockPhotoWordsSubject(photoWords: string): string;
  * its business named in English, else its plan's photo words' subject, else
  * its kind of site), every other site by its business type. One reading for
  * every slot of every source — hero, background, gallery, card, product,
- * post — so no slot searches by words another slot is held against.
+ * post — so no slot searches by words another slot is held against. A site for
+ * adults alone ({@link aiStockAdultsOnly}) is told so, whatever its world.
+ */
+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 aiStockSourceTerms(input: Pick<AiLayoutStockPhotoSourceInput, 'business' | 'language' | 'photoWords' | 'kindWords'>): AiStockSiteTerms;
+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.