@jini-ai/admin 0.4.10 → 0.4.12

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.4.12 — 2026-10-16
+
+- SEO: searchable entry picker and grouped per-entry form (6c128f9d); image fields name the file, styled analysis, slug for same-titled entries (bc1dbf0d); one Social preview section with an optional "Customize for X" (ff1a709f); X/Twitter labels, file names with extensions, muted inherited site-default image (4919371d); "Using image from page content" when the share image comes from the page (746457d9).
+- Peers: `@jini-ai/ui` `^0.5.5` (grouped Select) and `@jini-ai/cms` `^0.5.13` (share-image source).
+
+## 0.4.11 — 2026-10-14
+
+- `FieldAttributesDialog` and `SitemapModal` use the neutral `jini-domain-dialog` class instead of a host-named one; hosts style `.jini-domain-dialog` (47b9fa4f).
+- Rides along, no API change: forms option row keys come from the editor's own row list instead of a module-level counter (6281ddc8); redirects imports its shared widgets directly instead of the React barrel (9b45c742); comment scrubs (8e508fb6, 6281ddc8).
+
 ## 0.4.10 — 2026-10-13
 
 - Forms HTML starter: URL fields emit `type="text"` plus the registry's URL hints (`inputmode`, `autocomplete`, `spellcheck`, `autocapitalize`), so bare domains such as `tovu.dev` are no longer refused by the browser. CMS peer floor ^0.5.11.

package/dist/comments/rules.d.ts

