gtx-cli 2.6.17 → 2.6.19

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,11 +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[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.17";
+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.17';
+export const PACKAGE_VERSION = '2.6.19';

package/dist/index.js

@@ -2,16 +2,22 @@ import { BaseCLI } from './cli/base.js';
 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 === Libraries.GT_NODE) {
+        cli = new NodeCLI(program, library, additionalModules);
+    }
     else {
         cli = new BaseCLI(program, library, additionalModules);
     }

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

@@ -1,6 +1,6 @@
 export declare const DECLARE_VAR_FUNCTION = "declareVar";
 export declare const DECLARE_STATIC_FUNCTION = "declareStatic";
-export declare const MSG_TRANSLATION_FUNCTION = "msg";
+export declare const MSG_REGISTRATION_FUNCTION = "msg";
 export declare const INLINE_TRANSLATION_HOOK = "useGT";
 export declare const INLINE_TRANSLATION_HOOK_ASYNC = "getGT";
 export declare const INLINE_MESSAGE_HOOK = "useMessages";
@@ -11,7 +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-i18n", "@generaltranslation/react-core"];
-export type GTLibrary = (typeof GT_LIBRARIES)[number];
-export declare const GT_LIBRARIES_UPSTREAM: Record<GTLibrary, GTLibrary[]>;

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

@@ -1,6 +1,6 @@
 export const DECLARE_VAR_FUNCTION = 'declareVar';
 export const DECLARE_STATIC_FUNCTION = 'declareStatic';
-export const MSG_TRANSLATION_FUNCTION = 'msg';
+export const MSG_REGISTRATION_FUNCTION = 'msg';
 export const INLINE_TRANSLATION_HOOK = 'useGT';
 export const INLINE_TRANSLATION_HOOK_ASYNC = 'getGT';
 export const INLINE_MESSAGE_HOOK = 'useMessages';
@@ -13,7 +13,7 @@ export const GT_TRANSLATION_FUNCS = [
     INLINE_TRANSLATION_HOOK_ASYNC,
     INLINE_MESSAGE_HOOK,
     INLINE_MESSAGE_HOOK_ASYNC,
-    MSG_TRANSLATION_FUNCTION,
+    MSG_REGISTRATION_FUNCTION,
     DECLARE_VAR_FUNCTION,
     DECLARE_STATIC_FUNCTION,
     TRANSLATION_COMPONENT,
@@ -44,44 +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-i18n',
-    '@generaltranslation/react-core',
-];
-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)
-    ],
-    '@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/getPathsAndAliases.js

@@ -1,5 +1,5 @@
 import traverseModule from '@babel/traverse';
-import { GT_TRANSLATION_FUNCS, INLINE_TRANSLATION_HOOK, INLINE_TRANSLATION_HOOK_ASYNC, INLINE_MESSAGE_HOOK, INLINE_MESSAGE_HOOK_ASYNC, MSG_TRANSLATION_FUNCTION, TRANSLATION_COMPONENT, } from '../../jsx/utils/constants.js';
+import { GT_TRANSLATION_FUNCS, INLINE_TRANSLATION_HOOK, INLINE_TRANSLATION_HOOK_ASYNC, INLINE_MESSAGE_HOOK, INLINE_MESSAGE_HOOK_ASYNC, MSG_REGISTRATION_FUNCTION, TRANSLATION_COMPONENT, } from '../../jsx/utils/constants.js';
 import { extractImportName } from './parseAst.js';
 // Handle CommonJS/ESM interop
 const traverse = traverseModule.default || traverseModule;
