@orion-studios/payload-blocks 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orion Studios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# @orion-studios/payload-blocks
+
+Reusable Payload CMS block definitions and admin components for building content-rich websites.
+
+## Installation
+
+```bash
+npm install @orion-studios/payload-blocks
+```
+
+## Features
+
+- **9 Production-Ready Blocks**: Hero, RichText, Media, FeatureGrid, Testimonials, FAQ, CTA, FormEmbed, BookingEmbed
+- **Admin UI Components**: Custom block labels and controls
+- **Section Presets**: Pre-configured block combinations for common page sections
+- **Template Starters**: Complete page layouts for contact, landing, services pages
+- **TypeScript Support**: Full type definitions included
+
+## Usage
+
+### Quick Start
+
+```typescript
+// src/collections/Pages.ts
+import { CollectionConfig } from 'payload'
+import { defaultPageLayoutBlocks } from '@orion-studios/payload-blocks'
+
+export const Pages: CollectionConfig = {
+  slug: 'pages',
+  fields: [
+    {
+      name: 'title',
+      type: 'text',
+      required: true,
+    },
+    {
+      name: 'layout',
+      type: 'blocks',
+      blocks: defaultPageLayoutBlocks, // All 9 blocks ready to use
+    },
+  ],
+}
+```
+
+### Using Individual Blocks
+
+```typescript
+import {
+  HeroBlock,
+  CtaBlock,
+  FaqBlock,
+} from '@orion-studios/payload-blocks'
+
+export const Pages: CollectionConfig = {
+  slug: 'pages',
+  fields: [
+    {
+      name: 'layout',
+      type: 'blocks',
+      blocks: [HeroBlock, CtaBlock, FaqBlock], // Pick only what you need
+    },
+  ],
+}
+```
+
+### Using Presets
+
+```typescript
+import {
+  sectionPresets,
+  templateStarterPresets,
+  clonePresetBlocks,
+} from '@orion-studios/payload-blocks'
+
+// Section presets for common patterns
+console.log(sectionPresets)
+// [
+//   { id: 'hero-conversion', title: 'Hero + Conversion CTA', blocks: [...] },
+//   { id: 'services-grid', title: 'Services Grid', blocks: [...] },
+//   { id: 'social-proof', title: 'Testimonials + FAQ', blocks: [...] },
+//   { id: 'lead-capture', title: 'Lead Capture', blocks: [...] }
+// ]
+
+// Template starters for entire pages
+console.log(Object.keys(templateStarterPresets))
+// ['contact', 'landing', 'services', 'standard']
+
+// Clone preset blocks for customization
+const myBlocks = clonePresetBlocks(templateStarterPresets.landing)
+```
+
+## Available Blocks
+
+### 1. Hero Block
+Large hero section with headline, subheadline, CTA buttons, and optional background image.
+
+### 2. Rich Text Block
+Full-featured rich text editor powered by Lexical.
+
+### 3. Media Block
+Image/video display with caption support.
+
+### 4. Feature Grid Block
+Grid layout for showcasing features, services, or benefits. Supports two variants: cards and highlights.
+
+### 5. Testimonials Block
+Customer testimonials with quotes, names, and locations.
+
+### 6. FAQ Block
+Frequently asked questions in an accordion format.
+
+### 7. CTA Block
+Call-to-action section with headline, description, and button.
+
+### 8. Form Embed Block
+Embed form components (customize for your needs).
+
+### 9. Booking Embed Block
+Embed booking/scheduling components.
+
+## Admin Components
+
+The package includes custom admin UI components that enhance the Payload admin experience:
+
+```typescript
+import { BuilderBlockLabel } from '@orion-studios/payload-blocks'
+
+// Used automatically with defaultPageLayoutBlocks
+// Provides better visual labels for blocks in the admin panel
+```
+
+## License
+
+MIT © Orion Studios

package/dist/index.d.mts

@@ -0,0 +1,51 @@
+import * as payload from 'payload';
+import { Block } from 'payload';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const BookingEmbedBlock: Block;
+
+declare const CtaBlock: Block;
+
+declare const FaqBlock: Block;
+
+declare const FeatureGridBlock: Block;
+
+declare const FormEmbedBlock: Block;
+
+declare const HeroBlock: Block;
+
+declare const MediaBlock: Block;
+
+declare const RichTextBlock: Block;
+
+declare const TestimonialsBlock: Block;
+
+declare const builderBlockLabelComponent: {
+    exportName: string;
+    path: string;
+};
+
+type Props = {
+    blockType: string;
+    rowLabel?: string;
+    rowNumber?: number;
+};
+declare function BuilderBlockLabel({ blockType, rowLabel, rowNumber }: Props): react_jsx_runtime.JSX.Element;
+
+type BuilderBlock = {
+    blockType: string;
+    [key: string]: unknown;
+};
+type SectionPreset = {
+    id: string;
+    title: string;
+    description: string;
+    blocks: BuilderBlock[];
+};
+declare const sectionPresets: SectionPreset[];
+declare const templateStarterPresets: Record<string, BuilderBlock[]>;
+declare function clonePresetBlocks(blocks: BuilderBlock[]): BuilderBlock[];
+
+declare const defaultPageLayoutBlocks: payload.Block[];
+
+export { BookingEmbedBlock, BuilderBlockLabel, CtaBlock, FaqBlock, FeatureGridBlock, FormEmbedBlock, HeroBlock, MediaBlock, RichTextBlock, type SectionPreset, TestimonialsBlock, builderBlockLabelComponent, clonePresetBlocks, defaultPageLayoutBlocks, sectionPresets, templateStarterPresets };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import * as payload from 'payload';
+import { Block } from 'payload';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const BookingEmbedBlock: Block;
+
+declare const CtaBlock: Block;
+
+declare const FaqBlock: Block;
+
+declare const FeatureGridBlock: Block;
+
+declare const FormEmbedBlock: Block;
+
+declare const HeroBlock: Block;
+
+declare const MediaBlock: Block;
+
+declare const RichTextBlock: Block;
+
+declare const TestimonialsBlock: Block;
+
+declare const builderBlockLabelComponent: {
+    exportName: string;
+    path: string;
+};
+
+type Props = {
+    blockType: string;
+    rowLabel?: string;
+    rowNumber?: number;
+};
+declare function BuilderBlockLabel({ blockType, rowLabel, rowNumber }: Props): react_jsx_runtime.JSX.Element;
+
+type BuilderBlock = {
+    blockType: string;
+    [key: string]: unknown;
+};
+type SectionPreset = {
+    id: string;
+    title: string;
+    description: string;
+    blocks: BuilderBlock[];
+};
+declare const sectionPresets: SectionPreset[];
+declare const templateStarterPresets: Record<string, BuilderBlock[]>;
+declare function clonePresetBlocks(blocks: BuilderBlock[]): BuilderBlock[];
+
+declare const defaultPageLayoutBlocks: payload.Block[];
+
+export { BookingEmbedBlock, BuilderBlockLabel, CtaBlock, FaqBlock, FeatureGridBlock, FormEmbedBlock, HeroBlock, MediaBlock, RichTextBlock, type SectionPreset, TestimonialsBlock, builderBlockLabelComponent, clonePresetBlocks, defaultPageLayoutBlocks, sectionPresets, templateStarterPresets };