@bison-lab/payload-core 3.18.0 → 3.19.1

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
@@ -290,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({
@@ -300,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
@@ -340,10 +337,68 @@ 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`). Once the document has groups, that list is the sidebar —
+omitted collections and globals stay off it. `group: false` stays off.
+`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.
@@ -351,6 +406,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

@@ -170,5 +170,45 @@ 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-item-row-label.d.ts
+/**
+ * Item accordion title. Shows the chosen collection or global name
+ * (Pages), or “Item” when the row is still empty.
+ */
+declare function AdminNavItemRowLabel(): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/admin/admin-nav-entity-field.d.ts
+/**
+ * Payload's select of collections or globals. Subscribes to sibling Type
+ * with `useField` so the list updates when Type changes — `getDataByPath`
+ * does not re-render this field.
+ */
+declare const AdminNavEntityField: TextFieldClientComponent;
+//#endregion
+export { AdminNav, AdminNavEntityField, AdminNavItemRowLabel, 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;;;;;;;;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"}
+{"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-item-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;;;;;;;iBCGhB,oBAAA,CAAA,GAAoB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;;cCEvB,mBAAA,EAAqB,wBAAA"}

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, SelectField, 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";
@@ -3395,6 +3395,280 @@ 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]));
+	return (doc.groups ?? []).map((row) => ({
+		label: typeof row.label === "string" ? row.label : "",
+		items: (row.items ?? []).flatMap((item) => {
+			const resolved = itemFromSaved(item ?? {}, byKey);
+			return resolved ? [resolved] : [];
+		})
+	}));
+}
+/**
+* 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) => {
+					const href = item.type === "collection" ? `${adminRoute}/collections/${item.slug}` : `${adminRoute}/globals/${item.slug}`;
+					return /* @__PURE__ */ jsx(Link, {
+						className: `${BASE}__link`,
+						href,
+						prefetch: false,
+						children: /* @__PURE__ */ jsx("span", {
+							className: `${BASE}__link-label`,
+							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-nav/entity-options.ts
+function entityType(type) {
+	return type === "global" ? "global" : "collection";
+}
+/**
+* Collections or globals a Developer may pin. Sibling Type decides which
+* list. `group: false` stays off — those entities are not on the sidebar.
+*/
+function adminNavEntityOptions(config, type) {
+	const kind = entityType(type);
+	return (kind === "global" ? config.globals ?? [] : config.collections ?? []).filter((entity) => entity.admin?.group !== false).map((entity) => ({
+		value: entity.slug,
+		label: kind === "global" ? typeof entity.label === "string" && entity.label ? entity.label : entity.slug : typeof entity.labels?.plural === "string" && entity.labels.plural ? entity.labels.plural : entity.slug
+	}));
+}
+/** Array row title. Empty slug falls back to “Item”, never “Item 01”. */
+function adminNavEntityLabel(config, type, slug) {
+	if (typeof slug !== "string" || !slug) return "Item";
+	return adminNavEntityOptions(config, type).find((option) => option.value === slug)?.label ?? slug;
+}
+//#endregion
+//#region src/admin/admin-nav-item-row-label.tsx
+/**
+* Item accordion title. Shows the chosen collection or global name
+* (Pages), or “Item” when the row is still empty.
+*/
+function AdminNavItemRowLabel() {
+	const { data } = useRowLabel();
+	const { config } = useConfig();
+	return /* @__PURE__ */ jsx("span", { children: adminNavEntityLabel(config, data.type, data.slug) });
+}
+//#endregion
+//#region src/admin/admin-nav-entity-field.tsx
+/**
+* Payload's select of collections or globals. Subscribes to sibling Type
+* with `useField` so the list updates when Type changes — `getDataByPath`
+* does not re-render this field.
+*/
+const AdminNavEntityField = ({ field, path, permissions, readOnly, schemaPath }) => {
+	const { value: type } = useField({ path: path.replace(/\.slug$/, ".type") });
+	const { config } = useConfig();
+	const options = adminNavEntityOptions(config, type);
+	return /* @__PURE__ */ jsx(SelectField, {
+		field: {
+			name: field.name,
+			label: field.label,
+			required: field.required,
+			admin: {
+				...field.admin,
+				isClearable: false,
+				isSortable: false,
+				placeholder: "Select…"
+			},
+			type: "select",
+			hasMany: false,
+			options
+		},
+		path,
+		permissions,
+		readOnly,
+		schemaPath
+	});
+};
+//#endregion
+export { AdminNav, AdminNavEntityField, AdminNavItemRowLabel, 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