@pwfabric/authoring 0.0.0-stage → 1.0.0-rc.0

package/dist/define-factory.d.ts

@@ -0,0 +1,114 @@
+/**
+ * defineFactory API
+ *
+ * Create factory functions that generate block compositions.
+ *
+ * @module @pwfabric/authoring/define-factory
+ *
+ * @example
+ * ```typescript
+ * import { defineFactory } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * const MyPageFactory = defineFactory({
+ *   id: 'my-page',
+ *   name: 'My Page Factory',
+ *   configSchema: z.object({
+ *     title: z.string(),
+ *     subtitle: z.string().optional(),
+ *   }),
+ *   build: (config) => [
+ *     { type: 'heading', props: { text: config.title, level: 'h1' } },
+ *     { type: 'text', props: { content: config.subtitle ?? '' } },
+ *   ]
+ * })
+ * ```
+ */
+import type { Block } from '@pwfabric/core';
+import type { FactoryOptions, FactoryDefinition, FactoryConfig } from './types.js';
+/**
+ * Reset the ID counter (useful for testing)
+ */
+export declare function resetIdCounter(): void;
+/**
+ * Define a factory function that generates block compositions
+ *
+ * Factories allow you to create reusable block patterns that can be
+ * customized with configuration. They automatically generate unique
+ * block IDs and validate configuration against an optional schema.
+ *
+ * @param options - Factory definition options
+ * @returns A frozen factory definition
+ *
+ * @example
+ * ```typescript
+ * import { defineFactory } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * // Define a pricing section factory
+ * const PricingSectionFactory = defineFactory({
+ *   id: 'pricing-section',
+ *   name: 'Pricing Section',
+ *   description: 'Create a pricing section with multiple tiers',
+ *   configSchema: z.object({
+ *     title: z.string(),
+ *     tiers: z.array(z.object({
+ *       name: z.string(),
+ *       price: z.number(),
+ *       features: z.array(z.string()),
+ *     })),
+ *   }),
+ *   build: (config) => [
+ *     {
+ *       type: 'container',
+ *       props: { direction: 'column', gap: 32 },
+ *       children: [
+ *         { type: 'heading', props: { text: config.title, level: 'h2' } },
+ *         {
+ *           type: 'grid',
+ *           props: { columns: config.tiers.length },
+ *           children: config.tiers.map((tier) => ({
+ *             type: 'pricing-card',
+ *             props: {
+ *               title: tier.name,
+ *               price: tier.price,
+ *               features: tier.features,
+ *             },
+ *           })),
+ *         },
+ *       ],
+ *     },
+ *   ],
+ * })
+ *
+ * // Use the factory
+ * const blocks = PricingSectionFactory.build({
+ *   title: 'Choose Your Plan',
+ *   tiers: [
+ *     { name: 'Basic', price: 9, features: ['Feature 1'] },
+ *     { name: 'Pro', price: 29, features: ['Feature 1', 'Feature 2'] },
+ *   ],
+ * })
+ * ```
+ */
+export declare function defineFactory<TConfig extends FactoryConfig = FactoryConfig>(options: FactoryOptions<TConfig>): FactoryDefinition<TConfig>;
+/**
+ * Check if a value is a factory definition
+ */
+export declare function isFactoryDefinition(value: unknown): value is FactoryDefinition;
+/**
+ * Compose multiple factory outputs into a single block array
+ *
+ * @param factories - Array of factory output block arrays
+ * @returns Combined block array
+ */
+export declare function composeFactoryOutputs(...factories: readonly (readonly Block[])[]): readonly Block[];
+/**
+ * Wrap factory output in a container block
+ *
+ * @param blocks - Factory output blocks
+ * @param containerProps - Props for the wrapper container
+ * @returns Single container block with children
+ */
+export declare function wrapInContainer(blocks: readonly Block[], containerProps?: Record<string, unknown>): Block;
+//# sourceMappingURL=define-factory.d.ts.map

package/dist/define-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-factory.d.ts","sourceRoot":"","sources":["../src/define-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAG3C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EAId,MAAM,YAAY,CAAA;AAgBnB;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAyFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EACzE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAC/B,iBAAiB,CAAC,OAAO,CAAC,CA8B5B;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAY9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,SAAS,EAAE,SAAS,CAAC,SAAS,KAAK,EAAE,CAAC,EAAE,GAC1C,SAAS,KAAK,EAAE,CAElB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC3C,KAAK,CAYP"}

package/dist/define-factory.js

