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

package/dist/index.js

@@ -0,0 +1,95 @@
+/**
+ * @pwfabric/runtime
+ *
+ * Runtime and execution engine for the PWFabric platform.
+ *
+ * Runtime spine implementation
+ * Surface rendering pipeline, layout system, primitives
+ * Binding engine, auth, cache, graph resolver
+ *
+ * @module @pwfabric/runtime
+ */
+// Re-export contracts for convenience
+export * from '@pwfabric/contracts';
+// Fabric kernel
+export { FabricKernel, createFabric } from './kernel.js';
+// Capability registry
+export { InMemoryCapabilityRegistry, createRegistry } from './registry.js';
+// Contract validator
+export { RuntimeContractValidator, createValidator, isValidationSuccess, isValidationFailure, formatValidationErrors, } from './validator.js';
+// Event bus
+export { InMemoryEventBus, createEventBus, createFabricEvent } from './bus.js';
+// Execution context
+export { RuntimeExecutionContext, ConsoleExecutionLogger, NoOpExecutionLogger, createExecutionContext, generateTraceId, generateSpanId, } from './execution-context.js';
+// Legacy exports (for backward compatibility)
+export * from './context.js';
+export * from './executor.js';
+// Surface rendering pipeline
+export * from './surface/index.js';
+// Binding, cache, graph
+export * from './binding/index.js';
+export * from './cache/index.js';
+export * from './graph/index.js';
+// Auth is intentionally NOT part of the default export: it holds the
+// MSAL/API-key providers, and pulling them into the default barrel would make
+// every consumer of `.` — including `@pwfabric/embed`'s browser-facing IIFE
+// build — carry them along. Available explicitly via `@pwfabric/runtime/auth`.
+// State and forms capabilities
+export * from './state/index.js';
+export * from './forms/index.js';
+// Entity system
+export * from './entity/index.js';
+// Connector engine loading + registry (platform-side
+// execution of CONNECTOR/PROVIDER atom engines)
+export * from './connectors/index.js';
+export { SurfaceConnectionsContext, useSurfaceConnections } from './render/index.js';
+export { EntitlementProvider, useEntitlements, GatedBlockPlaceholder } from './render/index.js';
+export { BlockModuleLoader, DynamicBlockWrapper, DynamicArtifactProvider, preloadDynamicBlocks, useDynamicBlocks, useDynamicStarters, } from './render/index.js';
+// Block Error Boundary (crash isolation)
+export { BlockErrorBoundary } from './render/index.js';
+export { dataSourceCacheKey } from './render/index.js';
+// Surface event protocol
+export { createSurfaceEventBus } from './render/index.js';
+export { SurfaceEventContext } from './render/index.js';
+export { useSurfaceEvents } from './render/index.js';
+export { BehaviorSurfaceProvider } from './render/index.js';
+export { SurfaceIdContext } from './render/index.js';
+export { useSurfaceId } from './render/index.js';
+export { ShellSelectionContext, ShellSelectionProvider, createShellSelectionStore, useShellSelection, } from './render/index.js';
+// Image Adapters
+export { DefaultImageAdapter, NextImageAdapter } from './adapters/index.js';
+export { SurfaceRenderer as BlockSurfaceRenderer, BlockRenderer, getBlockIds, findBlockById, updateBlockById, DataBoundSurfaceRenderer, surfaceNeedsDataBinding, blockActionsOf, resolveEndpoint, resolveBlockExpressions, resolveString, surfaceThemeToCSS, } from './render/index.js';
+// legacy first-party `*Block` component re-exports +
+// `defaultBlockComponents` map retired. Production rendering loads
+// components from CDN bundles via `BlockModuleLoader`; the static
+// component registry no longer ships from this package.
+// Capability system (definitions, type mapping, validation)
+export * from './capability/index.js';
+// Data, routing, SEO, analytics, i18n capabilities
+export * from './data/index.js';
+export * from './routing/index.js';
+export * from './seo/index.js';
+export * from './analytics/index.js';
+export * from './i18n/index.js';
+export { WebVitalsCollector, createWebVitalsCollector, rateMetric, RenderTimer, createRenderTimer, DEFAULT_BUDGET, BudgetChecker, createBudgetChecker, PerformanceReporter, createPerformanceReporter, } from './perf/index.js';
+export { LiveRegionAnnouncer, createAnnouncer } from './a11y/index.js';
+export { FocusTrapManager, FocusRestorer, createSkipLink, createFocusTrap, createFocusRestorer, } from './a11y/index.js';
+export { KeyboardNavigationManager, RovingTabIndex, createKeyboardNav, createRovingTabIndex, } from './a11y/index.js';
+export { hexToRgb, relativeLuminance, contrastRatio, checkContrast, meetsWCAG, } from './a11y/index.js';
+// tenant-scoped pack atom registry hook
+export { useInstalledAtoms, } from './hooks/useInstalledAtoms.js';
+// The engine names no tenant: a host's tenant model (plan, entitlements,
+// storage, installations) belongs to the host.
+//
+// What the engine offers is the mechanism without the vocabulary: `EntitlementProvider`
+// and `useEntitlements` in ./render/capability-gate.tsx still enforce a claim
+// set, typed structurally as `EntitlementClaims`.
+// canonical home for block infrastructure (registry,
+// composition rules, rule engine, contexts, hooks, default block
+// components, schemas, 45 first-party block defs). Subpath import
+// `@pwfabric/runtime/blocks` is the recommended consumer entry; the root
+// re-exports above (SurfaceEventContext / useSurfaceEvents /
+// SurfaceIdContext / useSurfaceId / defaultBlockComponents / 21 block
+// components) now resolve via `runtime/render/*` → `runtime/blocks/*`
+// preserving React-context identity.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @pwfabric/runtime\n *\n * Runtime and execution engine for the PWFabric platform.\n *\n * Runtime spine implementation\n * Surface rendering pipeline, layout system, primitives\n * Binding engine, auth, cache, graph resolver\n *\n * @module @pwfabric/runtime\n */\n\n// Re-export contracts for convenience\nexport * from '@pwfabric/contracts'\n\n// Fabric kernel\nexport { FabricKernel, createFabric } from './kernel.js'\n\n// Capability registry\nexport { type CapabilityRegistry, InMemoryCapabilityRegistry, createRegistry } from './registry.js'\n\n// Contract validator\nexport {\n  type ContractValidator,\n  RuntimeContractValidator,\n  createValidator,\n  isValidationSuccess,\n  isValidationFailure,\n  formatValidationErrors,\n} from './validator.js'\n\n// Event bus\nexport { InMemoryEventBus, createEventBus, createFabricEvent } from './bus.js'\n\n// Execution context\nexport {\n  type InvocationHandler,\n  RuntimeExecutionContext,\n  ConsoleExecutionLogger,\n  NoOpExecutionLogger,\n  createExecutionContext,\n  generateTraceId,\n  generateSpanId,\n  type CreateExecutionContextOptions,\n} from './execution-context.js'\n\n// Legacy exports (for backward compatibility)\nexport * from './context.js'\nexport * from './executor.js'\n\n// Surface rendering pipeline\nexport * from './surface/index.js'\n\n// Binding, cache, graph\nexport * from './binding/index.js'\nexport * from './cache/index.js'\nexport * from './graph/index.js'\n\n// Auth is intentionally NOT part of the default export: it holds the\n// MSAL/API-key providers, and pulling them into the default barrel would make\n// every consumer of `.` — including `@pwfabric/embed`'s browser-facing IIFE\n// build — carry them along. Available explicitly via `@pwfabric/runtime/auth`.\n\n// State and forms capabilities\nexport * from './state/index.js'\nexport * from './forms/index.js'\n\n// Entity system\nexport * from './entity/index.js'\n\n// Connector engine loading + registry (platform-side\n// execution of CONNECTOR/PROVIDER atom engines)\nexport * from './connectors/index.js'\nexport { SurfaceConnectionsContext, useSurfaceConnections } from './render/index.js'\n\n// Surface renderer (avoiding duplicates with surface/index.js)\nexport type {\n  BlockComponentProps,\n  BlockComponent,\n  BlockComponentRegistry,\n  CapabilityProvider,\n  BlockContext,\n  SurfaceEventType,\n  SurfaceEvent,\n  SurfaceRendererProps,\n  BlockRendererProps,\n  RenderableSurface,\n  CapabilityType,\n  ImageAdapter,\n  ImageAdapterProps,\n  SurfaceDataSourceKind,\n  SurfaceDataSourceDefinition,\n  SurfaceActionType,\n  SurfaceAction,\n  BlockActionProp,\n  DataBoundSurface,\n  DataBoundSurfaceRendererProps,\n} from './render/index.js'\n\n// Capability Gate (Entitlement enforcement)\nexport type {\n  EntitlementContextValue,\n  EntitlementProviderProps,\n  GatedBlockPlaceholderProps,\n} from './render/index.js'\nexport { EntitlementProvider, useEntitlements, GatedBlockPlaceholder } from './render/index.js'\n\n// Dynamic Artifact Loading\nexport type {\n  DynamicBlockWrapperProps,\n  DynamicArtifactContextValue,\n  DynamicArtifactProviderProps,\n} from './render/index.js'\nexport {\n  BlockModuleLoader,\n  DynamicBlockWrapper,\n  DynamicArtifactProvider,\n  preloadDynamicBlocks,\n  useDynamicBlocks,\n  useDynamicStarters,\n} from './render/index.js'\n\n// Block Error Boundary (crash isolation)\nexport { BlockErrorBoundary } from './render/index.js'\nexport { dataSourceCacheKey } from './render/index.js'\nexport type { SurfaceDataCache } from './render/index.js'\n\n// Surface event protocol\nexport { createSurfaceEventBus } from './render/index.js'\nexport { SurfaceEventContext } from './render/index.js'\nexport { useSurfaceEvents } from './render/index.js'\n\n// BehaviorSurfaceProvider — runtime surface wiring\nexport type { BehaviorSurfaceProviderProps } from './render/index.js'\nexport { BehaviorSurfaceProvider } from './render/index.js'\nexport { SurfaceIdContext } from './render/index.js'\nexport { useSurfaceId } from './render/index.js'\n\n// Shell × body: SPLIT shell selection (URL-projected), and the shell/body\n// classification the renderer lays out by.\nexport type {\n  ShellSelectionStore,\n  ShellSelectionOptions,\n  ShellSelectionProviderProps,\n} from './render/index.js'\nexport {\n  ShellSelectionContext,\n  ShellSelectionProvider,\n  createShellSelectionStore,\n  useShellSelection,\n} from './render/index.js'\n\n// Image Adapters\nexport { DefaultImageAdapter, NextImageAdapter } from './adapters/index.js'\nexport {\n  SurfaceRenderer as BlockSurfaceRenderer,\n  BlockRenderer,\n  getBlockIds,\n  findBlockById,\n  updateBlockById,\n  DataBoundSurfaceRenderer,\n  surfaceNeedsDataBinding,\n  blockActionsOf,\n  resolveEndpoint,\n  resolveBlockExpressions,\n  resolveString,\n  surfaceThemeToCSS,\n} from './render/index.js'\n// legacy first-party `*Block` component re-exports +\n// `defaultBlockComponents` map retired. Production rendering loads\n// components from CDN bundles via `BlockModuleLoader`; the static\n// component registry no longer ships from this package.\n\n// Capability system (definitions, type mapping, validation)\nexport * from './capability/index.js'\n\n// Data, routing, SEO, analytics, i18n capabilities\nexport * from './data/index.js'\nexport * from './routing/index.js'\nexport * from './seo/index.js'\nexport * from './analytics/index.js'\nexport * from './i18n/index.js'\n\n// Performance monitoring module\nexport type {\n  WebVitalName,\n  WebVitalRating,\n  WebVitalMetric,\n  WebVitalCallback,\n  WebVitalsReport,\n  RenderMetrics,\n  RenderTimerConfig,\n  PerformanceBudget,\n  BudgetViolation,\n  BudgetCheckResult,\n  ReportDestination,\n  ReporterConfig,\n  PerformanceReport,\n} from './perf/index.js'\nexport {\n  WebVitalsCollector,\n  createWebVitalsCollector,\n  rateMetric,\n  RenderTimer,\n  createRenderTimer,\n  DEFAULT_BUDGET,\n  BudgetChecker,\n  createBudgetChecker,\n  PerformanceReporter,\n  createPerformanceReporter,\n} from './perf/index.js'\n\n// Accessibility (a11y) module\nexport type { AnnouncementLevel, LiveRegionConfig } from './a11y/index.js'\nexport { LiveRegionAnnouncer, createAnnouncer } from './a11y/index.js'\nexport type { FocusTrapConfig } from './a11y/index.js'\nexport {\n  FocusTrapManager,\n  FocusRestorer,\n  createSkipLink,\n  createFocusTrap,\n  createFocusRestorer,\n} from './a11y/index.js'\nexport type { ArrowDirection, KeyboardNavConfig } from './a11y/index.js'\nexport {\n  KeyboardNavigationManager,\n  RovingTabIndex,\n  createKeyboardNav,\n  createRovingTabIndex,\n} from './a11y/index.js'\nexport type { ContrastResult } from './a11y/index.js'\nexport {\n  hexToRgb,\n  relativeLuminance,\n  contrastRatio,\n  checkContrast,\n  meetsWCAG,\n} from './a11y/index.js'\n\n// tenant-scoped pack atom registry hook\nexport {\n  useInstalledAtoms,\n  type InstalledAtomDescriptor,\n  type InstalledAtomKind,\n  type InstalledAtomsState,\n  type InstalledAtomsFetcher,\n  type AtomManifestPayload,\n  type AtomBlockDefinitionMetadata,\n} from './hooks/useInstalledAtoms.js'\n\n// The engine names no tenant: a host's tenant model (plan, entitlements,\n// storage, installations) belongs to the host.\n//\n// What the engine offers is the mechanism without the vocabulary: `EntitlementProvider`\n// and `useEntitlements` in ./render/capability-gate.tsx still enforce a claim\n// set, typed structurally as `EntitlementClaims`.\n\n// canonical home for block infrastructure (registry,\n// composition rules, rule engine, contexts, hooks, default block\n// components, schemas, 45 first-party block defs). Subpath import\n// `@pwfabric/runtime/blocks` is the recommended consumer entry; the root\n// re-exports above (SurfaceEventContext / useSurfaceEvents /\n// SurfaceIdContext / useSurfaceId / defaultBlockComponents / 21 block\n// components) now resolve via `runtime/render/*` → `runtime/blocks/*`\n// preserving React-context identity.\n"]}

