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

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

@@ -158,6 +158,15 @@ export declare const AI_LAYOUT_STOCK_SEARCHES_PER_PAGE = 18;
 export declare const AI_LAYOUT_STOCK_PICK_WINDOW = 40;
 /** The largest photo copied: inside one direct upload. */
 export declare const AI_LAYOUT_STOCK_MAX_BYTES: number;
+/**
+ * The media library's refusals that are about ONE photo's own bytes, as the
+ * console's `ingestMedia` returns them (AGL-3923): 415 for a type or contents
+ * it does not accept, 413 for a photo too large to store, 451 for a file
+ * held in quarantine. The slot then tries its next hit, and the page goes on
+ * storing. Every other refusal (403 from the storage band, the site's scope
+ * or a lockdown; 500) holds for the whole page.
+ */
+export declare const AI_STOCK_PHOTO_OWN_REFUSALS: ReadonlySet<number>;
 /**
  * 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).
@@ -228,6 +237,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;
@@ -289,6 +304,10 @@ export interface AiStockSearch extends StockPhotoSearchRequest {
     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}). */
@@ -309,6 +328,33 @@ 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. */
@@ -332,6 +378,19 @@ export interface AiStockScene {
  * `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". */
@@ -386,8 +445,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' | 'scenes'>>, 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. */
@@ -432,6 +504,14 @@ export interface AiStockJudgement {
     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}):
@@ -457,6 +537,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;
 /**
@@ -469,13 +562,26 @@ export declare function aiStockPlacedSrcs(nodes: NodesMap | null | undefined): s
 export declare function aiStockForgetJobPhotos(): void;
 /**
  * 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.
+ * 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;
 /**
@@ -599,7 +705,8 @@ 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;
 /**
@@ -611,6 +718,32 @@ export declare function aiStockIsAbbreviation(businessType: string): boolean;
 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;
+/**
+ * Whether a site's world is only its own words (AGL-3923): no craft this
+ * module lists and no kind of site named it, so its broad searches are its
+ * business and its craft read back ("freelencing"), which a library may not
+ * know at all.
+ */
+export declare function aiStockWorldIsUnlisted(terms: Pick<AiStockSiteTerms, 'business' | 'craft' | 'broad'>): boolean;
+/**
+ * What a picture is searched by once nothing narrower found it a photo
+ * (AGL-3923), widest last: the kind of site the person picked, the kind its
+ * starter is the shape of, and the starter's own common photos
+ * ({@link STARTER_GENERIC}). Only a site whose world is its own words alone
+ * ({@link aiStockWorldIsUnlisted}) widens: a craft this module lists, or a
+ * world read from the kind of site, keeps its slots to that world, and a slot
+ * nothing in it fits keeps no photo rather than an office (AGL-3831). A rung
+ * that would search what an earlier one did is left out.
+ *
+ * The beta.265 Kasvora Marketing Solutions start (job BK3r4I8bF1) typed its
+ * business as "Freelencing site offer services": its world was the one word
+ * "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'>, kind: string): Array<{
+    rung: 'kind' | 'starter' | 'generic';
+    terms: AiStockSiteTerms;
+}>;
 /**
  * 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