@aglyn/plugins-ai 1.0.0-beta.269 → 1.0.0-beta.270

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

@@ -243,6 +243,12 @@ export interface AiStockSiteTerms {
     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[];
+    /**
+     * What a craft whose pictures are people at a moment shows wherever a page
+     * would show its maker ({@link aiStockWorkScenes}, AGL-3942): the scenes
+     * its site's own words name, set where the site is.
+     */
+    work?: AiStockScene[];
 }
 /** The site's terms, read from its business type. */
 export declare function aiStockSiteTerms(businessType: string): AiStockSiteTerms;
@@ -308,6 +314,8 @@ export interface AiStockSearch extends StockPhotoSearchRequest {
     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;
+    /** Stems of the places its hits are not set in, which none of their first tags name: a Blue Ridge couple's beach ({@link aiStockSettingAway}, AGL-3942). */
+    away?: 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}). */
@@ -355,6 +363,8 @@ export declare function aiStockRoleRefusals(role: Pick<AiStockPeopleRole, 'refus
  * anywhere on it, whatever else its words name ("school").
  */
 export declare function aiStockAdultsOnly(texts: ReadonlyArray<string | undefined>): boolean;
+/** The stems of the places a setting is not ({@link SCENE_SETTINGS}); none for no setting. */
+export declare function aiStockSettingAway(setting: string): string[];
 /** What a picture of a moment shows ({@link aiStockScene}). */
 export interface AiStockScene {
     /** The searches that ask for it, the people and their setting first. */
@@ -369,6 +379,8 @@ export interface AiStockScene {
     shun: string[];
     /** The stems of its words, which let in what they name: a family's children. */
     named: string[];
+    /** Stems of the places it is not set in, which none of a photo's first tags name ({@link aiStockSettingAway}, AGL-3942). */
+    away: string[];
 }
 /**
  * The scene a picture's words name (AGL-3856): the people at a moment, and
@@ -377,7 +389,7 @@ export interface AiStockScene {
  * 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;
+export declare function aiStockScene(text: string, siteSetting?: 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;
 /**
@@ -391,6 +403,17 @@ export declare function aiStockSetting(text: string): string;
  * neither names people at a moment nor a portrait.
  */
 export declare function aiStockRecordScene(name: string, category?: string, siteSetting?: string): AiStockScene | null;
+/**
+ * The work a craft whose pictures are people at a moment shows (AGL-3942):
+ * the scenes its site's own words name, in the order they name them, each
+ * set where the site is — a wedding photographer "for couples planning
+ * mountain weddings, and families" shows a wedding couple in the mountains
+ * and a family in the mountains. A family session still never shows a
+ * bride, whatever else the site names. Empty where its words name no people.
+ */
+export declare function aiStockWorkScenes(text: string, setting?: string): AiStockScene[];
+/** Whether a setting is a place a photo shows on its own, a landscape searched by its name: "mountains", never "autumn". */
+export declare function aiStockSettingIsLandscape(setting: string): boolean;
 /** 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". */
@@ -451,7 +474,15 @@ 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'>>, 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'>>, 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
+ * picture, a story of the craft, an intro's cover. Not a record (which shows
+ * its own moment, {@link aiStockShowsTheWork}), a portrait of the business's
+ * people, nor a product; and only where the site's words name the work.
+ */
+export declare function aiStockShowsItsWork(slot: Pick<AiLayoutPictureSlot, 'record' | 'people' | 'product'>, terms: Partial<Pick<AiStockSiteTerms, 'scenes' | 'work'>>): boolean;
 /**
  * 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
@@ -512,6 +543,8 @@ export interface AiStockJudgement {
     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[];
+    /** 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[];
 }
 /**
  * Whether a hit carries a topic its site never named ({@link SENSITIVE_TOPICS}):