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

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
@@ -591,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;
 /**
@@ -612,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.
  */

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

@@ -178,6 +178,31 @@ import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
  * part of the job already shows outside its pages — a dataset's records
  * (AGL-3616) — which a page does not place again.
  */ export 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 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 function aiStockJobPhotosOf(value) {
+    if (!Array.isArray(value)) return [];
+    return value.flatMap((entry)=>{
+        const photo = entry;
+        const src = typeof (photo == null ? void 0 : photo.src) === 'string' ? photo.src : '';
+        const width = Number(photo == null ? void 0 : photo.width);
+        const height = Number(photo == null ? void 0 : photo.height);
+        if (!src.startsWith('media:') || !(width > 0) || !(height > 0)) return [];
+        const alt = typeof (photo == null ? void 0 : photo.alt) === 'string' ? photo.alt.trim() : '';
+        return [
+            _extends({
+                src,
+                width,
+                height
+            }, alt ? {
+                alt
+            } : {})
+        ];
+    });
+}
 const words = (list)=>new Set(list.trim().split(/\s+/));
 /** Words that carry no subject. */ const STOPWORDS = words('a an the and or of in on at to for with from by into onto over under near our your their my his her its ' + 'this that these those is are be being was were who whom which where while as about than then very just ' + 'small local best new top quality premium family-owned family owned independent professional ' + 'business company services service page photo picture image showing shows show ' + 'someone people person one two three some many several');
 /**
@@ -3078,6 +3103,35 @@ const clip = (query)=>query.replace(/\s+/g, ' ').trim().slice(0, STOCK_PHOTO_QUE
     }
     return out;
 }
+/**
+ * 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 function aiStockPlacedPhotos(nodes) {
+    const map = nodes != null ? nodes : {};
+    const out = new Map();
+    for (const node of Object.values(map)){
+        var _node_props, _node_props1, _node_props2, _node_props3;
+        if ((node == null ? void 0 : node.componentId) !== 'image') continue;
+        const src = (_node_props = node.props) == null ? void 0 : _node_props['src'];
+        const width = Number((_node_props1 = node.props) == null ? void 0 : _node_props1['intrinsicWidth']);
+        const height = Number((_node_props2 = node.props) == null ? void 0 : _node_props2['intrinsicHeight']);
+        if (typeof src !== 'string' || !src.startsWith('media:') || out.has(src)) continue;
+        if (!(width > 0) || !(height > 0)) continue;
+        const alt = typeof ((_node_props3 = node.props) == null ? void 0 : _node_props3['alt']) === 'string' ? node.props['alt'].trim() : '';
+        out.set(src, _extends({
+            src,
+            width,
+            height
+        }, alt ? {
+            alt
+        } : {}));
+    }
+    return [
+        ...out.values()
+    ];
+}
 /**
  * What this process has placed for each job, by source key and asset src,
  * with the scope (the page's seed) that placed it (AGL-3660). It spans the
@@ -3114,13 +3168,34 @@ function jobPhotos(key) {
 'together alone apart away abroad ahead nearby outside inside upstairs downstairs ' + // Adjectives a tag gives alone, never a thing: "students, multicultural" (AGL-3856).
 'multicultural multiethnic multiracial diverse international cultural traditional modern classic classical ' + 'domestic wild tropical rural urban ' + // How the photo was made, never what it shows: "cutout, perspective", "men, silhouettes".
 'silhouette silhouettes cutout perspective bokeh closeup ' + // A holiday names when, never a thing: "tet market" is a market.
-'tet christmas easter halloween diwali ramadan hanukkah thanksgiving ' + 'indian asian african american european caucasian vietnamese japanese chinese korean thai latino latina hispanic ' + 'japan vietnam viet nam thailand india china korea germany france italy spain england britain uk usa america ' + 'canada mexico brazil australia africa europe asia');
+'tet christmas easter halloween diwali ramadan hanukkah thanksgiving ' + 'indian asian african american european caucasian vietnamese japanese chinese korean thai latino latina hispanic ' + 'japan vietnam viet nam thailand india china korea germany france italy spain england britain uk usa america ' + 'canada mexico brazil australia africa europe asia ' + // How a scene feels or looks, never a thing in it (AGL-3988): "mountain,
+// snow, winter, cold, couple, color, landscape" is a couple in the snow.
+'cold warm hot chilly freezing frozen icy color colors colour colours landscape landscapes ' + 'panorama panoramic vista scene scenes');
+/**
+ * The sky and the light over a scene, never a thing in it (AGL-3988): "A
+ * couple with a sky at sunset" and "A child with clouds by a lake" were a
+ * couple at sunset and a child by a lake.
+ */ const SCENERY = words('sky skies cloud clouds sun sunshine sunlight daylight light shadow shadows horizon');
+/**
+ * The weather a scene is in, said as where (AGL-3988): "A couple with a fog
+ * at a wedding" was a couple in the fog, "A snow in the mountains" a couple
+ * in the snow.
+ */ const WEATHER = {
+    fog: 'in the fog',
+    mist: 'in the mist',
+    haze: 'in the haze',
+    rain: 'in the rain',
+    snow: 'in the snow',
+    snowfall: 'in the snow',
+    snowflakes: 'in the snow',
+    wind: 'in the wind'
+};
 /**
  * Words a tag uses for what a person or a thing is like, said before it
  * rather than as a thing of its own (AGL-3856): "a confident lawyer", "an
  * elderly couple", "an analog camera", never "a lawyer, law and a confident".
  */ const QUALITIES = words('confident professional successful serious smart busy creative proud skilled experienced determined focused ' + 'senior junior expert friendly cheerful smiling elderly analog analogue digital mirrorless');
