@npm-questionpro/wick-ui-i18n 0.14.0 → 2.0.0-next.4

package/README.md

@@ -7,98 +7,99 @@ translatable props to `{wt("...")}`, and emits `wick-ui-i18n.json`.
 
 ## JSX text
 
-| Input | Output |
-|---|---|
-| `<WuButton>Hello</WuButton>` | ✅ `<WuTranslate __i18nKey="Hello" />` |
-| `<WuIcon>star</WuIcon>` | ❌ |
-| `<div>Hello</div>` | ❌ |
-| `<WuButton data-skip>Hello</WuButton>` | ❌ |
-| `<span data-i18n-wrapper>Hello</span>` | ✅ `<WuTranslate __i18nKey="Hello" />` |
-| `<WuButton data-i18n-key="k">Hello</WuButton>` | ✅ `<WuTranslate __i18nKey="k" />` |
-| `<WuButton>&amp;</WuButton>` | ❌ |
-| `<WuButton>Hello &amp; World</WuButton>` | ✅ `<WuTranslate __i18nKey="Hello" /> &amp; <WuTranslate __i18nKey="World" />` |
+| Input                                          | Output                                                                         |
+| ---------------------------------------------- | ------------------------------------------------------------------------------ |
+| `<WuButton>Hello</WuButton>`                   | ✅ `<WuTranslate __i18nKey="Hello" />`                                         |
+| `<WuIcon>star</WuIcon>`                        | ❌                                                                             |
+| `<div>Hello</div>`                             | ❌                                                                             |
+| `<WuButton data-skip>Hello</WuButton>`         | ❌                                                                             |
+| `<span data-i18n-wrapper>Hello</span>`         | ✅ `<WuTranslate __i18nKey="Hello" />`                                         |
+| `<WuButton data-i18n-key="k">Hello</WuButton>` | ✅ `<WuTranslate __i18nKey="k" />`                                             |
+| `<WuButton>&amp;</WuButton>`                   | ❌                                                                             |
+| `<WuButton>Hello &amp; World</WuButton>`       | ✅ `<WuTranslate __i18nKey="Hello" /> &amp; <WuTranslate __i18nKey="World" />` |
 
 ## JSX string expressions
 
-| Input | Output |
-|---|---|
-| `<WuButton>{"Hello"}</WuButton>` | ✅ `<WuTranslate __i18nKey="Hello" />` |
-| `` <WuButton>{`Hello`}</WuButton> `` | ✅ `<WuTranslate __i18nKey="Hello" />` |
-| `<WuButton>{variable}</WuButton>` | ❌ |
+| Input                              | Output                                 |
+| ---------------------------------- | -------------------------------------- |
+| `<WuButton>{"Hello"}</WuButton>`   | ✅ `<WuTranslate __i18nKey="Hello" />` |
+| ``<WuButton>{`Hello`}</WuButton>`` | ✅ `<WuTranslate __i18nKey="Hello" />` |
+| `<WuButton>{variable}</WuButton>`  | ❌                                     |
 
 ## JSX ternaries
 
-| Input | Output |
-|---|---|
-| `<WuButton>{flag ? "Yes" : "No"}</WuButton>` | ✅ `{flag ? <WuTranslate __i18nKey="Yes" /> : <WuTranslate __i18nKey="No" />}` |
-| `<WuButton>{flag ? "Yes" : variable}</WuButton>` | ✅ `{flag ? <WuTranslate __i18nKey="Yes" /> : variable}` |
-| `<WuButton>{flag ? variable : variable}</WuButton>` | ❌ |
-| `<WuButton>{a ? "A" : b ? "B" : "C"}</WuButton>` | ✅ `{a ? <WuTranslate __i18nKey="A" /> : b ? <WuTranslate __i18nKey="B" /> : <WuTranslate __i18nKey="C" />}` |
+| Input                                               | Output                                                                                                       |
+| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `<WuButton>{flag ? "Yes" : "No"}</WuButton>`        | ✅ `{flag ? <WuTranslate __i18nKey="Yes" /> : <WuTranslate __i18nKey="No" />}`                               |
+| `<WuButton>{flag ? "Yes" : variable}</WuButton>`    | ✅ `{flag ? <WuTranslate __i18nKey="Yes" /> : variable}`                                                     |
+| `<WuButton>{flag ? variable : variable}</WuButton>` | ❌                                                                                                           |
+| `<WuButton>{a ? "A" : b ? "B" : "C"}</WuButton>`    | ✅ `{a ? <WuTranslate __i18nKey="A" /> : b ? <WuTranslate __i18nKey="B" /> : <WuTranslate __i18nKey="C" />}` |
 
 ## JSX template literals with expressions
 
