@codedrifters/configulator 0.0.192 → 0.0.193

package/lib/index.d.mts

@@ -1315,6 +1315,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
@@ -1673,6 +1767,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.
      *
@@ -2097,6 +2195,192 @@ declare class ResetTask extends Component {
     constructor(project: Project$1, 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
@@ -2737,155 +3021,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.
@@ -3001,4 +3136,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, type AwsAccount, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };