@bison-lab/payload-core 3.16.0 → 3.18.0

package/README.md

@@ -22,7 +22,7 @@ lockstep.
 
 | Import                             | Contents                                                                                         | Runs where                                                                 |
 | ---------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
-| `@bison-lab/payload-core`          | `seoPlugin`, `createTheme`, `createBrandAssets`, `createRoles`, `createFeatures`, `createPages`, `createUsers`, `createMedia`, `adminOnlyApiTab`, `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`, `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.    |
@@ -265,9 +265,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.
@@ -318,8 +320,9 @@ read from the live Features and Roles Globals) so Payload's
 
 ## Pages, users, and media
 
-`createPages`, `createUsers`, `createMedia`, `slugField`, and
-`adminOnlyApiTab` ship from the same React-free entry. Pages take the
+`createPages`, `createUsers`, `createMedia`, `slugField`,
+`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
 constrained to `_status: draft` — an Author can save a draft and cannot
@@ -327,7 +330,12 @@ publish or edit a live page. Users sit under Settings next to Roles,
 take `secureCookies`, and offer whatever rows the Global (or the seed
 plus the same `extras`) has. `users.roles` and `users.allowedFeatures`
 set `saveToJWT: true`. The checklist labels are the editable names.
-`adminOnlyApiTab` shows the document API tab only to Developer. Overlay
+`adminOnlyApiTab` shows the document API tab only to Developer.
+`documentTitleActions` is one admin provider that puts every document's
+primary actions on the title row — the same slot collection lists use
+for Create New — and hides the dead Edit tab when it has no sibling.
+One-list Globals pass `documentCreateNew("roles")` (or a site field
+path) so Create New uses those same words, with no icon. Overlay
 settings (Better Editor) take `developerOnlyAccess` and
 `hideUnlessDeveloper` on the site — the package does not add that
 plugin as a peer.

package/dist/admin.d.mts

@@ -1,5 +1,6 @@
 
 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";
 
@@ -103,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
@@ -155,5 +156,19 @@ declare const RolesGrantsField: JSONFieldClientComponent;
  */
 declare const FeaturesMatrixField: ArrayFieldClientComponent;
 //#endregion
-export { AppearanceField, ColorField, ColorScaleField, ContrastReport, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
+//#region src/admin/document-title-actions.d.ts
+declare function DocumentTitleActions({
+  children
+}: {
+  children?: ReactNode;
+}): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/admin/document-create-new.d.ts
+declare function DocumentCreateNew({
+  path
+}: {
+  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 };
 //# 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"],"mappings":";;;;;;;;;;cAWa,UAAA,EAAY,wBAAA;;;;;;;cCsBZ,eAAA,EAAiB,yBAAA;;;;;;;;ADtB9B;cEgBa,YAAA,EAAc,yBAAA;;;;;;;;AFhB3B;cGOa,SAAA,EAAW,0BAAA;;;;;;;cCNX,YAAA,EAAc,sBAAA;;;;;;;cCCd,eAAA,EAAiB,yBAAA;;;;;;;cCuDjB,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;;;;AAAA,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"}
+{"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"}

package/dist/admin.mjs

@@ -1,8 +1,8 @@
 "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, CheckboxInput, FieldDescription, FieldError, FieldLabel, fieldBaseClass, useAuth, useConfig, useField, useForm, useFormFields, useRowLabel } from "@payloadcms/ui";
+import { ArrayField, Button, CheckboxInput, FieldDescription, FieldError, FieldLabel, fieldBaseClass, useAuth, useConfig, useField, useForm, useFormFields, 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, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createPortal } from "react-dom";
 import { findFont, fontFaceCss, isFontId } from "@bison-lab/fonts";
@@ -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
 	};
@@ -2842,12 +2842,12 @@ function resetRolesMatrix(current) {
 }
 //#endregion
 //#region src/admin/roles-matrix-field.tsx
-const HIDE_ROW_CHROME = `.bl-roles-matrix .array-actions__add,.bl-roles-matrix .array-actions__duplicate,.bl-roles-matrix .array-actions__copy{display:none}.bl-roles-matrix .array-field__add-row{display:none}.bl-roles-matrix--hide-developer .array-field__row:has([data-role-seed="developer"]),.bl-roles-matrix--hide-developer .collapsible:has([data-role-seed="developer"]){display:none}.bl-roles-matrix__toolbar{display:flex;justify-content:flex-end;gap:.5rem;margin-block-end:.75rem}.bl-roles-matrix__reset,.bl-roles-matrix__add{min-height:2.25rem;padding:.35rem .9rem;border:1px solid var(--theme-elevation-150,#e2e8f0);border-radius:8px;background:transparent;color:inherit;font:inherit;cursor:pointer}body.bl-roles-matrix-seed-menu .array-actions__remove{display:none}`;
+const HIDE_ROW_CHROME = `.bl-roles-matrix .array-actions__add,.bl-roles-matrix .array-actions__duplicate,.bl-roles-matrix .array-actions__copy{display:none}.bl-roles-matrix .array-field__add-row{display:none}.bl-roles-matrix--hide-developer .array-field__row:has([data-role-seed="developer"]),.bl-roles-matrix--hide-developer .collapsible:has([data-role-seed="developer"]){display:none}.bl-roles-matrix__toolbar{display:flex;justify-content:flex-end;gap:.5rem;margin-block-end:.75rem}.bl-roles-matrix__reset{min-height:2.25rem;padding:.35rem .9rem;border:1px solid var(--theme-elevation-150,#e2e8f0);border-radius:8px;background:transparent;color:inherit;font:inherit;cursor:pointer}body.bl-roles-matrix-seed-menu .array-actions__remove{display:none}`;
 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 });
