@wix/zero-config-implementation 1.5.0

package/README.md

@@ -0,0 +1,72 @@
+# @wix/zero-config
+
+CLI and library to generate component manifests from React TypeScript and CSS files. Consumes `.ts`/`.tsx` entry files and produces [EditorReactComponent](https://www.npmjs.com/package/@wix/component-protocol) manifests.
+
+## Installation
+
+```bash
+yarn add -D @wix/zero-config
+```
+
+Peer dependencies: `react` (^18 || ^19), `react-dom` (^18 || ^19), `typescript` (^5).
+
+## Usage
+
+### Programmatic
+
+```ts
+import { extractComponentManifest } from '@wix/zero-config'
+
+const result = await extractComponentManifest(
+  './src/MyComponent.tsx',
+  (name) => require(`./src/${name}`).default,
+)
+
+result.match(
+  (manifest) => {
+    console.log(manifest.components)
+    console.log(manifest.errors)
+  },
+  (err) => console.error(err),
+)
+```
+
+### CLI
+
+```bash
+npx @wix/zero-config ./src/MyComponent.tsx
+# or
+npx @wix/zero-config
+# then enter path when prompted
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `yarn build` | Build with Vite; output in `dist/` |
+| `yarn dev` | Run CLI in dev (vite-node) |
+| `yarn start` | Run built CLI: `node dist/cli.js` |
+| `yarn lint` | Biome check on `src/` |
+| `yarn test` | Vitest |
+| `yarn docs` | Generate TypeDoc markdown into `docs-audit/` |
+
+## API layers
+
+- **Tier 1 — High-level:** `extractComponentManifest()` — one call, default pipeline.
+- **Tier 2 — Pipeline building blocks:** `compileTsFile`, `extractAllComponentInfo`, `extractCssImports`, `processComponent`, `runExtractors`, `ExtractorStore`, `buildElementTree`, `createPropTrackerExtractor`, `createCssPropertiesExtractor`, `parseCss`, `toEditorReactComponent`, and exported types (e.g. `ComponentInfo`, `PropInfo`, `ExtractionResult`, `ReactExtractor`).
+- **Tier 3 — Low-level:** `renderWithExtractors`, `CreateElementListener` for custom createElement/JSX interception.
+
+Full API reference: [docs-audit/README.md](./docs-audit/README.md) (generate with `yarn docs`).
+
+## Structure
+
+- `src/cli.ts` — CLI entry (bin: `zero-config`)
+- `src/index.ts` — Library exports and main API
+- `src/ts-compiler.ts` — TypeScript compilation
+- `src/manifest-pipeline.ts` — Per-component pipeline (load → render → CSS → conversion)
+- `src/component-loader.ts` — Resolve and load component package
+- `src/component-renderer/` — React createElement interception and `renderWithExtractors`
+- `src/information-extractors/` — TS (AST), CSS (lightningcss), React (prop tracking, DOM coupling)
+- `src/converters/` — To EditorReactComponent and data items
+- `src/errors.ts` — BaseError, NotFoundError, ParseError, etc.

package/dist/component-loader.d.ts

@@ -0,0 +1,42 @@
+import { ResultAsync } from 'neverthrow';
+import { ComponentType } from 'react';
+import { IoError, NotFoundError } from './errors';
+type NotFoundErrorInstance = InstanceType<typeof NotFoundError>;
+type IoErrorInstance = InstanceType<typeof IoError>;
+export type LoaderError = NotFoundErrorInstance | IoErrorInstance;
+export interface ComponentLoaderResult {
+    loadComponent: (name: string) => ComponentType<unknown> | null;
+    packageName: string;
+    entryPath: string | undefined;
+    exportNames: string[];
+}
+/**
+ * Creates a component loader that dynamically loads components from the
+ * user's package. Finds the nearest package.json, resolves its entry point,
+ * and loads the module.
+ *
+ * The returned `loadComponent` is synchronous (required by processComponent).
+ * ESM modules are loaded via async `import()` during creation, so this
+ * function itself is async.
+ *
+ * @returns A `ResultAsync` containing a `ComponentLoaderResult` on success.
+ * @errors {NotFoundError} When no package.json is found or the package has no resolvable entry points.
+ * @errors {IoError} When module loading fails (CJS require or ESM import).
+ */
+export declare function createComponentLoader(componentPath: string): ResultAsync<ComponentLoaderResult, LoaderError>;
+/**
+ * Attempts to load a module, first via ESM `import()`, then via CJS `require`.
+ *
+ * ESM `import()` is preferred because it participates in the ESM loader hook
+ * pipeline (registered via `module.register()` in the CLI). This is required
+ * for JSX interception to work — the loader hook redirects `react/jsx-runtime`
+ * to the interceptable version. CJS `require()` bypasses ESM hooks even when
+ * loading ESM modules (Node 22+), so it's only used as a fallback.
+ *
+ * @param entryPath - Absolute path to the module entry point.
+ * @returns A `ResultAsync` containing the module exports on success.
+ * @errors {IoError} When both ESM import and CJS require fail.
+ */
+export declare function loadModule(entryPath: string): ResultAsync<Record<string, unknown>, IoErrorInstance>;
+export declare function findComponent(moduleExports: Record<string, unknown>, name: string): ComponentType<unknown> | null;
+export {};

package/dist/component-renderer.d.ts

@@ -0,0 +1,31 @@
+import { ComponentType } from 'react';
+import { ExtractorStore } from './information-extractors/react/extractors/core/store';
+import { CreateElementEvent } from './information-extractors/react/extractors/core/types';
+export declare const TRACE_ATTR = "data-trace-id";
+export type { CreateElementEvent };
+export interface CreateElementListener {
+    onCreateElement: (event: CreateElementEvent) => void;
+}
+/**
+ * Renders a React component to static HTML while intercepting element creation.
+ *
+ * Uses monkey-patching of React.createElement and jsx/jsxs to notify listeners
+ * when DOM elements are created. Each DOM element gets a unique `data-trace-id`
+ * attribute for tracking.
+ *
+ * @param Component - The React component to render
+ * @param componentProps - Props to pass to the component
+ * @param listeners - Listeners to notify on each DOM element creation
+ * @param store - Shared ExtractorStore, included in each CreateElementEvent
+ * @returns Static HTML string with trace IDs on DOM elements
+ *
+ * @example
+ * ```ts
+ * const store = new ExtractorStore()
+ * const tracker = createPropTracker(getSpyMetadata)
+ * const html = renderWithExtractors(MyComponent, { title: 'Hello' }, [tracker], store)
+ * // html contains: <div data-trace-id="t1">...</div>
+ * // tracker.stores now has prop→DOM bindings
+ * ```
+ */
+export declare function renderWithExtractors(Component: ComponentType<unknown>, componentProps: unknown, listeners: CreateElementListener[], store: ExtractorStore): string;

package/dist/converters/data-item-builder.d.ts

@@ -0,0 +1,15 @@
+import { Result } from 'neverthrow';
+import { ParseError } from '../errors';
+import { PropInfo } from '../information-extractors/ts/types';
+import { DataItem } from '../schema';
+type ParseErrorInstance = InstanceType<typeof ParseError>;
+/**
+ * Converts a single PropInfo to a DataItem for the Wix Editor component schema.
+ *
+ * @param propInfo - The resolved TypeScript prop information to convert.
+ * @param defaultValue - Optional default value for the data item.
+ * @returns `Ok<DataItem>` on success, `Err<ParseError>` if an invariant is violated
+ *          (e.g. an array type missing its element type).
+ */
+export declare function buildDataItem(propInfo: PropInfo, defaultValue?: unknown): Result<DataItem, ParseErrorInstance>;
+export {};

package/dist/converters/index.d.ts

@@ -0,0 +1 @@
+export { toEditorReactComponent } from './to-editor-component';

package/dist/converters/to-editor-component.d.ts

@@ -0,0 +1,3 @@
+import { ComponentInfoWithCss } from '../index';
+import { EditorReactComponent } from '../schema';
+export declare function toEditorReactComponent(component: ComponentInfoWithCss): EditorReactComponent;

package/dist/converters/utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utility functions for the converter module
+ */
+/**
+ * Formats any string format to Title Case display name
+ * Handles: kebab-case, camelCase, PascalCase, snake_case, SCREAMING_SNAKE_CASE, and mixed formats
+ *
+ * Examples:
+ *   "input-field-weight" -> "Input Field Weight"
+ *   "camelCaseExample" -> "Camel Case Example"
+ *   "PascalCaseExample" -> "Pascal Case Example"
+ *   "snake_case_example" -> "Snake Case Example"
+ *   "SCREAMING_SNAKE_CASE" -> "Screaming Snake Case"
+ *   "mixed-format_example" -> "Mixed Format Example"
+ */
+export declare function formatDisplayName(input: string): string;

package/dist/errors.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Error class hierarchy using modern-errors and modern-errors-cli.
+ *
+ * Classes are organized by **failure type** (what went wrong), not by pipeline
+ * phase (where it happened). Phase is an orthogonal runtime property composed
+ * onto any error instance via `mapErr` or instance `props`.
+ */
+/**
+ * Root error class for the entire project. All domain errors extend this.
+ *
+ * Plugins attached here cascade to every subclass automatically.
+ * The `phase` prop defaults to `"unknown"` and is overridden at the call
+ * site or via `mapErr` as the error propagates through pipeline stages.
+ */
+export declare const BaseError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    /** Pipeline stage where the error originated (composed at runtime). */
+    phase: string;
+    /** True if this error represents a violated invariant, not a user error. */
+    isDefect: boolean;
+    /** Process exit code used by BaseError.exit(). */
+    exitCode: number;
+}, import('modern-errors').CustomClass>;
+/** A required resource (file, module, component) could not be found. */
+export declare const NotFoundError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    /** Pipeline stage where the error originated (composed at runtime). */
+    phase: string;
+    /** True if this error represents a violated invariant, not a user error. */
+    isDefect: boolean;
+    /** Process exit code used by BaseError.exit(). */
+    exitCode: number;
+} & object, import('modern-errors').CustomClass>;
+/** Data could not be parsed or decoded (JSON, source code, config, CSS). */
+export declare const ParseError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    /** Pipeline stage where the error originated (composed at runtime). */
+    phase: string;
+    /** True if this error represents a violated invariant, not a user error. */
+    isDefect: boolean;
+    /** Process exit code used by BaseError.exit(). */
+    exitCode: number;
+} & object, import('modern-errors').CustomClass>;
+/** Input or data does not satisfy validation rules. */
+export declare const ValidationError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    /** Pipeline stage where the error originated (composed at runtime). */
+    phase: string;
+    /** True if this error represents a violated invariant, not a user error. */
+    isDefect: boolean;
+    /** Process exit code used by BaseError.exit(). */
+    exitCode: number;
+} & object, import('modern-errors').CustomClass>;
+/** File system or network I/O failed (permissions, disk full, timeout). */
+export declare const IoError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    /** Pipeline stage where the error originated (composed at runtime). */
+    phase: string;
+    /** True if this error represents a violated invariant, not a user error. */
+    isDefect: boolean;
+    /** Process exit code used by BaseError.exit(). */
+    exitCode: number;
+} & object, import('modern-errors').CustomClass>;
+/**
+ * Represents an unexpected internal failure — a violated invariant or
+ * impossible state that should never occur during normal operation.
+ *
+ * Exit code 70 (EX_SOFTWARE) signals an internal software error.
+ */
+export declare const DefectError: import('modern-errors').SpecificErrorClass<{
+    name: "cli";
+    isOptions: (options: unknown) => boolean;
+    getOptions: (options?: import('modern-errors-cli').Options) => {
+        custom: string;
+        stack?: boolean;
+        cause?: boolean;
+        props?: boolean;
+        colors?: boolean;
+        icon?: ("infinity" | "tick" | "info" | "warning" | "cross" | "square" | "squareSmall" | "squareSmallFilled" | "squareDarkShade" | "squareMediumShade" | "squareLightShade" | "squareTop" | "squareBottom" | "squareLeft" | "squareRight" | "squareCenter" | "circle" | "circleFilled" | "circleDotted" | "circleDouble" | "circleCircle" | "circleCross" | "circlePipe" | "circleQuestionMark" | "radioOn" | "radioOff" | "checkboxOn" | "checkboxOff" | "checkboxCircleOn" | "checkboxCircleOff" | "questionMarkPrefix" | "bullet" | "dot" | "ellipsis" | "pointer" | "pointerSmall" | "triangleUp" | "triangleUpSmall" | "triangleUpOutline" | "triangleDown" | "triangleDownSmall" | "triangleLeft" | "triangleLeftSmall" | "triangleRight" | "triangleRightSmall" | "lozenge" | "lozengeOutline" | "home" | "hamburger" | "smiley" | "mustache" | "heart" | "star" | "play" | "musicNote" | "musicNoteBeamed" | "nodejs" | "arrowUp" | "arrowDown" | "arrowLeft" | "arrowRight" | "arrowLeftRight" | "arrowUpDown" | "almostEqual" | "notEqual" | "lessOrEqual" | "greaterOrEqual" | "identical" | "subscriptZero" | "subscriptOne" | "subscriptTwo" | "subscriptThree" | "subscriptFour" | "subscriptFive" | "subscriptSix" | "subscriptSeven" | "subscriptEight" | "subscriptNine" | "oneHalf" | "oneThird" | "oneQuarter" | "oneFifth" | "oneSixth" | "oneSeventh" | "oneEighth" | "oneNinth" | "oneTenth" | "twoThirds" | "twoFifths" | "threeQuarters" | "threeFifths" | "threeEighths" | "fourFifths" | "fiveSixths" | "fiveEighths" | "sevenEighth" | "line" | "lineBold" | "lineDouble" | "lineDashed0" | "lineDashed1" | "lineDashed2" | "lineDashed3" | "lineDashed4" | "lineDashed5" | "lineDashed6" | "lineDashed7" | "lineDashed8" | "lineDashed9" | "lineDashed10" | "lineDashed11" | "lineDashed12" | "lineDashed13" | "lineDashed14" | "lineDashed15" | "lineVertical" | "lineVerticalBold" | "lineVerticalDouble" | "lineVerticalDashed0" | "lineVerticalDashed1" | "lineVerticalDashed2" | "lineVerticalDashed3" | "lineVerticalDashed4" | "lineVerticalDashed5" | "lineVerticalDashed6" | "lineVerticalDashed7" | "lineVerticalDashed8" | "lineVerticalDashed9" | "lineVerticalDashed10" | "lineVerticalDashed11" | "lineDownLeft" | "lineDownLeftArc" | "lineDownBoldLeftBold" | "lineDownBoldLeft" | "lineDownLeftBold" | "lineDownDoubleLeftDouble" | "lineDownDoubleLeft" | "lineDownLeftDouble" | "lineDownRight" | "lineDownRightArc" | "lineDownBoldRightBold" | "lineDownBoldRight" | "lineDownRightBold" | "lineDownDoubleRightDouble" | "lineDownDoubleRight" | "lineDownRightDouble" | "lineUpLeft" | "lineUpLeftArc" | "lineUpBoldLeftBold" | "lineUpBoldLeft" | "lineUpLeftBold" | "lineUpDoubleLeftDouble" | "lineUpDoubleLeft" | "lineUpLeftDouble" | "lineUpRight" | "lineUpRightArc" | "lineUpBoldRightBold" | "lineUpBoldRight" | "lineUpRightBold" | "lineUpDoubleRightDouble" | "lineUpDoubleRight" | "lineUpRightDouble" | "lineUpDownLeft" | "lineUpBoldDownBoldLeftBold" | "lineUpBoldDownBoldLeft" | "lineUpDownLeftBold" | "lineUpBoldDownLeftBold" | "lineUpDownBoldLeftBold" | "lineUpDownBoldLeft" | "lineUpBoldDownLeft" | "lineUpDoubleDownDoubleLeftDouble" | "lineUpDoubleDownDoubleLeft" | "lineUpDownLeftDouble" | "lineUpDownRight" | "lineUpBoldDownBoldRightBold" | "lineUpBoldDownBoldRight" | "lineUpDownRightBold" | "lineUpBoldDownRightBold" | "lineUpDownBoldRightBold" | "lineUpDownBoldRight" | "lineUpBoldDownRight" | "lineUpDoubleDownDoubleRightDouble" | "lineUpDoubleDownDoubleRight" | "lineUpDownRightDouble" | "lineDownLeftRight" | "lineDownBoldLeftBoldRightBold" | "lineDownLeftBoldRightBold" | "lineDownBoldLeftRight" | "lineDownBoldLeftBoldRight" | "lineDownBoldLeftRightBold" | "lineDownLeftRightBold" | "lineDownLeftBoldRight" | "lineDownDoubleLeftDoubleRightDouble" | "lineDownDoubleLeftRight" | "lineDownLeftDoubleRightDouble" | "lineUpLeftRight" | "lineUpBoldLeftBoldRightBold" | "lineUpLeftBoldRightBold" | "lineUpBoldLeftRight" | "lineUpBoldLeftBoldRight" | "lineUpBoldLeftRightBold" | "lineUpLeftRightBold" | "lineUpLeftBoldRight" | "lineUpDoubleLeftDoubleRightDouble" | "lineUpDoubleLeftRight" | "lineUpLeftDoubleRightDouble" | "lineUpDownLeftRight" | "lineUpBoldDownBoldLeftBoldRightBold" | "lineUpDownBoldLeftBoldRightBold" | "lineUpBoldDownLeftBoldRightBold" | "lineUpBoldDownBoldLeftRightBold" | "lineUpBoldDownBoldLeftBoldRight" | "lineUpBoldDownLeftRight" | "lineUpDownBoldLeftRight" | "lineUpDownLeftBoldRight" | "lineUpDownLeftRightBold" | "lineUpBoldDownBoldLeftRight" | "lineUpDownLeftBoldRightBold" | "lineUpBoldDownLeftBoldRight" | "lineUpBoldDownLeftRightBold" | "lineUpDownBoldLeftBoldRight" | "lineUpDownBoldLeftRightBold" | "lineUpDoubleDownDoubleLeftDoubleRightDouble" | "lineUpDoubleDownDoubleLeftRight" | "lineUpDownLeftDoubleRightDouble" | "lineCross" | "lineBackslash" | "lineSlash") | "";
+        header?: import('chalk-string').Styles | "";
+        classes?: {
+            readonly [errorName: string]: Omit<import('beautiful-error').Options, "classes">;
+        } & {
+            readonly [errorName: string]: Omit<import('handle-cli-error').Options, "classes">;
+        };
+        exitCode?: number;
+        silent?: boolean;
+        timeout?: number;
+        log?: (message: string) => void;
+    };
+    instanceMethods: {
+        exit: ({ error, options }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => void;
+        pretty: ({ error, options: { exitCode, silent, timeout, log, ...beautifulErrorOptions }, }: import('modern-errors').Info<import('modern-errors-cli').Options>["instanceMethods"]) => string;
+    };
+}[], {
+    phase: string;
+    isDefect: boolean;
+    exitCode: number;
+}, import('modern-errors').CustomClass>;
+/**
+ * Wrap an async entry point with a defect boundary.
+ *
+ * If the wrapped function throws an exception (i.e. a defect that was not
+ * captured as a Result), it is caught, wrapped in a DefectError, and printed
+ * via BaseError.exit().
+ *
+ * @param fn - The entry point function to wrap
+ * @throws {DefectError} If an unexpected exception occurs during execution
+ */
+export declare function withDefectBoundary(fn: () => Promise<void>): Promise<void>;

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { ResultAsync } from 'neverthrow';
+import { EditorReactComponent } from './schema';
+import { NotFoundError, ParseError } from './errors';
+export type { ComponentInfoWithCss, ExtractedCssInfo, ExtractionWarning, ProcessComponentResult, } from './manifest-pipeline';
+export interface ManifestResult {
+    component: EditorReactComponent;
+    errors: ExtractionError[];
+}
+export interface ExtractionError {
+    componentName: string;
+    phase: 'render' | 'coupling' | 'css' | 'loader' | 'conversion';
+    error: string;
+}
+/**
+ * Extract component manifest from a TypeScript source file.
+ *
+ * @param componentPath - Path to the TypeScript source file
+ * @param compiledEntryPath - Path to the built JS entry file of the component's package (e.g. dist/index.js)
+ * @returns The manifest result containing components and non-fatal warnings
+ * @errors
+ * - {@link NotFoundError} — Source file does not exist (phase: `compile`)
+ * - {@link ParseError} — TypeScript config or component types could not be parsed (phase: `compile` | `extract`)
+ */
+export declare function extractComponentManifest(componentPath: string, compiledEntryPath: string): ResultAsync<ManifestResult, InstanceType<typeof NotFoundError> | InstanceType<typeof ParseError>>;
+/** TypeScript compilation & static analysis */
+export { compileTsFile } from './ts-compiler';
+export { extractAllComponentInfo, extractDefaultComponentInfo } from './information-extractors/ts/components';
+export { extractCssImports } from './information-extractors/ts/css-imports';
+export type { ComponentInfo, PropInfo, ResolvedType, ResolvedKind, DefaultValue, } from './information-extractors/ts/types';
+/** React render-time extraction */
+export { runExtractors, ExtractorStore, buildElementTree, createPropTrackerExtractor, createCssPropertiesExtractor, } from './information-extractors/react';
+export type { ExtractionResult, ReactExtractor, RenderContext, CreateElementEvent, RenderCompleteEvent, ExtractedElement, PropTrackerData, PropTrackerExtractorState, CssPropertiesData, PropSpyContext, } from './information-extractors/react';
+export type { CoupledComponentInfo, CoupledProp, DOMBinding, TrackingStores, PropReadInfo, PropWriteInfo, PropSpyMeta, } from './information-extractors/react';
+/** CSS parsing & selector matching */
+export { parseCss } from './information-extractors/css';
+export type { CSSParserAPI } from './information-extractors/css';
+/** Error classes */
+export { BaseError, NotFoundError, ParseError, ValidationError, IoError, DefectError, withDefectBoundary, } from './errors';
+/** Component loader */
+export { createComponentLoader } from './component-loader';
+export { renderWithExtractors } from './component-renderer';
+export type { CreateElementListener } from './component-renderer';