@vocoder/cli 0.2.4 → 0.8.0

package/dist/lib.d.mts

@@ -1,5 +1,51 @@
-export { ExtractedString, StringExtractor, VocoderConfig, loadVocoderConfig } from '@vocoder/extractor';
-export { defineConfig } from '@vocoder/config';
+interface VocoderConfig {
+    /** Glob patterns for files to extract strings from. */
+    include?: string[];
+    /** Glob patterns to exclude. */
+    exclude?: string[];
+    /**
+     * Git branches that trigger string extraction and translation.
+     * Synced to the Vocoder dashboard on each push — change here to update.
+     */
+    targetBranches?: string[];
+    /**
+     * Directory to write translated locale files after sync (optional).
+     * If set, `vocoder sync` writes {locale}.json files to this path.
+     */
+    localesPath?: string;
+}
+/** Type helper for vocoder.config.ts — provides autocomplete and type checking. */
+declare function defineConfig(config: VocoderConfig): VocoderConfig;
+
+/**
+ * Load vocoder.config.{ts,js,mjs,json} from the given directory.
+ * Uses Babel AST parsing so it works for both TypeScript and JavaScript
+ * without requiring runtime execution or extra transpilation dependencies.
+ *
+ * Supports the common patterns:
+ *   export default { include: [...], exclude: [...] }
+ *   export default defineConfig({ include: [...], exclude: [...] })
+ *
+ * Returns null if no config file is found or parsing fails.
+ */
+declare function loadVocoderConfig(cwd: string): VocoderConfig | null;
+
+interface ExtractedString {
+    key: string;
+    text: string;
+    file: string;
+    line: number;
+    context?: string;
+    formality?: "formal" | "informal" | "neutral" | "auto";
+}
+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 {
     nativeName: string;
@@ -16,6 +62,7 @@ interface SyncPolicyConfig {
 interface APIProjectConfig {
     projectName: string;
     organizationName: string;
+    shortCode: string;
     sourceLocale: string;
     targetLocales: string[];
     targetBranches: string[];
@@ -133,4 +180,4 @@ declare function getSetupSnippets(params: {
     targetBranches: string[];
 }): SetupSnippets;
 
-export { type APIProjectConfig, type DetectedEcosystem, type DetectedFramework, type LimitErrorResponse, type LocalDetectionResult, type LocaleInfo, type LocalesMap, type PackageManager, type SetupSnippets, type SyncPolicyConfig, type SyncPolicyErrorResponse, type TranslationBatchResponse, type TranslationSnapshotResponse, type TranslationStatusResponse, buildInstallCommand, detectLocalEcosystem, getPackagesToInstall, getSetupSnippets };
+export { type APIProjectConfig, type DetectedEcosystem, type DetectedFramework, type ExtractedString, type LimitErrorResponse, type LocalDetectionResult, type LocaleInfo, type LocalesMap, type PackageManager, type SetupSnippets, StringExtractor, type SyncPolicyConfig, type SyncPolicyErrorResponse, type TranslationBatchResponse, type TranslationSnapshotResponse, type TranslationStatusResponse, type VocoderConfig, buildInstallCommand, defineConfig, detectLocalEcosystem, getPackagesToInstall, getSetupSnippets, loadVocoderConfig };

package/dist/lib.mjs

@@ -1,14 +1,17 @@
+import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);
 import {
   StringExtractor,
   buildInstallCommand,
   detectLocalEcosystem,
   getPackagesToInstall,
-  getSetupSnippets
-} from "./chunk-TFAPB25S.mjs";
+  getSetupSnippets,
+  loadVocoderConfig
+} from "./chunk-7LFRSUPU.mjs";
 
-// src/lib.ts
-import { loadVocoderConfig } from "@vocoder/extractor";
-import { defineConfig } from "@vocoder/config";
+// ../config/src/index.ts
+function defineConfig(config) {
+  return config;
+}
 export {
   StringExtractor,
   buildInstallCommand,

package/dist/lib.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/lib.ts"],"sourcesContent":["export type {\n\tAPIProjectConfig,\n\tExtractedString,\n\tLimitErrorResponse,\n\tLocaleInfo,\n\tLocalesMap,\n\tSyncPolicyConfig,\n\tSyncPolicyErrorResponse,\n\tTranslationBatchResponse,\n\tTranslationSnapshotResponse,\n\tTranslationStatusResponse,\n} from \"./types.js\";\nexport type {\n\tDetectedEcosystem,\n\tDetectedFramework,\n\tLocalDetectionResult,\n\tPackageManager,\n} from \"./utils/detect-local.js\";\nexport {\n\tbuildInstallCommand,\n\tdetectLocalEcosystem,\n\tgetPackagesToInstall,\n} from \"./utils/detect-local.js\";\nexport { StringExtractor } from \"./utils/extract.js\";\nexport { loadVocoderConfig } from \"@vocoder/extractor\";\nexport type { VocoderConfig } from \"@vocoder/extractor\";\nexport { defineConfig } from \"@vocoder/config\";\nexport type { SetupSnippets } from \"./utils/setup-snippets.js\";\nexport { getSetupSnippets } from \"./utils/setup-snippets.js\";\n"],"mappings":";;;;;;;;;AAwBA,SAAS,yBAAyB;AAElC,SAAS,oBAAoB;","names":[]}
+{"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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.2.4",
+  "version": "0.8.0",
   "description": "CLI tool for Vocoder translation workflow",
   "files": [
     "dist"
@@ -38,19 +38,7 @@
   "bugs": {
     "url": "https://github.com/vocoder/vocoder-sdk/issues"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch --no-dts --clean=false",
-    "watch": "tsup --watch",
-    "test": "vitest run --exclude 'src/__tests__/integration/**'",
-    "test:watch": "vitest",
-    "test:unit": "vitest run --exclude 'src/__tests__/integration/**'",
-    "test:integration": "RUN_INTEGRATION=true vitest run src/__tests__/integration",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
-    "@vocoder/config": "workspace:*",
-    "@vocoder/extractor": "workspace:*",
     "@clack/core": "0.4.1",
     "@clack/prompts": "^0.9.1",
     "chalk": "^5.3.0",
@@ -62,9 +50,21 @@
     "@types/node": "^20.19.9",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^1.0.0"
+    "vitest": "^1.0.0",
+    "@vocoder/extractor": "0.8.0",
+    "@vocoder/config": "0.8.0"
   },
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --no-dts --clean=false",
+    "watch": "tsup --watch",
+    "test": "vitest run --exclude 'src/__tests__/integration/**'",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --exclude 'src/__tests__/integration/**'",
+    "test:integration": "RUN_INTEGRATION=true vitest run src/__tests__/integration",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/chunk-TFAPB25S.mjs

@@ -1,277 +0,0 @@
-// src/utils/detect-local.ts
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function detectLocalEcosystem(cwd = process.cwd()) {
-  const packageManager = detectPackageManager(cwd);
-  const pkg = readPackageJson(cwd);
-  if (!pkg) {
-    return {
-      ecosystem: null,
-      framework: null,
-      packageManager,
-      uiPackage: null,
-      hasUnplugin: false,
-      hasExtractor: false,
-      hasConfig: false,
-      hasUiPackage: false,
-      sourceLocale: null
-    };
-  }
-  const allDeps = {
-    ...pkg.dependencies ?? {},
-    ...pkg.devDependencies ?? {}
-  };
-  const hasUnplugin = "@vocoder/plugin" in allDeps;
-  const hasExtractor = "@vocoder/extractor" in allDeps;
-  const hasConfig = "@vocoder/config" in allDeps;
-  const { ecosystem, framework, uiPackage } = detectFromDeps(allDeps, cwd);
-  const hasUiPackage = uiPackage !== null && uiPackage in allDeps;
-  return {
-    ecosystem,
-    framework,
-    packageManager,
-    uiPackage,
-    hasUnplugin,
-    hasExtractor,
-    hasConfig,
-    hasUiPackage,
-    sourceLocale: null
-  };
-}
-function detectPackageManager(cwd) {
-  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join(cwd, "bun.lockb")) || existsSync(join(cwd, "bun.lock")))
-    return "bun";
-  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
-  return "npm";
-}
-function readPackageJson(cwd) {
-  const pkgPath = join(cwd, "package.json");
-  if (!existsSync(pkgPath)) return null;
-  try {
-    return JSON.parse(readFileSync(pkgPath, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-function detectFromDeps(allDeps, cwd) {
-  if ("vue" in allDeps) {
-    const framework = "nuxt" in allDeps ? "nuxt" : null;
-    return { ecosystem: "vue", framework, uiPackage: "@vocoder/vue" };
-  }
-  if ("svelte" in allDeps) {
-    const framework = "@sveltejs/kit" in allDeps ? "sveltekit" : null;
-    return { ecosystem: "svelte", framework, uiPackage: "@vocoder/svelte" };
-  }
-  if ("@angular/core" in allDeps || existsSync(join(cwd, "angular.json"))) {
-    return {
-      ecosystem: "angular",
-      framework: "angular",
-      uiPackage: "@vocoder/angular"
-    };
-  }
-  if ("react" in allDeps) {
-    let framework = null;
-    if ("next" in allDeps) framework = "nextjs";
-    else if ("@remix-run/react" in allDeps) framework = "remix";
-    else if ("gatsby" in allDeps) framework = "gatsby";
-    else if ("vite" in allDeps) framework = "vite";
-    return { ecosystem: "react", framework, uiPackage: "@vocoder/react" };
-  }
-  return { ecosystem: null, framework: null, uiPackage: null };
-}
-function buildInstallCommand(packageManager, packages, dev = false) {
-  if (packages.length === 0) return "";
-  const pkgList = packages.join(" ");
-  const devFlag = dev ? " -D" : "";
-  switch (packageManager) {
-    case "pnpm":
-      return `pnpm add${devFlag} ${pkgList}`;
-    case "yarn":
-      return `yarn add${devFlag} ${pkgList}`;
-    case "bun":
-      return `bun add${devFlag} ${pkgList}`;
-    default:
-      return `npm install${devFlag} ${pkgList}`;
-  }
-}
-function getPackagesToInstall(detection) {
-  const devPackages = [];
-  const runtimePackages = [];
-  if (!detection.hasUnplugin) devPackages.push("@vocoder/plugin");
-  if (!detection.hasExtractor) devPackages.push("@vocoder/extractor");
-  if (!detection.hasConfig) devPackages.push("@vocoder/config");
-  if (detection.uiPackage && !detection.hasUiPackage)
-    runtimePackages.push(detection.uiPackage);
-  return { devPackages, runtimePackages };
-}
-
-// 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>`
-      };
-  }
-}
-
-// src/utils/extract.ts
-import { StringExtractor } from "@vocoder/extractor";
-
-export {
-  detectLocalEcosystem,
-  buildInstallCommand,
-  getPackagesToInstall,
-  getSetupSnippets,
-  StringExtractor
-};
-//# sourceMappingURL=chunk-TFAPB25S.mjs.map

package/dist/chunk-TFAPB25S.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/detect-local.ts","../src/utils/setup-snippets.ts","../src/utils/extract.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport type PackageManager = \"pnpm\" | \"npm\" | \"yarn\" | \"bun\";\n\nexport type DetectedFramework =\n\t| \"nextjs\"\n\t| \"vite\"\n\t| \"remix\"\n\t| \"nuxt\"\n\t| \"sveltekit\"\n\t| \"gatsby\"\n\t| \"angular\"\n\t| null;\n\nexport type DetectedEcosystem = \"react\" | \"vue\" | \"svelte\" | \"angular\" | null;\n\nexport interface LocalDetectionResult {\n\tecosystem: DetectedEcosystem;\n\tframework: DetectedFramework;\n\tpackageManager: PackageManager;\n\tuiPackage: string | null;\n\thasUnplugin: boolean;\n\thasExtractor: boolean;\n\thasConfig: boolean;\n\thasUiPackage: boolean;\n\tsourceLocale: string | null;\n}\n\n/**\n * Detect the local project's ecosystem, framework, and package manager\n * by inspecting filesystem artifacts. No network calls.\n */\nexport function detectLocalEcosystem(\n\tcwd: string = process.cwd(),\n): LocalDetectionResult {\n\tconst packageManager = detectPackageManager(cwd);\n\tconst pkg = readPackageJson(cwd);\n\n\tif (!pkg) {\n\t\treturn {\n\t\t\tecosystem: null,\n\t\t\tframework: null,\n\t\t\tpackageManager,\n\t\t\tuiPackage: null,\n\t\t\thasUnplugin: false,\n\t\t\thasExtractor: false,\n\t\t\thasConfig: false,\n\t\t\thasUiPackage: false,\n\t\t\tsourceLocale: null,\n\t\t};\n\t}\n\n\tconst allDeps = {\n\t\t...((pkg.dependencies as Record<string, string>) ?? {}),\n\t\t...((pkg.devDependencies as Record<string, string>) ?? {}),\n\t};\n\n\tconst hasUnplugin = \"@vocoder/plugin\" in allDeps;\n\tconst hasExtractor = \"@vocoder/extractor\" in allDeps;\n\tconst hasConfig = \"@vocoder/config\" in allDeps;\n\n\t// Detect ecosystem + framework\n\tconst { ecosystem, framework, uiPackage } = detectFromDeps(allDeps, cwd);\n\tconst hasUiPackage = uiPackage !== null && uiPackage in allDeps;\n\n\treturn {\n\t\tecosystem,\n\t\tframework,\n\t\tpackageManager,\n\t\tuiPackage,\n\t\thasUnplugin,\n\t\thasExtractor,\n\t\thasConfig,\n\t\thasUiPackage,\n\t\tsourceLocale: null,\n\t};\n}\n\nfunction detectPackageManager(cwd: string): PackageManager {\n\tif (existsSync(join(cwd, \"pnpm-lock.yaml\"))) return \"pnpm\";\n\tif (existsSync(join(cwd, \"bun.lockb\")) || existsSync(join(cwd, \"bun.lock\")))\n\t\treturn \"bun\";\n\tif (existsSync(join(cwd, \"yarn.lock\"))) return \"yarn\";\n\treturn \"npm\";\n}\n\nfunction readPackageJson(cwd: string): Record<string, unknown> | null {\n\tconst pkgPath = join(cwd, \"package.json\");\n\tif (!existsSync(pkgPath)) return null;\n\ttry {\n\t\treturn JSON.parse(readFileSync(pkgPath, \"utf-8\")) as Record<\n\t\t\tstring,\n\t\t\tunknown\n\t\t>;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction detectFromDeps(\n\tallDeps: Record<string, string>,\n\tcwd: string,\n): {\n\tecosystem: DetectedEcosystem;\n\tframework: DetectedFramework;\n\tuiPackage: string | null;\n} {\n\t// Vue ecosystem\n\tif (\"vue\" in allDeps) {\n\t\tconst framework = \"nuxt\" in allDeps ? (\"nuxt\" as const) : null;\n\t\treturn { ecosystem: \"vue\", framework, uiPackage: \"@vocoder/vue\" };\n\t}\n\n\t// Svelte ecosystem\n\tif (\"svelte\" in allDeps) {\n\t\tconst framework =\n\t\t\t\"@sveltejs/kit\" in allDeps ? (\"sveltekit\" as const) : null;\n\t\treturn { ecosystem: \"svelte\", framework, uiPackage: \"@vocoder/svelte\" };\n\t}\n\n\t// Angular ecosystem\n\tif (\"@angular/core\" in allDeps || existsSync(join(cwd, \"angular.json\"))) {\n\t\treturn {\n\t\t\tecosystem: \"angular\",\n\t\t\tframework: \"angular\",\n\t\t\tuiPackage: \"@vocoder/angular\",\n\t\t};\n\t}\n\n\t// React ecosystem (most common — check last)\n\tif (\"react\" in allDeps) {\n\t\tlet framework: DetectedFramework = null;\n\t\tif (\"next\" in allDeps) framework = \"nextjs\";\n\t\telse if (\"@remix-run/react\" in allDeps) framework = \"remix\";\n\t\telse if (\"gatsby\" in allDeps) framework = \"gatsby\";\n\t\telse if (\"vite\" in allDeps) framework = \"vite\";\n\t\treturn { ecosystem: \"react\", framework, uiPackage: \"@vocoder/react\" };\n\t}\n\n\treturn { ecosystem: null, framework: null, uiPackage: null };\n}\n\n/**\n * Build the install command for packages that aren't already installed.\n * Pass dev=true for devDependencies (-D flag).\n */\nexport function buildInstallCommand(\n\tpackageManager: PackageManager,\n\tpackages: string[],\n\tdev = false,\n): string {\n\tif (packages.length === 0) return \"\";\n\tconst pkgList = packages.join(\" \");\n\tconst devFlag = dev ? \" -D\" : \"\";\n\tswitch (packageManager) {\n\t\tcase \"pnpm\":\n\t\t\treturn `pnpm add${devFlag} ${pkgList}`;\n\t\tcase \"yarn\":\n\t\t\treturn `yarn add${devFlag} ${pkgList}`;\n\t\tcase \"bun\":\n\t\t\treturn `bun add${devFlag} ${pkgList}`;\n\t\tdefault:\n\t\t\treturn `npm install${devFlag} ${pkgList}`;\n\t}\n}\n\n/**\n * Get the lists of packages that need to be installed, split by dep type.\n * devPackages → devDependencies (build tools)\n * runtimePackages → dependencies (used at runtime in the app)\n */\nexport function getPackagesToInstall(detection: LocalDetectionResult): {\n\tdevPackages: string[];\n\truntimePackages: string[];\n} {\n\tconst devPackages: string[] = [];\n\tconst runtimePackages: string[] = [];\n\n\tif (!detection.hasUnplugin) devPackages.push(\"@vocoder/plugin\");\n\tif (!detection.hasExtractor) devPackages.push(\"@vocoder/extractor\");\n\tif (!detection.hasConfig) devPackages.push(\"@vocoder/config\");\n\n\tif (detection.uiPackage && !detection.hasUiPackage)\n\t\truntimePackages.push(detection.uiPackage);\n\n\treturn { devPackages, runtimePackages };\n}\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}): 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","export { type ExtractedString, StringExtractor } from \"@vocoder/extractor\";\n"],"mappings":"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","names":[]}