-| Input | Output |
-|---|---|
-| `` <WuButton>{`Hello ${name}`}</WuButton> `` | ✅ `<><WuTranslate __i18nKey="Hello" /> {name}</>` |
-| `` <WuButton>{`${name} world`}</WuButton> `` | ✅ `<>{name} <WuTranslate __i18nKey="world" /></>` |
-| `` <WuButton>{`Hello ${a} and ${b}`}</WuButton> `` | ✅ `<><WuTranslate __i18nKey="Hello" /> {a} <WuTranslate __i18nKey="and" /> {b}</>` |
-| `` <WuButton>{`${a}${b}`}</WuButton> `` | ❌ |
+| Input                                            | Output                                                                              |
+| ------------------------------------------------ | ----------------------------------------------------------------------------------- |
+| ``<WuButton>{`Hello ${name}`}</WuButton>``       | ✅ `<><WuTranslate __i18nKey="Hello" /> {name}</>`                                  |
+| ``<WuButton>{`${name} world`}</WuButton>``       | ✅ `<>{name} <WuTranslate __i18nKey="world" /></>`                                  |
+| ``<WuButton>{`Hello ${a} and ${b}`}</WuButton>`` | ✅ `<><WuTranslate __i18nKey="Hello" /> {a} <WuTranslate __i18nKey="and" /> {b}</>` |
+| ``<WuButton>{`${a}${b}`}</WuButton>``            | ❌                                                                                  |
 
 ## JSX mixed children
 
-| Input | Output |
-|---|---|
+| Input                               | Output                                        |
+| ----------------------------------- | --------------------------------------------- |
 | `<WuButton>Hello {name}</WuButton>` | ✅ `<WuTranslate __i18nKey="Hello" /> {name}` |
-| `<WuButton>{a} and {b}</WuButton>` | ✅ `{a} <WuTranslate __i18nKey="and" /> {b}` |
-| `<WuButton>{a}   {b}</WuButton>` | ❌ |
+| `<WuButton>{a} and {b}</WuButton>`  | ✅ `{a} <WuTranslate __i18nKey="and" /> {b}`  |
+| `<WuButton>{a}   {b}</WuButton>`    | ❌                                            |
 
 ## JSX props
 
 Defaults: `Label`, `placeholder`, `title`, `aria-label`, `aria-placeholder`.
 
-| Input | Output |
-|---|---|
-| `<WuField Label="First name" />` | ✅ `Label={wt("First name")}` |
+| Input                                  | Output                              |
+| -------------------------------------- | ----------------------------------- |
+| `<WuField Label="First name" />`       | ✅ `Label={wt("First name")}`       |
 | `<WuInput placeholder="Enter name" />` | ✅ `placeholder={wt("Enter name")}` |
