@autometa/config 0.1.26 → 1.0.0-rc.0

package/README.md

@@ -1,3 +1,35 @@
-# Introduction
+# @autometa/config
 
-There's nothing here yet
+Environment-aware configuration utilities for Autometa executors. This package
+exposes a schema-backed `defineConfig` helper that resolves the active
+environment, merges overrides, and provides an immutable configuration object
+to downstream runners.
+
+## Quick start
+
+```ts
+import { defineConfig } from "@autometa/config";
+
+export const config = defineConfig({
+	default: {
+		runner: "vitest",
+		roots: {
+			features: ["features"],
+			steps: ["steps"],
+		},
+	},
+	environments: {
+		ci: {
+			test: {
+				timeout: { value: 30, unit: "s" },
+			},
+		},
+	},
+	environment: (env) => env.byEnvironmentVariable("AUTOMETA_ENV"),
+});
+
+const { config: resolved } = config.resolve();
+```
+
+See `src/config.ts` and the unit tests under `src/__tests__` for more usage
+examples.

package/dist/builder-types.d.ts

@@ -0,0 +1,27 @@
+export type ModuleFormat = "cjs" | "esm";
+export type SourceMapSetting = boolean | "inline" | "external";
+export interface BuildHookContext {
+    readonly cwd: string;
+    readonly cacheDir: string;
+    readonly outDir: string;
+    readonly entries: readonly string[];
+    readonly format: ModuleFormat;
+    readonly target?: string | string[];
+    readonly sourcemap?: SourceMapSetting;
+    readonly tsconfig?: string;
+    readonly external?: string[];
+}
+export type BuildHook = (context: BuildHookContext) => void | Promise<void>;
+export interface BuilderHooks {
+    before?: BuildHook[] | undefined;
+    after?: BuildHook[] | undefined;
+}
+export interface BuilderConfig {
+    format?: ModuleFormat | undefined;
+    target?: string | string[] | undefined;
+    sourcemap?: SourceMapSetting | undefined;
+    tsconfig?: string | undefined;
+    external?: string[] | undefined;
+    outDir?: string | undefined;
+    hooks?: BuilderHooks | undefined;
+}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import { ConfigDefinition, ConfigDefinitionInput, ExecutorConfig, ResolveOptions, ResolvedConfig } from "./types";
+export declare class Config {
+    private readonly definition;
+    constructor(definition: ConfigDefinition);
+    resolve(options?: ResolveOptions): ResolvedConfig;
+    current(options?: ResolveOptions): ExecutorConfig;
+    get environment(): string;
+    forEnvironment(environment: string): ExecutorConfig;
+    private resolveEnvironment;
+    private assertEnvironment;
+}
+export declare const defineConfig: (input: ConfigDefinitionInput) => Config;

package/dist/environment-selector.d.ts

@@ -0,0 +1,10 @@
+export type EnvironmentFactory = () => string | undefined;
+export declare class EnvironmentSelector {
+    private readonly detectors;
+    private fallback;
+    byLiteral(name: string): this;
+    byEnvironmentVariable(variable: string): this;
+    byFactory(factory: EnvironmentFactory): this;
+    defaultTo(name: string): this;
+    resolve(): string;
+}