@intlayer/engine 9.5.9 → 9.5.11

package/dist/esm/docReview/rebuildDocument.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rebuildDocument.mjs","names":[],"sources":["../../../src/docReview/rebuildDocument.ts"],"sourcesContent":["import type { AlignmentPlan, FingerprintedBlock } from './types';\n\n/**\n * A block that needs to be translated or re-translated by an external consumer\n * (an AI client, a human, or an agent).\n */\nexport type SegmentToReview = {\n  /** The base block to translate. */\n  baseBlock: FingerprintedBlock;\n  /** Existing target translation, or `null` when the block is new. */\n  targetBlockText: string | null;\n  /** Index of the originating action within {@link AlignmentPlan.actions}. */\n  actionIndex: number;\n};\n\nexport type RebuildInput = {\n  baseBlocks: FingerprintedBlock[];\n  targetBlocks: FingerprintedBlock[];\n  plan: AlignmentPlan;\n};\n\nexport type RebuildResult = {\n  segmentsToReview: SegmentToReview[];\n};\n\n/**\n * Analyze the alignment plan and return only the segments that need\n * review/translation. Does not generate output text - that is done by\n * {@link mergeReviewedSegments} once the translations are available.\n *\n * @param input - The base/target blocks and the alignment plan.\n * @returns The list of segments that require translation.\n */\nexport const identifySegmentsToReview = ({\n  baseBlocks,\n  targetBlocks,\n  plan,\n}: RebuildInput): RebuildResult => {\n  const segmentsToReview: SegmentToReview[] = [];\n\n  plan.actions.forEach((action, actionIndex) => {\n    if (action.kind === 'review') {\n      const baseBlock = baseBlocks[action.baseIndex];\n      const targetBlockText =\n        action.targetIndex !== null\n          ? targetBlocks[action.targetIndex].content\n          : null;\n\n      segmentsToReview.push({ baseBlock, targetBlockText, actionIndex });\n    } else if (action.kind === 'insert_new') {\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      segmentsToReview.push({\n        baseBlock,\n        targetBlockText: null,\n        actionIndex,\n      });\n    }\n  });\n\n  return { segmentsToReview };\n};\n\n/** Markdown separates two blocks with a blank line. */\nconst endsWithBlockBoundary = (text: string): boolean =>\n  /\\n[ \\t]*\\n$/.test(text);\n\n/**\n * The newlines missing at the end of `text` for it to close a markdown block.\n *\n * @param text - The document built so far.\n * @returns `''`, `'\\n'` or `'\\n\\n'` depending on how the text already ends.\n */\nconst buildBlockSeparator = (text: string): string => {\n  if (text.length === 0 || endsWithBlockBoundary(text)) return '';\n\n  return text.endsWith('\\n') ? '\\n' : '\\n\\n';\n};\n\n/**\n * Merge reviewed translations back into the final document following the\n * alignment plan, reusing untouched target blocks as-is.\n *\n * @param plan - The alignment plan.\n * @param targetBlocks - Blocks of the existing target document.\n * @param reviewedSegments - Map of action index to its reviewed translation.\n * @returns The rebuilt target document.\n */\nexport const mergeReviewedSegments = (\n  plan: AlignmentPlan,\n  targetBlocks: FingerprintedBlock[],\n  reviewedSegments: Map<number, string>\n): string => {\n  let mergedText = '';\n  let previousPartWasGenerated = false;\n\n  /**\n   * Append one part, keeping a blank line around the content this run produced.\n   *\n   * Blocks own the blank lines that trail them, so two verbatim blocks already\n   * separate themselves and are appended untouched — a document with nothing to\n   * change merges back byte for byte. Generated content is the exception: the\n   * block it lands after may be the one that used to end the document, which\n   * carries no trailing blank line, and the two would be glued into a single\n   * markdown block (a heading swallowed by the paragraph above it).\n   */\n  const appendPart = (content: string, isGenerated: boolean): void => {\n    if (content.length === 0) return;\n\n    if (isGenerated || previousPartWasGenerated) {\n      mergedText += buildBlockSeparator(mergedText);\n    }\n\n    mergedText += content;\n    previousPartWasGenerated = isGenerated;\n  };\n\n  plan.actions.forEach((action, actionIndex) => {\n    if (action.kind === 'reuse') {\n      appendPart(targetBlocks[action.targetIndex]!.content, false);\n    } else if (action.kind === 'review' || action.kind === 'insert_new') {\n      const reviewedContent = reviewedSegments.get(actionIndex);\n\n      if (reviewedContent !== undefined) {\n        appendPart(reviewedContent, true);\n      } else {\n        // Fallback: if review failed, use existing or blank\n        if (action.kind === 'review' && action.targetIndex !== null) {\n          appendPart(targetBlocks[action.targetIndex]!.content, false);\n        } else {\n          appendPart('\\n', false);\n        }\n      }\n    } else if (action.kind === 'delete') {\n      const reviewedContent = reviewedSegments.get(actionIndex);\n      if (reviewedContent !== undefined) {\n        // Caller explicitly resolved this block: empty string = actually delete,\n        // non-empty string = replacement content.\n        appendPart(reviewedContent, true);\n      } else {\n        // Default: keep verbatim. A target block with no base counterpart may\n        // just be a section the aligner could not follow (reordering, split\n        // prose) — keeping it prevents accidental data loss in log/read-only mode.\n        appendPart(targetBlocks[action.targetIndex]!.content, false);\n      }\n    }\n  });\n\n  return mergedText;\n};\n"],"mappings":";;;;;;;;;AAiCA,MAAa,4BAA4B,EACvC,YACA,cACA,WACiC;CACjC,MAAM,mBAAsC,CAAC;CAE7C,KAAK,QAAQ,SAAS,QAAQ,gBAAgB;EAC5C,IAAI,OAAO,SAAS,UAAU;GAC5B,MAAM,YAAY,WAAW,OAAO;GACpC,MAAM,kBACJ,OAAO,gBAAgB,OACnB,aAAa,OAAO,YAAY,CAAC,UACjC;GAEN,iBAAiB,KAAK;IAAE;IAAW;IAAiB;GAAY,CAAC;EACnE,OAAO,IAAI,OAAO,SAAS,cAAc;GACvC,MAAM,YAAY,WAAW,OAAO;GAEpC,iBAAiB,KAAK;IACpB;IACA,iBAAiB;IACjB;GACF,CAAC;EACH;CACF,CAAC;CAED,OAAO,EAAE,iBAAiB;AAC5B;;AAGA,MAAM,yBAAyB,SAC7B,cAAc,KAAK,IAAI;;;;;;;AAQzB,MAAM,uBAAuB,SAAyB;CACpD,IAAI,KAAK,WAAW,KAAK,sBAAsB,IAAI,GAAG,OAAO;CAE7D,OAAO,KAAK,SAAS,IAAI,IAAI,OAAO;AACtC;;;;;;;;;;AAWA,MAAa,yBACX,MACA,cACA,qBACW;CACX,IAAI,aAAa;CACjB,IAAI,2BAA2B;;;;;;;;;;;CAY/B,MAAM,cAAc,SAAiB,gBAA+B;EAClE,IAAI,QAAQ,WAAW,GAAG;EAE1B,IAAI,eAAe,0BACjB,cAAc,oBAAoB,UAAU;EAG9C,cAAc;EACd,2BAA2B;CAC7B;CAEA,KAAK,QAAQ,SAAS,QAAQ,gBAAgB;EAC5C,IAAI,OAAO,SAAS,SAClB,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;OACtD,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,cAAc;GACnE,MAAM,kBAAkB,iBAAiB,IAAI,WAAW;GAExD,IAAI,oBAAoB,QACtB,WAAW,iBAAiB,IAAI;QAGhC,IAAI,OAAO,SAAS,YAAY,OAAO,gBAAgB,MACrD,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;QAE3D,WAAW,MAAM,KAAK;EAG5B,OAAO,IAAI,OAAO,SAAS,UAAU;GACnC,MAAM,kBAAkB,iBAAiB,IAAI,WAAW;GACxD,IAAI,oBAAoB,QAGtB,WAAW,iBAAiB,IAAI;QAKhC,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;EAE/D;CACF,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"rebuildDocument.mjs","names":[],"sources":["../../../src/docReview/rebuildDocument.ts"],"sourcesContent":["import type { AlignmentPlan, FingerprintedBlock } from './types';\n\n/**\n * A block that needs to be translated or re-translated by an external consumer\n * (an AI client, a human, or an agent).\n */\nexport type SegmentToReview = {\n  /** The base block to translate. */\n  baseBlock: FingerprintedBlock;\n  /** Existing target translation, or `null` when the block is new. */\n  targetBlockText: string | null;\n  /** Index of the originating action within {@link AlignmentPlan.actions}. */\n  actionIndex: number;\n};\n\nexport type RebuildInput = {\n  baseBlocks: FingerprintedBlock[];\n  targetBlocks: FingerprintedBlock[];\n  plan: AlignmentPlan;\n};\n\nexport type RebuildResult = {\n  segmentsToReview: SegmentToReview[];\n};\n\n/**\n * Analyze the alignment plan and return only the segments that need\n * review/translation. Does not generate output text - that is done by\n * {@link mergeReviewedSegments} once the translations are available.\n *\n * @param input - The base/target blocks and the alignment plan.\n * @returns The list of segments that require translation.\n */\nexport const identifySegmentsToReview = ({\n  baseBlocks,\n  targetBlocks,\n  plan,\n}: RebuildInput): RebuildResult => {\n  const segmentsToReview: SegmentToReview[] = [];\n\n  plan.actions.forEach((action, actionIndex) => {\n    if (action.kind === 'review') {\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) return;\n\n      const targetBlockText =\n        action.targetIndex !== null\n          ? (targetBlocks[action.targetIndex]?.content ?? null)\n          : null;\n\n      segmentsToReview.push({ baseBlock, targetBlockText, actionIndex });\n    } else if (action.kind === 'insert_new') {\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) return;\n\n      segmentsToReview.push({\n        baseBlock,\n        targetBlockText: null,\n        actionIndex,\n      });\n    }\n  });\n\n  return { segmentsToReview };\n};\n\n/** Markdown separates two blocks with a blank line. */\nconst endsWithBlockBoundary = (text: string): boolean =>\n  /\\n[ \\t]*\\n$/.test(text);\n\n/**\n * The newlines missing at the end of `text` for it to close a markdown block.\n *\n * @param text - The document built so far.\n * @returns `''`, `'\\n'` or `'\\n\\n'` depending on how the text already ends.\n */\nconst buildBlockSeparator = (text: string): string => {\n  if (text.length === 0 || endsWithBlockBoundary(text)) return '';\n\n  return text.endsWith('\\n') ? '\\n' : '\\n\\n';\n};\n\n/**\n * Merge reviewed translations back into the final document following the\n * alignment plan, reusing untouched target blocks as-is.\n *\n * @param plan - The alignment plan.\n * @param targetBlocks - Blocks of the existing target document.\n * @param reviewedSegments - Map of action index to its reviewed translation.\n * @returns The rebuilt target document.\n */\nexport const mergeReviewedSegments = (\n  plan: AlignmentPlan,\n  targetBlocks: FingerprintedBlock[],\n  reviewedSegments: Map<number, string>\n): string => {\n  let mergedText = '';\n  let previousPartWasGenerated = false;\n\n  /**\n   * Append one part, keeping a blank line around the content this run produced.\n   *\n   * Blocks own the blank lines that trail them, so two verbatim blocks already\n   * separate themselves and are appended untouched — a document with nothing to\n   * change merges back byte for byte. Generated content is the exception: the\n   * block it lands after may be the one that used to end the document, which\n   * carries no trailing blank line, and the two would be glued into a single\n   * markdown block (a heading swallowed by the paragraph above it).\n   */\n  const appendPart = (content: string, isGenerated: boolean): void => {\n    if (content.length === 0) return;\n\n    if (isGenerated || previousPartWasGenerated) {\n      mergedText += buildBlockSeparator(mergedText);\n    }\n\n    mergedText += content;\n    previousPartWasGenerated = isGenerated;\n  };\n\n  plan.actions.forEach((action, actionIndex) => {\n    if (action.kind === 'reuse') {\n      appendPart(targetBlocks[action.targetIndex]!.content, false);\n    } else if (action.kind === 'review' || action.kind === 'insert_new') {\n      const reviewedContent = reviewedSegments.get(actionIndex);\n\n      if (reviewedContent !== undefined) {\n        appendPart(reviewedContent, true);\n      } else {\n        // Fallback: if review failed, use existing or blank\n        if (action.kind === 'review' && action.targetIndex !== null) {\n          appendPart(targetBlocks[action.targetIndex]!.content, false);\n        } else {\n          appendPart('\\n', false);\n        }\n      }\n    } else if (action.kind === 'delete') {\n      const reviewedContent = reviewedSegments.get(actionIndex);\n      if (reviewedContent !== undefined) {\n        // Caller explicitly resolved this block: empty string = actually delete,\n        // non-empty string = replacement content.\n        appendPart(reviewedContent, true);\n      } else {\n        // Default: keep verbatim. A target block with no base counterpart may\n        // just be a section the aligner could not follow (reordering, split\n        // prose) — keeping it prevents accidental data loss in log/read-only mode.\n        appendPart(targetBlocks[action.targetIndex]!.content, false);\n      }\n    }\n  });\n\n  return mergedText;\n};\n"],"mappings":";;;;;;;;;AAiCA,MAAa,4BAA4B,EACvC,YACA,cACA,WACiC;CACjC,MAAM,mBAAsC,CAAC;CAE7C,KAAK,QAAQ,SAAS,QAAQ,gBAAgB;EAC5C,IAAI,OAAO,SAAS,UAAU;GAC5B,MAAM,YAAY,WAAW,OAAO;GAEpC,IAAI,CAAC,WAAW;GAEhB,MAAM,kBACJ,OAAO,gBAAgB,OAClB,aAAa,OAAO,YAAY,EAAE,WAAW,OAC9C;GAEN,iBAAiB,KAAK;IAAE;IAAW;IAAiB;GAAY,CAAC;EACnE,OAAO,IAAI,OAAO,SAAS,cAAc;GACvC,MAAM,YAAY,WAAW,OAAO;GAEpC,IAAI,CAAC,WAAW;GAEhB,iBAAiB,KAAK;IACpB;IACA,iBAAiB;IACjB;GACF,CAAC;EACH;CACF,CAAC;CAED,OAAO,EAAE,iBAAiB;AAC5B;;AAGA,MAAM,yBAAyB,SAC7B,cAAc,KAAK,IAAI;;;;;;;AAQzB,MAAM,uBAAuB,SAAyB;CACpD,IAAI,KAAK,WAAW,KAAK,sBAAsB,IAAI,GAAG,OAAO;CAE7D,OAAO,KAAK,SAAS,IAAI,IAAI,OAAO;AACtC;;;;;;;;;;AAWA,MAAa,yBACX,MACA,cACA,qBACW;CACX,IAAI,aAAa;CACjB,IAAI,2BAA2B;;;;;;;;;;;CAY/B,MAAM,cAAc,SAAiB,gBAA+B;EAClE,IAAI,QAAQ,WAAW,GAAG;EAE1B,IAAI,eAAe,0BACjB,cAAc,oBAAoB,UAAU;EAG9C,cAAc;EACd,2BAA2B;CAC7B;CAEA,KAAK,QAAQ,SAAS,QAAQ,gBAAgB;EAC5C,IAAI,OAAO,SAAS,SAClB,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;OACtD,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,cAAc;GACnE,MAAM,kBAAkB,iBAAiB,IAAI,WAAW;GAExD,IAAI,oBAAoB,QACtB,WAAW,iBAAiB,IAAI;QAGhC,IAAI,OAAO,SAAS,YAAY,OAAO,gBAAgB,MACrD,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;QAE3D,WAAW,MAAM,KAAK;EAG5B,OAAO,IAAI,OAAO,SAAS,UAAU;GACnC,MAAM,kBAAkB,iBAAiB,IAAI,WAAW;GACxD,IAAI,oBAAoB,QAGtB,WAAW,iBAAiB,IAAI;QAKhC,WAAW,aAAa,OAAO,YAAY,CAAE,SAAS,KAAK;EAE/D;CACF,CAAC;CAED,OAAO;AACT"}

package/dist/esm/docReview/reviewReport.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewReport.mjs","names":[],"sources":["../../../src/docReview/reviewReport.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizeNumber } from '@intlayer/config/logger';\nimport { buildAlignmentPlan } from './pipeline';\n\n/**\n * The kind of change detected for a block when reviewing a translation against\n * its base document.\n *\n * - `review`: the base block changed and its translation must be updated.\n * - `insert_new`: the base block has no translation yet and must be added.\n * - `delete`: the target block no longer exists in the base and should be removed.\n */\nexport type ReviewBlockAction = 'review' | 'insert_new' | 'delete';\n\n/** A 1-based, inclusive line range within a document. */\nexport type LineRange = {\n  start: number;\n  end: number;\n};\n\n/**\n * A single block that diverges between the base document and its translation.\n *\n * This is the unit an external translator (AI client, human, or agent) needs to\n * act on: it carries the base content to translate, the existing translation to\n * update, and where each lives so the change can be located in the file.\n */\nexport type ReviewReportBlock = {\n  /** What should happen to this block. */\n  action: ReviewBlockAction;\n  /** Line range of the block in the base document (omitted for pure deletions). */\n  baseLineRange?: LineRange;\n  /** Line range of the block in the target document (omitted for new insertions). */\n  targetLineRange?: LineRange;\n  /** Raw markdown of the base block (omitted for pure deletions). */\n  baseContent?: string;\n  /** Existing translation of the block (omitted for new insertions). */\n  targetContent?: string;\n};\n\nexport type ReviewReportSummary = {\n  /** Number of blocks reused as-is (unchanged translation). */\n  reuse: number;\n  /** Number of blocks whose translation must be updated. */\n  review: number;\n  /** Number of blocks missing a translation. */\n  insertNew: number;\n  /** Number of stale target blocks to delete. */\n  delete: number;\n};\n\nexport type ReviewReport = {\n  /** Only the blocks that diverge (review, insert_new, delete). */\n  blocks: ReviewReportBlock[];\n  /** Counts per action over the whole document, including reused blocks. */\n  summary: ReviewReportSummary;\n};\n\nexport type BuildReviewReportInput = {\n  /** The base (source) document, used as the translation reference. */\n  baseText: string;\n  /** The existing target (translated) document, possibly empty. */\n  targetText: string;\n  /**\n   * 1-based line numbers that changed in the base document.\n   *\n   * When omitted the whole document is compared, and only inserted and deleted\n   * blocks are reported (no aligned block is flagged for review since there is\n   * no way to know which ones changed). An empty array means nothing changed,\n   * and no block at all is reported.\n   */\n  changedLines?: number[];\n};\n\n/**\n * Compare a base markdown document with its translation and report only the\n * blocks that need attention, with their line ranges and content.\n *\n * Reusable across the CLI (`doc review --log`), the backend (comparing two\n * translation contents stored in database), and agents that generate the\n * missing translations.\n *\n * @param input - The base/target texts and optional changed lines.\n * @returns The divergent blocks and a per-action summary.\n */\nexport const buildReviewReport = ({\n  baseText,\n  targetText,\n  changedLines,\n}: BuildReviewReportInput): ReviewReport => {\n  const { baseBlocks, targetBlocks, plan } = buildAlignmentPlan({\n    baseText,\n    targetText,\n    changedLines,\n  });\n\n  const summary: ReviewReportSummary = {\n    reuse: 0,\n    review: 0,\n    insertNew: 0,\n    delete: 0,\n  };\n\n  const blocks: ReviewReportBlock[] = [];\n\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'reuse') {\n      summary.reuse += 1;\n      continue;\n    }\n\n    if (action.kind === 'review') {\n      summary.review += 1;\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) continue;\n\n      const targetBlock =\n        action.targetIndex !== null ? targetBlocks[action.targetIndex] : null;\n\n      blocks.push({\n        action: 'review',\n        baseLineRange: { start: baseBlock.lineStart, end: baseBlock.lineEnd },\n        targetLineRange: targetBlock\n          ? { start: targetBlock.lineStart, end: targetBlock.lineEnd }\n          : undefined,\n        baseContent: baseBlock.content,\n        targetContent: targetBlock?.content,\n      });\n      continue;\n    }\n\n    if (action.kind === 'insert_new') {\n      summary.insertNew += 1;\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) continue;\n\n      // Find the target line after which the new block should be inserted:\n      // scan backwards for the last action that produced a target block.\n      let insertAfterLine: number | undefined;\n      for (let prevIndex = actionIndex - 1; prevIndex >= 0; prevIndex--) {\n        const prevAction = plan.actions[prevIndex];\n        if (!prevAction) continue;\n\n        let targetIdx: number | null = null;\n        if (prevAction.kind === 'reuse') targetIdx = prevAction.targetIndex;\n        else if (\n          prevAction.kind === 'review' &&\n          prevAction.targetIndex !== null\n        )\n          targetIdx = prevAction.targetIndex;\n        else if (prevAction.kind === 'delete')\n          targetIdx = prevAction.targetIndex;\n\n        if (targetIdx !== null) {\n          const prevTargetBlock = targetBlocks[targetIdx];\n          if (prevTargetBlock) {\n            insertAfterLine = prevTargetBlock.lineEnd + 1;\n            break;\n          }\n        }\n      }\n\n      blocks.push({\n        action: 'insert_new',\n        baseLineRange: { start: baseBlock.lineStart, end: baseBlock.lineEnd },\n        targetLineRange:\n          insertAfterLine !== undefined\n            ? { start: insertAfterLine, end: insertAfterLine }\n            : undefined,\n        baseContent: baseBlock.content,\n      });\n      continue;\n    }\n\n    if (action.kind === 'delete') {\n      summary.delete += 1;\n      const targetBlock = targetBlocks[action.targetIndex];\n\n      if (!targetBlock) continue;\n\n      blocks.push({\n        action: 'delete',\n        targetLineRange: {\n          start: targetBlock.lineStart,\n          end: targetBlock.lineEnd,\n        },\n        targetContent: targetBlock.content,\n      });\n    }\n  }\n\n  return { blocks, summary };\n};\n\n/** Render a line range as a blue colored string, or an orange dash when absent. */\nconst colorizeLineRange = (range?: LineRange): string => {\n  if (!range) return colorize('—', ANSIColors.ORANGE);\n  const rangeStr =\n    range.start === range.end\n      ? `L${range.start}`\n      : `L${range.start}-${range.end}`;\n  return colorize(rangeStr, ANSIColors.BLUE);\n};\n\n/**\n * Colorize a count with green when zero (nothing to do) and a caller-supplied\n * non-zero color (orange for warnings, red for destructive actions).\n */\nconst colorizeCount = (\n  count: number,\n  nonZeroColor: (typeof ANSIColors)[keyof typeof ANSIColors]\n): string =>\n  colorizeNumber(count, {\n    zero: ANSIColors.GREEN,\n    one: nonZeroColor,\n    two: nonZeroColor,\n    few: nonZeroColor,\n    many: nonZeroColor,\n    other: nonZeroColor,\n  });\n\n/**\n * Render a {@link ReviewReport} as a human and agent readable log.\n *\n * Each divergent block is printed with its action, the base/target line ranges,\n * the base content to translate, and the existing translation to update.\n *\n * @param report - The report to format.\n * @param options - Optional labels for the base and target locales.\n * @returns A multi-line string describing every block that needs attention.\n */\nexport const formatReviewReport = (\n  report: ReviewReport,\n  options?: { baseLabel?: string; targetLabel?: string }\n): string => {\n  const baseLabel = options?.baseLabel ?? 'base';\n  const targetLabel = options?.targetLabel ?? 'target';\n\n  const { summary, blocks } = report;\n\n  // Build the summary header piece-by-piece so each count uses its own color.\n  const header = [\n    colorize('Review report: ', ANSIColors.ORANGE),\n    colorizeCount(blocks.length, ANSIColors.ORANGE),\n    colorize(' block(s) need attention (review=', ANSIColors.ORANGE),\n    colorizeCount(summary.review, ANSIColors.ORANGE),\n    colorize(', new=', ANSIColors.ORANGE),\n    colorizeCount(summary.insertNew, ANSIColors.ORANGE),\n    colorize(', delete=', ANSIColors.ORANGE),\n    colorizeCount(summary.delete, ANSIColors.RED),\n    colorize(', reuse=', ANSIColors.ORANGE),\n    colorizeNumber(summary.reuse),\n    colorize(').', ANSIColors.ORANGE),\n  ].join('');\n\n  if (blocks.length === 0) {\n    return `${header}\\n${colorize('No changes needed.', ANSIColors.GREEN)}`;\n  }\n\n  const sections = blocks.map((block, index) => {\n    const lines: string[] = [];\n\n    // Block header: each token colored individually.\n    const blockHeader = [\n      colorize('--- Block ', ANSIColors.ORANGE),\n      colorizeNumber(index + 1),\n      colorize('/', ANSIColors.ORANGE),\n      colorizeNumber(blocks.length),\n      colorize(` [${block.action}] `, ANSIColors.ORANGE),\n      baseLabel,\n      colorize(' ', ANSIColors.ORANGE),\n      colorizeLineRange(block.baseLineRange),\n      colorize(' → ', ANSIColors.ORANGE),\n      targetLabel,\n      colorize(' ', ANSIColors.ORANGE),\n      colorizeLineRange(block.targetLineRange),\n      colorize(' ---', ANSIColors.ORANGE),\n    ].join('');\n\n    lines.push(blockHeader);\n\n    if (block.baseContent !== undefined) {\n      lines.push(colorize(`[${baseLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize(block.baseContent.trimEnd(), ANSIColors.GREY));\n    }\n\n    if (block.targetContent !== undefined) {\n      lines.push(colorize(`[${targetLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize(block.targetContent.trimEnd(), ANSIColors.GREY));\n    } else if (block.action === 'insert_new') {\n      lines.push(colorize(`[${targetLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize('(missing — to be translated)', ANSIColors.ORANGE));\n    }\n\n    return lines.join('\\n');\n  });\n\n  const editingNote = colorize(\n    'Tip: start editing from the last block — working bottom-up keeps earlier line numbers accurate.',\n    ANSIColors.GREY\n  );\n\n  return [header, '', ...sections, '', editingNote].join('\\n');\n};\n"],"mappings":"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"}
+{"version":3,"file":"reviewReport.mjs","names":[],"sources":["../../../src/docReview/reviewReport.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport {\n  type ANSIColorsType,\n  colorize,\n  colorizeNumber,\n} from '@intlayer/config/logger';\nimport { buildAlignmentPlan } from './pipeline';\n\n/**\n * The kind of change detected for a block when reviewing a translation against\n * its base document.\n *\n * - `review`: the base block changed and its translation must be updated.\n * - `insert_new`: the base block has no translation yet and must be added.\n * - `delete`: the target block no longer exists in the base and should be removed.\n */\nexport type ReviewBlockAction = 'review' | 'insert_new' | 'delete';\n\n/** A 1-based, inclusive line range within a document. */\nexport type LineRange = {\n  start: number;\n  end: number;\n};\n\n/**\n * A single block that diverges between the base document and its translation.\n *\n * This is the unit an external translator (AI client, human, or agent) needs to\n * act on: it carries the base content to translate, the existing translation to\n * update, and where each lives so the change can be located in the file.\n */\nexport type ReviewReportBlock = {\n  /** What should happen to this block. */\n  action: ReviewBlockAction;\n  /** Line range of the block in the base document (omitted for pure deletions). */\n  baseLineRange?: LineRange;\n  /** Line range of the block in the target document (omitted for new insertions). */\n  targetLineRange?: LineRange;\n  /** Raw markdown of the base block (omitted for pure deletions). */\n  baseContent?: string;\n  /** Existing translation of the block (omitted for new insertions). */\n  targetContent?: string;\n};\n\nexport type ReviewReportSummary = {\n  /** Number of blocks reused as-is (unchanged translation). */\n  reuse: number;\n  /** Number of blocks whose translation must be updated. */\n  review: number;\n  /** Number of blocks missing a translation. */\n  insertNew: number;\n  /** Number of stale target blocks to delete. */\n  delete: number;\n};\n\nexport type ReviewReport = {\n  /** Only the blocks that diverge (review, insert_new, delete). */\n  blocks: ReviewReportBlock[];\n  /** Counts per action over the whole document, including reused blocks. */\n  summary: ReviewReportSummary;\n};\n\nexport type BuildReviewReportInput = {\n  /** The base (source) document, used as the translation reference. */\n  baseText: string;\n  /** The existing target (translated) document, possibly empty. */\n  targetText: string;\n  /**\n   * 1-based line numbers that changed in the base document.\n   *\n   * When omitted the whole document is compared, and only inserted and deleted\n   * blocks are reported (no aligned block is flagged for review since there is\n   * no way to know which ones changed). An empty array means nothing changed,\n   * and no block at all is reported.\n   */\n  changedLines?: number[];\n};\n\n/**\n * Compare a base markdown document with its translation and report only the\n * blocks that need attention, with their line ranges and content.\n *\n * Reusable across the CLI (`doc review --log`), the backend (comparing two\n * translation contents stored in database), and agents that generate the\n * missing translations.\n *\n * @param input - The base/target texts and optional changed lines.\n * @returns The divergent blocks and a per-action summary.\n */\nexport const buildReviewReport = ({\n  baseText,\n  targetText,\n  changedLines,\n}: BuildReviewReportInput): ReviewReport => {\n  const { baseBlocks, targetBlocks, plan } = buildAlignmentPlan({\n    baseText,\n    targetText,\n    changedLines,\n  });\n\n  const summary: ReviewReportSummary = {\n    reuse: 0,\n    review: 0,\n    insertNew: 0,\n    delete: 0,\n  };\n\n  const blocks: ReviewReportBlock[] = [];\n\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'reuse') {\n      summary.reuse += 1;\n      continue;\n    }\n\n    if (action.kind === 'review') {\n      summary.review += 1;\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) continue;\n\n      const targetBlock =\n        action.targetIndex !== null ? targetBlocks[action.targetIndex] : null;\n\n      blocks.push({\n        action: 'review',\n        baseLineRange: { start: baseBlock.lineStart, end: baseBlock.lineEnd },\n        targetLineRange: targetBlock\n          ? { start: targetBlock.lineStart, end: targetBlock.lineEnd }\n          : undefined,\n        baseContent: baseBlock.content,\n        targetContent: targetBlock?.content,\n      });\n      continue;\n    }\n\n    if (action.kind === 'insert_new') {\n      summary.insertNew += 1;\n      const baseBlock = baseBlocks[action.baseIndex];\n\n      if (!baseBlock) continue;\n\n      // Find the target line after which the new block should be inserted:\n      // scan backwards for the last action that produced a target block.\n      let insertAfterLine: number | undefined;\n      for (let prevIndex = actionIndex - 1; prevIndex >= 0; prevIndex--) {\n        const prevAction = plan.actions[prevIndex];\n        if (!prevAction) continue;\n\n        let targetIdx: number | null = null;\n        if (prevAction.kind === 'reuse') targetIdx = prevAction.targetIndex;\n        else if (\n          prevAction.kind === 'review' &&\n          prevAction.targetIndex !== null\n        )\n          targetIdx = prevAction.targetIndex;\n        else if (prevAction.kind === 'delete')\n          targetIdx = prevAction.targetIndex;\n\n        if (targetIdx !== null) {\n          const prevTargetBlock = targetBlocks[targetIdx];\n          if (prevTargetBlock) {\n            insertAfterLine = prevTargetBlock.lineEnd + 1;\n            break;\n          }\n        }\n      }\n\n      blocks.push({\n        action: 'insert_new',\n        baseLineRange: { start: baseBlock.lineStart, end: baseBlock.lineEnd },\n        targetLineRange:\n          insertAfterLine !== undefined\n            ? { start: insertAfterLine, end: insertAfterLine }\n            : undefined,\n        baseContent: baseBlock.content,\n      });\n      continue;\n    }\n\n    if (action.kind === 'delete') {\n      summary.delete += 1;\n      const targetBlock = targetBlocks[action.targetIndex];\n\n      if (!targetBlock) continue;\n\n      blocks.push({\n        action: 'delete',\n        targetLineRange: {\n          start: targetBlock.lineStart,\n          end: targetBlock.lineEnd,\n        },\n        targetContent: targetBlock.content,\n      });\n    }\n  }\n\n  return { blocks, summary };\n};\n\n/** Render a line range as a blue colored string, or an orange dash when absent. */\nconst colorizeLineRange = (range?: LineRange): string => {\n  if (!range) return colorize('—', ANSIColors.ORANGE);\n  const rangeStr =\n    range.start === range.end\n      ? `L${range.start}`\n      : `L${range.start}-${range.end}`;\n  return colorize(rangeStr, ANSIColors.BLUE);\n};\n\n/**\n * Colorize a count with green when zero (nothing to do) and a caller-supplied\n * non-zero color (orange for warnings, red for destructive actions).\n */\nconst colorizeCount = (count: number, nonZeroColor: ANSIColorsType): string =>\n  colorizeNumber(count, {\n    zero: ANSIColors.GREEN,\n    one: nonZeroColor,\n    two: nonZeroColor,\n    few: nonZeroColor,\n    many: nonZeroColor,\n    other: nonZeroColor,\n  });\n\n/**\n * Render a {@link ReviewReport} as a human and agent readable log.\n *\n * Each divergent block is printed with its action, the base/target line ranges,\n * the base content to translate, and the existing translation to update.\n *\n * @param report - The report to format.\n * @param options - Optional labels for the base and target locales.\n * @returns A multi-line string describing every block that needs attention.\n */\nexport const formatReviewReport = (\n  report: ReviewReport,\n  options?: { baseLabel?: string; targetLabel?: string }\n): string => {\n  const baseLabel = options?.baseLabel ?? 'base';\n  const targetLabel = options?.targetLabel ?? 'target';\n\n  const { summary, blocks } = report;\n\n  // Build the summary header piece-by-piece so each count uses its own color.\n  const header = [\n    colorize('Review report: ', ANSIColors.ORANGE),\n    colorizeCount(blocks.length, ANSIColors.ORANGE),\n    colorize(' block(s) need attention (review=', ANSIColors.ORANGE),\n    colorizeCount(summary.review, ANSIColors.ORANGE),\n    colorize(', new=', ANSIColors.ORANGE),\n    colorizeCount(summary.insertNew, ANSIColors.ORANGE),\n    colorize(', delete=', ANSIColors.ORANGE),\n    colorizeCount(summary.delete, ANSIColors.RED),\n    colorize(', reuse=', ANSIColors.ORANGE),\n    colorizeNumber(summary.reuse),\n    colorize(').', ANSIColors.ORANGE),\n  ].join('');\n\n  if (blocks.length === 0) {\n    return `${header}\\n${colorize('No changes needed.', ANSIColors.GREEN)}`;\n  }\n\n  const sections = blocks.map((block, index) => {\n    const lines: string[] = [];\n\n    // Block header: each token colored individually.\n    const blockHeader = [\n      colorize('--- Block ', ANSIColors.ORANGE),\n      colorizeNumber(index + 1),\n      colorize('/', ANSIColors.ORANGE),\n      colorizeNumber(blocks.length),\n      colorize(` [${block.action}] `, ANSIColors.ORANGE),\n      baseLabel,\n      colorize(' ', ANSIColors.ORANGE),\n      colorizeLineRange(block.baseLineRange),\n      colorize(' → ', ANSIColors.ORANGE),\n      targetLabel,\n      colorize(' ', ANSIColors.ORANGE),\n      colorizeLineRange(block.targetLineRange),\n      colorize(' ---', ANSIColors.ORANGE),\n    ].join('');\n\n    lines.push(blockHeader);\n\n    if (block.baseContent !== undefined) {\n      lines.push(colorize(`[${baseLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize(block.baseContent.trimEnd(), ANSIColors.GREY));\n    }\n\n    if (block.targetContent !== undefined) {\n      lines.push(colorize(`[${targetLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize(block.targetContent.trimEnd(), ANSIColors.GREY));\n    } else if (block.action === 'insert_new') {\n      lines.push(colorize(`[${targetLabel}]`, ANSIColors.BEIGE));\n      lines.push(colorize('(missing — to be translated)', ANSIColors.ORANGE));\n    }\n\n    return lines.join('\\n');\n  });\n\n  const editingNote = colorize(\n    'Tip: start editing from the last block — working bottom-up keeps earlier line numbers accurate.',\n    ANSIColors.GREY\n  );\n\n  return [header, '', ...sections, '', editingNote].join('\\n');\n};\n"],"mappings":"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"}

package/dist/esm/docReview/segmentDocument.mjs

@@ -1,7 +1,7 @@
 //#region src/docReview/segmentDocument.ts
 const HEADING_PATTERN = /^\s*(#{1,6})\s+/;
-const isBlankLine = (line) => line.trim().length === 0;
-const isFencedCodeDelimiter = (line) => /^\s*```/.test(line);
+const isBlankLine = (line) => !line || line.trim().length === 0;
+const isFencedCodeDelimiter = (line) => Boolean(line && /^\s*```/.test(line));
 /**
 * Read the depth of an ATX markdown heading (`#` → 1, `######` → 6).
 *
@@ -9,10 +9,11 @@ const isFencedCodeDelimiter = (line) => /^\s*```/.test(line);
 * @returns The heading depth, or `null` when the line is not a heading.
 */
 const parseHeadingDepth = (line) => {
+	if (!line) return null;
 	return HEADING_PATTERN.exec(line)?.[1]?.length ?? null;
 };
 const isHeading = (line) => parseHeadingDepth(line) !== null;
-const isFrontmatterDelimiter = (line) => /^\s*---\s*$/.test(line);
+const isFrontmatterDelimiter = (line) => Boolean(line && /^\s*---\s*$/.test(line));
 /**
 * Split a markdown document into fine-grained blocks.
 *
@@ -87,7 +88,8 @@ const segmentDocument = (text) => {
 	if (units.length === 0) return [];
 	return units.map((unit, unitIndex) => {
 		const blockStartIndex = unitIndex === 0 ? 0 : unit.startIndex;
-		const blockEndIndex = unitIndex === units.length - 1 ? lineCount - 1 : units[unitIndex + 1].startIndex - 1;
+		const nextUnit = units[unitIndex + 1];
+		const blockEndIndex = unitIndex === units.length - 1 || !nextUnit ? lineCount - 1 : nextUnit.startIndex - 1;
 		const blockLines = lines.slice(blockStartIndex, blockEndIndex + 1);
 		const content = blockEndIndex < lineCount - 1 ? `${blockLines.join("\n")}\n` : blockLines.join("\n");
 		return {
@@ -123,8 +125,9 @@ const segmentSections = (text) => {
 	let currentBlocks = [];
 	const flushSection = () => {
 		if (currentBlocks.length === 0) return;
-		const [firstBlock] = currentBlocks;
+		const firstBlock = currentBlocks[0];
 		const lastBlock = currentBlocks[currentBlocks.length - 1];
+		if (!firstBlock || !lastBlock) return;
 		sections.push({
 			type: firstBlock.type,
 			content: currentBlocks.map((block) => block.content).join(""),

package/dist/esm/docReview/segmentDocument.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"segmentDocument.mjs","names":[],"sources":["../../../src/docReview/segmentDocument.ts"],"sourcesContent":["import type { Block, BlockType } from './types';\n\nconst HEADING_PATTERN = /^\\s*(#{1,6})\\s+/;\n\nconst isBlankLine = (line: string): boolean => line.trim().length === 0;\nconst isFencedCodeDelimiter = (line: string): boolean => /^\\s*```/.test(line);\n\n/**\n * Read the depth of an ATX markdown heading (`#` → 1, `######` → 6).\n *\n * @param line - The line to inspect.\n * @returns The heading depth, or `null` when the line is not a heading.\n */\nconst parseHeadingDepth = (line: string): number | null => {\n  const match = HEADING_PATTERN.exec(line);\n\n  return match?.[1]?.length ?? null;\n};\n\nconst isHeading = (line: string): boolean => parseHeadingDepth(line) !== null;\nconst isFrontmatterDelimiter = (line: string): boolean =>\n  /^\\s*---\\s*$/.test(line);\n\n/**\n * A content unit (heading, paragraph, code block or frontmatter) spanning a\n * 0-based, inclusive line range. Blank-line runs are not units of their own;\n * they are folded into the preceding unit as trailing separators (see\n * {@link segmentDocument}) so that the concatenation of every block's content\n * reproduces the document byte-for-byte.\n */\ntype ContentUnit = {\n  type: BlockType;\n  /** Depth of the ATX heading opening the unit, `null` when it is not a heading. */\n  headingDepth: number | null;\n  startIndex: number;\n  endIndex: number;\n};\n\n/**\n * Split a markdown document into fine-grained blocks.\n *\n * Boundaries are drawn at headings, blank lines (paragraph breaks) and fenced\n * code blocks, while frontmatter and the inside of code fences are kept intact.\n * Each blank-line run is appended to the block that precedes it, so the blocks\n * form an exact partition of the document: concatenating every `content` (in\n * order) yields the original text unchanged. This is what lets the block-aware\n * review re-translate only the paragraphs/snippets that actually changed instead\n * of the whole heading section.\n *\n * @param text - The full markdown document.\n * @returns The ordered list of blocks with their 1-based line ranges.\n */\nexport const segmentDocument = (text: string): Block[] => {\n  const lines = text.split('\\n');\n  const lineCount = lines.length;\n\n  // 1. Tokenize into content units, skipping blank-line runs (folded in below).\n  const units: ContentUnit[] = [];\n  let index = 0;\n\n  while (index < lineCount) {\n    const currentLine = lines[index];\n\n    if (isBlankLine(currentLine)) {\n      index += 1;\n      continue;\n    }\n\n    // Frontmatter: only when it opens the document.\n    if (units.length === 0 && isFrontmatterDelimiter(currentLine)) {\n      const startIndex = index;\n      index += 1;\n      while (index < lineCount && !isFrontmatterDelimiter(lines[index])) {\n        index += 1;\n      }\n      // Include the closing delimiter when present.\n      if (index < lineCount) index += 1;\n      units.push({\n        type: 'unknown',\n        headingDepth: null,\n        startIndex,\n        endIndex: index - 1,\n      });\n      continue;\n    }\n\n    // Fenced code block: consumed whole so inner blank lines and `#` lines are\n    // never treated as boundaries.\n    if (isFencedCodeDelimiter(currentLine)) {\n      const startIndex = index;\n      index += 1;\n      while (index < lineCount && !isFencedCodeDelimiter(lines[index])) {\n        index += 1;\n      }\n      // Include the closing fence when present.\n      if (index < lineCount) index += 1;\n      units.push({\n        type: 'code_block',\n        headingDepth: null,\n        startIndex,\n        endIndex: index - 1,\n      });\n      continue;\n    }\n\n    // Heading: a single self-contained line.\n    const headingDepth = parseHeadingDepth(currentLine);\n\n    if (headingDepth !== null) {\n      units.push({\n        type: 'heading',\n        headingDepth,\n        startIndex: index,\n        endIndex: index,\n      });\n      index += 1;\n      continue;\n    }\n\n    // Paragraph: a run of consecutive lines until a blank line, a heading or a\n    // code fence. Tables and tight lists stay together (no blank line between\n    // their rows/items).\n    const startIndex = index;\n    while (\n      index < lineCount &&\n      !isBlankLine(lines[index]) &&\n      !isHeading(lines[index]) &&\n      !isFencedCodeDelimiter(lines[index])\n    ) {\n      index += 1;\n    }\n    units.push({\n      type: 'paragraph',\n      headingDepth: null,\n      startIndex,\n      endIndex: index - 1,\n    });\n  }\n\n  if (units.length === 0) return [];\n\n  // 2. Turn each unit into a block whose line range extends to just before the\n  //    next unit, so the trailing blank-line run is owned by it. The first block\n  //    also absorbs any leading blank lines, and the last block runs to EOF.\n  return units.map((unit, unitIndex): Block => {\n    const blockStartIndex = unitIndex === 0 ? 0 : unit.startIndex;\n    const blockEndIndex =\n      unitIndex === units.length - 1\n        ? lineCount - 1\n        : units[unitIndex + 1].startIndex - 1;\n\n    const blockLines = lines.slice(blockStartIndex, blockEndIndex + 1);\n    // Re-append the boundary newline dropped by `split` for every block but the\n    // one ending at EOF, so concatenating all blocks rebuilds the document.\n    const content =\n      blockEndIndex < lineCount - 1\n        ? `${blockLines.join('\\n')}\\n`\n        : blockLines.join('\\n');\n\n    return {\n      type: unit.type,\n      content,\n      headingDepth: unit.headingDepth,\n      lineStart: blockStartIndex + 1,\n      lineEnd: blockEndIndex + 1,\n    };\n  });\n};\n\n/**\n * Split a markdown document into coarse, heading-anchored sections.\n *\n * Built by grouping the fine blocks of {@link segmentDocument}: frontmatter and\n * each heading open a new section, and the following non-heading blocks are\n * folded into it. Because it only concatenates adjacent fine blocks, the result\n * is still an exact partition of the document (sections concatenate back to the\n * source unchanged).\n *\n * Sections are the robust alignment unit between a base document and its\n * translation — both share the same heading structure, so they align almost\n * perfectly and a translation that splits its prose into a different number of\n * paragraphs never causes a section to be dropped. Fine-grained review happens\n * within a section once it is known to have changed.\n *\n * @param text - The full markdown document.\n * @returns The ordered list of sections with their 1-based line ranges.\n */\nexport const segmentSections = (text: string): Block[] => {\n  const fineBlocks = segmentDocument(text);\n  const sections: Block[] = [];\n  let currentBlocks: Block[] = [];\n\n  const flushSection = (): void => {\n    if (currentBlocks.length === 0) return;\n\n    const [firstBlock] = currentBlocks;\n    const lastBlock = currentBlocks[currentBlocks.length - 1];\n\n    sections.push({\n      type: firstBlock.type,\n      content: currentBlocks.map((block) => block.content).join(''),\n      // A section is identified by the heading that opens it, so it inherits its\n      // depth — this is what keeps a `##` section from aligning with a `###` one.\n      headingDepth: firstBlock.headingDepth,\n      lineStart: firstBlock.lineStart,\n      lineEnd: lastBlock.lineEnd,\n    });\n    currentBlocks = [];\n  };\n\n  for (const block of fineBlocks) {\n    // Frontmatter (a leading `unknown` block) and every heading open a section.\n    const opensSection =\n      block.type === 'heading' ||\n      (block.type === 'unknown' && sections.length === 0);\n\n    if (opensSection) flushSection();\n    currentBlocks.push(block);\n    if (block.type === 'unknown' && sections.length === 0) flushSection();\n  }\n\n  flushSection();\n\n  return sections;\n};\n"],"mappings":"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"}
+{"version":3,"file":"segmentDocument.mjs","names":[],"sources":["../../../src/docReview/segmentDocument.ts"],"sourcesContent":["import type { Block, BlockType } from './types';\n\nconst HEADING_PATTERN = /^\\s*(#{1,6})\\s+/;\n\nconst isBlankLine = (line?: string): boolean =>\n  !line || line.trim().length === 0;\nconst isFencedCodeDelimiter = (line?: string): boolean =>\n  Boolean(line && /^\\s*```/.test(line));\n\n/**\n * Read the depth of an ATX markdown heading (`#` → 1, `######` → 6).\n *\n * @param line - The line to inspect.\n * @returns The heading depth, or `null` when the line is not a heading.\n */\nconst parseHeadingDepth = (line?: string): number | null => {\n  if (!line) return null;\n  const match = HEADING_PATTERN.exec(line);\n\n  return match?.[1]?.length ?? null;\n};\n\nconst isHeading = (line?: string): boolean => parseHeadingDepth(line) !== null;\nconst isFrontmatterDelimiter = (line?: string): boolean =>\n  Boolean(line && /^\\s*---\\s*$/.test(line));\n\n/**\n * A content unit (heading, paragraph, code block or frontmatter) spanning a\n * 0-based, inclusive line range. Blank-line runs are not units of their own;\n * they are folded into the preceding unit as trailing separators (see\n * {@link segmentDocument}) so that the concatenation of every block's content\n * reproduces the document byte-for-byte.\n */\ntype ContentUnit = {\n  type: BlockType;\n  /** Depth of the ATX heading opening the unit, `null` when it is not a heading. */\n  headingDepth: number | null;\n  startIndex: number;\n  endIndex: number;\n};\n\n/**\n * Split a markdown document into fine-grained blocks.\n *\n * Boundaries are drawn at headings, blank lines (paragraph breaks) and fenced\n * code blocks, while frontmatter and the inside of code fences are kept intact.\n * Each blank-line run is appended to the block that precedes it, so the blocks\n * form an exact partition of the document: concatenating every `content` (in\n * order) yields the original text unchanged. This is what lets the block-aware\n * review re-translate only the paragraphs/snippets that actually changed instead\n * of the whole heading section.\n *\n * @param text - The full markdown document.\n * @returns The ordered list of blocks with their 1-based line ranges.\n */\nexport const segmentDocument = (text: string): Block[] => {\n  const lines = text.split('\\n');\n  const lineCount = lines.length;\n\n  // 1. Tokenize into content units, skipping blank-line runs (folded in below).\n  const units: ContentUnit[] = [];\n  let index = 0;\n\n  while (index < lineCount) {\n    const currentLine = lines[index];\n\n    if (isBlankLine(currentLine)) {\n      index += 1;\n      continue;\n    }\n\n    // Frontmatter: only when it opens the document.\n    if (units.length === 0 && isFrontmatterDelimiter(currentLine)) {\n      const startIndex = index;\n      index += 1;\n      while (index < lineCount && !isFrontmatterDelimiter(lines[index])) {\n        index += 1;\n      }\n      // Include the closing delimiter when present.\n      if (index < lineCount) index += 1;\n      units.push({\n        type: 'unknown',\n        headingDepth: null,\n        startIndex,\n        endIndex: index - 1,\n      });\n      continue;\n    }\n\n    // Fenced code block: consumed whole so inner blank lines and `#` lines are\n    // never treated as boundaries.\n    if (isFencedCodeDelimiter(currentLine)) {\n      const startIndex = index;\n      index += 1;\n      while (index < lineCount && !isFencedCodeDelimiter(lines[index])) {\n        index += 1;\n      }\n      // Include the closing fence when present.\n      if (index < lineCount) index += 1;\n      units.push({\n        type: 'code_block',\n        headingDepth: null,\n        startIndex,\n        endIndex: index - 1,\n      });\n      continue;\n    }\n\n    // Heading: a single self-contained line.\n    const headingDepth = parseHeadingDepth(currentLine);\n\n    if (headingDepth !== null) {\n      units.push({\n        type: 'heading',\n        headingDepth,\n        startIndex: index,\n        endIndex: index,\n      });\n      index += 1;\n      continue;\n    }\n\n    // Paragraph: a run of consecutive lines until a blank line, a heading or a\n    // code fence. Tables and tight lists stay together (no blank line between\n    // their rows/items).\n    const startIndex = index;\n    while (\n      index < lineCount &&\n      !isBlankLine(lines[index]) &&\n      !isHeading(lines[index]) &&\n      !isFencedCodeDelimiter(lines[index])\n    ) {\n      index += 1;\n    }\n    units.push({\n      type: 'paragraph',\n      headingDepth: null,\n      startIndex,\n      endIndex: index - 1,\n    });\n  }\n\n  if (units.length === 0) return [];\n\n  // 2. Turn each unit into a block whose line range extends to just before the\n  //    next unit, so the trailing blank-line run is owned by it. The first block\n  //    also absorbs any leading blank lines, and the last block runs to EOF.\n  return units.map((unit, unitIndex): Block => {\n    const blockStartIndex = unitIndex === 0 ? 0 : unit.startIndex;\n    const nextUnit = units[unitIndex + 1];\n    const blockEndIndex =\n      unitIndex === units.length - 1 || !nextUnit\n        ? lineCount - 1\n        : nextUnit.startIndex - 1;\n\n    const blockLines = lines.slice(blockStartIndex, blockEndIndex + 1);\n    // Re-append the boundary newline dropped by `split` for every block but the\n    // one ending at EOF, so concatenating all blocks rebuilds the document.\n    const content =\n      blockEndIndex < lineCount - 1\n        ? `${blockLines.join('\\n')}\\n`\n        : blockLines.join('\\n');\n\n    return {\n      type: unit.type,\n      content,\n      headingDepth: unit.headingDepth,\n      lineStart: blockStartIndex + 1,\n      lineEnd: blockEndIndex + 1,\n    };\n  });\n};\n\n/**\n * Split a markdown document into coarse, heading-anchored sections.\n *\n * Built by grouping the fine blocks of {@link segmentDocument}: frontmatter and\n * each heading open a new section, and the following non-heading blocks are\n * folded into it. Because it only concatenates adjacent fine blocks, the result\n * is still an exact partition of the document (sections concatenate back to the\n * source unchanged).\n *\n * Sections are the robust alignment unit between a base document and its\n * translation — both share the same heading structure, so they align almost\n * perfectly and a translation that splits its prose into a different number of\n * paragraphs never causes a section to be dropped. Fine-grained review happens\n * within a section once it is known to have changed.\n *\n * @param text - The full markdown document.\n * @returns The ordered list of sections with their 1-based line ranges.\n */\nexport const segmentSections = (text: string): Block[] => {\n  const fineBlocks = segmentDocument(text);\n  const sections: Block[] = [];\n  let currentBlocks: Block[] = [];\n\n  const flushSection = (): void => {\n    if (currentBlocks.length === 0) return;\n\n    const firstBlock = currentBlocks[0];\n    const lastBlock = currentBlocks[currentBlocks.length - 1];\n\n    if (!firstBlock || !lastBlock) return;\n\n    sections.push({\n      type: firstBlock.type,\n      content: currentBlocks.map((block) => block.content).join(''),\n      // A section is identified by the heading that opens it, so it inherits its\n      // depth — this is what keeps a `##` section from aligning with a `###` one.\n      headingDepth: firstBlock.headingDepth,\n      lineStart: firstBlock.lineStart,\n      lineEnd: lastBlock.lineEnd,\n    });\n    currentBlocks = [];\n  };\n\n  for (const block of fineBlocks) {\n    // Frontmatter (a leading `unknown` block) and every heading open a section.\n    const opensSection =\n      block.type === 'heading' ||\n      (block.type === 'unknown' && sections.length === 0);\n\n    if (opensSection) flushSection();\n    currentBlocks.push(block);\n    if (block.type === 'unknown' && sections.length === 0) flushSection();\n  }\n\n  flushSection();\n\n  return sections;\n};\n"],"mappings":"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"}

package/dist/esm/init/cms.mjs

@@ -1,4 +1,4 @@
-import { enableIntlayerEditorConfig, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode } from "./utils/configManipulation.mjs";
+import { enableIntlayerEditorConfig, setIntlayerConfigCompilerOutput, setIntlayerConfigEnableProxy, setIntlayerConfigRoutingMode, setIntlayerConfigRoutingStorageOnly } from "./utils/configManipulation.mjs";
 import { exists, readFileFromRoot, writeFileToRoot } from "./utils/fileSystem.mjs";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, colorizePath, logger, v, x } from "@intlayer/config/logger";
@@ -117,6 +117,39 @@ const setRoutingModeInConfig = async (rootDir, mode) => {
 	return configFile;
 };
 /**
+* Sets `routing.enableProxy` in the project's Intlayer configuration file.
+* Returns the config file that was updated, or `undefined` when none was found.
+*/
+const setEnableProxyInConfig = async (rootDir, enableProxy) => {
+	const configFile = await findIntlayerConfigFile(rootDir);
+	if (!configFile) return void 0;
+	const extension = configFile.split(".").pop();
+	const content = await readFileFromRoot(rootDir, configFile);
+	const updatedContent = setIntlayerConfigEnableProxy(content, extension, enableProxy);
+	if (updatedContent !== content) {
+		await writeFileToRoot(rootDir, configFile, updatedContent);
+		logger(`${v} Set ${colorize(`routing.enableProxy = ${enableProxy}`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`);
+	}
+	return configFile;
+};
+/**
+* Reduces `routing` in the project's Intlayer configuration file to its
+* `storage` entry. Returns the config file that was updated, or `undefined`
+* when none was found.
+*/
+const setRoutingStorageOnlyInConfig = async (rootDir) => {
+	const configFile = await findIntlayerConfigFile(rootDir);
+	if (!configFile) return void 0;
+	const extension = configFile.split(".").pop();
+	const content = await readFileFromRoot(rootDir, configFile);
+	const updatedContent = setIntlayerConfigRoutingStorageOnly(content, extension);
+	if (updatedContent !== content) {
+		await writeFileToRoot(rootDir, configFile, updatedContent);
+		logger(`${v} Kept only ${colorize("routing.storage", ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)} (no URL routing in this project)`);
+	}
+	return configFile;
+};
+/**
 * Sets `compiler.output` in the project's Intlayer configuration file to the
 * given `{{variable}}` path template. Returns the config file that was updated,
 * or `undefined` when none was found.
@@ -144,5 +177,5 @@ const setupCmsCredentials = async (rootDir, credentials) => {
 };
 
 //#endregion
-export { INTLAYER_CONFIG_FILE_CANDIDATES, enableEditorInConfig, findEnvFile, setCompilerOutputInConfig, setRoutingModeInConfig, setupCmsCredentials, writeCmsCredentialsToEnv };
+export { INTLAYER_CONFIG_FILE_CANDIDATES, enableEditorInConfig, findEnvFile, setCompilerOutputInConfig, setEnableProxyInConfig, setRoutingModeInConfig, setRoutingStorageOnlyInConfig, setupCmsCredentials, writeCmsCredentialsToEnv };
 //# sourceMappingURL=cms.mjs.map

package/dist/esm/init/cms.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cms.mjs","names":[],"sources":["../../../src/init/cms.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport fg from 'fast-glob';\nimport {\n  enableIntlayerEditorConfig,\n  type RoutingMode,\n  setIntlayerConfigCompilerOutput,\n  setIntlayerConfigRoutingMode,\n} from './utils/configManipulation';\nimport { exists, readFileFromRoot, writeFileToRoot } from './utils/fileSystem';\n\n/**\n * Intlayer configuration file candidates, ordered by the precedence used when\n * resolving which file to mutate.\n */\nexport const INTLAYER_CONFIG_FILE_CANDIDATES = [\n  'intlayer.config.ts',\n  'intlayer.config.mjs',\n  'intlayer.config.js',\n  'intlayer.config.cjs',\n  'intlayer.config.json',\n] as const;\n\n/**\n * Environment files searched (most-preferred first) when persisting the CMS\n * credentials. The first existing match is reused; otherwise a `.env` file is\n * created at the project root.\n */\nconst ENV_FILE_CANDIDATES = ['.env', '.env.local', '.env.development'] as const;\n\n/** Credentials returned by the CMS login flow (access key pair). */\nexport type CmsCredentials = {\n  clientId: string;\n  clientSecret: string;\n};\n\n/**\n * Resolves the first existing Intlayer configuration file at the project root,\n * or `undefined` when none is present.\n */\nconst findIntlayerConfigFile = async (\n  rootDir: string\n): Promise<(typeof INTLAYER_CONFIG_FILE_CANDIDATES)[number] | undefined> => {\n  for (const candidate of INTLAYER_CONFIG_FILE_CANDIDATES) {\n    if (await exists(rootDir, candidate)) {\n      return candidate;\n    }\n  }\n\n  return undefined;\n};\n\n/**\n * Locates the environment file the CMS credentials should be written to. Uses\n * `fast-glob` to detect an existing dotenv file at the project root, preferring\n * a plain `.env`; falls back to `.env` (to be created) when none exist.\n */\nexport const findEnvFile = async (rootDir: string): Promise<string> => {\n  const matches = await fg([...ENV_FILE_CANDIDATES], {\n    cwd: rootDir,\n    dot: true,\n    deep: 1,\n    onlyFiles: true,\n  });\n\n  return (\n    ENV_FILE_CANDIDATES.find((candidate) => matches.includes(candidate)) ??\n    '.env'\n  );\n};\n\n/**\n * Inserts or updates a `KEY=value` line in dotenv file content. An existing\n * assignment of the same key is replaced in place; otherwise the line is\n * appended with a trailing newline.\n */\nconst upsertEnvVariable = (\n  content: string,\n  key: string,\n  value: string\n): string => {\n  const line = `${key}=${value}`;\n  const keyMatcher = new RegExp(`^${key}=.*$`, 'm');\n\n  if (keyMatcher.test(content)) {\n    return content.replace(keyMatcher, line);\n  }\n\n  const needsLeadingNewline = content.length > 0 && !content.endsWith('\\n');\n\n  return `${content}${needsLeadingNewline ? '\\n' : ''}${line}\\n`;\n};\n\n/**\n * Persists the CMS access-key credentials to the project's environment file as\n * `INTLAYER_CLIENT_ID` / `INTLAYER_CLIENT_SECRET`. The target file is detected\n * with {@link findEnvFile} and created when missing. Returns the relative path\n * of the file that was written.\n */\nexport const writeCmsCredentialsToEnv = async (\n  rootDir: string,\n  { clientId, clientSecret }: CmsCredentials\n): Promise<string> => {\n  const envFile = await findEnvFile(rootDir);\n\n  let content = '';\n  if (await exists(rootDir, envFile)) {\n    content = await readFileFromRoot(rootDir, envFile);\n  }\n\n  let updatedContent = content;\n  updatedContent = upsertEnvVariable(\n    updatedContent,\n    'INTLAYER_CLIENT_ID',\n    clientId\n  );\n  updatedContent = upsertEnvVariable(\n    updatedContent,\n    'INTLAYER_CLIENT_SECRET',\n    clientSecret\n  );\n\n  await writeFileToRoot(rootDir, envFile, updatedContent);\n  logger(\n    `${v} Saved Intlayer CMS credentials to ${colorizePath(envFile)} (${colorize('INTLAYER_CLIENT_ID', ANSIColors.GREY_LIGHT)}, ${colorize('INTLAYER_CLIENT_SECRET', ANSIColors.GREY_LIGHT)})`\n  );\n\n  return envFile;\n};\n\n/**\n * Enables the Intlayer visual editor in the project's configuration file:\n * flips `editor.enabled` to `true` and wires `clientId` / `clientSecret` to the\n * matching environment variables. JSON configs cannot reference `process.env`,\n * so they are skipped with a warning. Returns the config file that was updated,\n * or `undefined` when no editable config was found.\n */\nexport const enableEditorInConfig = async (\n  rootDir: string\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) {\n    logger(\n      `${x} Could not find an Intlayer configuration file to enable the editor.`,\n      { level: 'warn' }\n    );\n    return undefined;\n  }\n\n  const extension = configFile.split('.').pop()!;\n\n  if (extension === 'json') {\n    logger(\n      `${x} ${colorizePath(configFile)} is a JSON config and cannot reference environment variables. Enable the editor and set clientId/clientSecret manually.`,\n      { level: 'warn' }\n    );\n    return undefined;\n  }\n\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = enableIntlayerEditorConfig(content);\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(`${v} Enabled the Intlayer editor in ${colorizePath(configFile)}`);\n  } else {\n    logger(\n      `${v} ${colorizePath(configFile)} already has the Intlayer editor enabled`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Sets `routing.mode` in the project's Intlayer configuration file. Returns the\n * config file that was updated, or `undefined` when none was found.\n */\nexport const setRoutingModeInConfig = async (\n  rootDir: string,\n  mode: RoutingMode\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigRoutingMode(content, extension, mode);\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Set ${colorize(`routing.mode = '${mode}'`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Sets `compiler.output` in the project's Intlayer configuration file to the\n * given `{{variable}}` path template. Returns the config file that was updated,\n * or `undefined` when none was found.\n */\nexport const setCompilerOutputInConfig = async (\n  rootDir: string,\n  outputTemplate: string\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigCompilerOutput(\n    content,\n    extension,\n    outputTemplate\n  );\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Set ${colorize(`compiler.output = '${outputTemplate}'`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Completes the CMS setup once credentials are received from the login flow:\n * writes them to the environment file and enables the editor in the Intlayer\n * configuration file.\n */\nexport const setupCmsCredentials = async (\n  rootDir: string,\n  credentials: CmsCredentials\n): Promise<void> => {\n  await writeCmsCredentialsToEnv(rootDir, credentials);\n  await enableEditorInConfig(rootDir);\n};\n"],"mappings":"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"}
+{"version":3,"file":"cms.mjs","names":[],"sources":["../../../src/init/cms.ts"],"sourcesContent":["import * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizePath, logger, v, x } from '@intlayer/config/logger';\nimport fg from 'fast-glob';\nimport {\n  enableIntlayerEditorConfig,\n  type RoutingMode,\n  setIntlayerConfigCompilerOutput,\n  setIntlayerConfigEnableProxy,\n  setIntlayerConfigRoutingMode,\n  setIntlayerConfigRoutingStorageOnly,\n} from './utils/configManipulation';\nimport { exists, readFileFromRoot, writeFileToRoot } from './utils/fileSystem';\n\n/**\n * Intlayer configuration file candidates, ordered by the precedence used when\n * resolving which file to mutate.\n */\nexport const INTLAYER_CONFIG_FILE_CANDIDATES = [\n  'intlayer.config.ts',\n  'intlayer.config.mjs',\n  'intlayer.config.js',\n  'intlayer.config.cjs',\n  'intlayer.config.json',\n] as const;\n\n/**\n * Environment files searched (most-preferred first) when persisting the CMS\n * credentials. The first existing match is reused; otherwise a `.env` file is\n * created at the project root.\n */\nconst ENV_FILE_CANDIDATES = ['.env', '.env.local', '.env.development'] as const;\n\n/** Credentials returned by the CMS login flow (access key pair). */\nexport type CmsCredentials = {\n  clientId: string;\n  clientSecret: string;\n};\n\n/**\n * Resolves the first existing Intlayer configuration file at the project root,\n * or `undefined` when none is present.\n */\nconst findIntlayerConfigFile = async (\n  rootDir: string\n): Promise<(typeof INTLAYER_CONFIG_FILE_CANDIDATES)[number] | undefined> => {\n  for (const candidate of INTLAYER_CONFIG_FILE_CANDIDATES) {\n    if (await exists(rootDir, candidate)) {\n      return candidate;\n    }\n  }\n\n  return undefined;\n};\n\n/**\n * Locates the environment file the CMS credentials should be written to. Uses\n * `fast-glob` to detect an existing dotenv file at the project root, preferring\n * a plain `.env`; falls back to `.env` (to be created) when none exist.\n */\nexport const findEnvFile = async (rootDir: string): Promise<string> => {\n  const matches = await fg([...ENV_FILE_CANDIDATES], {\n    cwd: rootDir,\n    dot: true,\n    deep: 1,\n    onlyFiles: true,\n  });\n\n  return (\n    ENV_FILE_CANDIDATES.find((candidate) => matches.includes(candidate)) ??\n    '.env'\n  );\n};\n\n/**\n * Inserts or updates a `KEY=value` line in dotenv file content. An existing\n * assignment of the same key is replaced in place; otherwise the line is\n * appended with a trailing newline.\n */\nconst upsertEnvVariable = (\n  content: string,\n  key: string,\n  value: string\n): string => {\n  const line = `${key}=${value}`;\n  const keyMatcher = new RegExp(`^${key}=.*$`, 'm');\n\n  if (keyMatcher.test(content)) {\n    return content.replace(keyMatcher, line);\n  }\n\n  const needsLeadingNewline = content.length > 0 && !content.endsWith('\\n');\n\n  return `${content}${needsLeadingNewline ? '\\n' : ''}${line}\\n`;\n};\n\n/**\n * Persists the CMS access-key credentials to the project's environment file as\n * `INTLAYER_CLIENT_ID` / `INTLAYER_CLIENT_SECRET`. The target file is detected\n * with {@link findEnvFile} and created when missing. Returns the relative path\n * of the file that was written.\n */\nexport const writeCmsCredentialsToEnv = async (\n  rootDir: string,\n  { clientId, clientSecret }: CmsCredentials\n): Promise<string> => {\n  const envFile = await findEnvFile(rootDir);\n\n  let content = '';\n  if (await exists(rootDir, envFile)) {\n    content = await readFileFromRoot(rootDir, envFile);\n  }\n\n  let updatedContent = content;\n  updatedContent = upsertEnvVariable(\n    updatedContent,\n    'INTLAYER_CLIENT_ID',\n    clientId\n  );\n  updatedContent = upsertEnvVariable(\n    updatedContent,\n    'INTLAYER_CLIENT_SECRET',\n    clientSecret\n  );\n\n  await writeFileToRoot(rootDir, envFile, updatedContent);\n  logger(\n    `${v} Saved Intlayer CMS credentials to ${colorizePath(envFile)} (${colorize('INTLAYER_CLIENT_ID', ANSIColors.GREY_LIGHT)}, ${colorize('INTLAYER_CLIENT_SECRET', ANSIColors.GREY_LIGHT)})`\n  );\n\n  return envFile;\n};\n\n/**\n * Enables the Intlayer visual editor in the project's configuration file:\n * flips `editor.enabled` to `true` and wires `clientId` / `clientSecret` to the\n * matching environment variables. JSON configs cannot reference `process.env`,\n * so they are skipped with a warning. Returns the config file that was updated,\n * or `undefined` when no editable config was found.\n */\nexport const enableEditorInConfig = async (\n  rootDir: string\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) {\n    logger(\n      `${x} Could not find an Intlayer configuration file to enable the editor.`,\n      { level: 'warn' }\n    );\n    return undefined;\n  }\n\n  const extension = configFile.split('.').pop()!;\n\n  if (extension === 'json') {\n    logger(\n      `${x} ${colorizePath(configFile)} is a JSON config and cannot reference environment variables. Enable the editor and set clientId/clientSecret manually.`,\n      { level: 'warn' }\n    );\n    return undefined;\n  }\n\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = enableIntlayerEditorConfig(content);\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(`${v} Enabled the Intlayer editor in ${colorizePath(configFile)}`);\n  } else {\n    logger(\n      `${v} ${colorizePath(configFile)} already has the Intlayer editor enabled`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Sets `routing.mode` in the project's Intlayer configuration file. Returns the\n * config file that was updated, or `undefined` when none was found.\n */\nexport const setRoutingModeInConfig = async (\n  rootDir: string,\n  mode: RoutingMode\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigRoutingMode(content, extension, mode);\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Set ${colorize(`routing.mode = '${mode}'`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Sets `routing.enableProxy` in the project's Intlayer configuration file.\n * Returns the config file that was updated, or `undefined` when none was found.\n */\nexport const setEnableProxyInConfig = async (\n  rootDir: string,\n  enableProxy: boolean\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigEnableProxy(\n    content,\n    extension,\n    enableProxy\n  );\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Set ${colorize(`routing.enableProxy = ${enableProxy}`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Reduces `routing` in the project's Intlayer configuration file to its\n * `storage` entry. Returns the config file that was updated, or `undefined`\n * when none was found.\n */\nexport const setRoutingStorageOnlyInConfig = async (\n  rootDir: string\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigRoutingStorageOnly(\n    content,\n    extension\n  );\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Kept only ${colorize('routing.storage', ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)} (no URL routing in this project)`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Sets `compiler.output` in the project's Intlayer configuration file to the\n * given `{{variable}}` path template. Returns the config file that was updated,\n * or `undefined` when none was found.\n */\nexport const setCompilerOutputInConfig = async (\n  rootDir: string,\n  outputTemplate: string\n): Promise<string | undefined> => {\n  const configFile = await findIntlayerConfigFile(rootDir);\n\n  if (!configFile) return undefined;\n\n  const extension = configFile.split('.').pop()!;\n  const content = await readFileFromRoot(rootDir, configFile);\n  const updatedContent = setIntlayerConfigCompilerOutput(\n    content,\n    extension,\n    outputTemplate\n  );\n\n  if (updatedContent !== content) {\n    await writeFileToRoot(rootDir, configFile, updatedContent);\n    logger(\n      `${v} Set ${colorize(`compiler.output = '${outputTemplate}'`, ANSIColors.GREY_LIGHT)} in ${colorizePath(configFile)}`\n    );\n  }\n\n  return configFile;\n};\n\n/**\n * Completes the CMS setup once credentials are received from the login flow:\n * writes them to the environment file and enables the editor in the Intlayer\n * configuration file.\n */\nexport const setupCmsCredentials = async (\n  rootDir: string,\n  credentials: CmsCredentials\n): Promise<void> => {\n  await writeCmsCredentialsToEnv(rootDir, credentials);\n  await enableEditorInConfig(rootDir);\n};\n"],"mappings":"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"}

package/dist/esm/init/documentationRouter.mjs

@@ -0,0 +1,139 @@
+//#region src/init/documentationRouter.ts
+/**
+* Documentation URL Constants
+*/
+const DocumentationRouter = {
+	NextJS: "https://intlayer.org/doc/environment/nextjs",
+	NextJS_16: "https://intlayer.org/doc/environment/nextjs",
+	NextJS_15: "https://intlayer.org/doc/environment/nextjs/15",
+	NextJS_14: "https://intlayer.org/doc/environment/nextjs/14",
+	NextJS_PageRouter: "https://intlayer.org/doc/environment/nextjs/next-with-page-router",
+	CRA: "https://intlayer.org/doc/environment/create-react-app",
+	Astro: "https://intlayer.org/doc/environment/astro",
+	Astro_Lit: "https://intlayer.org/doc/environment/astro/lit",
+	Astro_Preact: "https://intlayer.org/doc/environment/astro/preact",
+	Astro_React: "https://intlayer.org/doc/environment/astro/react",
+	Astro_Solid: "https://intlayer.org/doc/environment/astro/solid",
+	Astro_Svelte: "https://intlayer.org/doc/environment/astro/svelte",
+	Astro_Vue: "https://intlayer.org/doc/environment/astro/vue",
+	ViteAndReact: "https://intlayer.org/doc/environment/vite-and-react",
+	ViteAndReact_ReactRouterV7: "https://intlayer.org/doc/environment/vite-and-react/react-router-v7",
+	ViteAndVue: "https://intlayer.org/doc/environment/vite-and-vue",
+	ViteAndSolid: "https://intlayer.org/doc/environment/vite-and-solid",
+	ViteAndSvelte: "https://intlayer.org/doc/environment/vite-and-svelte",
+	ViteAndPreact: "https://intlayer.org/doc/environment/vite-and-preact",
+	ViteAndLit: "https://intlayer.org/doc/environment/vite-and-lit",
+	ViteAndVanilla: "https://intlayer.org/doc/environment/vite-and-vanilla",
+	Vanilla: "https://intlayer.org/doc/environment/vanilla",
+	TanStackRouter: "https://intlayer.org/doc/environment/tanstack-start",
+	TanStackRouterAndSolid: "https://intlayer.org/doc/environment/tanstack-start/solid",
+	SolidStart: "https://intlayer.org/doc/environment/solid-start",
+	Analog: "https://intlayer.org/doc/environment/analog",
+	Remix: "https://intlayer.org/doc/environment/remix-3",
+	NuxtAndVue: "https://intlayer.org/doc/environment/nuxt-and-vue",
+	Angular: "https://intlayer.org/doc/environment/angular",
+	Angular_19: "https://intlayer.org/doc/environment/angular/19",
+	SvelteKit: "https://intlayer.org/doc/environment/sveltekit",
+	ReactNativeAndExpo: "https://intlayer.org/doc/environment/react-native-and-expo",
+	Lynx: "https://intlayer.org/doc/environment/lynx-and-react",
+	HTMX: "https://intlayer.org/doc/environment/htmx",
+	Storybook: "https://intlayer.org/doc/storybook",
+	Express: "https://intlayer.org/doc/environment/express",
+	NestJS: "https://intlayer.org/doc/environment/nest",
+	Fastify: "https://intlayer.org/doc/environment/fastify",
+	Hono: "https://intlayer.org/doc/environment/hono",
+	AdonisJS: "https://intlayer.org/doc/environment/adonisjs",
+	Elysia: "https://intlayer.org/doc/environment/elysia",
+	Default: "https://intlayer.org/doc/get-started",
+	LSP: "https://intlayer.org/doc/lsp",
+	ESLint: "https://intlayer.org/doc/eslint",
+	NextIntl: "https://intlayer.org/doc/next-intl",
+	NextI18Next: "https://intlayer.org/doc/next-i18next",
+	ReactI18Next: "https://intlayer.org/doc/compatibility/react-i18next",
+	ReactIntl: "https://intlayer.org/doc/compatibility/react-intl",
+	VueI18n: "https://intlayer.org/doc/compatibility/vue-i18n",
+	NuxtI18n: "https://intlayer.org/doc/compatibility/nuxtjs-i18n",
+	I18next: "https://intlayer.org/doc/compatibility/i18next"
+};
+/**
+* Helper: Detects the environment and returns the doc URL
+*/
+const getDocumentationUrl = (packageJson) => {
+	const deps = {
+		...packageJson?.dependencies,
+		...packageJson?.devDependencies
+	};
+	/**
+	* Helper to check if a version string matches a specific major version
+	* Matches: "15", "^15.0.0", "~15.2", "15.0.0-beta"
+	*/
+	const isVersion = (versionString, major) => {
+		if (!versionString || typeof versionString !== "string") return false;
+		return new RegExp(`^[\\^~]?${major}(?:\\.|$)`).test(versionString);
+	};
+	if (deps["@lynx-js/react"] || deps["@lynx-js/core"]) return DocumentationRouter.Lynx;
+	if (deps["react-native"] || deps.expo) return DocumentationRouter.ReactNativeAndExpo;
+	if (deps.next) {
+		const version = deps.next;
+		if (isVersion(version, 14)) return DocumentationRouter.NextJS_14;
+		if (isVersion(version, 15)) return DocumentationRouter.NextJS_15;
+		return DocumentationRouter.NextJS;
+	}
+	if (deps.nuxt) return DocumentationRouter.NuxtAndVue;
+	if (deps.astro) {
+		if (deps["@astrojs/react"] || deps.react) return DocumentationRouter.Astro_React;
+		if (deps["@astrojs/vue"] || deps.vue) return DocumentationRouter.Astro_Vue;
+		if (deps["@astrojs/svelte"] || deps.svelte) return DocumentationRouter.Astro_Svelte;
+		if (deps["@astrojs/solid-js"] || deps["solid-js"]) return DocumentationRouter.Astro_Solid;
+		if (deps["@astrojs/preact"] || deps.preact) return DocumentationRouter.Astro_Preact;
+		if (deps["@astrojs/lit"] || deps.lit) return DocumentationRouter.Astro_Lit;
+		return DocumentationRouter.Astro;
+	}
+	if (deps["@sveltejs/kit"]) return DocumentationRouter.SvelteKit;
+	if (deps["@analogjs/platform"]) return DocumentationRouter.Analog;
+	if (deps["@solidjs/start"]) return DocumentationRouter.SolidStart;
+	if (deps.remix || deps["remix-intlayer"]) return DocumentationRouter.Remix;
+	if (deps["@tanstack/react-router"]) return DocumentationRouter.TanStackRouter;
+	if (deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
+	if (deps["@tanstack/start"]) {
+		if (deps["solid-js"] || deps["@tanstack/solid-router"]) return DocumentationRouter.TanStackRouterAndSolid;
+		return DocumentationRouter.TanStackRouter;
+	}
+	const reactRouterVersion = deps["react-router"];
+	if (typeof reactRouterVersion === "string" && (deps["@react-router/fs-routes"] || isVersion(reactRouterVersion, 7))) return DocumentationRouter.ViteAndReact_ReactRouterV7;
+	if (deps.vite) {
+		if (deps.vue) return DocumentationRouter.ViteAndVue;
+		if (deps["solid-js"]) return DocumentationRouter.ViteAndSolid;
+		if (deps.svelte) return DocumentationRouter.ViteAndSvelte;
+		if (deps.preact) return DocumentationRouter.ViteAndPreact;
+		if (deps.lit) return DocumentationRouter.ViteAndLit;
+		if (deps["vanilla-intlayer"]) return DocumentationRouter.ViteAndVanilla;
+		return DocumentationRouter.ViteAndReact;
+	}
+	if (deps["react-scripts"]) return DocumentationRouter.CRA;
+	if (deps["@angular/core"]) {
+		const version = deps["@angular/core"];
+		if (isVersion(version, 19)) return DocumentationRouter.Angular_19;
+		return DocumentationRouter.Angular;
+	}
+	if (deps.lit) return DocumentationRouter.ViteAndLit;
+	if (deps["vanilla-intlayer"]) return DocumentationRouter.Vanilla;
+	if (deps.htmx || deps["htmx.org"]) return DocumentationRouter.HTMX;
+	if (deps.storybook || deps["@storybook/react"] || deps["@storybook/vue3"]) return DocumentationRouter.Storybook;
+	if (deps["@nestjs/core"]) return DocumentationRouter.NestJS;
+	if (deps["@adonisjs/core"]) return DocumentationRouter.AdonisJS;
+	if (deps.elysia) return DocumentationRouter.Elysia;
+	if (deps.hono) return DocumentationRouter.Hono;
+	if (deps.express) return DocumentationRouter.Express;
+	if (deps.fastify) return DocumentationRouter.Fastify;
+	if (deps["next-intl"]) return DocumentationRouter.NextIntl;
+	if (deps["react-i18next"] || deps.i18next) return DocumentationRouter.ReactI18Next;
+	if (deps["react-intl"]) return DocumentationRouter.ReactIntl;
+	if (deps["next-i18next"]) return DocumentationRouter.NextI18Next;
+	if (deps["vue-i18n"]) return DocumentationRouter.VueI18n;
+	return DocumentationRouter.Default;
+};
+
+//#endregion
+export { DocumentationRouter, getDocumentationUrl };
+//# sourceMappingURL=documentationRouter.mjs.map

package/dist/esm/init/documentationRouter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentationRouter.mjs","names":[],"sources":["../../../src/init/documentationRouter.ts"],"sourcesContent":["/**\n * Documentation URL Constants\n */\nexport const DocumentationRouter = {\n  NextJS: 'https://intlayer.org/doc/environment/nextjs',\n  NextJS_16: 'https://intlayer.org/doc/environment/nextjs',\n  NextJS_15: 'https://intlayer.org/doc/environment/nextjs/15',\n  NextJS_14: 'https://intlayer.org/doc/environment/nextjs/14',\n  NextJS_PageRouter:\n    'https://intlayer.org/doc/environment/nextjs/next-with-page-router',\n  CRA: 'https://intlayer.org/doc/environment/create-react-app',\n  Astro: 'https://intlayer.org/doc/environment/astro',\n  Astro_Lit: 'https://intlayer.org/doc/environment/astro/lit',\n  Astro_Preact: 'https://intlayer.org/doc/environment/astro/preact',\n  Astro_React: 'https://intlayer.org/doc/environment/astro/react',\n  Astro_Solid: 'https://intlayer.org/doc/environment/astro/solid',\n  Astro_Svelte: 'https://intlayer.org/doc/environment/astro/svelte',\n  Astro_Vue: 'https://intlayer.org/doc/environment/astro/vue',\n  ViteAndReact: 'https://intlayer.org/doc/environment/vite-and-react',\n  ViteAndReact_ReactRouterV7:\n    'https://intlayer.org/doc/environment/vite-and-react/react-router-v7',\n  ViteAndVue: 'https://intlayer.org/doc/environment/vite-and-vue',\n  ViteAndSolid: 'https://intlayer.org/doc/environment/vite-and-solid',\n  ViteAndSvelte: 'https://intlayer.org/doc/environment/vite-and-svelte',\n  ViteAndPreact: 'https://intlayer.org/doc/environment/vite-and-preact',\n  ViteAndLit: 'https://intlayer.org/doc/environment/vite-and-lit',\n  ViteAndVanilla: 'https://intlayer.org/doc/environment/vite-and-vanilla',\n  Vanilla: 'https://intlayer.org/doc/environment/vanilla',\n  TanStackRouter: 'https://intlayer.org/doc/environment/tanstack-start',\n  TanStackRouterAndSolid:\n    'https://intlayer.org/doc/environment/tanstack-start/solid',\n  SolidStart: 'https://intlayer.org/doc/environment/solid-start',\n  Analog: 'https://intlayer.org/doc/environment/analog',\n  Remix: 'https://intlayer.org/doc/environment/remix-3',\n  NuxtAndVue: 'https://intlayer.org/doc/environment/nuxt-and-vue',\n  Angular: 'https://intlayer.org/doc/environment/angular',\n  Angular_19: 'https://intlayer.org/doc/environment/angular/19',\n  SvelteKit: 'https://intlayer.org/doc/environment/sveltekit',\n  ReactNativeAndExpo:\n    'https://intlayer.org/doc/environment/react-native-and-expo',\n  Lynx: 'https://intlayer.org/doc/environment/lynx-and-react',\n  HTMX: 'https://intlayer.org/doc/environment/htmx',\n  Storybook: 'https://intlayer.org/doc/storybook',\n  Express: 'https://intlayer.org/doc/environment/express',\n  NestJS: 'https://intlayer.org/doc/environment/nest',\n  Fastify: 'https://intlayer.org/doc/environment/fastify',\n  Hono: 'https://intlayer.org/doc/environment/hono',\n  AdonisJS: 'https://intlayer.org/doc/environment/adonisjs',\n  Elysia: 'https://intlayer.org/doc/environment/elysia',\n  Default: 'https://intlayer.org/doc/get-started',\n\n  // Intlayer Language Server (Go-to-Definition from getter keys to .content files)\n  LSP: 'https://intlayer.org/doc/lsp',\n\n  // Lint rules for hardcoded text and non-optimizable dynamic calls\n  ESLint: 'https://intlayer.org/doc/eslint',\n\n  // Competitor / Compat libs\n  NextIntl: 'https://intlayer.org/doc/next-intl',\n  NextI18Next: 'https://intlayer.org/doc/next-i18next',\n  ReactI18Next: 'https://intlayer.org/doc/compatibility/react-i18next',\n  ReactIntl: 'https://intlayer.org/doc/compatibility/react-intl',\n  VueI18n: 'https://intlayer.org/doc/compatibility/vue-i18n',\n  NuxtI18n: 'https://intlayer.org/doc/compatibility/nuxtjs-i18n',\n  I18next: 'https://intlayer.org/doc/compatibility/i18next',\n};\n\nexport type DocumentationRouterType = typeof DocumentationRouter;\n\n/**\n * Helper: Detects the environment and returns the doc URL\n */\nexport const getDocumentationUrl = (packageJson: any): string => {\n  const deps = {\n    ...packageJson?.dependencies,\n    ...packageJson?.devDependencies,\n  };\n\n  /**\n   * Helper to check if a version string matches a specific major version\n   * Matches: \"15\", \"^15.0.0\", \"~15.2\", \"15.0.0-beta\"\n   */\n  const isVersion = (versionString: string, major: number): boolean => {\n    if (!versionString || typeof versionString !== 'string') return false;\n    const regex = new RegExp(`^[\\\\^~]?${major}(?:\\\\.|$)`);\n    return regex.test(versionString);\n  };\n\n  // Mobile / Cross-platform\n  if (deps['@lynx-js/react'] || deps['@lynx-js/core']) {\n    return DocumentationRouter.Lynx;\n  }\n  if (deps['react-native'] || deps.expo) {\n    return DocumentationRouter.ReactNativeAndExpo;\n  }\n\n  // Meta-frameworks (Next, Nuxt, Astro, SvelteKit)\n  if (deps.next) {\n    const version = deps.next;\n\n    if (isVersion(version, 14)) {\n      return DocumentationRouter.NextJS_14;\n    }\n\n    if (isVersion(version, 15)) {\n      return DocumentationRouter.NextJS_15;\n    }\n\n    return DocumentationRouter.NextJS;\n  }\n\n  if (deps.nuxt) return DocumentationRouter.NuxtAndVue;\n\n  if (deps.astro) {\n    if (deps['@astrojs/react'] || deps.react)\n      return DocumentationRouter.Astro_React;\n    if (deps['@astrojs/vue'] || deps.vue) return DocumentationRouter.Astro_Vue;\n    if (deps['@astrojs/svelte'] || deps.svelte)\n      return DocumentationRouter.Astro_Svelte;\n    if (deps['@astrojs/solid-js'] || deps['solid-js'])\n      return DocumentationRouter.Astro_Solid;\n    if (deps['@astrojs/preact'] || deps.preact)\n      return DocumentationRouter.Astro_Preact;\n    if (deps['@astrojs/lit'] || deps.lit) return DocumentationRouter.Astro_Lit;\n\n    return DocumentationRouter.Astro;\n  }\n\n  if (deps['@sveltejs/kit']) return DocumentationRouter.SvelteKit;\n  if (deps['@analogjs/platform']) return DocumentationRouter.Analog;\n  if (deps['@solidjs/start']) return DocumentationRouter.SolidStart;\n  if (deps.remix || deps['remix-intlayer']) return DocumentationRouter.Remix;\n\n  // Routers (TanStack & React Router v7)\n  if (deps['@tanstack/react-router']) {\n    return DocumentationRouter.TanStackRouter;\n  }\n  if (deps['@tanstack/solid-router']) {\n    return DocumentationRouter.TanStackRouterAndSolid;\n  }\n  if (deps['@tanstack/start']) {\n    if (deps['solid-js'] || deps['@tanstack/solid-router']) {\n      return DocumentationRouter.TanStackRouterAndSolid;\n    }\n    return DocumentationRouter.TanStackRouter;\n  }\n\n  // Check for React Router v7 (the guide covers both config and FS routes)\n  const reactRouterVersion = deps['react-router'];\n  if (\n    typeof reactRouterVersion === 'string' &&\n    (deps['@react-router/fs-routes'] || isVersion(reactRouterVersion, 7))\n  ) {\n    return DocumentationRouter.ViteAndReact_ReactRouterV7;\n  }\n\n  // Vite Ecosystem (General)\n  if (deps.vite) {\n    if (deps.vue) return DocumentationRouter.ViteAndVue;\n    if (deps['solid-js']) return DocumentationRouter.ViteAndSolid;\n    if (deps.svelte) return DocumentationRouter.ViteAndSvelte;\n    if (deps.preact) return DocumentationRouter.ViteAndPreact;\n    if (deps.lit) return DocumentationRouter.ViteAndLit;\n    if (deps['vanilla-intlayer']) return DocumentationRouter.ViteAndVanilla;\n\n    // Default to React if Vite is present but specific other frameworks aren't found\n    return DocumentationRouter.ViteAndReact;\n  }\n\n  // Other Web Frameworks\n  if (deps['react-scripts']) return DocumentationRouter.CRA;\n  if (deps['@angular/core']) {\n    const version = deps['@angular/core'];\n    if (isVersion(version, 19)) {\n      return DocumentationRouter.Angular_19;\n    }\n    return DocumentationRouter.Angular;\n  }\n  if (deps.lit) return DocumentationRouter.ViteAndLit;\n  if (deps['vanilla-intlayer']) return DocumentationRouter.Vanilla;\n  if (deps.htmx || deps['htmx.org']) return DocumentationRouter.HTMX;\n  if (deps.storybook || deps['@storybook/react'] || deps['@storybook/vue3'])\n    return DocumentationRouter.Storybook;\n\n  // Backend\n  // NestJS first: it runs on top of Express (or Fastify), so both dependencies\n  // are present and the more specific one has to win.\n  if (deps['@nestjs/core']) return DocumentationRouter.NestJS;\n  if (deps['@adonisjs/core']) return DocumentationRouter.AdonisJS;\n  if (deps.elysia) return DocumentationRouter.Elysia;\n  if (deps.hono) return DocumentationRouter.Hono;\n  if (deps.express) return DocumentationRouter.Express;\n  if (deps.fastify) return DocumentationRouter.Fastify;\n\n  // Competitor Libs (Migration Guides)\n  // We check these last as specific environment setup is usually higher priority,\n  // but if no specific framework logic matched (or as a fallback), we guide to migration.\n  if (deps['next-intl']) return DocumentationRouter.NextIntl;\n  if (deps['react-i18next'] || deps.i18next)\n    return DocumentationRouter.ReactI18Next;\n  if (deps['react-intl']) return DocumentationRouter.ReactIntl;\n  if (deps['next-i18next']) return DocumentationRouter.NextI18Next;\n  if (deps['vue-i18n']) return DocumentationRouter.VueI18n;\n\n  return DocumentationRouter.Default;\n};\n"],"mappings":"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"}

package/dist/esm/init/frameworkSetup/backend/index.mjs

@@ -0,0 +1,130 @@
+import { exists, readFileFromRoot, writeFileToRoot } from "../../utils/fileSystem.mjs";
+import { registerElysiaPlugin, registerExpressMiddleware, registerFastifyPlugin, registerHonoMiddleware, registerNestJsMiddleware } from "./transforms.mjs";
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, colorizePath, logger, v, x } from "@intlayer/config/logger";
+
+//#region src/init/frameworkSetup/backend/index.ts
+/** Script extensions probed for a server entry file. */
+const ENTRY_EXTENSIONS = [
+	"ts",
+	"mts",
+	"js",
+	"mjs",
+	"cjs"
+];
+/** Conventional server entry file names, most likely first. */
+const DEFAULT_ENTRY_BASE_NAMES = [
+	"src/index",
+	"src/server",
+	"src/app",
+	"src/main",
+	"index",
+	"server",
+	"app",
+	"main"
+];
+/**
+* Lists the candidate server entry files: the `package.json` `main` field when
+* it points at source (not a build output), then the conventional names.
+*/
+const getEntryCandidates = async (rootDir, entryBaseNames) => {
+	const candidates = [];
+	try {
+		const { main } = JSON.parse(await readFileFromRoot(rootDir, "package.json"));
+		if (typeof main === "string" && !/^(\.\/)?(dist|build|out)\//.test(main)) candidates.push(main.replace(/^\.\//, ""));
+	} catch {}
+	for (const baseName of entryBaseNames) for (const extension of ENTRY_EXTENSIONS) candidates.push(`${baseName}.${extension}`);
+	return [...new Set(candidates)];
+};
+/**
+* Registers the middleware in the first candidate entry file the transform
+* recognizes. Files the transform cannot confidently edit are left untouched;
+* when none matches, guidance is logged instead.
+*/
+const registerBackendMiddleware = async (rootDir, integration) => {
+	logger(colorize(`Setting up ${integration.name} integration...`, ANSIColors.CYAN));
+	const candidates = await getEntryCandidates(rootDir, integration.entryBaseNames);
+	for (const candidate of candidates) {
+		if (!await exists(rootDir, candidate)) continue;
+		const code = await readFileFromRoot(rootDir, candidate);
+		let result;
+		try {
+			result = integration.transform(code);
+		} catch {
+			continue;
+		}
+		if (result.status === "already") {
+			logger(`${v} ${colorizePath(candidate)} already registers the Intlayer middleware`);
+			return;
+		}
+		if (result.status === "registered") {
+			await writeFileToRoot(rootDir, candidate, result.code);
+			logger(`${v} Registered ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} in ${colorizePath(candidate)}`);
+			return;
+		}
+	}
+	logger(`${x} Could not find where your ${integration.name} app is created — add ${colorize(integration.registrationHint, ANSIColors.MAGENTA)} manually: ${colorizePath(integration.documentationUrl)}`, { level: "warn" });
+};
+/** Wraps a backend integration into a framework adapter. */
+const createBackendAdapter = (integration) => ({
+	name: integration.name,
+	detect: ({ allDeps }) => integration.detect(allDeps),
+	setup: ({ rootDir }) => registerBackendMiddleware(rootDir, integration)
+});
+/**
+* NestJS on the Express platform. Checked before Express: a Nest app is
+* created by `NestFactory`, not `express()`. Nest on Fastify is left to the
+* guide (its adapter is registered through the Fastify instance).
+*/
+const nestJsAdapter = createBackendAdapter({
+	name: "NestJS",
+	detect: (allDeps) => Boolean(allDeps["@nestjs/core"]) && !allDeps["@nestjs/platform-fastify"],
+	entryBaseNames: ["src/main", "main"],
+	transform: registerNestJsMiddleware,
+	registrationHint: "app.use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/nest.md"
+});
+const expressAdapter = createBackendAdapter({
+	name: "Express",
+	detect: (allDeps) => Boolean(allDeps.express),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: registerExpressMiddleware,
+	registrationHint: "app.use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/express.md"
+});
+const fastifyAdapter = createBackendAdapter({
+	name: "Fastify",
+	detect: (allDeps) => Boolean(allDeps.fastify),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: registerFastifyPlugin,
+	registrationHint: "fastify.register(intlayer)",
+	documentationUrl: "https://intlayer.org/doc/environment/fastify.md"
+});
+const honoAdapter = createBackendAdapter({
+	name: "Hono",
+	detect: (allDeps) => Boolean(allDeps.hono),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: registerHonoMiddleware,
+	registrationHint: "app.use(\"*\", intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/hono.md"
+});
+const elysiaAdapter = createBackendAdapter({
+	name: "Elysia",
+	detect: (allDeps) => Boolean(allDeps.elysia),
+	entryBaseNames: DEFAULT_ENTRY_BASE_NAMES,
+	transform: registerElysiaPlugin,
+	registrationHint: "new Elysia().use(intlayer())",
+	documentationUrl: "https://intlayer.org/doc/environment/elysia.md"
+});
+/** Backend adapters, in detection order. */
+const backendAdapters = [
+	nestJsAdapter,
+	expressAdapter,
+	fastifyAdapter,
+	honoAdapter,
+	elysiaAdapter
+];
+
+//#endregion
+export { backendAdapters, elysiaAdapter, expressAdapter, fastifyAdapter, honoAdapter, nestJsAdapter };
+//# sourceMappingURL=index.mjs.map