@intlayer/cli 9.1.3 → 9.3.0

package/dist/types/reviewDoc/reviewDocBlockAware.d.ts

@@ -3,6 +3,7 @@ import { GetConfigurationOptions } from "@intlayer/config/node";
 import { AIOptions } from "@intlayer/api";
 import { Locale } from "@intlayer/types/allLocales";
 import { AIConfig } from "@intlayer/ai";
+import { ReviewReportSummary } from "@intlayer/engine/docReview";
 //#region src/reviewDoc/reviewDocBlockAware.d.ts
 /**
  * Review a file using block-aware alignment.
@@ -14,8 +15,11 @@ import { AIConfig } from "@intlayer/ai";
  * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so
  *    line numbers of earlier blocks are not shifted by edits below them.
  * 6. Rewrites the file after each block so progress is persisted incrementally.
+ *
+ * @returns The per-action block counts of the alignment plan, so the caller can
+ * synthesize what was reused and what had to be edited.
  */
-declare const reviewFileBlockAware: (baseFilePath: string, outputFilePath: string, locale: Locale, baseLocale: Locale, aiOptions?: AIOptions, configOptions?: GetConfigurationOptions, customInstructions?: string, changedLines?: number[], aiClient?: AIClient, aiConfig?: AIConfig) => Promise<void>;
+declare const reviewFileBlockAware: (baseFilePath: string, outputFilePath: string, locale: Locale, baseLocale: Locale, aiOptions?: AIOptions, configOptions?: GetConfigurationOptions, customInstructions?: string, changedLines?: number[], aiClient?: AIClient, aiConfig?: AIConfig) => Promise<ReviewReportSummary>;
 //#endregion
 export { reviewFileBlockAware };
 //# sourceMappingURL=reviewDocBlockAware.d.ts.map

package/dist/types/reviewDoc/reviewDocBlockAware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDocBlockAware.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"mappings":";;;;;;;;;;;;;;;;;cA0Ca,uBAAoB,sBACX,wBACE,QACd,QAAM,YACF,QAAM,YACN,WAAS,gBACL,yBAAuB,6BACZ,yBACJ,WACZ,UAAQ,WACR,aAAQ"}
+{"version":3,"file":"reviewDocBlockAware.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA+Ca,uBAAoB,sBACX,wBACE,QACd,QAAM,YACF,QAAM,YACN,WAAS,gBACL,yBAAuB,6BACZ,yBACJ,WACZ,UAAQ,WACR,aACV,QAAQ"}

package/dist/types/reviewDoc/reviewDocLog.d.ts

@@ -3,22 +3,26 @@ import { Locale } from "@intlayer/types/allLocales";
 import { ReviewReport } from "@intlayer/engine/docReview";
 //#region src/reviewDoc/reviewDocLog.d.ts
 /**
- * Log-only review of a single file/locale pair.
- *
- * Instead of calling an AI to translate the changed blocks, this compares the
- * base document with its translation and logs the blocks that need attention
- * (with their line ranges and content) so another agent or a human can generate
- * the missing translations.
+ * Compare a base document with its translation without calling any AI.
  *
  * @param baseFilePath - Absolute path of the base (source) document.
  * @param outputFilePath - Absolute path of the target (translated) document.
+ * @param changedLines - 1-based base line numbers that changed (from git), if any.
+ * @returns The structured review report.
+ */
+declare const buildFileReviewReport: (baseFilePath: string, outputFilePath: string, changedLines?: number[]) => Promise<ReviewReport>;
+/**
+ * Log the blocks that need attention (with their line ranges and content) for a
+ * single file/locale pair, so another agent or a human can generate the missing
+ * translations.
+ *
+ * @param report - The report built by {@link buildFileReviewReport}.
+ * @param baseFilePath - Absolute path of the base (source) document.
  * @param locale - The target locale being reviewed.
  * @param baseLocale - The base locale used as reference.
  * @param configOptions - Optional Intlayer configuration overrides.
- * @param changedLines - 1-based base line numbers that changed (from git), if any.
- * @returns The structured review report.
  */
-declare const logReviewFileBlocks: (baseFilePath: string, outputFilePath: string, locale: Locale, baseLocale: Locale, configOptions?: GetConfigurationOptions, changedLines?: number[]) => Promise<ReviewReport>;
+declare const logReviewFileBlocks: (report: ReviewReport, baseFilePath: string, locale: Locale, baseLocale: Locale, configOptions?: GetConfigurationOptions) => void;
 //#endregion
-export { logReviewFileBlocks };
+export { buildFileReviewReport, logReviewFileBlocks };
 //# sourceMappingURL=reviewDocLog.d.ts.map

package/dist/types/reviewDoc/reviewDocLog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDocLog.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocLog.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;cA+Ba,sBAAmB,sBACV,wBACE,QACd,QAAM,YACF,QAAM,gBACF,yBAAuB,4BAEtC,QAAQ"}
+{"version":3,"file":"reviewDocLog.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocLog.ts"],"mappings":";;;;;;;;;;;;cAuBa,wBAAqB,sBACZ,wBACE,4BAErB,QAAQ;;;;;;;;;;;;cAoBE,sBAAmB,QACtB,cAAY,sBACA,QACZ,QAAM,YACF,QAAM,gBACF"}

package/dist/types/reviewDoc/reviewDocProgress.d.ts

