@jhits/plugin-blog 0.0.7 → 0.0.9

package/dist/state/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * State Management Types
+ * Types for the editor state management system
+ */
+import { Block } from '../types/block';
+import { BlogPost, PostStatus, SEOMetadata, PostMetadata } from '../types/post';
+/**
+ * Editor State
+ * Represents the current state of the editor
+ */
+export interface EditorState {
+    /** Array of blocks in the editor */
+    blocks: Block[];
+    /** Post title */
+    title: string;
+    /** Post slug */
+    slug: string;
+    /** SEO metadata */
+    seo: SEOMetadata;
+    /** Post metadata */
+    metadata: PostMetadata;
+    /** Publication status */
+    status: PostStatus;
+    /** Whether the post has unsaved changes */
+    isDirty: boolean;
+    /** Whether the editor is in focus mode */
+    focusMode: boolean;
+    /** Currently selected block ID */
+    selectedBlockId: string | null;
+    /** Currently dragged block ID */
+    draggedBlockId: string | null;
+    /** Post ID (if editing existing post) */
+    postId: string | null;
+}
+/**
+ * Editor Actions
+ * Actions that can be dispatched to modify editor state
+ */
+export type EditorAction = {
+    type: 'SET_BLOCKS';
+    payload: Block[];
+} | {
+    type: 'ADD_BLOCK';
+    payload: {
+        block: Block;
+        index?: number;
+        containerId?: string;
+    };
+} | {
+    type: 'UPDATE_BLOCK';
+    payload: {
+        id: string;
+        data: Partial<Block['data']>;
+    };
+} | {
+    type: 'DELETE_BLOCK';
+    payload: {
+        id: string;
+    };
+} | {
+    type: 'DUPLICATE_BLOCK';
+    payload: {
+        id: string;
+    };
+} | {
+    type: 'MOVE_BLOCK';
+    payload: {
+        id: string;
+        newIndex: number;
+        containerId?: string;
+    };
+} | {
+    type: 'SET_TITLE';
+    payload: string;
+} | {
+    type: 'SET_SLUG';
+    payload: string;
+} | {
+    type: 'SET_SEO';
+    payload: Partial<SEOMetadata>;
+} | {
+    type: 'SET_METADATA';
+    payload: Partial<PostMetadata>;
+} | {
+    type: 'SET_STATUS';
+    payload: PostStatus;
+} | {
+    type: 'SET_FOCUS_MODE';
+    payload: boolean;
+} | {
+    type: 'SELECT_BLOCK';
+    payload: string | null;
+} | {
+    type: 'SET_DRAGGED_BLOCK';
+    payload: string | null;
+} | {
+    type: 'LOAD_POST';
+    payload: BlogPost;
+} | {
+    type: 'RESET_EDITOR';
+} | {
+    type: 'MARK_CLEAN';
+} | {
+    type: 'MARK_DIRTY';
+} | {
+    type: 'UNDO';
+} | {
+    type: 'REDO';
+} | {
+    type: 'SAVE_HISTORY';
+};
+/**
+ * Editor Context Value
+ * The value provided by the EditorContext
+ */
+export interface EditorContextValue {
+    /** Current editor state */
+    state: EditorState;
+    /** Dispatch an action to modify state */
+    dispatch: (action: EditorAction) => void;
+    /** Enable dark mode for content area and wrappers */
+    darkMode: boolean;
+    /** Background colors for the editor */
+    backgroundColors?: {
+        /** Background color for light mode (REQUIRED) */
+        light: string;
+        /** Background color for dark mode (optional) */
+        dark?: string;
+    };
+    /** Helper functions for common operations */
+    helpers: {
+        /** Add a new block (supports nested containers via containerId) */
+        addBlock: (type: string, index?: number, containerId?: string) => void;
+        /** Update a block's data */
+        updateBlock: (id: string, data: Partial<Block['data']>) => void;
+        /** Delete a block */
+        deleteBlock: (id: string) => void;
+        /** Duplicate a block */
+        duplicateBlock: (id: string) => void;
+        /** Move a block to a new position (supports nested containers via containerId) */
+        moveBlock: (id: string, newIndex: number, containerId?: string) => void;
+        /** Load a post into the editor */
+        loadPost: (post: BlogPost) => void;
+        /** Reset editor to initial state */
+        resetEditor: () => void;
+        /** Save current state (triggers save callback) */
+        save: (heroBlock?: Block | null) => Promise<void>;
+        /** Undo last action */
+        undo: () => void;
+        /** Redo last undone action */
+        redo: () => void;
+    };
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** Whether redo is available */
+    canRedo: boolean;
+}
+/**
+ * Initial Editor State
+ */
+export declare const initialEditorState: EditorState;
+//# sourceMappingURL=types.d.ts.map

