@prenta/admin 2.6.1 → 2.8.0

package/dist/layout/primitives/AdminShell.js

@@ -1,5 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
+import { X } from 'lucide-react';
+/** The mobile drawer's id, for an opener's `aria-controls`. */
+export const DRAWER_ID = 'prenta-nav-drawer';
+const FOCUSABLE = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+function setInert(el, inert) {
+    if (el)
+        el.inert = inert;
+}
+/**
+ * The drawer's Tab stops: rendered (a `display: none` ancestor leaves no
+ * client rects, like the sidebar's collapse footer below 1025px) and not
+ * inert.
+ */
+function tabStops(root) {
+    return Array.from(root.querySelectorAll(FOCUSABLE)).filter((el) => el.getClientRects().length > 0 && !el.closest('[inert]'));
+}
 /**
  * The canonical admin chrome. Owns the entire viewport, splits into
  * `sidebar | (header + breadcrumbs + content)`, and handles the mobile
@@ -18,8 +34,13 @@ import { useEffect, useState } from 'react';
  *    layout is independent of Tailwind's `md:` utility compilation. If
  *    the CSS bundle is stale or partially loaded the layout still works.
  */
-export function AdminShell({ sidebar, header, breadcrumbs, children, mobileSidebarOpen = false, onMobileSidebarClose, desktopBreakpoint = 768, }) {
+export function AdminShell({ sidebar, header, breadcrumbs, children, tabBar, mobileSidebarOpen = false, onMobileSidebarClose, desktopBreakpoint = 768, }) {
     const [isDesktop, setIsDesktop] = useState(false);
+    const sidebarRef = useRef(null);
+    const contentRef = useRef(null);
+    const tabBarRef = useRef(null);
+    const skipRef = useRef(null);
+    const drawerOpen = !isDesktop && mobileSidebarOpen;
     useEffect(() => {
         if (typeof window === 'undefined')
             return;
@@ -29,9 +50,90 @@ export function AdminShell({ sidebar, header, breadcrumbs, children, mobileSideb
         mq.addEventListener('change', handler);
         return () => mq.removeEventListener('change', handler);
     }, [desktopBreakpoint]);
+    // The closed mobile drawer is off-screen: keep it out of the tab order and
+    // the accessibility tree. Set on the element because React 18 has no
+    // `inert` prop.
+    useEffect(() => {
+        setInert(sidebarRef.current, !isDesktop && !mobileSidebarOpen);
+    }, [isDesktop, mobileSidebarOpen]);
+    // The drawer only exists below the breakpoint: close it on the way out, or
+    // it would reopen by itself when the window narrows again.
+    useEffect(() => {
+        if (isDesktop && mobileSidebarOpen)
+            onMobileSidebarClose?.();
+    }, [isDesktop, mobileSidebarOpen, onMobileSidebarClose]);
+    // The open drawer is modal: the skip link, the content and the tab bar go
+    // inert, focus moves in (to its close button), and on close it returns to
+    // the opener (the tab bar's More, or a custom header's menu button). One effect so the
+    // opener is read before it goes inert and un-inerted before it takes focus
+    // back.
+    useEffect(() => {
+        if (!drawerOpen)
+            return;
+        const opener = document.activeElement;
+        const behind = [skipRef.current, contentRef.current, tabBarRef.current];
+        for (const el of behind)
+            setInert(el, true);
+        const drawer = sidebarRef.current;
+        if (drawer)
+            (tabStops(drawer)[0] ?? drawer).focus();
+        // App shortcuts listening on `document` would open UI in the inert column
+        // (the command palette's Ctrl/Cmd+K); a modal ignores them.
+        const blockShortcuts = (e) => {
+            if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') {
+                e.stopPropagation();
+                // Also keep the browser's own Ctrl+K (focus the address bar) from
+                // firing; Shift combos (e.g. Edge's Duplicate tab) are left alone.
+                if (!e.shiftKey)
+                    e.preventDefault();
+            }
+        };
+        document.addEventListener('keydown', blockShortcuts, true);
+        return () => {
+            document.removeEventListener('keydown', blockShortcuts, true);
+            for (const el of behind)
+                setInert(el, false);
+            if (opener && opener !== document.body && document.contains(opener))
+                opener.focus();
+        };
+    }, [drawerOpen]);
+    // Esc closes the drawer; Tab and Shift+Tab stay inside it. Keys from
+    // portals rendered in the drawer's React tree (a Radix menu's Esc) bubble
+    // here too; they belong to that layer.
+    const onDrawerKeyDown = (e) => {
+        if (!drawerOpen || e.defaultPrevented)
+            return;
+        if (!e.currentTarget.contains(e.target))
+            return;
+        if (e.key === 'Escape') {
+            e.stopPropagation();
+            onMobileSidebarClose?.();
+            return;
+        }
+        if (e.key !== 'Tab')
+            return;
+        const items = tabStops(e.currentTarget);
+        if (items.length === 0)
+            return;
+        const first = items[0];
+        const last = items[items.length - 1];
+        if (e.shiftKey && document.activeElement === first) {
+            e.preventDefault();
+            last.focus();
+        }
+        else if (!e.shiftKey && document.activeElement === last) {
+            e.preventDefault();
+            first.focus();
+        }
+    };
     return (_jsxs("div", { className: "bg-background text-foreground h-screen overflow-hidden", style: isDesktop
             ? { display: 'grid', gridTemplateColumns: 'auto minmax(0, 1fr)' }
-            : { display: 'block', position: 'relative' }, children: [_jsx("a", { className: "prenta-skip-link", href: "#prenta-main", children: "Skip to content" }), !isDesktop && mobileSidebarOpen && (_jsx("div", { "aria-hidden": true, className: "fixed inset-0 z-40 bg-black/30 backdrop-blur-sm", onClick: onMobileSidebarClose })), _jsx("div", { className: "z-50", style: isDesktop
+            : { display: 'block', position: 'relative' }, children: [_jsx("a", { ref: skipRef, className: "prenta-skip-link", href: "#prenta-main", children: "Skip to content" }), !isDesktop && mobileSidebarOpen && (_jsx("div", { "aria-hidden": true, className: "fixed inset-0 z-40 bg-black/30 backdrop-blur-sm", onClick: onMobileSidebarClose })), _jsxs("div", { ref: sidebarRef, id: DRAWER_ID, 
+                // Below the desktop breakpoint the open sidebar is a modal drawer.
+                role: drawerOpen ? 'dialog' : undefined, "aria-modal": drawerOpen ? true : undefined, "aria-label": drawerOpen ? 'Navigation' : undefined, tabIndex: drawerOpen ? -1 : undefined, onKeyDown: onDrawerKeyDown, 
+                // A class, not an inline transition, so the in-app Reduce motion
+                // setting (and prefers-reduced-motion) can stop the slide.
+                className: `z-50 outline-none ${isDesktop ? '' : 'motion-safe:transition-transform motion-safe:duration-300 motion-safe:ease-out'}`, style: isDesktop
                     ? {
                         gridColumn: '1 / 2',
                         height: '100vh',
@@ -43,9 +145,15 @@ export function AdminShell({ sidebar, header, breadcrumbs, children, mobileSideb
                         bottom: 0,
                         left: 0,
                         transform: mobileSidebarOpen ? 'translateX(0)' : 'translateX(-100%)',
-                        transition: 'transform 300ms ease',
-                    }, children: sidebar }), _jsxs("div", { className: "flex flex-col overflow-hidden", style: isDesktop
+                    }, children: [!isDesktop && onMobileSidebarClose ? (_jsx("button", { type: "button", onClick: onMobileSidebarClose, "aria-label": "Close navigation", className: "rounded-7 text-sub hover:bg-acc-l hover:text-acc prenta-touch-target absolute top-2.5 right-2.5 z-[1] flex h-9 w-9 cursor-pointer items-center justify-center border-0 bg-transparent p-0", children: _jsx(X, { className: "h-4 w-4", strokeWidth: 1.75, "aria-hidden": true }) })) : null, sidebar] }), _jsxs("div", { ref: contentRef, className: "flex flex-col overflow-hidden", style: isDesktop
                     ? { gridColumn: '2 / 3', height: '100vh', minWidth: 0 }
-                    : { height: '100vh', minWidth: 0 }, children: [header, breadcrumbs, _jsx("main", { id: "prenta-main", className: "min-h-0 flex-1 overflow-y-auto", children: children })] })] }));
+                    : { height: '100vh', minWidth: 0 }, children: [header, breadcrumbs, _jsx("main", { id: "prenta-main", className: "relative min-h-0 flex-1 scroll-pb-[84px] overflow-x-hidden overflow-y-auto", style: !isDesktop && tabBar
+                            ? {
+                                // --fab-clear: room for a floating action button
+                                // (responsive.css sets it while the page has one).
+                                paddingBottom: 'calc(var(--tabbar-h) + env(safe-area-inset-bottom) + var(--fab-clear, 0px))',
+                                scrollPaddingBottom: 'calc(84px + var(--tabbar-h) + env(safe-area-inset-bottom))',
+                            }
+                            : undefined, children: children })] }), !isDesktop && tabBar ? _jsx("div", { ref: tabBarRef, children: tabBar }) : null] }));
 }
 //# sourceMappingURL=AdminShell.js.map

