@bison-lab/payload-core 3.17.0 → 3.19.0

package/README.md

@@ -18,14 +18,15 @@ and `react` are needed for its admin fields; `@bison-lab/ui` and
 Pin the plugin to the same version as `payload`; Payload releases them in
 lockstep.
 
-## Five entry points, and why
+## Six entry points, and why
 
 | Import                             | Contents                                                                                         | Runs where                                                                 |
 | ---------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| `@bison-lab/payload-core`          | `seoPlugin`, `createTheme`, `createBrandAssets`, `createRoles`, `createFeatures`, `createPages`, `createUsers`, `createMedia`, `adminOnlyApiTab`, `documentTitleActions`, `seedTheme`, `seedRoles`, `seedFeatures`, predicates, `lookField`, `colorTokenField`, import-map strings, title and text helpers, types | Node. What `payload.config.ts` imports; it loads the plugin. |
+| `@bison-lab/payload-core`          | `seoPlugin`, `createTheme`, `createBrandAssets`, `createRoles`, `createFeatures`, `createPages`, `createUsers`, `createMedia`, `createAdminNav`, `adminNav`, `createNavigation`, `adminOnlyApiTab`, `documentTitleActions`, `seedTheme`, `seedRoles`, `seedFeatures`, predicates, `lookField`, `colorTokenField`, import-map strings, title and text helpers, types | Node. What `payload.config.ts` imports; it loads the plugin. |
 | `@bison-lab/payload-core/metadata` | `pageMetadata`, the title helpers, the same types                                                | Server. What a page route imports; it does not load the plugin.            |
 | `@bison-lab/payload-core/theme`    | `getPublishedTheme`, `getPublishedIdentity`, `themeConfigFromDoc`, `themeHead`, `themeHeadFromDoc` | Server. What a root layout imports; it does not load the plugin or React.  |
-| `@bison-lab/payload-core/admin`    | Theme fields, the Roles and Features matrices, and the Users Roles checklist                     | Admin. Referenced by import-map string; `generate:importmap` writes it.    |
+| `@bison-lab/payload-core/navigation` | `getNavigation`, the Header and Footer slugs                                                  | Server. What a site header imports; it does not load the plugin or React.  |
+| `@bison-lab/payload-core/admin`    | Theme fields, the Roles and Features matrices, Admin nav, and the Users Roles checklist          | Admin. Referenced by import-map string; `generate:importmap` writes it.    |
 | `@bison-lab/payload-core/react`    | `ThemePreview` (legacy; Theme has no preview pane)                                               | Client. Kept so an older site import does not break.                       |
 
 ## What editors get
@@ -265,9 +266,11 @@ implicit — every catalogue feature, including ones not released. That
 row is visible only to a Developer, with every tick on and locked.
 Defaults ship in the package (Theme
 screens on Designer; Designer also has Users and Roles; Admin + Designer
-both store). A site may pass `extras` into `createRoles` — each extra
-is a slug, a display label, and default `grants` — and an Admin can add
-further custom rows and edit any row’s name. Seed slugs stay read-only.
+both store). An Admin may remove Admin, Designer, or Author after first
+run; only Developer stays. A site may pass `extras` into `createRoles` —
+each extra is a slug, a display label, and default `grants` — and an
+Admin can add further custom rows and edit any row’s name. Remaining
+seed slugs stay read-only.
 `canManageBrand` and the other predicates read the saved Global and fall
 back to that seed (plus extras). The package never writes `developer`
 onto a user row.
@@ -288,8 +291,8 @@ assets), and Users (Users, Roles). Features itself is not a row. The
 document API tab and Better Editor overlay settings are not rows either
 — they stay code-locked to Developer (`adminOnlyApiTab`,
 `developerOnlyAccess` / `hideUnlessDeveloper`). A site may pass `extras`
-into `createFeatures` — those rows appear only there, including a
-future Navigation global:
+into `createFeatures` — those rows appear only there, including the
+Navigation tick `createNavigation` reads:
 
 ```ts
 createFeatures({
@@ -298,10 +301,6 @@ createFeatures({
     { slug: "navigation", label: "Navigation" },
   ],
 });
-
-// On that Global:
-//   access: { update: canUseFeature("navigation") }
-// Drafts use the same Publish tick as Pages to go live.
 ```
 
 `canUseFeature(slug)` is true when the row is released and a held role
