blendsdk 5.33.0

package/dist/expression/core/types.js

@@ -0,0 +1,121 @@
+/**
+ * Core type definitions for expression2
+ */
+/**
+ * SQL dialect enumeration
+ */
+export var SqlDialect;
+(function (SqlDialect) {
+    SqlDialect["PostgreSQL"] = "postgresql";
+    SqlDialect["MySQL"] = "mysql";
+    SqlDialect["MSSQL"] = "mssql";
+    SqlDialect["SQLite"] = "sqlite";
+})(SqlDialect || (SqlDialect = {}));
+/**
+ * Base AST node type
+ */
+export var ASTNodeType;
+(function (ASTNodeType) {
+    ASTNodeType["Comparison"] = "comparison";
+    ASTNodeType["Logical"] = "logical";
+    ASTNodeType["Group"] = "group";
+    ASTNodeType["Json"] = "json";
+    ASTNodeType["FullText"] = "fulltext";
+    ASTNodeType["Subquery"] = "subquery";
+})(ASTNodeType || (ASTNodeType = {}));
+/**
+ * Comparison operators
+ */
+export var ComparisonOperator;
+(function (ComparisonOperator) {
+    ComparisonOperator["Equal"] = "=";
+    ComparisonOperator["NotEqual"] = "<>";
+    ComparisonOperator["GreaterThan"] = ">";
+    ComparisonOperator["GreaterThanOrEqual"] = ">=";
+    ComparisonOperator["LessThan"] = "<";
+    ComparisonOperator["LessThanOrEqual"] = "<=";
+    ComparisonOperator["Like"] = "LIKE";
+    ComparisonOperator["ILike"] = "ILIKE";
+    ComparisonOperator["In"] = "IN";
+    ComparisonOperator["NotIn"] = "NOT IN";
+    ComparisonOperator["Between"] = "BETWEEN";
+    ComparisonOperator["NotBetween"] = "NOT BETWEEN";
+    ComparisonOperator["IsNull"] = "IS NULL";
+    ComparisonOperator["IsNotNull"] = "IS NOT NULL";
+})(ComparisonOperator || (ComparisonOperator = {}));
+/**
+ * Logical operators
+ */
+export var LogicalOperator;
+(function (LogicalOperator) {
+    LogicalOperator["And"] = "AND";
+    LogicalOperator["Or"] = "OR";
+})(LogicalOperator || (LogicalOperator = {}));
+/**
+ * JSON operators (PostgreSQL)
+ */
+export var JsonOperator;
+(function (JsonOperator) {
+    JsonOperator["Contains"] = "@>";
+    JsonOperator["ContainedBy"] = "<@";
+    JsonOperator["HasKey"] = "?";
+    JsonOperator["HasAnyKey"] = "?|";
+    JsonOperator["HasAllKeys"] = "?&";
+    JsonOperator["PathExists"] = "@?";
+})(JsonOperator || (JsonOperator = {}));
+/**
+ * Full-text search modes
+ */
+export var FullTextMode;
+(function (FullTextMode) {
+    FullTextMode["Plain"] = "plain";
+    FullTextMode["Phrase"] = "phrase";
+    FullTextMode["WebSearch"] = "websearch";
+})(FullTextMode || (FullTextMode = {}));
+/**
+ * Type guard to check if a value is an ASTNode
+ */
+export function isASTNode(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        'type' in value &&
+        'id' in value &&
+        Object.values(ASTNodeType).includes(value.type));
+}
+/**
+ * Type guard for ComparisonNode
+ */
+export function isComparisonNode(node) {
+    return node.type === ASTNodeType.Comparison;
+}
+/**
+ * Type guard for LogicalNode
+ */
+export function isLogicalNode(node) {
+    return node.type === ASTNodeType.Logical;
+}
+/**
+ * Type guard for GroupNode
+ */
+export function isGroupNode(node) {
+    return node.type === ASTNodeType.Group;
+}
+/**
+ * Type guard for JsonNode
+ */
+export function isJsonNode(node) {
+    return node.type === ASTNodeType.Json;
+}
+/**
+ * Type guard for FullTextNode
+ */
+export function isFullTextNode(node) {
+    return node.type === ASTNodeType.FullText;
+}
+/**
+ * Type guard for SubqueryNode
+ */
+export function isSubqueryNode(node) {
+    return node.type === ASTNodeType.Subquery;
+}
+//# sourceMappingURL=types.js.map

