@lang-tag/cli 0.11.1 → 0.11.2

package/config.d.ts

@@ -99,9 +99,28 @@ export interface LangTagCLIConfig {
      * Allows dynamic modification of the tag's configuration (namespace, path, etc.)
      * based on the file path or other context.
      *
+     * **IMPORTANT:** The `event.config` object is deeply frozen and immutable. Any attempt
+     * to directly modify it will throw an error. To update the configuration, you must
+     * use `event.save(newConfig)` with a new configuration object.
+     *
      * 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.
+     *
+     * @example
+     * ```ts
+     * onConfigGeneration: async (event) => {
+     *   // ❌ This will throw an error:
+     *   // event.config.namespace = "new-namespace";
+     *
+     *   // ✅ Correct way to update:
+     *   event.save({
+     *     ...event.config,
+     *     namespace: "new-namespace",
+     *     path: "new.path"
+     *   });
+     * }
+     * ```
      */
     onConfigGeneration: (event: LangTagCLIConfigGenerationEvent) => Promise<void>;
     debug?: boolean;
@@ -163,14 +182,19 @@ export interface LangTagCLIConflict {
 }
 export interface LangTagCLIConfigGenerationEvent {
     /** The absolute path to the source file being processed. */
-    absolutePath: string;
+    readonly absolutePath: string;
     /** The path of the source file relative to the project root (where the command was invoked). */
-    relativePath: string;
+    readonly 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;
-    langTagConfig: LangTagCLIConfig;
+    readonly isImportedLibrary: boolean;
+    /**
+     * The configuration object extracted from the lang tag's options argument (e.g., `{ namespace: 'common', path: 'my.path' }`).
+     *
+     * **This object is deeply frozen and immutable.** Any attempt to modify it will throw an error in strict mode.
+     * To update the configuration, use the `save()` method with a new configuration object.
+     */
+    readonly config: Readonly<LangTagTranslationsConfig> | undefined;
+    readonly langTagConfig: LangTagCLIConfig;
     /**
      * Tells CLI to replace tag configuration
      * undefined = means configuration will be removed

package/index.cjs

@@ -168,7 +168,7 @@ class $LT_TagProcessor {
   replaceTags(fileContent, replacements) {
     const replaceMap = /* @__PURE__ */ new Map();
     replacements.forEach((R) => {
-      if (!R.translations && !R.config) {
+      if (!R.translations && !R.config && R.config !== null) {
         throw new Error("Replacement data is required!");
       }
       const tag = R.tag;
@@ -182,7 +182,7 @@ class $LT_TagProcessor {
         throw new Error(`Tag translations are invalid object! Translations: ${newTranslationsString}`);
       }
       let newConfigString = R.config;
-      if (!newConfigString) newConfigString = tag.parameterConfig;
+      if (!newConfigString && newConfigString !== null) newConfigString = tag.parameterConfig;
       if (newConfigString) {
         try {
           if (typeof newConfigString === "string") JSON5.parse(newConfigString);
@@ -426,6 +426,16 @@ function $LT_FilterEmptyNamespaceTags(tags, logger) {
     return true;
   });
 }
+function deepFreezeObject(obj) {
+  const propNames = Object.getOwnPropertyNames(obj);
+  for (const name of propNames) {
+    const value = obj[name];
+    if (value && typeof value === "object") {
+      deepFreezeObject(value);
+    }
+  }
+  return Object.freeze(obj);
+}
 async function checkAndRegenerateFileLangTags(config, logger, file, path$12) {
   let libraryImportsDir = config.import.dir;
   if (!libraryImportsDir.endsWith(path.sep)) libraryImportsDir += path.sep;
@@ -440,14 +450,15 @@ async function checkAndRegenerateFileLangTags(config, logger, file, path$12) {
   for (let tag of tags) {
     let newConfig = void 0;
     let shouldUpdate = false;
+    const frozenConfig = tag.parameterConfig ? deepFreezeObject(tag.parameterConfig) : tag.parameterConfig;
     await config.onConfigGeneration({
       langTagConfig: config,
-      config: tag.parameterConfig,
+      config: frozenConfig,
       absolutePath: file,
       relativePath: path$12,
       isImportedLibrary: path$12.startsWith(libraryImportsDir),
       save: (updatedConfig) => {
-        newConfig = updatedConfig;
+        newConfig = updatedConfig || null;
         shouldUpdate = true;
       }
     });

package/index.js

@@ -148,7 +148,7 @@ class $LT_TagProcessor {
   replaceTags(fileContent, replacements) {
     const replaceMap = /* @__PURE__ */ new Map();
     replacements.forEach((R) => {
-      if (!R.translations && !R.config) {
+      if (!R.translations && !R.config && R.config !== null) {
         throw new Error("Replacement data is required!");
       }
       const tag = R.tag;
@@ -162,7 +162,7 @@ class $LT_TagProcessor {
         throw new Error(`Tag translations are invalid object! Translations: ${newTranslationsString}`);
       }
       let newConfigString = R.config;
-      if (!newConfigString) newConfigString = tag.parameterConfig;
+      if (!newConfigString && newConfigString !== null) newConfigString = tag.parameterConfig;
       if (newConfigString) {
         try {
           if (typeof newConfigString === "string") JSON5.parse(newConfigString);
@@ -406,6 +406,16 @@ function $LT_FilterEmptyNamespaceTags(tags, logger) {
     return true;
   });
 }
+function deepFreezeObject(obj) {
+  const propNames = Object.getOwnPropertyNames(obj);
+  for (const name of propNames) {
+    const value = obj[name];
+    if (value && typeof value === "object") {
+      deepFreezeObject(value);
+    }
+  }
+  return Object.freeze(obj);
+}
 async function checkAndRegenerateFileLangTags(config, logger, file, path2) {
   let libraryImportsDir = config.import.dir;
   if (!libraryImportsDir.endsWith(sep)) libraryImportsDir += sep;
@@ -420,14 +430,15 @@ async function checkAndRegenerateFileLangTags(config, logger, file, path2) {
   for (let tag of tags) {
     let newConfig = void 0;
     let shouldUpdate = false;
+    const frozenConfig = tag.parameterConfig ? deepFreezeObject(tag.parameterConfig) : tag.parameterConfig;
     await config.onConfigGeneration({
       langTagConfig: config,
-      config: tag.parameterConfig,
+      config: frozenConfig,
       absolutePath: file,
       relativePath: path2,
       isImportedLibrary: path2.startsWith(libraryImportsDir),
       save: (updatedConfig) => {
-        newConfig = updatedConfig;
+        newConfig = updatedConfig || null;
         shouldUpdate = true;
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lang-tag/cli",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "type": "module",
   "publishConfig": {
     "access": "public"