-/** What a tag names that takes no article: "chalk" of "board, chalk". */ const MASS_NOUNS = words('food coffee tea bread wood water wax soap clay money fabric yarn wool furniture jewelry jewellery ' + 'pottery glass paper music art hair makeup chalk paint ink dust stone marble concrete steel metal ' + 'skincare equipment decor fashion wildlife weather traffic wine beer chocolate rice sugar flour milk ' + 'cheese honey oil ice fire light sunlight dough sourdough pastry dessert people foliage greenery faculty staff ' + 'clothing bedding frosting icing flooring');
+/** What a tag names that takes no article: "chalk" of "board, chalk". */ const MASS_NOUNS = words('food coffee tea bread wood water wax soap clay money fabric yarn wool furniture jewelry jewellery ' + 'pottery glass paper music art hair makeup chalk paint ink dust stone marble concrete steel metal ' + 'skincare equipment decor wildlife weather traffic wine beer chocolate rice sugar flour milk ' + 'cheese honey oil ice fire light sunlight dough sourdough pastry dessert people foliage greenery faculty staff ' + 'clothing bedding frosting icing flooring');
 /** Nouns plural without an "-s": said without an article, "women in a classroom". */ const PLURAL_NOUNS = words('men women people children feet teeth mice geese sheep fish');
 /**
  * What a tag names that no photo shows as a thing of its own (AGL-3856): an
@@ -3128,7 +3203,8 @@ function jobPhotos(key) {
  * doing ("read", "lift", "fitness", "a workout"), a word for the photo itself
  * ("photo", "spot"). Left out, never said with an article: "A bookwork and a
  * read", "A kettlebell and fitness", "A board and training" said nothing.
- */ const ABSTRACT_NOUNS = words('law justice advocacy business feedback review news return communication communicate discussion dialog conversation ' + 'success career work job satisfaction quality concept idea strategy marketing education technology health support ' + 'confirmation opinion rating evaluation planning project presentation optimization information internet finance ' + 'management leadership teamwork motivation growth strength service services help advice consulting consultation ' + 'marriage photography architecture travel transport transportation industry company corporate social e-business ' + 'fitness workout workouts exercise exercises crossfit sport sports skill skills knowledge exam exams lecture ' + 'session lesson course hobby leisure power energy wellness talent formation participation ' + 'press show day days night year years time holiday month months week weeks morning evening afternoon season seasons ' + 'kiss hug embrace ' + 'photo photos picture pictures image images shot shots shoot shoots spot spots ' + 'read write learn study lift move remove focus relax think sit smile laugh eat swim teach enjoy celebrate explore ' + 'hike can');
+ */ const ABSTRACT_NOUNS = words('law justice advocacy business feedback review news return communication communicate discussion dialog conversation ' + 'success career work job satisfaction quality concept idea strategy marketing education technology health support ' + 'confirmation opinion rating evaluation planning project presentation optimization information internet finance ' + 'management leadership teamwork motivation growth strength service services help advice consulting consultation ' + 'marriage photography architecture travel transport transportation industry company corporate social e-business ' + 'fitness workout workouts exercise exercises crossfit sport sports skill skills knowledge exam exams lecture ' + 'session lesson course hobby leisure power energy wellness talent formation participation ' + 'press show day days night year years time holiday month months week weeks morning evening afternoon season seasons ' + 'kiss hug embrace ' + // A feeling, never a thing anyone holds (AGL-3988): "A father with a care".
+'care worry trust hope joy peace fear faith grief pride comfort safety bliss delight passion desire feeling feelings ' + 'moment moments memory memories fashion style ' + 'photo photos picture pictures image images shot shots shoot shoots spot spots ' + 'read write learn study lift move remove focus relax think sit smile laugh eat swim teach enjoy celebrate explore ' + 'hike can');
 /** Words ending as an idea does that are things: "a station", "a city", "a ship". */ const CONCRETE_ABSTRACT_ENDINGS = words('station mansion lotion potion ornament instrument apartment monument pavement basement garment compartment ' + 'equipment cement city university facility ship warship spaceship airship');
 /** Whether a word is an idea or a doing by how it ends: "participation", "unity", "empowerment". */ const saysAnIdea = (word)=>/(?:tion|sion|ment|ness|ity|ship|ism)s?$/.test(word) && !CONCRETE_ABSTRACT_ENDINGS.has(aiStockStem(word));
 /**
@@ -3138,8 +3214,20 @@ function jobPhotos(key) {
 /** Stopwords a description still says, as the people a photo shows: "a family", "a person". */ const SAID_PEOPLE = words('people person family');
 /** Words ending in "-ing" that are things, and take an article: "a wedding", "a ring". */ const COUNTED_ING = words('wedding ring earring building painting drawing ceiling string swing king sibling wing dumpling pudding sapling');
 /** "-ing" words that are things, and take no article: "clothing". */ const UNCOUNTED_ING = words('clothing bedding frosting icing flooring stuffing seasoning filling');
