gt 2.8.0 → 2.8.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.8.1
+
+### Patch Changes
+
+- [#1093](https://github.com/generaltranslation/gt/pull/1093) [`69a13a5`](https://github.com/generaltranslation/gt/commit/69a13a5791254ebb4a2679321d24fecebb1fef11) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - fix: support for temporary structural transforms
+
 ## 2.8.0
 
 ### Minor Changes

package/dist/formats/json/extractJson.js

@@ -2,6 +2,7 @@ import { logger } from '../../console/logger.js';
 import { findMatchingItemArray, findMatchingItemObject, generateSourceObjectPointers, validateJsonSchema, } from './utils.js';
 import { flattenJsonWithStringFilter } from './flattenJson.js';
 import { gt } from '../../utils/gt.js';
+import { applyStructuralTransforms } from './transformJson.js';
 /**
  * Extracts translated values from a full JSON file back into composite JSON format.
  * This is the inverse of mergeJson - it takes a merged/reconstructed JSON file
@@ -36,6 +37,9 @@ export function extractJson(localContent, inputPath, options, targetLocale, defa
     const canonicalDefaultLocale = useCanonicalLocaleKeys
         ? gt.resolveCanonicalLocale(defaultLocale)
         : defaultLocale;
+    if (jsonSchema.structuralTransform && jsonSchema.composite) {
+        applyStructuralTransforms(localJson, jsonSchema.structuralTransform, jsonSchema.composite);
+    }
     // Handle include-style schemas (simple path-based extraction)
     if (jsonSchema.include) {
         const extracted = flattenJsonWithStringFilter(localJson, jsonSchema.include);

package/dist/formats/json/mergeJson.js

@@ -6,6 +6,7 @@ import { JSONPath } from 'jsonpath-plus';
 import { getLocaleProperties } from 'generaltranslation';
 import { replaceLocalePlaceholders } from '../utils.js';
 import { gt } from '../../utils/gt.js';
+import { applyStructuralTransforms, unapplyStructuralTransforms, } from './transformJson.js';
 export function mergeJson(originalContent, inputPath, options, targets, defaultLocale, localeOrder = []) {
     const jsonSchema = validateJsonSchema(options, inputPath);
     if (!jsonSchema) {
@@ -26,6 +27,9 @@ export function mergeJson(originalContent, inputPath, options, targets, defaultL
     const canonicalLocaleOrder = useCanonicalLocaleKeys
         ? localeOrder.map((locale) => gt.resolveCanonicalLocale(locale))
         : localeOrder;
+    if (jsonSchema.structuralTransform && jsonSchema.composite) {
+        applyStructuralTransforms(originalJson, jsonSchema.structuralTransform, jsonSchema.composite);
+    }
     // Handle include
     if (jsonSchema.include) {
         const output = [];
@@ -237,6 +241,9 @@ export function mergeJson(originalContent, inputPath, options, targets, defaultL
             JSONPointer.set(mergedJson, sourceObjectPointer, sourceObjectValue);
         }
     }
+    if (jsonSchema.structuralTransform && jsonSchema.composite) {
+        unapplyStructuralTransforms(mergedJson, jsonSchema.structuralTransform, jsonSchema.composite);
+    }
     return [JSON.stringify(mergedJson, null, 2)];
 }
 function sortByLocaleOrder(items, sourceObjectOptions, localeOrder, sourceObjectPointer, defaultLocale) {

package/dist/formats/json/parseJson.js

@@ -3,6 +3,7 @@ import { JSONPath } from 'jsonpath-plus';
 import { exitSync } from '../../console/logging.js';
 import { logger } from '../../console/logger.js';
 import { findMatchingItemArray, findMatchingItemObject, generateSourceObjectPointers, validateJsonSchema, } from './utils.js';
+import { applyStructuralTransforms } from './transformJson.js';
 // Parse a JSON file according to a JSON schema
 export function parseJson(content, filePath, options, defaultLocale) {
     const jsonSchema = validateJsonSchema(options, filePath);
@@ -17,6 +18,9 @@ export function parseJson(content, filePath, options, defaultLocale) {
         logger.error(`Invalid JSON file: ${filePath}`);
         return exitSync(1);
     }
+    if (jsonSchema.structuralTransform && jsonSchema.composite) {
+        applyStructuralTransforms(json, jsonSchema.structuralTransform, jsonSchema.composite);
+    }
     // Handle include
     if (jsonSchema.include) {
         const flattenedJson = flattenJsonWithStringFilter(json, jsonSchema.include);

package/dist/formats/json/transformJson.d.ts

@@ -0,0 +1,13 @@
+import { StructuralTransform, SourceObjectOptions } from '../../types/index.js';
+/**
+ * Apply structural transforms: copy values from sourcePointer to destinationPointer
+ * for each entry resolved by the composite config's parent paths.
+ * Mutates json in-place.
+ */
+export declare function applyStructuralTransforms(json: any, transforms: StructuralTransform[], compositeConfig: Record<string, SourceObjectOptions>): any;
+/**
+ * Unapply structural transforms: delete the value at destinationPointer
+ * for each entry resolved by the composite config's parent paths.
+ * Leaves sourcePointer untouched. Mutates json in-place.
+ */
+export declare function unapplyStructuralTransforms(json: any, transforms: StructuralTransform[], compositeConfig: Record<string, SourceObjectOptions>): any;

package/dist/formats/json/transformJson.js

@@ -0,0 +1,92 @@
+import JSONPointer from 'jsonpointer';
+import { JSONPath } from 'jsonpath-plus';
+/**
+ * Derive entry parent paths from composite sourceObjectPaths by trimming the last segment.
+ * e.g., "$.*.translations" → "$.*"
+ */
+function deriveEntryPaths(compositeConfig) {
+    const entryPaths = new Set();
+    for (const sourceObjectPath of Object.keys(compositeConfig)) {
+        const lastDot = sourceObjectPath.lastIndexOf('.');
+        if (lastDot > 0) {
+            entryPaths.add(sourceObjectPath.substring(0, lastDot));
+        }
+    }
+    return [...entryPaths];
+}
+/**
+ * Apply structural transforms: copy values from sourcePointer to destinationPointer
+ * for each entry resolved by the composite config's parent paths.
+ * Mutates json in-place.
+ */
+export function applyStructuralTransforms(json, transforms, compositeConfig) {
+    const entryPaths = deriveEntryPaths(compositeConfig);
+    for (const entryPath of entryPaths) {
+        const entries = JSONPath({
+            json,
+            path: entryPath,
+            resultType: 'all',
+            flatten: true,
+            wrap: true,
+        });
+        if (!entries)
+            continue;
+        for (const entry of entries) {
+            const entryObj = entry.value;
+            if (typeof entryObj !== 'object' || entryObj === null)
+                continue;
+            for (const transform of transforms) {
+                const sourceValue = JSONPointer.get(entryObj, transform.sourcePointer);
+                if (sourceValue !== undefined) {
+                    JSONPointer.set(entryObj, transform.destinationPointer, sourceValue);
+                }
+            }
+        }
+    }
+    return json;
+}
+/**
+ * Unapply structural transforms: delete the value at destinationPointer
+ * for each entry resolved by the composite config's parent paths.
+ * Leaves sourcePointer untouched. Mutates json in-place.
+ */
+export function unapplyStructuralTransforms(json, transforms, compositeConfig) {
+    const entryPaths = deriveEntryPaths(compositeConfig);
+    for (const entryPath of entryPaths) {
+        const entries = JSONPath({
+            json,
+            path: entryPath,
+            resultType: 'all',
+            flatten: true,
+            wrap: true,
+        });
+        if (!entries)
+            continue;
+        for (const entry of entries) {
+            const entryObj = entry.value;
+            if (typeof entryObj !== 'object' || entryObj === null)
+                continue;
+            for (const transform of transforms) {
+                // Navigate to parent of destinationPointer and delete the leaf key
+                const pointer = transform.destinationPointer;
+                const lastSlash = pointer.lastIndexOf('/');
+                if (lastSlash < 0)
+                    continue;
+                const parentPointer = pointer.substring(0, lastSlash) || '';
+                const leafKey = pointer.substring(lastSlash + 1);
+                try {
+                    const parent = parentPointer
+                        ? JSONPointer.get(entryObj, parentPointer)
+                        : entryObj;
+                    if (parent && typeof parent === 'object' && leafKey in parent) {
+                        delete parent[leafKey];
+                    }
+                }
+                catch {
+                    /* entry may not have the destination path */
+                }
+            }
+        }
+    }
+    return json;
+}

package/dist/formats/json/utils.js

@@ -146,5 +146,10 @@ export function validateJsonSchema(options, filePath) {
         return exitSync(1);
         return null;
     }
+    if (jsonSchema.structuralTransform && !jsonSchema.composite) {
+        logger.error('structuralTransform requires composite to be defined in the JSON schema');
+        return exitSync(1);
+        return null;
+    }
     return jsonSchema;
 }

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.8.0";
+export declare const PACKAGE_VERSION = "2.8.1";

package/dist/generated/version.js

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

package/dist/types/index.d.ts

@@ -218,8 +218,13 @@ export type SharedStaticAssetsConfig = {
     publicPath?: string;
     mirrorToLocales?: boolean;
 };
+export type StructuralTransform = {
+    sourcePointer: string;
+    destinationPointer: string;
+};
 export type JsonSchema = {
     preset?: 'mintlify' | 'openapi';
+    structuralTransform?: StructuralTransform[];
     include?: string[];
     composite?: {
         [sourceObjectPath: string]: SourceObjectOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gt",
-  "version": "2.8.0",
+  "version": "2.8.1",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [
@@ -110,9 +110,9 @@
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
     "yaml": "^2.8.0",
-    "gt-remark": "1.0.5",
     "@generaltranslation/python-extractor": "0.1.0",
-    "generaltranslation": "8.1.14"
+    "generaltranslation": "8.1.14",
+    "gt-remark": "1.0.5"
   },
   "devDependencies": {
     "@babel/types": "^7.28.4",