@brickflow/cli 0.0.30 → 0.0.32

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @brickflow/cli
 
+## 0.0.32
+
+### Patch Changes
+
+- Ban async effect
+
+## 0.0.31
+
+### Patch Changes
+
+- Translation folders migration
+
 ## 0.0.30
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brickflow/cli",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "description": "",
   "type": "module",
   "main": "index.mjs",

package/src/translate/ai.js

@@ -58,7 +58,7 @@ function buildContents(strings, sourceLocale, targetLocales, componentContext) {
 }
 
 function buildSystemInstruction() {
-  const { productContext, terminology, tone } = getTranslateRuntimeConfig()
+  const { productContext } = getTranslateRuntimeConfig()
 
   return [
     'You are a professional localization engine for a paid adult content platform.',
@@ -66,12 +66,6 @@ function buildSystemInstruction() {
     'PRODUCT CONTEXT:',
     productContext,
     '',
-    'TERMINOLOGY:',
-    terminology,
-    '',
-    'TONE:',
-    tone,
-    '',
     'RULES:',
     '- Return only raw JSON.',
     '- Preserve JSON shape exactly.',

package/src/translate/index.js

@@ -1,9 +1,8 @@
 import fs from 'fs'
-import { globSync } from 'glob'
 import { dirname, join, relative } from 'path'
 
 import { resolveWorkspaceRoot } from '../shared/workspace-root.js'
-import { getAiContextState } from './ai-context.js'
+import { getContextFilePath, readAiContextDescription } from '../translate-context/ai-context.js'
 import { translateBatch } from './ai.js'
 import { buildTranslateHelp, parseTranslateRuntimeArgs, setTranslateRuntimeConfig } from './runtime-config.js'
 import { listTranslationTargets, sortObjectKeys, stringifySortedJson } from './utils.js'
@@ -17,9 +16,11 @@ if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
 }
 
 const { options } = parseTranslateRuntimeArgs(rawArgs)
+let requestedLanguageCodes
 
 try {
   setTranslateRuntimeConfig(options)
+  requestedLanguageCodes = parseLanguageCodes(options.locales)
 } catch (error) {
   console.error(error instanceof Error ? error.message : String(error))
   console.error('')
@@ -27,45 +28,9 @@ try {
   process.exit(1)
 }
 
-const DEFAULT_LANGUAGE_CODES = [
-  'bn',
-  'cz',
-  'dk',
-  'de',
-  'en',
-  'es',
-  'fi',
-  'fr',
-  'hi',
-  'hu',
-  'it',
-  'ja',
-  'nl',
-  'no',
-  'pl',
-  'pt',
-  'ru',
-  'si',
-  'se',
-  'sk',
-]
 const BATCH_MAX_ITEMS = readPositiveInt('TRANSLATE_BATCH_MAX_ITEMS', 30)
 const BATCH_MAX_CHARS = readPositiveInt('TRANSLATE_BATCH_MAX_CHARS', 3500)
-const languagePaths = globSync(
-  '{packages/brick,apps/*}/{components/**/translate,pages-translate/*,layouts/**,global/*}/generated/*.json',
-  {
-    absolute: true,
-    cwd: workspaceRoot,
-    ignore: ['**/node_modules/**', '**/.nuxt/**', '**/dist/**', '**/.output/**', '**/coverage/**', '**/public/**'],
-  },
-).sort()
-
-const languageCodes = [
-  ...new Set([
-    ...languagePaths.map((filePath) => filePath.replace(/.*\/([^/]+)\.json$/, '$1')),
-    ...DEFAULT_LANGUAGE_CODES,
-  ]),
-].sort()
+const languageCodes = requestedLanguageCodes
 
 const tasks = listTranslationTargets(workspaceRoot).map(({ samplePath, sourceFilePath }) => ({
   sample: readJson(samplePath),
@@ -141,25 +106,52 @@ function normalizeEol(content) {
   return String(content).replace(/\r\n/g, '\n')
 }
 
-async function processSample({ sample, samplePath, sourceFilePath }) {
+function parseLanguageCodes(value) {
+  if (value === undefined || value === null) {
+    throw new Error('Missing required translate option: --locales')
+  }
+
+  const localeCodes = [
+    ...new Set(
+      String(value)
+        .split(/[\s,]+/)
+        .filter(Boolean),
+    ),
+  ].map((code) => code.toLowerCase())
+
+  if (localeCodes.length === 0 || localeCodes.some((code) => !/^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/.test(code))) {
+    throw new Error(
+      'Invalid --locales value. Use comma-separated locale codes, for example: --locales en,pl,ru,de',
+    )
+  }
+
+  if (!localeCodes.includes('en')) {
+    throw new Error('Missing required locale: en. Add it to --locales, for example: --locales en,pl,ru,de')
+  }
+
+  return localeCodes.sort()
+}
+
+async function processSample({ sample, samplePath }) {
+  const componentContext = readAiContextDescription(samplePath)
+
+  if (!componentContext) {
+    throw new Error(
+      `Missing AI context: ${relative(workspaceRoot, getContextFilePath(samplePath))}. Run "brick translate-context" first.`,
+    )
+  }
+
   writeSortedJsonIfNeeded(samplePath, sample)
 
-  const generatedDir = join(dirname(samplePath), 'generated')
-  const enPath = join(generatedDir, 'en.json')
-  const currentEn = existsJson(enPath) ? readJson(enPath) : {}
+  const dataPath = join(dirname(samplePath), 'data.json')
+  const currentData = existsJson(dataPath) ? readJson(dataPath) : {}
+  const currentEn = currentData.en ?? {}
   const currentByLanguage = new Map(
-    languageCodes.map((languageCode) => [
-      languageCode,
-      existsJson(join(generatedDir, `${languageCode}.json`))
-        ? readJson(join(generatedDir, `${languageCode}.json`))
-        : {},
-    ]),
+    languageCodes.map((languageCode) => [languageCode, currentData[languageCode] ?? {}]),
   )
   const resultByLanguage = new Map(languageCodes.map((languageCode) => [languageCode, {}]))
   const pendingEntriesByLocales = new Map()
 
-  fs.mkdirSync(generatedDir, { recursive: true })
-
   for (const [key, sampleValue] of Object.entries(sample)) {
     const missingLocales = []
 
@@ -201,15 +193,6 @@ async function processSample({ sample, samplePath, sourceFilePath }) {
     }
   }
 
-  let componentContext = null
-
-  if (pendingEntriesByLocales.size > 0) {
-    componentContext = getAiContextState({
-      samplePath,
-      sourceFilePath,
-    }).description
-  }
-
   for (const [localeKey, entries] of pendingEntriesByLocales) {
     const targetLocales = localeKey.split(',').filter(Boolean)
     const chunks = splitIntoBatches(entries, BATCH_MAX_ITEMS, BATCH_MAX_CHARS)
@@ -243,11 +226,13 @@ async function processSample({ sample, samplePath, sourceFilePath }) {
     }
   }
 
+  const nextData = {}
+
   for (const languageCode of languageCodes) {
-    const generatedPath = join(generatedDir, `${languageCode}.json`)
-    const languageResult = sortObjectKeys(resultByLanguage.get(languageCode) ?? {})
-    writeTextPreservingEol(generatedPath, stringifySortedJson(languageResult))
+    nextData[languageCode] = sortObjectKeys(resultByLanguage.get(languageCode) ?? {})
   }
+
+  writeTextPreservingEol(dataPath, stringifySortedJson(nextData))
 }
 
 function readJson(filePath) {

package/src/translate/runtime-config.js

@@ -2,32 +2,29 @@ export const DEFAULT_CONTEXT_MODEL = 'gemini-3.1-flash-lite-preview'
 
 let runtimeConfig = null
 
-export function buildTranslateHelp(command = 'brick translate') {
+export function buildTranslateHelp(command = 'brick translate', { includeLocales = true } = {}) {
+  const localesRequired = includeLocales ? '\n  --locales "en,pl,ru,de"' : ''
+  const localesExample = includeLocales ? '    --locales "en,pl,ru,de" \\\n' : ''
+
   return `${command}
 
 Required options:
   --product-context "<text>"
-  --terminology "<text>"
-  --tone "<text>"
-  --api-key "<key>"
+  --api-key "<key>"${localesRequired}
 
 Optional:
   --context-model "<model>"  Default: ${DEFAULT_CONTEXT_MODEL}
 
 Example:
   ${command} \\
-    --product-context "Creators sell adult content packs with free previews and paid unlocks." \\
-    --terminology "Bundle=content pack; Unlock=paid access; VIP=premium content" \\
-    --tone "Natural, modern, conversion-oriented, explicit when source is explicit." \\
+    --product-context "Creators sell goods packs." \\
     --api-key "your-gemini-api-key" \\
-    --context-model "${DEFAULT_CONTEXT_MODEL}"`
+${localesExample}    --context-model "${DEFAULT_CONTEXT_MODEL}"`
 }
 
 export function getTranslateRuntimeConfig() {
   if (!runtimeConfig) {
-    throw new Error(
-      'Translate runtime config is not initialized. Pass --product-context, --terminology, --tone, and --api-key.',
-    )
+    throw new Error('Translate runtime config is not initialized. Pass --product-context and --api-key.')
   }
 
   return runtimeConfig
@@ -37,9 +34,8 @@ export function parseTranslateRuntimeArgs(rawArgs) {
   const options = {
     apiKey: null,
     contextModel: DEFAULT_CONTEXT_MODEL,
+    locales: undefined,
     productContext: null,
-    terminology: null,
-    tone: null,
   }
   const positional = []
 
@@ -52,18 +48,6 @@ export function parseTranslateRuntimeArgs(rawArgs) {
       continue
     }
 
-    if (value === '--terminology') {
-      options.terminology = rawArgs[index + 1] ?? null
-      index += 1
-      continue
-    }
-
-    if (value === '--tone') {
-      options.tone = rawArgs[index + 1] ?? null
-      index += 1
-      continue
-    }
-
     if (value === '--api-key') {
       options.apiKey = rawArgs[index + 1] ?? null
       index += 1
@@ -76,6 +60,12 @@ export function parseTranslateRuntimeArgs(rawArgs) {
       continue
     }
 
+    if (value === '--locales') {
+      options.locales = rawArgs[index + 1] ?? null
+      index += 1
+      continue
+    }
+
     positional.push(value)
   }
 
@@ -100,14 +90,6 @@ export function validateTranslateRuntimeConfig(config) {
     missing.push('--product-context')
   }
 
-  if (!config.terminology) {
-    missing.push('--terminology')
-  }
-
-  if (!config.tone) {
-    missing.push('--tone')
-  }
-
   if (!config.apiKey) {
     missing.push('--api-key')
   }

package/src/translate/utils.js

@@ -19,7 +19,7 @@ const IGNORED_GLOB_PATTERNS = [
 ]
 const IGNORED_SOURCE_SEGMENTS = ['/node_modules/', '/.nuxt/', '/dist/', '/.output/', '/coverage/', '/public/']
 const TRANSLATION_SAMPLE_GLOB =
-  '{packages/brick,apps/*}/{components/**/translate,pages-translate/*,layouts/**,global/*}/sample.json'
+  '{packages/brick,apps/*}/{components/**/translate,pages-translate/*,layouts-translate/**,script-translate/*}/sample.json'
 
 export function compileVueToJS(code, filePath) {
   const { descriptor } = parseSFC(code)
@@ -171,6 +171,10 @@ export function getTranslationPaths(id) {
     /\.(?:js|ts)$/.test(normalizedId) &&
     !normalizedId.endsWith('.d.ts')
 
+  if (isComponent && !normalizedId.endsWith('/index.vue')) {
+    return null
+  }
+
   if (!isComponent && !isPage && !isLayout && !isScript) {
     return null
   }
@@ -204,13 +208,9 @@ export function getTranslationPaths(id) {
   }
 
   if (isLayout) {
-    const layoutDir = normalizedId.split('/').slice(0, -1).join('/')
-    const fileName =
-      normalizedId
-        .split('/')
-        .pop()
-        ?.replace(/\.\w+$/, '') ?? ''
-    const baseDir = join(layoutDir, fileName)
+    const layoutsRoot = `${normalizedId.split('/layouts/')[0]}/layouts`
+    const layoutPath = normalizedId.split('/layouts/')[1].replace(/\.\w+$/, '')
+    const baseDir = join(layoutsRoot, '..', 'layouts-translate', layoutPath)
 
     return {
       baseDir,
@@ -222,7 +222,7 @@ export function getTranslationPaths(id) {
     }
   }
 
-  const baseDir = join(projectRoot, 'global', getComponentName(normalizedId))
+  const baseDir = join(projectRoot, 'script-translate', getComponentName(normalizedId))
 
   return {
     baseDir,

package/src/{translate → translate-context}/ai-context.js

@@ -1,27 +1,30 @@
 #!/usr/bin/env node
 
 import fs from 'fs'
+import { globSync } from 'glob'
 import { dirname, join, relative, resolve } from 'path'
 import { fileURLToPath } from 'url'
 
 import { resolveWorkspaceRoot } from '../shared/workspace-root.js'
-import { generateContentWithLimits } from './gemini.js'
+import { generateContentWithLimits } from '../translate/gemini.js'
 import {
   buildTranslateHelp,
   DEFAULT_CONTEXT_MODEL,
   getTranslateRuntimeConfig,
   parseTranslateRuntimeArgs,
   setTranslateRuntimeConfig,
-} from './runtime-config.js'
-import { listTranslationTargets, stringifySortedJson } from './utils.js'
+} from '../translate/runtime-config.js'
+import { listTranslationTargets, stringifySortedJson } from '../translate/utils.js'
 
 const workspaceRoot = resolveWorkspaceRoot()
 const CONTEXT_FILE_NAME = 'ai-context.json'
+const CONTEXT_FILE_GLOB =
+  '{packages/brick,apps/*}/{components/**/translate,pages-translate/*,layouts-translate/**,script-translate/*}/ai-context.json'
 const CHANGE_THRESHOLD = readFloat('TRANSLATE_CONTEXT_MIN_CHANGE', 0.3)
 const SOURCE_MAX_CHARS = readPositiveInt('TRANSLATE_CONTEXT_SOURCE_MAX_CHARS', 16000)
 
 export function buildAiContextHelp(command = 'brick translate-context') {
-  return `${buildTranslateHelp(command)}\n\nExtra:\n  --force`
+  return `${buildTranslateHelp(command, { includeLocales: false })}\n\nExtra:\n  --force`
 }
 
 export function calculateChangeRatio(previousSource, nextSource) {
@@ -55,13 +58,8 @@ export async function ensureAiContext({ force = false, sample, samplePath, sourc
   })
 
   const next = {
-    changeRatio: state.changeRatio,
     description,
-    samplePath: relative(workspaceRoot, samplePath),
-    sourceFilePath: relative(workspaceRoot, state.sourceFilePath),
     sourceSnapshot: state.sourceCode,
-    updatedAt: new Date().toISOString(),
-    version: 1,
   }
 
   writeTextPreservingEol(state.contextPath, stringifySortedJson(next))
@@ -116,6 +114,30 @@ export function getContextFilePath(samplePath) {
   return join(dirname(samplePath), CONTEXT_FILE_NAME)
 }
 
+export function readAiContextDescription(samplePath) {
+  const description = readContextFile(getContextFilePath(samplePath))?.description
+
+  return typeof description === 'string' && description.length > 0 ? description : null
+}
+
+export function removeObsoleteAiContexts(targets, rootDir = workspaceRoot) {
+  const activeContextPaths = new Set(targets.map(({ samplePath }) => getContextFilePath(samplePath)))
+  const contextPaths = globSync(CONTEXT_FILE_GLOB, {
+    absolute: true,
+    cwd: rootDir,
+    nodir: true,
+  }).sort()
+
+  for (const contextPath of contextPaths) {
+    if (activeContextPaths.has(contextPath)) {
+      continue
+    }
+
+    fs.rmSync(contextPath)
+    console.log(`🗑️  Context removed (sample not found): ${relative(rootDir, contextPath)}`)
+  }
+}
+
 export async function runAiContextCli(rawArgs = process.argv.slice(3), command = 'brick translate-context') {
   const helpText = buildAiContextHelp(command)
 
@@ -144,22 +166,41 @@ export async function runAiContextCli(rawArgs = process.argv.slice(3), command =
     ? targets.filter(({ samplePath }) => requestedSamplePaths.has(samplePath))
     : targets
 
+  if (!requestedSamplePaths) {
+    removeObsoleteAiContexts(targets)
+  }
+
+  const progress = createProgress(targetEntries.length)
+
   for (const { samplePath, sourceFilePath } of targetEntries) {
     if (!sourceFilePath || !fs.existsSync(samplePath)) {
+      console.warn(`⚠️  Context skipped (source not found): ${relative(workspaceRoot, samplePath)}`)
+      progress(samplePath, 'skipped')
+      continue
+    }
+
+    const state = getAiContextState({ force, samplePath, sourceFilePath })
+
+    if (!state.shouldRegenerate) {
+      progress(samplePath, 'unchanged')
       continue
     }
 
-    const description = await ensureAiContext({
+    await ensureAiContext({
       force,
       sample: JSON.parse(fs.readFileSync(samplePath, 'utf-8')),
       samplePath,
       sourceFilePath,
     })
 
-    if (description) {
-      console.log(`🧠 Context updated: ${relative(workspaceRoot, samplePath)}`)
-    }
+    progress(samplePath, 'updated')
   }
+
+  if (targetEntries.length > 0) {
+    process.stdout.write('\n')
+  }
+
+  console.log(`✅ Done: ${targetEntries.length} context files`)
 }
 
 function buildContextContents({ sampleEntries, samplePath, sourceCode, sourceFilePath }) {
@@ -176,23 +217,19 @@ function buildContextContents({ sampleEntries, samplePath, sourceCode, sourceFil
 }
 
 function buildContextSystemInstruction() {
-  const { productContext, terminology, tone } = getTranslateRuntimeConfig()
+  const { productContext } = getTranslateRuntimeConfig()
 
   return [
     'You are generating translation context for a UI component.',
     'Write a compact but informative description for translators.',
     'Product context:',
     productContext,
-    'Terminology:',
-    terminology,
-    'Tone:',
-    tone,
     'Focus on:',
     '- what the component or page does',
     '- main user actions',
     '- important entities and domain meaning',
     '- what the shown strings likely refer to',
-    '- tone or UX intent if obvious',
+    '- UX intent if obvious',
     'Rules:',
     '- Return plain text only.',
     '- Write 4 to 8 short sentences.',
@@ -209,6 +246,28 @@ function cleanText(text) {
     .trim()
 }
 
+function createProgress(total) {
+  let done = 0
+  const start = Date.now()
+
+  return function update(samplePath, status) {
+    done += 1
+
+    const percent = total === 0 ? 100 : Math.round((done * 100) / total)
+    const filled = Math.round(percent / 5)
+    const empty = 20 - filled
+    const elapsed = ((Date.now() - start) / 1000).toFixed(1)
+    const shortName = shortenPath(relative(workspaceRoot, samplePath))
+
+    process.stdout.write(
+      `\r🧠 Context: [${'█'.repeat(filled)}${' '.repeat(empty)}] ` +
+        `${percent}% (${done}/${total}) ` +
+        `⏱ ${elapsed}s ` +
+        `\x1b[90m${status} ${shortName}\x1b[0m\x1b[K`,
+    )
+  }
+}
+
 function detectEol(filePath) {
   if (!fs.existsSync(filePath)) {
     return '\n'
@@ -301,6 +360,14 @@ function readPositiveInt(name, fallback) {
   return Number.isFinite(value) && value > 0 ? value : fallback
 }
 
+function shortenPath(filePath, maxLength = 72) {
+  if (filePath.length <= maxLength) {
+    return filePath
+  }
+
+  return `...${filePath.slice(-(maxLength - 3))}`
+}
+
 function writeTextPreservingEol(filePath, content) {
   const eol = detectEol(filePath)
   const normalized = String(content).replace(/\r?\n/g, eol)
@@ -308,5 +375,5 @@ function writeTextPreservingEol(filePath, content) {
 }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  await runAiContextCli(process.argv.slice(2), 'node packages/cli/src/translate/ai-context.js')
+  await runAiContextCli(process.argv.slice(2), 'node packages/cli/src/translate-context/ai-context.js')
 }

package/src/translate-context/index.js

@@ -1,3 +1,3 @@
-import { runAiContextCli } from '../translate/ai-context.js'
+import { runAiContextCli } from './ai-context.js'
 
 await runAiContextCli(process.argv.slice(3))

package/src/translate-sync/index.js

@@ -26,11 +26,11 @@ if (args.length > 0) {
 }
 
 const workspaceRoot = resolveWorkspaceRoot()
-const activeGeneratedDirs = new Set()
+const activeTranslationDirs = new Set()
 const cleanupRoots = new Set()
 const staticCleanupRoots = [
-  path.resolve(workspaceRoot, 'packages/brick/global'),
-  ...globSync('apps/*/global', {
+  path.resolve(workspaceRoot, 'packages/brick/script-translate'),
+  ...globSync('apps/*/script-translate', {
     absolute: true,
     cwd: workspaceRoot,
   }),
@@ -52,12 +52,12 @@ for (const file of filtered) {
   progress(file)
 }
 
-cleanupGeneratedDirs()
+cleanupTranslationDirs()
 
 process.stdout.write('\n')
 console.log('✅ Done')
 
-function cleanupGeneratedDirs() {
+function cleanupTranslationDirs() {
   for (const rootDir of cleanupRoots) {
     if (!fs.existsSync(rootDir)) {
       continue
@@ -70,7 +70,7 @@ function cleanupGeneratedDirs() {
 
       const targetDir = path.resolve(rootDir, entry.name)
 
-      if (!activeGeneratedDirs.has(targetDir)) {
+      if (!activeTranslationDirs.has(targetDir)) {
         removeDir(targetDir)
       }
     }
@@ -127,16 +127,7 @@ function ensureSortedJsonFile(filePath) {
 }
 
 function ensureSortedTranslationJsons(baseDir, samplePath) {
-  const filesToCheck = [samplePath, path.resolve(baseDir, 'ai-context.json')]
-  const generatedDir = path.resolve(baseDir, 'generated')
-
-  if (fs.existsSync(generatedDir)) {
-    for (const entry of fs.readdirSync(generatedDir, { withFileTypes: true })) {
-      if (entry.isFile() && entry.name.endsWith('.json')) {
-        filesToCheck.push(path.resolve(generatedDir, entry.name))
-      }
-    }
-  }
+  const filesToCheck = [samplePath, path.resolve(baseDir, 'ai-context.json'), path.resolve(baseDir, 'data.json')]
 
   for (const filePath of filesToCheck) {
     try {
@@ -165,7 +156,7 @@ Usage:
 
 Notes:
   Scans source files and regenerates translation sample.json files
-  Removes obsolete generated translation directories
+  Removes obsolete translation directories
   Verifies and normalizes translation JSON key ordering`)
 }
 
@@ -241,7 +232,7 @@ function writeTranslations(id, strings) {
   }
 
   if (isPage || isLayout || isScript) {
-    activeGeneratedDirs.add(baseDir)
+    activeTranslationDirs.add(baseDir)
   }
 
   fs.mkdirSync(baseDir, { recursive: true })