pob 29.9.0 → 31.0.1

package/CHANGELOG.md

@@ -3,6 +3,67 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [31.0.1](https://github.com/christophehurpeau/pob/compare/pob@31.0.0...pob@31.0.1) (2025-12-06)
+
+### Bug Fixes
+
+* update all workflows
+* update workflow-release ejs
+
+Version bump for dependency: @pob/root
+
+
+## [31.0.0](https://github.com/christophehurpeau/pob/compare/pob@30.0.0...pob@31.0.0) (2025-12-06)
+
+### ⚠ BREAKING CHANGES
+
+* migrate pob-version to @pob/version and add initial bun support
+
+### Features
+
+* add bunfig.toml with minimumReleaseAge
+* add npmMinimalAgeGate in yarn config
+* add npmMinimumReleaseAgeExclude option to CoreYarnGenerator
+* add quoteArg utility function and update script paths in generators
+* migrate pob-version to @pob/version and add initial bun support
+* try to implement publish with bun
+* update npmPreapprovedPackages in CoreYarnGenerator
+
+### Bug Fixes
+
+* simplify script path handling in CommonLintGenerator and CommonTestingGenerator
+
+Version bump for dependency: @pob/sort-object
+Version bump for dependency: @pob/sort-pkg
+Version bump for dependency: @pob/root
+
+
+## [30.0.0](https://github.com/christophehurpeau/pob/compare/pob@29.9.0...pob@30.0.0) (2025-11-24)
+
+### ⚠ BREAKING CHANGES
+
+* migrate createLintStagedConfig to ES module and remove CommonJS version
+* drop swc with jest support
+
+### Features
+
+* add ci permissions
+* drop swc with jest support
+* implement package dependency descriptor utilities and workspace management to replace yarn packages and better support bun
+* migrate createLintStagedConfig to ES module and remove CommonJS version
+* update templates for bun v2
+* update yarn to 4.12.0
+
+### Bug Fixes
+
+* add rollup-plugin-copy to the list of removed dependencies
+* **deps:** update js-yaml to version 4.1.1
+* move /.yarnrc.yml to yarn section
+* update E2E testing paths to handle boolean and string values correctly
+
+Version bump for dependency: @pob/root
+
+
 ## [29.9.0](https://github.com/christophehurpeau/pob/compare/pob@29.8.0...pob@29.9.0) (2025-11-18)
 
 ### Features

package/lib/generators/common/format-lint/CommonLintGenerator.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import Generator from "yeoman-generator";
+import { quoteArg } from "../../../utils/execUtils.js";
 import inMonorepo from "../../../utils/inMonorepo.js";
 import * as packageUtils from "../../../utils/package.js";
 import { copyAndFormatTpl } from "../../../utils/writeAndFormat.js";
@@ -522,9 +523,7 @@ export default class CommonFormatLintGenerator extends Generator {
 
       packageUtils.addScripts(pkg, {
         "lint:eslint": globalEslint
-          ? `yarn ../.. run eslint ${args} ${path
-              .relative("../..", ".")
-              .replace("\\", "/")}`
+          ? `yarn ../.. run eslint ${args} ${quoteArg(path.relative("../..", "."))}`
           : `eslint ${args} .`,
         lint: `${
           useTypescript && !composite ? "tsc && " : ""

package/lib/generators/common/format-lint/templates/prettierignore.ejs

@@ -1,9 +1,9 @@
 CHANGELOG.md
-/.yarnrc.yml
 <% if (documentation) { -%>
 /docs
 <% } -%>
 <% if (packageManager === 'yarn' && inRoot) { -%>
+/.yarnrc.yml
 /.yarn/**/*
 <% if (yarnNodeLinker === 'pnp') { -%>
 /.pnp.*

package/lib/generators/common/husky/CommonHuskyGenerator.js

@@ -69,17 +69,14 @@ export default class CommonHuskyGenerator extends Generator {
         //   '@commitlint/config-lerna-scopes': '6.1.3',
         // });
 
-        if (pkg.type !== "module") {
-          this.fs.copy(
-            this.templatePath("lint-staged.config.cjs.txt"),
-            this.destinationPath("lint-staged.config.js"),
-          );
-        } else {
-          this.fs.copy(
-            this.templatePath("lint-staged.config.js.txt"),
-            this.destinationPath("lint-staged.config.js"),
-          );
-        }
+        this.fs.copy(
+          this.templatePath("lint-staged.config.js.txt"),
+          this.destinationPath(
+            pkg.type !== "module"
+              ? "lint-staged.config.mjs"
+              : "lint-staged.config.js",
+          ),
+        );
       }
 
       pkg.commitlint = {

package/lib/generators/common/old-dependencies/CommonRemoveOldDependenciesGenerator.js

@@ -48,6 +48,7 @@ export default class CommonRemoveOldDependenciesGenerator extends Generator {
       "pob-release",
       "eslint-plugin-typescript",
       "xunit-file",
+      "rollup-plugin-copy",
     ]);
 
     this.fs.writeJSON(this.destinationPath("package.json"), pkg);

package/lib/generators/common/release/CommonReleaseGenerator.js

@@ -69,16 +69,11 @@ export default class CommonReleaseGenerator extends Generator {
     const pkg = this.fs.readJSON(this.destinationPath("package.json"));
 
     if (this.options.enable && this.options.ci) {
-      const useLegacyName = this.fs.exists(
-        this.destinationPath(".github/workflows/publish.yml"),
-      );
-
-      const name = useLegacyName ? "publish.yml" : "release.yml";
+      this.fs.delete(this.destinationPath(".github/workflows/publish.yml"));
 
-      // TODO rename release (release = version + publish)
       this.fs.copyTpl(
         this.templatePath("workflow-release.yml.ejs"),
-        this.destinationPath(`.github/workflows/${name}`),
+        this.destinationPath(".github/workflows/release.yml"),
         {
           packageManager: this.options.packageManager,
           enablePublish: this.options.enablePublish,

package/lib/generators/common/release/templates/workflow-release.yml.ejs

@@ -24,19 +24,29 @@ on:
         default: "major"
 <% } -%>
 
+permissions:
+  id-token: write # Required for OIDC
+  contents: write
+
 jobs:
   release:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
         with:
-          token: ${{ secrets.GH_TOKEN }}
+          ssh-key: ${{ secrets.PUSH_DEPLOY_KEY }}
           fetch-depth: 0
           fetch-tags: true
 <% if (packageManager === 'yarn') { -%>
 
       - name: Enable Corepack
         run: corepack enable
+<% } else if (packageManager === 'bun') { -%>
+
+      - name: Install bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
 <% } -%>
 
       - uses: actions/setup-node@v6
@@ -61,16 +71,13 @@ jobs:
         run: yarn install --immutable --immutable-cache
 <% } -%>
 <% } else if (packageManager === 'bun') { -%>
-      - name: Install bun
-        uses: oven-sh/setup-bun@v1
-
       - name: Install Dependencies
         run: bun install --frozen-lockfile
 <% } -%>
 
       - name: New version (dry run)
         if: github.ref == 'refs/heads/main' && inputs.dry-run
-        run: yarn yarn-version version --dry-run<% if (isMonorepo && isMonorepoIndependent) { %> --bump-dependents-highest-as=${{ inputs.bump-dependents-highest-as }}<% } %>
+        run: <%= packageManager %> run pob-version --dry-run<% if (isMonorepo && isMonorepoIndependent) { %> --bump-dependents-highest-as=${{ inputs.bump-dependents-highest-as }}<% } %>
 
       - name: Configure Git user
         if: github.ref == 'refs/heads/main' && !inputs.dry-run
@@ -81,27 +88,27 @@ jobs:
       - name: New version
         if: github.ref == 'refs/heads/main' && !inputs.dry-run
         run: |
-          yarn yarn-version version --create-release=github <% if (isMonorepo && isMonorepoIndependent) { %> --bump-dependents-highest-as=${{ inputs.bump-dependents-highest-as }}<% } %> -m 'chore: release <%- isMonorepoIndependent ? '' : '%v ' %>[skip ci]<%- isMonorepoIndependent ? '\\n\\n%t' : '' %>'
+          <%= packageManager %> run pob-version <% if (enablePublish && packageManager === "bun") { %>--publish <% } %>--create-release=github <% if (isMonorepo && isMonorepoIndependent) { %> --bump-dependents-highest-as=${{ inputs.bump-dependents-highest-as }}<% } %> -m 'chore: release <%- isMonorepoIndependent ? '' : '%v ' %>[skip ci]<%- isMonorepoIndependent ? '\\n\\n%t' : '' %>'
         env:
           HUSKY: 0
-          GH_TOKEN: ${{ secrets.GH_TOKEN }}
           YARN_ENABLE_IMMUTABLE_INSTALLS: false
-<% if (enablePublish) { -%>
+          GH_TOKEN: {{ secrets.GITHUB_TOKEN }}
+<% if (enablePublish && packageManager === "yarn") { -%>
 
       - name: Publish to npm
+        if: github.ref == 'refs/heads/main' && !inputs.dry-run
         run: |
-          if [ -z "$NODE_AUTH_TOKEN" ]; then
-            echo "Missing env variable NODE_AUTH_TOKEN"
+          if [ -z "$NPM_AUTH_TOKEN" ]; then
+            echo "Missing env variable NPM_AUTH_TOKEN"
             exit 1
           fi
           echo >> ./.yarnrc.yml
-          echo "npmAuthToken: $NODE_AUTH_TOKEN" >> ./.yarnrc.yml
+          echo "npmAuthToken: $NPM_AUTH_TOKEN" >> ./.yarnrc.yml
 <% if (isMonorepo) { -%>
           yarn workspaces foreach --all --parallel --no-private npm publish --tolerate-republish
 <% } else { -%>
           yarn npm publish
 <% } -%>
-        if: github.ref == 'refs/heads/main' && !inputs.dry-run
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 <% } -%>

package/lib/generators/common/testing/CommonTestingGenerator.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import Generator from "yeoman-generator";
+import { quoteArg } from "../../../utils/execUtils.js";
 import inMonorepo from "../../../utils/inMonorepo.js";
 import * as packageUtils from "../../../utils/package.js";
 import {
@@ -103,13 +104,6 @@ export default class CommonTestingGenerator extends Generator {
       description:
         "Disable git cache. See https://yarnpkg.com/features/caching#offline-mirror.",
     });
-
-    this.option("swc", {
-      type: Boolean,
-      required: false,
-      default: false,
-      description: "Use swc to transpile code.",
-    });
   }
 
   default() {
@@ -179,17 +173,13 @@ export default class CommonTestingGenerator extends Generator {
     const tsTestUtil = (() => {
       if (testRunner === "vitest") return undefined;
       if (!withTypescript) return undefined;
-      if (this.options.swc || isJestRunner) return "swc";
+      if (isJestRunner && !transpileWithBabel && withTypescript) {
+        throw new Error("SWC is no longer supported. Migrate to vitest.");
+      }
       return "node";
     })();
 
-    const dependenciesForTestUtil = {
-      swc: {
-        devDependenciesShared: ["@swc/core"],
-        devDependenciesWithJest: ["@swc/jest"],
-        devDependenciesWithNode: ["@swc-node/register"],
-      },
-    };
+    const dependenciesForTestUtil = {};
 
     Object.entries(dependenciesForTestUtil).forEach(
       ([
@@ -257,9 +247,6 @@ export default class CommonTestingGenerator extends Generator {
       switch (tsTestUtil) {
         case "node":
           return "";
-        case "swc":
-          return "--import=@swc-node/register/esm";
-
         // no default
       }
     })();
@@ -447,23 +434,6 @@ export default class CommonTestingGenerator extends Generator {
               delete jestConfig.extensionsToTreatAsEsm;
             }
 
-            if (tsTestUtil === "swc" && !transpileWithBabel && withTypescript) {
-              jestConfig.transform = {
-                [hasReact ? "^.+\\.tsx?$" : "^.+\\.ts$"]: ["@swc/jest"],
-              };
-            } else if (jestConfig.transform) {
-              jestConfig.transform = Object.fromEntries(
-                Object.entries(jestConfig.transform).filter(
-                  ([key, value]) =>
-                    value !== "@swc/jest" &&
-                    !(Array.isArray(value) && value[0] === "@swc/jest"),
-                ),
-              );
-              if (Object.keys(jestConfig.transform).length === 0) {
-                delete jestConfig.transform;
-              }
-            }
-
             writeAndFormatJson(this.fs, jestConfigPath, jestConfig);
           }
         } else {
@@ -477,9 +447,7 @@ export default class CommonTestingGenerator extends Generator {
               delete pkg.scripts["test:coverage"];
             }
             packageUtils.addScripts(pkg, {
-              test: `yarn ../../ run test -- ${path
-                .relative("../..", ".")
-                .replace("\\", "/")}`,
+              test: `yarn ../../ run test -- ${quoteArg(path.relative("../..", "."))}`,
             });
           } else {
             const withTypescript =
@@ -554,42 +522,19 @@ export default class CommonTestingGenerator extends Generator {
                 };
               } else if (!transpileWithBabel && !withTypescript) {
                 delete jestConfig.transform;
-              } else {
-                if (
-                  tsTestUtil === "swc" &&
-                  !transpileWithBabel &&
-                  withTypescript
-                ) {
-                  jestConfig.transform = {
-                    [hasReact ? "^.+\\.tsx?$" : "^.+\\.ts$"]: ["@swc/jest"],
-                  };
-                } else if (jestConfig.transform) {
-                  jestConfig.transform = Object.fromEntries(
-                    Object.entries(jestConfig.transform).filter(
-                      ([key, value]) =>
-                        value !== "@swc/jest" &&
-                        !(Array.isArray(value) && value[0] === "@swc/jest"),
-                    ),
-                  );
-                  if (Object.keys(jestConfig.transform).length === 0) {
-                    delete jestConfig.transform;
-                  }
-                }
-
-                if (jestConfig.transform) {
-                  jestConfig.transform = Object.fromEntries(
-                    Object.entries(jestConfig.transform).filter(
-                      ([key, value]) =>
-                        !(
-                          value &&
-                          Array.isArray(value) &&
-                          value[0] === "jest-esbuild"
-                        ),
-                    ),
-                  );
-                  if (Object.keys(jestConfig.transform).length === 0) {
-                    delete jestConfig.transform;
-                  }
+              } else if (jestConfig.transform) {
+                jestConfig.transform = Object.fromEntries(
+                  Object.entries(jestConfig.transform).filter(
+                    ([key, value]) =>
+                      !(
+                        value &&
+                        Array.isArray(value) &&
+                        value[0] === "jest-esbuild"
+                      ),
+                  ),
+                );
+                if (Object.keys(jestConfig.transform).length === 0) {
+                  delete jestConfig.transform;
                 }
               }
 

package/lib/generators/core/bun/CoreBunGenerator.js

@@ -27,8 +27,14 @@ export default class CoreBunGenerator extends Generator {
     const pkg = this.fs.readJSON(this.destinationPath("package.json"));
 
     if (this.options.enable) {
+      this.fs.copyTpl(
+        this.templatePath("bunfig.toml.ejs"),
+        this.destinationPath("bunfig.toml"),
+        {},
+      );
     } else {
       this.fs.delete("bun.lock");
+      this.fs.delete("bunfig.toml");
     }
 
     this.fs.writeJSON(this.destinationPath("package.json"), pkg);

package/lib/generators/core/bun/templates/bunfig.toml.ejs

@@ -0,0 +1,3 @@
+[install]
+# Only install package versions published at least 3 days ago
+minimumReleaseAge = 259200 # seconds - in #23162 it'll allow "3d" too

package/lib/generators/core/ci/templates/github-action-documentation-workflow.yml.ejs

@@ -14,6 +14,12 @@ jobs:
       - name: Enable Corepack
         run: corepack enable
 
+<% } else if (packageManager === 'bun') { -%>
+      - name: Install bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
 <% } -%>
       - uses: actions/setup-node@v6
         with:
@@ -28,9 +34,6 @@ jobs:
         run: yarn install --immutable --immutable-cache
 <% } -%>
 <% } else if (packageManager === 'bun') { -%>
-      - name: Install bun
-        uses: oven-sh/setup-bun@v1
-
       - name: Install Dependencies
         run: bun install --frozen-lockfile
 <% } -%>

package/lib/generators/core/ci/templates/github-action-push-workflow-split.yml.ejs

@@ -1,5 +1,6 @@
 name: Push CI
-
+permissions:
+  contents: read
 on: [push]
 
 jobs:
@@ -113,6 +114,12 @@ jobs:
       - name: Enable Corepack
         run: corepack enable
 
+<% } else if (packageManager === 'bun') { -%>
+      - name: Install bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
 <% } -%>
       - uses: actions/setup-node@v6
         with:
@@ -127,9 +134,6 @@ jobs:
         run: yarn install --immutable --immutable-cache
 <% } -%>
 <% } else if (packageManager === 'bun') { -%>
-      - name: Install bun
-        uses: oven-sh/setup-bun@v1
-
       - name: Install Dependencies
         run: bun install --frozen-lockfile
 <% } -%>
@@ -185,7 +189,7 @@ jobs:
 <% } -%>
 
       - name: E2E testing
-        run: <%= packageManager %> <%= e2eTesting === '.' ? '.' : `./${e2eTesting}` %> run test:e2e
+        run: <%= packageManager %> <%= e2eTesting === '.' || e2eTesting === true ? '.' : `./${e2eTesting}` %> run test:e2e
 <% } -%>
 <% if (isReleasePleaseEnabled) { -%>
   release:

package/lib/generators/core/ci/templates/github-action-push-workflow.yml.ejs

@@ -1,5 +1,6 @@
 name: Push CI
-
+permissions:
+  contents: read
 on: [push]
 
 jobs:
@@ -17,6 +18,12 @@ jobs:
       - name: Enable Corepack
         run: corepack enable
 
+<% } else if (packageManager === 'bun') { -%>
+      - name: Install bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
 <% } -%>
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
@@ -36,9 +43,6 @@ jobs:
       - name: Install Dependencies
         run: npm ci
 <% } else if (packageManager === 'bun') { -%>
-      - name: Install bun
-        uses: oven-sh/setup-bun@v1
-
       - name: Install Dependencies
         run: bun install --frozen-lockfile
 <% } -%>

package/lib/generators/core/yarn/CoreYarnGenerator.js

@@ -142,9 +142,9 @@ export default class CoreYarnGenerator extends Generator {
       if (
         !pkg.packageManager ||
         !pkg.packageManager.startsWith("yarn@") ||
-        lt(pkg.packageManager.slice("yarn@".length), "4.10.3")
+        lt(pkg.packageManager.slice("yarn@".length), "4.12.0")
       ) {
-        pkg.packageManager = "yarn@4.10.3";
+        pkg.packageManager = "yarn@4.12.0";
       }
 
       // must be done after plugins installed
@@ -159,7 +159,7 @@ export default class CoreYarnGenerator extends Generator {
         // leave default compressionLevel instead of this next line
         delete config.compressionLevel;
         // config.compressionLevel = "mixed"; // optimized for size
-        config.enableGlobalCache = "true";
+        config.enableGlobalCache = true;
         delete config.supportedArchitectures;
       } else {
         config.compressionLevel = 0; // optimized for github config
@@ -175,6 +175,14 @@ export default class CoreYarnGenerator extends Generator {
       config.defaultSemverRangePrefix = this.options.type === "app" ? "" : "^";
       delete config.enableMessageNames; // was a config for yarn < 4
       config.nodeLinker = this.options.yarnNodeLinker;
+      config.npmMinimalAgeGate = 1440 * 3; // 3 days
+      config.npmPreapprovedPackages = [
+        "@pob/*",
+        "alouette",
+        "alouette-icons",
+        "nightingale",
+        "nightingale-logger",
+      ];
 
       if (config.yarnPath) {
         this.fs.delete(config.yarnPath);

package/lib/generators/monorepo/PobMonorepoGenerator.js

@@ -1,31 +1,16 @@
 import { execSync } from "node:child_process";
 import fs from "node:fs";
 import { platform } from "node:process";
-import { getPluginConfiguration } from "@yarnpkg/cli";
-import { Configuration, Project } from "@yarnpkg/core";
-import { ppath } from "@yarnpkg/fslib";
+import Generator from "yeoman-generator";
+import * as packageUtils from "../../utils/package.js";
 import {
   buildDependenciesMaps,
   buildTopologicalOrderBatches,
+  discoverWorkspaces,
   getWorkspaceName,
-} from "yarn-workspace-utils";
-import Generator from "yeoman-generator";
-import * as packageUtils from "../../utils/package.js";
+} from "../../utils/workspaceUtils.js";
 import { copyAndFormatTpl } from "../../utils/writeAndFormat.js";
 
-export const createYarnProject = async () => {
-  const portablePath = ppath.cwd();
-
-  const configuration = await Configuration.find(
-    portablePath,
-    // eslint-disable-next-line unicorn/no-array-method-this-argument -- not an array
-    getPluginConfiguration(),
-  );
-  // eslint-disable-next-line unicorn/no-array-method-this-argument -- not an array
-  const { project } = await Project.find(configuration, portablePath);
-  return project;
-};
-
 const getAppTypes = (configs) => {
   const appConfigs = configs.filter(
     (config) => config && config.project && config.project.type === "app",
@@ -129,10 +114,10 @@ export default class PobMonorepoGenerator extends Generator {
   }
 
   async initializing() {
-    const yarnProject = await createYarnProject(this.destinationPath());
+    const workspaces = await discoverWorkspaces(this.destinationPath());
     const batches = buildTopologicalOrderBatches(
-      yarnProject,
-      buildDependenciesMaps(yarnProject),
+      workspaces,
+      buildDependenciesMaps(workspaces),
     );
 
     this.packages = [];
@@ -145,7 +130,7 @@ export default class PobMonorepoGenerator extends Generator {
       );
 
       batch.forEach((workspace) => {
-        if (workspace === yarnProject.topLevelWorkspace) {
+        if (workspace.isRoot) {
           return;
         }
         this.packages.push(workspace.manifest.raw);
@@ -268,8 +253,10 @@ export default class PobMonorepoGenerator extends Generator {
     });
 
     const rootIgnorePaths = [
-      this.pobLernaConfig.e2eTesting && "/playwright-report/",
-      this.pobLernaConfig.e2eTesting && "/test-results/",
+      this.pobLernaConfig.e2eTesting &&
+        `${this.pobLernaConfig.e2eTesting === "." || this.pobLernaConfig.e2eTesting === true ? "" : `/${this.pobLernaConfig.e2eTesting}`}/playwright-report/`,
+      this.pobLernaConfig.e2eTesting &&
+        `${this.pobLernaConfig.e2eTesting === "." || this.pobLernaConfig.e2eTesting === true ? "" : `/${this.pobLernaConfig.e2eTesting}`}/test-results/`,
     ].filter(Boolean);
 
     const gitignorePaths = [

package/lib/utils/execUtils.js

@@ -0,0 +1,3 @@
+export const quoteArg = (s) => {
+  return `'${s.replace(/'/g, "'\"'")}'`;
+};

package/lib/utils/packageDependencyDescriptorUtils.js

@@ -0,0 +1,52 @@
+// TODO use pm-utils when available
+
+export const PackageDescriptorNameUtils = {
+  parse: (value) => {
+    if (value.startsWith("@")) {
+      const [scope, name] = value.slice(1).split("/", 2);
+      return { scope, name };
+    }
+    return { name: value };
+  },
+  stringify: (descriptor) => {
+    return descriptor.scope === undefined
+      ? descriptor.name
+      : `@${descriptor.scope}/${descriptor.name}`;
+  },
+};
+
+export const PackageDependencyDescriptorUtils = {
+  make: (descriptor, selector) => {
+    return {
+      key: descriptor.key,
+      npmName: descriptor.npmName,
+      nameDescriptor: descriptor.nameDescriptor,
+      selector,
+    };
+  },
+  parse: (dependencyKey, dependencyValue) => {
+    const parseFromNpm = (v) => {
+      if (!v.startsWith("@")) return v.split("@", 2);
+      const [packageNameWithoutFirstChar, selector] = v.slice(1).split("@", 2);
+      return [`@${packageNameWithoutFirstChar}`, selector];
+    };
+    const [name, selector] = dependencyValue.startsWith("npm:")
+      ? parseFromNpm(dependencyValue.slice("npm:".length))
+      : [dependencyKey, dependencyValue];
+
+    return {
+      key: dependencyKey,
+      npmName: name,
+      nameDescriptor: PackageDescriptorNameUtils.parse(name),
+      selector,
+    };
+  },
+  stringify: (descriptor) => {
+    return [
+      descriptor.key,
+      descriptor.npmName !== descriptor.key
+        ? `npm:${descriptor.npmName}@${descriptor.selector}`
+        : descriptor.selector,
+    ];
+  },
+};

package/lib/utils/packageDependencyDescriptorUtils.ts.backup

@@ -0,0 +1,79 @@
+export interface PackageDescriptorName {
+  scope?: string;
+  name: string;
+}
+
+interface DescriptorUtils<Descriptor> {
+  parse: (value: string) => Descriptor;
+  stringify: (descriptor: Descriptor) => string;
+}
+
+export const PackageDescriptorNameUtils: DescriptorUtils<PackageDescriptorName> =
+  {
+    parse: (value) => {
+      if (value.startsWith("@")) {
+        const [scope, name] = value.slice(1).split("/", 2);
+        return { scope, name };
+      }
+      return { name: value };
+    },
+    stringify: (descriptor) => {
+      return descriptor.scope === undefined
+        ? descriptor.name
+        : `@${descriptor.scope}/${descriptor.name}`;
+    },
+  };
+
+export interface PackageDependencyDescriptor {
+  key: string;
+  npmName: string;
+  nameDescriptor: PackageDescriptorName;
+  selector: string; // can be npm tag or version or version range or git url or local folder path
+}
+
+interface PackageDependencyDescriptorUtils<
+  Descriptor = PackageDependencyDescriptor,
+> {
+  make: (descriptor: Descriptor, selector: string) => Descriptor;
+  parse: (dependencyKey: string, dependencyValue: string) => Descriptor;
+  stringify: (descriptor: Descriptor) => [key: string, value: string];
+}
+
+export const PackageDependencyDescriptorUtils: PackageDependencyDescriptorUtils =
+  {
+    make: (descriptor, selector) => {
+      return {
+        key: descriptor.key,
+        npmName: descriptor.npmName,
+        nameDescriptor: descriptor.nameDescriptor,
+        selector,
+      };
+    },
+    parse: (dependencyKey, dependencyValue) => {
+      const [name, selector] = dependencyValue.startsWith("npm:")
+        ? (() => {
+            const v = dependencyValue.slice("npm:".length);
+            if (!v.startsWith("@")) return v.split("@", 2);
+            const [packageNameWithoutFirstChar, selector] = v
+              .slice(1)
+              .split("@", 2);
+            return [`@${packageNameWithoutFirstChar}`, selector];
+          })()
+        : [dependencyKey, dependencyValue];
+
+      return {
+        key: dependencyKey,
+        npmName: name,
+        nameDescriptor: PackageDescriptorNameUtils.parse(name),
+        selector,
+      };
+    },
+    stringify: (descriptor) => {
+      return [
+        descriptor.key,
+        descriptor.npmName !== descriptor.key
+          ? `npm:${descriptor.npmName}@${descriptor.selector}`
+          : descriptor.selector,
+      ];
+    },
+  };

package/lib/utils/workspaceUtils.js

@@ -0,0 +1,131 @@
+import fs from "node:fs";
+// eslint-disable-next-line n/no-unsupported-features/node-builtins
+import { glob } from "node:fs/promises";
+import path from "node:path";
+import { PackageDependencyDescriptorUtils } from "./packageDependencyDescriptorUtils.js";
+
+export const getWorkspaceName = (workspace) => {
+  if (workspace?.manifest?.raw?.name) return workspace.manifest.raw.name;
+  return path.basename(workspace.location) || "unnamed-workspace";
+};
+
+export const discoverWorkspaces = async (rootPath) => {
+  const rootPackageJSONPath = path.join(rootPath, "package.json");
+  const rootPkg = JSON.parse(fs.readFileSync(rootPackageJSONPath));
+
+  let workspaceGlobs = [];
+  if (Array.isArray(rootPkg.workspaces)) {
+    workspaceGlobs = rootPkg.workspaces;
+  } else if (typeof rootPkg.workspaces === "object") {
+    workspaceGlobs = (rootPkg.workspaces && rootPkg.workspaces.packages) || [];
+  }
+
+  const workspaces = [
+    {
+      name: rootPkg.name,
+      location: ".",
+      manifest: { raw: rootPkg },
+      relativeCwd: { toString: () => "." },
+      isRoot: true,
+    },
+  ];
+
+  const patternPackageJsons = workspaceGlobs.map((g) =>
+    path.join(g, "package.json"),
+  );
+  const found = new Set();
+  for (const pattern of patternPackageJsons) {
+    for await (const match of glob(pattern, { cwd: rootPath, nodir: true })) {
+      if (found.has(match)) continue;
+      found.add(match);
+      const filePath = path.join(rootPath, match);
+      const content = JSON.parse(fs.readFileSync(filePath));
+      const dir = path.dirname(match);
+      workspaces.push({
+        name: content.name,
+        location: dir || ".",
+        manifest: { raw: content },
+        relativeCwd: { toString: () => dir || "." },
+      });
+    }
+  }
+
+  return workspaces;
+};
+
+export const buildDependenciesMaps = (workspaces) => {
+  const dependenciesMap = new Map();
+
+  const workspacesByName = new Map(
+    workspaces.filter((w) => !!w.name).map((w) => [w.name, w]),
+  );
+  const dependencyTypes = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+  ];
+
+  for (const dependent of workspaces) {
+    for (const set of dependencyTypes) {
+      const deps =
+        (dependent.manifest.raw && dependent.manifest.raw[set]) || {};
+      for (const [dependencyKey, dependencyValue] of Object.entries(deps)) {
+        if (!dependencyValue) continue;
+        const descriptor = PackageDependencyDescriptorUtils.parse(
+          dependencyKey,
+          String(dependencyValue),
+        );
+        const workspace = workspacesByName.get(descriptor.npmName);
+        if (!workspace) continue;
+
+        const entries = dependenciesMap.get(dependent) || [];
+        entries.push([workspace, set, descriptor]);
+        dependenciesMap.set(dependent, entries);
+      }
+    }
+  }
+
+  return dependenciesMap;
+};
+
+export const buildTopologicalOrderBatches = (workspaces, dependenciesMap) => {
+  const batches = [];
+  const added = new Set();
+  const toAdd = new Set(workspaces);
+
+  while (toAdd.size > 0) {
+    const batch = new Set();
+    for (const workspace of toAdd) {
+      if (workspace.isRoot && toAdd.size > 1) continue;
+      const dependencies = dependenciesMap.get(workspace);
+      if (!dependencies || dependencies.every((w) => added.has(w[0]))) {
+        batch.add(workspace);
+      }
+    }
+
+    for (const workspace of batch) {
+      added.add(workspace);
+      toAdd.delete(workspace);
+    }
+
+    if (batch.size === 0) {
+      throw new Error("Circular dependency detected");
+    }
+    batches.push([...batch]);
+  }
+
+  return batches;
+};
+
+export const buildDependentsMaps = (workspaces) => {
+  const dependentsMap = new Map();
+  const dependenciesMap = buildDependenciesMaps(workspaces);
+  for (const [dependent, relations] of dependenciesMap) {
+    for (const [workspace, set, descriptor] of relations) {
+      const cmd = dependentsMap.get(workspace) || [];
+      cmd.push([dependent, set, descriptor]);
+      dependentsMap.set(workspace, cmd);
+    }
+  }
+  return dependentsMap;
+};

