@savvy-web/github-action-builder 1.1.1 → 2.0.0

package/index.d.ts

@@ -1,5 +1,4 @@
 import { Context, Effect, Layer, Schema } from "effect";
-
 //#region src/schemas/config.d.ts
 /**
  * Schema for entry point paths.
@@ -10,18 +9,20 @@ import { Context, Effect, Layer, Schema } from "effect";
  * - `pre`: Runs before the main action (optional)
  * - `post`: Runs after the main action for cleanup (optional)
  *
- * Additional non-lifecycle bundles can be declared via `workers` (name → source path),
- * each emitted as `dist/<name>.js`.
+ * Additional non-lifecycle bundles can be declared via `workers` (name -\> source path),
+ * each emitted as `dist/\{name\}.js`.
  *
  * @public
  */
 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>; /** Extra non-lifecycle worker bundles (name -> source path), each emitted as dist/<name>.js. */
-  workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+  /** Path to the main action entry point. Defaults to "src/main.ts". */
+  readonly main: Schema.withDecodingDefaultType<Schema.String, never>;
+  /** Path to the pre-action hook entry point. */
+  readonly pre: Schema.optional<Schema.String>;
+  /** Path to the post-action hook entry point. */
+  readonly post: Schema.optional<Schema.String>;
+  /** Extra non-lifecycle worker bundles (name -\> source path), each emitted as dist/\{name\}.js. */
+  readonly workers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
 }>;
 /**
  * Entry point paths configuration.
@@ -39,18 +40,14 @@ type Entries = typeof EntriesSchema.Type;
  * @public
  */
 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[];
-  }>;
+  /** Enable minification to reduce bundle size. Defaults to true. */
+  readonly minify: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+  /** Generate source maps for debugging. Defaults to false. */
+  readonly sourceMap: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+  /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
+  readonly externals: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, 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 []. */
+  readonly ignore: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
   /**
    * Packages whose dynamic `import(...)` calls must stay native `import()` at runtime instead of
    * being compiled into an rspack context module. Use this for packages that resolve a module path
@@ -60,9 +57,7 @@ declare const BuildOptionsSchema: Schema.Struct<{
    * the package here injects a `webpackIgnore` comment into its dynamic imports so rspack leaves
    * them alone. Defaults to [].
    */
-  nativeDynamicImports: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-    default: () => never[];
-  }>;
+  readonly nativeDynamicImports: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
 }>;
 /**
  * Build options for the bundler.
@@ -80,11 +75,12 @@ type BuildOptions = typeof BuildOptionsSchema.Type;
  * @public
  */
 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>;
+  /** Require action.yml to exist and be valid. Defaults to true. */
+  readonly requireActionYml: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+  /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
+  readonly maxBundleSize: Schema.optional<Schema.String>;
+  /** Treat warnings as errors. Auto-detects from CI when undefined. */
+  readonly strict: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Validation options for the build process.
@@ -102,15 +98,12 @@ type ValidationOptions = typeof ValidationOptionsSchema.Type;
  * @public
  */
 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;
-  }>;
+  /** Enable persisting build output locally. Defaults to true. */
+  readonly enabled: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+  /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
+  readonly path: Schema.withDecodingDefaultType<Schema.String, never>;
+  /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
+  readonly actTemplate: Schema.withDecodingDefaultType<Schema.Boolean, never>;
 }>;
 /**
  * Persist-local options for copying build output.
@@ -128,28 +121,28 @@ type PersistLocalOptions = typeof PersistLocalOptionsSchema.Type;
  * @public
  */
 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>;
