@vocoder/cli 0.8.0 → 0.10.0

package/dist/lib.d.mts

@@ -1,3 +1,18 @@
+/**
+ * Supported app industry classifications.
+ * Set once in vocoder.config.ts; synced to ProjectApp at extraction time.
+ * 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";
+/**
+ * Translation formality level.
+ * Can be set project-wide in vocoder.config.ts or overridden per-string
+ * via <T formality="formal"> (requires allowAiTranslations plan).
+ */
+type Formality = "formal" | "informal" | "neutral";
 interface VocoderConfig {
     /** Glob patterns for files to extract strings from. */
     include?: string[];
@@ -13,6 +28,19 @@ interface VocoderConfig {
      * If set, `vocoder sync` writes {locale}.json files to this path.
      */
     localesPath?: string;
+    /**
+     * The industry or domain of this application.
+     * Used to improve translation quality for domain-specific terminology
+     * and to isolate cache entries by industry in the global translation cache.
+     * Synced to ProjectApp at extraction time.
+     */
+    appIndustry?: AppIndustry;
+    /**
+     * Project-wide default formality level for translations.
+     * Can be overridden per-string via <T formality="..."> on the AI plan.
+     * Synced to ProjectApp at extraction time.
+     */
+    formality?: Formality;
 }
 /** Type helper for vocoder.config.ts — provides autocomplete and type checking. */
 declare function defineConfig(config: VocoderConfig): VocoderConfig;
@@ -37,14 +65,13 @@ interface ExtractedString {
     line: number;
     context?: string;
     formality?: "formal" | "informal" | "neutral" | "auto";
+    /** Detected UI role from JSX parent element or prop. e.g. "button_label", "heading", "input_placeholder" */
+    uiRole?: string;
+    /** Feature area inferred from file path. e.g. "checkout", "auth", "settings" */
+    featureArea?: string;
 }
 declare class StringExtractor {
     extractFromProject(pattern: string | string[], projectRoot?: string, excludePattern?: string | string[]): Promise<ExtractedString[]>;
-    private extractFromFile;
-    private extractPluralSelectICU;
-    private extractTemplateText;
-    private getStringAttribute;
-    private deduplicateStrings;
 }
 
 interface LocaleInfo {
@@ -135,6 +162,8 @@ interface LocalDetectionResult {
     hasConfig: boolean;
     hasUiPackage: boolean;
     sourceLocale: string | null;
+    /** True when a tsconfig.json is present or TypeScript is listed as a dependency. */
+    isTypeScript: boolean;
 }
 /**
  * Detect the local project's ecosystem, framework, and package manager

package/dist/lib.mjs

@@ -6,7 +6,7 @@ import {
   getPackagesToInstall,
   getSetupSnippets,
   loadVocoderConfig
-} from "./chunk-7LFRSUPU.mjs";
+} from "./chunk-73U4VZYP.mjs";
 
 // ../config/src/index.ts
 function defineConfig(config) {

package/dist/lib.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../config/src/index.ts"],"sourcesContent":["export interface VocoderConfig {\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}\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/**\n * Canonical translation bundle format shared by the build plugin and CLI.\n * Both read and write this shape — keeps cache files identical regardless of\n * which tool produced them.\n *\n * translations: locale → sourceKey (hash) → translated text\n * config.locales: locale metadata snapshot for the runtime\n */\nexport interface VocoderTranslationData {\n\tconfig: {\n\t\tsourceLocale: string;\n\t\ttargetLocales: string[];\n\t\tlocales: Record<string, {\n\t\t\tnativeName: string;\n\t\t\tdir?: \"rtl\";\n\t\t\tcurrencyCode?: string;\n\t\t\tordinalForms?: { type: \"suffix\"; suffixes: { zero?: string; one?: string; two?: string; few?: string; many?: string; other: string } } | { type: \"word\"; words: Record<string, Record<number, string>> };\n\t\t}>;\n\t};\n\ttranslations: Record<string, Record<string, string>>;\n\tupdatedAt: string | null;\n}\n"],"mappings":";;;;;;;;;;;AAkBO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}
+{"version":3,"sources":["../../config/src/index.ts"],"sourcesContent":["/**\n * Supported app industry classifications.\n * Set once in vocoder.config.ts; synced to ProjectApp 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/** 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 ProjectApp 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 ProjectApp 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/**\n * Canonical translation bundle format shared by the build plugin and CLI.\n * Both read and write this shape — keeps cache files identical regardless of\n * which tool produced them.\n *\n * translations: locale → sourceKey (hash) → translated text\n * config.locales: locale metadata snapshot for the runtime\n */\nexport interface VocoderTranslationData {\n\tconfig: {\n\t\tsourceLocale: string;\n\t\ttargetLocales: string[];\n\t\tlocales: Record<string, {\n\t\t\tnativeName: string;\n\t\t\tdir?: \"rtl\";\n\t\t\tcurrencyCode?: string;\n\t\t\tordinalForms?: { type: \"suffix\"; suffixes: { zero?: string; one?: string; two?: string; few?: string; many?: string; other: string } } | { type: \"word\"; words: Record<string, Record<number, string>> };\n\t\t}>;\n\t};\n\ttranslations: Record<string, Record<string, string>>;\n\tupdatedAt: string | null;\n}\n"],"mappings":";;;;;;;;;;;AAwDO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.8.0",
+  "version": "0.10.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.8.0",
-    "@vocoder/config": "0.8.0"
+    "@vocoder/config": "0.10.0",
+    "@vocoder/extractor": "0.10.0"
   },
   "engines": {
     "node": ">=18"