@codedrifters/configulator 0.0.192 → 0.0.193

package/lib/index.d.ts

@@ -1364,6 +1364,100 @@ interface TemplateResolveResult {
  */
 declare function resolveTemplateVariables(template: string, metadata: ResolvedProjectMetadata | undefined): TemplateResolveResult;
 
+/**
+ * Astro output mode.
+ *
+ * @see https://docs.astro.build/en/reference/configuration-reference/#output
+ */
+declare const AstroOutput: {
+    readonly STATIC: "static";
+    readonly SERVER: "server";
+    readonly HYBRID: "hybrid";
+};
+type AstroOutput = (typeof AstroOutput)[keyof typeof AstroOutput];
+/**
+ * Declarative spec for an Astro integration or adapter import.
+ *
+ * Rendered into `astro.config.mjs` as an import plus an invocation in
+ * the `integrations` array (or as the `adapter` field).
+ */
+interface AstroIntegrationSpec {
+    /**
+     * Local binding used in the generated config, e.g. "react".
+     */
+    readonly name: string;
+    /**
+     * Module to import from, e.g. "@astrojs/react".
+     */
+    readonly importPath: string;
+    /**
+     * Raw argument expression passed to the integration call.
+     *
+     * Written verbatim inside the parentheses, e.g. `"{ include: ['**\/*.tsx'] }"`.
+     * When omitted the integration is invoked with no arguments.
+     */
+    readonly args?: string;
+    /**
+     * When true, use a default import (`import name from ...`).
+     * When false or omitted, use a named import (`import { name } from ...`).
+     *
+     * @default true
+     */
+    readonly defaultImport?: boolean;
+}
+/**
+ * Options controlling the rendered `astro.config.mjs`.
+ */
+interface AstroConfigOptions {
+    /**
+     * Site URL (used for canonical URLs, sitemaps, RSS).
+     */
+    readonly site?: string;
+    /**
+     * Base path the site is deployed under.
+     */
+    readonly base?: string;
+    /**
+     * Output mode.
+     *
+     * @default AstroOutput.STATIC
+     */
+    readonly output?: AstroOutput;
+    /**
+     * Integrations rendered into the `integrations` array.
+     */
+    readonly integrations?: Array<AstroIntegrationSpec>;
+    /**
+     * SSR adapter rendered into the `adapter` field.
+     */
+    readonly adapter?: AstroIntegrationSpec;
+}
+
+/**
+ * Renders `astro.config.mjs` for an Astro project.
+ */
+declare class AstroConfig extends Component {
+    readonly project: NodeProject;
+    /**
+     * Find the AstroConfig component on a project.
+     */
+    static of(project: NodeProject): AstroConfig | undefined;
+    private readonly configFilePath;
+    private readonly site?;
+    private readonly base?;
+    private readonly output?;
+    private readonly integrations;
+    private readonly adapter?;
+    constructor(project: NodeProject, options?: AstroConfigOptions);
+    /**
+     * Render the config file contents as an array of lines.
+     *
+     * Exposed for unit testing — `synthesizeConfig` writes these to disk.
+     */
+    renderConfig(): Array<string>;
+    private synthesizeConfig;
+}
+
 /*******************************************************************************
  *
  * Git configs for this repo. This venn diagram has a great deal of overlap
@@ -1722,6 +1816,10 @@ interface AwsOrganization {
 declare function getLatestEligibleVersion(packageName: string, minimumReleaseAgeMinutes: number): Promise<string | null>;
 
 declare const VERSION: {
+    /**
+     * Version of Astro to pin for AstroProject scaffolding.
+     */
+    readonly ASTRO_VERSION: "5.14.1";
     /**
      * CDK CLI for workflows and command line operations.
      *
@@ -2146,6 +2244,192 @@ declare class ResetTask extends Component {
     constructor(project: Project, options?: ResetTaskOptions);
 }
 
+/**
+ * Options for the Vitest config (test block in vitest.config).
+ *
+ * @see https://vitest.dev/config/
+ */
+interface VitestConfigOptions {
+    /**
+     * Glob patterns for test files.
+     *
+     * @default ["**\/*.{test,spec}.?(c|m)[jt]s?(x)"]
+     */
+    readonly include?: string[];
+    /**
+     * Glob patterns to exclude from test files.
+     *
+     * @default ["**\/node_modules\/**", "**\/dist\/**", "**\/lib\/**", "**\/.?\*"]
+     */
+    readonly exclude?: string[];
+    /**
+     * Test environment.
+     *
+     * @default "node"
+     */
+    readonly environment?: "node" | "jsdom" | "happy-dom" | "edge-runtime";
+    /**
+     * Do not fail when no tests are found.
+     *
+     * @default true
+     */
+    readonly passWithNoTests?: boolean;
+    /**
+     * Enable coverage collection.
+     *
+     * @default true
+     */
+    readonly coverageEnabled?: boolean;
+    /**
+     * Coverage reports directory.
+     *
+     * @default "coverage"
+     */
+    readonly coverageDirectory?: string;
+    /**
+     * Coverage reporters.
+     *
+     * @default ["text", "lcov"]
+     */
+    readonly coverageReporters?: string[];
+}
+/**
+ * Options for the Vitest component.
+ */
+interface VitestOptions {
+    /**
+     * Config file path.
+     *
+     * @default "vitest.config.ts"
+     */
+    readonly configFilePath?: string;
+    /**
+     * Vitest config (test block).
+     */
+    readonly config?: VitestConfigOptions;
+    /**
+     * Vitest version (overrides VERSION.VITEST_VERSION).
+     */
+    readonly vitestVersion?: string;
+}
+/**
+ * Vitest component for Node/TypeScript projects.
+ *
+ * Adds Vitest as the test runner: devDeps, vitest.config.ts, and test/watch tasks.
+ * Incompatible with Jest; use jest: false when constructing the project.
+ */
+declare class Vitest extends Component {
+    readonly project: NodeProject;
+    /**
+     * Find the Vitest component on a project.
+     */
+    static of(project: NodeProject): Vitest | undefined;
+    private readonly configFilePath;
+    private readonly include;
+    private readonly exclude;
+    private readonly environment;
+    private readonly passWithNoTests;
+    private readonly coverageEnabled;
+    private readonly coverageDirectory;
+    private readonly coverageReporters;
+    private readonly version;
+    constructor(project: NodeProject, options?: VitestOptions);
+    preSynthesize(): void;
+    private addTestTasks;
+    private synthesizeConfig;
+    private renderConfig;
+}
+
+/**
+ * Test runner for TypeScript projects.
+ */
+declare const TestRunner: {
+    readonly JEST: "jest";
+    readonly VITEST: "vitest";
+};
+type TestRunner = (typeof TestRunner)[keyof typeof TestRunner];
+/**
+ * Configuration options for TypeScriptProject.
+ */
+interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOptions, "defaultReleaseBranch"> {
+    /**
+     * Test runner to use.
+     *
+     * @default TestRunner.JEST
+     */
+    readonly testRunner?: TestRunner;
+    /**
+     * Options for Vitest (only used when testRunner is 'vitest').
+     */
+    readonly vitestOptions?: VitestOptions;
+    /**
+     * Enable the reset task that deletes all build artifacts.
+     *
+     * @default true
+     */
+    readonly resetTask?: boolean;
+    /**
+     * Options for the reset task.
+     */
+    readonly resetTaskOptions?: ResetTaskOptions;
+    /**
+     * AI agent configuration (Cursor, Claude Code rules).
+     * Generates rule files with auto-detected bundles based on project tooling.
+     *
+     * - `true` or `{}`: enable with auto-detected defaults
+     * - `AgentConfigOptions`: enable with explicit configuration
+     * - `false` or `undefined`: disabled (default)
+     *
+     * Sub-projects do not inherit `AgentConfig` from their parent
+     * `MonorepoProject`. Agent rule files are rendered only on projects that
+     * explicitly opt in, so a monorepo's root `AgentConfig` does not duplicate
+     * `.cursor/`, `.claude/`, or `CLAUDE.md` into each sub-project's `outdir`.
+     *
+     * @default false
+     */
+    readonly agentConfig?: AgentConfigOptions | boolean;
+}
+declare class TypeScriptProject extends typescript.TypeScriptProject {
+    constructor(userOptions: TypeScriptProjectOptions);
+}
+
+/**
+ * Configuration options for AstroProject.
+ */
+interface AstroProjectOptions extends TypeScriptProjectOptions, AstroConfigOptions {
+    /**
+     * Astro package version.
+     *
+     * @default VERSION.ASTRO_VERSION
+     */
+    readonly astroVersion?: string;
+    /**
+     * Emit sample Astro starter files (`src/pages/index.astro`, `public/favicon.svg`).
+     *
+     * @default false
+     */
+    readonly sampleCode?: boolean;
+    /**
+     * Astro tsconfig preset to extend.
+     *
+     * @default "astro/tsconfigs/strict"
+     */
+    readonly astroTsconfigExtends?: string;
+}
+/**
+ * Minimal Astro site scaffolded on top of {@link TypeScriptProject}.
+ *
+ * Replaces the `tsc` compile step with `astro check && astro build`, writes
+ * `astro.config.mjs`, sets `"type": "module"`, and wires dev/preview tasks.
+ */
+declare class AstroProject extends TypeScriptProject {
+    /**
+     * Rendered Astro config component.
+     */
+    readonly astroConfig: AstroConfig;
+    constructor(userOptions: AstroProjectOptions);
+}
+
 /**
  * Each of the below options corresponds to a task property found here:
  *  * https://turborepo.com/docs/reference/configuration#defining-tasks
@@ -2786,155 +3070,6 @@ declare class ProjectMetadata extends Component {
     private autoDetectRepository;
 }
 
-/**
- * Options for the Vitest config (test block in vitest.config).
- *
- * @see https://vitest.dev/config/
- */
-interface VitestConfigOptions {
-    /**
-     * Glob patterns for test files.
-     *
-     * @default ["**\/*.{test,spec}.?(c|m)[jt]s?(x)"]
-     */
-    readonly include?: string[];
-    /**
-     * Glob patterns to exclude from test files.
-     *
-     * @default ["**\/node_modules\/**", "**\/dist\/**", "**\/lib\/**", "**\/.?\*"]
-     */
-    readonly exclude?: string[];
-    /**
-     * Test environment.
-     *
-     * @default "node"
-     */
-    readonly environment?: "node" | "jsdom" | "happy-dom" | "edge-runtime";
-    /**
-     * Do not fail when no tests are found.
-     *
-     * @default true
-     */
-    readonly passWithNoTests?: boolean;
-    /**
-     * Enable coverage collection.
-     *
-     * @default true
-     */
-    readonly coverageEnabled?: boolean;
-    /**
-     * Coverage reports directory.
-     *
-     * @default "coverage"
-     */
-    readonly coverageDirectory?: string;
-    /**
-     * Coverage reporters.
-     *
-     * @default ["text", "lcov"]
-     */
-    readonly coverageReporters?: string[];
-}
-/**
- * Options for the Vitest component.
- */
-interface VitestOptions {
-    /**
-     * Config file path.
-     *
-     * @default "vitest.config.ts"
-     */
-    readonly configFilePath?: string;
-    /**
-     * Vitest config (test block).
-     */
-    readonly config?: VitestConfigOptions;
-    /**
-     * Vitest version (overrides VERSION.VITEST_VERSION).
-     */
-    readonly vitestVersion?: string;
-}
-/**
- * Vitest component for Node/TypeScript projects.
- *
- * Adds Vitest as the test runner: devDeps, vitest.config.ts, and test/watch tasks.
- * Incompatible with Jest; use jest: false when constructing the project.
- */
-declare class Vitest extends Component {
-    readonly project: NodeProject;
-    /**
-     * Find the Vitest component on a project.
-     */
-    static of(project: NodeProject): Vitest | undefined;
-    private readonly configFilePath;
-    private readonly include;
-    private readonly exclude;
-    private readonly environment;
-    private readonly passWithNoTests;
-    private readonly coverageEnabled;
-    private readonly coverageDirectory;
-    private readonly coverageReporters;
-    private readonly version;
-    constructor(project: NodeProject, options?: VitestOptions);
-    preSynthesize(): void;
-    private addTestTasks;
-    private synthesizeConfig;
-    private renderConfig;
-}
-
-/**
- * Test runner for TypeScript projects.
- */
-declare const TestRunner: {
-    readonly JEST: "jest";
-    readonly VITEST: "vitest";
-};
-type TestRunner = (typeof TestRunner)[keyof typeof TestRunner];
-/**
- * Configuration options for TypeScriptProject.
- */
-interface TypeScriptProjectOptions extends Omit<typescript.TypeScriptProjectOptions, "defaultReleaseBranch"> {
-    /**
-     * Test runner to use.
-     *
-     * @default TestRunner.JEST
-     */
-    readonly testRunner?: TestRunner;
-    /**
-     * Options for Vitest (only used when testRunner is 'vitest').
-     */
-    readonly vitestOptions?: VitestOptions;
-    /**
-     * Enable the reset task that deletes all build artifacts.
-     *
-     * @default true
-     */
-    readonly resetTask?: boolean;
-    /**
-     * Options for the reset task.
-     */
-    readonly resetTaskOptions?: ResetTaskOptions;
-    /**
-     * AI agent configuration (Cursor, Claude Code rules).
-     * Generates rule files with auto-detected bundles based on project tooling.
-     *
-     * - `true` or `{}`: enable with auto-detected defaults
-     * - `AgentConfigOptions`: enable with explicit configuration
-     * - `false` or `undefined`: disabled (default)
-     *
-     * Sub-projects do not inherit `AgentConfig` from their parent
-     * `MonorepoProject`. Agent rule files are rendered only on projects that
-     * explicitly opt in, so a monorepo's root `AgentConfig` does not duplicate
-     * `.cursor/`, `.claude/`, or `CLAUDE.md` into each sub-project's `outdir`.
-     *
-     * @default false
-     */
-    readonly agentConfig?: AgentConfigOptions | boolean;
-}
-declare class TypeScriptProject extends typescript.TypeScriptProject {
-    constructor(userOptions: TypeScriptProjectOptions);
-}
-
 /*******************************************************************************
  *
  * Update / customize typescript configs for a project.
@@ -3050,5 +3185,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
-export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AwsAccount, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };