@i18nprune/core 0.1.0

package/dist/index-DVT26v11.d.ts

@@ -0,0 +1,61 @@
+import { I as Issue } from './index-X50E1FIX.js';
+import { S as StringLeaf } from './index-BQuLEQ9b.js';
+import { P as ParityPolicy } from './root-2-kCaBvQ.js';
+import { R as RunEmitter } from './index-BgG01AKL.js';
+
+/**
+ * Types for the **quality** domain (source-identical / parity-adjacent reporting).
+ */
+
+/** Payload for the `quality` operation JSON envelope (`data` field). */
+type QualityJsonData = {
+    total: number;
+    perFile: Record<string, number>;
+    dynamicKeySites: number;
+    sourceLocale: string;
+    localesDir: string;
+    localeCount: number;
+    targetLocaleCount: number;
+    files: QualityFileLine[];
+};
+type QualityFileLine = {
+    code: string;
+    /** Primary segment report key (`fr.json`, `app/fr.json`, …). */
+    file: string;
+    segmentCount: number;
+    segmentRelativePaths: string[];
+    leafCount: number;
+    isSourceLocale: boolean;
+    sourceIdenticalLeafCount: number | null;
+};
+type ComputeEnglishIdenticalCountsInput = {
+    /** Source locale string leaves (paths and values). */
+    sourceLeaves: readonly StringLeaf[];
+    /**
+     * One entry per target locale file (basename e.g. `ja.json` and leaves from that file).
+     * Order matches CLI iteration over filtered locale files.
+     */
+    targets: ReadonlyArray<{
+        fileBasename: string;
+        leaves: readonly StringLeaf[];
+    }>;
+    /** Same semantics as CLI `config.policies.parity`. */
+    parity?: ParityPolicy;
+};
+type QualityRunOptions = {
+    /** Report only this locale file (basename without .json); omit for all non-source locales. */
+    target?: string;
+};
+type QualityHostHooks = {
+    emit?: RunEmitter;
+    runId?: string;
+    /** Max locale rows in human output (from CLI list window). */
+    listLimit?: number;
+};
+type QualityRunResult = {
+    payload: QualityJsonData;
+    issues: Issue[];
+    keyObservationsCount: number;
+};
+
+export type { ComputeEnglishIdenticalCountsInput as C, QualityFileLine as Q, QualityJsonData as a, QualityRunOptions as b, QualityHostHooks as c, QualityRunResult as d };

package/dist/index-DdjljwMj.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Dynamic (non-literal) translation call sites — shared by validate and `locales dynamic`.
+ * Optional fields are omitted when analysis used merged source text (no per-file path).
+ */
+type DynamicKeySiteKind = 'non_literal' | 'template_interpolation' | 'empty_call'
+/** First argument appears inside a line or block comment (inactive for runtime). */
+ | 'commented';
+
+type DynamicKeySite = {
+    kind: DynamicKeySiteKind;
+    /** Function name as configured (e.g. `t`). */
+    functionName: string;
+    /** Short excerpt for logs / JSON (single line). */
+    preview: string;
+    /**
+     * Absolute or project-relative path when scanned per file; omitted for merged-text analysis.
+     */
+    filePath?: string;
+    /** 1-based line when `filePath` is set. */
+    line?: number;
+    /** 1-based column (UTF-16 code unit) at call start when `filePath` is set. */
+    column?: number;
+    /** True when the matched translation call spans multiple lines. */
+    isMultilineCall?: boolean;
+    /** True when the call site offset lies inside a line or block comment (TS/JS heuristic). */
+    isCommented?: boolean;
+    /**
+     * True when the file extension is one we treat as executable source for dynamic-key analysis.
+     * Non-source extensions are not scanned; this is only set when a provider handled the file.
+     */
+    isSourceFile?: boolean;
+    /**
+     * For **`template_interpolation`**: static key prefix up to (but not including) the first
+     * `${…}` that cannot be resolved from the const map.
+     */
+    resolvedPrefix?: string;
+};
+
+export type { DynamicKeySite as D, DynamicKeySiteKind as a };

package/dist/index-DeIw-cZd.d.ts

