@lang-tag/cli 0.9.4 → 0.10.1

package/README.md

@@ -1,4 +1,4 @@
-# Lang-tag: Component-Colocated Translation Management / Translation Engine Proxy
+# Lang-tag CLI
 
 A professional solution for managing translations in modern JavaScript/TypeScript projects, especially those using component-based architectures. `lang-tag` simplifies internationalization by allowing you to define translation keys directly within the components where they are used. Translations become local, callable function objects with full TypeScript support, IntelliSense, and compile-time safety.
 

package/{cli/config.d.ts → config.d.ts}

@@ -1,4 +1,4 @@
-import { LangTagTranslationsConfig } from '../index.ts';
+import { LangTagTranslationsConfig } from 'lang-tag';
 import { LangTagCLILogger } from './logger.ts';
 export interface LangTagCLIConfig {
     /**
@@ -98,9 +98,12 @@ export interface LangTagCLIConfig {
      * A function called for each found lang tag before processing.
      * Allows dynamic modification of the tag's configuration (namespace, path, etc.)
      * based on the file path or other context.
-     * If it returns `undefined`, the tag's configuration is not automatically generated or updated.
+     *
+     * Changes made inside this function are **applied only if you explicitly call**
+     * `event.save(configuration)`. Returning a value or modifying the event object
+     * without calling `save()` will **not** update the configuration.
      */
-    onConfigGeneration: (params: LangTagCLIOnConfigGenerationParams) => LangTagTranslationsConfig | undefined;
+    onConfigGeneration: (event: LangTagCLIConfigGenerationEvent) => Promise<void>;
     debug?: boolean;
 }
 /**
@@ -131,19 +134,6 @@ export interface LangTagCLIOnImportActions {
     /** Sets the configuration for the currently imported tag. */
     setConfig: (config: LangTagTranslationsConfig) => void;
 }
-/**
- * Parameters passed to the `onConfigGeneration` configuration function.
- */
-export interface LangTagCLIOnConfigGenerationParams {
-    /** The absolute path to the source file being processed. */
-    fullPath: string;
-    /** The path of the source file relative to the project root (where the command was invoked). */
-    path: string;
-    /** True if the file being processed is located within the configured library import directory (`config.import.dir`). */
-    isImportedLibrary: boolean;
-    /** The configuration object extracted from the lang tag's options argument (e.g., `{ namespace: 'common', path: 'my.path' }`). */
-    config: LangTagTranslationsConfig;
-}
 type Validity = 'ok' | 'invalid-param-1' | 'invalid-param-2' | 'translations-not-found';
 export interface LangTagCLIProcessedTag {
     fullMatch: string;
@@ -171,6 +161,21 @@ export interface LangTagCLIConflict {
     tagB: LangTagCLITagConflictInfo;
     conflictType: 'path_overwrite' | 'type_mismatch';
 }
+export interface LangTagCLIConfigGenerationEvent {
+    /** The absolute path to the source file being processed. */
+    absolutePath: string;
+    /** The path of the source file relative to the project root (where the command was invoked). */
+    relativePath: string;
+    /** True if the file being processed is located within the configured library import directory (`config.import.dir`). */
+    isImportedLibrary: boolean;
+    /** The configuration object extracted from the lang tag's options argument (e.g., `{ namespace: 'common', path: 'my.path' }`). */
+    config: LangTagTranslationsConfig | undefined;
+    /**
+     * Tells CLI to replace tag configuration
+     * undefined = means configuration will be removed
+     **/
+    save(config: LangTagTranslationsConfig | undefined): void;
+}
 export interface LangTagCLICollectConfigFixEvent {
     config: LangTagTranslationsConfig;
     langTagConfig: LangTagCLIConfig;