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

package/dist/i18n/translator.js

@@ -0,0 +1,357 @@
+/**
+ * i18n Capability Implementation
+ *
+ * Locale resolution, ICU-style string interpolation,
+ * pluralization, and number/date formatting
+ *
+ * @module @pwfabric/runtime/i18n/translator
+ */
+// ============================================================
+// DEFAULT I18N CAPABILITY
+// ============================================================
+/**
+ * Default i18n capability implementation
+ */
+export class DefaultI18nCapability {
+    locales = new Map();
+    catalogs = new Map();
+    currentLocale;
+    defaultLocale;
+    missingKeyHandler;
+    constructor(options) {
+        this.defaultLocale = options?.defaultLocale ?? 'en';
+        this.currentLocale = this.defaultLocale;
+        this.missingKeyHandler = options?.onMissingKey ?? defaultMissingKeyHandler;
+    }
+    addLocale(locale) {
+        this.locales.set(locale.id, locale);
+    }
+    loadTranslations(localeId, catalog) {
+        let existing = this.catalogs.get(localeId);
+        if (!existing) {
+            existing = new Map();
+            this.catalogs.set(localeId, existing);
+        }
+        for (const [key, value] of Object.entries(catalog)) {
+            existing.set(key, value);
+        }
+    }
+    resolveLocale(preferred) {
+        // Try exact match
+        for (const locale of preferred) {
+            if (this.catalogs.has(locale)) {
+                return locale;
+            }
+        }
+        // Try language-only match (e.g. 'en-US' -> 'en')
+        for (const locale of preferred) {
+            const language = locale.split('-')[0];
+            if (language && this.catalogs.has(language)) {
+                return language;
+            }
+        }
+        // Try matching registered locales by language prefix
+        for (const locale of preferred) {
+            const language = locale.split('-')[0];
+            if (language) {
+                for (const registeredId of this.catalogs.keys()) {
+                    if (registeredId.startsWith(language)) {
+                        return registeredId;
+                    }
+                }
+            }
+        }
+        return this.defaultLocale;
+    }
+    setLocale(localeId) {
+        this.currentLocale = localeId;
+    }
+    getLocale() {
+        return this.currentLocale;
+    }
+    getLocaleIds() {
+        return Array.from(this.catalogs.keys());
+    }
+    translate(key, values) {
+        const message = this.lookupKey(key, this.currentLocale);
+        if (message === undefined) {
+            return this.missingKeyHandler(key, this.currentLocale);
+        }
+        if (!values || Object.keys(values).length === 0) {
+            return message;
+        }
+        return this.interpolate(message, values);
+    }
+    t(key, values) {
+        return this.translate(key, values);
+    }
+    formatNumber(value, options) {
+        try {
+            const intlOptions = {};
+            if (options?.style)
+                intlOptions.style = options.style;
+            if (options?.currency)
+                intlOptions.currency = options.currency;
+            if (options?.minimumFractionDigits !== undefined) {
+                intlOptions.minimumFractionDigits = options.minimumFractionDigits;
+            }
+            if (options?.maximumFractionDigits !== undefined) {
+                intlOptions.maximumFractionDigits = options.maximumFractionDigits;
+            }
+            if (options?.useGrouping !== undefined)
+                intlOptions.useGrouping = options.useGrouping;
+            return new Intl.NumberFormat(this.currentLocale, intlOptions).format(value);
+        }
+        catch {
+            // Fallback to basic formatting
+            return String(value);
+        }
+    }
+    formatDate(value, options) {
+        try {
+            const date = typeof value === 'number' ? new Date(value) : value;
+            const intlOptions = {};
+            if (options?.dateStyle)
+                intlOptions.dateStyle = options.dateStyle;
+            if (options?.timeStyle)
+                intlOptions.timeStyle = options.timeStyle;
+            if (options?.year)
+                intlOptions.year = options.year;
+            if (options?.month)
+                intlOptions.month = options.month;
+            if (options?.day)
+                intlOptions.day = options.day;
+            if (options?.hour)
+                intlOptions.hour = options.hour;
+            if (options?.minute)
+                intlOptions.minute = options.minute;
+            if (options?.second)
+                intlOptions.second = options.second;
+            if (options?.timeZone)
+                intlOptions.timeZone = options.timeZone;
+            return new Intl.DateTimeFormat(this.currentLocale, intlOptions).format(date);
+        }
+        catch {
+            // Fallback to ISO string
+            const date = typeof value === 'number' ? new Date(value) : value;
+            return date.toISOString();
+        }
+    }
+    hasTranslation(key) {
+        return this.lookupKey(key, this.currentLocale) !== undefined;
+    }
+    clear() {
+        this.locales.clear();
+        this.catalogs.clear();
+        this.currentLocale = this.defaultLocale;
+    }
+    // ============================================================
+    // PRIVATE METHODS
+    // ============================================================
+    lookupKey(key, localeId) {
+        // Try current locale
+        const catalog = this.catalogs.get(localeId);
+        if (catalog?.has(key)) {
+            return catalog.get(key);
+        }
+        // Try fallback chain
+        const locale = this.locales.get(localeId);
+        if (locale?.fallback) {
+            return this.lookupKey(key, locale.fallback);
+        }
+        // Try default locale if different
+        if (localeId !== this.defaultLocale) {
+            const defaultCatalog = this.catalogs.get(this.defaultLocale);
+            if (defaultCatalog?.has(key)) {
+                return defaultCatalog.get(key);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Interpolate ICU-style message patterns
+     *
+     * Supports:
+     * - Simple: "Hello, {name}!"
+     * - Plural: "{count, plural, one {# item} other {# items}}"
+     * - Select: "{gender, select, male {He} female {She} other {They}}"
+     */
+    interpolate(message, values) {
+        let result = '';
+        let i = 0;
+        while (i < message.length) {
+            if (message[i] === '{') {
+                // Extract the full brace-balanced block
+                const block = this.extractBraceBlock(message, i);
+                if (block !== null) {
+                    const inner = block.content.trim();
+                    result += this.resolveBlock(inner, values);
+                    i = block.end + 1;
+                }
+                else {
+                    result += message[i];
+                    i++;
+                }
+            }
+            else {
+                result += message[i];
+                i++;
+            }
+        }
+        return result;
+    }
+    /**
+     * Extract a brace-balanced block starting at position `start`
+     * Returns the content between the outer braces and the end index
+     */
+    extractBraceBlock(message, start) {
+        if (message[start] !== '{')
+            return null;
+        let depth = 0;
+        let i = start;
+        while (i < message.length) {
+            if (message[i] === '{') {
+                depth++;
+            }
+            else if (message[i] === '}') {
+                depth--;
+                if (depth === 0) {
+                    return {
+                        content: message.slice(start + 1, i),
+                        end: i,
+                    };
+                }
+            }
+            i++;
+        }
+        return null;
+    }
+    /**
+     * Resolve a single interpolation block (content between outer braces)
+     */
+    resolveBlock(inner, values) {
+        // Check for plural/select: "name, plural, ..." or "name, select, ..."
+        const commaIndex = inner.indexOf(',');
+        if (commaIndex > 0) {
+            const varName = inner.slice(0, commaIndex).trim();
+            const rest = inner.slice(commaIndex + 1).trim();
+            // Check for plural
+            if (rest.startsWith('plural,')) {
+                const pluralBody = rest.slice('plural,'.length).trim();
+                const value = values[varName];
+                if (typeof value === 'number') {
+                    return this.resolvePlural(value, pluralBody);
+                }
+            }
+            // Check for select
+            if (rest.startsWith('select,')) {
+                const selectBody = rest.slice('select,'.length).trim();
+                const value = values[varName];
+                return this.resolveSelect(String(value), selectBody);
+            }
+        }
+        // Simple interpolation: "name"
+        const value = values[inner];
+        if (value !== undefined) {
+            return String(value);
+        }
+        return `{${inner}}`;
+    }
+    resolvePlural(count, body) {
+        const category = this.getPluralCategory(count);
+        const options = this.parseICUOptions(body);
+        // Try exact match first (=0, =1, etc.)
+        const exactMatch = options.get(`=${count}`);
+        if (exactMatch) {
+            return exactMatch.replace(/#/g, String(count));
+        }
+        // Try category match
+        const categoryMatch = options.get(category);
+        if (categoryMatch) {
+            return categoryMatch.replace(/#/g, String(count));
+        }
+        // Fallback to 'other'
+        const other = options.get('other');
+        if (other) {
+            return other.replace(/#/g, String(count));
+        }
+        return String(count);
+    }
+    resolveSelect(value, body) {
+        const options = this.parseICUOptions(body);
+        const match = options.get(value);
+        if (match)
+            return match;
+        const other = options.get('other');
+        if (other)
+            return other;
+        return value;
+    }
+    /**
+     * Parse ICU option blocks like: "one {# item} other {# items}"
+     * Handles nested braces correctly using a brace-depth parser.
+     */
+    parseICUOptions(body) {
+        const options = new Map();
+        let i = 0;
+        while (i < body.length) {
+            // Skip whitespace
+            while (i < body.length && /\s/.test(body[i]))
+                i++;
+            if (i >= body.length)
+                break;
+            // Read key (non-whitespace until { or whitespace)
+            let key = '';
+            while (i < body.length && body[i] !== '{' && !/\s/.test(body[i])) {
+                key += body[i];
+                i++;
+            }
+            if (!key)
+                break;
+            // Skip whitespace before opening brace
+            while (i < body.length && /\s/.test(body[i]))
+                i++;
+            if (i >= body.length || body[i] !== '{')
+                break;
+            // Extract brace-balanced value
+            const block = this.extractBraceBlock(body, i);
+            if (block === null)
+                break;
+            options.set(key, block.content);
+            i = block.end + 1;
+        }
+        return options;
+    }
+    getPluralCategory(count) {
+        // Basic English-style plural rules
+        // For production use, this should use Intl.PluralRules
+        try {
+            const pr = new Intl.PluralRules(this.currentLocale);
+            return pr.select(count);
+        }
+        catch {
+            // Fallback: simple English plural
+            if (count === 0)
+                return 'zero';
+            if (count === 1)
+                return 'one';
+            return 'other';
+        }
+    }
+}
+/**
+ * Default handler returns the key itself as a visible fallback
+ */
+function defaultMissingKeyHandler(key, _locale) {
+    return key;
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create an i18n capability instance
+ */
+export function createI18nCapability(options) {
+    return new DefaultI18nCapability(options);
+}
+//# sourceMappingURL=translator.js.map

package/dist/i18n/translator.js.map

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

package/dist/i18n/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * i18n Capability Types
+ *
+ * Locale resolution, translation, pluralization, and formatting
+ *
+ * @module @pwfabric/runtime/i18n/types
+ */
+/**
+ * Locale identifier (BCP 47 format, e.g. 'en', 'en-US', 'pt-BR')
+ */
+export type LocaleId = string;
+/**
+ * Locale definition
+ */
+export interface LocaleDefinition {
+    readonly id: LocaleId;
+    readonly name: string;
+    readonly nativeName?: string;
+    readonly direction?: 'ltr' | 'rtl';
+    readonly fallback?: LocaleId;
+}
+/**
+ * Translation catalog -- flat key-value pairs for a locale
+ *
+ * Keys can be dot-separated for namespacing (e.g. 'nav.home', 'errors.notFound').
+ * Values support ICU-style interpolation:
+ *   - Simple: "Hello, {name}!"
+ *   - Plural: "{count, plural, one {# item} other {# items}}"
+ *   - Select: "{gender, select, male {He} female {She} other {They}}"
+ */
+export type TranslationCatalog = Readonly<Record<string, string>>;
+/**
+ * Plural categories (CLDR)
+ */
+export type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+/**
+ * Plural rule function
+ */
+export type PluralRuleFunction = (count: number) => PluralCategory;
+/**
+ * Number format options
+ */
+export interface NumberFormatOptions {
+    readonly style?: 'decimal' | 'currency' | 'percent' | 'unit';
+    readonly currency?: string;
+    readonly minimumFractionDigits?: number;
+    readonly maximumFractionDigits?: number;
+    readonly useGrouping?: boolean;
+}
+/**
+ * Date format options
+ */
+export interface DateFormatOptions {
+    readonly style?: 'short' | 'medium' | 'long' | 'full';
+    readonly dateStyle?: 'short' | 'medium' | 'long' | 'full';
+    readonly timeStyle?: 'short' | 'medium' | 'long' | 'full';
+    readonly year?: 'numeric' | '2-digit';
+    readonly month?: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow';
+    readonly day?: 'numeric' | '2-digit';
+    readonly hour?: 'numeric' | '2-digit';
+    readonly minute?: 'numeric' | '2-digit';
+    readonly second?: 'numeric' | '2-digit';
+    readonly timeZone?: string;
+}
+/**
+ * i18n capability interface
+ */
+export interface I18nCapability {
+    /** Register a locale definition */
+    addLocale(locale: LocaleDefinition): void;
+    /** Load translations for a locale */
+    loadTranslations(localeId: LocaleId, catalog: TranslationCatalog): void;
+    /** Resolve the best locale from a list of preferred locales */
+    resolveLocale(preferred: readonly LocaleId[]): LocaleId;
+    /** Set the current active locale */
+    setLocale(localeId: LocaleId): void;
+    /** Get the current active locale */
+    getLocale(): LocaleId;
+    /** Get all registered locale IDs */
+    getLocaleIds(): readonly LocaleId[];
+    /** Translate a key with optional interpolation values */
+    translate(key: string, values?: Readonly<Record<string, unknown>>): string;
+    /** Shorthand alias for translate */
+    t(key: string, values?: Readonly<Record<string, unknown>>): string;
+    /** Format a number according to the current locale */
+    formatNumber(value: number, options?: NumberFormatOptions): string;
+    /** Format a date according to the current locale */
+    formatDate(value: Date | number, options?: DateFormatOptions): string;
+    /** Check if a translation key exists */
+    hasTranslation(key: string): boolean;
+    /** Clear all locales and translations */
+    clear(): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC7B;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAMjE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAE9E;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,CAAA;AAMlE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAEzC,qCAAqC;IACrC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAEvE,+DAA+D;IAC/D,aAAa,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,CAAA;IAEvD,oCAAoC;IACpC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAEnC,oCAAoC;IACpC,SAAS,IAAI,QAAQ,CAAA;IAErB,oCAAoC;IACpC,YAAY,IAAI,SAAS,QAAQ,EAAE,CAAA;IAEnC,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAA;IAE1E,oCAAoC;IACpC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAA;IAElE,sDAAsD;IACtD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;IAElE,oDAAoD;IACpD,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAA;IAErE,wCAAwC;IACxC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAEpC,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAA;CACd"}

package/dist/i18n/types.js

@@ -0,0 +1,9 @@
+/**
+ * i18n Capability Types
+ *
+ * Locale resolution, translation, pluralization, and formatting
+ *
+ * @module @pwfabric/runtime/i18n/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/i18n/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @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
+ */
+export * from '@pwfabric/contracts';
+export { FabricKernel, createFabric } from './kernel.js';
+export { type CapabilityRegistry, InMemoryCapabilityRegistry, createRegistry } from './registry.js';
+export { type ContractValidator, RuntimeContractValidator, createValidator, isValidationSuccess, isValidationFailure, formatValidationErrors, } from './validator.js';
+export { InMemoryEventBus, createEventBus, createFabricEvent } from './bus.js';
+export { type InvocationHandler, RuntimeExecutionContext, ConsoleExecutionLogger, NoOpExecutionLogger, createExecutionContext, generateTraceId, generateSpanId, type CreateExecutionContextOptions, } from './execution-context.js';
+export * from './context.js';
+export * from './executor.js';
+export * from './surface/index.js';
+export * from './binding/index.js';
+export * from './cache/index.js';
+export * from './graph/index.js';
+export * from './state/index.js';
+export * from './forms/index.js';
+export * from './entity/index.js';
+export * from './connectors/index.js';
+export { SurfaceConnectionsContext, useSurfaceConnections } from './render/index.js';
+export type { BlockComponentProps, BlockComponent, BlockComponentRegistry, CapabilityProvider, BlockContext, SurfaceEventType, SurfaceEvent, SurfaceRendererProps, BlockRendererProps, RenderableSurface, CapabilityType, ImageAdapter, ImageAdapterProps, SurfaceDataSourceKind, SurfaceDataSourceDefinition, SurfaceActionType, SurfaceAction, BlockActionProp, DataBoundSurface, DataBoundSurfaceRendererProps, } from './render/index.js';
+export type { EntitlementContextValue, EntitlementProviderProps, GatedBlockPlaceholderProps, } from './render/index.js';
+export { EntitlementProvider, useEntitlements, GatedBlockPlaceholder } from './render/index.js';
+export type { DynamicBlockWrapperProps, DynamicArtifactContextValue, DynamicArtifactProviderProps, } from './render/index.js';
+export { BlockModuleLoader, DynamicBlockWrapper, DynamicArtifactProvider, preloadDynamicBlocks, useDynamicBlocks, useDynamicStarters, } from './render/index.js';
+export { BlockErrorBoundary } from './render/index.js';
+export { dataSourceCacheKey } from './render/index.js';
+export type { SurfaceDataCache } from './render/index.js';
+export { createSurfaceEventBus } from './render/index.js';
+export { SurfaceEventContext } from './render/index.js';
+export { useSurfaceEvents } from './render/index.js';
+export type { BehaviorSurfaceProviderProps } from './render/index.js';
+export { BehaviorSurfaceProvider } from './render/index.js';
+export { SurfaceIdContext } from './render/index.js';
+export { useSurfaceId } from './render/index.js';
+export type { ShellSelectionStore, ShellSelectionOptions, ShellSelectionProviderProps, } from './render/index.js';
+export { ShellSelectionContext, ShellSelectionProvider, createShellSelectionStore, useShellSelection, } from './render/index.js';
+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';
+export * from './capability/index.js';
+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 type { WebVitalName, WebVitalRating, WebVitalMetric, WebVitalCallback, WebVitalsReport, RenderMetrics, RenderTimerConfig, PerformanceBudget, BudgetViolation, BudgetCheckResult, ReportDestination, ReporterConfig, PerformanceReport, } from './perf/index.js';
+export { WebVitalsCollector, createWebVitalsCollector, rateMetric, RenderTimer, createRenderTimer, DEFAULT_BUDGET, BudgetChecker, createBudgetChecker, PerformanceReporter, createPerformanceReporter, } from './perf/index.js';
+export type { AnnouncementLevel, LiveRegionConfig } from './a11y/index.js';
+export { LiveRegionAnnouncer, createAnnouncer } from './a11y/index.js';
+export type { FocusTrapConfig } from './a11y/index.js';
+export { FocusTrapManager, FocusRestorer, createSkipLink, createFocusTrap, createFocusRestorer, } from './a11y/index.js';
+export type { ArrowDirection, KeyboardNavConfig } from './a11y/index.js';
+export { KeyboardNavigationManager, RovingTabIndex, createKeyboardNav, createRovingTabIndex, } from './a11y/index.js';
+export type { ContrastResult } from './a11y/index.js';
+export { hexToRgb, relativeLuminance, contrastRatio, checkContrast, meetsWCAG, } from './a11y/index.js';
+export { useInstalledAtoms, type InstalledAtomDescriptor, type InstalledAtomKind, type InstalledAtomsState, type InstalledAtomsFetcher, type AtomManifestPayload, type AtomBlockDefinitionMetadata, } from './hooks/useInstalledAtoms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

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