@i18nprune/core 0.1.0

package/dist/report-D5-6bVFj.d.ts

@@ -0,0 +1,8 @@
+/** `ProjectReportDocument.kind` wire value (see `@i18nprune/core/report-schema`). */
+declare const PROJECT_REPORT_KIND: "i18nprune.projectReport";
+/** `ProjectReportDocument.schemaVersion` for hosted report ingest. */
+declare const PROJECT_REPORT_SCHEMA_VERSION: 1;
+/** Placeholder in built HTML before the CLI inlines the JSON payload. */
+declare const REPORT_INLINE_PAYLOAD_PLACEHOLDER: "__I18NPRUNE_REPORT__";
+
+export { PROJECT_REPORT_KIND as P, REPORT_INLINE_PAYLOAD_PLACEHOLDER as R, PROJECT_REPORT_SCHEMA_VERSION as a };

package/dist/report-schema.d.ts

@@ -0,0 +1,102 @@
+import { P as PROJECT_REPORT_KIND, a as PROJECT_REPORT_SCHEMA_VERSION } from './report-D5-6bVFj.js';
+export { R as REPORT_INLINE_PAYLOAD_PLACEHOLDER } from './report-D5-6bVFj.js';
+import { z } from 'zod';
+
+/**
+ * Canonical project-report Zod schema (source of truth for `@i18nprune/core/report-schema`).
+ *
+ * Published `@i18nprune/core`
+ * and root `i18nprune` bundles include it at build time.
+ */
+declare const projectReportDocumentSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"i18nprune.projectReport">;
+    schemaVersion: z.ZodLiteral<1>;
+    generatedAt: z.ZodString;
+    toolVersion: z.ZodString;
+    project: z.ZodObject<{
+        cwd: z.ZodString;
+        sourceLocalePath: z.ZodString;
+        localesDir: z.ZodString;
+        srcRoot: z.ZodString;
+        sourceLocaleTag: z.ZodOptional<z.ZodString>;
+        environment: z.ZodOptional<z.ZodObject<{
+            platform: z.ZodString;
+            arch: z.ZodString;
+            nodeVersion: z.ZodString;
+            osRelease: z.ZodString;
+            distro: z.ZodOptional<z.ZodString>;
+            wslDistroName: z.ZodOptional<z.ZodString>;
+            runtimeFamily: z.ZodOptional<z.ZodEnum<{
+                windows: "windows";
+                darwin: "darwin";
+                linux: "linux";
+                "linux-wsl": "linux-wsl";
+                "edge-worker": "edge-worker";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        missingKeysCount: z.ZodNumber;
+        dynamicSitesCount: z.ZodNumber;
+        keyObservationsCount: z.ZodNumber;
+        sourceFilesScannedCount: z.ZodOptional<z.ZodNumber>;
+        ok: z.ZodBoolean;
+    }, z.core.$strip>;
+    details: z.ZodObject<{
+        missingKeys: z.ZodArray<z.ZodString>;
+        dynamicSites: z.ZodArray<z.ZodUnknown>;
+        keyObservations: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type ParsedProjectReportDocument = z.infer<typeof projectReportDocumentSchema>;
+
+type ProjectReportSummary = {
+    missingKeysCount: number;
+    dynamicSitesCount: number;
+    keyObservationsCount: number;
+    /**
+     * Source files scanned under `project.srcRoot` (same scope as key-site and dynamic scans).
+     * Omitted in older embedded JSON.
+     */
+    sourceFilesScannedCount?: number;
+    /** True when every scanned literal key exists in the source locale JSON. */
+    ok: boolean;
+};
+/** Where `i18nprune report` ran; drives stable editor deep links in the HTML UI. */
+type ProjectReportEnvironment = {
+    platform: string;
+    arch: string;
+    nodeVersion: string;
+    osRelease: string;
+    distro?: string;
+    /** Set when the scan ran inside WSL (`WSL_DISTRO_NAME`). Required for `linux-wsl` → Windows editor UNC paths. */
+    wslDistroName?: string;
+    /**
+     * Distinguishes native Linux from WSL. Omitted in older reports (inferred from `wslDistroName` when possible).
+     */
+    runtimeFamily?: 'windows' | 'darwin' | 'linux' | 'linux-wsl' | 'edge-worker';
+};
+type ProjectReportProjectMeta = {
+    cwd: string;
+    sourceLocalePath: string;
+    localesDir: string;
+    srcRoot: string;
+    sourceLocaleTag?: string;
+    /** Present when generated by a recent CLI; older JSON may omit this. */
+    environment?: ProjectReportEnvironment;
+};
+type ProjectReportDocument = {
+    kind: typeof PROJECT_REPORT_KIND;
+    schemaVersion: typeof PROJECT_REPORT_SCHEMA_VERSION;
+    generatedAt: string;
+    toolVersion: string;
+    project: ProjectReportProjectMeta;
+    summary: ProjectReportSummary;
+    details: {
+        missingKeys: string[];
+        dynamicSites: unknown[];
+        keyObservations: unknown[];
+    };
+};
+
+export { PROJECT_REPORT_KIND, PROJECT_REPORT_SCHEMA_VERSION, type ParsedProjectReportDocument, type ProjectReportDocument, type ProjectReportEnvironment, type ProjectReportProjectMeta, type ProjectReportSummary, projectReportDocumentSchema };

package/dist/report-schema.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+
+// src/shared/constants/report.ts
+var PROJECT_REPORT_KIND = "i18nprune.projectReport";
+var PROJECT_REPORT_SCHEMA_VERSION = 1;
+var REPORT_INLINE_PAYLOAD_PLACEHOLDER = "__I18NPRUNE_REPORT__";
+var projectReportDocumentSchema = z.object({
+  kind: z.literal(PROJECT_REPORT_KIND),
+  schemaVersion: z.literal(PROJECT_REPORT_SCHEMA_VERSION),
+  generatedAt: z.string(),
+  toolVersion: z.string(),
+  project: z.object({
+    cwd: z.string(),
+    sourceLocalePath: z.string(),
+    localesDir: z.string(),
+    srcRoot: z.string(),
+    sourceLocaleTag: z.string().optional(),
+    environment: z.object({
+      platform: z.string(),
+      arch: z.string(),
+      nodeVersion: z.string(),
+      osRelease: z.string(),
+      distro: z.string().optional(),
+      wslDistroName: z.string().optional(),
+      runtimeFamily: z.enum(["windows", "darwin", "linux", "linux-wsl", "edge-worker"]).optional()
+    }).optional()
+  }),
+  summary: z.object({
+    missingKeysCount: z.number(),
+    dynamicSitesCount: z.number(),
+    keyObservationsCount: z.number(),
+    sourceFilesScannedCount: z.number().int().nonnegative().optional(),
+    ok: z.boolean()
+  }),
+  details: z.object({
+    missingKeys: z.array(z.string()),
+    dynamicSites: z.array(z.unknown()),
+    keyObservations: z.array(z.unknown())
+  })
+});
+
+export { PROJECT_REPORT_KIND, PROJECT_REPORT_SCHEMA_VERSION, REPORT_INLINE_PAYLOAD_PLACEHOLDER, projectReportDocumentSchema };

package/dist/resumeCandidates-xR13eEwt.d.ts

@@ -0,0 +1,200 @@
+import { T as TranslateConfigInput } from './translate-CIHYp7wi.js';
+import { R as RuntimeAdapters } from './adapters-gp1lXp0T.js';
+import { a as TranslatorEnv, b as CacheWarning, T as TranslationSurfaceLeaf } from './coreContext-DMaWLvmB.js';
+import { T as TranslationProviderId } from './providers-0uMEfT6q.js';
+import { I as Issue } from './index-X50E1FIX.js';
+import { T as TranslationResult, a as TranslationLeafMeta, L as LeafDecision } from './index-B_ow_Xvr.js';
+import { E as EffectiveReferenceConfig, a as PreservePolicy, P as ParityPolicy } from './root-2-kCaBvQ.js';
+
+type TranslateContext = {
+    /** Translate-block config (provider list, primary, policy, workers). */
+    readonly config: TranslateConfigInput;
+    /** Runtime adapters — required, no Node default. Hosts pass theirs in (CLI: createNodeRuntimeAdapters). */
+    readonly adapters: RuntimeAdapters;
+    /** Env map — required, no `process.*` access in core. Hosts pass theirs in (CLI: process.env). */
+    readonly env: TranslatorEnv;
+};
+
+/**
+ * Stats captured when translation stops before all planned leaves finished — surfaced on
+ * **`TranslateRunInterruptedError`** so a fallback provider can resume without re-translating
+ * already-completed leaves.
+ */
+type TranslateRunPartialStats = {
+    readonly requestAttempts: number;
+    readonly retriesMade: number;
+    readonly successfulLeaves: number;
+    readonly failedRequests: number;
+    /** Leaves served from L1 or L2 without a provider network call. */
+    readonly cacheHits: number;
+};
+
+type TranslateFailureOutcome = 'rate_limited' | 'quota_exceeded' | 'transient_network' | 'provider_unavailable' | 'auth_failure' | 'malformed_response' | 'unknown_hard_stop';
+type ProviderAttemptOutcome = 'success' | 'rate_limited' | 'network_error' | 'non_retryable_error';
+
+type HandoffEligibilityRow = {
+    readonly id: TranslationProviderId;
+    /** True only when this row is first in the eligible list and is `google`. */
+    readonly recommended: boolean;
+};
+type HandoffCatalogBuildResult = {
+    readonly eligibleRows: readonly HandoffEligibilityRow[];
+    /** Human-readable reason per provider id filtered out (for empty-pool messages). */
+    readonly ineligibleReasons: Readonly<Record<string, string>>;
+};
+
+type IdentitySample = {
+    readonly sourceText: string;
+    readonly translatedText: string;
+    readonly path: string;
+};
+type IdentityStreakState = {
+    consecutiveIdentity: number;
+    lastPath: string;
+};
+type IdentityStreakInteractive = () => boolean;
+type IdentityStreakConfirmInput = {
+    command: string;
+    target: string;
+    count: number;
+    latestPath: string;
+    samples: readonly IdentitySample[];
+};
+type IdentityStreakConfirmFn = (input: IdentityStreakConfirmInput) => Promise<boolean>;
+type IdentityStreakGuardOptions = {
+    command: string;
+    target: string;
+    threshold?: number;
+    interactive?: IdentityStreakInteractive;
+    confirm?: IdentityStreakConfirmFn;
+};
+
+type IdentityStreakGuard = {
+    onTranslated: (sourceText: string, translatedText: string, path: string) => Promise<void>;
+    flushIssues: () => Issue[];
+};
+
+/**
+ * Translation **`tickProgress`** contract for **`generate`** (orchestration → host UI).
+ * Hosts map ticks to TTY / JSON / quiet; core stays I/O-free.
+ */
+/**
+ * How **`tickProgress`** should interpret the numeric index for strict vs parallel phases.
+ */
+type TranslationProgressPhase = 'strict' | 'parallel_pool';
+/**
+ * Honest snapshot while a bounded **`translateLeaf`** pool runs (worker slots are stable 0..N-1).
+ */
+type TranslationPoolProgressSnapshot = {
+    /** Finished **`translateLeaf`** jobs in this pool (monotonic). */
+    readonly completed: number;
+    /** Total **`translateLeaf`** jobs in this pool. */
+    readonly total: number;
+    /** In-flight jobs: path per worker slot (slot order). */
+    readonly activeBySlot: readonly {
+        readonly slot: number;
+        readonly path: string;
+    }[];
+};
+type TranslationTickProgressOptions = {
+    readonly phase?: TranslationProgressPhase;
+    /** Present during **`parallel_pool`** when the host should show pool-accurate bar / keys. */
+    readonly pool?: TranslationPoolProgressSnapshot;
+};
+type TranslationTickProgressFn = (index: number, total: number, path: string, options?: TranslationTickProgressOptions) => void;
+
+/** Inputs for {@link buildTranslateCacheKey} (L1; includes target language in digest). */
+type BuildTranslateCacheKeyInput = {
+    sourceText: string;
+    sourceLang: string;
+    targetLang: string;
+    providerId: TranslationProviderId;
+    translateConfigEpoch: string;
+};
+/** Inputs for per-locale L2 file keys (target language is the file name). */
+type BuildTranslateCacheKeyForLocaleFileInput = {
+    sourceText: string;
+    sourceLang: string;
+    providerId: TranslationProviderId;
+    translateConfigEpoch: string;
+};
+/** One persisted L2 translation row (text-level; no leaf path). */
+type TranslationCacheEntry = {
+    text: string;
+    leafMeta: TranslationLeafMeta;
+    decision?: LeafDecision;
+    providerId: TranslationProviderId;
+    createdAt: string;
+};
+/** On-disk `translations/<code>.json` envelope (target lang is the file name). */
+type TranslationLocaleCacheFile = {
+    version: number;
+    updatedAt: string;
+    targetLang: string;
+    translateConfigEpoch: string;
+    inputFilesEpoch: string;
+    entries: Record<string, TranslationCacheEntry>;
+};
+type TranslateCacheHitLayer = false | 'l1' | 'l2';
+type TranslateLeafWithL1Result = {
+    result: TranslationResult;
+    cacheHit: TranslateCacheHitLayer;
+};
+/** In-process L1 memo surface used by {@link translateLeafWithGenerateCache}. */
+type TranslateCacheL1Port = {
+    readonly translateConfigEpoch: string;
+    get(key: string): TranslationResult | undefined;
+    set(key: string, value: TranslationResult): void;
+    buildKey(input: {
+        sourceText: string;
+        sourceLang: string;
+        targetLang: string;
+        providerId: TranslationProviderId;
+    }): string;
+};
+/** Per-target L2 disk store surface (`translations/<code>.json`). */
+type TranslateCacheL2Port = {
+    readonly targetLang: string;
+    get(key: string): TranslationResult | undefined;
+    set(key: string, result: TranslationResult, providerId: TranslationProviderId): void;
+    buildKey(input: {
+        sourceText: string;
+        sourceLang: string;
+        providerId: TranslationProviderId;
+    }): string;
+    flush(): CacheWarning | undefined;
+};
+/** Per-run L1 memo plus optional per-target L2 store for generate. */
+type GenerateTranslateCache = {
+    l1?: TranslateCacheL1Port;
+    l2?: TranslateCacheL2Port;
+};
+/** L1-only slice shared across targets until L2 is bound per locale. */
+type GenerateTranslateCacheBase = {
+    l1?: TranslateCacheL1Port;
+};
+/** Options for {@link openTranslateCacheL2ForTarget}. */
+type OpenTranslateCacheL2Options = {
+    /** When true, skip L2 reads (e.g. `generate --force`). */
+    bypassL2?: boolean;
+};
+
+/**
+ * Types for **`generate --resume`** (review-leaf top-up); shared with resume translation helpers.
+ */
+
+/** Subset of key-reference context used for resume eligibility guards. */
+type GenerateResumeRefContext = {
+    uncertainPrefixes: readonly string[];
+};
+/** Inputs for {@link import('../../generate/resume/eligibleResumeLeaves.js').isResumeCandidateLeaf}. */
+type GenerateResumeCandidateLeafInput = {
+    leaf: TranslationSurfaceLeaf;
+    sourceMap: ReadonlyMap<string, string>;
+    refCtx: GenerateResumeRefContext;
+    eff: EffectiveReferenceConfig;
+    preserve?: PreservePolicy;
+    parity?: ParityPolicy;
+};
+
+export type { BuildTranslateCacheKeyForLocaleFileInput as B, GenerateResumeRefContext as G, HandoffEligibilityRow as H, IdentityStreakGuard as I, OpenTranslateCacheL2Options as O, ProviderAttemptOutcome as P, TranslateContext as T, TranslationTickProgressOptions as a, TranslationTickProgressFn as b, TranslateFailureOutcome as c, TranslateRunPartialStats as d, GenerateTranslateCache as e, GenerateResumeCandidateLeafInput as f, BuildTranslateCacheKeyInput as g, GenerateTranslateCacheBase as h, HandoffCatalogBuildResult as i, IdentitySample as j, IdentityStreakConfirmFn as k, IdentityStreakConfirmInput as l, IdentityStreakGuardOptions as m, IdentityStreakInteractive as n, IdentityStreakState as o, TranslateCacheHitLayer as p, TranslateCacheL1Port as q, TranslateCacheL2Port as r, TranslateLeafWithL1Result as s, TranslationCacheEntry as t, TranslationLocaleCacheFile as u };