package/dist/kernel.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Fabric Kernel
+ *
+ * Runtime kernel for fabric orchestration
+ *
+ * The Fabric Kernel is the core runtime that manages capability
+ * registration, dependency resolution, and execution lifecycle.
+ *
+ * @module @pwfabric/runtime/kernel
+ */
+import type { Fabric, FabricConfig, FabricState, FabricMetadata, FabricSnapshot, FabricId, CapabilityId, Capability, RegistrationResult, Resolution, ExecutionResult, ExecutionOptions, SemanticVersion, Timestamp, EventBus } from '@pwfabric/contracts';
+/**
+ * Fabric kernel implementation
+ */
+export declare class FabricKernel implements Fabric {
+    readonly id: FabricId;
+    readonly version: SemanticVersion;
+    readonly metadata: FabricMetadata;
+    readonly createdAt: Timestamp;
+    private _state;
+    private readonly registry;
+    private readonly validator;
+    private readonly eventBus;
+    private readonly config;
+    constructor(options?: FabricConfig);
+    get state(): FabricState;
+    register<C extends Capability>(capability: C): RegistrationResult<C>;
+    resolve<C extends Capability>(id: CapabilityId): Resolution<C>;
+    has(id: CapabilityId): boolean;
+    capabilities(): readonly CapabilityId[];
+    execute<TInput, TOutput>(id: CapabilityId, input: TInput, options?: ExecutionOptions): Promise<ExecutionResult<TOutput>>;
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Get a snapshot of the fabric state
+     */
+    getSnapshot(): FabricSnapshot;
+    /**
+     * Get the event bus for subscribing to events
+     */
+    getEventBus(): EventBus;
+    private transitionState;
+}
+/**
+ * Create a new Fabric instance
+ */
+export declare function createFabric(options?: FabricConfig): FabricKernel;