-| `<WuDialog title="Confirm?" />` | ✅ `title={wt("Confirm?")}` |
-| `<WuField Label={variable} />` | ❌ |
-| `<WuField Label="" />` | ❌ |
-| `<WuIcon Label="x" />` | ❌ |
-| `<input placeholder="x" />` | ❌ |
-| `<WuField data-skip Label="x" />` | ❌ |
+| `<WuDialog title="Confirm?" />`        | ✅ `title={wt("Confirm?")}`         |
+| `<WuField Label={variable} />`         | ❌                                  |
+| `<WuField Label="" />`                 | ❌                                  |
+| `<WuIcon Label="x" />`                 | ❌                                  |
+| `<input placeholder="x" />`            | ❌                                  |
+| `<WuField data-skip Label="x" />`      | ❌                                  |
 
 ## `wt()` calls
 
-Plugin records static args into `wick-ui-i18n.json`. No code rewrite unless template literal with expressions.
+Plugin records static args into `wick-ui-i18n.json`. No code rewrite unless
+template literal with expressions.
 
-| Input | Dictionary | Code output |
-|---|---|---|
-| `wt("Hello")` | ✅ `"Hello"` | `wt("Hello")` |
-| `` wt(`Hello`) `` | ✅ `"Hello"` | `` wt(`Hello`) `` |
-| `` wt(`Hello ${name}`) `` | ✅ `"Hello"` | `` `${wt("Hello")} ${name}` `` |
-| `` wt(`Hello ${a} and ${b}`) `` | ✅ `"Hello"`, `"and"` | `` `${wt("Hello")} ${a} ${wt("and")} ${b}` `` |
-| `wt(variable)` | ❌ | — |
-| `` wt(`${a}${b}`) `` | ❌ | — |
+| Input                         | Dictionary            | Code output                                   |
+| ----------------------------- | --------------------- | --------------------------------------------- |
+| `wt("Hello")`                 | ✅ `"Hello"`          | `wt("Hello")`                                 |
+| ``wt(`Hello`)``               | ✅ `"Hello"`          | ``wt(`Hello`)``                               |
+| ``wt(`Hello ${name}`)``       | ✅ `"Hello"`          | `` `${wt("Hello")} ${name}` ``                |
+| ``wt(`Hello ${a} and ${b}`)`` | ✅ `"Hello"`, `"and"` | `` `${wt("Hello")} ${a} ${wt("and")} ${b}` `` |
+| `wt(variable)`                | ❌                    | —                                             |
+| ``wt(`${a}${b}`)``            | ❌                    | —                                             |
 
 ## Data files (`extractFromKeys` option)
 
 No code rewrite — keys only recorded in `wick-ui-i18n.json`.
 
-| Input | Dictionary |
-|---|---|
+| Input                                                   | Dictionary       |
+| ------------------------------------------------------- | ---------------- |
 | `{ label: 'Analytics' }` + `extractFromKeys: ['label']` | ✅ `"Analytics"` |
-| `{ label: variable }` | ❌ |
-| `{ label: '' }` | ❌ |
+| `{ label: variable }`                                   | ❌               |
+| `{ label: '' }`                                         | ❌               |
 
 ---
 
 ## 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 `wt()` |
-| `extractFromKeys` | `[]` | Object keys extracted into dictionary |
-| `excludeFiles` | — | Files skipped entirely |
-| `debug` | `false` | Log transforms to console |
+| 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 `wt()`             |
+| `extractFromKeys`   | `[]`                                                              | Object keys extracted into dictionary |
+| `excludeFiles`      | —                                                                 | Files skipped entirely                |
+| `debug`             | `false`                                                           | Log transforms to console             |

package/index.d.ts

@@ -1,5 +1,6 @@
 import type {Plugin} from 'vite'
 
+// eslint-disable-next-line @typescript-eslint/naming-convention
 export interface WickI18nOptions {
   /** Extra component names to translate (in addition to Wu* components). */
   components?: string[]

package/index.js

@@ -18,10 +18,10 @@
  * };
  */
 
