locize-cli 12.3.1 → 12.5.0

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 Project versioning adheres to [Semantic Versioning](http://semver.org/).
 Change log format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## [12.5.0](https://github.com/locize/locize-cli/compare/v12.4.0...v12.5.0) - 2026-07-15
+
+- sync: removed keys are now listed by name in real runs too (previously the
+  names were only shown with `--dry`), capped at 50 keys per namespace, so a
+  sync always shows exactly what it deleted. When keys are removed without
+  `--backup-deleted-path`, a one-line tip now points to `-B` to keep a local
+  backup of the removed segments ([98](https://github.com/locize/locize-cli/issues/98)).
+- remove: accepts multiple keys (`locize remove common title subtitle ...`),
+  batched into a single update request per language ([53](https://github.com/locize/locize-cli/issues/53)).
+- docs: README notes for pnpm >= 11 (`blockExoticSubdeps` and why `xlsx` is
+  pinned to the SheetJS CDN tarball) and for the xcstrings format (file-level
+  conversion; i18next plural suffixes / `{{...}}` interpolation are not
+  rewritten to String Catalog plural variations / format specifiers).
+
+## [12.4.0](https://github.com/locize/locize-cli/compare/v12.3.1...v12.4.0) - 2026-07-06
+
+- xliff: proper support for inline elements (e.g. Angular's
+  `<x id="INTERPOLATION" equiv-text="{{ count }}"/>` placeholders, or
+  `<ph>`/`<pc>`/`<g>`/`<bpt>` tags from other TMS exports). On import they are
+  flattened into stable placeholder tokens inside the translation value
+  (previously such values were silently corrupted into arrays); on export the
+  tokens are restored as real XLIFF inline elements, so Angular `.xlf` files
+  round-trip cleanly. Requires `xliff` >= 6.4.0 (the encoding is implemented
+  in the library and shared with the locize CAT editor).
+- xliff: new formats `xliff21`, `xliff22`, `xlf21`, `xlf22` for XLIFF 2.1 and
+  2.2 (import of 2.1/2.2 files already worked via `xliff2`; exports now emit
+  the matching `version` attribute). XLIFF 2.1 exports carry the
+  OASIS-correct `urn:oasis:names:tc:xliff:document:2.0` core namespace.
+
 ## [12.3.1](https://github.com/locize/locize-cli/compare/v12.3.0...v12.3.1) - 2026-06-18
 
 - request: retry transient network failures with exponential backoff and jitter

package/README.md

@@ -12,6 +12,11 @@
 npm install -g locize-cli
 ```
 
+> ℹ️ **pnpm >= 11:** locize-cli depends on `xlsx` pinned to the official SheetJS CDN tarball, because the npm registry version is outdated and has known vulnerabilities. pnpm 11 blocks such non-registry transitive dependencies by default (`ERR_PNPM_EXOTIC_SUBDEP`). Install with npm, or opt out in your `pnpm-workspace.yaml`:
+> ```yaml
+> blockExoticSubdeps: false
+> ```
+
 ### with Shell: (downloads [released](https://github.com/locize/locize-cli/releases) (linux or macos) binaries)
 
 ```sh
@@ -67,6 +72,12 @@ or
 locize remove common title
 ```
 
+or remove multiple keys at once (batched into one request per language):
+
+```sh
+locize remove common title subtitle description
+```
+
 
 ## Get keys
 ### Step 1: execute
@@ -105,11 +116,12 @@ locize download --cdn-type standard
 locize download --cdn-type pro
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
 - use yaml-rails-ns to have the namespace in the resulting yaml as first key scope
+- xcstrings (Apple String Catalog): conversion happens at the file level, not at the in-string syntax level — i18next-style plural suffixes (`key_one`/`key_other`) stay separate entries (they are not merged into `variations.plural`) and interpolation placeholders like `{{name}}` are not rewritten to `%@`/`%lld` format specifiers. For a clean String Catalog export, the content should already use xcstrings-native plural variations and format specifiers.
 
 ```sh
 locize download --project-id my-project-id-93e1-442a-ab35-24331fa294ba --ver latest --language en --namespace namespace1 --path ./backup --format android
@@ -160,11 +172,12 @@ locize sync --cdn-type standard --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672
 locize sync --cdn-type pro --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
 - use yaml-rails-ns to have the namespace in the resulting yaml as first key scope
+- xcstrings (Apple String Catalog): conversion happens at the file level, not at the in-string syntax level — i18next-style plural suffixes (`key_one`/`key_other`) stay separate entries (they are not merged into `variations.plural`) and interpolation placeholders like `{{name}}` are not rewritten to `%@`/`%lld` format specifiers. For a clean String Catalog export, the content should already use xcstrings-native plural variations and format specifiers.
 
 ```sh
 locize sync --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba --format android
@@ -227,7 +240,7 @@ locize save-missing --cdn-type standard --api-key my-api-key-d9de-4f55-9855-a9ef
 locize save-missing --cdn-type pro --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 ```sh
 locize save-missing --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba --format android

package/dist/cjs/add.js

@@ -5,6 +5,18 @@ var flatten = require('flat');
 var getRemoteLanguages = require('./getRemoteLanguages.js');
 var request = require('./request.js');
 
+const payloadOf = (opt) => {
+  const data = flatten(opt.data || {});
+  if (!opt.data) {
+    data[opt.key] = opt.value || null; // null will remove the key
+  }
+  return data
+};
+
+const isRemoval = (data) => Object.keys(data).length > 0 && Object.values(data).every((v) => v === undefined || v === null);
+
+const keyLabel = (opt, data) => opt.key || Object.keys(data).join(', ');
+
 const _add = async (opt) => {
   const url = `${opt.apiEndpoint}/update/{{projectId}}/{{version}}/{{lng}}/{{ns}}`
     .replace('{{projectId}}', opt.projectId)
@@ -15,15 +27,14 @@ const _add = async (opt) => {
     .replace('{{ns}}', opt.namespace)
     .replace('{{namespace}}', opt.namespace);
 
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.yellow(`removing ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
-  } else {
-    console.log(colors.yellow(`adding ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
-  }
+  const data = payloadOf(opt);
+  const removing = isRemoval(data);
+  const label = keyLabel(opt, data);
 
-  const data = flatten(opt.data || {});
-  if (!opt.data) {
-    data[opt.key] = opt.value || null; // null will remove the key
+  if (removing) {
+    console.log(colors.yellow(`removing ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+  } else {
+    console.log(colors.yellow(`adding ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
   }
 
   try {
@@ -35,10 +46,10 @@ const _add = async (opt) => {
       body: data
     });
     if (res.status >= 300 && res.status !== 412) {
-      if (!opt.data && (opt.value === undefined || opt.value === null)) {
-        console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+      if (removing) {
+        console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
       } else {
-        console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+        console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
       }
       if (obj && (obj.errorMessage || obj.message)) {
         console.error(colors.red((obj.errorMessage || obj.message)));
@@ -49,16 +60,16 @@ const _add = async (opt) => {
       }
       return
     }
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.green(`removed ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.green(`removed ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.green(`added ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.green(`added ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
   } catch (err) {
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
     console.error(colors.red(err.message));
     process.exit(1);
@@ -80,10 +91,11 @@ const add = async (opt) => {
     opt.language = lng;
     await _add(opt);
   }
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.green(`removed ${opt.namespace}/${opt.key} (${opt.version}) from all languages...`));
+  const data = payloadOf(opt);
+  if (isRemoval(data)) {
+    console.log(colors.green(`removed ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) from all languages...`));
   } else {
-    console.log(colors.green(`added ${opt.namespace}/${opt.key} (${opt.version}) in all languages...`));
+    console.log(colors.green(`added ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) in all languages...`));
   }
 };
 

package/dist/cjs/cli.js

@@ -50,7 +50,7 @@ const program = new commander.Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.3.1'); // This string is replaced with the actual version at build time by rollup
+  .version('12.5.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -189,9 +189,9 @@ program
   });
 
 program
-  .command('remove <namespace> <key>')
+  .command('remove <namespace> <key...>')
   .alias('rm')
-  .description('remove a key')
+  .description('remove one or more keys')
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-l, --language <lng>', 'The language that should be targeted (omitting this attribute will result in removing the key from all languages)')
@@ -199,7 +199,7 @@ program
   .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
   .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`)
   .option('--ct, --cdn-type <standard|pro>', `Specify the cdn endpoint that should be used (depends on which cdn type you've in your Locize project) (default: ${defaultCdnType})`)
-  .action((namespace, key, options) => {
+  .action((namespace, keys, options) => {
     try {
       config = ini.parse(fs.readFileSync(options.configPath, 'utf-8')) || config;
     } catch (e) {}
@@ -240,13 +240,16 @@ program
       language,
       version,
       namespace,
-      key
+      key: keys.length === 1 ? keys[0] : undefined,
+      // multiple keys are batched into one update request per language
+      data: keys.length > 1 ? keys.reduce((m, k) => { m[k] = null; return m }, {}) : undefined
     });
   })
   .on('--help', () => {
     console.log('  Examples:');
     console.log();
     console.log('    $ locize remove common title');
+    console.log('    $ locize remove common title subtitle description');
     console.log('    $ locize remove common title --language en');
     console.log('    $ locize remove common title --api-key <apiKey> --project-id <projectId> --language en');
     console.log();
@@ -263,7 +266,7 @@ program
   .option('-n, --namespace <ns>', 'The namespace that should be targeted')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: true)', 'true')
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
@@ -412,7 +415,7 @@ program
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-B, --backup-deleted-path <path>', 'Saves the segments that will be deleted in this path')
   .option('-A, --auto-create-path <true|false>', 'This will automatically make sure the --path is created. (default: true)', 'true')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: false)', 'false')
   .option('-c, --clean <true|false>', 'Removes all local files by removing the whole folder (default: false)', 'false')
   .option('--cf, --clean-local-files <true|false>', 'Removes all local files without removing any folder (default: false)', 'false')
@@ -540,7 +543,7 @@ program
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-v, --ver <version>', 'Found namespaces will be matched to this version (default: latest)')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
@@ -835,7 +838,7 @@ program
   .command('format [fileOrDirectory]')
   .alias('ft')
   .description('format local files')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-l, --reference-language <lng>', 'Some format conversions need to know the reference language.', 'en')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
   .action((fileOrDirectory, options) => {

package/dist/cjs/convertToDesiredFormat.js

@@ -143,19 +143,17 @@ const convertToDesiredFormat = async (
     });
     return stringsFile.compile(data)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
-    const fn =
-      opt.format === 'xliff12' || opt.format === 'xlf12'
-        ? xliff.createxliff12
-        : xliff.createxliff;
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
     const refNs = await opt.getNamespace(opt, opt.referenceLanguage, namespace);
     const prepared = combineSubkeyPreprocessor.prepareExport(refNs, flatten(data));
-    return await fn(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace)
+    const js = await xliff.createjs(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace);
+    if (opt.format === 'xliff12' || opt.format === 'xlf12') {
+      return await xliff.jsToXliff12(js, { inlineAsString: true })
+    }
+    let targetXliffVersion; // default 2.0
+    if (opt.format === 'xliff21' || opt.format === 'xlf21') targetXliffVersion = '2.1';
+    if (opt.format === 'xliff22' || opt.format === 'xlf22') targetXliffVersion = '2.2';
+    return await xliff.js2xliff(js, { targetXliffVersion, inlineAsString: true })
   }
   if (opt.format === 'resx') {
     return await resx.js2resx(flatten(data))

package/dist/cjs/convertToFlatFormat.js

@@ -116,17 +116,13 @@ const convertToFlatFormat = async (opt, data, lng) => {
     // CRLF => LF
     return stringsFile.parse(data.toString().replace(/\r\n/g, '\n'), false)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
+    // xliff2js parses 2.0, 2.1 and 2.2
     const fn =
       opt.format === 'xliff12' || opt.format === 'xlf12'
         ? xliff.xliff12ToJs
         : xliff.xliff2js;
-    const res = await fn(data.toString());
+    const res = await fn(data.toString(), { inlineAsString: true });
     res.resources = res.resources || {};
     const ns = Object.keys(res.resources)[0];
     const orgRes = res.resources[ns] || res.resources;

package/dist/cjs/formats.js

@@ -10,8 +10,8 @@ const fileExtensionsMap = {
   '.yaml': ['yaml', 'yaml-rails', 'yaml-rails-ns', 'yaml-nested'],
   '.yml': ['yml', 'yml-rails', 'yml-rails-ns', 'yml-nested'],
   '.xlsx': ['xlsx'],
-  '.xliff': ['xliff2', 'xliff12'],
-  '.xlf': ['xlf2', 'xlf12'],
+  '.xliff': ['xliff2', 'xliff21', 'xliff22', 'xliff12'],
+  '.xlf': ['xlf2', 'xlf21', 'xlf22', 'xlf12'],
   '.ftl': ['fluent'],
   '.tmx': ['tmx'],
   '.php': ['laravel'],

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "locize-cli",
-  "version": "12.3.1",
+  "version": "12.5.0",
   "type": "commonjs"
 }

package/dist/cjs/request.js

@@ -43,7 +43,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.3.1 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.5.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {

package/dist/cjs/sync.js

@@ -195,6 +195,8 @@ const cleanupLanguages = (opt, remoteLanguages) => {
   });
 };
 
+const listRemovedKeys = (keys) => keys.length <= 50 ? keys.join(', ') : `${keys.slice(0, 50).join(', ')} ... and ${keys.length - 50} more`;
+
 const backupDeleted = (opt, ns, now) => {
   if (opt.dry || ns.diff.toRemove.length === 0) return
   let m = now.getMonth() + 1;
@@ -529,6 +531,7 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
   const shouldOmit = lngsInReqs.length > 5 || nsInReqs.length > 5;
 
   let wasThereSomethingToUpdate = opt.autoTranslate || false;
+  let suggestBackupTip = false;
 
   async function updateComparedNamespaces () {
     const now = new Date();
@@ -539,14 +542,13 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
           console.log(colors.bgRed(`skipping the removal of ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
           if (opt.dry) console.log(colors.bgRed(`skipped to remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
         } else {
-          console.log(colors.red(`removing ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
-          if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
+          console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}: ${listRemovedKeys(ns.diff.toRemove)}`));
           if (!opt.dry && opt.backupDeletedPath) backupDeleted(opt, ns, now);
+          if (!opt.dry && !opt.backupDeletedPath) suggestBackupTip = true;
         }
       }
       if (ns.diff.toRemoveLocally.length > 0) {
-        console.log(colors.red(`removing ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally...`));
-        if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemoveLocally.join(', ')} in ${ns.language}/${ns.namespace} locally...`));
+        console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally: ${listRemovedKeys(ns.diff.toRemoveLocally)}`));
       }
       if (ns.diff.toAdd.length > 0) {
         console.log(colors.green(`adding ${ns.diff.toAdd.length} keys in ${ns.language}/${ns.namespace}...`));
@@ -585,6 +587,8 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
       });
     });
 
+    if (suggestBackupTip) console.log(colors.yellow('tip: use -B <path> (--backup-deleted-path) to keep a local backup of removed segments'));
+
     console.log(colors.grey('syncing...'));
 
     async function down () {

package/dist/esm/add.js

@@ -3,6 +3,18 @@ import flatten from 'flat';
 import getRemoteLanguages from './getRemoteLanguages.js';
 import request from './request.js';
 
+const payloadOf = (opt) => {
+  const data = flatten(opt.data || {});
+  if (!opt.data) {
+    data[opt.key] = opt.value || null; // null will remove the key
+  }
+  return data
+};
+
+const isRemoval = (data) => Object.keys(data).length > 0 && Object.values(data).every((v) => v === undefined || v === null);
+
+const keyLabel = (opt, data) => opt.key || Object.keys(data).join(', ');
+
 const _add = async (opt) => {
   const url = `${opt.apiEndpoint}/update/{{projectId}}/{{version}}/{{lng}}/{{ns}}`
     .replace('{{projectId}}', opt.projectId)
@@ -13,15 +25,14 @@ const _add = async (opt) => {
     .replace('{{ns}}', opt.namespace)
     .replace('{{namespace}}', opt.namespace);
 
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.yellow(`removing ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
-  } else {
-    console.log(colors.yellow(`adding ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
-  }
+  const data = payloadOf(opt);
+  const removing = isRemoval(data);
+  const label = keyLabel(opt, data);
 
-  const data = flatten(opt.data || {});
-  if (!opt.data) {
-    data[opt.key] = opt.value || null; // null will remove the key
+  if (removing) {
+    console.log(colors.yellow(`removing ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+  } else {
+    console.log(colors.yellow(`adding ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
   }
 
   try {
@@ -33,10 +44,10 @@ const _add = async (opt) => {
       body: data
     });
     if (res.status >= 300 && res.status !== 412) {
-      if (!opt.data && (opt.value === undefined || opt.value === null)) {
-        console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+      if (removing) {
+        console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
       } else {
-        console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+        console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
       }
       if (obj && (obj.errorMessage || obj.message)) {
         console.error(colors.red((obj.errorMessage || obj.message)));
@@ -47,16 +58,16 @@ const _add = async (opt) => {
       }
       return
     }
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.green(`removed ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.green(`removed ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.green(`added ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.green(`added ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
   } catch (err) {
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
     console.error(colors.red(err.message));
     process.exit(1);
@@ -78,10 +89,11 @@ const add = async (opt) => {
     opt.language = lng;
     await _add(opt);
   }
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.green(`removed ${opt.namespace}/${opt.key} (${opt.version}) from all languages...`));
+  const data = payloadOf(opt);
+  if (isRemoval(data)) {
+    console.log(colors.green(`removed ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) from all languages...`));
   } else {
-    console.log(colors.green(`added ${opt.namespace}/${opt.key} (${opt.version}) in all languages...`));
+    console.log(colors.green(`added ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) in all languages...`));
   }
 };
 

package/dist/esm/cli.js

@@ -48,7 +48,7 @@ const program = new Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.3.1'); // This string is replaced with the actual version at build time by rollup
+  .version('12.5.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -187,9 +187,9 @@ program
   });
 
 program
-  .command('remove <namespace> <key>')
+  .command('remove <namespace> <key...>')
   .alias('rm')
-  .description('remove a key')
+  .description('remove one or more keys')
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-l, --language <lng>', 'The language that should be targeted (omitting this attribute will result in removing the key from all languages)')
@@ -197,7 +197,7 @@ program
   .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
   .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`)
   .option('--ct, --cdn-type <standard|pro>', `Specify the cdn endpoint that should be used (depends on which cdn type you've in your Locize project) (default: ${defaultCdnType})`)
-  .action((namespace, key, options) => {
+  .action((namespace, keys, options) => {
     try {
       config = ini.parse(fs.readFileSync(options.configPath, 'utf-8')) || config;
     } catch (e) {}
@@ -238,13 +238,16 @@ program
       language,
       version,
       namespace,
-      key
+      key: keys.length === 1 ? keys[0] : undefined,
+      // multiple keys are batched into one update request per language
+      data: keys.length > 1 ? keys.reduce((m, k) => { m[k] = null; return m }, {}) : undefined
     });
   })
   .on('--help', () => {
     console.log('  Examples:');
     console.log();
     console.log('    $ locize remove common title');
+    console.log('    $ locize remove common title subtitle description');
     console.log('    $ locize remove common title --language en');
     console.log('    $ locize remove common title --api-key <apiKey> --project-id <projectId> --language en');
     console.log();
@@ -261,7 +264,7 @@ program
   .option('-n, --namespace <ns>', 'The namespace that should be targeted')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: true)', 'true')
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
@@ -410,7 +413,7 @@ program
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-B, --backup-deleted-path <path>', 'Saves the segments that will be deleted in this path')
   .option('-A, --auto-create-path <true|false>', 'This will automatically make sure the --path is created. (default: true)', 'true')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: false)', 'false')
   .option('-c, --clean <true|false>', 'Removes all local files by removing the whole folder (default: false)', 'false')
   .option('--cf, --clean-local-files <true|false>', 'Removes all local files without removing any folder (default: false)', 'false')
@@ -538,7 +541,7 @@ program
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-v, --ver <version>', 'Found namespaces will be matched to this version (default: latest)')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
@@ -833,7 +836,7 @@ program
   .command('format [fileOrDirectory]')
   .alias('ft')
   .description('format local files')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-l, --reference-language <lng>', 'Some format conversions need to know the reference language.', 'en')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
   .action((fileOrDirectory, options) => {

package/dist/esm/convertToDesiredFormat.js

@@ -141,19 +141,17 @@ const convertToDesiredFormat = async (
     });
     return stringsFile.compile(data)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
-    const fn =
-      opt.format === 'xliff12' || opt.format === 'xlf12'
-        ? xliff.createxliff12
-        : xliff.createxliff;
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
     const refNs = await opt.getNamespace(opt, opt.referenceLanguage, namespace);
     const prepared = prepareExport(refNs, flatten(data));
-    return await fn(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace)
+    const js = await xliff.createjs(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace);
+    if (opt.format === 'xliff12' || opt.format === 'xlf12') {
+      return await xliff.jsToXliff12(js, { inlineAsString: true })
+    }
+    let targetXliffVersion; // default 2.0
+    if (opt.format === 'xliff21' || opt.format === 'xlf21') targetXliffVersion = '2.1';
+    if (opt.format === 'xliff22' || opt.format === 'xlf22') targetXliffVersion = '2.2';
+    return await xliff.js2xliff(js, { targetXliffVersion, inlineAsString: true })
   }
   if (opt.format === 'resx') {
     return await resx.js2resx(flatten(data))

package/dist/esm/convertToFlatFormat.js

@@ -114,17 +114,13 @@ const convertToFlatFormat = async (opt, data, lng) => {
     // CRLF => LF
     return stringsFile.parse(data.toString().replace(/\r\n/g, '\n'), false)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
+    // xliff2js parses 2.0, 2.1 and 2.2
     const fn =
       opt.format === 'xliff12' || opt.format === 'xlf12'
         ? xliff.xliff12ToJs
         : xliff.xliff2js;
-    const res = await fn(data.toString());
+    const res = await fn(data.toString(), { inlineAsString: true });
     res.resources = res.resources || {};
     const ns = Object.keys(res.resources)[0];
     const orgRes = res.resources[ns] || res.resources;

package/dist/esm/formats.js

@@ -8,8 +8,8 @@ const fileExtensionsMap = {
   '.yaml': ['yaml', 'yaml-rails', 'yaml-rails-ns', 'yaml-nested'],
   '.yml': ['yml', 'yml-rails', 'yml-rails-ns', 'yml-nested'],
   '.xlsx': ['xlsx'],
-  '.xliff': ['xliff2', 'xliff12'],
-  '.xlf': ['xlf2', 'xlf12'],
+  '.xliff': ['xliff2', 'xliff21', 'xliff22', 'xliff12'],
+  '.xlf': ['xlf2', 'xlf21', 'xlf22', 'xlf12'],
   '.ftl': ['fluent'],
   '.tmx': ['tmx'],
   '.php': ['laravel'],

package/dist/esm/request.js

@@ -41,7 +41,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.3.1 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.5.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {

package/dist/esm/sync.js

@@ -193,6 +193,8 @@ const cleanupLanguages = (opt, remoteLanguages) => {
   });
 };
 
+const listRemovedKeys = (keys) => keys.length <= 50 ? keys.join(', ') : `${keys.slice(0, 50).join(', ')} ... and ${keys.length - 50} more`;
+
 const backupDeleted = (opt, ns, now) => {
   if (opt.dry || ns.diff.toRemove.length === 0) return
   let m = now.getMonth() + 1;
@@ -527,6 +529,7 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
   const shouldOmit = lngsInReqs.length > 5 || nsInReqs.length > 5;
 
   let wasThereSomethingToUpdate = opt.autoTranslate || false;
+  let suggestBackupTip = false;
 
   async function updateComparedNamespaces () {
     const now = new Date();
@@ -537,14 +540,13 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
           console.log(colors.bgRed(`skipping the removal of ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
           if (opt.dry) console.log(colors.bgRed(`skipped to remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
         } else {
-          console.log(colors.red(`removing ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
-          if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
+          console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}: ${listRemovedKeys(ns.diff.toRemove)}`));
           if (!opt.dry && opt.backupDeletedPath) backupDeleted(opt, ns, now);
+          if (!opt.dry && !opt.backupDeletedPath) suggestBackupTip = true;
         }
       }
       if (ns.diff.toRemoveLocally.length > 0) {
-        console.log(colors.red(`removing ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally...`));
-        if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemoveLocally.join(', ')} in ${ns.language}/${ns.namespace} locally...`));
+        console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally: ${listRemovedKeys(ns.diff.toRemoveLocally)}`));
       }
       if (ns.diff.toAdd.length > 0) {
         console.log(colors.green(`adding ${ns.diff.toAdd.length} keys in ${ns.language}/${ns.namespace}...`));
@@ -583,6 +585,8 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
       });
     });
 
+    if (suggestBackupTip) console.log(colors.yellow('tip: use -B <path> (--backup-deleted-path) to keep a local backup of removed segments'));
+
     console.log(colors.grey('syncing...'));
 
     async function down () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locize-cli",
-  "version": "12.3.1",
+  "version": "12.5.0",
   "description": "locize cli to import locales",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -32,10 +32,10 @@
     "commander": "14.0.3",
     "diff": "8.0.4",
     "dotenv": "17.4.2",
-    "fast-csv": "5.0.5",
+    "fast-csv": "5.0.7",
     "flat": "5.0.2",
     "fluent_conv": "3.3.0",
-    "gettext-converter": "1.3.1",
+    "gettext-converter": "1.3.3",
     "https-proxy-agent": "7.0.6",
     "ini": "6.0.0",
     "laravelphp": "2.0.4",
@@ -46,20 +46,20 @@
     "rimraf": "6.1.3",
     "strings-file": "0.0.5",
     "tmexchange": "2.0.6",
-    "xliff": "6.3.0",
+    "xliff": "6.4.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
-    "yaml": "2.8.3"
+    "yaml": "2.9.0"
   },
   "devDependencies": {
     "@rollup/plugin-replace": "6.0.3",
-    "@rollup/plugin-terser": "0.4.4",
-    "@yao-pkg/pkg": "6.14.2",
+    "@rollup/plugin-terser": "1.0.0",
+    "@yao-pkg/pkg": "6.21.0",
     "eslint": "9.39.2",
     "eslint-plugin-import": "2.32.0",
-    "gh-release": "7.0.2",
+    "gh-release": "8.1.0",
     "neostandard": "0.13.0",
-    "rollup": "4.60.1",
-    "vitest": "4.1.4"
+    "rollup": "4.62.2",
+    "vitest": "4.1.10"
   },
   "scripts": {
     "lint": "eslint .",
@@ -67,10 +67,10 @@
     "test:watch": "vitest",
     "test": "npm run lint && vitest run",
     "pkg": "mkdir -p ./bins && pkg ./dist/cjs/cli.js --output ./bins/locize --targets node24-linux-x64,node24-macos-x64,node24-win-x64,node24-alpine-x64",
-    "release": "gh-release --assets ./bins/locize-linux,./bins/locize-macos,./bins/locize-win.exe,./bins/locize-alpine",
+    "release": "GH_RELEASE_GITHUB_API_TOKEN=$(gh auth token) gh-release --assets ./bins/locize-linux,./bins/locize-macos,./bins/locize-win.exe,./bins/locize-alpine",
     "preversion": "npm run test",
     "version": "npm run build && npm run pkg",
-    "postversion": "git push && npm run release"
+    "postversion": "git push --follow-tags && npm run release"
   },
   "keywords": [
     "cli",