package/dist/layout/primitives/AdminShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdminShell.js","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AA0B3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,iBAAiB,GAAG,KAAK,EACzB,oBAAoB,EACpB,iBAAiB,GAAG,GAAG,GACP;IAChB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAM;QACzC,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,iBAAiB,KAAK,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;QAC9C,OAAO,EAAE,CAAA;QACT,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACtC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,OAAO,CACL,eACE,SAAS,EAAC,wDAAwD,EAClE,KAAK,EACH,SAAS;YACP,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,qBAAqB,EAAE;YACjE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAShD,YAAG,SAAS,EAAC,kBAAkB,EAAC,IAAI,EAAC,cAAc,gCAE/C,EAEH,CAAC,SAAS,IAAI,iBAAiB,IAAI,CAClC,mCAEE,SAAS,EAAC,iDAAiD,EAC3D,OAAO,EAAE,oBAAoB,GAC7B,CACH,EAED,cACE,SAAS,EAAC,MAAM,EAChB,KAAK,EACH,SAAS;oBACP,CAAC,CAAC;wBACE,UAAU,EAAE,OAAO;wBACnB,MAAM,EAAE,OAAO;wBACf,QAAQ,EAAE,QAAQ;qBACnB;oBACH,CAAC,CAAC;wBACE,QAAQ,EAAE,OAAO;wBACjB,GAAG,EAAE,CAAC;wBACN,MAAM,EAAE,CAAC;wBACT,IAAI,EAAE,CAAC;wBACP,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB;wBACpE,UAAU,EAAE,sBAAsB;qBACnC,YAGN,OAAO,GACJ,EAEN,eACE,SAAS,EAAC,+BAA+B,EACzC,KAAK,EACH,SAAS;oBACP,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACvD,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,aAGrC,MAAM,EACN,WAAW,EACZ,eAAM,EAAE,EAAC,aAAa,EAAC,SAAS,EAAC,gCAAgC,YAC9D,QAAQ,GACJ,IACH,IACF,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"AdminShell.js","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":"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"}