@@ -23,7 +23,7 @@ export function getPathsAndAliases(ast, pkgs) {
                         name.original === INLINE_TRANSLATION_HOOK_ASYNC ||
                         name.original === INLINE_MESSAGE_HOOK ||
                         name.original === INLINE_MESSAGE_HOOK_ASYNC ||
-                        name.original === MSG_TRANSLATION_FUNCTION) {
+                        name.original === MSG_REGISTRATION_FUNCTION) {
                         inlineTranslationPaths.push({
                             localName: name.local,
                             path,
@@ -60,8 +60,7 @@ export function getPathsAndAliases(ast, pkgs) {
                             if (name.original === INLINE_TRANSLATION_HOOK ||
                                 name.original === INLINE_TRANSLATION_HOOK_ASYNC ||
                                 name.original === INLINE_MESSAGE_HOOK ||
-                                name.original === INLINE_MESSAGE_HOOK_ASYNC ||
-                                name.original === MSG_TRANSLATION_FUNCTION) {
+                                name.original === INLINE_MESSAGE_HOOK_ASYNC) {
                                 inlineTranslationPaths.push({
                                     localName: name.local,
                                     path: parentPath,

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_TRANSLATION_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';
@@ -432,7 +433,7 @@ export function parseStrings(importName, originalName, path, config, output) {
     const referencePaths = path.scope.bindings[importName]?.referencePaths || [];
     for (const refPath of referencePaths) {
         // Handle msg() calls directly without variable assignment
-        if (originalName === MSG_TRANSLATION_FUNCTION) {
+        if (originalName === MSG_REGISTRATION_FUNCTION) {
             const msgConfig = {
                 parsingOptions: config.parsingOptions,
                 file: config.file,

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,24 +41,26 @@ export async function createInlineUpdates(pkg, validate, filePatterns, parsingOp
             }, { updates, errors, warnings });
         }
         // Parse <T> components
-        for (const { localName, path } of translationComponentPaths) {
-            parseTranslationComponent({
-                originalName: localName,
-                localName,
-                path,
-                updates,
-                config: {
-                    importAliases,
-                    parsingOptions,
-                    pkgs,
-                    file,
-                },
-                output: {
-                    errors,
-                    warnings,
-                    unwrappedExpressions: [],
-                },
-            });
+        if (REACT_LIBRARIES.includes(pkg)) {
+            for (const { localName, path } of translationComponentPaths) {
+                parseTranslationComponent({
+                    originalName: localName,
+                    localName,
+                    path,
+                    updates,
+                    config: {
+                        importAliases,
+                        parsingOptions,
+                        pkgs,
+                        file,
+                    },
+                    output: {
+                        errors,
+                        warnings,
+                        unwrappedExpressions: [],
+                    },
+                });
+            }
         }
     }
     // Post processing steps:
@@ -69,7 +71,8 @@ export async function createInlineUpdates(pkg, validate, filePatterns, parsingOp
 }
 /**
  * Given a package name, return the upstream packages that it depends on
- * @param pkg
+ * @param pkg - The package name
+ * @returns The upstream packages that the package depends on
  */
 function getUpstreamPackages(pkg) {
     return GT_LIBRARIES_UPSTREAM[pkg];

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.d.ts

@@ -0,0 +1,24 @@
+import { SupportedLibraries } from '../types/index.js';
+export declare const CURSOR_GT_RULES_FILE = ".cursor/rules/gt-i18n.mdc";
+/**
+ * Detect existing AI agent instruction files in the project.
+ */
+export declare function findAgentFiles(): string[];
+/**
+ * Find agent files that already contain GT instructions.
+ */
+export declare function findAgentFilesWithInstructions(): string[];
+/**
+ * Check if the .cursor/rules/ directory exists (for offering to create gt-i18n.mdc).
+ */
+export declare function hasCursorRulesDir(): boolean;
+/**
+ * Generate GT agent instructions content based on the detected library.
+ */
+export declare function getAgentInstructions(library: SupportedLibraries): string;
+/**
+ * Append or replace GT instructions in an agent file.
+ * Skips writing if the file already contains identical instructions.
+ * For .cursor/rules/gt.md, writes the file fresh (dedicated GT rules file).
+ */
+export declare function appendAgentInstructions(filePath: string, instructions: string): boolean;

package/dist/setup/agentInstructions.js

@@ -0,0 +1,138 @@
+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',
+    'AGENTS.md',
+    'GPT.md',
+    'CHATGPT.md',
+    '.cursorrules',
+];
+const CURSOR_RULES_DIR = '.cursor/rules';
+export const CURSOR_GT_RULES_FILE = '.cursor/rules/gt-i18n.mdc';
+const GT_SECTION_START = '<!-- GT I18N RULES START -->';
+const GT_SECTION_END = '<!-- GT I18N RULES END -->';
+function getLibraryVersion(library) {
+    const packageJsonPath = path.resolve(process.cwd(), 'package.json');
+    if (!fs.existsSync(packageJsonPath))
+        return undefined;
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return getPackageVersion(library, packageJson);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Detect existing AI agent instruction files in the project.
+ */
+export function findAgentFiles() {
+    const cwd = process.cwd();
+    const found = [];
+    for (const filePath of [...AGENT_FILE_PATHS, CURSOR_GT_RULES_FILE]) {
+        const fullPath = path.resolve(cwd, filePath);
+        if (fs.existsSync(fullPath)) {
+            found.push(filePath);
+        }
+    }
+    return found;
+}
+/**
+ * Find agent files that already contain GT instructions.
+ */
+export function findAgentFilesWithInstructions() {
+    const cwd = process.cwd();
+    const found = [];
+    for (const filePath of [...AGENT_FILE_PATHS, CURSOR_GT_RULES_FILE]) {
+        const fullPath = path.resolve(cwd, filePath);
+        if (fs.existsSync(fullPath)) {
+            const content = fs.readFileSync(fullPath, 'utf8');
+            if (content.includes(GT_SECTION_START)) {
+                found.push(filePath);
+            }
+        }
+    }
+    return found;
+}
+/**
+ * Check if the .cursor/rules/ directory exists (for offering to create gt-i18n.mdc).
+ */
+export function hasCursorRulesDir() {
+    const cursorRulesDir = path.resolve(process.cwd(), CURSOR_RULES_DIR);
+    return (fs.existsSync(cursorRulesDir) && fs.statSync(cursorRulesDir).isDirectory());
+}
+/**
+ * Generate GT agent instructions content based on the detected library.
+ */
+export function getAgentInstructions(library) {
+    const libraryVersion = getLibraryVersion(library);
+    const versionLine = libraryVersion
+        ? `- **${library}**: ${libraryVersion}\n- **gtx-cli**: v${getCLIVersion()}`
+        : `- **gtx-cli**: v${getCLIVersion()}`;
+    const base = fs.readFileSync(path.join(INSTRUCTIONS_DIR, 'base.md'), 'utf8');
+    let body = '';
+    const libToFile = {
+        [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) {
+        body += '\n\n'; // add two newlines between the base and the specific instructions
+        body += fs.readFileSync(path.join(INSTRUCTIONS_DIR, instructionFile), 'utf8');
+    }
+    return `${GT_SECTION_START}
+
+${versionLine}
+
+${base}${body}
+${GT_SECTION_END}`;
+}
+/**
+ * Append or replace GT instructions in an agent file.
+ * Skips writing if the file already contains identical instructions.
+ * For .cursor/rules/gt.md, writes the file fresh (dedicated GT rules file).
+ */
+export function appendAgentInstructions(filePath, instructions) {
+    const fullPath = path.resolve(process.cwd(), filePath);
+    // For .cursor/rules/gt.md, write as a standalone file with frontmatter
+    if (filePath === CURSOR_GT_RULES_FILE) {
+        const cursorContent = `---\ndescription: GT internationalization instructions\nalwaysApply: true\n---\n${instructions}\n`;
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+        if (fs.existsSync(fullPath)) {
+            const existing = fs.readFileSync(fullPath, 'utf8');
+            if (existing === cursorContent)
+                return false;
+        }
+        fs.writeFileSync(fullPath, cursorContent, 'utf8');
+        return true;
+    }
+    // For other files, read existing content and append/replace
+    let content = '';
+    if (fs.existsSync(fullPath)) {
+        content = fs.readFileSync(fullPath, 'utf8');
+    }
+    // Already has identical instructions — skip
+    if (content.includes(instructions))
+        return false;
+    const startIdx = content.indexOf(GT_SECTION_START);
+    const endIdx = startIdx !== -1 ? content.indexOf(GT_SECTION_END, startIdx) : -1;
+    if (startIdx !== -1 && endIdx !== -1) {
+        // Replace existing section
+        const before = content.substring(0, startIdx);
+        const after = content.substring(endIdx + GT_SECTION_END.length);
+        content = before + instructions + after;
+    }
+    else {
+        // Append to end
+        const separator = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
+        content = content + separator + '\n' + instructions + '\n';
+    }
+    fs.writeFileSync(fullPath, content, 'utf8');
+    return true;
+}

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

@@ -0,0 +1,29 @@
+# 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
+
+The General Translation configuration file is called `gt.config.json`. It is usually located in the root or src directory of a project.
+
+```json
+{
+  "defaultLocale": "en",
+  "locales": ["es", "fr", "de"],
+  "files": {
+    "json": {
+      "include": ["./**/[locale]/*.json"]
+    }
+  }
+}
+```
+
+The API reference for the config file can be found at <https://generaltranslation.com/docs/cli/reference/config.md>.
+
+## Translation
+
+Run `npx gtx-cli translate` to create translation files for your project. You must have an API key to do this.
+
+## Documentation
+
+<https://generaltranslation.com/llms.txt>