@lionrapid/core 0.1.0

package/dist/cache/CacheManager.js

@@ -0,0 +1,277 @@
+/**
+ * CacheManager - TanStack Query-inspired cache management
+ *
+ * Provides unified cache invalidation and optimistic update patterns.
+ */
+/**
+ * CacheManager - Unified cache API inspired by TanStack Query
+ *
+ * @example
+ * ```typescript
+ * // Invalidate by namespace
+ * await i18n.cache.invalidate({ namespace: 'app' });
+ *
+ * // Optimistic update
+ * const previous = i18n.cache.get('en:app:welcome');
+ * i18n.cache.set('en:app:welcome', 'New value');
+ * // ... if error, rollback:
+ * i18n.cache.set('en:app:welcome', previous.value);
+ * ```
+ */
+export class CacheManager {
+    handlerChain;
+    bus;
+    currentLocale;
+    loadNamespaces;
+    constructor(handlerChain, bus, getCurrentLocale, loadNamespaces) {
+        this.handlerChain = handlerChain;
+        this.bus = bus;
+        this.currentLocale = getCurrentLocale;
+        this.loadNamespaces = loadNamespaces;
+    }
+    /**
+     * Get a cached translation entry
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @returns Cache entry with value and styles, or null if not found
+     */
+    get(key) {
+        const entries = this.handlerChain.getEntries();
+        // Search through all handler entries
+        for (const handlerName in entries) {
+            const handlerEntries = entries[handlerName];
+            if (handlerEntries && typeof handlerEntries === 'object') {
+                if (key in handlerEntries) {
+                    const rawValue = handlerEntries[key];
+                    // Parse ContentUnit JSON (stored as { text, styles })
+                    try {
+                        if (typeof rawValue === 'string') {
+                            const parsed = JSON.parse(rawValue);
+                            if (typeof parsed === 'object' && 'text' in parsed) {
+                                return {
+                                    value: String(parsed.text),
+                                    styles: parsed.styles || undefined,
+                                };
+                            }
+                            // Legacy plain string
+                            return { value: rawValue, styles: undefined };
+                        }
+                        // Already an object
+                        return {
+                            value: JSON.stringify(rawValue),
+                            styles: undefined,
+                        };
+                    }
+                    catch {
+                        // If parse fails, treat as plain string
+                        return {
+                            value: typeof rawValue === 'string' ? rawValue : JSON.stringify(rawValue),
+                            styles: undefined,
+                        };
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Set a cache entry (for optimistic updates)
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @param value - Translation value
+     * @param styles - Optional styles for indexed tags
+     */
+    set(key, value, styles) {
+        // Parse the key to get locale, namespace, and translation key
+        const [locale, namespace, ...keyParts] = key.split(':');
+        const translationKey = keyParts.join(':');
+        if (!locale || !namespace || !translationKey) {
+            throw new Error(`Invalid cache key format: "${key}". Expected format: "locale:namespace:key"`);
+        }
+        // Use the handler chain's setCache method for optimistic updates
+        this.handlerChain.setCache(key, value, styles);
+        // Emit cache:set event
+        this.bus.emit('cache:set', {
+            payload: {
+                key,
+                value,
+                styles,
+                optimistic: true,
+            },
+        });
+    }
+    /**
+     * Check if a key exists in cache
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @returns true if key is cached
+     */
+    has(key) {
+        return this.get(key) !== null;
+    }
+    /**
+     * Invalidate cache entries and optionally refetch
+     *
+     * Like TanStack Query's invalidateQueries, this clears matching cache entries
+     * and triggers background refetch by default.
+     *
+     * @param options - Filter options for invalidation
+     *
+     * @example
+     * ```typescript
+     * // Invalidate all
+     * await cache.invalidate();
+     *
+     * // Invalidate by namespace
+     * await cache.invalidate({ namespace: 'app' });
+     *
+     * // Invalidate by locale
+     * await cache.invalidate({ locale: 'es' });
+     *
+     * // Invalidate specific key
+     * await cache.invalidate({ key: 'en:app:welcome' });
+     *
+     * // Invalidate with predicate
+     * await cache.invalidate({ predicate: (k) => k.includes('common:') });
+     *
+     * // Invalidate without refetch
+     * await cache.invalidate({ namespace: 'app', refetch: false });
+     * ```
+     */
+    async invalidate(options = {}) {
+        const { namespace, locale, key, predicate, refetch = true } = options;
+        const currentLocale = this.currentLocale();
+        let keysCleared = 0;
+        // Determine what to clear
+        if (key) {
+            // Clear specific key
+            const [keyLocale, keyNamespace] = key.split(':');
+            if (keyLocale && keyNamespace) {
+                this.handlerChain.clearNamespace(keyLocale, keyNamespace);
+                keysCleared = 1;
+            }
+        }
+        else if (namespace && locale) {
+            // Clear specific locale + namespace
+            this.handlerChain.clearNamespace(locale, namespace);
+            keysCleared = this.countClearedKeys(locale, namespace);
+        }
+        else if (namespace) {
+            // Clear namespace for current locale
+            this.handlerChain.clearNamespace(currentLocale, namespace);
+            keysCleared = this.countClearedKeys(currentLocale, namespace);
+        }
+        else if (locale) {
+            // Clear all namespaces for a specific locale
+            const entries = this.handlerChain.getEntries();
+            const namespacesToClear = new Set();
+            for (const handlerName in entries) {
+                const handlerEntries = entries[handlerName];
+                if (handlerEntries && typeof handlerEntries === 'object') {
+                    for (const entryKey of Object.keys(handlerEntries)) {
+                        if (entryKey.startsWith(`${locale}:`) || entryKey.startsWith(`@${locale}:`)) {
+                            const parts = entryKey.replace('@', '').split(':');
+                            if (parts[1]) {
+                                namespacesToClear.add(parts[1]);
+                            }
+                        }
+                    }
+                }
+            }
+            for (const ns of namespacesToClear) {
+                this.handlerChain.clearNamespace(locale, ns);
+                keysCleared++;
+            }
+        }
+        else if (predicate) {
+            // Clear with custom predicate
+            const entries = this.handlerChain.getEntries();
+            const toClear = new Map(); // locale -> namespaces
+            for (const handlerName in entries) {
+                const handlerEntries = entries[handlerName];
+                if (handlerEntries && typeof handlerEntries === 'object') {
+                    for (const entryKey of Object.keys(handlerEntries)) {
+                        if (predicate(entryKey)) {
+                            const parts = entryKey.replace('@', '').split(':');
+                            const entryLocale = parts[0];
+                            const entryNs = parts[1];
+                            if (entryLocale && entryNs) {
+                                if (!toClear.has(entryLocale)) {
+                                    toClear.set(entryLocale, new Set());
+                                }
+                                toClear.get(entryLocale).add(entryNs);
+                                keysCleared++;
+                            }
+                        }
+                    }
+                }
+            }
+            for (const [loc, namespaces] of toClear) {
+                for (const ns of namespaces) {
+                    this.handlerChain.clearNamespace(loc, ns);
+                }
+            }
+        }
+        else {
+            // Clear all
+            this.handlerChain.clearCache();
+            keysCleared = -1; // Indicates all cleared
+        }
+        // Emit invalidate event
+        this.bus.emit('cache:invalidate', {
+            payload: {
+                filter: options,
+                keysCleared,
+                refetch,
+            },
+        });
+        // Refetch if requested
+        if (refetch) {
+            await this.refetchAfterInvalidate(options);
+        }
+    }
+    /**
+     * Count keys that would be cleared (for event reporting)
+     */
+    countClearedKeys(locale, namespace) {
+        const entries = this.handlerChain.getEntries();
+        let count = 0;
+        const prefix = `${locale}:${namespace}:`;
+        const namespaceKey = `@${locale}:${namespace}`;
+        for (const handlerName in entries) {
+            const handlerEntries = entries[handlerName];
+            if (handlerEntries && typeof handlerEntries === 'object') {
+                for (const key of Object.keys(handlerEntries)) {
+                    if (key.startsWith(prefix) || key === namespaceKey) {
+                        count++;
+                    }
+                }
+            }
+        }
+        return count;
+    }
+    /**
+     * Refetch data after invalidation
+     */
+    async refetchAfterInvalidate(options) {
+        const { namespace, locale, key } = options;
+        const currentLocale = this.currentLocale();
+        if (key) {
+            // Refetch specific namespace from key
+            const [keyLocale, keyNamespace] = key.split(':');
+            if (keyLocale && keyNamespace) {
+                await this.loadNamespaces(keyLocale, [keyNamespace]);
+            }
+        }
+        else if (namespace) {
+            // Refetch namespace for specific or current locale
+            await this.loadNamespaces(locale || currentLocale, [namespace]);
+        }
+        else if (locale) {
+            // For locale-wide invalidation, we can't easily know which namespaces to reload
+            // The app will lazy-load them as needed
+        }
+        // For full cache clear, lazy loading will handle refetch
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/cache/CacheManager.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cache module exports
+ */
+export { CacheManager } from './CacheManager.js';
+export type { CacheEntry as CacheManagerEntry, CacheEventPayloads, InvalidateOptions, } from './CacheManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,UAAU,IAAI,iBAAiB,EAC/B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,5 @@
+/**
+ * Cache module exports
+ */
+export { CacheManager } from './CacheManager.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * All configuration exports
+ */
+export * from './lionrapid.config.js';
+export * from './repository.config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,6 @@
+/**
+ * All configuration exports
+ */
+export * from './lionrapid.config.js';
+export * from './repository.config.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/config/lionrapid.config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core LionRapid configuration - only built-in features
+ */
+export interface LionRapidCoreConfig {
+    defaultLocale?: string;
+    fallbackLocale?: string;
+    namespace?: string;
+    debugMode?: boolean;
+    maxRetries?: number;
+    options?: Record<string, unknown>;
+}
+//# sourceMappingURL=lionrapid.config.d.ts.map

package/dist/config/lionrapid.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lionrapid.config.d.ts","sourceRoot":"","sources":["../../src/config/lionrapid.config.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/config/lionrapid.config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lionrapid.config.js.map

package/dist/config/lionrapid.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lionrapid.config.js","sourceRoot":"","sources":["../../src/config/lionrapid.config.ts"],"names":[],"mappings":""}

package/dist/config/logger.config.d.ts

@@ -0,0 +1,19 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+export interface LoggerConfig {
+    level?: LogLevel;
+    enabled?: boolean;
+    prefix?: string;
+    showLineNumbers?: boolean;
+    useColors?: boolean;
+}
+export interface PackageLoggerConfig extends LoggerConfig {
+    packageName?: string;
+    packageEmoji?: string;
+}
+//# sourceMappingURL=logger.config.d.ts.map

package/dist/config/logger.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.config.d.ts","sourceRoot":"","sources":["../../src/config/logger.config.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACT;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/config/logger.config.js

@@ -0,0 +1,9 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 4] = "NONE";
+})(LogLevel || (LogLevel = {}));
+//# sourceMappingURL=logger.config.js.map

package/dist/config/logger.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.config.js","sourceRoot":"","sources":["../../src/config/logger.config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;AACV,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}

package/dist/config/repository.config.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Handler configuration types
+ */
+/**
+ * Base configuration for all handlers
+ */
+/**
+ * Memory  handler specific configuration
+ */
+export interface MemoryRepositoryConfig {
+    enabled?: boolean;
+    priority?: number;
+    options?: {
+        /** Maximum number of translations to cache */
+        maxSize?: number;
+        /** TTL for cache entries in milliseconds */
+        ttl?: number;
+        [key: string]: unknown;
+    };
+}
+export interface StorageRepositoryConfig {
+    enabled?: boolean;
+    priority?: number;
+    options?: {
+        prefix?: string;
+        persistent?: boolean;
+        ttl?: number;
+        priority?: number;
+        [key: string]: unknown;
+    };
+}
+export interface PreloadNamespaces {
+    locale: string;
+    namespace: string;
+    eager?: boolean;
+}
+/**
+ * Missing translation sync configuration
+ */
+export interface SyncMissingConfig {
+    /** Enable automatic syncing of missing translations */
+    enabled: boolean;
+    /** Debounce delay in milliseconds before syncing (default: 500) */
+    debounceMs: number;
+    /** Maximum batch size before forcing immediate flush (default: 50) */
+    batchSize: number;
+}
+/**
+ * Network Repository endpoint configuration
+ * Supports placeholder syntax: :key, :locale, :namespace
+ */
+export interface NetworkEndpoints {
+    /** GET single translation - default: '/api/integrations/translations/:key' */
+    getTranslation?: string;
+    /** GET namespace translations - default: '/api/integrations/translations/:locale/:namespace' */
+    getNamespace?: string;
+    /** PUT single translation - default: '/api/integrations/sync/:key' */
+    setTranslation?: string;
+    /** PUT namespace translations - default: '/api/integrations/sync/:locale/:namespace' */
+    setNamespace?: string;
+    /** POST batch translations - default: '/api/integrations/sync/batch' */
+    setBatch?: string;
+    /** DELETE single translation - default: '/api/integrations/sync/:key' */
+    removeTranslation?: string;
+    /** DELETE all translations - default: '/translations' */
+    clearTranslations?: string;
+}
+/**
+ * Network Repository specific configuration
+ */
+export interface NetworkRepositoryConfig {
+    enabled?: boolean;
+    priority?: number;
+    options?: {
+        baseUrl: string;
+        timeout?: number;
+        retries?: number;
+        retryDelay?: number;
+        headers?: Record<string, string>;
+        apiKey?: string;
+        endpoints?: NetworkEndpoints;
+        preloadNamespaces?: Array<PreloadNamespaces>;
+        syncMissing?: SyncMissingConfig;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=repository.config.d.ts.map

package/dist/config/repository.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.config.d.ts","sourceRoot":"","sources":["../../src/config/repository.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AASH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,8CAA8C;QAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,4CAA4C;QAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAGlB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAER,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;QAGhB,SAAS,CAAC,EAAE,gBAAgB,CAAC;QAG7B,iBAAiB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAG7C,WAAW,CAAC,EAAE,iBAAiB,CAAC;QAGhC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/config/repository.config.js

@@ -0,0 +1,5 @@
+/**
+ * Handler configuration types
+ */
+export {};
+//# sourceMappingURL=repository.config.js.map

package/dist/config/repository.config.js.map

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

package/dist/content/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Content module - Unified Content Architecture for LionRapid
+ *
+ * Provides types, interfaces, and utilities for handling styled content
+ * with indexed tags and ICU MessageFormat support.
+ *
+ * @module content
+ */
+export type { ContentUnit } from './types.js';
+export type { IParser } from './parser/IParser.js';
+export { MarkupParser } from './parser/MarkupParser.js';
+export type { MarkupParserOptions } from './parser/MarkupParser.js';
+export type { ISerializer } from './serializer/ISerializer.js';
+export { HTMLSerializer } from './serializer/HTMLSerializer.js';
+export type { HTMLSerializerOptions } from './serializer/HTMLSerializer.js';
+export type { IValidator, ValidationResult, ValidationError, ValidationWarning, ValidationErrorCode, ValidationWarningCode, } from './validator/IValidator.js';
+export { ContentValidator } from './validator/ContentValidator.js';
+export type { IStyleMapper, ElementMapping } from './style-mapper/IStyleMapper.js';
+export { DefaultStyleMapper } from './style-mapper/DefaultStyleMapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAG5E,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/content/index.js

@@ -0,0 +1,13 @@
+/**
+ * Content module - Unified Content Architecture for LionRapid
+ *
+ * Provides types, interfaces, and utilities for handling styled content
+ * with indexed tags and ICU MessageFormat support.
+ *
+ * @module content
+ */
+export { MarkupParser } from './parser/MarkupParser.js';
+export { HTMLSerializer } from './serializer/HTMLSerializer.js';
+export { ContentValidator } from './validator/ContentValidator.js';
+export { DefaultStyleMapper } from './style-mapper/DefaultStyleMapper.js';
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKxD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAYhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAInE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/content/parser/IParser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parser interface for converting platform-specific input to ContentUnit
+ * @module content/parser/IParser
+ */
+import type { ContentUnit } from '../types.js';
+/**
+ * Generic parser interface
+ *
+ * Implementations:
+ * - MarkupParser: HTML string → ContentUnit (core)
+ * - JSXParser: ReactNode → ContentUnit (react package)
+ *
+ * @typeParam TInput - Platform-specific input type
+ *
+ * @example
+ * ```typescript
+ * class MarkupParser implements IParser<string> {
+ *   parse(html: string): ContentUnit {
+ *     // Convert <b>, <a>, etc. to indexed tags
+ *   }
+ * }
+ * ```
+ */
+export interface IParser<TInput> {
+    /**
+     * Parse input into ContentUnit
+     *
+     * @param input - Platform-specific input (string, ReactNode, etc.)
+     * @returns Normalized ContentUnit with indexed tags and styles
+     */
+    parse(input: TInput): ContentUnit;
+}
+//# sourceMappingURL=IParser.d.ts.map

package/dist/content/parser/IParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IParser.d.ts","sourceRoot":"","sources":["../../../src/content/parser/IParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,OAAO,CAAC,MAAM;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CACnC"}

package/dist/content/parser/IParser.js

@@ -0,0 +1,6 @@
+/**
+ * Parser interface for converting platform-specific input to ContentUnit
+ * @module content/parser/IParser
+ */
+export {};
+//# sourceMappingURL=IParser.js.map

package/dist/content/parser/IParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IParser.js","sourceRoot":"","sources":["../../../src/content/parser/IParser.ts"],"names":[],"mappings":"AAAA;;;GAGG"}