@bison-lab/payload-blocks 3.2.0 → 3.3.0

package/README.md

@@ -2,6 +2,8 @@
 
 Payload CMS block configs and renderers for the Bison Lab marketing blocks.
 
+Full guide, with every block rendered live: <https://payload.bisonlab.ai/>
+
 Install it in a Payload site and editors get the same sections `@bison-lab/ui`
 ships as React props — showcase panels, process steps, FAQ columns, testimonial
 masonry, NAP — as blocks they can add to a page.
@@ -175,6 +177,51 @@ export const NextBlockLink: BlockLinkComponent = ({ newTab, ...props }) => <Link
 Without one, `DefaultBlockLink` renders a plain anchor and sets `target` and
 `rel` together whenever `newTab` is on.
 
+### The seam
+
+One block floats across the join between two bands: the stats band with
+`overlap` on. It pulls itself up over the block above and down over the block
+below with negative margins, and each neighbour adds the same distance on its
+own side so the band sits across the seam without covering copy. Nothing is
+configured for this: `RenderBlocks` works out which rows float and hands every
+renderer two booleans, `overlapAbove` and `overlapBelow`, the same kind of
+derived neighbour fact as `runIndex` and `isLast`. Every package renderer's
+band wrapper adds `seamClasses(props)`; a renderer never reads a neighbour's
+row.
+
+A site's own renderer does the same. The usual case is the hero, which keeps
+symmetric padding until an editor drops an overlapping band under it:
+
+```tsx
+export function SiteHeroRenderer(props: BlockRendererProps<HeroBlockData>) {
+  return <PageHero overlap={props.overlapBelow} … />
+}
+```
+
+Which rows float is `RenderBlocks`' `floats` prop, defaulting to
+`overlapsSeam` (the package's stats band with `overlap` on). A site with a
+floating block of its own composes it:
+
+```tsx
+<RenderBlocks … floats={(row) => overlapsSeam(row) || row.blockType === 'bookingCard'} />
+```
+
+`SEAM_PULL_UP` / `SEAM_PULL_DOWN` are the floating block's negative margins
+and `OVERLAP_ABOVE_CLEARANCE` / `OVERLAP_BELOW_CLEARANCE` the matching
+padding, all from `./react`, so a site block that floats uses the same
+distance the neighbours clear. A floating block that is first on the page
+keeps its top padding, and one that is last keeps its bottom padding rather
+than pulling the footer up.
+
+**Tailwind has to see the renderers.** The padding and margins above are
+utilities in this package's output, not in `@bison-lab/ui`, so a site's
+stylesheet scans both packages:
+
+```css
+@source '../../../node_modules/@bison-lab/ui/dist';
+@source '../../../node_modules/@bison-lab/payload-blocks/dist';
+```
+
 ## Wiring a header
 
 Two more blocks build a header rather than a page: `megaMenuBlock` and
@@ -258,6 +305,7 @@ renders nothing, and `headerItemsFromBlocks` drops it.
 | `faqColumns` | `FAQColumnsBlock` | Answers are plain text, not Lexical — see the config for why. |
 | `testimonialMasonry` | `TestimonialMasonry` | Avatars fall back to initials. |
 | `nap` | `NapBlock` + `JsonLd` | Emits schema.org `LocalBusiness`; `phoneE164` is what the `tel:` link uses. |
+| `statsBand` | `StatsBandBlock` | 2–6 figures. Phones show two per row, tablets three, `columns` from `lg`. `overlap` floats it over the seam with its neighbours — see "The seam". |
 | `megaMenu` | `MegaMenuPanel` | A header block, from `megaMenuBlock({ variants, icons })`. See "Wiring a header". |
 | `navLink` | — | A header block: a plain bar item. `headerItemsFromBlocks` maps it. |
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ArrayFieldValidation, Block, CollectionSlug, Field, GroupField, TextFieldSingleValidation, UploadField } from "payload";
+import { ArrayFieldValidation, Block, CollectionSlug, Condition, Field, GroupField, TextFieldSingleValidation, UploadField } from "payload";
 
 //#region src/blocks/hero/config.d.ts
 /**
@@ -43,6 +43,17 @@ declare const TestimonialMasonryBlock: Block;
  */
 declare const NapBlock: Block;
 //#endregion
