@vocoder/cli 0.15.0 → 0.16.0

package/dist/lib.d.mts

@@ -11,14 +11,12 @@ interface ExtractedString {
 }
 
 /**
- * Supported app industry classifications.
+ * Supported industry classifications for an app.
  * Set once in vocoder.config.ts; synced to App at extraction time.
+ * Used as a TM pool bucket key — matching values across orgs share cache entries.
  * Cannot be edited from the dashboard — config file is the source of truth.
- *
- * Keep in sync with APP_INDUSTRIES in
- * vocoder-app/lib/vocoder/translation/context-constants.ts.
  */
-type AppIndustry = "ecommerce" | "saas" | "healthcare" | "fintech" | "gaming" | "education" | "media" | "productivity";
+type Industry = "ecommerce" | "b2b_saas" | "healthcare" | "fintech" | "gaming" | "education" | "media" | "productivity" | "travel" | "legal" | "government" | "nonprofit" | "other";
 /**
  * Translation formality level.
  * Can be set project-wide in vocoder.config.ts or overridden per-string
@@ -51,7 +49,9 @@ interface VocoderConfig {
      * and to isolate cache entries by industry in the global translation cache.
      * Synced to App at extraction time.
      */
-    appIndustry?: AppIndustry;
+    industry?: Industry;
+    /** @deprecated Use `industry` */
+    appIndustry?: Industry;
     /**
      * Project-wide default formality level for translations.
      * Can be overridden per-string via <T formality="..."> on the AI plan.
@@ -274,7 +274,7 @@ declare class VocoderAPI {
         clientRunId?: string;
         force?: boolean;
         /** From vocoder.config.ts — synced to App on every push */