@@ -31,11 +31,11 @@ export declare const KEYS: {
 /** The moderation queue's name on `lib/content-refresh-bus.ts` — see `taxonomy/rules.ts`'s
  *  `TAXONOMY_RESOURCE` for why this is a plain colocated constant rather than a shared registry.
  *  Agent-writable via `comments_approve_comment`/`comments_mark_comment_spam`/
- *  `comments_trash_comment`/`comments_restore_comment` (`apps/website/src/features/comments/
- *  agent-tools.ts`), all of which move a comment between statuses this queue lists.
+ *  `comments_trash_comment`/`comments_restore_comment` (the host's comment agent tools),
+ *  all of which move a comment between statuses this queue lists.
  *
  *  There is deliberately NO sibling `COMMENTS_SETTINGS_RESOURCE`: `react/hooks/use-comment-settings.hooks.ts`'s
- *  own header records a real, already-fixed lost-update bug (TM-TOVU-2026-08-12-A) whose fix is a
+ *  own header records a real, already-fixed lost-update bug (2026-08-12) whose fix is a
  *  ONE-SHOT seed guard that refuses to re-seed `settings` from any later successful load, including
  *  this bus's own out-of-band notification. Wiring that hook to the bus would either do nothing
  *  (the guard blocks it) or, if the guard were bypassed instead, reintroduce the exact silent

package/dist/comments/rules.js

@@ -35,11 +35,11 @@ export const KEYS = {
 /** The moderation queue's name on `lib/content-refresh-bus.ts` — see `taxonomy/rules.ts`'s
  *  `TAXONOMY_RESOURCE` for why this is a plain colocated constant rather than a shared registry.
  *  Agent-writable via `comments_approve_comment`/`comments_mark_comment_spam`/
- *  `comments_trash_comment`/`comments_restore_comment` (`apps/website/src/features/comments/
- *  agent-tools.ts`), all of which move a comment between statuses this queue lists.
+ *  `comments_trash_comment`/`comments_restore_comment` (the host's comment agent tools),
+ *  all of which move a comment between statuses this queue lists.
  *
  *  There is deliberately NO sibling `COMMENTS_SETTINGS_RESOURCE`: `react/hooks/use-comment-settings.hooks.ts`'s
- *  own header records a real, already-fixed lost-update bug (TM-TOVU-2026-08-12-A) whose fix is a
+ *  own header records a real, already-fixed lost-update bug (2026-08-12) whose fix is a
  *  ONE-SHOT seed guard that refuses to re-seed `settings` from any later successful load, including
  *  this bus's own out-of-band notification. Wiring that hook to the bus would either do nothing
  *  (the guard blocks it) or, if the guard were bypassed instead, reintroduce the exact silent

package/dist/core/ports/seo.d.ts

@@ -76,6 +76,10 @@ export interface AdminSeoOpenGraph {
     readonly image?: string;
     /** Source reference before resizing, used to diagnose the selected share image. */
     readonly imageRef?: string;
+    /** Effective image provenance; absent from older hosts. */
+    readonly imageSource?: 'override' | 'content' | 'default';
+    /** Present (true) only when the entry stores its own image override; absent from older hosts. */
+    readonly imageOverridden?: true;
     readonly siteName?: string;
 }
 export interface AdminSeoTwitterCard {
@@ -149,6 +153,18 @@ export interface AdminSeoEntryChoice {
     readonly id: string;
     readonly title: string;
     readonly status: string;
+    /** Tells two same-titled entries apart in the picker; optional for hosts that omit it. */
+    readonly slug?: string;
+}
+/** What an image field shows for a chosen library file: its name and, when stored, its size. */
+export interface AdminSeoMediaSummary {
+    readonly id: string;
+    readonly slug?: string;
+    readonly title: string;
+    readonly width?: number | null;
+    readonly height?: number | null;
+    /** The stored bytes' sniffed type (`image/png`); gives the displayed name its extension. */
+    readonly contentType?: string | null;
 }
 export interface AdminSeoPort {
     getSeoEntry(requiredArgs: {
@@ -189,6 +205,10 @@ export interface AdminSeoPort {
     mediaPreviewUrl?(required: {
         value: string;
     }, optional?: Record<string, never>): string | null;
+    /** Optional: library rows so an image field can name its file instead of showing a reference. */
+    listSeoMedia?(required: Record<string, never>, optional?: {
+        signal?: AbortSignal;
+    }): Promise<readonly AdminSeoMediaSummary[]>;
     /** Original thumbnail URL; media-reference resolution stays on the server. */
     mediaOriginalUrl(requiredArgs: {
         id: string;

package/dist/forms/field-settings.d.ts

@@ -65,6 +65,7 @@ export declare function retypeField({ field, type }: {
     field: AdminFormField;
     type: AdminFormField["type"];
 }, _optional?: Record<string, never>): AdminFormField;
+/** Local React keys for option rows; identity is scoped to the editor's own row list. */
 export interface OptionRow {
     _rowId: number;
     value: string;

package/dist/forms/field-settings.js

@@ -134,8 +134,6 @@ export function retypeField({ field, type }, _optional = {}) {
         next.default = field.default;
     return next;
 }
-/** Local React keys for option rows; same module-counter pattern as `rules.ts`'s attribute rows. */
-let nextOptionRowId = 0;
 const text = (value) => (value === undefined || value === null ? "" : String(value));
 /** Seed the draft from a stored field. @complexity O(o) in options. */
 export function settingsFormFromField({ field }, _optional = {}) {
@@ -147,7 +145,7 @@ export function settingsFormFromField({ field }, _optional = {}) {
         defaultChoices: Array.isArray(defaults) ? [...defaults] : typeof defaults === "string" && fieldSettingsFor({ type: field.type }).options ? [defaults] : [],
         minLength: text(field.minLength), maxLength: text(field.maxLength), pattern: text(field.pattern),
         min: text(field.min), max: text(field.max), step: text(field.step),
-        options: (field.options ?? []).map((option) => ({ _rowId: nextOptionRowId++, value: option.value, label: option.label })),
+        options: (field.options ?? []).map((option, index) => ({ _rowId: index, value: option.value, label: option.label })),
         accept: [...(field.accept ?? [])],
         maxFileSizeMb: field.maxFileSize === undefined ? "" : String(Math.round((field.maxFileSize / 1024 / 1024) * 100) / 100),
     };
@@ -167,7 +165,9 @@ export function updateOptionRow({ rows, rowId, patch }, _optional = {}) {
 }
 /** @complexity O(o). */
 export function addOptionRow({ rows }, _optional = {}) {
-    return [...rows, { _rowId: nextOptionRowId++, value: "", label: "" }];
+    // Use the highest current key so deleting or reordering rows cannot create a duplicate.
+    const rowId = rows.reduce((max, row) => Math.max(max, row._rowId), -1) + 1;
+    return [...rows, { _rowId: rowId, value: "", label: "" }];
 }
 /** @complexity O(o). */
 export function removeOptionRow({ rows, rowId }, _optional = {}) {

package/dist/forms/react/components/FieldAttributesDialog.js

@@ -19,7 +19,7 @@ export function FieldAttributesDialog({ field, fieldIndex, onSave, onCancel, use
     // it was not judged worth the added indirection.
     const { className, addRow, error, submit } = controller;
     const { rows, displayName, onClose, onClassName, hasStyling } = useFieldAttributesView({ field, fieldIndex, controller, onCancel });
-    return (_jsx(Dialog, { open: true, title: `${t("Field settings —")} ${displayName}`, onClose: onClose, className: "settings-dialog tovu-domain-dialog field-attrs-dialog", children: _jsxs("form", { onSubmit: submit, ...agentHandle({ handle: "form-field-attrs-dialog" }, {
+    return (_jsx(Dialog, { open: true, title: `${t("Field settings —")} ${displayName}`, onClose: onClose, className: "settings-dialog jini-domain-dialog field-attrs-dialog", children: _jsxs("form", { onSubmit: submit, ...agentHandle({ handle: "form-field-attrs-dialog" }, {
                 role: "region",
                 label: "Field settings dialog — type-specific settings, CSS classes and HTML attributes for one form field",
             }), children: [_jsx(FieldSettingsSection, { field: field, controller: controller, t: t }), _jsxs("details", { className: "field-settings-advanced", open: hasStyling, children: [_jsx("summary", { children: t("CSS classes and HTML attributes") }), _jsxs("div", { className: "field", children: [_jsxs("span", { className: "field-settings-label", children: [_jsx("label", { className: "field-label", htmlFor: "field-attrs-classname", children: t("CSS classes") }), _jsx(InfoTip, { label: t("Classes are unrestricted, e.g. Tailwind md:col-span-2. Attribute names must be aria-*, data-* or a safe layout attribute; event handlers like onclick are rejected.") })] }), _jsx("input", { id: "field-attrs-classname", value: className, placeholder: "e.g. md:col-span-2 w-1/2 focus:ring-2", onChange: onClassName, ...agentHandle({ handle: "form-field-attrs-classname" }, {

package/dist/forms/react/hooks/use-forms-list.hooks.d.ts

@@ -37,7 +37,7 @@ import { type FormDateLine } from "../../rules.js";
  *
  * the scoped formsEvents subscription (staleness-bug generalization pass, see that hook's own header):
  * `forms_create_definition`/`forms_update_definition`/`forms_set_definition_status`
- * (`apps/website/src/features/forms/agent-tools.ts`) are agent-callable, so this list re-invalidates
+ * (the host's forms agent tools) are agent-callable, so this list re-invalidates
  * `KEYS.list` on an out-of-band content-refresh notification the same way `use-taxonomy.hooks.ts`
  * does for its own resource.
  */

package/dist/forms/rules.d.ts

@@ -31,8 +31,8 @@ import { type FieldType } from "@jini-ai/cms/forms";
 /**
  * This screen's name on `lib/content-refresh-bus.ts` — see `taxonomy/rules.ts`'s `TAXONOMY_RESOURCE`
  * for why this is a plain colocated constant rather than a shared registry. `forms_create_definition`/
- * `forms_update_definition`/`forms_set_definition_status` (`apps/website/src/features/forms/agent-
- * tools.ts`) are agent-callable, so `FormsList.tsx` needs the same "an assistant write shows up
+ * `forms_update_definition`/`forms_set_definition_status` (the host's forms agent tools)
+ * are agent-callable, so `FormsList.tsx` needs the same "an assistant write shows up
  * without a reload" fix `use-taxonomy.hooks.ts` shipped first.
  */
 export declare const FORMS_LIST_RESOURCE = "forms";

package/dist/forms/rules.js

@@ -30,8 +30,8 @@ import { FIELD_TYPE_REGISTRY } from "@jini-ai/cms/forms";
 /**
  * This screen's name on `lib/content-refresh-bus.ts` — see `taxonomy/rules.ts`'s `TAXONOMY_RESOURCE`
  * for why this is a plain colocated constant rather than a shared registry. `forms_create_definition`/
- * `forms_update_definition`/`forms_set_definition_status` (`apps/website/src/features/forms/agent-
- * tools.ts`) are agent-callable, so `FormsList.tsx` needs the same "an assistant write shows up
+ * `forms_update_definition`/`forms_set_definition_status` (the host's forms agent tools)
+ * are agent-callable, so `FormsList.tsx` needs the same "an assistant write shows up
  * without a reload" fix `use-taxonomy.hooks.ts` shipped first.
  */
 export const FORMS_LIST_RESOURCE = "forms";

package/dist/redirects/react/hooks/RedirectsPage.hooks.js

@@ -1,5 +1,5 @@
 import { createElement } from 'react';
-import { RowMenu } from '../../../react/index.js';
+import { RowMenu } from '../../../react/components/RowMenu/RowMenu.js';
 import { redirectRowMenuItems } from '../../rules.js';
 import { HitCountCell } from '../components/HitCountCell.js';
 import { useRedirectsOptions } from './RedirectsOptions.hooks.js';

package/dist/redirects/react/pages/RedirectsPage.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DataTable, ConfirmDialog } from '../../../react/index.js';
+import { DataTable } from '../../../react/components/DataTable.js';
+import { ConfirmDialog } from '../../../react/components/ConfirmDialog/ConfirmDialog.js';
 import { agentHandle } from '@jini-ai/agentic';
 import { describeApiError } from '../../../core/transport/errors.js';
 import { ImportRedirectsForm } from '../components/ImportRedirectsForm.js';

package/dist/redirects/rules.d.ts

@@ -22,8 +22,8 @@ export declare const KEYS: {
 };
 /** This screen's name on the host refresh bus — see `taxonomy/rules.ts`'s `TAXONOMY_RESOURCE`
  *  for why this is a plain colocated constant rather than a shared registry. Agent-writable via
- *  `redirects_create`/`redirects_update`/`redirects_tombstone` (`apps/website/src/features/redirects/
- *  agent-tools.ts`) — `redirects_import` is excluded from that catalog entirely, but the three wired
+ *  `redirects_create`/`redirects_update`/`redirects_tombstone` (the host's redirect agent tools) —
+ *  `redirects_import` is excluded from that catalog entirely, but the three wired
  *  single-row writes are enough to make this list go stale the same way Posts/Media did. */
 export declare const REDIRECTS_RESOURCE = "redirects";
 /**

package/dist/redirects/rules.js

@@ -18,8 +18,8 @@ export const KEYS = {
 };
 /** This screen's name on the host refresh bus — see `taxonomy/rules.ts`'s `TAXONOMY_RESOURCE`
  *  for why this is a plain colocated constant rather than a shared registry. Agent-writable via
- *  `redirects_create`/`redirects_update`/`redirects_tombstone` (`apps/website/src/features/redirects/
- *  agent-tools.ts`) — `redirects_import` is excluded from that catalog entirely, but the three wired
+ *  `redirects_create`/`redirects_update`/`redirects_tombstone` (the host's redirect agent tools) —
+ *  `redirects_import` is excluded from that catalog entirely, but the three wired
  *  single-row writes are enough to make this list go stale the same way Posts/Media did. */
 export const REDIRECTS_RESOURCE = "redirects";
 /**

package/dist/seo/adapters/http.js

@@ -20,6 +20,11 @@ export function createHttpSeoApi({ transport, basePath }, { sitemapTransport, im
         analyzeSeoEntry: ({ entryId }) => data(`${entryPath(entryId)}/analyze`, 'GET'),
         listSeoPosts: () => choices('posts'),
         listSeoPages: () => choices('pages'),
+        // The admin media list route the picker already reads; projected so no media row type leaks in.
+        async listSeoMedia() {
+            const response = await transport.request({ path: `${base}/media`, method: 'GET' });
+            return response.media.map(({ id, slug, title, width, height, contentType }) => ({ id, title, ...(slug ? { slug } : {}), width: width ?? null, height: height ?? null, contentType: contentType ?? null }));
+        },
         mediaOriginalUrl: ({ id }) => transport.url({ path: `${base}/media/${encodeURIComponent(id)}/original` }),
         mediaPreviewUrl: ({ value }) => resolveMediaRefPreviewUrl({ value, mediaOriginalUrl: id => transport.url({ path: `${base}/media/${encodeURIComponent(id)}/original` }) }, { siteOrigin }),
         ...(imageTransport ? { async inspectShareImage({ url }, options = {}) {

package/dist/seo/adapters/memory.js

@@ -49,7 +49,7 @@ function applySeoPatch(meta, patch) {
     };
 }
 /** One of the three site-wide scalars the server registers as `nullable: true` (`SEO_DEFINITIONS`,
- *  `apps/website/src/features/seo/settings.ts`), under the real write's own rule: an omitted key
+ *  `features/seo/settings.ts`), under the real write's own rule: an omitted key
  *  (`undefined`) keeps the current value, `null` clears it, and a string overwrites. */
 function settingOrCleared(patchValue, currentValue) {
     if (patchValue === undefined)

package/dist/seo/messages.en.d.ts

@@ -20,21 +20,24 @@ export declare const seoMessagesEn: {
     readonly "Canonical URL": "Canonical URL";
     readonly Noindex: "Noindex";
     readonly Nofollow: "Nofollow";
-    readonly "OG title": "OG title";
-    readonly "OG description": "OG description";
-    readonly "OG image": "OG image";
-    readonly "Twitter title": "Twitter title";
-    readonly "Twitter description": "Twitter description";
-    readonly "Twitter image": "Twitter image";
+    readonly "Preview title": "Preview title";
+    readonly "Preview description": "Preview description";
+    readonly "Preview image": "Preview image";
+    readonly "X/Twitter title": "X/Twitter title";
+    readonly "X/Twitter description": "X/Twitter description";
+    readonly "X/Twitter image": "X/Twitter image";
+    readonly "Customize for X/Twitter (optional)": "Customize for X/Twitter (optional)";
+    readonly "Same as the preview image": "Same as the preview image";
+    readonly "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter": "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter";
     readonly "Saving\u2026": "Saving…";
     readonly "Save overrides": "Save overrides";
     readonly "Per-entry SEO": "Per-entry SEO";
     readonly "Search appearance": "Search appearance";
     readonly "Title template (must contain %s)": "Title template (must contain %s)";
     readonly "Default meta description": "Default meta description";
-    readonly "Social sharing": "Social sharing";
-    readonly "Default Open Graph / Twitter image": "Default Open Graph / Twitter image";
-    readonly "Twitter @site handle": "Twitter @site handle";
+    readonly "Social preview": "Social preview";
+    readonly "Default preview image": "Default preview image";
+    readonly "X/Twitter @handle": "X/Twitter @handle";
     readonly Crawling: "Crawling";
     readonly "Default noindex": "Default noindex";
     readonly "Default nofollow": "Default nofollow";
@@ -47,7 +50,7 @@ export declare const seoMessagesEn: {
     readonly "View sitemap": "View sitemap";
     readonly "Loading SEO settings\u2026": "Loading SEO settings…";
     readonly Marketing: "Marketing";
-    readonly "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.": "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.";
+    readonly "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.": "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.";
     readonly "Choose image": "Choose image";
     readonly Remove: "Remove";
     readonly "Sitemap \u00B7 {count} URLs": "Sitemap · {count} URLs";
@@ -75,5 +78,7 @@ export declare const seoMessagesEn: {
     readonly "failed to load the sitemap": "failed to load the sitemap";
     readonly "Could not load the sitemap (HTTP {status}).": "Could not load the sitemap (HTTP {status}).";
     readonly "Selected image": "Selected image";
+    readonly "Using site default: {name}": "Using site default: {name}";
+    readonly "Using image from page content: {name}": "Using image from page content: {name}";
 };
 //# sourceMappingURL=messages.en.d.ts.map

package/dist/seo/messages.en.js

@@ -20,21 +20,24 @@ export const seoMessagesEn = {
     "Canonical URL": "Canonical URL",
     "Noindex": "Noindex",
     "Nofollow": "Nofollow",
-    "OG title": "OG title",
-    "OG description": "OG description",
-    "OG image": "OG image",
-    "Twitter title": "Twitter title",
-    "Twitter description": "Twitter description",
-    "Twitter image": "Twitter image",
+    "Preview title": "Preview title",
+    "Preview description": "Preview description",
+    "Preview image": "Preview image",
+    "X/Twitter title": "X/Twitter title",
+    "X/Twitter description": "X/Twitter description",
+    "X/Twitter image": "X/Twitter image",
+    "Customize for X/Twitter (optional)": "Customize for X/Twitter (optional)",
+    "Same as the preview image": "Same as the preview image",
+    "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter": "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter",
     "Saving…": "Saving…",
     "Save overrides": "Save overrides",
     "Per-entry SEO": "Per-entry SEO",
     "Search appearance": "Search appearance",
     "Title template (must contain %s)": "Title template (must contain %s)",
     "Default meta description": "Default meta description",
-    "Social sharing": "Social sharing",
-    "Default Open Graph / Twitter image": "Default Open Graph / Twitter image",
-    "Twitter @site handle": "Twitter @site handle",
+    "Social preview": "Social preview",
+    "Default preview image": "Default preview image",
+    "X/Twitter @handle": "X/Twitter @handle",
     "Crawling": "Crawling",
     "Default noindex": "Default noindex",
     "Default nofollow": "Default nofollow",
@@ -47,7 +50,7 @@ export const seoMessagesEn = {
     "View sitemap": "View sitemap",
     "Loading SEO settings…": "Loading SEO settings…",
     "Marketing": "Marketing",
-    "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.": "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.",
+    "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.": "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.",
     "Choose image": "Choose image",
     "Remove": "Remove",
     "Sitemap · {count} URLs": "Sitemap · {count} URLs",
@@ -75,5 +78,7 @@ export const seoMessagesEn = {
     "failed to load the sitemap": "failed to load the sitemap",
     "Could not load the sitemap (HTTP {status}).": "Could not load the sitemap (HTTP {status}).",
     "Selected image": "Selected image",
+    "Using site default: {name}": "Using site default: {name}",
+    "Using image from page content: {name}": "Using image from page content: {name}",
 };
 //# sourceMappingURL=messages.en.js.map

package/dist/seo/models.d.ts

@@ -75,6 +75,8 @@ export interface SeoController {
 }
 export interface EntryPickerController {
     entries: readonly AdminPost[] | null;
+    /** Searchable-picker rows (grouped Pages/Posts); null while entries load. */
+    options?: import('./rules.js').SeoEntryPickerOption[] | null;
     error: string | null;
 }
 export interface SeoEntryPanelOptions {
@@ -98,6 +100,9 @@ export interface SeoEntryPanelController {
      *  `null` for each one they emptied. An untouched field is ABSENT, never `null`: "unchanged" must
      *  never become "clear". */
     touched: SeoEntryOverridesPatch;
+    /** The social preview image comes from content or the site default (`ogImageInherited`, rules.ts). Optional
+     *  for injected legacy views. */
+    ogImageInherited?: false | 'default' | 'content';
 }
 export interface SeoEntrySectionController {
     entryId: string;
@@ -153,6 +158,12 @@ export interface MediaRefFieldController {
     /** The field's current value resolved to a thumbnail `<img src>`, or `null` when the value is
      *  empty or unparseable — see `resolveMediaRefPreviewUrl`'s own doc. */
     previewUrl: string | null;
+    /** The chosen file's display name and pixel size (`describeMediaRef`), or null when empty.
+     *  Optional for injected legacy views. */
+    file?: {
+        name: string;
+        size: string | null;
+    } | null;
     /** Shared diagnostics for defaults, OG and Twitter fields; optional for injected legacy views. */
     warning?: string | null;
     onPreviewLoad?: (event: {

package/dist/seo/react/components/MediaRefField.d.ts

@@ -1,7 +1,7 @@
 import { useWiredMediaRefField } from "../hooks/MediaRefField.hooks.js";
 /**
- * @file `MediaRefField` — a text input for an `{assetId}:{transformName}` media reference (or a
- * pasted absolute URL), plus a "Choose image" affordance that opens the existing
+ * @file `MediaRefField` — an `{assetId}:{transformName}` media reference (or an absolute URL),
+ * shown as the chosen file's thumbnail and name, plus a "Choose image" affordance that opens the existing
  * `MediaPickerDialog`, a thumbnail preview of the current value, and a Remove control.
  *
  * Built for `react/pages/SeoPage.tsx`'s `defaultOgImage`/`ogImage`/`twitterImage` fields (SPEC intent: "make the OG
@@ -16,11 +16,15 @@ import { useWiredMediaRefField } from "../hooks/MediaRefField.hooks.js";
  * 2026-10-08 polish: the original editable-input rationale above still applies to pasted URLs
  * and empty fields. A selected library reference now shows plain copy with its preview; Remove
  * returns to manual entry. A hidden input preserves the exact FormData value on defaults saves.
+ * 2026-10-15: superseded — the input is removed entirely (owner: the read-only box "looks
+ * useless"). An existing pasted URL still displays (by its file name) and still saves unchanged;
+ * a new URL can no longer be typed here, only chosen from the library.
  */
 export interface MediaRefFieldProps {
     locale: string;
-    /** `<input id>`/`<label htmlFor>` pairing — same `getByLabelText`-friendly shape `react/pages/SeoPage.tsx`'s
-     *  other explicit-`htmlFor` fields already use. */
+    /** Base id: the caption is `{id}-label` and names the row's `role="group"`; the hidden input (when
+     *  `name` is set) carries the id itself. Was an `<input id>`/`<label htmlFor>` pair until the text
+     *  box was removed (2026-10-15). */
     id: string;
     /** Forwarded to the `<input name>` only when set — `defaultOgImage` needs this (its `<form>` reads
      *  `FormData` by name on submit); the per-entry `ogImage`/`twitterImage` fields do not (they save
@@ -32,9 +36,17 @@ export interface MediaRefFieldProps {
     /** This field's own base handle — appended `-choose`/`-clear`/`-dialog` for its own controls, and
      *  forwarded as-is to the `<input>` itself. Omit to leave every element here untagged. */
     agentHandle?: string;
+    /** Shown in the file slot while no image is set — for a field that inherits another field's
+     *  image when empty (the X image falls back to the social preview image). */
+    emptyHint?: string;
+    /** The value comes from the site default or page content, with no SEO override of its own: the file
+     *  shows muted as "Using site default: …" or "Using image from page content: …"; size and Remove
+     *  are hidden — there is no SEO override to remove. "Choose image" is how an override starts
+     *  (owner, 2026-10-15). */
+    inherited?: false | 'default' | 'content';
     /** Injectable seam for the picker's own state — same convention as `MediaPickerDialog`'s own
      *  `useDialog` prop. Defaults to the real {@link useWiredMediaRefField}. */
     useField?: typeof useWiredMediaRefField;
 }
-export declare function MediaRefField({ locale, id, name, label, value, onChange, agentHandle: base, useField, }: MediaRefFieldProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function MediaRefField({ locale, id, name, label, value, onChange, agentHandle: base, emptyHint, inherited, useField, }: MediaRefFieldProps, _optional?: Record<string, never>): import("react").JSX.Element;
 //# sourceMappingURL=MediaRefField.d.ts.map

package/dist/seo/react/components/MediaRefField.js

@@ -1,12 +1,22 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { agentHandle } from "@jini-ai/agentic";
+import { interpolate } from "@jini-ai/ui/i18n";
 import { MediaPickerBridge } from "./MediaPickerBridge.js";
 import { useSeoCopy } from "../hooks/SeoPorts.hooks.js";
 import { useWiredMediaRefField, useMediaRefPresentation, handleSpread } from "../hooks/MediaRefField.hooks.js";
-export function MediaRefField({ locale, id, name, label, value, onChange, agentHandle: base, useField = useWiredMediaRefField, }, _optional = {}) {
+export function MediaRefField({ locale, id, name, label, value, onChange, agentHandle: base, emptyHint, inherited = false, useField = useWiredMediaRefField, }, _optional = {}) {
     const t = useSeoCopy();
-    const { Picker = MediaPickerBridge, storedReference } = useMediaRefPresentation({ value });
-    const { pickerOpen, openPicker, closePicker, handleSelect, clear, previewUrl, accept, warning, onPreviewLoad, onPreviewError } = useField({ value, onChange });
-    return (_jsxs("div", { className: "jini-field jini-media-ref-field", children: [_jsx("label", { className: "jini-field-label", htmlFor: id, children: label }), _jsxs("div", { className: "jini-media-ref-field-row", children: [_jsx("input", { className: "jini-input", id: id, name: storedReference ? undefined : name, value: storedReference ? t({ locale, key: "Selected image" }) : value, readOnly: storedReference, "aria-describedby": warning ? `${id}-warning` : undefined, onChange: (e) => onChange(e.target.value), ...(base ? agentHandle({ handle: base }, { role: "field", label }) : {}) }), storedReference && name ? _jsx("input", { type: "hidden", name: name, value: value }) : null, _jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: openPicker, ...handleSpread({ ...(base === undefined ? {} : { base }), suffix: "choose", label: `Choose an image for: ${label}` }), children: t({ locale: locale, key: "Choose image" }) }), value ? (_jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: clear, ...handleSpread({ ...(base === undefined ? {} : { base }), suffix: "clear", label: `Remove the selected image for: ${label}` }), children: t({ locale: locale, key: "Remove" }) })) : null] }), previewUrl ? _jsx("img", { className: "jini-media-ref-field-preview", src: previewUrl, alt: `${label} preview`, onLoad: onPreviewLoad, onError: onPreviewError }, previewUrl) : null, warning ? _jsx("p", { id: `${id}-warning`, className: "jini-notice jini-notice-warning", role: "status", children: warning }) : null, pickerOpen ? (_jsx(Picker, { onSelect: handleSelect, onCancel: closePicker, accept: accept, agentHandle: base ? `${base}-dialog` : undefined })) : null] }));
+    const { Picker = MediaPickerBridge } = useMediaRefPresentation({ value });
+    const { pickerOpen, openPicker, closePicker, handleSelect, clear, previewUrl, file, accept, onPreviewLoad, onPreviewError } = useField({ value, onChange });
+    const labelId = `${id}-label`;
+    /* One compact row: thumbnail, the file's name and size, then Choose/Remove kept together in their
+       own group so a narrow column wraps the pair as one unit instead of stranding Remove on a line of
+       its own (owner, 2026-10-15). The thumbnail used to sit under the row at 4rem, repeated per field.
+       `warning` (share-image size/byte/HTTP diagnostics) is still computed by the hook but no longer
+       painted: the owner called the yellow callout under every image "completely useless".
+       2026-10-15 (round 3): the text box is gone — for a library pick it only ever said a read-only
+       "Selected image" ("i can't change it and looks useless"), so the row names the file instead and
+       the picker is the one way in. The exact value still rides a hidden input for FormData saves. */
+    return (_jsxs("div", { className: "jini-field jini-media-ref-field", children: [_jsx("span", { className: "jini-field-label", id: labelId, children: label }), _jsxs("div", { className: "jini-media-ref-field-row", role: "group", "aria-labelledby": labelId, ...(base ? agentHandle({ handle: base }, { role: "region", label }) : {}), children: [file ? (_jsxs("span", { className: inherited ? "jini-media-ref-field-file jini-media-ref-field-file-inherited" : "jini-media-ref-field-file", children: [previewUrl ? _jsx("img", { className: "jini-media-ref-field-preview", src: previewUrl, alt: `${label} preview`, onLoad: onPreviewLoad, onError: onPreviewError }, previewUrl) : null, _jsx("span", { className: "jini-media-ref-field-name", title: file.name, children: inherited ? interpolate({ template: t({ locale: locale, key: inherited === 'content' ? "Using image from page content: {name}" : "Using site default: {name}", vars: { name: file.name } }), vars: { name: file.name } }) : file.name }), file.size && !inherited ? _jsx("span", { className: "jini-media-ref-field-size", children: file.size }) : null] })) : (emptyHint && _jsx("span", { className: "jini-media-ref-field-empty", children: emptyHint })), name ? _jsx("input", { type: "hidden", id: id, name: name, value: value }) : null, _jsxs("span", { className: "jini-media-ref-field-actions", children: [_jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: openPicker, ...handleSpread({ ...(base === undefined ? {} : { base }), suffix: "choose", label: `Choose an image for: ${label}` }), children: t({ locale: locale, key: "Choose image" }) }), value && !inherited ? (_jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: clear, ...handleSpread({ ...(base === undefined ? {} : { base }), suffix: "clear", label: `Remove the selected image for: ${label}` }), children: t({ locale: locale, key: "Remove" }) })) : null] })] }), pickerOpen ? (_jsx(Picker, { onSelect: handleSelect, onCancel: closePicker, accept: accept, agentHandle: base ? `${base}-dialog` : undefined })) : null] }));
 }
 //# sourceMappingURL=MediaRefField.js.map

package/dist/seo/react/components/SitemapModal.js

@@ -64,7 +64,7 @@ export function SitemapModal({ locale, sitemapEnabled, regenerating, onRegenerat
     const { title } = useSitemapPresentation({ locale, modal });
     const { handleRegenerate } = useSitemapModalRegenerate({ onRegenerate });
     // Native modality keeps Tab from reaching the background, as MediaPickerDialog now does too.
-    return (_jsxs(Dialog, { open: true, title: title, onClose: () => onClose(), className: "settings-dialog tovu-domain-dialog sitemap-modal", children: [_jsx("div", { className: "sitemap-modal-header", children: _jsx(SitemapModalHeaderActions, { locale: locale, modal: modal }) }), _jsx("div", { className: "sitemap-modal-body", children: _jsx(SitemapModalBody, { locale: locale, sitemapEnabled: sitemapEnabled, modal: modal }) }), _jsx("div", { className: "widget-picker-footer", children: _jsxs("span", { className: "editor-actions", children: [_jsx("button", { type: "button", className: "btn-secondary", onClick: handleRegenerate, disabled: regenerating, ...agentHandle({ handle: "seo-sitemap-modal-regenerate" }, {
+    return (_jsxs(Dialog, { open: true, title: title, onClose: () => onClose(), className: "settings-dialog jini-domain-dialog sitemap-modal", children: [_jsx("div", { className: "sitemap-modal-header", children: _jsx(SitemapModalHeaderActions, { locale: locale, modal: modal }) }), _jsx("div", { className: "sitemap-modal-body", children: _jsx(SitemapModalBody, { locale: locale, sitemapEnabled: sitemapEnabled, modal: modal }) }), _jsx("div", { className: "widget-picker-footer", children: _jsxs("span", { className: "editor-actions", children: [_jsx("button", { type: "button", className: "btn-secondary", onClick: handleRegenerate, disabled: regenerating, ...agentHandle({ handle: "seo-sitemap-modal-regenerate" }, {
                                 role: "button",
                                 label: "Rebuild the cached sitemap and refresh this view",
                             }), children: actionLabel({ pending: regenerating, pendingLabel: t({ locale: locale, key: "Working…" }), idleLabel: t({ locale: locale, key: "Regenerate sitemap" }) }) }), _jsx("button", { type: "button", className: "btn-secondary", onClick: onClose, "data-jini-autofocus": "", ...agentHandle({ handle: "seo-sitemap-modal-close" }, { role: "button", label: "Close the sitemap viewer" }), children: t({ locale: locale, key: "Close" }) })] }) })] }));

package/dist/seo/react/hooks/MediaRefField.hooks.js

@@ -3,16 +3,24 @@ import { useShareImageWarning } from './use-share-image-warning.hooks.js';
 import { agentHandle } from '@jini-ai/agentic';
 import { useController } from '../../../core/react/use-controller.js';
 import { createMediaRefController } from '../../controllers/media-ref.controller.js';
-import { isStoredMediaRef, resolveMediaRefPreviewUrl } from '../../rules.js';
+import { describeMediaRef, isStoredMediaRef, resolveMediaRefPreviewUrl } from '../../rules.js';
+import { useFetchQuery } from '@jini-ai/ui/fetch-query';
+import { extensionForMimeType } from '@jini-ai/ui';
+import { SEO_KEYS } from './SeoQuery.hooks.js';
 import { useSeoPorts, useSeoOptions } from './SeoPorts.hooks.js';
 export function useMediaRefField({ value, onChange, api }, { t } = {}) {
     const change = useRef(onChange);
     change.current = onChange;
     const { controller, snapshot } = useController({ create: () => createMediaRefController({ onChange: value => change.current(value) }), dependencies: [] });
     const previewUrl = api.mediaPreviewUrl ? api.mediaPreviewUrl({ value }) : resolveMediaRefPreviewUrl({ value, mediaOriginalUrl: id => api.mediaOriginalUrl({ id }) });
-    const diagnostics = useShareImageWarning({ value, previewUrl, api }, { t });
+    const { naturalWidth, naturalHeight, ...diagnostics } = useShareImageWarning({ value, previewUrl, api }, { t });
+    // One cached library read shared by every image field on the screen; only a library reference
+    // needs it (a URL names itself), and a host without `listSeoMedia` falls back to the slug.
+    const list = api.listSeoMedia;
+    const media = useFetchQuery({ key: SEO_KEYS.media, fetch: () => list ? list.call(api, {}) : Promise.resolve([]) }, { enabled: Boolean(list) && isStoredMediaRef({ value }) });
     return {
         ...diagnostics,
+        file: describeMediaRef({ value, media: media.data }, { width: naturalWidth, height: naturalHeight, t, extensionFor: extensionForMimeType }),
         pickerOpen: snapshot?.pickerOpen ?? false,
         openPicker: () => controller?.openPicker({}), closePicker: () => controller?.closePicker({}),
         handleSelect: item => controller?.handleSelect({ item }), clear: () => controller?.clear({}),

package/dist/seo/react/hooks/SeoPage.hooks.d.ts

@@ -29,6 +29,7 @@ export declare function useAnalyzePanel({ analysis }: {
     analysis: SeoEntryAnalysis;
 }, _optional?: Record<string, never>): {
     sortedIssues: import("../../../core/index.js").AdminSeoIssue[];
+    tone: "warning" | "success" | "failure";
 };
 /** All seven defaults remain in one FormData submission; tabs never split this form. */
 export declare function useSeoDefaults({ save }: {

package/dist/seo/react/hooks/SeoPage.hooks.js

@@ -1,6 +1,6 @@
 import { createElement } from 'react';
 import { SeoDefaultsIcon, SeoSitemapIcon, SeoEntriesIcon } from '../components/SeoIcons.js';
-import { buildSeoSettingsPatch, resolveSeoTabId, sortIssuesBySeverity } from '../../rules.js';
+import { buildSeoSettingsPatch, resolveSeoTabId, sortIssuesBySeverity, scoreTone } from '../../rules.js';
 import { useSeoOptions } from './SeoPorts.hooks.js';
 export { buildSeoSettingsPatch, resolveSeoTabId } from '../../rules.js';
 export function resolveSeoTabs(_required = {}, { t = key => key } = {}) {
@@ -20,7 +20,7 @@ export function useSeoTabs({ tabId }, _optional = {}) {
     return { activeTabId: resolveSeoTabId({ tabId }), tabs: resolveSeoTabs({}, { t }) };
 }
 export function useAnalyzePanel({ analysis }, _optional = {}) {
-    return { sortedIssues: sortIssuesBySeverity({ issues: analysis.issues }) };
+    return { sortedIssues: sortIssuesBySeverity({ issues: analysis.issues }), tone: scoreTone({ score: analysis.score }) };
 }
 /** All seven defaults remain in one FormData submission; tabs never split this form. */
 export function useSeoDefaults({ save }, _optional = {}) {

package/dist/seo/react/hooks/SeoQuery.hooks.d.ts

@@ -8,6 +8,7 @@ export declare const SEO_KEYS: {
     }, _optional?: Record<string, never>) => readonly ["seo", "entry", string];
     choices: readonly ["seo", "choices"];
     sitemap: readonly ["seo", "sitemap"];
+    media: readonly ["seo", "media"];
 };
 /** Controllers keep their draft/error contracts; these injected ports share the provider cache.
  * Reads omit a controller's abort signal because another mounted consumer can own the same read.

package/dist/seo/react/hooks/SeoQuery.hooks.js

@@ -7,6 +7,7 @@ export const SEO_KEYS = {
     entry: ({ entryId }, _optional = {}) => ['seo', 'entry', entryId],
     choices: ['seo', 'choices'],
     sitemap: ['seo', 'sitemap'],
+    media: ['seo', 'media'],
 };
 /** Controllers keep their draft/error contracts; these injected ports share the provider cache.
  * Reads omit a controller's abort signal because another mounted consumer can own the same read.

package/dist/seo/react/hooks/use-entry-picker.hooks.js

@@ -2,13 +2,18 @@ import { describeSeoError } from '../../models.js';
 import { useFetchQuery } from '@jini-ai/ui/fetch-query';
 import { SEO_KEYS } from './SeoQuery.hooks.js';
 import { initialEntryPickerState } from '../../models.js';
+import { entryPickerOptions } from '../../rules.js';
 import { useSeoOptions, useSeoPorts } from './SeoPorts.hooks.js';
 export function useEntryPicker({ api }, { t, describeError } = {}) {
     const query = useFetchQuery({ key: SEO_KEYS.choices, fetch: async () => {
             const [posts, pages] = await Promise.all([api.listSeoPosts({}), api.listSeoPages({})]);
-            return [...posts, ...pages];
+            return { posts, pages };
         } });
-    return { ...initialEntryPickerState, entries: query.data ?? null, error: query.error ? (describeError ?? describeSeoError)({ error: query.error, fallback: t?.('failed to load entries') ?? 'failed to load entries' }) : null };
+    const data = query.data;
+    return { ...initialEntryPickerState,
+        entries: data ? [...data.posts, ...data.pages] : null,
+        options: data ? entryPickerOptions(data, { t }) : null,
+        error: query.error ? (describeError ?? describeSeoError)({ error: query.error, fallback: t?.('failed to load entries') ?? 'failed to load entries' }) : null };
 }
 export function useWiredEntryPicker(_required = {}, _optional = {}) {
     const { seoApi: api } = useSeoPorts();