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

package/dist/binding/two-way.js

@@ -0,0 +1,462 @@
+/**
+ * Two-way Data Binding
+ *
+ * P1-5: Extends the binding system with write-back capability.
+ * UI changes propagate back to the data source, enabling form inputs,
+ * editable fields, and other interactive elements to automatically
+ * update the data model.
+ *
+ * @module @pwfabric/runtime/binding/two-way
+ */
+import { resolvePath } from './expression.js';
+/**
+ * Parse a dot-notation path into segments for traversal
+ */
+function parsePath(path) {
+    const segments = [];
+    const regex = /(\w+)|\[(\d+)\]/g;
+    let match;
+    while ((match = regex.exec(path)) !== null) {
+        if (match[1] !== undefined) {
+            segments.push({ type: 'property', key: match[1] });
+        }
+        else if (match[2] !== undefined) {
+            segments.push({ type: 'index', index: parseInt(match[2], 10) });
+        }
+    }
+    return segments;
+}
+/**
+ * Set a value at a dot-notation path in an object, creating
+ * intermediate objects/arrays as needed.
+ *
+ * Mutates the target object in place.
+ */
+function setAtPath(obj, path, value) {
+    const segments = parsePath(path);
+    if (segments.length === 0)
+        return;
+    let current = obj;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const segment = segments[i];
+        if (segment === undefined)
+            return;
+        if (segment.type === 'property') {
+            if (typeof current !== 'object' || current === null)
+                return;
+            const record = current;
+            if (record[segment.key] === undefined || record[segment.key] === null) {
+                // Look ahead to decide whether to create an object or array
+                const next = segments[i + 1];
+                record[segment.key] = next && next.type === 'index' ? [] : {};
+            }
+            current = record[segment.key];
+        }
+        else {
+            if (!Array.isArray(current))
+                return;
+            if (current[segment.index] === undefined || current[segment.index] === null) {
+                const next = segments[i + 1];
+                current[segment.index] = next && next.type === 'index' ? [] : {};
+            }
+            current = current[segment.index];
+        }
+    }
+    const last = segments[segments.length - 1];
+    if (last === undefined)
+        return;
+    if (last.type === 'property') {
+        if (typeof current === 'object' && current !== null) {
+            ;
+            current[last.key] = value;
+        }
+    }
+    else {
+        if (Array.isArray(current)) {
+            current[last.index] = value;
+        }
+    }
+}
+/**
+ * Deep-clone a plain object/array structure using structured clone
+ * semantics (JSON round-trip for simplicity and zero dependencies).
+ */
+function deepClone(value) {
+    if (value === undefined || value === null)
+        return value;
+    if (typeof value !== 'object')
+        return value;
+    return JSON.parse(JSON.stringify(value));
+}
+// ============================================================
+// TWO-WAY BINDING INSTANCE (INTERNAL)
+// ============================================================
+/**
+ * Internal class that implements a single two-way binding
+ */
+class TwoWayBindingInstance {
+    path;
+    _value;
+    _initialValue;
+    _error;
+    _isDirty = false;
+    _isValidating = false;
+    _disposed = false;
+    config;
+    manager;
+    debounceTimer;
+    constructor(config, initialValue, manager) {
+        this.path = config.path;
+        this.config = config;
+        this.manager = manager;
+        // Apply toView transform for initial value
+        const viewValue = config.transform?.toView
+            ? config.transform.toView(initialValue)
+            : initialValue;
+        this._value = viewValue;
+        this._initialValue = deepClone(viewValue);
+    }
+    get value() {
+        return this._value;
+    }
+    get error() {
+        return this._error;
+    }
+    get isDirty() {
+        return this._isDirty;
+    }
+    get isValidating() {
+        return this._isValidating;
+    }
+    setValue(newValue) {
+        if (this._disposed)
+            return;
+        const oldValue = this._value;
+        // Run validation if configured
+        if (this.config.validate) {
+            this._isValidating = true;
+            const result = this.config.validate(newValue);
+            this._isValidating = false;
+            if (!result.valid) {
+                this._error = result.error;
+                return;
+            }
+        }
+        // Clear any previous error
+        this._error = undefined;
+        // Update the local value
+        this._value = newValue;
+        // Track dirty state
+        this._isDirty = !isEqual(newValue, this._initialValue);
+        // Debounced write-back to model
+        this.scheduleWriteBack(newValue, oldValue);
+    }
+    reset() {
+        if (this._disposed)
+            return;
+        const oldValue = this._value;
+        this._value = deepClone(this._initialValue);
+        this._isDirty = false;
+        this._error = undefined;
+        this.clearDebounce();
+        // Write the reset value back to model immediately
+        const modelValue = this.config.transform?.toModel
+            ? this.config.transform.toModel(this._value)
+            : this._value;
+        this.manager.setValueInternal(this.path, modelValue, oldValue);
+    }
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this.clearDebounce();
+    }
+    /**
+     * Called by the manager when the model value changes externally
+     */
+    updateFromModel(modelValue) {
+        if (this._disposed)
+            return;
+        const viewValue = this.config.transform?.toView
+            ? this.config.transform.toView(modelValue)
+            : modelValue;
+        this._value = viewValue;
+        this._isDirty = !isEqual(viewValue, this._initialValue);
+    }
+    scheduleWriteBack(newValue, oldValue) {
+        this.clearDebounce();
+        const delay = this.config.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        if (delay <= 0) {
+            // Write immediately
+            this.writeBack(newValue, oldValue);
+            return;
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = undefined;
+            this.writeBack(newValue, oldValue);
+        }, delay);
+    }
+    writeBack(newValue, oldValue) {
+        if (this._disposed)
+            return;
+        // Apply toModel transform before writing back
+        const modelValue = this.config.transform?.toModel
+            ? this.config.transform.toModel(newValue)
+            : newValue;
+        this.manager.setValueInternal(this.path, modelValue, oldValue);
+    }
+    clearDebounce() {
+        if (this.debounceTimer !== undefined) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = undefined;
+        }
+    }
+}
+// ============================================================
+// CONSTANTS
+// ============================================================
+/** Default debounce delay in milliseconds */
+const DEFAULT_DEBOUNCE_MS = 300;
+// ============================================================
+// UTILITY
+// ============================================================
+/**
+ * Shallow equality check suitable for primitive and simple object values.
+ * Uses JSON serialization for object comparison (safe for plain data).
+ */
+function isEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (a === undefined || b === undefined)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object') {
+        try {
+            return JSON.stringify(a) === JSON.stringify(b);
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+// ============================================================
+// TWO-WAY BINDING MANAGER
+// ============================================================
+/**
+ * Manages two-way data bindings.
+ *
+ * Provides a central data store with path-based access, change listeners,
+ * validation, transforms, and batch update support. Each call to `bind()`
+ * creates a `TwoWayBinding` instance that can read/write a specific path
+ * in the data model.
+ */
+export class TwoWayBindingManager {
+    bindings = new Map();
+    data;
+    listeners = new Map();
+    batchDepth = 0;
+    pendingNotifications = [];
+    constructor(initialData) {
+        this.data = initialData ? deepClone(initialData) : {};
+    }
+    /**
+     * Create a two-way binding for a specific data path.
+     *
+     * Returns a `TwoWayBinding` instance that tracks the value at the path,
+     * supports validation and transforms, and writes changes back to the
+     * data model with optional debouncing.
+     */
+    bind(config) {
+        // Dispose any existing binding at this path
+        const existing = this.bindings.get(config.path);
+        if (existing) {
+            existing.dispose();
+        }
+        const currentValue = resolvePath(this.data, config.path);
+        const instance = new TwoWayBindingInstance(config, currentValue, this);
+        this.bindings.set(config.path, instance);
+        return instance;
+    }
+    /**
+     * Get the current value at a data path
+     */
+    getValue(path) {
+        return resolvePath(this.data, path);
+    }
+    /**
+     * Set a value at a data path, triggering change listeners
+     */
+    setValue(path, value) {
+        const oldValue = resolvePath(this.data, path);
+        // Write to data store
+        setAtPath(this.data, path, value);
+        // Update any binding watching this path
+        const binding = this.bindings.get(path);
+        if (binding) {
+            binding.updateFromModel(value);
+        }
+        // Notify listeners
+        this.notifyChange(path, value, oldValue);
+    }
+    /**
+     * Subscribe to changes at a data path.
+     *
+     * @returns Unsubscribe function
+     */
+    onChange(path, listener) {
+        let pathListeners = this.listeners.get(path);
+        if (!pathListeners) {
+            pathListeners = new Set();
+            this.listeners.set(path, pathListeners);
+        }
+        pathListeners.add(listener);
+        return () => {
+            pathListeners.delete(listener);
+            if (pathListeners.size === 0) {
+                this.listeners.delete(path);
+            }
+        };
+    }
+    /**
+     * Batch multiple updates together.
+     *
+     * Listener notifications are deferred until the outermost batch
+     * completes, then fired once per changed path.
+     */
+    batch(updates) {
+        this.batchDepth++;
+        try {
+            updates();
+        }
+        finally {
+            this.batchDepth--;
+            if (this.batchDepth === 0) {
+                this.flushPendingNotifications();
+            }
+        }
+    }
+    /**
+     * Get all bindings that have been modified from their initial values
+     */
+    getDirtyBindings() {
+        const dirty = [];
+        for (const binding of this.bindings.values()) {
+            if (binding.isDirty) {
+                dirty.push(binding);
+            }
+        }
+        return dirty;
+    }
+    /**
+     * Reset all bindings to their initial values
+     */
+    resetAll() {
+        for (const binding of this.bindings.values()) {
+            binding.reset();
+        }
+    }
+    /**
+     * Dispose all bindings and clear all listeners
+     */
+    dispose() {
+        for (const binding of this.bindings.values()) {
+            binding.dispose();
+        }
+        this.bindings.clear();
+        this.listeners.clear();
+        this.pendingNotifications.length = 0;
+    }
+    /**
+     * Internal method called by binding instances to write back to the model.
+     * Not part of the public API.
+     */
+    setValueInternal(path, modelValue, oldViewValue) {
+        const oldModelValue = resolvePath(this.data, path);
+        // Write to data store
+        setAtPath(this.data, path, modelValue);
+        // Notify listeners with model values
+        this.notifyChange(path, modelValue, oldModelValue ?? oldViewValue);
+    }
+    // ============================================================
+    // PRIVATE
+    // ============================================================
+    notifyChange(path, newValue, oldValue) {
+        if (this.batchDepth > 0) {
+            // During batch, accumulate notifications (last write wins per path)
+            const existingIdx = this.pendingNotifications.findIndex((n) => n.path === path);
+            if (existingIdx >= 0) {
+                const existing = this.pendingNotifications[existingIdx];
+                if (existing) {
+                    // Keep the original oldValue, update newValue
+                    this.pendingNotifications[existingIdx] = {
+                        path,
+                        newValue,
+                        oldValue: existing.oldValue,
+                    };
+                }
+            }
+            else {
+                this.pendingNotifications.push({ path, newValue, oldValue });
+            }
+            return;
+        }
+        this.fireListeners(path, newValue, oldValue);
+    }
+    flushPendingNotifications() {
+        // Copy and clear to handle re-entrant batch calls
+        const pending = [...this.pendingNotifications];
+        this.pendingNotifications.length = 0;
+        for (const { path, newValue, oldValue } of pending) {
+            this.fireListeners(path, newValue, oldValue);
+        }
+    }
+    fireListeners(path, newValue, oldValue) {
+        const pathListeners = this.listeners.get(path);
+        if (!pathListeners)
+            return;
+        for (const listener of pathListeners) {
+            try {
+                listener(newValue, oldValue);
+            }
+            catch {
+                // Swallow errors from listeners to prevent cascade failures
+            }
+        }
+    }
+}
+// ============================================================
+// FACTORY
+// ============================================================
+/**
+ * Create a two-way binding manager
+ *
+ * @param initialData - Optional initial data to populate the model
+ * @returns A new TwoWayBindingManager instance
+ *
+ * @example
+ * ```ts
+ * const manager = createTwoWayBindingManager({
+ *   user: { name: 'John', email: 'john@example.com' }
+ * })
+ *
+ * const nameBinding = manager.bind<string>({
+ *   path: 'user.name',
+ *   debounceMs: 200,
+ *   validate: (v) => ({
+ *     valid: typeof v === 'string' && v.length > 0,
+ *     error: 'Name is required',
+ *   }),
+ * })
+ *
+ * nameBinding.setValue('Jane')
+ * // After debounce, manager.getValue('user.name') === 'Jane'
+ * ```
+ */
+export function createTwoWayBindingManager(initialData) {
+    return new TwoWayBindingManager(initialData);
+}
+//# sourceMappingURL=two-way.js.map

package/dist/binding/two-way.js.map

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

package/dist/binding/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Binding System Types
+ *
+ * Types for capability-to-surface binding
+ *
+ * @module @pwfabric/runtime/binding/types
+ */
+import type { CapabilityId, SurfaceId, ExecutionResult } from '@pwfabric/contracts';
+/**
+ * Binding state
+ */
+export type BindingState = 'unbound' | 'binding' | 'bound' | 'error' | 'stale';
+/**
+ * Binding configuration
+ */
+export interface BindingConfig {
+    readonly capabilityId: CapabilityId;
+    readonly alias?: string;
+    readonly transform?: RuntimeBindingTransform;
+    readonly cache?: BindingCacheConfig;
+    readonly retry?: RetryConfig;
+}
+/**
+ * Transform configuration for binding input/output (runtime version)
+ * Named differently from contracts BindingTransform to avoid export collision
+ */
+export interface RuntimeBindingTransform {
+    readonly input?: (data: unknown) => unknown;
+    readonly output?: (data: unknown) => unknown;
+}
+/**
+ * Cache configuration for binding (runtime version)
+ * Named differently from contracts CacheConfig to avoid export collision
+ */
+export interface BindingCacheConfig {
+    readonly enabled: boolean;
+    readonly ttl?: number;
+    readonly key?: string;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    readonly maxAttempts: number;
+    readonly backoff: 'fixed' | 'exponential';
+    readonly delayMs: number;
+}
+/**
+ * A bound capability instance
+ */
+export interface BoundCapability<TInput = unknown, TOutput = unknown> {
+    readonly id: string;
+    readonly capabilityId: CapabilityId;
+    readonly state: BindingState;
+    readonly config: BindingConfig;
+    readonly lastExecuted?: number;
+    readonly lastResult?: ExecutionResult<TOutput>;
+    readonly error?: BindingError;
+    /**
+     * Execute the bound capability
+     */
+    execute(input: TInput): Promise<ExecutionResult<TOutput>>;
+    /**
+     * Refresh the binding (re-execute with last input)
+     */
+    refresh(): Promise<ExecutionResult<TOutput>>;
+    /**
+     * Invalidate cached data
+     */
+    invalidate(): void;
+}
+/**
+ * Binding error
+ */
+export interface BindingError {
+    readonly type: 'resolution_failed' | 'execution_failed' | 'transform_failed' | 'cache_failed';
+    readonly message: string;
+    readonly cause?: unknown;
+}
+/**
+ * Context for binding resolution
+ */
+export interface BindingContext {
+    readonly surfaceId: SurfaceId;
+    readonly auth?: AuthContext;
+    readonly data: Record<string, unknown>;
+    readonly bindings: Map<string, BoundCapability>;
+}
+/**
+ * Authentication context
+ */
+export interface AuthContext {
+    readonly isAuthenticated: boolean;
+    readonly userId?: string;
+    readonly worldId?: string;
+    readonly scopes?: readonly string[];
+    readonly token?: string;
+    readonly expiresAt?: number;
+}
+/**
+ * Result of binding resolution
+ */
+export type BindingResult<T = unknown> = {
+    readonly success: true;
+    readonly binding: BoundCapability<unknown, T>;
+} | {
+    readonly success: false;
+    readonly error: BindingError;
+};
+/**
+ * Result of binding all capabilities for a surface
+ */
+export type SurfaceBindingResult = {
+    readonly success: true;
+    readonly context: BindingContext;
+} | {
+    readonly success: false;
+    readonly errors: readonly BindingError[];
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/binding/types.js

@@ -0,0 +1,9 @@
+/**
+ * Binding System Types
+ *
+ * Types for capability-to-surface binding
+ *
+ * @module @pwfabric/runtime/binding/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/binding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/binding/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/blocks/__test-fixtures__/block-fixtures.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Block Fixtures
+ *
+ * Canonical test fixture for registry-dependent suites — supplies the
+ * `BlockRegistry` / `CompositionRuleEngine` / composer-prompt /
+ * introspection tests with a populated set of `BlockDefinition` stubs.
+ * Production code MUST NOT import from this module; production block
+ * metadata flows through the install pipeline (`useInstalledAtoms`
+ * browser-side, `installedBlocksOverride` server-side).
+ *
+ * The 45 stubs carry only the metadata the rule engine and composition
+ * validators consult: `type`, `name`, `category`, `schema`,
+ * `defaultProps`, `canHaveChildren`, optional `allowedChildren`/
+ * `allowedParents`. Component implementations live exclusively in
+ * `pwpack-source/<pack>/blocks/<cat>/<name>/component.tsx` and are
+ * loaded at runtime via `BlockModuleLoader` from the published CDN
+ * bundle. The stub `type` set + enum values mirror the historic
+ * first-party catalog because composer-prompt + introspection tests
+ * verify parity against that catalog.
+ *
+ * Usage in tests:
+ *   import { populateTestBlocks } from
+ *     '@pwfabric/runtime/blocks/__test-fixtures__/block-fixtures'
+ *   populateTestBlocks()
+ *
+ * @module @pwfabric/runtime/blocks/__test-fixtures__/block-fixtures
+ */
+import type { BlockDefinition } from '@pwfabric/core';
+import { type BlockRegistry } from '../registry.js';
+export declare const TEST_BLOCK_DEFINITIONS: readonly BlockDefinition[];
+/**
+ * Register the 45 block definition stubs on the supplied registry
+ * (or the runtime singleton when omitted). Idempotent — skips
+ * definitions whose `type` is already registered.
+ *
+ * Tests that exercise registry-dependent behaviour call this once at
+ * module-load. Production code must use the install pipeline instead.
+ */
+export declare function populateTestBlocks(target?: BlockRegistry): void;
+//# sourceMappingURL=block-fixtures.d.ts.map

package/dist/blocks/__test-fixtures__/block-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-fixtures.d.ts","sourceRoot":"","sources":["../../../src/blocks/__test-fixtures__/block-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAA;AAgElE,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAgb5D,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,aAA6B,GAAG,IAAI,CAI9E"}