package/dist/kernel.js

@@ -0,0 +1,258 @@
+/**
+ * Fabric Kernel
+ *
+ * Runtime kernel for fabric orchestration
+ *
+ * The Fabric Kernel is the core runtime that manages capability
+ * registration, dependency resolution, and execution lifecycle.
+ *
+ * @module @pwfabric/runtime/kernel
+ */
+import { fabricId, parseVersion, INITIAL_VERSION, VALID_TRANSITIONS, DEFAULT_FABRIC_CONFIG, executionOk, executionErr, } from '@pwfabric/contracts';
+import { createRegistry } from './registry.js';
+import { createValidator, isValidationSuccess } from './validator.js';
+import { createEventBus, createFabricEvent } from './bus.js';
+import { createExecutionContext } from './execution-context.js';
+// ============================================================
+// HELPER FUNCTIONS
+// ============================================================
+/**
+ * Build FabricMetadata from partial input
+ */
+function buildFabricMetadata(input) {
+    const result = {
+        name: input?.name ?? 'PWFabric',
+    };
+    if (input?.description !== undefined) {
+        result.description = input.description;
+    }
+    if (input?.tags !== undefined) {
+        result.tags = input.tags;
+    }
+    if (input?.environment !== undefined) {
+        result.environment = input.environment;
+    }
+    return result;
+}
+// ============================================================
+// FABRIC KERNEL IMPLEMENTATION
+// ============================================================
+/**
+ * Fabric kernel implementation
+ */
+export class FabricKernel {
+    id;
+    version;
+    metadata;
+    createdAt;
+    _state = 'initializing';
+    registry;
+    validator;
+    eventBus;
+    config;
+    constructor(options = {}) {
+        this.id = fabricId(options.id ?? `fabric_${Date.now()}`);
+        this.version = options.version
+            ? (parseVersion(options.version) ?? INITIAL_VERSION)
+            : INITIAL_VERSION;
+        // Build metadata with only defined properties
+        this.metadata = buildFabricMetadata(options.metadata);
+        this.createdAt = Date.now();
+        // Build config
+        this.config = {
+            ...DEFAULT_FABRIC_CONFIG,
+            ...options,
+        };
+        this.registry = createRegistry();
+        this.validator = createValidator();
+        this.eventBus = createEventBus();
+        // Transition to ready
+        this.transitionState('ready');
+        // Emit creation event
+        this.eventBus.emit(createFabricEvent('fabric.created', {
+            source: { fabricId: this.id },
+            fabricId: this.id,
+            version: `${this.version.major}.${this.version.minor}.${this.version.patch}`,
+        }));
+    }
+    get state() {
+        return this._state;
+    }
+    register(capability) {
+        // Validate capability
+        const validationResult = this.validator.validateCapability(capability);
+        if (!isValidationSuccess(validationResult)) {
+            return {
+                success: false,
+                error: {
+                    type: 'invalid_contract',
+                    id: capability.id,
+                    message: 'Capability validation failed',
+                },
+            };
+        }
+        // Register with registry
+        const result = this.registry.register(capability);
+        if (result.success) {
+            this.eventBus.emit(createFabricEvent('capability.registered', {
+                source: { fabricId: this.id, capabilityId: capability.id },
+                capabilityId: capability.id,
+                version: `${capability.version.major}.${capability.version.minor}.${capability.version.patch}`,
+            }));
+        }
+        return result;
+    }
+    resolve(id) {
+        return this.registry.resolve(id);
+    }
+    has(id) {
+        return this.registry.has(id);
+    }
+    capabilities() {
+        return this.registry.list();
+    }
+    async execute(id, input, options = {}) {
+        // Resolve capability
+        const resolution = this.resolve(id);
+        if (!resolution.found) {
+            const error = {
+                type: 'capability_not_found',
+                message: `Capability ${id} not found`,
+                capabilityId: id,
+            };
+            return executionErr(error);
+        }
+        const capability = resolution.capability;
+        // Validate input
+        const inputValidation = capability.contract.validateInput(input);
+        if (!inputValidation.success) {
+            const error = {
+                type: 'validation_error',
+                message: 'Input validation failed',
+                capabilityId: id,
+                cause: inputValidation.error,
+            };
+            return executionErr(error);
+        }
+        // Create execution context
+        const timeout = options.timeout ?? this.config.defaultTimeout;
+        const contextOptions = {
+            fabricId: this.id,
+            timeout,
+            invoker: async (capId, inp) => {
+                return this.execute(capId, inp, { timeout });
+            },
+        };
+        if (options.contextData) {
+            contextOptions.data = options.contextData;
+        }
+        const context = createExecutionContext(contextOptions);
+        // Emit execution started event
+        this.eventBus.emit(createFabricEvent('capability.invoked', {
+            source: { fabricId: this.id, capabilityId: id },
+            capabilityId: id,
+            traceId: context.traceId,
+        }));
+        const startTime = Date.now();
+        try {
+            // Execute with timeout
+            const result = await Promise.race([
+                capability.execute(inputValidation.data, context),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Execution timeout')), timeout)),
+            ]);
+            // Validate output
+            const outputValidation = capability.contract.validateOutput(result);
+            if (!outputValidation.success) {
+                const error = {
+                    type: 'contract_violation',
+                    message: 'Output validation failed',
+                    capabilityId: id,
+                    cause: outputValidation.error,
+                };
+                return executionErr(error);
+            }
+            const duration = Date.now() - startTime;
+            // Emit completion event
+            this.eventBus.emit(createFabricEvent('capability.completed', {
+                source: { fabricId: this.id, capabilityId: id },
+                capabilityId: id,
+                traceId: context.traceId,
+                duration,
+            }));
+            return executionOk(outputValidation.data);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const executionError = {
+                type: error instanceof Error && error.message === 'Execution timeout'
+                    ? 'timeout'
+                    : 'execution_error',
+                message: errorMessage,
+                capabilityId: id,
+                cause: error,
+            };
+            // Emit failure event
+            this.eventBus.emit(createFabricEvent('capability.failed', {
+                source: { fabricId: this.id, capabilityId: id },
+                capabilityId: id,
+                traceId: context.traceId,
+                error: errorMessage,
+            }));
+            return executionErr(executionError);
+        }
+    }
+    async start() {
+        this.transitionState('running');
+        this.eventBus.emit(createFabricEvent('fabric.started', {
+            source: { fabricId: this.id },
+            fabricId: this.id,
+        }));
+    }
+    async shutdown() {
+        this.transitionState('stopping');
+        // Wait for any pending operations (in a real implementation)
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        this.transitionState('stopped');
+        this.eventBus.emit(createFabricEvent('fabric.stopped', {
+            source: { fabricId: this.id },
+            fabricId: this.id,
+            reason: 'graceful_shutdown',
+        }));
+    }
+    /**
+     * Get a snapshot of the fabric state
+     */
+    getSnapshot() {
+        return {
+            id: this.id,
+            version: this.version,
+            state: this._state,
+            metadata: this.metadata,
+            capabilities: this.registry.list(),
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Get the event bus for subscribing to events
+     */
+    getEventBus() {
+        return this.eventBus;
+    }
+    transitionState(newState) {
+        const validTransitions = VALID_TRANSITIONS[this._state];
+        if (!validTransitions.includes(newState)) {
+            throw new Error(`Invalid state transition from ${this._state} to ${newState}. Valid transitions: ${validTransitions.join(', ')}`);
+        }
+        this._state = newState;
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create a new Fabric instance
+ */
+export function createFabric(options) {
+    return new FabricKernel(options);
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Fabric Kernel\n *\n * Runtime kernel for fabric orchestration\n *\n * The Fabric Kernel is the core runtime that manages capability\n * registration, dependency resolution, and execution lifecycle.\n *\n * @module @pwfabric/runtime/kernel\n */\n\nimport type {\n  Fabric,\n  FabricConfig,\n  FabricState,\n  FabricMetadata,\n  FabricSnapshot,\n  FabricId,\n  CapabilityId,\n  Capability,\n  RegistrationResult,\n  Resolution,\n  ExecutionResult,\n  ExecutionOptions,\n  ExecutionError,\n  SemanticVersion,\n  Timestamp,\n  EventBus,\n} from '@pwfabric/contracts'\nimport {\n  fabricId,\n  parseVersion,\n  INITIAL_VERSION,\n  VALID_TRANSITIONS,\n  DEFAULT_FABRIC_CONFIG,\n  executionOk,\n  executionErr,\n} from '@pwfabric/contracts'\n\nimport { createRegistry, type CapabilityRegistry } from './registry.js'\nimport { createValidator, type ContractValidator, isValidationSuccess } from './validator.js'\nimport { createEventBus, createFabricEvent } from './bus.js'\nimport { createExecutionContext } from './execution-context.js'\n\n// ============================================================\n// HELPER FUNCTIONS\n// ============================================================\n\n/**\n * Build FabricMetadata from partial input\n */\nfunction buildFabricMetadata(input?: Partial<FabricMetadata>): FabricMetadata {\n  const result: {\n    name: string\n    description?: string\n    tags?: readonly string[]\n    environment?: string\n  } = {\n    name: input?.name ?? 'PWFabric',\n  }\n  if (input?.description !== undefined) {\n    result.description = input.description\n  }\n  if (input?.tags !== undefined) {\n    result.tags = input.tags\n  }\n  if (input?.environment !== undefined) {\n    result.environment = input.environment\n  }\n  return result\n}\n\n// ============================================================\n// FABRIC KERNEL IMPLEMENTATION\n// ============================================================\n\n/**\n * Fabric kernel implementation\n */\nexport class FabricKernel implements Fabric {\n  readonly id: FabricId\n  readonly version: SemanticVersion\n  readonly metadata: FabricMetadata\n  readonly createdAt: Timestamp\n\n  private _state: FabricState = 'initializing'\n  private readonly registry: CapabilityRegistry\n  private readonly validator: ContractValidator\n  private readonly eventBus: EventBus\n  private readonly config: Required<FabricConfig>\n\n  constructor(options: FabricConfig = {}) {\n    this.id = fabricId(options.id ?? `fabric_${Date.now()}`)\n    this.version = options.version\n      ? (parseVersion(options.version) ?? INITIAL_VERSION)\n      : INITIAL_VERSION\n\n    // Build metadata with only defined properties\n    this.metadata = buildFabricMetadata(options.metadata)\n\n    this.createdAt = Date.now()\n\n    // Build config\n    this.config = {\n      ...DEFAULT_FABRIC_CONFIG,\n      ...options,\n    } as Required<FabricConfig>\n\n    this.registry = createRegistry()\n    this.validator = createValidator()\n    this.eventBus = createEventBus()\n\n    // Transition to ready\n    this.transitionState('ready')\n\n    // Emit creation event\n    this.eventBus.emit(\n      createFabricEvent('fabric.created', {\n        source: { fabricId: this.id },\n        fabricId: this.id,\n        version: `${this.version.major}.${this.version.minor}.${this.version.patch}`,\n      })\n    )\n  }\n\n  get state(): FabricState {\n    return this._state\n  }\n\n  register<C extends Capability>(capability: C): RegistrationResult<C> {\n    // Validate capability\n    const validationResult = this.validator.validateCapability(capability)\n    if (!isValidationSuccess(validationResult)) {\n      return {\n        success: false,\n        error: {\n          type: 'invalid_contract',\n          id: capability.id,\n          message: 'Capability validation failed',\n        },\n      }\n    }\n\n    // Register with registry\n    const result = this.registry.register(capability)\n\n    if (result.success) {\n      this.eventBus.emit(\n        createFabricEvent('capability.registered', {\n          source: { fabricId: this.id, capabilityId: capability.id },\n          capabilityId: capability.id,\n          version: `${capability.version.major}.${capability.version.minor}.${capability.version.patch}`,\n        })\n      )\n    }\n\n    return result\n  }\n\n  resolve<C extends Capability>(id: CapabilityId): Resolution<C> {\n    return this.registry.resolve<C>(id)\n  }\n\n  has(id: CapabilityId): boolean {\n    return this.registry.has(id)\n  }\n\n  capabilities(): readonly CapabilityId[] {\n    return this.registry.list()\n  }\n\n  async execute<TInput, TOutput>(\n    id: CapabilityId,\n    input: TInput,\n    options: ExecutionOptions = {}\n  ): Promise<ExecutionResult<TOutput>> {\n    // Resolve capability\n    const resolution = this.resolve(id)\n    if (!resolution.found) {\n      const error: ExecutionError = {\n        type: 'capability_not_found',\n        message: `Capability ${id} not found`,\n        capabilityId: id,\n      }\n      return executionErr(error)\n    }\n\n    const capability = resolution.capability as Capability<CapabilityId, TInput, TOutput>\n\n    // Validate input\n    const inputValidation = capability.contract.validateInput(input)\n    if (!inputValidation.success) {\n      const error: ExecutionError = {\n        type: 'validation_error',\n        message: 'Input validation failed',\n        capabilityId: id,\n        cause: inputValidation.error,\n      }\n      return executionErr(error)\n    }\n\n    // Create execution context\n    const timeout = options.timeout ?? this.config.defaultTimeout\n    const contextOptions: Parameters<typeof createExecutionContext>[0] = {\n      fabricId: this.id,\n      timeout,\n      invoker: async <I, O>(capId: CapabilityId, inp: I) => {\n        return this.execute<I, O>(capId, inp, { timeout })\n      },\n    }\n    if (options.contextData) {\n      contextOptions.data = options.contextData\n    }\n    const context = createExecutionContext(contextOptions)\n\n    // Emit execution started event\n    this.eventBus.emit(\n      createFabricEvent('capability.invoked', {\n        source: { fabricId: this.id, capabilityId: id },\n        capabilityId: id,\n        traceId: context.traceId,\n      })\n    )\n\n    const startTime = Date.now()\n\n    try {\n      // Execute with timeout\n      const result = await Promise.race([\n        capability.execute(inputValidation.data, context),\n        new Promise<never>((_, reject) =>\n          setTimeout(() => reject(new Error('Execution timeout')), timeout)\n        ),\n      ])\n\n      // Validate output\n      const outputValidation = capability.contract.validateOutput(result)\n      if (!outputValidation.success) {\n        const error: ExecutionError = {\n          type: 'contract_violation',\n          message: 'Output validation failed',\n          capabilityId: id,\n          cause: outputValidation.error,\n        }\n        return executionErr(error)\n      }\n\n      const duration = Date.now() - startTime\n\n      // Emit completion event\n      this.eventBus.emit(\n        createFabricEvent('capability.completed', {\n          source: { fabricId: this.id, capabilityId: id },\n          capabilityId: id,\n          traceId: context.traceId,\n          duration,\n        })\n      )\n\n      return executionOk(outputValidation.data as TOutput)\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error)\n\n      const executionError: ExecutionError = {\n        type:\n          error instanceof Error && error.message === 'Execution timeout'\n            ? 'timeout'\n            : 'execution_error',\n        message: errorMessage,\n        capabilityId: id,\n        cause: error,\n      }\n\n      // Emit failure event\n      this.eventBus.emit(\n        createFabricEvent('capability.failed', {\n          source: { fabricId: this.id, capabilityId: id },\n          capabilityId: id,\n          traceId: context.traceId,\n          error: errorMessage,\n        })\n      )\n\n      return executionErr(executionError)\n    }\n  }\n\n  async start(): Promise<void> {\n    this.transitionState('running')\n    this.eventBus.emit(\n      createFabricEvent('fabric.started', {\n        source: { fabricId: this.id },\n        fabricId: this.id,\n      })\n    )\n  }\n\n  async shutdown(): Promise<void> {\n    this.transitionState('stopping')\n\n    // Wait for any pending operations (in a real implementation)\n    await new Promise((resolve) => setTimeout(resolve, 10))\n\n    this.transitionState('stopped')\n    this.eventBus.emit(\n      createFabricEvent('fabric.stopped', {\n        source: { fabricId: this.id },\n        fabricId: this.id,\n        reason: 'graceful_shutdown',\n      })\n    )\n  }\n\n  /**\n   * Get a snapshot of the fabric state\n   */\n  getSnapshot(): FabricSnapshot {\n    return {\n      id: this.id,\n      version: this.version,\n      state: this._state,\n      metadata: this.metadata,\n      capabilities: this.registry.list(),\n      timestamp: Date.now(),\n    }\n  }\n\n  /**\n   * Get the event bus for subscribing to events\n   */\n  getEventBus(): EventBus {\n    return this.eventBus\n  }\n\n  private transitionState(newState: FabricState): void {\n    const validTransitions = VALID_TRANSITIONS[this._state]\n    if (!validTransitions.includes(newState)) {\n      throw new Error(\n        `Invalid state transition from ${this._state} to ${newState}. Valid transitions: ${validTransitions.join(', ')}`\n      )\n    }\n    this._state = newState\n  }\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create a new Fabric instance\n */\nexport function createFabric(options?: FabricConfig): FabricKernel {\n  return new FabricKernel(options)\n}\n"]}

package/dist/perf/budget.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Performance Budget Enforcement
+ *
+ * Defines performance budgets based on web.dev recommendations
+ * and checks measured metrics against those budgets. Violations
+ * are reported with severity levels.
+ *
+ * @module @pwfabric/runtime/perf
+ */
+/** Performance budget thresholds */
+export interface PerformanceBudget {
+    /** Max Largest Contentful Paint in ms */
+    readonly lcp?: number;
+    /** Max First Input Delay in ms */
+    readonly fid?: number;
+    /** Max Cumulative Layout Shift score */
+    readonly cls?: number;
+    /** Max First Contentful Paint in ms */
+    readonly fcp?: number;
+    /** Max Time to First Byte in ms */
+    readonly ttfb?: number;
+    /** Max bundle size in bytes */
+    readonly maxBundleSize?: number;
+    /** Max render time in ms */
+    readonly maxRenderTime?: number;
+}
+/** A single budget violation */
+export interface BudgetViolation {
+    /** Metric that violated the budget */
+    readonly metric: string;
+    /** Budget threshold */
+    readonly budget: number;
+    /** Actual measured value */
+    readonly actual: number;
+    /** Severity: warning if within 20% over, error if more */
+    readonly severity: 'warning' | 'error';
+}
+/** Result of checking metrics against a budget */
+export interface BudgetCheckResult {
+    /** Whether all metrics passed the budget */
+    readonly passed: boolean;
+    /** List of violations (empty if passed) */
+    readonly violations: readonly BudgetViolation[];
+    /** Timestamp when the check was performed */
+    readonly checkedAt: number;
+}
+/**
+ * Default performance budgets based on web.dev "good" thresholds.
+ */
+export declare const DEFAULT_BUDGET: Readonly<PerformanceBudget>;
+/**
+ * Checks measured performance metrics against a budget.
+ *
+ * Uses default web.dev "good" thresholds unless overridden.
+ * Violations are classified as "warning" (within 20% over)
+ * or "error" (more than 20% over).
+ */
+export declare class BudgetChecker {
+    private budget;
+    /**
+     * @param budget - Custom budget thresholds (merged with defaults)
+     */
+    constructor(budget?: PerformanceBudget);
+    /**
+     * Check a set of metrics against the current budget.
+     *
+     * @param metrics - Map of metric name to measured value
+     * @returns Check result with pass/fail and any violations
+     */
+    check(metrics: Partial<Record<string, number>>): BudgetCheckResult;
+    /**
+     * Update the performance budget.
+     *
+     * Merges the provided values with the existing budget.
+     *
+     * @param budget - Partial budget to merge
+     */
+    setBudget(budget: Partial<PerformanceBudget>): void;
+    /**
+     * Get the current performance budget.
+     *
+     * @returns Readonly copy of the budget
+     */
+    getBudget(): Readonly<PerformanceBudget>;
+}
+/**
+ * Create a new BudgetChecker instance.
+ *
+ * @param budget - Optional custom budget thresholds
+ * @returns A new BudgetChecker
+ */
+export declare function createBudgetChecker(budget?: PerformanceBudget): BudgetChecker;