@actuate-media/cms-admin 0.32.0 → 0.33.0

package/dist/views/settings/useSeoSettings.js

@@ -0,0 +1,278 @@
+'use client';
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { cmsApi } from '../../lib/api.js';
+const EMPTY_FORM = {
+    titleTemplate: '',
+    defaultMetaDescription: '',
+    defaultOgImage: '',
+    defaultSocialImageAssetId: '',
+    googleVerification: '',
+    bingVerification: '',
+    yandexVerification: '',
+    pinterestVerification: '',
+    facebookDomainVerification: '',
+    autoGenerateSitemap: true,
+    pingOnPublish: true,
+};
+/** Recommended max length for the default meta description (SERP truncation). */
+export const META_DESCRIPTION_MAX = 160;
+/** Below this, the description is likely too thin to be useful. */
+export const META_DESCRIPTION_MIN = 70;
+// Mirror of cms-core's `SITE_TITLE_TOKENS` (kept tiny + stable so the client can
+// validate without importing the full cms-core module graph). The server
+// re-validates on save via `validateTitleTemplate`, so this is a UX aid only.
+const SITE_TITLE_TOKENS = ['page', 'site', 'type', 'separator', 'author', 'date', 'category', 'tag'];
+const TOKEN_RE = /%(\w+)%/g;
+export function validateTitleTemplateClient(template) {
+    if (!template || template.trim() === '')
+        return { valid: true, unknownTokens: [] };
+    const known = new Set(SITE_TITLE_TOKENS);
+    const unknown = [];
+    let hasKnown = false;
+    for (const m of template.matchAll(TOKEN_RE)) {
+        const t = m[1];
+        if (known.has(t))
+            hasKnown = true;
+        else if (!unknown.includes(t))
+            unknown.push(t);
+    }
+    const literal = template.replace(TOKEN_RE, '').trim();
+    if (unknown.length > 0)
+        return { valid: false, unknownTokens: unknown };
+    if (!hasKnown && literal === '')
+        return { valid: false, unknownTokens: [] };
+    return { valid: true, unknownTokens: [] };
+}
+function validate(form) {
+    const issues = [];
+    const tpl = validateTitleTemplateClient(form.titleTemplate);
+    if (!tpl.valid) {
+        issues.push({
+            field: 'titleTemplate',
+            message: tpl.unknownTokens.length > 0
+                ? `Unsupported token${tpl.unknownTokens.length > 1 ? 's' : ''}: ${tpl.unknownTokens
+                    .map((t) => `%${t}%`)
+                    .join(', ')}`
+                : 'Template must include at least one token or some literal text.',
+            severity: 'error',
+        });
+    }
+    const desc = form.defaultMetaDescription.trim();
+    if (desc.length > META_DESCRIPTION_MAX) {
+        issues.push({
+            field: 'defaultMetaDescription',
+            message: `Default description is ${desc.length} characters — search engines truncate around ${META_DESCRIPTION_MAX}.`,
+            severity: 'warning',
+        });
+    }
+    else if (desc.length > 0 && desc.length < META_DESCRIPTION_MIN) {
+        issues.push({
+            field: 'defaultMetaDescription',
+            message: `Default description is short (${desc.length} characters). Aim for ${META_DESCRIPTION_MIN}–${META_DESCRIPTION_MAX}.`,
+            severity: 'warning',
+        });
+    }
+    return issues;
+}
+export function useSeoSettings(canEdit) {
+    const [loading, setLoading] = useState(true);
+    const [loadError, setLoadError] = useState(null);
+    const [baseline, setBaseline] = useState(EMPTY_FORM);
+    const [form, setForm] = useState(EMPTY_FORM);
+    const [overrideSite, setOverrideSite] = useState({});
+    const [sources, setSources] = useState({});
+    const [siteName, setSiteName] = useState('');
+    const [siteUrl, setSiteUrl] = useState('');
+    const [isProduction, setIsProduction] = useState(false);
+    const [sitemap, setSitemap] = useState(null);
+    const [saveState, setSaveState] = useState('idle');
+    const [saveError, setSaveError] = useState(null);
+    const [regenerating, setRegenerating] = useState(false);
+    const [reloadKey, setReloadKey] = useState(0);
+    useEffect(() => {
+        let cancelled = false;
+        setLoading(true);
+        setLoadError(null);
+        Promise.all([
+            cmsApi('/seo/config'),
+            cmsApi('/seo/crawl-settings'),
+            cmsApi('/seo/sitemap/status'),
+            cmsApi('/seo/index-status'),
+        ])
+            .then(([seoRes, crawlRes, sitemapRes, statusRes]) => {
+            if (cancelled)
+                return;
+            if (seoRes.error && seoRes.status !== 404)
+                setLoadError(seoRes.error);
+            const seo = seoRes.data ?? {};
+            const effectiveSite = seo.effective?.site ?? {};
+            const staticSite = seo.static?.site ?? {};
+            const overSite = seo.overrides?.site ?? {};
+            const verification = effectiveSite.verification ?? {};
+            const crawl = crawlRes.data ?? {};
+            const loaded = {
+                titleTemplate: String(effectiveSite.titleTemplate ?? ''),
+                defaultMetaDescription: String(effectiveSite.defaultMetaDescription ?? ''),
+                defaultOgImage: String(effectiveSite.defaultOgImage ?? ''),
+                defaultSocialImageAssetId: String(effectiveSite.defaultSocialImageAssetId ?? ''),
+                googleVerification: String(verification.googleSearchConsole ?? ''),
+                bingVerification: String(verification.bingWebmasterTools ?? ''),
+                yandexVerification: String(verification.yandex ?? ''),
+                pinterestVerification: String(verification.pinterest ?? ''),
+                facebookDomainVerification: String(verification.facebookDomain ?? ''),
+                autoGenerateSitemap: crawl.autoRegenerateSitemapOnPublish !== false,
+                pingOnPublish: crawl.pingSearchEnginesOnPublish !== false,
+            };
+            // `editable` reflects the field's MANAGEMENT source (config vs database),
+            // not the user's role — role gates the inputs via `canEdit`. This keeps
+            // the source badge (and the field's accessible label) stable across
+            // roles, and only surfaces it when a value is locked by config.
+            const configManaged = (key) => staticSite[key]
+                ? { source: 'config', editable: false, reason: 'Set in actuate.config.ts' }
+                : { source: 'database', editable: true };
+            setSources({
+                titleTemplate: configManaged('titleTemplate'),
+                defaultMetaDescription: configManaged('defaultMetaDescription'),
+                defaultOgImage: configManaged('defaultOgImage'),
+                verification: { source: 'database', editable: true },
+                sitemap: { source: 'database', editable: true },
+            });
+            setBaseline(loaded);
+            setForm(loaded);
+            setOverrideSite(overSite ?? {});
+            setSiteName(String(effectiveSite.siteName ?? ''));
+            setSiteUrl(String(effectiveSite.siteUrl ?? ''));
+            if (statusRes.data?.environment)
+                setIsProduction(statusRes.data.environment === 'production');
+            if (!sitemapRes.error && sitemapRes.data)
+                setSitemap(sitemapRes.data);
+        })
+            .catch(() => {
+            if (!cancelled)
+                setLoadError('Failed to load SEO settings.');
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [reloadKey, canEdit]);
+    const setField = useCallback((key, value) => {
+        setForm((prev) => ({ ...prev, [key]: value }));
+        setSaveState('idle');
+    }, []);
+    const dirty = useMemo(() => Object.keys(form).some((k) => form[k] !== baseline[k]), [form, baseline]);
+    const issues = useMemo(() => validate(form), [form]);
+    const hasErrors = issues.some((i) => i.severity === 'error');
+    const refetchSitemap = useCallback(async () => {
+        const res = await cmsApi('/seo/sitemap/status');
+        if (!res.error && res.data)
+            setSitemap(res.data);
+    }, []);
+    const save = useCallback(async () => {
+        if (!canEdit || hasErrors)
+            return;
+        setSaveState('saving');
+        setSaveError(null);
+        const siteChanged = form.titleTemplate !== baseline.titleTemplate ||
+            form.defaultMetaDescription !== baseline.defaultMetaDescription ||
+            form.defaultOgImage !== baseline.defaultOgImage ||
+            form.defaultSocialImageAssetId !== baseline.defaultSocialImageAssetId ||
+            form.googleVerification !== baseline.googleVerification ||
+            form.bingVerification !== baseline.bingVerification ||
+            form.yandexVerification !== baseline.yandexVerification ||
+            form.pinterestVerification !== baseline.pinterestVerification ||
+            form.facebookDomainVerification !== baseline.facebookDomainVerification;
+        const sitemapChanged = form.autoGenerateSitemap !== baseline.autoGenerateSitemap ||
+            form.pingOnPublish !== baseline.pingOnPublish;
+        try {
+            // 1. Meta defaults + verification → shared /seo/config (merge over the
+            //    current override site so General's siteUrl/robots aren't wiped).
+            if (siteChanged) {
+                const nextSite = {
+                    ...overrideSite,
+                    titleTemplate: form.titleTemplate.trim() || undefined,
+                    defaultMetaDescription: form.defaultMetaDescription.trim() || undefined,
+                    defaultOgImage: form.defaultOgImage.trim() || undefined,
+                    defaultSocialImageAssetId: form.defaultSocialImageAssetId.trim() || undefined,
+                    verification: {
+                        ...(overrideSite.verification ?? {}),
+                        googleSearchConsole: form.googleVerification.trim() || undefined,
+                        bingWebmasterTools: form.bingVerification.trim() || undefined,
+                        yandex: form.yandexVerification.trim() || undefined,
+                        pinterest: form.pinterestVerification.trim() || undefined,
+                        facebookDomain: form.facebookDomainVerification.trim() || undefined,
+                    },
+                };
+                const res = await cmsApi('/seo/config', {
+                    method: 'PUT',
+                    body: JSON.stringify({ site: nextSite }),
+                });
+                if (res.error)
+                    throw new Error(res.error);
+                setOverrideSite(nextSite);
+            }
+            // 2. Sitemap toggles → shared /seo/crawl-settings (`module`).
+            if (sitemapChanged) {
+                const res = await cmsApi('/seo/crawl-settings', {
+                    method: 'PUT',
+                    body: JSON.stringify({
+                        autoRegenerateSitemapOnPublish: form.autoGenerateSitemap,
+                        pingSearchEnginesOnPublish: form.pingOnPublish,
+                    }),
+                });
+                if (res.error)
+                    throw new Error(res.error);
+            }
+            setBaseline(form);
+            setSaveState('success');
+            if (sitemapChanged)
+                await refetchSitemap();
+        }
+        catch (err) {
+            setSaveState('error');
+            setSaveError(err instanceof Error ? err.message : 'Failed to save SEO settings.');
+        }
+    }, [canEdit, hasErrors, form, baseline, overrideSite, refetchSitemap]);
+    const reset = useCallback(() => {
+        setForm(baseline);
+        setSaveState('idle');
+        setSaveError(null);
+    }, [baseline]);
+    const refetch = useCallback(() => setReloadKey((k) => k + 1), []);
+    const regenerateSitemap = useCallback(async () => {
+        setRegenerating(true);
+        try {
+            const res = await cmsApi('/seo/sitemap/regenerate', { method: 'POST' });
+            if (!res.error && res.data)
+                setSitemap((prev) => ({ ...(prev ?? res.data), ...res.data }));
+        }
+        finally {
+            setRegenerating(false);
+        }
+    }, []);
+    return {
+        loading,
+        loadError,
+        form,
+        setField,
+        dirty,
+        issues,
+        hasErrors,
+        sources,
+        siteName,
+        siteUrl,
+        isProduction,
+        sitemap,
+        saveState,
+        saveError,
+        save,
+        reset,
+        refetch,
+        regenerateSitemap,
+        regenerating,
+    };
+}
+//# sourceMappingURL=useSeoSettings.js.map

package/dist/views/settings/useSeoSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSeoSettings.js","sourceRoot":"","sources":["../../../src/views/settings/useSeoSettings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cms-admin",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/actuate-media/actuatecms.git",
@@ -88,7 +88,7 @@
     "tailwindcss": "^4.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@actuate-media/cms-core": "0.41.0",
+    "@actuate-media/cms-core": "0.42.0",
     "@actuate-media/component-blocks": "0.2.0"
   },
   "scripts": {

package/src/__tests__/views/seo-settings.render.test.tsx

@@ -0,0 +1,219 @@
+// @vitest-environment happy-dom
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { fireEvent, render, screen, waitFor, within } from '@testing-library/react'
+
+// The SEO defaults tab reads four shared backends: /seo/config (meta defaults +
+// verification), /seo/crawl-settings (sitemap toggles), /seo/sitemap/status
+// (read-only summary), and /seo/index-status (environment).
+const cmsApi = vi.fn(async (endpoint: string, options?: { method?: string }) => {
+  const method = options?.method ?? 'GET'
+  if (endpoint === '/seo/config' && method === 'GET') {
+    return {
+      data: {
+        static: { site: null },
+        overrides: { site: {} },
+        effective: {
+          site: {
+            siteName: 'Acme',
+            siteUrl: 'https://acme.test',
+            titleTemplate: '%page% — %site%',
+            defaultMetaDescription: 'Seed description.',
+            verification: { googleSearchConsole: '', bingWebmasterTools: '' },
+          },
+        },
+        collections: [],
+      },
+      status: 200,
+    }
+  }
+  if (endpoint === '/seo/crawl-settings' && method === 'GET') {
+    return {
+      data: {
+        autoRegenerateSitemapOnPublish: true,
+        pingSearchEnginesOnPublish: true,
+        sitemapEnabled: true,
+      },
+      status: 200,
+    }
+  }
+  if (endpoint === '/seo/sitemap/status' && method === 'GET') {
+    return {
+      data: {
+        sitemapUrl: 'https://acme.test/api/cms/sitemap.xml',
+        lastGeneratedAt: '2026-01-02T03:04:05.000Z',
+        pagesIncluded: 12,
+        pagesExcluded: 1,
+        warnings: [],
+      },
+      status: 200,
+    }
+  }
+  if (endpoint === '/seo/index-status' && method === 'GET') {
+    return { data: { environment: 'preview' }, status: 200 }
+  }
+  return { data: {}, status: 200 }
+})
+
+vi.mock('../../lib/api.js', () => ({
+  cmsApi: (e: string, o?: unknown) => cmsApi(e, o as any),
+  ensureCsrfToken: vi.fn(async () => {}),
+}))
+
+// Stub the Media Center picker: when open, expose a button that selects a known
+// asset (id + url), exercising the asset-id storage path without the real
+// MediaBrowser/network stack.
+vi.mock('../../components/MediaPickerModal.js', () => ({
+  MediaPickerModal: ({
+    open,
+    onSelect,
+    onSelectItem,
+  }: {
+    open: boolean
+    onSelect: (url: string) => void
+    onSelectItem?: (item: { id: string }) => void
+  }) =>
+    open ? (
+      <button
+        type="button"
+        onClick={() => {
+          onSelect('https://cdn.test/og.png')
+          onSelectItem?.({ id: 'asset-123' })
+        }}
+      >
+        pick-asset
+      </button>
+    ) : null,
+}))
+
+const { SeoSettingsTab } = await import('../../views/settings/SeoSettingsTab.js')
+
+beforeEach(() => {
+  cmsApi.mockClear()
+})
+
+describe('SeoSettingsTab', () => {
+  it('renders the workspace callout and loads meta defaults from /seo/config', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+
+    expect(await screen.findByText('Looking for the full SEO workspace?')).toBeTruthy()
+    expect((screen.getByLabelText('Title template') as HTMLInputElement).value).toBe(
+      '%page% — %site%',
+    )
+    expect((screen.getByLabelText('Default meta description') as HTMLTextAreaElement).value).toBe(
+      'Seed description.',
+    )
+    // Clean form → Save disabled.
+    expect(
+      (screen.getByRole('button', { name: 'Save Changes' }) as HTMLButtonElement).disabled,
+    ).toBe(true)
+  })
+
+  it('routes "Open SEO" to /seo', async () => {
+    const onNavigate = vi.fn()
+    render(<SeoSettingsTab role="ADMIN" onNavigate={onNavigate} />)
+    await screen.findByText('Looking for the full SEO workspace?')
+    fireEvent.click(screen.getByRole('button', { name: /Open SEO/ }))
+    expect(onNavigate).toHaveBeenCalledWith('/seo')
+  })
+
+  it('rejects an unsupported title-template token and blocks save', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    const tpl = (await screen.findByLabelText('Title template')) as HTMLInputElement
+    fireEvent.change(tpl, { target: { value: '%page% %bogus%' } })
+
+    expect((await screen.findAllByText(/Unsupported token/i)).length).toBeGreaterThan(0)
+    expect(
+      (screen.getByRole('button', { name: 'Save Changes' }) as HTMLButtonElement).disabled,
+    ).toBe(true)
+  })
+
+  it('shows a character count and warns when the description is too long', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    const desc = (await screen.findByLabelText('Default meta description')) as HTMLTextAreaElement
+    fireEvent.change(desc, { target: { value: 'x'.repeat(200) } })
+
+    expect(screen.getByText('200/160')).toBeTruthy()
+    expect((await screen.findAllByText(/truncate/i)).length).toBeGreaterThan(0)
+  })
+
+  it('persists meta defaults + verification to the shared /seo/config', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    const google = (await screen.findByLabelText('Google Search Console')) as HTMLInputElement
+    fireEvent.change(google, { target: { value: 'goog-token' } })
+
+    const save = screen.getByRole('button', { name: 'Save Changes' }) as HTMLButtonElement
+    expect(save.disabled).toBe(false)
+    fireEvent.click(save)
+
+    await waitFor(() =>
+      expect(cmsApi).toHaveBeenCalledWith(
+        '/seo/config',
+        expect.objectContaining({ method: 'PUT' }),
+      ),
+    )
+    const putCall = cmsApi.mock.calls.find(
+      ([e, o]) => e === '/seo/config' && (o as { method?: string })?.method === 'PUT',
+    )
+    const body = JSON.parse((putCall![1] as { body: string }).body)
+    expect(body.site.verification.googleSearchConsole).toBe('goog-token')
+  })
+
+  it('stores the selected social image asset id from the Media Center picker', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    await screen.findByLabelText('Title template')
+
+    fireEvent.click(screen.getByRole('button', { name: 'Choose image' }))
+    fireEvent.click(screen.getByRole('button', { name: 'pick-asset' }))
+
+    const save = screen.getByRole('button', { name: 'Save Changes' }) as HTMLButtonElement
+    expect(save.disabled).toBe(false)
+    fireEvent.click(save)
+
+    await waitFor(() =>
+      expect(cmsApi).toHaveBeenCalledWith(
+        '/seo/config',
+        expect.objectContaining({ method: 'PUT' }),
+      ),
+    )
+    const putCall = cmsApi.mock.calls.find(
+      ([e, o]) => e === '/seo/config' && (o as { method?: string })?.method === 'PUT',
+    )
+    const body = JSON.parse((putCall![1] as { body: string }).body)
+    expect(body.site.defaultSocialImageAssetId).toBe('asset-123')
+    expect(body.site.defaultOgImage).toBe('https://cdn.test/og.png')
+  })
+
+  it('persists sitemap toggles to the shared /seo/crawl-settings', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    await screen.findByLabelText('Title template')
+    fireEvent.click(screen.getByRole('switch', { name: 'Ping search engines on publish' }))
+
+    fireEvent.click(screen.getByRole('button', { name: 'Save Changes' }))
+
+    await waitFor(() =>
+      expect(cmsApi).toHaveBeenCalledWith(
+        '/seo/crawl-settings',
+        expect.objectContaining({ method: 'PUT' }),
+      ),
+    )
+  })
+
+  it('shows the read-only sitemap summary', async () => {
+    render(<SeoSettingsTab role="ADMIN" />)
+    await screen.findByLabelText('Title template')
+    expect(screen.getByText('Included URLs')).toBeTruthy()
+    expect(screen.getByText('12')).toBeTruthy()
+    expect(screen.getByRole('link', { name: /View sitemap/ })).toBeTruthy()
+  })
+
+  it('is read-only for non-admins', async () => {
+    render(<SeoSettingsTab role="EDITOR" />)
+    expect(await screen.findByText(/read-only access to SEO defaults/i)).toBeTruthy()
+    // Scope to the Meta Defaults region: the advanced SEOConfigPanel disclosure
+    // also mounts and can briefly produce overlapping label matches.
+    const metaCard = screen.getByRole('region', { name: 'Meta Defaults' })
+    expect((within(metaCard).getByLabelText('Title template') as HTMLInputElement).disabled).toBe(
+      true,
+    )
+  })
+})

