@jini-ai/admin 0.4.10 → 0.4.12

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

@@ -62,6 +62,7 @@ export function useShareImageWarning({ value, previewUrl, api }, { t = key => ke
     const checked = inspection?.url === previewUrl ? inspection : null;
     const error = checked?.error;
     return {
+        naturalWidth: source?.width, naturalHeight: source?.height,
         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 }),
         onPreviewLoad: ({ currentTarget }) => {

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

@@ -20,7 +20,7 @@ import { useWiredSeo } from "../hooks/use-seo.hooks.js";
  * still a minimal textarea-per-rule form (unchanged from the original disclosed scope note).
  *
  * Copy comes from the module's injected t function. Legacy locale props remain render-contract
- * metadata only; Tovu retains its dictionaries and passes the bound translator through the module.
+ * metadata only; the host retains its dictionaries and passes the bound translator through the module.
  * Host publish behavior is injected as headerActions, and media selection uses its existing slot
  * or the shared mediaPickerToken service. The original rationale is archived in SOURCE-RATIONALE.
  *
@@ -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 {

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

@@ -2,8 +2,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useAnalyzePanel, useSeoDefaults, useSeoTabs, seoTabPanel } from "../hooks/SeoPage.hooks.js";
 import { agentHandle } from "@jini-ai/agentic";
 import { TabBar } from "@jini-ai/ui/tab-strip";
+import { InfoTip, Select } from "@jini-ai/ui/admin-widgets";
 import { useSeoCopy, useSeoOptions } from "../hooks/SeoPorts.hooks.js";
-import { actionLabel, orEmpty } from "../../rules.js";
+import { actionLabel, orEmpty, xIsCustomized, xResolvedValue } from "../../rules.js";
 import { useWiredEntryPicker } from "../hooks/use-entry-picker.hooks.js";
 import { useWiredSeoEntryPanel } from "../hooks/use-seo-entry-panel.hooks.js";
 import { useSeoEntrySection } from "../hooks/use-seo-entry-section.hooks.js";
@@ -29,31 +30,27 @@ import { SitemapModal } from "../components/SitemapModal.js";
  * overrides", which sits INSIDE the "Per-entry SEO" section — keeps its own `<h3>` and is not
  * routed through here.
  */
-function SeoSection({ title, children }) {
-    return (_jsxs("section", { className: "jini-seo-section", children: [_jsx("div", { className: "jini-seo-section-head", children: _jsx("h2", { className: "jini-seo-section-title", children: title }) }), _jsx("div", { className: "jini-seo-section-body", children: children })] }));
+function SeoSection({ title, tip, children }) {
+    return (_jsxs("section", { className: "jini-seo-section", children: [_jsx("div", { className: "jini-seo-section-head", children: _jsxs("h2", { className: "jini-seo-section-title", children: [title, tip ? _jsx(InfoTip, { label: tip }) : null] }) }), _jsx("div", { className: "jini-seo-section-body", children: children })] }));
 }
-/** Dropdown over every post + page, sourced from the already-existing `listPosts`/`listPages`
- * routes — cheapest entry-selection UX available given what's already built (REQ-06). */
+/** Searchable picker over every page + post, sourced from the already-existing `listPosts`/`listPages`
+ * routes (REQ-06). It was a native `<select>`; with a few dozen entries that opened as one tall OS
+ * list with "(published)" after every row (owner, 2026-10-15: "we have a searchable dropdown
+ * right?"). The shared admin-widgets `Select` already types-to-filter and handles the keyboard, so
+ * rows are just grouped Pages/Posts with a pill only for the non-published exceptions
+ * (`entryPickerOptions` in `rules.ts`). */
 function EntryPicker({ locale, entryId, onChange, useEntryPickerHook = useWiredEntryPicker }) {
     const t = useSeoCopy();
-    const { entries, error } = useEntryPickerHook();
+    const { entries, options, error } = useEntryPickerHook();
     if (error)
         return _jsx("div", { className: "jini-notice jini-notice-error", children: error });
     if (!entries)
         return _jsx("div", { className: "jini-notice", children: t({ locale: locale, key: "Loading entries…" }) });
     /* The "Entry" caption is no longer painted (owner, 2026-09-06: "you can actually just get rid of
-       'Entry'") — the placeholder option already says "Choose an entry…", so the visible word was
-       saying it twice, and with no gap between the two it read as one smashed-together control.
-       It stays a REAL label rather than becoming a placeholder-only select: this is the exact
-       `<label class="a11y-label-wrap">` + `.visually-hidden` idiom `styles/editor.css` documents for
-       the four controls a previous accessibility pass found unnamed — including, by name, a
-       `<select>` with no accessible name at all. `display: contents` drops the wrapper's own box, so
-       the select keeps the section body's sizing exactly as if the label were not there.
-       The i18n key is unchanged and still passed through `t`, so nothing dangles. */
-    return (_jsxs("label", { className: "jini-a11y-label-wrap", children: [_jsx("span", { className: "jini-visually-hidden", children: t({ locale: locale, key: "Entry" }) }), _jsxs("select", { className: "jini-select", value: entryId, onChange: (e) => onChange(e.target.value), ...agentHandle({ handle: "seo-entry-picker" }, {
-                    role: "field",
-                    label: "Choose which page or post to edit or analyze SEO for",
-                }), children: [_jsx("option", { value: "", children: t({ locale: locale, key: "Choose an entry…" }) }), entries.map((entry) => (_jsxs("option", { value: entry.id, children: [entry.title, " (", entry.status, ")"] }, entry.id)))] })] }));
+       'Entry'") — the placeholder already says "Choose an entry…", so the visible word was saying it
+       twice. It stays the control's accessible name (now `aria-label` on the combobox trigger) rather
+       than leaving a placeholder-only control with no name at all. The i18n key is unchanged. */
+    return (_jsx("div", { className: "jini-seo-entry-picker", children: _jsx(Select, { value: entryId, onChange: onChange, options: options ?? [], placeholder: t({ locale: locale, key: "Choose an entry…" }), "aria-label": t({ locale: locale, key: "Entry" }), agentHandle: "seo-entry-picker", translate: (key) => t({ locale, key }) }) }));
 }
 /** Read-only score + issues view (REQ-07) — exact field names read off `SeoAnalysis`/`SeoIssue`
  * (`src/seo/types.ts`), not guessed. No state of its own — only the severity sort, which lives in
@@ -61,8 +58,11 @@ function EntryPicker({ locale, entryId, onChange, useEntryPickerHook = useWiredE
 function AnalyzePanel(props) {
     const t = useSeoCopy();
     const { locale } = props;
-    const { sortedIssues } = useAnalyzePanel({ analysis: props.analysis });
-    return (_jsxs("div", { className: "jini-seo-analyze-panel", children: [_jsx("h3", { children: t({ locale: locale, key: "Analysis" }) }), _jsxs("p", { children: [t({ locale: locale, key: "Score:" }), " ", _jsx("strong", { children: props.analysis.score })] }), sortedIssues.length === 0 ? (_jsx("p", { className: "jini-muted-cell", children: t({ locale: locale, key: "No issues." }) })) : (_jsx("ul", { children: sortedIssues.map((issue, i) => (_jsxs("li", { children: [_jsx("span", { className: `jini-status jini-status-${issue.severity === "error" ? "failure" : issue.severity === "warning" ? "unavailable" : "success"}`, children: issue.severity }), " ", _jsx("code", { children: issue.code }), issue.field ? _jsxs("span", { className: "jini-muted-cell", children: [" (", issue.field, ")"] }) : null, " \u2014 ", issue.message] }, `${issue.code}-${i}`))) }))] }));
+    const { sortedIssues, tone } = useAnalyzePanel({ analysis: props.analysis });
+    /* Heading + score pill on one line, issues as a compact list (owner, 2026-10-15: the bare
+       "Score: 100 / No issues." read as unstyled text). The pill reuses the issue pills' status
+       tones, so the score and the issues under it speak one colour language. */
+    return (_jsxs("section", { className: "jini-seo-analyze-panel", "aria-labelledby": "seo-analysis-heading", children: [_jsxs("div", { className: "jini-seo-analyze-head", children: [_jsx("h3", { id: "seo-analysis-heading", children: t({ locale: locale, key: "Analysis" }) }), _jsxs("span", { className: `jini-status jini-status-${tone} jini-seo-score`, children: [t({ locale: locale, key: "Score:" }), " ", _jsx("strong", { children: props.analysis.score })] })] }), sortedIssues.length === 0 ? (_jsx("p", { className: "jini-seo-analyze-empty", children: t({ locale: locale, key: "No issues." }) })) : (_jsx("ul", { className: "jini-seo-issues", children: sortedIssues.map((issue, i) => (_jsxs("li", { className: "jini-seo-issue", children: [_jsx("span", { className: `jini-status jini-status-${issue.severity === "error" ? "failure" : issue.severity === "warning" ? "warning" : "success"}`, children: issue.severity }), _jsxs("span", { className: "jini-seo-issue-text", children: [issue.message, issue.field ? _jsxs("span", { className: "jini-muted-cell", children: [" (", issue.field, ")"] }) : null] })] }, `${issue.code}-${i}`))) }))] }));
 }
 /** Per-entry overrides edit form (REQ-06). Pre-fills from `getSeoEntry`'s resolved meta, but
  * tracks which fields the user actually touched so `putSeoEntry` only ever sends a genuine
@@ -80,14 +80,16 @@ function AnalyzePanel(props) {
 // the ceiling on their own. There is nothing to extract: splitting the eleven fields into their own
 // components would still evaluate the same fallback chains, just spread across more functions, for
 // no complexity benefit and a real loss of "one form, one place to read its fields."
+// 2026-10-15: now 27 — the X fields' placeholders (the live social preview value) add two more
+// flat `??` fallbacks of exactly that kind.
 function SeoEntryPanel({ locale, entryId, useSeoEntryPanelHook = useWiredSeoEntryPanel }) {
     const t = useSeoCopy();
-    const { resolved, analysis, loadError, saving, saveError, notice, fieldValue, setField, save, touched } = useSeoEntryPanelHook({ entryId });
+    const { resolved, analysis, loadError, saving, saveError, notice, fieldValue, setField, save, touched, ogImageInherited = false } = useSeoEntryPanelHook({ entryId });
     if (loadError)
         return _jsx("div", { className: "jini-notice jini-notice-error", children: loadError });
     if (!resolved)
         return _jsx("div", { className: "jini-notice", children: t({ locale: locale, key: "Loading entry SEO…" }) });
-    return (_jsxs("div", { className: "jini-seo-entry-panel", children: [_jsx("h3", { children: t({ locale: locale, key: "Per-entry overrides" }) }), _jsxs("p", { className: "jini-muted-cell", children: [t({ locale: locale, key: "Fields show the currently-effective value (author override, or site default, or derived from the entry). Only fields you change here are saved as overrides." }), " ", t({ locale: locale, key: "Empty a field and save to remove its override — the entry falls back to the site default." })] }), notice ? _jsx("div", { className: "jini-notice", children: notice }) : null, saveError ? (_jsx("div", { className: "jini-notice jini-notice-error", role: "alert", children: saveError })) : null, _jsxs("label", { children: [t({ locale: locale, key: "Title" }), _jsx("input", { className: "jini-input", value: fieldValue("title", resolved.title) ?? "", onChange: (e) => setField("title", e.target.value), ...agentHandle({ handle: "seo-entry-title" }, { role: "field", label: "This entry's SEO title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Description" }), _jsx("textarea", { className: "jini-textarea", value: fieldValue("description", resolved.description ?? "") ?? "", onChange: (e) => setField("description", e.target.value), ...agentHandle({ handle: "seo-entry-description" }, { role: "field", label: "This entry's SEO description override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Canonical URL" }), _jsx("input", { className: "jini-input", value: fieldValue("canonical", resolved.canonical) ?? "", onChange: (e) => setField("canonical", e.target.value), ...agentHandle({ handle: "seo-entry-canonical" }, { role: "field", label: "This entry's canonical URL override" }) })] }), _jsxs("label", { children: [_jsx("input", { className: "jini-input", type: "checkbox", checked: fieldValue("noindex", resolved.robots.noindex) ?? false, onChange: (e) => setField("noindex", e.target.checked), ...agentHandle({ handle: "seo-entry-noindex" }, { role: "checkbox", label: "Override this entry's robots noindex directive" }) }), t({ locale: locale, key: "Noindex" })] }), _jsxs("label", { children: [_jsx("input", { className: "jini-input", type: "checkbox", checked: fieldValue("nofollow", resolved.robots.nofollow) ?? false, onChange: (e) => setField("nofollow", e.target.checked), ...agentHandle({ handle: "seo-entry-nofollow" }, { role: "checkbox", label: "Override this entry's robots nofollow directive" }) }), t({ locale: locale, key: "Nofollow" })] }), _jsxs("label", { children: [t({ locale: locale, key: "OG title" }), _jsx("input", { className: "jini-input", value: fieldValue("ogTitle", resolved.openGraph.title) ?? "", onChange: (e) => setField("ogTitle", e.target.value), ...agentHandle({ handle: "seo-entry-og-title" }, { role: "field", label: "This entry's Open Graph title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "OG description" }), _jsx("input", { className: "jini-input", value: fieldValue("ogDescription", resolved.openGraph.description ?? "") ?? "", onChange: (e) => setField("ogDescription", e.target.value), ...agentHandle({ handle: "seo-entry-og-description" }, { role: "field", label: "This entry's Open Graph description override" }) })] }), _jsx(MediaRefField, { locale: locale, id: "seo-entry-og-image", label: t({ locale: locale, key: "OG image" }), value: fieldValue("ogImage", resolved.openGraph.imageRef ?? resolved.openGraph.image ?? "") ?? "", onChange: (value) => setField("ogImage", value), agentHandle: "seo-entry-og-image" }), _jsxs("label", { children: [t({ locale: locale, key: "Twitter title" }), _jsx("input", { className: "jini-input", value: fieldValue("twitterTitle", resolved.twitter.title) ?? "", onChange: (e) => setField("twitterTitle", e.target.value), ...agentHandle({ handle: "seo-entry-twitter-title" }, { role: "field", label: "This entry's Twitter card title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Twitter description" }), _jsx("input", { className: "jini-input", value: fieldValue("twitterDescription", resolved.twitter.description ?? "") ?? "", onChange: (e) => setField("twitterDescription", e.target.value), ...agentHandle({ handle: "seo-entry-twitter-description" }, { role: "field", label: "This entry's Twitter card description override" }) })] }), _jsx(MediaRefField, { locale: locale, id: "seo-entry-twitter-image", label: t({ locale: locale, key: "Twitter image" }), value: fieldValue("twitterImage", resolved.twitter.imageRef ?? resolved.twitter.image ?? "") ?? "", onChange: (value) => setField("twitterImage", value), agentHandle: "seo-entry-twitter-image" }), _jsx("span", { className: "jini-editor-actions", children: _jsx("button", { type: "button", className: "jini-btn jini-btn-secondary", onClick: save, disabled: saving || Object.keys(touched).length === 0, ...agentHandle({ handle: "seo-entry-save-overrides" }, { role: "button", label: "Save this entry's SEO overrides" }), children: saving ? t({ locale: locale, key: "Saving…" }) : t({ locale: locale, key: "Save overrides" }) }) }), analysis ? _jsx(AnalyzePanel, { locale: locale, analysis: analysis }) : null] }));
+    return (_jsxs("div", { className: "jini-seo-entry-panel", children: [_jsx("div", { className: "jini-seo-entry-head", children: _jsxs("div", { className: "jini-seo-entry-head-bar", children: [_jsx("h3", { children: t({ locale: locale, key: "Per-entry overrides" }) }), _jsx(InfoTip, { label: `${t({ locale: locale, key: "Fields show the currently-effective value (author override, or site default, or derived from the entry). Only fields you change here are saved as overrides." })} ${t({ locale: locale, key: "Empty a field and save to remove its override — the entry falls back to the site default." })}` }), _jsx("span", { className: "jini-seo-entry-head-actions", children: _jsx("button", { type: "button", className: "jini-btn", onClick: save, disabled: saving || Object.keys(touched).length === 0, ...agentHandle({ handle: "seo-entry-save-overrides" }, { role: "button", label: "Save this entry's SEO overrides" }), children: saving ? t({ locale: locale, key: "Saving…" }) : t({ locale: locale, key: "Save overrides" }) }) })] }) }), notice ? _jsx("div", { className: "jini-notice", children: notice }) : null, saveError ? (_jsx("div", { className: "jini-notice jini-notice-error", role: "alert", children: saveError })) : null, _jsxs("fieldset", { className: "jini-seo-entry-group", children: [_jsx("legend", { children: t({ locale: locale, key: "Search appearance" }) }), _jsxs("label", { children: [t({ locale: locale, key: "Title" }), _jsx("input", { className: "jini-input", value: fieldValue("title", resolved.title) ?? "", onChange: (e) => setField("title", e.target.value), ...agentHandle({ handle: "seo-entry-title" }, { role: "field", label: "This entry's SEO title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Description" }), _jsx("textarea", { className: "jini-textarea", value: fieldValue("description", resolved.description ?? "") ?? "", onChange: (e) => setField("description", e.target.value), ...agentHandle({ handle: "seo-entry-description" }, { role: "field", label: "This entry's SEO description override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Canonical URL" }), _jsx("input", { className: "jini-input", value: fieldValue("canonical", resolved.canonical) ?? "", onChange: (e) => setField("canonical", e.target.value), ...agentHandle({ handle: "seo-entry-canonical" }, { role: "field", label: "This entry's canonical URL override" }) })] }), _jsxs("div", { className: "jini-seo-entry-checks", children: [_jsxs("label", { children: [_jsx("input", { className: "jini-input", type: "checkbox", checked: fieldValue("noindex", resolved.robots.noindex) ?? false, onChange: (e) => setField("noindex", e.target.checked), ...agentHandle({ handle: "seo-entry-noindex" }, { role: "checkbox", label: "Override this entry's robots noindex directive" }) }), t({ locale: locale, key: "Noindex" })] }), _jsxs("label", { children: [_jsx("input", { className: "jini-input", type: "checkbox", checked: fieldValue("nofollow", resolved.robots.nofollow) ?? false, onChange: (e) => setField("nofollow", e.target.checked), ...agentHandle({ handle: "seo-entry-nofollow" }, { role: "checkbox", label: "Override this entry's robots nofollow directive" }) }), t({ locale: locale, key: "Nofollow" })] })] })] }), _jsxs("fieldset", { className: "jini-seo-entry-group", children: [_jsxs("legend", { children: [t({ locale: locale, key: "Social preview" }), _jsx(InfoTip, { label: t({ locale: locale, key: "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Preview title" }), _jsx("input", { className: "jini-input", value: fieldValue("ogTitle", resolved.openGraph.title) ?? "", onChange: (e) => setField("ogTitle", e.target.value), ...agentHandle({ handle: "seo-entry-og-title" }, { role: "field", label: "This entry's Open Graph title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "Preview description" }), _jsx("input", { className: "jini-input", value: fieldValue("ogDescription", resolved.openGraph.description ?? "") ?? "", onChange: (e) => setField("ogDescription", e.target.value), ...agentHandle({ handle: "seo-entry-og-description" }, { role: "field", label: "This entry's Open Graph description override" }) })] }), _jsx(MediaRefField, { locale: locale, id: "seo-entry-og-image", label: t({ locale: locale, key: "Preview image" }), value: fieldValue("ogImage", resolved.openGraph.imageRef ?? resolved.openGraph.image ?? "") ?? "", onChange: (value) => setField("ogImage", value), inherited: ogImageInherited, agentHandle: "seo-entry-og-image" }), _jsxs("details", { className: "jini-seo-x-disclosure", open: xIsCustomized({ meta: resolved }), children: [_jsx("summary", { children: t({ locale: locale, key: "Customize for X/Twitter (optional)" }) }), _jsxs("div", { className: "jini-seo-x-fields", children: [_jsxs("label", { children: [t({ locale: locale, key: "X/Twitter title" }), _jsx("input", { className: "jini-input", value: fieldValue("twitterTitle", xResolvedValue({ key: "twitterTitle", meta: resolved })) ?? "", placeholder: fieldValue("ogTitle", resolved.openGraph.title) ?? "", onChange: (e) => setField("twitterTitle", e.target.value), ...agentHandle({ handle: "seo-entry-twitter-title" }, { role: "field", label: "This entry's Twitter card title override" }) })] }), _jsxs("label", { children: [t({ locale: locale, key: "X/Twitter description" }), _jsx("input", { className: "jini-input", value: fieldValue("twitterDescription", xResolvedValue({ key: "twitterDescription", meta: resolved })) ?? "", placeholder: fieldValue("ogDescription", resolved.openGraph.description ?? "") ?? "", onChange: (e) => setField("twitterDescription", e.target.value), ...agentHandle({ handle: "seo-entry-twitter-description" }, { role: "field", label: "This entry's Twitter card description override" }) })] }), _jsx(MediaRefField, { locale: locale, id: "seo-entry-twitter-image", label: t({ locale: locale, key: "X/Twitter image" }), value: fieldValue("twitterImage", xResolvedValue({ key: "twitterImage", meta: resolved })) ?? "", emptyHint: t({ locale: locale, key: "Same as the preview image" }), onChange: (value) => setField("twitterImage", value), agentHandle: "seo-entry-twitter-image" })] })] })] }), analysis ? _jsx(AnalyzePanel, { locale: locale, analysis: analysis }) : null] }));
 }
 /** Section wrapper (REQ-06/07) — entry picker over the per-entry edit + analyze panels. This IS the
  *  "Pages & posts" tab panel; it kept its name and its markup, because nothing about it changed
@@ -139,7 +141,7 @@ export function SeoDefaultsTab({ controller }, _optional = {}) {
                                 }) })] }), _jsxs("div", { className: "jini-field", children: [_jsx("label", { className: "jini-field-label", htmlFor: "seo-default-description", children: t({ locale: locale, key: "Default meta description" }) }), _jsx("textarea", { className: "jini-textarea", id: "seo-default-description", name: "defaultDescription", defaultValue: orEmpty({ value: settings.defaultDescription }), ...agentHandle({ handle: "seo-default-description" }, {
                                     role: "field",
                                     label: "Fallback meta description for pages that set none of their own",
-                                }) })] })] }), _jsxs(SeoSection, { title: t({ locale: locale, key: "Social sharing" }), children: [_jsx(MediaRefField, { locale: locale, id: "seo-default-og-image", name: "defaultOgImage", label: t({ locale: locale, key: "Default Open Graph / Twitter image" }), value: defaultOgImage, onChange: setDefaultOgImage, agentHandle: "seo-default-og-image" }), _jsxs("div", { className: "jini-field", children: [_jsx("label", { className: "jini-field-label", htmlFor: "seo-twitter-site", children: t({ locale: locale, key: "Twitter @site handle" }) }), _jsx("input", { className: "jini-input", id: "seo-twitter-site", name: "twitterSite", defaultValue: orEmpty({ value: settings.twitterSite }), ...agentHandle({ handle: "seo-twitter-site" }, {
+                                }) })] })] }), _jsxs(SeoSection, { title: t({ locale: locale, key: "Social preview" }), tip: t({ locale: locale, key: "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter" }), children: [_jsx(MediaRefField, { locale: locale, id: "seo-default-og-image", name: "defaultOgImage", label: t({ locale: locale, key: "Default preview image" }), value: defaultOgImage, onChange: setDefaultOgImage, agentHandle: "seo-default-og-image" }), _jsxs("div", { className: "jini-field", children: [_jsx("label", { className: "jini-field-label", htmlFor: "seo-twitter-site", children: t({ locale: locale, key: "X/Twitter @handle" }) }), _jsx("input", { className: "jini-input", id: "seo-twitter-site", name: "twitterSite", defaultValue: orEmpty({ value: settings.twitterSite }), ...agentHandle({ handle: "seo-twitter-site" }, {
                                     role: "field",
                                     label: "The site's Twitter @handle, used in Twitter card metadata",
                                 }) })] })] }), _jsxs(SeoSection, { title: t({ locale: locale, key: "Crawling" }), children: [_jsxs("label", { className: "jini-form-checkbox-field", children: [_jsx("input", { className: "jini-input", type: "checkbox", name: "noindex", defaultChecked: settings.defaultRobots.noindex, ...agentHandle({ handle: "seo-default-noindex" }, {
@@ -208,7 +210,7 @@ export function Seo({ tabId, onTabChange, useSeoHook = useWiredSeo } = {}, _opti
         regenerateSitemap,
         openSitemapModal,
     };
-    return (_jsxs("div", { className: "jini-page jini-seo-page", children: [_jsxs("div", { className: "jini-page-header", children: [_jsxs("div", { className: "jini-page-header-text", children: [_jsx("p", { className: "jini-page-kicker", children: t({ locale: locale, key: "Marketing" }) }), _jsx("h1", { className: "jini-page-title", children: "SEO" }), _jsx("p", { className: "jini-page-description", children: t({ locale: locale, key: "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives." }) })] }), _jsx("div", { className: "jini-page-actions", children: headerActions })] }), error ? _jsx("div", { className: "jini-notice jini-notice-error", children: error }) : null, notice ? _jsx("div", { className: "jini-notice", children: notice }) : null, _jsx(TabBar, { ariaLabel: "SEO", tabs: tabs, activeId: activeTabId, onChange: changeTab, containerHandle: "seo-tab-bar" }), seoTabPanel({ activeTabId, controller, components: { SeoDefaultsTab, SeoSitemapTab, SeoEntrySection } }), sitemapModalOpen ? (_jsx(SitemapModal, { locale: locale, sitemapEnabled: settings.sitemapEnabled, regenerating: saving, onRegenerate: regenerateSitemap, onClose: closeSitemapModal })) : null] }));
+    return (_jsxs("div", { className: "jini-page jini-seo-page", children: [_jsxs("div", { className: "jini-page-header", children: [_jsxs("div", { className: "jini-page-header-text", children: [_jsx("p", { className: "jini-page-kicker", children: t({ locale: locale, key: "Marketing" }) }), _jsx("h1", { className: "jini-page-title", children: "SEO" }), _jsx("p", { className: "jini-page-description", children: t({ locale: locale, key: "Site-wide defaults for meta titles, descriptions, social previews, and robots directives." }) })] }), _jsx("div", { className: "jini-page-actions", children: headerActions })] }), error ? _jsx("div", { className: "jini-notice jini-notice-error", children: error }) : null, notice ? _jsx("div", { className: "jini-notice", children: notice }) : null, _jsx(TabBar, { ariaLabel: "SEO", tabs: tabs, activeId: activeTabId, onChange: changeTab, containerHandle: "seo-tab-bar" }), seoTabPanel({ activeTabId, controller, components: { SeoDefaultsTab, SeoSitemapTab, SeoEntrySection } }), sitemapModalOpen ? (_jsx(SitemapModal, { locale: locale, sitemapEnabled: settings.sitemapEnabled, regenerating: saving, onRegenerate: regenerateSitemap, onClose: closeSitemapModal })) : null] }));
 }
 export { Seo as SeoPage };
 export default Seo;

package/dist/seo/rules.d.ts

@@ -1,5 +1,6 @@
 import type { AdminSeoIssue as SeoIssue, AdminSeoSettingsPatch as SeoSettingsPatch } from "../core/ports/seo.js";
 import type { SeoTranslator } from './models.js';
+import type { AdminSeoEntryChoice, AdminSeoMediaSummary, AdminSeoMeta } from '../core/ports/seo.js';
 /**
  * Orders issues error-first, then warning, then info, matching the severities' natural urgency.
  * An unrecognized severity sorts last (falls back to `9`) rather than throwing, since this reads
@@ -14,7 +15,7 @@ export declare function sortIssuesBySeverity({ issues }: {
 /**
  * One edited per-entry override field's outgoing value. An emptied text/URL box means "remove this
  * override so the entry falls back to the site default", which on the wire is `null` — the clear
- * sentinel `SeoExtFieldsPatch` documents (`apps/website/src/features/seo/types.ts`) and
+ * sentinel `SeoExtFieldsPatch` documents (`features/seo/types.ts`) and
  * `setEntrySeoOverrides` implements by `delete`-ing the key.
  *
  * It is NOT `""`. `write-service.ts` stores `""` as a genuine override and `seo.ts` resolves
@@ -37,6 +38,36 @@ export declare function overrideOrClear<V>({ value }: {
 export declare function orEmpty({ value }: {
     value: string | undefined;
 }, _optional?: Record<string, never>): string;
+/** The X (twitter) fields the "Customize for X/Twitter" disclosure holds, each paired with the social
+ *  preview (Open Graph) value it falls back to. */
+export type SeoXFieldKey = 'twitterTitle' | 'twitterDescription' | 'twitterImage';
+/** Whether this entry's X card differs from its social preview in any field — i.e. an X override
+ *  is in effect, so the "Customize for X/Twitter" disclosure opens on load. (2026-10-15, owner: one
+ *  generic social preview, X only as an optional customization.)
+ *  @complexity O(1). */
+export declare function xIsCustomized({ meta }: {
+    meta: AdminSeoMeta;
+}, _optional?: Record<string, never>): boolean;
+/** An X field's untouched box value, handed to `fieldValue` as its resolved value (so a pending
+ *  edit or clear still wins there). An X value equal to the social preview's is inherited, so the
+ *  box stays empty and its placeholder shows the live social value — typing there is what creates
+ *  an X override.
+ *  @complexity O(1). */
+export declare function xResolvedValue({ key, meta }: {
+    key: SeoXFieldKey;
+    meta: AdminSeoMeta;
+}, _optional?: Record<string, never>): string;
+/** The X field an edit to a social preview field should carry along: when X still shows the
+ *  preview's value and has no pending edit of its own, the edit also clears X's stored override so
+ *  X keeps following the preview after save. Without it, an X override saved equal to the preview
+ *  (indistinguishable here, the screen sees only effective values) would silently pin X to the old
+ *  text. Clearing an override that does not exist is a no-op on the server.
+ *  @complexity O(1). */
+export declare function inheritedXFor({ key, meta, touched }: {
+    key: string;
+    meta: AdminSeoMeta;
+    touched: Readonly<Record<string, unknown>>;
+}, _optional?: Record<string, never>): SeoXFieldKey | null;
 /** A pending-action button's label — `react/pages/SeoPage.tsx` uses this for both the save-settings button
  *  ("Saving…"/"Save settings") and the regenerate-sitemap button ("Working…"/"Regenerate
  *  sitemap"), same `pending ? … : …` shape, different copy. Also reused by `SitemapModal.tsx`'s
@@ -47,7 +78,7 @@ export declare function actionLabel({ pending, pendingLabel, idleLabel }: {
     idleLabel: string;
 }, _optional?: Record<string, never>): string;
 /**
- * One `<url>` entry from a parsed sitemap. Only the fields `apps/website`'s
+ * One `<url>` entry from a parsed sitemap. Only the fields the host's
  * `registerSeoSitemapRoute` (`server/inbound/public-http/routes/site/sitemap.ts`) actually emits —
  * `<loc>` always, `<lastmod>` when the entry has one — verified by reading that route rather than
  * guessed: it never writes `changefreq`/`priority`, so `SitemapModal.tsx`'s table has no columns
@@ -85,10 +116,43 @@ export declare function filterSitemapEntries({ entries, query }: {
 export declare function isStoredMediaRef({ value }: {
     value: string;
 }, _optional?: Record<string, never>): boolean;
+/** What an image field shows for its value — the file's name and pixel size — in place of the raw
+ * `{slug}:public` reference or URL (owner, 2026-10-15: a read-only "Selected image" box "looks
+ * useless"). The library row wins when the host can list media; otherwise a readable slug or the
+ * URL's file name stands in, and an opaque id falls back to the translated "Image".
+ * Size prefers the stored dimensions, then the decoded preview's natural size.
+ * @example describeMediaRef({ value: 'sunset:public', media: [{ id: 'a1', slug: 'sunset', title: 'Sunset', width: 1200, height: 630 }] }) // { name: 'Sunset', size: '1200 × 630' }
+ * @complexity O(m) over the media rows; no I/O.
+ */
+export declare function describeMediaRef({ value, media }: {
+    value: string;
+    media?: readonly AdminSeoMediaSummary[] | null | undefined;
+}, { width, height, t, extensionFor }?: {
+    width?: number | undefined;
+    height?: number | undefined;
+    t?: SeoTranslator | undefined;
+    /** `image/png` → `.png`; injected (the host UI kit owns the table) so this file stays pure. */
+    extensionFor?: ((contentType: string) => string) | undefined;
+}): {
+    name: string;
+    size: string | null;
+} | null;
+/** Whether an entry's social preview image comes from content or the site default, with no override
+ * of its own, so the field shows its source muted. "Using site default" is the original copy (owner,
+ * 2026-10-15). A pending edit is the entry's own, and so is a stored override the host flags
+ * (`imageOverridden`) even when it equals the default. A host without that flag can't tell such an
+ * override apart, so it reads as inherited (same image either way). Returns 'content' for an image
+ * the host identifies as content, 'default' for the site default, and false for an own/absent image.
+ * @complexity O(1). */
+export declare function ogImageInherited({ meta, defaultOgImage, touched }: {
+    meta: AdminSeoMeta;
+    defaultOgImage: string | undefined;
+    touched: Readonly<Record<string, unknown>>;
+}, _optional?: Record<string, never>): false | 'default' | 'content';
 /** Builds the `{slug}:public` reference `MediaRefField` writes into the field on selection —
  *  prefers the asset's readable slug over its id (readable-slugs S5b, 2026-09-23), matching
  *  `resolveSeoImageRef`'s own id-or-slug lookup server-side (`findMediaByIdOrSlug`,
- *  `apps/website/src/features/seo/media.ts`, S4) so a saved override reads as a slug, not an opaque
+ *  `features/seo/media.ts`, S4) so a saved override reads as a slug, not an opaque
  *  uuid. Falls back to `id` when `slug` is empty — defensive only; a real upload always derives one
  *  (`deriveUniqueMediaSlug`). Same `transformName: "public"` `EmbedInsertControl.tsx` already writes
  *  for an inserted image node. An old stored `{assetId}:public` value keeps resolving regardless
@@ -110,7 +174,7 @@ export declare function buildMediaRef({ item }: {
  *  "string"` also resolves to `null` rather than throwing — `MediaRefField`'s `value` prop is a
  *  `fieldValue(key, resolved) ?? ""` fallback chain (`react/pages/SeoPage.tsx`), where `??` does not replace a
  *  non-nullish-but-wrong-typed result from a misbehaving caller; matches `resolveSeoImageRef`'s own
- *  "never throws over one bad reference" contract (`apps/website/src/features/seo/media.ts`).
+ *  "never throws over one bad reference" contract (`features/seo/media.ts`).
  *
  * @complexity O(1) — string parsing only, no I/O (the returned URL is a template; the browser
  * performs the actual fetch only once it is used as an `<img src>`). */
@@ -159,4 +223,31 @@ export type SeoTabId = (typeof SEO_TAB_IDS)[number];
 export declare function resolveSeoTabId({ tabId }: {
     tabId?: string | null | undefined;
 }, _optional?: Record<string, never>): SeoTabId;
+/** Colour band for the analysis score pill: the same success/warning/failure tones the issue pills
+ * use, so a 100 reads green and a failing page reads red at a glance.
+ * @example scoreTone({ score: 100 }) // 'success'
+ */
+export declare function scoreTone({ score }: {
+    score: number;
+}, _optional?: Record<string, never>): 'success' | 'warning' | 'failure';
+/** One row of the searchable entry picker: grouped Pages then Posts, status only when not live. */
+export interface SeoEntryPickerOption {
+    value: string;
+    label: string;
+    group: string;
+    badge?: string;
+    detail?: string;
+}
+/**
+ * Picker rows for the Pages & posts tab. Pages lead because they are fewer and are the usual SEO
+ * targets (home, about, pricing); a published entry carries no pill, so only the exceptions
+ * (draft, scheduled, …) draw the eye. An untitled entry stays pickable by its id.
+ * @example entryPickerOptions({ posts, pages }, { t }) // [{ value: 'p1', label: 'About', group: 'Pages' }, …]
+ */
+export declare function entryPickerOptions({ posts, pages }: {
+    posts: readonly AdminSeoEntryChoice[];
+    pages: readonly AdminSeoEntryChoice[];
+}, { t }?: {
+    t?: SeoTranslator | undefined;
+}): SeoEntryPickerOption[];
 //# sourceMappingURL=rules.d.ts.map