@kabyeon/nexusjs 0.6.5

package/dist/i18n/index.js.map

@@ -0,0 +1,17 @@
+{
+  "version": 3,
+  "sources": ["../src/core/constants.ts", "../src/core/decorators/params.ts", "../src/i18n/service.ts", "../src/core/decorators/module.ts", "../src/core/decorators/injectable.ts", "../src/i18n/module.ts", "../src/i18n/middleware.ts", "../src/i18n/decorators.ts"],
+  "sourcesContent": [
+    "/**\n * Metadata keys used by reflect-metadata for storing decorator data.\n *\n * These constants are the contract between decorators and the framework\n * core (DI container, router, validator).\n */\nexport const METADATA_KEY = {\n\t/** Marks a class as a Nest-style controller, stores route prefix. */\n\tCONTROLLER: \"nexus:controller\",\n\n\t/** Marks a class as an injectable provider. */\n\tINJECTABLE: \"nexus:injectable\",\n\n\t/** Marks a class as a repository. */\n\tREPOSITORY: \"nexus:repository\",\n\n\t/** Marks a class as a module. Stores module options. */\n\tMODULE: \"nexus:module\",\n\n\t/** HTTP method routes registered on a controller (Get/Post/...). */\n\tROUTES: \"nexus:routes\",\n\n\t/** Method parameter type metadata (body/query/param/headers/ctx). */\n\tPARAMS: \"nexus:params\",\n\n\t/** Validation schema per method (Zod schema or class). */\n\tVALIDATE: \"nexus:validate\",\n\n\t/** Class-level design:paramtypes (built-in). */\n\tPARAMTYPES: \"design:paramtypes\",\n\n\t/** Class-level design:type (built-in). */\n\tTYPE: \"design:type\",\n\n\t/** Class-level design:returntype (built-in). */\n\tRETURNTYPE: \"design:returntype\",\n\n\t/** Provider token to inject for a parameter (for custom tokens). */\n\tINJECT: \"nexus:inject\",\n} as const;\n\nexport type MetadataKey = (typeof METADATA_KEY)[keyof typeof METADATA_KEY];\n\n/** Available parameter decorator locations. */\nexport const PARAM_TYPES = {\n\tREQUEST: 0,\n\tRESPONSE: 1,\n\tNEXT: 2,\n\tBODY: 3,\n\tQUERY: 4,\n\tPARAM: 5,\n\tHEADERS: 6,\n\tCTX: 7,\n\tUSER: 8,\n} as const;\n\nexport type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];\n\n/** HTTP methods supported by the router. */\nexport const HTTP_METHODS = [\n\t\"GET\",\n\t\"POST\",\n\t\"PUT\",\n\t\"DELETE\",\n\t\"PATCH\",\n\t\"OPTIONS\",\n\t\"HEAD\",\n] as const;\nexport type HttpMethod = (typeof HTTP_METHODS)[number];\n",
+    "/**\n * Parameter decorators.\n *\n * These mark a controller method argument as a source of request data:\n *   - `@Req()`        → Hono context\n *   - `@Res()`        → Response helper\n *   - `@Next()`       → next() callback (for middleware-style handlers)\n *   - `@Body()`       → request body (parsed)\n *   - `@Query('key')` → a single query param, or full query object\n *   - `@Param('key')` → a single path param, or full params object\n *   - `@Headers('k')` → a single header, or full headers object\n *   - `@Ctx()`        → Hono context (alias for @Req)\n *   - `@User()`       → authenticated user (resolved via auth provider)\n *\n * The metadata is read by the router at mount time to build the\n * handler invocation list.\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY, PARAM_TYPES } from \"../constants.js\";\nimport type { ParamMetadata } from \"../di/tokens.js\";\n\nexport function createParamDecorator(\n\ttype: number,\n\tdata?: string | object,\n): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\t// Method parameter: target is the prototype, propertyKey is the method name.\n\t\t// Constructor parameter: target is the class, propertyKey is undefined.\n\t\tif (propertyKey !== undefined) {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target, propertyKey);\n\t\t} else {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target);\n\t\t}\n\t};\n}\n\nexport const Req = () => createParamDecorator(PARAM_TYPES.REQUEST);\nexport const Res = () => createParamDecorator(PARAM_TYPES.RESPONSE);\nexport const Next = () => createParamDecorator(PARAM_TYPES.NEXT);\nexport const Body = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.BODY, key);\nexport const Query = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.QUERY, key);\nexport const Param = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.PARAM, key);\nexport const Headers = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.HEADERS, key);\nexport const Ctx = () => createParamDecorator(PARAM_TYPES.CTX);\nexport const User = () => createParamDecorator(PARAM_TYPES.USER);\n\nexport function getParamMetadata(\n\ttarget: any,\n\tpropertyKey: string | symbol,\n): ParamMetadata[] {\n\treturn Reflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n}\n\nexport { PARAM_TYPES };\n",
+    "/**\n * `I18nService` — locale-aware translation + formatting.\n *\n * Usage:\n *\n *   const i18n = new I18nService({\n *     defaultLocale: \"en\",\n *     messages: {\n *       en: { hello: \"Hello, :name!\" },\n *       ko: { hello: \"안녕하세요, :name님!\" },\n *     },\n *   });\n *\n *   i18n.t(\"hello\", { name: \"Alice\" });              // → \"Hello, Alice!\"\n *   i18n.t(\"hello\", { name: \"Alice\" }, \"ko\");       // → \"안녕하세요, Alice님!\"\n *\n * The service is registered as a DI singleton by\n * `I18nModule.forRoot(config)`. The Hono middleware (built-in)\n * extracts the locale from the request and stores it in the\n * request context. Controllers can read it via the\n * `@CurrentLocale()` decorator.\n *\n * Message format:\n *\n *   \"auth.welcome\": \"Welcome, :name!\"            # interpolation\n *   \"items.count\":  \"no items|:count items\"      # pluralization (| separator)\n *   \"deep.key\":     \"value\"                       # nested lookup\n *\n * The plural-form separator uses `Intl.PluralRules` to pick the\n * right form. The number of `|` segments is configurable per\n * locale via the `pluralCategories()` helper.\n *\n * Locale fallback chain:\n *   - Exact match (`fr-CA`)\n *   - Region fallback (`fr`)\n *   - Default locale\n */\n\nimport type {\n\tLocale,\n\tMessageCatalog,\n\tMessageDict,\n\tTranslateArgs,\n\tPluralCategory,\n\tCurrencyFormatOptions,\n\tDateFormatOptions,\n\tNumberFormatOptions,\n} from \"./types.js\";\n\nconst DEFAULT_PLURAL_CATEGORIES: PluralCategory[] = [\n\t\"zero\",\n\t\"one\",\n\t\"two\",\n\t\"few\",\n\t\"many\",\n\t\"other\",\n];\n\nexport const I18N_SERVICE_TOKEN = Symbol.for(\"nexus:I18nService\");\n\nexport class I18nService {\n\tprivate messages: MessageCatalog = {};\n\tprivate defaultLocale: Locale;\n\tprivate fallback: boolean;\n\tprivate fallbackToDefault: boolean;\n\tprivate supportedLocales: Set<Locale> | null = null;\n\t/** Cached `Intl.PluralRules` per locale. */\n\tprivate pluralRulesCache = new Map<Locale, Intl.PluralRules>();\n\t/** Cached `Intl.DateTimeFormat` per (locale, options) key. */\n\tprivate dateFormatCache = new Map<string, Intl.DateTimeFormat>();\n\t/** Cached `Intl.NumberFormat` per (locale, options) key. */\n\tprivate numberFormatCache = new Map<string, Intl.NumberFormat>();\n\t/** Cached `Intl.Collator` per locale. */\n\tprivate collatorCache = new Map<Locale, Intl.Collator>();\n\n\tconstructor(config: {\n\t\tdefaultLocale?: Locale;\n\t\tfallback?: boolean;\n\t\tfallbackToDefault?: boolean;\n\t\tsupportedLocales?: Locale[];\n\t\tmessages?: MessageCatalog;\n\t} = {}) {\n\t\tthis.defaultLocale = config.defaultLocale ?? \"en\";\n\t\tthis.fallback = config.fallback ?? true;\n\t\tthis.fallbackToDefault = config.fallbackToDefault ?? true;\n\t\tif (config.supportedLocales && config.supportedLocales.length > 0) {\n\t\t\tthis.supportedLocales = new Set(config.supportedLocales);\n\t\t}\n\t\tif (config.messages) {\n\t\t\tfor (const [locale, dict] of Object.entries(config.messages)) {\n\t\t\t\tthis.addMessages(locale, dict);\n\t\t\t}\n\t\t}\n\t}\n\n\t/* ---------------- messages ---------------- */\n\n\t/**\n\t * Add (or merge) messages for a locale. Nested dicts are merged\n\t * recursively — so you can call `addMessages` multiple times\n\t * for the same locale.\n\t */\n\taddMessages(locale: Locale, dict: MessageDict): void {\n\t\tconst existing = this.messages[locale] ?? {};\n\t\tthis.messages[locale] = mergeDict(existing, dict);\n\t}\n\n\t/** Replace the entire message catalog. */\n\tsetMessages(catalog: MessageCatalog): void {\n\t\tthis.messages = {};\n\t\tfor (const [locale, dict] of Object.entries(catalog)) {\n\t\t\tthis.addMessages(locale, dict);\n\t\t}\n\t}\n\n\t/** True if a message key exists in the given locale. */\n\thasMessage(key: string, locale: Locale = this.defaultLocale): boolean {\n\t\treturn resolveKey(this.messages[locale], key) !== undefined;\n\t}\n\n\t/** Get a raw message string (with no interpolation or pluralization). */\n\tgetRaw(key: string, locale: Locale = this.defaultLocale): string | undefined {\n\t\tconst value = resolveKey(this.messages[locale], key);\n\t\treturn typeof value === \"string\" ? value : undefined;\n\t}\n\n\t/* ---------------- translation ---------------- */\n\n\t/**\n\t * Translate a key.\n\t *\n\t * - `args` interpolates `:name`-style placeholders.\n\t * - If the value contains `|` segments, the appropriate plural\n\t *   form is selected based on `args.count` (or the first\n\t *   numeric arg).\n\t * - `locale` defaults to the configured default locale. Pass\n\t *   an explicit locale to override.\n\t *\n\t * If the key is missing in `locale`, the service falls back to\n\t * the default locale (if `fallbackToDefault` is true) and then\n\t * to the key itself (so the developer sees what's missing).\n\t */\n\tt(\n\t\tkey: string,\n\t\targs?: TranslateArgs,\n\t\tlocale: Locale = this.defaultLocale,\n\t): string {\n\t\tconst raw = this.lookupRaw(key, locale);\n\t\tif (raw === undefined) {\n\t\t\t// Key not found. Return the key itself, optionally\n\t\t\t// bracketed, so the developer can spot it.\n\t\t\treturn key;\n\t\t}\n\t\treturn this.format(raw, args, locale);\n\t}\n\n\t/**\n\t * Translate a key; if not found, return the fallback string\n\t * (no `[]` brackets). Useful for optional UI text.\n\t */\n\ttOr(\n\t\tkey: string,\n\t\tfallback: string,\n\t\targs?: TranslateArgs,\n\t\tlocale: Locale = this.defaultLocale,\n\t): string {\n\t\tconst raw = this.lookupRaw(key, locale);\n\t\tif (raw === undefined) return this.format(fallback, args, locale);\n\t\treturn this.format(raw, args, locale);\n\t}\n\n\t/**\n\t * Translate a key with explicit plural control. The `count`\n\t * argument is used to select the plural form.\n\t */\n\ttChoice(\n\t\tkey: string,\n\t\tcount: number,\n\t\targs: TranslateArgs = {},\n\t\tlocale: Locale = this.defaultLocale,\n\t): string {\n\t\treturn this.t(key, { ...args, count }, locale);\n\t}\n\n\t/**\n\t * Format a raw message template with args (interpolation +\n\t * plural selection). Exposed for users who want to format\n\t * messages outside the catalog.\n\t */\n\tformat(template: string, args: TranslateArgs = {}, locale: Locale = this.defaultLocale): string {\n\t\t// 1. Select plural form (if any)\n\t\tconst selected = this.selectPluralForm(template, args, locale);\n\t\t// 2. Interpolate :name placeholders\n\t\treturn this.interpolate(selected, args);\n\t}\n\n\t/* ---------------- pluralization ---------------- */\n\n\t/**\n\t * Return the plural category for `count` in the given locale.\n\t * Wraps `Intl.PluralRules`.\n\t */\n\tpluralCategory(count: number, locale: Locale = this.defaultLocale): PluralCategory {\n\t\tconst rules = this.getPluralRules(locale);\n\t\treturn rules.select(count) as PluralCategory;\n\t}\n\n\t/* ---------------- formatters ---------------- */\n\n\tformatDate(\n\t\tdate: Date | number | string,\n\t\toptions: DateFormatOptions = {},\n\t\tlocale?: Locale,\n\t): string {\n\t\tconst useLocale = options.locale ?? locale ?? this.defaultLocale;\n\t\tconst key = `${useLocale}|${stableStringify(options)}`;\n\t\tlet fmt = this.dateFormatCache.get(key);\n\t\tif (!fmt) {\n\t\t\tfmt = new Intl.DateTimeFormat(useLocale, options);\n\t\t\tthis.dateFormatCache.set(key, fmt);\n\t\t}\n\t\treturn fmt.format(typeof date === \"string\" ? new Date(date) : new Date(date));\n\t}\n\n\tformatNumber(\n\t\tvalue: number,\n\t\toptions: NumberFormatOptions = {},\n\t\tlocale?: Locale,\n\t): string {\n\t\tconst useLocale = options.locale ?? locale ?? this.defaultLocale;\n\t\tconst key = `${useLocale}|${stableStringify(options)}`;\n\t\tlet fmt = this.numberFormatCache.get(key);\n\t\tif (!fmt) {\n\t\t\tfmt = new Intl.NumberFormat(useLocale, options);\n\t\t\tthis.numberFormatCache.set(key, fmt);\n\t\t}\n\t\treturn fmt.format(value);\n\t}\n\n\tformatCurrency(\n\t\tamount: number,\n\t\toptions: CurrencyFormatOptions,\n\t\tlocale?: Locale,\n\t): string {\n\t\tconst useLocale = options.locale ?? locale ?? this.defaultLocale;\n\t\tconst { locale: _omit, ...opts } = options;\n\t\tconst key = `${useLocale}|${stableStringify(opts)}`;\n\t\tlet fmt = this.numberFormatCache.get(key);\n\t\tif (!fmt) {\n\t\t\tfmt = new Intl.NumberFormat(useLocale, { style: \"currency\", ...opts });\n\t\t\tthis.numberFormatCache.set(key, fmt);\n\t\t}\n\t\treturn fmt.format(amount);\n\t}\n\n\t/**\n\t * Compare two strings using locale-aware ordering.\n\t * Returns negative if a < b, positive if a > b, 0 if equal.\n\t */\n\tcompare(a: string, b: string, locale: Locale = this.defaultLocale): number {\n\t\tlet c = this.collatorCache.get(locale);\n\t\tif (!c) {\n\t\t\tc = new Intl.Collator(locale);\n\t\t\tthis.collatorCache.set(locale, c);\n\t\t}\n\t\treturn c.compare(a, b);\n\t}\n\n\t/* ---------------- locales ---------------- */\n\n\tgetDefaultLocale(): Locale {\n\t\treturn this.defaultLocale;\n\t}\n\n\t/** Locales currently registered (in the catalog). */\n\tgetLocales(): Locale[] {\n\t\treturn Object.keys(this.messages);\n\t}\n\n\t/** True if the locale is in the supported set (or all are allowed). */\n\tisSupported(locale: Locale): boolean {\n\t\tif (!this.supportedLocales) return true;\n\t\treturn this.supportedLocales.has(locale);\n\t}\n\n\t/** Negotiate a locale from a list of candidates. */\n\tnegotiateLocale(\n\t\tpreferred: Locale[] = [],\n\t\tacceptLanguage?: string,\n\t): Locale {\n\t\t// Combine preferred (in order) with Accept-Language (sorted by\n\t\t// quality). Preferred wins because the caller may have already\n\t\t// applied query/cookie priorities.\n\t\tconst candidates: Locale[] = [...preferred];\n\t\tif (acceptLanguage) {\n\t\t\tfor (const tag of parseAcceptLanguage(acceptLanguage)) {\n\t\t\t\tif (!candidates.includes(tag)) candidates.push(tag);\n\t\t\t}\n\t\t}\n\t\tfor (const cand of candidates) {\n\t\t\tif (this.isSupported(cand) && this.messages[cand]) return cand;\n\t\t\tif (this.fallback) {\n\t\t\t\tconst lang = cand.split(\"-\")[0];\n\t\t\t\tif (lang && lang !== cand && this.isSupported(lang) && this.messages[lang]) {\n\t\t\t\t\treturn lang;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn this.defaultLocale;\n\t}\n\n\t/* ---------------- internals ---------------- */\n\n\tprivate lookupRaw(key: string, locale: Locale): string | undefined {\n\t\t// 1. Exact match\n\t\tconst v = resolveKey(this.messages[locale], key);\n\t\tif (typeof v === \"string\") return v;\n\n\t\t// 2. Region fallback\n\t\tif (this.fallback) {\n\t\t\tconst lang = locale.split(\"-\")[0];\n\t\t\tif (lang && lang !== locale) {\n\t\t\t\tconst v2 = resolveKey(this.messages[lang], key);\n\t\t\t\tif (typeof v2 === \"string\") return v2;\n\t\t\t}\n\t\t}\n\n\t\t// 3. Default-locale fallback\n\t\tif (this.fallbackToDefault && locale !== this.defaultLocale) {\n\t\t\tconst v3 = resolveKey(this.messages[this.defaultLocale], key);\n\t\t\tif (typeof v3 === \"string\") return v3;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\tprivate selectPluralForm(\n\t\ttemplate: string,\n\t\targs: TranslateArgs,\n\t\tlocale: Locale,\n\t): string {\n\t\tif (!template.includes(\"|\")) return template;\n\t\tconst segments = template.split(\"|\");\n\t\tif (segments.length === 1) return template;\n\n\t\t// Find a count in args\n\t\tconst count = pickCount(args);\n\t\tif (count === undefined) {\n\t\t\t// No count → use the \"other\" form (last segment).\n\t\t\treturn segments[segments.length - 1]!;\n\t\t}\n\n\t\tconst category = this.pluralCategory(count, locale);\n\t\tconst idx = this.pluralIndex(category, segments.length);\n\t\treturn segments[idx]!;\n\t}\n\n\tprivate pluralIndex(category: PluralCategory, segmentCount: number): number {\n\t\t// Map plural category to a segment index. The number of\n\t\t// segments the user provides maps to CLDR categories as\n\t\t// follows (the AdonisJS / i18next convention):\n\t\t//   1 segment  → other\n\t\t//   2 segments → one | other\n\t\t//   3 segments → zero | one | other\n\t\t//   4 segments → zero | one | two | other\n\t\t//   5 segments → zero | one | two | few | other\n\t\t//   6 segments → zero | one | two | few | many | other\n\t\t// Categories not in the table (e.g. \"few\" with 3 segments)\n\t\t// fall back to the last segment (\"other\").\n\t\tif (segmentCount <= 1) return segmentCount - 1;\n\t\t// Build a mapping table.\n\t\tconst table: Record<number, PluralCategory[]> = {\n\t\t\t2: [\"one\", \"other\"],\n\t\t\t3: [\"zero\", \"one\", \"other\"],\n\t\t\t4: [\"zero\", \"one\", \"two\", \"other\"],\n\t\t\t5: [\"zero\", \"one\", \"two\", \"few\", \"other\"],\n\t\t\t6: [\"zero\", \"one\", \"two\", \"few\", \"many\", \"other\"],\n\t\t};\n\t\tconst cats = table[segmentCount] ?? [\"other\"];\n\t\tconst i = cats.indexOf(category);\n\t\tif (i < 0) return segmentCount - 1;\n\t\treturn i;\n\t}\n\n\tprivate getPluralRules(locale: Locale): Intl.PluralRules {\n\t\tlet r = this.pluralRulesCache.get(locale);\n\t\tif (!r) {\n\t\t\ttry {\n\t\t\t\tr = new Intl.PluralRules(locale);\n\t\t\t} catch {\n\t\t\t\tr = new Intl.PluralRules(this.defaultLocale);\n\t\t\t}\n\t\t\tthis.pluralRulesCache.set(locale, r);\n\t\t}\n\t\treturn r;\n\t}\n\n\tprivate interpolate(template: string, args: TranslateArgs): string {\n\t\tif (Object.keys(args).length === 0) return template;\n\t\treturn template.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (match, name: string) => {\n\t\t\tif (name in args) {\n\t\t\t\treturn String(args[name]);\n\t\t\t}\n\t\t\treturn match;\n\t\t});\n\t}\n}\n\n/* ------------------------------------------------------------------ *\n * Helpers\n * ------------------------------------------------------------------ */\n\nfunction resolveKey(\n\tdict: MessageDict | undefined,\n\tkey: string,\n): string | MessageDict | undefined {\n\tif (!dict) return undefined;\n\tconst parts = key.split(\".\");\n\tlet cur: string | MessageDict | undefined = dict;\n\tfor (const p of parts) {\n\t\tif (cur && typeof cur === \"object\" && p in (cur as MessageDict)) {\n\t\t\tcur = (cur as MessageDict)[p];\n\t\t} else {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\treturn cur;\n}\n\nfunction mergeDict(target: MessageDict, source: MessageDict): MessageDict {\n\tconst out: MessageDict = { ...target };\n\tfor (const [k, v] of Object.entries(source)) {\n\t\tconst existing = out[k];\n\t\tif (\n\t\t\texisting &&\n\t\t\ttypeof existing === \"object\" &&\n\t\t\t!Array.isArray(existing) &&\n\t\t\tv &&\n\t\t\ttypeof v === \"object\" &&\n\t\t\t!Array.isArray(v)\n\t\t) {\n\t\t\tout[k] = mergeDict(existing as MessageDict, v as MessageDict);\n\t\t} else {\n\t\t\tout[k] = v;\n\t\t}\n\t}\n\treturn out;\n}\n\nfunction pickCount(args: TranslateArgs): number | undefined {\n\tif (\"count\" in args && typeof args.count === \"number\") return args.count;\n\tfor (const v of Object.values(args)) {\n\t\tif (typeof v === \"number\") return v;\n\t}\n\treturn undefined;\n}\n\nfunction parseAcceptLanguage(header: string): Locale[] {\n\treturn header\n\t\t.split(\",\")\n\t\t.map((part) => {\n\t\t\tconst [tag, qPart] = part.trim().split(\";\");\n\t\t\tconst q = qPart?.startsWith(\"q=\") ? Number(qPart.slice(2)) : 1;\n\t\t\treturn { tag: tag?.trim() ?? \"\", q: isFinite(q) ? q : 1 };\n\t\t})\n\t\t.filter((e) => e.tag.length > 0)\n\t\t.sort((a, b) => b.q - a.q)\n\t\t.map((e) => e.tag);\n}\n\nfunction stableStringify(obj: object): string {\n\treturn JSON.stringify(obj, (_k, v) => {\n\t\tif (v && typeof v === \"object\" && !Array.isArray(v)) {\n\t\t\tconst sorted: Record<string, unknown> = {};\n\t\t\tfor (const key of Object.keys(v).sort()) {\n\t\t\t\tsorted[key] = (v as Record<string, unknown>)[key];\n\t\t\t}\n\t\t\treturn sorted;\n\t\t}\n\t\treturn v;\n\t});\n}\n",
+    "/**\n * @Module decorator.\n *\n * Marks a class as a Nest-style module: a logical grouping of\n * controllers and providers with explicit imports/exports.\n *\n * @example\n * ```ts\n * @Module({\n *   imports: [UserModule],\n *   controllers: [UserController],\n *   providers: [UserService],\n *   exports: [UserService],\n * })\n * class AppModule {}\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ModuleOptions, Type } from \"../di/tokens.js\";\n\nexport function Module(options: ModuleOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.MODULE, options, target);\n\t};\n}\n\n/** Read the @Module options from a class. */\nexport function getModuleOptions(target: Type<any>): ModuleOptions {\n\treturn Reflect.getMetadata(METADATA_KEY.MODULE, target) ?? {};\n}\n",
+    "/**\n * @Injectable decorator.\n *\n * Marks a class as available for DI. The container uses reflect-metadata's\n * `design:paramtypes` to read constructor parameter types and resolve them\n * automatically.\n *\n * @example\n * ```ts\n * @Injectable()\n * class UserService {\n *   constructor(private repo: UserRepository) {}\n * }\n *\n * @Injectable({ scope: 'request' })\n * class RequestContext {\n *   constructor(@Inject(REQUEST) private req: any) {}\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\n\nexport interface InjectableOptions {\n\tscope?: \"singleton\" | \"request\" | \"transient\";\n}\n\nexport function Injectable(options: InjectableOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.INJECTABLE, true, target);\n\t\tif (options.scope) {\n\t\t\tReflect.defineMetadata(\n\t\t\t\t\"nexus:di:scope\",\n\t\t\t\toptions.scope,\n\t\t\t\ttarget,\n\t\t\t);\n\t\t}\n\t};\n}\n\nexport function isInjectable(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.INJECTABLE, target);\n}\n\n/**\n * Read the scope declared on a class via `@Injectable({ scope })`.\n * Returns undefined when no scope is declared (defaults to singleton).\n */\nexport function getScope(\n\ttarget: any,\n): \"singleton\" | \"request\" | \"transient\" | undefined {\n\treturn Reflect.getMetadata(\"nexus:di:scope\", target);\n}\n\n/**\n * Mark a parameter as resolved by a specific token instead of its declared\n * type. Useful for interfaces, abstract classes, or string tokens.\n *\n * @example\n * ```ts\n * constructor(@Inject('CONFIG') private config: AppConfig) {}\n * ```\n */\nexport function Inject<T = any>(token: any): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\tconst existing: Map<number, any> =\n\t\t\tReflect.getMetadata(METADATA_KEY.INJECT, target) ?? new Map();\n\t\texisting.set(parameterIndex, token);\n\t\tReflect.defineMetadata(METADATA_KEY.INJECT, existing, target);\n\t};\n}",
+    "/**\n * `I18nModule` — wires `I18nService` into the DI container.\n *\n * Usage:\n *\n *   @Module({\n *     imports: [\n *       I18nModule.forRoot({\n *         defaultLocale: \"en\",\n *         messages: {\n *           en: { hello: \"Hello, :name!\" },\n *           ko: { hello: \"안녕하세요, :name님!\" },\n *         },\n *       }),\n *     ],\n *   })\n *   class AppModule {}\n *\n * The middleware is also exported (`i18nMiddleware()`) and\n * installed by the module's static `install()` helper:\n *\n *   const app = new Application(AppModule);\n *   I18nModule.install(app, container);  // or via @Module middleware config\n */\n\nimport { Module } from \"../core/decorators/module.js\";\nimport { Inject } from \"../core/decorators/injectable.js\";\nimport \"reflect-metadata\";\nimport type { Application } from \"../core/application.js\";\nimport {\n\tI18nService,\n\tI18N_SERVICE_TOKEN,\n} from \"./service.js\";\nimport { i18nMiddleware } from \"./middleware.js\";\nimport type { I18nConfig, Locale, MessageCatalog } from \"./types.js\";\n\n@Module({\n\tproviders: [\n\t\tI18nService,\n\t\t{ provide: I18N_SERVICE_TOKEN, useExisting: I18nService },\n\t],\n\texports: [I18nService, I18N_SERVICE_TOKEN],\n})\nexport class I18nModule {\n\tstatic forRoot(config: I18nConfig = {}) {\n\t\tconst fullConfig: Required<I18nConfig> = {\n\t\t\tdefaultLocale: config.defaultLocale ?? \"en\",\n\t\t\tfallback: config.fallback ?? true,\n\t\t\tfallbackToDefault: config.fallbackToDefault ?? true,\n\t\t\tsupportedLocales: config.supportedLocales ?? [],\n\t\t\tmessages: config.messages ?? {},\n\t\t\tmessagesDir: config.messagesDir ?? \"\",\n\t\t\tdetectQueryKey: config.detectQueryKey ?? \"lang\",\n\t\t\tdetectCookieKey: config.detectCookieKey ?? \"lang\",\n\t\t};\n\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\t{\n\t\t\t\t\tprovide: I18nService,\n\t\t\t\t\tuseFactory: () => {\n\t\t\t\t\t\tconst svc = new I18nService({\n\t\t\t\t\t\t\tdefaultLocale: fullConfig.defaultLocale,\n\t\t\t\t\t\t\tfallback: fullConfig.fallback,\n\t\t\t\t\t\t\tfallbackToDefault: fullConfig.fallbackToDefault,\n\t\t\t\t\t\t\tsupportedLocales: fullConfig.supportedLocales,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tif (fullConfig.messages) {\n\t\t\t\t\t\t\tsvc.setMessages(fullConfig.messages as MessageCatalog);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (fullConfig.messagesDir) {\n\t\t\t\t\t\t\tloadFromDir(svc, fullConfig.messagesDir);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn svc;\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{ provide: I18N_SERVICE_TOKEN, useExisting: I18nService },\n\t\t\t\t{ provide: \"I18N_CONFIG\", useValue: fullConfig },\n\t\t\t],\n\t\t\texports: [I18nService, I18N_SERVICE_TOKEN, \"I18N_CONFIG\"],\n\t\t})\n\t\tclass ConfiguredI18nModule {\n\t\t\tconstructor(@Inject(I18N_SERVICE_TOKEN) readonly service: I18nService) {}\n\n\t\t\t/** Returns a Hono middleware bound to the configured service. */\n\t\t\tmiddleware() {\n\t\t\t\treturn i18nMiddleware(this.service, {\n\t\t\t\t\tqueryKey: fullConfig.detectQueryKey,\n\t\t\t\t\tcookieKey: fullConfig.detectCookieKey,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\tObject.defineProperty(ConfiguredI18nModule, \"name\", {\n\t\t\tvalue: \"ConfiguredI18nModule\",\n\t\t});\n\n\t\t// Add static `install` helper.\n\t\t(ConfiguredI18nModule as unknown as { install: (app: Application) => void }).install = (\n\t\t\tapp: Application,\n\t\t) => {\n\t\t\t// Lazy: the module is constructed when the app boots.\n\t\t\t// The user typically accesses the middleware via\n\t\t\t// `app.i18nMiddleware()` instead.\n\t\t\tvoid app;\n\t\t};\n\n\t\treturn ConfiguredI18nModule as unknown as typeof ConfiguredI18nModule & {\n\t\t\treadonly config: typeof fullConfig;\n\t\t};\n\t}\n}\n\n/* ------------------------------------------------------------------ *\n * Loader: messages from disk\n * ------------------------------------------------------------------ */\n\nfunction loadFromDir(svc: I18nService, dir: string): void {\n\t// Lazy-import `node:fs` so this module is edge-safe.\n\tlet fs: typeof import(\"node:fs\");\n\tlet path: typeof import(\"node:path\");\n\ttry {\n\t\tfs = require(\"node:fs\");\n\t\tpath = require(\"node:path\");\n\t} catch {\n\t\tthrow new Error(\n\t\t\t\"I18nModule messagesDir requires a Node-like runtime. \" +\n\t\t\t\t\"On Cloudflare Workers, register messages programmatically \" +\n\t\t\t\t\"via I18nModule.forRoot({ messages: {...} }).\",\n\t\t);\n\t}\n\n\tconst stat = fs.statSync(dir);\n\tif (!stat.isDirectory()) {\n\t\tthrow new Error(`I18nModule messagesDir is not a directory: ${dir}`);\n\t}\n\tfor (const file of fs.readdirSync(dir)) {\n\t\tif (!file.endsWith(\".json\")) continue;\n\t\tconst locale = file.replace(/\\.json$/, \"\");\n\t\tconst content = fs.readFileSync(path.join(dir, file), \"utf8\");\n\t\ttry {\n\t\t\tconst dict = JSON.parse(content);\n\t\t\tsvc.addMessages(locale, dict);\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t`I18nModule: failed to parse ${file}: ${(err as Error).message}`,\n\t\t\t);\n\t\t}\n\t}\n}\n",
+    "/**\n * Hono middleware that detects the active locale for a request\n * and stores it in the Hono context (`c.var.locale`).\n *\n * Detection priority:\n *   1. Query string: `?lang=ko`\n *   2. Cookie: `lang=ko`\n *   3. `Accept-Language` header\n *   4. Default locale\n *\n * The middleware uses `I18nService.negotiateLocale()` to pick\n * the best locale based on the request headers and the\n * service's registered catalog.\n */\n\nimport type { Context, MiddlewareHandler, Next } from \"hono\";\nimport type { I18nService } from \"./service.js\";\nimport type { DetectOptions, Locale } from \"./types.js\";\n\n/** Augment Hono's `c.var` with the active locale. */\ndeclare module \"hono\" {\n\tinterface ContextVariableMap {\n\t\tlocale?: Locale;\n\t\ti18n?: I18nService;\n\t}\n}\n\nexport function i18nMiddleware(\n\tservice: I18nService,\n\toptions: DetectOptions = {},\n): MiddlewareHandler {\n\tconst queryKey = options.queryKey ?? \"lang\";\n\tconst cookieKey = options.cookieKey ?? \"lang\";\n\tconst defaultLocale = options.defaultLocale ?? service.getDefaultLocale();\n\n\treturn async (c: Context, next: Next) => {\n\t\tconst fromQuery = c.req.query(queryKey);\n\t\tconst fromCookie = getCookie(c, cookieKey);\n\t\tconst acceptLanguage = c.req.header(\"accept-language\");\n\n\t\tconst preferred: Locale[] = [];\n\t\tif (fromQuery) preferred.push(fromQuery);\n\t\tif (fromCookie) preferred.push(fromCookie);\n\t\tif (acceptLanguage) {\n\t\t\tpreferred.push(...parseAcceptLanguage(acceptLanguage));\n\t\t}\n\t\tpreferred.push(defaultLocale);\n\n\t\tconst locale = service.negotiateLocale(preferred, acceptLanguage);\n\t\tc.set(\"locale\", locale);\n\t\tc.set(\"i18n\", service);\n\t\tawait next();\n\t};\n}\n\n/* ------------------------------------------------------------------ *\n * Helpers\n * ------------------------------------------------------------------ */\n\nfunction getCookie(c: Context, name: string): string | undefined {\n\t// Hono parses cookies lazily via `c.req.header(\"cookie\")`. We\n\t// parse a small subset here; for production apps with many\n\t// cookies, prefer `hono/cookie`.\n\tconst raw = c.req.header(\"cookie\");\n\tif (!raw) return undefined;\n\tfor (const part of raw.split(\";\")) {\n\t\tconst [k, ...rest] = part.trim().split(\"=\");\n\t\tif (k === name) return decodeURIComponent(rest.join(\"=\"));\n\t}\n\treturn undefined;\n}\n\nfunction parseAcceptLanguage(header: string): Locale[] {\n\treturn header\n\t\t.split(\",\")\n\t\t.map((part) => {\n\t\t\tconst [tag, qPart] = part.trim().split(\";\");\n\t\t\tconst q = qPart?.startsWith(\"q=\") ? Number(qPart.slice(2)) : 1;\n\t\t\treturn { tag: tag?.trim() ?? \"\", q: isFinite(q) ? q : 1 };\n\t\t})\n\t\t.filter((e) => e.tag.length > 0)\n\t\t.sort((a, b) => b.q - a.q)\n\t\t.map((e) => e.tag);\n}\n",
+    "/**\n * `@CurrentLocale()` — controller parameter decorator that\n * injects the active locale string (e.g. `\"en\"`, `\"ko\"`).\n *\n * Requires that `i18nMiddleware()` has been installed upstream.\n *\n *   @Get('/')\n *   index(@CurrentLocale() locale: string) {\n *     return { locale };\n *   }\n */\n\nimport \"reflect-metadata\";\nimport { createParamDecorator } from \"../core/decorators/params.js\";\nimport { PARAM_TYPES } from \"../core/constants.js\";\nimport type { Locale } from \"./types.js\";\n\nexport function CurrentLocale(): ParameterDecorator {\n\treturn createParamDecorator(PARAM_TYPES.USER, {} as never) as ParameterDecorator;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "1C79ABD6524A60BB64756E2164756E21",
+  "names": []
+}

package/dist/i18n/middleware.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hono middleware that detects the active locale for a request
+ * and stores it in the Hono context (`c.var.locale`).
+ *
+ * Detection priority:
+ *   1. Query string: `?lang=ko`
+ *   2. Cookie: `lang=ko`
+ *   3. `Accept-Language` header
+ *   4. Default locale
+ *
+ * The middleware uses `I18nService.negotiateLocale()` to pick
+ * the best locale based on the request headers and the
+ * service's registered catalog.
+ */
+import type { MiddlewareHandler } from "hono";
+import type { I18nService } from "./service.js";
+import type { DetectOptions, Locale } from "./types.js";
+/** Augment Hono's `c.var` with the active locale. */
+declare module "hono" {
+    interface ContextVariableMap {
+        locale?: Locale;
+        i18n?: I18nService;
+    }
+}
+export declare function i18nMiddleware(service: I18nService, options?: DetectOptions): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/i18n/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAW,iBAAiB,EAAQ,MAAM,MAAM,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAExD,qDAAqD;AACrD,OAAO,QAAQ,MAAM,CAAC;IACrB,UAAU,kBAAkB;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,WAAW,CAAC;KACnB;CACD;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,aAAkB,GACzB,iBAAiB,CAuBnB"}

package/dist/i18n/module.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `I18nModule` — wires `I18nService` into the DI container.
+ *
+ * Usage:
+ *
+ *   @Module({
+ *     imports: [
+ *       I18nModule.forRoot({
+ *         defaultLocale: "en",
+ *         messages: {
+ *           en: { hello: "Hello, :name!" },
+ *           ko: { hello: "안녕하세요, :name님!" },
+ *         },
+ *       }),
+ *     ],
+ *   })
+ *   class AppModule {}
+ *
+ * The middleware is also exported (`i18nMiddleware()`) and
+ * installed by the module's static `install()` helper:
+ *
+ *   const app = new Application(AppModule);
+ *   I18nModule.install(app, container);  // or via @Module middleware config
+ */
+import "reflect-metadata";
+import { I18nService } from "./service.js";
+import type { I18nConfig } from "./types.js";
+export declare class I18nModule {
+    static forRoot(config?: I18nConfig): {
+        new (service: I18nService): {
+            readonly service: I18nService;
+            /** Returns a Hono middleware bound to the configured service. */
+            middleware(): import("hono").MiddlewareHandler;
+        };
+    } & {
+        readonly config: Required<I18nConfig>;
+    };
+}
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/i18n/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACN,WAAW,EAEX,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,YAAY,CAAC;AAErE,qBAOa,UAAU;IACtB,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,UAAe,GA8DK;sBAxBiB,WAAW;8BAAX,WAAW;YAErE,iEAAiE;;;QAsBM;QACvE,QAAQ,CAAC,MAAM,uBAAoB;KACnC;CAEF"}

package/dist/i18n/service.d.ts

@@ -0,0 +1,130 @@
+/**
+ * `I18nService` — locale-aware translation + formatting.
+ *
+ * Usage:
+ *
+ *   const i18n = new I18nService({
+ *     defaultLocale: "en",
+ *     messages: {
+ *       en: { hello: "Hello, :name!" },
+ *       ko: { hello: "안녕하세요, :name님!" },
+ *     },
+ *   });
+ *
+ *   i18n.t("hello", { name: "Alice" });              // → "Hello, Alice!"
+ *   i18n.t("hello", { name: "Alice" }, "ko");       // → "안녕하세요, Alice님!"
+ *
+ * The service is registered as a DI singleton by
+ * `I18nModule.forRoot(config)`. The Hono middleware (built-in)
+ * extracts the locale from the request and stores it in the
+ * request context. Controllers can read it via the
+ * `@CurrentLocale()` decorator.
+ *
+ * Message format:
+ *
+ *   "auth.welcome": "Welcome, :name!"            # interpolation
+ *   "items.count":  "no items|:count items"      # pluralization (| separator)
+ *   "deep.key":     "value"                       # nested lookup
+ *
+ * The plural-form separator uses `Intl.PluralRules` to pick the
+ * right form. The number of `|` segments is configurable per
+ * locale via the `pluralCategories()` helper.
+ *
+ * Locale fallback chain:
+ *   - Exact match (`fr-CA`)
+ *   - Region fallback (`fr`)
+ *   - Default locale
+ */
+import type { Locale, MessageCatalog, MessageDict, TranslateArgs, PluralCategory, CurrencyFormatOptions, DateFormatOptions, NumberFormatOptions } from "./types.js";
+export declare const I18N_SERVICE_TOKEN: unique symbol;
+export declare class I18nService {
+    private messages;
+    private defaultLocale;
+    private fallback;
+    private fallbackToDefault;
+    private supportedLocales;
+    /** Cached `Intl.PluralRules` per locale. */
+    private pluralRulesCache;
+    /** Cached `Intl.DateTimeFormat` per (locale, options) key. */
+    private dateFormatCache;
+    /** Cached `Intl.NumberFormat` per (locale, options) key. */
+    private numberFormatCache;
+    /** Cached `Intl.Collator` per locale. */
+    private collatorCache;
+    constructor(config?: {
+        defaultLocale?: Locale;
+        fallback?: boolean;
+        fallbackToDefault?: boolean;
+        supportedLocales?: Locale[];
+        messages?: MessageCatalog;
+    });
+    /**
+     * Add (or merge) messages for a locale. Nested dicts are merged
+     * recursively — so you can call `addMessages` multiple times
+     * for the same locale.
+     */
+    addMessages(locale: Locale, dict: MessageDict): void;
+    /** Replace the entire message catalog. */
+    setMessages(catalog: MessageCatalog): void;
+    /** True if a message key exists in the given locale. */
+    hasMessage(key: string, locale?: Locale): boolean;
+    /** Get a raw message string (with no interpolation or pluralization). */
+    getRaw(key: string, locale?: Locale): string | undefined;
+    /**
+     * Translate a key.
+     *
+     * - `args` interpolates `:name`-style placeholders.
+     * - If the value contains `|` segments, the appropriate plural
+     *   form is selected based on `args.count` (or the first
+     *   numeric arg).
+     * - `locale` defaults to the configured default locale. Pass
+     *   an explicit locale to override.
+     *
+     * If the key is missing in `locale`, the service falls back to
+     * the default locale (if `fallbackToDefault` is true) and then
+     * to the key itself (so the developer sees what's missing).
+     */
+    t(key: string, args?: TranslateArgs, locale?: Locale): string;
+    /**
+     * Translate a key; if not found, return the fallback string
+     * (no `[]` brackets). Useful for optional UI text.
+     */
+    tOr(key: string, fallback: string, args?: TranslateArgs, locale?: Locale): string;
+    /**
+     * Translate a key with explicit plural control. The `count`
+     * argument is used to select the plural form.
+     */
+    tChoice(key: string, count: number, args?: TranslateArgs, locale?: Locale): string;
+    /**
+     * Format a raw message template with args (interpolation +
+     * plural selection). Exposed for users who want to format
+     * messages outside the catalog.
+     */
+    format(template: string, args?: TranslateArgs, locale?: Locale): string;
+    /**
+     * Return the plural category for `count` in the given locale.
+     * Wraps `Intl.PluralRules`.
+     */
+    pluralCategory(count: number, locale?: Locale): PluralCategory;
+    formatDate(date: Date | number | string, options?: DateFormatOptions, locale?: Locale): string;
+    formatNumber(value: number, options?: NumberFormatOptions, locale?: Locale): string;
+    formatCurrency(amount: number, options: CurrencyFormatOptions, locale?: Locale): string;
+    /**
+     * Compare two strings using locale-aware ordering.
+     * Returns negative if a < b, positive if a > b, 0 if equal.
+     */
+    compare(a: string, b: string, locale?: Locale): number;
+    getDefaultLocale(): Locale;
+    /** Locales currently registered (in the catalog). */
+    getLocales(): Locale[];
+    /** True if the locale is in the supported set (or all are allowed). */
+    isSupported(locale: Locale): boolean;
+    /** Negotiate a locale from a list of candidates. */
+    negotiateLocale(preferred?: Locale[], acceptLanguage?: string): Locale;
+    private lookupRaw;
+    private selectPluralForm;
+    private pluralIndex;
+    private getPluralRules;
+    private interpolate;
+}
+//# sourceMappingURL=service.d.ts.map

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

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

package/dist/i18n/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Public types for `nexusjs/i18n`.
+ *
+ * `nexusjs/i18n` provides locale-aware translation and formatting
+ * for the Bun-native stack. It uses Node's built-in `Intl` API
+ * for date / number / currency / pluralization — zero external
+ * dependencies.
+ */
+/** A locale identifier. e.g. `"en"`, `"en-US"`, `"fr-CA"`, `"ko"`. */
+export type Locale = string;
+/** A message dictionary. Values can be strings (terminal) or nested dicts. */
+export type MessageDict = {
+    [key: string]: string | MessageDict;
+};
+/** A flat `locale → messages` map. */
+export type MessageCatalog = Record<Locale, MessageDict>;
+/** Arguments passed to `t()`. Values are coerced to strings. */
+export type TranslateArgs = Record<string, string | number | boolean>;
+/** A plural rule key. Matches `Intl.PluralRule` outputs. */
+export type PluralCategory = "zero" | "one" | "two" | "few" | "many" | "other";
+/** A plural form for a single message. Use `|` to separate forms. */
+export type PluralForm = `${string | number}${string}`;
+export interface I18nConfig {
+    /** Default locale. Default: `"en"`. */
+    defaultLocale?: Locale;
+    /** Whether to fall back to a more general locale (e.g. `fr-CA` → `fr`)
+     * when an exact match is not found. Default: `true`. */
+    fallback?: boolean;
+    /** Whether to fall back to the default locale when a key is missing
+     * in the requested locale. Default: `true`. */
+    fallbackToDefault?: boolean;
+    /** Whitelist of supported locales. Empty / undefined = all. */
+    supportedLocales?: Locale[];
+    /** Initial messages (also useful for tests). */
+    messages?: MessageCatalog;
+    /** When set, load `*.json` files from this directory on boot. */
+    messagesDir?: string;
+    /** Query string key for locale detection. Default: `"lang"`. */
+    detectQueryKey?: string;
+    /** Cookie name for locale detection. Default: `"lang"`. */
+    detectCookieKey?: string;
+}
+export interface DetectOptions {
+    /** Override the query key. */
+    queryKey?: string;
+    /** Override the cookie name. */
+    cookieKey?: string;
+    /** Override the default locale. */
+    defaultLocale?: Locale;
+}
+export interface DateFormatOptions extends Intl.DateTimeFormatOptions {
+    /** IETF locale tag. Defaults to the active locale. */
+    locale?: Locale;
+}
+export interface NumberFormatOptions extends Intl.NumberFormatOptions {
+    /** IETF locale tag. Defaults to the active locale. */
+    locale?: Locale;
+}
+export interface CurrencyFormatOptions extends Intl.NumberFormatOptions {
+    /** IETF locale tag. Defaults to the active locale. */
+    locale?: Locale;
+    /** ISO 4217 currency code (e.g. `"USD"`, `"KRW"`). */
+    currency: string;
+}
+//# 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;;;;;;;GAOG;AAMH,sEAAsE;AACtE,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAM5B,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;CACpC,CAAC;AAEF,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAMzD,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAMtE,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/E,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAMvD,MAAM,WAAW,UAAU;IAC1B,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;4DACwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;mDAC+C;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,aAAa;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,qBAAqB;IACpE,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB;IACpE,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,mBAAmB;IACtE,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CACjB"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './core/index.js';
+export { default } from './core/application.js';