@@ -0,0 +1,247 @@
+/**
+ * defineFactory API
+ *
+ * Create factory functions that generate block compositions.
+ *
+ * @module @pwfabric/authoring/define-factory
+ *
+ * @example
+ * ```typescript
+ * import { defineFactory } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * const MyPageFactory = defineFactory({
+ *   id: 'my-page',
+ *   name: 'My Page Factory',
+ *   configSchema: z.object({
+ *     title: z.string(),
+ *     subtitle: z.string().optional(),
+ *   }),
+ *   build: (config) => [
+ *     { type: 'heading', props: { text: config.title, level: 'h1' } },
+ *     { type: 'text', props: { content: config.subtitle ?? '' } },
+ *   ]
+ * })
+ * ```
+ */
+import { DEFAULT_BLOCK_LAYOUT } from '@pwfabric/core';
+import { blockRegistry } from '@pwfabric/runtime/blocks';
+// ============================================================
+// ID GENERATION
+// ============================================================
+let idCounter = 0;
+/**
+ * Generate a unique block ID
+ */
+function generateBlockId(type) {
+    idCounter += 1;
+    return `${type}-${idCounter}-${Date.now().toString(36)}`;
+}
+/**
+ * Reset the ID counter (useful for testing)
+ */
+export function resetIdCounter() {
+    idCounter = 0;
+}
+// ============================================================
+// VALIDATION
+// ============================================================
+/**
+ * Validate factory identifier
+ */
+function validateFactoryId(id) {
+    if (typeof id !== 'string') {
+        throw new Error('Factory id must be a string');
+    }
+    if (id.length < 2 || id.length > 50) {
+        throw new Error('Factory id must be 2-50 characters');
+    }
+    const kebabCaseRegex = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+    if (!kebabCaseRegex.test(id)) {
+        throw new Error(`Factory id "${id}" must be kebab-case (lowercase letters, numbers, hyphens, starting with a letter)`);
+    }
+}
+/**
+ * Validate factory config against schema
+ */
+function validateConfig(config, schema) {
+    if (!schema) {
+        // No schema, accept any config
+        return {
+            valid: true,
+            config: config,
+        };
+    }
+    const result = schema.safeParse(config);
+    if (result.success) {
+        return {
+            valid: true,
+            config: result.data,
+        };
+    }
+    const errors = result.error.errors.map((e) => ({
+        path: e.path.join('.'),
+        message: e.message,
+    }));
+    return {
+        valid: false,
+        errors,
+    };
+}
+// ============================================================
+// BLOCK SPEC TO BLOCK
+// ============================================================
+/**
+ * Convert a BlockSpec (without id) to a Block (with id)
+ */
+function specToBlock(spec) {
+    const block = {
+        id: generateBlockId(spec.type),
+        type: spec.type,
+        props: spec.props,
+        layout: blockRegistry.get(spec.type)?.defaultLayout ?? DEFAULT_BLOCK_LAYOUT,
+    };
+    if (spec.children && spec.children.length > 0) {
+        return {
+            ...block,
+            children: spec.children.map(specToBlock),
+        };
+    }
+    return block;
+}
+// ============================================================
+// DEFINE FACTORY
+// ============================================================
+/**
+ * Define a factory function that generates block compositions
+ *
+ * Factories allow you to create reusable block patterns that can be
+ * customized with configuration. They automatically generate unique
+ * block IDs and validate configuration against an optional schema.
+ *
+ * @param options - Factory definition options
+ * @returns A frozen factory definition
+ *
+ * @example
+ * ```typescript
+ * import { defineFactory } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * // Define a pricing section factory
+ * const PricingSectionFactory = defineFactory({
+ *   id: 'pricing-section',
+ *   name: 'Pricing Section',
+ *   description: 'Create a pricing section with multiple tiers',
+ *   configSchema: z.object({
+ *     title: z.string(),
+ *     tiers: z.array(z.object({
+ *       name: z.string(),
+ *       price: z.number(),
+ *       features: z.array(z.string()),
+ *     })),
+ *   }),
+ *   build: (config) => [
+ *     {
+ *       type: 'container',
+ *       props: { direction: 'column', gap: 32 },
+ *       children: [
+ *         { type: 'heading', props: { text: config.title, level: 'h2' } },
+ *         {
+ *           type: 'grid',
+ *           props: { columns: config.tiers.length },
+ *           children: config.tiers.map((tier) => ({
+ *             type: 'pricing-card',
+ *             props: {
+ *               title: tier.name,
+ *               price: tier.price,
+ *               features: tier.features,
+ *             },
+ *           })),
+ *         },
+ *       ],
+ *     },
+ *   ],
+ * })
+ *
+ * // Use the factory
+ * const blocks = PricingSectionFactory.build({
+ *   title: 'Choose Your Plan',
+ *   tiers: [
+ *     { name: 'Basic', price: 9, features: ['Feature 1'] },
+ *     { name: 'Pro', price: 29, features: ['Feature 1', 'Feature 2'] },
+ *   ],
+ * })
+ * ```
+ */
+export function defineFactory(options) {
+    // Validate required fields
+    validateFactoryId(options.id);
+    if (typeof options.build !== 'function') {
+        throw new Error('Factory build function is required');
+    }
+    // Create the build wrapper that converts specs to blocks
+    const buildWithIds = (config) => {
+        const specs = options.build(config);
+        return specs.map(specToBlock);
+    };
+    // Create the validation function
+    const validateConfigFn = (config) => {
+        return validateConfig(config, options.configSchema);
+    };
+    const definition = {
+        id: options.id,
+        name: options.name ?? options.id,
+        description: options.description ?? '',
+        build: buildWithIds,
+        validateConfig: validateConfigFn,
+        // Only include configSchema if it's defined
+        ...(options.configSchema !== undefined && { configSchema: options.configSchema }),
+    };
+    return Object.freeze(definition);
+}
+// ============================================================
+// UTILITY FUNCTIONS
+// ============================================================
+/**
+ * Check if a value is a factory definition
+ */
+export function isFactoryDefinition(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const def = value;
+    return (typeof def.id === 'string' &&
+        typeof def.name === 'string' &&
+        typeof def.build === 'function' &&
+        typeof def.validateConfig === 'function');
+}
+/**
+ * Compose multiple factory outputs into a single block array
+ *
+ * @param factories - Array of factory output block arrays
+ * @returns Combined block array
+ */
+export function composeFactoryOutputs(...factories) {
+    return factories.flat();
+}
+/**
+ * Wrap factory output in a container block
+ *
+ * @param blocks - Factory output blocks
+ * @param containerProps - Props for the wrapper container
+ * @returns Single container block with children
+ */
+export function wrapInContainer(blocks, containerProps = {}) {
+    return {
+        id: generateBlockId('container'),
+        type: 'container',
+        props: {
+            direction: 'column',
+            gap: 24,
+            ...containerProps,
+        },
+        layout: blockRegistry.get('container')?.defaultLayout ?? DEFAULT_BLOCK_LAYOUT,
+        children: [...blocks],
+    };
+}
+//# sourceMappingURL=define-factory.js.map

