@elliemae/pui-cli 9.0.0-alpha.11 → 9.0.0-alpha.13

package/dist/cjs/skills/migrate-to-pui-cli-9/SKILL.md

@@ -2,11 +2,12 @@
 name: migrate-to-pui-cli-9
 description: >-
   Migrate a PUI app or library to pui-cli 9 (Node 24, pnpm 11, ESLint 10 flat config, Stylelint 17,
-  Husky 9, Vitest 4, semantic-release 25, Lerna 9, Nx 22). Use when upgrading @elliemae/pui-cli,
-  migrating from .eslintrc.cjs to eslint.config.mjs, release.config.cjs to release.config.mjs,
+  Husky 9, Vitest 4, Jest 30, semantic-release 25, Lerna 9, Nx 22). Use when upgrading @elliemae/pui-cli,
+  migrating from .eslintrc.cjs to eslint.config.mjs, jest.config.cjs to jest.config.mjs, release.config.cjs to release.config.mjs,
+  babel.config.cjs to babel.config.ts, prettier.config.cjs / commitlint.config.cjs to .mjs subpath imports (pui-cli 9 is ESM-only),
   upgrading Husky 8 hooks, fixing Vitest 4 / coverage-v8 breakages, migrating monorepo nx.json from
-  @nrwl/workspace to nx 22, or adopting shared configs from pui-cli. App/library production builds
-  stay on Webpack.
+  @nrwl/workspace to nx 22, moving shamefully-hoist from .npmrc to pnpm-workspace.yaml for pnpm 11,
+  or adopting shared configs from pui-cli. App/library production builds stay on Webpack.
 ---
 
 # Migrate to pui-cli 9
@@ -35,9 +36,46 @@ pnpm install
 
 1. Update `.node-version` to `24` if needed.
 2. Ensure CI Jenkins/docker images use Node 24.
-3. Upgrade pnpm to 11 (`packageManager` field in root `package.json`).
+3. Upgrade pnpm to 11 — set `engines.pnpm` to `>=11` in root `package.json` (do not pin an exact version in `packageManager`; customers may use any pnpm 11 minor/patch).
 4. Run `pnpm install`, `pnpm test`, `pnpm run build` — fix any Node/pnpm breakages only.
 
