@kywi-software/core 0.1.0 → 0.2.0

package/dist/admin/nav.js

@@ -1,90 +1,47 @@
-export function buildAdminNav(_config) {
-    return [
-        { label: 'Dashboard', href: '/admin/dashboard', icon: 'layout-dashboard' },
-        { label: 'Site Tree', href: '/admin/content-tree', icon: 'git-branch' },
-        { label: 'Approvals', href: '/admin/approvals', icon: 'check-circle' },
-        { label: 'Changesets', href: '/admin/changesets', icon: 'layers' },
-        { label: 'Search', href: '/admin/search', icon: 'search' },
-        {
-            label: 'Media',
-            href: '/admin/media',
-            icon: 'image',
-            children: [
-                { label: 'Library', href: '/admin/media' },
-                { label: 'Upload', href: '/admin/media/upload' },
-            ],
-        },
-        {
-            label: 'Users',
-            href: '/admin/users',
-            icon: 'users',
-            children: [
-                { label: 'All Users', href: '/admin/users' },
-                { label: 'Groups', href: '/admin/users/groups' },
-                { label: 'Permissions', href: '/admin/users/permissions' },
-            ],
-        },
-        {
-            label: 'Forms',
-            href: '/admin/forms',
-            icon: 'clipboard',
-            children: [
-                { label: 'All Forms', href: '/admin/forms' },
-                { label: 'Submissions', href: '/admin/forms/submissions' },
-            ],
-        },
-        { label: 'Categories', href: '/admin/categories', icon: 'folder-tree' },
-        { label: 'Tags', href: '/admin/tags', icon: 'tag' },
-        { label: 'Trash', href: '/admin/trash', icon: 'trash-2' },
-        { label: 'Comments', href: '/admin/comments', icon: 'message-square' },
-        { label: 'Translations', href: '/admin/translations', icon: 'languages' },
-        { label: 'Feeds', href: '/admin/feeds', icon: 'rss' },
-        {
-            label: 'Audiences',
-            href: '/admin/audiences',
-            icon: 'target',
-            children: [
-                { label: 'All Audiences', href: '/admin/audiences' },
-                { label: 'Self-ID Fields', href: '/admin/audiences/fields' },
-                { label: 'Self-ID Widget', href: '/admin/audiences/self-id-widget' },
-                { label: 'Preview Tokens', href: '/admin/audiences/preview-tokens' },
-            ],
-        },
-        { label: 'Experiments', href: '/admin/experiments', icon: 'flask-conical' },
-        { label: 'Layouts', href: '/admin/layouts', icon: 'layout' },
-        {
-            label: 'Extensions',
-            href: '/admin/extensions',
-            icon: 'blocks',
-            children: [
-                { label: 'All Extensions', href: '/admin/extensions' },
-                { label: 'Import / Export', href: '/admin/extensions/import-export' },
-            ],
-        },
-        { label: 'Plugins', href: '/admin/plugins', icon: 'puzzle' },
-        {
-            label: 'Web Services',
-            href: '/admin/web-services',
-            icon: 'globe',
-            children: [
-                { label: 'OAuth Clients', href: '/admin/web-services/oauth' },
-                { label: 'API Keys', href: '/admin/web-services/api-keys' },
-            ],
-        },
-        {
-            label: 'Settings',
-            href: '/admin/settings',
-            icon: 'settings',
-            children: [
-                { label: 'General', href: '/admin/settings' },
-                { label: 'Site Settings', href: '/admin/settings/site' },
-                { label: 'Sites', href: '/admin/settings/sites' },
-                { label: 'Cache', href: '/admin/settings/cache' },
-                { label: 'Email', href: '/admin/settings/email' },
-                { label: 'Agent Experience', href: '/admin/settings/ax' },
-                { label: 'Content Types', href: '/admin/content-types' },
-            ],
-        },
-    ];
+import { ADMIN_SURFACES, ADMIN_NAV_GROUPS, } from './registry.js';
+import { isSurfaceVisible } from './surface-matcher.js';
+function patternToHref(pattern) {
+    return `/admin/${pattern}`;
+}
+/**
+ * Build the admin sidebar nav, DERIVED from the surface registry (T1).
+ *
+ * Back-compat lynchpin: with a config that carries no `admin` block and no
+ * `opts`, this reproduces the previous hard-coded tree byte-for-byte (same
+ * labels/hrefs/icons/order/nesting) — the existing export signature and return
+ * shape are unchanged so `shell.tsx` and all importers keep working.
+ *
+ * Filtering precedence: config ceiling (`config.admin`) ∧ runtime flags (opts)
+ * ∧ role (opts). A group header renders iff ≥1 of its child surfaces survives.
+ */
+export function buildAdminNav(config, opts) {
+    const ceiling = config.admin;
+    const role = opts?.role;
+    const flags = opts?.flags;
+    const topNodes = [];
+    // Top-level leaf surfaces (nav present, no parentId).
+    for (const surface of ADMIN_SURFACES) {
+        if (!surface.nav || surface.nav.parentId)
+            continue;
+        if (!isSurfaceVisible(surface, ceiling, flags, role))
+            continue;
+        const item = { label: surface.label, href: patternToHref(surface.pattern) };
+        if (surface.nav.icon)
+            item.icon = surface.nav.icon;
+        topNodes.push({ order: surface.nav.order, item });
+    }
+    // Nav groups — rendered iff at least one child surface survives.
+    for (const group of ADMIN_NAV_GROUPS) {
+        const children = ADMIN_SURFACES.filter(s => s.nav?.parentId === group.id && isSurfaceVisible(s, ceiling, flags, role))
+            .sort((a, b) => a.nav.order - b.nav.order)
+            .map(s => ({ label: s.label, href: patternToHref(s.pattern) }));
+        if (children.length === 0)
+            continue;
+        topNodes.push({
+            order: group.order,
+            item: { label: group.label, href: group.href, icon: group.icon, children },
+        });
+    }
+    return topNodes.sort((a, b) => a.order - b.order).map(n => n.item);
 }
 //# sourceMappingURL=nav.js.map

package/dist/admin/nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"nav.js","sourceRoot":"","sources":["../../src/admin/nav.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,OAAO;QACL,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE;QAC1E,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,YAAY,EAAE;QACvE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;QACtE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1D;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC1C,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,EAAE;aACjD;SACF;QACD;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC5C,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,EAAE;gBAChD,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,0BAA0B,EAAE;aAC3D;SACF;QACD;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC5C,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,0BAA0B,EAAE;aAC3D;SACF;QACD,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,EAAE;QACvE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE;QACnD,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzD,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE;QACtE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE;QACzE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;QACrD;YACE,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;gBACpD,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,yBAAyB,EAAE;gBAC5D,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,iCAAiC,EAAE;gBACpE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,iCAAiC,EAAE;aACrE;SACF;QACD,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE;QAC3E,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5D;YACE,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACtD,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,iCAAiC,EAAE;aACtE;SACF;QACD,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5D;YACE,KAAK,EAAE,cAAc;YACrB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,2BAA2B,EAAE;gBAC7D,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,8BAA8B,EAAE;aAC5D;SACF;QACD;YACE,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBAC7C,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,EAAE;gBACxD,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE;gBACjD,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE;gBACjD,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE;gBACjD,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,oBAAoB,EAAE;gBACzD,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,EAAE;aACzD;SACF;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../../src/admin/nav.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAiBvD,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,UAAU,OAAO,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,IAA2B;IAC3E,MAAM,OAAO,GAAI,MAAyC,CAAC,KAAK,CAAA;IAChE,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAA;IACvB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;IAEzB,MAAM,QAAQ,GAAiD,EAAE,CAAA;IAEjE,sDAAsD;IACtD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;YAAE,SAAQ;QAClD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;YAAE,SAAQ;QAC9D,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;QACzF,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA;QAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,iEAAiE;IACjE,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,KAAK,KAAK,CAAC,EAAE,IAAI,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAC/E;aACE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAI,CAAC,KAAK,CAAC;aAC3C,GAAG,CAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QACnC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE;SAC3E,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACpE,CAAC"}

package/dist/admin/primitives.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared presentational primitives for the admin surfaces, moved into core so
+ * migrated surfaces (T5–T13) and the e2e suite depend on ONE canonical copy.
+ *
+ * Ported verbatim (same names, same props, same markup/classes) from:
+ *  - `apps/reference/components/taxonomy-ui.tsx` — `slugify`, `Loading`,
+ *    `ErrorBox`, `EmptyState`, `Modal`, `ConfirmDialog`
+ *  - `apps/reference/components/admin-states.tsx` — `LoadingState`, `ErrorState`
+ *
+ * The JSON fetch layer that `taxonomy-ui.tsx` also re-exported (`apiGet`/
+ * `apiSend`) is intentionally NOT here — it moves into `@kywi-software/core/
+ * host-client` under T3. Surfaces source data helpers from there and primitives
+ * from here. All markup uses the shipped `kywi-*` admin design-system classes.
+ */
+import React from 'react';
+/** Derive a URL-safe slug from a human label. */
+export declare function slugify(input: string): string;
+export declare function Loading({ label }: {
+    label?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ErrorBox({ message, onRetry }: {
+    message: string;
+    onRetry?: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function EmptyState({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * `LoadingState` / `ErrorState` are the names the Web Services, Plugins,
+ * Extensions, Content-Types and Translations surfaces import (from the old
+ * `admin-states.tsx`). Their markup is byte-identical to `Loading`/`ErrorBox`,
+ * so they are exported as those components under the historical names to keep
+ * both call-site vocabularies working from one implementation.
+ */
+export declare const LoadingState: typeof Loading;
+export declare const ErrorState: typeof ErrorBox;
+export declare function Modal({ title, onClose, children, labelledBy, }: {
+    title: string;
+    onClose: () => void;
+    children: React.ReactNode;
+    labelledBy?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ConfirmDialog({ title, message, confirmLabel, danger, busy, onConfirm, onCancel, }: {
+    title: string;
+    message: React.ReactNode;
+    confirmLabel?: string;
+    danger?: boolean;
+    busy?: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/admin/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/admin/primitives.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAA;AAEhD,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAID,wBAAgB,OAAO,CAAC,EAAE,KAAkB,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAOjE;AAED,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,2CAWvF;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAErE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,gBAAU,CAAA;AACnC,eAAO,MAAM,UAAU,iBAAW,CAAA;AAIlC,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,OAAO,EACP,QAAQ,EACR,UAA+B,GAChC,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,2CA6CA;AAID,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,YAAuB,EACvB,MAAa,EACb,IAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB,2CAqCA"}

package/dist/admin/primitives.js

@@ -0,0 +1,78 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Shared presentational primitives for the admin surfaces, moved into core so
+ * migrated surfaces (T5–T13) and the e2e suite depend on ONE canonical copy.
+ *
+ * Ported verbatim (same names, same props, same markup/classes) from:
+ *  - `apps/reference/components/taxonomy-ui.tsx` — `slugify`, `Loading`,
+ *    `ErrorBox`, `EmptyState`, `Modal`, `ConfirmDialog`
+ *  - `apps/reference/components/admin-states.tsx` — `LoadingState`, `ErrorState`
+ *
+ * The JSON fetch layer that `taxonomy-ui.tsx` also re-exported (`apiGet`/
+ * `apiSend`) is intentionally NOT here — it moves into `@kywi-software/core/
+ * host-client` under T3. Surfaces source data helpers from there and primitives
+ * from here. All markup uses the shipped `kywi-*` admin design-system classes.
+ */
+import { useEffect, useRef } from 'react';
+/** Derive a URL-safe slug from a human label. */
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+// ── Presentational states ─────────────────────────────────────────────────────
+export function Loading({ label = 'Loading…' }) {
+    return (_jsxs("div", { className: "kywi-admin-loading", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "kywi-spinner", "aria-hidden": "true" }), _jsx("span", { children: label })] }));
+}
+export function ErrorBox({ message, onRetry }) {
+    return (_jsxs("div", { className: "kywi-admin-error", role: "alert", children: [_jsx("p", { className: "kywi-admin-error-message", children: message }), onRetry && (_jsx("button", { type: "button", className: "kywi-btn kywi-btn-secondary", onClick: onRetry, children: "Try again" }))] }));
+}
+export function EmptyState({ children }) {
+    return _jsx("div", { className: "kywi-admin-empty-state", children: children });
+}
+/**
+ * `LoadingState` / `ErrorState` are the names the Web Services, Plugins,
+ * Extensions, Content-Types and Translations surfaces import (from the old
+ * `admin-states.tsx`). Their markup is byte-identical to `Loading`/`ErrorBox`,
+ * so they are exported as those components under the historical names to keep
+ * both call-site vocabularies working from one implementation.
+ */
+export const LoadingState = Loading;
+export const ErrorState = ErrorBox;
+// ── Modal frame ───────────────────────────────────────────────────────────────
+export function Modal({ title, onClose, children, labelledBy = 'kywi-modal-title', }) {
+    const firstFieldRef = useRef(null);
+    useEffect(() => {
+        function onKey(e) {
+            if (e.key === 'Escape')
+                onClose();
+        }
+        window.addEventListener('keydown', onKey);
+        // Focus the first focusable control for keyboard users.
+        firstFieldRef.current?.querySelector('input, select, textarea, button')?.focus();
+        return () => window.removeEventListener('keydown', onKey);
+    }, [onClose]);
+    return (_jsx("div", { className: "kywi-admin-picker-overlay", onClick: (e) => {
+            if (e.target === e.currentTarget)
+                onClose();
+        }, children: _jsxs("div", { className: "kywi-admin-picker-modal", role: "dialog", "aria-modal": "true", "aria-labelledby": labelledBy, children: [_jsxs("div", { className: "kywi-admin-picker-header", children: [_jsx("span", { id: labelledBy, className: "kywi-admin-picker-title", children: title }), _jsx("button", { type: "button", className: "kywi-admin-picker-close", "aria-label": "Close", onClick: onClose, children: "\u00D7" })] }), _jsx("div", { ref: firstFieldRef, style: { padding: 'var(--kywi-space-5)' }, children: children })] }) }));
+}
+// ── Confirm dialog ─────────────────────────────────────────────────────────────
+export function ConfirmDialog({ title, message, confirmLabel = 'Delete', danger = true, busy = false, onConfirm, onCancel, }) {
+    useEffect(() => {
+        function onKey(e) {
+            if (e.key === 'Escape')
+                onCancel();
+        }
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [onCancel]);
+    return (_jsx("div", { className: "kywi-admin-picker-overlay", onClick: (e) => {
+            if (e.target === e.currentTarget)
+                onCancel();
+        }, children: _jsxs("div", { className: "kywi-confirm", role: "alertdialog", "aria-modal": "true", "aria-labelledby": "kywi-confirm-title", children: [_jsx("h2", { id: "kywi-confirm-title", className: "kywi-section-heading", children: title }), _jsx("div", { className: "kywi-admin-confirm-text", children: message }), _jsxs("div", { className: "kywi-admin-form-actions", children: [_jsx("button", { type: "button", className: "kywi-btn kywi-btn-secondary", onClick: onCancel, disabled: busy, children: "Cancel" }), _jsx("button", { type: "button", className: `kywi-btn ${danger ? 'kywi-btn-danger' : 'kywi-btn-primary'}`, onClick: onConfirm, disabled: busy, children: busy ? 'Working…' : confirmLabel })] })] }) }));
+}
+//# sourceMappingURL=primitives.js.map

package/dist/admin/primitives.js.map

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

package/dist/admin/registry.d.ts

@@ -0,0 +1,130 @@
+import type { ComponentType } from 'react';
+import type { KywiRole } from '../auth/roles.js';
+/**
+ * The canonical, typed admin surface registry — the single source of truth for
+ * every admin route, its config/flag/role gating granularity, and (from T5–T13
+ * onward) its lazily-loaded surface component.
+ *
+ * T1 status: FOUNDATION ONLY. This module reproduces every current admin route
+ * as a registry entry and drives the config-aware nav derivation + pure matcher.
+ * Real surface components are NOT migrated yet — see the `load` field note below.
+ */
+/**
+ * Feature-area taxonomy — the granularity at which config (`admin.features`) and
+ * runtime flags (`admin.features` site-settings key, T16) enable/disable admin.
+ * 22 areas.
+ */
+export type AdminArea = 'dashboard' | 'contentTree' | 'content' | 'approvals' | 'changesets' | 'search' | 'media' | 'users' | 'forms' | 'taxonomy' | 'trash' | 'comments' | 'translations' | 'feeds' | 'audiences' | 'experiments' | 'layouts' | 'extensions' | 'plugins' | 'webServices' | 'settings' | 'contentTypes';
+/** Runtime-checkable list of every area, in declaration order. */
+export declare const ADMIN_AREAS: readonly AdminArea[];
+/**
+ * Props every migrated surface component receives. `params` carries the matched
+ * pattern params (e.g. `{ type: 'page', id: 'abc' }` for `content/:type/:id`),
+ * replacing the old wrappers' `useParams()`.
+ */
+export interface SurfaceProps {
+    params: Record<string, string>;
+}
+/** Nav metadata for a surface that appears in the admin sidebar. */
+export interface AdminSurfaceNav {
+    /**
+     * Coarse section key for future grouped rendering. Does not affect the current
+     * flat/derived nav tree — kept for forward-compatibility.
+     */
+    section: string;
+    /** Sidebar icon (top-level leaves only; grouped child rows carry no icon). */
+    icon?: string;
+    /**
+     * Ordering slot. For a top-level leaf (no `parentId`), this is its position in
+     * the top-level list; for a grouped child row, its position within the group.
+     */
+    order: number;
+    /** Nav group id (see `ADMIN_NAV_GROUPS`) when this surface is a child row. */
+    parentId?: string;
+}
+/**
+ * A single admin surface = one migratable route (list/new/detail patterns each
+ * get their own entry, since each is a distinct component with its own lazy
+ * `load` thunk).
+ */
+export interface AdminSurface {
+    /** Stable unique id, e.g. `'media.upload'`. */
+    id: string;
+    /** Feature area — the config/flag gating bucket. */
+    area: AdminArea;
+    /**
+     * Path matcher, same `:param` / `*catchAll` style as `api/router.ts`
+     * (e.g. `'media/upload'`, `'content/:type/:id'`). No leading `/admin`.
+     */
+    pattern: string;
+    /**
+     * Canonical label. For nav-visible surfaces this IS the nav label (e.g.
+     * `'Library'`, `'All Users'`, `'General'`) so the derived nav reproduces the
+     * current tree; group *header* labels live on `ADMIN_NAV_GROUPS`.
+     */
+    label: string;
+    /** Present ⇒ surface is listed in the sidebar; absent ⇒ detail route (reachable, unlisted). */
+    nav?: AdminSurfaceNav;
+    /** Minimum role. Default `'editor'`; `settings`/`plugins` are `'siteAdmin'`. */
+    minRole: KywiRole;
+    /**
+     * Lazy loader for the surface component.
+     *
+     * T1 DEFERRAL: intentionally OPTIONAL and UNPOPULATED in T1. Phase 1 (T5–T13)
+     * populates each entry with a **static-literal** `import('./surfaces/<area>/<x>.js')`
+     * thunk — the T0 spike proved this literal form is what lets webpack/tsc emit
+     * one chunk per surface (a dynamically-built path defeats splitting). The
+     * matcher and nav derivation deliberately do NOT depend on `load` being set.
+     */
+    load?: () => Promise<{
+        default: ComponentType<SurfaceProps>;
+    }>;
+}
+/**
+ * A top-level nav group header (the container rows: Media, Users, Forms, …).
+ * These are NOT surfaces — they are pure sidebar structure. A group renders iff
+ * at least one of its child surfaces is enabled.
+ */
+export interface AdminNavGroup {
+    /** Group id, referenced by child surfaces' `nav.parentId`. */
+    id: string;
+    /** Header label, e.g. `'Media'`. */
+    label: string;
+    /**
+     * Header link target. Usually a child's landing path; for Web Services this is
+     * the bare `/admin/web-services` (no backing surface) — matching current nav.
+     */
+    href: string;
+    /** Header icon. */
+    icon: string;
+    /** Position in the top-level nav ordering (shared space with leaf surfaces). */
+    order: number;
+}
+/**
+ * The config-ceiling projection consulted by the matcher/nav/precedence helpers.
+ * T2 ships the canonical `admin` config block + `resolveAdminConfig`; its output
+ * is structurally assignable to this. Denylist semantics: omitted/true = on.
+ */
+export interface AdminConfigCeiling {
+    /** Master switch. `false` ⇒ no admin surfaces at all. */
+    enabled?: boolean;
+    /** Per-area denylist. Omitted/true = enabled; `false` = disabled. */
+    features?: Partial<Record<AdminArea, boolean>>;
+    /** Fine-grained surface-id denylist, e.g. `['media.upload']`. */
+    disableSurfaces?: string[];
+}
+/**
+ * Runtime feature-flag map (T16 storage). `areaOrSurfaceId -> boolean`; a missing
+ * entry means enabled (mirrors plugin activation's active-by-default). Typed
+ * placeholder in T1 — full storage/routes land in T16.
+ */
+export type AdminFeatureFlags = Record<string, boolean>;
+export declare const ADMIN_NAV_GROUPS: readonly AdminNavGroup[];
+export declare const ADMIN_SURFACES: readonly AdminSurface[];
+/**
+ * Surface id that the bare `/admin` index (empty path segments) resolves to.
+ * The generated catch-all redirects `/admin` → `/admin/dashboard`; the matcher
+ * mirrors that by resolving `[]` to this surface.
+ */
+export declare const ADMIN_INDEX_SURFACE_ID = "dashboard.index";
+//# sourceMappingURL=registry.d.ts.map

package/dist/admin/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/admin/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,aAAa,GACb,SAAS,GACT,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,OAAO,GACP,UAAU,GACV,cAAc,GACd,OAAO,GACP,WAAW,GACX,aAAa,GACb,SAAS,GACT,YAAY,GACZ,SAAS,GACT,aAAa,GACb,UAAU,GACV,cAAc,CAAA;AAElB,kEAAkE;AAClE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAuBlC,CAAA;AAIV;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,oDAAoD;IACpD,IAAI,EAAE,SAAS,CAAA;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,+FAA+F;IAC/F,GAAG,CAAC,EAAE,eAAe,CAAA;IACrB,gFAAgF;IAChF,OAAO,EAAE,QAAQ,CAAA;IACjB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAA;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9C,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIvD,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAQ3C,CAAA;AAQV,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EA6axC,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAA"}