@vocoder/cli 0.1.4 → 0.1.7

package/dist/lib.d.mts

@@ -0,0 +1,175 @@
+type EffectiveSyncMode = 'required' | 'best-effort';
+interface SyncPolicyConfig {
+    blockingBranches: string[];
+    blockingMode: EffectiveSyncMode;
+    nonBlockingMode: EffectiveSyncMode;
+    defaultMaxWaitMs: number;
+}
+interface APIProjectConfig {
+    projectName: string;
+    organizationName: string;
+    sourceLocale: string;
+    targetLocales: string[];
+    targetBranches: string[];
+    syncPolicy: SyncPolicyConfig;
+}
+interface ExtractedString {
+    key: string;
+    text: string;
+    file: string;
+    line: number;
+    context?: string;
+    formality?: 'formal' | 'informal' | 'neutral' | 'auto';
+}
+interface TranslationBatchResponse {
+    batchId: string;
+    newStrings: number;
+    deletedStrings?: number;
+    totalStrings: number;
+    status: 'PENDING' | 'TRANSLATING' | 'COMPLETED' | 'FAILED' | 'UP_TO_DATE';
+    noChanges?: boolean;
+    estimatedTime?: number;
+    effectiveMode?: EffectiveSyncMode;
+    queueStatus?: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
+    snapshotAvailable?: boolean;
+    latestCompletedBatchId?: string;
+    translations?: Record<string, Record<string, string>>;
+}
+interface TranslationStatusResponse {
+    status: 'PENDING' | 'TRANSLATING' | 'COMPLETED' | 'FAILED';
+    progress: number;
+    jobs?: Array<{
+        locale: string;
+        status: string;
+        progress: number;
+    }>;
+    translations?: Record<string, Record<string, string>>;
+    localeMetadata?: Record<string, {
+        nativeName: string;
+        dir?: 'rtl';
+    }>;
+    errorMessage?: string;
+}
+interface TranslationSnapshotResponse {
+    status: 'FOUND' | 'NOT_FOUND';
+    branch: string;
+    sourceLocale?: string;
+    targetLocales?: string[];
+    snapshotBatchId?: string;
+    completedAt?: string | null;
+    translations?: Record<string, Record<string, string>>;
+    localeMetadata?: Record<string, {
+        nativeName: string;
+        dir?: 'rtl';
+    }>;
+}
+interface LimitErrorResponse {
+    errorCode: 'LIMIT_EXCEEDED' | 'INSUFFICIENT_CREDITS';
+    limitType: 'organizations' | 'projects' | 'git_connections' | 'members' | 'providers' | 'translation_chars' | 'source_strings' | 'credits';
+    planId: string;
+    current: number;
+    required: number;
+    upgradeUrl: string;
+    message: string;
+}
+interface SyncPolicyErrorResponse {
+    errorCode: 'BRANCH_NOT_ALLOWED' | 'PROJECT_REPOSITORY_MISMATCH';
+    message: string;
+    branch?: string;
+    targetBranches?: string[];
+    boundRepoLabel?: string | null;
+    boundScopePath?: string | null;
+}
+
+/**
+ * Extract translatable strings from source files
+ *
+ * NOTE: This is a simplified version for the CLI MVP.
+ * Eventually this logic should be moved to a shared @vocoder/extraction package
+ * that can be used by both the CLI and the backend.
+ */
+declare class StringExtractor {
+    /**
+     * Extract strings from all files matching the pattern(s)
+     *
+     * @param pattern - Glob pattern(s) to include
+     * @param projectRoot - Project root directory
+     * @param excludePattern - Glob pattern(s) to exclude (optional)
+     */
+    extractFromProject(pattern: string | string[], projectRoot?: string, excludePattern?: string | string[]): Promise<ExtractedString[]>;
+    /**
+     * Extract strings from a single file
+     */
+    private extractFromFile;
+    /**
+     * Extract text from template literal
+     * Converts template literals like `Hello ${name}` to `Hello {name}`
+     */
+    private extractTemplateText;
+    /**
+     * Extract text content from JSX children
+     */
+    private extractTextContent;
+    /**
+     * Get string value from JSX attribute
+     * Handles both string literals and template literals
+     */
+    private getStringAttribute;
+    /**
+     * Deduplicate strings (keep first occurrence)
+     */
+    private deduplicateStrings;
+    private generateStableKey;
+}
+
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+type DetectedFramework = 'nextjs' | 'vite' | 'remix' | 'nuxt' | 'sveltekit' | 'gatsby' | 'angular' | null;
+type DetectedEcosystem = 'react' | 'vue' | 'svelte' | 'angular' | null;
+interface LocalDetectionResult {
+    ecosystem: DetectedEcosystem;
+    framework: DetectedFramework;
+    packageManager: PackageManager;
+    uiPackage: string | null;
+    hasUnplugin: boolean;
+    hasUiPackage: boolean;
+    sourceLocale: string | null;
+}
+/**
+ * Detect the local project's ecosystem, framework, and package manager
+ * by inspecting filesystem artifacts. No network calls.
+ */
+declare function detectLocalEcosystem(cwd?: string): LocalDetectionResult;
+/**
+ * Build the install command for packages that aren't already installed.
+ */
+declare function buildInstallCommand(packageManager: PackageManager, packages: string[]): string;
+/**
+ * Get the list of packages that need to be installed.
+ */
+declare function getPackagesToInstall(detection: LocalDetectionResult): string[];
+
+interface SetupSnippets {
+    pluginStep: {
+        file: string;
+        code: string;
+    } | null;
+    providerStep: {
+        file: string;
+        code: string;
+    } | null;
+    wrapStep: {
+        code: string;
+    };
+    whatsNext: string;
+}
+/**
+ * Generate framework-specific setup snippets.
+ */
+declare function getSetupSnippets(params: {
+    framework: DetectedFramework;
+    ecosystem: DetectedEcosystem;
+    sourceLocale: string;
+    translationTriggers: string[];
+}): SetupSnippets;
+
+export { type APIProjectConfig, type DetectedEcosystem, type DetectedFramework, type ExtractedString, type LimitErrorResponse, type LocalDetectionResult, type PackageManager, type SetupSnippets, StringExtractor, type SyncPolicyConfig, type SyncPolicyErrorResponse, type TranslationBatchResponse, type TranslationSnapshotResponse, type TranslationStatusResponse, buildInstallCommand, detectLocalEcosystem, getPackagesToInstall, getSetupSnippets };

package/dist/lib.mjs

@@ -0,0 +1,15 @@
+import {
+  StringExtractor,
+  buildInstallCommand,
+  detectLocalEcosystem,
+  getPackagesToInstall,
+  getSetupSnippets
+} from "./chunk-OC5N5C5X.mjs";
+export {
+  StringExtractor,
+  buildInstallCommand,
+  detectLocalEcosystem,
+  getPackagesToInstall,
+  getSetupSnippets
+};
+//# sourceMappingURL=lib.mjs.map

package/dist/lib.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "CLI tool for Vocoder translation workflow",
   "files": [
     "dist"
@@ -8,6 +8,12 @@
   "bin": {
     "vocoder": "dist/bin.mjs"
   },
+  "exports": {
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/lib.mjs"
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -47,12 +53,12 @@
     "@babel/parser": "^7.26.0",
     "@babel/traverse": "^7.26.0",
     "@babel/types": "^7.26.0",
+    "@clack/core": "0.4.1",
     "@clack/prompts": "^0.9.1",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "dotenv": "^16.3.1",
     "glob": "^10.3.10",
-    "recast": "^0.23.11",
     "tsx": "^4.7.0"
   },
   "devDependencies": {