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

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

package/dist/i18n/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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;
+}

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

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @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';