-import { createFilter } from "vite";
-import { TranslationProcessor } from "./src/processor.js";
-import { transformFile } from "./src/transform.js";
-import { printReport } from "./src/debug.js";
+import {createFilter} from 'vite'
+import {TranslationProcessor} from './src/processor.js'
+import {transformFile} from './src/transform.js'
+import {printReport} from './src/debug.js'
 
 /**
  * @typedef {object} WickI18nOptions
@@ -46,15 +46,15 @@ export default function wickuiI18nPlugin(options = {}) {
     translatableProps: options.translatableProps,
     extractFromKeys: options.extractFromKeys,
     debug: options.debug,
-  });
+  })
 
-  const filter = createFilter([/\.(jsx|tsx|ts)$/], options.excludeFiles);
+  const filter = createFilter([/\.(jsx|tsx|ts)$/], options.excludeFiles)
 
-  let base = "/";
+  let base = '/'
 
   return {
-    name: "wick-ui-i18n",
-    enforce: "pre",
+    name: 'wick-ui-i18n',
+    enforce: 'pre',
 
     /**
      * Capture the resolved base so the dev-server middleware path matches
@@ -63,7 +63,7 @@ export default function wickuiI18nPlugin(options = {}) {
      * @param {import('vite').ResolvedConfig} resolvedConfig
      */
     configResolved(resolvedConfig) {
-      base = resolvedConfig.base;
+      base = resolvedConfig.base
     },
 
     /**
@@ -71,8 +71,8 @@ export default function wickuiI18nPlugin(options = {}) {
      * watch-mode rebuilds.
      */
     buildStart() {
-      processor.dictionary.clear();
-      processor.entries = [];
+      processor.dictionary.clear()
+      processor.entries = []
     },
 
     /**
@@ -84,14 +84,14 @@ export default function wickuiI18nPlugin(options = {}) {
      */
     transform(code, id) {
       const hasAnyTarget =
-        code.includes("Wu") ||
+        code.includes('Wu') ||
         /\bwt\(/.test(code) ||
         (processor.components.size > 0 &&
           [...processor.components].some(c => code.includes(c))) ||
         (processor.extractFromKeys.size > 0 &&
-          [...processor.extractFromKeys].some(k => code.includes(k)));
-      if (!filter(id) || !hasAnyTarget) return null;
-      return transformFile(code, id, processor);
+          [...processor.extractFromKeys].some(k => code.includes(k)))
+      if (!filter(id) || !hasAnyTarget) return null
+      return transformFile(code, id, processor)
     },
 
     /**
@@ -101,26 +101,26 @@ export default function wickuiI18nPlugin(options = {}) {
      */
     configureServer(server) {
       server.middlewares.use(`${base}wick-ui-i18n.json`, (_req, res) => {
-        res.setHeader("Content-Type", "application/json");
+        res.setHeader('Content-Type', 'application/json')
         res.end(
           JSON.stringify(Object.fromEntries(processor.dictionary), null, 2),
-        );
-      });
+        )
+      })
     },
 
     /** Emit the translation dictionary as a build asset and print debug table. */
     generateBundle() {
       this.emitFile({
-        type: "asset",
-        fileName: "wick-ui-i18n.json",
+        type: 'asset',
+        fileName: 'wick-ui-i18n.json',
         source: JSON.stringify(
           Object.fromEntries(processor.dictionary),
           null,
           2,
         ),
-      });
+      })
 
-      printReport(processor.entries);
+      printReport(processor.entries)
     },
-  };
+  }
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@npm-questionpro/wick-ui-i18n",
-  "version": "0.14.0",
+  "version": "2.0.0-next.4",
+  "private": false,
   "license": "ISC",
   "description": "Auto-translation AST wrapper for Wick UI",
   "type": "module",
