@savvy-web/github-action-builder 0.7.3 → 0.7.5

package/index.d.ts

@@ -1,1820 +1,1567 @@
-/**
- * GitHub Action Builder
- *
- * A zero-config build tool for creating GitHub Actions from TypeScript source code.
- * This package provides both a programmatic API and CLI for bundling TypeScript
- * GitHub Actions into production-ready JavaScript bundles.
- *
- * @remarks
- * The package uses rsbuild under the hood to create single-file bundles
- * that include all dependencies. It automatically detects entry points
- * (`main.ts`, `pre.ts`, `post.ts`) and validates `action.yml` configuration.
- *
- * @example Programmatic usage with GitHubAction class
- * ```typescript
- * import { GitHubAction } from "@savvy-web/github-action-builder";
- *
- * async function main(): Promise<void> {
- *   const action = GitHubAction.create();
- *   const result = await action.build();
- *
- *   if (result.success) {
- *     console.log("Build completed successfully");
- *   } else {
- *     console.error(result.error);
- *     process.exit(1);
- *   }
- * }
- *
- * main();
- * ```
- *
- * @example Configuration file (action.config.ts)
- * ```typescript
- * import { defineConfig } from "@savvy-web/github-action-builder";
- *
- * export default defineConfig({
- *   entries: {
- *     main: "src/main.ts",
- *     post: "src/cleanup.ts",
- *   },
- *   build: {
- *     minify: true,
- *   },
- * });
- * ```
- *
- * @packageDocumentation
- */
-
-import { Context } from 'effect';
-import type { Effect } from 'effect';
-import { Layer } from 'effect';
-import { Schema } from 'effect';
-import { URL as URL_2 } from 'node:url';
-import { VoidIfEmpty } from 'effect/Types';
-import { YieldableError } from 'effect/Cause';
-
-/**
- * Error when action.yml file is missing.
- *
- * @public
- */
-export declare class ActionYmlMissing extends ActionYmlMissingBase<{
-    /**
-     * The working directory that was searched.
-     */
-    readonly cwd: string;
-}> {
-}
-
-/**
- * Base class for ActionYmlMissing error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ActionYmlMissingBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ActionYmlMissing";
-} & Readonly<A>;
-
-/**
- * Error when action.yml runs paths don't resolve correctly in destination.
- *
- * @public
- */
-export declare class ActionYmlPathError extends ActionYmlPathErrorBase<{
-    /**
-     * The entry type whose path failed validation (main, pre, post).
-     */
-    readonly entryType: string;
-    /**
-     * The path specified in action.yml.
-     */
-    readonly specifiedPath: string;
-    /**
-     * The expected resolved path.
-     */
-    readonly expectedPath: string;
-}> {
-}
-
-/**
- * Base class for ActionYmlPathError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ActionYmlPathErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ActionYmlPathError";
-} & Readonly<A>;
-
-/**
- * Result of action.yml validation.
- * @public
- */
-export declare type ActionYmlResult = typeof ActionYmlResultSchema.Type;
-
-/**
- * Result of action.yml validation.
- * @internal
- */
-export declare const ActionYmlResultSchema: Schema.Struct<{
-    /** Whether the action.yml is valid. */
-    valid: typeof Schema.Boolean;
-    /** Parsed action.yml content if valid. */
-    content: Schema.optional<typeof Schema.Any>;
-    /** Validation errors. */
-    errors: Schema.Array$<Schema.Struct<{
-        /** Error code for categorization. */
-        code: typeof Schema.String;
-        /** Human-readable error message. */
-        message: typeof Schema.String;
-        /** File path where error occurred. */
-        file: Schema.optional<typeof Schema.String>;
-        /** Suggestion for fixing the error. */
-        suggestion: Schema.optional<typeof Schema.String>;
-    }>>;
-    /** Validation warnings. */
-    warnings: Schema.Array$<Schema.Struct<{
-        /** Warning code for categorization. */
-        code: typeof Schema.String;
-        /** Human-readable warning message. */
-        message: typeof Schema.String;
-        /** File path where warning occurred. */
-        file: Schema.optional<typeof Schema.String>;
-        /** Suggestion for addressing the warning. */
-        suggestion: Schema.optional<typeof Schema.String>;
-    }>>;
-}>;
-
-/**
- * Error when action.yml fails schema validation.
- *
- * @public
- */
-export declare class ActionYmlSchemaError extends ActionYmlSchemaErrorBase<{
-    /**
-     * The path to the action.yml file.
-     */
-    readonly path: string;
-    /**
-     * List of schema validation errors.
-     */
-    readonly errors: ReadonlyArray<{
-        readonly path: string;
-        readonly message: string;
-    }>;
-}> {
-}
-
-/**
- * Base class for ActionYmlSchemaError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ActionYmlSchemaErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ActionYmlSchemaError";
-} & Readonly<A>;
-
-/**
- * Error when action.yml has invalid YAML syntax.
- *
- * @public
- */
-export declare class ActionYmlSyntaxError extends ActionYmlSyntaxErrorBase<{
-    /**
-     * The path to the action.yml file.
-     */
-    readonly path: string;
-    /**
-     * The syntax error message.
-     */
-    readonly message: string;
-    /**
-     * Line number where the error occurred, if available.
-     */
-    readonly line?: number;
-    /**
-     * Column number where the error occurred, if available.
-     */
-    readonly column?: number;
-}> {
-}
-
-/**
- * Base class for ActionYmlSyntaxError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ActionYmlSyntaxErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ActionYmlSyntaxError";
-} & Readonly<A>;
-
-/**
- * Union of all possible errors in the GitHub Action Builder.
- *
- * @public
- */
-export declare type AppError = ConfigError | ValidationError | BuildError | PersistError;
-
-/**
- * Combined layer providing all services.
- *
- * @remarks
- * This layer composes ConfigService, ValidationService, BuildService,
- * and PersistLocalService.
- * Use this when you need access to all services in your Effect program.
- *
- * @example Using AppLayer with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const buildService = yield* BuildService;
- *
- *   const { config } = yield* configService.load();
- *   const result = yield* buildService.build(config);
- *
- *   return result;
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
- *
- * @public
- */
-export declare const AppLayer: Layer.Layer<BuildService | ConfigService | PersistLocalService | ValidationService, never, never>;
-
-/**
- * Union of all build-related errors.
- *
- * @public
- */
-export declare type BuildError = BundleFailed | WriteError | CleanError | BuildFailed;
-
-/**
- * Error when the build process fails overall.
- *
- * @public
- */
-export declare class BuildFailed extends BuildFailedBase<{
-    /**
-     * Summary message of the build failure.
-     */
-    readonly message: string;
-    /**
-     * Number of entries that failed.
-     */
-    readonly failedEntries: number;
-}> {
-}
-
-/**
- * Base class for BuildFailed error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const BuildFailedBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "BuildFailed";
-} & Readonly<A>;
-
-/**
- * Layer providing BuildService (depends on ConfigService).
- *
- * @remarks
- * Includes ConfigService automatically.
- *
- * @public
- */
-export declare const BuildLayer: Layer.Layer<BuildService, never, never>;
-
-/**
- * Build options for the bundler.
- *
- * @public
- */
-export declare type BuildOptions = typeof BuildOptionsSchema.Type;
-
-/**
- * Schema for build options.
- *
- * @remarks
- * Build options control how the TypeScript source is bundled using rsbuild.
- * The bundler creates a single JavaScript file with all dependencies inlined.
- *
- * @internal
- */
-export declare const BuildOptionsSchema: Schema.Struct<{
-    /** Enable minification to reduce bundle size. Defaults to true. */
-    minify: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-    /** Generate source maps for debugging. Defaults to false. */
-    sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => false;
-    }>;
-    /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
-    externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-        default: () => never[];
-    }>;
-    /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
-    ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-        default: () => never[];
-    }>;
-}>;
-
-/**
- * Result of the complete build process.
- * @public
- */
-export declare type BuildResult = typeof BuildResultSchema.Type;
-
-/**
- * Result of the complete build process.
- * @internal
- */
-export declare const BuildResultSchema: Schema.Struct<{
-    /** Whether the overall build succeeded. */
-    success: typeof Schema.Boolean;
-    /** Results for each entry that was built. */
-    entries: Schema.Array$<Schema.Struct<{
-        /** Whether bundling succeeded. */
-        success: typeof Schema.Boolean;
-        /** Bundle statistics if successful. */
-        stats: Schema.optional<Schema.Struct<{
-            /** Entry type (main, pre, or post). */
-            entry: typeof Schema.String;
-            /** Bundle size in bytes. */
-            size: typeof Schema.Number;
-            /** Build duration in milliseconds. */
-            duration: typeof Schema.Number;
-            /** Output path relative to working directory. */
-            outputPath: typeof Schema.String;
-        }>>;
-        /** Error message if failed. */
-        error: Schema.optional<typeof Schema.String>;
-    }>>;
-    /** Total build duration in milliseconds. */
-    duration: typeof Schema.Number;
-    /** Error message if build failed. */
-    error: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Options for the build process.
- * @public
- */
-export declare type BuildRunnerOptions = typeof BuildRunnerOptionsSchema.Type;
-
-/**
- * Options for the build process.
- * @internal
- */
-export declare const BuildRunnerOptionsSchema: Schema.Struct<{
-    /** Working directory for the build. Accepts string, Buffer, or URL. */
-    cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL_2>]>, typeof Schema.String>>;
-    /** Clean output directory before building. Defaults to true. */
-    clean: Schema.optional<typeof Schema.Boolean>;
-}>;
-
-/**
- * BuildService interface for build and bundling capabilities.
- *
- * @remarks
- * This service handles:
- * - Bundling TypeScript entries with rsbuild
- * - Managing output directory
- * - Collecting build statistics
- * - Formatting build results
- *
- * @example Using BuildService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const buildService = yield* BuildService;
- *
- *   const { config } = yield* configService.load();
- *   const result = yield* buildService.build(config);
- *
- *   if (result.success) {
- *     console.log("Build complete:", result.entries.length, "entries");
- *   }
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
- *
- * @public
- */
-export declare interface BuildService {
-    /**
-     * Build all entries from the configuration.
-     *
-     * @param config - Configuration with entry points
-     * @param options - Build options
-     * @returns Effect that resolves to build result
-     */
-    readonly build: (config: Config, options?: BuildRunnerOptions) => Effect.Effect<BuildResult, BuildError | MainEntryMissing>;
-    /**
-     * Bundle a single entry point.
-     *
-     * @param entry - Entry to bundle
-     * @param config - Build configuration
-     * @returns Effect that resolves to bundle result
-     */
-    readonly bundle: (entry: DetectedEntry, config: Config) => Effect.Effect<BundleResult, BuildError>;
-    /**
-     * Clean the output directory.
-     *
-     * @param outputDir - Directory to clean
-     * @returns Effect that resolves when complete
-     */
-    readonly clean: (outputDir: string) => Effect.Effect<void, BuildError>;
-    /**
-     * Format build result for display.
-     *
-     * @param result - Build result to format
-     * @returns Formatted string for terminal output
-     */
-    readonly formatResult: (result: BuildResult) => string;
-    /**
-     * Format bytes as human-readable string.
-     *
-     * @param bytes - Number of bytes
-     * @returns Formatted string like "1.5 MB"
-     */
-    readonly formatBytes: (bytes: number) => string;
-}
-
-/**
- * BuildService tag for dependency injection.
- *
- * @public
- */
-export declare const BuildService: Context.Tag<BuildService, BuildService>;
-
-/**
- * Error when bundling with rsbuild fails.
- *
- * @public
- */
-export declare class BundleFailed extends BundleFailedBase<{
-    /**
-     * The entry file that failed to bundle.
-     */
-    readonly entry: string;
-    /**
-     * The underlying error or error message.
-     */
-    readonly cause: unknown;
-}> {
-}
-
-/**
- * Base class for BundleFailed error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const BundleFailedBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "BundleFailed";
-} & Readonly<A>;
-
-/**
- * Result of bundling a single entry.
- * @public
- */
-export declare type BundleResult = typeof BundleResultSchema.Type;
-
-/**
- * Result of bundling a single entry.
- * @internal
- */
-export declare const BundleResultSchema: Schema.Struct<{
-    /** Whether bundling succeeded. */
-    success: typeof Schema.Boolean;
-    /** Bundle statistics if successful. */
-    stats: Schema.optional<Schema.Struct<{
-        /** Entry type (main, pre, or post). */
-        entry: typeof Schema.String;
-        /** Bundle size in bytes. */
-        size: typeof Schema.Number;
-        /** Build duration in milliseconds. */
-        duration: typeof Schema.Number;
-        /** Output path relative to working directory. */
-        outputPath: typeof Schema.String;
-    }>>;
-    /** Error message if failed. */
-    error: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Statistics for a single bundled entry.
- * @public
- */
-export declare type BundleStats = typeof BundleStatsSchema.Type;
-
-/**
- * Statistics for a single bundled entry.
- * @internal
- */
-export declare const BundleStatsSchema: Schema.Struct<{
-    /** Entry type (main, pre, or post). */
-    entry: typeof Schema.String;
-    /** Bundle size in bytes. */
-    size: typeof Schema.Number;
-    /** Build duration in milliseconds. */
-    duration: typeof Schema.Number;
-    /** Output path relative to working directory. */
-    outputPath: typeof Schema.String;
-}>;
-
-/**
- * Error when cleaning the output directory fails.
- *
- * @public
- */
-export declare class CleanError extends CleanErrorBase<{
-    /**
-     * The directory that failed to clean.
-     */
-    readonly directory: string;
-    /**
-     * The underlying error or error message.
-     */
-    readonly cause: unknown;
-}> {
-}
-
-/**
- * Base class for CleanError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const CleanErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "CleanError";
-} & Readonly<A>;
-
-/**
- * Fully resolved configuration with all defaults applied.
- *
- * @remarks
- * This type represents the final configuration after all defaults
- * have been applied. It is the result of calling {@link defineConfig}.
- *
- * @public
- */
-export declare type Config = typeof ConfigSchema.Type;
-
-/**
- * Union of all configuration-related errors.
- *
- * @public
- */
-export declare type ConfigError = ConfigNotFound | ConfigInvalid | ConfigLoadFailed;
-
-/**
- * User-provided configuration input (all fields optional).
- *
- * @remarks
- * Use this type when accepting configuration from users.
- * All fields are optional and will be merged with defaults.
- *
- * @public
- */
-export declare type ConfigInput = typeof ConfigInputSchema.Type;
-
-/**
- * User-provided configuration input (all fields optional).
- *
- * @remarks
- * This schema is used for parsing user-provided configuration.
- * All sections are optional; defaults are applied via {@link defineConfig}.
- *
- * @internal
- */
-export declare const ConfigInputSchema: Schema.Struct<{
-    entries: Schema.optional<Schema.Struct<{
-        main: Schema.optional<typeof Schema.String>;
-        pre: Schema.optional<typeof Schema.String>;
-        post: Schema.optional<typeof Schema.String>;
-    }>>;
-    build: Schema.optional<Schema.Struct<{
-        minify: Schema.optional<typeof Schema.Boolean>;
-        sourceMap: Schema.optional<typeof Schema.Boolean>;
-        externals: Schema.optional<Schema.Array$<typeof Schema.String>>;
-        ignore: Schema.optional<Schema.Array$<typeof Schema.String>>;
-    }>>;
-    validation: Schema.optional<Schema.Struct<{
-        requireActionYml: Schema.optional<typeof Schema.Boolean>;
-        maxBundleSize: Schema.optional<typeof Schema.String>;
-        strict: Schema.optional<typeof Schema.Boolean>;
-    }>>;
-    persistLocal: Schema.optional<Schema.Struct<{
-        enabled: Schema.optional<typeof Schema.Boolean>;
-        path: Schema.optional<typeof Schema.String>;
-        actTemplate: Schema.optional<typeof Schema.Boolean>;
-    }>>;
-}>;
-
-/**
- * Error when configuration file exists but contains invalid content.
- *
- * @public
- */
-export declare class ConfigInvalid extends ConfigInvalidBase<{
-    /**
-     * The path to the invalid config file.
-     */
-    readonly path: string;
-    /**
-     * List of validation errors.
-     */
-    readonly errors: ReadonlyArray<string>;
-}> {
-}
-
-/**
- * Base class for ConfigInvalid error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ConfigInvalidBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ConfigInvalid";
-} & Readonly<A>;
-
-/**
- * Layer providing ConfigService (no dependencies).
- *
- * @remarks
- * Use this layer when you only need configuration management.
- *
- * @public
- */
-export declare const ConfigLayer: Layer.Layer<ConfigService, never, never>;
-
-/**
- * Error when configuration file fails to load (import error, syntax error, etc.).
- *
- * @public
- */
-export declare class ConfigLoadFailed extends ConfigLoadFailedBase<{
-    /**
-     * The path to the config file that failed to load.
-     */
-    readonly path: string;
-    /**
-     * The underlying error or error message.
-     */
-    readonly cause: unknown;
-}> {
-}
-
-/**
- * Base class for ConfigLoadFailed error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ConfigLoadFailedBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ConfigLoadFailed";
-} & Readonly<A>;
-
-/**
- * Error when configuration file is not found.
- *
- * @public
- */
-export declare class ConfigNotFound extends ConfigNotFoundBase<{
-    /**
-     * The path that was searched for the config file.
-     */
-    readonly path: string;
-    /**
-     * Additional context about the search.
-     */
-    readonly message?: string;
-}> {
-}
-
-/**
- * Base class for ConfigNotFound error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ConfigNotFoundBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ConfigNotFound";
-} & Readonly<A>;
-
-/**
- * Fully resolved configuration with all defaults applied.
- *
- * @internal
- */
-export declare const ConfigSchema: Schema.Struct<{
-    entries: Schema.Struct<{
-        /** Path to the main action entry point. Defaults to "src/main.ts". */
-        main: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        /** Path to the pre-action hook entry point. */
-        pre: Schema.optional<typeof Schema.String>;
-        /** Path to the post-action hook entry point. */
-        post: Schema.optional<typeof Schema.String>;
-    }>;
-    build: Schema.Struct<{
-        /** Enable minification to reduce bundle size. Defaults to true. */
-        minify: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        /** Generate source maps for debugging. Defaults to false. */
-        sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => false;
-        }>;
-        /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
-        externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-            default: () => never[];
-        }>;
-        /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
-        ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-            default: () => never[];
-        }>;
-    }>;
-    validation: Schema.Struct<{
-        /** Require action.yml to exist and be valid. Defaults to true. */
-        requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
-        maxBundleSize: Schema.optional<typeof Schema.String>;
-        /** Treat warnings as errors. Auto-detects from CI when undefined. */
-        strict: Schema.optional<typeof Schema.Boolean>;
-    }>;
-    persistLocal: Schema.Struct<{
-        /** Enable persisting build output locally. Defaults to true. */
-        enabled: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-        /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
-        path: Schema.optionalWith<typeof Schema.String, {
-            default: () => string;
-        }>;
-        /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
-        actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
-            default: () => true;
-        }>;
-    }>;
-}>;
-
-/**
- * ConfigService interface for configuration management capabilities.
- *
- * @remarks
- * This service handles:
- * - Loading configuration from `action.config.ts` files
- * - Resolving partial configuration with defaults
- * - Detecting entry points in the project
- *
- * @example Using ConfigService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, ConfigService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const result = yield* configService.load({ cwd: process.cwd() });
- *   console.log("Loaded config:", result.config);
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
- *
- * @public
- */
-export declare interface ConfigService {
-    /**
-     * Load configuration from file or use defaults.
-     *
-     * @param options - Loading options
-     * @returns Effect that resolves to the loaded configuration
-     */
-    readonly load: (options?: LoadConfigOptions) => Effect.Effect<LoadConfigResult, ConfigError>;
-    /**
-     * Resolve partial configuration input to full configuration.
-     *
-     * @param input - Partial configuration input
-     * @returns Effect that resolves to full configuration
-     */
-    readonly resolve: (input?: Partial<ConfigInput>) => Effect.Effect<Config, ConfigError>;
-    /**
-     * Detect entry points in the project.
-     *
-     * @param cwd - Working directory to search
-     * @param entries - Optional explicit entry configuration
-     * @returns Effect that resolves to detected entries
-     */
-    readonly detectEntries: (cwd: string, entries?: {
-        main?: string;
-        pre?: string;
-        post?: string;
-    }) => Effect.Effect<DetectEntriesResult, MainEntryMissing>;
-}
-
-/**
- * ConfigService tag for dependency injection.
- *
- * @public
- */
-export declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
-
-/**
- * Define a configuration with full TypeScript support.
- *
- * @remarks
- * This function validates the configuration and applies all defaults.
- * Use it in your `action.config.ts` file for autocomplete and type checking.
- *
- * @param config - Partial configuration object
- * @returns Fully resolved configuration with defaults applied
- *
- * @example Basic configuration file
- * ```typescript
- * // action.config.ts
- * import { defineConfig } from "@savvy-web/github-action-builder";
- *
- * export default defineConfig({
- *   entries: {
- *     main: "src/main.ts",
- *   },
- *   build: {
- *     minify: true,
- *   },
- * });
- * ```
- *
- * @example Full configuration with all options
- * ```typescript
- * // action.config.ts
- * import { defineConfig } from "@savvy-web/github-action-builder";
- *
- * export default defineConfig({
- *   entries: {
- *     main: "src/action.ts",
- *     pre: "src/setup.ts",
- *     post: "src/cleanup.ts",
- *   },
- *   build: {
- *     minify: true,
- *     sourceMap: true,
- *     externals: ["@aws-sdk/client-s3"],
- *     ignore: ["libxmljs2"],
- *   },
- *   validation: {
- *     requireActionYml: true,
- *     maxBundleSize: "10mb",
- *     strict: true,
- *   },
- * });
- * ```
- *
- * @public
- */
-export declare function defineConfig(config?: Partial<ConfigInput>): Config;
-
-/**
- * Detected entry point information.
- * @public
- */
-export declare type DetectedEntry = typeof DetectedEntrySchema.Type;
-
-/**
- * Detected entry point information.
- * @internal
- */
-export declare const DetectedEntrySchema: Schema.Struct<{
-    /** Entry type (main, pre, or post). */
-    type: Schema.Literal<["main", "pre", "post"]>;
-    /** Absolute path to the entry file. */
-    path: typeof Schema.String;
-    /** Output path for the bundled file. */
-    output: typeof Schema.String;
-}>;
-
-/**
- * Result of entry detection.
- * @public
- */
-export declare type DetectEntriesResult = typeof DetectEntriesResultSchema.Type;
-
-/**
- * Result of entry detection.
- * @internal
- */
-export declare const DetectEntriesResultSchema: Schema.Struct<{
-    /** Whether detection was successful. */
-    success: typeof Schema.Boolean;
-    /** Detected entries. */
-    entries: Schema.Array$<Schema.Struct<{
-        /** Entry type (main, pre, or post). */
-        type: Schema.Literal<["main", "pre", "post"]>;
-        /** Absolute path to the entry file. */
-        path: typeof Schema.String;
-        /** Output path for the bundled file. */
-        output: typeof Schema.String;
-    }>>;
-}>;
-
-/**
- * Entry point paths configuration.
- *
- * @public
- */
-export declare type Entries = typeof EntriesSchema.Type;
-
-/**
- * Schema for entry point paths.
- *
- * @remarks
- * GitHub Actions support three entry points:
- * - `main`: The primary action entry point (required)
- * - `pre`: Runs before the main action (optional)
- * - `post`: Runs after the main action for cleanup (optional)
- *
- * @internal
- */
-export declare const EntriesSchema: Schema.Struct<{
-    /** Path to the main action entry point. Defaults to "src/main.ts". */
-    main: Schema.optionalWith<typeof Schema.String, {
-        default: () => string;
-    }>;
-    /** Path to the pre-action hook entry point. */
-    pre: Schema.optional<typeof Schema.String>;
-    /** Path to the post-action hook entry point. */
-    post: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Error when an explicitly specified entry file is missing.
- *
- * @public
- */
-export declare class EntryFileMissing extends EntryFileMissingBase<{
-    /**
-     * The type of entry (main, pre, post).
-     */
-    readonly entryType: "main" | "pre" | "post";
-    /**
-     * The path that was specified but not found.
-     */
-    readonly path: string;
-}> {
-}
-
-/**
- * Base class for EntryFileMissing error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const EntryFileMissingBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "EntryFileMissing";
-} & Readonly<A>;
-
-/**
- * Main API class for building GitHub Actions.
- *
- * @remarks
- * This class provides a Promise-based interface wrapping Effect services.
- * It handles configuration loading, validation, and bundling in a single workflow.
- *
- * For Effect consumers, use the services directly:
- * - {@link ConfigService} for configuration
- * - {@link ValidationService} for validation
- * - {@link BuildService} for building
- *
- * @example Complete build workflow
- * ```typescript
- * import { GitHubAction } from "@savvy-web/github-action-builder";
- *
- * async function buildAction(): Promise<void> {
- *   const action = GitHubAction.create();
- *   const result = await action.build();
- *
- *   if (result.success) {
- *     console.log(`Built ${result.build?.entries.length} entry points`);
- *   } else {
- *     console.error(`Build failed: ${result.error}`);
- *     process.exit(1);
- *   }
- * }
- *
- * buildAction();
- * ```
- *
- * @example With custom configuration
- * ```typescript
- * import { GitHubAction } from "@savvy-web/github-action-builder";
- *
- * async function main(): Promise<void> {
- *   const action = GitHubAction.create({
- *     config: {
- *       entries: { main: "src/action.ts" },
- *       build: { minify: true },
- *     },
- *     cwd: "/path/to/project",
- *   });
- *
- *   const result = await action.build();
- *   console.log(result.success ? "Success" : result.error);
- * }
- *
- * main();
- * ```
- *
- * @public
- */
-export declare class GitHubAction {
-    /**
-     * Managed runtime for running Effects.
-     * @internal
-     */
-    private readonly runtime;
-    /**
-     * Cached configuration after first load.
-     * @internal
-     */
-    private config;
-    /**
-     * Resolved options.
-     * @internal
-     */
-    private readonly cwd;
-    private readonly configSource;
-    private readonly skipValidation;
-    private readonly clean;
-    private constructor();
-    /**
-     * Create a new GitHubAction builder instance.
-     *
-     * @param options - Builder options
-     * @returns A new GitHubAction instance
-     *
-     * @example
-     * ```typescript
-     * import { GitHubAction } from "@savvy-web/github-action-builder";
-     *
-     * // Auto-detect configuration
-     * const action = GitHubAction.create();
-     *
-     * // With inline config
-     * const action2 = GitHubAction.create({
-     *   config: { build: { minify: false } },
-     * });
-     *
-     * // With config file path
-     * const action3 = GitHubAction.create({
-     *   config: "./custom.config.ts",
-     * });
-     * ```
-     */
-    static create(options?: GitHubActionOptions): GitHubAction;
-    /**
-     * Load and resolve configuration.
-     *
-     * @remarks
-     * Configuration is cached after the first load. Subsequent calls
-     * return the cached configuration.
-     *
-     * @returns Resolved configuration with all defaults applied
-     * @throws Error if configuration file cannot be loaded or is invalid
-     */
-    loadConfig(): Promise<Config>;
-    /**
-     * Validate the action configuration and action.yml.
-     *
-     * @remarks
-     * Validation checks:
-     * - Entry point files exist
-     * - Output directory is writable
-     * - action.yml exists and is valid (if required)
-     *
-     * In CI environments, warnings are treated as errors by default.
-     *
-     * @param options - Validation options
-     * @returns Validation result with errors and warnings
-     */
-    validate(options?: ValidateOptions): Promise<ValidationResult>;
-    /**
-     * Build the GitHub Action.
-     *
-     * @remarks
-     * The build process:
-     * 1. Loads configuration (if not already loaded)
-     * 2. Validates the project (unless `skipValidation` is set)
-     * 3. Bundles each entry point with rsbuild
-     * 4. Writes output to the `dist/` directory
-     *
-     * @returns Build result with success status and details
-     *
-     * @example
-     * ```typescript
-     * import { GitHubAction } from "@savvy-web/github-action-builder";
-     *
-     * async function main(): Promise<void> {
-     *   const action = GitHubAction.create();
-     *   const result = await action.build();
-     *
-     *   if (result.success && result.build) {
-     *     console.log(`Built ${result.build.entries.length} entries`);
-     *   } else {
-     *     console.error(result.error);
-     *   }
-     * }
-     *
-     * main();
-     * ```
-     */
-    build(): Promise<GitHubActionBuildResult>;
-    /**
-     * Dispose the runtime and release resources.
-     *
-     * @remarks
-     * Call this when you're done using the GitHubAction instance
-     * to clean up any resources held by the Effect runtime.
-     */
-    dispose(): Promise<void>;
-}
-
-/**
- * Result of a GitHubAction build operation.
- * @public
- */
-export declare type GitHubActionBuildResult = typeof GitHubActionBuildResultSchema.Type;
-
-/**
- * Result of a GitHubAction build operation.
- *
- * @remarks
- * The result contains detailed information about both validation and build steps.
- * Check the `success` property first, then examine `error`, `validation`, or `build`
- * for details.
- *
- * @internal
- */
-export declare const GitHubActionBuildResultSchema: Schema.Struct<{
-    /** Whether the build completed successfully. */
-    success: typeof Schema.Boolean;
-    /** Build result details if the build step ran. */
-    build: Schema.optional<Schema.Struct<{
-        success: typeof Schema.Boolean;
-        entries: Schema.Array$<Schema.Struct<{
-            success: typeof Schema.Boolean;
-            stats: Schema.optional<Schema.Struct<{
-                entry: typeof Schema.String;
-                size: typeof Schema.Number;
-                duration: typeof Schema.Number;
-                outputPath: typeof Schema.String;
-            }>>;
-            error: Schema.optional<typeof Schema.String>;
-        }>>;
-        duration: typeof Schema.Number;
-        error: Schema.optional<typeof Schema.String>;
-    }>>;
-    /** Validation result if validation was performed. */
-    validation: Schema.optional<Schema.Struct<{
-        valid: typeof Schema.Boolean;
-        errors: Schema.Array$<Schema.Struct<{
-            code: typeof Schema.String;
-            message: typeof Schema.String;
-            file: Schema.optional<typeof Schema.String>;
-            suggestion: Schema.optional<typeof Schema.String>;
-        }>>;
-        warnings: Schema.Array$<Schema.Struct<{
-            code: typeof Schema.String;
-            message: typeof Schema.String;
-            file: Schema.optional<typeof Schema.String>;
-            suggestion: Schema.optional<typeof Schema.String>;
-        }>>;
-    }>>;
-    /** Persist-local result if persist was performed. */
-    persistLocal: Schema.optional<Schema.Struct<{
-        success: typeof Schema.Boolean;
-        filesCopied: typeof Schema.Number;
-        filesSkipped: typeof Schema.Number;
-        actTemplateGenerated: typeof Schema.Boolean;
-        outputPath: typeof Schema.String;
-        error: Schema.optional<typeof Schema.String>;
-    }>>;
-    /** Error message if the build or validation failed. */
-    error: Schema.optional<typeof Schema.String>;
-    /** Raw error object for programmatic inspection. */
-    cause: Schema.optional<typeof Schema.Unknown>;
-}>;
-
-/**
- * Options for creating a GitHubAction builder instance.
- *
- * @remarks
- * All options are optional. When no options are provided, the builder
- * auto-detects configuration from `action.config.ts` in the current directory.
- *
- * @public
- */
-export declare interface GitHubActionOptions {
-    /**
-     * Configuration object or path to config file.
-     *
-     * @remarks
-     * - If a string is provided, it's treated as a path to a config file
-     * - If an object is provided, it's used directly as configuration
-     * - If not provided, auto-detects `action.config.ts` or uses defaults
-     */
-    config?: Partial<ConfigInput> | string;
-    /**
-     * Working directory for the build.
-     *
-     * @defaultValue `process.cwd()`
-     */
-    cwd?: string;
-    /**
-     * Skip validation before building.
-     *
-     * @remarks
-     * Skipping validation is not recommended for production builds.
-     *
-     * @defaultValue `false`
-     */
-    skipValidation?: boolean;
-    /**
-     * Clean output directory before building.
-     *
-     * @defaultValue `true`
-     */
-    clean?: boolean;
-    /**
-     * Custom Effect Layer to use instead of the default AppLayer.
-     *
-     * @remarks
-     * Advanced option for testing or customizing service implementations.
-     */
-    layer?: Layer.Layer<ConfigService | ValidationService | BuildService | PersistLocalService>;
-}
-
-/**
- * Options for loading configuration.
- * @public
- */
-export declare type LoadConfigOptions = typeof LoadConfigOptionsSchema.Type;
-
-/**
- * Options for loading configuration.
- * @internal
- */
-export declare const LoadConfigOptionsSchema: Schema.Struct<{
-    /** Working directory to search for config. Accepts string, Buffer, or URL. */
-    cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL_2>]>, typeof Schema.String>>;
-    /** Explicit path to config file. Accepts string, Buffer, or URL. */
-    configPath: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL_2>]>, typeof Schema.String>>;
-}>;
-
-/**
- * Result of configuration loading.
- * @public
- */
-export declare interface LoadConfigResult {
-    /** The resolved configuration. */
-    config: Config;
-    /** Path to the config file that was loaded, if any. */
-    configPath?: string;
-    /** Whether defaults were used (no config file found). */
-    usingDefaults: boolean;
-}
-
-/**
- * Error when the required main entry point is missing.
- *
- * @public
- */
-export declare class MainEntryMissing extends MainEntryMissingBase<{
-    /**
-     * The expected path for the main entry.
-     */
-    readonly expectedPath: string;
-    /**
-     * The working directory that was searched.
-     */
-    readonly cwd: string;
-}> {
-}
-
-/**
- * Base class for MainEntryMissing error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const MainEntryMissingBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "MainEntryMissing";
-} & Readonly<A>;
-
-/**
- * Union of all persist-local-related errors.
- *
- * @public
- */
-export declare type PersistError = PersistLocalError | ActionYmlPathError;
-
-/**
- * Error when persisting build output to local action directory fails.
- *
- * @public
- */
-export declare class PersistLocalError extends PersistLocalErrorBase<{
-    /**
-     * The path involved in the failure.
-     */
-    readonly path: string;
-    /**
-     * The underlying error or error message.
-     */
-    readonly cause: unknown;
-}> {
-}
-
-/**
- * Base class for PersistLocalError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const PersistLocalErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "PersistLocalError";
-} & Readonly<A>;
-
-/**
- * Layer providing PersistLocalService (no dependencies).
- *
- * @remarks
- * Use this layer when you only need persist-local functionality.
- *
- * @public
- */
-export declare const PersistLocalLayer: Layer.Layer<PersistLocalService, never, never>;
-
-/**
- * Persist-local options for copying build output.
- *
- * @public
- */
-export declare type PersistLocalOptions = typeof PersistLocalOptionsSchema.Type;
-
-/**
- * Schema for persist-local options.
- *
- * @remarks
- * Controls automatic copying of build output to a local action directory
- * for testing with nektos/act.
- *
- * @internal
- */
-export declare const PersistLocalOptionsSchema: Schema.Struct<{
-    /** Enable persisting build output locally. Defaults to true. */
-    enabled: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-    /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
-    path: Schema.optionalWith<typeof Schema.String, {
-        default: () => string;
-    }>;
-    /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
-    actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-}>;
-
-/**
- * Result of the persist-local operation.
- * @public
- */
-export declare type PersistLocalResult = typeof PersistLocalResultSchema.Type;
-
-/**
- * Result of the persist-local operation.
- * @internal
- */
-export declare const PersistLocalResultSchema: Schema.Struct<{
-    /** Whether the operation completed successfully. */
-    success: typeof Schema.Boolean;
-    /** Number of files copied (changed or new). */
-    filesCopied: typeof Schema.Number;
-    /** Number of files skipped (unchanged). */
-    filesSkipped: typeof Schema.Number;
-    /** Whether act template files were generated. */
-    actTemplateGenerated: typeof Schema.Boolean;
-    /** Output path where files were persisted. */
-    outputPath: typeof Schema.String;
-    /** Error message if failed. */
-    error: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Options for the persist operation.
- * @public
- */
-export declare type PersistLocalRunnerOptions = typeof PersistLocalRunnerOptionsSchema.Type;
-
-/**
- * Options for the persist operation.
- * @internal
- */
-export declare const PersistLocalRunnerOptionsSchema: Schema.Struct<{
-    /** Working directory. Accepts string. */
-    cwd: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * PersistLocalService interface for copying build output locally.
- *
- * @remarks
- * This service handles:
- * - Smart-syncing action.yml and dist/ to a local action directory
- * - Hash-based comparison to avoid unnecessary copies
- * - Removing stale files in the destination
- * - Validating action.yml runs paths resolve in the destination
- * - Generating act boilerplate files
- *
- * @public
- */
-export declare interface PersistLocalService {
-    /**
-     * Persist build output to the local action directory.
-     *
-     * @param config - Configuration with persistLocal options
-     * @param options - Runner options (cwd, etc.)
-     * @returns Effect that resolves to persist result
-     */
-    readonly persist: (config: Config, options?: PersistLocalRunnerOptions) => Effect.Effect<PersistLocalResult, PersistLocalError | ActionYmlPathError>;
-    /**
-     * Format persist result for display.
-     *
-     * @param result - Persist result to format
-     * @returns Formatted string for terminal output
-     */
-    readonly formatResult: (result: PersistLocalResult) => string;
-}
-
-/**
- * PersistLocalService tag for dependency injection.
- *
- * @public
- */
-export declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocalService>;
-
-/**
- * Options for validation.
- * @public
- */
-export declare type ValidateOptions = typeof ValidateOptionsSchema.Type;
-
-/**
- * Options for validation.
- * @internal
- */
-export declare const ValidateOptionsSchema: Schema.Struct<{
-    /** Working directory for file operations. Accepts string, Buffer, or URL. */
-    cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL_2>]>, typeof Schema.String>>;
-    /** Force strict mode regardless of environment. Auto-detects from CI when undefined. */
-    strict: Schema.optional<typeof Schema.Boolean>;
-}>;
-
-/**
- * Union of all validation-related errors.
- *
- * @public
- */
-export declare type ValidationError = MainEntryMissing | EntryFileMissing | ActionYmlMissing | ActionYmlSyntaxError | ActionYmlSchemaError | ValidationFailed;
-
-/**
- * A validation error item.
- * @public
- */
-export declare type ValidationErrorItem = typeof ValidationErrorSchema.Type;
-
-/**
- * A validation error item.
- * @internal
- */
-export declare const ValidationErrorSchema: Schema.Struct<{
-    /** Error code for categorization. */
-    code: typeof Schema.String;
-    /** Human-readable error message. */
-    message: typeof Schema.String;
-    /** File path where error occurred. */
-    file: Schema.optional<typeof Schema.String>;
-    /** Suggestion for fixing the error. */
-    suggestion: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Error when validation fails in strict mode (CI environment).
- *
- * @public
- */
-export declare class ValidationFailed extends ValidationFailedBase<{
-    /**
-     * Number of errors encountered.
-     */
-    readonly errorCount: number;
-    /**
-     * Number of warnings encountered.
-     */
-    readonly warningCount: number;
-    /**
-     * Formatted validation result message.
-     */
-    readonly message: string;
-}> {
-}
-
-/**
- * Base class for ValidationFailed error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const ValidationFailedBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "ValidationFailed";
-} & Readonly<A>;
-
-/**
- * Layer providing ValidationService (depends on ConfigService).
- *
- * @remarks
- * Includes ConfigService automatically.
- *
- * @public
- */
-export declare const ValidationLayer: Layer.Layer<ValidationService, never, never>;
-
-/**
- * Validation options for the build process.
- *
- * @public
- */
-export declare type ValidationOptions = typeof ValidationOptionsSchema.Type;
-
-/**
- * Schema for validation options.
- *
- * @remarks
- * Validation options control how strictly the build process validates
- * the project structure and configuration before building.
- *
- * @internal
- */
-export declare const ValidationOptionsSchema: Schema.Struct<{
-    /** Require action.yml to exist and be valid. Defaults to true. */
-    requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
-        default: () => true;
-    }>;
-    /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
-    maxBundleSize: Schema.optional<typeof Schema.String>;
-    /** Treat warnings as errors. Auto-detects from CI when undefined. */
-    strict: Schema.optional<typeof Schema.Boolean>;
-}>;
-
-/**
- * Validation result with errors and warnings.
- * @public
- */
-export declare type ValidationResult = typeof ValidationResultSchema.Type;
-
-/**
- * Validation result with errors and warnings.
- * @internal
- */
-export declare const ValidationResultSchema: Schema.Struct<{
-    /** Whether validation passed (no errors, or only warnings in non-strict mode). */
-    valid: typeof Schema.Boolean;
-    /** Validation errors. */
-    errors: Schema.Array$<Schema.Struct<{
-        /** Error code for categorization. */
-        code: typeof Schema.String;
-        /** Human-readable error message. */
-        message: typeof Schema.String;
-        /** File path where error occurred. */
-        file: Schema.optional<typeof Schema.String>;
-        /** Suggestion for fixing the error. */
-        suggestion: Schema.optional<typeof Schema.String>;
-    }>>;
-    /** Validation warnings. */
-    warnings: Schema.Array$<Schema.Struct<{
-        /** Warning code for categorization. */
-        code: typeof Schema.String;
-        /** Human-readable warning message. */
-        message: typeof Schema.String;
-        /** File path where warning occurred. */
-        file: Schema.optional<typeof Schema.String>;
-        /** Suggestion for addressing the warning. */
-        suggestion: Schema.optional<typeof Schema.String>;
-    }>>;
-}>;
-
-/**
- * ValidationService interface for validation capabilities.
- *
- * @remarks
- * This service handles:
- * - Validating configuration and entry points
- * - Validating action.yml structure and schema
- * - Formatting validation results for display
- * - CI-aware strict mode handling
- *
- * @example Using ValidationService with Effect
- * ```typescript
- * import { Effect } from "effect";
- * import { AppLayer, ConfigService, ValidationService } from "@savvy-web/github-action-builder";
- *
- * const program = Effect.gen(function* () {
- *   const configService = yield* ConfigService;
- *   const validationService = yield* ValidationService;
- *
- *   const { config } = yield* configService.load();
- *   const result = yield* validationService.validate(config);
- *
- *   if (!result.valid) {
- *     console.error("Validation failed:", result.errors);
- *   }
- * });
- *
- * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
- * ```
- *
- * @public
- */
-export declare interface ValidationService {
-    /**
-     * Validate configuration and project structure.
-     *
-     * @param config - Configuration to validate
-     * @param options - Validation options
-     * @returns Effect that resolves to validation result
-     */
-    readonly validate: (config: Config, options?: ValidateOptions) => Effect.Effect<ValidationResult, ValidationError>;
-    /**
-     * Validate action.yml file.
-     *
-     * @param path - Path to action.yml file
-     * @returns Effect that resolves to action.yml validation result
-     */
-    readonly validateActionYml: (path: string) => Effect.Effect<ActionYmlResult, ValidationError>;
-    /**
-     * Format validation result for display.
-     *
-     * @param result - Validation result to format
-     * @returns Formatted string for terminal output
-     */
-    readonly formatResult: (result: ValidationResult) => string;
-    /**
-     * Check if running in CI environment.
-     *
-     * @returns Effect that resolves to true if in CI
-     */
-    readonly isCI: () => Effect.Effect<boolean>;
-    /**
-     * Check if strict mode is enabled.
-     *
-     * @param configStrict - Optional config override
-     * @returns Effect that resolves to true if strict mode
-     */
-    readonly isStrict: (configStrict?: boolean) => Effect.Effect<boolean>;
-}
-
-/**
- * ValidationService tag for dependency injection.
- *
- * @public
- */
-export declare const ValidationService: Context.Tag<ValidationService, ValidationService>;
-
-/**
- * A validation warning.
- * @public
- */
-export declare type ValidationWarning = typeof ValidationWarningSchema.Type;
-
-/**
- * A validation warning.
- * @internal
- */
-export declare const ValidationWarningSchema: Schema.Struct<{
-    /** Warning code for categorization. */
-    code: typeof Schema.String;
-    /** Human-readable warning message. */
-    message: typeof Schema.String;
-    /** File path where warning occurred. */
-    file: Schema.optional<typeof Schema.String>;
-    /** Suggestion for addressing the warning. */
-    suggestion: Schema.optional<typeof Schema.String>;
-}>;
-
-/**
- * Error when writing output files fails.
- *
- * @public
- */
-export declare class WriteError extends WriteErrorBase<{
-    /**
-     * The path that failed to write.
-     */
-    readonly path: string;
-    /**
-     * The underlying error or error message.
-     */
-    readonly cause: unknown;
-}> {
-}
-
-/**
- * Base class for WriteError error.
- *
- * @privateRemarks
- * This export is required for api-extractor documentation generation.
- * Effect's Data.TaggedError creates an anonymous base class that must be
- * explicitly exported to avoid "forgotten export" warnings. Do not delete.
- *
- * @internal
- */
-export declare const WriteErrorBase: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<    { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => YieldableError & {
-    readonly _tag: "WriteError";
-} & Readonly<A>;
-
-export { }
+import { Context, Effect, Layer, Schema } from "effect";
+
+//#region src/schemas/config.d.ts
+/**
+ * Schema for entry point paths.
+ *
+ * @remarks
+ * GitHub Actions support three entry points:
+ * - `main`: The primary action entry point (required)
+ * - `pre`: Runs before the main action (optional)
+ * - `post`: Runs after the main action for cleanup (optional)
+ *
+ * @internal
+ */
+declare const EntriesSchema: Schema.Struct<{
+  /** Path to the main action entry point. Defaults to "src/main.ts". */main: Schema.optionalWith<typeof Schema.String, {
+    default: () => string;
+  }>; /** Path to the pre-action hook entry point. */
+  pre: Schema.optional<typeof Schema.String>; /** Path to the post-action hook entry point. */
+  post: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Entry point paths configuration.
+ *
+ * @public
+ */
+type Entries = typeof EntriesSchema.Type;
+/**
+ * Schema for build options.
+ *
+ * @remarks
+ * Build options control how the TypeScript source is bundled using rsbuild.
+ * The bundler creates a single JavaScript file with all dependencies inlined.
+ *
+ * @internal
+ */
+declare const BuildOptionsSchema: Schema.Struct<{
+  /** Enable minification to reduce bundle size. Defaults to true. */minify: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>; /** Generate source maps for debugging. Defaults to false. */
+  sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => false;
+  }>; /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
+  externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+    default: () => never[];
+  }>; /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
+  ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+    default: () => never[];
+  }>;
+}>;
+/**
+ * Build options for the bundler.
+ *
+ * @public
+ */
+type BuildOptions = typeof BuildOptionsSchema.Type;
+/**
+ * Schema for validation options.
+ *
+ * @remarks
+ * Validation options control how strictly the build process validates
+ * the project structure and configuration before building.
+ *
+ * @internal
+ */
+declare const ValidationOptionsSchema: Schema.Struct<{
+  /** Require action.yml to exist and be valid. Defaults to true. */requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>; /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
+  maxBundleSize: Schema.optional<typeof Schema.String>; /** Treat warnings as errors. Auto-detects from CI when undefined. */
+  strict: Schema.optional<typeof Schema.Boolean>;
+}>;
+/**
+ * Validation options for the build process.
+ *
+ * @public
+ */
+type ValidationOptions = typeof ValidationOptionsSchema.Type;
+/**
+ * Schema for persist-local options.
+ *
+ * @remarks
+ * Controls automatic copying of build output to a local action directory
+ * for testing with nektos/act.
+ *
+ * @internal
+ */
+declare const PersistLocalOptionsSchema: Schema.Struct<{
+  /** Enable persisting build output locally. Defaults to true. */enabled: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>; /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
+  path: Schema.optionalWith<typeof Schema.String, {
+    default: () => string;
+  }>; /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
+  actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
+    default: () => true;
+  }>;
+}>;
+/**
+ * Persist-local options for copying build output.
+ *
+ * @public
+ */
+type PersistLocalOptions = typeof PersistLocalOptionsSchema.Type;
+/**
+ * User-provided configuration input (all fields optional).
+ *
+ * @remarks
+ * This schema is used for parsing user-provided configuration.
+ * All sections are optional; defaults are applied via {@link defineConfig}.
+ *
+ * @internal
+ */
+declare const ConfigInputSchema: Schema.Struct<{
+  entries: Schema.optional<Schema.Struct<{
+    main: Schema.optional<typeof Schema.String>;
+    pre: Schema.optional<typeof Schema.String>;
+    post: Schema.optional<typeof Schema.String>;
+  }>>;
+  build: Schema.optional<Schema.Struct<{
+    minify: Schema.optional<typeof Schema.Boolean>;
+    sourceMap: Schema.optional<typeof Schema.Boolean>;
+    externals: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    ignore: Schema.optional<Schema.Array$<typeof Schema.String>>;
+  }>>;
+  validation: Schema.optional<Schema.Struct<{
+    requireActionYml: Schema.optional<typeof Schema.Boolean>;
+    maxBundleSize: Schema.optional<typeof Schema.String>;
+    strict: Schema.optional<typeof Schema.Boolean>;
+  }>>;
+  persistLocal: Schema.optional<Schema.Struct<{
+    enabled: Schema.optional<typeof Schema.Boolean>;
+    path: Schema.optional<typeof Schema.String>;
+    actTemplate: Schema.optional<typeof Schema.Boolean>;
+  }>>;
+}>;
+/**
+ * User-provided configuration input (all fields optional).
+ *
+ * @remarks
+ * Use this type when accepting configuration from users.
+ * All fields are optional and will be merged with defaults.
+ *
+ * @public
+ */
+type ConfigInput = typeof ConfigInputSchema.Type;
+/**
+ * Fully resolved configuration with all defaults applied.
+ *
+ * @internal
+ */
+declare const ConfigSchema: Schema.Struct<{
+  entries: Schema.Struct<{
+    /** Path to the main action entry point. Defaults to "src/main.ts". */main: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>; /** Path to the pre-action hook entry point. */
+    pre: Schema.optional<typeof Schema.String>; /** Path to the post-action hook entry point. */
+    post: Schema.optional<typeof Schema.String>;
+  }>;
+  build: Schema.Struct<{
+    /** Enable minification to reduce bundle size. Defaults to true. */minify: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>; /** Generate source maps for debugging. Defaults to false. */
+    sourceMap: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => false;
+    }>; /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
+    externals: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+      default: () => never[];
+    }>; /** Packages to exclude from the bundle and replace with a stub that throws if loaded at runtime. Use for optional transitive dependencies the action never exercises (e.g. native modules). Defaults to []. */
+    ignore: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
+      default: () => never[];
+    }>;
+  }>;
+  validation: Schema.Struct<{
+    /** Require action.yml to exist and be valid. Defaults to true. */requireActionYml: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>; /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
+    maxBundleSize: Schema.optional<typeof Schema.String>; /** Treat warnings as errors. Auto-detects from CI when undefined. */
+    strict: Schema.optional<typeof Schema.Boolean>;
+  }>;
+  persistLocal: Schema.Struct<{
+    /** Enable persisting build output locally. Defaults to true. */enabled: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>; /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
+    path: Schema.optionalWith<typeof Schema.String, {
+      default: () => string;
+    }>; /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
+    actTemplate: Schema.optionalWith<typeof Schema.Boolean, {
+      default: () => true;
+    }>;
+  }>;
+}>;
+/**
+ * Fully resolved configuration with all defaults applied.
+ *
+ * @remarks
+ * This type represents the final configuration after all defaults
+ * have been applied. It is the result of calling {@link defineConfig}.
+ *
+ * @public
+ */
+type Config = typeof ConfigSchema.Type;
+/**
+ * Define a configuration with full TypeScript support.
+ *
+ * @remarks
+ * This function validates the configuration and applies all defaults.
+ * Use it in your `action.config.ts` file for autocomplete and type checking.
+ *
+ * @param config - Partial configuration object
+ * @returns Fully resolved configuration with defaults applied
+ *
+ * @example Basic configuration file
+ * ```typescript
+ * // action.config.ts
+ * import { defineConfig } from "@savvy-web/github-action-builder";
+ *
+ * export default defineConfig({
+ *   entries: {
+ *     main: "src/main.ts",
+ *   },
+ *   build: {
+ *     minify: true,
+ *   },
+ * });
+ * ```
+ *
+ * @example Full configuration with all options
+ * ```typescript
+ * // action.config.ts
+ * import { defineConfig } from "@savvy-web/github-action-builder";
+ *
+ * export default defineConfig({
+ *   entries: {
+ *     main: "src/action.ts",
+ *     pre: "src/setup.ts",
+ *     post: "src/cleanup.ts",
+ *   },
+ *   build: {
+ *     minify: true,
+ *     sourceMap: true,
+ *     externals: ["@aws-sdk/client-s3"],
+ *     ignore: ["libxmljs2"],
+ *   },
+ *   validation: {
+ *     requireActionYml: true,
+ *     maxBundleSize: "10mb",
+ *     strict: true,
+ *   },
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function defineConfig(config?: Partial<ConfigInput>): Config;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Base class for ConfigNotFound error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ConfigNotFoundBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ConfigNotFound";
+} & Readonly<A>;
+/**
+ * Error when configuration file is not found.
+ *
+ * @public
+ */
+declare class ConfigNotFound extends ConfigNotFoundBase<{
+  /**
+   * The path that was searched for the config file.
+   */
+  readonly path: string;
+  /**
+   * Additional context about the search.
+   */
+  readonly message?: string;
+}> {}
+/**
+ * Base class for ConfigInvalid error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ConfigInvalidBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ConfigInvalid";
+} & Readonly<A>;
+/**
+ * Error when configuration file exists but contains invalid content.
+ *
+ * @public
+ */
+declare class ConfigInvalid extends ConfigInvalidBase<{
+  /**
+   * The path to the invalid config file.
+   */
+  readonly path: string;
+  /**
+   * List of validation errors.
+   */
+  readonly errors: ReadonlyArray<string>;
+}> {}
+/**
+ * Base class for ConfigLoadFailed error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ConfigLoadFailedBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ConfigLoadFailed";
+} & Readonly<A>;
+/**
+ * Error when configuration file fails to load (import error, syntax error, etc.).
+ *
+ * @public
+ */
+declare class ConfigLoadFailed extends ConfigLoadFailedBase<{
+  /**
+   * The path to the config file that failed to load.
+   */
+  readonly path: string;
+  /**
+   * The underlying error or error message.
+   */
+  readonly cause: unknown;
+}> {}
+/**
+ * Union of all configuration-related errors.
+ *
+ * @public
+ */
+type ConfigError = ConfigNotFound | ConfigInvalid | ConfigLoadFailed;
+/**
+ * Base class for MainEntryMissing error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const MainEntryMissingBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "MainEntryMissing";
+} & Readonly<A>;
+/**
+ * Error when the required main entry point is missing.
+ *
+ * @public
+ */
+declare class MainEntryMissing extends MainEntryMissingBase<{
+  /**
+   * The expected path for the main entry.
+   */
+  readonly expectedPath: string;
+  /**
+   * The working directory that was searched.
+   */
+  readonly cwd: string;
+}> {}
+/**
+ * Base class for EntryFileMissing error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const EntryFileMissingBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "EntryFileMissing";
+} & Readonly<A>;
+/**
+ * Error when an explicitly specified entry file is missing.
+ *
+ * @public
+ */
+declare class EntryFileMissing extends EntryFileMissingBase<{
+  /**
+   * The type of entry (main, pre, post).
+   */
+  readonly entryType: "main" | "pre" | "post";
+  /**
+   * The path that was specified but not found.
+   */
+  readonly path: string;
+}> {}
+/**
+ * Base class for ActionYmlMissing error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ActionYmlMissingBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ActionYmlMissing";
+} & Readonly<A>;
+/**
+ * Error when action.yml file is missing.
+ *
+ * @public
+ */
+declare class ActionYmlMissing extends ActionYmlMissingBase<{
+  /**
+   * The working directory that was searched.
+   */
+  readonly cwd: string;
+}> {}
+/**
+ * Base class for ActionYmlSyntaxError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ActionYmlSyntaxErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ActionYmlSyntaxError";
+} & Readonly<A>;
+/**
+ * Error when action.yml has invalid YAML syntax.
+ *
+ * @public
+ */
+declare class ActionYmlSyntaxError extends ActionYmlSyntaxErrorBase<{
+  /**
+   * The path to the action.yml file.
+   */
+  readonly path: string;
+  /**
+   * The syntax error message.
+   */
+  readonly message: string;
+  /**
+   * Line number where the error occurred, if available.
+   */
+  readonly line?: number;
+  /**
+   * Column number where the error occurred, if available.
+   */
+  readonly column?: number;
+}> {}
+/**
+ * Base class for ActionYmlSchemaError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ActionYmlSchemaErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ActionYmlSchemaError";
+} & Readonly<A>;
+/**
+ * Error when action.yml fails schema validation.
+ *
+ * @public
+ */
+declare class ActionYmlSchemaError extends ActionYmlSchemaErrorBase<{
+  /**
+   * The path to the action.yml file.
+   */
+  readonly path: string;
+  /**
+   * List of schema validation errors.
+   */
+  readonly errors: ReadonlyArray<{
+    readonly path: string;
+    readonly message: string;
+  }>;
+}> {}
+/**
+ * Base class for ValidationFailed error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ValidationFailedBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ValidationFailed";
+} & Readonly<A>;
+/**
+ * Error when validation fails in strict mode (CI environment).
+ *
+ * @public
+ */
+declare class ValidationFailed extends ValidationFailedBase<{
+  /**
+   * Number of errors encountered.
+   */
+  readonly errorCount: number;
+  /**
+   * Number of warnings encountered.
+   */
+  readonly warningCount: number;
+  /**
+   * Formatted validation result message.
+   */
+  readonly message: string;
+}> {}
+/**
+ * Union of all validation-related errors.
+ *
+ * @public
+ */
+type ValidationError = MainEntryMissing | EntryFileMissing | ActionYmlMissing | ActionYmlSyntaxError | ActionYmlSchemaError | ValidationFailed;
+/**
+ * Base class for BundleFailed error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const BundleFailedBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "BundleFailed";
+} & Readonly<A>;
+/**
+ * Error when bundling with rsbuild fails.
+ *
+ * @public
+ */
+declare class BundleFailed extends BundleFailedBase<{
+  /**
+   * The entry file that failed to bundle.
+   */
+  readonly entry: string;
+  /**
+   * The underlying error or error message.
+   */
+  readonly cause: unknown;
+}> {}
+/**
+ * Base class for WriteError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const WriteErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "WriteError";
+} & Readonly<A>;
+/**
+ * Error when writing output files fails.
+ *
+ * @public
+ */
+declare class WriteError extends WriteErrorBase<{
+  /**
+   * The path that failed to write.
+   */
+  readonly path: string;
+  /**
+   * The underlying error or error message.
+   */
+  readonly cause: unknown;
+}> {}
+/**
+ * Base class for CleanError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const CleanErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "CleanError";
+} & Readonly<A>;
+/**
+ * Error when cleaning the output directory fails.
+ *
+ * @public
+ */
+declare class CleanError extends CleanErrorBase<{
+  /**
+   * The directory that failed to clean.
+   */
+  readonly directory: string;
+  /**
+   * The underlying error or error message.
+   */
+  readonly cause: unknown;
+}> {}
+/**
+ * Base class for BuildFailed error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const BuildFailedBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "BuildFailed";
+} & Readonly<A>;
+/**
+ * Error when the build process fails overall.
+ *
+ * @public
+ */
+declare class BuildFailed extends BuildFailedBase<{
+  /**
+   * Summary message of the build failure.
+   */
+  readonly message: string;
+  /**
+   * Number of entries that failed.
+   */
+  readonly failedEntries: number;
+}> {}
+/**
+ * Union of all build-related errors.
+ *
+ * @public
+ */
+type BuildError = BundleFailed | WriteError | CleanError | BuildFailed;
+/**
+ * Base class for PersistLocalError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const PersistLocalErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "PersistLocalError";
+} & Readonly<A>;
+/**
+ * Error when persisting build output to local action directory fails.
+ *
+ * @public
+ */
+declare class PersistLocalError extends PersistLocalErrorBase<{
+  /**
+   * The path involved in the failure.
+   */
+  readonly path: string;
+  /**
+   * The underlying error or error message.
+   */
+  readonly cause: unknown;
+}> {}
+/**
+ * Base class for ActionYmlPathError error.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+declare const ActionYmlPathErrorBase: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
+  readonly _tag: "ActionYmlPathError";
+} & Readonly<A>;
+/**
+ * Error when action.yml runs paths don't resolve correctly in destination.
+ *
+ * @public
+ */
+declare class ActionYmlPathError extends ActionYmlPathErrorBase<{
+  /**
+   * The entry type whose path failed validation (main, pre, post).
+   */
+  readonly entryType: string;
+  /**
+   * The path specified in action.yml.
+   */
+  readonly specifiedPath: string;
+  /**
+   * The expected resolved path.
+   */
+  readonly expectedPath: string;
+}> {}
+/**
+ * Union of all persist-local-related errors.
+ *
+ * @public
+ */
+type PersistError = PersistLocalError | ActionYmlPathError;
+/**
+ * Union of all possible errors in the GitHub Action Builder.
+ *
+ * @public
+ */
+type AppError = ConfigError | ValidationError | BuildError | PersistError;
+//#endregion
+//#region src/services/config.d.ts
+/**
+ * Options for loading configuration.
+ * @internal
+ */
+declare const LoadConfigOptionsSchema: Schema.Struct<{
+  /** Working directory to search for config. Accepts string, Buffer, or URL. */cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>; /** Explicit path to config file. Accepts string, Buffer, or URL. */
+  configPath: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>;
+}>;
+/**
+ * Options for loading configuration.
+ * @public
+ */
+type LoadConfigOptions = typeof LoadConfigOptionsSchema.Type;
+/**
+ * Detected entry point information.
+ * @internal
+ */
+declare const DetectedEntrySchema: Schema.Struct<{
+  /** Entry type (main, pre, or post). */type: Schema.Literal<["main", "pre", "post"]>; /** Absolute path to the entry file. */
+  path: typeof Schema.String; /** Output path for the bundled file. */
+  output: typeof Schema.String;
+}>;
+/**
+ * Detected entry point information.
+ * @public
+ */
+type DetectedEntry = typeof DetectedEntrySchema.Type;
+/**
+ * Result of entry detection.
+ * @internal
+ */
+declare const DetectEntriesResultSchema: Schema.Struct<{
+  /** Whether detection was successful. */success: typeof Schema.Boolean; /** Detected entries. */
+  entries: Schema.Array$<Schema.Struct<{
+    /** Entry type (main, pre, or post). */type: Schema.Literal<["main", "pre", "post"]>; /** Absolute path to the entry file. */
+    path: typeof Schema.String; /** Output path for the bundled file. */
+    output: typeof Schema.String;
+  }>>;
+}>;
+/**
+ * Result of entry detection.
+ * @public
+ */
+type DetectEntriesResult = typeof DetectEntriesResultSchema.Type;
+/**
+ * Result of configuration loading.
+ * @public
+ */
+interface LoadConfigResult {
+  /** The resolved configuration. */
+  config: Config;
+  /** Path to the config file that was loaded, if any. */
+  configPath?: string;
+  /** Whether defaults were used (no config file found). */
+  usingDefaults: boolean;
+}
+/**
+ * ConfigService interface for configuration management capabilities.
+ *
+ * @remarks
+ * This service handles:
+ * - Loading configuration from `action.config.ts` files
+ * - Resolving partial configuration with defaults
+ * - Detecting entry points in the project
+ *
+ * @example Using ConfigService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, ConfigService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const result = yield* configService.load({ cwd: process.cwd() });
+ *   console.log("Loaded config:", result.config);
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
+ *
+ * @public
+ */
+interface ConfigService {
+  /**
+   * Load configuration from file or use defaults.
+   *
+   * @param options - Loading options
+   * @returns Effect that resolves to the loaded configuration
+   */
+  readonly load: (options?: LoadConfigOptions) => Effect.Effect<LoadConfigResult, ConfigError>;
+  /**
+   * Resolve partial configuration input to full configuration.
+   *
+   * @param input - Partial configuration input
+   * @returns Effect that resolves to full configuration
+   */
+  readonly resolve: (input?: Partial<ConfigInput>) => Effect.Effect<Config, ConfigError>;
+  /**
+   * Detect entry points in the project.
+   *
+   * @param cwd - Working directory to search
+   * @param entries - Optional explicit entry configuration
+   * @returns Effect that resolves to detected entries
+   */
+  readonly detectEntries: (cwd: string, entries?: {
+    main?: string;
+    pre?: string;
+    post?: string;
+  }) => Effect.Effect<DetectEntriesResult, MainEntryMissing>;
+}
+/**
+ * ConfigService tag for dependency injection.
+ *
+ * @public
+ */
+declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
+//#endregion
+//#region src/services/build.d.ts
+/**
+ * Options for the build process.
+ * @internal
+ */
+declare const BuildRunnerOptionsSchema: Schema.Struct<{
+  /** Working directory for the build. Accepts string, Buffer, or URL. */cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>; /** Clean output directory before building. Defaults to true. */
+  clean: Schema.optional<typeof Schema.Boolean>;
+}>;
+/**
+ * Options for the build process.
+ * @public
+ */
+type BuildRunnerOptions = typeof BuildRunnerOptionsSchema.Type;
+/**
+ * Statistics for a single bundled entry.
+ * @internal
+ */
+declare const BundleStatsSchema: Schema.Struct<{
+  /** Entry type (main, pre, or post). */entry: typeof Schema.String; /** Bundle size in bytes. */
+  size: typeof Schema.Number; /** Build duration in milliseconds. */
+  duration: typeof Schema.Number; /** Output path relative to working directory. */
+  outputPath: typeof Schema.String;
+}>;
+/**
+ * Statistics for a single bundled entry.
+ * @public
+ */
+type BundleStats = typeof BundleStatsSchema.Type;
+/**
+ * Result of bundling a single entry.
+ * @internal
+ */
+declare const BundleResultSchema: Schema.Struct<{
+  /** Whether bundling succeeded. */success: typeof Schema.Boolean; /** Bundle statistics if successful. */
+  stats: Schema.optional<Schema.Struct<{
+    /** Entry type (main, pre, or post). */entry: typeof Schema.String; /** Bundle size in bytes. */
+    size: typeof Schema.Number; /** Build duration in milliseconds. */
+    duration: typeof Schema.Number; /** Output path relative to working directory. */
+    outputPath: typeof Schema.String;
+  }>>; /** Error message if failed. */
+  error: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Result of bundling a single entry.
+ * @public
+ */
+type BundleResult = typeof BundleResultSchema.Type;
+/**
+ * Result of the complete build process.
+ * @internal
+ */
+declare const BuildResultSchema: Schema.Struct<{
+  /** Whether the overall build succeeded. */success: typeof Schema.Boolean; /** Results for each entry that was built. */
+  entries: Schema.Array$<Schema.Struct<{
+    /** Whether bundling succeeded. */success: typeof Schema.Boolean; /** Bundle statistics if successful. */
+    stats: Schema.optional<Schema.Struct<{
+      /** Entry type (main, pre, or post). */entry: typeof Schema.String; /** Bundle size in bytes. */
+      size: typeof Schema.Number; /** Build duration in milliseconds. */
+      duration: typeof Schema.Number; /** Output path relative to working directory. */
+      outputPath: typeof Schema.String;
+    }>>; /** Error message if failed. */
+    error: Schema.optional<typeof Schema.String>;
+  }>>; /** Total build duration in milliseconds. */
+  duration: typeof Schema.Number; /** Error message if build failed. */
+  error: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Result of the complete build process.
+ * @public
+ */
+type BuildResult = typeof BuildResultSchema.Type;
+/**
+ * BuildService interface for build and bundling capabilities.
+ *
+ * @remarks
+ * This service handles:
+ * - Bundling TypeScript entries with rsbuild
+ * - Managing output directory
+ * - Collecting build statistics
+ * - Formatting build results
+ *
+ * @example Using BuildService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const buildService = yield* BuildService;
+ *
+ *   const { config } = yield* configService.load();
+ *   const result = yield* buildService.build(config);
+ *
+ *   if (result.success) {
+ *     console.log("Build complete:", result.entries.length, "entries");
+ *   }
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
+ *
+ * @public
+ */
+interface BuildService {
+  /**
+   * Build all entries from the configuration.
+   *
+   * @param config - Configuration with entry points
+   * @param options - Build options
+   * @returns Effect that resolves to build result
+   */
+  readonly build: (config: Config, options?: BuildRunnerOptions) => Effect.Effect<BuildResult, BuildError | MainEntryMissing>;
+  /**
+   * Bundle a single entry point.
+   *
+   * @param entry - Entry to bundle
+   * @param config - Build configuration
+   * @returns Effect that resolves to bundle result
+   */
+  readonly bundle: (entry: DetectedEntry, config: Config) => Effect.Effect<BundleResult, BuildError>;
+  /**
+   * Clean the output directory.
+   *
+   * @param outputDir - Directory to clean
+   * @returns Effect that resolves when complete
+   */
+  readonly clean: (outputDir: string) => Effect.Effect<void, BuildError>;
+  /**
+   * Format build result for display.
+   *
+   * @param result - Build result to format
+   * @returns Formatted string for terminal output
+   */
+  readonly formatResult: (result: BuildResult) => string;
+  /**
+   * Format bytes as human-readable string.
+   *
+   * @param bytes - Number of bytes
+   * @returns Formatted string like "1.5 MB"
+   */
+  readonly formatBytes: (bytes: number) => string;
+}
+/**
+ * BuildService tag for dependency injection.
+ *
+ * @public
+ */
+declare const BuildService: Context.Tag<BuildService, BuildService>;
+//#endregion
+//#region src/services/persist-local.d.ts
+/**
+ * Options for the persist operation.
+ * @internal
+ */
+declare const PersistLocalRunnerOptionsSchema: Schema.Struct<{
+  /** Working directory. Accepts string. */cwd: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Options for the persist operation.
+ * @public
+ */
+type PersistLocalRunnerOptions = typeof PersistLocalRunnerOptionsSchema.Type;
+/**
+ * Result of the persist-local operation.
+ * @internal
+ */
+declare const PersistLocalResultSchema: Schema.Struct<{
+  /** Whether the operation completed successfully. */success: typeof Schema.Boolean; /** Number of files copied (changed or new). */
+  filesCopied: typeof Schema.Number; /** Number of files skipped (unchanged). */
+  filesSkipped: typeof Schema.Number; /** Whether act template files were generated. */
+  actTemplateGenerated: typeof Schema.Boolean; /** Output path where files were persisted. */
+  outputPath: typeof Schema.String; /** Error message if failed. */
+  error: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Result of the persist-local operation.
+ * @public
+ */
+type PersistLocalResult = typeof PersistLocalResultSchema.Type;
+/**
+ * PersistLocalService interface for copying build output locally.
+ *
+ * @remarks
+ * This service handles:
+ * - Smart-syncing action.yml and dist/ to a local action directory
+ * - Hash-based comparison to avoid unnecessary copies
+ * - Removing stale files in the destination
+ * - Validating action.yml runs paths resolve in the destination
+ * - Generating act boilerplate files
+ *
+ * @public
+ */
+interface PersistLocalService {
+  /**
+   * Persist build output to the local action directory.
+   *
+   * @param config - Configuration with persistLocal options
+   * @param options - Runner options (cwd, etc.)
+   * @returns Effect that resolves to persist result
+   */
+  readonly persist: (config: Config, options?: PersistLocalRunnerOptions) => Effect.Effect<PersistLocalResult, PersistLocalError | ActionYmlPathError>;
+  /**
+   * Format persist result for display.
+   *
+   * @param result - Persist result to format
+   * @returns Formatted string for terminal output
+   */
+  readonly formatResult: (result: PersistLocalResult) => string;
+}
+/**
+ * PersistLocalService tag for dependency injection.
+ *
+ * @public
+ */
+declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocalService>;
+//#endregion
+//#region src/services/validation.d.ts
+/**
+ * Options for validation.
+ * @internal
+ */
+declare const ValidateOptionsSchema: Schema.Struct<{
+  /** Working directory for file operations. Accepts string, Buffer, or URL. */cwd: Schema.optional<Schema.transform<Schema.Union<[typeof Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>>, Schema.instanceOf<URL>]>, typeof Schema.String>>; /** Force strict mode regardless of environment. Auto-detects from CI when undefined. */
+  strict: Schema.optional<typeof Schema.Boolean>;
+}>;
+/**
+ * Options for validation.
+ * @public
+ */
+type ValidateOptions = typeof ValidateOptionsSchema.Type;
+/**
+ * A validation error item.
+ * @internal
+ */
+declare const ValidationErrorSchema: Schema.Struct<{
+  /** Error code for categorization. */code: typeof Schema.String; /** Human-readable error message. */
+  message: typeof Schema.String; /** File path where error occurred. */
+  file: Schema.optional<typeof Schema.String>; /** Suggestion for fixing the error. */
+  suggestion: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * A validation error item.
+ * @public
+ */
+type ValidationErrorItem = typeof ValidationErrorSchema.Type;
+/**
+ * A validation warning.
+ * @internal
+ */
+declare const ValidationWarningSchema: Schema.Struct<{
+  /** Warning code for categorization. */code: typeof Schema.String; /** Human-readable warning message. */
+  message: typeof Schema.String; /** File path where warning occurred. */
+  file: Schema.optional<typeof Schema.String>; /** Suggestion for addressing the warning. */
+  suggestion: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * A validation warning.
+ * @public
+ */
+type ValidationWarning = typeof ValidationWarningSchema.Type;
+/**
+ * Validation result with errors and warnings.
+ * @internal
+ */
+declare const ValidationResultSchema: Schema.Struct<{
+  /** Whether validation passed (no errors, or only warnings in non-strict mode). */valid: typeof Schema.Boolean; /** Validation errors. */
+  errors: Schema.Array$<Schema.Struct<{
+    /** Error code for categorization. */code: typeof Schema.String; /** Human-readable error message. */
+    message: typeof Schema.String; /** File path where error occurred. */
+    file: Schema.optional<typeof Schema.String>; /** Suggestion for fixing the error. */
+    suggestion: Schema.optional<typeof Schema.String>;
+  }>>; /** Validation warnings. */
+  warnings: Schema.Array$<Schema.Struct<{
+    /** Warning code for categorization. */code: typeof Schema.String; /** Human-readable warning message. */
+    message: typeof Schema.String; /** File path where warning occurred. */
+    file: Schema.optional<typeof Schema.String>; /** Suggestion for addressing the warning. */
+    suggestion: Schema.optional<typeof Schema.String>;
+  }>>;
+}>;
+/**
+ * Validation result with errors and warnings.
+ * @public
+ */
+type ValidationResult = typeof ValidationResultSchema.Type;
+/**
+ * Result of action.yml validation.
+ * @internal
+ */
+declare const ActionYmlResultSchema: Schema.Struct<{
+  /** Whether the action.yml is valid. */valid: typeof Schema.Boolean; /** Parsed action.yml content if valid. */
+  content: Schema.optional<typeof Schema.Any>; /** Validation errors. */
+  errors: Schema.Array$<Schema.Struct<{
+    /** Error code for categorization. */code: typeof Schema.String; /** Human-readable error message. */
+    message: typeof Schema.String; /** File path where error occurred. */
+    file: Schema.optional<typeof Schema.String>; /** Suggestion for fixing the error. */
+    suggestion: Schema.optional<typeof Schema.String>;
+  }>>; /** Validation warnings. */
+  warnings: Schema.Array$<Schema.Struct<{
+    /** Warning code for categorization. */code: typeof Schema.String; /** Human-readable warning message. */
+    message: typeof Schema.String; /** File path where warning occurred. */
+    file: Schema.optional<typeof Schema.String>; /** Suggestion for addressing the warning. */
+    suggestion: Schema.optional<typeof Schema.String>;
+  }>>;
+}>;
+/**
+ * Result of action.yml validation.
+ * @public
+ */
+type ActionYmlResult = typeof ActionYmlResultSchema.Type;
+/**
+ * ValidationService interface for validation capabilities.
+ *
+ * @remarks
+ * This service handles:
+ * - Validating configuration and entry points
+ * - Validating action.yml structure and schema
+ * - Formatting validation results for display
+ * - CI-aware strict mode handling
+ *
+ * @example Using ValidationService with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, ConfigService, ValidationService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const validationService = yield* ValidationService;
+ *
+ *   const { config } = yield* configService.load();
+ *   const result = yield* validationService.validate(config);
+ *
+ *   if (!result.valid) {
+ *     console.error("Validation failed:", result.errors);
+ *   }
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
+ *
+ * @public
+ */
+interface ValidationService {
+  /**
+   * Validate configuration and project structure.
+   *
+   * @param config - Configuration to validate
+   * @param options - Validation options
+   * @returns Effect that resolves to validation result
+   */
+  readonly validate: (config: Config, options?: ValidateOptions) => Effect.Effect<ValidationResult, ValidationError>;
+  /**
+   * Validate action.yml file.
+   *
+   * @param path - Path to action.yml file
+   * @returns Effect that resolves to action.yml validation result
+   */
+  readonly validateActionYml: (path: string) => Effect.Effect<ActionYmlResult, ValidationError>;
+  /**
+   * Format validation result for display.
+   *
+   * @param result - Validation result to format
+   * @returns Formatted string for terminal output
+   */
+  readonly formatResult: (result: ValidationResult) => string;
+  /**
+   * Check if running in CI environment.
+   *
+   * @returns Effect that resolves to true if in CI
+   */
+  readonly isCI: () => Effect.Effect<boolean>;
+  /**
+   * Check if strict mode is enabled.
+   *
+   * @param configStrict - Optional config override
+   * @returns Effect that resolves to true if strict mode
+   */
+  readonly isStrict: (configStrict?: boolean) => Effect.Effect<boolean>;
+}
+/**
+ * ValidationService tag for dependency injection.
+ *
+ * @public
+ */
+declare const ValidationService: Context.Tag<ValidationService, ValidationService>;
+//#endregion
+//#region src/github-action.d.ts
+/**
+ * Options for creating a GitHubAction builder instance.
+ *
+ * @remarks
+ * All options are optional. When no options are provided, the builder
+ * auto-detects configuration from `action.config.ts` in the current directory.
+ *
+ * @public
+ */
+interface GitHubActionOptions {
+  /**
+   * Configuration object or path to config file.
+   *
+   * @remarks
+   * - If a string is provided, it's treated as a path to a config file
+   * - If an object is provided, it's used directly as configuration
+   * - If not provided, auto-detects `action.config.ts` or uses defaults
+   */
+  config?: Partial<ConfigInput> | string;
+  /**
+   * Working directory for the build.
+   *
+   * @defaultValue `process.cwd()`
+   */
+  cwd?: string;
+  /**
+   * Skip validation before building.
+   *
+   * @remarks
+   * Skipping validation is not recommended for production builds.
+   *
+   * @defaultValue `false`
+   */
+  skipValidation?: boolean;
+  /**
+   * Clean output directory before building.
+   *
+   * @defaultValue `true`
+   */
+  clean?: boolean;
+  /**
+   * Custom Effect Layer to use instead of the default AppLayer.
+   *
+   * @remarks
+   * Advanced option for testing or customizing service implementations.
+   */
+  layer?: Layer.Layer<ConfigService | ValidationService | BuildService | PersistLocalService>;
+}
+/**
+ * Result of a GitHubAction build operation.
+ *
+ * @remarks
+ * The result contains detailed information about both validation and build steps.
+ * Check the `success` property first, then examine `error`, `validation`, or `build`
+ * for details.
+ *
+ * @internal
+ */
+declare const GitHubActionBuildResultSchema: Schema.Struct<{
+  /** Whether the build completed successfully. */success: typeof Schema.Boolean; /** Build result details if the build step ran. */
+  build: Schema.optional<Schema.Struct<{
+    success: typeof Schema.Boolean;
+    entries: Schema.Array$<Schema.Struct<{
+      success: typeof Schema.Boolean;
+      stats: Schema.optional<Schema.Struct<{
+        entry: typeof Schema.String;
+        size: typeof Schema.Number;
+        duration: typeof Schema.Number;
+        outputPath: typeof Schema.String;
+      }>>;
+      error: Schema.optional<typeof Schema.String>;
+    }>>;
+    duration: typeof Schema.Number;
+    error: Schema.optional<typeof Schema.String>;
+  }>>; /** Validation result if validation was performed. */
+  validation: Schema.optional<Schema.Struct<{
+    valid: typeof Schema.Boolean;
+    errors: Schema.Array$<Schema.Struct<{
+      code: typeof Schema.String;
+      message: typeof Schema.String;
+      file: Schema.optional<typeof Schema.String>;
+      suggestion: Schema.optional<typeof Schema.String>;
+    }>>;
+    warnings: Schema.Array$<Schema.Struct<{
+      code: typeof Schema.String;
+      message: typeof Schema.String;
+      file: Schema.optional<typeof Schema.String>;
+      suggestion: Schema.optional<typeof Schema.String>;
+    }>>;
+  }>>; /** Persist-local result if persist was performed. */
+  persistLocal: Schema.optional<Schema.Struct<{
+    success: typeof Schema.Boolean;
+    filesCopied: typeof Schema.Number;
+    filesSkipped: typeof Schema.Number;
+    actTemplateGenerated: typeof Schema.Boolean;
+    outputPath: typeof Schema.String;
+    error: Schema.optional<typeof Schema.String>;
+  }>>; /** Error message if the build or validation failed. */
+  error: Schema.optional<typeof Schema.String>; /** Raw error object for programmatic inspection. */
+  cause: Schema.optional<typeof Schema.Unknown>;
+}>;
+/**
+ * Result of a GitHubAction build operation.
+ * @public
+ */
+type GitHubActionBuildResult = typeof GitHubActionBuildResultSchema.Type;
+/**
+ * Main API class for building GitHub Actions.
+ *
+ * @remarks
+ * This class provides a Promise-based interface wrapping Effect services.
+ * It handles configuration loading, validation, and bundling in a single workflow.
+ *
+ * For Effect consumers, use the services directly:
+ * - {@link ConfigService} for configuration
+ * - {@link ValidationService} for validation
+ * - {@link BuildService} for building
+ *
+ * @example Complete build workflow
+ * ```typescript
+ * import { GitHubAction } from "@savvy-web/github-action-builder";
+ *
+ * async function buildAction(): Promise<void> {
+ *   const action = GitHubAction.create();
+ *   const result = await action.build();
+ *
+ *   if (result.success) {
+ *     console.log(`Built ${result.build?.entries.length} entry points`);
+ *   } else {
+ *     console.error(`Build failed: ${result.error}`);
+ *     process.exit(1);
+ *   }
+ * }
+ *
+ * buildAction();
+ * ```
+ *
+ * @example With custom configuration
+ * ```typescript
+ * import { GitHubAction } from "@savvy-web/github-action-builder";
+ *
+ * async function main(): Promise<void> {
+ *   const action = GitHubAction.create({
+ *     config: {
+ *       entries: { main: "src/action.ts" },
+ *       build: { minify: true },
+ *     },
+ *     cwd: "/path/to/project",
+ *   });
+ *
+ *   const result = await action.build();
+ *   console.log(result.success ? "Success" : result.error);
+ * }
+ *
+ * main();
+ * ```
+ *
+ * @public
+ */
+declare class GitHubAction {
+  /**
+   * Managed runtime for running Effects.
+   * @internal
+   */
+  private readonly runtime;
+  /**
+   * Cached configuration after first load.
+   * @internal
+   */
+  private config;
+  /**
+   * Resolved options.
+   * @internal
+   */
+  private readonly cwd;
+  private readonly configSource;
+  private readonly skipValidation;
+  private readonly clean;
+  private constructor();
+  /**
+   * Create a new GitHubAction builder instance.
+   *
+   * @param options - Builder options
+   * @returns A new GitHubAction instance
+   *
+   * @example
+   * ```typescript
+   * import { GitHubAction } from "@savvy-web/github-action-builder";
+   *
+   * // Auto-detect configuration
+   * const action = GitHubAction.create();
+   *
+   * // With inline config
+   * const action2 = GitHubAction.create({
+   *   config: { build: { minify: false } },
+   * });
+   *
+   * // With config file path
+   * const action3 = GitHubAction.create({
+   *   config: "./custom.config.ts",
+   * });
+   * ```
+   */
+  static create(options?: GitHubActionOptions): GitHubAction;
+  /**
+   * Load and resolve configuration.
+   *
+   * @remarks
+   * Configuration is cached after the first load. Subsequent calls
+   * return the cached configuration.
+   *
+   * @returns Resolved configuration with all defaults applied
+   * @throws Error if configuration file cannot be loaded or is invalid
+   */
+  loadConfig(): Promise<Config>;
+  /**
+   * Validate the action configuration and action.yml.
+   *
+   * @remarks
+   * Validation checks:
+   * - Entry point files exist
+   * - Output directory is writable
+   * - action.yml exists and is valid (if required)
+   *
+   * In CI environments, warnings are treated as errors by default.
+   *
+   * @param options - Validation options
+   * @returns Validation result with errors and warnings
+   */
+  validate(options?: ValidateOptions): Promise<ValidationResult>;
+  /**
+   * Build the GitHub Action.
+   *
+   * @remarks
+   * The build process:
+   * 1. Loads configuration (if not already loaded)
+   * 2. Validates the project (unless `skipValidation` is set)
+   * 3. Bundles each entry point with rsbuild
+   * 4. Writes output to the `dist/` directory
+   *
+   * @returns Build result with success status and details
+   *
+   * @example
+   * ```typescript
+   * import { GitHubAction } from "@savvy-web/github-action-builder";
+   *
+   * async function main(): Promise<void> {
+   *   const action = GitHubAction.create();
+   *   const result = await action.build();
+   *
+   *   if (result.success && result.build) {
+   *     console.log(`Built ${result.build.entries.length} entries`);
+   *   } else {
+   *     console.error(result.error);
+   *   }
+   * }
+   *
+   * main();
+   * ```
+   */
+  build(): Promise<GitHubActionBuildResult>;
+  /**
+   * Dispose the runtime and release resources.
+   *
+   * @remarks
+   * Call this when you're done using the GitHubAction instance
+   * to clean up any resources held by the Effect runtime.
+   */
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region src/layers/app.d.ts
+/**
+ * Layer providing ConfigService (no dependencies).
+ *
+ * @remarks
+ * Use this layer when you only need configuration management.
+ *
+ * @public
+ */
+declare const ConfigLayer: Layer.Layer<ConfigService, never, never>;
+/**
+ * Layer providing ValidationService (depends on ConfigService).
+ *
+ * @remarks
+ * Includes ConfigService automatically.
+ *
+ * @public
+ */
+declare const ValidationLayer: Layer.Layer<ValidationService, never, never>;
+/**
+ * Layer providing BuildService (depends on ConfigService).
+ *
+ * @remarks
+ * Includes ConfigService automatically.
+ *
+ * @public
+ */
+declare const BuildLayer: Layer.Layer<BuildService, never, never>;
+/**
+ * Layer providing PersistLocalService (no dependencies).
+ *
+ * @remarks
+ * Use this layer when you only need persist-local functionality.
+ *
+ * @public
+ */
+declare const PersistLocalLayer: Layer.Layer<PersistLocalService, never, never>;
+/**
+ * Combined layer providing all services.
+ *
+ * @remarks
+ * This layer composes ConfigService, ValidationService, BuildService,
+ * and PersistLocalService.
+ * Use this when you need access to all services in your Effect program.
+ *
+ * @example Using AppLayer with Effect
+ * ```typescript
+ * import { Effect } from "effect";
+ * import { AppLayer, BuildService, ConfigService } from "@savvy-web/github-action-builder";
+ *
+ * const program = Effect.gen(function* () {
+ *   const configService = yield* ConfigService;
+ *   const buildService = yield* BuildService;
+ *
+ *   const { config } = yield* configService.load();
+ *   const result = yield* buildService.build(config);
+ *
+ *   return result;
+ * });
+ *
+ * Effect.runPromise(program.pipe(Effect.provide(AppLayer)));
+ * ```
+ *
+ * @public
+ */
+declare const AppLayer: Layer.Layer<BuildService | ConfigService | ValidationService | PersistLocalService, never, never>;
+//#endregion
+export { ActionYmlMissing, ActionYmlMissingBase, ActionYmlPathError, ActionYmlPathErrorBase, type ActionYmlResult, ActionYmlResultSchema, ActionYmlSchemaError, ActionYmlSchemaErrorBase, ActionYmlSyntaxError, ActionYmlSyntaxErrorBase, type AppError, AppLayer, type BuildError, BuildFailed, BuildFailedBase, BuildLayer, type BuildOptions, BuildOptionsSchema, type BuildResult, BuildResultSchema, type BuildRunnerOptions, BuildRunnerOptionsSchema, BuildService, BundleFailed, BundleFailedBase, type BundleResult, BundleResultSchema, type BundleStats, BundleStatsSchema, CleanError, CleanErrorBase, type Config, type ConfigError, type ConfigInput, ConfigInputSchema, ConfigInvalid, ConfigInvalidBase, ConfigLayer, ConfigLoadFailed, ConfigLoadFailedBase, ConfigNotFound, ConfigNotFoundBase, ConfigSchema, ConfigService, type DetectEntriesResult, DetectEntriesResultSchema, type DetectedEntry, DetectedEntrySchema, type Entries, EntriesSchema, EntryFileMissing, EntryFileMissingBase, GitHubAction, type GitHubActionBuildResult, GitHubActionBuildResultSchema, type GitHubActionOptions, type LoadConfigOptions, LoadConfigOptionsSchema, type LoadConfigResult, MainEntryMissing, MainEntryMissingBase, type PersistError, PersistLocalError, PersistLocalErrorBase, PersistLocalLayer, type PersistLocalOptions, PersistLocalOptionsSchema, type PersistLocalResult, PersistLocalResultSchema, type PersistLocalRunnerOptions, PersistLocalRunnerOptionsSchema, PersistLocalService, type ValidateOptions, ValidateOptionsSchema, type ValidationError, type ValidationErrorItem, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, type ValidationOptions, ValidationOptionsSchema, type ValidationResult, ValidationResultSchema, ValidationService, type ValidationWarning, ValidationWarningSchema, WriteError, WriteErrorBase, defineConfig };
+//# sourceMappingURL=index.d.ts.map