package/dist/layout/topbar-classes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The kit's topbar icon button (`.icbtn`, SHELL.md §3): 34×34, radius 8,
+ * `--sub`, hover `--acc-l` / `--acc`; 44×44 below 769px (cms-layouts.css) and
+ * at least 44px on touch screens (`.prenta-touch-target`). `relative` so the
+ * bell's unread dot can sit in its corner.
+ */
+export declare const TOPBAR_ICON_BUTTON = "rounded-8 text-sub hover:bg-acc-l hover:text-acc prenta-touch-target relative flex h-[34px] w-[34px] shrink-0 cursor-pointer items-center justify-center border-0 bg-transparent p-0 mobile:h-11 mobile:w-11";
+//# sourceMappingURL=topbar-classes.d.ts.map

package/dist/layout/topbar-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topbar-classes.d.ts","sourceRoot":"","sources":["../../src/layout/topbar-classes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iNACiL,CAAA"}

package/dist/layout/topbar-classes.js

@@ -0,0 +1,8 @@
+/**
+ * The kit's topbar icon button (`.icbtn`, SHELL.md §3): 34×34, radius 8,
+ * `--sub`, hover `--acc-l` / `--acc`; 44×44 below 769px (cms-layouts.css) and
+ * at least 44px on touch screens (`.prenta-touch-target`). `relative` so the
+ * bell's unread dot can sit in its corner.
+ */
+export const TOPBAR_ICON_BUTTON = 'rounded-8 text-sub hover:bg-acc-l hover:text-acc prenta-touch-target relative flex h-[34px] w-[34px] shrink-0 cursor-pointer items-center justify-center border-0 bg-transparent p-0 mobile:h-11 mobile:w-11';
+//# sourceMappingURL=topbar-classes.js.map