-/** People a photo shows; the generic ones give way to a role ("man" to "businessman"). */ const PEOPLE_NOUNS = words('man men woman women person people human humans boy boys girl girls guy guys lady ladies child children kid kids ' + 'baby family couple bride groom schoolgirl schoolboy teen teenager student students graduate athlete athletes ' + 'businessman businesswoman businessmen lawyer attorney doctor dentist nurse chef cook baker barista ' + 'trainer coach teacher teachers instructor lecturer professor tutor worker workers entrepreneur model ' + 'photographer potter artist florist mother father parent parents grandmother grandfather grandparents ' + 'faculty staff team participants volunteer volunteers musician dancer leader manager owner founder ' + 'journalist journalists reporter reporters master masters lovers newlywed newlyweds husband wife fiance fiancee spouse');
-/** People said by no role: a model is whoever posed (AGL-3856), "a woman" of "woman, model, show, teacher". */ const GENERIC_PEOPLE = words('man men woman women person people human humans guy guys lady ladies adult boy boys girl girls model models');
+/** People a photo shows; the generic ones give way to a role ("man" to "businessman"). */ const PEOPLE_NOUNS = words('man men woman women person people human humans boy boys girl girls guy guys lady ladies child children kid kids ' + 'baby family couple bride groom schoolgirl schoolboy teen teenager student students graduate athlete athletes ' + 'businessman businesswoman businessmen lawyer attorney doctor dentist nurse chef cook baker barista ' + 'trainer coach teacher teachers instructor lecturer professor tutor worker workers entrepreneur model ' + 'photographer potter artist florist mother father parent parents grandmother grandfather grandparents ' + 'faculty staff team participants volunteer volunteers musician dancer leader manager owner founder ' + 'journalist journalists reporter reporters master masters lovers newlywed newlyweds husband wife fiance fiancee spouse ' + // Whoever else is about (AGL-3988): "A family with tourists" was a family.
+'tourist tourists traveler travelers traveller travellers hiker hikers visitor visitors friend friends crowd ' + // A family's people, said as a parent with a child (AGL-3988).
+'dad dads mom moms mum mums son sons daughter daughters toddler toddlers');
+/** People said by no role: a model is whoever posed (AGL-3856), "a woman" of "woman, model, show, teacher". */ const GENERIC_PEOPLE = words('man men woman women person people human humans guy guys lady ladies adult boy boys girl girls model models ' + 'tourist tourists traveler travelers traveller travellers hiker hikers visitor visitors friend friends crowd');
+/** A parent a photo shows, said with the child beside them: "A father with a girl" (AGL-3988). */ const PARENTS = words('father mother dad mom mum parent parents grandfather grandmother grandparent grandparents');
+/** A child a photo shows beside a parent (AGL-3988). */ const CHILDREN = words('child children kid kids baby babies toddler toddlers girl girls boy boys son sons daughter daughters');
+/** How a family's word is said: "a dad" is a father (AGL-3988). */ const SAID_AS = {
+    dad: 'father',
+    dads: 'fathers',
+    mom: 'mother',
+    moms: 'mothers',
+    mum: 'mother',
+    mums: 'mothers'
+};
 /**
  * A body's parts, never a thing a photo is described by (AGL-3856): "A girl
  * with a hand" said nothing, and "A body in a gym" is a gym.
@@ -3209,13 +3297,46 @@ function jobPhotos(key) {
     cliff: 'on',
     river: 'by',
     lake: 'by',
+    lakeside: 'by',
+    lakeshore: 'by',
+    sea: 'by',
+    ocean: 'by',
+    seaside: 'by',
+    coast: 'on',
+    shore: 'on',
+    sundown: 'at',
     waterfall: 'at'
 };
 /** Places that are things too, a photo's subject where nothing else is: "a desk in a classroom". */ const OBJECT_PLACES = words('desk table counter bridge bed sofa couch bench');
