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

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

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginMediaAsset } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest';
+import type { AiLayoutPicturePhoto, AiLayoutPictureSlot, AiLayoutPictureSource } from '../layout-language/ai-layout-pictures';
+import { aiLayoutStockPhotoSource, type AiLayoutStockPhotoDeps, type AiLayoutStockPhotoSourceInput } from './ai-layout-stock-photos';
+/**
+ * THE BUSINESS'S OWN PHOTOS COME FIRST (AGL-3957).
+ *
+ * A site built for an owner at a booth or on a doorstep has, by the time its
+ * pages are drawn, the photos they sent from their phone through a site
+ * photo link: their van, their shop, their work. A photo of the owner's own
+ * work beats any stock photo, so a page's picture slots are filled from
+ * those first, and only the slots left over are searched for in the stock
+ * library, the way they were before.
+ *
+ * Which photo goes where is decided by shape and size, not by subject: an
+ * owner's photo says nothing a search could read. The hero takes the widest
+ * photo among the largest; the about picture takes the next largest; the
+ * gallery takes the rest, newest first, each photo once on the page and once
+ * across the job (`avoid`). A product's photo, a person's portrait and a
+ * record's cover are of one named thing, which a photo of the business in
+ * general is not, so those slots go to the stock search untouched.
+ */
+export interface AiLayoutOwnerPhotoDeps extends AiLayoutStockPhotoDeps {
+    /** The stock source the leftover slots go to; the real one otherwise. Specs hand in a fake. */
+    stock?: typeof aiLayoutStockPhotoSource;
+    /** The most owner photos read for one page. */
+    limit?: number;
+}
+/** A slot an owner's photo may fill: one of the business in general, not of one named thing. */
+export declare function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean;
+/**
+ * Assigns the owner's photos to the slots, in the order above. Pure, so a
+ * spec can hold the choice itself: `null` for a slot left to the stock
+ * search, in slot order.
+ */
+export declare function aiAssignOwnerPhotos(slots: readonly AiLayoutPictureSlot[], photos: readonly PluginMediaAsset[], avoid?: ReadonlySet<string>): Array<AiLayoutPicturePhoto | null>;
+/**
+ * The source for one page: the owner's photos for the slots they fit, the
+ * stock library for the rest. `null` only when neither can answer — no
+ * media door and no stock library — which leaves every slot to the starters.
+ */
+export declare function aiLayoutSitePhotoSource(input: AiLayoutStockPhotoSourceInput, deps?: AiLayoutOwnerPhotoDeps): AiLayoutPictureSource | null;

package/src/lib/jobs/ai-layout-owner-photos.js