@@ -0,0 +1,25 @@
+//#region src/reviewDoc/reviewDocProgress.d.ts
+type ReviewProgressLogger = {
+  /** Show the progress line and start animating the spinner. */
+  start: () => void;
+  /** Count one processed document/locale pair and refresh the progress line. */
+  increment: () => void;
+  /** Stop the spinner and erase the progress line. */
+  stop: () => void;
+};
+/**
+ * Single-line progress indicator used while the documents are compared with
+ * their translations.
+ *
+ * The line is rewritten in place on an interactive terminal, then erased so the
+ * final synthesis is printed on a clean line. On a non-interactive output (a
+ * file, a CI log) a single static line is printed instead of the animation, to
+ * avoid flooding the log with escape sequences.
+ *
+ * @param totalCount - Number of document/locale pairs to process.
+ * @returns The progress logger handles.
+ */
+declare const createReviewProgressLogger: (totalCount: number) => ReviewProgressLogger;
+//#endregion
+export { ReviewProgressLogger, createReviewProgressLogger };
+//# sourceMappingURL=reviewDocProgress.d.ts.map

package/dist/types/reviewDoc/reviewDocProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDocProgress.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocProgress.ts"],"mappings":";KAUY;;EAEV;;EAEA;;EAEA;;;;;;;;;;;;;;cAeW,6BAA0B,uBAEpC"}

package/dist/types/reviewDoc/reviewDocSynthesis.d.ts

@@ -0,0 +1,41 @@
+import { Locale } from "@intlayer/types/allLocales";
+import { ReviewReportSummary } from "@intlayer/engine/docReview";
+//#region src/reviewDoc/reviewDocSynthesis.d.ts
+/**
+ * The outcome of reviewing one base document against one target locale.
+ *
+ * - `upToDate`: the translation matches the base document, nothing to do.
+ * - `toEdit`: at least one block diverges (to review, to add, or to delete).
+ * - `skipped`: the pair was not reviewed (already exists, modification range…).
+ */
+type ReviewOutcome = 'upToDate' | 'toEdit' | 'skipped';
+/** The result of reviewing a single base document / target locale pair. */
+type ReviewFileResult = {
+  /** Path of the base document, as matched by the doc pattern. */
+  docPath: string;
+  /** The reviewed target locale. */
+  locale: Locale;
+  /** What the review concluded for this pair. */
+  outcome: ReviewOutcome;
+  /** Per-action block counts, when the document was actually compared. */
+  summary?: ReviewReportSummary;
+};
+type FormatReviewSynthesisOptions = {
+  /**
+   * When `true`, the diverging blocks were fixed during the run, so the section
+   * is labelled `Updated` instead of `To edit`.
+   */
+  hasAppliedChanges?: boolean;
+};
+/**
+ * Render the end-of-run synthesis: which documents are aligned with their base
+ * document and which ones still have blocks to edit.
+ *
+ * @param results - One entry per reviewed base document / target locale pair.
+ * @param options - Rendering options.
+ * @returns A multi-line string, ready to be logged.
+ */
+declare const formatReviewSynthesis: (results: ReviewFileResult[], options?: FormatReviewSynthesisOptions) => string;
+//#endregion
+export { FormatReviewSynthesisOptions, ReviewFileResult, ReviewOutcome, formatReviewSynthesis };
+//# sourceMappingURL=reviewDocSynthesis.d.ts.map

package/dist/types/reviewDoc/reviewDocSynthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDocSynthesis.d.ts","names":[],"sources":["../../../src/reviewDoc/reviewDocSynthesis.ts"],"mappings":";;;;;;;;;;KAiBY;;KAGA;;EAEV;;EAEA,QAAQ;;EAER,SAAS;;EAET,UAAU;;KAGA;;;;;EAKV;;;;;;;;;;cA+EW,wBAAqB,SACvB,oBAAkB,UACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/cli",
-  "version": "9.1.3",
+  "version": "9.3.0",
   "private": false,
   "description": "Provides uniform command-line interface scripts for Intlayer, used in packages like intlayer-cli and intlayer.",
   "keywords": [
@@ -66,24 +66,24 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@clack/prompts": "0.11.0",
-    "@intlayer/api": "9.1.3",
-    "@intlayer/babel": "9.1.3",
-    "@intlayer/config": "9.1.3",
-    "@intlayer/core": "9.1.3",
-    "@intlayer/dictionaries-entry": "9.1.3",
-    "@intlayer/engine": "9.1.3",
-    "@intlayer/remote-dictionaries-entry": "9.1.3",
-    "@intlayer/types": "9.1.3",
-    "@intlayer/unmerged-dictionaries-entry": "9.1.3",
+    "@clack/prompts": "1.7.0",
+    "@intlayer/api": "9.3.0",
+    "@intlayer/babel": "9.3.0",
+    "@intlayer/config": "9.3.0",
+    "@intlayer/core": "9.3.0",
+    "@intlayer/dictionaries-entry": "9.3.0",
+    "@intlayer/engine": "9.3.0",
+    "@intlayer/remote-dictionaries-entry": "9.3.0",
+    "@intlayer/types": "9.3.0",
+    "@intlayer/unmerged-dictionaries-entry": "9.3.0",
     "commander": "15.0.0",
     "enquirer": "2.4.1",
-    "eventsource": "4.1.0",
+    "eventsource": "4.1.1",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {
-    "@intlayer/ai": "9.1.3",
-    "@types/node": "26.1.2",
+    "@intlayer/ai": "9.3.0",
+    "@types/node": "26.2.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
@@ -93,7 +93,7 @@
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@intlayer/ai": "9.1.3"
+    "@intlayer/ai": "9.3.0"
   },
   "peerDependenciesMeta": {
     "@intlayer/ai": {