@@ -338,10 +337,67 @@ settings (Better Editor) take `developerOnlyAccess` and
 `hideUnlessDeveloper` on the site — the package does not add that
 plugin as a peer.
 
+## Admin nav
+
+Settings → Admin nav is Developer chrome, not a Features row. A Developer
+adds, renames, deletes, and drags group headers and the collections or
+globals under each. An Admin never opens the editor. Every login can read
+the document so the sidebar can paint. Save writes immediately.
+
+`adminNav()` sets `admin.components.Nav` to the package Nav. A consuming
+site must not write a Nav component. An empty document falls back to
+Payload's first-seen walk (collections, then globals, bucketed by
+`admin.group`). `group: false` stays off the sidebar. `resolveAdminNav`
+is the layout source so a later skin (SPI-10) does not invent a second
+one.
+
+```ts
+import { adminNav, createAdminNav } from "@bison-lab/payload-core";
+
+export default buildConfig({
+  plugins: [adminNav()],
+  globals: [createAdminNav(), createRoles(), createFeatures()],
+});
+```
+
+Then `payload generate:importmap` and `payload migrate:create`.
+
+## Header and Footer
+
+`createNavigation({ blocks })` returns two Globals so each has its own
+Save / Publish / drafts. Header keeps slug `navigation` and table `nav`
+so an existing one-document row does not move. Footer is
+`navigation-footer` / `navf` — short because nested footer arrays hit
+Postgres's 63-character identifier cap the same way `nav` did. Both sit
+in `admin.group: "Navigation"` until a Developer moves them from Admin
+nav. One Features tick (`navigation`, passed as a `createFeatures`
+extra). Publish still needs the Publish tick. `getNavigation({ payload,
+draft })` finds both and returns `{ header, footer }`.
+
+```ts
+import { createNavigation } from "@bison-lab/payload-core";
+import { getNavigation } from "@bison-lab/payload-core/navigation";
+
+globals: [
+  ...createNavigation({
+    blocks: [megaMenuBlock({ variants }), LinkBlock],
+    preview: () => "/preview",
+  }),
+];
+
+// In a site header — the /navigation entry keeps the SEO plugin off the layout.
+const { header, footer } = await getNavigation({ payload, draft });
+```
+
+A site that already stored footer columns on the `nav` document copies
+`footer.columns` onto the new global, then drops the footer fields from
+`nav`. Bar behaviour (hide on scroll, viewport, default panel width) is
+not this factory.
+
 ## No generated types
 
 The package cannot import a site's `payload-types`, so the shapes it reads
-(`SeoMeta`, `SeoImageDoc`, `SeoPage`, `ThemeDoc`, `RolesDoc`) are hand-written and
+(`SeoMeta`, `SeoImageDoc`, `SeoPage`, `ThemeDoc`, `RolesDoc`, `AdminNavDoc`, `NavigationDoc`) are hand-written and
 structural. A generated `Page`, `Media` or Theme Global is assignable to
 them; nothing carries an index signature, since an interface will not assign
 to a type that has one.
@@ -349,6 +405,7 @@ to a type that has one.
 ## Changing a field
 
 `noIndexField`, the plugin's own fields, the Theme Global fields, the
-Roles Global fields, and the brand-assets collection fields are columns
+Roles Global fields, the Admin nav fields, the Header and Footer fields,
+and the brand-assets collection fields are columns
 in every consuming site. A change to them is a schema change: say "run
 `payload migrate:create`" in the changeset.

package/dist/admin.d.mts

@@ -104,9 +104,9 @@ declare const LookField: TextFieldClientComponent;
 //#endregion
 //#region src/admin/roles-matrix-field.d.ts
 /**
- * Payload's array field: drag rank stays, add is for custom rows, seed
- * rows have no remove. Developer stays in the saved array and is shown
- * only to a Developer. Reset restores seed ticks and package labels.
+ * Payload's array field: drag rank stays, add is for custom rows.
+ * Developer has no remove, stays in the saved array, and is shown only
+ * to a Developer. Reset restores the package four and leaves extras.
  */
 declare const RolesMatrixField: ArrayFieldClientComponent;
 //#endregion
@@ -170,5 +170,42 @@ declare function DocumentCreateNew({
   path: string;
 }): react_jsx_runtime0.JSX.Element;
 //#endregion
