@npm-questionpro/wick-ui-i18n 2.0.0-next.31 → 2.0.0-next.32

package/README.md

@@ -33,17 +33,15 @@ export default defineConfig({plugins: [react(), wickI18n()]})
 
 ## Options
 
-| Option              | Default                                                           | Description                                                          |
-| ------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------- |
-| `components`        | `[]`                                                              | Extra components treated like Wu\*                                   |
-| `ignoreComponents`  | `[]`                                                              | Extra components never translated                                    |
-| `translatableProps` | `['Label','placeholder','title','aria-label','aria-placeholder']` | Props rewritten to `useWt()()`                                       |
-| `dataLabelKeys`     | `[]`                                                              | Property names whose values are labels in mixed data files           |
-| `dictionaryFiles`   | —                                                                 | Files where every string is a display label (enums, label constants) |
-| `excludeFiles`      | —                                                                 | Files skipped entirely                                               |
-| `debug`             | `false`                                                           | Print extraction table at build                                      |
-
-> **Deprecated:** `extractFromKeys` → `dataLabelKeys` · `resolveFiles` → `dictionaryFiles`
+| Option              | Default                                                           | Description                                                                             |
+| ------------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| `components`        | `[]`                                                              | Extra components treated like Wu\*                                                      |
+| `ignoreComponents`  | `[]`                                                              | Extra components never translated                                                       |
+| `translatableProps` | `['Label','placeholder','title','aria-label','aria-placeholder']` | Props rewritten to `useWt()()`                                                          |
+| `dataLabelKeys`     | `[]`                                                              | Property names whose values are labels in mixed data files                              |
+| `dictionaryFiles`   | —                                                                 | Globs (project files via Vite) or exact paths (anywhere, incl. `node_modules` via `fs`) |
+| `excludeFiles`      | —                                                                 | Files skipped entirely                                                                  |
+| `debug`             | `false`                                                           | Print extraction table at build                                                         |
 
 ---
 

package/index.d.ts

