gtx-cli 2.6.18 → 2.6.19

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # gtx-cli
 
+## 2.6.19
+
+### Patch Changes
+
+- [#1014](https://github.com/generaltranslation/gt/pull/1014) [`e421292`](https://github.com/generaltranslation/gt/commit/e421292739807db8696d7912da8b92731fb34b2b) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - refactor: library names
+
+- [#1018](https://github.com/generaltranslation/gt/pull/1018) [`3ac2e30`](https://github.com/generaltranslation/gt/commit/3ac2e30dcd76bf5819f1a385397eb59bcc158732) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - fix: gt-react-native inline tx
+
 ## 2.6.18
 
 ### Patch Changes

package/dist/cli/base.js

@@ -31,6 +31,7 @@ import { detectFramework } from '../setup/detectFramework.js';
 import { getFrameworkDisplayName, getReactFrameworkLibrary, } from '../setup/frameworkUtils.js';
 import { findAgentFiles, findAgentFilesWithInstructions, hasCursorRulesDir, CURSOR_GT_RULES_FILE, getAgentInstructions, appendAgentInstructions, } from '../setup/agentInstructions.js';
 import { determineLibrary } from '../fs/determineFramework.js';
+import { INLINE_LIBRARIES } from '../types/libraries.js';
 export class BaseCLI {
     library;
     additionalModules;
@@ -162,9 +163,7 @@ export class BaseCLI {
             if (!options.keyType) {
                 const packageJson = await searchForPackageJson();
                 if (packageJson &&
-                    (isPackageInstalled('gt-next', packageJson) ||
-                        isPackageInstalled('gt-react', packageJson) ||
-                        isPackageInstalled('gt-node', packageJson))) {
+                    INLINE_LIBRARIES.some((lib) => isPackageInstalled(lib, packageJson))) {
                     options.keyType = 'development';
                 }
                 else {
@@ -298,9 +297,7 @@ export class BaseCLI {
         const packageJson = await searchForPackageJson();
         // Ask if using another i18n library
         const gtInstalled = !!packageJson &&
-            (isPackageInstalled('gt-next', packageJson) ||
-                isPackageInstalled('gt-react', packageJson) ||
-                isPackageInstalled('gt-node', packageJson));
+            INLINE_LIBRARIES.some((lib) => isPackageInstalled(lib, packageJson));
         const isUsingGT = ranReactSetup || gtInstalled;
         // Ask where the translations are stored
         const usingCDN = await (async () => {

package/dist/cli/inline.d.ts

@@ -1,11 +1,12 @@
 import { Command } from 'commander';
 import { BaseCLI } from './base.js';
 import { SupportedLibraries, TranslateFlags, Options } from '../types/index.js';
+import { InlineLibrary } from '../types/libraries.js';
 /**
  * Stand in for a CLI tool that does any sort of inline content translations
  */
 export declare class InlineCLI extends BaseCLI {
-    constructor(command: Command, library: 'gt-react' | 'gt-next' | 'gt-node', additionalModules?: SupportedLibraries[]);
+    constructor(command: Command, library: InlineLibrary, additionalModules?: SupportedLibraries[]);
     init(): void;
     protected setupStageCommand(): void;
     protected setupTranslateCommand(): void;

package/dist/cli/inline.js

@@ -12,6 +12,7 @@ import { generateSettings } from '../config/generateSettings.js';
 import { aggregateInlineTranslations } from '../translation/stage.js';
 import { validateConfigExists } from '../config/validateSettings.js';
 import { validateProject } from '../translation/validate.js';
+import { Libraries } from '../types/libraries.js';
 /**
  * Stand in for a CLI tool that does any sort of inline content translations
  */
@@ -122,7 +123,11 @@ export class InlineCLI extends BaseCLI {
     }
 }
 function fallbackToGtReact(library) {
-    return ['gt-next', 'gt-node'].includes(library)
+    return [
+        Libraries.GT_NEXT,
+        Libraries.GT_NODE,
+        Libraries.GT_REACT_NATIVE,
+    ].includes(library)
         ? library
-        : 'gt-react';
+        : Libraries.GT_REACT;
 }

package/dist/cli/next.d.ts

@@ -1,8 +1,9 @@
 import { WrapOptions, SupportedFrameworks, SupportedLibraries } from '../types/index.js';
 import { ReactCLI } from './react.js';
 import { Command } from 'commander';
+import { Libraries } from '../types/libraries.js';
 export declare class NextCLI extends ReactCLI {
-    constructor(command: Command, library: 'gt-next', additionalModules?: SupportedLibraries[]);
+    constructor(command: Command, library: typeof Libraries.GT_NEXT, additionalModules?: SupportedLibraries[]);
     protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
         filesUpdated: string[];
     }>;

package/dist/cli/next.js

@@ -1,6 +1,7 @@
 import { ReactCLI } from './react.js';
 import { wrapContentNext } from '../next/parse/wrapContent.js';
-const pkg = 'gt-next';
+import { Libraries } from '../types/libraries.js';
+const pkg = Libraries.GT_NEXT;
 export class NextCLI extends ReactCLI {
     constructor(command, library, additionalModules) {
         super(command, library, additionalModules);

package/dist/cli/node.d.ts

@@ -1,9 +1,10 @@
 import { Command } from 'commander';
 import { SupportedLibraries } from '../types/index.js';
 import { InlineCLI } from './inline.js';
+import { Libraries } from '../types/libraries.js';
 /**
  * CLI tool for managing translations with gt-node
  */
 export declare class NodeCLI extends InlineCLI {
-    constructor(command: Command, library: 'gt-node', additionalModules?: SupportedLibraries[]);
+    constructor(command: Command, library: typeof Libraries.GT_NODE, additionalModules?: SupportedLibraries[]);
 }

package/dist/cli/react.d.ts

@@ -1,8 +1,8 @@
 import { Command } from 'commander';
-import { SupportedFrameworks, WrapOptions, SupportedLibraries } from '../types/index.js';
+import { Framework, SupportedFrameworks, WrapOptions, SupportedLibraries } from '../types/index.js';
 import { InlineCLI } from './inline.js';
 export declare class ReactCLI extends InlineCLI {
-    constructor(command: Command, library: 'gt-react' | 'gt-next', additionalModules?: SupportedLibraries[]);
+    constructor(command: Command, library: Framework, additionalModules?: SupportedLibraries[]);
     init(): void;
     protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
         filesUpdated: string[];

package/dist/cli/react.js

@@ -6,7 +6,8 @@ import { wrapContentReact } from '../react/parse/wrapContent.js';
 import { generateSettings } from '../config/generateSettings.js';
 import { attachInlineTranslateFlags, attachTranslateFlags } from './flags.js';
 import { InlineCLI } from './inline.js';
-const pkg = 'gt-react';
+import { Libraries } from '../types/libraries.js';
+const pkg = Libraries.GT_REACT;
 export class ReactCLI extends InlineCLI {
     constructor(command, library, additionalModules) {
         super(command, library, additionalModules);

package/dist/formats/files/collectFiles.js

@@ -4,14 +4,13 @@ import { aggregateFiles } from '../../formats/files/translate.js';
 import { aggregateInlineTranslations } from '../../translation/stage.js';
 import { hashStringSync } from '../../utils/hash.js';
 import { TEMPLATE_FILE_NAME, TEMPLATE_FILE_ID } from '../../utils/constants.js';
+import { isInlineLibrary } from '../../types/libraries.js';
 export async function collectFiles(options, settings, library) {
     // Aggregate files
     const allFiles = await aggregateFiles(settings);
     // Parse for React components
     let reactComponents = 0;
-    if (library === 'gt-react' ||
-        library === 'gt-next' ||
-        library === 'gt-node') {
+    if (isInlineLibrary(library)) {
         const updates = await aggregateInlineTranslations(options, settings, library);
         if (updates.length > 0) {
             if (!settings.publish && !settings.files?.placeholderPaths.gt) {

package/dist/fs/determineFramework.js

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import path from 'node:path';
 import fs from 'node:fs';
 import { logger } from '../console/logger.js';
+import { Libraries } from '../types/libraries.js';
 export function determineLibrary() {
     let library = 'base';
     const additionalModules = [];
@@ -21,14 +22,17 @@ export function determineLibrary() {
             ...packageJson.devDependencies,
         };
         // Check for gt-next or gt-react in dependencies
-        if (dependencies['gt-next']) {
-            library = 'gt-next';
+        if (dependencies[Libraries.GT_NEXT]) {
+            library = Libraries.GT_NEXT;
         }
-        else if (dependencies['gt-react']) {
-            library = 'gt-react';
+        else if (dependencies[Libraries.GT_REACT]) {
+            library = Libraries.GT_REACT;
         }
-        else if (dependencies['gt-node']) {
-            library = 'gt-node';
+        else if (dependencies[Libraries.GT_REACT_NATIVE]) {
+            library = Libraries.GT_REACT_NATIVE;
+        }
+        else if (dependencies[Libraries.GT_NODE]) {
+            library = Libraries.GT_NODE;
         }
         else if (dependencies['next-intl']) {
             library = 'next-intl';

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.6.18";
+export declare const PACKAGE_VERSION = "2.6.19";

package/dist/generated/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated. Do not edit manually.
-export const PACKAGE_VERSION = '2.6.18';
+export const PACKAGE_VERSION = '2.6.19';

package/dist/index.js

@@ -3,17 +3,19 @@ import { NextCLI } from './cli/next.js';
 import { ReactCLI } from './cli/react.js';
 import { determineLibrary } from './fs/determineFramework.js';
 import { NodeCLI } from './cli/node.js';
+import { Libraries } from './types/libraries.js';
 export function main(program) {
     program.name('gtx-cli');
     const { library, additionalModules } = determineLibrary();
     let cli;
-    if (library === 'gt-next') {
+    if (library === Libraries.GT_NEXT) {
         cli = new NextCLI(program, library, additionalModules);
     }
-    else if (library === 'gt-react') {
+    else if (library === Libraries.GT_REACT ||
+        library === Libraries.GT_REACT_NATIVE) {
         cli = new ReactCLI(program, library, additionalModules);
     }
-    else if (library === 'gt-node') {
+    else if (library === Libraries.GT_NODE) {
         cli = new NodeCLI(program, library, additionalModules);
     }
     else {

package/dist/next/parse/wrapContent.d.ts

@@ -1,4 +1,5 @@
 import { WrapOptions } from '../../types/index.js';
+import { Libraries } from '../../types/libraries.js';
 /**
  * Wraps all JSX elements in the src directory with a <T> tag, with unique ids.
  * - Ignores pure strings
@@ -6,6 +7,6 @@ import { WrapOptions } from '../../types/index.js';
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-export declare function wrapContentNext(options: WrapOptions, pkg: 'gt-next', errors: string[], warnings: string[]): Promise<{
+export declare function wrapContentNext(options: WrapOptions, pkg: typeof Libraries.GT_NEXT, errors: string[], warnings: string[]): Promise<{
     filesUpdated: string[];
 }>;

package/dist/next/parse/wrapContent.js

@@ -13,13 +13,14 @@ import { isHtmlElement, isBodyElement, hasGTProviderChild, addDynamicLangAttribu
 import { generateImportMap, createImports, } from '../../react/jsx/utils/parseAst.js';
 import { matchFiles } from '../../fs/matchFiles.js';
 import { DEFAULT_SRC_PATTERNS } from '../../config/generateSettings.js';
+import { Libraries } from '../../types/libraries.js';
 const IMPORT_MAP = {
-    T: { name: 'T', source: 'gt-next' },
-    Var: { name: 'Var', source: 'gt-next' },
-    GTT: { name: 'T', source: 'gt-next' },
-    GTVar: { name: 'Var', source: 'gt-next' },
-    GTProvider: { name: 'GTProvider', source: 'gt-next' },
-    getLocale: { name: 'getLocale', source: 'gt-next/server' },
+    T: { name: 'T', source: Libraries.GT_NEXT },
+    Var: { name: 'Var', source: Libraries.GT_NEXT },
+    GTT: { name: 'T', source: Libraries.GT_NEXT },
+    GTVar: { name: 'Var', source: Libraries.GT_NEXT },
+    GTProvider: { name: 'GTProvider', source: Libraries.GT_NEXT },
+    getLocale: { name: 'getLocale', source: Libraries.GT_NEXT + '/server' },
 };
 /**
  * Wraps all JSX elements in the src directory with a <T> tag, with unique ids.
@@ -58,7 +59,7 @@ export async function wrapContentNext(options, pkg, errors, warnings) {
         let globalId = 0;
         traverse(ast, {
             JSXElement(path) {
-                if (pkg === 'gt-next' &&
+                if (pkg === Libraries.GT_NEXT &&
                     options.addGTProvider &&
                     isHtmlElement(path.node.openingElement)) {
                     // Find the body element recursively in the HTML tree

package/dist/react/jsx/utils/constants.d.ts

@@ -11,14 +11,3 @@ export declare const GT_TRANSLATION_FUNCS: string[];
 export declare const VARIABLE_COMPONENTS: string[];
 export declare const GT_ATTRIBUTES_WITH_SUGAR: readonly ["$id", "$context", "$maxChars"];
 export declare const GT_ATTRIBUTES: readonly ["id", "context", "maxChars", "$id", "$context", "$maxChars"];
-export declare function mapAttributeName(attrName: string): string;
-export declare const GT_LIBRARIES: readonly ["gt-react", "gt-next", "gt-react-native", "gt-node", "gt-i18n", "@generaltranslation/react-core"];
-export type GTLibrary = (typeof GT_LIBRARIES)[number];
-/**
- * GT Libraries that use react translations
- */
-export type GTReactLibrary = 'gt-react' | 'gt-react-native' | 'gt-next' | '@generaltranslation/react-core';
-/**
- * A mapping of each library to their upstream dependencies for filtering imports
- */
-export declare const GT_LIBRARIES_UPSTREAM: Record<GTLibrary, GTLibrary[]>;

package/dist/react/jsx/utils/constants.js

@@ -44,49 +44,3 @@ export const GT_ATTRIBUTES = [
     'maxChars',
     ...GT_ATTRIBUTES_WITH_SUGAR,
 ];
-export function mapAttributeName(attrName) {
-    if (attrName === '$id')
-        return 'id';
-    if (attrName === '$context')
-        return 'context';
-    if (attrName === '$maxChars')
-        return 'maxChars';
-    return attrName;
-}
-export const GT_LIBRARIES = [
-    'gt-react',
-    'gt-next',
-    'gt-react-native',
-    'gt-node',
-    'gt-i18n',
-    '@generaltranslation/react-core',
-];
-/**
- * A mapping of each library to their upstream dependencies for filtering imports
- */
-export const GT_LIBRARIES_UPSTREAM = {
-    'gt-next': [
-        'gt-i18n',
-        '@generaltranslation/react-core',
-        'gt-react',
-        'gt-next',
-    ],
-    'gt-react': [
-        'gt-i18n',
-        '@generaltranslation/react-core',
-        'gt-react',
-        'gt-react-native', // allow for cross-library compatibility (gt-react/gt-react-native only)
-    ],
-    'gt-react-native': [
-        'gt-i18n',
-        '@generaltranslation/react-core',
-        'gt-react-native',
-        'gt-react', // allow for cross-library compatibility (gt-react/gt-react-native only)
-    ],
-    'gt-node': ['gt-i18n', '@generaltranslation/react-core', 'gt-node'],
-    '@generaltranslation/react-core': [
-        'gt-i18n',
-        '@generaltranslation/react-core',
-    ],
-    'gt-i18n': ['gt-i18n'],
-};

package/dist/react/jsx/utils/getPathsAndAliases.d.ts

@@ -1,5 +1,5 @@
 import { NodePath } from '@babel/traverse';
-import { GTLibrary } from '../../jsx/utils/constants.js';
+import { GTLibrary } from '../../../types/libraries.js';
 /**
  * Constructs tracking for gt related variables of interest
  * inlineTranslationPaths: these are string-related translation functions

package/dist/react/jsx/utils/jsxParsing/parseJsx.d.ts

@@ -1,7 +1,7 @@
 import { Updates } from '../../../../types/index.js';
 import { ParsingConfigOptions } from '../../../../types/parsing.js';
 import traverseModule from '@babel/traverse';
-import { GTLibrary } from '../constants.js';
+import { GTLibrary } from '../../../../types/libraries.js';
 /**
  * Immutable configuration options for parsing.
  */

package/dist/react/jsx/utils/jsxParsing/parseTProps.js

@@ -2,7 +2,8 @@ import * as t from '@babel/types';
 import generateModule from '@babel/generator';
 // Handle CommonJS/ESM interop
 const generate = generateModule.default || generateModule;
-import { GT_ATTRIBUTES, mapAttributeName } from '../constants.js';
+import { GT_ATTRIBUTES } from '../constants.js';
+import { mapAttributeName } from '../mapAttributeName.js';
 import { isStaticExpression } from '../../evaluateJsx.js';
 import { warnInvalidMaxCharsSync, warnVariablePropSync, } from '../../../../console/index.js';
 import { isNumberLiteral } from '../isNumberLiteral.js';

package/dist/react/jsx/utils/mapAttributeName.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Map the attribute name to the corresponding attribute name in the metadata
+ * @param attrName - The attribute name to map
+ * @returns The mapped attribute name
+ */
+export declare function mapAttributeName(attrName: string): string;

package/dist/react/jsx/utils/mapAttributeName.js

@@ -0,0 +1,14 @@
+/**
+ * Map the attribute name to the corresponding attribute name in the metadata
+ * @param attrName - The attribute name to map
+ * @returns The mapped attribute name
+ */
+export function mapAttributeName(attrName) {
+    if (attrName === '$id')
+        return 'id';
+    if (attrName === '$context')
+        return 'context';
+    if (attrName === '$maxChars')
+        return 'maxChars';
+    return attrName;
+}

package/dist/react/jsx/utils/parseAst.d.ts

@@ -1,7 +1,7 @@
 import * as t from '@babel/types';
 import { ParseResult } from '@babel/parser';
 import { ImportDeclaration, VariableDeclaration } from '@babel/types';
-import { GTLibrary } from './constants.js';
+import { GTLibrary } from '../../../types/libraries.js';
 export declare function determineModuleType(ast: ParseResult<t.File>): boolean;
 export type ImportItem = string | {
     local: string;

package/dist/react/jsx/utils/parseString.js

@@ -5,7 +5,8 @@ import { parse } from '@babel/parser';
 import fs from 'node:fs';
 import { warnDeclareStaticNoResultsSync, warnFunctionNotFoundSync, warnInvalidDeclareVarNameSync, } from '../../../console/index.js';
 import traverseModule from '@babel/traverse';
-import { DECLARE_VAR_FUNCTION, GT_LIBRARIES } from './constants.js';
+import { DECLARE_VAR_FUNCTION } from '../../jsx/utils/constants.js';
+import { GT_LIBRARIES } from '../../../types/libraries.js';
 import { declareVar } from 'generaltranslation/internal';
 import { isStaticExpression } from '../evaluateJsx.js';
 import generateModule from '@babel/generator';

package/dist/react/jsx/utils/parseStringFunction.js

@@ -1,6 +1,7 @@
 import * as t from '@babel/types';
 import { isStaticExpression, isValidIcu } from '../evaluateJsx.js';
-import { GT_ATTRIBUTES_WITH_SUGAR, MSG_REGISTRATION_FUNCTION, INLINE_TRANSLATION_HOOK, INLINE_TRANSLATION_HOOK_ASYNC, mapAttributeName, INLINE_MESSAGE_HOOK, INLINE_MESSAGE_HOOK_ASYNC, } from './constants.js';
+import { GT_ATTRIBUTES_WITH_SUGAR, MSG_REGISTRATION_FUNCTION, INLINE_TRANSLATION_HOOK, INLINE_TRANSLATION_HOOK_ASYNC, INLINE_MESSAGE_HOOK, INLINE_MESSAGE_HOOK_ASYNC, } from './constants.js';
+import { mapAttributeName } from './mapAttributeName.js';
 import { warnNonStaticExpressionSync, warnNonStringSync, warnTemplateLiteralSync, warnAsyncUseGT, warnSyncGetGT, warnInvalidIcuSync, warnInvalidMaxCharsSync, } from '../../../console/index.js';
 import generateModule from '@babel/generator';
 import traverseModule from '@babel/traverse';

package/dist/react/parse/createInlineUpdates.d.ts

@@ -1,6 +1,6 @@
 import { Updates } from '../../types/index.js';
 import type { ParsingConfigOptions } from '../../types/parsing.js';
-import { GTLibrary } from '../jsx/utils/constants.js';
+import { GTLibrary } from '../../types/libraries.js';
 export declare function createInlineUpdates(pkg: GTLibrary, validate: boolean, filePatterns: string[] | undefined, parsingOptions: ParsingConfigOptions): Promise<{
     updates: Updates;
     errors: string[];

package/dist/react/parse/createInlineUpdates.js

@@ -7,7 +7,7 @@ import { logger } from '../../console/logger.js';
 import { matchFiles } from '../../fs/matchFiles.js';
 import { DEFAULT_SRC_PATTERNS } from '../../config/generateSettings.js';
 import { getPathsAndAliases } from '../jsx/utils/getPathsAndAliases.js';
-import { GT_LIBRARIES_UPSTREAM } from '../jsx/utils/constants.js';
+import { GT_LIBRARIES_UPSTREAM, REACT_LIBRARIES, } from '../../types/libraries.js';
 export async function createInlineUpdates(pkg, validate, filePatterns, parsingOptions) {
     const updates = [];
     const errors = [];
@@ -41,7 +41,7 @@ export async function createInlineUpdates(pkg, validate, filePatterns, parsingOp
             }, { updates, errors, warnings });
         }
         // Parse <T> components
-        if (pkg !== 'gt-node') {
+        if (REACT_LIBRARIES.includes(pkg)) {
             for (const { localName, path } of translationComponentPaths) {
                 parseTranslationComponent({
                     originalName: localName,

package/dist/react/parse/wrapContent.d.ts

@@ -1,4 +1,5 @@
 import { SupportedFrameworks, WrapOptions } from '../../types/index.js';
+import { Libraries } from '../../types/libraries.js';
 /**
  * Wraps all JSX elements in the src directory with a <T> tag, with unique ids.
  * - Ignores pure strings
@@ -6,6 +7,6 @@ import { SupportedFrameworks, WrapOptions } from '../../types/index.js';
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-export declare function wrapContentReact(options: WrapOptions, pkg: 'gt-react', framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+export declare function wrapContentReact(options: WrapOptions, pkg: typeof Libraries.GT_REACT, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
     filesUpdated: string[];
 }>;

package/dist/react/parse/wrapContent.js

@@ -13,13 +13,13 @@ import { getRelativePath } from '../../fs/findFilepath.js';
 import { generateImportMap, createImports, } from '../jsx/utils/parseAst.js';
 import { DEFAULT_SRC_PATTERNS } from '../../config/generateSettings.js';
 import { matchFiles } from '../../fs/matchFiles.js';
+import { Libraries } from '../../types/libraries.js';
 const IMPORT_MAP = {
-    T: { name: 'T', source: 'gt-react' },
-    Var: { name: 'Var', source: 'gt-react' },
-    GTT: { name: 'T', source: 'gt-react' },
-    GTVar: { name: 'Var', source: 'gt-react' },
-    GTProvider: { name: 'GTProvider', source: 'gt-react' },
-    // getLocale: { name: 'getLocale', source: 'gt-react/server' },
+    T: { name: 'T', source: Libraries.GT_REACT },
+    Var: { name: 'Var', source: Libraries.GT_REACT },
+    GTT: { name: 'T', source: Libraries.GT_REACT },
+    GTVar: { name: 'Var', source: Libraries.GT_REACT },
+    GTProvider: { name: 'GTProvider', source: Libraries.GT_REACT },
 };
 /**
  * Wraps all JSX elements in the src directory with a <T> tag, with unique ids.

package/dist/setup/agentInstructions.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { getCLIVersion, getPackageVersion } from '../utils/packageJson.js';
+import { Libraries } from '../types/libraries.js';
 const INSTRUCTIONS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), 'instructions');
 const AGENT_FILE_PATHS = [
     'CLAUDE.md',
@@ -75,8 +76,10 @@ export function getAgentInstructions(library) {
     const base = fs.readFileSync(path.join(INSTRUCTIONS_DIR, 'base.md'), 'utf8');
     let body = '';
     const libToFile = {
-        'gt-next': 'gt-next.md',
-        'gt-react': 'gt-react.md',
+        [Libraries.GT_NEXT]: 'gt-next.md',
+        [Libraries.GT_REACT]: 'gt-react.md',
+        // TODO: add gt-react-native.md
+        [Libraries.GT_REACT_NATIVE]: 'gt-react.md',
     };
     const instructionFile = libToFile[library];
     if (instructionFile) {

package/dist/setup/frameworkUtils.js

@@ -1,3 +1,4 @@
+import { Libraries } from '../types/libraries.js';
 export function getFrameworkDisplayName(frameworkObject) {
     if (frameworkObject.name === 'mintlify') {
         return 'Mintlify';
@@ -23,5 +24,7 @@ export function getFrameworkDisplayName(frameworkObject) {
     return 'another framework';
 }
 export function getReactFrameworkLibrary(frameworkObject) {
-    return frameworkObject.name === 'next-app' ? 'gt-next' : 'gt-react';
+    return frameworkObject.name === 'next-app'
+        ? Libraries.GT_NEXT
+        : Libraries.GT_REACT;
 }

package/dist/setup/instructions/base.md

@@ -1,8 +1,8 @@
-## General Translation (GT) Internationalization Rules
+# General Translation (GT) Internationalization Rules
 
 This project is using [General Translation](https://generaltranslation.com/docs/overview.md) for internationalization (i18n) and translations. General Translation is a developer-first localization stack, built for the world's best engineering teams to ship apps in every language with ease.
 
-### Configuration
+## Configuration
 
 The General Translation configuration file is called `gt.config.json`. It is usually located in the root or src directory of a project.
 
@@ -18,12 +18,12 @@ The General Translation configuration file is called `gt.config.json`. It is usu
 }
 ```
 
-The API reference for the config file can be found at https://generaltranslation.com/docs/cli/reference/config.md.
+The API reference for the config file can be found at <https://generaltranslation.com/docs/cli/reference/config.md>.
 
-### Translation
+## Translation
 
 Run `npx gtx-cli translate` to create translation files for your project. You must have an API key to do this.
 
-### Documentation 
+## Documentation
 
-https://generaltranslation.com/llms.txt
+<https://generaltranslation.com/llms.txt>

package/dist/setup/instructions/gt-next.md

@@ -1,14 +1,14 @@
-### gt-next
+# gt-next
 
 This project is using the `gt-next` internationalization library for Next.js App Router.
 
-### gt-next setup
+## gt-next setup
 
 - `GTProvider` must wrap the app in the root layout to provide translation context.
 - The `withGTConfig()` plugin wraps `next.config` in the Next.js config file.
 - (optional) `createNextMiddleware()` is used in `proxy.ts` for automatic locale routing.
 
-### Translating JSX 
+## Translating JSX
 
 `gt-next` uses the `<T>` component for translation.
 
@@ -26,7 +26,7 @@ import { T } from 'gt-next';
 </T>;
 ```
 
-You can also add a `context` prop to `<T>` to give context to the translator. For example: 
+You can also add a `context` prop to `<T>` to give context to the translator. For example:
 
 ```jsx
 import { T } from 'gt-next';
@@ -36,7 +36,7 @@ import { T } from 'gt-next';
 </T>;
 ```
 
-### Translating simple strings
+## Translating simple strings
 
 Use the `gt` function returned by the `useGT()` hook to translate strings directly. Invoke `useGT()` in synchronous components or `await getGT()` in async components only.
 
@@ -54,9 +54,9 @@ gt('Hello, world!');
 
 - Just like with the children of the `<T>` component, all strings passed to `gt()` must be static string literals. No variables or template literals.
 
-### Translating shared or out-of-scope strings
+## Translating shared or out-of-scope strings
 
-Use `msg()` to register strings for translation, and `useMessages()` to translate them. `const m = useMessages()` should be used equivalently to `const gt = useGT()`. 
+Use `msg()` to register strings for translation, and `useMessages()` to translate them. `const m = useMessages()` should be used equivalently to `const gt = useGT()`.
 
 ```js
 import { msg, useMessages } from 'gt-next';
@@ -73,7 +73,7 @@ export default function Greeting() {
 - Use the equivalent `await getMessages()` for async components.
 - `useMessages()` / `getMessages()` take no arguments.
 
-### Dynamic content inside `<T>`
+## Dynamic content inside `<T>`
 
 Use variable components for dynamic values inside `<T>`:
 
@@ -90,9 +90,9 @@ import { T, Var, Num } from 'gt-next';
 </T>;
 ```
 
-### Utility hooks
+## Utility hooks
 
-#### `useLocale()`
+### `useLocale()`
 
 `useLocale` returns the user's current language, as a BCP 47 locale tag.
 
@@ -102,6 +102,6 @@ import { useLocale } from 'gt-next'
 const locale = useLocale(); // "en-US"
 ```
 
-### Quickstart
+## Quickstart
 
-See https://generaltranslation.com/docs/next.md
+See <https://generaltranslation.com/docs/next.md>

package/dist/setup/instructions/gt-react.md

@@ -1,12 +1,12 @@
-### gt-react
+# gt-react
 
 This project is using the `gt-react` internationalization library.
 
-### gt-react setup
+## gt-react setup
 
 - `GTProvider` must wrap the app in the root layout to provide translation context.
 
-### Translating JSX 
+## Translating JSX
 
 `gt-react` uses the `<T>` component for translation.
 
@@ -24,7 +24,7 @@ import { T } from 'gt-react';
 </T>;
 ```
 
-You can also add a `context` prop to `<T>` to give context to the translator. For example: 
+You can also add a `context` prop to `<T>` to give context to the translator. For example:
 
 ```jsx
 import { T } from 'gt-react';
@@ -34,7 +34,7 @@ import { T } from 'gt-react';
 </T>;
 ```
 
-### Translating simple strings
+## Translating simple strings
 
 Use the `gt` function returned by the `useGT()` hook to translate strings directly.
 
@@ -46,9 +46,9 @@ gt('Hello, world!'); // returns "Hola, mundo"
 
 - Just like with the children of the `<T>` component, all strings passed to `gt()` must be static string literals. No variables or template literals.
 
-### Translating shared or out-of-scope strings
+## Translating shared or out-of-scope strings
 
-Use `msg()` to register strings for translation, and `useMessages()` to translate them. `const m = useMessages()` should be used equivalently to `const gt = useGT()`. 
+Use `msg()` to register strings for translation, and `useMessages()` to translate them. `const m = useMessages()` should be used equivalently to `const gt = useGT()`.
 
 ```js
 import { msg, useMessages } from 'gt-react';
@@ -64,7 +64,7 @@ export default function Greeting() {
 - All strings passed to `msg()` must be static string literals. No variables or template literals.
 - `useMessages()` / `getMessages()` take no arguments.
 
-### Dynamic content inside `<T>`
+## Dynamic content inside `<T>`
 
 Use variable components for dynamic values inside `<T>`:
 
@@ -81,9 +81,9 @@ import { T, Var, Num } from 'gt-react';
 </T>;
 ```
 
-### Utility hooks
+## Utility hooks
 
-#### `useLocale()`
+### `useLocale()`
 
 `useLocale` returns the user's current language, as a BCP 47 locale tag.
 
@@ -93,6 +93,6 @@ import { useLocale } from 'gt-react'
 const locale = useLocale(); // "en-US"
 ```
 
-### Quickstart
+## Quickstart
 
-See https://generaltranslation.com/docs/react.md
+See <https://generaltranslation.com/docs/react.md>

package/dist/setup/wizard.js

@@ -15,6 +15,7 @@ import { loadConfig } from '../fs/config/loadConfig.js';
 import { addVitePlugin } from '../react/parse/addVitePlugin/index.js';
 import { exitSync } from '../console/logging.js';
 import { getFrameworkDisplayName } from './frameworkUtils.js';
+import { Libraries } from '../types/libraries.js';
 export async function handleSetupReactCommand(options, frameworkObject, useDefaults = false) {
     const frameworkDisplayName = getFrameworkDisplayName(frameworkObject);
     // Ask user for confirmation using inquirer
@@ -62,20 +63,20 @@ Please let us know what you would like to see added at https://github.com/genera
     }
     // Check if gt-next or gt-react is installed
     if (frameworkType === 'next-app' &&
-        !isPackageInstalled('gt-next', packageJson)) {
+        !isPackageInstalled(Libraries.GT_NEXT, packageJson)) {
         const packageManager = await getPackageManager();
         const spinner = logger.createSpinner('timer');
-        spinner.start(`Installing gt-next with ${packageManager.name}...`);
-        await installPackage('gt-next', packageManager);
-        spinner.stop(chalk.green('Automatically installed gt-next.'));
+        spinner.start(`Installing ${Libraries.GT_NEXT} with ${packageManager.name}...`);
+        await installPackage(Libraries.GT_NEXT, packageManager);
+        spinner.stop(chalk.green(`Automatically installed ${Libraries.GT_NEXT}.`));
     }
     else if (['next-pages', 'react', 'redwood', 'vite', 'gatsby'].includes(frameworkType) &&
-        !isPackageInstalled('gt-react', packageJson)) {
+        !isPackageInstalled(Libraries.GT_REACT, packageJson)) {
         const packageManager = await getPackageManager();
         const spinner = logger.createSpinner('timer');
-        spinner.start(`Installing gt-react with ${packageManager.name}...`);
-        await installPackage('gt-react', packageManager);
-        spinner.stop(chalk.green('Automatically installed gt-react.'));
+        spinner.start(`Installing ${Libraries.GT_REACT} with ${packageManager.name}...`);
+        await installPackage(Libraries.GT_REACT, packageManager);
+        spinner.stop(chalk.green(`Automatically installed ${Libraries.GT_REACT}.`));
     }
     const errors = [];
     const warnings = [];
@@ -105,7 +106,7 @@ Please let us know what you would like to see added at https://github.com/genera
         const spinner = logger.createSpinner();
         spinner.start('Wrapping JSX content with <T> tags...');
         // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
-        const { filesUpdated: filesUpdatedNext } = await wrapContentNext(mergeOptions, 'gt-next', errors, warnings);
+        const { filesUpdated: filesUpdatedNext } = await wrapContentNext(mergeOptions, Libraries.GT_NEXT, errors, warnings);
         filesUpdated = [...filesUpdated, ...filesUpdatedNext];
         spinner.stop(chalk.green(`Success! Updated ${chalk.bold.cyan(filesUpdated.length)} files:\n`) + filesUpdated.map((file) => `${chalk.green('-')} ${file}`).join('\n'));
         // Add the withGTConfig() function to the next.config.js file

package/dist/translation/parse.d.ts

@@ -1,5 +1,6 @@
 import { Updates, TranslateFlags } from '../types/index.js';
 import type { ParsingConfigOptions } from '../types/parsing.js';
+import { InlineLibrary } from '../types/libraries.js';
 /**
  * Searches for gt-react or gt-next dictionary files and creates updates for them,
  * as well as inline updates for <T> tags and useGT()/getGT() calls
@@ -9,7 +10,7 @@ import type { ParsingConfigOptions } from '../types/parsing.js';
  * @param pkg - The package name
  * @returns An object containing the updates and errors
  */
-export declare function createUpdates(options: TranslateFlags, src: string[] | undefined, sourceDictionary: string | undefined, pkg: 'gt-react' | 'gt-next' | 'gt-node', validate: boolean, parsingOptions: ParsingConfigOptions): Promise<{
+export declare function createUpdates(options: TranslateFlags, src: string[] | undefined, sourceDictionary: string | undefined, pkg: InlineLibrary, validate: boolean, parsingOptions: ParsingConfigOptions): Promise<{
     updates: Updates;
     errors: string[];
     warnings: string[];

package/dist/translation/stage.d.ts

@@ -1,2 +1,3 @@
 import { Settings, TranslateFlags, Updates } from '../types/index.js';
-export declare function aggregateInlineTranslations(options: TranslateFlags, settings: Settings, library: 'gt-react' | 'gt-next' | 'gt-node'): Promise<Updates>;
+import { InlineLibrary } from '../types/libraries.js';
+export declare function aggregateInlineTranslations(options: TranslateFlags, settings: Settings, library: InlineLibrary): Promise<Updates>;

package/dist/translation/validate.d.ts

@@ -1,4 +1,5 @@
-import { Options, Settings } from '../types/index.js';
+import { Framework, Options, Settings } from '../types/index.js';
+import { InlineLibrary } from '../types/libraries.js';
 export type ValidationLevel = 'error' | 'warning';
 export type ValidationMessage = {
     level: ValidationLevel;
@@ -9,5 +10,5 @@ export type ValidationResult = Record<string, ValidationMessage[]>;
  * Programmatic API for validation - returns structured results instead of logging/exiting.
  * Equivalent to running `gtx-cli validate` but returns data.
  */
-export declare function getValidateJson(settings: Options & Settings, pkg: 'gt-react' | 'gt-next', files?: string[]): Promise<ValidationResult>;
-export declare function validateProject(settings: Options & Settings, pkg: 'gt-react' | 'gt-next' | 'gt-node', files?: string[]): Promise<void>;
+export declare function getValidateJson(settings: Options & Settings, pkg: Framework, files?: string[]): Promise<ValidationResult>;
+export declare function validateProject(settings: Options & Settings, pkg: InlineLibrary, files?: string[]): Promise<void>;

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 import { CustomMapping } from 'generaltranslation/types';
 import { SUPPORTED_FILE_EXTENSIONS } from '../formats/files/supportedFiles.js';
 import { ParsingConfigOptions } from './parsing.js';
+import { Libraries, InlineLibrary } from './libraries.js';
 export type { Updates } from 'generaltranslation/types';
 export type Options = {
     config: string;
@@ -95,7 +96,7 @@ export type GenerateSourceOptions = {
     ignoreErrors: boolean;
     suppressWarnings: boolean;
 };
-export type Framework = 'gt-next' | 'gt-react';
+export type Framework = typeof Libraries.GT_NEXT | typeof Libraries.GT_REACT | typeof Libraries.GT_REACT_NATIVE;
 export type FrameworkObject = {
     name: 'mintlify';
     type?: undefined;
@@ -111,7 +112,7 @@ export type SupportedFrameworks = FrameworkObject['name'];
 export type SupportedReactFrameworks = Extract<FrameworkObject, {
     type: 'react';
 }>['name'];
-export type SupportedLibraries = 'gt-next' | 'gt-react' | 'next-intl' | 'react-i18next' | 'next-i18next' | 'i18next' | 'i18next-icu' | 'gt-node' | 'base';
+export type SupportedLibraries = InlineLibrary | 'next-intl' | 'react-i18next' | 'next-i18next' | 'i18next' | 'i18next-icu' | 'base';
 export interface ContentScanner {
     scanForContent(options: WrapOptions, framework: Framework): Promise<{
         errors: string[];

package/dist/types/libraries.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A list of all the libraries names supported by the CLI
+ */
+export declare enum Libraries {
+    GT_REACT = "gt-react",
+    GT_NEXT = "gt-next",
+    GT_REACT_NATIVE = "gt-react-native",
+    GT_NODE = "gt-node",
+    GT_I18N = "gt-i18n",
+    GT_REACT_CORE = "@generaltranslation/react-core"
+}
+/**
+ * A list of all the libraries that support the CLI
+ */
+export declare const GT_LIBRARIES: readonly [Libraries.GT_REACT, Libraries.GT_NEXT, Libraries.GT_REACT_NATIVE, Libraries.GT_NODE, Libraries.GT_I18N, Libraries.GT_REACT_CORE];
+export type GTLibrary = (typeof GT_LIBRARIES)[number];
+/**
+ * Libraries that support inline translation
+ */
+export declare const INLINE_LIBRARIES: readonly [Libraries.GT_REACT, Libraries.GT_NEXT, Libraries.GT_NODE, Libraries.GT_REACT_NATIVE, Libraries.GT_REACT_CORE, Libraries.GT_I18N];
+export type InlineLibrary = (typeof INLINE_LIBRARIES)[number];
+export declare function isInlineLibrary(lib: string): lib is InlineLibrary;
+/**
+ * Libraries that support react primitives
+ */
+export declare const REACT_LIBRARIES: readonly [Libraries.GT_NEXT, Libraries.GT_REACT, Libraries.GT_REACT_NATIVE, Libraries.GT_REACT_CORE];
+export type ReactLibrary = (typeof REACT_LIBRARIES)[number];
+/**
+ * A mapping of each library to their upstream dependencies for filtering imports
+ */
+export declare const GT_LIBRARIES_UPSTREAM: Record<GTLibrary, GTLibrary[]>;

package/dist/types/libraries.js

@@ -0,0 +1,72 @@
+/**
+ * A list of all the libraries names supported by the CLI
+ */
+export var Libraries;
+(function (Libraries) {
+    Libraries["GT_REACT"] = "gt-react";
+    Libraries["GT_NEXT"] = "gt-next";
+    Libraries["GT_REACT_NATIVE"] = "gt-react-native";
+    Libraries["GT_NODE"] = "gt-node";
+    Libraries["GT_I18N"] = "gt-i18n";
+    Libraries["GT_REACT_CORE"] = "@generaltranslation/react-core";
+})(Libraries || (Libraries = {}));
+/**
+ * A list of all the libraries that support the CLI
+ */
+export const GT_LIBRARIES = [
+    Libraries.GT_REACT,
+    Libraries.GT_NEXT,
+    Libraries.GT_REACT_NATIVE,
+    Libraries.GT_NODE,
+    Libraries.GT_I18N,
+    Libraries.GT_REACT_CORE,
+];
+/**
+ * Libraries that support inline translation
+ */
+export const INLINE_LIBRARIES = [
+    Libraries.GT_REACT,
+    Libraries.GT_NEXT,
+    Libraries.GT_NODE,
+    Libraries.GT_REACT_NATIVE,
+    Libraries.GT_REACT_CORE,
+    Libraries.GT_I18N,
+];
+export function isInlineLibrary(lib) {
+    return INLINE_LIBRARIES.includes(lib);
+}
+/**
+ * Libraries that support react primitives
+ */
+export const REACT_LIBRARIES = [
+    Libraries.GT_NEXT,
+    Libraries.GT_REACT,
+    Libraries.GT_REACT_NATIVE,
+    Libraries.GT_REACT_CORE,
+];
+/**
+ * A mapping of each library to their upstream dependencies for filtering imports
+ */
+export const GT_LIBRARIES_UPSTREAM = {
+    [Libraries.GT_NEXT]: [
+        Libraries.GT_I18N,
+        Libraries.GT_REACT_CORE,
+        Libraries.GT_REACT,
+        Libraries.GT_NEXT,
+    ],
+    [Libraries.GT_REACT]: [
+        Libraries.GT_I18N,
+        Libraries.GT_REACT_CORE,
+        Libraries.GT_REACT,
+        Libraries.GT_REACT_NATIVE, // allow for cross-library compatibility (gt-react/gt-react-native only)
+    ],
+    [Libraries.GT_REACT_NATIVE]: [
+        Libraries.GT_I18N,
+        Libraries.GT_REACT_CORE,
+        Libraries.GT_REACT_NATIVE,
+        Libraries.GT_REACT, // allow for cross-library compatibility (gt-react/gt-react-native only)
+    ],
+    [Libraries.GT_NODE]: [Libraries.GT_I18N, Libraries.GT_NODE],
+    [Libraries.GT_REACT_CORE]: [Libraries.GT_I18N, Libraries.GT_REACT_CORE],
+    [Libraries.GT_I18N]: [Libraries.GT_I18N],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.6.18",
+  "version": "2.6.19",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [