@i18nprune/core 0.1.0

package/dist/init.d.ts

@@ -0,0 +1,86 @@
+import { B as BuildInitConfigTemplateOptions, I as InitConfigFormat, R as RunInitHostInput, a as InitRunOptions, b as InitRunResult, c as InitPackageJsonSignals, d as InitFilesystemHost, e as InitTopologySignals, f as InitLocaleLayoutHint, g as InitPresetScore, h as InitPresetId, i as InitProjectSignals, j as InitDetectResult, k as InitPresetConfigFields } from './template-CGM-_WLT.js';
+export { l as InitJsonPayload, m as InitScoreFactor } from './template-CGM-_WLT.js';
+import './index-X50E1FIX.js';
+import './fs-BUYD8ZhA.js';
+import './path-Bfn3SAts.js';
+
+/** Default import for **`defineConfig`** + **`I18nPruneConfig`** from core config surface. */
+declare const DEFAULT_INIT_CONFIG_IMPORT_SPECIFIER = "i18nprune/core/config";
+/** Starter config template used by \`init\` when writing a new config file. */
+declare function buildInitConfigTemplate(importSpecifierOrOpts?: string | BuildInitConfigTemplateOptions): string;
+declare function configFileNameForFormat(baseName: string, format: InitConfigFormat): string;
+declare function defaultInitConfigFileName(baseName: string): string;
+
+/**
+ * Plan an **`init`** config scaffold from optional **`--auto`** / **`--preset`** inputs.
+ *
+ * @param host - Filesystem + path ports and **`projectRoot`** (absolute).
+ * @param opts - **`auto`**, **`preset`**, **`rich`**, and optional **`importSpecifier`**.
+ * @returns JSON payload for hosts, diagnostic **`issues`**, and an **`exitCode`** (`1` when auto-selection is blocked).
+ *
+ * @remarks **Pure** aside from host port reads — never writes files. Hosts own **`console.*`** and disk writes.
+ */
+declare function runInit(host: RunInitHostInput, opts?: InitRunOptions): InitRunResult;
+
+/**
+ * Read **`package.json`** at **`projectRoot`** and return dependency maps.
+ *
+ * @returns **`null`** when the file is missing or JSON is invalid.
+ */
+declare function readInitPackageJson(host: InitFilesystemHost, projectRoot: string): InitPackageJsonSignals | null;
+/** Whether **`name`** appears in **`dependencies`** or **`devDependencies`**. */
+declare function initPackageDeclares(pkg: InitPackageJsonSignals | null, name: string): boolean;
+
+/**
+ * Collect lightweight directory / framework markers under **`projectRoot`**.
+ *
+ * @remarks Uses **`fs.exists`** / **`statKind`** only — no locale JSON parsing.
+ */
+declare function readInitTopologySignals(host: InitFilesystemHost, projectRoot: string): InitTopologySignals;
+
+/**
+ * Infer `locales.mode` / `locales.structure` from on-disk JSON under **`localesDirectory`** (project-relative).
+ *
+ * @returns A hint only when every discovered segment agrees on one structure; otherwise `null`.
+ */
+declare function detectLocaleFilesystemLayout(host: InitFilesystemHost, projectRoot: string, localesDirectory: string): InitLocaleLayoutHint | null;
+
+/**
+ * Score curated presets from **`InitProjectSignals`** using weighted, explainable factors.
+ *
+ * @remarks Pure — deterministic; callers handle ambiguity / host UX.
+ */
+declare function scoreInitPresets(signals: InitProjectSignals): InitPresetScore[];
+/** Top preset id after **`scoreInitPresets`** (array sorted descending by score). */
+declare function pickTopInitPreset(scores: InitPresetScore[]): InitPresetId;
+/**
+ * Whether auto-selection should refuse to pick a single preset without host confirmation.
+ *
+ * @param scores — sorted descending (as returned by **`scoreInitPresets`**).
+ */
+declare function isInitAutoAmbiguous(scores: InitPresetScore[]): boolean;
+
+/**
+ * Scan **`projectRoot`** for **`package.json`** markers and locale-directory topology, then score presets.
+ *
+ * @param host - Filesystem + path ports (**synchronous** ports required).
+ * @param projectRoot - Absolute project directory.
+ * @returns Structured signals plus preset scores (descending by **`score`**).
+ *
+ * @remarks No **`console.*`**, no **`process.*`** — uses host ports only.
+ */
+declare function detectInitProject(host: InitFilesystemHost, projectRoot: string): InitDetectResult;
+
+/**
+ * Every shipped starter preset id (for validation, scoring order, and CLI prompts).
+ *
+ * @remarks **`generic` first** (neutral default); remaining ids are alphabetical for stable UX.
+ */
+declare const INIT_PRESET_IDS: readonly InitPresetId[];
+declare function isInitPresetId(value: string): value is InitPresetId;
+/** Comma-separated preset ids for machine / human hints (stable order). */
+declare function formatInitPresetIdList(): string;
+/** Resolved starter fields for **`buildInitConfigTemplate`**. */
+declare function getInitPresetConfigFields(preset: InitPresetId): InitPresetConfigFields;
+
+export { BuildInitConfigTemplateOptions, DEFAULT_INIT_CONFIG_IMPORT_SPECIFIER, INIT_PRESET_IDS, InitConfigFormat, InitDetectResult, InitFilesystemHost, InitLocaleLayoutHint, InitPackageJsonSignals, InitPresetConfigFields, InitPresetId, InitPresetScore, InitProjectSignals, InitRunOptions, InitRunResult, InitTopologySignals, RunInitHostInput, buildInitConfigTemplate, configFileNameForFormat, defaultInitConfigFileName, detectInitProject, detectLocaleFilesystemLayout, formatInitPresetIdList, getInitPresetConfigFields, initPackageDeclares, isInitAutoAmbiguous, isInitPresetId, pickTopInitPreset, readInitPackageJson, readInitTopologySignals, runInit, scoreInitPresets };