@bison-lab/payload-core 3.24.0 → 3.26.0

package/README.md

@@ -8,10 +8,10 @@ are extracted.
 Full guide: <https://payload.bisonlab.ai/site/seo/>
 
 ```bash
-pnpm add @bison-lab/payload-core @payloadcms/plugin-seo @bison-lab/tokens @bison-lab/fonts
+pnpm add @bison-lab/payload-core @payloadcms/plugin-seo @payloadcms/plugin-redirects @bison-lab/tokens @bison-lab/fonts
 ```
 
-Peers: `payload` and `@payloadcms/plugin-seo` are required. `@bison-lab/tokens`
+Peers: `payload`, `@payloadcms/plugin-seo`, and `@payloadcms/plugin-redirects` are required. `@bison-lab/tokens`
 and `@bison-lab/fonts` are needed to adopt the Theme Global; `@payloadcms/ui`
 and `react` are needed for its admin fields; `@bison-lab/ui` and
 `@payloadcms/live-preview-react` are needed for the live theme preview.
@@ -22,7 +22,7 @@ lockstep.
 
 | Import                             | Contents                                                                                         | Runs where                                                                 |
 | ---------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| `@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`          | `seoPlugin`, `createTheme`, `createBrandAssets`, `createRoles`, `createFeatures`, `createPages`, `createUsers`, `createMedia`, `createRedirects`, `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/navigation` | `getNavigation`, the Header and Footer slugs                                                  | Server. What a site header imports; it does not load the plugin or React.  |