+//#region src/blocks/stats-band/config.d.ts
+/**
+ * A strip of figures: the facts a visitor should take in at a glance.
+ *
+ * The count, the order and the desktop column count are the editor's. The
+ * phone and tablet layouts are the library's: two per row and three per row,
+ * with `wide` naming the one stat that takes a full phone row when the count
+ * is odd.
+ */
+declare const StatsBandBlock: Block;
+//#endregion
 //#region src/blocks/mega-menu/config.d.ts
 /**
  * The blocks a header global's `items` array takes.
@@ -163,6 +174,12 @@ interface HeadingFieldsOptions {
   required?: boolean;
   /** Description shown under the eyebrow input. */
   eyebrowDescription?: string;
+  /**
+   * Show the three fields only when this holds, e.g. unless the block floats.
+   * Pair it with `required: false`: a hidden required field can never be
+   * satisfied, and the block could not publish.
+   */
+  condition?: Condition;
 }
 /**
  * The eyebrow / title / description trio every marketing band opens with.
@@ -174,7 +191,8 @@ interface HeadingFieldsOptions {
  */
 declare function headingFields({
   required,
-  eyebrowDescription
+  eyebrowDescription,
+  condition
 }?: HeadingFieldsOptions): Field[];
 //#endregion
 //#region src/fields/min-rows.d.ts
@@ -369,6 +387,24 @@ interface TestimonialMasonryBlockData extends BlockRow<"testimonialMasonry"> {
   minItemsForFade?: number | null;
   maxVisibleRows?: number | null;
 }