@@ -39,11 +39,20 @@ export interface WickI18nOptions {
    * Use **only** for dedicated enum/constant files. Do NOT point at mixed data
    * files — use `dataLabelKeys` for those.
    *
-   * Passed to Vite's `createFilter` as `include`, so globs, regexes, and
-   * package specifiers all work.
+   * Two modes depending on the value:
+   * - **Glob patterns** (`'src/enums/*.ts'`) — matched via Vite's transform pipeline.
+   *   Works for files in your project; does **not** reach `node_modules`.
+   * - **Exact paths** (`'node_modules/@company/shared/enums.ts'`) — read directly
+   *   with `fs` at build time, bypassing Vite's transform pipeline. Use this for
+   *   `node_modules` files. Missing files produce a `console.warn`.
+   *
+   * Both modes can be mixed in the same array.
    *
    * @example
-   * dictionaryFiles: ['src/enums/*.ts', 'src/constants/labels.ts']
+   * dictionaryFiles: [
+   *   'src/enums/*.ts',                              // glob — project files
+   *   'node_modules/@company/shared/enums.ts',       // exact — node_modules
+   * ]
    */
   dictionaryFiles?: string | RegExp | Array<string | RegExp>
 
@@ -52,16 +61,6 @@ export interface WickI18nOptions {
 
   /** Print a build-time extraction report table to stdout. */
   debug?: boolean
-
-  /**
-   * @deprecated Use `dataLabelKeys` instead.
-   */
-  extractFromKeys?: string[]
-
-  /**
-   * @deprecated Use `dictionaryFiles` instead.
-   */
-  resolveFiles?: string | RegExp | Array<string | RegExp>
 }
 
 /**

package/index.js

@@ -18,6 +18,8 @@
  * };
  */
 
+import fs from 'node:fs'
+import path from 'node:path'
 import {createFilter} from 'vite'
 import {TranslationProcessor} from './src/processor.js'
 import {transformFile} from './src/transform.js'
@@ -33,11 +35,9 @@ import {extractStringsFromFile} from './src/extractStrings.js'
  * @property {string[]}  [dataLabelKeys]     - Object property names whose string values are labels in mixed data
  *                                             files (e.g. `['label', 'title']` in nav config arrays). No code rewrite;
  *                                             keys are recorded into `wick-ui-i18n.json` for the translation API.
- * @property {string[]}  [extractFromKeys]   - @deprecated Use `dataLabelKeys` instead.
  * @property {string|string[]|RegExp} [dictionaryFiles] - Files where every string is a display label (enum files,
  *                                             message constants). Pattern: `'**\/enums\/*.ts'`.
  *                                             Do NOT point at mixed data files — use `dataLabelKeys` for those.
- * @property {string|string[]|RegExp} [resolveFiles]   - @deprecated Use `dictionaryFiles` instead.
  * @property {string|string[]|RegExp} [excludeFiles]   - Files to skip (passed as `exclude` to Vite's createFilter).
  * @property {boolean}   [debug]             - Log transform activity to the console.
  */
@@ -56,17 +56,23 @@ export default function wickuiI18nPlugin(options = {}) {
     ignoreComponents: options.ignoreComponents,
     translatableProps: options.translatableProps,
     dataLabelKeys: options.dataLabelKeys,
-    extractFromKeys: options.extractFromKeys, // deprecated alias — processor handles both
     debug: options.debug,
   })
 
   const filter = createFilter([/\.(jsx|tsx|ts)$/], options.excludeFiles)
-  const enumFilter =
-    (options.dictionaryFiles ?? options.resolveFiles)
-      ? createFilter(options.dictionaryFiles ?? options.resolveFiles)
-      : null
+  const enumFilter = options.dictionaryFiles ? createFilter(options.dictionaryFiles) : null
+
+  // Exact-path entries from dictionaryFiles (no glob chars) are read via fs in buildStart
+  // so they work for node_modules files that Vite never processes through transforms.
+  const dictionaryPatterns = (() => {
+    const raw = options.dictionaryFiles
+    if (!raw) return []
+    const arr = Array.isArray(raw) ? raw : [raw]
+    return arr.filter(p => typeof p === 'string' && !/[*?{}[\]]/.test(p))
+  })()
 
   let base = '/'
+  let root = '/'
 
   return {
     name: 'wick-ui-i18n',
@@ -80,6 +86,7 @@ export default function wickuiI18nPlugin(options = {}) {
      */
     configResolved(resolvedConfig) {
       base = resolvedConfig.base
+      root = resolvedConfig.root
       telemetry.scanVersions(resolvedConfig.root)
     },
 
@@ -91,6 +98,16 @@ export default function wickuiI18nPlugin(options = {}) {
       processor.dictionary.clear()
       processor.entries = []
       telemetry.reset()
+
+      for (const rel of dictionaryPatterns) {
+        const abs = path.isAbsolute(rel) ? rel : path.resolve(root, rel)
+        try {
+          const code = fs.readFileSync(abs, 'utf8')
+          extractStringsFromFile(code, abs, processor)
+        } catch {
+          console.warn(`[wick-i18n] dictionaryFiles: could not read "${rel}" — file not found or unreadable`)
+        }
+      }
     },
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@npm-questionpro/wick-ui-i18n",
-  "version": "2.0.0-next.31",
+  "version": "2.0.0-next.32",
   "private": false,
   "license": "ISC",
   "description": "Auto-translation AST wrapper for Wick UI",

package/src/processor.js

@@ -38,7 +38,7 @@ export class TranslationProcessor {
     /** @type {Set<string>} JSX prop names that should be translated. */
     this.translatableProps = new Set([...DEFAULT_TRANSLATABLE_PROPS, ...(options.translatableProps || [])])
     /** @type {Set<string>} Object property key names whose string values are extracted (e.g. 'label'). */
-    this.extractFromKeys = new Set(options.dataLabelKeys || options.extractFromKeys || [])
+    this.extractFromKeys = new Set(options.dataLabelKeys || [])
     /** @type {Map<string, string>} key → original text */
     this.dictionary = new Map()
     /** @type {import('./debug.js').DebugEntry[]} */