pob 40.3.3 → 40.4.0

package/lib/generators/app/PobAppGenerator.js

@@ -1,9 +1,12 @@
 import { execSync } from "node:child_process";
 import { platform } from "node:process";
 import Generator from "yeoman-generator";
+import { detectAlouette } from "../../utils/alouette.js";
+import { appsWithBrowser } from "../../utils/appTsconfigTarget.js";
 import { removeFromGitIndex } from "../../utils/git.js";
 import inMonorepo from "../../utils/inMonorepo.js";
 import removeLegacyGeneratedDocs from "../../utils/legacyGeneratedDocs.js";
+import { nodeAppTypes } from "../../utils/nodeApps.js";
 import * as packageUtils from "../../utils/package.js";
 import { detectStorybookReactNative } from "../../utils/storybook.js";
 import { appIgnorePaths } from "./ignorePaths.js";
@@ -16,7 +19,6 @@ const appsWithTypescript = [
   "expo",
   "yarn-plugin",
 ];
-const appsWithBrowser = ["alp", "next.js", "vite", "vite-with-server"];
 const shouldEnableHashSlash = (appType) =>
   appType === "alp" ||
   appType === "vite" ||
@@ -96,12 +98,15 @@ export default class PobAppGenerator extends Generator {
       delete config.ci;
     }
 
-    const storybookDefault = detectStorybookReactNative([
-      this.fs.readJSON(this.destinationPath("package.json"), {}),
-    ]);
+    const pkg = this.fs.readJSON(this.destinationPath("package.json"), {});
+    const storybookDefault = detectStorybookReactNative([pkg]);
     if (config?.type === "expo" && config.storybook === undefined) {
       config.storybook = storybookDefault;
     }
+    const alouetteDefault = detectAlouette(pkg);
+    if (config?.type === "expo" && config.alouette === undefined) {
+      config.alouette = alouetteDefault;
+    }
 
     if (config && this.options.updateOnly) {
       this.config.set("app", this.appConfig);
@@ -162,6 +167,13 @@ export default class PobAppGenerator extends Generator {
         default: config?.storybook ?? storybookDefault,
         when: (values) => values.type === "expo",
       },
+      {
+        type: "confirm",
+        name: "alouette",
+        message: "Do you use alouette ?",
+        default: config?.alouette ?? alouetteDefault,
+        when: (values) => values.type === "expo",
+      },
     ]);
 
     this.config.set("app", this.appConfig);
@@ -262,10 +274,12 @@ export default class PobAppGenerator extends Generator {
           inMonorepo.pobMonorepoConfig?.typescript === "check-only"),
       isApp: true,
       isAppLibrary,
+      appType: this.appConfig.type,
       nextConfig: this.appConfig.type === "next.js",
       // nextjs now supports src
       rootDir: this.appConfig.type === "expo" ? "." : srcDirectory,
       srcDirectory,
+      includeScripts: nodeAppTypes.includes(this.appConfig.type),
       builddefs: false,
       dom: browser,
       jsx,