package/dist/expression/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,uCAAyB,CAAA;IACzB,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,+BAAiB,CAAA;AACnB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAmED;;GAEG;AACH,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,oCAAqB,CAAA;IACrB,oCAAqB,CAAA;AACvB,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAUD;;GAEG;AACH,MAAM,CAAN,IAAY,kBAeX;AAfD,WAAY,kBAAkB;IAC5B,iCAAW,CAAA;IACX,qCAAe,CAAA;IACf,uCAAiB,CAAA;IACjB,+CAAyB,CAAA;IACzB,oCAAc,CAAA;IACd,4CAAsB,CAAA;IACtB,mCAAa,CAAA;IACb,qCAAe,CAAA;IACf,+BAAS,CAAA;IACT,sCAAgB,CAAA;IAChB,yCAAmB,CAAA;IACnB,gDAA0B,CAAA;IAC1B,wCAAkB,CAAA;IAClB,+CAAyB,CAAA;AAC3B,CAAC,EAfW,kBAAkB,KAAlB,kBAAkB,QAe7B;AAcD;;GAEG;AACH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,4BAAS,CAAA;AACX,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAoBD;;GAEG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,kCAAkB,CAAA;IAClB,4BAAY,CAAA;IACZ,gCAAgB,CAAA;IAChB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAeD;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,iCAAiB,CAAA;IACjB,uCAAuB,CAAA;AACzB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAiDD;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAU;IAClC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,IAAI,IAAI,KAAK;QACb,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,UAAU,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,OAAO,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,QAAQ,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,QAAQ,CAAC;AAC5C,CAAC"}

package/dist/expression/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @blendsdk/expression
+ * Modern, type-safe SQL WHERE clause builder with fluent API
+ */
+export { query, QueryBuilderImpl } from './builders/query-builder.js';
+export type { ComparisonBuilder, QueryBuilder, SubqueryBuilder, } from './core/query-builder-interfaces.js';
+export type { ASTNode, ComparisonNode, CompileResult, DebugInfo, FullTextNode, GroupNode, JsonNode, LogicalNode, QueryOptions, SearchOptions, SubqueryNode, } from './core/types.js';
+export { ASTNodeType, ComparisonOperator, FullTextMode, JsonOperator, LogicalOperator, SqlDialect, } from './core/types.js';
+export { PostgreSQLCompiler } from './compiler/postgresql-compiler.js';
+export { ParameterManager } from './core/parameter-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAE5C,YAAY,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/expression/index.js

@@ -0,0 +1,11 @@
+/**
+ * @blendsdk/expression
+ * Modern, type-safe SQL WHERE clause builder with fluent API
+ */
+// Export main query builder
+export { query, QueryBuilderImpl } from './builders/query-builder.js';
+export { ASTNodeType, ComparisonOperator, FullTextMode, JsonOperator, LogicalOperator, SqlDialect, } from './core/types.js';
+// Export utilities
+export { PostgreSQLCompiler } from './compiler/postgresql-compiler.js';
+export { ParameterManager } from './core/parameter-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/expression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4BAA4B;AAC5B,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAuBtE,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/i18n/content-file-source.d.ts

