@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/blocks/rule-engine.js

@@ -0,0 +1,321 @@
+/**
+ * Composition Rule Engine
+ *
+ * CP7: Validation engine for block compositions
+ * Block metadata accessor is now an injectable provider so
+ * web-side editor flows can supply install-aware data without depending on
+ * the populated runtime singleton.
+ *
+ * @module @pwfabric/core/blocks/rule-engine
+ */
+import { MAX_NESTING_DEPTH } from '@pwfabric/core';
+import { blockRegistry } from './registry.js';
+import { compositionRules } from './composition-rules.js';
+function definitionToSnapshot(def) {
+    return {
+        type: def.type,
+        name: def.name,
+        canHaveChildren: def.canHaveChildren,
+        ...(def.allowedChildren !== undefined ? { allowedChildren: def.allowedChildren } : {}),
+        ...(def.allowedParents !== undefined ? { allowedParents: def.allowedParents } : {}),
+    };
+}
+/**
+ * Default provider — reads from the runtime `blockRegistry` singleton.
+ * Returns `undefined` for types absent from the singleton (post-
+ * the singleton is empty by default).
+ */
+export const defaultBlockMetaProvider = {
+    get(type) {
+        const def = blockRegistry.get(type);
+        return def ? definitionToSnapshot(def) : undefined;
+    },
+};
+// ============================================================
+// ERROR CODES
+// ============================================================
+export const CompositionErrorCode = {
+    MAX_DEPTH_EXCEEDED: 'MAX_DEPTH_EXCEEDED',
+    INVALID_CHILD: 'INVALID_CHILD',
+    INVALID_PARENT: 'INVALID_PARENT',
+    NO_CHILDREN_ALLOWED: 'NO_CHILDREN_ALLOWED',
+    SELF_NESTING: 'SELF_NESTING',
+    UNKNOWN_BLOCK_TYPE: 'UNKNOWN_BLOCK_TYPE',
+    ORPHANED_BLOCK: 'ORPHANED_BLOCK',
+};
+// ============================================================
+// RULE ENGINE CLASS
+// ============================================================
+/**
+ * Composition Rule Engine
+ *
+ * Validates block compositions against defined rules.
+ */
+export class CompositionRuleEngine {
+    /** Rules for this engine instance (reserved for future custom rule support) */
+    rules;
+    /** Block metadata accessor */
+    meta;
+    constructor(rules = compositionRules, meta = defaultBlockMetaProvider) {
+        this.rules = rules;
+        this.meta = meta;
+    }
+    /**
+     * Check if a child can be inserted into a parent
+     *
+     * @param parent - Parent block (null for root level)
+     * @param childType - Type of child block to insert
+     * @param currentDepth - Current nesting depth
+     * @returns Validation result
+     */
+    canInsert(parent, childType, currentDepth = 0) {
+        const errors = [];
+        // Check if child type is registered
+        const childDef = this.meta.get(childType);
+        if (!childDef) {
+            errors.push({
+                code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,
+                message: `Unknown block type: ${childType}`,
+                suggestion: 'Use a registered block type',
+            });
+            return { valid: false, errors };
+        }
+        // Root level insertion
+        if (parent === null) {
+            return { valid: true, errors: [] };
+        }
+        // Get parent definition
+        const parentDef = this.meta.get(parent.type);
+        if (!parentDef) {
+            errors.push({
+                code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,
+                message: `Unknown parent block type: ${parent.type}`,
+                blockId: parent.id,
+            });
+            return { valid: false, errors };
+        }
+        // Check if parent can have children
+        if (!parentDef.canHaveChildren) {
+            errors.push({
+                code: CompositionErrorCode.NO_CHILDREN_ALLOWED,
+                message: `${parentDef.name} blocks cannot have children`,
+                blockId: parent.id,
+                suggestion: `Place the ${childDef.name} block outside of ${parentDef.name}`,
+            });
+            return { valid: false, errors };
+        }
+        // Check depth limit
+        if (currentDepth >= MAX_NESTING_DEPTH) {
+            errors.push({
+                code: CompositionErrorCode.MAX_DEPTH_EXCEEDED,
+                message: `Maximum nesting depth (${MAX_NESTING_DEPTH}) exceeded`,
+                blockId: parent.id,
+                suggestion: 'Reduce nesting or restructure your layout',
+            });
+            return { valid: false, errors };
+        }
+        // Check allowed children
+        if (parentDef.allowedChildren && !parentDef.allowedChildren.includes(childType)) {
+            errors.push({
+                code: CompositionErrorCode.INVALID_CHILD,
+                message: `${childDef.name} is not allowed inside ${parentDef.name}`,
+                blockId: parent.id,
+                suggestion: `Allowed children: ${parentDef.allowedChildren.join(', ')}`,
+            });
+            return { valid: false, errors };
+        }
+        // Check allowed parents
+        if (childDef.allowedParents && !childDef.allowedParents.includes(parent.type)) {
+            errors.push({
+                code: CompositionErrorCode.INVALID_PARENT,
+                message: `${childDef.name} should be placed inside ${childDef.allowedParents.join(' or ')}`,
+                blockId: parent.id,
+                suggestion: `Move the ${childDef.name} into a ${childDef.allowedParents[0]}`,
+            });
+            // This is a warning, not a hard error
+            return { valid: true, errors };
+        }
+        // Check grid-specific rules (no nested grids)
+        if (parent.type === 'grid' && childType === 'grid') {
+            errors.push({
+                code: CompositionErrorCode.INVALID_CHILD,
+                message: 'Grids cannot contain other grids as direct children',
+                blockId: parent.id,
+                suggestion: 'Wrap the inner grid in a container first',
+            });
+            return { valid: false, errors };
+        }
+        return { valid: true, errors: [] };
+    }
+    /**
+     * Check if a block can be moved to a new parent
+     *
+     * @param block - Block to move
+     * @param newParent - New parent block (null for root level)
+     * @param currentDepth - Current nesting depth
+     * @returns Validation result
+     */
+    canMove(block, newParent, currentDepth = 0) {
+        const errors = [];
+        // Check for self-nesting
+        if (newParent && this.isDescendantOf(newParent, block)) {
+            errors.push({
+                code: CompositionErrorCode.SELF_NESTING,
+                message: 'Cannot move a block into itself or its descendants',
+                blockId: block.id,
+                suggestion: 'Choose a different location',
+            });
+            return { valid: false, errors };
+        }
+        // Use canInsert for other validations
+        return this.canInsert(newParent, block.type, currentDepth);
+    }
+    /**
+     * Validate an entire block tree
+     *
+     * @param blocks - Root level blocks to validate
+     * @returns Array of validation errors
+     */
+    validateTree(blocks) {
+        const errors = [];
+        const validateBlock = (block, parent, depth) => {
+            // Check block type
+            const def = this.meta.get(block.type);
+            if (!def) {
+                errors.push({
+                    code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,
+                    message: `Unknown block type: ${block.type}`,
+                    blockId: block.id,
+                });
+                return;
+            }
+            // Validate insertion
+            if (parent !== null) {
+                if (depth >= MAX_NESTING_DEPTH) {
+                    errors.push({
+                        code: CompositionErrorCode.MAX_DEPTH_EXCEEDED,
+                        message: `Block at depth ${depth} exceeds maximum nesting depth (${MAX_NESTING_DEPTH})`,
+                        blockId: block.id,
+                        suggestion: 'Reduce nesting or restructure your layout',
+                    });
+                }
+                else {
+                    const insertResult = this.canInsert(parent, block.type, depth);
+                    errors.push(...insertResult.errors);
+                }
+            }
+            // Recursively validate children
+            if (block.children) {
+                // Check if block can have children
+                if (!def.canHaveChildren && block.children.length > 0) {
+                    errors.push({
+                        code: CompositionErrorCode.NO_CHILDREN_ALLOWED,
+                        message: `${def.name} blocks cannot have children`,
+                        blockId: block.id,
+                        suggestion: 'Remove children from this block',
+                    });
+                }
+                for (const child of block.children) {
+                    validateBlock(child, block, depth + 1);
+                }
+            }
+        };
+        for (const block of blocks) {
+            validateBlock(block, null, 0);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Get the depth of a block in a tree
+     *
+     * @param blocks - Root level blocks
+     * @param targetId - ID of block to find
+     * @returns Depth of block or -1 if not found
+     */
+    getBlockDepth(blocks, targetId) {
+        const findDepth = (blockList, currentDepth) => {
+            for (const block of blockList) {
+                if (block.id === targetId) {
+                    return currentDepth;
+                }
+                if (block.children) {
+                    const found = findDepth(block.children, currentDepth + 1);
+                    if (found >= 0)
+                        return found;
+                }
+            }
+            return -1;
+        };
+        return findDepth(blocks, 0);
+    }
+    /**
+     * Check if a block is a descendant of another block
+     *
+     * @param block - Block to check descendants of
+     * @param potentialAncestor - Potential ancestor block
+     * @returns True if block is a descendant
+     */
+    isDescendantOf(block, potentialAncestor) {
+        if (block.id === potentialAncestor.id) {
+            return true;
+        }
+        if (potentialAncestor.children) {
+            for (const child of potentialAncestor.children) {
+                if (this.isDescendantOf(block, child)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+// ============================================================
+// SINGLETON INSTANCE
+// ============================================================
+/**
+ * Default composition rule engine singleton
+ */
+export const compositionRuleEngine = new CompositionRuleEngine();
+/**
+ * Get the default composition rule engine
+ *
+ * @returns The default rule engine instance
+ */
+export function getCompositionRuleEngine() {
+    return compositionRuleEngine;
+}
+/**
+ * Create a new composition rule engine
+ *
+ * @param rules - Optional custom rules
+ * @param meta - Optional block metadata provider
+ * @returns New rule engine instance
+ */
+export function createCompositionRuleEngine(rules, meta) {
+    return new CompositionRuleEngine(rules, meta);
+}
+// ============================================================
+// CONVENIENCE FUNCTIONS
+// ============================================================
+/**
+ * Check if a block can be inserted (convenience function)
+ */
+export function canInsertBlock(parent, childType, currentDepth = 0) {
+    return compositionRuleEngine.canInsert(parent, childType, currentDepth);
+}
+/**
+ * Check if a block can be moved (convenience function)
+ */
+export function canMoveBlock(block, newParent, currentDepth = 0) {
+    return compositionRuleEngine.canMove(block, newParent, currentDepth);
+}
+/**
+ * Validate a block tree (convenience function)
+ */
+export function validateBlockTree(blocks) {
+    return compositionRuleEngine.validateTree(blocks);
+}
+//# sourceMappingURL=rule-engine.js.map

package/dist/blocks/rule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.js","sourceRoot":"","sources":["../../src/blocks/rule-engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Composition Rule Engine\n *\n * CP7: Validation engine for block compositions\n * Block metadata accessor is now an injectable provider so\n * web-side editor flows can supply install-aware data without depending on\n * the populated runtime singleton.\n *\n * @module @pwfabric/core/blocks/rule-engine\n */\n\nimport type {\n  Block,\n  BlockValidationResult as ValidationResult,\n  BlockValidationError as ValidationError,\n  CompositionRule,\n  BlockDefinition,\n} from '@pwfabric/core'\nimport { MAX_NESTING_DEPTH } from '@pwfabric/core'\nimport { blockRegistry } from './registry.js'\nimport { compositionRules } from './composition-rules.js'\n\n// ============================================================\n// BLOCK META PROVIDER\n// ============================================================\n\n/**\n * Snapshot of the block metadata the rule engine consults during\n * validation. A subset of `BlockDefinition` — only the fields that\n * affect composition decisions (name + child/parent rules).\n */\nexport interface BlockMetaSnapshot {\n  readonly type: string\n  readonly name: string\n  readonly canHaveChildren: boolean\n  readonly allowedChildren?: readonly string[]\n  readonly allowedParents?: readonly string[]\n}\n\n/**\n * Pluggable block metadata accessor. The default implementation is a\n * thin adapter over the legacy `blockRegistry` singleton; install-aware\n * editor flows construct their own provider that wraps\n * `useInstalledAtoms` data.\n */\nexport interface BlockMetaProvider {\n  get(type: string): BlockMetaSnapshot | undefined\n}\n\nfunction definitionToSnapshot(def: BlockDefinition): BlockMetaSnapshot {\n  return {\n    type: def.type,\n    name: def.name,\n    canHaveChildren: def.canHaveChildren,\n    ...(def.allowedChildren !== undefined ? { allowedChildren: def.allowedChildren } : {}),\n    ...(def.allowedParents !== undefined ? { allowedParents: def.allowedParents } : {}),\n  }\n}\n\n/**\n * Default provider — reads from the runtime `blockRegistry` singleton.\n * Returns `undefined` for types absent from the singleton (post-\n * the singleton is empty by default).\n */\nexport const defaultBlockMetaProvider: BlockMetaProvider = {\n  get(type: string): BlockMetaSnapshot | undefined {\n    const def = blockRegistry.get(type)\n    return def ? definitionToSnapshot(def) : undefined\n  },\n}\n\n// ============================================================\n// ERROR CODES\n// ============================================================\n\nexport const CompositionErrorCode = {\n  MAX_DEPTH_EXCEEDED: 'MAX_DEPTH_EXCEEDED',\n  INVALID_CHILD: 'INVALID_CHILD',\n  INVALID_PARENT: 'INVALID_PARENT',\n  NO_CHILDREN_ALLOWED: 'NO_CHILDREN_ALLOWED',\n  SELF_NESTING: 'SELF_NESTING',\n  UNKNOWN_BLOCK_TYPE: 'UNKNOWN_BLOCK_TYPE',\n  ORPHANED_BLOCK: 'ORPHANED_BLOCK',\n} as const\n\nexport type CompositionErrorCodeType =\n  (typeof CompositionErrorCode)[keyof typeof CompositionErrorCode]\n\n// ============================================================\n// RULE ENGINE CLASS\n// ============================================================\n\n/**\n * Composition Rule Engine\n *\n * Validates block compositions against defined rules.\n */\nexport class CompositionRuleEngine {\n  /** Rules for this engine instance (reserved for future custom rule support) */\n  readonly rules: readonly CompositionRule[]\n  /** Block metadata accessor */\n  readonly meta: BlockMetaProvider\n\n  constructor(\n    rules: readonly CompositionRule[] = compositionRules,\n    meta: BlockMetaProvider = defaultBlockMetaProvider\n  ) {\n    this.rules = rules\n    this.meta = meta\n  }\n\n  /**\n   * Check if a child can be inserted into a parent\n   *\n   * @param parent - Parent block (null for root level)\n   * @param childType - Type of child block to insert\n   * @param currentDepth - Current nesting depth\n   * @returns Validation result\n   */\n  canInsert(parent: Block | null, childType: string, currentDepth = 0): ValidationResult {\n    const errors: ValidationError[] = []\n\n    // Check if child type is registered\n    const childDef = this.meta.get(childType)\n    if (!childDef) {\n      errors.push({\n        code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,\n        message: `Unknown block type: ${childType}`,\n        suggestion: 'Use a registered block type',\n      })\n      return { valid: false, errors }\n    }\n\n    // Root level insertion\n    if (parent === null) {\n      return { valid: true, errors: [] }\n    }\n\n    // Get parent definition\n    const parentDef = this.meta.get(parent.type)\n    if (!parentDef) {\n      errors.push({\n        code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,\n        message: `Unknown parent block type: ${parent.type}`,\n        blockId: parent.id,\n      })\n      return { valid: false, errors }\n    }\n\n    // Check if parent can have children\n    if (!parentDef.canHaveChildren) {\n      errors.push({\n        code: CompositionErrorCode.NO_CHILDREN_ALLOWED,\n        message: `${parentDef.name} blocks cannot have children`,\n        blockId: parent.id,\n        suggestion: `Place the ${childDef.name} block outside of ${parentDef.name}`,\n      })\n      return { valid: false, errors }\n    }\n\n    // Check depth limit\n    if (currentDepth >= MAX_NESTING_DEPTH) {\n      errors.push({\n        code: CompositionErrorCode.MAX_DEPTH_EXCEEDED,\n        message: `Maximum nesting depth (${MAX_NESTING_DEPTH}) exceeded`,\n        blockId: parent.id,\n        suggestion: 'Reduce nesting or restructure your layout',\n      })\n      return { valid: false, errors }\n    }\n\n    // Check allowed children\n    if (parentDef.allowedChildren && !parentDef.allowedChildren.includes(childType)) {\n      errors.push({\n        code: CompositionErrorCode.INVALID_CHILD,\n        message: `${childDef.name} is not allowed inside ${parentDef.name}`,\n        blockId: parent.id,\n        suggestion: `Allowed children: ${parentDef.allowedChildren.join(', ')}`,\n      })\n      return { valid: false, errors }\n    }\n\n    // Check allowed parents\n    if (childDef.allowedParents && !childDef.allowedParents.includes(parent.type)) {\n      errors.push({\n        code: CompositionErrorCode.INVALID_PARENT,\n        message: `${childDef.name} should be placed inside ${childDef.allowedParents.join(' or ')}`,\n        blockId: parent.id,\n        suggestion: `Move the ${childDef.name} into a ${childDef.allowedParents[0]}`,\n      })\n      // This is a warning, not a hard error\n      return { valid: true, errors }\n    }\n\n    // Check grid-specific rules (no nested grids)\n    if (parent.type === 'grid' && childType === 'grid') {\n      errors.push({\n        code: CompositionErrorCode.INVALID_CHILD,\n        message: 'Grids cannot contain other grids as direct children',\n        blockId: parent.id,\n        suggestion: 'Wrap the inner grid in a container first',\n      })\n      return { valid: false, errors }\n    }\n\n    return { valid: true, errors: [] }\n  }\n\n  /**\n   * Check if a block can be moved to a new parent\n   *\n   * @param block - Block to move\n   * @param newParent - New parent block (null for root level)\n   * @param currentDepth - Current nesting depth\n   * @returns Validation result\n   */\n  canMove(block: Block, newParent: Block | null, currentDepth = 0): ValidationResult {\n    const errors: ValidationError[] = []\n\n    // Check for self-nesting\n    if (newParent && this.isDescendantOf(newParent, block)) {\n      errors.push({\n        code: CompositionErrorCode.SELF_NESTING,\n        message: 'Cannot move a block into itself or its descendants',\n        blockId: block.id,\n        suggestion: 'Choose a different location',\n      })\n      return { valid: false, errors }\n    }\n\n    // Use canInsert for other validations\n    return this.canInsert(newParent, block.type, currentDepth)\n  }\n\n  /**\n   * Validate an entire block tree\n   *\n   * @param blocks - Root level blocks to validate\n   * @returns Array of validation errors\n   */\n  validateTree(blocks: readonly Block[]): ValidationResult {\n    const errors: ValidationError[] = []\n\n    const validateBlock = (block: Block, parent: Block | null, depth: number): void => {\n      // Check block type\n      const def = this.meta.get(block.type)\n      if (!def) {\n        errors.push({\n          code: CompositionErrorCode.UNKNOWN_BLOCK_TYPE,\n          message: `Unknown block type: ${block.type}`,\n          blockId: block.id,\n        })\n        return\n      }\n\n      // Validate insertion\n      if (parent !== null) {\n        if (depth >= MAX_NESTING_DEPTH) {\n          errors.push({\n            code: CompositionErrorCode.MAX_DEPTH_EXCEEDED,\n            message: `Block at depth ${depth} exceeds maximum nesting depth (${MAX_NESTING_DEPTH})`,\n            blockId: block.id,\n            suggestion: 'Reduce nesting or restructure your layout',\n          })\n        } else {\n          const insertResult = this.canInsert(parent, block.type, depth)\n          errors.push(...insertResult.errors)\n        }\n      }\n\n      // Recursively validate children\n      if (block.children) {\n        // Check if block can have children\n        if (!def.canHaveChildren && block.children.length > 0) {\n          errors.push({\n            code: CompositionErrorCode.NO_CHILDREN_ALLOWED,\n            message: `${def.name} blocks cannot have children`,\n            blockId: block.id,\n            suggestion: 'Remove children from this block',\n          })\n        }\n\n        for (const child of block.children) {\n          validateBlock(child, block, depth + 1)\n        }\n      }\n    }\n\n    for (const block of blocks) {\n      validateBlock(block, null, 0)\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    }\n  }\n\n  /**\n   * Get the depth of a block in a tree\n   *\n   * @param blocks - Root level blocks\n   * @param targetId - ID of block to find\n   * @returns Depth of block or -1 if not found\n   */\n  getBlockDepth(blocks: readonly Block[], targetId: string): number {\n    const findDepth = (blockList: readonly Block[], currentDepth: number): number => {\n      for (const block of blockList) {\n        if (block.id === targetId) {\n          return currentDepth\n        }\n        if (block.children) {\n          const found = findDepth(block.children, currentDepth + 1)\n          if (found >= 0) return found\n        }\n      }\n      return -1\n    }\n\n    return findDepth(blocks, 0)\n  }\n\n  /**\n   * Check if a block is a descendant of another block\n   *\n   * @param block - Block to check descendants of\n   * @param potentialAncestor - Potential ancestor block\n   * @returns True if block is a descendant\n   */\n  private isDescendantOf(block: Block, potentialAncestor: Block): boolean {\n    if (block.id === potentialAncestor.id) {\n      return true\n    }\n\n    if (potentialAncestor.children) {\n      for (const child of potentialAncestor.children) {\n        if (this.isDescendantOf(block, child)) {\n          return true\n        }\n      }\n    }\n\n    return false\n  }\n}\n\n// ============================================================\n// SINGLETON INSTANCE\n// ============================================================\n\n/**\n * Default composition rule engine singleton\n */\nexport const compositionRuleEngine = new CompositionRuleEngine()\n\n/**\n * Get the default composition rule engine\n *\n * @returns The default rule engine instance\n */\nexport function getCompositionRuleEngine(): CompositionRuleEngine {\n  return compositionRuleEngine\n}\n\n/**\n * Create a new composition rule engine\n *\n * @param rules - Optional custom rules\n * @param meta - Optional block metadata provider\n * @returns New rule engine instance\n */\nexport function createCompositionRuleEngine(\n  rules?: readonly CompositionRule[],\n  meta?: BlockMetaProvider\n): CompositionRuleEngine {\n  return new CompositionRuleEngine(rules, meta)\n}\n\n// ============================================================\n// CONVENIENCE FUNCTIONS\n// ============================================================\n\n/**\n * Check if a block can be inserted (convenience function)\n */\nexport function canInsertBlock(\n  parent: Block | null,\n  childType: string,\n  currentDepth = 0\n): ValidationResult {\n  return compositionRuleEngine.canInsert(parent, childType, currentDepth)\n}\n\n/**\n * Check if a block can be moved (convenience function)\n */\nexport function canMoveBlock(\n  block: Block,\n  newParent: Block | null,\n  currentDepth = 0\n): ValidationResult {\n  return compositionRuleEngine.canMove(block, newParent, currentDepth)\n}\n\n/**\n * Validate a block tree (convenience function)\n */\nexport function validateBlockTree(blocks: readonly Block[]): ValidationResult {\n  return compositionRuleEngine.validateTree(blocks)\n}\n"]}

package/dist/blocks/surface-event-context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Surface Event Context
+ *
+ * React context that carries the SurfaceEventBus down the render tree
+ * so block components can emit events without prop-drilling.
+ *
+ * The default value is `null`; block components that call `useSurfaceEvents()`
+ * when no bus is provided simply no-op rather than throwing.
+ *
+ * @module @pwfabric/runtime/blocks/surface-event-context
+ */
+import type { SurfaceEventBus } from '@pwfabric/contracts';
+export declare const SurfaceEventContext: import("react").Context<SurfaceEventBus | null>;

package/dist/blocks/surface-event-context.js

@@ -0,0 +1,14 @@
+/**
+ * Surface Event Context
+ *
+ * React context that carries the SurfaceEventBus down the render tree
+ * so block components can emit events without prop-drilling.
+ *
+ * The default value is `null`; block components that call `useSurfaceEvents()`
+ * when no bus is provided simply no-op rather than throwing.
+ *
+ * @module @pwfabric/runtime/blocks/surface-event-context
+ */
+import { createContext } from 'react';
+export const SurfaceEventContext = createContext(null);
+//# sourceMappingURL=surface-event-context.js.map

package/dist/blocks/surface-event-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-event-context.js","sourceRoot":"","sources":["../../src/blocks/surface-event-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAGrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAA","sourcesContent":["/**\n * Surface Event Context\n *\n * React context that carries the SurfaceEventBus down the render tree\n * so block components can emit events without prop-drilling.\n *\n * The default value is `null`; block components that call `useSurfaceEvents()`\n * when no bus is provided simply no-op rather than throwing.\n *\n * @module @pwfabric/runtime/blocks/surface-event-context\n */\n\nimport { createContext } from 'react'\nimport type { SurfaceEventBus } from '@pwfabric/contracts'\n\nexport const SurfaceEventContext = createContext<SurfaceEventBus | null>(null)\n"]}

package/dist/blocks/surface-id-context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Surface ID Context
+ *
+ * React context that carries the current surface ID down the render tree
+ * so block components can include it in emitted events without prop-drilling.
+ *
+ * The default value is an empty string; blocks that read this context when
+ * no `BehaviorSurfaceProvider` is present will emit events with an empty
+ * surfaceId rather than throwing.
+ *
+ * @module @pwfabric/runtime/blocks/surface-id-context
+ */
+export declare const SurfaceIdContext: import("react").Context<string>;

package/dist/blocks/surface-id-context.js

@@ -0,0 +1,15 @@
+/**
+ * Surface ID Context
+ *
+ * React context that carries the current surface ID down the render tree
+ * so block components can include it in emitted events without prop-drilling.
+ *
+ * The default value is an empty string; blocks that read this context when
+ * no `BehaviorSurfaceProvider` is present will emit events with an empty
+ * surfaceId rather than throwing.
+ *
+ * @module @pwfabric/runtime/blocks/surface-id-context
+ */
+import { createContext } from 'react';
+export const SurfaceIdContext = createContext('');
+//# sourceMappingURL=surface-id-context.js.map

package/dist/blocks/surface-id-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-id-context.js","sourceRoot":"","sources":["../../src/blocks/surface-id-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAS,EAAE,CAAC,CAAA","sourcesContent":["/**\n * Surface ID Context\n *\n * React context that carries the current surface ID down the render tree\n * so block components can include it in emitted events without prop-drilling.\n *\n * The default value is an empty string; blocks that read this context when\n * no `BehaviorSurfaceProvider` is present will emit events with an empty\n * surfaceId rather than throwing.\n *\n * @module @pwfabric/runtime/blocks/surface-id-context\n */\n\nimport { createContext } from 'react'\n\nexport const SurfaceIdContext = createContext<string>('')\n"]}

package/dist/bus.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Event Bus
+ *
+ * Event bus for fabric communication
+ *
+ * @module @pwfabric/runtime/bus
+ */
+import type { BaseEvent, EventBus, EventHandler, EventSubscription, EventFilter, FabricEvent } from '@pwfabric/contracts';
+/**
+ * In-memory event bus implementation
+ */
+export declare class InMemoryEventBus implements EventBus {
+    private subscriptions;
+    private typeSubscriptions;
+    emit<E extends BaseEvent>(event: E): void;
+    subscribe<E extends BaseEvent>(handler: EventHandler<E>, filter?: EventFilter): EventSubscription;
+    on<E extends BaseEvent>(type: E['type'], handler: EventHandler<E>): EventSubscription;
+    once<E extends BaseEvent>(type: E['type'], handler: EventHandler<E>): EventSubscription;
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+    /**
+     * Get subscription count
+     */
+    subscriptionCount(): number;
+    private matchesFilter;
+    private invokeHandler;
+}
+/**
+ * Create a new event bus
+ */
+export declare function createEventBus(): EventBus;
+/**
+ * Helper to create a typed event
+ */
+export declare function createFabricEvent<T extends FabricEvent['type']>(type: T, data: Omit<Extract<FabricEvent, {
+    type: T;
+}>, 'id' | 'type' | 'timestamp'>): Extract<FabricEvent, {
+    type: T;
+}>;

package/dist/bus.js

@@ -0,0 +1,158 @@
+/**
+ * Event Bus
+ *
+ * Event bus for fabric communication
+ *
+ * @module @pwfabric/runtime/bus
+ */
+import { generateEventId } from '@pwfabric/contracts';
+/**
+ * In-memory event bus implementation
+ */
+export class InMemoryEventBus {
+    subscriptions = [];
+    typeSubscriptions = new Map();
+    emit(event) {
+        // Emit to type-specific subscribers
+        const typeHandlers = this.typeSubscriptions.get(event.type);
+        if (typeHandlers) {
+            for (const entry of typeHandlers) {
+                this.invokeHandler(entry.handler, event);
+            }
+        }
+        // Emit to general subscribers
+        for (const entry of this.subscriptions) {
+            if (this.matchesFilter(event, entry.filter)) {
+                this.invokeHandler(entry.handler, event);
+            }
+        }
+    }
+    subscribe(handler, filter) {
+        const entry = {
+            id: generateEventId(),
+            handler: handler,
+            filter,
+        };
+        this.subscriptions.push(entry);
+        return {
+            unsubscribe: () => {
+                const index = this.subscriptions.indexOf(entry);
+                if (index !== -1) {
+                    this.subscriptions.splice(index, 1);
+                }
+            },
+        };
+    }
+    on(type, handler) {
+        const entry = {
+            id: generateEventId(),
+            handler: handler,
+            filter: undefined,
+        };
+        let typeSet = this.typeSubscriptions.get(type);
+        if (!typeSet) {
+            typeSet = new Set();
+            this.typeSubscriptions.set(type, typeSet);
+        }
+        typeSet.add(entry);
+        return {
+            unsubscribe: () => {
+                const set = this.typeSubscriptions.get(type);
+                if (set) {
+                    set.delete(entry);
+                    if (set.size === 0) {
+                        this.typeSubscriptions.delete(type);
+                    }
+                }
+            },
+        };
+    }
+    once(type, handler) {
+        const subscription = this.on(type, (event) => {
+            subscription.unsubscribe();
+            handler(event);
+        });
+        return subscription;
+    }
+    /**
+     * Clear all subscriptions
+     */
+    clear() {
+        this.subscriptions = [];
+        this.typeSubscriptions.clear();
+    }
+    /**
+     * Get subscription count
+     */
+    subscriptionCount() {
+        let count = this.subscriptions.length;
+        for (const set of this.typeSubscriptions.values()) {
+            count += set.size;
+        }
+        return count;
+    }
+    matchesFilter(event, filter) {
+        if (!filter)
+            return true;
+        // Check type filter
+        if (filter.types && filter.types.length > 0) {
+            if (!filter.types.includes(event.type)) {
+                return false;
+            }
+        }
+        // Check source filter
+        if (filter.sources && filter.sources.length > 0) {
+            const eventSource = event.source;
+            const matches = filter.sources.some((source) => {
+                if (source.fabricId && source.fabricId !== eventSource.fabricId) {
+                    return false;
+                }
+                if (source.capabilityId && source.capabilityId !== eventSource.capabilityId) {
+                    return false;
+                }
+                if (source.domainId && source.domainId !== eventSource.domainId) {
+                    return false;
+                }
+                return true;
+            });
+            if (!matches)
+                return false;
+        }
+        return true;
+    }
+    invokeHandler(handler, event) {
+        try {
+            const result = handler(event);
+            // Handle async handlers - errors are swallowed but could be logged
+            if (result instanceof Promise) {
+                result.catch(() => {
+                    // Handler error - could log here
+                });
+            }
+        }
+        catch {
+            // Handler threw synchronously - could log here
+        }
+    }
+}
+/**
+ * Create a new event bus
+ */
+export function createEventBus() {
+    return new InMemoryEventBus();
+}
+// ============================================================
+// TYPED EVENT EMITTERS
+// ============================================================
+/**
+ * Helper to create a typed event
+ */
+export function createFabricEvent(type, data) {
+    return {
+        id: generateEventId(),
+        type,
+        timestamp: Date.now(),
+        ...data,
+    };
+}
+//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Event Bus\n *\n * Event bus for fabric communication\n *\n * @module @pwfabric/runtime/bus\n */\n\nimport type {\n  BaseEvent,\n  EventBus,\n  EventHandler,\n  EventSubscription,\n  EventFilter,\n  FabricEvent,\n} from '@pwfabric/contracts'\nimport { generateEventId } from '@pwfabric/contracts'\n\n// ============================================================\n// IN-MEMORY EVENT BUS IMPLEMENTATION\n// ============================================================\n\n/**\n * Subscription entry\n */\ninterface SubscriptionEntry {\n  readonly id: string\n  readonly handler: EventHandler<BaseEvent>\n  readonly filter: EventFilter | undefined\n}\n\n/**\n * In-memory event bus implementation\n */\nexport class InMemoryEventBus implements EventBus {\n  private subscriptions: SubscriptionEntry[] = []\n  private typeSubscriptions = new Map<string, Set<SubscriptionEntry>>()\n\n  emit<E extends BaseEvent>(event: E): void {\n    // Emit to type-specific subscribers\n    const typeHandlers = this.typeSubscriptions.get(event.type)\n    if (typeHandlers) {\n      for (const entry of typeHandlers) {\n        this.invokeHandler(entry.handler, event)\n      }\n    }\n\n    // Emit to general subscribers\n    for (const entry of this.subscriptions) {\n      if (this.matchesFilter(event, entry.filter)) {\n        this.invokeHandler(entry.handler, event)\n      }\n    }\n  }\n\n  subscribe<E extends BaseEvent>(\n    handler: EventHandler<E>,\n    filter?: EventFilter\n  ): EventSubscription {\n    const entry: SubscriptionEntry = {\n      id: generateEventId(),\n      handler: handler as EventHandler<BaseEvent>,\n      filter,\n    }\n\n    this.subscriptions.push(entry)\n\n    return {\n      unsubscribe: () => {\n        const index = this.subscriptions.indexOf(entry)\n        if (index !== -1) {\n          this.subscriptions.splice(index, 1)\n        }\n      },\n    }\n  }\n\n  on<E extends BaseEvent>(type: E['type'], handler: EventHandler<E>): EventSubscription {\n    const entry: SubscriptionEntry = {\n      id: generateEventId(),\n      handler: handler as EventHandler<BaseEvent>,\n      filter: undefined,\n    }\n\n    let typeSet = this.typeSubscriptions.get(type)\n    if (!typeSet) {\n      typeSet = new Set()\n      this.typeSubscriptions.set(type, typeSet)\n    }\n    typeSet.add(entry)\n\n    return {\n      unsubscribe: () => {\n        const set = this.typeSubscriptions.get(type)\n        if (set) {\n          set.delete(entry)\n          if (set.size === 0) {\n            this.typeSubscriptions.delete(type)\n          }\n        }\n      },\n    }\n  }\n\n  once<E extends BaseEvent>(type: E['type'], handler: EventHandler<E>): EventSubscription {\n    const subscription = this.on(type, (event) => {\n      subscription.unsubscribe()\n      handler(event as E)\n    })\n    return subscription\n  }\n\n  /**\n   * Clear all subscriptions\n   */\n  clear(): void {\n    this.subscriptions = []\n    this.typeSubscriptions.clear()\n  }\n\n  /**\n   * Get subscription count\n   */\n  subscriptionCount(): number {\n    let count = this.subscriptions.length\n    for (const set of this.typeSubscriptions.values()) {\n      count += set.size\n    }\n    return count\n  }\n\n  private matchesFilter(event: BaseEvent, filter?: EventFilter): boolean {\n    if (!filter) return true\n\n    // Check type filter\n    if (filter.types && filter.types.length > 0) {\n      if (!filter.types.includes(event.type)) {\n        return false\n      }\n    }\n\n    // Check source filter\n    if (filter.sources && filter.sources.length > 0) {\n      const eventSource = event.source\n      const matches = filter.sources.some((source) => {\n        if (source.fabricId && source.fabricId !== eventSource.fabricId) {\n          return false\n        }\n        if (source.capabilityId && source.capabilityId !== eventSource.capabilityId) {\n          return false\n        }\n        if (source.domainId && source.domainId !== eventSource.domainId) {\n          return false\n        }\n        return true\n      })\n      if (!matches) return false\n    }\n\n    return true\n  }\n\n  private invokeHandler(handler: EventHandler<BaseEvent>, event: BaseEvent): void {\n    try {\n      const result = handler(event)\n      // Handle async handlers - errors are swallowed but could be logged\n      if (result instanceof Promise) {\n        result.catch(() => {\n          // Handler error - could log here\n        })\n      }\n    } catch {\n      // Handler threw synchronously - could log here\n    }\n  }\n}\n\n/**\n * Create a new event bus\n */\nexport function createEventBus(): EventBus {\n  return new InMemoryEventBus()\n}\n\n// ============================================================\n// TYPED EVENT EMITTERS\n// ============================================================\n\n/**\n * Helper to create a typed event\n */\nexport function createFabricEvent<T extends FabricEvent['type']>(\n  type: T,\n  data: Omit<Extract<FabricEvent, { type: T }>, 'id' | 'type' | 'timestamp'>\n): Extract<FabricEvent, { type: T }> {\n  return {\n    id: generateEventId(),\n    type,\n    timestamp: Date.now(),\n    ...data,\n  } as Extract<FabricEvent, { type: T }>\n}\n"]}

package/dist/cache/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cache Module
+ *
+ * Caching system for binding and data
+ *
+ * @module @pwfabric/runtime/cache
+ */
+export type { CacheProvider, CacheStats, CacheEntry, CacheConfig } from './types.js';
+export { InMemoryCache, createMemoryCache } from './memory.js';