@codedrifters/configulator 0.0.197 → 0.0.199

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.mts CHANGED
@@ -1791,6 +1791,11 @@ declare const VERSION: {
1791
1791
  * Version of Node.js to use in CI workflows at github actions.
1792
1792
  */
1793
1793
  readonly NODE_WORKFLOWS: "24";
1794
+ /**
1795
+ * Version of `pnpm/action-setup` to use in GitHub workflows.
1796
+ * Tracks the version projen currently emits (see node_modules/projen/lib/javascript/node-project.js).
1797
+ */
1798
+ readonly PNPM_ACTION_SETUP_VERSION: "v5";
1794
1799
  /**
1795
1800
  * Version of PNPM to use in workflows at github actions.
1796
1801
  */
@@ -1799,6 +1804,20 @@ declare const VERSION: {
1799
1804
  * Version of Projen to use.
1800
1805
  */
1801
1806
  readonly PROJEN_VERSION: "0.99.48";
1807
+ /**
1808
+ * Version of `actions/setup-node` to use in GitHub workflows.
1809
+ * Tracks the version projen currently emits (see node_modules/projen/lib/github/workflows.js).
1810
+ */
1811
+ readonly SETUP_NODE_ACTION_VERSION: "v6";
1812
+ /**
1813
+ * Version of sharp to pin for StarlightProject (required peer for
1814
+ * Starlight's image optimization pipeline).
1815
+ */
1816
+ readonly SHARP_VERSION: "0.34.5";
1817
+ /**
1818
+ * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
1819
+ */
1820
+ readonly STARLIGHT_VERSION: "0.38.3";
1802
1821
  /**
1803
1822
  * What version of the turborepo library should we use?
1804
1823
  */
@@ -3236,6 +3255,113 @@ declare class ProjectMetadata extends Component {
3236
3255
  private autoDetectRepository;
3237
3256
  }
3238
3257
 
3258
+ /**
3259
+ * A single Starlight social icon link.
3260
+ */
3261
+ interface StarlightSocialLink {
3262
+ readonly icon: string;
3263
+ readonly label: string;
3264
+ readonly href: string;
3265
+ }
3266
+ /**
3267
+ * Starlight logo configuration.
3268
+ */
3269
+ interface StarlightLogo {
3270
+ readonly src: string;
3271
+ readonly alt?: string;
3272
+ }
3273
+ /**
3274
+ * Starlight edit-link configuration.
3275
+ */
3276
+ interface StarlightEditLink {
3277
+ readonly baseUrl: string;
3278
+ }
3279
+ /**
3280
+ * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
3281
+ * common shapes: link, group with nested items, autogenerated group, and
3282
+ * internal slug reference.
3283
+ */
3284
+ type StarlightSidebarItem = {
3285
+ readonly label: string;
3286
+ readonly link: string;
3287
+ readonly badge?: string | {
3288
+ readonly text: string;
3289
+ readonly variant?: string;
3290
+ };
3291
+ } | {
3292
+ readonly label: string;
3293
+ readonly items: ReadonlyArray<StarlightSidebarItem>;
3294
+ } | {
3295
+ readonly label: string;
3296
+ readonly autogenerate: {
3297
+ readonly directory: string;
3298
+ readonly collapsed?: boolean;
3299
+ };
3300
+ } | {
3301
+ readonly label: string;
3302
+ readonly slug: string;
3303
+ };
3304
+ /**
3305
+ * Configuration options for StarlightProject.
3306
+ */
3307
+ interface StarlightProjectOptions extends AstroProjectOptions {
3308
+ /**
3309
+ * Starlight site title (required).
3310
+ */
3311
+ readonly starlightTitle: string;
3312
+ /**
3313
+ * Starlight site description.
3314
+ */
3315
+ readonly starlightDescription?: string;
3316
+ /**
3317
+ * Social links rendered in the Starlight header.
3318
+ */
3319
+ readonly social?: ReadonlyArray<StarlightSocialLink>;
3320
+ /**
3321
+ * Sidebar config (passed through verbatim). When omitted, Starlight
3322
+ * autogenerates the sidebar from the `src/content/docs/` tree.
3323
+ */
3324
+ readonly sidebar?: ReadonlyArray<StarlightSidebarItem>;
3325
+ /**
3326
+ * Custom CSS files loaded by Starlight.
3327
+ */
3328
+ readonly customCss?: ReadonlyArray<string>;
3329
+ /**
3330
+ * Site logo displayed in the Starlight header.
3331
+ */
3332
+ readonly logo?: StarlightLogo;
3333
+ /**
3334
+ * "Edit this page" link configuration.
3335
+ */
3336
+ readonly editLink?: StarlightEditLink;
3337
+ /**
3338
+ * @astrojs/starlight package version.
3339
+ *
3340
+ * @default VERSION.STARLIGHT_VERSION
3341
+ */
3342
+ readonly starlightVersion?: string;
3343
+ /**
3344
+ * sharp package version (required peer for Starlight's image pipeline).
3345
+ *
3346
+ * @default VERSION.SHARP_VERSION
3347
+ */
3348
+ readonly sharpVersion?: string;
3349
+ /**
3350
+ * Emit sample Starlight content (`src/content/docs/index.mdx`,
3351
+ * `src/content/config.ts`).
3352
+ *
3353
+ * @default false
3354
+ */
3355
+ readonly sampleContent?: boolean;
3356
+ }
3357
+ /**
3358
+ * Docs site scaffolded on top of {@link AstroProject} using the
3359
+ * Starlight Astro integration.
3360
+ */
3361
+ declare class StarlightProject extends AstroProject {
3362
+ constructor(userOptions: StarlightProjectOptions);
3363
+ }
3364
+
3239
3365
  /*******************************************************************************
3240
3366
  *
3241
3367
  * Update / customize typescript configs for a project.
@@ -3270,4 +3396,4 @@ declare const COMPLETE_JOB_ID = "complete";
3270
3396
  */
3271
3397
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
3272
3398
 
3273
- 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, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, 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_TEARDOWN_BRANCH_PATTERNS, 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 };
3399
+ 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, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, 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_TEARDOWN_BRANCH_PATTERNS, 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 StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, type StarlightSocialLink, 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 };
package/lib/index.d.ts CHANGED
@@ -1840,6 +1840,11 @@ declare const VERSION: {
1840
1840
  * Version of Node.js to use in CI workflows at github actions.
1841
1841
  */
1842
1842
  readonly NODE_WORKFLOWS: "24";
1843
+ /**
1844
+ * Version of `pnpm/action-setup` to use in GitHub workflows.
1845
+ * Tracks the version projen currently emits (see node_modules/projen/lib/javascript/node-project.js).
1846
+ */
1847
+ readonly PNPM_ACTION_SETUP_VERSION: "v5";
1843
1848
  /**
1844
1849
  * Version of PNPM to use in workflows at github actions.
1845
1850
  */
@@ -1848,6 +1853,20 @@ declare const VERSION: {
1848
1853
  * Version of Projen to use.
1849
1854
  */
1850
1855
  readonly PROJEN_VERSION: "0.99.48";
1856
+ /**
1857
+ * Version of `actions/setup-node` to use in GitHub workflows.
1858
+ * Tracks the version projen currently emits (see node_modules/projen/lib/github/workflows.js).
1859
+ */
1860
+ readonly SETUP_NODE_ACTION_VERSION: "v6";
1861
+ /**
1862
+ * Version of sharp to pin for StarlightProject (required peer for
1863
+ * Starlight's image optimization pipeline).
1864
+ */
1865
+ readonly SHARP_VERSION: "0.34.5";
1866
+ /**
1867
+ * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
1868
+ */
1869
+ readonly STARLIGHT_VERSION: "0.38.3";
1851
1870
  /**
1852
1871
  * What version of the turborepo library should we use?
1853
1872
  */
@@ -3285,6 +3304,113 @@ declare class ProjectMetadata extends Component {
3285
3304
  private autoDetectRepository;
3286
3305
  }
3287
3306
 
3307
+ /**
3308
+ * A single Starlight social icon link.
3309
+ */
3310
+ interface StarlightSocialLink {
3311
+ readonly icon: string;
3312
+ readonly label: string;
3313
+ readonly href: string;
3314
+ }
3315
+ /**
3316
+ * Starlight logo configuration.
3317
+ */
3318
+ interface StarlightLogo {
3319
+ readonly src: string;
3320
+ readonly alt?: string;
3321
+ }
3322
+ /**
3323
+ * Starlight edit-link configuration.
3324
+ */
3325
+ interface StarlightEditLink {
3326
+ readonly baseUrl: string;
3327
+ }
3328
+ /**
3329
+ * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
3330
+ * common shapes: link, group with nested items, autogenerated group, and
3331
+ * internal slug reference.
3332
+ */
3333
+ type StarlightSidebarItem = {
3334
+ readonly label: string;
3335
+ readonly link: string;
3336
+ readonly badge?: string | {
3337
+ readonly text: string;
3338
+ readonly variant?: string;
3339
+ };
3340
+ } | {
3341
+ readonly label: string;
3342
+ readonly items: ReadonlyArray<StarlightSidebarItem>;
3343
+ } | {
3344
+ readonly label: string;
3345
+ readonly autogenerate: {
3346
+ readonly directory: string;
3347
+ readonly collapsed?: boolean;
3348
+ };
3349
+ } | {
3350
+ readonly label: string;
3351
+ readonly slug: string;
3352
+ };
3353
+ /**
3354
+ * Configuration options for StarlightProject.
3355
+ */
3356
+ interface StarlightProjectOptions extends AstroProjectOptions {
3357
+ /**
3358
+ * Starlight site title (required).
3359
+ */
3360
+ readonly starlightTitle: string;
3361
+ /**
3362
+ * Starlight site description.
3363
+ */
3364
+ readonly starlightDescription?: string;
3365
+ /**
3366
+ * Social links rendered in the Starlight header.
3367
+ */
3368
+ readonly social?: ReadonlyArray<StarlightSocialLink>;
3369
+ /**
3370
+ * Sidebar config (passed through verbatim). When omitted, Starlight
3371
+ * autogenerates the sidebar from the `src/content/docs/` tree.
3372
+ */
3373
+ readonly sidebar?: ReadonlyArray<StarlightSidebarItem>;
3374
+ /**
3375
+ * Custom CSS files loaded by Starlight.
3376
+ */
3377
+ readonly customCss?: ReadonlyArray<string>;
3378
+ /**
3379
+ * Site logo displayed in the Starlight header.
3380
+ */
3381
+ readonly logo?: StarlightLogo;
3382
+ /**
3383
+ * "Edit this page" link configuration.
3384
+ */
3385
+ readonly editLink?: StarlightEditLink;
3386
+ /**
3387
+ * @astrojs/starlight package version.
3388
+ *
3389
+ * @default VERSION.STARLIGHT_VERSION
3390
+ */
3391
+ readonly starlightVersion?: string;
3392
+ /**
3393
+ * sharp package version (required peer for Starlight's image pipeline).
3394
+ *
3395
+ * @default VERSION.SHARP_VERSION
3396
+ */
3397
+ readonly sharpVersion?: string;
3398
+ /**
3399
+ * Emit sample Starlight content (`src/content/docs/index.mdx`,
3400
+ * `src/content/config.ts`).
3401
+ *
3402
+ * @default false
3403
+ */
3404
+ readonly sampleContent?: boolean;
3405
+ }
3406
+ /**
3407
+ * Docs site scaffolded on top of {@link AstroProject} using the
3408
+ * Starlight Astro integration.
3409
+ */
3410
+ declare class StarlightProject extends AstroProject {
3411
+ constructor(userOptions: StarlightProjectOptions);
3412
+ }
3413
+
3288
3414
  /*******************************************************************************
3289
3415
  *
3290
3416
  * Update / customize typescript configs for a project.
@@ -3319,5 +3445,5 @@ declare const COMPLETE_JOB_ID = "complete";
3319
3445
  */
3320
3446
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
3321
3447
 
3322
- export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, 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 };
3323
- export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, 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 };
3448
+ export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, 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, StarlightProject, 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 };
3449
+ export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, 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, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightSidebarItem, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
package/lib/index.js CHANGED
@@ -206,6 +206,7 @@ __export(index_exports, {
206
206
  ROOT_CI_TASK_NAME: () => ROOT_CI_TASK_NAME,
207
207
  ROOT_TURBO_TASK_NAME: () => ROOT_TURBO_TASK_NAME,
208
208
  ResetTask: () => ResetTask,
209
+ StarlightProject: () => StarlightProject,
209
210
  TestRunner: () => TestRunner,
210
211
  TurboRepo: () => TurboRepo,
211
212
  TurboRepoTask: () => TurboRepoTask,
@@ -3047,6 +3048,11 @@ var VERSION = {
3047
3048
  * Version of Node.js to use in CI workflows at github actions.
3048
3049
  */
3049
3050
  NODE_WORKFLOWS: "24",
3051
+ /**
3052
+ * Version of `pnpm/action-setup` to use in GitHub workflows.
3053
+ * Tracks the version projen currently emits (see node_modules/projen/lib/javascript/node-project.js).
3054
+ */
3055
+ PNPM_ACTION_SETUP_VERSION: "v5",
3050
3056
  /**
3051
3057
  * Version of PNPM to use in workflows at github actions.
3052
3058
  */
@@ -3055,6 +3061,20 @@ var VERSION = {
3055
3061
  * Version of Projen to use.
3056
3062
  */
3057
3063
  PROJEN_VERSION: "0.99.48",
3064
+ /**
3065
+ * Version of `actions/setup-node` to use in GitHub workflows.
3066
+ * Tracks the version projen currently emits (see node_modules/projen/lib/github/workflows.js).
3067
+ */
3068
+ SETUP_NODE_ACTION_VERSION: "v6",
3069
+ /**
3070
+ * Version of sharp to pin for StarlightProject (required peer for
3071
+ * Starlight's image optimization pipeline).
3072
+ */
3073
+ SHARP_VERSION: "0.34.5",
3074
+ /**
3075
+ * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
3076
+ */
3077
+ STARLIGHT_VERSION: "0.38.3",
3058
3078
  /**
3059
3079
  * What version of the turborepo library should we use?
3060
3080
  */
@@ -4816,6 +4836,8 @@ var VERSION_NPM_PACKAGES = [
4816
4836
  { key: "AWS_CONSTRUCTS_VERSION", npmPackage: "constructs" },
4817
4837
  { key: "PNPM_VERSION", npmPackage: "pnpm" },
4818
4838
  { key: "PROJEN_VERSION", npmPackage: "projen" },
4839
+ { key: "SHARP_VERSION", npmPackage: "sharp" },
4840
+ { key: "STARLIGHT_VERSION", npmPackage: "@astrojs/starlight" },
4819
4841
  { key: "TURBO_VERSION", npmPackage: "turbo" },
4820
4842
  { key: "TYPES_NODE_VERSION", npmPackage: "@types/node" },
4821
4843
  { key: "VITEST_VERSION", npmPackage: "vitest" }
@@ -4892,6 +4914,7 @@ var import_release = require("projen/lib/release");
4892
4914
  var import_ts_deepmerge2 = require("ts-deepmerge");
4893
4915
 
4894
4916
  // src/projects/monorepo-project.ts
4917
+ var import_github2 = require("projen/lib/github");
4895
4918
  var import_javascript3 = require("projen/lib/javascript");
4896
4919
  var import_typescript3 = require("projen/lib/typescript");
4897
4920
  var import_ts_deepmerge = require("ts-deepmerge");
@@ -5521,16 +5544,15 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
5521
5544
  name: "Build Sub Projects",
5522
5545
  run: `npx projen ${ROOT_CI_TASK_NAME}`
5523
5546
  },
5524
- {
5547
+ import_github2.WorkflowSteps.uploadArtifact({
5525
5548
  name: "Upload Turbo runs",
5526
5549
  if: "always()",
5527
- uses: "actions/upload-artifact@v4.6.2",
5550
+ continueOnError: true,
5528
5551
  with: {
5529
5552
  name: "turbo-runs",
5530
5553
  path: ".turbo/runs"
5531
- },
5532
- continueOnError: true
5533
- }
5554
+ }
5555
+ })
5534
5556
  );
5535
5557
  }
5536
5558
  if (options.resetTask !== false) {
@@ -5925,7 +5947,7 @@ var import_ts_deepmerge3 = require("ts-deepmerge");
5925
5947
  var import_utils11 = __toESM(require_lib());
5926
5948
  var import_projen18 = require("projen");
5927
5949
  var import_build = require("projen/lib/build");
5928
- var import_github2 = require("projen/lib/github");
5950
+ var import_github3 = require("projen/lib/github");
5929
5951
  var import_workflows_model5 = require("projen/lib/github/workflows-model");
5930
5952
  var PROD_DEPLOY_NAME = "prod-deploy";
5931
5953
  var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Component {
@@ -5944,7 +5966,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
5944
5966
  return [
5945
5967
  {
5946
5968
  name: "Setup Node",
5947
- uses: "actions/setup-node@v4",
5969
+ uses: `actions/setup-node@${VERSION.SETUP_NODE_ACTION_VERSION}`,
5948
5970
  with: {
5949
5971
  ["node-version"]: VERSION.NODE_WORKFLOWS
5950
5972
  },
@@ -5957,7 +5979,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
5957
5979
  return [
5958
5980
  {
5959
5981
  name: "Setup PNPM",
5960
- uses: "pnpm/action-setup@v3",
5982
+ uses: `pnpm/action-setup@${VERSION.PNPM_ACTION_SETUP_VERSION}`,
5961
5983
  with: {
5962
5984
  version: VERSION.PNPM_VERSION
5963
5985
  }
@@ -6041,7 +6063,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
6041
6063
  );
6042
6064
  }
6043
6065
  this.rootProject = project.root;
6044
- const github = import_github2.GitHub.of(this.rootProject);
6066
+ const github = import_github3.GitHub.of(this.rootProject);
6045
6067
  if (!github) {
6046
6068
  throw new Error(
6047
6069
  "AwsDeployWorkflow requires a GitHub component in the root project"
@@ -6176,16 +6198,15 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
6176
6198
  name: "Build Sub Projects",
6177
6199
  run: `npx projen ${ROOT_CI_TASK_NAME}`
6178
6200
  },
6179
- {
6201
+ import_github3.WorkflowSteps.uploadArtifact({
6180
6202
  name: "Upload Turbo runs",
6181
6203
  if: "always()",
6182
- uses: "actions/upload-artifact@v4.6.2",
6204
+ continueOnError: true,
6183
6205
  with: {
6184
6206
  name: "turbo-runs",
6185
6207
  path: ".turbo/runs"
6186
- },
6187
- continueOnError: true
6188
- }
6208
+ }
6209
+ })
6189
6210
  );
6190
6211
  }
6191
6212
  super.preSynthesize();
@@ -6194,7 +6215,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
6194
6215
 
6195
6216
  // src/workflows/aws-teardown-workflow.ts
6196
6217
  var import_projen19 = require("projen");
6197
- var import_github3 = require("projen/lib/github");
6218
+ var import_github4 = require("projen/lib/github");
6198
6219
  var import_workflows_model6 = require("projen/lib/github/workflows-model");
6199
6220
  var DEFAULT_TEARDOWN_BRANCH_PATTERNS = [
6200
6221
  "feat/*",
@@ -6244,7 +6265,7 @@ var AwsTeardownWorkflow = class extends import_projen19.Component {
6244
6265
  "AwsTeardownWorkflow requires the root project to be a MonorepoProject"
6245
6266
  );
6246
6267
  }
6247
- const github = import_github3.GitHub.of(this.rootProject);
6268
+ const github = import_github4.GitHub.of(this.rootProject);
6248
6269
  if (!github) {
6249
6270
  throw new Error(
6250
6271
  "AwsTeardownWorkflow requires a GitHub component in the root project"
@@ -6254,7 +6275,7 @@ var AwsTeardownWorkflow = class extends import_projen19.Component {
6254
6275
  deleteBranchPatterns,
6255
6276
  awsDestructionTargets
6256
6277
  );
6257
- const workflow = new import_github3.GithubWorkflow(github, "teardown-dev");
6278
+ const workflow = new import_github4.GithubWorkflow(github, "teardown-dev");
6258
6279
  workflow.on({
6259
6280
  workflowDispatch: {},
6260
6281
  schedule: [
@@ -6589,11 +6610,96 @@ var AwsCdkProject = class extends import_projen20.awscdk.AwsCdkTypeScriptApp {
6589
6610
  }
6590
6611
  };
6591
6612
 
6613
+ // src/projects/starlight-project.ts
6614
+ var import_projen21 = require("projen");
6615
+ var StarlightProject = class extends AstroProject {
6616
+ constructor(userOptions) {
6617
+ const starlightConfig = buildStarlightConfig(userOptions);
6618
+ const starlightSpec = {
6619
+ name: "starlight",
6620
+ importPath: "@astrojs/starlight",
6621
+ defaultImport: true,
6622
+ args: JSON.stringify(starlightConfig, null, 2)
6623
+ };
6624
+ const mergedOptions = {
6625
+ ...userOptions,
6626
+ integrations: [starlightSpec, ...userOptions.integrations ?? []],
6627
+ depsUpgradeOptions: {
6628
+ ...userOptions.depsUpgradeOptions,
6629
+ exclude: [
6630
+ ...userOptions.depsUpgradeOptions?.exclude ?? [],
6631
+ "@astrojs/starlight",
6632
+ "sharp"
6633
+ ]
6634
+ }
6635
+ };
6636
+ super(mergedOptions);
6637
+ const starlightVersion = userOptions.starlightVersion ?? VERSION.STARLIGHT_VERSION;
6638
+ const sharpVersion = userOptions.sharpVersion ?? VERSION.SHARP_VERSION;
6639
+ this.addDeps(
6640
+ `@astrojs/starlight@${starlightVersion}`,
6641
+ `sharp@${sharpVersion}`
6642
+ );
6643
+ const turbo = TurboRepo.of(this);
6644
+ if (turbo?.compileTask) {
6645
+ turbo.compileTask.inputs.push("src/content/**");
6646
+ }
6647
+ if (userOptions.sampleContent === true) {
6648
+ new import_projen21.SampleFile(this, "src/content/docs/index.mdx", {
6649
+ contents: DEFAULT_INDEX_MDX
6650
+ });
6651
+ new import_projen21.SampleFile(this, "src/content/config.ts", {
6652
+ contents: DEFAULT_CONTENT_CONFIG_TS
6653
+ });
6654
+ }
6655
+ }
6656
+ };
6657
+ function buildStarlightConfig(options) {
6658
+ const config = {
6659
+ title: options.starlightTitle
6660
+ };
6661
+ if (options.starlightDescription !== void 0) {
6662
+ config.description = options.starlightDescription;
6663
+ }
6664
+ if (options.social !== void 0) {
6665
+ config.social = options.social;
6666
+ }
6667
+ if (options.sidebar !== void 0) {
6668
+ config.sidebar = options.sidebar;
6669
+ }
6670
+ if (options.customCss !== void 0) {
6671
+ config.customCss = options.customCss;
6672
+ }
6673
+ if (options.logo !== void 0) {
6674
+ config.logo = options.logo;
6675
+ }
6676
+ if (options.editLink !== void 0) {
6677
+ config.editLink = options.editLink;
6678
+ }
6679
+ return config;
6680
+ }
6681
+ var DEFAULT_INDEX_MDX = `---
6682
+ title: Welcome
6683
+ description: Starlight-powered documentation site.
6684
+ ---
6685
+
6686
+ # Hello, Starlight!
6687
+
6688
+ Edit \`src/content/docs/index.mdx\` to replace this page.
6689
+ `;
6690
+ var DEFAULT_CONTENT_CONFIG_TS = `import { defineCollection } from "astro:content";
6691
+ import { docsSchema } from "@astrojs/starlight/schema";
6692
+
6693
+ export const collections = {
6694
+ docs: defineCollection({ schema: docsSchema() }),
6695
+ };
6696
+ `;
6697
+
6592
6698
  // src/typescript/typescript-config.ts
6593
6699
  var import_node_path2 = require("path");
6594
- var import_projen21 = require("projen");
6700
+ var import_projen22 = require("projen");
6595
6701
  var import_path2 = require("projen/lib/util/path");
6596
- var TypeScriptConfig = class extends import_projen21.Component {
6702
+ var TypeScriptConfig = class extends import_projen22.Component {
6597
6703
  constructor(project) {
6598
6704
  super(project);
6599
6705
  let tsPaths = {};
@@ -6651,6 +6757,7 @@ var TypeScriptConfig = class extends import_projen21.Component {
6651
6757
  ROOT_CI_TASK_NAME,
6652
6758
  ROOT_TURBO_TASK_NAME,
6653
6759
  ResetTask,
6760
+ StarlightProject,
6654
6761
  TestRunner,
6655
6762
  TurboRepo,
6656
6763
  TurboRepoTask,