package/dist/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,oCAAoC;IACpC,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,GAAG,EAAE,WAAW,CAAC;IAEjB,oBAAoB;IACpB,QAAQ,EAAE,YAAY,CAAC;IAEvB,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IAEnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,iCAAiC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,yCAAyC;IACzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,KAAK,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IAEnB,yCAAyC;IACzC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAEzC,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAElB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE;QACf,iDAAiD;QACjD,KAAK,EAAE,MAAM,CAAC;QACd,gDAAgD;QAChD,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,6CAA6C;IAC7C,OAAO,EAAE;QACL,mEAAmE;QACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAEvE,4BAA4B;QAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC;QAEhE,qBAAqB;QACrB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;QAElC,wBAAwB;QACxB,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;QAErC,kFAAkF;QAClF,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAExE,kCAAkC;QAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;QAEnC,oCAAoC;QACpC,WAAW,EAAE,MAAM,IAAI,CAAC;QAExB,kDAAkD;QAClD,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAElD,uBAAuB;QACvB,IAAI,EAAE,MAAM,IAAI,CAAC;QAEjB,8BAA8B;QAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IAEF,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAmBhC,CAAC"}

package/dist/state/types.js

@@ -0,0 +1,27 @@
+/**
+ * State Management Types
+ * Types for the editor state management system
+ */
+/**
+ * Initial Editor State
+ */
+export const initialEditorState = {
+    blocks: [],
+    title: '',
+    slug: '',
+    seo: {
+        title: '',
+        description: '',
+    },
+    metadata: {
+        categories: [],
+        tags: [],
+        excerpt: '',
+    },
+    status: 'draft',
+    isDirty: false,
+    focusMode: false,
+    selectedBlockId: null,
+    draggedBlockId: null,
+    postId: null,
+};

