@jini-ai/admin 0.4.2 → 0.4.4

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

@@ -0,0 +1,369 @@
+import { type ReactNode } from 'react';
+import type { AdminInstance } from '../../core/module/types.js';
+import type { SeoReactOptions } from './options.js';
+export type { SeoReactOptions, SeoMediaPickerSlotProps } from './options.js';
+export { useSeoPorts } from './hooks/SeoPorts.hooks.js';
+export { resolveSeoTabs, sitemapStateLabel } from './hooks/SeoPage.hooks.js';
+export type { SeoProps } from './pages/SeoPage.js';
+/** One binding per admin scope. Site origin is host-owned; all views are loaded on demand. */
+export declare function seo({ siteUrl }: Pick<SeoReactOptions, 'siteUrl'>, optional?: Omit<SeoReactOptions, 'siteUrl'>): {
+    id: "seo";
+    requires: {
+        readonly seoApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminSeoPort, "admin.seo.api">;
+    };
+    optional: {
+        readonly seoEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").SeoEventsPort, "admin.seo.events">;
+        readonly mediaPicker: import("../../core/module/token.js").AdminPortToken<import("../../contracts/media-picker.js").MediaPickerPort, "admin.media.picker">;
+    };
+    messages: {
+        readonly "Site defaults": "Site defaults";
+        readonly Sitemap: "Sitemap";
+        readonly "Pages & posts": "Pages & posts";
+        readonly "This site publishes a sitemap.": "This site publishes a sitemap.";
+        readonly "This site does not publish a sitemap. Turn it on under Site defaults.": "This site does not publish a sitemap. Turn it on under Site defaults.";
+        readonly "Loading entries\u2026": "Loading entries…";
+        readonly Entry: "Entry";
+        readonly "Choose an entry\u2026": "Choose an entry…";
+        readonly Analysis: "Analysis";
+        readonly "Score:": "Score:";
+        readonly "No issues.": "No issues.";
+        readonly "Loading entry SEO\u2026": "Loading entry SEO…";
+        readonly "Per-entry overrides": "Per-entry overrides";
+        readonly "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.": "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.";
+        readonly "Empty a field and save to remove its override \u2014 the entry falls back to the site default.": "Empty a field and save to remove its override — the entry falls back to the site default.";
+        readonly Title: "Title";
+        readonly Description: "Description";
+        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 "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 Crawling: "Crawling";
+        readonly "Default noindex": "Default noindex";
+        readonly "Default nofollow": "Default nofollow";
+        readonly "Sitemap enabled": "Sitemap enabled";
+        readonly "Save settings": "Save settings";
+        readonly "Cached sitemap": "Cached sitemap";
+        readonly "Rebuild the sitemap now to include the latest published content.": "Rebuild the sitemap now to include the latest published content.";
+        readonly "Working\u2026": "Working…";
+        readonly "Regenerate sitemap": "Regenerate sitemap";
+        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 "Choose image": "Choose image";
+        readonly Remove: "Remove";
+        readonly "Sitemap \u00B7 {count} URLs": "Sitemap · {count} URLs";
+        readonly "sitemap.xml \u2197": "sitemap.xml ↗";
+        readonly Table: "Table";
+        readonly "Raw XML": "Raw XML";
+        readonly "The sitemap has no URLs yet.": "The sitemap has no URLs yet.";
+        readonly "Filter sitemap URLs": "Filter sitemap URLs";
+        readonly "Filter by URL\u2026": "Filter by URL…";
+        readonly "No URLs match this filter.": "No URLs match this filter.";
+        readonly URL: "URL";
+        readonly "Last modified": "Last modified";
+        readonly "\u2014": "—";
+        readonly "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.": "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.";
+        readonly "Loading sitemap\u2026": "Loading sitemap…";
+        readonly Close: "Close";
+        readonly "failed to load entries": "failed to load entries";
+        readonly "failed to load entry SEO data": "failed to load entry SEO data";
+        readonly "Saved.": "Saved.";
+        readonly "failed to save SEO overrides": "failed to save SEO overrides";
+        readonly "failed to load SEO settings": "failed to load SEO settings";
+        readonly "failed to save SEO settings": "failed to save SEO settings";
+        readonly "Sitemap regeneration accepted.": "Sitemap regeneration accepted.";
+        readonly "failed to regenerate sitemap": "failed to regenerate sitemap";
+        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";
+    };
+    pages: {
+        readonly settings: {
+            readonly path: "/seo";
+            readonly label: "SEO";
+            readonly permissions: readonly ["admin.seo.manage"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "content";
+                readonly icon: "search";
+            };
+            readonly tabs: {
+                readonly defaults: {
+                    readonly label: "Site defaults";
+                    readonly agentReachable: true;
+                };
+                readonly sitemap: {
+                    readonly label: "Sitemap";
+                    readonly agentReachable: true;
+                };
+                readonly entries: {
+                    readonly label: "Pages & posts";
+                    readonly agentReachable: true;
+                };
+            };
+        };
+    };
+} & {
+    react: {
+        Provider: ({ admin, children, options }: {
+            admin: AdminInstance;
+            children: ReactNode;
+            options?: SeoReactOptions;
+        }, _optional?: Record<string, never>) => import("react").FunctionComponentElement<{
+            admin: AdminInstance;
+            children: ReactNode;
+        }>;
+        module: {
+            readonly id: "seo";
+            readonly requires: {
+                readonly seoApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminSeoPort, "admin.seo.api">;
+            };
+            readonly optional: {
+                readonly seoEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").SeoEventsPort, "admin.seo.events">;
+                readonly mediaPicker: import("../../core/module/token.js").AdminPortToken<import("../../contracts/media-picker.js").MediaPickerPort, "admin.media.picker">;
+            };
+            readonly messages: {
+                readonly "Site defaults": "Site defaults";
+                readonly Sitemap: "Sitemap";
+                readonly "Pages & posts": "Pages & posts";
+                readonly "This site publishes a sitemap.": "This site publishes a sitemap.";
+                readonly "This site does not publish a sitemap. Turn it on under Site defaults.": "This site does not publish a sitemap. Turn it on under Site defaults.";
+                readonly "Loading entries\u2026": "Loading entries…";
+                readonly Entry: "Entry";
+                readonly "Choose an entry\u2026": "Choose an entry…";
+                readonly Analysis: "Analysis";
+                readonly "Score:": "Score:";
+                readonly "No issues.": "No issues.";
+                readonly "Loading entry SEO\u2026": "Loading entry SEO…";
+                readonly "Per-entry overrides": "Per-entry overrides";
+                readonly "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.": "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.";
+                readonly "Empty a field and save to remove its override \u2014 the entry falls back to the site default.": "Empty a field and save to remove its override — the entry falls back to the site default.";
+                readonly Title: "Title";
+                readonly Description: "Description";
+                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 "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 Crawling: "Crawling";
+                readonly "Default noindex": "Default noindex";
+                readonly "Default nofollow": "Default nofollow";
+                readonly "Sitemap enabled": "Sitemap enabled";
+                readonly "Save settings": "Save settings";
+                readonly "Cached sitemap": "Cached sitemap";
+                readonly "Rebuild the sitemap now to include the latest published content.": "Rebuild the sitemap now to include the latest published content.";
+                readonly "Working\u2026": "Working…";
+                readonly "Regenerate sitemap": "Regenerate sitemap";
+                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 "Choose image": "Choose image";
+                readonly Remove: "Remove";
+                readonly "Sitemap \u00B7 {count} URLs": "Sitemap · {count} URLs";
+                readonly "sitemap.xml \u2197": "sitemap.xml ↗";
+                readonly Table: "Table";
+                readonly "Raw XML": "Raw XML";
+                readonly "The sitemap has no URLs yet.": "The sitemap has no URLs yet.";
+                readonly "Filter sitemap URLs": "Filter sitemap URLs";
+                readonly "Filter by URL\u2026": "Filter by URL…";
+                readonly "No URLs match this filter.": "No URLs match this filter.";
+                readonly URL: "URL";
+                readonly "Last modified": "Last modified";
+                readonly "\u2014": "—";
+                readonly "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.": "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.";
+                readonly "Loading sitemap\u2026": "Loading sitemap…";
+                readonly Close: "Close";
+                readonly "failed to load entries": "failed to load entries";
+                readonly "failed to load entry SEO data": "failed to load entry SEO data";
+                readonly "Saved.": "Saved.";
+                readonly "failed to save SEO overrides": "failed to save SEO overrides";
+                readonly "failed to load SEO settings": "failed to load SEO settings";
+                readonly "failed to save SEO settings": "failed to save SEO settings";
+                readonly "Sitemap regeneration accepted.": "Sitemap regeneration accepted.";
+                readonly "failed to regenerate sitemap": "failed to regenerate sitemap";
+                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 pages: {
+                readonly settings: {
+                    readonly path: "/seo";
+                    readonly label: "SEO";
+                    readonly permissions: readonly ["admin.seo.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "content";
+                        readonly icon: "search";
+                    };
+                    readonly tabs: {
+                        readonly defaults: {
+                            readonly label: "Site defaults";
+                            readonly agentReachable: true;
+                        };
+                        readonly sitemap: {
+                            readonly label: "Sitemap";
+                            readonly agentReachable: true;
+                        };
+                        readonly entries: {
+                            readonly label: "Pages & posts";
+                            readonly agentReachable: true;
+                        };
+                    };
+                };
+            };
+        };
+        pages: {
+            readonly settings: {
+                Page: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").ModulePageProps>>;
+                tabs: {
+                    readonly defaults: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").TabViewProps>>;
+                    readonly sitemap: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").TabViewProps>>;
+                    readonly entries: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").TabViewProps>>;
+                };
+            };
+        };
+        usePorts: (_required?: Record<string, never>, _optional?: Record<string, never>) => import("../../core/module/types.js").ScopedPorts<{
+            readonly id: "seo";
+            readonly requires: {
+                readonly seoApi: import("../../core/module/token.js").AdminPortToken<import("../ports.js").AdminSeoPort, "admin.seo.api">;
+            };
+            readonly optional: {
+                readonly seoEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").SeoEventsPort, "admin.seo.events">;
+                readonly mediaPicker: import("../../core/module/token.js").AdminPortToken<import("../../contracts/media-picker.js").MediaPickerPort, "admin.media.picker">;
+            };
+            readonly messages: {
+                readonly "Site defaults": "Site defaults";
+                readonly Sitemap: "Sitemap";
+                readonly "Pages & posts": "Pages & posts";
+                readonly "This site publishes a sitemap.": "This site publishes a sitemap.";
+                readonly "This site does not publish a sitemap. Turn it on under Site defaults.": "This site does not publish a sitemap. Turn it on under Site defaults.";
+                readonly "Loading entries\u2026": "Loading entries…";
+                readonly Entry: "Entry";
+                readonly "Choose an entry\u2026": "Choose an entry…";
+                readonly Analysis: "Analysis";
+                readonly "Score:": "Score:";
+                readonly "No issues.": "No issues.";
+                readonly "Loading entry SEO\u2026": "Loading entry SEO…";
+                readonly "Per-entry overrides": "Per-entry overrides";
+                readonly "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.": "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.";
+                readonly "Empty a field and save to remove its override \u2014 the entry falls back to the site default.": "Empty a field and save to remove its override — the entry falls back to the site default.";
+                readonly Title: "Title";
+                readonly Description: "Description";
+                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 "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 Crawling: "Crawling";
+                readonly "Default noindex": "Default noindex";
+                readonly "Default nofollow": "Default nofollow";
+                readonly "Sitemap enabled": "Sitemap enabled";
+                readonly "Save settings": "Save settings";
+                readonly "Cached sitemap": "Cached sitemap";
+                readonly "Rebuild the sitemap now to include the latest published content.": "Rebuild the sitemap now to include the latest published content.";
+                readonly "Working\u2026": "Working…";
+                readonly "Regenerate sitemap": "Regenerate sitemap";
+                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 "Choose image": "Choose image";
+                readonly Remove: "Remove";
+                readonly "Sitemap \u00B7 {count} URLs": "Sitemap · {count} URLs";
+                readonly "sitemap.xml \u2197": "sitemap.xml ↗";
+                readonly Table: "Table";
+                readonly "Raw XML": "Raw XML";
+                readonly "The sitemap has no URLs yet.": "The sitemap has no URLs yet.";
+                readonly "Filter sitemap URLs": "Filter sitemap URLs";
+                readonly "Filter by URL\u2026": "Filter by URL…";
+                readonly "No URLs match this filter.": "No URLs match this filter.";
+                readonly URL: "URL";
+                readonly "Last modified": "Last modified";
+                readonly "\u2014": "—";
+                readonly "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.": "Sitemap is off. Turn on \"Sitemap enabled\" above to publish one.";
+                readonly "Loading sitemap\u2026": "Loading sitemap…";
+                readonly Close: "Close";
+                readonly "failed to load entries": "failed to load entries";
+                readonly "failed to load entry SEO data": "failed to load entry SEO data";
+                readonly "Saved.": "Saved.";
+                readonly "failed to save SEO overrides": "failed to save SEO overrides";
+                readonly "failed to load SEO settings": "failed to load SEO settings";
+                readonly "failed to save SEO settings": "failed to save SEO settings";
+                readonly "Sitemap regeneration accepted.": "Sitemap regeneration accepted.";
+                readonly "failed to regenerate sitemap": "failed to regenerate sitemap";
+                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 pages: {
+                readonly settings: {
+                    readonly path: "/seo";
+                    readonly label: "SEO";
+                    readonly permissions: readonly ["admin.seo.manage"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "content";
+                        readonly icon: "search";
+                    };
+                    readonly tabs: {
+                        readonly defaults: {
+                            readonly label: "Site defaults";
+                            readonly agentReachable: true;
+                        };
+                        readonly sitemap: {
+                            readonly label: "Sitemap";
+                            readonly agentReachable: true;
+                        };
+                        readonly entries: {
+                            readonly label: "Pages & posts";
+                            readonly agentReachable: true;
+                        };
+                    };
+                };
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/seo/react/index.js

@@ -0,0 +1,30 @@
+import { createElement } from 'react';
+import { bindReact } from '../../core/react/bind-react.js';
+import { seoModule } from '../seo.module.js';
+import { SeoPortsContext, SeoOptionsContext } from './hooks/SeoPorts.hooks.js';
+export { useSeoPorts } from './hooks/SeoPorts.hooks.js';
+export { resolveSeoTabs, sitemapStateLabel } from './hooks/SeoPage.hooks.js';
+/** One binding per admin scope. Site origin is host-owned; all views are loaded on demand. */
+export function seo({ siteUrl }, optional = {}) {
+    const defaults = { siteUrl, ...optional };
+    const page = async () => {
+        const { SeoPage } = await import('./pages/SeoPage.js');
+        return { default: (props) => createElement(SeoPage, { tabId: props.requestedTab, onTabChange: props.onTabChange }) };
+    };
+    const tab = (id) => async () => {
+        const views = await import('./hooks/SeoModuleTabs.js');
+        return { default: (props) => createElement(views[id], props) };
+    };
+    // The unchanged shell owns its active panel and banners. Standalone lazy tab mounts reuse those
+    // same panel functions rather than introducing a second markup owner.
+    const react = bindReact({ module: seoModule, views: { settings: { page, tabs: { defaults: tab('SeoDefaultsModuleTab'), sitemap: tab('SeoSitemapModuleTab'), entries: tab('SeoEntriesModuleTab') } } } }, { context: SeoPortsContext });
+    /** Host options may refresh without replacing lazy views or controller state.
+     * @returns The existing port scope plus the current options; factory defaults remain supported.
+     * @example <Provider admin={admin} options={localizedOptions}>{children}</Provider>
+     */
+    function Provider({ admin, children, options = defaults }, _optional = {}) {
+        return createElement(react.Provider, { admin, children: createElement(SeoOptionsContext.Provider, { value: options }, children) });
+    }
+    return Object.assign({ ...seoModule }, { react: { ...react, Provider } });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,26 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { SeoMediaSelection, SeoTranslator, SeoErrorFormatter } from '../models.js';
+/** Host dialog wrapper keeps its existing media service, DOM and caller-specific handle ids. */
+export interface SeoMediaPickerSlotProps {
+    onSelect: (item: SeoMediaSelection) => void;
+    onCancel: () => void;
+    accept?: readonly string[];
+    agentHandle?: string | undefined;
+}
+export interface SeoReactOptions {
+    siteUrl: () => string;
+    t?: SeoTranslator | undefined;
+    describeError?: SeoErrorFormatter | undefined;
+    /** Format parsed lastmod values in the host's live locale/timezone; raw XML remains untouched.
+     * Omit to use the shared compact ISO timestamp display.
+     * @example ({ iso }) => formDateDisplay({ iso, locale }).text
+     */
+    formatDate?: ((required: {
+        iso: string;
+    }, optional?: Record<string, never>) => string) | undefined;
+    headerActions?: ReactNode;
+    slots?: {
+        MediaPickerDialog?: ComponentType<SeoMediaPickerSlotProps>;
+    };
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/seo/react/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1,161 @@
+import type { ReactNode } from "react";
+import type { SeoTabController } from "../hooks/SeoPage.hooks.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";
+import { useWiredSeo } from "../hooks/use-seo.hooks.js";
+/**
+ * `SeoSettingsScreen` (SPEC-008 ui.spec.md §2.4) — the site-wide `seo.*` settings form +
+ * `SitemapRegenerateButton` (§2.6). Coordinator-authored 2026-07-13, post-session-limit resume.
+ * Markup only.
+ *
+ * State and API calls live in one hook per component: `hooks/use-seo.hooks.ts` (top-level
+ * defaults form + sitemap button), `hooks/use-entry-picker.hooks.ts`, `hooks/use-seo-entry-panel
+ * .hooks.ts`, `hooks/use-seo-entry-section.hooks.ts`. The issue-severity sort lives in `rules.ts`.
+ *
+ * SPEC-037 REQ-06/07/08: `SeoEntryPanel` closes the deferred per-entry gap this file's own header
+ * used to disclose — a standalone entry picker (dropdown over `listPosts`/`listPages`, cheaper
+ * than threading a new panel through `PostEditor.tsx`, per REQ-06's own "implementer's choice")
+ * plus a partial-override edit form and a read-only analyze view. `RobotsRuleEditor` (§2.5) is
+ * 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.
+ * 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.
+ *
+ * ## Tabs (2026-09-06)
+ *
+ * The three sections above are now three `?tab=` tabs — Site defaults, Sitemap, Pages & posts —
+ * built on the shared `@jini-ai/ui/tab-strip` that `Deployment.tsx`, `Sites.tsx`, `Themes.tsx`,
+ * `Security.tsx`, `SourceControl.tsx` and `Database.tsx` already use. Nothing new was written for
+ * the tab mechanism: the shell was ALREADY extracted (`@jini-ai/ui/tab-strip` for the strip,
+ * `lib/resolve-active-tab-id.ts` for the `?tab=` guard), so this screen reuses it rather than
+ * becoming a third implementation. The reasoning for the grouping, the tab NAMES, and the one
+ * cut that was considered and rejected all live in `react/hooks/SeoPage.hooks.ts`'s header.
+ *
+ * Everything below the shell is unchanged markup, only relocated: `SeoDefaultsTab` holds the form
+ * verbatim (with two field-group headings added, which it never had), `SeoSitemapTab` holds the
+ * sitemap actions plus a new state line, and the Pages & posts panel IS the existing
+ * `SeoEntrySection`, rendered directly rather than wrapped in a new component that would add
+ * nothing.
+ * No component was split or merged, so `SeoEntryPanel` — the one function in this file carrying a
+ * recorded complexity exemption (`development/scripts/admin-complexity-debt.json`, keyed by
+ * `{rule, file, reason}`) — stays in THIS file at its recorded measurement. Moving it to a tab
+ * file of its own, the way `Deployment.tsx` gives each tab a file, would have made its debt entry
+ * name a path that no longer exists and required adding a NEW entry for the new file, growing a
+ * baseline that JSON's own instructions say must only shrink. One file, top-level components: the
+ * ESLint gate scores functions independently of which file they sit in, so the ceiling is
+ * satisfied either way — only the organizational preference differs, and the debt key decides it.
+ *
+ * ## Out of the cards (2026-09-06, same day)
+ *
+ * Owner, on the screen the section above describes: "for seo can you take the stuff out of the
+ * cards?" Every panel here was a `.card` (Site defaults, Sitemap) or a `.notice` (the two
+ * per-entry panels) and is now content laid directly on the page, held together by `SeoSection`'s
+ * heading rail and one hairline per seam. `styles/seo.css`'s header carries the measurements and
+ * the full reasoning, including why the card was never what grouped the three field groups.
+ *
+ * Two claims in the paragraph above are now stale and are corrected here rather than rewritten in
+ * place, since the tab conversion's own reasoning is still the reason the tabs exist: the defaults
+ * form has THREE field-group headings, not two ("Social sharing" was split out in the same
+ * commit), and those groups are `SeoSection`s rather than `.field-group` divs. What has NOT
+ * changed is the constraint that matters — all seven fields still live in one `<form>`, submitted
+ * as one `FormData`, with nothing about them conditional.
+ */
+export interface SeoSectionProps {
+    title: string;
+    children: ReactNode;
+}
+export interface EntryPickerProps {
+    locale: string;
+    entryId: string;
+    onChange: (entryId: string) => void;
+    /** Dependency injection seam for tests — the same convention `@jini-ai/ui`'s `CustomSelect` uses
+     *  for `useCustomSelect`. */
+    useEntryPickerHook?: typeof useWiredEntryPicker;
+}
+export interface SeoEntryPanelProps {
+    locale: string;
+    entryId: string;
+    useSeoEntryPanelHook?: typeof useWiredSeoEntryPanel;
+}
+export interface SeoEntrySectionProps {
+    locale: string;
+    useSeoEntrySectionHook?: typeof useSeoEntrySection;
+}
+/** 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
+ *  except that a tab now selects it.
+ *
+ *  The `<h2>` stays, and deliberately so — dropping it as "redundant with the tab label" was tried
+ *  and reverted. A tab label is not a heading: `TabBar` emits `role="tab"` buttons, which do not
+ *  appear in a screen reader's heading list at all, so removing this left the whole panel with `H1`
+ *  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;
+/** 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
+ *  panel a controller instead of assembling one out of parts. */
+/**
+ * The "Site defaults" tab — the site-wide `seo.*` settings form, moved here verbatim from `Seo`'s
+ * own body.
+ *
+ * ONE addition beyond relocation: the two `.field-group`s now carry headings ("Search appearance",
+ * "Crawling"). They are the grouping an operator already thinks in — every SEO tool they have used
+ * separates what search/social show from whether to be indexed at all — and the form had no
+ * internal hierarchy whatsoever before, just seven controls in a row. Expressing it as headings
+ * INSIDE one tab rather than as more tabs is deliberate and load-bearing: see `react/hooks/SeoPage.hooks.ts`'s
+ * header for why splitting this form across panels would silently blank fields on save.
+ *
+ * The submit handler is now one call to `buildSeoSettingsPatch` (`react/hooks/SeoPage.hooks.ts`) rather than seven
+ * inline `??`/`||` field reads — same fields, same fallbacks, same payload, just not written in the
+ * `.tsx`.
+ */
+export declare function SeoDefaultsTab({ controller }: {
+    controller: SeoTabController;
+}, _optional?: Record<string, never>): 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.
+ *
+ * That line is the reason this is a tab rather than a footnote on Site defaults. The switch
+ * ("Sitemap enabled") cannot move here — it belongs to the defaults form's `FormData` submit, see
+ * `react/hooks/SeoPage.hooks.ts`'s header — so without a state read, an operator who had sitemaps switched off
+ * would find a Regenerate button that appears live and reports success while publishing nothing.
+ * Reporting the state instead of duplicating the control keeps exactly one switch on the screen.
+ *
+ * Wrapped in a `.card` like the defaults form beside it, rather than left as loose text on the
+ * page — rendered side by side the uncontained version read as an unfinished panel next to a
+ * carded one. The heading is "Cached sitemap", not "Sitemap": it names what the card acts on
+ * without restating the tab label, the same way `deployment/OverviewTab.tsx`'s cards are titled.
+ * It also has to exist at all — a `role="tab"` button is not in a screen reader's heading list, so
+ * a panel with no `<h2>` leaves that reader nothing but the page `H1`.
+ */
+export declare function SeoSitemapTab({ controller }: {
+    controller: SeoTabController;
+}, _optional?: Record<string, never>): 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`
+ *  make for the identical gate.
+ *  @complexity O(1) — three mutually exclusive branches, no iteration. */
+export interface SeoProps {
+    /** The `?tab=` query value from `panels.tsx`'s `seo` route (`URLSearchParams.get` returns `null`
+     *  when the param is absent). Guarded by `resolveSeoTabId`, so a stale link or a typo opens Site
+     *  defaults rather than a blank panel. */
+    tabId?: string | null | undefined;
+    /** Dependency injection seam for tests — the same convention `@jini-ai/ui`'s `CustomSelect` uses
+     *  for `useCustomSelect`. Defaulted to the real hook, so production callers (`panels.tsx`) pass
+     *  nothing and behave exactly as before. */
+    useSeoHook?: typeof useWiredSeo;
+    onTabChange?: ((required: {
+        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 { Seo as SeoPage };
+export default Seo;
+//# sourceMappingURL=SeoPage.d.ts.map