@@ -2894,19 +2894,14 @@ const RolesMatrixField = (props) => {
 				precedence: "default",
 				children: HIDE_ROW_CHROME
 			}),
-			/* @__PURE__ */ jsxs("div", {
+			/* @__PURE__ */ jsx("div", {
 				className: "bl-roles-matrix__toolbar",
-				children: [/* @__PURE__ */ jsx("button", {
-					type: "button",
-					className: "bl-roles-matrix__add",
-					onClick: () => rootRef.current?.querySelector(".array-field__add-row")?.click(),
-					children: "Add Role"
-				}), /* @__PURE__ */ jsx("button", {
+				children: /* @__PURE__ */ jsx("button", {
 					type: "button",
 					className: "bl-roles-matrix__reset",
 					onClick: () => setValue(resetRolesMatrix(value)),
 					children: "Reset to defaults"
-				})]
+				})
 			}),
 			/* @__PURE__ */ jsx(ArrayField, { ...props })
 		]
@@ -3321,6 +3316,85 @@ const FeaturesMatrixField = (props) => {
 	});
 };
 //#endregion
-export { AppearanceField, ColorField, ColorScaleField, ContrastReport, FeaturesMatrixField, FontField, GreyScaleField, HiddenSaveButton, IdentityFallback, LibraryField, LookField, PairingField, PublishChild, RoleNameField, RoleSlugField, RolesField, RolesGrantsField, RolesMatrixField, RolesRowLabel, SectionHeading, ThemeDocumentControls, ThemeSaveButton };
+//#region src/admin/document-title-actions.tsx
+/**
+* Shared document header: title on the left, primary actions on the
+* right — the same slot collection lists use for Create New.
+*
+* Payload parks Edit / Versions / API in that slot and puts Save one
+* row down. This moves `.doc-controls__controls-wrapper` (Save,
+* Preview, Create New, and the kebab) onto the title row, hides the
+* active Edit tab (you are already on the form), and collapses the
+* leftover controls band when it has no meta.
+*
+* Mounted as `admin.components.providers` so Account and every
+* collection / global share one lift. A MutationObserver re-applies
+* after Payload redraws the controls.
+*/
+const TITLE_ACTIONS_CSS = `
+.doc-header__header{display:flex;align-items:center;justify-content:flex-start;width:100%;gap:10px}
+.doc-header__title{flex:0 1 auto;min-width:0}
+.doc-header__header > .doc-controls__controls-wrapper{margin-left:auto;display:flex;align-items:center;gap:8px}
+.doc-tab.doc-tab--active.btn--disabled{display:none}
+.doc-tabs:not(:has(.doc-tab:not(.doc-tab--active))){display:none}
+.doc-controls:has(.doc-controls__meta:empty):not(:has(.doc-controls__controls-wrapper)){height:0;min-height:0;padding:0;overflow:hidden}
+.doc-controls:has(.doc-controls__meta:empty):not(:has(.doc-controls__controls-wrapper)) .doc-controls__divider{display:none}
+`;
+function liftTitleActions() {
+	const header = document.querySelector(".doc-header__header");
+	const wrapper = document.querySelector(".doc-controls__controls-wrapper");
+	if (!header || !wrapper) return;
+	if (wrapper.parentElement === header) return;
+	header.appendChild(wrapper);
+}
+function DocumentTitleActions({ children }) {
+	useLayoutEffect(() => {
+		liftTitleActions();
+		const observer = new MutationObserver(liftTitleActions);
+		observer.observe(document.body, {
+			childList: true,
+			subtree: true
+		});
+		return () => observer.disconnect();
+	}, []);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("style", {
+		href: "bl-doc-title-actions",
+		precedence: "default",
+		children: TITLE_ACTIONS_CSS
+	}), children] });
+}
+//#endregion
+//#region src/admin/document-create-new.tsx
+/**
+* Same words as a collection list Create New — no icon, no "Area" or
+* "Role." The page title already says what is created. Primary so a
+* site's admin skin can paint it with Theme `--primary`.
+*
+* Hides the array's own Add while this control is mounted so the
+* action is not offered twice.
+*/
+const HIDE_FIELD_ADD = `.array-field__add-row{display:none}`;
+function DocumentCreateNew({ path }) {
+	const { addFieldRow, disabled } = useForm();
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("style", {
+		href: "bl-doc-create-new",
+		precedence: "default",
+		children: HIDE_FIELD_ADD
+	}), /* @__PURE__ */ jsx(Button, {
+		buttonStyle: "primary",
+		size: "medium",
+		type: "button",
+		disabled,
+		onClick: () => {
+			addFieldRow({
+				path,
+				schemaPath: path
+			});
+		},
+		children: "Create New"
+	})] });
+}
+//#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 };
 
 //# sourceMappingURL=admin.mjs.map