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

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

@@ -49,9 +49,24 @@ export declare function aiOwnerPhotoFits(slot: AiLayoutPictureSlot): boolean;
  * search, in slot order.
  */
 export declare function aiAssignOwnerPhotos(slots: readonly AiLayoutPictureSlot[], photos: readonly PluginMediaAsset[], avoid?: ReadonlySet<string>): Array<AiLayoutPicturePhoto | null>;
+/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */
+export declare const AI_LAYOUT_PAGE_PHOTOS_INPUT = "pagePhotos";
+/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */
+export declare function aiLayoutPagePhotosOf(inputs: Readonly<Record<string, unknown>> | null | undefined): PluginMediaAsset[];
+/**
+ * The photos a page brought in from the owner's own site placed first
+ * (AGL-3976): the page's own pictures, already in the site's library, fill
+ * the slots they fit, in the same order an owner's photos do and with no
+ * job-wide repeat rule, since a team photo the old site showed twice is the
+ * owner's to show twice. The slots left go to `next`.
+ */
+export declare function aiLayoutPagePhotoSource(photos: readonly PluginMediaAsset[], next: AiLayoutPictureSource | null): AiLayoutPictureSource | 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.
+ * A page a site import brings in (AGL-3976) places its own pictures first.
  */
-export declare function aiLayoutSitePhotoSource(input: AiLayoutStockPhotoSourceInput, deps?: AiLayoutOwnerPhotoDeps): AiLayoutPictureSource | null;
+export declare function aiLayoutSitePhotoSource(input: AiLayoutStockPhotoSourceInput & {
+    pagePhotos?: readonly PluginMediaAsset[];
+}, deps?: AiLayoutOwnerPhotoDeps): AiLayoutPictureSource | null;

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

@@ -67,11 +67,58 @@ function area(photo) {
     }
     return answers;
 }
+/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */ export const AI_LAYOUT_PAGE_PHOTOS_INPUT = 'pagePhotos';
+/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */ export function aiLayoutPagePhotosOf(inputs) {
+    const raw = inputs == null ? void 0 : inputs[AI_LAYOUT_PAGE_PHOTOS_INPUT];
+    if (!Array.isArray(raw)) return [];
+    const photos = [];
+    for (const entry of raw){
+        if (!entry || typeof entry !== 'object') continue;
+        const { mediaId, src, width, height, alt } = entry;
+        if (typeof mediaId !== 'string' || typeof src !== 'string' || !src.startsWith('media:')) continue;
+        if (typeof width !== 'number' || typeof height !== 'number' || width <= 0 || height <= 0) continue;
+        photos.push(_extends({
+            mediaId,
+            src,
+            width,
+            height
+        }, typeof alt === 'string' && alt.trim() ? {
+            alt: alt.trim()
+        } : {}));
+    }
+    return photos;
+}
+/**
+ * The photos a page brought in from the owner's own site placed first
+ * (AGL-3976): the page's own pictures, already in the site's library, fill
+ * the slots they fit, in the same order an owner's photos do and with no
+ * job-wide repeat rule, since a team photo the old site showed twice is the
+ * owner's to show twice. The slots left go to `next`.
+ */ export function aiLayoutPagePhotoSource(photos, next) {
+    if (!photos.length) return next;
+    return async (slots)=>{
+        const answers = aiAssignOwnerPhotos(slots, photos);
+        if (!next) return answers;
+        const open = slots.filter((_slot, index)=>!answers[index]);
+        if (!open.length) return answers;
+        const found = await next(open);
+        let index = 0;
+        return answers.map((answer)=>{
+            var _ref;
+            return (_ref = answer != null ? answer : found[index++]) != null ? _ref : 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.
+ * A page a site import brings in (AGL-3976) places its own pictures first.
  */ export function aiLayoutSitePhotoSource(input, deps = {}) {
+    var _input_pagePhotos;
+    return aiLayoutPagePhotoSource((_input_pagePhotos = input.pagePhotos) != null ? _input_pagePhotos : [], aiLayoutOwnerAndStockSource(input, deps));
+}
+function aiLayoutOwnerAndStockSource(input, deps) {
     var _deps_stock, _deps_ingest;
     var _ingest_listOwnerPhotos;
     const stock = ((_deps_stock = deps.stock) != null ? _deps_stock : aiLayoutStockPhotoSource)(input, deps);

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

@@ -1 +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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"}
+{"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/** The unit input carrying the photos a page brought in from the owner's own site (AGL-3976). */\nexport const AI_LAYOUT_PAGE_PHOTOS_INPUT = 'pagePhotos'\n\n/** The page's own photos a job's inputs carry, read defensively: library assets with their sizes only. */\nexport function aiLayoutPagePhotosOf(inputs: Readonly<Record<string, unknown>> | null | undefined): PluginMediaAsset[] {\n  const raw = inputs?.[AI_LAYOUT_PAGE_PHOTOS_INPUT]\n  if (!Array.isArray(raw)) return []\n  const photos: PluginMediaAsset[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { mediaId, src, width, height, alt } = entry as Record<string, unknown>\n    if (typeof mediaId !== 'string' || typeof src !== 'string' || !src.startsWith('media:')) continue\n    if (typeof width !== 'number' || typeof height !== 'number' || width <= 0 || height <= 0) continue\n    photos.push({ mediaId, src, width, height, ...(typeof alt === 'string' && alt.trim() ? { alt: alt.trim() } : {}) })\n  }\n  return photos\n}\n\n/**\n * The photos a page brought in from the owner's own site placed first\n * (AGL-3976): the page's own pictures, already in the site's library, fill\n * the slots they fit, in the same order an owner's photos do and with no\n * job-wide repeat rule, since a team photo the old site showed twice is the\n * owner's to show twice. The slots left go to `next`.\n */\nexport function aiLayoutPagePhotoSource(\n  photos: readonly PluginMediaAsset[],\n  next: AiLayoutPictureSource | null,\n): AiLayoutPictureSource | null {\n  if (!photos.length) return next\n  return async (slots) => {\n    const answers = aiAssignOwnerPhotos(slots, photos)\n    if (!next) return answers\n    const open = slots.filter((_slot, index) => !answers[index])\n    if (!open.length) return answers\n    const found = await next(open)\n    let index = 0\n    return answers.map((answer) => answer ?? found[index++] ?? null)\n  }\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 * A page a site import brings in (AGL-3976) places its own pictures first.\n */\nexport function aiLayoutSitePhotoSource(\n  input: AiLayoutStockPhotoSourceInput & { pagePhotos?: readonly PluginMediaAsset[] },\n  deps: AiLayoutOwnerPhotoDeps = {},\n): AiLayoutPictureSource | null {\n  return aiLayoutPagePhotoSource(input.pagePhotos ?? [], aiLayoutOwnerAndStockSource(input, deps))\n}\n\nfunction aiLayoutOwnerAndStockSource(\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","AI_LAYOUT_PAGE_PHOTOS_INPUT","aiLayoutPagePhotosOf","inputs","raw","Array","isArray","entry","mediaId","startsWith","push","trim","aiLayoutPagePhotoSource","next","open","_slot","found","answer","aiLayoutSitePhotoSource","input","deps","pagePhotos","aiLayoutOwnerAndStockSource","ingest","stock","list","listOwnerPhotos","bind","hostId","limit","error","console","warn"],"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
@@ -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();