@@ -0,0 +1,109 @@
+import type { TranslationCatalog } from "./types.js";
+import type { TranslationSource } from "./translation-source.js";
+/**
+ * Configuration for the content file translation source.
+ */
+export interface ContentFileSourceConfig {
+    /**
+     * Array of directory paths or glob patterns to scan for content files.
+     *
+     * Each path can be:
+     * - A directory path: all matching files in the directory are loaded
+     * - A glob pattern: files matching the pattern are loaded
+     *
+     * Files must follow the naming convention: `<locale>.<key>.<ext>`
+     * where:
+     * - First segment = locale (e.g., "en", "nl", "de")
+     * - Last segment = file extension (e.g., "html", "md", "txt")
+     * - Middle segments = translation key (e.g., "signup-email", "auth.welcome")
+     *
+     * @example
+     * paths: ["./content/emails", "./content/pages"]
+     * paths: ["./content/emails/*.html"]
+     */
+    paths: string[];
+    /**
+     * File extensions to include (with leading dot).
+     * Files with other extensions are silently ignored.
+     *
+     * @default [".html", ".md", ".txt"]
+     */
+    extensions?: string[];
+}
+/**
+ * Translation source that loads from individual content files.
+ *
+ * Each file represents one translation key for one locale.
+ * The filename convention is `<locale>.<key>.<ext>`:
+ * - `nl.signup-email.html` → locale: "nl", key: "signup-email"
+ * - `en.auth.welcome.md` → locale: "en", key: "auth.welcome"
+ *
+ * File content is read as UTF-8 and stored as-is (no transformation).
+ *
+ * @example
+ * ```typescript
+ * const source = new ContentFileSource({
+ *     paths: ["./content/emails"],
+ * });
+ * const catalog = await source.load();
+ * ```
+ */
+export declare class ContentFileSource implements TranslationSource {
+    /** @inheritdoc */
+    readonly name = "ContentFileSource";
+    /** Source configuration */
+    protected config: ContentFileSourceConfig;
+    /** Resolved extensions (with leading dot, lowercased) */
+    protected extensions: string[];
+    /**
+     * Create a new ContentFileSource.
+     *
+     * @param config - Directory paths, glob patterns, and optional extension filter
+     */
+    constructor(config: ContentFileSourceConfig);
+    /**
+     * Load all translations from configured content file paths.
+     *
+     * 1. Resolves all paths (directories and globs) to individual file paths
+     * 2. Parses each filename for locale and key using `<locale>.<key>.<ext>` convention
+     * 3. Filters by supported extensions
+     * 4. Reads file content as UTF-8
+     * 5. Builds translation catalog with content as-is
+     *
+     * Files that don't match the naming convention or have unsupported
+     * extensions are silently skipped.
+     *
+     * @returns The complete translation catalog from all matched content files
+     * @throws Error if a matched file cannot be read (e.g., permission denied)
+     */
+    load(): Promise<TranslationCatalog>;
+    /**
+     * Resolve all configured paths to individual file paths.
+     *
+     * - Plain directory paths (no glob chars): list all files in the directory
+     * - Glob patterns (contains * or ?): expand using simple wildcard matching
+     *
+     * Results are sorted for deterministic ordering so the same input
+     * always produces the same catalog.
+     *
+     * @returns Array of resolved absolute file paths, sorted alphabetically
+     */
+    protected resolveAllPaths(): Promise<string[]>;
+}
+/**
+ * Create a ContentFileSource instance. Convenience factory for plugin configuration.
+ *
+ * @param config - Content file source configuration
+ * @returns A new ContentFileSource instance
+ *
+ * @example
+ * ```typescript
+ * app.use(createI18nPlugin({
+ *     sources: [
+ *         contentFileSource({ paths: ["./content/emails"] }),
+ *     ],
+ * }));
+ * ```
+ */
+export declare function contentFileSource(config: ContentFileSourceConfig): ContentFileSource;
+//# sourceMappingURL=content-file-source.d.ts.map

package/dist/i18n/content-file-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-file-source.d.ts","sourceRoot":"","sources":["../src/content-file-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AA+GD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACvD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAE1C,yDAAyD;IACzD,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;OAIG;gBACS,MAAM,EAAE,uBAAuB;IAQ3C;;;;;;;;;;;;;;OAcG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAmCzC;;;;;;;;;;OAUG;cACa,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAkBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAEpF"}

package/dist/i18n/content-file-source.js

