@i18nprune/core 0.1.0

package/dist/types.js

@@ -0,0 +1 @@
+

package/dist/validate.d.ts

@@ -0,0 +1,126 @@
+import { T as TranslationSurfaceLeaf, C as CoreContext } from './coreContext-DMaWLvmB.js';
+import { D as DynamicKeySite } from './index-DdjljwMj.js';
+import { K as KeyObservation } from './index-Csm1w7XD.js';
+import { I as Issue } from './index-X50E1FIX.js';
+import { R as RunEmitter } from './index-BgG01AKL.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';
+
+/** Stable composite key for a locale leaf (`segmentRelativePath` + logical path). */
+declare function encodeLocaleLeafIdentity(segmentRelativePath: string, logicalPath: string): string;
+/** Logical paths present in at least one source segment (code keys are logical-path only). */
+declare function logicalPathsFromSourceLeaves(leaves: ReadonlyArray<Pick<TranslationSurfaceLeaf, 'path'>>): Set<string>;
+/**
+ * Literal keys in `resolvedKeys` with no matching logical path in `sourceLeaves`.
+ * Uses {@link logicalPathsFromSourceLeaves} (union across segments).
+ */
+declare function computeMissingLiteralKeysFromLeaves(sourceLeaves: ReadonlyArray<Pick<TranslationSurfaceLeaf, 'path'>>, resolvedKeys: ReadonlySet<string>): string[];
+/**
+ * Literal keys present in `resolvedKeys` but missing as string leaves in `localeJson`.
+ * Prefer {@link computeMissingLiteralKeysFromLeaves} when layout may span multiple source segments.
+ */
+declare function computeMissingLiteralKeysFromResolvedKeys(localeJson: unknown, resolvedKeys: ReadonlySet<string>): string[];
+/** Sort dotted paths shallow-first, then lexicographically (stable for CLI output). */
+declare function compareDottedPathDepth(a: string, b: string): number;
+
+/**
+ * JSON `data` payload for `validate` (same field meanings as CLI `ValidateJsonOutput`).
+ */
+type ValidateScanPayload = {
+    missing: string[];
+    count: number;
+    dynamic: {
+        count: number;
+    };
+    keyObservations: {
+        count: number;
+    };
+};
+/**
+ * Build validate result data from scan outputs (pure — no filesystem).
+ */
+declare function buildValidateScanPayload(input: {
+    sourceLocaleJson?: unknown;
+    /** Preferred for multi-segment layouts — merged source leaves across all segments. */
+    sourceLocaleLeaves?: ReadonlyArray<Pick<TranslationSurfaceLeaf, 'path'>>;
+    resolvedKeys: ReadonlySet<string>;
+    keyObservations: KeyObservation[];
+    dynamicSites: DynamicKeySite[];
+}): ValidateScanPayload;
+
+/** Build structured `issues[]` for validate envelopes from scan results. */
+declare function buildValidateIssues(params: {
+    missingCount: number;
+    dynamicSiteCount: number;
+    sourceLocalePath?: string;
+}): Issue[];
+
+type BuildValidateHumanViewInput = {
+    missing: string[];
+    dynamicSites: DynamicKeySite[];
+    dynamicPreviewLimit?: number;
+    missingPreviewLimit?: number;
+};
+type ValidateHumanView = {
+    dynamicWarning?: string;
+    dynamicPreview: string[];
+    dynamicHiddenCount: number;
+    missingMessage: string;
+    missingPreview: string[];
+    missingHiddenCount: number;
+};
+/** Pure human-log view builder for validate command output. */
+declare function buildValidateHumanView(input: BuildValidateHumanViewInput): ValidateHumanView;
+
+type BuildValidateReportViewInput = {
+    missing: string[];
+    dynamicSites: DynamicKeySite[];
+    keyObservations: KeyObservation[];
+    listLimit: number;
+};
+type ValidateReportView = {
+    missingMessage: string;
+    dynamicMessage?: string;
+    keyObservationsMessage: string;
+    missingPreview: string[];
+    dynamicPreview: DynamicKeySite[];
+    keyObservationsPreview: KeyObservation[];
+};
+/** Pure report-view shaper for validate command summaries/previews. */
+declare function buildValidateReportView(input: BuildValidateReportViewInput): ValidateReportView;
+
+/** JSON `data` for `validate` (same fields as CLI `ValidateJsonOutput` / {@link ValidateScanPayload}). */
+type ValidateJsonPayload = {
+    missing: string[];
+    count: number;
+    dynamic: {
+        count: number;
+    };
+    keyObservations: {
+        count: number;
+    };
+};
+type ValidateRunOptions = Record<string, never>;
+type ValidateHostHooks = {
+    emit?: RunEmitter;
+    runId?: string;
+};
+type ValidateRunResult = {
+    payload: ValidateJsonPayload;
+    issues: Issue[];
+    fullDynamicSites: DynamicKeySite[];
+    fullKeyObservations: KeyObservation[];
+};
+
+/**
+ * Compare resolved literal keys from project analysis to string leaves in the source locale JSON.
+ * Uses {@link resolveProjectAnalysis} so caching matches other project ops (`quality`, `review`, …).
+ */
+declare function runValidate(ctx: CoreContext, _opts: ValidateRunOptions, host: ValidateHostHooks): ValidateRunResult;
+
+export { type BuildValidateHumanViewInput, type BuildValidateReportViewInput, type ValidateHostHooks, type ValidateHumanView, type ValidateJsonPayload, type ValidateReportView, type ValidateRunOptions, type ValidateRunResult, type ValidateScanPayload, buildValidateHumanView, buildValidateIssues, buildValidateReportView, buildValidateScanPayload, compareDottedPathDepth, computeMissingLiteralKeysFromLeaves, computeMissingLiteralKeysFromResolvedKeys, encodeLocaleLeafIdentity, logicalPathsFromSourceLeaves, runValidate };