-export { AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
+//#region src/admin-nav/types.d.ts
+interface AdminNavVisibleEntities {
+  collections?: readonly string[];
+  globals?: readonly string[];
+}
+//#endregion
+//#region src/admin/admin-nav.d.ts
+interface AdminNavProps {
+  visibleEntities?: AdminNavVisibleEntities;
+}
+/**
+ * Default admin sidebar. Reads the Admin nav Global and paints
+ * `resolveAdminNav`. SPI-10 may replace this component; it should keep
+ * calling that function so the document stays the one layout source.
+ */
+declare function AdminNav({
+  visibleEntities
+}: AdminNavProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/admin/admin-nav-row-label.d.ts
+/**
+ * Array row header. Shows the group label, or “Group” when empty.
+ */
+declare function AdminNavRowLabel(): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/admin/admin-nav-entity-field.d.ts
+/**
+ * A select of collections or globals from this site's config. Type on the
+ * sibling row decides which list. `group: false` stays off — those entities
+ * are not on the sidebar.
+ */
+declare function AdminNavEntityField({
+  path
+}: {
+  path: string;
+}): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AdminNav, AdminNavEntityField, AdminNavRowLabel, AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
 //# sourceMappingURL=admin.d.mts.map

package/dist/admin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.mts","names":[],"sources":["../src/admin/color-field.tsx","../src/admin/color-scale-field.tsx","../src/admin/library-field.tsx","../src/admin/font-field.tsx","../src/admin/pairing-field.tsx","../src/admin/appearance-field.tsx","../src/admin/grey-scale-field.tsx","../src/admin/contrast-report.tsx","../src/admin/section-heading.tsx","../src/admin/publish-child.tsx","../src/admin/save-button.tsx","../src/admin/identity-fallback.tsx","../src/admin/look-field.tsx","../src/admin/roles-matrix-field.tsx","../src/admin/roles-row-label.tsx","../src/admin/role-slug-field.tsx","../src/admin/role-name-field.tsx","../src/admin/roles-field.tsx","../src/admin/roles-grants-field.tsx","../src/admin/features-matrix-field.tsx","../src/admin/document-title-actions.tsx","../src/admin/document-create-new.tsx"],"mappings":";;;;;;;;;;;cAWa,UAAA,EAAY,wBAAA;;;;;;;cCsBZ,eAAA,EAAiB,yBAAA;;;;;;;;;cCNjB,YAAA,EAAc,yBAAA;;;;;;;;;cCTd,SAAA,EAAW,0BAAA;;;;;;;cCNX,YAAA,EAAc,sBAAA;;;;;;;cCCd,eAAA,EAAiB,yBAAA;;;ALF9B;;;;AAAA,cMyDa,cAAA,EAAgB,0BAAA;;;;;;;cChDhB,cAAA,EAAgB,sBAAA;;;;;;cCbhB,cAAA,EAAgB,sBAAA;;;cCgJhB,YAAA,EAAc,sBAAA;;;;;;;;iBC3IX,qBAAA,CAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA;;AVDrC;;;iBUgBgB,eAAA,CAAA,GAAe,kBAAA,CAAA,GAAA,CAAA,OAAA;;iBA0Bf,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;cC7CnB,gBAAA,EAAkB,sBAAA;;;;;;;cCIlB,SAAA,EAAW,wBAAA;;;;;;;;cCsBX,gBAAA,EAAkB,yBAAA;;;;;;iBC3Bf,aAAA,CAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;cCChB,aAAA,EAAe,wBAAA;;;;;;;cCCf,aAAA,EAAe,wBAAA;;;;;;;;cC8Cf,UAAA,EAAY,0BAAA;;;;;;;;cChCZ,gBAAA,EAAkB,wBAAA;;;;;;;;;AlBZ/B;;cmB0Ca,mBAAA,EAAqB,yBAAA;;;iBCjBlB,oBAAA,CAAA;EAAuB;AAAA;EAAc,QAAA,GAAW,SAAA;AAAA,IAAW,kBAAA,CAAA,GAAA,CAAA,OAAA;;;iBCtB3D,iBAAA,CAAA;EAAoB;AAAA;EAAU,IAAA;AAAA,IAAc,kBAAA,CAAA,GAAA,CAAA,OAAA"}
+{"version":3,"file":"admin.d.mts","names":[],"sources":["../src/admin/color-field.tsx","../src/admin/color-scale-field.tsx","../src/admin/library-field.tsx","../src/admin/font-field.tsx","../src/admin/pairing-field.tsx","../src/admin/appearance-field.tsx","../src/admin/grey-scale-field.tsx","../src/admin/contrast-report.tsx","../src/admin/section-heading.tsx","../src/admin/publish-child.tsx","../src/admin/save-button.tsx","../src/admin/identity-fallback.tsx","../src/admin/look-field.tsx","../src/admin/roles-matrix-field.tsx","../src/admin/roles-row-label.tsx","../src/admin/role-slug-field.tsx","../src/admin/role-name-field.tsx","../src/admin/roles-field.tsx","../src/admin/roles-grants-field.tsx","../src/admin/features-matrix-field.tsx","../src/admin/document-title-actions.tsx","../src/admin/document-create-new.tsx","../src/admin-nav/types.ts","../src/admin/admin-nav.tsx","../src/admin/admin-nav-row-label.tsx","../src/admin/admin-nav-entity-field.tsx"],"mappings":";;;;;;;;;;;cAWa,UAAA,EAAY,wBAAA;;;;;;;cCsBZ,eAAA,EAAiB,yBAAA;;;;;;;;;cCNjB,YAAA,EAAc,yBAAA;;;;;;;;;cCTd,SAAA,EAAW,0BAAA;;;;;;;cCNX,YAAA,EAAc,sBAAA;;;;;;;cCCd,eAAA,EAAiB,yBAAA;;;ALF9B;;;;AAAA,cMyDa,cAAA,EAAgB,0BAAA;;;;;;;cChDhB,cAAA,EAAgB,sBAAA;;;;;;cCbhB,cAAA,EAAgB,sBAAA;;;cCgJhB,YAAA,EAAc,sBAAA;;;;;;;;iBC3IX,qBAAA,CAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA;;AVDrC;;;iBUgBgB,eAAA,CAAA,GAAe,kBAAA,CAAA,GAAA,CAAA,OAAA;;iBA0Bf,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;cC7CnB,gBAAA,EAAkB,sBAAA;;;;;;;cCIlB,SAAA,EAAW,wBAAA;;;;;;;;cCqBX,gBAAA,EAAkB,yBAAA;;;;;;iBC1Bf,aAAA,CAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;cCChB,aAAA,EAAe,wBAAA;;;;;;;cCCf,aAAA,EAAe,wBAAA;;;;;;;;cC8Cf,UAAA,EAAY,0BAAA;;;;;;;;cChCZ,gBAAA,EAAkB,wBAAA;;;;;;;;;AlBZ/B;;cmB0Ca,mBAAA,EAAqB,yBAAA;;;iBCjBlB,oBAAA,CAAA;EAAuB;AAAA;EAAc,QAAA,GAAW,SAAA;AAAA,IAAW,kBAAA,CAAA,GAAA,CAAA,OAAA;;;iBCtB3D,iBAAA,CAAA;EAAoB;AAAA;EAAU,IAAA;AAAA,IAAc,kBAAA,CAAA,GAAA,CAAA,OAAA;;;UCmB3C,uBAAA;EACf,WAAA;EACA,OAAA;AAAA;;;UC5Be,aAAA;EACf,eAAA,GAAkB,uBAAA;AAAA;;;;AvBGpB;;iBuBsCgB,QAAA,CAAA;EAAW;AAAA,GAAmB,aAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;iBC5C3C,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;;iBCEhB,mBAAA,CAAA;EAAsB;AAAA;EAAU,IAAA;AAAA,IAAc,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/admin.mjs

@@ -1,6 +1,6 @@
 "use client";
 import { a as colorDocFromState, i as SYSTEM_COLOR_KEYS, n as pageEditorLooks, r as pageEditorTokens, s as stateFromColorDoc } from "./looks-BbL309kO.mjs";
-import { ArrayField, Button, CheckboxInput, FieldDescription, FieldError, FieldLabel, fieldBaseClass, useAuth, useConfig, useField, useForm, useFormFields, useRowLabel } from "@payloadcms/ui";
+import { ArrayField, Button, CheckboxInput, FieldDescription, FieldError, FieldLabel, Link, Logout, NavGroup, NavToggler, fieldBaseClass, useAuth, useConfig, useField, useForm, useFormFields, useNav, useRowLabel } from "@payloadcms/ui";
 import { GREY_SCALES, SHADE_STEPS, contrastForeground, contrastRatio, createColorScale, deriveDarkPalette, deriveLightPalette, hexToHSL, hslToString, includedShadeSteps, isThemeHex, presetHints, setColorScaleInclude } from "@bison-lab/tokens";
 import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -2737,7 +2737,7 @@ const DEFAULT_ROLE_MATRIX = ROLES.map((role) => ({
 	grants: defaultGrantsForRole(role)
 }));
 const DEVELOPER_DESCRIPTION = "Everything, including features not released for assignment.";
-const MISSING_SEED_ROLES_MESSAGE = "Roles must include Developer, Admin, Designer, and Author.";
+const MISSING_SEED_ROLES_MESSAGE = "Roles must include Developer.";
 const DUPLICATE_ROLE_SLUG_MESSAGE = "Each role needs a unique slug.";
 function uniqueSlugs(values) {
 	const slugs = [];
@@ -2805,7 +2805,7 @@ function parseRolesMatrix(value) {
 		seen.add(parsed.role);
 		rows.push(parsed);
 	}
-	if (ROLES.some((role) => !seen.has(role))) return {
+	if (!seen.has("developer")) return {
 		ok: false,
 		message: MISSING_SEED_ROLES_MESSAGE
 	};
@@ -2847,7 +2847,7 @@ function seedRoleFromTrigger(trigger) {
 	let node = trigger.parentElement;
 	while (node) {
 		const slugs = node.querySelectorAll("[data-role-slug]");
-		if (slugs.length === 1) return isRole(slugs[0]?.getAttribute("data-role-seed") || slugs[0]?.getAttribute("data-role-slug"));
+		if (slugs.length === 1) return (slugs[0]?.getAttribute("data-role-seed") || slugs[0]?.getAttribute("data-role-slug")) === "developer";
 		if (slugs.length > 1) return false;
 		node = node.parentElement;
 	}
@@ -2859,9 +2859,9 @@ function viewerIsDeveloper(user) {
 	return Array.isArray(roles) && roles.includes("developer");
 }
 /**
-* Payload's array field: drag rank stays, add is for custom rows, seed
-* rows have no remove. Developer stays in the saved array and is shown
-* only to a Developer. Reset restores seed ticks and package labels.
+* Payload's array field: drag rank stays, add is for custom rows.
+* Developer has no remove, stays in the saved array, and is shown only
+* to a Developer. Reset restores the package four and leaves extras.
 */
 const RolesMatrixField = (props) => {
 	const { setValue, value } = useField({ path: props.path });
@@ -3395,6 +3395,263 @@ function DocumentCreateNew({ path }) {
 	})] });
 }
 //#endregion
-export { AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
+//#region src/admin-nav/types.ts
+/**
+* Developer-owned admin sidebar. SPI-10 skins this with AppSidebarBlock;
+* this package ships the document and the default Nav. A consuming site
+* waits for SPI-97 after this and BIS-110 publish.
+*/
+const ADMIN_NAV_SLUG = "admin-nav";
+//#endregion
+//#region src/admin-nav/resolve.ts
+function sidebarGroup(group) {
+	if (group === false) return false;
+	if (typeof group === "string") return group;
+	return "";
+}
+function asLabel(value, fallback) {
+	return typeof value === "string" && value ? value : fallback;
+}
+function entityLabel(entity, type) {
+	if (type === "collection") return asLabel(entity.labels?.plural, asLabel(entity.labels?.singular, entity.slug));
+	return asLabel(entity.label, entity.slug);
+}
+function keyOf(type, slug) {
+	return `${type}:${slug}`;
+}
+function catalog(config) {
+	const collections = (config.collections ?? []).map((entity) => ({
+		type: "collection",
+		slug: entity.slug,
+		label: entityLabel(entity, "collection"),
+		group: sidebarGroup(entity.admin?.group)
+	}));
+	const globals = (config.globals ?? []).map((entity) => ({
+		type: "global",
+		slug: entity.slug,
+		label: entityLabel(entity, "global"),
+		group: sidebarGroup(entity.admin?.group)
+	}));
+	return [...collections, ...globals];
+}
+function defaultGroups(entities) {
+	const groups = [];
+	for (const entity of entities) {
+		if (entity.group === false) continue;
+		let group = groups.find((entry) => entry.label === entity.group);
+		if (!group) {
+			group = {
+				label: entity.group,
+				items: []
+			};
+			groups.push(group);
+		}
+		group.items.push({
+			type: entity.type,
+			slug: entity.slug,
+			label: entity.label
+		});
+	}
+	return groups;
+}
+function itemFromSaved(item, byKey) {
+	const type = item.type === "global" || item.type === "collection" ? item.type : null;
+	const slug = typeof item.slug === "string" ? item.slug : "";
+	if (!type || !slug) return null;
+	const entity = byKey.get(keyOf(type, slug));
+	if (!entity || entity.group === false) return null;
+	return {
+		type,
+		slug,
+		label: entity.label
+	};
+}
+function fromDocument(doc, entities) {
+	const byKey = new Map(entities.map((entity) => [keyOf(entity.type, entity.slug), entity]));
+	const groups = (doc.groups ?? []).map((row) => ({
+		label: typeof row.label === "string" ? row.label : "",
+		items: (row.items ?? []).flatMap((item) => {
+			const resolved = itemFromSaved(item ?? {}, byKey);
+			return resolved ? [resolved] : [];
+		})
+	}));
+	const seen = new Set(groups.flatMap((group) => group.items.map((item) => keyOf(item.type, item.slug))));
+	for (const entity of entities) {
+		if (entity.group === false) continue;
+		const key = keyOf(entity.type, entity.slug);
+		if (seen.has(key)) continue;
+		let group = groups.find((entry) => entry.label === entity.group);
+		if (!group) {
+			group = {
+				label: entity.group,
+				items: []
+			};
+			groups.push(group);
+		}
+		group.items.push({
+			type: entity.type,
+			slug: entity.slug,
+			label: entity.label
+		});
+		seen.add(key);
+	}
+	return groups;
+}
+/**
+* Layout for the package Nav (and later SPI-10). Permissions are
+* `visibleEntities` — this function does not re-derive access.
+*/
+function resolveAdminNav({ config, doc, visibleEntities }) {
+	const entities = catalog(config);
+	const saved = Array.isArray(doc?.groups) ? doc.groups : [];
+	let groups = saved.length === 0 ? defaultGroups(entities) : fromDocument({ groups: saved }, entities);
+	if (visibleEntities) {
+		const collections = new Set(visibleEntities.collections ?? []);
+		const globals = new Set(visibleEntities.globals ?? []);
+		groups = groups.map((group) => ({
+			...group,
+			items: group.items.filter((item) => item.type === "collection" ? collections.has(item.slug) : globals.has(item.slug))
+		}));
+	}
+	return groups;
+}
+//#endregion
+//#region src/admin/admin-nav.tsx
+const BASE = "nav";
+function isAbortError(error) {
+	return error instanceof DOMException ? error.name === "AbortError" : error instanceof Error && error.name === "AbortError";
+}
+/**
+* Payload's DefaultNav roots in an `@internal` NavWrapper. Copy the
+* class contract here — this package does not depend on `@payloadcms/next`.
+* Without `nav--nav-open`, Payload's CSS keeps `.nav` at opacity 0.
+*/
+function AdminNavShell({ children }) {
+	const { hydrated, navOpen, navRef, shouldAnimate } = useNav();
+	return /* @__PURE__ */ jsx("aside", {
+		className: [
+			BASE,
+			navOpen && `${BASE}--nav-open`,
+			shouldAnimate && `${BASE}--nav-animate`,
+			hydrated && `${BASE}--nav-hydrated`
+		].filter(Boolean).join(" "),
+		inert: navOpen ? void 0 : true,
+		children: /* @__PURE__ */ jsx("div", {
+			className: `${BASE}__scroll`,
+			ref: navRef,
+			children
+		})
+	});
+}
+/**
+* Default admin sidebar. Reads the Admin nav Global and paints
+* `resolveAdminNav`. SPI-10 may replace this component; it should keep
+* calling that function so the document stays the one layout source.
+*/
+function AdminNav({ visibleEntities }) {
+	const { config } = useConfig();
+	const [doc, setDoc] = useState(null);
+	const adminRoute = config.routes.admin ?? "/admin";
+	const apiRoute = config.routes.api ?? "/api";
+	useEffect(() => {
+		const controller = new AbortController();
+		const url = `${config.serverURL ?? ""}${apiRoute}/globals/${ADMIN_NAV_SLUG}`;
+		fetch(url, {
+			credentials: "include",
+			signal: controller.signal
+		}).then((response) => response.ok ? response.json() : null).then((payload) => {
+			if (controller.signal.aborted) return;
+			setDoc(payload);
+		}).catch((error) => {
+			if (isAbortError(error) || controller.signal.aborted) return;
+			setDoc(null);
+		});
+		return () => controller.abort();
+	}, [apiRoute, config.serverURL]);
+	const groups = useMemo(() => resolveAdminNav({
+		config,
+		doc,
+		visibleEntities
+	}), [
+		config,
+		doc,
+		visibleEntities
+	]);
+	return /* @__PURE__ */ jsxs(AdminNavShell, { children: [/* @__PURE__ */ jsxs("nav", {
+		className: `${BASE}__wrap`,
+		"aria-label": "Admin",
+		children: [/* @__PURE__ */ jsx("div", {
+			className: `${BASE}__links`,
+			children: groups.map((group, index) => {
+				const items = group.items.map((item) => {
+					return /* @__PURE__ */ jsx(Link, {
+						href: item.type === "collection" ? `${adminRoute}/collections/${item.slug}` : `${adminRoute}/globals/${item.slug}`,
+						className: `${BASE}__link`,
+						children: item.label
+					}, `${item.type}:${item.slug}`);
+				});
+				if (!group.label) return /* @__PURE__ */ jsx("div", {
+					className: `${BASE}__ungrouped`,
+					children: items
+				}, `ungrouped-${index}`);
+				return /* @__PURE__ */ jsx(NavGroup, {
+					label: group.label,
+					children: items
+				}, `${group.label}-${index}`);
+			})
+		}), /* @__PURE__ */ jsx("div", {
+			className: `${BASE}__controls`,
+			children: /* @__PURE__ */ jsx(Logout, {})
+		})]
+	}), /* @__PURE__ */ jsx("div", {
+		className: `${BASE}__header`,
+		children: /* @__PURE__ */ jsx("div", {
+			className: `${BASE}__header-content`,
+			children: /* @__PURE__ */ jsx(NavToggler, {})
+		})
+	})] });
+}
+//#endregion
+//#region src/admin/admin-nav-row-label.tsx
+/**
+* Array row header. Shows the group label, or “Group” when empty.
+*/
+function AdminNavRowLabel() {
+	const { data } = useRowLabel();
+	return /* @__PURE__ */ jsx("span", { children: typeof data.label === "string" && data.label.trim() ? data.label.trim() : "Group" });
+}
+//#endregion
+//#region src/admin/admin-nav-entity-field.tsx
+/**
+* A select of collections or globals from this site's config. Type on the
+* sibling row decides which list. `group: false` stays off — those entities
+* are not on the sidebar.
+*/
+function AdminNavEntityField({ path }) {
+	const { value, setValue } = useField({ path });
+	const { getDataByPath } = useForm();
+	const type = getDataByPath(path.replace(/\.slug$/, ".type"));
+	const { config } = useConfig();
+	const options = type === "global" ? (config.globals ?? []).filter((entity) => entity.admin?.group !== false).map((entity) => ({
+		value: entity.slug,
+		label: typeof entity.label === "string" ? entity.label : entity.slug
+	})) : (config.collections ?? []).filter((entity) => entity.admin?.group !== false).map((entity) => ({
+		value: entity.slug,
+		label: typeof entity.labels?.plural === "string" ? entity.labels.plural : entity.slug
+	}));
+	return /* @__PURE__ */ jsxs("label", { children: ["Slug", /* @__PURE__ */ jsxs("select", {
+		value: typeof value === "string" ? value : "",
+		onChange: (event) => setValue(event.target.value),
+		children: [/* @__PURE__ */ jsx("option", {
+			value: "",
+			children: "Select…"
+		}), options.map((option) => /* @__PURE__ */ jsx("option", {
+			value: option.value,
+			children: option.label
+		}, option.value))]
+	})] });
+}
+//#endregion
+export { AdminNav, AdminNavEntityField, AdminNavRowLabel, AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
 
 //# sourceMappingURL=admin.mjs.map