@@ -0,0 +1,218 @@
+import { readFile, readdir } from "node:fs/promises";
+import { basename, resolve, dirname, extname } from "node:path";
+/** Default file extensions to load when none are configured */
+const DEFAULT_EXTENSIONS = [".html", ".md", ".txt"];
+/**
+ * Parse a content filename into locale and key.
+ *
+ * Convention: `<locale>.<key>.<ext>`
+ * - First dot-segment = locale
+ * - Last dot-segment = extension (ignored, used for filtering)
+ * - Everything in between = translation key
+ *
+ * Requires at least 3 segments (locale + key + extension).
+ *
+ * @param filename - The filename (without directory path)
+ * @returns Parsed locale and key, or null if filename doesn't match convention
+ *
+ * @example
+ * parseContentFilename("nl.signup-email.html")
+ * // → { locale: "nl", key: "signup-email" }
+ *
+ * parseContentFilename("en.auth.welcome.md")
+ * // → { locale: "en", key: "auth.welcome" }
+ *
+ * parseContentFilename("readme.txt")
+ * // → null (only 2 segments — no key)
+ */
+function parseContentFilename(filename) {
+    const segments = filename.split(".");
+    // Need at least 3 segments: locale, key (1+), extension
+    if (segments.length < 3) {
+        return null;
+    }
+    const locale = segments[0];
+    // Skip the last segment (extension) and join middle segments as key
+    const key = segments.slice(1, -1).join(".");
+    // Validate: locale and key must be non-empty
+    if (!locale || !key) {
+        return null;
+    }
+    return { locale, key };
+}
+/**
+ * List all files in a directory (non-recursive).
+ *
+ * Returns an empty array if the directory doesn't exist,
+ * allowing graceful handling of optional content directories.
+ *
+ * @param dirPath - Directory path to list
+ * @returns Array of absolute file paths
+ */
+async function listDirectoryFiles(dirPath) {
+    try {
+        const entries = await readdir(resolve(dirPath));
+        return entries.map((entry) => resolve(dirPath, entry));
+    }
+    catch {
+        // Directory doesn't exist or can't be read — return empty
+        return [];
+    }
+}
+/**
+ * Expand a simple glob pattern into matching file paths.
+ *
+ * Supports only `*` and `?` wildcards in the filename part (not recursive `**`).
+ * This covers the primary use case for content files without needing
+ * an external glob library.
+ *
+ * Same implementation as used by JsonFileSource for consistency.
+ *
+ * @param pattern - A glob pattern (e.g., "./content/*.html")
+ * @returns Array of matching absolute file paths
+ */
+async function expandSimpleGlob(pattern) {
+    const dir = dirname(pattern);
+    const filePattern = basename(pattern);
+    // Convert glob pattern to regex: * → [^/]*, ? → [^/]
+    const regexStr = filePattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&") // Escape regex special chars (except * and ?)
+        .replace(/\*/g, "[^/]*")
+        .replace(/\?/g, "[^/]");
+    const regex = new RegExp(`^${regexStr}$`);
+    try {
+        const entries = await readdir(resolve(dir));
+        return entries
+            .filter((entry) => regex.test(entry))
+            .map((entry) => resolve(dir, entry));
+    }
+    catch {
+        // Directory doesn't exist — return empty (no matches)
+        return [];
+    }
+}
+/**
+ * Translation source that loads from individual content files.
+ *
+ * Each file represents one translation key for one locale.
+ * The filename convention is `<locale>.<key>.<ext>`:
+ * - `nl.signup-email.html` → locale: "nl", key: "signup-email"
+ * - `en.auth.welcome.md` → locale: "en", key: "auth.welcome"
+ *
+ * File content is read as UTF-8 and stored as-is (no transformation).
+ *
+ * @example
+ * ```typescript
+ * const source = new ContentFileSource({
+ *     paths: ["./content/emails"],
+ * });
+ * const catalog = await source.load();
+ * ```
+ */
+export class ContentFileSource {
+    /** @inheritdoc */
+    name = "ContentFileSource";
+    /** Source configuration */
+    config;
+    /** Resolved extensions (with leading dot, lowercased) */
+    extensions;
+    /**
+     * Create a new ContentFileSource.
+     *
+     * @param config - Directory paths, glob patterns, and optional extension filter
+     */
+    constructor(config) {
+        this.config = config;
+        // Normalize extensions: ensure leading dot and lowercase
+        this.extensions = (config.extensions ?? DEFAULT_EXTENSIONS).map((ext) => ext.startsWith(".") ? ext.toLowerCase() : `.${ext.toLowerCase()}`);
+    }
+    /**
+     * Load all translations from configured content file paths.
+     *
+     * 1. Resolves all paths (directories and globs) to individual file paths
+     * 2. Parses each filename for locale and key using `<locale>.<key>.<ext>` convention
+     * 3. Filters by supported extensions
+     * 4. Reads file content as UTF-8
+     * 5. Builds translation catalog with content as-is
+     *
+     * Files that don't match the naming convention or have unsupported
+     * extensions are silently skipped.
+     *
+     * @returns The complete translation catalog from all matched content files
+     * @throws Error if a matched file cannot be read (e.g., permission denied)
+     */
+    async load() {
+        const catalog = {};
+        // Resolve all paths to individual file paths
+        const filePaths = await this.resolveAllPaths();
+        for (const filePath of filePaths) {
+            const filename = basename(filePath);
+            // Parse locale and key from filename
+            const parsed = parseContentFilename(filename);
+            if (!parsed) {
+                // Invalid filename format — skip silently
+                continue;
+            }
+            // Check extension is in the supported list
+            const ext = extname(filename).toLowerCase();
+            if (!this.extensions.includes(ext)) {
+                continue;
+            }
+            // Read file content as-is (no transformation)
+            const content = await readFile(filePath, "utf-8");
+            // Add to catalog: key → { locale: content }
+            if (!catalog[parsed.key]) {
+                catalog[parsed.key] = {};
+            }
+            catalog[parsed.key][parsed.locale] = content;
+        }
+        return catalog;
+    }
+    /**
+     * Resolve all configured paths to individual file paths.
+     *
+     * - Plain directory paths (no glob chars): list all files in the directory
+     * - Glob patterns (contains * or ?): expand using simple wildcard matching
+     *
+     * Results are sorted for deterministic ordering so the same input
+     * always produces the same catalog.
+     *
+     * @returns Array of resolved absolute file paths, sorted alphabetically
+     */
+    async resolveAllPaths() {
+        const allPaths = [];
+        for (const configPath of this.config.paths) {
+            if (configPath.includes("*") || configPath.includes("?")) {
+                // Glob pattern — expand it
+                const matches = await expandSimpleGlob(configPath);
+                allPaths.push(...matches);
+            }
+            else {
+                // Plain directory path — list files
+                const files = await listDirectoryFiles(configPath);
+                allPaths.push(...files);
+            }
+        }
+        // Sort for deterministic ordering
+        return allPaths.sort();
+    }
+}
+/**
+ * Create a ContentFileSource instance. Convenience factory for plugin configuration.
+ *
+ * @param config - Content file source configuration
+ * @returns A new ContentFileSource instance
+ *
+ * @example
+ * ```typescript
+ * app.use(createI18nPlugin({
+ *     sources: [
+ *         contentFileSource({ paths: ["./content/emails"] }),
+ *     ],
+ * }));
+ * ```
+ */
+export function contentFileSource(config) {
+    return new ContentFileSource(config);
+}
+//# sourceMappingURL=content-file-source.js.map