-    workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+  readonly entries: Schema.optional<Schema.Struct<{
+    readonly main: Schema.optional<Schema.String>;
+    readonly pre: Schema.optional<Schema.String>;
+    readonly post: Schema.optional<Schema.String>;
+    readonly workers: Schema.optional<Schema.$Record<Schema.String, 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>>;
-    nativeDynamicImports: Schema.optional<Schema.Array$<typeof Schema.String>>;
+  readonly build: Schema.optional<Schema.Struct<{
+    readonly minify: Schema.optional<Schema.Boolean>;
+    readonly sourceMap: Schema.optional<Schema.Boolean>;
+    readonly externals: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly ignore: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly nativeDynamicImports: Schema.optional<Schema.$Array<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>;
+  readonly validation: Schema.optional<Schema.Struct<{
+    readonly requireActionYml: Schema.optional<Schema.Boolean>;
+    readonly maxBundleSize: Schema.optional<Schema.String>;
+    readonly strict: Schema.optional<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>;
+  readonly persistLocal: Schema.optional<Schema.Struct<{
+    readonly enabled: Schema.optional<Schema.Boolean>;
+    readonly path: Schema.optional<Schema.String>;
+    readonly actTemplate: Schema.optional<Schema.Boolean>;
   }>>;
 }>;
 /**
@@ -168,27 +161,25 @@ type ConfigInput = typeof ConfigInputSchema.Type;
  * @public
  */
 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>; /** Extra non-lifecycle worker bundles (name -> source path), each emitted as dist/<name>.js. */
-    workers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+  readonly entries: Schema.Struct<{
+    /** Path to the main action entry point. Defaults to "src/main.ts". */
+    readonly main: Schema.withDecodingDefaultType<Schema.String, never>;
+    /** Path to the pre-action hook entry point. */
+    readonly pre: Schema.optional<Schema.String>;
+    /** Path to the post-action hook entry point. */
+    readonly post: Schema.optional<Schema.String>;
+    /** Extra non-lifecycle worker bundles (name -\> source path), each emitted as dist/\{name\}.js. */
+    readonly workers: Schema.optional<Schema.$Record<Schema.String, 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[];
-    }>;
+  readonly build: Schema.Struct<{
+    /** Enable minification to reduce bundle size. Defaults to true. */
+    readonly minify: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+    /** Generate source maps for debugging. Defaults to false. */
+    readonly sourceMap: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+    /** Packages to exclude from the bundle (in addition to node: builtins). Defaults to []. */
+    readonly externals: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, 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 []. */
+    readonly ignore: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, never>;
     /**
      * Packages whose dynamic `import(...)` calls must stay native `import()` at runtime instead of
      * being compiled into an rspack context module. Use this for packages that resolve a module path
@@ -198,27 +189,23 @@ declare const ConfigSchema: Schema.Struct<{
      * the package here injects a `webpackIgnore` comment into its dynamic imports so rspack leaves
      * them alone. Defaults to [].
      */
-    nativeDynamicImports: Schema.optionalWith<Schema.Array$<typeof Schema.String>, {
-      default: () => never[];
-    }>;
+    readonly nativeDynamicImports: Schema.withDecodingDefaultType<Schema.$Array<Schema.String>, 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>;
+  readonly validation: Schema.Struct<{
+    /** Require action.yml to exist and be valid. Defaults to true. */
+    readonly requireActionYml: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+    /** Maximum bundle size before warning/error (e.g., "5mb", "500kb"). */
+    readonly maxBundleSize: Schema.optional<Schema.String>;
+    /** Treat warnings as errors. Auto-detects from CI when undefined. */
+    readonly strict: Schema.optional<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;
-    }>;
+  readonly persistLocal: Schema.Struct<{
+    /** Enable persisting build output locally. Defaults to true. */
+    readonly enabled: Schema.withDecodingDefaultType<Schema.Boolean, never>;
+    /** Path for the local action directory, relative to cwd. Defaults to ".github/actions/local". */
+    readonly path: Schema.withDecodingDefaultType<Schema.String, never>;
+    /** Generate act boilerplate files (.actrc, act-test.yml) if they don't exist. Defaults to true. */
+    readonly actTemplate: Schema.withDecodingDefaultType<Schema.Boolean, never>;
   }>;
 }>;
 /**
@@ -297,7 +284,7 @@ declare function defineConfig(config?: Partial<ConfigInput>): Config;
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -325,7 +312,7 @@ declare class ConfigNotFound extends ConfigNotFoundBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -353,7 +340,7 @@ declare class ConfigInvalid extends ConfigInvalidBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -387,7 +374,7 @@ type ConfigError = ConfigNotFound | ConfigInvalid | ConfigLoadFailed;
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -415,7 +402,7 @@ declare class MainEntryMissing extends MainEntryMissingBase<{
  *
  * @public
  */
-declare const WorkerEntryMissingBase: 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 & {
+declare const WorkerEntryMissingBase: 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: "WorkerEntryMissing";
 } & Readonly<A>;
 /**
@@ -424,8 +411,11 @@ declare const WorkerEntryMissingBase: new <A extends Record<string, any> = {}>(a
  * @public
  */
 declare class WorkerEntryMissing extends WorkerEntryMissingBase<{
-  /** The worker name (config key). */readonly workerName: string; /** The expected path for the worker entry. */
-  readonly expectedPath: string; /** The working directory that was searched. */
+  /** The worker name (config key). */
+  readonly workerName: string;
+  /** The expected path for the worker entry. */
+  readonly expectedPath: string;
+  /** The working directory that was searched. */
   readonly cwd: string;
 }> {}
 /**
@@ -438,7 +428,7 @@ declare class WorkerEntryMissing extends WorkerEntryMissingBase<{
  *
  * @public
  */
-declare const WorkerEntryInvalidNameBase: 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 & {
+declare const WorkerEntryInvalidNameBase: 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: "WorkerEntryInvalidName";
 } & Readonly<A>;
 /**
@@ -452,7 +442,9 @@ declare const WorkerEntryInvalidNameBase: new <A extends Record<string, any> = {
  * @public
  */
 declare class WorkerEntryInvalidName extends WorkerEntryInvalidNameBase<{
-  /** The offending worker name (config key). */readonly workerName: string; /** Why the name was rejected. */
+  /** The offending worker name (config key). */
+  readonly workerName: string;
+  /** Why the name was rejected. */
   readonly reason: string;
 }> {}
 /**
@@ -465,7 +457,7 @@ declare class WorkerEntryInvalidName extends WorkerEntryInvalidNameBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -493,7 +485,7 @@ declare class EntryFileMissing extends EntryFileMissingBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -517,7 +509,7 @@ declare class ActionYmlMissing extends ActionYmlMissingBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -553,7 +545,7 @@ declare class ActionYmlSyntaxError extends ActionYmlSyntaxErrorBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -584,7 +576,7 @@ declare class ActionYmlSchemaError extends ActionYmlSchemaErrorBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -622,7 +614,7 @@ type ValidationError = MainEntryMissing | WorkerEntryMissing | WorkerEntryInvali
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -650,7 +642,7 @@ declare class BundleFailed extends BundleFailedBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -678,7 +670,7 @@ declare class WriteError extends WriteErrorBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -706,7 +698,7 @@ declare class CleanError extends CleanErrorBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -740,7 +732,7 @@ type BuildError = BundleFailed | WriteError | CleanError | BuildFailed;
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -768,7 +760,7 @@ declare class PersistLocalError extends PersistLocalErrorBase<{
  *
  * @public
  */
-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 & {
+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>;
 /**
@@ -809,8 +801,10 @@ type AppError = ConfigError | ValidationError | BuildError | PersistError;
  * @public
  */
 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>>;
+  /** Working directory to search for config. Accepts string, Buffer, or URL. */
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
+  /** Explicit path to config file. Accepts string, Buffer, or URL. */
+  readonly configPath: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
 }>;
 /**
  * Options for loading configuration.
@@ -822,9 +816,12 @@ type LoadConfigOptions = typeof LoadConfigOptionsSchema.Type;
  * @public
  */
 declare const DetectedEntrySchema: Schema.Struct<{
-  /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */type: typeof Schema.String; /** Absolute path to the entry file. */
-  path: typeof Schema.String; /** Output path for the bundled file. */
-  output: typeof Schema.String;
+  /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */
+  readonly type: Schema.String;
+  /** Absolute path to the entry file. */
+  readonly path: Schema.String;
+  /** Output path for the bundled file. */
+  readonly output: Schema.String;
 }>;
 /**
  * Detected entry point information.
@@ -836,11 +833,16 @@ type DetectedEntry = typeof DetectedEntrySchema.Type;
  * @public
  */
 declare const DetectEntriesResultSchema: Schema.Struct<{
-  /** Whether detection was successful. */success: typeof Schema.Boolean; /** Detected entries. */
-  entries: Schema.Array$<Schema.Struct<{
-    /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */type: typeof Schema.String; /** Absolute path to the entry file. */
-    path: typeof Schema.String; /** Output path for the bundled file. */
-    output: typeof Schema.String;
+  /** Whether detection was successful. */
+  readonly success: Schema.Boolean;
+  /** Detected entries. */
+  readonly entries: Schema.$Array<Schema.Struct<{
+    /** Entry type: "main"|"pre"|"post" for lifecycle entries, or the worker name. */
+    readonly type: Schema.String;
+    /** Absolute path to the entry file. */
+    readonly path: Schema.String;
+    /** Output path for the bundled file. */
+    readonly output: Schema.String;
   }>>;
 }>;
 /**
@@ -861,7 +863,7 @@ interface LoadConfigResult {
   usingDefaults: boolean;
 }
 /**
- * ConfigService interface for configuration management capabilities.
+ * Service shape for configuration management capabilities.
  *
  * @remarks
  * This service handles:
@@ -869,23 +871,12 @@ interface LoadConfigResult {
  * - 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)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link ConfigService} class as the service key.
  *
  * @public
  */
-interface ConfigService {
+interface ConfigServiceShape {
   /**
    * Load configuration from file or use defaults.
    *
@@ -914,12 +905,27 @@ interface ConfigService {
     workers?: Record<string, string>;
   }) => Effect.Effect<DetectEntriesResult, MainEntryMissing | WorkerEntryMissing | WorkerEntryInvalidName>;
 }
+declare const ConfigService_base: Context.ServiceClass<ConfigService, "ConfigService", ConfigServiceShape>;
 /**
- * ConfigService tag for dependency injection.
+ * ConfigService key for dependency injection.
+ *
+ * @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
  */
-declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
+declare class ConfigService extends ConfigService_base {}
 //#endregion
 //#region src/services/build.d.ts
 /**
@@ -927,8 +933,10 @@ declare const ConfigService: Context.Tag<ConfigService, ConfigService>;
  * @public
  */
 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>;
+  /** Working directory for the build. Accepts string, Buffer, or URL. */
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
+  /** Clean output directory before building. Defaults to true. */
+  readonly clean: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Options for the build process.
@@ -940,10 +948,14 @@ type BuildRunnerOptions = typeof BuildRunnerOptionsSchema.Type;
  * @public
  */
 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;
+  /** Entry type (main, pre, or post). */
+  readonly entry: Schema.String;
+  /** Bundle size in bytes. */
+  readonly size: Schema.Number;
+  /** Build duration in milliseconds. */
+  readonly duration: Schema.Number;
+  /** Output path relative to working directory. */
+  readonly outputPath: Schema.String;
 }>;
 /**
  * Statistics for a single bundled entry.
@@ -955,14 +967,21 @@ type BundleStats = typeof BundleStatsSchema.Type;
  * @public
  */
 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>;
+  /** Whether bundling succeeded. */
+  readonly success: Schema.Boolean;
+  /** Bundle statistics if successful. */
+  readonly stats: Schema.optional<Schema.Struct<{
+    /** Entry type (main, pre, or post). */
+    readonly entry: Schema.String;
+    /** Bundle size in bytes. */
+    readonly size: Schema.Number;
+    /** Build duration in milliseconds. */
+    readonly duration: Schema.Number;
+    /** Output path relative to working directory. */
+    readonly outputPath: Schema.String;
+  }>>;
+  /** Error message if failed. */
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of bundling a single entry.
@@ -974,19 +993,30 @@ type BundleResult = typeof BundleResultSchema.Type;
  * @public
  */
 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>;
+  /** Whether the overall build succeeded. */
+  readonly success: Schema.Boolean;
+  /** Results for each entry that was built. */
+  readonly entries: Schema.$Array<Schema.Struct<{
+    /** Whether bundling succeeded. */
+    readonly success: Schema.Boolean;
+    /** Bundle statistics if successful. */
+    readonly stats: Schema.optional<Schema.Struct<{
+      /** Entry type (main, pre, or post). */
+      readonly entry: Schema.String;
+      /** Bundle size in bytes. */
+      readonly size: Schema.Number;
+      /** Build duration in milliseconds. */
+      readonly duration: Schema.Number;
+      /** Output path relative to working directory. */
+      readonly outputPath: Schema.String;
+    }>>;
+    /** Error message if failed. */
+    readonly error: Schema.optional<Schema.String>;
+  }>>;
+  /** Total build duration in milliseconds. */
+  readonly duration: Schema.Number;
+  /** Error message if build failed. */
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of the complete build process.
@@ -994,7 +1024,7 @@ declare const BuildResultSchema: Schema.Struct<{
  */
 type BuildResult = typeof BuildResultSchema.Type;
 /**
- * BuildService interface for build and bundling capabilities.
+ * Service shape for build and bundling capabilities.
  *
  * @remarks
  * This service handles:
@@ -1003,29 +1033,12 @@ type BuildResult = typeof BuildResultSchema.Type;
  * - 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)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link BuildService} class as the service key.
  *
  * @public
  */
-interface BuildService {
+interface BuildServiceShape {
   /**
    * Build all entries from the configuration.
    *
@@ -1064,12 +1077,33 @@ interface BuildService {
    */
   readonly formatBytes: (bytes: number) => string;
 }
+declare const BuildService_base: Context.ServiceClass<BuildService, "BuildService", BuildServiceShape>;
 /**
- * BuildService tag for dependency injection.
+ * BuildService key for dependency injection.
+ *
+ * @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
  */
-declare const BuildService: Context.Tag<BuildService, BuildService>;
+declare class BuildService extends BuildService_base {}
 //#endregion
 //#region src/services/persist-local.d.ts
 /**
@@ -1077,7 +1111,8 @@ declare const BuildService: Context.Tag<BuildService, BuildService>;
  * @public
  */
 declare const PersistLocalRunnerOptionsSchema: Schema.Struct<{
-  /** Working directory. Accepts string. */cwd: Schema.optional<typeof Schema.String>;
+  /** Working directory. Accepts string. */
+  readonly cwd: Schema.optional<Schema.String>;
 }>;
 /**
  * Options for the persist operation.
@@ -1089,12 +1124,18 @@ type PersistLocalRunnerOptions = typeof PersistLocalRunnerOptionsSchema.Type;
  * @public
  */
 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>;
+  /** Whether the operation completed successfully. */
+  readonly success: Schema.Boolean;
+  /** Number of files copied (changed or new). */
+  readonly filesCopied: Schema.Number;
+  /** Number of files skipped (unchanged). */
+  readonly filesSkipped: Schema.Number;
+  /** Whether act template files were generated. */
+  readonly actTemplateGenerated: Schema.Boolean;
+  /** Output path where files were persisted. */
+  readonly outputPath: Schema.String;
+  /** Error message if failed. */
+  readonly error: Schema.optional<Schema.String>;
 }>;
 /**
  * Result of the persist-local operation.
@@ -1102,7 +1143,7 @@ declare const PersistLocalResultSchema: Schema.Struct<{
  */
 type PersistLocalResult = typeof PersistLocalResultSchema.Type;
 /**
- * PersistLocalService interface for copying build output locally.
+ * Service shape for copying build output locally.
  *
  * @remarks
  * This service handles:
@@ -1112,9 +1153,12 @@ type PersistLocalResult = typeof PersistLocalResultSchema.Type;
  * - Validating action.yml runs paths resolve in the destination
  * - Generating act boilerplate files
  *
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link PersistLocalService} class as the service key.
+ *
  * @public
  */
-interface PersistLocalService {
+interface PersistLocalServiceShape {
   /**
    * Persist build output to the local action directory.
    *
@@ -1131,12 +1175,13 @@ interface PersistLocalService {
    */
   readonly formatResult: (result: PersistLocalResult) => string;
 }
+declare const PersistLocalService_base: Context.ServiceClass<PersistLocalService, "PersistLocalService", PersistLocalServiceShape>;
 /**
- * PersistLocalService tag for dependency injection.
+ * PersistLocalService key for dependency injection.
  *
  * @public
  */
-declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocalService>;
+declare class PersistLocalService extends PersistLocalService_base {}
 //#endregion
 //#region src/services/validation.d.ts
 /**
@@ -1144,8 +1189,10 @@ declare const PersistLocalService: Context.Tag<PersistLocalService, PersistLocal
  * @public
  */
 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>;
+  /** Working directory for file operations. Accepts string, Buffer, or URL. */
+  readonly cwd: Schema.optional<Schema.decodeTo<Schema.String, Schema.Union<readonly [Schema.String, Schema.instanceOf<Buffer<ArrayBufferLike>, unknown>, Schema.instanceOf<URL, unknown>]>, never, never>>;
+  /** Force strict mode regardless of environment. Auto-detects from CI when undefined. */
+  readonly strict: Schema.optional<Schema.Boolean>;
 }>;
 /**
  * Options for validation.
@@ -1157,10 +1204,14 @@ type ValidateOptions = typeof ValidateOptionsSchema.Type;
  * @public
  */
 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 code for categorization. */
+  readonly code: Schema.String;
+  /** Human-readable error message. */
+  readonly message: Schema.String;
+  /** File path where error occurred. */
+  readonly file: Schema.optional<Schema.String>;
+  /** Suggestion for fixing the error. */
+  readonly suggestion: Schema.optional<Schema.String>;
 }>;
 /**
  * A validation error item.
@@ -1172,10 +1223,14 @@ type ValidationErrorItem = typeof ValidationErrorSchema.Type;
  * @public
  */
 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>;
+  /** Warning code for categorization. */
+  readonly code: Schema.String;
+  /** Human-readable warning message. */
+  readonly message: Schema.String;
+  /** File path where warning occurred. */
+  readonly file: Schema.optional<Schema.String>;
+  /** Suggestion for addressing the warning. */
+  readonly suggestion: Schema.optional<Schema.String>;
 }>;
 /**
  * A validation warning.
@@ -1187,18 +1242,29 @@ type ValidationWarning = typeof ValidationWarningSchema.Type;
  * @public
  */
 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>;
+  /** Whether validation passed (no errors, or only warnings in non-strict mode). */
+  readonly valid: Schema.Boolean;
+  /** Validation errors. */
+  readonly errors: Schema.$Array<Schema.Struct<{
+    /** Error code for categorization. */
+    readonly code: Schema.String;
+    /** Human-readable error message. */
+    readonly message: Schema.String;
+    /** File path where error occurred. */
+    readonly file: Schema.optional<Schema.String>;
+    /** Suggestion for fixing the error. */
+    readonly suggestion: Schema.optional<Schema.String>;
+  }>>;
+  /** Validation warnings. */
+  readonly warnings: Schema.$Array<Schema.Struct<{
+    /** Warning code for categorization. */
+    readonly code: Schema.String;
+    /** Human-readable warning message. */
+    readonly message: Schema.String;
+    /** File path where warning occurred. */
+    readonly file: Schema.optional<Schema.String>;
+    /** Suggestion for addressing the warning. */
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
 }>;
 /**
@@ -1211,19 +1277,31 @@ type ValidationResult = typeof ValidationResultSchema.Type;
  * @public
  */
 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>;
+  /** Whether the action.yml is valid. */
+  readonly valid: Schema.Boolean;
+  /** Parsed action.yml content if valid. */
+  readonly content: Schema.optional<Schema.Any>;
+  /** Validation errors. */
+  readonly errors: Schema.$Array<Schema.Struct<{
+    /** Error code for categorization. */
+    readonly code: Schema.String;
+    /** Human-readable error message. */
+    readonly message: Schema.String;
+    /** File path where error occurred. */
+    readonly file: Schema.optional<Schema.String>;
+    /** Suggestion for fixing the error. */
+    readonly suggestion: Schema.optional<Schema.String>;
+  }>>;
+  /** Validation warnings. */
+  readonly warnings: Schema.$Array<Schema.Struct<{
+    /** Warning code for categorization. */
+    readonly code: Schema.String;
+    /** Human-readable warning message. */
+    readonly message: Schema.String;
+    /** File path where warning occurred. */
+    readonly file: Schema.optional<Schema.String>;
+    /** Suggestion for addressing the warning. */
+    readonly suggestion: Schema.optional<Schema.String>;
   }>>;
 }>;
 /**
@@ -1232,7 +1310,7 @@ declare const ActionYmlResultSchema: Schema.Struct<{
  */
 type ActionYmlResult = typeof ActionYmlResultSchema.Type;
 /**
- * ValidationService interface for validation capabilities.
+ * Service shape for validation capabilities.
  *
  * @remarks
  * This service handles:
@@ -1241,29 +1319,12 @@ type ActionYmlResult = typeof ActionYmlResultSchema.Type;
  * - 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)));
- * ```
+ * Use this interface to type structural implementations (e.g. test mocks);
+ * use the {@link ValidationService} class as the service key.
  *
  * @public
  */
-interface ValidationService {
+interface ValidationServiceShape {
   /**
    * Validate configuration and project structure.
    *
@@ -1300,12 +1361,33 @@ interface ValidationService {
    */
   readonly isStrict: (configStrict?: boolean) => Effect.Effect<boolean>;
 }
+declare const ValidationService_base: Context.ServiceClass<ValidationService, "ValidationService", ValidationServiceShape>;
 /**
- * ValidationService tag for dependency injection.
+ * ValidationService key for dependency injection.
+ *
+ * @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
  */
-declare const ValidationService: Context.Tag<ValidationService, ValidationService>;
+declare class ValidationService extends ValidationService_base {}
 //#endregion
 //#region src/github-action.d.ts
 /**
@@ -1367,47 +1449,53 @@ interface GitHubActionOptions {
  * @public
  */
 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;
+  /** Whether the build completed successfully. */
+  readonly success: Schema.Boolean;
+  /** Build result details if the build step ran. */
+  readonly build: Schema.optional<Schema.Struct<{
+    readonly success: Schema.Boolean;
+    readonly entries: Schema.$Array<Schema.Struct<{
+      readonly success: Schema.Boolean;
+      readonly stats: Schema.optional<Schema.Struct<{
+        readonly entry: Schema.String;
+        readonly size: Schema.Number;
+        readonly duration: Schema.Number;
+        readonly outputPath: Schema.String;
       }>>;
-      error: Schema.optional<typeof Schema.String>;
+      readonly error: Schema.optional<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>;
+    readonly duration: Schema.Number;
+    readonly error: Schema.optional<Schema.String>;
+  }>>;
+  /** Validation result if validation was performed. */
+  readonly validation: Schema.optional<Schema.Struct<{
+    readonly valid: Schema.Boolean;
+    readonly errors: Schema.$Array<Schema.Struct<{
+      readonly code: Schema.String;
+      readonly message: Schema.String;
+      readonly file: Schema.optional<Schema.String>;
+      readonly suggestion: Schema.optional<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>;
+    readonly warnings: Schema.$Array<Schema.Struct<{
+      readonly code: Schema.String;
+      readonly message: Schema.String;
+      readonly file: Schema.optional<Schema.String>;
+      readonly suggestion: Schema.optional<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>;
+  }>>;
+  /** Persist-local result if persist was performed. */
+  readonly persistLocal: Schema.optional<Schema.Struct<{
+    readonly success: Schema.Boolean;
+    readonly filesCopied: Schema.Number;
+    readonly filesSkipped: Schema.Number;
+    readonly actTemplateGenerated: Schema.Boolean;
+    readonly outputPath: Schema.String;
+    readonly error: Schema.optional<Schema.String>;
+  }>>;
+  /** Error message if the build or validation failed. */
+  readonly error: Schema.optional<Schema.String>;
+  /** Raw error object for programmatic inspection. */
+  readonly cause: Schema.optional<Schema.Unknown>;
 }>;
 /**
  * Result of a GitHubAction build operation.
@@ -1422,9 +1510,9 @@ type GitHubActionBuildResult = typeof GitHubActionBuildResultSchema.Type;
  * It handles configuration loading, validation, and bundling in a single workflow.
  *
  * For Effect consumers, use the services directly:
- * - {@link (ConfigService:interface)} for configuration
- * - {@link (ValidationService:interface)} for validation
- * - {@link (BuildService:interface)} for building
+ * - {@link ConfigService} for configuration
+ * - {@link ValidationService} for validation
+ * - {@link BuildService} for building
  *
  * @example Complete build workflow
  * ```typescript
@@ -1646,5 +1734,5 @@ declare const PersistLocalLayer: Layer.Layer<PersistLocalService, never, never>;
  */
 declare const AppLayer: Layer.Layer<BuildService | ConfigService | PersistLocalService | ValidationService, 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, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase, defineConfig };
+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, type BuildServiceShape, 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 ConfigServiceShape, 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 PersistLocalServiceShape, type ValidateOptions, ValidateOptionsSchema, type ValidationError, type ValidationErrorItem, ValidationErrorSchema, ValidationFailed, ValidationFailedBase, ValidationLayer, type ValidationOptions, ValidationOptionsSchema, type ValidationResult, ValidationResultSchema, ValidationService, type ValidationServiceShape, type ValidationWarning, ValidationWarningSchema, WorkerEntryInvalidName, WorkerEntryInvalidNameBase, WorkerEntryMissing, WorkerEntryMissingBase, WriteError, WriteErrorBase, defineConfig };
 //# sourceMappingURL=index.d.ts.map