+interface StatsBandItemData {
+  value?: string | null;
+  label?: string | null;
+  href?: string | null;
+  wide?: boolean | null;
+  id?: string | null;
+}
+interface StatsBandBlockData extends BlockRow<"statsBand"> {
+  eyebrow?: string | null;
+  title?: string | null;
+  description?: string | null;
+  items?: StatsBandItemData[] | null;
+  /** A select, so the value is the digit as a string. */
+  columns?: ("2" | "3" | "4" | "5" | "6") | null;
+  tone?: ("card" | "plain") | null;
+  align?: ("start" | "center") | null;
+  overlap?: boolean | null;
+}
 interface NapDepartmentData {
   name?: string | null;
   departmentType?: string | null;
@@ -430,7 +466,7 @@ interface MegaMenuBlockData extends BlockRow<"megaMenu"> {
 }
 interface NavLinkBlockData extends BlockRow<"navLink">, LinkValue {}
 /** Every block this package ships, as one union. */
-type BisonBlockData = HeroBlockData | RichTextBlockData | ShowcasePanelsBlockData | ProcessStepsBlockData | FaqColumnsBlockData | TestimonialMasonryBlockData | NapBlockData | MegaMenuBlockData | NavLinkBlockData;
+type BisonBlockData = HeroBlockData | RichTextBlockData | ShowcasePanelsBlockData | ProcessStepsBlockData | FaqColumnsBlockData | TestimonialMasonryBlockData | NapBlockData | StatsBandBlockData | MegaMenuBlockData | NavLinkBlockData;
 /** The `blockType` of every block this package ships. */
 type BisonBlockType = BisonBlockData["blockType"];
 //#endregion
@@ -505,5 +541,5 @@ declare function sampleImage({
   alt
 }: SampleImageOptions): MediaDoc;
 //#endregion
-export { type BisonBlockData, type BisonBlockType, type BlockSamples, FaqColumnsBlock, type FaqColumnsBlockData, type FaqColumnsItemData, type HeadingFieldsOptions, HeroBlock, type HeroBlockData, type ImageFieldOptions, LinkBlock, type LinkFieldOptions, type LinkFieldsOptions, type LinkValue, MEGA_MENU_WIDTHS, MIN_ROWS_ARRAY_FIELD, type MediaDoc, type MediaValue, type MegaMenuBlockData, type MegaMenuBlockOptions, type MegaMenuColumnData, type MegaMenuLinkData, type MegaMenuOption, type MegaMenuSectionData, type MegaMenuWidthValue, NapBlock, type NapBlockData, type NapDepartmentData, type NavLinkBlockData, ProcessStepsBlock, type ProcessStepsBlockData, type ProcessStepsItemData, type ResolvedMedia, RichTextBlock, type RichTextBlockData, type RichTextContent, type SampleImageOptions, ShowcasePanelsBlock, type ShowcasePanelsBlockData, type ShowcasePanelsItemData, TestimonialMasonryBlock, type TestimonialMasonryBlockData, type TestimonialMasonryItemData, blockSamples, emptyRows, headingFields, imageField, linkField, linkFields, megaMenuBlock, megaMenuSampleOptions, resolveMedia, sampleImage, validateColumnWidths, validateRemWidth };
+export { type BisonBlockData, type BisonBlockType, type BlockSamples, FaqColumnsBlock, type FaqColumnsBlockData, type FaqColumnsItemData, type HeadingFieldsOptions, HeroBlock, type HeroBlockData, type ImageFieldOptions, LinkBlock, type LinkFieldOptions, type LinkFieldsOptions, type LinkValue, MEGA_MENU_WIDTHS, MIN_ROWS_ARRAY_FIELD, type MediaDoc, type MediaValue, type MegaMenuBlockData, type MegaMenuBlockOptions, type MegaMenuColumnData, type MegaMenuLinkData, type MegaMenuOption, type MegaMenuSectionData, type MegaMenuWidthValue, NapBlock, type NapBlockData, type NapDepartmentData, type NavLinkBlockData, ProcessStepsBlock, type ProcessStepsBlockData, type ProcessStepsItemData, type ResolvedMedia, RichTextBlock, type RichTextBlockData, type RichTextContent, type SampleImageOptions, ShowcasePanelsBlock, type ShowcasePanelsBlockData, type ShowcasePanelsItemData, StatsBandBlock, type StatsBandBlockData, type StatsBandItemData, TestimonialMasonryBlock, type TestimonialMasonryBlockData, type TestimonialMasonryItemData, blockSamples, emptyRows, headingFields, imageField, linkField, linkFields, megaMenuBlock, megaMenuSampleOptions, resolveMedia, sampleImage, validateColumnWidths, validateRemWidth };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/blocks/hero/config.ts","../src/blocks/rich-text/config.ts","../src/blocks/showcase-panels/config.ts","../src/blocks/process-steps/config.ts","../src/blocks/faq-columns/config.ts","../src/blocks/testimonial-masonry/config.ts","../src/blocks/nap/config.ts","../src/blocks/mega-menu/config.ts","../src/fields/image.ts","../src/fields/link.ts","../src/fields/heading.ts","../src/fields/min-rows.ts","../src/media.ts","../src/types.ts","../src/samples.ts","../src/blocks/mega-menu/sample.ts","../src/sample-image.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/blocks/hero/config.ts","../src/blocks/rich-text/config.ts","../src/blocks/showcase-panels/config.ts","../src/blocks/process-steps/config.ts","../src/blocks/faq-columns/config.ts","../src/blocks/testimonial-masonry/config.ts","../src/blocks/nap/config.ts","../src/blocks/stats-band/config.ts","../src/blocks/mega-menu/config.ts","../src/fields/image.ts","../src/fields/link.ts","../src/fields/heading.ts","../src/fields/min-rows.ts","../src/media.ts","../src/types.ts","../src/samples.ts","../src/blocks/mega-menu/sample.ts","../src/sample-image.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -323,21 +323,27 @@ const ProcessStepsBlock = {
 * puts the least-optional copy behind a click. The field names match the
 * `@bison-lab/ui` prop names so the renderers stay a pass-through.
 */
-function headingFields({ required = true, eyebrowDescription = "Small label above the heading. Leave empty to hide the row." } = {}) {
+function headingFields({ required = true, eyebrowDescription = "Small label above the heading. Leave empty to hide the row.", condition } = {}) {
+	const when = condition ? { condition } : {};
 	return [
 		{
 			name: "eyebrow",
 			type: "text",
-			admin: { description: eyebrowDescription }
+			admin: {
+				description: eyebrowDescription,
+				...when
+			}
 		},
 		{
 			name: "title",
 			type: "text",
-			required
+			required,
+			admin: when
 		},
 		{
 			name: "description",
-			type: "textarea"
+			type: "textarea",
+			admin: when
 		}
 	];
 }
@@ -641,6 +647,177 @@ const NapBlock = {
 	]
 };
 //#endregion
+//#region src/fields/row-limits.ts
+/**
+* A custom `validate` replaces Payload's stock array check, so any array
+* with its own rule re-applies the row limits first or `minRows` and
+* `maxRows` stop being enforced. Same messages as the stock check, through
+* the request's translator when the admin supplies one.
+*/
+function rowLimits(value, { minRows, maxRows, required, req }) {
+	const count = value?.length ?? 0;
+	const t = req?.t;
+	if (required && count === 0) return t ? t("validation:required") : "This field is required.";
+	if (minRows && count < minRows) return t ? t("validation:requiresAtLeast", {
+		count: minRows,
+		label: t("general:rows")
+	}) : `This field requires at least ${minRows} rows.`;
+	if (maxRows && count > maxRows) return t ? t("validation:requiresNoMoreThan", {
+		count: maxRows,
+		label: t("general:rows")
+	}) : `This field requires no more than ${maxRows} rows.`;
+	return true;
+}
+//#endregion
+//#region src/blocks/stats-band/config.ts
+/**
+* The rule on `wide`: on phones the band is two per row, so only an odd
+* count has a stat on a row of its own, only one stat can take it, and it
+* has to be a stat that starts a row (the 1st, 3rd or 5th), since a full-row
+* cell beside another cell would leave a hole. The array's own `validate`,
+* so the editor sees the message as they build, and Payload runs it again on
+* publish.
+*/
+const validateWideFlag = (value, options) => {
+	const limits = rowLimits(value, options);
+	if (limits !== true) return limits;
+	const rows = value ?? [];
+	const wide = rows.flatMap((row, i) => row?.wide ? [i] : []);
+	if (wide.length > 1) return "Only one stat can be full width on phones.";
+	if (wide.length === 0) return true;
+	if (rows.length % 2 === 0) return "Full width on phones only applies to an odd number of stats. With an even count every row is already full.";
+	if (wide[0] % 2 !== 0) return "Only a stat that starts a phone row can be full width: the 1st, 3rd or 5th. Move it up or down one place, or flag another.";
+	return true;
+};
+/**
+* An overlapping band is headless: it floats across the seam as a card, and a
+* heading pulled up into the block above would land on the wrong surface.
+* The heading fields disappear from the admin the moment `overlap` is on,
+* and the renderer ignores them if they were filled in first.
+*/
+const unlessOverlap = (_data, siblingData) => !siblingData?.overlap;
+/**
+* A strip of figures: the facts a visitor should take in at a glance.
+*
+* The count, the order and the desktop column count are the editor's. The
+* phone and tablet layouts are the library's: two per row and three per row,
+* with `wide` naming the one stat that takes a full phone row when the count
+* is odd.
+*/
+const StatsBandBlock = {
+	slug: "statsBand",
+	interfaceName: "StatsBandBlock",
+	labels: {
+		singular: "Stats Band",
+		plural: "Stats Bands"
+	},
+	fields: [
+		...headingFields({
+			required: false,
+			eyebrowDescription: "Small label above the heading. The heading and eyebrow are optional; without them the band stands alone.",
+			condition: unlessOverlap
+		}),
+		{
+			name: "items",
+			type: "array",
+			required: true,
+			minRows: 2,
+			maxRows: 6,
+			defaultValue: emptyRows(2),
+			labels: {
+				singular: "Stat",
+				plural: "Stats"
+			},
+			admin: { components: { Field: MIN_ROWS_ARRAY_FIELD } },
+			validate: validateWideFlag,
+			fields: [
+				{
+					name: "value",
+					type: "text",
+					required: true,
+					admin: { description: "The figure, as it should read: \"98%\", \"12,000+\", \"L1–S1\"." }
+				},
+				{
+					name: "label",
+					type: "textarea",
+					required: true
+				},
+				{
+					name: "href",
+					type: "text",
+					admin: { description: "Optional. Makes the whole stat a link: a site path (\"/outcomes\") or a full URL." }
+				},
+				{
+					name: "wide",
+					type: "checkbox",
+					label: "Full width on phones",
+					defaultValue: false,
+					admin: { description: "Phones show two per row. With an odd number of stats, this one takes a row to itself. Only the 1st, 3rd or 5th stat can." }
+				}
+			]
+		},
+		{
+			name: "columns",
+			type: "select",
+			defaultValue: "4",
+			options: [
+				{
+					label: "2",
+					value: "2"
+				},
+				{
+					label: "3",
+					value: "3"
+				},
+				{
+					label: "4",
+					value: "4"
+				},
+				{
+					label: "5",
+					value: "5"
+				},
+				{
+					label: "6",
+					value: "6"
+				}
+			],
+			admin: { description: "From large screens up, and never more than there are stats. Phones show two per row and tablets three." }
+		},
+		{
+			name: "tone",
+			type: "select",
+			defaultValue: "card",
+			options: [{
+				label: "Card (bordered, raised)",
+				value: "card"
+			}, {
+				label: "Plain (dividers only)",
+				value: "plain"
+			}]
+		},
+		{
+			name: "align",
+			type: "select",
+			defaultValue: "start",
+			options: [{
+				label: "Left",
+				value: "start"
+			}, {
+				label: "Centred",
+				value: "center"
+			}]
+		},
+		{
+			name: "overlap",
+			type: "checkbox",
+			label: "Float over the seam with the block above",
+			defaultValue: false,
+			admin: { description: "The band sits across the join between the block above and the block below. Both make room for it automatically. A floating band is headless: the heading fields above are hidden while this is on." }
+		}
+	]
+};
+//#endregion
 //#region src/blocks/mega-menu/rem-width.ts
 /**
 * The one rule for a typed panel width, shared by the config's validator and
@@ -676,25 +853,6 @@ const TWELFTHS = {
 	"100": 12
 };
 /**
-* A custom `validate` replaces Payload's stock array check, so the row limits
-* are re-applied here or five columns would pass. Same messages as the stock
-* check, through the request's translator when the admin supplies one.
-*/
-function rowLimits(value, { minRows, maxRows, required, req }) {
-	const count = value?.length ?? 0;
-	const t = req?.t;
-	if (required && count === 0) return t ? t("validation:required") : "This field is required.";
-	if (minRows && count < minRows) return t ? t("validation:requiresAtLeast", {
-		count: minRows,
-		label: t("general:rows")
-	}) : `This field requires at least ${minRows} rows.`;
-	if (maxRows && count > maxRows) return t ? t("validation:requiresNoMoreThan", {
-		count: maxRows,
-		label: t("general:rows")
-	}) : `This field requires no more than ${maxRows} rows.`;
-	return true;
-}
-/**
 * The rule on `columns`: read as fractions, the widths must total 100%. It is
 * the array's own `validate`, so the editor sees the message as they build,
 * and Payload runs field validation again on publish (only draft saves skip
@@ -1422,6 +1580,50 @@ const showcasePanelsSample = {
 	defaultActiveIndex: 0
 };
 //#endregion
+//#region src/blocks/stats-band/sample.ts
+/**
+* Four figures, the count the strip was designed around: one row on a
+* desktop, two by two on a tablet and a phone. `wide` is set (to `false`) so
+* the preview exercises the field, and an even count is where it is ignored.
+* `overlap` is off so the heading shows: a floating band is headless, and a
+* preview page has no hero for it to float over.
+*/
+const statsBandSample = {
+	id: "sample-stats-band",
+	blockType: "statsBand",
+	eyebrow: "At a glance",
+	title: "The clinic in numbers",
+	description: "What a year looks like across our two rooms, counted from the front desk rather than estimated.",
+	items: [
+		{
+			id: "sample-stat-pain",
+			value: "94%",
+			label: "of patients report less pain by their sixth session.",
+			href: "/outcomes",
+			wide: false
+		},
+		{
+			id: "sample-stat-visits",
+			value: "4,200+",
+			label: "appointments a year across two treatment rooms."
+		},
+		{
+			id: "sample-stat-wait",
+			value: "15 min",
+			label: "average wait from the front desk to the treatment room."
+		},
+		{
+			id: "sample-stat-years",
+			value: "12",
+			label: "years in the same building, on the same street."
+		}
+	],
+	columns: "4",
+	tone: "card",
+	align: "start",
+	overlap: false
+};
+//#endregion
 //#region src/blocks/testimonial-masonry/sample.ts
 function avatar(name) {
 	return sampleImage({
@@ -1520,10 +1722,11 @@ const blockSamples = {
 		maxVisibleRows: 2
 	},
 	nap: napSample,
+	statsBand: statsBandSample,
 	megaMenu: megaMenuSample,
 	navLink: navLinkSample
 };
 //#endregion
-export { FaqColumnsBlock, HeroBlock, LinkBlock, MEGA_MENU_WIDTHS, MIN_ROWS_ARRAY_FIELD, NapBlock, ProcessStepsBlock, RichTextBlock, ShowcasePanelsBlock, TestimonialMasonryBlock, blockSamples, emptyRows, headingFields, imageField, linkField, linkFields, megaMenuBlock, megaMenuSampleOptions, resolveMedia, sampleImage, validateColumnWidths, validateRemWidth };
+export { FaqColumnsBlock, HeroBlock, LinkBlock, MEGA_MENU_WIDTHS, MIN_ROWS_ARRAY_FIELD, NapBlock, ProcessStepsBlock, RichTextBlock, ShowcasePanelsBlock, StatsBandBlock, TestimonialMasonryBlock, blockSamples, emptyRows, headingFields, imageField, linkField, linkFields, megaMenuBlock, megaMenuSampleOptions, resolveMedia, sampleImage, validateColumnWidths, validateRemWidth };
 
 //# sourceMappingURL=index.mjs.map