package/dist/layout/topbar-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topbar-classes.js","sourceRoot":"","sources":["../../src/layout/topbar-classes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,8MAA8M,CAAA"}

package/dist/layout/use-nav-items.d.ts

@@ -0,0 +1,10 @@
+import { type NavItem } from './nav-config.js';
+/**
+ * The nav tree with live Forms counts. Counts refresh on mount and whenever a
+ * forms/entries mutation fires the shared event (mark read, archive, notify
+ * toggle, …). Best-effort: a failed fetch keeps the last known value rather
+ * than surfacing an error in nav. Pass `enabled: false` to skip the fetch when
+ * the caller already has the items.
+ */
+export declare function useNavItems(config: any, enabled?: boolean): NavItem[];
+//# sourceMappingURL=use-nav-items.d.ts.map

package/dist/layout/use-nav-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-items.d.ts","sourceRoot":"","sources":["../../src/layout/use-nav-items.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,UAAO,GAAG,OAAO,EAAE,CAyBlE"}

package/dist/layout/use-nav-items.js

@@ -0,0 +1,39 @@
+'use client';
+import { useEffect, useMemo, useState } from 'react';
+import { fetchFormsSidebarCounts } from '../lib/forms-service.js';
+import { onFormsChanged } from '../lib/forms-events.js';
+import { applyFormsNav, buildNavItems } from './nav-config.js';
+/**
+ * The nav tree with live Forms counts. Counts refresh on mount and whenever a
+ * forms/entries mutation fires the shared event (mark read, archive, notify
+ * toggle, …). Best-effort: a failed fetch keeps the last known value rather
+ * than surfacing an error in nav. Pass `enabled: false` to skip the fetch when
+ * the caller already has the items.
+ */
+export function useNavItems(config, enabled = true) {
+    const [forms, setForms] = useState([]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let active = true;
+        const load = () => {
+            fetchFormsSidebarCounts()
+                .then((counts) => {
+                // A malformed response must not break the nav.
+                if (active && Array.isArray(counts))
+                    setForms(counts);
+            })
+                .catch(() => {
+                /* keep the last known value; nav must never break on a fetch error */
+            });
+        };
+        load();
+        const off = onFormsChanged(load);
+        return () => {
+            active = false;
+            off();
+        };
+    }, [enabled]);
+    return useMemo(() => applyFormsNav(buildNavItems(config), forms), [config, forms]);
+}
+//# sourceMappingURL=use-nav-items.js.map

package/dist/layout/use-nav-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nav-items.js","sourceRoot":"","sources":["../../src/layout/use-nav-items.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAA0B,MAAM,yBAAyB,CAAA;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAgB,MAAM,iBAAiB,CAAA;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAW,EAAE,OAAO,GAAG,IAAI;IACrD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAsB,EAAE,CAAC,CAAA;IAE3D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,MAAM,GAAG,IAAI,CAAA;QACjB,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,uBAAuB,EAAE;iBACtB,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACf,+CAA+C;gBAC/C,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YACvD,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,sEAAsE;YACxE,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QACD,IAAI,EAAE,CAAA;QACN,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAA;YACd,GAAG,EAAE,CAAA;QACP,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AACpF,CAAC"}

package/dist/lib/api.d.ts

@@ -22,6 +22,14 @@ export interface CmsApiResult<T> {
      * `/seo/autopilot/applied/:id/revert`). Callers must narrow it themselves.
      */
     errorBody?: unknown;