package/dist/i18n/content-file-source.js.map

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

package/dist/i18n/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser-safe core entry point for @blendsdk/i18n.
+ *
+ * This module exports only the runtime-agnostic parts of the i18n library:
+ * Translator, mergeCatalogs, types, and the TranslationSource interface.
+ * It contains NO Node.js-specific imports (no `node:fs`, `node:path`),
+ * making it safe for browser bundlers (Webpack, Vite, esbuild, etc.).
+ *
+ * **Import paths:**
+ * - `@blendsdk/i18n`      — This module (browser-safe core)
+ * - `@blendsdk/i18n/node`  — Full package including JsonFileSource & ContentFileSource (Node.js only)
+ *
+ * @module @blendsdk/i18n
+ */
+export type { TranslationValue, TranslationEntry, TranslationCatalog, TranslatorConfig, LocaleParts, } from "./types.js";
+export { Translator } from "./translator.js";
+export type { TranslationSource } from "./translation-source.js";
+export { mergeCatalogs } from "./merge-catalogs.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,YAAY,EACR,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,21 @@
+/**
+ * Browser-safe core entry point for @blendsdk/i18n.
+ *
+ * This module exports only the runtime-agnostic parts of the i18n library:
+ * Translator, mergeCatalogs, types, and the TranslationSource interface.
+ * It contains NO Node.js-specific imports (no `node:fs`, `node:path`),
+ * making it safe for browser bundlers (Webpack, Vite, esbuild, etc.).
+ *
+ * **Import paths:**
+ * - `@blendsdk/i18n`      — This module (browser-safe core)
+ * - `@blendsdk/i18n/node`  — Full package including JsonFileSource & ContentFileSource (Node.js only)
+ *
+ * @module @blendsdk/i18n
+ */
+// Core
+export { Translator } from "./translator.js";
+// Catalog utilities
+export { mergeCatalogs } from "./merge-catalogs.js";
+// NOTE: JsonFileSource, ContentFileSource, and their factories are Node.js-only
+// and are exported from "./node.js" — see ./node.ts
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,gFAAgF;AAChF,8DAA8D"}

