@dialexjs/cli 0.9.1 → 0.9.2

package/dist/api.d.mts

@@ -1,22 +1,13 @@
 import { loadFile } from "magicast";
 import { DialexConfig, LintRuleSetting } from "dialexjs";
-//#region src/utils/dictionary-edit.d.ts
-/**
- * AST-level helpers for reading and editing `.content.ts` dictionary files.
- *
- * Magicast's proxy layer cannot represent every value (for example template-literal
- * functions), so these helpers work on the underlying AST nodes and use Magicast only
- * to parse and print, which preserves the rest of the file's formatting.
- *
- * Supported shapes:
- * - `export default defineDictionary("name", { en: {...}, tr: {...} })`
- * - `export default defineDictionary({ name: "name", dictionary: { ... } })`
- * - `export default { name: "name", dictionary: { ... } }`
- */
-type Node = {
+//#region src/utils/ast.d.ts
+/** A syntax-tree node as magicast (recast/babel) and oxc-style ESTree nodes both look. */
+type AstNode = {
   type: string;
   [key: string]: any;
 };
+//#endregion
+//#region src/utils/dictionary/types.d.ts
 export declare const TODO_PREFIX = "[TODO] ";
 interface DictionaryFile {
   file: string;
@@ -24,7 +15,7 @@ interface DictionaryFile {
   name?: string;
   mod: Awaited<ReturnType<typeof loadFile>>;
   /** The object whose keys are locales. */
-  localesObj: Node;
+  localesObj: AstNode;
   /** Whether the file ended with a newline when loaded; restored on save. */
   endsWithNewline: boolean;
   /**
@@ -52,6 +43,8 @@ interface Leaf {
   /** Present when `kind` is `"string"`. */
   value?: string;
 }
+//#endregion
+//#region src/utils/dictionary/io.d.ts
 /**
  * Parses dictionary source text (for example an unsaved editor buffer). Returns `undefined` when
  * the file does not have an editable shape; throws on syntax errors.
@@ -62,11 +55,15 @@ export declare function loadDictionaryFile(file: string): Promise<DictionaryFile
 /** The source text with all edits applied, without writing anything. */
 export declare function renderDictionaryFile(df: DictionaryFile): string;
 export declare function saveDictionaryFile(df: DictionaryFile): Promise<void>;
+//#endregion
+//#region src/utils/dictionary/read.d.ts
 export declare function listLocales(df: DictionaryFile): string[];
 /** Lists every leaf (string, function, or other value) of a locale, in source order. */
 export declare function listLeaves(df: DictionaryFile, locale: string): Leaf[];
 export declare function hasPath(df: DictionaryFile, locale: string, path: string[]): boolean;
 export declare function getString(df: DictionaryFile, locale: string, path: string[]): string | undefined;
+//#endregion
+//#region src/utils/dictionary/write.d.ts
 type SetResult = "created" | "updated" | "skipped";
 /**
  * Sets a string value at `path`. Existing function or non-string values are left alone
@@ -79,6 +76,8 @@ export declare function setString(df: DictionaryFile, locale: string, path: stri
  * Returns `false` when the source has no such leaf or the target already has one.
  */
 export declare function copyLeaf(df: DictionaryFile, fromLocale: string, toLocale: string, path: string[], mapString?: (value: string) => string): boolean;
+//#endregion
+//#region src/utils/dictionary/locations.d.ts
 /**
  * Where a locale (no `path`) or a key within it is written. The range covers the property key, so
  * it is a good place to attach a diagnostic or jump to.
@@ -89,15 +88,7 @@ export declare function dictionaryLocation(df: DictionaryFile): SourceRange | un
 /** The source code of a leaf's value (a function's source, or a string with its quotes). */
 export declare function getLeafSource(df: DictionaryFile, locale: string, path: string[]): string | undefined;
 //#endregion
-//#region src/analysis.d.ts
-/**
- * Project analysis shared by `dialex check` and the editor extension.
- *
- * It reads dictionaries from the syntax tree, so it never runs project code. Dictionaries that
- * cannot be read that way (spreads, computed keys, imported values) are skipped with an `info`
- * issue, unless `runtime: true` is passed, in which case they are imported and read from the
- * evaluated module (the CLI does this; editors must not).
- */
+//#region src/analysis/types.d.ts
 type IssueLevel = "error" | "warning" | "info";
 type IssueCode = "invalid-dictionary" | "unanalyzable" | "missing-locale" | "missing-key" | "invalid-locale" | "todo-placeholder" | "stale-translation" | "invalid-icu" | "icu-args-mismatch" | "icu-plural-categories" | "unknown-dictionary" | "unknown-path" | "unused-key" | "unused-dictionary";
 interface AnalysisIssue {
@@ -146,9 +137,6 @@ interface AnalysisCache {
   /** The `.gitignore` filter, reused until {@link clearGitignore} is called. */
   gitignore: Map<string, (absolutePath: string) => boolean>;
 }
-export declare function createAnalysisCache(): AnalysisCache;
-/** Forget the cached `.gitignore` rules, for example after a `.gitignore` file changed. */
-export declare function clearGitignore(cache: AnalysisCache): void;
 interface SourceScan {
   /** Distinct word-like tokens, for the unused-key heuristic. */
   tokens: string[];
@@ -203,7 +191,6 @@ interface AnalysisResult {
   /** Dictionary names registered in code with `dictionaries: { name: ... }`. Empty without `src`. */
   inlineDictionaries: string[];
 }
-export declare const DEFAULT_SOURCE_GLOB = "**/*.{ts,tsx,js,jsx,mjs,cjs,vue,svelte,astro,mdx}";
 interface Reference {
   /** A dictionary name, or a full `dictionary.key.path`. */
   kind: "dictionary" | "path";
@@ -212,16 +199,6 @@ interface Reference {
   start: number;
   end: number;
 }
-/** References and inline dictionary names found in one source file. */
-export declare function scanText(text: string): {
-  references: Reference[];
-  inline: string[];
-};
-/**
- * Finds `getDictionary("x")`-style and `t("x.y.z")` references in source text. References inside
- * comments, and on lines a `dialex-ignore` comment covers, are skipped.
- */
-export declare function scanReferences(text: string): Reference[];
 interface DictionaryData {
   name: string;
   locales: string[];
@@ -237,6 +214,26 @@ type Loaded = {
   code: IssueCode;
   message: string;
 };
+//#endregion
+//#region src/analysis/cache.d.ts
+export declare function createAnalysisCache(): AnalysisCache;
+/** Forget the cached `.gitignore` rules, for example after a `.gitignore` file changed. */
+export declare function clearGitignore(cache: AnalysisCache): void;
+//#endregion
+//#region src/analysis/source-scan.d.ts
+export declare const DEFAULT_SOURCE_GLOB = "**/*.{ts,tsx,js,jsx,mjs,cjs,vue,svelte,astro,mdx}";
+/** References and inline dictionary names found in one source file. */
+export declare function scanText(text: string): {
+  references: Reference[];
+  inline: string[];
+};
+/**
+ * Finds `getDictionary("x")`-style and `t("x.y.z")` references in source text. References inside
+ * comments, and on lines a `dialex-ignore` comment covers, are skipped.
+ */
+export declare function scanReferences(text: string): Reference[];
+//#endregion
+//#region src/analysis/index.d.ts
 /** Analyzes a project. With `runtime: true`, dictionaries the syntax tree cannot describe are imported. */
 export declare function analyzeProject(options: AnalysisOptions): Promise<AnalysisResult>;
 /**
@@ -371,7 +368,7 @@ export declare function loadStaticProject(root: string, configFile?: string): Pr
 /** `home` + `["nav", "about"]` -> `home.nav.about` */
 export declare const toKey: (dictionary: string, keyPath: string[]) => string;
 //#endregion
-//#region src/commands/generate.d.ts
+//#region src/commands/generate/types.d.ts
 interface GenerateOptions {
   cwd?: string;
   watch?: boolean;
@@ -403,6 +400,8 @@ interface RenderedGenerate {
   /** Things worth telling the user, such as a dictionary that could not be split by locale. */
   notes: string[];
 }
+//#endregion
+//#region src/commands/generate/render.d.ts
 /**
  * Works out `dialex.generated.ts` and `dialex-env.d.ts` for a project without writing anything,
  * so `check` can tell whether they are up to date.
@@ -411,6 +410,8 @@ interface RenderedGenerate {
  * back to the locales the dictionaries define.
  */
 export declare function renderGenerated(root: string, options?: GenerateOptions): RenderedGenerate;
+//#endregion
+//#region src/commands/generate/write.d.ts
 export declare function generateDictionaries(root: string, options?: GenerateOptions): {
   files: string[];
   outputPath: string;
@@ -418,6 +419,8 @@ export declare function generateDictionaries(root: string, options?: GenerateOpt
   configFile?: string;
   notes: string[];
 };
+//#endregion
+//#region src/commands/generate/watch.d.ts
 /**
  * Regenerates when a dictionary or config file is added, edited or removed. chokidar 4+ no longer
  * understands globs, so this watches the project directory and decides for itself which events

package/dist/api.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.mts","names":[],"sources":["../src/utils/dictionary-edit.ts","../src/analysis.ts","../src/utils/files.ts","../src/utils/lockfile.ts","../src/utils/static-config.ts","../src/utils/project.ts","../src/commands/generate.ts"],"mappings":"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"}
+{"version":3,"file":"api.d.mts","names":["Node"],"sources":["../src/utils/ast.ts","../src/utils/dictionary/types.ts","../src/utils/dictionary/io.ts","../src/utils/dictionary/read.ts","../src/utils/dictionary/write.ts","../src/utils/dictionary/locations.ts","../src/analysis/types.ts","../src/analysis/cache.ts","../src/analysis/source-scan.ts","../src/analysis/index.ts","../src/utils/files.ts","../src/utils/lockfile.ts","../src/utils/static-config.ts","../src/utils/project.ts","../src/commands/generate/types.ts","../src/commands/generate/render.ts","../src/commands/generate/write.ts","../src/commands/generate/watch.ts"],"mappings":"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"}

package/dist/api.mjs

@@ -1,2 +1,2 @@
-import { A as SOURCE_BUILTIN_IGNORE, B as listLocales, C as isStale, E as readLock, F as dictionaryLocation, G as saveDictionaryFile, H as locationOf, I as getLeafSource, K as setString, L as getString, M as scanFiles, N as TODO_PREFIX, O as writeLock, P as copyLeaf, R as hasPath, S as hashSource, U as parseDictionaryText, V as loadDictionaryFile, W as renderDictionaryFile, _ as createAnalysisCache, a as renderGenerated, b as scanText, c as DEFAULT_STATIC_CONFIG, g as clearGitignore, h as analyzeProjectSync, i as generateDictionaries, j as createGitignoreFilter, k as BUILTIN_IGNORE, l as parseStaticConfig, m as analyzeProject, n as loadStaticProject, p as DEFAULT_SOURCE_GLOB, r as toKey, s as startGenerateWatcher, t as loadProject, u as readStaticConfig, v as relativeFile, x as LOCK_FILE, y as scanReferences, z as listLeaves } from "./project-B27699T2.mjs";
+import { A as scanFiles, B as listLeaves, D as BUILTIN_IGNORE, E as writeLock, F as locationOf, G as saveDictionaryFile, H as loadDictionaryFile, I as copyLeaf, K as TODO_PREFIX, L as setString, M as createAnalysisCache, N as dictionaryLocation, O as SOURCE_BUILTIN_IGNORE, P as getLeafSource, R as getString, U as parseDictionaryText, V as listLocales, W as renderDictionaryFile, _ as scanReferences, a as generateDictionaries, b as hashSource, c as DEFAULT_STATIC_CONFIG, g as DEFAULT_SOURCE_GLOB, h as relativeFile, j as clearGitignore, k as createGitignoreFilter, l as parseStaticConfig, m as analyzeProjectSync, n as loadStaticProject, o as startGenerateWatcher, p as analyzeProject, r as toKey, s as renderGenerated, t as loadProject, u as readStaticConfig, v as scanText, w as readLock, x as isStale, y as LOCK_FILE, z as hasPath } from "./project-BTpZGNjh.mjs";
 export { BUILTIN_IGNORE, DEFAULT_SOURCE_GLOB, DEFAULT_STATIC_CONFIG, LOCK_FILE, SOURCE_BUILTIN_IGNORE, TODO_PREFIX, analyzeProject, analyzeProjectSync, clearGitignore, copyLeaf, createAnalysisCache, createGitignoreFilter, dictionaryLocation, generateDictionaries, getLeafSource, getString, hasPath, hashSource, isStale, listLeaves, listLocales, loadDictionaryFile, loadProject, loadStaticProject, locationOf, parseDictionaryText, parseStaticConfig, readLock, readStaticConfig, relativeFile, renderDictionaryFile, renderGenerated, saveDictionaryFile, scanFiles, scanReferences, scanText, setString, startGenerateWatcher, toKey, writeLock };