+    /**
+     * The parsed 2xx body, for the few endpoints that send fields beside `data`
+     * (e.g. a job review decision's `documentStatus` and `notice`). Callers must
+     * narrow it themselves.
+     */
+    body?: unknown;
+    /** The response's `ETag`, for endpoints that take `If-Match` on the next write. */
+    etag?: string;
     status: number;
 }
 export declare function cmsApi<T = unknown>(endpoint: string, options?: RequestInit): Promise<CmsApiResult<T>>;

package/dist/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,QAEtC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAmBD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAcD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA2C1B"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,QAEtC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAmBD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAcD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAoD1B"}

package/dist/lib/api.js

@@ -86,6 +86,8 @@ export async function cmsApi(endpoint, options = {}) {
     try {
         const res = await fetch(url, { ...options, headers, credentials: 'include' });
         const json = await res.json().catch(() => ({}));
+        // Test doubles often stub `fetch` with a bare `{ ok, json }`.
+        const etag = typeof res.headers?.get === 'function' ? (res.headers.get('ETag') ?? undefined) : undefined;
         if (!res.ok) {
             return {
                 error: json.error || `Request failed (${res.status})`,
@@ -94,7 +96,12 @@ export async function cmsApi(endpoint, options = {}) {
                 status: res.status,
             };
         }
-        return { data: json.data ?? json, status: res.status };
+        return {
+            data: json.data ?? json,
+            body: json,
+            status: res.status,
+            ...(etag ? { etag } : {}),
+        };
     }
     catch (err) {
         return { error: err instanceof Error ? err.message : 'Network error', status: 0 };

package/dist/lib/api.js.map

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

package/dist/lib/appearance-api.d.ts

@@ -1,9 +1,11 @@
-import { type BrandAssetLike, type BrandSettings, type ColorMode, type LogoShape, type SidebarDensity } from '@prenta/core/appearance';
+import { type BrandAssetLike, type BrandSettings, type ColorMode, type LightBase, type LogoShape, type SidebarDensity } from '@prenta/core/appearance';
 import type { AdminBrandCache, AppearanceSnapshot } from '../components/ThemeProvider.js';
 /** GET /appearance response shape (admin Appearance tab + boot hydration). */
 export interface AppearanceApiResponse {
     appearance: {
         adminColorModeDefault: ColorMode;
+        /** Absent on servers that predate the Linen base; treat as Porcelain. */
+        adminLightBase?: LightBase;
         adminAccentColor: string;
         sidebarDensity: SidebarDensity;
         contentFont: string;

package/dist/lib/appearance-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appearance-api.d.ts","sourceRoot":"","sources":["../../src/lib/appearance-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEzF,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE;QACV,qBAAqB,EAAE,SAAS,CAAA;QAChC,gBAAgB,EAAE,MAAM,CAAA;QACxB,cAAc,EAAE,cAAc,CAAA;QAC9B,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,OAAO,CAAA;QACrB,WAAW,CAAC,EAAE;YACZ,MAAM,CAAC,EAAE,MAAM,CAAA;YACf,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAA;IACD,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE;QAAE,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IACzC,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;CACjB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAa5F;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,eAAe,CAcjB;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CAWvF"}
+{"version":3,"file":"appearance-api.d.ts","sourceRoot":"","sources":["../../src/lib/appearance-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEzF,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE;QACV,qBAAqB,EAAE,SAAS,CAAA;QAChC,yEAAyE;QACzE,cAAc,CAAC,EAAE,SAAS,CAAA;QAC1B,gBAAgB,EAAE,MAAM,CAAA;QACxB,cAAc,EAAE,cAAc,CAAA;QAC9B,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,OAAO,CAAA;QACrB,WAAW,CAAC,EAAE;YACZ,MAAM,CAAC,EAAE,MAAM,CAAA;YACf,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAA;IACD,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE;QAAE,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IACzC,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;CACjB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAa5F;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,eAAe,CAcjB;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CAYvF"}

package/dist/lib/appearance-api.js

@@ -32,6 +32,7 @@ export function appearanceApiToSnapshot(data) {
     const assets = parseAppearanceAssets(data.assets);
     return {
         theme: data.appearance.adminColorModeDefault,
+        lightBase: data.appearance.adminLightBase === 'linen' ? 'linen' : 'porcelain',
         accent: data.appearance.adminAccentColor,
         density: data.appearance.sidebarDensity,
         font: data.appearance.contentFont,

package/dist/lib/appearance-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"appearance-api.js","sourceRoot":"","sources":["../../src/lib/appearance-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAMlB,MAAM,yBAAyB,CAAA;AAoChC,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,MAAM,IAAI,GAAiC,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG;YACX,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,GAAG,EAAE,CAAC,CAAC,SAAS;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;YAC7B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;SACtE,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,MAAoC,EACpC,SAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/B,CAAC,CAAC,EAAE;QACJ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACvF,CAAC,CACH,CAAA;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAA;IACzD,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI;QACzC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI;QACnC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CAAC,IAA2B;IACjE,MAAM,KAAK,GAAkB,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,oBAAoB,EAAE,CAAA;IAC9F,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,qBAAqB;QAC5C,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,gBAAgB;QACxC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc;QACvC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;QACjC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;QAC1C,UAAU,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;KACrE,CAAA;AACH,CAAC"}
+{"version":3,"file":"appearance-api.js","sourceRoot":"","sources":["../../src/lib/appearance-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAOlB,MAAM,yBAAyB,CAAA;AAsChC,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,MAAM,IAAI,GAAiC,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG;YACX,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,GAAG,EAAE,CAAC,CAAC,SAAS;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;YAC7B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;SACtE,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,MAAoC,EACpC,SAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/B,CAAC,CAAC,EAAE;QACJ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACvF,CAAC,CACH,CAAA;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAA;IACzD,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI;QACzC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI;QACnC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CAAC,IAA2B;IACjE,MAAM,KAAK,GAAkB,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,oBAAoB,EAAE,CAAA;IAC9F,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,qBAAqB;QAC5C,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;QAC7E,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,gBAAgB;QACxC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc;QACvC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;QACjC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;QAC1C,UAAU,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;KACrE,CAAA;AACH,CAAC"}

package/dist/lib/batch-wizard.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The New batch AI job wizard (jobs-new.jsx, TRACKING P-20): its sources,
+ * validation and request, kept apart from the component so they can be
+ * tested on their own. The server's rules are in cms-core `jobs/batch-ai.ts`
+ * and CONFLICTS.md §4 (P-16).
+ */
+import type { BatchAiEstimate, BatchAiPayload, BatchAiRequest, BatchAiTextField } from '@prenta/core';
+import { JOB_OPS } from './job-view.js';
+export type BatchOperation = BatchAiPayload['operation'];
+export type BatchOp = (typeof JOB_OPS)[number];
+/** Where a batch runs: a page or post collection, or the media library. */
+export interface BatchSource {
+    /** The collection's key in the config, or `media`. */
+    id: string;
+    /** The kit's Content select label ("Posts", "Media library"). */
+    label: string;
+}
+export declare const MEDIA_SOURCE: BatchSource;
+/**
+ * Documents picked in a list (P-21's "Run with AI…"). They run as they are,
+ * without the operation's "Only where" preset.
+ */
+export interface BatchSelection {
+    /** A collection key, or `media` for images picked in the media library. */
+    source: string;
+    documentIds: string[];
+}
+export declare const INSTRUCTION_MAX = 2000;
+/**
+ * The fields a custom instruction can rewrite. `field` isn't in the kit's
+ * contract; it's the kit's "Field you choose" (CONFLICTS.md §4, P-16).
+ */
+export declare const CUSTOM_FIELDS: ReadonlyArray<{
+    id: BatchAiTextField;
+    label: string;
+}>;
+export declare function batchOp(id: BatchOperation): BatchOp;
+/**
+ * The Content select's options: the config's page and post collections, in
+ * config order, without hidden ones (as Settings → AI's brand voice lists
+ * them). The media library is added for alt text only.
+ */
+export declare function batchSources(config: unknown): BatchSource[];
+/** cms-core's `ADMIN_ROLES`: who may queue a batch that applies changes automatically. */
+export declare function isAdminRole(role: string | null | undefined): boolean;
+/** Alt text runs on images; every other operation on a collection. */
+export declare function runsOnMedia(operation: BatchOperation): boolean;
+/** Whether an operation can run on a picked selection's source. */
+export declare function operationFits(operation: BatchOperation, selection: BatchSelection | null): boolean;
+/** Everything the wizard asks, before it becomes a request. */
+export interface BatchDraft {
+    operation: BatchOperation;
+    instruction: string;
+    field: BatchAiTextField;
+    /** The collection picked in the Content select (ignored for alt text). */
+    collection: string;
+    statusFilter: 'published' | 'all';
+    review: 'review' | 'auto';
+    onApprove: 'draft' | 'publish';
+    selection: BatchSelection | null;
+}
+/** Step 1's check: a custom instruction needs more than 8 characters (the server's message). */
+export declare function instructionError(operation: BatchOperation, instruction: string): string | null;
+/**
+ * The request for estimate, preview and create. "Apply automatically" never
+ * publishes (the server refuses it), so it always sends `draft`.
+ */
+export declare function batchRequest(draft: BatchDraft): BatchAiRequest;
+/**
+ * The fields that change which documents match, or what the AI writes. An
+ * estimate or preview is stale once its key differs from the draft's.
+ */
+export declare function estimateKey(request: BatchAiRequest): string;
+export declare function previewKey(request: BatchAiRequest): string;
+/** Why step 2 can't continue: nothing matches, or more than a batch holds. Null when it can. */
+export declare function matchProblem(estimate: BatchAiEstimate): string | null;
+/** The estimate tiles: "~42 min" and "~38k tokens", as the kit rounds them. */
+export declare function estimateTiles(estimate: BatchAiEstimate): {
+    minutes: string;
+    tokens: string;
+};
+/** The line under the tiles. The limit sentence is left out when Settings → AI sets none. */
+export declare function estimateNote(estimate: BatchAiEstimate): string;
+//# sourceMappingURL=batch-wizard.d.ts.map

package/dist/lib/batch-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-wizard.d.ts","sourceRoot":"","sources":["../../src/lib/batch-wizard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9C,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,YAAY,EAAE,WAAqD,CAAA;AAEhF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAID,eAAO,MAAM,eAAe,OAAO,CAAA;AAInC;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIhF,CAAA;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAEnD;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAY3D;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpE;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAC3B,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,cAAc,GAAG,IAAI,GAC/B,OAAO,CAGT;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,cAAc,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,gBAAgB,CAAA;IACvB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,WAAW,GAAG,KAAK,CAAA;IACjC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAA;IACzB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,SAAS,EAAE,cAAc,GAAG,IAAI,CAAA;CACjC;AAOD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAY9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAO3D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAMrE;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK5F;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAM9D"}

package/dist/lib/batch-wizard.js

@@ -0,0 +1,122 @@
+import { JOB_OPS } from './job-view.js';
+export const MEDIA_SOURCE = { id: 'media', label: 'Media library' };
+/** A custom instruction needs more than 8 characters, and at most 2,000. */
+const INSTRUCTION_MIN = 9;
+export const INSTRUCTION_MAX = 2000;
+/** The most documents one batch freezes. */
+const BATCH_MAX = 1000;
+/**
+ * The fields a custom instruction can rewrite. `field` isn't in the kit's
+ * contract; it's the kit's "Field you choose" (CONFLICTS.md §4, P-16).
+ */
+export const CUSTOM_FIELDS = [
+    { id: 'metaDescription', label: 'Meta description' },
+    { id: 'seoTitle', label: 'SEO title' },
+    { id: 'excerpt', label: 'Excerpt' },
+];
+export function batchOp(id) {
+    return JOB_OPS.find((op) => op.id === id) ?? JOB_OPS[0];
+}
+/**
+ * The Content select's options: the config's page and post collections, in
+ * config order, without hidden ones (as Settings → AI's brand voice lists
+ * them). The media library is added for alt text only.
+ */
+export function batchSources(config) {
+    const raw = config?.collections;
+    if (!raw || typeof raw !== 'object')
+        return [];
+    const entries = Array.isArray(raw)
+        ? raw.map((c) => [c.slug ?? '', c])
+        : Object.entries(raw);
+    return entries
+        .filter(([key, c]) => key && (c.type === 'page' || c.type === 'post') && !c.admin?.hidden)
+        .map(([key, c]) => ({
+        id: key,
+        label: c.labels?.plural ?? key.charAt(0).toUpperCase() + key.slice(1),
+    }));
+}
+/** cms-core's `ADMIN_ROLES`: who may queue a batch that applies changes automatically. */
+export function isAdminRole(role) {
+    return role === 'OWNER' || role === 'ADMIN';
+}
+/** Alt text runs on images; every other operation on a collection. */
+export function runsOnMedia(operation) {
+    return operation === 'alt';
+}
+/** Whether an operation can run on a picked selection's source. */
+export function operationFits(operation, selection) {
+    if (!selection)
+        return true;
+    return runsOnMedia(operation) === (selection.source === MEDIA_SOURCE.id);
+}
+/** The source a draft runs on: the media library for alt text, else its collection. */
+function draftSource(draft) {
+    return runsOnMedia(draft.operation) ? MEDIA_SOURCE.id : draft.collection;
+}
+/** Step 1's check: a custom instruction needs more than 8 characters (the server's message). */
+export function instructionError(operation, instruction) {
+    if (operation !== 'custom')
+        return null;
+    return instruction.trim().length < INSTRUCTION_MIN
+        ? 'A custom instruction needs more than 8 characters.'
+        : null;
+}
+/**
+ * The request for estimate, preview and create. "Apply automatically" never
+ * publishes (the server refuses it), so it always sends `draft`.
+ */
+export function batchRequest(draft) {
+    const instruction = draft.instruction.trim();
+    return {
+        operation: draft.operation,
+        source: draft.selection?.source ?? draftSource(draft),
+        statusFilter: draft.statusFilter,
+        review: draft.review,
+        onApprove: draft.review === 'auto' ? 'draft' : draft.onApprove,
+        instruction: instruction || null,
+        ...(draft.operation === 'custom' ? { field: draft.field } : {}),
+        ...(draft.selection ? { filter: { documentIds: draft.selection.documentIds } } : {}),
+    };
+}
+/**
+ * The fields that change which documents match, or what the AI writes. An
+ * estimate or preview is stale once its key differs from the draft's.
+ */
+export function estimateKey(request) {
+    return JSON.stringify([
+        request.operation,
+        request.source,
+        request.statusFilter,
+        request.filter?.documentIds ?? null,
+    ]);
+}
+export function previewKey(request) {
+    return JSON.stringify([estimateKey(request), request.instruction, request.field ?? null]);
+}
+/** Why step 2 can't continue: nothing matches, or more than a batch holds. Null when it can. */
+export function matchProblem(estimate) {
+    if (estimate.count === 0)
+        return 'No documents match this filter.';
+    if (estimate.count > BATCH_MAX) {
+        return `This matches ${estimate.count.toLocaleString('en-US')} documents. Narrow it to ${BATCH_MAX.toLocaleString('en-US')} or fewer.`;
+    }
+    return null;
+}
+/** The estimate tiles: "~42 min" and "~38k tokens", as the kit rounds them. */
+export function estimateTiles(estimate) {
+    return {
+        minutes: `~${estimate.minutes.toLocaleString('en-US')} min`,
+        tokens: `~${Math.round(estimate.tokens / 1000).toLocaleString('en-US')}k tokens`,
+    };
+}
+/** The line under the tiles. The limit sentence is left out when Settings → AI sets none. */
+export function estimateNote(estimate) {
+    const pace = 'One document per slice, about one a minute.';
+    const pct = estimate.pctOfMonthlyLimit;
+    if (pct === null)
+        return pace;
+    const share = pct === 0 && estimate.tokens > 0 ? 'under 1' : String(pct);
+    return `${pace} That’s ${share}% of this month’s AI limit.`;
+}
+//# sourceMappingURL=batch-wizard.js.map

package/dist/lib/batch-wizard.js.map

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