@codedrifters/configulator 0.0.437 → 0.0.438

package/lib/index.d.mts

@@ -14126,6 +14126,28 @@ interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "
      * @default - the parent monorepo's catalog pin for `constructs`
      */
     readonly constructsVersion?: string;
+    /**
+     * Options for the `CdkCli` component that every `cdk` invocation this
+     * project renders flows through — per-stage command defaults, per-account
+     * overrides, and the pinned CLI version.
+     *
+     * The component has to be seeded here rather than constructed afterwards.
+     * This constructor creates an `AwsDeploymentConfig`, which auto-creates a
+     * default `CdkCli` when the project has none, and `CdkCli.of()` resolves to
+     * the *first* matching component — so a `new CdkCli(project, options)` built
+     * once the constructor has returned is silently unreachable: no error, no
+     * warning, and the generated workflows render as if nothing was passed.
+     *
+     * Use it to declare a setting once per project instead of repeating it on
+     * every target via `AwsDeploymentTargetOptions.cdkOptions` — for example
+     * pinning `cdk diff --method=change-set` across stages so a diff never
+     * degrades to a template-only comparison and reports it as authoritative.
+     *
+     * @see `docs/src/content/docs/packages/@codedrifters/configulator/cdk-cli.md`
+     * @default - a `CdkCli` carrying no consumer overrides, identical to the one
+     * `AwsDeploymentConfig` would have auto-created
+     */
+    readonly cdkCliOptions?: CdkCliOptions;
     /**
      * AWS deployment targets (dev / stage / prod accounts and regions). Each
      * entry creates an `AwsDeploymentTarget` component on the project.

package/lib/index.d.ts

@@ -14175,6 +14175,28 @@ interface AwsCdkProjectOptions extends Omit<awscdk.AwsCdkTypeScriptAppOptions, "
      * @default - the parent monorepo's catalog pin for `constructs`
      */
     readonly constructsVersion?: string;
+    /**
+     * Options for the `CdkCli` component that every `cdk` invocation this
+     * project renders flows through — per-stage command defaults, per-account
+     * overrides, and the pinned CLI version.
+     *
+     * The component has to be seeded here rather than constructed afterwards.
+     * This constructor creates an `AwsDeploymentConfig`, which auto-creates a
+     * default `CdkCli` when the project has none, and `CdkCli.of()` resolves to
+     * the *first* matching component — so a `new CdkCli(project, options)` built
+     * once the constructor has returned is silently unreachable: no error, no
+     * warning, and the generated workflows render as if nothing was passed.
+     *
+     * Use it to declare a setting once per project instead of repeating it on
+     * every target via `AwsDeploymentTargetOptions.cdkOptions` — for example
+     * pinning `cdk diff --method=change-set` across stages so a diff never
+     * degrades to a template-only comparison and reports it as authoritative.
+     *
+     * @see `docs/src/content/docs/packages/@codedrifters/configulator/cdk-cli.md`
+     * @default - a `CdkCli` carrying no consumer overrides, identical to the one
+     * `AwsDeploymentConfig` would have auto-created
+     */
+    readonly cdkCliOptions?: CdkCliOptions;
     /**
      * AWS deployment targets (dev / stage / prod accounts and regions). Each
      * entry creates an `AwsDeploymentTarget` component on the project.

package/lib/index.js

@@ -44065,6 +44065,7 @@ var AwsCdkProject = class extends import_projen31.awscdk.AwsCdkTypeScriptApp {
     });
     this.gitignore?.addPatterns(".DS_Store", "test-reports", "cdk.out");
     this.npmignore?.addPatterns("*.spec.*", "*.test.*", "__fixtures__");
+    new CdkCli(this, options.cdkCliOptions ?? {});
     new AwsDeploymentConfig(this);
     (options.deploymentTargets ?? []).forEach(
       (targetOptions) => this.addDeploymentTarget(targetOptions)