-        appIndustry?: string;
+        industry?: string;
     }, repoIdentity?: RepoIdentityPayload): Promise<TranslationBatchResponse>;
     /**
      * Check translation status

package/dist/lib.mjs

@@ -7,17 +7,174 @@ import {
   clearAuthData,
   detectLocalEcosystem,
   getPackagesToInstall,
-  getSetupSnippets,
   loadVocoderConfig,
   readAuthData,
   verifyStoredAuth,
   writeAuthData
-} from "./chunk-62KCB6C6.mjs";
+} from "./chunk-IK4ZCESQ.mjs";
 
 // ../config/src/index.ts
 function defineConfig(config) {
   return config;
 }
+
+// src/utils/setup-snippets.ts
+function getSetupSnippets(params) {
+  const { framework, ecosystem, sourceLocale } = params;
+  return {
+    pluginStep: getPluginSnippet(framework, ecosystem),
+    providerStep: getProviderSnippet(ecosystem, sourceLocale),
+    wrapStep: getWrapSnippet(ecosystem),
+    whatsNext: "Push to a target branch to trigger translations."
+  };
+}
+function getPluginSnippet(framework, ecosystem) {
+  switch (framework) {
+    case "nextjs":
+      return {
+        file: "next.config.ts",
+        code: `import { withVocoder } from '@vocoder/plugin/next';
+
+export default withVocoder({
+  // your existing Next.js config
+});`
+      };
+    case "vite":
+    case "remix":
+      return {
+        file: "vite.config.ts",
+        code: `import vocoder from '@vocoder/plugin/vite';
+
+export default defineConfig({
+  plugins: [
+    vocoder(),
+    // your other plugins
+  ],
+});`
+      };
+    case "nuxt":
+      return {
+        file: "nuxt.config.ts",
+        code: `import vocoder from '@vocoder/plugin/vite';
+
+export default defineNuxtConfig({
+  vite: {
+    plugins: [vocoder()],
+  },
+});`
+      };
+    case "sveltekit":
+      return {
+        file: "vite.config.ts",
+        code: `import vocoder from '@vocoder/plugin/vite';
+import { sveltekit } from '@sveltejs/kit/vite';
+
+export default defineConfig({
+  plugins: [
+    sveltekit(),
+    vocoder(),
+  ],
+});`
+      };
+    case "gatsby":
+      return {
+        file: "gatsby-node.js",
+        code: `const vocoder = require('@vocoder/plugin/webpack');
+
+exports.onCreateWebpackConfig = ({ actions }) => {
+  actions.setWebpackConfig({
+    plugins: [vocoder()],
+  });
+};`
+      };
+    case "angular":
+      return null;
+    // Angular CLI doesn't expose plugin config easily
+    default:
+      if (ecosystem) {
+        return {
+          file: "your bundler config",
+          code: `// Vite
+import vocoder from '@vocoder/plugin/vite';
+// Webpack
+const vocoder = require('@vocoder/plugin/webpack');
+
+// Add vocoder() to your plugins array`
+        };
+      }
+      return null;
+  }
+}
+function getProviderSnippet(ecosystem, sourceLocale) {
+  switch (ecosystem) {
+    case "react":
+      return {
+        file: "your root layout or App component",
+        code: `import { VocoderProvider } from '@vocoder/react';
+
+<VocoderProvider defaultLocale="${sourceLocale}">
+  {children}
+</VocoderProvider>`
+      };
+    case "vue":
+      return {
+        file: "your app entry",
+        code: `import { createVocoder } from '@vocoder/vue';
+
+const vocoder = createVocoder({
+  defaultLocale: '${sourceLocale}',
+});
+
+app.use(vocoder);`
+      };
+    case "svelte":
+      return {
+        file: "your root layout",
+        code: `<script>
+  import { VocoderProvider } from '@vocoder/svelte';
+</script>
+
+<VocoderProvider defaultLocale="${sourceLocale}">
+  <slot />
+</VocoderProvider>`
+      };
+    default:
+      return null;
+  }
+}
+function getWrapSnippet(ecosystem) {
+  switch (ecosystem) {
+    case "react":
+      return {
+        code: `import { T } from '@vocoder/react';
+
+<T>Hello, world!</T>`
+      };
+    case "vue":
+      return {
+        code: `<template>
+  <T>Hello, world!</T>
+</template>
+
+<script setup>
+import { T } from '@vocoder/vue';
+</script>`
+      };
+    case "svelte":
+      return {
+        code: `<script>
+  import { T } from '@vocoder/svelte';
+</script>
+
+<T>Hello, world!</T>`
+      };
+    default:
+      return {
+        code: `// Wrap translatable strings with <T>
+<T>Hello, world!</T>`
+      };
+  }
+}
 export {
   StringExtractor,
   VocoderAPI,

package/dist/lib.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../config/src/index.ts"],"sourcesContent":["/**\n * Supported app industry classifications.\n * Set once in vocoder.config.ts; synced to App at extraction time.\n * Cannot be edited from the dashboard — config file is the source of truth.\n *\n * Keep in sync with APP_INDUSTRIES in\n * vocoder-app/lib/vocoder/translation/context-constants.ts.\n */\nexport type AppIndustry =\n\t| \"ecommerce\"\n\t| \"saas\"\n\t| \"healthcare\"\n\t| \"fintech\"\n\t| \"gaming\"\n\t| \"education\"\n\t| \"media\"\n\t| \"productivity\";\n\n/**\n * Translation formality level.\n * Can be set project-wide in vocoder.config.ts or overridden per-string\n * via <T formality=\"formal\"> (requires allowAiTranslations plan).\n */\nexport type Formality = \"formal\" | \"informal\" | \"neutral\";\n\nexport interface VocoderConfig {\n\t/**\n\t * Unique identifier for this app. Written by `vocoder init` — do not edit manually.\n\t * Used by the CLI to identify which app to update when syncing locales.\n\t */\n\tappId?: string;\n\t/** Glob patterns for files to extract strings from. */\n\tinclude?: string[];\n\t/** Glob patterns to exclude. */\n\texclude?: string[];\n\t/**\n\t * Git branches that trigger string extraction and translation.\n\t * Synced to the Vocoder dashboard on each push — change here to update.\n\t */\n\ttargetBranches?: string[];\n\t/**\n\t * Directory to write translated locale files after sync (optional).\n\t * If set, `vocoder sync` writes {locale}.json files to this path.\n\t */\n\tlocalesPath?: string;\n\t/**\n\t * The industry or domain of this application.\n\t * Used to improve translation quality for domain-specific terminology\n\t * and to isolate cache entries by industry in the global translation cache.\n\t * Synced to App at extraction time.\n\t */\n\tappIndustry?: AppIndustry;\n\t/**\n\t * Project-wide default formality level for translations.\n\t * Can be overridden per-string via <T formality=\"...\"> on the AI plan.\n\t * Synced to App at extraction time.\n\t */\n\tformality?: Formality;\n}\n\n/** Type helper for vocoder.config.ts — provides autocomplete and type checking. */\nexport function defineConfig(config: VocoderConfig): VocoderConfig {\n\treturn config;\n}\n\n// Canonical translation bundle format — defined in @vocoder/core and re-exported here\n// so consumers can import it from either package.\nexport type { VocoderTranslationData } from \"@vocoder/core\";\n"],"mappings":";;;;;;;;;;;;;;;;;AA6DO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}
+{"version":3,"sources":["../../config/src/index.ts","../src/utils/setup-snippets.ts"],"sourcesContent":["/**\n * Supported industry classifications for an app.\n * Set once in vocoder.config.ts; synced to App at extraction time.\n * Used as a TM pool bucket key — matching values across orgs share cache entries.\n * Cannot be edited from the dashboard — config file is the source of truth.\n */\nexport type Industry =\n\t| \"ecommerce\"\n\t| \"b2b_saas\"\n\t| \"healthcare\"\n\t| \"fintech\"\n\t| \"gaming\"\n\t| \"education\"\n\t| \"media\"\n\t| \"productivity\"\n\t| \"travel\"\n\t| \"legal\"\n\t| \"government\"\n\t| \"nonprofit\"\n\t| \"other\";\n\n/** @deprecated Use `Industry` */\nexport type AppIndustry = Industry;\n\n/**\n * Translation formality level.\n * Can be set project-wide in vocoder.config.ts or overridden per-string\n * via <T formality=\"formal\"> (requires allowAiTranslations plan).\n */\nexport type Formality = \"formal\" | \"informal\" | \"neutral\";\n\nexport interface VocoderConfig {\n\t/**\n\t * Unique identifier for this app. Written by `vocoder init` — do not edit manually.\n\t * Used by the CLI to identify which app to update when syncing locales.\n\t */\n\tappId?: string;\n\t/** Glob patterns for files to extract strings from. */\n\tinclude?: string[];\n\t/** Glob patterns to exclude. */\n\texclude?: string[];\n\t/**\n\t * Git branches that trigger string extraction and translation.\n\t * Synced to the Vocoder dashboard on each push — change here to update.\n\t */\n\ttargetBranches?: string[];\n\t/**\n\t * Directory to write translated locale files after sync (optional).\n\t * If set, `vocoder sync` writes {locale}.json files to this path.\n\t */\n\tlocalesPath?: string;\n\t/**\n\t * The industry or domain of this application.\n\t * Used to improve translation quality for domain-specific terminology\n\t * and to isolate cache entries by industry in the global translation cache.\n\t * Synced to App at extraction time.\n\t */\n\tindustry?: Industry;\n\t/** @deprecated Use `industry` */\n\tappIndustry?: Industry;\n\t/**\n\t * Project-wide default formality level for translations.\n\t * Can be overridden per-string via <T formality=\"...\"> on the AI plan.\n\t * Synced to App at extraction time.\n\t */\n\tformality?: Formality;\n}\n\n/** Type helper for vocoder.config.ts — provides autocomplete and type checking. */\nexport function defineConfig(config: VocoderConfig): VocoderConfig {\n\treturn config;\n}\n\n// Canonical translation bundle format — defined in @vocoder/core and re-exported here\n// so consumers can import it from either package.\nexport type { VocoderTranslationData } from \"@vocoder/core\";\n","import type { DetectedEcosystem, DetectedFramework } from \"./detect-local.js\";\n\nexport interface SetupSnippets {\n\tpluginStep: { file: string; code: string } | null;\n\tproviderStep: { file: string; code: string } | null;\n\twrapStep: { code: string };\n\twhatsNext: string;\n}\n\n/**\n * Generate framework-specific setup snippets.\n */\nexport function getSetupSnippets(params: {\n\tframework: DetectedFramework;\n\tecosystem: DetectedEcosystem;\n\tsourceLocale: string;\n\ttargetBranches: string[];\n\tappDir?: string;\n}): SetupSnippets {\n\tconst { framework, ecosystem, sourceLocale } = params;\n\n\treturn {\n\t\tpluginStep: getPluginSnippet(framework, ecosystem),\n\t\tproviderStep: getProviderSnippet(ecosystem, sourceLocale),\n\t\twrapStep: getWrapSnippet(ecosystem),\n\t\twhatsNext: \"Push to a target branch to trigger translations.\",\n\t};\n}\n\nfunction getPluginSnippet(\n\tframework: DetectedFramework,\n\tecosystem: DetectedEcosystem,\n): { file: string; code: string } | null {\n\tswitch (framework) {\n\t\tcase \"nextjs\":\n\t\t\treturn {\n\t\t\t\tfile: \"next.config.ts\",\n\t\t\t\tcode: `import { withVocoder } from '@vocoder/plugin/next';\n\nexport default withVocoder({\n  // your existing Next.js config\n});`,\n\t\t\t};\n\n\t\tcase \"vite\":\n\t\tcase \"remix\":\n\t\t\treturn {\n\t\t\t\tfile: \"vite.config.ts\",\n\t\t\t\tcode: `import vocoder from '@vocoder/plugin/vite';\n\nexport default defineConfig({\n  plugins: [\n    vocoder(),\n    // your other plugins\n  ],\n});`,\n\t\t\t};\n\n\t\tcase \"nuxt\":\n\t\t\treturn {\n\t\t\t\tfile: \"nuxt.config.ts\",\n\t\t\t\tcode: `import vocoder from '@vocoder/plugin/vite';\n\nexport default defineNuxtConfig({\n  vite: {\n    plugins: [vocoder()],\n  },\n});`,\n\t\t\t};\n\n\t\tcase \"sveltekit\":\n\t\t\treturn {\n\t\t\t\tfile: \"vite.config.ts\",\n\t\t\t\tcode: `import vocoder from '@vocoder/plugin/vite';\nimport { sveltekit } from '@sveltejs/kit/vite';\n\nexport default defineConfig({\n  plugins: [\n    sveltekit(),\n    vocoder(),\n  ],\n});`,\n\t\t\t};\n\n\t\tcase \"gatsby\":\n\t\t\treturn {\n\t\t\t\tfile: \"gatsby-node.js\",\n\t\t\t\tcode: `const vocoder = require('@vocoder/plugin/webpack');\n\nexports.onCreateWebpackConfig = ({ actions }) => {\n  actions.setWebpackConfig({\n    plugins: [vocoder()],\n  });\n};`,\n\t\t\t};\n\n\t\tcase \"angular\":\n\t\t\treturn null; // Angular CLI doesn't expose plugin config easily\n\n\t\tdefault:\n\t\t\t// No known framework — if they have React/Vue/Svelte, they likely have a bundler\n\t\t\t// but we can't guess which config file. Give generic advice.\n\t\t\tif (ecosystem) {\n\t\t\t\treturn {\n\t\t\t\t\tfile: \"your bundler config\",\n\t\t\t\t\tcode: `// Vite\nimport vocoder from '@vocoder/plugin/vite';\n// Webpack\nconst vocoder = require('@vocoder/plugin/webpack');\n\n// Add vocoder() to your plugins array`,\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn null;\n\t}\n}\n\nfunction getProviderSnippet(\n\tecosystem: DetectedEcosystem,\n\tsourceLocale: string,\n): { file: string; code: string } | null {\n\tswitch (ecosystem) {\n\t\tcase \"react\":\n\t\t\treturn {\n\t\t\t\tfile: \"your root layout or App component\",\n\t\t\t\tcode: `import { VocoderProvider } from '@vocoder/react';\n\n<VocoderProvider defaultLocale=\"${sourceLocale}\">\n  {children}\n</VocoderProvider>`,\n\t\t\t};\n\n\t\tcase \"vue\":\n\t\t\treturn {\n\t\t\t\tfile: \"your app entry\",\n\t\t\t\tcode: `import { createVocoder } from '@vocoder/vue';\n\nconst vocoder = createVocoder({\n  defaultLocale: '${sourceLocale}',\n});\n\napp.use(vocoder);`,\n\t\t\t};\n\n\t\tcase \"svelte\":\n\t\t\treturn {\n\t\t\t\tfile: \"your root layout\",\n\t\t\t\tcode: `<script>\n  import { VocoderProvider } from '@vocoder/svelte';\n</script>\n\n<VocoderProvider defaultLocale=\"${sourceLocale}\">\n  <slot />\n</VocoderProvider>`,\n\t\t\t};\n\n\t\tdefault:\n\t\t\treturn null;\n\t}\n}\n\nfunction getWrapSnippet(ecosystem: DetectedEcosystem): { code: string } {\n\tswitch (ecosystem) {\n\t\tcase \"react\":\n\t\t\treturn {\n\t\t\t\tcode: `import { T } from '@vocoder/react';\n\n<T>Hello, world!</T>`,\n\t\t\t};\n\n\t\tcase \"vue\":\n\t\t\treturn {\n\t\t\t\tcode: `<template>\n  <T>Hello, world!</T>\n</template>\n\n<script setup>\nimport { T } from '@vocoder/vue';\n</script>`,\n\t\t\t};\n\n\t\tcase \"svelte\":\n\t\t\treturn {\n\t\t\t\tcode: `<script>\n  import { T } from '@vocoder/svelte';\n</script>\n\n<T>Hello, world!</T>`,\n\t\t\t};\n\n\t\tdefault:\n\t\t\treturn {\n\t\t\t\tcode: `// Wrap translatable strings with <T>\n<T>Hello, world!</T>`,\n\t\t\t};\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAqEO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;;;AC3DO,SAAS,iBAAiB,QAMf;AACjB,QAAM,EAAE,WAAW,WAAW,aAAa,IAAI;AAE/C,SAAO;AAAA,IACN,YAAY,iBAAiB,WAAW,SAAS;AAAA,IACjD,cAAc,mBAAmB,WAAW,YAAY;AAAA,IACxD,UAAU,eAAe,SAAS;AAAA,IAClC,WAAW;AAAA,EACZ;AACD;AAEA,SAAS,iBACR,WACA,WACwC;AACxC,UAAQ,WAAW;AAAA,IAClB,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,MAKP;AAAA,IAED,KAAK;AAAA,IACL,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MASP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA;AAAA,IAER;AAGC,UAAI,WAAW;AACd,eAAO;AAAA,UACN,MAAM;AAAA,UACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAMP;AAAA,MACD;AACA,aAAO;AAAA,EACT;AACD;AAEA,SAAS,mBACR,WACA,cACwC;AACxC,UAAQ,WAAW;AAAA,IAClB,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA,kCAEwB,YAAY;AAAA;AAAA;AAAA,MAG3C;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA,oBAGU,YAAY;AAAA;AAAA;AAAA;AAAA,MAI7B;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA,kCAIwB,YAAY;AAAA;AAAA;AAAA,MAG3C;AAAA,IAED;AACC,aAAO;AAAA,EACT;AACD;AAEA,SAAS,eAAe,WAAgD;AACvE,UAAQ,WAAW;AAAA,IAClB,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA;AAAA;AAAA,MAGP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOP;AAAA,IAED,KAAK;AACJ,aAAO;AAAA,QACN,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,MAKP;AAAA,IAED;AACC,aAAO;AAAA,QACN,MAAM;AAAA;AAAA,MAEP;AAAA,EACF;AACD;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "CLI tool for Vocoder translation workflow",
   "files": [
     "dist"
@@ -51,8 +51,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^1.0.0",
-    "@vocoder/extractor": "0.15.0",
-    "@vocoder/config": "0.15.0"
+    "@vocoder/extractor": "0.16.0",
+    "@vocoder/config": "0.16.0"
   },
   "engines": {
     "node": ">=18"