@lang-tag/cli 0.18.1 → 0.20.0

package/templates/tag/base-library.mustache

@@ -1,9 +1,9 @@
 {{#isTypeScript}}
 import {
-    CallableTranslations,
-    LangTagTranslations,
-    LangTagTranslationsConfig,
-    PartialFlexibleTranslations,
+    type CallableTranslations,
+    type LangTagTranslations,
+    type LangTagTranslationsConfig,
+    type PartialFlexibleTranslations,
     createCallableTranslations,
     normalizeTranslations,
     lookupTranslation
@@ -17,7 +17,7 @@ import React, {
     createContext,
     useContext,
     useMemo,
-    ReactNode
+    type ReactNode
 } from 'react';
 {{/isReact}}
 

package/templates/tag/placeholder.mustache

@@ -30,8 +30,16 @@ export function processPlaceholders(
         }
 
         const key = placeholder.trim();
-        if (params && key in params) {
-            parts.push(params[key]);
+        const value = params?.[key];
+
+        if (React.isValidElement(value)) {
+            parts.push(value);
+        } else if (
+            typeof value === 'string' ||
+            typeof value === 'number' ||
+            typeof value === 'boolean'
+        ) {
+            parts.push(String(value));
         } else {
             parts.push('');
         }
@@ -49,12 +57,11 @@ export function processPlaceholders(
         return parts.join('');
     }
 
-    return parts.map((part, index) => {
-        if (React.isValidElement(part)) {
-            return React.cloneElement(part, { key: index });
-        }
-        return React.createElement(React.Fragment, { key: index }, part);
-    }){{#isTypeScript}} as unknown as string{{/isTypeScript}};
+    return parts.map((part, index) =>
+        React.isValidElement(part)
+            ? React.cloneElement(part, { key: index })
+            : React.createElement(React.Fragment, { key: index }, part)
+    ){{#isTypeScript}} as unknown as string{{/isTypeScript}};
 }
 {{/isReact}}
 

package/type.d.ts

@@ -40,6 +40,17 @@ export interface LangTagCLIConfig {
      * @default false
      */
     isLibrary: boolean;
+    /**
+     * When true and isLibrary is true, automatically adds "_" prefix to tagName
+     * to prevent the tag from being suggested in TypeScript autocomplete after compilation.
+     * This ensures that library tags remain internal and are not exposed in .d.ts files.
+     * @default true
+     * @example
+     * // With enforceLibraryTagPrefix: true and tagName: "lang"
+     * // Generated tag function will be: export function _lang(...)
+     * // Config tagName also will be automatically set to "_lang"
+     */
+    enforceLibraryTagPrefix?: boolean;
     collect?: {
         /**
          * Translation collector that defines how translation tags are organized into output files.
@@ -134,6 +145,12 @@ export interface LangTagCLIConfig {
      * @default 1
      */
     translationArgPosition: 1 | 2;
+    /**
+     * Directory containing compiled TypeScript declaration files (.d.ts) to remove export modifier.
+     * Used by the `hide-compiled-exports` command to remove exports of lang-tag variables.
+     * @default 'dist'
+     */
+    hideDistDir?: string;
     debug?: boolean;
 }
 type Validity = 'ok' | 'invalid-param-1' | 'invalid-param-2' | 'translations-not-found';
@@ -144,6 +161,8 @@ export interface LangTagCLIProcessedTag {
     parameterTranslations: any;
     parameterConfig?: any;
     variableName?: string;
+    /** Generic type parameter if present (e.g., "ValidationTranslations" from "lang<ValidationTranslations>(...)") */
+    genericType?: string;
     /** Character index in the whole text where the match starts */
     index: number;
     /** Line number (1-based) where the match was found */
@@ -232,6 +251,23 @@ export interface LangTagCLIConfigGenerationEvent {
      * null = means configuration will be removed
      **/
     save(config: LangTagTranslationsConfig | null, triggerName?: string): void;
+    /**
+     * Returns the current configuration object that should be used as a base for modifications.
+     * This method provides a reusable way to get the active configuration:
+     * - If `save()` was called, returns `savedConfig` (a mutable copy)
+     * - Otherwise, returns `config` (a mutable copy)
+     * - If neither exists, returns an empty object `{}`
+     *
+     * The returned object is always a shallow copy, so it can be safely modified.
+     *
+     * @example
+     * ```ts
+     * const currentConfig = event.getCurrentConfig();
+     * currentConfig.namespace = 'new-namespace';
+     * event.save(currentConfig);
+     * ```
+     */
+    getCurrentConfig(): LangTagTranslationsConfig;
 }
 export interface LangTagCLICollectConfigFixEvent {
     config: LangTagTranslationsConfig;