@@ -45,11 +45,12 @@ the site spells its name and its URL scheme once.
 
 ```ts
 // payload.config.ts
-import { firstImageIn, seoPlugin } from "@bison-lab/payload-core";
+import { createRedirects, firstImageIn, seoPlugin } from "@bison-lab/payload-core";
 import type { Page } from "@/payload-types";
 
 export default buildConfig({
   plugins: [
+    createRedirects(),
     seoPlugin<Page>({
       siteName: "Acme Clinics",
       urlFor: (doc) => (doc.slug ? absoluteUrl(pagePath(doc.slug)) : undefined),
@@ -318,10 +319,23 @@ read from the live Features and Roles Globals) so Payload's
 ## Pages, users, and media
 
 `createPages`, `createUsers`, `createMedia`, `slugField`,
-`adminOnlyApiTab`, and `documentTitleActions` ship from the same
+`createRedirects`, `adminOnlyApiTab`, and `documentTitleActions` ship from the same
 React-free entry. Pages take the
-site's hero and layout blocks, reserved-slug predicate, and preview
-path. Create follows the Content tick. Update without Publish is
+site's hero and layout blocks, reserved-slug predicate, preview
+path, and optional `folderRoots` (`patients`, `providers`, …). Parent
+on the page editor is where the page lives: site root, those roots,
+published CMS pages, folders created by earlier saves, or New folder….
+The address is that folder plus a title leaf until first publish, then
+locks. Layout carries the same standing copy as the hero — a page cannot
+be published without a section — and Publish names that fix instead of
+only `Content → Layout`. Title-follow does not wipe the folder prefix. A taken address is
+refused — never rewritten to `slug-2`. Unlock + a parent change writes a
+308 the same way a typed slug change does. `createRedirects()`
+wraps `@payloadcms/plugin-redirects` for `pages` only (permanent 308) and
+collapses chains when a published slug changes. The plugin stores the
+rows; the site still has to serve them. Pin the plugin to the same
+version as `payload`, then `payload generate:importmap`,
+`payload generate:types`, and `payload migrate:create`. Create follows the Content tick. Update without Publish is
 constrained to `_status: draft` — an Author can save a draft and cannot
 publish or edit a live page. Users sit under Settings next to Roles,
 take `secureCookies`, and offer whatever rows the Global (or the seed
@@ -418,6 +432,7 @@ to a type that has one.
 
 `noIndexField`, the plugin's own fields, the Theme Global fields, the
 Roles Global fields, the Admin nav fields, the Header and Footer fields,
-and the brand-assets collection fields are columns
+the Pages slug lock fields, the Redirects collection, 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

@@ -2,7 +2,7 @@
 import { ThemeConfig } from "@bison-lab/tokens";
 import { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { ArrayFieldClientComponent, GroupFieldClientComponent, JSONFieldClientComponent, SelectFieldClientComponent, TextFieldClientComponent, UIFieldClientComponent } from "payload";
+import { ArrayFieldClientComponent, DefaultCellComponentProps, GroupFieldClientComponent, JSONFieldClientComponent, SelectFieldClientComponent, TextFieldClientComponent, UIFieldClientComponent } from "payload";
 
 //#region src/admin/color-field.d.ts
 /**
@@ -126,6 +126,22 @@ declare function RolesRowLabel(): react_jsx_runtime0.JSX.Element;
  */
 declare const RoleSlugField: TextFieldClientComponent;
 //#endregion
+//#region src/admin/slug-field.d.ts
+/**
+ * Parent, new-folder name, composed address, and Unlock. Slug follows the
+ * title leaf until first publish; the folder prefix is not wiped. After
+ * publish the cluster locks until Unlock, which warns that the old address
+ * will redirect.
+ */
+declare const SlugField: TextFieldClientComponent;
+//#endregion
+//#region src/admin/page-title-cell.d.ts
+/**
+ * Indent a Pages list title by how deep its slug sits under a parent folder.
+ * DefaultCell still draws the document link — a custom Cell replaces that wrap.
+ */
+declare function PageTitleCell(props: DefaultCellComponentProps): react_jsx_runtime0.JSX.Element;
+//#endregion
 //#region src/admin/role-name-field.d.ts
 /**
  * Role name. Letters and spaces only, so the hidden slug stays
@@ -214,5 +230,5 @@ declare function AdminNavItemRowLabel(): react_jsx_runtime0.JSX.Element;
  */
 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, setThemePreviewMode };
+export { AdminNav, AdminNavEntityField, AdminNavItemRowLabel, AdminNavRowLabel, AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PageTitleCell, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, SlugField, ThemeDocumentControls, ThemeSaveButton, setThemePreviewMode };
 //# 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/preview-mode.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;;;;;;;;;cCOjB,YAAA,EAAc,yBAAA;;;;;;;;;cCtBd,SAAA,EAAW,0BAAA;;;;;;;cCNX,YAAA,EAAc,sBAAA;;;;;;;cCCd,eAAA,EAAiB,yBAAA;;;ALF9B;;;;AAAA,cM4Da,cAAA,EAAgB,0BAAA;;;;;;;cCnDhB,cAAA,EAAgB,sBAAA;;;;;;cCbhB,cAAA,EAAgB,sBAAA;;;cC0IhB,YAAA,EAAc,sBAAA;;;;;;;;iBCtIX,qBAAA,CAAA;;AVAhB;;;iBUQgB,eAAA,CAAA,GAAe,kBAAA,CAAA,GAAA,CAAA,OAAA;;iBA0Bf,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;KCrCpB,gBAAA;AAAA,iBAkCI,mBAAA,CAAoB,IAAA,EAAM,gBAAA;;;;;;;cClC7B,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;;;;;;;;;AnBZ/B;;coB0Ca,mBAAA,EAAqB,yBAAA;;;iBCflB,oBAAA,CAAA;EAAuB;AAAA;EAAc,QAAA,GAAW,SAAA;AAAA,IAAW,kBAAA,CAAA,GAAA,CAAA,OAAA;;;iBCxB3D,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;;;AxBGpB;;;iBwB6CgB,QAAA,CAAA;EAAW;AAAA,GAAmB,aAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;iBCnD3C,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;iBCGhB,oBAAA,CAAA,GAAoB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;;cCEvB,mBAAA,EAAqB,wBAAA"}
+{"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/preview-mode.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/slug-field.tsx","../src/admin/page-title-cell.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;;;;;;;;;cCOjB,YAAA,EAAc,yBAAA;;;;;;;;;cCtBd,SAAA,EAAW,0BAAA;;;;;;;cCNX,YAAA,EAAc,sBAAA;;;;;;;cCCd,eAAA,EAAiB,yBAAA;;;ALF9B;;;;AAAA,cM4Da,cAAA,EAAgB,0BAAA;;;;;;;cCnDhB,cAAA,EAAgB,sBAAA;;;;;;cCbhB,cAAA,EAAgB,sBAAA;;;cC0IhB,YAAA,EAAc,sBAAA;;;;;;;;iBCtIX,qBAAA,CAAA;;AVAhB;;;iBUQgB,eAAA,CAAA,GAAe,kBAAA,CAAA,GAAA,CAAA,OAAA;;iBA0Bf,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;KCrCpB,gBAAA;AAAA,iBAkCI,mBAAA,CAAoB,IAAA,EAAM,gBAAA;;;;;;;cClC7B,gBAAA,EAAkB,sBAAA;;;;;;;cCIlB,SAAA,EAAW,wBAAA;;;;;;;;cCqBX,gBAAA,EAAkB,yBAAA;;;;;;iBC1Bf,aAAA,CAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;cCChB,aAAA,EAAe,wBAAA;;;;;;;;;cC2Bf,SAAA,EAAW,wBAAA;;;;;;;iBC1BR,aAAA,CAAc,KAAA,EAAO,yBAAA,GAAyB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;;cCAjD,aAAA,EAAe,wBAAA;;;;;;;;cC8Cf,UAAA,EAAY,0BAAA;;;;;;;;cChCZ,gBAAA,EAAkB,wBAAA;;;;;;;;;ArBZ/B;;csB0Ca,mBAAA,EAAqB,yBAAA;;;iBCflB,oBAAA,CAAA;EAAuB;AAAA;EAAc,QAAA,GAAW,SAAA;AAAA,IAAW,kBAAA,CAAA,GAAA,CAAA,OAAA;;;iBCxB3D,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;;;A1BGpB;;;iB0B6CgB,QAAA,CAAA;EAAW;AAAA,GAAmB,aAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;;iBCnD3C,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,13 +1,14 @@
 "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, Link, Logout, NavGroup, NavToggler, SelectField, fieldBaseClass, useAuth, useConfig, useField, useForm, useFormFields, useNav, useRowLabel } from "@payloadcms/ui";
+import { ArrayField, Button, CheckboxInput, DefaultCell, 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";
-import { Badge, Dialog, Field, Input, KitProvider, Label, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@bison-lab/admin-ui";
+import { Badge, Button as Button$1, Dialog, Field, Input, KitProvider, Label, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@bison-lab/admin-ui";
 import { HexColorPicker } from "react-colorful";
 import { createPortal } from "react-dom";
 import { findFont, fontFaceCss, isFontId } from "@bison-lab/fonts";
+import "payload";
 //#region src/admin/color-field.tsx
 const HEX_ERROR = "Enter a six-digit hex colour like #1e3a5f";
 /**
@@ -3004,6 +3005,324 @@ const RoleSlugField = ({ field, path, readOnly }) => {
 	});
 };
 //#endregion
+//#region src/fields/slug.ts
+/** Sentinel the Parent control writes while the editor is naming a new folder. */
+const NEW_FOLDER_PARENT = "__new__";
+const SLUG_UNLOCK_WARNING = "This page is live. Changing the address will send visitors from the old URL to the new one.";
+function slugifySegment(segment) {
+	return segment.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+/**
+* A stored slug from whatever was typed: NFKD, hyphenated, slash segments
+* kept, so `Café / About Us` becomes `cafe/about-us`.
+*/
+function normalizeSlug(value) {
+	return value.split("/").map(slugifySegment).filter(Boolean).join("/");
+}
+/** The folder prefix Parent stores. `__new__` resolves through `newFolder`. */
+function parentPrefix(parent, newFolder) {
+	if (parent === "__new__") return normalizeSlug(newFolder ?? "");
+	return typeof parent === "string" ? normalizeSlug(parent) : "";
+}
+/**
+* Address from a parent prefix and a title (or an existing leaf). Title-follow
+* uses this so a folder is not wiped when the title changes.
+*/
+function composeSlug(parent, title, newFolder) {
+	const prefix = parentPrefix(parent, newFolder);
+	const leaf = slugifySegment(title);
+	return prefix ? `${prefix}/${leaf}` : leaf;
+}
+/** Prefixes that exist only because a child slug lives under them. */
+function inferredFolders(slugs) {
+	const folders = /* @__PURE__ */ new Set();
+	for (const slug of slugs) {
+		const parts = normalizeSlug(slug).split("/");
+		for (let i = 1; i < parts.length; i += 1) folders.add(parts.slice(0, i).join("/"));
+	}
+	return [...folders].sort();
+}
+/** Slash count after the first segment — how far to indent a list row. */
+function slugDepth(slug) {
+	const normalized = normalizeSlug(slug);
+	if (!normalized) return 0;
+	return normalized.split("/").length - 1;
+}
+//#endregion
+//#region src/admin/slug-field.tsx
+const SEARCH_DELAY_MS = 200;
+const SEARCH_LIMIT = 8;
+/**
+* Parent, new-folder name, composed address, and Unlock. Slug follows the
+* title leaf until first publish; the folder prefix is not wiped. After
+* publish the cluster locks until Unlock, which warns that the old address
+* will redirect.
+*/
+const SlugField = ({ field, path, readOnly }) => {
+	const slug = useField({ path });
+	const parent = useField({ path: "parent" });
+	const newFolder = useField({ path: "newFolder" });
+	const unlock = useField({ path: "slugUnlock" });
+	const title = useFormFields(([fields]) => fields.title?.value);
+	const slugLocked = Boolean(useFormFields(([fields]) => fields.slugLocked?.value));
+	const locked = Boolean(readOnly) || slugLocked && !unlock.value;
+	const folderRoots = useMemo(() => {
+		return ((field.admin?.custom ?? {}).folderRoots ?? []).map(normalizeSlug).filter(Boolean);
+	}, [field.admin?.custom]);
+	const { config } = useConfig();
+	const collection = "pages";
+	const titleKey = config.collections.find((entry) => entry.slug === collection)?.admin?.useAsTitle ?? "title";
+	const endpoint = `${config.serverURL}${config.routes.api}/${collection}`;
+	const id = useId();
+	const parentInputId = `${id}-parent`;
+	const folderInputId = `${id}-folder`;
+	const addressId = `${id}-address`;
+	const listId = `${id}-list`;
+	const [query, setQuery] = useState("");
+	const [open, setOpen] = useState(false);
+	const [results, setResults] = useState([]);
+	const [allSlugs, setAllSlugs] = useState([]);
+	const [active, setActive] = useState(-1);
+	const creatingFolder = parent.value === NEW_FOLDER_PARENT;
+	const setSlug = slug.setValue;
+	const slugValue = slug.value ?? "";
+	useEffect(() => {
+		if (slugLocked || typeof title !== "string") return;
+		const next = composeSlug(parent.value, title, newFolder.value);
+		if (next !== slugValue) setSlug(next);
+	}, [
+		newFolder.value,
+		parent.value,
+		setSlug,
+		slugLocked,
+		slugValue,
+		title
+	]);
+	useEffect(() => {
+		if (!open) return;
+		const seq = { cancelled: false };
+		const timer = setTimeout(() => {
+			const params = new URLSearchParams({
+				depth: "0",
+				limit: String(SEARCH_LIMIT),
+				sort: titleKey,
+				"where[_status][equals]": "published"
+			});
+			const trimmed = query.trim();
+			if (trimmed) params.set(`where[${titleKey}][like]`, trimmed);
+			fetch(`${endpoint}?${params.toString()}`, { credentials: "include" }).then((response) => response.ok ? response.json() : { docs: [] }).then((body) => {
+				if (seq.cancelled) return;
+				setResults(body.docs ?? []);
+			}).catch(() => {
+				if (!seq.cancelled) setResults([]);
+			});
+		}, SEARCH_DELAY_MS);
+		return () => {
+			seq.cancelled = true;
+			clearTimeout(timer);
+		};
+	}, [
+		endpoint,
+		open,
+		query,
+		titleKey
+	]);
+	useEffect(() => {
+		let cancelled = false;
+		fetch(`${endpoint}?depth=0&limit=100&sort=slug`, { credentials: "include" }).then((response) => response.ok ? response.json() : { docs: [] }).then((body) => {
+			if (cancelled) return;
+			setAllSlugs((body.docs ?? []).flatMap((doc) => doc.slug ? [doc.slug] : []));
+		}).catch(() => {
+			if (!cancelled) setAllSlugs([]);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [endpoint]);
+	const folders = useMemo(() => {
+		const inferred = inferredFolders(allSlugs);
+		return [...new Set([...folderRoots, ...inferred])].sort();
+	}, [allSlugs, folderRoots]);
+	const options = useMemo(() => {
+		const trimmed = query.trim().toLowerCase();
+		const matches = (label, path) => !trimmed || label.toLowerCase().includes(trimmed) || (path ?? "").toLowerCase().includes(trimmed);
+		const list = [{
+			kind: "root",
+			id: "root",
+			label: "Site root"
+		}];
+		for (const folder of folders) if (matches(folder, folder)) list.push({
+			kind: "folder",
+			id: folder,
+			label: folder,
+			path: `/${folder}`
+		});
+		for (const doc of results) {
+			const label = String(doc[titleKey] ?? doc.id);
+			const path = doc.slug ? `/${doc.slug}` : "";
+			if (matches(label, path)) list.push({
+				kind: "page",
+				id: `page:${doc.id}`,
+				label,
+				path,
+				page: doc
+			});
+		}
+		list.push({
+			kind: "new",
+			id: NEW_FOLDER_PARENT,
+			label: "New folder…"
+		});
+		return list;
+	}, [
+		folders,
+		query,
+		results,
+		titleKey
+	]);
+	function choose(option) {
+		if (option.kind === "root") {
+			parent.setValue("");
+			newFolder.setValue("");
+		} else if (option.kind === "folder") {
+			parent.setValue(option.id);
+			newFolder.setValue("");
+		} else if (option.kind === "page") {
+			parent.setValue(option.page.slug ?? "");
+			newFolder.setValue("");
+		} else parent.setValue(NEW_FOLDER_PARENT);
+		setQuery("");
+		setOpen(false);
+		setActive(-1);
+	}
+	function onKeyDown(event) {
+		if (event.key === "ArrowDown") {
+			event.preventDefault();
+			if (!open) {
+				setOpen(true);
+				return;
+			}
+			setActive((index) => options.length ? (index + 1) % options.length : -1);
+		} else if (event.key === "ArrowUp") {
+			event.preventDefault();
+			setActive((index) => options.length ? index <= 0 ? options.length - 1 : index - 1 : -1);
+		} else if (event.key === "Enter") {
+			if (!open) return;
+			event.preventDefault();
+			const pick = options[active] ?? options[0];
+			if (pick) choose(pick);
+		} else if (event.key === "Escape") {
+			if (!open) return;
+			event.preventDefault();
+			setOpen(false);
+			setActive(-1);
+		}
+	}
+	const selectedPage = options.find((option) => option.kind === "page" && option.page.slug === parent.value);
+	const selectedFolder = parent.value && parent.value !== "__new__" ? parent.value : "";
+	const parentChip = creatingFolder ? "New folder" : selectedPage ? selectedPage.label : selectedFolder ? selectedFolder : "Site root";
+	const parentKind = creatingFolder ? "Folder" : selectedPage ? "Page" : selectedFolder ? "Folder" : "Root";
+	const address = slug.value ? `/${slug.value}` : "/";
+	const activeId = active >= 0 && open ? `${id}-option-${active}` : void 0;
+	return /* @__PURE__ */ jsx(KitProvider, { children: /* @__PURE__ */ jsxs("div", {
+		className: "bl-page-address",
+		children: [
+			/* @__PURE__ */ jsxs(Field, { children: [/* @__PURE__ */ jsx(Label, { children: "Parent" }), /* @__PURE__ */ jsx("div", {
+				className: "bl-nav-kit__picker",
+				children: locked ? /* @__PURE__ */ jsxs("div", {
+					className: "bl-nav-kit__picker-control",
+					children: [/* @__PURE__ */ jsx(Badge, {
+						variant: "neutral-subtle",
+						children: parentKind
+					}), /* @__PURE__ */ jsx("span", { children: parentChip })]
+				}) : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Input, {
+					id: parentInputId,
+					role: "combobox",
+					"aria-label": "Parent",
+					placeholder: "Site root, a folder, or a published page",
+					autoComplete: "off",
+					value: open ? query : parentChip,
+					"aria-expanded": open,
+					"aria-controls": listId,
+					"aria-autocomplete": "list",
+					"aria-activedescendant": activeId,
+					onChange: (event) => {
+						setQuery(event.target.value);
+						setActive(-1);
+						setOpen(true);
+					},
+					onFocus: () => setOpen(true),
+					onBlur: () => setOpen(false),
+					onKeyDown
+				}), open ? /* @__PURE__ */ jsx("ul", {
+					id: listId,
+					role: "listbox",
+					className: "bl-nav-kit__picker-menu",
+					children: options.map((option, index) => /* @__PURE__ */ jsxs("li", {
+						id: `${id}-option-${index}`,
+						role: "option",
+						"aria-selected": index === active,
+						className: "bl-nav-kit__picker-option",
+						onMouseDown: (event) => {
+							event.preventDefault();
+							choose(option);
+						},
+						onMouseEnter: () => setActive(index),
+						children: [/* @__PURE__ */ jsx("span", { children: option.label }), "path" in option && option.path ? /* @__PURE__ */ jsx("span", {
+							className: "bl-nav-kit__picker-path",
+							children: option.path
+						}) : null]
+					}, option.id))
+				}) : null] })
+			})] }),
+			creatingFolder && !locked ? /* @__PURE__ */ jsxs(Field, { children: [/* @__PURE__ */ jsx(Label, { children: "New folder name" }), /* @__PURE__ */ jsx(Input, {
+				id: folderInputId,
+				"aria-label": "New folder name",
+				value: newFolder.value ?? "",
+				autoComplete: "off",
+				onChange: (event) => newFolder.setValue(event.target.value)
+			})] }) : null,
+			/* @__PURE__ */ jsxs(Field, { children: [
+				/* @__PURE__ */ jsx(Label, { children: "Address" }),
+				/* @__PURE__ */ jsxs("div", {
+					className: "bl-nav-kit__picker-address",
+					children: [/* @__PURE__ */ jsx(Input, {
+						id: addressId,
+						readOnly: true,
+						disabled: locked,
+						value: address,
+						autoComplete: "off",
+						spellCheck: false
+					}), slugLocked && !unlock.value ? /* @__PURE__ */ jsx(Button$1, {
+						variant: "outline",
+						onClick: () => unlock.setValue(true),
+						children: "Unlock"
+					}) : null]
+				}),
+				unlock.value ? /* @__PURE__ */ jsx("p", { children: SLUG_UNLOCK_WARNING }) : null,
+				/* @__PURE__ */ jsx(FieldError, {
+					message: slug.errorMessage,
+					path,
+					showError: slug.showError
+				})
+			] })
+		]
+	}) });
+};
+//#endregion
+//#region src/admin/page-title-cell.tsx
+/**
+* Indent a Pages list title by how deep its slug sits under a parent folder.
+* DefaultCell still draws the document link — a custom Cell replaces that wrap.
+*/
+function PageTitleCell(props) {
+	return /* @__PURE__ */ jsx("span", {
+		className: "bl-page-title-cell",
+		style: { paddingInlineStart: `${slugDepth(typeof props.rowData?.slug === "string" ? props.rowData.slug : "") * 1.25}rem` },
+		children: /* @__PURE__ */ jsx(DefaultCell, { ...props })
+	});
+}
+//#endregion
 //#region src/admin/role-name-field.tsx
 /**
 * Role name. Letters and spaces only, so the hidden slug stays
@@ -3743,6 +4062,6 @@ const AdminNavEntityField = ({ field, 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, setThemePreviewMode };
+export { AdminNav, AdminNavEntityField, AdminNavItemRowLabel, AdminNavRowLabel, AppearanceField, ColorField, ColorScaleField, ContrastReport, DocumentCreateNew, DocumentTitleActions, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PageTitleCell, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, SlugField, ThemeDocumentControls, ThemeSaveButton, setThemePreviewMode };
 
 //# sourceMappingURL=admin.mjs.map