@eserstack/codebase 0.0.0-stage → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/README.md +301 -2
  2. package/dist/changelog-gen.d.ts +105 -0
  3. package/dist/changelog-gen.js +498 -0
  4. package/dist/changelog-text.d.ts +39 -0
  5. package/dist/changelog-text.js +82 -0
  6. package/dist/cli-support.d.ts +140 -0
  7. package/dist/cli-support.js +244 -0
  8. package/dist/cli-system/app-opts.d.ts +15 -0
  9. package/dist/cli-system/app-opts.js +13 -0
  10. package/dist/cli-system/app.d.ts +29 -0
  11. package/dist/cli-system/app.js +12 -0
  12. package/dist/cli-system/handlers/completions-setup.d.ts +14 -0
  13. package/dist/cli-system/handlers/completions-setup.js +139 -0
  14. package/dist/cli-system/handlers/completions.d.ts +3 -0
  15. package/dist/cli-system/handlers/completions.js +79 -0
  16. package/dist/cli-system/handlers/doctor.d.ts +8 -0
  17. package/dist/cli-system/handlers/doctor.js +146 -0
  18. package/dist/cli-system/handlers/info.d.ts +3 -0
  19. package/dist/cli-system/handlers/info.js +69 -0
  20. package/dist/cli-system/handlers/install.d.ts +8 -0
  21. package/dist/cli-system/handlers/install.js +137 -0
  22. package/dist/cli-system/handlers/mod.d.ts +12 -0
  23. package/dist/cli-system/handlers/mod.js +13 -0
  24. package/dist/cli-system/handlers/uninstall.d.ts +3 -0
  25. package/dist/cli-system/handlers/uninstall.js +60 -0
  26. package/dist/cli-system/handlers/update.d.ts +76 -0
  27. package/dist/cli-system/handlers/update.js +310 -0
  28. package/dist/cli-system/handlers/version-check.d.ts +16 -0
  29. package/dist/cli-system/handlers/version-check.js +176 -0
  30. package/dist/cli-system/handlers/version.d.ts +3 -0
  31. package/dist/cli-system/handlers/version.js +45 -0
  32. package/dist/cli-system/mod.d.ts +19 -0
  33. package/dist/cli-system/mod.js +52 -0
  34. package/dist/commitmsg.d.ts +28 -0
  35. package/dist/commitmsg.js +232 -0
  36. package/dist/directive-analysis.d.ts +75 -0
  37. package/dist/directive-analysis.js +223 -0
  38. package/dist/ffi-client.d.ts +11 -0
  39. package/dist/ffi-client.js +12 -0
  40. package/dist/file-tool.d.ts +96 -0
  41. package/dist/file-tool.js +274 -0
  42. package/dist/file-tools-shared.d.ts +81 -0
  43. package/dist/file-tools-shared.js +276 -0
  44. package/dist/gh-contributors.d.ts +89 -0
  45. package/dist/gh-contributors.js +205 -0
  46. package/dist/gh.d.ts +3 -0
  47. package/dist/gh.js +64 -0
  48. package/dist/git-listing.d.ts +27 -0
  49. package/dist/git-listing.js +69 -0
  50. package/dist/git.d.ts +172 -0
  51. package/dist/git.js +277 -0
  52. package/dist/install.d.ts +34 -0
  53. package/dist/install.js +421 -0
  54. package/dist/main.d.ts +22 -0
  55. package/dist/main.js +14 -0
  56. package/dist/mod.d.ts +25 -0
  57. package/dist/mod.js +8 -0
  58. package/dist/module.d.ts +10 -0
  59. package/dist/module.js +221 -0
  60. package/dist/native-functions.d.ts +1088 -0
  61. package/dist/native-functions.js +2 -0
  62. package/dist/npm-externals.d.ts +27 -0
  63. package/dist/npm-externals.js +34 -0
  64. package/dist/npm-workspace-specifiers.d.ts +6 -0
  65. package/dist/npm-workspace-specifiers.js +45 -0
  66. package/dist/package/loader.d.ts +34 -0
  67. package/dist/package/loader.js +203 -0
  68. package/dist/package/mod.d.ts +36 -0
  69. package/dist/package/mod.js +5 -0
  70. package/dist/package/types.d.ts +142 -0
  71. package/dist/package/types.js +32 -0
  72. package/dist/package/workspace.d.ts +33 -0
  73. package/dist/package/workspace.js +158 -0
  74. package/dist/package/writer.d.ts +52 -0
  75. package/dist/package/writer.js +278 -0
  76. package/dist/package.json +275 -0
  77. package/dist/release-notes.d.ts +90 -0
  78. package/dist/release-notes.js +236 -0
  79. package/dist/release-tag.d.ts +46 -0
  80. package/dist/release-tag.js +95 -0
  81. package/dist/release.d.ts +145 -0
  82. package/dist/release.js +584 -0
  83. package/dist/source-mask.d.ts +3 -0
  84. package/dist/source-mask.js +185 -0
  85. package/dist/validate-bom.d.ts +5 -0
  86. package/dist/validate-bom.js +43 -0
  87. package/dist/validate-case-conflict.d.ts +5 -0
  88. package/dist/validate-case-conflict.js +43 -0
  89. package/dist/validate-circular-deps.d.ts +11 -0
  90. package/dist/validate-circular-deps.js +53 -0
  91. package/dist/validate-code-conventions.d.ts +22 -0
  92. package/dist/validate-code-conventions.js +166 -0
  93. package/dist/validate-commit-msg.d.ts +50 -0
  94. package/dist/validate-commit-msg.js +182 -0
  95. package/dist/validate-docs.d.ts +20 -0
  96. package/dist/validate-docs.js +78 -0
  97. package/dist/validate-eof.d.ts +5 -0
  98. package/dist/validate-eof.js +61 -0
  99. package/dist/validate-error-coverage.d.ts +28 -0
  100. package/dist/validate-error-coverage.js +93 -0
  101. package/dist/validate-export-names.d.ts +17 -0
  102. package/dist/validate-export-names.js +56 -0
  103. package/dist/validate-filenames.d.ts +5 -0
  104. package/dist/validate-filenames.js +151 -0
  105. package/dist/validate-json.d.ts +5 -0
  106. package/dist/validate-json.js +71 -0
  107. package/dist/validate-large-files.d.ts +5 -0
  108. package/dist/validate-large-files.js +41 -0
  109. package/dist/validate-laroux-boundaries.d.ts +19 -0
  110. package/dist/validate-laroux-boundaries.js +59 -0
  111. package/dist/validate-licenses.d.ts +5 -0
  112. package/dist/validate-licenses.js +137 -0
  113. package/dist/validate-line-endings.d.ts +5 -0
  114. package/dist/validate-line-endings.js +47 -0
  115. package/dist/validate-merge-conflict.d.ts +5 -0
  116. package/dist/validate-merge-conflict.js +46 -0
  117. package/dist/validate-mod-exports.d.ts +16 -0
  118. package/dist/validate-mod-exports.js +56 -0
  119. package/dist/validate-naming-and-todos.d.ts +5 -0
  120. package/dist/validate-naming-and-todos.js +70 -0
  121. package/dist/validate-runtime-js-apis.d.ts +5 -0
  122. package/dist/validate-runtime-js-apis.js +78 -0
  123. package/dist/validate-secrets.d.ts +5 -0
  124. package/dist/validate-secrets.js +82 -0
  125. package/dist/validate-self-imports.d.ts +5 -0
  126. package/dist/validate-self-imports.js +78 -0
  127. package/dist/validate-server-loc.d.ts +32 -0
  128. package/dist/validate-server-loc.js +94 -0
  129. package/dist/validate-shebangs.d.ts +5 -0
  130. package/dist/validate-shebangs.js +33 -0
  131. package/dist/validate-stream.d.ts +25 -0
  132. package/dist/validate-stream.js +62 -0
  133. package/dist/validate-submodules.d.ts +5 -0
  134. package/dist/validate-submodules.js +43 -0
  135. package/dist/validate-symlinks.d.ts +5 -0
  136. package/dist/validate-symlinks.js +46 -0
  137. package/dist/validate-toml.d.ts +5 -0
  138. package/dist/validate-toml.js +40 -0
  139. package/dist/validate-trailing-whitespace.d.ts +5 -0
  140. package/dist/validate-trailing-whitespace.js +49 -0
  141. package/dist/validate-yaml.d.ts +5 -0
  142. package/dist/validate-yaml.js +40 -0
  143. package/dist/validation/config.d.ts +17 -0
  144. package/dist/validation/config.js +30 -0
  145. package/dist/validation/mod.d.ts +71 -0
  146. package/dist/validation/mod.js +479 -0
  147. package/dist/validation/registry.d.ts +57 -0
  148. package/dist/validation/registry.js +256 -0
  149. package/dist/validation/types.d.ts +101 -0
  150. package/dist/validation/types.js +2 -0
  151. package/dist/validation/validators/circular-deps.d.ts +7 -0
  152. package/dist/validation/validators/circular-deps.js +31 -0
  153. package/dist/validation/validators/docs.d.ts +7 -0
  154. package/dist/validation/validators/docs.js +38 -0
  155. package/dist/validation/validators/error-coverage.d.ts +2 -0
  156. package/dist/validation/validators/error-coverage.js +46 -0
  157. package/dist/validation/validators/export-names.d.ts +7 -0
  158. package/dist/validation/validators/export-names.js +31 -0
  159. package/dist/validation/validators/laroux-boundaries.d.ts +2 -0
  160. package/dist/validation/validators/laroux-boundaries.js +29 -0
  161. package/dist/validation/validators/mod-exports.d.ts +7 -0
  162. package/dist/validation/validators/mod-exports.js +32 -0
  163. package/dist/validation/validators/mod.d.ts +11 -0
  164. package/dist/validation/validators/mod.js +12 -0
  165. package/dist/validation/validators/server-loc.d.ts +2 -0
  166. package/dist/validation/validators/server-loc.js +48 -0
  167. package/dist/versions.d.ts +166 -0
  168. package/dist/versions.js +349 -0
  169. package/dist/violation-baseline.d.ts +58 -0
  170. package/dist/violation-baseline.js +144 -0
  171. package/dist/walk-stream.d.ts +24 -0
  172. package/dist/walk-stream.js +55 -0
  173. package/dist/workspace-discovery.d.ts +60 -0
  174. package/dist/workspace-discovery.js +130 -0
  175. package/package.json +222 -3