package/dist/i18n/json-file-source.d.ts

@@ -0,0 +1,96 @@
+import type { TranslationCatalog } from "./types.js";
+import type { TranslationSource } from "./translation-source.js";
+/**
+ * Configuration for the JSON file translation source.
+ */
+export interface JsonFileSourceConfig {
+    /**
+     * Array of file paths or glob patterns to load.
+     *
+     * Supports two JSON file formats:
+     *
+     * **Format 1: Multi-locale file** — Each key maps to a locale→value object:
+     * ```json
+     * {
+     *     "greeting": { "en": "Hello", "nl": "Hallo" },
+     *     "book": { "en": ["1 book", "N books"] }
+     * }
+     * ```
+     *
+     * **Format 2: Single-locale file** — Flat key→value, locale derived from filename:
+     * File: `translations/en.json`
+     * ```json
+     * {
+     *     "greeting": "Hello",
+     *     "farewell": "Goodbye"
+     * }
+     * ```
+     * The locale is extracted from the filename: `en.json` → locale "en".
+     *
+     * Both formats are auto-detected per file and normalized into TranslationCatalog.
+     *
+     * @example
+     * paths: ["./translations/*.json"]
+     * paths: ["./translations/en.json", "./translations/nl.json"]
+     */
+    paths: string[];
+}
+/**
+ * Translation source that loads from JSON files.
+ *
+ * Supports two file formats:
+ * 1. Multi-locale: `{ key: { locale: value } }` — all locales in one file
+ * 2. Single-locale: `{ key: value }` — one file per locale, locale from filename
+ *
+ * Format is auto-detected per file based on the structure of the first value.
+ *
+ * @example
+ * ```typescript
+ * const source = new JsonFileSource({
+ *     paths: ["./translations/*.json"],
+ * });
+ * const catalog = await source.load();
+ * ```
+ */
+export declare class JsonFileSource implements TranslationSource {
+    /** @inheritdoc */
+    readonly name = "JsonFileSource";
+    /** Source configuration */
+    protected config: JsonFileSourceConfig;
+    /**
+     * Create a new JsonFileSource.
+     *
+     * @param config - File paths or glob patterns configuration
+     */
+    constructor(config: JsonFileSourceConfig);
+    /**
+     * Load all translations from configured JSON file paths.
+     *
+     * 1. Resolves all glob patterns to file paths
+     * 2. Reads and parses each JSON file
+     * 3. Auto-detects format (multi-locale vs single-locale)
+     * 4. Normalizes into TranslationCatalog entries
+     * 5. Merges all entries (later files override earlier for same key+locale)
+     *
+     * @returns The complete translation catalog from all matched files
+     * @throws Error if a file cannot be read or parsed
+     */
+    load(): Promise<TranslationCatalog>;
+}
+/**
+ * Create a JsonFileSource instance. Convenience factory for plugin configuration.
+ *
+ * @param config - JSON file source configuration
+ * @returns A new JsonFileSource instance
+ *
+ * @example
+ * ```typescript
+ * app.use(createI18nPlugin({
+ *     sources: [
+ *         jsonFileSource({ paths: ["./translations/*.json"] }),
+ *     ],
+ * }));
+ * ```
+ */
+export declare function jsonFileSource(config: JsonFileSourceConfig): JsonFileSource;
+//# sourceMappingURL=json-file-source.d.ts.map

package/dist/i18n/json-file-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file-source.d.ts","sourceRoot":"","sources":["../src/json-file-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAsC,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAGD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACpD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAEvC;;;;OAIG;gBACS,MAAM,EAAE,oBAAoB;IAIxC;;;;;;;;;;;OAWG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAgC5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAE3E"}