gtx-cli 2.6.31 → 2.7.0

package/dist/types/data.d.ts

@@ -1,37 +0,0 @@
-export type Entry = string;
-export type DictionaryMetadata = {
-    $context?: string;
-    $maxChars?: number;
-    $_hash?: string;
-    /** @deprecated use $context instead */
-    context?: string;
-    /** @deprecated use $maxChars instead */
-    maxChars?: number;
-    /** @deprecated */
-    variablesOptions?: Record<string, any>;
-    [key: string]: any;
-};
-export type DictionaryEntry = Entry | [Entry] | [Entry, DictionaryMetadata];
-export type Dictionary = {
-    [key: string]: Dictionary | DictionaryEntry;
-};
-export type FlattenedDictionary = {
-    [key: string]: DictionaryEntry;
-};
-export type JSONDictionary = {
-    [key: string]: string | JSONDictionary;
-};
-export type FlattenedJSONDictionary = {
-    [key: string]: string;
-};
-export type { FileFormat, DataFormat, FileToUpload, } from 'generaltranslation/types';
-export type JsxChildren = string | string[] | any;
-export type Translations = {
-    [key: string]: JsxChildren;
-};
-export type TranslationsMetadata = {
-    [key: string]: {
-        id?: string;
-        hash?: string;
-    };
-};

package/dist/types/data.js

@@ -1 +0,0 @@
-export {};

package/dist/types/files.d.ts

@@ -1,8 +0,0 @@
-export type FileMapping = Record<string, Record<string, string>>;
-export type FileProperties = {
-    versionId: string;
-    fileName: string;
-    fileId: string;
-    locale: string;
-    branchId: string;
-};

package/dist/types/files.js

@@ -1 +0,0 @@
-export {};

package/dist/types/libraries.d.ts

@@ -1,31 +0,0 @@
-/**
- * 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

@@ -1,72 +0,0 @@
-/**
- * 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/dist/types/parsing.d.ts

@@ -1,3 +0,0 @@
-export type ParsingConfigOptions = {
-    conditionNames: string[];
-};

package/dist/types/parsing.js

@@ -1 +0,0 @@
-export {};

package/dist/utils/addExplicitAnchorIds.d.ts

@@ -1,24 +0,0 @@
-/**
- * Represents a heading with its position and metadata
- */
-export interface HeadingInfo {
-    text: string;
-    level: number;
-    slug: string;
-    position: number;
-}
-/**
- * Extracts heading information from content (read-only, no modifications)
- */
-export declare function extractHeadingInfo(mdxContent: string): HeadingInfo[];
-/**
- * Applies anchor IDs to translated content based on source heading mapping
- */
-export declare function addExplicitAnchorIds(translatedContent: string, sourceHeadingMap: HeadingInfo[], settings?: any, sourcePath?: string, translatedPath?: string, fileTypeHint?: 'md' | 'mdx'): {
-    content: string;
-    hasChanges: boolean;
-    addedIds: Array<{
-        heading: string;
-        id: string;
-    }>;
-};

package/dist/utils/addExplicitAnchorIds.js