package/dist/define-factory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @pwfabric/authoring
+ *
+ * The surface a pack author writes against: define a block, compose a factory,
+ * declare a capability, register and validate what you built.
+ *
+ * It holds no HTTP client: talking to a hosting service is that service's
+ * own package. The scaffolding templates in the authoring tooling emit
+ * `import { defineBlock } from ...`, so this is the module name a third-party
+ * author reads first.
+ *
+ * @module @pwfabric/authoring
+ *
+ * @example
+ * ```typescript
+ * import { defineBlock, createCustomBlockRegistry } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * const MyBlock = defineBlock({
+ *   type: 'my-block',
+ *   name: 'My Block',
+ *   schema: z.object({ title: z.string() }),
+ *   defaultProps: { title: 'Default' },
+ *   component: ({ props }) => <div>{props.title}</div>
+ * })
+ *
+ * const registry = createCustomBlockRegistry()
+ * registry.register(MyBlock)
+ * ```
+ */
+export * from '@pwfabric/runtime';
+export type { CustomBlockOptions, CustomBlockComponentProps, CustomBlockComponent, CustomBlockContext, CustomBlockDefinition, FactoryConfig, BlockSpec, FactoryOptions, FactoryDefinition, FactoryValidationResult, FactoryValidationError, ICustomBlockRegistry, BlockValidationResult, BlockValidationError, PropsValidationResult, InferBlockProps, InferFactoryConfig, InferSchemaProps, } from './types.js';
+export { defineBlock, isCustomBlockDefinition, createBlockInstance } from './define-block.js';
+export { validateBlockDefinition } from './define-block.js';
+export type { BlockDefinitionIssue } from './define-block.js';
+export { defineFactory, isFactoryDefinition, composeFactoryOutputs, wrapInContainer, resetIdCounter, } from './define-factory.js';
+export { CapabilityBuilder, defineCapability } from '@pwfabric/contracts';
+export { CustomBlockRegistry, createCustomBlockRegistry, getCustomBlockRegistry, resetGlobalRegistry, mergeRegistries, mergeWithBaseComponents, } from './registry.js';
+export { validateProps, validatePropsWithDefaults, validateBlock, validateBlockTree, createBlockValidator, createPropsValidator, formatValidationErrors, hasErrors, isBlock, isBlockArray, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,cAAc,mBAAmB,CAAA;AAMjC,YAAY,EAEV,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EAGrB,aAAa,EACb,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EAGtB,oBAAoB,EAGpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EAGrB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAMnB,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAM7D,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAA;AAM5B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAMzE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAA;AAMtB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,OAAO,EACP,YAAY,GACb,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * @pwfabric/authoring
+ *
+ * The surface a pack author writes against: define a block, compose a factory,
+ * declare a capability, register and validate what you built.
+ *
+ * It holds no HTTP client: talking to a hosting service is that service's
+ * own package. The scaffolding templates in the authoring tooling emit
+ * `import { defineBlock } from ...`, so this is the module name a third-party
+ * author reads first.
+ *
+ * @module @pwfabric/authoring
+ *
+ * @example
+ * ```typescript
+ * import { defineBlock, createCustomBlockRegistry } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * const MyBlock = defineBlock({
+ *   type: 'my-block',
+ *   name: 'My Block',
+ *   schema: z.object({ title: z.string() }),
+ *   defaultProps: { title: 'Default' },
+ *   component: ({ props }) => <div>{props.title}</div>
+ * })
+ *
+ * const registry = createCustomBlockRegistry()
+ * registry.register(MyBlock)
+ * ```
+ */
+// Re-export runtime (which includes core and contracts)
+export * from '@pwfabric/runtime';
+// ============================================================
+// DEFINE BLOCK API
+// ============================================================
+export { defineBlock, isCustomBlockDefinition, createBlockInstance } from './define-block.js';
+// single-source field-severity gate for authoring/install.
+export { validateBlockDefinition } from './define-block.js';
+// ============================================================
+// DEFINE FACTORY API
+// ============================================================
+export { defineFactory, isFactoryDefinition, composeFactoryOutputs, wrapInContainer, resetIdCounter, } from './define-factory.js';
+// ============================================================
+// DEFINE CAPABILITY API
+// ============================================================
+export { CapabilityBuilder, defineCapability } from '@pwfabric/contracts';
+// ============================================================
+// REGISTRY API
+// ============================================================
+export { CustomBlockRegistry, createCustomBlockRegistry, getCustomBlockRegistry, resetGlobalRegistry, mergeRegistries, mergeWithBaseComponents, } from './registry.js';
+// ============================================================
+// VALIDATION API
+// ============================================================
+export { validateProps, validatePropsWithDefaults, validateBlock, validateBlockTree, createBlockValidator, createPropsValidator, formatValidationErrors, hasErrors, isBlock, isBlockArray, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,wDAAwD;AACxD,cAAc,mBAAmB,CAAA;AAoCjC,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC7F,2DAA2D;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAG3D,+DAA+D;AAC/D,qBAAqB;AACrB,+DAA+D;AAE/D,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAA;AAE5B,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAE/D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEzE,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAA;AAEtB,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,OAAO,EACP,YAAY,GACb,MAAM,iBAAiB,CAAA"}

package/dist/registry.d.ts

@@ -0,0 +1,165 @@
+/**
+ * CustomBlockRegistry
+ *
+ * Registry for managing custom block definitions.
+ *
+ * @module @pwfabric/authoring/registry
+ *
+ * @example
+ * ```typescript
+ * import { createCustomBlockRegistry, defineBlock } from '@pwfabric/authoring'
+ * import { z } from 'zod'
+ *
+ * const registry = createCustomBlockRegistry()
+ *
+ * const MyBlock = defineBlock({
+ *   type: 'my-block',
+ *   name: 'My Block',
+ *   schema: z.object({ title: z.string() }),
+ *   defaultProps: { title: 'Default' },
+ *   component: ({ props }) => <div>{props.title}</div>
+ * })
+ *
+ * registry.register(MyBlock)
+ *
+ * // Use with SurfaceRenderer
+ * <SurfaceRenderer components={registry.getComponents()} />
+ * ```
+ */
+import type { BlockCategory } from '@pwfabric/core';
+import type { BlockComponentRegistry } from '@pwfabric/runtime';
+import type { CustomBlockDefinition, ICustomBlockRegistry } from './types.js';
+/**
+ * CustomBlockRegistry
+ *
+ * Manages registration and retrieval of custom block definitions.
+ * Provides a bridge between custom block definitions and the
+ * SurfaceRenderer component registry.
+ */
+export declare class CustomBlockRegistry implements ICustomBlockRegistry {
+    private readonly definitions;
+    /**
+     * Register a custom block definition
+     *
+     * @param definition - The custom block definition to register
+     * @throws Error if block type already registered
+     */
+    register<TProps extends Record<string, unknown>>(definition: CustomBlockDefinition<TProps>): void;
+    /**
+     * Register multiple custom block definitions
+     *
+     * @param definitions - Array of custom block definitions
+     */
+    registerMany(definitions: readonly CustomBlockDefinition[]): void;
+    /**
+     * Get a custom block definition by type
+     *
+     * @param type - Block type identifier
+     * @returns The block definition or undefined
+     */
+    get(type: string): CustomBlockDefinition | undefined;
+    /**
+     * Check if a block type is registered
+     *
+     * @param type - Block type identifier
+     * @returns True if registered
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered custom block definitions
+     *
+     * @returns Array of all block definitions
+     */
+    list(): readonly CustomBlockDefinition[];
+    /**
+     * Get block definitions by category
+     *
+     * @param category - Block category
+     * @returns Array of block definitions in category
+     */
+    getByCategory(category: BlockCategory): readonly CustomBlockDefinition[];
+    /**
+     * Get all registered block types
+     *
+     * @returns Array of block type identifiers
+     */
+    types(): readonly string[];
+    /**
+     * Unregister a custom block
+     *
+     * @param type - Block type identifier
+     * @returns True if block was unregistered
+     */
+    unregister(type: string): boolean;
+    /**
+     * Clear all registrations
+     */
+    clear(): void;
+    /**
+     * Get number of registered blocks
+     */
+    get size(): number;
+    /**
+     * Get a component registry for use with SurfaceRenderer
+     *
+     * This method creates a BlockComponentRegistry that can be passed
+     * to the SurfaceRenderer's `components` prop to enable rendering
+     * of custom blocks.
+     *
+     * @returns BlockComponentRegistry with all registered custom blocks
+     *
+     * @example
+     * ```typescript
+     * import { SurfaceRenderer } from '@pwfabric/runtime'
+     *
+     * const registry = createCustomBlockRegistry()
+     * registry.register(MyCustomBlock)
+     *
+     * // Pass to SurfaceRenderer
+     * <SurfaceRenderer
+     *   surface={mySurface}
+     *   components={registry.getComponents()}
+     * />
+     * ```
+     */
+    getComponents(): BlockComponentRegistry;
+}
+/**
+ * Create a new CustomBlockRegistry
+ *
+ * @returns A new CustomBlockRegistry instance
+ *
+ * @example
+ * ```typescript
+ * const registry = createCustomBlockRegistry()
+ * registry.register(MyBlock)
+ * ```
+ */
+export declare function createCustomBlockRegistry(): CustomBlockRegistry;
+export declare function getCustomBlockRegistry(): CustomBlockRegistry;
+/**
+ * Reset the global registry
+ *
+ * Useful for testing or when you need to clear all registrations.
+ */
+export declare function resetGlobalRegistry(): void;
+/**
+ * Merge multiple custom block registries into one
+ *
+ * @param registries - Registries to merge
+ * @returns A new registry containing all blocks from input registries
+ * @throws Error if there are duplicate block types
+ */
+export declare function mergeRegistries(...registries: readonly CustomBlockRegistry[]): CustomBlockRegistry;
+/**
+ * Merge a custom block registry with a base BlockComponentRegistry
+ *
+ * This is useful when you want to extend the default block components
+ * with custom blocks.
+ *
+ * @param baseComponents - The base component registry (e.g., defaultBlockComponents)
+ * @param customRegistry - The custom block registry
+ * @returns A merged BlockComponentRegistry
+ */
+export declare function mergeWithBaseComponents(baseComponents: BlockComponentRegistry, customRegistry: CustomBlockRegistry): BlockComponentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAOnB;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAEvE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACxC,IAAI;IAOP;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI;IAMjE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIpD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,IAAI,IAAI,SAAS,qBAAqB,EAAE;IAIxC;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,qBAAqB,EAAE;IAIxE;;;;OAIG;IACH,KAAK,IAAI,SAAS,MAAM,EAAE;IAI1B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,IAAI,sBAAsB;CASxC;AA4ED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D;AAUD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,UAAU,EAAE,SAAS,mBAAmB,EAAE,GAC5C,mBAAmB,CAUrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,sBAAsB,EACtC,cAAc,EAAE,mBAAmB,GAClC,sBAAsB,CAKxB"}