package/lib/utils/workspaceUtils.test.js

@@ -0,0 +1,134 @@
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { describe, expect, it } from "vitest";
+import {
+  buildDependenciesMaps,
+  buildTopologicalOrderBatches,
+  discoverWorkspaces,
+} from "./workspaceUtils.js";
+
+async function prepareMonorepo(tmpDir) {
+  await fs.mkdir(path.join(tmpDir, "packages"), { recursive: true });
+  const rootPkg = {
+    name: "root",
+    workspaces: ["packages/*"],
+  };
+  await fs.writeFile(
+    path.join(tmpDir, "package.json"),
+    JSON.stringify(rootPkg, null, 2),
+  );
+
+  // package c
+  const cDir = path.join(tmpDir, "packages/c");
+  await fs.mkdir(cDir, { recursive: true });
+  await fs.writeFile(
+    path.join(cDir, "package.json"),
+    JSON.stringify({ name: "@ex/c" }, null, 2),
+  );
+
+  // package b depends on c
+  const bDir = path.join(tmpDir, "packages/b");
+  await fs.mkdir(bDir, { recursive: true });
+  await fs.writeFile(
+    path.join(bDir, "package.json"),
+    JSON.stringify(
+      { name: "@ex/b", dependencies: { "@ex/c": "1.0.0" } },
+      null,
+      2,
+    ),
+  );
+
+  // package a depends on b
+  const aDir = path.join(tmpDir, "packages/a");
+  await fs.mkdir(aDir, { recursive: true });
+  await fs.writeFile(
+    path.join(aDir, "package.json"),
+    JSON.stringify(
+      { name: "@ex/a", dependencies: { "@ex/b": "1.0.0" } },
+      null,
+      2,
+    ),
+  );
+
+  return tmpDir;
+}
+
+describe("workspaceUtils", () => {
+  it("should discover workspaces", async () => {
+    const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "pob-"));
+    await prepareMonorepo(tmp);
+    const workspaces = await discoverWorkspaces(tmp);
+    // root + a + b + c
+    expect(workspaces.length).toBeGreaterThanOrEqual(4);
+    const names = workspaces.map((w) => w.name).toSorted();
+    expect(names).toEqual(["@ex/a", "@ex/b", "@ex/c", "root"].toSorted());
+  });
+
+  it("should build dependencies maps and topological batches", async () => {
+    const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "pob-"));
+    await prepareMonorepo(tmp);
+    const workspaces = await discoverWorkspaces(tmp);
+    const dependenciesMap = buildDependenciesMaps(workspaces);
+    // find workspace by name
+    const byName = new Map(workspaces.map((w) => [w.name, w]));
+    const a = byName.get("@ex/a");
+    const b = byName.get("@ex/b");
+    // const c = byName.get("@ex/c");
+    expect(dependenciesMap.get(a)).toBeDefined();
+    expect(dependenciesMap.get(b)).toBeDefined();
+    // topological batches
+    const batches = buildTopologicalOrderBatches(workspaces, dependenciesMap);
+    // flatten names excluding root
+    const nonRoot = batches
+      .flat()
+      .filter((w) => !w.isRoot)
+      .map((w) => w.name);
+    // c should come before b which comes before a
+    expect(nonRoot.indexOf("@ex/c")).toBeLessThan(nonRoot.indexOf("@ex/b"));
+    expect(nonRoot.indexOf("@ex/b")).toBeLessThan(nonRoot.indexOf("@ex/a"));
+  });
+
+  it("throws on circular dependency", async () => {
+    const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "pob-"));
+    await fs.mkdir(path.join(tmp, "packages"), { recursive: true });
+    const rootPkg = {
+      name: "root",
+      workspaces: ["packages/*"],
+    };
+    await fs.writeFile(
+      path.join(tmp, "package.json"),
+      JSON.stringify(rootPkg, null, 2),
+    );
+
+    // package x depends on y
+    const xDir = path.join(tmp, "packages/x");
+    await fs.mkdir(xDir, { recursive: true });
+    await fs.writeFile(
+      path.join(xDir, "package.json"),
+      JSON.stringify(
+        { name: "@ex/x", dependencies: { "@ex/y": "1.0.0" } },
+        null,
+        2,
+      ),
+    );
+
+    // package y depends on x
+    const yDir = path.join(tmp, "packages/y");
+    await fs.mkdir(yDir, { recursive: true });
+    await fs.writeFile(
+      path.join(yDir, "package.json"),
+      JSON.stringify(
+        { name: "@ex/y", dependencies: { "@ex/x": "1.0.0" } },
+        null,
+        2,
+      ),
+    );
+
+    const workspaces = await discoverWorkspaces(tmp);
+    const dependenciesMap = buildDependenciesMaps(workspaces);
+    expect(() =>
+      buildTopologicalOrderBatches(workspaces, dependenciesMap),
+    ).toThrow();
+  });
+});