@@ -1,416 +0,0 @@
-import { unified } from 'unified';
-import remarkParse from 'remark-parse';
-import remarkMdx from 'remark-mdx';
-import remarkFrontmatter from 'remark-frontmatter';
-import remarkStringify from 'remark-stringify';
-import { visit } from 'unist-util-visit';
-import { logger } from '../console/logger.js';
-import { escapeHtmlInTextNodes, normalizeCJKCharacters } from 'gt-remark';
-import { decode } from 'html-entities';
-/**
- * Generates a slug from heading text
- */
-function generateSlug(text) {
-    return text
-        .toLowerCase()
-        .replace(/[^\w\s-]/g, '') // Remove special chars except spaces and hyphens
-        .trim()
-        .replace(/\s+/g, '-') // Replace spaces with hyphens
-        .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
-        .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
-}
-/**
- * Extracts text content from heading nodes
- */
-function extractHeadingText(heading) {
-    let text = '';
-    visit(heading, ['text', 'inlineCode'], (node) => {
-        if ('value' in node && typeof node.value === 'string') {
-            text += node.value;
-        }
-    });
-    return text;
-}
-/**
- * Simple line-by-line heading extractor that skips fenced code blocks.
- * Used as a fallback when MDX parsing fails.
- */
-function extractHeadingsWithFallback(mdxContent) {
-    const headings = [];
-    const lines = mdxContent.split('\n');
-    let position = 0;
-    let inFence = false;
-    let fenceChar = null;
-    for (const line of lines) {
-        const fenceMatch = line.match(/^(\s*)(`{3,}|~{3,})/);
-        if (fenceMatch) {
-            const fenceString = fenceMatch[2];
-            if (!inFence) {
-                inFence = true;
-                fenceChar = fenceString;
-            }
-            else if (fenceChar &&
-                fenceString[0] === fenceChar[0] &&
-                fenceString.length >= fenceChar.length) {
-                inFence = false;
-                fenceChar = null;
-            }
-            continue;
-        }
-        if (inFence) {
-            continue;
-        }
-        const headingMatch = line.match(/^(#{1,6})\s+(.*)$/);
-        if (!headingMatch) {
-            continue;
-        }
-        const hashes = headingMatch[1];
-        const rawText = headingMatch[2];
-        const { cleanedText, explicitId } = parseHeadingContent(rawText);
-        if (cleanedText || explicitId) {
-            headings.push({
-                text: cleanedText,
-                level: hashes.length,
-                slug: explicitId ?? generateSlug(cleanedText),
-                position: position++,
-            });
-        }
-    }
-    return headings;
-}
-function parseHeadingContent(text) {
-    // Support both {#id} and escaped \{#id\} forms
-    const anchorMatch = text.match(/(\\\{#([^}]+)\\\}|\{#([^}]+)\})\s*$/);
-    if (!anchorMatch) {
-        return { cleanedText: text };
-    }
-    const explicitId = anchorMatch[2] || anchorMatch[3];
-    const cleanedText = text.replace(anchorMatch[0], '').trimEnd();
-    return { cleanedText, explicitId };
-}
-/**
- * Checks if a heading is already wrapped in a div with id
- */
-function hasExplicitId(heading, ast) {
-    const lastChild = heading.children[heading.children.length - 1];
-    if (lastChild?.type === 'text') {
-        return /(\{#[^}]+\}|\\\{#[^}]+\\\}|\[[^\]]+\])\s*$/.test(lastChild.value);
-    }
-    return false;
-}
-/**
- * Extracts heading information from content (read-only, no modifications)
- */
-export function extractHeadingInfo(mdxContent) {
-    const headings = [];
-    // Parse the MDX content into an AST
-    let processedAst;
-    try {
-        const parseProcessor = unified()
-            .use(remarkParse)
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        const ast = parseProcessor.parse(mdxContent);
-        processedAst = parseProcessor.runSync(ast);
-    }
-    catch {
-        // Fallback: line-by-line extraction skipping fenced code blocks
-        return extractHeadingsWithFallback(mdxContent);
-    }
-    let position = 0;
-    visit(processedAst, 'heading', (heading) => {
-        const headingText = extractHeadingText(heading);
-        const { cleanedText, explicitId } = parseHeadingContent(headingText);
-        if (cleanedText || explicitId) {
-            const slug = explicitId ?? generateSlug(cleanedText);
-            headings.push({
-                text: cleanedText,
-                level: heading.depth,
-                slug,
-                position: position++,
-            });
-        }
-    });
-    return headings;
-}
-/**
- * Applies anchor IDs to translated content based on source heading mapping
- */
-export function addExplicitAnchorIds(translatedContent, sourceHeadingMap, settings, sourcePath, translatedPath, fileTypeHint) {
-    const addedIds = [];
-    const useDivWrapping = settings?.options?.experimentalAddHeaderAnchorIds === 'mintlify';
-    // Extract headings from translated content
-    const translatedHeadings = extractHeadingInfo(translatedContent);
-    // Pre-processing validation: check if header counts match
-    if (sourceHeadingMap.length !== translatedHeadings.length) {
-        const sourceFile = sourcePath
-            ? `Source file: ${sourcePath}`
-            : 'Source file';
-        const translatedFile = translatedPath
-            ? `translated file: ${translatedPath}`
-            : 'translated file';
-        logger.warn(`Header count mismatch detected! ${sourceFile} has ${sourceHeadingMap.length} headers but ${translatedFile} has ${translatedHeadings.length} headers. ` +
-            `This likely means your source file was edited after translation was requested, causing a mismatch between ` +
-            `the number of headers in your source file vs the translated file. Please re-translate this file to resolve the issue.`);
-    }
-    // Create ID mapping based on positional matching
-    const idMappings = new Map();
-    sourceHeadingMap.forEach((sourceHeading, index) => {
-        const translatedHeading = translatedHeadings[index];
-        // Match by position and level for safety
-        if (translatedHeading && translatedHeading.level === sourceHeading.level) {
-            idMappings.set(index, sourceHeading.slug);
-            addedIds.push({
-                heading: translatedHeading.text,
-                id: sourceHeading.slug,
-            });
-        }
-    });
-    if (idMappings.size === 0) {
-        return {
-            content: translatedContent,
-            hasChanges: false,
-            addedIds: [],
-        };
-    }
-    const translatedIsMdx = translatedPath
-        ? translatedPath.toLowerCase().endsWith('.mdx')
-        : true; // default to mdx-style escaping when unknown
-    const shouldEscapeAnchors = fileTypeHint === 'mdx'
-        ? true
-        : fileTypeHint === 'md'
-            ? false
-            : translatedIsMdx;
-    // Apply IDs to translated content
-    let content;
-    if (useDivWrapping) {
-        content = applyDivWrappedIds(translatedContent, translatedHeadings, idMappings);
-    }
-    else {
-        content = applyInlineIds(translatedContent, idMappings, shouldEscapeAnchors);
-    }
-    return {
-        content,
-        hasChanges: content !== translatedContent,
-        addedIds,
-    };
-}
-/**
- * Adds inline {#id} syntax to headings (standard markdown approach)
- */
-function applyInlineIds(translatedContent, idMappings, escapeAnchors) {
-    const escapeInlineAnchors = (content) => {
-        if (!escapeAnchors)
-            return content;
-        return content.replace(/\{#([A-Za-z0-9-_]+)\}/g, (match, id, offset, str) => {
-            if (offset > 0 && str[offset - 1] === '\\') {
-                return match;
-            }
-            return `\\{#${id}\\}`;
-        });
-    };
-    // Parse the translated content
-    let processedAst;
-    try {
-        const parseProcessor = unified()
-            .use(remarkParse)
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        const ast = parseProcessor.parse(translatedContent);
-        processedAst = parseProcessor.runSync(ast);
-    }
-    catch {
-        return applyInlineIdsStringFallback(translatedContent, idMappings, escapeAnchors);
-    }
-    // Apply IDs to headings based on position
-    let headingIndex = 0;
-    let actuallyModifiedContent = false;
-    visit(processedAst, 'heading', (heading) => {
-        const id = idMappings.get(headingIndex);
-        if (id) {
-            // Skip if heading already has explicit ID
-            if (hasExplicitId(heading, processedAst)) {
-                if (escapeAnchors) {
-                    // Normalize existing inline IDs to escaped form
-                    const lastChild = heading.children[heading.children.length - 1];
-                    if (lastChild?.type === 'text') {
-                        const match = lastChild.value.match(/\{#([^}]+)\}\s*$/);
-                        const alreadyEscaped = lastChild.value.match(/\\\{#[^}]+\\\}\s*$/);
-                        if (match && !alreadyEscaped) {
-                            const anchorId = match[1];
-                            const base = lastChild.value.replace(/\s*\{#[^}]+\}\s*$/, '');
-                            lastChild.value = `${base} \\{#${anchorId}\\}`;
-                            actuallyModifiedContent = true;
-                        }
-                    }
-                }
-                headingIndex++;
-                return;
-            }
-            // Add the ID to the heading
-            const lastChild = heading.children[heading.children.length - 1];
-            if (lastChild?.type === 'text') {
-                lastChild.value += escapeAnchors ? ` \\{#${id}\\}` : ` {#${id}}`;
-            }
-            else {
-                // If last child is not text, add a new text node
-                heading.children.push({
-                    type: 'text',
-                    value: escapeAnchors ? ` \\{#${id}\\}` : ` {#${id}}`,
-                });
-            }
-            actuallyModifiedContent = true;
-        }
-        headingIndex++;
-    });
-    // If we didn't modify any headings, return original content
-    if (!actuallyModifiedContent) {
-        const escaped = escapeInlineAnchors(translatedContent);
-        return escaped;
-    }
-    // Convert the modified AST back to MDX string
-    try {
-        const stringifyProcessor = unified()
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx)
-            .use(normalizeCJKCharacters)
-            .use(escapeHtmlInTextNodes)
-            .use(remarkStringify, {
-            handlers: {
-                // Custom handler to prevent escaping of {#id} syntax
-                text(node) {
-                    return node.value;
-                },
-            },
-        });
-        const outTree = stringifyProcessor.runSync(processedAst);
-        let content = stringifyProcessor.stringify(outTree);
-        // Handle newline formatting to match original input
-        if (content.endsWith('\n') && !translatedContent.endsWith('\n')) {
-            content = content.slice(0, -1);
-        }
-        // Preserve leading newlines from original content
-        if (translatedContent.startsWith('\n') && !content.startsWith('\n')) {
-            content = '\n' + content;
-        }
-        return content;
-    }
-    catch {
-        return translatedContent;
-    }
-}
-/**
- * Fallback string-based inline ID application when AST parsing fails
- */
-function applyInlineIdsStringFallback(translatedContent, idMappings, escapeAnchors) {
-    let headingIndex = 0;
-    let inFence = false;
-    let fenceChar = null;
-    const processedLines = translatedContent.split('\n').map((line) => {
-        const fenceMatch = line.match(/^(\s*)(`{3,}|~{3,})/);
-        if (fenceMatch) {
-            const fenceString = fenceMatch[2];
-            if (!inFence) {
-                inFence = true;
-                fenceChar = fenceString;
-            }
-            else if (fenceChar &&
-                fenceString[0] === fenceChar[0] &&
-                fenceString.length >= fenceChar.length) {
-                inFence = false;
-                fenceChar = null;
-            }
-            return line;
-        }
-        if (inFence) {
-            return line;
-        }
-        const headingMatch = line.match(/^(#{1,6}\s+)(.*)$/);
-        if (!headingMatch) {
-            return line;
-        }
-        const prefix = headingMatch[1];
-        const text = headingMatch[2];
-        const id = idMappings.get(headingIndex++);
-        if (!id) {
-            return line;
-        }
-        const hasEscaped = /\\\{#[^}]+\\\}\s*$/.test(text);
-        const hasUnescaped = /\{#[^}]+\}\s*$/.test(text);
-        if (hasEscaped) {
-            return line;
-        }
-        if (hasUnescaped) {
-            if (!escapeAnchors) {
-                return line;
-            }
-            return `${prefix}${text.replace(/\{#([^}]+)\}\s*$/, '\\{#$1\\}')}`;
-        }
-        const suffix = escapeAnchors ? ` \\{#${id}\\}` : ` {#${id}}`;
-        return `${prefix}${text}${suffix}`;
-    });
-    return processedLines.join('\n');
-}
-/**
- * Wraps headings in divs with IDs (Mintlify approach)
- */
-function applyDivWrappedIds(translatedContent, translatedHeadings, idMappings) {
-    // Extract all heading lines from the translated markdown
-    const lines = translatedContent.split('\n');
-    const headingLines = [];
-    lines.forEach((line, index) => {
-        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
-        if (headingMatch) {
-            const level = headingMatch[1].length;
-            headingLines.push({ line, level, index });
-        }
-    });
-    // Use string-based approach to wrap headings in divs
-    let content = translatedContent;
-    const headingsToWrap = [];
-    // Match translated headings with their corresponding lines by position and level
-    translatedHeadings.forEach((heading, position) => {
-        const id = idMappings.get(position);
-        if (id) {
-            // Find the corresponding original line for this heading
-            const matchingLine = headingLines.find((hl) => {
-                // Extract clean text from the original line for comparison
-                const lineCleanText = hl.line.replace(/^#{1,6}\s+/, '').trim();
-                // Create a version without markdown formatting for comparison
-                const cleanLineText = lineCleanText
-                    .replace(/\*\*(.*?)\*\*/g, '$1') // Remove bold
-                    .replace(/\*(.*?)\*/g, '$1') // Remove italic
-                    .replace(/`(.*?)`/g, '$1') // Remove inline code
-                    .replace(/\[(.*?)\]\(.*?\)/g, '$1') // Remove links, keep text
-                    .trim();
-                const normalizedLineText = decode(cleanLineText).trim();
-                const normalizedHeadingText = decode(heading.text).trim();
-                return (normalizedLineText === normalizedHeadingText &&
-                    hl.level === heading.level);
-            });
-            if (matchingLine) {
-                headingsToWrap.push({
-                    originalLine: matchingLine.line,
-                    id,
-                });
-            }
-        }
-    });
-    if (headingsToWrap.length > 0) {
-        // Process headings from longest to shortest original line to avoid partial matches
-        const sortedHeadings = headingsToWrap.sort((a, b) => b.originalLine.length - a.originalLine.length);
-        for (const heading of sortedHeadings) {
-            // If already wrapped with this id, skip (idempotent)
-            if (content.includes(`<div id="${heading.id}">`)) {
-                continue;
-            }
-            // Escape the original line for use in regex
-            const escapedLine = heading.originalLine.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            const headingPattern = new RegExp(`^${escapedLine}\\s*$`, 'gm');
-            content = content.replace(headingPattern, (match) => {
-                return `<div id="${heading.id}">\n  ${match.trim()}\n</div>\n`;
-            });
-        }
-    }
-    return content;
-}

package/dist/utils/constants.d.ts

@@ -1,5 +0,0 @@
-export declare const GT_DASHBOARD_URL = "https://dash.generaltranslation.com";
-export declare const GT_CONFIG_SCHEMA_URL = "https://assets.gtx.dev/config-schema.json";
-export declare const TEMPLATE_FILE_NAME = "__INTERNAL_GT_TEMPLATE_NAME__";
-export declare const TEMPLATE_FILE_ID: string;
-export declare const DEFAULT_GIT_REMOTE_NAME = "origin";

package/dist/utils/constants.js

@@ -1,6 +0,0 @@
-import { hashStringSync } from './hash.js';
-export const GT_DASHBOARD_URL = 'https://dash.generaltranslation.com';
-export const GT_CONFIG_SCHEMA_URL = 'https://assets.gtx.dev/config-schema.json';
-export const TEMPLATE_FILE_NAME = '__INTERNAL_GT_TEMPLATE_NAME__';
-export const TEMPLATE_FILE_ID = hashStringSync(TEMPLATE_FILE_NAME);
-export const DEFAULT_GIT_REMOTE_NAME = 'origin';

package/dist/utils/credentials.d.ts

@@ -1,12 +0,0 @@
-import { Settings, SupportedFrameworks } from '../types/index.js';
-type Credentials = {
-    apiKey: string;
-    projectId: string;
-};
-export declare function retrieveCredentials(settings: Settings, keyType: 'development' | 'production'): Promise<Credentials>;
-export declare function generateCredentialsSession(url: string, keyType: 'development' | 'production'): Promise<{
-    sessionId: string;
-}>;
-export declare function areCredentialsSet(): string | undefined;
-export declare function setCredentials(credentials: Credentials, type: 'development' | 'production', framework?: SupportedFrameworks, cwd?: string): Promise<void>;
-export {};