@@ -0,0 +1,110 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { pluginMediaIngest } from "@aglyn/aglyn/plugin-manager/plugin-media-ingest";
+import { aiLayoutStockPhotoSource } from "./ai-layout-stock-photos.js";
+const OWNER_PHOTOS_LIMIT = 60;
+/** A slot an owner's photo may fill: one of the business in general, not of one named thing. */ export function aiOwnerPhotoFits(slot) {
+    return !slot.product && !slot.people && !slot.record;
+}
+/** Fill order: the hero first, so the biggest photo is the first one seen; then about; then the gallery in document order. */ const ROLE_RANK = {
+    hero: 0,
+    about: 1,
+    gallery: 2
+};
+function area(photo) {
+    var _photo_width, _photo_height;
+    return ((_photo_width = photo.width) != null ? _photo_width : 0) * ((_photo_height = photo.height) != null ? _photo_height : 0);
+}
+/**
+ * Assigns the owner's photos to the slots, in the order above. Pure, so a
+ * spec can hold the choice itself: `null` for a slot left to the stock
+ * search, in slot order.
+ */ export function aiAssignOwnerPhotos(slots, photos, avoid = new Set()) {
+    const pool = photos.filter((photo)=>{
+        var _photo_width, _photo_height;
+        return photo.src && ((_photo_width = photo.width) != null ? _photo_width : 0) > 0 && ((_photo_height = photo.height) != null ? _photo_height : 0) > 0 && !avoid.has(photo.src);
+    }).sort((a, b)=>area(b) - area(a));
+    const answers = slots.map(()=>null);
+    const used = new Set();
+    const order = slots.map((slot, index)=>({
+            slot,
+            index
+        })).filter(({ slot })=>aiOwnerPhotoFits(slot)).sort((a, b)=>ROLE_RANK[a.slot.role] - ROLE_RANK[b.slot.role] || a.index - b.index);
+    for (const { slot, index } of order){
+        const free = pool.filter((photo)=>!used.has(photo.src));
+        if (!free.length) break;
+        // The hero wants the widest of the three largest; a portrait phone photo
+        // in a wide frame is the one mismatch a visitor sees first.
+        const pick = slot.role === 'hero' ? [
+            ...free.slice(0, 3)
+        ].sort((a, b)=>{
+            var _b_width, _b_height, _a_width, _a_height;
+            return ((_b_width = b.width) != null ? _b_width : 0) / ((_b_height = b.height) != null ? _b_height : 1) - ((_a_width = a.width) != null ? _a_width : 0) / ((_a_height = a.height) != null ? _a_height : 1);
+        })[0] : free[0];
+        if (!pick) break;
+        used.add(pick.src);
+        answers[index] = _extends({
+            src: pick.src,
+            width: pick.width,
+            height: pick.height
+        }, pick.alt ? {
+            alt: pick.alt
+        } : {});
+    }
+    return answers;
+}
+/**
+ * The source for one page: the owner's photos for the slots they fit, the
+ * stock library for the rest. `null` only when neither can answer — no
+ * media door and no stock library — which leaves every slot to the starters.
+ */ export function aiLayoutSitePhotoSource(input, deps = {}) {
+    var _deps_stock, _deps_ingest;
+    var _ingest_listOwnerPhotos;
+    const stock = ((_deps_stock = deps.stock) != null ? _deps_stock : aiLayoutStockPhotoSource)(input, deps);
+    const ingest = ((_deps_ingest = deps.ingest) != null ? _deps_ingest : pluginMediaIngest)();
+    const list = ingest == null ? void 0 : (_ingest_listOwnerPhotos = ingest.listOwnerPhotos) == null ? void 0 : _ingest_listOwnerPhotos.bind(ingest);
+    if (!list || !input.hostId) return stock;
+    return async (slots)=>{
+        var _input_avoid;
+        let photos = [];
+        try {
+            var _deps_limit;
+            photos = await list({
+                hostId: input.hostId,
+                limit: (_deps_limit = deps.limit) != null ? _deps_limit : OWNER_PHOTOS_LIMIT
+            });
+        } catch (error) {
+            console.warn('ai layout pictures: the owner photos could not be read; stock photos fill the page', {
+                error
+            });
+        }
+        const answers = aiAssignOwnerPhotos(slots, photos, new Set((_input_avoid = input.avoid) != null ? _input_avoid : []));
+        if (!stock) return answers;
+        const open = slots.filter((_slot, index)=>!answers[index]);
+        if (!open.length) return answers;
+        // The stock source sees only the slots the owner's photos left, so its
+        // own no-repeat rules and search budget are spent on those alone.
+        const found = await stock(open);
+        let next = 0;
+        return answers.map((answer)=>{
+            var _ref;
+            return (_ref = answer != null ? answer : found[next++]) != null ? _ref : null;
+        });
+    };
+}
+
+//# sourceMappingURL=ai-layout-owner-photos.js.map

