@aglyn/plugins-ai 1.0.0-beta.253 → 1.0.0-beta.255

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

@@ -400,6 +400,36 @@ export declare function aiStockPick(photos: readonly StockPhoto[], used: Readonl
 export declare function aiStockPlacedSrcs(nodes: NodesMap | null | undefined): string[];
 /** Forgets every job's placed photos; for specs. */
 export declare function aiStockForgetJobPhotos(): void;
+/**
+ * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805).
+ *
+ * A slot's alt text is the model's, written for the picture the page asked
+ * for before any photo was found, and a slot is filled by whatever the
+ * library answers for its search: a hero searched by the business, a gallery
+ * picture by its subject, a site in another language by English words alone.
+ * Kept as written, it described a photo the page does not show: the beta.253
+ * Panadería La Concha Dorada start (job eg4maZMGtN) captioned a round cake
+ * dusted "HOME MADE" on a cloth "Conchas recién horneadas sobre una charola en
+ * el mostrador de la panadería", and none of its nine photos showed what its
+ * words said: a birthday cake with candles was "the family kneading pan
+ * dulce", a plate of macarons the shop's display case.
+ *
+ * So the photo placed answers for its own words. `null` keeps the slot's: on
+ * an English site whose words name what the photo is OF — a word of their
+ * subject (`aiStockSubjectWords`: the noun phrase they open with, before any
+ * setting) among the hit's first tags or its page's address, so "conchas on
+ * a tray at the bakery counter" is never kept for a loaf tagged "bakery".
+ * Otherwise the photo is described by the
+ * library's own words: its description where it writes one (a Pexels hit's
+ * `alt`), else its first tags, the things it shows. The libraries write in
+ * English, and no model translates them, so a site in another language takes
+ * the platform's own words for an illustrative photo in its language
+ * (`aiLayoutLabel`), true of any photo, as does a hit with no words at all.
+ */
+export declare function aiStockPhotoAlt(photo: Pick<StockPhoto, 'tags' | 'alt' | 'pageUrl'>, slot: Pick<AiLayoutPictureSlot, 'alt' | 'product'>, input?: {
+    language?: string;
+    sectionName?: string;
+}): string | null;
 export interface AiLayoutStockPhotoSourceInput {
     hostId: string;
     /** The member the photos are stored as: the job's creator. */

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

@@ -18,7 +18,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
 import { STOCK_PHOTO_QUERY_MAX_CHARS, stockPhotoProvider, stockPhotoSourceKey } from "@aglyn/aglyn/plugin-manager/stock-photo-provider";
 import { aiLayoutSeedNumber } from "../layout-language/ai-layout-pictures.js";
 import { aiStorefrontSays } from "../layout-language/ai-layout-storefront.js";
-import { aiLayoutSpeaksOtherThanEnglish } from "../layout-language/ai-layout-labels.js";
+import { aiLayoutLabel, aiLayoutSpeaksOtherThanEnglish } from "../layout-language/ai-layout-labels.js";
 import { aiSiteKindOfInputs } from "../model/ai-site-kinds.js";
 import { aiStockBusinessNoun } from "./ai-stock-business-nouns.js";
 /**
@@ -1766,6 +1766,54 @@ function jobPhotos(key) {
 /** Forgets every job's placed photos; for specs. */ export function aiStockForgetJobPhotos() {
     JOB_PHOTOS.clear();
 }
+/** The longest description of a photo written from the library's own words. */ const AI_STOCK_ALT_MAX = 160;
+/**
+ * THE WORDS A PLACED STOCK PHOTO IS DESCRIBED BY (AGL-3805).
+ *
+ * A slot's alt text is the model's, written for the picture the page asked
+ * for before any photo was found, and a slot is filled by whatever the
+ * library answers for its search: a hero searched by the business, a gallery
+ * picture by its subject, a site in another language by English words alone.
+ * Kept as written, it described a photo the page does not show: the beta.253
+ * Panadería La Concha Dorada start (job eg4maZMGtN) captioned a round cake
+ * dusted "HOME MADE" on a cloth "Conchas recién horneadas sobre una charola en
+ * el mostrador de la panadería", and none of its nine photos showed what its
+ * words said: a birthday cake with candles was "the family kneading pan
+ * dulce", a plate of macarons the shop's display case.
+ *
+ * So the photo placed answers for its own words. `null` keeps the slot's: on
+ * an English site whose words name what the photo is OF — a word of their
+ * subject (`aiStockSubjectWords`: the noun phrase they open with, before any
+ * setting) among the hit's first tags or its page's address, so "conchas on
+ * a tray at the bakery counter" is never kept for a loaf tagged "bakery".
+ * Otherwise the photo is described by the
+ * library's own words: its description where it writes one (a Pexels hit's
+ * `alt`), else its first tags, the things it shows. The libraries write in
+ * English, and no model translates them, so a site in another language takes
+ * the platform's own words for an illustrative photo in its language
+ * (`aiLayoutLabel`), true of any photo, as does a hit with no words at all.
+ */ export function aiStockPhotoAlt(photo, slot, input = {}) {
+    var _ref, _photo_alt, _photo_tags;
+    var _slot_product;
+    if (aiLayoutSpeaksOtherThanEnglish(input.language)) return aiLayoutLabel('illustrativePhoto', input.language);
+    const { lead } = hitWords(photo);
+    const named = [
+        slot.alt,
+        ...(_ref = (_slot_product = slot.product) == null ? void 0 : _slot_product.subjects) != null ? _ref : []
+    ].flatMap((words)=>{
+        var _input_sectionName;
+        return stemList(aiStockSubjectWords(words, (_input_sectionName = input.sectionName) != null ? _input_sectionName : ''));
+    });
+    if (named.some((word)=>lead.has(word))) return null;
+    const own = ((_photo_alt = photo.alt) != null ? _photo_alt : '').replace(/\s+/g, ' ').trim();
+    if (own) return own.length > AI_STOCK_ALT_MAX ? `${own.slice(0, AI_STOCK_ALT_MAX).replace(/\s+\S*$/, '')}…` : own;
+    const tags = [
+        ...new Set(((_photo_tags = photo.tags) != null ? _photo_tags : []).map((tag)=>tag.replace(/\s+/g, ' ').trim().toLowerCase()).filter(Boolean))
+    ].slice(0, 3);
+    if (!tags.length) return aiLayoutLabel('illustrativePhoto', input.language);
+    const said = tags.join(', ');
+    return `${said.charAt(0).toUpperCase()}${said.slice(1)}`;
+}
 const EXTENSIONS = {
     'image/jpeg': 'jpg',
     'image/png': 'png',
@@ -1906,8 +1954,20 @@ const EXTENSIONS = {
             answers.set(key, asked);
             return asked;
         };
+        /** The photo's own words where the slot's do not describe it ({@link aiStockPhotoAlt}). */ const altFor = (photo, slot)=>{
+            var _input_sectionNames_slot_sectionIndex;
+            return aiStockPhotoAlt(photo, slot, _extends({}, input.language ? {
+                language: input.language
+            } : {}, {
+                sectionName: (_input_sectionNames_slot_sectionIndex = input.sectionNames[slot.sectionIndex]) != null ? _input_sectionNames_slot_sectionIndex : ''
+            }));
+        };
         /** The photo placed in the site's library, a copy it holds or a new one; `null` when it cannot be placed. */ const keep = async (photo, slot, query, repeat = false)=>{
             const sourceKey = stockPhotoSourceKey(photo);
+            const alt = altFor(photo, slot);
+            const described = alt === null ? {} : {
+                alt
+            };
             try {
                 var _EXTENSIONS_bytes_contentType;
                 const kept = await ingest.findStockPhoto({
@@ -1919,11 +1979,11 @@ const EXTENSIONS = {
                     // Held because a slot of this page or another page of the job shows it.
                     if (!repeat && (placedSrcs.has(kept.src) || elsewhere(kept.src))) return null;
                     remember(sourceKey, kept.src);
-                    return {
+                    return _extends({
                         src: kept.src,
                         width: (_kept_width = kept.width) != null ? _kept_width : photo.width,
                         height: (_kept_height = kept.height) != null ? _kept_height : photo.height
-                    };
+                    }, described);
                 }
                 // A refusal to store (the storage band, a lockdown) holds for the
                 // whole page, so the rest of it reuses what it can and copies nothing.
@@ -1940,7 +2000,7 @@ const EXTENSIONS = {
                     fileName: `${photo.provider}-${photo.id}.${(_EXTENSIONS_bytes_contentType = EXTENSIONS[bytes.contentType]) != null ? _EXTENSIONS_bytes_contentType : 'jpg'}`,
                     contentType: bytes.contentType,
                     bytes: bytes.bytes,
-                    alt: slot.alt,
+                    alt: alt != null ? alt : slot.alt,
                     description: credit.text,
                     stockPhoto: _extends({
                         key: sourceKey,
@@ -1961,11 +2021,11 @@ const EXTENSIONS = {
                 if (stored.ok) {
                     var _stored_width, _stored_height;
                     remember(sourceKey, stored.src);
-                    return {
+                    return _extends({
                         src: stored.src,
                         width: (_stored_width = stored.width) != null ? _stored_width : photo.width,
                         height: (_stored_height = stored.height) != null ? _stored_height : photo.height
-                    };
+                    }, described);
                 }
                 storing = false;
                 const refusal = stored;
@@ -2142,8 +2202,16 @@ const EXTENSIONS = {
                 if (signal.aborted) return;
                 const key = stockPhotoSourceKey(candidate);
                 if (choice.repeat) {
-                    var _placedByKey_get;
-                    const placed = (_placedByKey_get = placedByKey.get(key)) != null ? _placedByKey_get : await keep(candidate, slot, choice.query, true);
+                    // Placed for another slot, it is described for this one.
+                    const shown = placedByKey.get(key);
+                    const alt = shown ? altFor(candidate, slot) : null;
+                    const placed = shown ? _extends({
+                        src: shown.src,
+                        width: shown.width,
+                        height: shown.height
+                    }, alt === null ? {} : {
+                        alt
+                    }) : await keep(candidate, slot, choice.query, true);
                     if (placed) {
                         photos[index] = placed;
                         return;