@i18n-micro/types 1.1.5 → 1.1.7

package/dist/index.d.ts

@@ -28,6 +28,29 @@ export type TranslationKey = keyof DefineLocaleMessage extends never ? string :
  * ```
  */
 export type ScopedKey<Scope extends string> = Extract<TranslationKey, `${Scope}.${string}`>;
+/**
+ * Locale configuration object.
+ *
+ * Supports arbitrary custom properties via the index signature `[key: string]: unknown`.
+ * To get full TypeScript support for your custom properties, use module augmentation:
+ *
+ * ```typescript
+ * // app/i18n.d.ts (or any .d.ts file included in your tsconfig)
+ * declare module '@i18n-micro/types' {
+ *   interface Locale {
+ *     flag?: string
+ *     currency?: string
+ *   }
+ * }
+ * ```
+ *
+ * Then access them with full typing:
+ * ```typescript
+ * const locales = $getLocales()
+ * locales[0].flag     // string | undefined  (typed!)
+ * locales[0].currency // string | undefined  (typed!)
+ * ```
+ */
 export interface Locale {
     /** BCP-47 locale code (e.g. `'en'`, `'de-DE'`, `'zh-Hans'`). Used in URLs and as file/key identifier. */
     code: LocaleCode;
@@ -171,6 +194,13 @@ export interface ModuleOptions {
      * @default true
      */
     hooks?: boolean;
+    /**
+     * Register built-in i18n components (`<i18n-link>`, `<i18n-switcher>`, `<i18n-t>`, `<i18n-group>`).
+     * Set to `false` to disable automatic component registration (e.g. if you don't use them
+     * and want to reduce the module footprint).
+     * @default true
+     */
+    components?: boolean;
     /**
      * The locale to use when no locale can be determined from URL or user preferences.
      * Also used as the fallback locale for missing translations when `fallbackLocale` is not set.
@@ -340,11 +370,22 @@ export interface ModuleOptions {
      */
     cacheMaxSize?: number;
     /**
-     * Time-to-live (in milliseconds) for cached translation entries.
+     * Time-to-live (in seconds) for cached translation entries.
      * `0` means entries never expire.
      * @default 0
      */
     cacheTtl?: number;
+    /**
+     * Value used for cache-busting translation requests (`?v=...`).
+     *
+     * When not provided, the module falls back to `Date.now()` (non-deterministic).
+     * For reproducible/rolling deployments, set this to a stable value
+     * (e.g. a git SHA or build number).
+     *
+     * @example
+     * i18n: { dateBuild: 'e3b0c442' }
+     */
+    dateBuild?: string | number;
     /**
      * Bucket for experimental/unstable options.
      * Contents may change or be removed without notice between minor versions.
@@ -356,8 +397,8 @@ export interface ModuleOptions {
  * Includes resolved values and build-time metadata.
  */
 export interface ModuleOptionsExtend extends ModuleOptions {
-    /** Unix timestamp (ms) of the last build. Used for cache-busting translation requests. */
-    dateBuild: number;
+    /** Value used for cache-busting translation requests (`?v=...`). */
+    dateBuild: string | number;
     /** Whether the Nuxt app uses hash-based routing (`router.options.hashMode`). */
     hashMode: boolean;
     /** Whether the current build is a static site generation (SSG / `nuxi generate`). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/types",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "",
   "repository": "s00d/nuxt-i18n-micro",
   "license": "MIT",

package/src/index.ts

@@ -33,6 +33,29 @@ export type TranslationKey = keyof DefineLocaleMessage extends never ? string :
  */
 export type ScopedKey<Scope extends string> = Extract<TranslationKey, `${Scope}.${string}`>
 
+/**
+ * Locale configuration object.
+ *
+ * Supports arbitrary custom properties via the index signature `[key: string]: unknown`.
+ * To get full TypeScript support for your custom properties, use module augmentation:
+ *
+ * ```typescript
+ * // app/i18n.d.ts (or any .d.ts file included in your tsconfig)
+ * declare module '@i18n-micro/types' {
+ *   interface Locale {
+ *     flag?: string
+ *     currency?: string
+ *   }
+ * }
+ * ```
+ *
+ * Then access them with full typing:
+ * ```typescript
+ * const locales = $getLocales()
+ * locales[0].flag     // string | undefined  (typed!)
+ * locales[0].currency // string | undefined  (typed!)
+ * ```
+ */
 export interface Locale {
   /** BCP-47 locale code (e.g. `'en'`, `'de-DE'`, `'zh-Hans'`). Used in URLs and as file/key identifier. */
   code: LocaleCode
@@ -195,6 +218,14 @@ export interface ModuleOptions {
    */
   hooks?: boolean
 
+  /**
+   * Register built-in i18n components (`<i18n-link>`, `<i18n-switcher>`, `<i18n-t>`, `<i18n-group>`).
+   * Set to `false` to disable automatic component registration (e.g. if you don't use them
+   * and want to reduce the module footprint).
+   * @default true
+   */
+  components?: boolean
+
   /**
    * The locale to use when no locale can be determined from URL or user preferences.
    * Also used as the fallback locale for missing translations when `fallbackLocale` is not set.
@@ -388,12 +419,24 @@ export interface ModuleOptions {
   cacheMaxSize?: number
 
   /**
-   * Time-to-live (in milliseconds) for cached translation entries.
+   * Time-to-live (in seconds) for cached translation entries.
    * `0` means entries never expire.
    * @default 0
    */
   cacheTtl?: number
 
+  /**
+   * Value used for cache-busting translation requests (`?v=...`).
+   *
+   * When not provided, the module falls back to `Date.now()` (non-deterministic).
+   * For reproducible/rolling deployments, set this to a stable value
+   * (e.g. a git SHA or build number).
+   *
+   * @example
+   * i18n: { dateBuild: 'e3b0c442' }
+   */
+  dateBuild?: string | number
+
   /**
    * Bucket for experimental/unstable options.
    * Contents may change or be removed without notice between minor versions.
@@ -406,8 +449,8 @@ export interface ModuleOptions {
  * Includes resolved values and build-time metadata.
  */
 export interface ModuleOptionsExtend extends ModuleOptions {
-  /** Unix timestamp (ms) of the last build. Used for cache-busting translation requests. */
-  dateBuild: number
+  /** Value used for cache-busting translation requests (`?v=...`). */
+  dateBuild: string | number
   /** Whether the Nuxt app uses hash-based routing (`router.options.hashMode`). */
   hashMode: boolean
   /** Whether the current build is a static site generation (SSG / `nuxi generate`). */