@jini-ai/admin 0.4.11 → 0.4.13

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): import("react").JSX.Element;
 //# sourceMappingURL=MediaRefField.d.ts.map

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

@@ -1,12 +1,39 @@
 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, }) {
     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: [_jsx(MediaRefFile, { file: file, emptyHint: emptyHint, label: label, locale: locale, t: t, inherited: inherited, previewUrl: previewUrl, onPreviewLoad: onPreviewLoad, onPreviewError: onPreviewError }), name ? _jsx("input", { type: "hidden", id: id, name: name, value: value }) : null, _jsx(MediaRefActions, { label: label, locale: locale, t: t, base: base, value: value, inherited: inherited, openPicker: openPicker, clear: clear })] }), pickerOpen ? (_jsx(Picker, { onSelect: handleSelect, onCancel: closePicker, accept: accept, agentHandle: base ? `${base}-dialog` : undefined })) : null] }));
+}
+/** The chosen file: thumbnail, name (prefixed with its source when inherited) and, for an own
+ *  override, its pixel size. With no file, the field's empty hint (if any) takes the slot. */
+function MediaRefFile({ file, emptyHint, label, locale, t, inherited, previewUrl, onPreviewLoad, onPreviewError }) {
+    if (!file)
+        return emptyHint ? _jsx("span", { className: "jini-media-ref-field-empty", children: emptyHint }) : null;
+    return (_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 ? inheritedFileName({ name: file.name, inherited, locale, t }) : file.name }), file.size && !inherited ? _jsx("span", { className: "jini-media-ref-field-size", children: file.size }) : null] }));
+}
+/** "Using site default: {name}" or "Using image from page content: {name}", translated. */
+function inheritedFileName({ name, inherited, locale, t }, _optional = {}) {
+    const key = inherited === "content" ? "Using image from page content: {name}" : "Using site default: {name}";
+    return interpolate({ template: t({ locale, key, vars: { name } }), vars: { name } });
+}
+/** Choose (always) and Remove (only for an own value), grouped so they wrap as one unit. */
+function MediaRefActions({ label, locale, t, base, value, inherited, openPicker, clear }) {
+    const handleBase = base === undefined ? {} : { base };
+    return (_jsxs("span", { className: "jini-media-ref-field-actions", children: [_jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: openPicker, ...handleSpread({ ...handleBase, suffix: "choose", label: `Choose an image for: ${label}` }), children: t({ locale, key: "Choose image" }) }), value && !inherited ? (_jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: clear, ...handleSpread({ ...handleBase, suffix: "clear", label: `Remove the selected image for: ${label}` }), children: t({ locale, key: "Remove" }) })) : null] }));
 }
 //# sourceMappingURL=MediaRefField.js.map

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