-  "main": "index.js",
   "types": "index.d.ts",
   "exports": {
     ".": {
@@ -13,19 +13,36 @@
     }
   },
   "peerDependencies": {
-    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+    "vite": "^8.0.15"
   },
   "devDependencies": {
     "@types/babel__traverse": "^7.28.0",
-    "vite": "^7.3.1",
-    "vitest": "^3.2.4"
+    "vite": "^8.0.15",
+    "vitest": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.8",
+    "eslint": "^10.4.1",
+    "@npm-questionpro/wick-ui-eslint-config": "1.0.0",
+    "@wick-ui/tsconfig": "1.0.0"
   },
   "dependencies": {
     "@babel/parser": "^7.29.0",
     "@babel/traverse": "^7.29.0",
     "magic-string": "^0.30.21"
   },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "src",
+    "llms.txt"
+  ],
+  "prettier": "@npm-questionpro/wick-ui-prettier-config",
   "scripts": {
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ci": "vitest run --coverage",
+    "format": "prettier --write .",
+    "format:ci": "prettier --check .",
+    "lint": "eslint . --fix",
+    "lint:ci": "eslint --max-warnings 0 ."
   }
 }

package/src/debug.js

@@ -4,7 +4,7 @@
  * after the bundle is generated.
  */
 
-import { basename } from "node:path";
+import {basename} from 'node:path'
 
 /**
  * Walk up the Babel path and collect JSX element names from outermost inward.
@@ -13,17 +13,17 @@ import { basename } from "node:path";
  * @returns {string} e.g. `"WuProvider > div > WuButton"`
  */
 export function getComponentTree(path) {
-  const parts = [];
-  path.findParent((p) => {
+  const parts = []
+  path.findParent(p => {
     if (p.isJSXElement()) {
       const name =
         p.node.openingElement.name.name ||
-        p.node.openingElement.name.property?.name;
-      if (name) parts.unshift(name);
+        p.node.openingElement.name.property?.name
+      if (name) parts.unshift(name)
     }
-    return false;
-  });
-  return parts.join(" > ") || "(root)";
+    return false
+  })
+  return parts.join(' > ') || '(root)'
 }
 
 /**
@@ -42,39 +42,38 @@ export function getComponentTree(path) {
  */
 export function printReport(entries) {
   if (!entries.length) {
-    console.log("\n[wick-i18n] No translations captured.\n");
-    return;
+    console.log('\n[wick-i18n] No translations captured.\n')
+    return
   }
 
-  const headers = ["Text", "File", "Component Tree"];
+  const headers = ['Text', 'File', 'Component Tree']
 
-  const rows = entries.map((e) => [e.text, basename(e.file), e.componentTree]);
+  const rows = entries.map(e => [e.text, basename(e.file), e.componentTree])
 
-  const cols = headers.length;
   const widths = headers.map((h, i) =>
-    Math.max(h.length, ...rows.map((r) => r[i].length)),
-  );
+    Math.max(h.length, ...rows.map(r => r[i].length)),
+  )
 
-  const pad = (str, w) => str.padEnd(w);
+  const pad = (str, w) => str.padEnd(w)
   const sep = (l, m, r, fill) =>
-    l + widths.map((w) => fill.repeat(w + 2)).join(m) + r;
+    l + widths.map(w => fill.repeat(w + 2)).join(m) + r
 
-  const top = sep("┌", "┬", "┐", "─");
-  const mid = sep("├", "┼", "┤", "─");
-  const bottom = sep("└", "┴", "┘", "─");
-  const row = (cells) =>
-    "│" + cells.map((c, i) => ` ${pad(c, widths[i])} `).join("│") + "│";
+  const top = sep('┌', '┬', '┐', '─')
+  const mid = sep('├', '┼', '┤', '─')
+  const bottom = sep('└', '┴', '┘', '─')
+  const row = cells =>
+    '│' + cells.map((c, i) => ` ${pad(c, widths[i])} `).join('│') + '│'
 
   const lines = [
-    "",
+    '',
     `[wick-i18n] Build report — ${entries.length} translation(s) captured`,
     top,
     row(headers),
     mid,
     ...rows.map(row),
     bottom,
-    "",
-  ];
+    '',
+  ]
 
-  console.log(lines.join("\n"));
+  console.log(lines.join('\n'))
 }