@@ -0,0 +1,43 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * Submodule checker — detects new git submodules.
4
+ *
5
+ * @module
6
+ */
7
+ import { runtime } from "@eserstack/standards/cross-runtime";
8
+ import * as cliSupport from "./cli-support.js";
9
+ import * as fileTool from "./file-tool.js";
10
+ export const tool = fileTool.withGoValidator(fileTool.createFileTool({
11
+ name: "validate-submodules",
12
+ description: "Detect new git submodules",
13
+ canFix: false,
14
+ stacks: [],
15
+ defaults: {},
16
+ checkAll: async (_files, options) => {
17
+ const gitmodulesPath = runtime.path.join(options.root, ".gitmodules");
18
+ const exists = await runtime.fs.exists(gitmodulesPath);
19
+ if (!exists) {
20
+ return [];
21
+ }
22
+ const content = await runtime.fs.readTextFile(gitmodulesPath);
23
+ const submoduleCount = (content.match(/\[submodule\s/g) ?? []).length;
24
+ if (submoduleCount > 0) {
25
+ return [
26
+ {
27
+ path: gitmodulesPath,
28
+ message: `found ${submoduleCount} submodule(s) — submodules are not allowed`,
29
+ },
30
+ ];
31
+ }
32
+ return [];
33
+ },
34
+ }), "submodules");
35
+ export const run = tool.run;
36
+ export const validator = tool.validator;
37
+ export const main = tool.main;
38
+ if (import.meta.main) {
39
+ // Entry point: the await only runs when this file is executed directly.
40
+ // oxlint-disable-next-line node/no-top-level-await
41
+ const result = await main(runtime.process.args);
42
+ cliSupport.runCliMain(result);
43
+ }
@@ -0,0 +1,5 @@
1
+ import type { FileTool } from "./file-tool.ts";
2
+ export declare const tool: FileTool;
3
+ export declare const run: FileTool["run"];
4
+ export declare const validator: FileTool["validator"];
5
+ export declare const main: FileTool["main"];
@@ -0,0 +1,46 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * Symlink checker — detects broken and destroyed symlinks.
4
+ *
5
+ * @module
6
+ */
7
+ import * as standards from "@eserstack/standards";
8
+ import * as cliSupport from "./cli-support.js";
9
+ import * as fileTool from "./file-tool.js";
10
+ export const tool = fileTool.withGoValidator(fileTool.createFileTool({
11
+ name: "validate-symlinks",
12
+ description: "Detect broken symlinks",
13
+ canFix: false,
14
+ stacks: [],
15
+ defaults: {},
16
+ checkAll: async (files) => {
17
+ // Only flag BROKEN symlinks (target doesn't exist).
18
+ // Valid symlinks like AGENTS.md → CLAUDE.md pass silently.
19
+ // Each check is independent, so they run concurrently.
20
+ const symlinks = files.filter((file) => file.isSymlink);
21
+ const broken = await Promise.all(symlinks.map(async (file) => {
22
+ try {
23
+ await standards.crossRuntime.runtime.fs.stat(file.path);
24
+ return false;
25
+ }
26
+ catch {
27
+ return true;
28
+ }
29
+ }));
30
+ return symlinks
31
+ .filter((_file, index) => broken[index] === true)
32
+ .map((file) => ({
33
+ path: file.path,
34
+ message: "broken symlink — target not found",
35
+ }));
36
+ },
37
+ }), "symlinks");
38
+ export const run = tool.run;
39
+ export const validator = tool.validator;
40
+ export const main = tool.main;
41
+ if (import.meta.main) {
42
+ // Entry point: the await only runs when this file is executed directly.
43
+ // oxlint-disable-next-line node/no-top-level-await
44
+ const result = await main(standards.crossRuntime.runtime.process.args);
45
+ cliSupport.runCliMain(result);
46
+ }
@@ -0,0 +1,5 @@
1
+ import type { FileTool } from "./file-tool.ts";
2
+ export declare const tool: FileTool;
3
+ export declare const run: FileTool["run"];
4
+ export declare const validator: FileTool["validator"];
5
+ export declare const main: FileTool["main"];
@@ -0,0 +1,40 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * TOML syntax checker — validates .toml files.
4
+ *
5
+ * @module
6
+ */
7
+ import * as toml from "smol-toml";
8
+ import * as standards from "@eserstack/standards";
9
+ import * as cliSupport from "./cli-support.js";
10
+ import * as fileTool from "./file-tool.js";
11
+ export const tool = fileTool.withGoValidator(fileTool.createFileTool({
12
+ name: "validate-toml",
13
+ description: "Validate TOML syntax",
14
+ canFix: false,
15
+ stacks: [],
16
+ defaults: {},
17
+ extensions: ["toml"],
18
+ checkFile(file, content) {
19
+ if (content === undefined) {
20
+ return [];
21
+ }
22
+ try {
23
+ toml.parse(content);
24
+ return [];
25
+ }
26
+ catch (error) {
27
+ const message = error instanceof Error ? error.message : "invalid TOML";
28
+ return [{ path: file.path, message }];
29
+ }
30
+ },
31
+ }), "toml");
32
+ export const run = tool.run;
33
+ export const validator = tool.validator;
34
+ export const main = tool.main;
35
+ if (import.meta.main) {
36
+ // Entry point: the await only runs when this file is executed directly.
37
+ // oxlint-disable-next-line node/no-top-level-await
38
+ const result = await main(standards.crossRuntime.runtime.process.args);
39
+ cliSupport.runCliMain(result);
40
+ }
@@ -0,0 +1,5 @@
1
+ import type { FileTool } from "./file-tool.ts";
2
+ export declare const tool: FileTool;
3
+ export declare const run: FileTool["run"];
4
+ export declare const validator: FileTool["validator"];
5
+ export declare const main: FileTool["main"];
@@ -0,0 +1,49 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * Trailing whitespace fixer — removes trailing spaces/tabs from lines.
4
+ *
5
+ * @module
6
+ */
7
+ import * as standards from "@eserstack/standards";
8
+ import * as cliSupport from "./cli-support.js";
9
+ import * as fileTool from "./file-tool.js";
10
+ export const tool = fileTool.withGoValidator(fileTool.createFileTool({
11
+ name: "validate-trailing-whitespace",
12
+ description: "Remove trailing whitespace from lines",
13
+ canFix: true,
14
+ stacks: [],
15
+ defaults: {},
16
+ checkFile(file, content) {
17
+ if (content === undefined) {
18
+ return [];
19
+ }
20
+ const issues = [];
21
+ const lines = content.split("\n");
22
+ for (let i = 0; i < lines.length; i++) {
23
+ if (/[ \t]+$/.test(lines[i])) {
24
+ issues.push({
25
+ path: file.path,
26
+ line: i + 1,
27
+ message: "trailing whitespace",
28
+ });
29
+ }
30
+ }
31
+ return issues;
32
+ },
33
+ fixFile(file, content) {
34
+ const fixed = content.replace(/[ \t]+$/gm, "");
35
+ if (fixed === content) {
36
+ return undefined;
37
+ }
38
+ return { path: file.path, oldContent: content, newContent: fixed };
39
+ },
40
+ }), "trailing");
41
+ export const run = tool.run;
42
+ export const validator = tool.validator;
43
+ export const main = tool.main;
44
+ if (import.meta.main) {
45
+ // Entry point: the await only runs when this file is executed directly.
46
+ // oxlint-disable-next-line node/no-top-level-await
47
+ const result = await main(standards.crossRuntime.runtime.process.args);
48
+ cliSupport.runCliMain(result);
49
+ }
@@ -0,0 +1,5 @@
1
+ import type { FileTool } from "./file-tool.ts";
2
+ export declare const tool: FileTool;
3
+ export declare const run: FileTool["run"];
4
+ export declare const validator: FileTool["validator"];
5
+ export declare const main: FileTool["main"];
@@ -0,0 +1,40 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * YAML syntax checker — validates .yml and .yaml files.
4
+ *
5
+ * @module
6
+ */
7
+ import * as yaml from "yaml";
8
+ import * as standards from "@eserstack/standards";
9
+ import * as cliSupport from "./cli-support.js";
10
+ import * as fileTool from "./file-tool.js";
11
+ export const tool = fileTool.withGoValidator(fileTool.createFileTool({
12
+ name: "validate-yaml",
13
+ description: "Validate YAML syntax",
14
+ canFix: false,
15
+ stacks: [],
16
+ defaults: {},
17
+ extensions: ["yml", "yaml"],
18
+ checkFile(file, content) {
19
+ if (content === undefined) {
20
+ return [];
21
+ }
22
+ try {
23
+ yaml.parse(content);
24
+ return [];
25
+ }
26
+ catch (error) {
27
+ const message = error instanceof Error ? error.message : "invalid YAML";
28
+ return [{ path: file.path, message }];
29
+ }
30
+ },
31
+ }), "yaml");
32
+ export const run = tool.run;
33
+ export const validator = tool.validator;
34
+ export const main = tool.main;
35
+ if (import.meta.main) {
36
+ // Entry point: the await only runs when this file is executed directly.
37
+ // oxlint-disable-next-line node/no-top-level-await
38
+ const result = await main(standards.crossRuntime.runtime.process.args);
39
+ cliSupport.runCliMain(result);
40
+ }
@@ -0,0 +1,17 @@
1
+ import type { ProjectConfig } from "./types.ts";
2
+ /**
3
+ * Load project configuration from a directory
4
+ *
5
+ * Looks for .eser/manifest.yml or .eser/manifest.yaml in the specified directory.
6
+ *
7
+ * @param dir - Directory to load config from
8
+ * @returns Project configuration or null if no config file exists
9
+ */
10
+ export declare const loadProjectConfig: (dir: string) => Promise<ProjectConfig | null>;
11
+ /**
12
+ * Get the config file path in a directory (if it exists)
13
+ *
14
+ * @param dir - Directory to check
15
+ * @returns Path to config file or null if none exists
16
+ */
17
+ export declare const getProjectConfigPath: (dir: string) => Promise<string | null>;
@@ -0,0 +1,30 @@
1
+ // Copyright 2023-present Eser Ozvataf and other contributors. All rights reserved. Apache-2.0 license.
2
+ /**
3
+ * Project configuration loading from .eser/manifest.yml
4
+ *
5
+ * @module
6
+ */
7
+ import * as configManifest from "@eserstack/config/manifest";
8
+ /**
9
+ * Load project configuration from a directory
10
+ *
11
+ * Looks for .eser/manifest.yml or .eser/manifest.yaml in the specified directory.
12
+ *
13
+ * @param dir - Directory to load config from
14
+ * @returns Project configuration or null if no config file exists
15
+ */
16
+ export const loadProjectConfig = async (dir) => {
17
+ const raw = await configManifest.loadManifest(dir);
18
+ if (raw === null)
19
+ return null;
20
+ return raw;
21
+ };
22
+ /**
23
+ * Get the config file path in a directory (if it exists)
24
+ *
25
+ * @param dir - Directory to check
26
+ * @returns Path to config file or null if none exists
27
+ */
28
+ export const getProjectConfigPath = async (dir) => {
29
+ return await configManifest.getManifestPath(dir);
30
+ };
@@ -0,0 +1,71 @@
1
+ import type * as shellArgs from "@eserstack/shell/args";
2
+ import type { ValidateOptions, ValidateResult, ValidatorResult } from "./types.ts";
3
+ export type { ProjectConfig, SkippedValidator, StackId, ValidateOptions, ValidateResult, Validator, ValidatorIssue, ValidatorOptions, ValidatorResult, } from "./types.ts";
4
+ export { getProjectConfigPath, loadProjectConfig } from "./config.ts";
5
+ export type { WorkflowCompatibleTool } from "./registry.ts";
6
+ export { getValidator, getValidatorNames, getValidators, getWorkflowTools, registerValidator, } from "./registry.ts";
7
+ /**
8
+ * Options for running Go's built-in file validators.
9
+ */
10
+ export type BuiltinValidatorOptions = {
11
+ /** Root directory to scan (default: ".") */
12
+ readonly dir?: string;
13
+ /** Validator names to run (default: all built-ins: eof, bom, trailing-whitespace, line-endings, merge-conflicts, secrets, large-file) */
14
+ readonly validators?: readonly string[];
15
+ /** File extensions to include (default: all) */
16
+ readonly extensions?: readonly string[];
17
+ /** Use git ls-files for file enumeration (default: true) */
18
+ readonly gitAware?: boolean;
19
+ };
20
+ /**
21
+ * Run Go's built-in language-agnostic file validators.
22
+ *
23
+ * Covers: EOF newline, BOM markers, trailing whitespace, line endings,
24
+ * merge conflict markers, secret patterns, large file detection.
25
+ *
26
+ * Falls back to an empty result when the native library is unavailable.
27
+ * For the full TS validation registry (including JS/TS-specific checks),
28
+ * use `validate()` instead.
29
+ *
30
+ * @param options - Validator options
31
+ * @returns Array of validator results, one per built-in validator
32
+ */
33
+ export declare const runBuiltinValidators: (options?: BuiltinValidatorOptions) => Promise<ValidatorResult[]>;
34
+ /**
35
+ * Run all applicable validators
36
+ *
37
+ * Loads project configuration from `.eser/manifest.yml`, determines which validators
38
+ * to run based on the stack configuration, and returns aggregated results.
39
+ *
40
+ * When no `.eser/manifest.yml` exists, all validators are run by default.
41
+ *
42
+ * @param options - Validation options
43
+ * @returns Validation result with all validator outputs
44
+ */
45
+ export declare const validate: (options?: ValidateOptions) => Promise<ValidateResult>;
46
+ /** The arguments of the standalone validation CLI. */
47
+ export type ValidationCliArgs = {
48
+ readonly help: boolean;
49
+ readonly json: boolean;
50
+ readonly yes: boolean;
51
+ readonly fix: boolean;
52
+ /** The `--root` directory, or undefined for the working directory. */
53
+ readonly root: string | undefined;
54
+ /** The comma-separated `--only` validators. */
55
+ readonly onlyList: string[];
56
+ /** The comma-separated `--skip` validators. */
57
+ readonly skipList: string[];
58
+ };
59
+ /**
60
+ * Parse the validation CLI arguments: `--root`, `--only`, `--skip`, `--fix`,
61
+ * `--json`, `--yes` (`-y`), `--help` (`-h`).
62
+ */
63
+ export declare const parseCliArgs: (cliArgs: readonly string[]) => ValidationCliArgs;
64
+ /**
65
+ * CLI main function for standalone usage.
66
+ *
67
+ * Displays a spinner while loading config, a progress bar while running
68
+ * validators, and streams per-validator results in real-time using TUI
69
+ * components from `@eserstack/shell/tui`.
70
+ */
71
+ export declare const main: (cliArgs?: readonly string[]) => Promise<shellArgs.CliResult<void>>;