@@ -3,16 +3,26 @@ 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;
+    // `fetch` runs only while the query is enabled, which requires `list`: the fetch-query adapters
+    // never call a disabled read's fetch (not on mount, focus or prefix invalidation).
+    const media = useFetchQuery({ key: SEO_KEYS.media, fetch: () => list.call(api, {}) }, { 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: "failure" | "warning" | "success";
 };
 /** 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();

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

@@ -1,9 +1,11 @@
 import { describeSeoError } from '../../models.js';
 import { useEffect, useRef } from 'react';
-import { useSeoEntryQuery } from './SeoQuery.hooks.js';
+import { useSeoEntryQuery, SEO_KEYS } from './SeoQuery.hooks.js';
+import { useFetchQuery } from '@jini-ai/ui/fetch-query';
 import { useController } from '../../../core/react/use-controller.js';
 import { createSeoEntryController } from '../../controllers/seo-entry.controller.js';
 import { initialSeoEntryState } from '../../models.js';
+import { inheritedXFor, ogImageInherited } from '../../rules.js';
 import { useSeoOptions, useSeoPorts } from './SeoPorts.hooks.js';
 export function useSeoEntryPanel({ api, entryId }, { t, describeError } = {}) {
     const cached = useSeoEntryQuery({ api, entryId });
@@ -17,11 +19,20 @@ export function useSeoEntryPanel({ api, entryId }, { t, describeError } = {}) {
         if (controller && cached.query.data)
             controller.set({ patch: cached.query.data });
     }, [controller, cached.query.data]);
+    // The site defaults read the Site defaults tab already caches; only the default image is used here.
+    const settings = useFetchQuery({ key: SEO_KEYS.settings, fetch: () => api.getSeoSettings({}) });
     const state = snapshot ?? initialSeoEntryState;
     return {
         ...state,
+        ogImageInherited: state.resolved ? ogImageInherited({ meta: state.resolved, defaultOgImage: settings.data?.defaultOgImage, touched: state.touched }) : false,
         fieldValue: (key, resolvedValue) => controller ? controller.fieldValue({ key, resolvedValue }) : resolvedValue,
-        setField: (key, value) => controller?.setField({ key, value }),
+        setField: (key, value) => {
+            // An edit to the social preview also clears an X field that was following it (rules.ts).
+            const xKey = state.resolved ? inheritedXFor({ key, meta: state.resolved, touched: state.touched }) : null;
+            controller?.setField({ key, value });
+            if (xKey)
+                controller?.setField({ key: xKey, value: '' });
+        },
         save: async () => { await controller?.save({}); },
     };
 }

package/dist/seo/react/hooks/use-share-image-warning.hooks.d.ts

@@ -15,5 +15,8 @@ export declare function useShareImageWarning({ value, previewUrl, api }: {
     api: AdminSeoPort;
 }, { t }?: {
     t?: SeoTranslator | undefined;
-}): Pick<MediaRefFieldController, 'warning' | 'onPreviewLoad' | 'onPreviewError'>;
+}): Pick<MediaRefFieldController, 'warning' | 'onPreviewLoad' | 'onPreviewError'> & {
+    naturalWidth?: number | undefined;
+    naturalHeight?: number | undefined;
+};
 //# sourceMappingURL=use-share-image-warning.hooks.d.ts.map

package/dist/seo/react/hooks/use-share-image-warning.hooks.js

@@ -17,20 +17,8 @@ export function useShareImageWarning({ value, previewUrl, api }, { t = key => ke
     const [inspection, setInspection] = useState(null);
     useEffect(() => {
         const inspect = api.inspectShareImage;
-        if (!previewUrl || !inspect)
+        if (!previewUrl || !inspect || !isBrowserSameOrigin({ url: previewUrl }))
             return;
-        // Browser origin, rather than the public site's alias: a cross-origin HEAD cannot establish
-        // that an otherwise loadable external image is missing when the server omits CORS headers.
-        const location = globalThis.location;
-        if (!location)
-            return;
-        try {
-            if (new URL(previewUrl, location.href).origin !== location.origin)
-                return;
-        }
-        catch {
-            return;
-        }
         const controller = new AbortController();
         let active = true;
         const timeout = setTimeout(() => {
@@ -39,17 +27,8 @@ export function useShareImageWarning({ value, previewUrl, api }, { t = key => ke
             setInspection({ url: previewUrl, error: { key: 'The share image check timed out after 10 seconds.' } });
         }, 10_000);
         inspect.call(api, { url: previewUrl }, { signal: controller.signal }).then(({ status, byteSize }) => {
-            if (!active)
-                return;
-            if (status === 404 || status === 410) {
-                setInspection({ url: previewUrl, error: { key: 'The share image is missing (HTTP {status}).', vars: { status } } });
-            }
-            else if (status < 200 || status >= 300) {
-                setInspection({ url: previewUrl, error: { key: 'The share image could not be checked (HTTP {status}).', vars: { status } } });
-            }
-            else {
-                setInspection({ url: previewUrl, byteSize });
-            }
+            if (active)
+                setInspection(inspectionFromResponse({ url: previewUrl, status, byteSize }));
         }).catch((error) => {
             if (!active)
                 return;
@@ -58,22 +37,58 @@ export function useShareImageWarning({ value, previewUrl, api }, { t = key => ke
         }).finally(() => { clearTimeout(timeout); });
         return () => { active = false; clearTimeout(timeout); controller.abort(); };
     }, [previewUrl, api]);
-    const source = decoded?.url === previewUrl ? decoded : null;
-    const checked = inspection?.url === previewUrl ? inspection : null;
-    const error = checked?.error;
+    const source = stateForUrl({ state: decoded, url: previewUrl });
+    const checked = stateForUrl({ state: inspection, url: previewUrl });
     return {
-        warning: shareImageWarning({ value, previewUrl, width: source?.width, height: source?.height, previewFailed: source?.failed, byteSize: checked?.byteSize,
-            error: error ? interpolate({ template: t(error.key, error.vars), vars: error.vars ?? {} }) : undefined }, { t }),
+        naturalWidth: source.width, naturalHeight: source.height,
+        warning: shareImageWarning({ value, previewUrl, width: source.width, height: source.height, previewFailed: source.failed, byteSize: checked.byteSize,
+            error: translatedInspectionError({ error: checked.error }, { t }) }, { t }),
         onPreviewLoad: ({ currentTarget }) => {
-            const url = currentTarget.getAttribute('src');
-            if (url && url === currentUrl.current)
+            const url = currentPreviewSrc({ image: currentTarget, currentUrl: currentUrl.current });
+            if (url)
                 setDecoded({ url, width: currentTarget.naturalWidth, height: currentTarget.naturalHeight });
         },
         onPreviewError: ({ currentTarget }) => {
-            const url = currentTarget.getAttribute('src');
-            if (url && url === currentUrl.current)
+            const url = currentPreviewSrc({ image: currentTarget, currentUrl: currentUrl.current });
+            if (url)
                 setDecoded({ url, failed: true });
         },
     };
 }
+/** URL-keyed state for the current preview only; a prior choice's state reads as nothing known. */
+function stateForUrl({ state, url }, _optional = {}) {
+    return state?.url === url ? state : {};
+}
+/** Whether `url` resolves to the browser's own origin; `false` outside a browser or for an unparseable URL. */
+function isBrowserSameOrigin({ url }, _optional = {}) {
+    // Browser origin, rather than the public site's alias: a cross-origin HEAD cannot establish
+    // that an otherwise loadable external image is missing when the server omits CORS headers.
+    const location = globalThis.location;
+    if (!location)
+        return false;
+    try {
+        return new URL(url, location.href).origin === location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+/** A HEAD response as inspection state: 404/410 is a missing file, any other non-2xx an unchecked
+ * one, and a 2xx carries the reported byte size. */
+function inspectionFromResponse({ url, status, byteSize }, _optional = {}) {
+    if (status === 404 || status === 410)
+        return { url, error: { key: 'The share image is missing (HTTP {status}).', vars: { status } } };
+    if (status < 200 || status >= 300)
+        return { url, error: { key: 'The share image could not be checked (HTTP {status}).', vars: { status } } };
+    return { url, byteSize };
+}
+/** The inspection error's copy, translated at render so a language switch re-renders it. */
+function translatedInspectionError({ error }, { t }) {
+    return error ? interpolate({ template: t(error.key, error.vars), vars: error.vars ?? {} }) : undefined;
+}
+/** The preview image's `src` when it is still the current selection's; `null` for a stale event. */
+function currentPreviewSrc({ image, currentUrl }, _optional = {}) {
+    const url = image.getAttribute('src');
+    return url && url === currentUrl ? url : null;
+}
 //# sourceMappingURL=use-share-image-warning.hooks.js.map

package/dist/seo/react/index.d.ts

@@ -36,21 +36,24 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
         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";
@@ -63,7 +66,7 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
         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";
@@ -91,6 +94,8 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
         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}";
     };
     pages: {
         readonly settings: {
@@ -158,21 +163,24 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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";
@@ -185,7 +193,7 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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";
@@ -213,6 +221,8 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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}";
             };
             readonly pages: {
                 readonly settings: {
@@ -281,21 +291,24 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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";
@@ -308,7 +321,7 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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";
@@ -336,6 +349,8 @@ export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optio
                 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}";
             };
             readonly pages: {
                 readonly settings: {

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

@@ -65,6 +65,8 @@ import { useWiredSeo } from "../hooks/use-seo.hooks.js";
  */
 export interface SeoSectionProps {
     title: string;
+    /** Optional ⓘ explanation beside the title (explanations are tips, never loose paragraphs). */
+    tip?: string;
     children: ReactNode;
 }
 export interface EntryPickerProps {
@@ -94,7 +96,7 @@ export interface SeoEntrySectionProps {
  *  and nothing else — the exact regression `deployment/HistoryTab.tsx`'s own comment records
  *  measuring live on its tab. It is also not a duplicate: the tab reads "Pages & posts" (what you
  *  pick from), the heading reads "Per-entry SEO" (what you are editing). */
-export declare function SeoEntrySection({ locale, useSeoEntrySectionHook }: SeoEntrySectionProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function SeoEntrySection({ locale, useSeoEntrySectionHook }: SeoEntrySectionProps): import("react").JSX.Element;
 /** What the two site-wide tab panels need from `useWiredSeo()`. Named as one object rather than
  *  passed as six loose props for the same reason `Roles.tsx`'s `RoleCreateFormController` documents:
  *  none of these is meaningful without the others, so naming the group is what lets a test hand a
@@ -116,7 +118,7 @@ export declare function SeoEntrySection({ locale, useSeoEntrySectionHook }: SeoE
  */
 export declare function SeoDefaultsTab({ controller }: {
     controller: SeoTabController;
-}, _optional?: Record<string, never>): import("react").JSX.Element;
+}): import("react").JSX.Element;
 /**
  * The "Sitemap" tab — the two sitemap actions, moved here verbatim, plus one line this screen never
  * had: whether a sitemap is being published at all.
@@ -136,7 +138,7 @@ export declare function SeoDefaultsTab({ controller }: {
  */
 export declare function SeoSitemapTab({ controller }: {
     controller: SeoTabController;
-}, _optional?: Record<string, never>): import("react").JSX.Element;
+}): import("react").JSX.Element;
 /** Dispatches the one active tab's panel as a flat if-chain — a plain function rather than a
  *  ternary written directly in `Seo`'s JSX, which would be counted against that component's own
  *  complexity. Same split `Deployment.tsx`'s `deploymentTabPanel` and `Sites.tsx`'s `sitesTabPanel`
@@ -155,7 +157,7 @@ export interface SeoProps {
         tab: string;
     }, optional?: Record<string, never>) => void) | undefined;
 }
-export declare function Seo({ tabId, onTabChange, useSeoHook }?: SeoProps, _optional?: Record<string, never>): import("react").JSX.Element;
+export declare function Seo({ tabId, onTabChange, useSeoHook }?: SeoProps): import("react").JSX.Element;
 export { Seo as SeoPage };
 export default Seo;
 //# sourceMappingURL=SeoPage.d.ts.map