@npm-questionpro/wick-ui-i18n 2.0.0-next.28 → 2.0.0-next.30

package/index.js

@@ -22,6 +22,7 @@ import {createFilter} from 'vite'
 import {TranslationProcessor} from './src/processor.js'
 import {transformFile} from './src/transform.js'
 import {printReport} from './src/debug.js'
+import {TelemetryCollector, collectComponents} from './src/telemetry.js'
 
 /**
  * @typedef {object} WickI18nOptions
@@ -40,6 +41,8 @@ import {printReport} from './src/debug.js'
  * @returns {import('vite').Plugin}
  */
 export default function wickuiI18nPlugin(options = {}) {
+  const telemetry = new TelemetryCollector()
+
   const processor = new TranslationProcessor({
     components: options.components || [],
     ignoreComponents: options.ignoreComponents,
@@ -64,6 +67,7 @@ export default function wickuiI18nPlugin(options = {}) {
      */
     configResolved(resolvedConfig) {
       base = resolvedConfig.base
+      telemetry.scanVersions(resolvedConfig.root)
     },
 
     /**
@@ -73,6 +77,7 @@ export default function wickuiI18nPlugin(options = {}) {
     buildStart() {
       processor.dictionary.clear()
       processor.entries = []
+      telemetry.reset()
     },
 
     /**
@@ -88,6 +93,7 @@ export default function wickuiI18nPlugin(options = {}) {
         /\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) && code.includes('Wu')) collectComponents(code, telemetry)
       if (!filter(id) || !hasAnyTarget) return null
       return transformFile(code, id, processor)
     },
@@ -102,10 +108,20 @@ export default function wickuiI18nPlugin(options = {}) {
         res.setHeader('Content-Type', 'application/json')
         res.end(JSON.stringify(Object.fromEntries(processor.dictionary), null, 2))
       })
+      server.middlewares.use(`${base}telemetry.json`, (_req, res) => {
+        res.setHeader('Content-Type', 'application/json')
+        res.end(JSON.stringify(telemetry.toJSON()))
+      })
     },
 
     /** Emit the translation dictionary as a build asset and print debug table. */
     generateBundle() {
+      this.emitFile({
+        type: 'asset',
+        fileName: 'telemetry.json',
+        source: JSON.stringify(telemetry.toJSON()),
+      })
+
       this.emitFile({
         type: 'asset',
         fileName: 'wick-ui-i18n.json',

package/package.json

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

package/src/telemetry.js

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Telemetry collector — scans consumer node_modules for
+ * @npm-questionpro/wick-ui-* versions and counts Wu* JSX component usages
+ * across the entire build. Emitted as `telemetry.json` at build time and
+ * served at `GET /telemetry.json` in dev.
+ *
+ * Intentionally isolated from i18n logic — no imports from other src/ files.
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import {parse} from '@babel/parser'
+import _traverse from '@babel/traverse'
+
+const traverse = _traverse.default || _traverse
+
+/** Babel parser plugins applied to every file. */
+const BABEL_PLUGINS = ['jsx', 'typescript']
+
+export class TelemetryCollector {
+  constructor() {
+    /** @type {Record<string, string>} short name → version e.g. { lib: '2.0.0-next.29' } */
+    this.versions = {}
+    /** @type {Map<string, number>} PascalCase component name → total usage count */
+    this.counts = new Map()
+  }
+
+  /** Clear component counts — called on every buildStart so watch-mode rebuilds are clean. */
+  reset() {
+    this.counts.clear()
+  }
+
+  /**
+   * Increment the usage count for a Wu* component and record its prop names.
+   * @param {string}   name  - e.g. 'WuButton'
+   * @param {string[]} props - Prop names present on this usage e.g. ['variant', 'disabled']
+   */
+  record(name, props = []) {
+    if (!this.counts.has(name)) this.counts.set(name, {count: 0, props: new Map()})
+    const entry = this.counts.get(name)
+    entry.count++
+    for (const prop of props) {
+      entry.props.set(prop, (entry.props.get(prop) ?? 0) + 1)
+    }
+  }
+
+  /**
+   * Scan the consumer's node_modules for all @npm-questionpro/wick-ui-* packages
+   * and record their versions. Called once in configResolved when root is known.
+   *
+   * @param {string} root - Vite project root
+   */
+  scanVersions(root) {
+    const scopeDir = path.join(root, 'node_modules', '@npm-questionpro')
+    let entries
+    try {
+      entries = fs.readdirSync(scopeDir)
+    } catch {
+      // @npm-questionpro scope not present — skip silently
+      return
+    }
+    for (const name of entries) {
+      if (!name.startsWith('wick-ui-')) continue
+      try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(scopeDir, name, 'package.json'), 'utf8'))
+        const shortKey = name.replace('wick-ui-', '')
+        this.versions[shortKey] = pkg.version
+      } catch {
+        // malformed or missing package.json — skip
+      }
+    }
+  }
+
+  /**
+   * Produce the final telemetry payload: versions first (sorted), then
+   * component counts (sorted alphabetically).
+   *
+   * @returns {Record<string, string|number>}
+   */
+  toJSON() {
+    const sortedVersions = Object.fromEntries(Object.entries(this.versions).sort(([a], [b]) => a.localeCompare(b)))
+    const sortedCounts = Object.fromEntries(
+      [...this.counts.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, {count, props}]) => [
+          name,
+          {
+            count,
+            props: Object.fromEntries([...props.entries()].sort(([a], [b]) => a.localeCompare(b))),
+          },
+        ]),
+    )
+    return {...sortedVersions, ...sortedCounts}
+  }
+}
+
+/**
+ * Parse a single file and record all Wu* JSX component usages into the collector.
+ * Skips files that fail to parse without throwing.
+ *
+ * @param {string} code - Raw source of the file.
+ * @param {TelemetryCollector} collector
+ */
+export function collectComponents(code, collector) {
+  let ast
+  try {
+    ast = parse(code, {sourceType: 'module', plugins: BABEL_PLUGINS})
+  } catch {
+    return
+  }
+
+  traverse(ast, {
+    JSXOpeningElement(path) {
+      const name = path.node.name.name
+      if (typeof name === 'string' && name.startsWith('Wu')) {
+        const props = path.node.attributes
+          .filter(a => a.type === 'JSXAttribute' && typeof a.name?.name === 'string')
+          .map(a => a.name.name)
+        collector.record(name, props)
+      }
+    },
+  })
+}