@growth-labs/cms 0.1.0

package/dist/ui/inspector/SeoTab.js

@@ -0,0 +1,328 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// src/ui/inspector/SeoTab.tsx — SEO inspector tab.
+//
+// Sections:
+//   - Score ring: live 0–100 score + 5-check checklist (re-scores on debounce).
+//   - Meta fields: seoTitle / description / seoFocusKeyword — PATCH on blur.
+//   - OG / social preview: renders from title/excerpt/hero; Generate is P4-disabled.
+//
+// The Generate button is rendered disabled with title="AI generation arrives in P4"
+// per the P3 scope guard: NO LlmDispatch call here.
+//
+// Compile-gated (tsc, jsx: react-jsx). No vitest — the pure helpers (scoreRingGeometry,
+// seoSummary) are tested in score-ring.test.ts / seo-checks.test.ts.
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Icon } from '../icons.js';
+import { Field } from './Field.js';
+import { generateOgImage, ogButtonState, patchContent, scoreSeo } from './inspector-data.js';
+import { Section } from './Section.js';
+import { scoreRingGeometry, seoSummary } from './seo-helpers.js';
+// ---------------------------------------------------------------------------
+// SeoTab
+// ---------------------------------------------------------------------------
+export function SeoTab({ docId, seoTitle: initialSeoTitle, description: initialDescription, seoFocusKeyword: initialFocusKeyword, title, excerpt, heroImageUrl, onChanged, }) {
+    // Local field state (controlled).
+    const [seoTitle, setSeoTitle] = useState(initialSeoTitle ?? '');
+    const [description, setDescription] = useState(initialDescription ?? '');
+    const [focusKeyword, setFocusKeyword] = useState(initialFocusKeyword ?? '');
+    // OG image generation state.
+    const [ogState, setOgState] = useState('idle');
+    const [ogPreviewUrl, setOgPreviewUrl] = useState(heroImageUrl);
+    // Sync external changes (e.g. after a parent refresh).
+    useEffect(() => setSeoTitle(initialSeoTitle ?? ''), [initialSeoTitle]);
+    useEffect(() => setDescription(initialDescription ?? ''), [initialDescription]);
+    useEffect(() => setFocusKeyword(initialFocusKeyword ?? ''), [initialFocusKeyword]);
+    // Live score state.
+    const [score, setScore] = useState(null);
+    const [checks, setChecks] = useState([]);
+    const [scoring, setScoring] = useState(false);
+    // Debounce timer ref.
+    const debounceRef = useRef(null);
+    // Re-score when any SEO field changes.
+    const triggerScore = useCallback((overrides) => {
+        if (debounceRef.current)
+            clearTimeout(debounceRef.current);
+        debounceRef.current = setTimeout(async () => {
+            setScoring(true);
+            try {
+                const result = (await scoreSeo(docId, {
+                    seoTitle: overrides.seoTitle,
+                    description: overrides.description,
+                    focusKeyword: overrides.focusKeyword,
+                }));
+                if (typeof result.score === 'number')
+                    setScore(result.score);
+                if (Array.isArray(result.checks))
+                    setChecks(result.checks);
+            }
+            catch {
+                // non-fatal — ring stays on last score
+            }
+            finally {
+                setScoring(false);
+            }
+        }, 400);
+    }, [docId]);
+    // Initial score on mount (no overrides — read persisted fields).
+    useEffect(() => {
+        if (!docId)
+            return;
+        void (async () => {
+            setScoring(true);
+            try {
+                const result = (await scoreSeo(docId));
+                if (typeof result.score === 'number')
+                    setScore(result.score);
+                if (Array.isArray(result.checks))
+                    setChecks(result.checks);
+            }
+            catch {
+                // non-fatal
+            }
+            finally {
+                setScoring(false);
+            }
+        })();
+    }, [docId]);
+    // Field change handlers — update local state + trigger a re-score.
+    const handleSeoTitleChange = useCallback((e) => {
+        const val = e.target.value;
+        setSeoTitle(val);
+        triggerScore({ seoTitle: val, description, focusKeyword });
+    }, [description, focusKeyword, triggerScore]);
+    const handleDescriptionChange = useCallback((e) => {
+        const val = e.target.value;
+        setDescription(val);
+        triggerScore({ seoTitle, description: val, focusKeyword });
+    }, [seoTitle, focusKeyword, triggerScore]);
+    const handleFocusKeywordChange = useCallback((e) => {
+        const val = e.target.value;
+        setFocusKeyword(val);
+        triggerScore({ seoTitle, description, focusKeyword: val });
+    }, [seoTitle, description, triggerScore]);
+    // PATCH on blur — persist to the backend.
+    const handleSeoTitleBlur = useCallback(async () => {
+        try {
+            await patchContent(docId, { seoTitle: seoTitle || null });
+            onChanged?.();
+        }
+        catch {
+            // non-fatal
+        }
+    }, [docId, seoTitle, onChanged]);
+    const handleDescriptionBlur = useCallback(async () => {
+        try {
+            await patchContent(docId, { description: description || null });
+            onChanged?.();
+        }
+        catch {
+            // non-fatal
+        }
+    }, [docId, description, onChanged]);
+    const handleFocusKeywordBlur = useCallback(async () => {
+        try {
+            await patchContent(docId, { seoFocusKeyword: focusKeyword || null });
+            onChanged?.();
+        }
+        catch {
+            // non-fatal
+        }
+    }, [docId, focusKeyword, onChanged]);
+    // Sync OG preview when hero url changes externally.
+    useEffect(() => setOgPreviewUrl(heroImageUrl), [heroImageUrl]);
+    // OG image generate handler (P4 — live).
+    const handleGenerateOgImage = useCallback(async () => {
+        if (!docId || ogState === 'loading')
+            return;
+        setOgState('loading');
+        try {
+            const result = await generateOgImage(docId);
+            const state = ogButtonState(result.written, result.locked);
+            setOgState(state === 'idle' ? 'generated' : state);
+            setOgPreviewUrl(result.url);
+            onChanged?.();
+        }
+        catch {
+            setOgState('error');
+        }
+    }, [docId, ogState, onChanged]);
+    const summary = seoSummary(checks);
+    const ringGeom = score !== null ? scoreRingGeometry(score, 72) : null;
+    // -------------------------------------------------------------------------
+    // Render
+    // -------------------------------------------------------------------------
+    return (_jsxs("div", { children: [_jsxs(Section, { title: "SEO score", icon: "seo", children: [_jsxs("div", { style: scoreWrap, children: [_jsxs("div", { style: ringWrap, children: [ringGeom ? (_jsxs("svg", { width: 72, height: 72, role: "img", "aria-label": `SEO score: ${score ?? 0}`, style: { transform: 'rotate(-90deg)' }, children: [_jsx("circle", { cx: 36, cy: 36, r: ringGeom.radius, fill: "none", stroke: "var(--hover)", strokeWidth: 8 }), _jsx("circle", { cx: 36, cy: 36, r: ringGeom.radius, fill: "none", stroke: ringColorVar(ringGeom.color), strokeWidth: 8, strokeLinecap: "round", strokeDasharray: ringGeom.circumference, strokeDashoffset: ringGeom.dashOffset, style: { transition: 'stroke-dashoffset .3s ease' } })] })) : (_jsx("svg", { width: 72, height: 72, "aria-hidden": "true", children: _jsx("circle", { cx: 36, cy: 36, r: 28, fill: "none", stroke: "var(--hover)", strokeWidth: 8 }) })), _jsx("div", { style: ringLabel, children: scoring ? (_jsx("span", { style: ringLabelText, children: "\u2026" })) : score !== null ? (_jsx("span", { style: ringLabelText, children: score })) : null })] }), _jsxs("div", { style: scoreInfo, children: [_jsx("div", { style: verdictLabel, children: summary.verdict }), _jsxs("div", { style: verdictSub, children: [summary.passing, "/", summary.total, " checks passing"] })] })] }), checks.length > 0 && (_jsx("ul", { style: checkList, children: checks.map((c) => (_jsxs("li", { style: checkItem, children: [_jsx("span", { style: checkIcon(c.pass), children: c.pass ? _jsx(Icon, { name: "checkCircle", size: 13 }) : _jsx(Icon, { name: "x", size: 13 }) }), _jsxs("span", { style: checkBody, children: [_jsx("span", { style: checkLabel(c.pass), children: c.label }), !c.pass && _jsx("span", { style: checkHint, children: c.hint })] })] }, c.id))) }))] }), _jsxs(Section, { title: "Meta fields", icon: "search", children: [_jsx(Field, { label: "Focus keyword", htmlFor: "seo-focus-keyword", children: _jsx("input", { id: "seo-focus-keyword", className: "input", type: "text", value: focusKeyword, placeholder: "e.g. content marketing", onChange: handleFocusKeywordChange, onBlur: () => void handleFocusKeywordBlur() }) }), _jsxs(Field, { label: "SEO title", htmlFor: "seo-title", help: "Overrides the page title in search results. Leave blank to use the content title.", children: [_jsx("input", { id: "seo-title", className: "input", type: "text", value: seoTitle, placeholder: title, maxLength: 60, onChange: handleSeoTitleChange, onBlur: () => void handleSeoTitleBlur() }), _jsxs("div", { style: charCount(seoTitle.length, 60), children: [seoTitle.length, "/60"] })] }), _jsxs(Field, { label: "Meta description", htmlFor: "seo-description", help: "Shown in search results. Aim for 50\u2013160 characters.", children: [_jsx("textarea", { id: "seo-description", className: "textarea", value: description, placeholder: "A concise summary of this content\u2026", maxLength: 160, rows: 3, onChange: handleDescriptionChange, onBlur: () => void handleDescriptionBlur() }), _jsxs("div", { style: charCount(description.length, 160), children: [description.length, "/160"] })] })] }), _jsxs(Section, { title: "Social card preview", icon: "globe", children: [_jsx("p", { style: ogHelp, children: "Social image defaults to the hero image. Generate a custom social image only when you need an override for sharing." }), _jsxs("div", { style: ogCard, children: [ogPreviewUrl ? (_jsx("div", { style: ogImageWrap, children: _jsx("img", { src: ogPreviewUrl, alt: "", style: ogImage }) })) : (_jsx("div", { style: ogImagePlaceholder, children: _jsx(Icon, { name: "image", size: 22, style: { color: 'var(--ink-faint)' } }) })), _jsxs("div", { style: ogMeta, children: [_jsx("div", { style: ogSiteName, children: "yoursite.com" }), _jsx("div", { style: ogTitle, children: seoTitle || title || 'Untitled' }), _jsx("div", { style: ogDesc, children: description || excerpt || 'No description yet.' })] })] }), ogState === 'locked' && _jsx("p", { style: lockedHint, children: "Field locked \u2014 AI cannot overwrite." }), ogState === 'error' && _jsx("p", { style: errorHint, children: "Generation failed. Try again." }), _jsxs("button", { type: "button", className: "btn sm", style: {
+                            width: '100%',
+                            opacity: ogState === 'loading' ? 0.6 : 1,
+                            cursor: ogState === 'loading' ? 'wait' : 'pointer',
+                        }, disabled: ogState === 'loading', onClick: () => void handleGenerateOgImage(), children: [_jsx(Icon, { name: "sparkle", size: 14 }), ogState === 'loading'
+                                ? 'Generating…'
+                                : ogState === 'generated'
+                                    ? 'Regenerate custom social image'
+                                    : 'Generate custom social image'] })] })] }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function ringColorVar(color) {
+    switch (color) {
+        case 'green':
+            return 'var(--green, #22c55e)';
+        case 'amber':
+            return 'var(--amber, #f59e0b)';
+        case 'red':
+            return 'var(--red, #ef4444)';
+    }
+}
+// ---------------------------------------------------------------------------
+// Styles
+// ---------------------------------------------------------------------------
+const scoreWrap = {
+    display: 'flex',
+    alignItems: 'center',
+    gap: 16,
+    marginBottom: 16,
+};
+const ringWrap = {
+    position: 'relative',
+    width: 72,
+    height: 72,
+    flexShrink: 0,
+};
+const ringLabel = {
+    position: 'absolute',
+    inset: 0,
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    pointerEvents: 'none',
+};
+const ringLabelText = {
+    fontSize: 18,
+    fontWeight: 700,
+    color: 'var(--ink)',
+};
+const scoreInfo = {
+    flex: 1,
+};
+const verdictLabel = {
+    fontSize: 15,
+    fontWeight: 700,
+    color: 'var(--ink)',
+    marginBottom: 2,
+};
+const verdictSub = {
+    fontSize: 12,
+    color: 'var(--ink-muted)',
+};
+const checkList = {
+    listStyle: 'none',
+    margin: 0,
+    padding: 0,
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 7,
+};
+const checkItem = {
+    display: 'flex',
+    alignItems: 'flex-start',
+    gap: 8,
+};
+function checkIcon(pass) {
+    return {
+        color: pass ? 'var(--green, #22c55e)' : 'var(--ink-faint)',
+        flexShrink: 0,
+        marginTop: 1,
+    };
+}
+const checkBody = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 1,
+};
+function checkLabel(pass) {
+    return {
+        fontSize: 12.5,
+        fontWeight: 500,
+        color: pass ? 'var(--ink)' : 'var(--ink-muted)',
+    };
+}
+const checkHint = {
+    fontSize: 11,
+    color: 'var(--ink-faint)',
+};
+function charCount(len, max) {
+    return {
+        fontSize: 10.5,
+        color: len > max * 0.9 ? 'var(--amber, #f59e0b)' : 'var(--ink-faint)',
+        textAlign: 'right',
+        marginTop: 3,
+    };
+}
+const ogCard = {
+    border: '1px solid var(--border)',
+    borderRadius: 8,
+    overflow: 'hidden',
+    marginBottom: 10,
+    background: 'var(--panel-2)',
+};
+const ogHelp = {
+    margin: '0 0 10px',
+    fontSize: 11.5,
+    lineHeight: 1.45,
+    color: 'var(--ink-muted)',
+};
+const ogImageWrap = {
+    height: 100,
+    overflow: 'hidden',
+};
+const ogImage = {
+    width: '100%',
+    height: '100%',
+    objectFit: 'cover',
+};
+const ogImagePlaceholder = {
+    height: 100,
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    background: 'var(--field)',
+};
+const ogMeta = {
+    padding: '10px 12px',
+};
+const ogSiteName = {
+    fontSize: 10.5,
+    color: 'var(--ink-faint)',
+    marginBottom: 2,
+    textTransform: 'uppercase',
+    letterSpacing: '0.04em',
+};
+const ogTitle = {
+    fontSize: 13,
+    fontWeight: 600,
+    color: 'var(--ink)',
+    marginBottom: 3,
+    overflow: 'hidden',
+    textOverflow: 'ellipsis',
+    whiteSpace: 'nowrap',
+};
+const ogDesc = {
+    fontSize: 11.5,
+    color: 'var(--ink-muted)',
+    overflow: 'hidden',
+    display: '-webkit-box',
+    WebkitLineClamp: 2,
+    WebkitBoxOrient: 'vertical',
+};
+const lockedHint = {
+    fontSize: 11,
+    color: 'var(--amber, #f59e0b)',
+    margin: '0 0 6px',
+};
+const errorHint = {
+    fontSize: 11,
+    color: 'var(--red, #ef4444)',
+    margin: '0 0 6px',
+};
+//# sourceMappingURL=SeoTab.js.map

package/dist/ui/inspector/SeoTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeoTab.js","sourceRoot":"","sources":["../../../src/ui/inspector/SeoTab.tsx"],"names":[],"mappings":"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"}

package/dist/ui/inspector/foundry-stages.d.ts

@@ -0,0 +1,36 @@
+import type { ProcessingState } from '../../engine/foundry-dispatch.js';
+export interface StageEntry {
+    /** Human-readable stage label. */
+    label: string;
+    /** Approximate duration shown to editors while the pipeline is active. */
+    estimate: string;
+    /** True when this stage has completed successfully. */
+    done: boolean;
+    /** True when this is the currently-executing stage. */
+    active: boolean;
+    /** True when this stage encountered an error (only set for 'failed' state). */
+    error?: boolean;
+}
+/**
+ * Map a processing_state value to the ordered stage list the Foundry tab renders.
+ *
+ * State → stage progress:
+ *   pending      → all pending (not yet dispatched)
+ *   queued       → source stage active
+ *   fetching     → source stage active
+ *   transcribing → source done, transcript stage active
+ *   transcoding  → source + transcript done, transcode active
+ *   ready        → all done
+ *   failed       → no active stage, error flag on first stage (conservative)
+ */
+export declare function processingStages(processingState: ProcessingState, _type: 'video' | 'podcast' | string): StageEntry[];
+export type FoundryPillState = 'working' | 'ready' | 'failed';
+/**
+ * Collapse the 7-value processing_state into a 3-bucket display pill state.
+ *
+ *   pending / queued / fetching / transcribing / transcoding → 'working'
+ *   ready → 'ready'
+ *   failed → 'failed'
+ */
+export declare function foundryPillState(state: ProcessingState): FoundryPillState;
+//# sourceMappingURL=foundry-stages.d.ts.map

package/dist/ui/inspector/foundry-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry-stages.d.ts","sourceRoot":"","sources":["../../../src/ui/inspector/foundry-stages.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAMvE,MAAM,WAAW,UAAU;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAuBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GACjC,UAAU,EAAE,CAmDd;AAMD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAIzE"}

package/dist/ui/inspector/foundry-stages.js

@@ -0,0 +1,101 @@
+// src/ui/inspector/foundry-stages.ts — pure pipeline stage helpers for the Foundry tab.
+//
+// processingStages(processingState, type) maps the 7-state machine to an ordered
+// stage list the design renders:
+//   Source uploaded → Transcode / normalize → Transcript → Thumbnail / chapters
+//
+// Each entry is { label, done, active, error? } — driven by the current
+// processing_state value.
+//
+// foundryPillState(state) → 'working' | 'ready' | 'failed'
+//   Collapses the 7 states into a display pill bucket for the tab header.
+//
+// Pure — no DOM, no React, fully vitest-testable.
+// ---------------------------------------------------------------------------
+// Stage definitions
+// ---------------------------------------------------------------------------
+// The pipeline executes in order: source fetch → transcript → transcode → thumbnail.
+// (The state machine is: queued → fetching → transcribing → transcoding → ready.)
+// Stage indices map 1:1 to the processing pipeline execution order.
+const STAGE_SOURCE = 0; // queued / fetching
+const STAGE_TRANSCRIPT = 1; // transcribing
+const STAGE_TRANSCODE = 2; // transcoding
+const _STAGE_THUMBNAIL = 3; // finalising / thumbnail / chapters (reached at ready); not referenced in switch
+const STAGE_LABELS = [
+    'Source uploaded',
+    'Transcript',
+    'Transcode / normalize',
+    'Thumbnail / chapters',
+];
+const STAGE_ESTIMATES = ['1-5 min', '5-20 min', '10-45 min', '2-10 min'];
+/**
+ * Map a processing_state value to the ordered stage list the Foundry tab renders.
+ *
+ * State → stage progress:
+ *   pending      → all pending (not yet dispatched)
+ *   queued       → source stage active
+ *   fetching     → source stage active
+ *   transcribing → source done, transcript stage active
+ *   transcoding  → source + transcript done, transcode active
+ *   ready        → all done
+ *   failed       → no active stage, error flag on first stage (conservative)
+ */
+export function processingStages(processingState, _type) {
+    const stages = STAGE_LABELS.map((label, index) => ({
+        label,
+        estimate: STAGE_ESTIMATES[index] ?? '',
+        done: false,
+        active: false,
+    }));
+    switch (processingState) {
+        case 'pending':
+            // Nothing done yet — all stages pending, none active
+            break;
+        case 'queued':
+        case 'fetching':
+            // Source is being fetched / item is queued
+            stages[STAGE_SOURCE].active = true;
+            break;
+        case 'transcribing':
+            // Source has been fetched; now generating transcript
+            stages[STAGE_SOURCE].done = true;
+            stages[STAGE_TRANSCRIPT].active = true;
+            break;
+        case 'transcoding':
+            // Transcript done; now transcoding media
+            stages[STAGE_SOURCE].done = true;
+            stages[STAGE_TRANSCRIPT].done = true;
+            stages[STAGE_TRANSCODE].active = true;
+            break;
+        case 'ready':
+            // All stages complete
+            for (const s of stages) {
+                s.done = true;
+            }
+            break;
+        case 'failed': {
+            // No stage is active. Surface the error on the source stage
+            // (conservative — the real error text is in processing_error).
+            stages[STAGE_SOURCE].error = true;
+            break;
+        }
+        default:
+            break;
+    }
+    return stages;
+}
+/**
+ * Collapse the 7-value processing_state into a 3-bucket display pill state.
+ *
+ *   pending / queued / fetching / transcribing / transcoding → 'working'
+ *   ready → 'ready'
+ *   failed → 'failed'
+ */
+export function foundryPillState(state) {
+    if (state === 'ready')
+        return 'ready';
+    if (state === 'failed')
+        return 'failed';
+    return 'working';
+}
+//# sourceMappingURL=foundry-stages.js.map

package/dist/ui/inspector/foundry-stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry-stages.js","sourceRoot":"","sources":["../../../src/ui/inspector/foundry-stages.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,EAAE;AACF,iFAAiF;AACjF,iCAAiC;AACjC,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,0BAA0B;AAC1B,EAAE;AACF,2DAA2D;AAC3D,0EAA0E;AAC1E,EAAE;AACF,kDAAkD;AAqBlD,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,qFAAqF;AACrF,kFAAkF;AAClF,oEAAoE;AACpE,MAAM,YAAY,GAAG,CAAC,CAAA,CAAC,oBAAoB;AAC3C,MAAM,gBAAgB,GAAG,CAAC,CAAA,CAAC,eAAe;AAC1C,MAAM,eAAe,GAAG,CAAC,CAAA,CAAC,cAAc;AACxC,MAAM,gBAAgB,GAAG,CAAC,CAAA,CAAC,iFAAiF;AAE5G,MAAM,YAAY,GAAG;IACpB,iBAAiB;IACjB,YAAY;IACZ,uBAAuB;IACvB,sBAAsB;CACtB,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC/B,eAAgC,EAChC,KAAmC;IAEnC,MAAM,MAAM,GAAiB,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAChE,KAAK;QACL,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE;QACtC,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;KACb,CAAC,CAAC,CAAA;IAEH,QAAQ,eAAe,EAAE,CAAC;QACzB,KAAK,SAAS;YACb,qDAAqD;YACrD,MAAK;QAEN,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACd,2CAA2C;YAC3C,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,IAAI,CAAA;YAClC,MAAK;QAEN,KAAK,cAAc;YAClB,qDAAqD;YACrD,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,GAAG,IAAI,CAAA;YAChC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAA;YACtC,MAAK;QAEN,KAAK,aAAa;YACjB,yCAAyC;YACzC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,GAAG,IAAI,CAAA;YAChC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAA;YACpC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,IAAI,CAAA;YACrC,MAAK;QAEN,KAAK,OAAO;YACX,sBAAsB;YACtB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACxB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAA;YACd,CAAC;YACD,MAAK;QAEN,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,4DAA4D;YAC5D,+DAA+D;YAC/D,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,GAAG,IAAI,CAAA;YACjC,MAAK;QACN,CAAC;QAED;YACC,MAAK;IACP,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACtD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACrC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACvC,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/dist/ui/inspector/inspector-data.d.ts

@@ -0,0 +1,80 @@
+import type { ContentStatus } from '../../schema/types.js';
+export interface PublishActionPayload {
+    /** The ?action= query param value to use. */
+    action: string;
+    /** The JSON body to send (null for bodyless actions). */
+    body: Record<string, unknown> | null;
+}
+/**
+ * Map a target ContentStatus to the action + body expected by the content
+ * route action handler.
+ *
+ * - draft / review → `?action=set-status` with `{ status }`
+ * - published      → `?action=publish` (no body)
+ * - archived       → `?action=archive` (no body)
+ * - scheduled      → use buildScheduleBody + `?action=schedule` separately
+ *   (scheduled requires a date/time and is handled by the PublishTab directly)
+ */
+export declare function publishActionPayload(status: ContentStatus): PublishActionPayload;
+export interface ScheduleBody {
+    publishAtLocal: string;
+    timezone: string;
+}
+/**
+ * Build the JSON body for `?action=schedule`.
+ * The route accepts `publishAtLocal` (an ISO local-datetime string `YYYY-MM-DDTHH:MM`)
+ * plus a `timezone` identifier. Trims the input string.
+ */
+export declare function buildScheduleBody(localDateTime: string, tz: string): ScheduleBody;
+export declare function shouldShowScheduleControls(currentStatus: ContentStatus, selectedStatus: ContentStatus | null | undefined): boolean;
+/** Fetch a full content item payload from the API. */
+export declare function getContent(id: string): Promise<unknown>;
+/** PATCH a content item with a partial update payload. */
+export declare function patchContent(id: string, patch: Record<string, unknown>): Promise<unknown>;
+export declare class CmsActionError extends Error {
+    readonly status: number;
+    readonly payload: Record<string, unknown>;
+    constructor(message: string, status: number, payload: Record<string, unknown>);
+}
+/** Fire a lifecycle action on a content item (POST ?action=...). */
+export declare function runAction(id: string, action: string, body?: Record<string, unknown> | null): Promise<unknown>;
+/**
+ * Build a URL for an AI action endpoint.
+ * e.g. buildAiPostUrl('doc-123', 'og-image') → '/admin/api/content/doc-123/ai/og-image'
+ */
+export declare function buildAiPostUrl(id: string, action: 'og-image' | 'takeaways'): string;
+/**
+ * Determine the OG generate button affordance state.
+ *
+ * - 'generated': the AI just wrote an OG image id (written === true)
+ * - 'locked':    the field is locked by a manual override (locked === true)
+ * - 'idle':      neither — button is ready to trigger
+ */
+export declare function ogButtonState(written: boolean, locked: boolean | undefined): 'generated' | 'locked' | 'idle';
+export interface OgImageResult {
+    ogImageId: string;
+    url: string;
+    written: boolean;
+    locked?: boolean;
+}
+export interface TakeawaysResult {
+    takeaways: string[];
+    written: boolean;
+    locked?: boolean;
+}
+/** POST /admin/api/content/:id/ai/og-image — generate and persist a social-card OG image. */
+export declare function generateOgImage(id: string): Promise<OgImageResult>;
+/** POST /admin/api/content/:id/ai/takeaways — generate and persist key takeaways. */
+export declare function regenerateTakeaways(id: string): Promise<TakeawaysResult>;
+/**
+ * POST /admin/api/content/:id/seo-score with optional override fields.
+ * Returns { score, checks } from the real-time SEO scorer (Task 1 route).
+ */
+export declare function scoreSeo(id: string, overrides?: {
+    title?: string;
+    seoTitle?: string;
+    description?: string;
+    focusKeyword?: string;
+    bodyMarkdown?: string;
+}): Promise<unknown>;
+//# sourceMappingURL=inspector-data.d.ts.map

package/dist/ui/inspector/inspector-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-data.d.ts","sourceRoot":"","sources":["../../../src/ui/inspector/inspector-data.ts"],"names":[],"mappings":"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"}