@dbx-tools/projen 0.6.210 → 0.6.212

package/src/release.ts

@@ -276,13 +276,23 @@ function addDocsJobs(
         uses: "actions/setup-node@v6",
         with: { "node-version": "22" },
       },
+      {
+        name: "Setup Python",
+        uses: "actions/setup-python@v6",
+        with: { "python-version": "3.11" },
+      },
+      { name: "Setup Rust", uses: "dtolnay/rust-toolchain@stable" },
       { name: "Configure Pages", uses: "actions/configure-pages@v5" },
       { name: "Install dependencies", run: "bun install" },
+      {
+        name: "Validate public source documentation",
+        run: "bun docs/scripts/check-source-docs.mjs",
+      },
       { name: "Generate docs from READMEs", run: "bun docs/scripts/sync-readmes.mjs" },
       { name: "Install docs dependencies", run: "bun install --cwd .docs-build/site" },
       bunCacheSaveStep(),
       {
-        name: "Generate TypeScript API docs",
+        name: "Generate API docs",
         run: "bun docs/scripts/generate-api-docs.mjs",
       },
       {

package/src/tags.ts

@@ -64,8 +64,13 @@ export const PACKAGE_TAG_MIXINS = {
   // compile (typecheck). No app build / index.html: a full browser app is an
   // `app`-tagged package (see below) that layers Bun's build tooling on top.
   ui: create(projectPredicate.hasTag("ui"), (p) => {
-    p.addDeps("react@catalog:", "react-dom@catalog:");
-    p.addDevDeps("@types/react@catalog:", "@types/react-dom@catalog:");
+    p.addPeerDeps("react@catalog:", "react-dom@catalog:");
+    p.addDevDeps(
+      "react@catalog:",
+      "react-dom@catalog:",
+      "@types/react@catalog:",
+      "@types/react-dom@catalog:",
+    );
     // `jsx` is not set here: it is in the shared floor for EVERY package, because
     // packages resolve each other to source and so every consumer of a `.tsx`
     // module needs it too (see SHARED_COMPILER_OPTIONS). What this tag adds is the

package/tasks/bump.ts

@@ -6,44 +6,27 @@
  */
 import { exec, project } from "@dbx-tools/core";
 import { log } from "@dbx-tools/shared-core";
-import { Command, Option } from "commander";
-import { releasePlatformFilter } from "../src/_release-platform.ts";
+import { Command } from "commander";
 import {
+  releaseArchitectureOption,
+  releaseLevelOption,
+  releaseOperatingSystemOption,
+  releasePlatformFilter,
+  type ReleaseArch,
+  type ReleaseOs,
   type VersionLevel,
-  resolveNextVersion,
-  writeWorkspaceVersion,
-} from "../src/workspace-version.ts";
+} from "../src/_release-platform.ts";
+import { resolveNextVersion, writeWorkspaceVersion } from "../src/workspace-version.ts";
 
 const logger = log.logger("projen:bump");
-const LEVELS = ["patch", "minor", "major"] as const;
-const RELEASE_OSES = ["darwin", "linux", "win32"] as const;
-const RELEASE_ARCHES = ["arm64", "x64"] as const;
-type ReleaseOs = (typeof RELEASE_OSES)[number];
-type ReleaseArch = (typeof RELEASE_ARCHES)[number];
-
-function collectValue<T extends string>(value: T, previous: T[]): T[] {
-  return [...previous, value];
-}
 
 const program = new Command();
 program
   .description("Increment VERSION and synchronize generated workspace versions")
-  .addOption(
-    new Option("-l, --level <level>", "semver increment").choices([...LEVELS]).default("patch"),
-  )
+  .addOption(releaseLevelOption())
   .option("--prefix <prefix>", "git tag prefix used to resolve the published base", "v")
-  .addOption(
-    new Option("--os <os>", "release operating system, repeatable; crossed with every --arch")
-      .choices([...RELEASE_OSES])
-      .argParser((value, previous: ReleaseOs[]) => collectValue(value as ReleaseOs, previous))
-      .default([] as ReleaseOs[]),
-  )
-  .addOption(
-    new Option("--arch <arch>", "release CPU architecture, repeatable; crossed with every --os")
-      .choices([...RELEASE_ARCHES])
-      .argParser((value, previous: ReleaseArch[]) => collectValue(value as ReleaseArch, previous))
-      .default([] as ReleaseArch[]),
-  )
+  .addOption(releaseOperatingSystemOption())
+  .addOption(releaseArchitectureOption())
   .option("--no-synth", "write VERSION without synchronizing generated files")
   .action(
     (opts: {

package/tasks/release-pr.ts

@@ -12,24 +12,19 @@ import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { exec, project } from "@dbx-tools/core";
 import { log } from "@dbx-tools/shared-core";
-import { Command, Option } from "commander";
-import { publishLocalRelease } from "./local-publish.ts";
+import { Command } from "commander";
 import {
+  releaseArchitectureOption,
+  releaseLevelOption,
+  releaseOperatingSystemOption,
+  type ReleaseArch,
+  type ReleaseOs,
   type VersionLevel,
-  readWorkspaceVersion,
-  resolveNextVersion,
-} from "../src/workspace-version.ts";
+} from "../src/_release-platform.ts";
+import { publishLocalRelease } from "./local-publish.ts";
+import { readWorkspaceVersion, resolveNextVersion } from "../src/workspace-version.ts";
 
 const logger = log.logger("projen:release");
-const LEVELS = ["patch", "minor", "major"] as const;
-const RELEASE_OSES = ["darwin", "linux", "win32"] as const;
-const RELEASE_ARCHES = ["arm64", "x64"] as const;
-type ReleaseOs = (typeof RELEASE_OSES)[number];
-type ReleaseArch = (typeof RELEASE_ARCHES)[number];
-
-function collectValue<T extends string>(value: T, previous: T[]): T[] {
-  return [...previous, value];
-}
 
 function git(
   root: string,
@@ -126,24 +121,12 @@ function githubAccount(root: string): { owner: string; repository: string; token
 const program = new Command();
 program
   .description("Prepare, validate, locally publish, and open a reviewed release PR")
-  .addOption(
-    new Option("-l, --level <level>", "semver increment").choices([...LEVELS]).default("patch"),
-  )
+  .addOption(releaseLevelOption())
   .option("--prefix <prefix>", "release tag prefix", "v")
   .option("--base <branch>", "release pull request base branch", "main")
   .option("--message <message>", "commit message for pending source work", "chore: prepare release")
-  .addOption(
-    new Option("--os <os>", "release operating system, repeatable; crossed with every --arch")
-      .choices([...RELEASE_OSES])
-      .argParser((value, previous: ReleaseOs[]) => collectValue(value as ReleaseOs, previous))
-      .default([] as ReleaseOs[]),
-  )
-  .addOption(
-    new Option("--arch <arch>", "release CPU architecture, repeatable; crossed with every --os")
-      .choices([...RELEASE_ARCHES])
-      .argParser((value, previous: ReleaseArch[]) => collectValue(value as ReleaseArch, previous))
-      .default([] as ReleaseArch[]),
-  )
+  .addOption(releaseOperatingSystemOption())
+  .addOption(releaseArchitectureOption())
   .option("--local-registry <value>", "local npm registry: auto, false, or an explicit URL", "auto")
   .option("--local-pypi <value>", "local PyPI index: auto, false, or an explicit URL", "auto")
   .option("--python-root <path>", "Python workspace package root", "packages/py")