@i18nprune/core 0.1.0

package/dist/missing-BVCvgUC8.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Default string **`missing`** writes for keys that appear in code but are absent from the target locale JSON
+ * when **`config.missing.placeholder`** is omitted. Override in config for a custom sentinel (or empty string).
+ * A non-empty default is distinct from an intentional empty UI string so tooling can **`grep`** scaffolded keys.
+ */
+declare const DEFAULT_MISSING_LEAF_PLACEHOLDER: "__I18NPRUNE_MISSING__";
+/** Keep locale target suggestions helpful without turning typo warnings into noisy catalog dumps. */
+declare const MAX_MISSING_TARGET_SUGGESTIONS = 3;
+
+export { DEFAULT_MISSING_LEAF_PLACEHOLDER as D, MAX_MISSING_TARGET_SUGGESTIONS as M };

package/dist/missing.d.ts

@@ -0,0 +1,85 @@
+export { D as DEFAULT_MISSING_LEAF_PLACEHOLDER, M as MAX_MISSING_TARGET_SUGGESTIONS } from './missing-BVCvgUC8.js';
+import { C as CoreContext } from './coreContext-DMaWLvmB.js';
+import { M as MissingHostHooks, a as MissingPlaceholderLeaf, b as MissingTargetPlan, c as MissingRunOptions, d as MissingRunResult, e as MissingWriteInput, f as MissingSegmentWrite, R as ResolveMissingPathsPlanInput } from './index-CIzZl4W8.js';
+export { g as MissingJsonOutput, h as MissingJsonTarget, i as MissingPlaceholderLeafList, j as MissingSkippedTarget, k as MissingTargetKind, l as MissingTargetState } from './index-CIzZl4W8.js';
+import './root-2-kCaBvQ.js';
+import 'zod';
+import './path-Bfn3SAts.js';
+import './fs-BUYD8ZhA.js';
+import './providers-0uMEfT6q.js';
+import './capabilities-x74cD2Hu.js';
+import './adapters-gp1lXp0T.js';
+import './index-X50E1FIX.js';
+import './index-BgG01AKL.js';
+
+declare function emitMissingTargetWriteIntro(host: Pick<MissingHostHooks, 'emit' | 'runId'>, entry: MissingTargetPlan): void;
+declare function emitMissingTargetActionMessage(host: Pick<MissingHostHooks, 'emit' | 'runId'>, entry: MissingTargetPlan, action: 'would_add' | 'will_add' | 'added' | 'declined', placeholder?: string, preview?: {
+    fullList: boolean;
+    top?: number;
+}): void;
+declare function emitMissingPathsPreview(host: Pick<MissingHostHooks, 'emit' | 'runId'>, input: {
+    paths: readonly string[];
+    fullList: boolean;
+    top?: number;
+}): void;
+declare function emitMissingPlaceholderLeavesPreview(host: Pick<MissingHostHooks, 'emit' | 'runId'>, input: {
+    leaves: readonly MissingPlaceholderLeaf[];
+    fullList: boolean;
+    top?: number;
+}): void;
+/** Write missing paths using per-segment planning (multi-segment layouts). */
+declare function writeMissingPaths(ctx: CoreContext, input: MissingWriteInput): void;
+declare function runMissing(ctx: CoreContext, opts: MissingRunOptions, host: MissingHostHooks): MissingRunResult;
+
+declare function applyMissingPaths(input: {
+    localeJson: unknown;
+    paths: readonly string[];
+    placeholder: string;
+}): unknown;
+
+/**
+ * Group missing key paths into per-segment writes for one locale code.
+ * Skips paths already present in the target segment file on disk.
+ */
+declare function createMissingWritePlan(ctx: CoreContext, localeCode: string, paths: readonly string[]): MissingSegmentWrite[];
+/** Apply placeholder leaves and write every segment in the plan. */
+declare function writeMissingWritePlan(ctx: CoreContext, plan: readonly MissingSegmentWrite[], placeholder: string): {
+    filesWritten: number;
+    pathsWritten: number;
+};
+
+/** Max length for **`config.missing.placeholder`**; longer values fall back to the default with a warning. */
+declare const MISSING_LEAF_PLACEHOLDER_MAX_LEN = 256;
+/**
+ * Resolve the leaf placeholder used by **`missing`** (and tooling that must grep the same sentinel).
+ * Empty / whitespace-only / overlong / non-string values fall back to **`DEFAULT_MISSING_LEAF_PLACEHOLDER`**
+ * and return human-readable **`warnings`** for the host to log once.
+ */
+declare function resolveMissingLeafPlaceholder(raw: unknown): {
+    placeholder: string;
+    warnings: string[];
+};
+
+/**
+ * Parse the `missing` string array from an already-loaded validate `--json` report object.
+ * @param sourceLabel - appended to errors (e.g. file path) for actionable CLI messages.
+ */
+declare function parseMissingArrayFromValidateReportJson(raw: unknown, sourceLabel?: string): string[];
+/**
+ * From paths listed in a validate report: which to insert vs skipped because not in current scan.
+ */
+declare function planMissingPathsFromReport(reportPaths: string[], usedLiteralKeys: ReadonlySet<string>, existingLeafPaths: ReadonlySet<string>): {
+    toAdd: string[];
+    skippedNotInScan: string[];
+};
+
+/**
+ * Pure planner for `missing`: compute key paths to add into a target locale JSON.
+ * If `reportMissingPaths` is provided, keep only entries still present in current scan.
+ */
+declare function resolveMissingPathsPlan(input: ResolveMissingPathsPlanInput): {
+    toAdd: string[];
+    skippedNotInScan: string[];
+};
+
+export { MISSING_LEAF_PLACEHOLDER_MAX_LEN, MissingHostHooks, MissingPlaceholderLeaf, MissingRunOptions, MissingRunResult, MissingSegmentWrite, MissingTargetPlan, MissingWriteInput, ResolveMissingPathsPlanInput, applyMissingPaths, createMissingWritePlan, emitMissingPathsPreview, emitMissingPlaceholderLeavesPreview, emitMissingTargetActionMessage, emitMissingTargetWriteIntro, parseMissingArrayFromValidateReportJson, planMissingPathsFromReport, resolveMissingLeafPlaceholder, resolveMissingPathsPlan, runMissing, writeMissingPaths, writeMissingWritePlan };