package/src/lib/jobs/ai-layout-owner-photos.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-layout-owner-photos.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginMediaAsset } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport { pluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest'\nimport type {\n  AiLayoutPicturePhoto,\n  AiLayoutPictureSlot,\n  AiLayoutPictureSource,\n} from '../layout-language/ai-layout-pictures'\nimport {\n  aiLayoutStockPhotoSource,\n  type AiLayoutStockPhotoDeps,\n  type AiLayoutStockPhotoSourceInput,\n} from './ai-layout-stock-photos'\n\n/**\n * THE BUSINESS'S OWN PHOTOS COME FIRST (AGL-3957).\n *\n * A site built for an owner at a booth or on a doorstep has, by the time its\n * pages are drawn, the photos they sent from their phone through a site\n * photo link: their van, their shop, their work. A photo of the owner's own\n * work beats any stock photo, so a page's picture slots are filled from\n * those first, and only the slots left over are searched for in the stock\n * library, the way they were before.\n *\n * Which photo goes where is decided by shape and size, not by subject: an\n * owner's photo says nothing a search could read. The hero takes the widest\n * photo among the largest; the about picture takes the next largest; the\n * gallery takes the rest, newest first, each photo once on the page and once\n * across the job (`avoid`). A product's photo, a person's portrait and a\n * record's cover are of one named thing, which a photo of the business in\n * general is not, so those slots go to the stock search untouched.\n */\n\nexport interface AiLayoutOwnerPhotoDeps extends AiLayoutStockPhotoDeps {\n  /** The stock source the leftover slots go to; the real one otherwise. Specs hand in a fake. */\n  stock?: typeof aiLayoutStockPhotoSource\n  /** The most owner photos read for one page. */\n  limit?: number\n}\n\nconst OWNER_PHOTOS_LIMIT = 60\n\n/** A slot an owner's photo may fill: one of the business in general, not of one named thing. */\nexport function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean {\n  return !slot.product && !slot.people && !slot.record\n}\n\n/** Fill order: the hero first, so the biggest photo is the first one seen; then about; then the gallery in document order. */\nconst ROLE_RANK = { hero: 0, about: 1, gallery: 2 } as const\n\nfunction area(photo: PluginMediaAsset): number {\n  return (photo.width ?? 0) * (photo.height ?? 0)\n}\n\n/**\n * Assigns the owner's photos to the slots, in the order above. Pure, so a\n * spec can hold the choice itself: `null` for a slot left to the stock\n * search, in slot order.\n */\nexport function aiAssignOwnerPhotos(\n  slots: readonly AiLayoutPictureSlot[],\n  photos: readonly PluginMediaAsset[],\n  avoid: ReadonlySet<string> = new Set(),\n): Array<AiLayoutPicturePhoto | null> {\n  const pool = photos\n    .filter((photo) => photo.src && (photo.width ?? 0) > 0 && (photo.height ?? 0) > 0 && !avoid.has(photo.src))\n    .sort((a, b) => area(b) - area(a))\n  const answers: Array<AiLayoutPicturePhoto | null> = slots.map(() => null)\n  const used = new Set<string>()\n  const order = slots\n    .map((slot, index) => ({ slot, index }))\n    .filter(({ slot }) => aiOwnerPhotoFits(slot))\n    .sort((a, b) => ROLE_RANK[a.slot.role] - ROLE_RANK[b.slot.role] || a.index - b.index)\n  for (const { slot, index } of order) {\n    const free = pool.filter((photo) => !used.has(photo.src))\n    if (!free.length) break\n    // The hero wants the widest of the three largest; a portrait phone photo\n    // in a wide frame is the one mismatch a visitor sees first.\n    const pick =\n      slot.role === 'hero'\n        ? [...free.slice(0, 3)].sort(\n            (a, b) => (b.width ?? 0) / (b.height ?? 1) - (a.width ?? 0) / (a.height ?? 1),\n          )[0]\n        : free[0]\n    if (!pick) break\n    used.add(pick.src)\n    answers[index] = {\n      src: pick.src,\n      width: pick.width as number,\n      height: pick.height as number,\n      ...(pick.alt ? { alt: pick.alt } : {}),\n    }\n  }\n  return answers\n}\n\n/**\n * The source for one page: the owner's photos for the slots they fit, the\n * stock library for the rest. `null` only when neither can answer — no\n * media door and no stock library — which leaves every slot to the starters.\n */\nexport function aiLayoutSitePhotoSource(\n  input: AiLayoutStockPhotoSourceInput,\n  deps: AiLayoutOwnerPhotoDeps = {},\n): AiLayoutPictureSource | null {\n  const stock = (deps.stock ?? aiLayoutStockPhotoSource)(input, deps)\n  const ingest = (deps.ingest ?? pluginMediaIngest)()\n  const list = ingest?.listOwnerPhotos?.bind(ingest)\n  if (!list || !input.hostId) return stock\n  return async (slots) => {\n    let photos: PluginMediaAsset[] = []\n    try {\n      photos = await list({ hostId: input.hostId, limit: deps.limit ?? OWNER_PHOTOS_LIMIT })\n    } catch (error) {\n      console.warn('ai layout pictures: the owner photos could not be read; stock photos fill the page', { error })\n    }\n    const answers = aiAssignOwnerPhotos(slots, photos, new Set(input.avoid ?? []))\n    if (!stock) return answers\n    const open = slots.filter((_slot, index) => !answers[index])\n    if (!open.length) return answers\n    // The stock source sees only the slots the owner's photos left, so its\n    // own no-repeat rules and search budget are spent on those alone.\n    const found = await stock(open)\n    let next = 0\n    return answers.map((answer) => answer ?? found[next++] ?? null)\n  }\n}\n"],"names":["pluginMediaIngest","aiLayoutStockPhotoSource","OWNER_PHOTOS_LIMIT","aiOwnerPhotoFits","slot","product","people","record","ROLE_RANK","hero","about","gallery","area","photo","width","height","aiAssignOwnerPhotos","slots","photos","avoid","Set","pool","filter","src","has","sort","a","b","answers","map","used","order","index","role","free","length","pick","slice","add","alt","aiLayoutSitePhotoSource","input","deps","ingest","stock","list","listOwnerPhotos","bind","hostId","limit","error","console","warn","open","_slot","found","next","answer"],"mappings":"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"}

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

@@ -17,7 +17,7 @@
 import { type PluginMediaIngest } from '@aglyn/aglyn/plugin-manager/plugin-media-ingest';
 import { type StockPhoto, type StockPhotoOrientation, type StockPhotoProvider, type StockPhotoSearchRequest } from '@aglyn/aglyn/plugin-manager/stock-photo-provider';
 import type { NodesMap } from '@aglyn/aglyn/types/nodes';
-import { type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-language/ai-layout-pictures';
+import { type AiLayoutPicturePhoto, type AiLayoutPictureSlot, type AiLayoutPictureSource } from '../layout-language/ai-layout-pictures';
 import type { AiBuildPlan } from '../model/ai-build-plan';
 /**
  * STOCK PHOTOS FOR A LANGUAGE PAGE'S PICTURE SLOTS (AGL-3660).
@@ -178,6 +178,14 @@ export declare const AI_STOCK_PHOTO_PAGES_INPUT = "stockPhotoPages";
  * (AGL-3616) — which a page does not place again.
  */
 export declare const AI_STOCK_PHOTO_AVOID_INPUT = "stockPhotoAvoid";
+/**
+ * The unit job input holding the photos another part of the job placed
+ * outside its pages — a dataset's records — with their size and words
+ * (AGL-3988): what a picture the library failed takes before any starter.
+ */
+export declare const AI_STOCK_PHOTO_JOB_PHOTOS_INPUT = "stockPhotoJobPhotos";
+/** The job photos a unit input holds ({@link AI_STOCK_PHOTO_JOB_PHOTOS_INPUT}): library photos with a size; anything else is dropped. */
+export declare function aiStockJobPhotosOf(value: unknown): AiLayoutPicturePhoto[];
 /**
  * A word's singular, for matching only: "bowls" and "bowl", "vases" and
  * "vase", "berries" and "berry", "dishes" and "dish" meet. Both sides of a
@@ -243,6 +251,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 +322,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 +371,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 +387,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 +397,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 +411,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 +482,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 +551,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}):
@@ -558,6 +599,13 @@ export declare function aiStockPick(photos: readonly StockPhoto[], used: Readonl
  * not the job's, and are not listed.
  */
 export declare function aiStockPlacedSrcs(nodes: NodesMap | null | undefined): string[];
+/**
+ * The library photos a stored page shows, each as a slot takes it (AGL-3988):
+ * its source, its size and what it shows. A photo the job placed on another
+ * page is what a slot the library failed takes before any starter
+ * (`aiLayoutJobPhotoPicks`). Each photo once; one without a size is left out.
+ */
+export declare function aiStockPlacedPhotos(nodes: NodesMap | null | undefined): AiLayoutPicturePhoto[];
 /** Forgets every job's placed photos; for specs. */
 export declare function aiStockForgetJobPhotos(): void;
 /**
@@ -579,7 +627,17 @@ export declare function aiStockForgetJobPhotos(): void;
  * - 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".
+ * - no word is said twice: never "an elderly couple and an elderly";
+ * - the sky, the clouds and the light are no thing anyone holds, and the
+ *   weather is said as where it is: "a couple in the fog at a wedding",
+ *   "a couple in the snow in the mountains", never "a couple with a sky at
+ *   sunset" or "a snow in the mountains"; a feeling ("care", "worry") is no
+ *   thing either; whoever else is about ("tourists") is never said beside a
+ *   family; a parent beside a child is said with them ("a father with a
+ *   girl"); a tag that is a phrase of its own ("couple on bench") is read as
+ *   its parts; a time of day comes after where ("in the mountains at
+ *   sunset"), and a bench out of doors says where it stands ("on a bench by
+ *   the lake") (AGL-3988).
  *
  * `null` where no tag names a thing.
  */