package/lib/utils/workspaceUtils.ts.backup

@@ -0,0 +1,167 @@
+import fs from "node:fs";
+// eslint-disable-next-line n/no-unsupported-features/node-builtins
+import { glob } from "node:fs/promises";
+import path from "node:path";
+import type { PackageJson } from "type-fest";
+import {
+  PackageDependencyDescriptorUtils,
+  PackageDescriptorNameUtils,
+} from "./packageDependencyDescriptorUtils";
+import type { PackageDependencyDescriptor } from "./packageDependencyDescriptorUtils.ts";
+
+export interface Workspace {
+  name?: string;
+  location: string;
+  manifest: { raw: PackageJson };
+  relativeCwd: { toString: () => string };
+  isRoot?: boolean;
+}
+
+export const getWorkspaceName = (workspace: Workspace): string => {
+  if (workspace?.manifest?.raw?.name) return workspace.manifest.raw.name;
+  return path.basename(workspace.location) || "unnamed-workspace";
+};
+
+export type DependencyType =
+  | "dependencies"
+  | "devDependencies"
+  | "peerDependencies";
+
+type WorkspacesDependenciesMap = Map<
+  Workspace,
+  [Workspace, DependencyType, PackageDependencyDescriptor][]
+>;
+
+export const discoverWorkspaces = async (
+  rootPath: string,
+): Promise<Workspace[]> => {
+  const rootPackageJSONPath = path.join(rootPath, "package.json");
+  const rootPkg: PackageJson = JSON.parse(fs.readFileSync(rootPackageJSONPath));
+
+  let workspaceGlobs: string[] = [];
+  if (Array.isArray((rootPkg as any).workspaces)) {
+    workspaceGlobs = (rootPkg as any).workspaces;
+  } else if (typeof (rootPkg as any).workspaces === "object") {
+    workspaceGlobs = (rootPkg as any).workspaces.packages || [];
+  }
+
+  // include root as workspace
+  const workspaces: Workspace[] = [
+    {
+      name: rootPkg.name,
+      location: ".",
+      manifest: { raw: rootPkg },
+      relativeCwd: { toString: () => "." },
+      isRoot: true,
+    } as Workspace,
+  ];
+
+  const patternPackageJsons = workspaceGlobs.map((globPattern) =>
+    path.join(globPattern, "package.json"),
+  );
+  const found = new Set<string>();
+  for (const pattern of patternPackageJsons) {
+    for await (const match of glob(pattern, { cwd: rootPath, nodir: true })) {
+      if (found.has(match)) continue;
+      found.add(match);
+      const filePath = path.join(rootPath, match);
+      const content = JSON.parse(fs.readFileSync(filePath));
+      const dir = path.dirname(match);
+      workspaces.push({
+        name: content.name,
+        location: dir || ".",
+        manifest: { raw: content },
+        relativeCwd: { toString: () => dir || "." },
+      });
+    }
+  }
+
+  return workspaces;
+};
+
+export const buildDependenciesMaps = (
+  workspaces: Workspace[],
+): WorkspacesDependenciesMap => {
+  const dependenciesMap: WorkspacesDependenciesMap = new Map();
+
+  const workspacesByName = new Map<string, Workspace>(
+    workspaces.filter((w) => !!w.name).map((w) => [w.name, w]),
+  );
+
+  const dependencyTypes: DependencyType[] = [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+  ];
+
+  for (const dependent of workspaces) {
+    for (const set of dependencyTypes) {
+      const deps = (dependent.manifest.raw as any)[set] || {};
+      for (const [dependencyKey, dependencyValue] of Object.entries(deps)) {
+        if (!dependencyValue) continue;
+        const descriptor = PackageDependencyDescriptorUtils.parse(
+          dependencyKey,
+          String(dependencyValue),
+        );
+        const workspace = workspacesByName.get(descriptor.npmName);
+        if (!workspace) continue;
+
+        const entries = dependenciesMap.get(dependent) || [];
+        entries.push([workspace, set, descriptor]);
+        dependenciesMap.set(dependent, entries);
+      }
+    }
+  }
+
+  return dependenciesMap;
+};
+
+export const buildTopologicalOrderBatches = (
+  workspaces: Workspace[],
+  dependenciesMap: WorkspacesDependenciesMap,
+): Workspace[][] => {
+  const batches: Workspace[][] = [];
+
+  const added = new Set<Workspace>();
+  const toAdd = new Set<Workspace>(workspaces);
+
+  while (toAdd.size > 0) {
+    const batch = new Set<Workspace>();
+    for (const workspace of toAdd) {
+      // skip root workspace until the end when there are others
+      if (workspace.isRoot && toAdd.size > 1) continue;
+
+      const dependencies = dependenciesMap.get(workspace);
+      if (!dependencies || dependencies.every((w) => added.has(w[0]))) {
+        batch.add(workspace);
+      }
+    }
+
+    for (const workspace of batch) {
+      added.add(workspace);
+      toAdd.delete(workspace);
+    }
+
+    if (batch.size === 0) {
+      throw new Error("Circular dependency detected");
+    }
+    batches.push([...batch]);
+  }
+
+  return batches;
+};
+
+export const buildDependentsMaps = (
+  workspaces: Workspace[],
+): WorkspacesDependenciesMap => {
+  const dependentsMap: WorkspacesDependenciesMap = new Map();
+  const dependenciesMap = buildDependenciesMaps(workspaces);
+  for (const [dependent, relations] of dependenciesMap) {
+    for (const [workspace, set, descriptor] of relations) {
+      const cmd = dependentsMap.get(workspace) || [];
+      cmd.push([dependent, set, descriptor]);
+      dependentsMap.set(workspace, cmd);
+    }
+  }
+  return dependentsMap;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pob",
-  "version": "29.9.0",
+  "version": "31.0.1",
   "description": "Pile of bones, library generator with git/babel/typescript/typedoc/readme/jest",
   "keywords": [
     "skeleton"
@@ -36,7 +36,7 @@
     "build:definitions": "tsc -p tsconfig.json",
     "format": "prettier --write",
     "lint": "yarn run lint:eslint",
-    "lint:eslint": "yarn ../.. run eslint --quiet packages/pob"
+    "lint:eslint": "yarn ../.. run eslint --quiet 'packages/pob'"
   },
   "pob": {
     "typescript": "check-only"
@@ -46,20 +46,17 @@
     "@pob/eslint-config": "62.0.0",
     "@pob/eslint-config-typescript": "62.0.0",
     "@pob/eslint-config-typescript-react": "62.0.0",
-    "@pob/sort-object": "10.1.0",
-    "@pob/sort-pkg": "12.1.0",
+    "@pob/sort-object": "10.1.1",
+    "@pob/sort-pkg": "12.1.1",
     "@prettier/sync": "0.6.1",
     "@types/inquirer": "9.0.9",
-    "@yarnpkg/cli": "4.11.0",
-    "@yarnpkg/core": "4.5.0",
-    "@yarnpkg/fslib": "3.1.4",
     "@yeoman/adapter": "3.1.0",
     "@yeoman/types": "1.8.0",
     "eslint": "9.39.1",
     "findup-sync": "^5.0.0",
     "git-remote-url": "^1.0.1",
     "github-username": "^9.0.0",
-    "js-yaml": "^4.1.0",
+    "js-yaml": "^4.1.1",
     "json5": "^2.2.3",
     "lodash.camelcase": "^4.3.0",
     "lodash.kebabcase": "^4.1.1",
@@ -67,17 +64,16 @@
     "mem-fs-editor": "11.1.4",
     "minimist": "1.2.8",
     "parse-author": "2.0.0",
-    "pob-dependencies": "20.6.0",
+    "pob-dependencies": "21.0.1",
     "prettier": "3.6.2",
     "semver": "7.7.3",
     "typescript": "5.9.3",
     "validate-npm-package-name": "^6.0.2",
-    "yarn-workspace-utils": "9.5.0",
     "yeoman-environment": "5.0.0",
     "yeoman-generator": "7.5.1"
   },
   "devDependencies": {
-    "@pob/root": "19.8.0",
+    "@pob/root": "20.0.2",
     "@types/node": "22.19.1"
   }
 }

package/lib/generators/common/husky/templates/lint-staged.config.cjs.txt

@@ -1,5 +0,0 @@
-"use strict";
-
-const createLintStagedConfig = require("@pob/root/createLintStagedConfig.cjs");
-
-module.exports = createLintStagedConfig();