+### Phase 1b — pnpm 11 hoisting (`pnpm-workspace.yaml`)
+
+**Required for every repo** (apps, libs, monorepos). pnpm 11 ignores hoist settings in `.npmrc`.
+
+1. **Keep org hoisting policy** — set `shamefullyHoist: true` in `pnpm-workspace.yaml` (same as legacy `shamefully-hoist=true`). Do not switch to isolated/no-hoist; PUI apps use `@elliemae/app-react-dependencies` and pui-cli webpack `getAlias()` expects deps at repo root `node_modules/`.
+
+2. **Create or update `pnpm-workspace.yaml`** at the repo root. Move settings out of `.npmrc` using camelCase:
+
+   | `.npmrc` (ignored by pnpm 11)     | `pnpm-workspace.yaml`         |
+   | --------------------------------- | ----------------------------- |
+   | `shamefully-hoist=true`           | `shamefullyHoist: true`       |
+   | `public-hoist-pattern[]=…`        | `publicHoistPattern: [ "…" ]` |
+   | `strict-peer-dependencies`        | `strictPeerDependencies`      |
+   | `auto-install-peers`              | `autoInstallPeers`            |
+   | `package.json` `"pnpm".overrides` | top-level `overrides:`        |
+
+3. **Single-package repo** — include `packages: ['.']`. Reference: `pui-react-boilerplate/pnpm-workspace.yaml`.
+
+4. **Monorepo** — include `packages: ["libs/*", "apps/*"]`. Optional explicit `publicHoistPattern` for webpack alias targets: `esbuild-loader`, `@elliemae/*`, `styled-components`, `history`, `lodash`. Reference: `pui-microfe/pnpm-workspace.yaml`.
+
+5. **Migrate `allowBuilds`** — replace `onlyBuiltDependencies` / placeholder `allowBuilds` entries with `true` for packages that need postinstall scripts (`@swc/core`, `esbuild`, `nx`, etc.). Fix `ERR_PNPM_IGNORED_BUILDS`.
+
+6. **Trim `.npmrc`** — keep auth/registry only (for example `legacy-peer-deps=true`).
+
+7. **Clean reinstall and verify:**
+
+```bash
+rm -rf node_modules libs/*/node_modules   # if monorepo
+SKIP_POST_INSTALL_BUILD=1 pnpm install --no-frozen-lockfile
+grep publicHoistPattern node_modules/.modules.yaml   # must NOT be []
+pnpm run build
+```
+
+**Symptoms if skipped:** `Can't resolve 'esbuild-loader'` / `styled-components` / `@elliemae/pui-theme` during webpack; `publicHoistPattern: []` in `.modules.yaml`.
+
+See migration guide section **1b. Migrate pnpm hoisting to `pnpm-workspace.yaml`**.
+
 ### Phase 2 — Bump pui-cli
 
 ```bash
@@ -46,6 +84,52 @@ pnpm add -D @elliemae/pui-cli@9
 
 Re-run install and smoke-test build/test without ESLint changes yet if the bump is large.
 
+### Phase 2b — Babel config (`babel.config.ts`)
+
+pui-cli 9 requires Node 24, which natively loads TypeScript config files. Babel 7.28+ (shipped with pui-cli 9) supports **`babel.config.ts`** without extra loaders.
+
+1. Replace root `babel.config.cjs` with `babel.config.ts`:
+
+```typescript
+import { babelConfig } from '@elliemae/pui-cli';
+
+export default babelConfig;
+```
+
+2. Delete `babel.config.cjs`. Repeat for monorepo packages that have their own Babel file (for example `libs/foo/babel.config.cjs`).
+
+3. **Do not** add `@babel/plugin-transform-private-methods` or `@babel/plugin-transform-private-property-in-object` locally — pui-cli 9 includes them in shared `babelConfig` (Storybook and app-sdk private class syntax).
+
+4. Verify: `pnpm run build`; if the repo uses Storybook, `pnpm exec pui-cli storybook -b`.
+
+See migration guide section **2b. Migrate Babel config to TypeScript**.
+
+### Phase 2c — Prettier and Commitlint (`.mjs`)
+
+pui-cli 9 ships shared Prettier and Commitlint configs as ESM. Migrate root configs from `.cjs` to `.mjs` using subpath exports (same pattern as Stylelint and Jest).
+
+1. Replace `prettier.config.cjs` with `prettier.config.mjs`:
+
+```javascript
+import { prettierConfig } from '@elliemae/pui-cli/prettier';
+
+export default prettierConfig;
+```
+
+2. Replace `commitlint.config.cjs` with `commitlint.config.mjs`:
+
+```javascript
+import { commitlintConfig } from '@elliemae/pui-cli/commitlint';
+
+export default commitlintConfig;
+```
+
+3. Delete the old `.cjs` files. **`require('@elliemae/pui-cli')` is removed in pui-cli 9** — use ESM subpath imports only.
+
+4. Verify: `pnpm exec prettier --check .`; test a commit through Husky if commitlint is enabled.
+
+See migration guide section **2c. Migrate Prettier and Commitlint configs to ESM**.
+
 ### Phase 3 — ESLint 10 flat config
 
 **React apps and libraries:**
@@ -153,12 +237,43 @@ Reference hooks: [pui-cli/.husky](https://git.elliemae.io/platform-ui/pui-cli/tr
 
 ### Phase 6 — Stylelint 17 (if CSS / styled-components)
 
-1. Simplify `stylelint.config.cjs` — remove `stylelint-config-styled-components` workarounds.
-2. Optional ESM: `stylelint.config.mjs` importing `@elliemae/pui-cli/stylelint`.
-3. Run `pnpm exec pui-cli lint` (CSS pass).
+1. Simplify or migrate to `stylelint.config.mjs` importing `@elliemae/pui-cli/stylelint` — remove `stylelint-config-styled-components` workarounds.
+2. Run `pnpm exec pui-cli lint` (CSS pass).
 
 See [stylelint-migration.md](https://docs.pui.mortgagetech.q1.ice.com/cli/stylelint-migration) in pui-cli docs.
 
+### Phase 6b — Jest 30 (if using `pui-cli test`)
+
+Skip if the repo uses Vitest (`pui-cli vitest`) only.
+
+1. Replace `jest.config.cjs` with `jest.config.mjs`:
+
+```javascript
+import { jestConfig } from '@elliemae/pui-cli';
+
+delete jestConfig.moduleNameMapper['@elliemae/pui-diagnostics'];
+
+export default jestConfig;
+```
+
+Delete `jest.config.cjs` after creating `jest.config.mjs`.
+
+2. Align local Jest devDependencies with pui-cli 9:
+
+```bash
+pnpm add -D jest-cli@30 jest-environment-jsdom@30 @types/jest@30 jest-watch-typeahead@3
+```
+
+3. Search for deprecated matcher aliases (`toBeCalled`, `toReturn`, `toThrowError`, etc.) and update to canonical names (`toHaveBeenCalled`, `toHaveReturned`, `toThrow`). Use `eslint-plugin-jest` `no-alias-methods` autofix when available.
+
+4. Regenerate snapshots if needed: `pnpm exec pui-cli test --fix` or `jest -u`.
+
+5. Run `pnpm exec pui-cli test`.
+
+**Do not** replace `setupFiles` wholesale — spread pui-cli defaults when adding repo-specific setup. Remove any local `jest-textencoder-setup.cjs` (built into shared `jestConfig`).
+
+See migration guide section **Jest 30 (`pui-cli test`)**.
+
 ### Phase 7 — Vitest 4 (if using `pui-cli vitest`)
 
 Skip if the repo uses Jest (`pui-cli test`) only.
@@ -243,11 +358,12 @@ pnpm exec lerna --version # 9.x
    - Remove `tasksRunnerOptions`; move cacheable targets to `"cache": true` in `targetDefaults`
    - Optional: `pnpm exec nx migrate latest && pnpm exec nx migrate --run-migrations`
 
-4. Lerna 9: stop using `lerna bootstrap` / `lerna add` / `lerna link` — use pnpm workspaces. Keep existing `lerna.json` unless it referenced removed commands. `pui-cli version` unchanged.
+4. Lerna 9: stop using `lerna bootstrap` / `lerna add` / `lerna link` — use pnpm workspaces. Remove `"useWorkspaces": true` from `lerna.json` (Lerna 9 errors with `ECONFIGWORKSPACES` if present). Keep `"npmClient": "pnpm"` so Lerna reads `pnpm-workspace.yaml`. Optional: `pnpm exec lerna repair`. `pui-cli version` unchanged.
 
 5. Smoke-test:
 
 ```bash