package/src/__tests__/views/settings-save-footer.render.test.tsx

@@ -3,11 +3,16 @@ import { beforeEach, describe, expect, it, vi } from 'vitest'
 import { render, screen, waitFor } from '@testing-library/react'
 
 /**
- * Regression: the shared "Save Changes" footer must only render on tabs that
- * actually persist through `handleSave` (currently just Layout, which writes
- * `defaultLayout` into the settings global). On self-managed tabs like SEO it
- * was rendering a footer whose click toasted "Settings saved successfully!"
- * while persisting none of the tab's edits — misleading, no-op UI.
+ * Regression: the shared no-op "Save Changes" footer (driven by the settings
+ * global `handleSave`) must only render on tabs that actually persist through
+ * it (currently just Layout). On self-managed tabs like SEO it used to render a
+ * SECOND footer whose click toasted "Settings saved successfully!" while
+ * persisting none of the tab's edits — misleading, no-op UI.
+ *
+ * The SEO tab now owns a real `SettingsSaveBar` (also labelled "Save Changes")
+ * that persists through `/seo/config`, so the contract is: exactly ONE
+ * "Save Changes" button on the SEO tab — the tab's own — never the global one
+ * stacked on top of it.
  */
 const SEO_CONFIG = {
   static: { site: null },
@@ -44,15 +49,17 @@ beforeEach(() => {
 })
 
 describe('Settings shared save footer', () => {
-  it('does NOT render the global "Save Changes" footer on the self-managed SEO tab', async () => {
+  it("renders only the SEO tab's own save bar, not the global footer on top", async () => {
     render(<Settings config={LAYOUT_CONFIG} session={SESSION} initialTab="seo" />)
 
-    // The SEO panel owns its own persistence ("Save SEO defaults").
+    // The Advanced disclosure still mounts the per-collection SEO panel, which
+    // owns its own persistence ("Save SEO defaults").
     expect(
       (await screen.findAllByRole('button', { name: 'Save SEO defaults' })).length,
     ).toBeGreaterThan(0)
-    // The shared footer ("Save Changes") must be absent here.
-    expect(screen.queryByRole('button', { name: 'Save Changes' })).toBeNull()
+    // The tab's own SettingsSaveBar is the ONLY "Save Changes" button — the
+    // no-op global footer must not be stacked on top of it.
+    expect(screen.getAllByRole('button', { name: 'Save Changes' })).toHaveLength(1)
   })
 
   it('renders the global "Save Changes" footer on the Layout tab', async () => {

package/src/components/MediaPickerModal.tsx

@@ -16,14 +16,35 @@ interface MediaItem {
   height?: number
 }
 
+/** Minimal selected-asset shape exposed to callers that need the asset id. */
+export interface SelectedMediaItem {
+  id: string
+  storageKey: string
+  filename: string
+  mimeType: string
+  width?: number
+  height?: number
+}
+
 export interface MediaPickerModalProps {
   open: boolean
   onClose: () => void
   onSelect: (url: string, alt?: string) => void
+  /**
+   * Optional richer callback fired alongside `onSelect` with the full media
+   * item, so callers that need to store the asset id (not just the URL) can.
+   */
+  onSelectItem?: (item: SelectedMediaItem) => void
   accept?: string
 }
 
-export function MediaPickerModal({ open, onClose, onSelect, accept }: MediaPickerModalProps) {
+export function MediaPickerModal({
+  open,
+  onClose,
+  onSelect,
+  onSelectItem,
+  accept,
+}: MediaPickerModalProps) {
   const [tab, setTab] = useState<'library' | 'upload'>('library')
   const [search, setSearch] = useState('')
   const [uploading, setUploading] = useState(false)
@@ -52,9 +73,17 @@ export function MediaPickerModal({ open, onClose, onSelect, accept }: MediaPicke
     if (res.error) {
       toast.error(res.error)
     } else if (res.data) {
-      const mediaItem = res.data as any
+      const mediaItem = res.data as MediaItem
       const url = mediaItem.storageKey ?? ''
       toast.success(`Uploaded ${file.name}`)
+      onSelectItem?.({
+        id: mediaItem.id,
+        storageKey: mediaItem.storageKey,
+        filename: mediaItem.filename ?? file.name,
+        mimeType: mediaItem.mimeType ?? file.type,
+        width: mediaItem.width,
+        height: mediaItem.height,
+      })
       onSelect(url, file.name)
       onClose()
     }
@@ -64,6 +93,14 @@ export function MediaPickerModal({ open, onClose, onSelect, accept }: MediaPicke
   }
 
   function handleSelectItem(item: MediaItem) {
+    onSelectItem?.({
+      id: item.id,
+      storageKey: item.storageKey,
+      filename: item.filename,
+      mimeType: item.mimeType,
+      width: item.width,
+      height: item.height,
+    })
     onSelect(item.storageKey, item.filename)
     onClose()
   }

package/src/views/Settings.tsx

@@ -22,8 +22,8 @@ import { toast } from 'sonner'
 import { useApiData } from '../lib/useApiData.js'
 import { cmsApi } from '../lib/api.js'
 import { RelationshipField } from '../fields/RelationshipField.js'
-import { SEOConfigPanel } from '../components/SEOConfigPanel.js'
 import { GeneralSettingsTab } from './settings/GeneralSettingsTab.js'
+import { SeoSettingsTab } from './settings/SeoSettingsTab.js'
 import { AppearanceTab } from './settings/AppearanceTab.js'
 import { SecurityTab } from './settings/SecurityTab.js'
 import { Users as UsersView } from './Users.js'
@@ -314,7 +314,7 @@ export function Settings({
         </Tabs.Content>
 
         <Tabs.Content value="seo" className="space-y-4">
-          <SEOConfigPanel />
+          <SeoSettingsTab onNavigate={onNavigate} role={session?.user?.role} />
         </Tabs.Content>
 
         <Tabs.Content value="ai" className="space-y-4">