@codedrifters/configulator 0.0.309 → 0.0.311

package/lib/index.d.mts

@@ -8695,6 +8695,95 @@ interface PnpmWorkspaceOptions {
             [dependencyName: string]: string;
         };
     };
+    /**
+     * Whether pnpm prompts before removing a sub-project's `node_modules`
+     * directory during install. Set to `false` to skip the interactive prompt
+     * so headless / non-TTY consumers (Claude Code agents, CI scripts,
+     * scheduled tasks) don't abort with
+     * `ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY` mid-synth.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#confirmmodulespurge
+     */
+    readonly confirmModulesPurge?: boolean;
+    /**
+     * Whether pnpm fails the install when a dependency's build script has not
+     * been explicitly approved via `allowBuilds`. Set to `false` so unreviewed
+     * build-script entries don't fail mid-synth in CI when configulator is
+     * regenerating `allowBuilds` placeholders.
+     *
+     * Introduced in pnpm 10.3 (default `true` in pnpm 11).
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#strictdepbuilds
+     */
+    readonly strictDepBuilds?: boolean;
+    /**
+     * Whether `pnpm run` / `pnpm exec` verifies the lockfile matches
+     * `node_modules` before executing the requested script. Set to `"install"`
+     * (or `false`) so non-TTY consumers don't hang on the `"prompt"` default.
+     *
+     * Introduced in pnpm 10.x.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of "prompt")
+     *
+     * @see https://pnpm.io/settings#verifydepsbeforerun
+     */
+    readonly verifyDepsBeforeRun?: "install" | "warn" | "error" | "prompt" | false;
+    /**
+     * How catalog entries are enforced when a sub-project's `package.json`
+     * specifies a dependency that exists in a catalog. `"manual"` keeps the
+     * existing opt-in `catalog:` protocol behavior, `"prefer"` substitutes
+     * catalog versions automatically, and `"strict"` rejects any version
+     * that diverges from the catalog.
+     *
+     * Introduced in pnpm 10.12.1.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of "manual")
+     *
+     * @see https://pnpm.io/settings#catalogmode
+     */
+    readonly catalogMode?: "manual" | "prefer" | "strict";
+    /**
+     * Whether pnpm removes unused catalog entries from `pnpm-workspace.yaml`
+     * during install. Helps keep the catalog honest when sub-projects stop
+     * referencing a catalog entry.
+     *
+     * Introduced in pnpm 10.15.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#cleanupunusedcatalogs
+     */
+    readonly cleanupUnusedCatalogs?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution fails when no published version
+     * satisfies the age constraint. `true` fails the install; `false` falls
+     * back to an older version that does satisfy the age constraint.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#minimumreleaseagestrict
+     */
+    readonly minimumReleaseAgeStrict?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution skips the age check for packages
+     * whose registry response lacks timestamp metadata. Default is `true`
+     * (skip the check rather than fail), which mirrors pnpm's behavior.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of true)
+     *
+     * @see https://pnpm.io/settings#minimumreleaseageignoremissingtime
+     */
+    readonly minimumReleaseAgeIgnoreMissingTime?: boolean;
 }
 declare class PnpmWorkspace extends Component {
     /**
@@ -8813,6 +8902,54 @@ declare class PnpmWorkspace extends Component {
             [dependencyName: string]: string;
         };
     };
+    /**
+     * Skip the interactive `node_modules` purge prompt so headless consumers
+     * don't abort mid-synth. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#confirmmodulespurge
+     */
+    confirmModulesPurge?: boolean;
+    /**
+     * Fail (`true`) or warn (`false`) when a dependency's build script has
+     * not been explicitly approved via `allowBuilds`. Introduced in pnpm 10.3.
+     *
+     * @see https://pnpm.io/settings#strictdepbuilds
+     */
+    strictDepBuilds?: boolean;
+    /**
+     * Behavior of `pnpm run` / `pnpm exec` when the lockfile drifts from
+     * `node_modules`. Use `"install"` (or `false`) for non-TTY callers.
+     *
+     * @see https://pnpm.io/settings#verifydepsbeforerun
+     */
+    verifyDepsBeforeRun?: "install" | "warn" | "error" | "prompt" | false;
+    /**
+     * Catalog enforcement mode. Introduced in pnpm 10.12.1.
+     *
+     * @see https://pnpm.io/settings#catalogmode
+     */
+    catalogMode?: "manual" | "prefer" | "strict";
+    /**
+     * Whether unused catalog entries are pruned on install.
+     * Introduced in pnpm 10.15.
+     *
+     * @see https://pnpm.io/settings#cleanupunusedcatalogs
+     */
+    cleanupUnusedCatalogs?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution fails when no version satisfies
+     * the age constraint. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#minimumreleaseagestrict
+     */
+    minimumReleaseAgeStrict?: boolean;
+    /**
+     * Whether `minimumReleaseAge` skips the age check for registries lacking
+     * timestamp metadata. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#minimumreleaseageignoremissingtime
+     */
+    minimumReleaseAgeIgnoreMissingTime?: boolean;
     constructor(project: Project$1, options?: PnpmWorkspaceOptions);
 }
 /**
@@ -10281,9 +10418,22 @@ interface StarlightEditLink {
     readonly baseUrl: string;
 }
 /**
- * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
- * common shapes: link, group with nested items, autogenerated group, and
- * internal slug reference.
+ * Sidebar item accepted by Starlight's `sidebar` config.
+ *
+ * Covers the shapes Starlight 0.39+ accepts:
+ * - link (`{ label, link, badge? }`)
+ * - group with nested items (`{ label, collapsed?, items }`)
+ * - bare autogenerated entry, nested inside a group's `items` array
+ *   (`{ autogenerate: { directory, collapsed? } }`)
+ * - internal slug reference (`{ label, slug }`)
+ *
+ * Plus one legacy shape kept for one deprecation cycle:
+ * - top-level autogenerated group (`{ label, collapsed?, autogenerate }`).
+ *   Starlight v0.39.0 removed runtime support for this shape; the
+ *   `StarlightProject` emitter translates it to the nested form
+ *   `{ label, collapsed?, items: [{ autogenerate }] }` before writing
+ *   `astro.config.mjs`. Migrate to the nested form directly — this
+ *   variant will be removed in a future release.
  */
 type StarlightSidebarItem = {
     readonly label: string;
@@ -10297,6 +10447,12 @@ type StarlightSidebarItem = {
     readonly collapsed?: boolean;
     readonly items: ReadonlyArray<StarlightSidebarItem>;
 } | {
+    readonly autogenerate: {
+        readonly directory: string;
+        readonly collapsed?: boolean;
+    };
+} | {
+    /** @deprecated Use `{ label, items: [{ autogenerate }] }` instead. Translated by the emitter for one cycle. */
     readonly label: string;
     readonly collapsed?: boolean;
     readonly autogenerate: {

package/lib/index.d.ts

@@ -8744,6 +8744,95 @@ interface PnpmWorkspaceOptions {
             [dependencyName: string]: string;
         };
     };
+    /**
+     * Whether pnpm prompts before removing a sub-project's `node_modules`
+     * directory during install. Set to `false` to skip the interactive prompt
+     * so headless / non-TTY consumers (Claude Code agents, CI scripts,
+     * scheduled tasks) don't abort with
+     * `ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY` mid-synth.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#confirmmodulespurge
+     */
+    readonly confirmModulesPurge?: boolean;
+    /**
+     * Whether pnpm fails the install when a dependency's build script has not
+     * been explicitly approved via `allowBuilds`. Set to `false` so unreviewed
+     * build-script entries don't fail mid-synth in CI when configulator is
+     * regenerating `allowBuilds` placeholders.
+     *
+     * Introduced in pnpm 10.3 (default `true` in pnpm 11).
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#strictdepbuilds
+     */
+    readonly strictDepBuilds?: boolean;
+    /**
+     * Whether `pnpm run` / `pnpm exec` verifies the lockfile matches
+     * `node_modules` before executing the requested script. Set to `"install"`
+     * (or `false`) so non-TTY consumers don't hang on the `"prompt"` default.
+     *
+     * Introduced in pnpm 10.x.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of "prompt")
+     *
+     * @see https://pnpm.io/settings#verifydepsbeforerun
+     */
+    readonly verifyDepsBeforeRun?: "install" | "warn" | "error" | "prompt" | false;
+    /**
+     * How catalog entries are enforced when a sub-project's `package.json`
+     * specifies a dependency that exists in a catalog. `"manual"` keeps the
+     * existing opt-in `catalog:` protocol behavior, `"prefer"` substitutes
+     * catalog versions automatically, and `"strict"` rejects any version
+     * that diverges from the catalog.
+     *
+     * Introduced in pnpm 10.12.1.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of "manual")
+     *
+     * @see https://pnpm.io/settings#catalogmode
+     */
+    readonly catalogMode?: "manual" | "prefer" | "strict";
+    /**
+     * Whether pnpm removes unused catalog entries from `pnpm-workspace.yaml`
+     * during install. Helps keep the catalog honest when sub-projects stop
+     * referencing a catalog entry.
+     *
+     * Introduced in pnpm 10.15.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#cleanupunusedcatalogs
+     */
+    readonly cleanupUnusedCatalogs?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution fails when no published version
+     * satisfies the age constraint. `true` fails the install; `false` falls
+     * back to an older version that does satisfy the age constraint.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default)
+     *
+     * @see https://pnpm.io/settings#minimumreleaseagestrict
+     */
+    readonly minimumReleaseAgeStrict?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution skips the age check for packages
+     * whose registry response lacks timestamp metadata. Default is `true`
+     * (skip the check rather than fail), which mirrors pnpm's behavior.
+     *
+     * Introduced in pnpm 11.0.
+     *
+     * @default undefined (key omitted; pnpm uses its built-in default of true)
+     *
+     * @see https://pnpm.io/settings#minimumreleaseageignoremissingtime
+     */
+    readonly minimumReleaseAgeIgnoreMissingTime?: boolean;
 }
 declare class PnpmWorkspace extends Component {
     /**
@@ -8862,6 +8951,54 @@ declare class PnpmWorkspace extends Component {
             [dependencyName: string]: string;
         };
     };
+    /**
+     * Skip the interactive `node_modules` purge prompt so headless consumers
+     * don't abort mid-synth. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#confirmmodulespurge
+     */
+    confirmModulesPurge?: boolean;
+    /**
+     * Fail (`true`) or warn (`false`) when a dependency's build script has
+     * not been explicitly approved via `allowBuilds`. Introduced in pnpm 10.3.
+     *
+     * @see https://pnpm.io/settings#strictdepbuilds
+     */
+    strictDepBuilds?: boolean;
+    /**
+     * Behavior of `pnpm run` / `pnpm exec` when the lockfile drifts from
+     * `node_modules`. Use `"install"` (or `false`) for non-TTY callers.
+     *
+     * @see https://pnpm.io/settings#verifydepsbeforerun
+     */
+    verifyDepsBeforeRun?: "install" | "warn" | "error" | "prompt" | false;
+    /**
+     * Catalog enforcement mode. Introduced in pnpm 10.12.1.
+     *
+     * @see https://pnpm.io/settings#catalogmode
+     */
+    catalogMode?: "manual" | "prefer" | "strict";
+    /**
+     * Whether unused catalog entries are pruned on install.
+     * Introduced in pnpm 10.15.
+     *
+     * @see https://pnpm.io/settings#cleanupunusedcatalogs
+     */
+    cleanupUnusedCatalogs?: boolean;
+    /**
+     * Whether `minimumReleaseAge` resolution fails when no version satisfies
+     * the age constraint. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#minimumreleaseagestrict
+     */
+    minimumReleaseAgeStrict?: boolean;
+    /**
+     * Whether `minimumReleaseAge` skips the age check for registries lacking
+     * timestamp metadata. Introduced in pnpm 11.0.
+     *
+     * @see https://pnpm.io/settings#minimumreleaseageignoremissingtime
+     */
+    minimumReleaseAgeIgnoreMissingTime?: boolean;
     constructor(project: Project, options?: PnpmWorkspaceOptions);
 }
 /**
@@ -10330,9 +10467,22 @@ interface StarlightEditLink {
     readonly baseUrl: string;
 }
 /**
- * Sidebar item accepted by Starlight's `sidebar` config. Covers the four
- * common shapes: link, group with nested items, autogenerated group, and
- * internal slug reference.
+ * Sidebar item accepted by Starlight's `sidebar` config.
+ *
+ * Covers the shapes Starlight 0.39+ accepts:
+ * - link (`{ label, link, badge? }`)
+ * - group with nested items (`{ label, collapsed?, items }`)
+ * - bare autogenerated entry, nested inside a group's `items` array
+ *   (`{ autogenerate: { directory, collapsed? } }`)
+ * - internal slug reference (`{ label, slug }`)
+ *
+ * Plus one legacy shape kept for one deprecation cycle:
+ * - top-level autogenerated group (`{ label, collapsed?, autogenerate }`).
+ *   Starlight v0.39.0 removed runtime support for this shape; the
+ *   `StarlightProject` emitter translates it to the nested form
+ *   `{ label, collapsed?, items: [{ autogenerate }] }` before writing
+ *   `astro.config.mjs`. Migrate to the nested form directly — this
+ *   variant will be removed in a future release.
  */
 type StarlightSidebarItem = {
     readonly label: string;
@@ -10346,6 +10496,12 @@ type StarlightSidebarItem = {
     readonly collapsed?: boolean;
     readonly items: ReadonlyArray<StarlightSidebarItem>;
 } | {
+    readonly autogenerate: {
+        readonly directory: string;
+        readonly collapsed?: boolean;
+    };
+} | {
+    /** @deprecated Use `{ label, items: [{ autogenerate }] }` instead. Translated by the emitter for one cycle. */
     readonly label: string;
     readonly collapsed?: boolean;
     readonly autogenerate: {

package/lib/index.js

@@ -16934,6 +16934,13 @@ var PnpmWorkspace = class _PnpmWorkspace extends import_projen.Component {
     this.subprojects = options.subprojects ?? [];
     this.defaultCatalog = options.defaultCatalog;
     this.namedCatalogs = options.namedCatalogs;
+    this.confirmModulesPurge = options.confirmModulesPurge;
+    this.strictDepBuilds = options.strictDepBuilds;
+    this.verifyDepsBeforeRun = options.verifyDepsBeforeRun;
+    this.catalogMode = options.catalogMode;
+    this.cleanupUnusedCatalogs = options.cleanupUnusedCatalogs;
+    this.minimumReleaseAgeStrict = options.minimumReleaseAgeStrict;
+    this.minimumReleaseAgeIgnoreMissingTime = options.minimumReleaseAgeIgnoreMissingTime;
     project.addPackageIgnore(this.fileName);
     new import_projen.YamlFile(this.project, this.fileName, {
       obj: () => {
@@ -16990,6 +16997,27 @@ var PnpmWorkspace = class _PnpmWorkspace extends import_projen.Component {
         if (this.namedCatalogs && Object.keys(this.namedCatalogs).length > 0) {
           pnpmConfig.namedCatalogs = this.namedCatalogs;
         }
+        if (this.confirmModulesPurge !== void 0) {
+          pnpmConfig.confirmModulesPurge = this.confirmModulesPurge;
+        }
+        if (this.strictDepBuilds !== void 0) {
+          pnpmConfig.strictDepBuilds = this.strictDepBuilds;
+        }
+        if (this.verifyDepsBeforeRun !== void 0) {
+          pnpmConfig.verifyDepsBeforeRun = this.verifyDepsBeforeRun;
+        }
+        if (this.catalogMode !== void 0) {
+          pnpmConfig.catalogMode = this.catalogMode;
+        }
+        if (this.cleanupUnusedCatalogs !== void 0) {
+          pnpmConfig.cleanupUnusedCatalogs = this.cleanupUnusedCatalogs;
+        }
+        if (this.minimumReleaseAgeStrict !== void 0) {
+          pnpmConfig.minimumReleaseAgeStrict = this.minimumReleaseAgeStrict;
+        }
+        if (this.minimumReleaseAgeIgnoreMissingTime !== void 0) {
+          pnpmConfig.minimumReleaseAgeIgnoreMissingTime = this.minimumReleaseAgeIgnoreMissingTime;
+        }
         return {
           ...packages.length > 0 ? { packages } : {},
           ...pnpmConfig ? { ...pnpmConfig } : {}
@@ -35662,7 +35690,7 @@ function buildStarlightConfig(options) {
     config.social = options.social;
   }
   if (options.sidebar !== void 0) {
-    config.sidebar = options.sidebar;
+    config.sidebar = options.sidebar.map(translateSidebarItem);
   }
   if (options.customCss !== void 0) {
     config.customCss = options.customCss;
@@ -35675,6 +35703,31 @@ function buildStarlightConfig(options) {
   }
   return config;
 }
+function translateSidebarItem(item) {
+  if (item === null || typeof item !== "object") {
+    return item;
+  }
+  const record = item;
+  if (typeof record.label === "string" && record.autogenerate !== void 0 && record.items === void 0) {
+    const translated = {
+      label: record.label,
+      items: [{ autogenerate: record.autogenerate }]
+    };
+    if (record.collapsed !== void 0) {
+      translated.collapsed = record.collapsed;
+    }
+    return translated;
+  }
+  if (Array.isArray(record.items)) {
+    return {
+      ...record,
+      items: record.items.map(
+        translateSidebarItem
+      )
+    };
+  }
+  return item;
+}
 var DEFAULT_INDEX_MDX = `---
 title: Welcome
 description: Starlight-powered documentation site.