-/** Places said without an article: "in court", "at sunset". */ const BARE_PLACES = words('court sunset sunrise dusk dawn');
+/** Places said without an article: "in court", "at sunset". */ const BARE_PLACES = words('court sunset sunrise sundown dusk dawn');
 /** Places said in words of their own: a mountain tag is "in the mountains". */ const PLACES_SAID = {
-    mountain: 'the mountains'
+    mountain: 'the mountains',
+    lakeside: 'the lake',
+    lakeshore: 'the lake',
+    sea: 'the sea',
+    ocean: 'the ocean',
+    seaside: 'the sea',
+    coast: 'the coast',
+    shore: 'the shore'
 };
+/** Places that say when, said after where: "a couple in the mountains at sunset" (AGL-3988). */ const TIME_PLACES = words('sunset sunrise sundown dusk dawn');
+/** Places out of doors, said after a thing to sit on: "a couple on a bench by the lake" (AGL-3988). */ const OUTDOORS = words('forest field meadow valley mountain hill cliff river lake lakeside lakeshore waterfall beach park garden trail sea ocean seaside coast shore');
+/** Words inside a tag that say one thing is where another is: "couple on bench" (AGL-3988). */ const TAG_PREPOSITIONS = words('on in at by with under near beside');
+/**
+ * A tag that is a phrase of its own, read as its parts (AGL-3988): "couple
+ * on bench" is a couple, and a bench they are on. The beta.270 Sugar Hollow
+ * About page read it whole, as a place, and said "A lakeside on a couple on
+ * bench".
+ */ function tagParts(tag) {
+    const list = tag.toLowerCase().trim().split(/\s+/);
+    const at = list.findIndex((word, index)=>index > 0 && index < list.length - 1 && TAG_PREPOSITIONS.has(word));
+    return at > 0 ? [
+        list.slice(0, at).join(' '),
+        list.slice(at + 1).join(' ')
+    ] : [
+        tag
+    ];
+}
 /** How many of a photo's first tags its description reads: the things and people it is OF. */ const ALT_TAGS_READ = 8;
 /** How far a photo's tags are read for where it is set, said last: "in a gym" of a kettlebell's seventh tag. */ const ALT_PLACE_TAGS_READ = 10;
 /** A tag's words, a word for the photo itself taken off a compound: "photo-camera" is a camera. */ function tagWords(tag) {
@@ -3290,15 +3411,31 @@ function jobPhotos(key) {
  * - 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.
  */ export function aiStockTagsAlt(tags, proper = new Set()) {
+    var _ref;
     const parts = [];
     let quality = '';
     let portrait = false;
-    for (const [index, tag] of tags.slice(0, ALT_PLACE_TAGS_READ).entries()){
-        var _ref;
+    /** The weather it is in, said as where ({@link WEATHER}). */ let weather = '';
+    const read = tags.slice(0, ALT_PLACE_TAGS_READ).flatMap((tag, index)=>tagParts(tag).map((part)=>({
+                tag: part,
+                index
+            })));
+    for (const { tag, index } of read){
+        var _ref1;
         var _bare_split_pop;
         const lower = tag.toLowerCase().trim();
         const reading = index < ALT_TAGS_READ;
@@ -3310,11 +3447,18 @@ function jobPhotos(key) {
             if (reading) quality || (quality = lower);
             continue;
         }
-        const said = describedTag(tag, proper);
+        // The sky is never a thing a photo is described by; the weather is where it is.
+        if (SCENERY.has(lower)) continue;
+        if (WEATHER[lower]) {
+            if (reading) weather || (weather = WEATHER[lower]);
+            continue;
+        }
+        const family = SAID_AS[lower];
+        const said = family ? `${articleFor(family)} ${family}`.replace(/^an? (?=\S+s$)/, '') : describedTag(tag, proper);
         if (!said) continue;
         const bare = said.replace(/^an?\s+/, '');
         const stems = stemList(bare);
-        const head = (_ref = (_bare_split_pop = bare.split(/\s+/).pop()) == null ? void 0 : _bare_split_pop.toLowerCase()) != null ? _ref : '';
+        const head = (_ref1 = (_bare_split_pop = bare.split(/\s+/).pop()) == null ? void 0 : _bare_split_pop.toLowerCase()) != null ? _ref1 : '';
         if (!head) continue;
         const headStem = aiStockStem(head);
         const kind = PEOPLE_NOUNS.has(head) || PEOPLE_NOUNS.has(headStem) ? 'person' : PLACES[headStem] ? 'place' : 'thing';
@@ -3358,7 +3502,12 @@ function jobPhotos(key) {
     // silhouettes, camera, nature, photographer" men with a camera.
     const leads = (part)=>portrait || part.index < ALT_PERSON_TAGS_READ || !things.length;
     const role = posed ? undefined : people.find((part)=>!GENERIC_PEOPLE.has(part.head) && part.index < ALT_ROLE_TAGS_READ && leads(part));
-    const person = role != null ? role : people.find(leads);
+    // A parent beside a child is said with them (AGL-3988): "A father with a
+    // girl", never "a child with clouds" of "child, clouds, dad, dock, father".
+    const parent = people.find((part)=>PARENTS.has(part.head) && part.index < ALT_ROLE_TAGS_READ);
+    const child = people.find((part)=>CHILDREN.has(part.head) && part.index < ALT_ROLE_TAGS_READ);
+    const family = parent && child && (!role || role === parent || role === child) ? parent : undefined;
+    const person = (_ref = family != null ? family : role) != null ? _ref : people.find(leads);
     // Nothing but places: a desk is the thing in a classroom; "a school in a classroom" says one place.
     if (!person && !things.length && places.length > 1) {
         const object = places.find((part)=>OBJECT_PLACES.has(part.head));
@@ -3370,7 +3519,7 @@ function jobPhotos(key) {
         } else places = places.slice(0, 1);
     }
     const place = places[0];
-    if (!person && !things.length && !place) return null;
+    if (!person && !things.length && !place && !weather) return null;
     /** Every word said so far, so none is said twice. */ const said = new Set();
     const fresh = (part)=>{
         const list = stemList(part.said.replace(/^an?\s+/, ''));
@@ -3382,18 +3531,40 @@ function jobPhotos(key) {
     let phrase = '';
     if (person && fresh(person)) {
         phrase = portrait ? `a portrait of ${person.said}` : qualified(person);
-        const held = things.find((part)=>part.index <= 2);
+        const held = family && child && child !== person ? child : things.find((part)=>part.index <= 2);
         if (!portrait && held && fresh(held)) phrase += ` ${CLOTHING.has(held.head) ? 'in' : 'with'} ${held.said}`;
     } else if (things[0] && fresh(things[0])) {
         phrase = qualified(things[0]);
         const second = things[1];
         if (second && second.index <= 1 && !place && fresh(second)) phrase += ` and ${second.said}`;
     }
+    /** A place as it is said alone: "a classroom", "the mountains", "sunset". */ const placeOf = (part)=>{
+        var _PLACES_SAID_part_head;
+        return (_PLACES_SAID_part_head = PLACES_SAID[part.head]) != null ? _PLACES_SAID_part_head : BARE_PLACES.has(part.head) && /^an? \S+$/.test(part.said) ? part.head : part.said;
+    };
+    /** A place as it is said after what is there: "in the mountains", "at sunset", "on a bench". */ const whereOf = (part)=>{
+        var _PLACES_part_head;
+        return `${(_PLACES_part_head = PLACES[part.head]) != null ? _PLACES_part_head : 'in'} ${placeOf(part)}`;
+    };
+    // The weather is said before where (AGL-3988): "a couple in the fog at a
+    // wedding"; alone, it is what the photo shows: "snow in the mountains".
+    if (weather && phrase) phrase += ` ${weather}`;
+    else if (weather) phrase = weather.replace(/^in the /, '');
     if (place && fresh(place)) {
-        var _PLACES_place_head, _PLACES_SAID_place_head;
-        const preposition = (_PLACES_place_head = PLACES[place.head]) != null ? _PLACES_place_head : 'in';
-        const where = (_PLACES_SAID_place_head = PLACES_SAID[place.head]) != null ? _PLACES_SAID_place_head : BARE_PLACES.has(place.head) && /^an? \S+$/.test(place.said) ? place.head : place.said;
-        phrase = phrase ? `${phrase} ${preposition} ${where}` : where;
+        // A second place where the first is a time of day or a bench out of
+        // doors: "a couple in the mountains at sunset", "a couple on a bench by
+        // the lake"; never a bed in a room.
+        const second = places.find((part)=>part !== place && !OBJECT_PLACES.has(part.head) && !TIME_PLACES.has(part.head) && (TIME_PLACES.has(place.head) || place.head === 'bench' && OUTDOORS.has(part.head)));
+        const after = second && fresh(second) ? second : null;
+        const [first, last] = after && TIME_PLACES.has(place.head) ? [
+            after,
+            place
+        ] : [
+            place,
+            after
+        ];
+        const tail = last ? ` ${whereOf(last)}` : '';
+        phrase = phrase ? `${phrase} ${whereOf(first)}${tail}` : `${placeOf(first)}${tail}`;
     }
     // Never a dangling article or preposition, whatever a tag left behind.
     phrase = phrase.replace(DANGLING_END, '').trim();