+pnpm exec lerna list
 pnpm exec nx run-many --target=build --all --parallel
 pnpm exec nx affected --target=lint --uncommitted
 pnpm exec pui-cli lint
@@ -255,8 +371,40 @@ pnpm exec pui-cli lint
 
 See [pui-cli 9 migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/pui-cli-9-migration) — **Lerna 9 and Nx 22** section for the full `nx.json` template.
 
+### Phase 11 — Storybook 10 + latest pui-app-sdk
+
+Applies when the repo uses `pui-cli storybook`. Requires pui-cli 9 **and** a matching **pui-app-sdk** release on the same train (`storybook/cjs/*` removed; shared config is TypeScript in app-sdk, consumed from **compiled dist**).
+
+Install the dedicated skill for agents:
+
+```bash
+pnpm exec pui-cli skills install migrate-storybook-out-of-cjs --target all
+```
+
+Follow **`migrate-storybook-out-of-cjs`** for the full CJS → ESM playbook. Summary:
+
+1. Bump `@elliemae/pui-cli@9` and `@elliemae/pui-app-sdk@*` together; reinstall (rebuild app-sdk if using a `file:` link).
+2. Replace `.storybook/main.js` with `.storybook/main.mjs` importing **`getStorybookConfig`** from `@elliemae/pui-app-sdk/storybook/main` (not `getConfig` or `storybook/cjs/main`).
+3. Delete `.storybook/middleware.js`; migrate `preview` / `manager` / `theme` to `.mjs` when customized.
+4. Rename docs-only **`*.stories.mdx`** → **`*.mdx`**; use `@storybook/addon-docs/blocks` for `<Meta>` (MDX3).
+5. Update stories to CSF3 where types fail; remove SB6 webpack alias workarounds unless still required.
+6. Migrate consumer **`babel.config.cjs` → `babel.config.ts`** (re-export pui-cli `babelConfig`) — see Phase 2b; **do not** duplicate private-method Babel plugins (pui-cli 9 includes them for Storybook).
+
+Verify:
+
+```bash
+pnpm exec pui-cli storybook
+pnpm exec pui-cli storybook -b
+pnpm exec pui-cli lint
+```
+
+See [pui-cli 9 migration guide — Storybook 10](https://docs.pui.mortgagetech.q1.ice.com/cli/pui-cli-9-migration) for pui-app-sdk export changes, dist build requirement, and troubleshooting.
+
 ### Phase 10 — Verify
 
+- [ ] `babel.config.ts` re-exports pui-cli `babelConfig`; `babel.config.cjs` removed
+- [ ] `prettier.config.mjs` and `commitlint.config.mjs` import subpath exports; legacy `.cjs` removed
+- [ ] `shamefullyHoist` in `pnpm-workspace.yaml` (not `.npmrc`); `publicHoistPattern` not `[]` in `.modules.yaml`
 - [ ] `pnpm exec pui-cli lint` — 0 errors
 - [ ] `pnpm exec pui-cli tscheck --files`
 - [ ] `pnpm test` (or `pui-cli vitest` if applicable)
@@ -267,21 +415,35 @@ See [pui-cli 9 migration guide](https://docs.pui.mortgagetech.q1.ice.com/cli/pui
 
 ## Common lint fixes after upgrade
 
-| Symptom                              | Fix                                                                                 |
-| ------------------------------------ | ----------------------------------------------------------------------------------- |
-| `import-x/no-unresolved`             | Use `import type` for type-only imports                                             |
-| `@typescript-eslint/no-explicit-any` | Type the value or add targeted override (warn) during transition                    |
-| `@typescript-eslint/no-unused-vars`  | Remove or prefix with `_`                                                           |
-| Stale `eslint-disable` comments      | Remove disables for rules no longer in config                                       |
-| Test/fixture files flagged           | Shared config includes `lib/**/tests/**` globs — ensure pui-cli 9.0.0+              |
-| `.d.ts` files                        | pui-cli turns off `no-explicit-any` for `**/*.d.ts`                                 |
-| Cannot find module `vite` in tscheck | Set `moduleResolution: "bundler"` or extend pui-cli 9 tsconfig                      |
-| Vitest `optimizer.web` unknown       | Rename to `test.deps.optimizer.client` (Vitest 4)                                   |
-| Coverage fails after upgrade         | Remove `@vitest/coverage-c8`; use `@vitest/coverage-v8@4`                           |
-| `release.config.cjs` extends fails   | Migrate to `release.config.mjs`; requires semantic-release 22+ (pui-cli 9 ships 25) |
-| `nx` fails after pui-cli 9 bump      | Migrate `nx.json` off `@nrwl/*`; use `targetDefaults` not `targetDependencies`      |
-| `lerna bootstrap` / `add` / `link`   | Removed in lerna 9 — use `pnpm` workspaces and `pnpm add --filter`                  |
-| Stale `@nrwl/workspace` in lockfile  | Remove direct `@nrwl/*` pins; rely on pui-cli's `nx` + `@nx/workspace`              |
+| Symptom                                                     | Fix                                                                                                                                                                                               |
+| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `import-x/no-unresolved`                                    | Use `import type` for type-only imports                                                                                                                                                           |
+| `@typescript-eslint/no-explicit-any`                        | Type the value or add targeted override (warn) during transition                                                                                                                                  |
+| `@typescript-eslint/no-unused-vars`                         | Remove or prefix with `_`                                                                                                                                                                         |
+| Stale `eslint-disable` comments                             | Remove disables for rules no longer in config                                                                                                                                                     |
+| Test/fixture files flagged                                  | Shared config includes `lib/**/tests/**` globs — ensure pui-cli 9.0.0+                                                                                                                            |
+| `.d.ts` files                                               | pui-cli turns off `no-explicit-any` for `**/*.d.ts`                                                                                                                                               |
+| Cannot find module `vite` in tscheck                        | Set `moduleResolution: "bundler"` or extend pui-cli 9 tsconfig                                                                                                                                    |
+| Vitest `optimizer.web` unknown                              | Rename to `test.deps.optimizer.client` (Vitest 4)                                                                                                                                                 |
+| Coverage fails after upgrade                                | Remove `@vitest/coverage-c8`; use `@vitest/coverage-v8@4`                                                                                                                                         |
+| `release.config.cjs` extends fails                          | Migrate to `release.config.mjs`; requires semantic-release 22+ (pui-cli 9 ships 25)                                                                                                               |
+| `nx` fails after pui-cli 9 bump                             | Migrate `nx.json` off `@nrwl/*`; use `targetDefaults` not `targetDependencies`                                                                                                                    |
+| `lerna bootstrap` / `add` / `link`                          | Removed in lerna 9 — use `pnpm` workspaces and `pnpm add --filter`                                                                                                                                |
+| `ECONFIGWORKSPACES` / `useWorkspaces` has been removed      | Delete `"useWorkspaces": true` from `lerna.json`; keep `"npmClient": "pnpm"`; run `pnpm exec lerna list` to verify                                                                                |
+| Stale `@nrwl/workspace` in lockfile                         | Remove direct `@nrwl/*` pins; rely on pui-cli's `nx` + `@nx/workspace`                                                                                                                            |
+| `Can't resolve 'esbuild-loader'`                            | Move `shamefullyHoist: true` to `pnpm-workspace.yaml`; clean reinstall                                                                                                                            |
+| `Can't resolve 'styled-components'` / `@elliemae/pui-theme` | Same — hoisting ignored if still only in `.npmrc`                                                                                                                                                 |
+| `publicHoistPattern: []` in `.modules.yaml`                 | Migrate hoist settings from `.npmrc` to `pnpm-workspace.yaml`                                                                                                                                     |
+| `ERR_PNPM_IGNORED_BUILDS`                                   | Set real `allowBuilds` in `pnpm-workspace.yaml` or run `pnpm approve-builds`                                                                                                                      |
+| `husky: command not found` on prepare                       | `shamefullyHoist` + `publicHoistPattern: [husky]` or direct root `devDependency`                                                                                                                  |
+| Storybook fails after pui-cli 9 bump                        | Migrate `.storybook/main.js` → `main.mjs`; import `getStorybookConfig` from `@elliemae/pui-app-sdk/storybook/main`; build app-sdk if using `file:` link                                           |
+| `Class private methods are not enabled` (Storybook build)   | Upgrade pui-cli 9 (private-method Babel plugins in shared `babelConfig`); remove duplicate plugins from consumer Babel config                                                                     |
+| Babel cannot load `babel.config.ts`                         | Confirm Node 24 (`.node-version`, CI); pui-cli 9 requires Node 24 for native TS config loading                                                                                                    |
+| `Failed to load native binding` / SWC errors                | pui-cli removes SWC from Storybook webpack; reinstall deps; Babel compiler addon uses pui-cli `babelConfig`                                                                                       |
+| `middleware.js` ignored / API mocks missing                 | Delete middleware file; pui-cli Storybook dev server loads routes automatically                                                                                                                   |
+| Jest `TextEncoder is not defined`                           | Built into pui-cli `jestConfig` — remove repo `jest-textencoder-setup.cjs`; keep `delete moduleNameMapper['@elliemae/pui-diagnostics']` only if using real package                                |
+| `require('@elliemae/pui-cli')` fails / `ERR_REQUIRE_ESM`    | pui-cli 9 is ESM-only — migrate configs to `.mjs`/`.ts` and use subpath imports (`@elliemae/pui-cli/eslint`, `/prettier`, `/jest`, etc.)                                                          |
+| Jest fails after pui-cli 9 bump                             | Migrate `jest.config.cjs` → `jest.config.mjs`; align `jest-cli@30`, `jest-environment-jsdom@30`, `@types/jest@30`, `jest-watch-typeahead@3`; fix deprecated matcher aliases; regenerate snapshots |
 
 Full rule comparison: [eslint-rules-migration.md](https://docs.pui.mortgagetech.q1.ice.com/cli/eslint-rules-migration) (also at `docs/eslint-rules-migration.md` in pui-cli).
 
@@ -299,7 +461,8 @@ Skills are copied to `.cursor/skills/`, `.claude/skills/`, and `.github/skills/`
 
 - Application business logic — migration is tooling/config only
 - Webpack/babel production build config — pui-cli 9 does not migrate apps to Vite for bundling
-- Prettier / commitlint configs unless pui-cli 9 bumps those presets
+- Prettier / commitlint preset values — migrate config **format** to `.mjs` when touching those files; do not change shared rule/preset content unless pui-cli 9 bumps them
+- **Org hoisting policy** — keep `shamefullyHoist: true`; do not remove hoisting or duplicate webpack deps in root `package.json` as a workaround
 
 ## Additional resources
 

package/dist/cjs/testing/{jest.config.cjs → jest.config.mjs}

@@ -1,15 +1,19 @@
-const path = require('path');
-const normalizePath = require('normalize-path');
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import normalizePath from 'normalize-path';
+
+const require = createRequire(import.meta.url);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
 const { getAppConfig, basePath } = require('../utils.cjs');
 const { swcrcConfig } = require('../transpile/swcrc.config.cjs');
 const { findMonoRepoRoot } = require('../monorepo/utils.cjs');
 
 let isReactModule = true;
 try {
-   
   require('react');
   require('styled-components');
-   
 } catch {
   isReactModule = false;
 }
@@ -80,7 +84,11 @@ const jestConfig = {
   },
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
   setupFilesAfterEnv: [path.resolve(__dirname, './setup-tests.js')],
-  setupFiles: ['raf/polyfill', 'whatwg-fetch'],
+  setupFiles: [
+    path.resolve(__dirname, './setup-textencoder.cjs'),
+    'raf/polyfill',
+    'whatwg-fetch',
+  ],
   testRegex: '(app|lib).*/tests/.*\\.test\\.[jt]sx?$',
   snapshotSerializers: [],
   testResultsProcessor: 'jest-sonar-reporter',
@@ -113,4 +121,4 @@ if (isReactModule && jestConfig.setupFilesAfterEnv)
     path.resolve(__dirname, './setup-react-env.js'),
   );
 
-exports.jestConfig = jestConfig;
+export { jestConfig };

package/dist/{esm/testing/jest.node.config.cjs → cjs/testing/jest.node.config.mjs}

@@ -1,5 +1,6 @@
-const { jestConfig } = require('./jest.config.cjs');
-exports.jestNodeConfig = {
+import { jestConfig } from './jest.config.mjs';
+
+export const jestNodeConfig = {
   ...jestConfig,
   testEnvironment: 'node',
   transformIgnorePatterns: [],

package/dist/cjs/testing/setup-textencoder.cjs

@@ -0,0 +1,4 @@
+const { TextDecoder, TextEncoder } = require('node:util');
+
+globalThis.TextEncoder = TextEncoder;
+globalThis.TextDecoder = TextDecoder;

package/dist/cjs/webpack/webpack.storybook.js

@@ -29,15 +29,28 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var webpack_storybook_exports = {};
 __export(webpack_storybook_exports, {
   managerWebpack: () => managerWebpack,
+  resolveStorybookAddon: () => resolveStorybookAddon,
   webpackFinal: () => webpackFinal
 });
 module.exports = __toCommonJS(webpack_storybook_exports);
+var import_node_module = require("node:module");
+var import_node_url = require("node:url");
 var import_webpack = __toESM(require("webpack"), 1);
 var import_mini_css_extract_plugin = __toESM(require("mini-css-extract-plugin"), 1);
 var import_copy_webpack_plugin = __toESM(require("copy-webpack-plugin"), 1);
 var import_resolve_typescript_plugin = __toESM(require("resolve-typescript-plugin"), 1);
 var import_helpers = require("./helpers.js");
+var import_appRoutes = require("../server/appRoutes.js");
 var import_utils = require("../utils.js");
+const import_meta = {};
+const puiCliRequire = (0, import_node_module.createRequire)((0, import_node_url.fileURLToPath)(import_meta.url));
+const resolveStorybookAddon = (addonName) => {
+  try {
+    return puiCliRequire.resolve(addonName);
+  } catch {
+    return addonName;
+  }
+};
 const IS_APP = (0, import_utils.isApp)();
 const CWD = process.cwd();
 const getAdditionalPlugins = () => [
@@ -84,12 +97,50 @@ const getModuleRules = () => [
     type: "asset/resource"
   }
 ];
+const setupStorybookMiddlewares = (middlewares, devServer) => {
+  if (devServer.app) {
+    (0, import_appRoutes.loadRoutes)(devServer.app).catch((err) => {
+      console.error(err);
+    });
+  }
+  return middlewares;
+};
+const usesSwcLoader = (rule) => {
+  if (typeof rule.loader === "string" && rule.loader.includes("swc-loader")) {
+    return true;
+  }
+  const uses = Array.isArray(rule.use) ? rule.use : rule.use ? [rule.use] : [];
+  return uses.some((useEntry) => {
+    const loader = typeof useEntry === "string" ? useEntry : useEntry.loader;
+    return loader?.includes("swc-loader");
+  });
+};
+const removeSwcLoaderRules = (rules = []) => rules.filter((rule) => !usesSwcLoader(rule)).map((rule) => {
+  if (rule.oneOf) {
+    return {
+      ...rule,
+      oneOf: removeSwcLoaderRules(rule.oneOf)
+    };
+  }
+  if (rule.rules) {
+    return {
+      ...rule,
+      rules: removeSwcLoaderRules(rule.rules)
+    };
+  }
+  return rule;
+});
 const webpackFinal = (config, { configType }) => {
   const isProd = configType === "PRODUCTION";
   const fileLoaderRule = config?.module?.rules?.find?.(
     (rule) => rule.test?.test?.(".svg")
   );
   if (fileLoaderRule) fileLoaderRule.exclude = /\.svg$/i;
+  if (config.module?.rules) {
+    config.module.rules = removeSwcLoaderRules(
+      config.module.rules
+    );
+  }
   config?.module?.rules?.unshift(...getModuleRules());
   config?.plugins?.push(...getAdditionalPlugins());
   if (isProd) {
@@ -118,6 +169,17 @@ const webpackFinal = (config, { configType }) => {
     config.externals["@elliemae/pui-diagnostics"] = "emuiDiagnostics";
     config.externals["@elliemae/pui-logrocket"] = "emuiLogrocket";
   }
+  if (!isProd) {
+    const existingDevServer = config.devServer ?? {};
+    const existingSetupMiddlewares = existingDevServer.setupMiddlewares;
+    config.devServer = {
+      ...existingDevServer,
+      setupMiddlewares: (middlewares, devServer) => {
+        const nextMiddlewares = typeof existingSetupMiddlewares === "function" ? existingSetupMiddlewares(middlewares, devServer) : middlewares;
+        return setupStorybookMiddlewares(nextMiddlewares, devServer);
+      }
+    };
+  }
   return config;
 };
 const managerWebpack = (config) => {

package/dist/esm/babel.config.js

@@ -0,0 +1,94 @@
+import fs from "node:fs";
+import path from "node:path";
+const isApp = () => fs.existsSync(path.join(process.cwd(), "app"));
+const nodeEnvPreset = {
+  modules: process.env.ES_MODULES === "false" ? "commonjs" : false,
+  targets: {
+    node: "current"
+  }
+};
+const webEnvPreset = {
+  modules: process.env.ES_MODULES === "false" ? "commonjs" : false,
+  useBuiltIns: "usage",
+  corejs: { version: "3.36", proposals: true }
+};
+const presetEnvOptions = process.env.TARGET_ENV === "node" ? nodeEnvPreset : webEnvPreset;
+const config = {
+  ignore: [/\/core-js/],
+  sourceType: "unambiguous",
+  presets: [
+    ["@babel/preset-env", presetEnvOptions],
+    ["@babel/preset-react", { runtime: "automatic" }],
+    "@babel/preset-typescript"
+  ],
+  plugins: [
+    [
+      "babel-plugin-module-resolver",
+      {
+        alias: {
+          "@": isApp() ? "./app" : "./lib"
+        },
+        stripExtensions: []
+      }
+    ],
+    ["babel-plugin-styled-components", { displayName: true }],
+    ["@babel/plugin-transform-runtime", { regenerator: true }],
+    "@babel/plugin-proposal-class-properties",
+    "@babel/plugin-transform-private-methods",
+    "@babel/plugin-transform-private-property-in-object",
+    "@babel/plugin-syntax-dynamic-import",
+    "@babel/plugin-proposal-export-default-from",
+    "lodash",
+    "date-fns"
+  ],
+  env: {
+    development: {
+      plugins: [
+        ["babel-plugin-styled-components", { displayName: true }],
+        "@babel/plugin-transform-react-jsx-source"
+      ]
+    },
+    production: {
+      plugins: [
+        ["babel-plugin-styled-components", { displayName: false, pure: true }],
+        ["transform-remove-console", { exclude: ["error", "warn"] }],
+        "transform-react-remove-prop-types",
+        "@babel/plugin-transform-react-inline-elements",
+        "@babel/plugin-transform-react-constant-elements"
+      ]
+    },
+    test: {
+      plugins: [
+        ["babel-plugin-styled-components", { displayName: true }],
+        "@babel/plugin-transform-modules-commonjs",
+        "dynamic-import-node",
+        [
+          "babel-plugin-transform-strip-block",
+          {
+            requireDirective: true,
+            identifiers: [{ start: "block:start", end: "block:end" }]
+          }
+        ],
+        "babel-plugin-import-remove-resource-query"
+      ]
+    }
+  }
+};
+if (process.env.STORYBOOK_BUILD !== "true" && process.env.TARGET_ENV !== "node") {
+  config.env?.development?.plugins?.push?.("react-refresh/babel");
+}
+if (process.env.ES_MODULES === "false") {
+  config.plugins?.push?.([
+    "babel-plugin-transform-strip-block",
+    {
+      requireDirective: true,
+      identifiers: [{ start: "block:start", end: "block:end" }]
+    }
+  ]);
+}
+const babelConfig = config;
+var babel_config_default = babelConfig;
+export {
+  babelConfig,
+  babel_config_default as default
+};

package/dist/esm/commands/storybook.js

@@ -1,13 +1,27 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { exec, logInfo, logError, logSuccess } from "./utils.js";
+const DEFAULT_PORT = 11e3;
+const puiCliRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "../../.."
+);
+const storybookBin = path.join(puiCliRoot, "node_modules/.bin/storybook");
+const crossEnvBin = path.join(puiCliRoot, "node_modules/.bin/cross-env");
+const puiCliNodeModules = path.join(puiCliRoot, "node_modules");
+const getStorybookEnv = () => {
+  const nodePath = [puiCliNodeModules, process.env.NODE_PATH].filter(Boolean).join(path.delimiter);
+  return `NODE_PATH="${nodePath}"`;
+};
 const buildStoryBook = async (outputDir = "demo", isDoc = false) => {
   const additionalParams = isDoc ? `--docs -o ${outputDir}/docs` : `-o ${outputDir}`;
   await exec(
-    `cross-env NODE_ENV=production build-storybook --quiet ${additionalParams}`
+    `"${crossEnvBin}" ${getStorybookEnv()} NODE_ENV=production "${storybookBin}" build --quiet ${additionalParams}`
   );
 };
-const startStoryBook = async (isDoc = false) => {
+const startStoryBook = async (isDoc = false, port = DEFAULT_PORT) => {
   await exec(
-    `cross-env NODE_ENV=development STORYBOOK_BUILD=true start-storybook ${isDoc ? "--docs" : ""} -p 11000 --quiet`
+    `"${crossEnvBin}" ${getStorybookEnv()} NODE_ENV=development STORYBOOK_BUILD=true "${storybookBin}" dev ${isDoc ? "--docs" : ""} -p ${port} --quiet`
   );
 };
 const cmdArgs = {
@@ -24,13 +38,17 @@ const cmdArgs = {
     string: true,
     alias: "o",
     default: "demo"
+  },
+  port: {
+    number: true,
+    default: DEFAULT_PORT
   }
 };
 const storybookCmd = {
   handler: async (argv) => {
     try {
       if (!argv.build) {
-        await startStoryBook(argv.docs);
+        await startStoryBook(argv.docs, argv.port);
         logInfo("Storybook started");
       } else {
         await buildStoryBook(argv.output, argv.docs);

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-import { babelConfig } from "./babel.config.cjs";
+import { babelConfig } from "./babel.config.js";
 import {
   eslintFlatBaseConfig,
   eslintFlatBaseConfigStrict
@@ -7,21 +7,17 @@ import {
   eslintFlatConfig,
   eslintFlatConfigStrict
 } from "./lint-config/eslint/flat/react-export.mjs";
-import { esConfig } from "./lint-config/eslint/non-react.cjs";
-import { esReactConfig } from "./lint-config/eslint/react.cjs";
 import { stylelintConfig } from "./lint-config/stylelint/export.mjs";
-import { prettierConfig } from "./lint-config/prettier.config.cjs";
-import { commitlintConfig } from "./lint-config/commitlint.config.cjs";
-import { jestConfig } from "./testing/jest.config.cjs";
+import { prettierConfig } from "./lint-config/prettier.config.mjs";
+import { commitlintConfig } from "./lint-config/commitlint.config.mjs";
+import { jestConfig } from "./testing/jest.config.mjs";
 import { vitestConfig } from "./testing/vitest.config.js";
-import { jestNodeConfig } from "./testing/jest.node.config.cjs";
+import { jestNodeConfig } from "./testing/jest.node.config.mjs";
 import { lintStagedConfig } from "./lint-config/lint-staged.config.js";
 import { loadRoutes } from "./server/appRoutes.js";
 export {
   babelConfig,
   commitlintConfig,
-  esConfig as eslintBaseConfig,
-  esReactConfig as eslintConfig,
   eslintFlatBaseConfig,
   eslintFlatBaseConfigStrict,
   eslintFlatConfig,

package/dist/esm/lint-config/commitlint/export.mjs

@@ -0,0 +1 @@
+export { commitlintConfig, default } from '../commitlint.config.mjs';

package/dist/esm/lint-config/commitlint.config.mjs

@@ -0,0 +1,6 @@
+/** @type {import('@commitlint/types').UserConfig} */
+export const commitlintConfig = {
+  extends: ['@commitlint/config-conventional'],
+};
+
+export default commitlintConfig;

package/dist/esm/lint-config/eslint/common.cjs

@@ -1,5 +1,12 @@
  
-const prettierOptions = require("../prettier.config.cjs");
+const prettierOptions = {
+  printWidth: 80,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+};
 // const webpackConfig = require('../../webpack/webpack.prod.babel');
 
 exports.baseExtends = [