package/dist/types/block.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Core Block Types
+ * Foundation for the Block-Based Architecture
+ * Multi-Tenant Plugin Architecture - Blocks are provided by client applications
+ */
+import React from 'react';
+/**
+ * Base Block Interface
+ * Every block in the system extends this structure
+ */
+export interface Block {
+    /** Unique identifier for the block */
+    id: string;
+    /** Block type identifier (e.g., 'heading', 'paragraph', 'image', 'plantSpec') */
+    type: string;
+    /** Block-specific data (varies by type) */
+    data: Record<string, unknown>;
+    /**
+     * Child blocks (for container blocks like Section, Columns)
+     * Can be an array of Block IDs (for flat storage) or Block objects (for nested structure)
+     */
+    children?: string[] | Block[];
+    /** Optional metadata for editor state, styling, etc. */
+    meta?: {
+        /** Visual order in the editor */
+        order?: number;
+        /** Whether block is collapsed in editor */
+        collapsed?: boolean;
+        /** Custom styling overrides */
+        style?: Record<string, string>;
+        /** Editor-specific flags */
+        flags?: string[];
+        /** Column index (for column container blocks) */
+        columnIndex?: number;
+        /** Additional custom metadata */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Block Edit Component Props
+ * Props passed to the Edit component in the dashboard editor
+ */
+export interface BlockEditProps {
+    /** The block being edited */
+    block: Block;
+    /** Update handler - call this to update the block's data */
+    onUpdate: (data: Partial<Block['data']>) => void;
+    /** Delete handler - call this to remove the block */
+    onDelete?: () => void;
+    /** Duplicate handler - call this to duplicate the block */
+    onDuplicate?: () => void;
+    /** Whether the block is currently selected */
+    isSelected?: boolean;
+    /** Whether the block is currently being dragged */
+    isDragging?: boolean;
+    /** Focus mode state */
+    focusMode?: boolean;
+    /** Child blocks (for container blocks like Section, Columns) */
+    childBlocks?: Block[];
+    /** Add a child block (for container blocks) */
+    onChildBlockAdd?: (type: string, index?: number, containerId?: string) => void;
+    /** Update a child block (for container blocks) */
+    onChildBlockUpdate?: (id: string, data: Partial<Block['data']>, containerId?: string) => void;
+    /** Delete a child block (for container blocks) */
+    onChildBlockDelete?: (id: string, containerId?: string) => void;
+    /** Move a child block (for container blocks) */
+    onChildBlockMove?: (id: string, newIndex: number, containerId?: string) => void;
+}
+/**
+ * Block Preview Component Props
+ * Props passed to the Preview component for headless rendering
+ */
+export interface BlockPreviewProps {
+    /** The block to render */
+    block: Block;
+    /** Additional rendering context */
+    context?: {
+        /** Site ID */
+        siteId?: string;
+        /** Locale */
+        locale?: string;
+        /** Custom render props */
+        [key: string]: unknown;
+    };
+    /** Child blocks (for container blocks like Section, Columns) */
+    childBlocks?: Block[];
+    /** Render a child block (for container blocks) */
+    renderChild?: (childBlock: Block) => React.ReactElement;
+}
+/**
+ * Strict Block Component Interface
+ * Every client-provided block MUST implement this interface
+ */
+export interface IBlockComponent {
+    /**
+     * Edit Component - Rendered in the dashboard editor
+     * Must use dashboard design system (earth-tone palette, typography)
+     */
+    Edit: React.ComponentType<BlockEditProps>;
+    /**
+     * Preview Component - Rendered in headless/frontend context
+     * Can use client's own design system
+     */
+    Preview: React.ComponentType<BlockPreviewProps>;
+    /**
+     * Icon Component - Shown in block palette
+     * Should be a simple icon (lucide-react recommended)
+     */
+    Icon?: React.ComponentType<{
+        className?: string;
+    }>;
+}
+/**
+ * Block Type Definition
+ * Complete definition of a block type for the registry
+ */
+export interface BlockTypeDefinition {
+    /** Unique type identifier */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the block (shown in tooltips) */
+    description: string;
+    /** Icon component (React component) - Optional, falls back to block component's Icon */
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Default data structure for this block type */
+    defaultData: Record<string, unknown>;
+    /** Validation schema (optional, for runtime validation) */
+    validate?: (data: Record<string, unknown>) => boolean;
+    /** Whether this block can contain nested blocks */
+    isContainer?: boolean;
+    /** Allowed child block types (if container) */
+    allowedChildren?: string[];
+    /** Category for grouping in block palette */
+    category?: 'text' | 'media' | 'layout' | 'interactive' | 'custom';
+    /**
+     * Block Components - REQUIRED for client-provided blocks
+     * Edit and Preview components must be provided
+     */
+    components: IBlockComponent;
+}
+/**
+ * Rich Text Formatting Configuration
+ * Optional configuration for rich text formatting in text blocks
+ */
+export interface RichTextFormattingConfig {
+    /** Whether bold formatting is available */
+    bold?: boolean;
+    /** Whether italic formatting is available */
+    italic?: boolean;
+    /** Whether underline formatting is available */
+    underline?: boolean;
+    /** Whether links are available */
+    links?: boolean;
+    /** Available colors (array of color values or Tailwind classes) */
+    colors?: string[];
+    /** Custom CSS classes for formatted text */
+    styles?: {
+        bold?: string;
+        italic?: string;
+        underline?: string;
+        link?: string;
+        /** Color classes mapped by color value */
+        colorClasses?: Record<string, string>;
+    };
+}
+/**
+ * Client Block Definition
+ * Simplified interface for client apps to provide blocks
+ */
+export interface ClientBlockDefinition {
+    /** Unique type identifier */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of the block */
+    description: string;
+    /** Icon component (optional) */
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Default data structure */
+    defaultData: Record<string, unknown>;
+    /** Validation function (optional) */
+    validate?: (data: Record<string, unknown>) => boolean;
+    /** Whether this block can contain nested blocks */
+    isContainer?: boolean;
+    /** Allowed child block types (if container) */
+    allowedChildren?: string[];
+    /** Category for grouping */
+    category?: 'text' | 'media' | 'layout' | 'interactive' | 'custom';
+    /** Block components - REQUIRED */
+    components: IBlockComponent;
+    /** Rich text formatting configuration (optional) */
+    richTextFormatting?: RichTextFormattingConfig;
+}
+/**
+ * Block Registry Configuration
+ * Central registry of all available block types
+ */
+export interface BlockRegistry {
+    /** Map of block type to definition */
+    types: Map<string, BlockTypeDefinition>;
+    /** Register a new block type */
+    register(definition: BlockTypeDefinition): void;
+    /** Register multiple client blocks at once */
+    registerClientBlocks(definitions: ClientBlockDefinition[]): void;
+    /** Get block type definition */
+    get(type: string): BlockTypeDefinition | undefined;
+    /** Get all registered block types */
+    getAll(): BlockTypeDefinition[];
+    /** Get block types by category */
+    getByCategory(category: BlockTypeDefinition['category']): BlockTypeDefinition[];
+    /** Check if a block type is registered */
+    has(type: string): boolean;
+    /** Clear all registered blocks */
+    clear(): void;
+}
+//# sourceMappingURL=block.d.ts.map

package/dist/types/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/types/block.ts"],"names":[],"mappings":"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"}

package/dist/types/block.js

@@ -0,0 +1,6 @@
+/**
+ * Core Block Types
+ * Foundation for the Block-Based Architecture
+ * Multi-Tenant Plugin Architecture - Blocks are provided by client applications
+ */
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Central type exports
+ */
+export * from './block';
+export * from './post';
+export type { IBlockComponent, BlockEditProps, BlockPreviewProps, ClientBlockDefinition, } from './block';
+export type { BlockRegistry } from './block';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AAGvB,YAAY,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Central type exports
+ */
+export * from './block';
+export * from './post';

package/dist/types/post.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Post Types
+ * Data structures for blog posts
+ */
+import { Block } from './block';
+/**
+ * Post Status
+ */
+export type PostStatus = 'draft' | 'published' | 'scheduled' | 'archived';
+/**
+ * SEO Metadata
+ */
+export interface SEOMetadata {
+    /** SEO title (can differ from post title) */
+    title?: string;
+    /** Meta description */
+    description?: string;
+    /** Open Graph image URL */
+    ogImage?: string;
+    /** Keywords/tags for SEO */
+    keywords?: string[];
+    /** Canonical URL */
+    canonicalUrl?: string;
+}
+/**
+ * Publication Data
+ */
+export interface PublicationData {
+    /** Publication status */
+    status: PostStatus;
+    /** Publication date (ISO string) */
+    date?: string;
+    /** Scheduled publication date (if status is 'scheduled') */
+    scheduledDate?: string;
+    /** Author ID */
+    authorId?: string;
+    /** Last modified date */
+    updatedAt?: string;
+}
+/**
+ * Privacy Settings
+ */
+export interface PrivacySettings {
+    /** Whether the post is private (not publicly accessible) */
+    isPrivate?: boolean;
+    /** Password protection (if set, post requires password to view) */
+    password?: string;
+    /** List of user IDs who have access (from plugin-users) */
+    sharedWithUsers?: string[];
+}
+/**
+ * Post Metadata
+ */
+export interface PostMetadata {
+    /** Featured image */
+    featuredImage?: {
+        id?: string;
+        src?: string;
+        alt?: string;
+        brightness?: number;
+        blur?: number;
+        scale?: number;
+        positionX?: number;
+        positionY?: number;
+        isCustom?: boolean;
+    };
+    /** Categories */
+    categories?: string[];
+    /** Tags */
+    tags?: string[];
+    /** Excerpt/summary */
+    excerpt?: string;
+    /** Language code */
+    lang?: string;
+    /** Privacy settings */
+    privacy?: PrivacySettings;
+}
+/**
+ * Complete Blog Post Structure
+ * This is the headless JSON structure stored in the database
+ */
+export interface BlogPost {
+    /** Unique post identifier */
+    id: string;
+    /** Post title */
+    title: string;
+    /** URL slug (unique, auto-generated from title) */
+    slug: string;
+    /** Array of content blocks */
+    blocks: Block[];
+    /** SEO metadata */
+    seo: SEOMetadata;
+    /** Publication data */
+    publication: PublicationData;
+    /** Additional metadata */
+    metadata: PostMetadata;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Version number for revision tracking */
+    version?: number;
+}
+/**
+ * Post List Item (for list views)
+ * Lightweight version of BlogPost for performance
+ */
+export interface PostListItem {
+    id: string;
+    title: string;
+    slug: string;
+    status: PostStatus;
+    date?: string;
+    excerpt?: string;
+    featuredImage?: string;
+    authorId?: string;
+    updatedAt: string;
+    category?: string;
+}
+/**
+ * Post Filter Options
+ */
+export interface PostFilterOptions {
+    status?: PostStatus | PostStatus[];
+    category?: string;
+    tag?: string;
+    authorId?: string;
+    search?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    skip?: number;
+    sortBy?: 'date' | 'title' | 'updatedAt';
+    sortOrder?: 'asc' | 'desc';
+}
+//# sourceMappingURL=post.d.ts.map

package/dist/types/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../src/types/post.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IAEnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qBAAqB;IACrB,aAAa,CAAC,EAAE;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,mBAAmB;IACnB,GAAG,EAAE,WAAW,CAAC;IAEjB,uBAAuB;IACvB,WAAW,EAAE,eAAe,CAAC;IAE7B,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,CAAC;IAEvB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC9B"}

package/dist/types/post.js

@@ -0,0 +1,5 @@
+/**
+ * Post Types
+ * Data structures for blog posts
+ */
+export {};

package/dist/utils/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Client Utilities
+ * Helper functions for fetching blog data in client applications
+ */
+import { PostListItem, BlogPost } from '../types/post';
+export interface FetchBlogsOptions {
+    /** Maximum number of posts to fetch (default: 10) */
+    limit?: number;
+    /** Number of posts to skip (default: 0) */
+    skip?: number;
+    /** Filter by status (published, draft, concept) */
+    status?: string;
+    /** Whether to fetch all posts for admin (includes drafts) */
+    admin?: boolean;
+    /** API base URL (default: '/api/blogs') */
+    apiBaseUrl?: string;
+}
+export interface FetchBlogsResult {
+    /** Array of blog posts */
+    blogs: PostListItem[];
+    /** Total number of posts available */
+    total: number;
+}
+/**
+ * Fetch blog posts from the API
+ *
+ * @example
+ * ```ts
+ * const { blogs, total } = await fetchBlogs({ limit: 5 });
+ * ```
+ */
+export declare function fetchBlogs(options?: FetchBlogsOptions): Promise<FetchBlogsResult>;
+export interface FetchBlogOptions {
+    /** Blog post slug */
+    slug: string;
+    /** API base URL (default: '/api/blogs') */
+    apiBaseUrl?: string;
+}
+/**
+ * Fetch a single blog post by slug
+ *
+ * @example
+ * ```ts
+ * const blog = await fetchBlog({ slug: 'my-blog-post' });
+ * ```
+ */
+export declare function fetchBlog(options: FetchBlogOptions): Promise<BlogPost>;
+//# sourceMappingURL=client.d.ts.map

package/dist/utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,0BAA0B;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiD3F;AAED,MAAM,WAAW,gBAAgB;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB5E"}