@@ -0,0 +1,52 @@
+import { I as Issue } from './index-X50E1FIX.js';
+import { S as StringLeaf } from './index-BQuLEQ9b.js';
+
+type SourcePlaceholderLeaf = {
+    path: string;
+    value: string;
+};
+type LocalePlaceholderLeaf = SourcePlaceholderLeaf & {
+    localeRole: 'source' | 'target';
+    localeCode: string;
+    localePath?: string;
+};
+declare function sourcePlaceholderValues(configuredPlaceholder: unknown): string[];
+declare function detectSourcePlaceholderLeaves(leaves: readonly StringLeaf[], placeholderValues: readonly string[]): SourcePlaceholderLeaf[];
+declare function detectLocalePlaceholderLeaves(input: {
+    leaves: readonly StringLeaf[];
+    placeholderValues: readonly string[];
+    localeRole: 'source' | 'target';
+    localeCode: string;
+    localePath?: string;
+}): LocalePlaceholderLeaf[];
+declare function formatSourcePlaceholderMessage(input: {
+    count: number;
+    samplePaths: readonly string[];
+}): string;
+declare function formatSyncSourcePlaceholderMessage(input: {
+    count: number;
+    samplePaths: readonly string[];
+}): string;
+declare function formatTargetPlaceholderMessage(input: {
+    count: number;
+    samplePaths: readonly string[];
+    targetLabel?: string;
+}): string;
+declare function issuesFromSourcePlaceholderLeaves(leaves: readonly SourcePlaceholderLeaf[]): Issue[];
+declare function issuesFromTargetPlaceholderLeaves(leaves: readonly LocalePlaceholderLeaf[]): Issue[];
+
+type index_LocalePlaceholderLeaf = LocalePlaceholderLeaf;
+type index_SourcePlaceholderLeaf = SourcePlaceholderLeaf;
+declare const index_detectLocalePlaceholderLeaves: typeof detectLocalePlaceholderLeaves;
+declare const index_detectSourcePlaceholderLeaves: typeof detectSourcePlaceholderLeaves;
+declare const index_formatSourcePlaceholderMessage: typeof formatSourcePlaceholderMessage;
+declare const index_formatSyncSourcePlaceholderMessage: typeof formatSyncSourcePlaceholderMessage;
+declare const index_formatTargetPlaceholderMessage: typeof formatTargetPlaceholderMessage;
+declare const index_issuesFromSourcePlaceholderLeaves: typeof issuesFromSourcePlaceholderLeaves;
+declare const index_issuesFromTargetPlaceholderLeaves: typeof issuesFromTargetPlaceholderLeaves;
+declare const index_sourcePlaceholderValues: typeof sourcePlaceholderValues;
+declare namespace index {
+  export { type index_LocalePlaceholderLeaf as LocalePlaceholderLeaf, type index_SourcePlaceholderLeaf as SourcePlaceholderLeaf, index_detectLocalePlaceholderLeaves as detectLocalePlaceholderLeaves, index_detectSourcePlaceholderLeaves as detectSourcePlaceholderLeaves, index_formatSourcePlaceholderMessage as formatSourcePlaceholderMessage, index_formatSyncSourcePlaceholderMessage as formatSyncSourcePlaceholderMessage, index_formatTargetPlaceholderMessage as formatTargetPlaceholderMessage, index_issuesFromSourcePlaceholderLeaves as issuesFromSourcePlaceholderLeaves, index_issuesFromTargetPlaceholderLeaves as issuesFromTargetPlaceholderLeaves, index_sourcePlaceholderValues as sourcePlaceholderValues };
+}
+
+export { type LocalePlaceholderLeaf as L, type SourcePlaceholderLeaf as S, detectSourcePlaceholderLeaves as a, formatSyncSourcePlaceholderMessage as b, formatTargetPlaceholderMessage as c, detectLocalePlaceholderLeaves as d, issuesFromTargetPlaceholderLeaves as e, formatSourcePlaceholderMessage as f, index as g, issuesFromSourcePlaceholderLeaves as i, sourcePlaceholderValues as s };

package/dist/index-X50E1FIX.d.ts

@@ -0,0 +1,50 @@
+type IssueSeverity = 'error' | 'warning' | 'info';
+/** Structured finding for automation (CLI `--json` envelope `issues[]`, library `Result`). */
+type Issue = {
+    severity: IssueSeverity;
+    /** Stable machine id, e.g. `i18nprune.missing_source_locale`. */
+    code: string;
+    message: string;
+    path?: string;
+    /**
+     * Legacy: path under the repo **`docs/`** tree (no leading slash), e.g. `docs/commands/validate/README`.
+     * Prefer **`docHref`** for stable links to the published docs site.
+     */
+    docPath?: string;
+    /** Full HTTPS URL to the documented issue section (e.g. `docs/issues/scan#…`). */
+    docHref?: string;
+};
+type ResultMeta = {
+    /** Envelope contract version (same value as `RESULT_API_VERSION` in `constants/result.ts`). */
+    apiVersion: string;
+    schemaVersion?: string;
+    cwd?: string;
+};
+/**
+ * Unified CLI / library JSON envelope: domain outcome in `ok`, payload in `data`.
+ * CLI `--json` mode always serializes this shape; operation-specific payload fields live in `data`.
+ */
+type CliJsonEnvelope<K extends string, D> = {
+    ok: boolean;
+    kind: K;
+    data: D;
+    issues: Issue[];
+    meta: ResultMeta;
+};
+/** Discriminated success variant for programmatic APIs (no `data` on failure). */
+type OkResult<K extends string, D> = {
+    ok: true;
+    kind: K;
+    data: D;
+    issues: Issue[];
+    meta: ResultMeta;
+};
+type ErrResult = {
+    ok: false;
+    kind: 'failed';
+    issues: Issue[];
+    meta: ResultMeta;
+};
+type Result<K extends string, D> = OkResult<K, D> | ErrResult;
+
+export type { CliJsonEnvelope as C, ErrResult as E, Issue as I, OkResult as O, Result as R, IssueSeverity as a, ResultMeta as b };