@@ -277,6 +291,8 @@ export default class PobAppGenerator extends Generator {
       onlyLatestLTS: true,
       packageManager: this.options.packageManager,
       enableHashSlash,
+      // only asked for expo apps: the on-device react-native storybook
+      storybook: this.appConfig.storybook,
       plugins: (() => {
         if (this.appConfig.type === "next.js") {
           return "next";
@@ -363,6 +379,8 @@ export default class PobAppGenerator extends Generator {
       typescript,
       testing: this.appConfig.testing,
       testRunner: this.appConfig.testRunner,
+      // only asked for expo apps
+      tailwind: this.appConfig.alouette,
     });
 
     // only for gitignore
@@ -412,6 +430,8 @@ export default class PobAppGenerator extends Generator {
       this.fs.delete(this.destinationPath("next-env.d.ts"));
     }
 
+    if (this.options.check) return;
+
     if (platform !== "win32") {
       execSync(
         `rm -Rf ${["lib-*", "coverage", "generated-docs", "dist"].filter(Boolean).join(" ")}`,

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

@@ -281,6 +281,10 @@ export default class CommonFormatLintGenerator extends Generator {
       const rootIgnorePatterns = new Set(
         this.options.rootIgnorePaths.split("\n").filter(Boolean),
       );
+      if (this.options.storybookReactNative) {
+        // regenerated by metro on each start (sb-rn-get-stories)
+        rootIgnorePatterns.add("**/storybook.requires.ts");
+      }
       const ignorePatterns = new Set(
         this.options.ignorePaths.split("\n").filter(Boolean),
       );
@@ -508,7 +512,8 @@ export default class CommonFormatLintGenerator extends Generator {
       // tsconfig.json; point typed lint at that project. The monorepo root
       // owns the shared tsconfig.tools.json (its **/scripts/** glob covers
       // package scripts too), and single repos own their own; in-monorepo
-      // packages inherit the root config.
+      // packages inherit the root config. Node apps type-check them with
+      // their tsconfig.json instead, but still need the vitest resolution.
       if ((isMonorepoRoot || !inMonorepo) && useTypescript) {
         flatCascade.push("...pobConfig.configs.toolsProject");
       }
@@ -575,11 +580,12 @@ export default class CommonFormatLintGenerator extends Generator {
         }
 
         if (this.options.storybook) {
-          ignorePatterns.add("**/.storybook/");
           ignorePatterns.add("**/storybook-static/");
         }
         if (this.options.storybookReactNative) {
           ignorePatterns.add("**/.rnstorybook/");
+          // generated in .storybook/ by sb-rn-get-stories
+          ignorePatterns.add("**/storybook.requires.ts");
         }
 
         if (hasDesignSync(this)) {
@@ -753,6 +759,12 @@ export default class CommonFormatLintGenerator extends Generator {
    */
   async end() {
     if (!this.runOxlintOnlyCodemods) return;
+    if (this.options.check) {
+      console.log(
+        "@pob/eslint-config 68: eslint-disable comments of rules checked by oxlint would be rewritten",
+      );
+      return;
+    }
     const cwd = this.destinationPath();
     const files = execFileSync(
       "git",

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

@@ -16,7 +16,9 @@ export default class CommonHuskyGenerator extends Generator {
   }
 
   writing() {
-    rmSync("git-hooks", { recursive: true, force: true });
+    if (!this.options.check) {
+      rmSync("git-hooks", { recursive: true, force: true });
+    }
 
     const gitHookDestination = this.destinationPath(".git/hooks/pre-commit");
     let isSymlink;

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

@@ -523,8 +523,16 @@ export default class CommonTestingGenerator extends Generator {
       }
     }
 
-    // legacy jest babel config
-    this.fs.delete("babel.config.cjs");
+    // legacy jest babel config, only when generated by pob:
+    // apps (expo, react-native) can have their own, read by metro
+    const babelConfigPath = this.destinationPath("babel.config.cjs");
+    if (
+      this.fs
+        .read(babelConfigPath, { defaults: "" })
+        .includes("pob-babel/preset")
+    ) {
+      this.fs.delete(babelConfigPath);
+    }
 
     return writeAndFormatJson(
       this.fs,

package/lib/generators/common/transpiler/CommonTranspilerGenerator.js

@@ -127,15 +127,17 @@ export default class CommonTranspilerGenerator extends Generator {
     this.entries = pkg.pob.entries;
     this.babelEnvs = pkg.pob.babelEnvs || [];
 
-    if (
-      this.babelEnvs.length > 0 ||
-      pkg.pob.typescript === true ||
-      pkg.pob.bundler
-    ) {
-      fs.mkdirSync(this.destinationPath("src"), { recursive: true });
-    } else {
-      // recursive does not throw if directory already exists
-      fs.mkdirSync(this.destinationPath("lib"), { recursive: true });
+    if (!this.options.check) {
+      if (
+        this.babelEnvs.length > 0 ||
+        pkg.pob.typescript === true ||
+        pkg.pob.bundler
+      ) {
+        fs.mkdirSync(this.destinationPath("src"), { recursive: true });
+      } else {
+        // recursive does not throw if directory already exists
+        fs.mkdirSync(this.destinationPath("lib"), { recursive: true });
+      }
     }
   }
 

package/lib/generators/common/typescript/CommonTypescriptGenerator.js

@@ -1,5 +1,9 @@
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import Generator from "yeoman-generator";
+import {
+  getAppTsconfigTarget,
+  getConsumerAppsTsconfigTarget,
+} from "../../../utils/appTsconfigTarget.js";
 import inMonorepo from "../../../utils/inMonorepo.js";
 import { latestLTS, maintenanceLTS } from "../../../utils/nodeVersions.js";
 import * as packageUtils from "../../../utils/package.js";
@@ -27,6 +31,12 @@ export default class CommonTypescriptGenerator extends Generator {
       default: false,
     });
 
+    this.option("appType", {
+      type: String,
+      default: "",
+      description: "app type, when isApp",
+    });
+
     this.option("rootDir", {
       type: String,
       default: "src",
@@ -39,6 +49,13 @@ export default class CommonTypescriptGenerator extends Generator {
       description: "customize srcDirectory, if different than rootDir",
     });
 
+    this.option("includeScripts", {
+      type: Boolean,
+      default: false,
+      description:
+        "type-check scripts and root config files with tsconfig.json instead of tsconfig.tools.json (node apps)",
+    });
+
     this.option("jsx", {
       type: Boolean,
       default: true,
@@ -128,6 +145,13 @@ export default class CommonTypescriptGenerator extends Generator {
       default: false,
       description: "enable #/ in paths",
     });
+
+    this.option("storybook", {
+      type: Boolean,
+      required: false,
+      default: false,
+      description: "Type-check the storybook config in .storybook",
+    });
   }
 
   default() {
@@ -154,7 +178,22 @@ export default class CommonTypescriptGenerator extends Generator {
     const withNode = envs.some((env) => env.target === "node");
     const withBun = this.options.packageManager === "bun";
 
+    // untranspiled libraries are never built on their own: they are compiled
+    // by the bundler of the apps importing them
+    const consumerAppsTarget =
+      this.options.appType === "untranspiled-library" &&
+      inMonorepo &&
+      !inMonorepo.root
+        ? await getConsumerAppsTsconfigTarget({
+            rootPath: inMonorepo.rootPath,
+            packageName: pkg.name,
+            withBun,
+          })
+        : undefined;
+
     const presets = (() => {
+      if (consumerAppsTarget) return [consumerAppsTarget];
+
       const babelEnvs =
         pkg.pob?.babelEnvs ||
         (pkg.pob?.bundler === "rollup-babel" && pkg.pob.envs) ||
@@ -198,20 +237,12 @@ export default class CommonTypescriptGenerator extends Generator {
         return ["@pob/root/tsconfigs/targets/rollup-es2015.json"];
       }
 
-      if (this.options.isApp && pkg.dependencies?.expo) {
-        return ["@pob/root/tsconfigs/targets/expo.json"];
-      }
-
-      if (this.options.dom) {
-        if (this.options.isApp && pkg.devDependencies?.vite) {
-          return ["@pob/root/tsconfigs/targets/vite.json"];
-        }
-        return ["@pob/root/tsconfigs/targets/webpack.json"];
-      }
-      if (withBun) {
-        return ["@pob/root/tsconfigs/targets/bun.json"];
-      }
-      return [];
+      const target = getAppTsconfigTarget({
+        appType: this.options.isApp ? this.options.appType : undefined,
+        dom: this.options.dom,
+        withBun,
+      });
+      return target ? [target] : [];
     })();
 
     packageUtils.removeDevDependencies(pkg, ["flow-bin"]);
@@ -237,12 +268,18 @@ export default class CommonTypescriptGenerator extends Generator {
     const tsconfigBuildPath = this.destinationPath("tsconfig.build.json");
     const tsconfigToolsPath = this.destinationPath("tsconfig.tools.json");
 
+    // the check-js template only covers the src directory
+    const includeScripts =
+      this.options.includeScripts && !this.options.onlyCheck;
+
     if (this.options.enable) {
       const { jsx, dom } = this.options;
       let monorepoComposite;
       let monorepoPackageReferences;
       // let monorepoPackageBuildReferences;
       let monorepoPackageSrcPaths;
+      // another workspace package depends on this one, so its tsconfig references it
+      let isMonorepoDependency = false;
 
       if (inMonorepo && !inMonorepo.root) {
         const yoConfig = inMonorepo.rootYoConfig;
@@ -253,24 +290,42 @@ export default class CommonTypescriptGenerator extends Generator {
           yoConfig.pob.monorepo.typescript;
 
         if (monorepoComposite) {
+          const dependsOn = (dependentPkg, packageName) =>
+            Boolean(
+              dependentPkg.dependencies?.[packageName] ||
+              dependentPkg.devDependencies?.[packageName] ||
+              dependentPkg.peerDependencies?.[packageName],
+            );
+          const getPackageLocation = (packageName) =>
+            `../../${
+              packageName[0] === "@"
+                ? // oxlint-disable-next-line unicorn/no-nested-ternary
+                  yoConfig.pob.project.type === "app"
+                  ? `packages/${packageName.slice(packageName.indexOf("/") + 1)}`
+                  : packageName
+                : `packages/${packageName}`
+            }`;
+
+          isMonorepoDependency = yoConfig.pob.monorepo.packageNames.some(
+            (packageName) => {
+              if (packageName === pkg.name) return false;
+              const dependentPkgPath = `${getPackageLocation(packageName)}/package.json`;
+              return (
+                existsSync(dependentPkgPath) &&
+                dependsOn(
+                  JSON.parse(readFileSync(dependentPkgPath, "utf8")),
+                  pkg.name,
+                )
+              );
+            },
+          );
+
           const packageLocations = new Map(
             yoConfig.pob.monorepo.packageNames
-              .filter(
-                (packageName) =>
-                  (pkg.dependencies && pkg.dependencies[packageName]) ||
-                  (pkg.devDependencies && pkg.devDependencies[packageName]) ||
-                  (pkg.peerDependencies && pkg.peerDependencies[packageName]),
-              )
+              .filter((packageName) => dependsOn(pkg, packageName))
               .map((packageName) => [
                 packageName,
-                `../../${
-                  packageName[0] === "@"
-                    ? // oxlint-disable-next-line unicorn/no-nested-ternary
-                      yoConfig.pob.project.type === "app"
-                      ? `packages/${packageName.slice(packageName.indexOf("/") + 1)}`
-                      : packageName
-                    : `packages/${packageName}`
-                }`,
+                getPackageLocation(packageName),
               ]),
           );
 
@@ -304,6 +359,14 @@ export default class CommonTypescriptGenerator extends Generator {
         }
       }
 
+      // composite is meant for packages built and exported before the ones
+      // depending on them: libraries, and apps imported by other packages.
+      // Other apps only enable incremental.
+      const isReferenceable =
+        !this.options.isApp ||
+        this.options.isAppLibrary ||
+        isMonorepoDependency;
+
       if (this.fs.exists(tsconfigEslintPath)) {
         this.fs.delete(tsconfigEslintPath);
       }
@@ -328,29 +391,37 @@ export default class CommonTypescriptGenerator extends Generator {
             pkg.pob?.rollup === false ||
             pkg.pob?.bundler === false ||
             pkg.pob?.bundler === "tsc",
-          cacheEnabled: !this.options.isApp || this.options.isAppLibrary,
+          cacheEnabled: isReferenceable,
           monorepoPackageSrcPaths,
           monorepoPackageReferences,
-          rootDir: this.options.rootDir,
+          // "." also includes root *.ts files, like vitest.config.ts
+          rootDir: includeScripts ? "." : this.options.rootDir,
           srcDirectory: this.options.srcDirectory || this.options.rootDir,
           enableHashSlash: this.options.enableHashSlash,
           jsx,
           jsxPreserve: this.options.jsxPreserve,
           nextConfig: this.options.nextConfig,
-          // for apps, only enable incremental. Composite is meant for libraries to build and export before the ones depending on them.
           composite:
             monorepoComposite &&
             monorepoComposite !== "check-only" &&
-            (!this.options.isApp || this.options.isAppLibrary),
+            isReferenceable,
           incremental: monorepoComposite,
           dom,
           resolveJsonModule: this.options.resolveJsonModule,
           forceExcludeNodeModules: this.options.forceExcludeNodeModules,
           forceAllowJs: this.options.forceAllowJs,
           plugins: this.options.plugins.split(",").filter(Boolean),
-          additionalIncludes: this.options.additionalIncludes
-            .split(",")
-            .filter(Boolean),
+          additionalIncludes: [
+            ...this.options.additionalIncludes.split(",").filter(Boolean),
+            ...(includeScripts
+              ? ["scripts/**/*.ts", "scripts/**/*.mts", "scripts/**/*.cts"]
+              : []),
+            // the app only imports the generated storybook.requires.ts, which
+            // loads ./preview with a require() that typescript does not follow
+            ...(this.options.storybook
+              ? [".storybook/*.ts", ".storybook/*.tsx"]
+              : []),
+          ],
           node: withNode,
           presets,
         },
@@ -381,7 +452,8 @@ export default class CommonTypescriptGenerator extends Generator {
       // dedicated noEmit project so it is type-checked without emitting
       // definitions nor violating rootDir. Monorepos handle this at the root
       // via the shared tsconfig.tools.json, so only single repos get it here.
-      if (inMonorepo) {
+      // Node apps include them in tsconfig.json instead.
+      if (inMonorepo || includeScripts) {
         this.fs.delete(tsconfigToolsPath);
       } else {
         await copyAndFormatTpl(
@@ -405,7 +477,7 @@ export default class CommonTypescriptGenerator extends Generator {
       // tsrs and tsc do not share their .tsbuildinfo: switching between them
       // triggers a full rebuild
       const tscCommand = (compiler) =>
-        inMonorepo || !this.options.enable
+        inMonorepo || includeScripts || !this.options.enable
           ? compiler
           : `${compiler} && ${compiler} -p tsconfig.tools.json`;
       packageUtils.addOrRemoveScripts(pkg, this.options.enable, {

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

@@ -41,7 +41,7 @@ export default class CoreBunGenerator extends Generator {
   }
 
   end() {
-    if (this.options.enable) {
+    if (this.options.enable && !this.options.check) {
       this.spawnSync("bun", ["install", "--save-text-lockfile"], {});
 
       const pkg = this.fs.readJSON(this.destinationPath("package.json"));

package/lib/generators/core/ci/CoreCIGenerator.js

@@ -107,7 +107,10 @@ export default class CoreCIGenerator extends Generator {
   }
 
   async default() {
-    if (fs.existsSync(this.destinationPath(".circleci"))) {
+    if (
+      !this.options.check &&
+      fs.existsSync(this.destinationPath(".circleci"))
+    ) {
       fs.rmdirSync(this.destinationPath(".circleci"), { recursive: true });
     }
 

package/lib/generators/core/git/CoreGitGenerator.js

@@ -167,6 +167,8 @@ export default class CoreGitGenerator extends Generator {
 
     this.fs.writeJSON(this.destinationPath("package.json"), pkg);
 
+    if (this.options.check) return;
+
     const cwd = this.destinationPath();
 
     const isGitRepository =

package/lib/generators/core/git/generators/github/CoreGitGithubGenerator.js

@@ -264,6 +264,7 @@ export default class CoreGitGithubGenerator extends Generator {
   }
 
   async end() {
+    if (this.options.check) return;
     const pkg = this.fs.readJSON(this.destinationPath("package.json"), {});
     const owner = this.options.gitHostAccount;
     const repo = this.options.repoName || getRepoName(pkg.name);

package/lib/generators/core/package/CorePackageGenerator.js

@@ -205,15 +205,24 @@ export default class CorePackageGenerator extends Generator {
       if (pkg.private) delete pkg.bugs;
       else if (rootMonorepoPkg.bugs) pkg.bugs = rootMonorepoPkg.bugs;
 
-      if (this.fs.exists(this.destinationPath("yarn.lock"))) {
+      if (
+        !this.options.check &&
+        this.fs.exists(this.destinationPath("yarn.lock"))
+      ) {
         fs.unlinkSync(this.destinationPath("yarn.lock"));
       }
-      if (this.fs.exists(this.destinationPath("pnpm-lock.yaml"))) {
+      if (
+        !this.options.check &&
+        this.fs.exists(this.destinationPath("pnpm-lock.yaml"))
+      ) {
         fs.unlinkSync(this.destinationPath("pnpm-lock.yaml"));
       }
     }
 
-    if (this.fs.exists(this.destinationPath("yarn-error.log"))) {
+    if (
+      !this.options.check &&
+      this.fs.exists(this.destinationPath("yarn-error.log"))
+    ) {
       fs.unlinkSync(this.destinationPath("yarn-error.log"));
     }
 

package/lib/generators/core/pnpm/CorePnpmGenerator.js

@@ -131,7 +131,13 @@ export default class CorePnpmGenerator extends Generator {
       }
       config.savePrefix = this.options.type === "app" ? "" : "^";
       config.minimumReleaseAge = 1440 * 2.5; // 2.5 days in minutes
-      config.minimumReleaseAgeExclude = minimumReleaseAgeExcludePackages;
+      // keep the entries added by renovate for security updates, or manually
+      config.minimumReleaseAgeExclude = [
+        ...new Set([
+          ...minimumReleaseAgeExcludePackages,
+          ...(config.minimumReleaseAgeExclude ?? []),
+        ]),
+      ];
       config.dedupePeerDependents = true;
       config.nodeLinker = "hoisted";
 
@@ -156,7 +162,7 @@ export default class CorePnpmGenerator extends Generator {
   }
 
   end() {
-    if (this.options.enable) {
+    if (this.options.enable && !this.options.check) {
       if (this.pendingAllowBuilds.length > 0) {
         console.warn(
           `pnpm-workspace.yaml: set allowBuilds to true or false for ${this.pendingAllowBuilds.join(", ")}`,

package/lib/generators/core/vscode/CoreVSCodeGenerator.js

@@ -55,6 +55,13 @@ export default class CoreVSCodeGenerator extends Generator {
       description: "Typescript enabled",
     });
 
+    this.option("tailwind", {
+      type: Boolean,
+      required: false,
+      default: false,
+      description: "Tailwind enabled, with tailwind-variants (alouette)",
+    });
+
     this.option("packageNames", {
       type: String,
       required: false,
@@ -95,6 +102,7 @@ export default class CoreVSCodeGenerator extends Generator {
           yarn: this.options.packageManager === "yarn",
           pnp: this.options.yarnNodeLinker === "pnp",
           typescript: this.options.typescript,
+          tailwind: this.options.tailwind,
         },
       );
       await copyAndFormatTpl(
@@ -111,6 +119,7 @@ export default class CoreVSCodeGenerator extends Generator {
           tsrs: withTsrs,
           testing: this.options.testing,
           testRunner: this.options.testRunner,
+          tailwind: this.options.tailwind,
           module: pkg.type === "module",
         },
       );

package/lib/generators/core/vscode/templates/extensions.json.ejs

@@ -11,7 +11,8 @@
     "dbaeumer.vscode-eslint",
     "EditorConfig.EditorConfig",
     "esbenp.prettier-vscode"<% if (typescript) { -%>,
-    "TypeScriptTeam.native-preview"<% } %>
+    "TypeScriptTeam.native-preview"<% } %><% if (tailwind) { -%>,
+    "bradlc.vscode-tailwindcss"<% } %>
   ],
   // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
   "unwantedRecommendations": []

package/lib/generators/core/vscode/templates/settings.json.ejs

@@ -63,4 +63,9 @@
   // format config
   "eslint.format.enable": false,
   "editor.defaultFormatter": "oxc.oxc-vscode",
+<% if (tailwind) { -%>
+
+  // tailwind config: class names in tailwind-variants tv() calls
+  "tailwindCSS.classFunctions": ["tv"],
+<% } -%>
 }

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

@@ -46,7 +46,7 @@ export default class CoreYarnGenerator extends Generator {
   async initializing() {
     if (this.options.enable) {
       // dont use this.fs here, as it will cache the result
-      if (!fs.existsSync(".yarnrc.yml")) {
+      if (!this.options.check && !fs.existsSync(".yarnrc.yml")) {
         // yarn 2 not yet installed
         // https://yarnpkg.com/getting-started/install
         this.spawnSync("yarn", ["set", "version", "stable"]);
@@ -103,6 +103,10 @@ export default class CoreYarnGenerator extends Generator {
       //   this.spawnSync("yarn", ["plugin", "import", nameOrUrl]);
       // };
       const removePlugin = (name) => {
+        if (this.options.check) {
+          console.log(`yarn plugin ${name} would be removed`);
+          return;
+        }
         this.spawnSync("yarn", ["plugin", "remove", name]);
       };
 
@@ -224,7 +228,7 @@ export default class CoreYarnGenerator extends Generator {
 
   end() {
     this.fs.delete(this.destinationPath(".yarn/build-state.yml"));
-    if (this.options.enable) {
+    if (this.options.enable && !this.options.check) {
       if (this.options.yarnNodeLinker === "pnp") {
         this.spawnSync("yarn", ["dlx", "@yarnpkg/sdks", "vscode"]);
       } else {

package/lib/generators/lib/PobLibGenerator.js

@@ -476,19 +476,21 @@ export default class PobLibGenerator extends Generator {
     }
 
     this.fs.writeJSON(this.destinationPath("package.json"), pkg);
-    [
-      "lib-node14",
-      "lib-node16",
-      "coverage",
-      this.pobjson.documentation && "generated-docs",
-      !(withBabel || withTypescript) && "dist",
-    ]
-      .filter(Boolean)
-      .forEach((path) => {
-        rmSync(path, { recursive: true, force: true });
-      });
-
-    removeLegacyGeneratedDocs((path) => this.destinationPath(path));
+    if (!this.options.check) {
+      [
+        "lib-node14",
+        "lib-node16",
+        "coverage",
+        this.pobjson.documentation && "generated-docs",
+        !(withBabel || withTypescript) && "dist",
+      ]
+        .filter(Boolean)
+        .forEach((path) => {
+          rmSync(path, { recursive: true, force: true });
+        });
+
+      removeLegacyGeneratedDocs((path) => this.destinationPath(path));
+    }
 
     const { pobjson } = this;
 

package/lib/generators/monorepo/PobMonorepoGenerator.js

@@ -2,7 +2,9 @@ import { execSync } from "node:child_process";
 import fs from "node:fs";
 import { platform } from "node:process";
 import Generator from "yeoman-generator";
+import { isAlouetteApp } from "../../utils/alouette.js";
 import removeLegacyGeneratedDocs from "../../utils/legacyGeneratedDocs.js";
+import { isNodeApp } from "../../utils/nodeApps.js";
 import * as packageUtils from "../../utils/package.js";
 import { packageManagerRun } from "../../utils/packageManagerUtils.js";
 import {
@@ -389,6 +391,9 @@ export default class PobMonorepoGenerator extends Generator {
       typescript: this.pobMonorepoConfig.typescript,
       testing: this.pobMonorepoConfig.testing,
       testRunner: this.pobMonorepoConfig.testRunner,
+      tailwind: this.packageConfigs.some((config, index) =>
+        isAlouetteApp(config, this.packages[index]),
+      ),
       packageNames: JSON.stringify(packageNames),
       packageLocations: JSON.stringify(this.packageLocations),
     });
@@ -428,6 +433,17 @@ export default class PobMonorepoGenerator extends Generator {
       isAppProject: this.options.isAppProject,
       packageNames: JSON.stringify(packageNames),
       packagePaths: JSON.stringify(packagePaths),
+      // mirrors the includeScripts option given by the app generator
+      packagePathsWithScriptsIncluded: JSON.stringify(
+        this.packageLocations.filter(
+          (location, index) =>
+            this.pobMonorepoConfig.typescript !== "check-only" &&
+            this.packages[index].pob?.typescript !== "check-only" &&
+            isNodeApp(this.packageConfigs[index]) &&
+            packagePaths.includes(location) &&
+            fs.existsSync(`${location}/scripts`),
+        ),
+      ),
       testRunner: this.pobMonorepoConfig.testRunner,
       onlyLatestLTS: this.options.onlyLatestLTS,
       packageManager: this.options.packageManager,
@@ -435,6 +451,8 @@ export default class PobMonorepoGenerator extends Generator {
 
     this.fs.writeJSON(this.destinationPath("package.json"), pkg);
 
+    if (this.options.check) return;
+
     if (platform !== "win32") {
       execSync(
         `rm -Rf ${["lib-*", "coverage", "generated-docs"].filter(Boolean).join(" ")}`,

package/lib/generators/monorepo/typescript/MonorepoTypescriptGenerator.js

@@ -57,6 +57,14 @@ export default class MonorepoTypescriptGenerator extends Generator {
       required: true,
     });
 
+    this.option("packagePathsWithScriptsIncluded", {
+      type: String,
+      required: false,
+      default: "[]",
+      description:
+        "packages whose tsconfig.json includes their scripts (node apps)",
+    });
+
     this.option("testRunner", {
       type: String,
       required: false,
@@ -85,7 +93,8 @@ export default class MonorepoTypescriptGenerator extends Generator {
   // emitting tsconfig, so it needs a dedicated noEmit project for type-aware
   // linting and tsc -b: root config files (e.g. vitest.config.ts), a root
   // scripts/ dir, and each package's scripts/ dir (matched via the workspace
-  // globs so all packages are covered)
+  // globs so all packages are covered, except node apps which include them in
+  // their own tsconfig.json)
   #hasTools() {
     return (
       hasRootConfigFiles(this.destinationPath()) ||
@@ -199,6 +208,9 @@ export default class MonorepoTypescriptGenerator extends Generator {
           {
             nodeVersion: latestLTS,
             workspaceGlobs,
+            packagePathsWithScriptsIncluded: JSON.parse(
+              this.options.packagePathsWithScriptsIncluded,
+            ),
           },
         );
       } else {

package/lib/generators/monorepo/typescript/templates/tsconfig.tools.json.ejs

@@ -21,6 +21,13 @@
     "<%= workspaceGlob %>/e2e/**/*.cts"<%= index === workspaceGlobs.length - 1 ? '' : ',' %>
 <% }) -%>
   ],
+<% if (packagePathsWithScriptsIncluded.length > 0) { -%>
+  "exclude": [
+<% packagePathsWithScriptsIncluded.forEach((packagePath, index) => { -%>
+    "<%= packagePath %>/scripts/**"<%= index === packagePathsWithScriptsIncluded.length - 1 ? '' : ',' %>
+<% }) -%>
+  ],
+<% } -%>
   "compilerOptions": {
     "noEmit": true,
     "tsBuildInfoFile": "node_modules/.cache/tsc/tsbuildinfo-tools",

package/lib/generators/monorepo/workspaces/MonorepoWorkspacesGenerator.js

@@ -199,21 +199,26 @@ export default class MonorepoWorkspacesGenerator extends Generator {
         return;
       }
       console.log(`=> update ${packagePath}`);
-      spawnSync(
+      const { status } = spawnSync(
         process.argv[0],
         [
           process.argv[1],
           "update",
           "from-pob",
-          this.options.force ? "--force" : undefined,
+          this.options.check && "--check",
+          !this.options.check && this.options.force && "--force",
         ].filter(Boolean),
         {
           cwd: packagePath,
           stdio: "inherit",
         },
       );
+      // with --check, a package exits with 1 when a file would change
+      if (this.options.check && status !== 0) process.exitCode = 1;
     });
 
+    if (this.options.check) return;
+
     switch (this.options.packageManager) {
       case "npm":
         this.spawnSync("npm", ["install"]);

package/lib/generators/pob/PobBaseGenerator.js

@@ -45,7 +45,9 @@ export default class PobBaseGenerator extends Generator {
 
   async initializing() {
     // format package.json to ensure diff is correct
-    await ensureJsonFileFormatted(this.destinationPath("package.json"));
+    if (!this.options.check) {
+      await ensureJsonFileFormatted(this.destinationPath("package.json"));
+    }
 
     if (this.options.monorepo) {
       this.isMonorepo = true;
@@ -296,7 +298,7 @@ export default class PobBaseGenerator extends Generator {
   }
 
   install() {
-    if (this.options.fromPob) return;
+    if (this.options.fromPob || this.options.check) return;
 
     switch (this.#getPackageManager()) {
       case "npm":

package/lib/pob.js

@@ -51,12 +51,42 @@ import { getNewPackagePath } from "./utils/workspaceUtils.js";
 
 const printUsage = () => {
   console.error("Usage: pob [monorepo] [lib|app|init]");
-  console.error("       pob [monorepo] update [--force]");
+  console.error("       pob [monorepo] update [--force|--check]");
   console.error(
     "       pob add <packageName> [--app <appType> [--testing] [--e2e]]",
   );
 };
 
+const printHelp = () => {
+  console.log(`Usage: pob [monorepo] [lib|app|init]
+       pob [monorepo] update [from-pob] [--force|--check]
+       pob add <packageName> [--app <appType> [--testing] [--e2e]]
+       pob migrate-to-monorepo
+
+Commands:
+  lib                    Generate a library
+  app                    Generate an app
+  init                   Initialize pob config, prompting for project type
+  update                 Regenerate files from the existing .yo-rc.json, without prompts
+  update from-pob        Same as update, without running install or build
+  add <packageName>      Add a new package to the monorepo workspaces
+  migrate-to-monorepo    Move the current project into packages/<name> and create a monorepo root
+
+  monorepo               Prefix to force monorepo mode (auto-detected from workspaces or lerna.json)
+
+Options:
+  --force                Overwrite every file without asking
+  --check                With update (implied when no command is given): print
+                         the diffs without writing anything or running install,
+                         exit with code 1 when a file would change
+  --app <appType>        With add: generate an app package without prompts
+                         (alp, vite, vite-with-server, next.js, node, node-library,
+                         untranspiled-library, alp-node, expo, other)
+  --testing              With add --app: enable testing
+  --e2e                  With add --app: enable e2e testing
+  -h, --help             Show this help`);
+};
+
 const readJson = (filepath) => {
   try {
     return JSON.parse(readFileSync(filepath, "utf8"));
@@ -69,14 +99,39 @@ const readJson = (filepath) => {
 //   console.log(pkg.version);
 // };
 
-const argv = minimist(process.argv.slice(2));
+const argv = minimist(process.argv.slice(2), { alias: { h: "help" } });
+
+if (argv.help || argv._[0] === "help") {
+  printHelp();
+  process.exit(0);
+}
 
 if (argv.version) {
   // printVersion();
   process.exit(0);
 }
 
-const env = yeoman.createEnv();
+const check = !!argv.check;
+
+// dryRun: the conflicter prints the diffs and skips every write.
+// sharedOptions.check: generators skip their side effects outside mem-fs.
+const env = yeoman.createEnv(
+  check
+    ? { dryRun: true, skipInstall: true, sharedOptions: { check: true } }
+    : {},
+);
+
+// the conflicter clears its file statuses after each file: collect them as logged
+const changedFiles = [];
+if (check) {
+  for (const status of ["create", "conflict"]) {
+    const log = env.adapter.log[status];
+    env.adapter.log[status] = (filePath, ...args) => {
+      changedFiles.push(filePath);
+      return log.call(env.adapter.log, filePath, ...args);
+    };
+  }
+}
 
 env.on("error", (err) => {
   console.error(err.stack || err.message || err);
@@ -266,7 +321,13 @@ env.registerStub(
 const projectPkg = readJson(path.resolve("./package.json"));
 const monorepoArg = argv._[0] === "lerna" || argv._[0] === "monorepo";
 let monorepo = monorepoArg || !!(projectPkg && projectPkg.workspaces);
-const action = monorepoArg ? argv._[1] : argv._[0];
+const action = (monorepoArg ? argv._[1] : argv._[0]) ?? (check && "update");
+
+if (check && action !== "update") {
+  console.error("--check can only be used with update");
+  printUsage();
+  process.exit(1);
+}
 
 if (action === "add") {
   if (!projectPkg.workspaces) {
@@ -417,7 +478,8 @@ const options = {
   updateOnly,
   monorepo,
   fromPob,
-  force: argv.force,
+  // force bypasses the conflicter diff
+  force: check ? false : argv.force,
 };
 
 try {
@@ -429,6 +491,14 @@ try {
   }
 }
 
+if (check) {
+  if (changedFiles.length > 0) {
+    console.error(`pob --check: ${changedFiles.length} file(s) would change:`);
+    for (const file of changedFiles) console.error(`  ${file}`);
+    process.exitCode = 1;
+  }
+}
+
 // generator.on('error', (err) => {
 //   console.error(err.stack || err.message || err);
 //   process.exit(1);

package/lib/utils/alouette.js

@@ -0,0 +1,18 @@
+// alouette styles components with tailwind (nativewind) and tailwind-variants
+
+/** @param {Record<string, any>} pkg */
+export const detectAlouette = (pkg) =>
+  [pkg.dependencies, pkg.devDependencies].some(
+    (dependencies) => dependencies?.alouette !== undefined,
+  );
+
+/**
+ * Fallback on the dependencies for an app config missing the option.
+ *
+ * @param {Record<string, any> | undefined} pobConfig
+ * @param {Record<string, any>} pkg
+ */
+export const isAlouetteApp = (pobConfig, pkg) =>
+  pobConfig?.project?.type === "app" &&
+  pobConfig.app?.type === "expo" &&
+  (pobConfig.app.alouette ?? detectAlouette(pkg));

package/lib/utils/appTsconfigTarget.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildDependentsMaps, discoverWorkspaces } from "./workspaceUtils.js";
+
+export const appsWithBrowser = ["alp", "next.js", "vite", "vite-with-server"];
+
+const expoTarget = "@pob/root/tsconfigs/targets/expo.json";
+
+// based on the app type from the pob config rather than on the package.json
+// dependencies, which can change without pob being run again
+export const getAppTsconfigTarget = ({ appType, dom, withBun }) => {
+  if (appType === "expo") return expoTarget;
+  if (dom) {
+    return appType === "vite" || appType === "vite-with-server"
+      ? "@pob/root/tsconfigs/targets/vite.json"
+      : "@pob/root/tsconfigs/targets/webpack.json";
+  }
+  if (withBun) return "@pob/root/tsconfigs/targets/bun.json";
+  return undefined;
+};
+
+const readPobConfig = (location) => {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(location, ".yo-rc.json"))).pob;
+  } catch {
+    return undefined;
+  }
+};
+
+/**
+ * Target of the apps directly depending on the package, for packages compiled
+ * by the bundler of these apps (untranspiled libraries). Expo wins as the
+ * widest target, otherwise the apps must agree on a single target.
+ */
+export const getConsumerAppsTsconfigTarget = async ({
+  rootPath,
+  packageName,
+  withBun,
+}) => {
+  const workspaces = await discoverWorkspaces(rootPath);
+  const workspace = workspaces.find((w) => w.name === packageName);
+  if (!workspace) return undefined;
+
+  const dependents = buildDependentsMaps(workspaces).get(workspace) || [];
+  const targets = new Set();
+  for (const [dependent] of dependents) {
+    const pobConfig = readPobConfig(path.join(rootPath, dependent.location));
+    if (pobConfig?.project?.type !== "app") continue;
+    const appType = pobConfig.app?.type;
+    const target = getAppTsconfigTarget({
+      appType,
+      dom: appsWithBrowser.includes(appType),
+      withBun,
+    });
+    if (target) targets.add(target);
+  }
+
+  if (targets.has(expoTarget)) return expoTarget;
+  return targets.size === 1 ? [...targets][0] : undefined;
+};

package/lib/utils/appTsconfigTarget.test.js

@@ -0,0 +1,169 @@
+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 {
+  getAppTsconfigTarget,
+  getConsumerAppsTsconfigTarget,
+} from "./appTsconfigTarget.js";
+
+const targets = {
+  expo: "@pob/root/tsconfigs/targets/expo.json",
+  vite: "@pob/root/tsconfigs/targets/vite.json",
+  webpack: "@pob/root/tsconfigs/targets/webpack.json",
+  bun: "@pob/root/tsconfigs/targets/bun.json",
+};
+
+describe("getAppTsconfigTarget", () => {
+  it("returns expo for expo apps", () => {
+    expect(getAppTsconfigTarget({ appType: "expo", dom: false })).toBe(
+      targets.expo,
+    );
+  });
+
+  it("returns vite for vite apps", () => {
+    expect(getAppTsconfigTarget({ appType: "vite", dom: true })).toBe(
+      targets.vite,
+    );
+    expect(
+      getAppTsconfigTarget({ appType: "vite-with-server", dom: true }),
+    ).toBe(targets.vite);
+  });
+
+  it("returns webpack for other browser apps and dom libraries", () => {
+    expect(getAppTsconfigTarget({ appType: "alp", dom: true })).toBe(
+      targets.webpack,
+    );
+    expect(getAppTsconfigTarget({ appType: undefined, dom: true })).toBe(
+      targets.webpack,
+    );
+  });
+
+  it("returns bun without dom with bun", () => {
+    expect(
+      getAppTsconfigTarget({ appType: "node", dom: false, withBun: true }),
+    ).toBe(targets.bun);
+  });
+
+  it("returns undefined for node apps", () => {
+    expect(getAppTsconfigTarget({ appType: "node", dom: false })).toBe(
+      undefined,
+    );
+  });
+});
+
+async function writeWorkspace(rootPath, location, pkg, pobConfig) {
+  const dir = path.join(rootPath, location);
+  await fs.mkdir(dir, { recursive: true });
+  await fs.writeFile(path.join(dir, "package.json"), JSON.stringify(pkg));
+  if (pobConfig) {
+    await fs.writeFile(
+      path.join(dir, ".yo-rc.json"),
+      JSON.stringify({ pob: pobConfig }),
+    );
+  }
+}
+
+const app = (type) => ({ project: { type: "app" }, app: { type } });
+
+/**
+ * Monorepo with an untranspiled library "@ex/lib" and the given consumers,
+ * each one an [appType, pobConfig] pair depending on the library.
+ */
+async function prepareMonorepo(consumers) {
+  const rootPath = await fs.mkdtemp(path.join(os.tmpdir(), "pob-"));
+  await writeWorkspace(rootPath, ".", {
+    name: "root",
+    workspaces: ["packages/*"],
+  });
+  await writeWorkspace(
+    rootPath,
+    "packages/lib",
+    { name: "@ex/lib" },
+    app("untranspiled-library"),
+  );
+  for (const [name, pobConfig] of consumers) {
+    await writeWorkspace(
+      rootPath,
+      `packages/${name}`,
+      { name: `@ex/${name}`, dependencies: { "@ex/lib": "workspace:*" } },
+      pobConfig,
+    );
+  }
+  return rootPath;
+}
+
+const getLibTarget = async (consumers, { withBun = false } = {}) =>
+  getConsumerAppsTsconfigTarget({
+    rootPath: await prepareMonorepo(consumers),
+    packageName: "@ex/lib",
+    withBun,
+  });
+
+describe("getConsumerAppsTsconfigTarget", () => {
+  it("uses the target of a consumer expo app", async () => {
+    expect(await getLibTarget([["mobile", app("expo")]])).toBe(targets.expo);
+  });
+
+  it("prefers expo when consumer apps disagree", async () => {
+    expect(
+      await getLibTarget([
+        ["mobile", app("expo")],
+        ["web", app("vite")],
+        ["api", app("node")],
+      ]),
+    ).toBe(targets.expo);
+  });
+
+  it("uses the target shared by all consumer apps", async () => {
+    expect(
+      await getLibTarget([
+        ["web", app("vite")],
+        ["api", app("node")],
+      ]),
+    ).toBe(targets.vite);
+  });
+
+  it("returns undefined when consumer apps disagree without expo", async () => {
+    expect(
+      await getLibTarget([
+        ["web", app("vite")],
+        ["legacy", app("alp")],
+      ]),
+    ).toBe(undefined);
+  });
+
+  it("returns undefined without consumer apps with a target", async () => {
+    expect(await getLibTarget([])).toBe(undefined);
+    expect(await getLibTarget([["api", app("node")]])).toBe(undefined);
+    expect(
+      await getLibTarget([["other-lib", { project: { type: "lib" } }]]),
+    ).toBe(undefined);
+    expect(await getLibTarget([["no-config", undefined]])).toBe(undefined);
+  });
+
+  it("uses bun for node consumer apps with bun", async () => {
+    expect(await getLibTarget([["api", app("node")]], { withBun: true })).toBe(
+      targets.bun,
+    );
+  });
+
+  it("ignores apps depending on the library through another library", async () => {
+    const rootPath = await prepareMonorepo([
+      ["other-lib", app("untranspiled-library")],
+    ]);
+    await writeWorkspace(
+      rootPath,
+      "packages/mobile",
+      { name: "@ex/mobile", dependencies: { "@ex/other-lib": "workspace:*" } },
+      app("expo"),
+    );
+    expect(
+      await getConsumerAppsTsconfigTarget({
+        rootPath,
+        packageName: "@ex/lib",
+        withBun: false,
+      }),
+    ).toBe(undefined);
+  });
+});

package/lib/utils/nodeApps.js

@@ -0,0 +1,8 @@
+// node backend apps: their scripts run in the same environment as their
+// sources, so the package tsconfig.json type-checks them too instead of a
+// separate tsconfig.tools.json
+export const nodeAppTypes = ["node", "node-library", "alp-node"];
+
+export const isNodeApp = (pobConfig) =>
+  pobConfig?.project?.type === "app" &&
+  nodeAppTypes.includes(pobConfig.app?.type);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pob",
-  "version": "40.3.3",
+  "version": "40.4.0",
   "description": "Pile of bones, library generator with git/babel/typescript/typedoc/readme/vitest",
   "keywords": [
     "skeleton"
@@ -32,8 +32,8 @@
   },
   "dependencies": {
     "@pob/codemods": "0.18.2",
-    "@pob/eslint-config": "68.0.0",
-    "@pob/eslint-config-typescript-react": "68.0.0",
+    "@pob/eslint-config": "68.1.0",
+    "@pob/eslint-config-typescript-react": "68.1.0",
     "@pob/sort-object": "11.2.0",
     "@pob/sort-pkg": "13.2.0",
     "@types/inquirer": "9.0.10",
@@ -51,7 +51,7 @@
     "minimist": "1.2.8",
     "oxfmt": "0.72.0",
     "parse-author": "2.0.0",
-    "pob-dependencies": "28.2.0",
+    "pob-dependencies": "28.3.0",
     "semver": "7.8.5",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "validate-npm-package-name": "^8.0.0",
@@ -59,7 +59,7 @@
     "yeoman-generator": "10.3.0"
   },
   "devDependencies": {
-    "@pob/root": "28.2.2",
+    "@pob/root": "28.3.0",
     "@types/node": "24.19.1",
     "@typescript/native": "npm:typescript@7.0.2",
     "@yeoman/types": "1.13.1",