@bison-lab/payload-core 3.15.0 → 3.17.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.    |
@@ -173,10 +173,7 @@ export default buildConfig({
           mark: { url: "/logo-mark.svg", alt: "Acme mark" },
         },
       },
-      colorUsages: {
-        collections: ["pages"],
-        globals: ["navigation"],
-      },
+      colorUsages: true,
       onPublish: async () => {
         revalidateTag("theme");
       },
@@ -186,13 +183,15 @@ export default buildConfig({
 ```
 
 **Color usages.** `createTheme({ colorUsages })` is the only site wiring for
-"is this custom color assigned?" Name every collection and global that
-stores a `lookField` / `colorTokenField` (or a string token those fields
-wrote). The package scans those documents — drafts included — and
-rewrites tokens when Colors Delete needs a replacement. Omit the option,
-or pass empty arrays, and every additional color is unused and deletes
-immediately. A new look surface is added to `colorUsages`, not copied
-into a site helper. Site adopt names the slugs (SPI-93).
+"is this custom color assigned?" Pass `true` to scan every collection and
+global Payload has registered when Colors Delete runs — drafts included,
+blocks included. Payload internals (`payload-*`) and Theme itself are
+skipped, so the library row being deleted is not treated as a use, and a
+later Navigation or Territories global joins without a site change. A
+`{ collections, globals }` list still names slugs when a site wants a
+narrower walk. Omit the option, or pass empty arrays, and every
+additional color is unused and deletes immediately. The site does not
+copy `findColorTokens`.
 
 Then `payload generate:importmap` (the Theme fields resolve from
 `@bison-lab/payload-core/admin`), `payload generate:types`, and
@@ -319,8 +318,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
@@ -328,7 +328,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";
 
@@ -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;;;;;;;;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"}

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";
@@ -2842,7 +2842,7 @@ 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) {
@@ -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