@elliemae/pui-cli 9.0.0-alpha.10 → 9.0.0-alpha.12

package/dist/esm/lint-config/eslint/flat/compat.mjs

@@ -2,7 +2,7 @@
  * ESLint 10 removed deprecated context APIs (e.g. getSourceCode, getScope, getFilename).
  * Wrap legacy plugins via @eslint/compat v2 (ESLint 10–aware fixupPluginRules).
  */
-import { fixupConfigRules, fixupPluginRules } from '@eslint/compat';
+import { fixupPluginRules } from '@eslint/compat';
 import react from 'eslint-plugin-react';
 import reduxSaga from 'eslint-plugin-redux-saga';
 import storybook from 'eslint-plugin-storybook';
@@ -20,8 +20,8 @@ export const reactPlugin = fixupPluginRules(react);
 /** @type {import('eslint').ESLint.Plugin} */
 export const reduxSagaPlugin = fixupPluginRules(reduxSaga);
 
-/** Storybook flat presets — uses legacy context APIs (eslint-plugin-storybook@0.12). */
+/** Storybook flat presets — native flat config (eslint-plugin-storybook@10). */
 /** @type {import('eslint').Linter.Config[]} */
-export const storybookFlatConfigs = fixupConfigRules(
-  Array.isArray(storybookFlat) ? storybookFlat : [storybookFlat],
-);
+export const storybookFlatConfigs = Array.isArray(storybookFlat)
+  ? storybookFlat
+  : [storybookFlat];

package/dist/esm/skills/migrate-storybook-out-of-cjs/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: migrate-storybook-out-of-cjs
+description: >-
+  Migrate PUI Storybook from CJS wrappers and @elliemae/pui-app-sdk/storybook/cjs/* to ESM
+  (.storybook/*.mjs) and @elliemae/pui-app-sdk/storybook/* imports. Use when upgrading Storybook
+  10 with pui-cli 9, replacing require() in .storybook/main.js, removing storybook/cjs/main or
+  storybook/cjs/middleware, deleting .storybook/middleware.js, or converting preview/manager/theme
+  to ESM.
+---
+
+# Migrate Storybook out of CJS
+
+Moves consumer repos from legacy CommonJS Storybook wrappers (`require('@elliemae/pui-app-sdk/storybook/cjs/...')`) to ESM (`.storybook/*.mjs` + `@elliemae/pui-app-sdk/storybook/*`).
+
+Requires **pui-cli 9** and a matching **pui-app-sdk** release on the same train. The `storybook/cjs/*` package paths are **removed** from pui-app-sdk — repos still on CJS imports will fail at install or runtime.
+
+For the full pui-cli 9 upgrade (Node 24, ESLint 10, etc.), install `migrate-to-pui-cli-9` first or in parallel.
+
+## When to use
+
+- `.storybook/main.js` uses `require('@elliemae/pui-app-sdk/storybook/cjs/main')`
+- `.storybook/middleware.js` exists or imports `storybook/cjs/middleware`
+- Storybook fails after bumping pui-app-sdk with “Cannot find module …/storybook/cjs/…”
+- Moving from Storybook 6 CJS config to Storybook 10 ESM config with pui-cli
+
+## What changed
+
+| Topic             | Before (CJS / SB6)                         | After (ESM / SB10)                                               |
+| ----------------- | ------------------------------------------ | ---------------------------------------------------------------- |
+| Consumer config   | `.storybook/main.js`                       | `.storybook/main.mjs`                                            |
+| Shared import     | `@elliemae/pui-app-sdk/storybook/cjs/main` | `@elliemae/pui-app-sdk/storybook/main`                           |
+| Export name       | `getConfig()` (CJS default)                | **`getStorybookConfig()`** (named export)                        |
+| API mocks         | `.storybook/middleware.js`                 | Built into pui-cli Storybook dev server                          |
+| Preview / manager | `.storybook/preview.js`, `manager.js`      | `.storybook/preview.mjs`, `manager.mjs` (when using ESM imports) |
+| CLI               | `start-storybook` / `build-storybook`      | `pui-cli storybook` → `storybook dev` / `storybook build`        |
+| Addons            | Installed in consumer `package.json`       | Bundled in pui-cli; resolved via pui-app-sdk                     |
+
+## Pre-flight
+
+1. Bump `@elliemae/pui-cli@9` and `@elliemae/pui-app-sdk@*` together.
+2. Run `pnpm install`. If using a local `file:` link to pui-app-sdk, reinstall after rebuilding app-sdk so workspace `node_modules` picks up fresh dist.
+3. Confirm the repo uses `pui-cli storybook` (not raw `start-storybook` scripts).
+
+## Migration steps
+
+### Step 1 — Replace `.storybook/main.js`
+
+Delete `main.js`. Create `.storybook/main.mjs`:
+
+```javascript
+import { getStorybookConfig } from '@elliemae/pui-app-sdk/storybook/main';
+
+export default getStorybookConfig();
+```
+
+**Do not** use `getConfig` or `require('…/storybook/cjs/main')` — those paths and names are removed.
+
+### Step 2 — Remove middleware
+
+Delete `.storybook/middleware.js` if present.
+
+pui-cli registers mock API routes during `storybook dev`. The deprecated `@elliemae/pui-app-sdk/storybook/middleware` export exists only for repos not yet on pui-cli 9 Storybook — **do not** add it back in new ESM configs.
+
+### Step 3 — Convert preview, manager, theme (if customized)
+
+If the repo only uses shared pui-app-sdk defaults, you may have no preview file — skip.
+
+**Minimal preview** (no custom theme):
+
+```javascript
+// .storybook/preview.mjs
+export {
+  decorators,
+  parameters,
+  loaders,
+} from '@elliemae/pui-app-sdk/storybook/preview';
+```
+
+**Preview with local theme** (see `pui-react-boilerplate`, `pui-app-sdk`):
+
+```javascript
+// .storybook/preview.mjs
+import {
+  getParameters,
+  loaders,
+  decorators,
+} from '@elliemae/pui-app-sdk/storybook/preview';
+import { theme } from './theme.mjs';
+
+const parameters = getParameters(theme);
+
+export { decorators, parameters, loaders };
+```
+
+**Manager / theme** — convert `manager.js` → `manager.mjs`, `theme.js` → `theme.mjs` when they use `import`/`export`:
+
+```javascript
+// .storybook/manager.mjs
+export { managerConfig } from '@elliemae/pui-app-sdk/storybook/manager';
+```
+
+```javascript
+// .storybook/theme.mjs
+export { theme } from '@elliemae/pui-app-sdk/storybook/theme';
+```
+
+Keep `.storybook/preview-head.html` unchanged.
+
+Delete obsolete `.js` duplicates after creating `.mjs` files (`preview.js`, `manager.js`, `theme.js`, `middleware.js`).
+
+### Step 4 — Monorepo lib packages (no `app/` directory)
+
+pui-app-sdk omits `../app/**` story globs when no `app/` folder exists. If globs still fail, filter explicitly in `main.mjs`:
+
+```javascript
+import { getStorybookConfig } from '@elliemae/pui-app-sdk/storybook/main';
+
+const config = getStorybookConfig();
+config.stories = config.stories.filter((s) => !s.includes('/app/'));
+
+export default config;
+```
+
+Pilot: `pui-mono-repo-boilerplate/libs/foo`.
+
+### Step 5 — Stories and types
+
+- Prefer CSF3 and `@storybook/react-webpack5` types where TypeScript fails.
+- Remove Storybook 6 webpack alias workarounds (MDX pinning, react-select hacks) unless a story still breaks after upgrade.
+- Consumers do **not** install `@storybook/addon-*` separately — addons resolve from pui-cli via pui-app-sdk.
+
+### Step 6 — ESLint
+
+Ensure `.storybook/**` is linted. After pui-cli 9 ESLint flat config migration, run `pnpm exec pui-cli lint` on story files.
+
+## Verify
+
+```bash
+pnpm exec pui-cli storybook              # dev, default port 11000
+pnpm exec pui-cli storybook -b           # static build to demo/
+pnpm exec pui-cli storybook -b --docs    # docs build
+pnpm exec pui-cli lint
+```
+
+Checklist:
+
+- [ ] No `require('@elliemae/pui-app-sdk/storybook/cjs/…')` anywhere
+- [ ] `.storybook/main.mjs` exists; `main.js` removed
+- [ ] `.storybook/middleware.js` removed (if it existed)
+- [ ] Story dev server starts; mock API routes work without middleware file
+- [ ] Static build succeeds
+
+## Troubleshooting
+
+| Symptom                                      | Fix                                                                                   |
+| -------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `Cannot find module '…/storybook/cjs/main'`  | Migrate to `@elliemae/pui-app-sdk/storybook/main` in `main.mjs`                       |
+| `getConfig is not a function`                | Use named import **`getStorybookConfig`**, not `getConfig`                            |
+| `Can't resolve './app'` in lib-only package  | Use conditional globs in app-sdk or filter `config.stories` in `main.mjs`             |
+| `Failed to load native binding` / SWC errors | Rebuild pui-app-sdk; reinstall workspace; Babel compiler addon is bundled via pui-cli |
+| “Using default Webpack5 setup” (no Babel)    | Refresh pnpm install after bumping `file:` pui-cli / pui-app-sdk links                |
+| API mocks missing                            | Delete middleware file; use `pui-cli storybook` (not legacy CLI)                      |
+| Stale app-sdk in monorepo                    | `pnpm install --ignore-scripts` after rebuilding linked packages                      |
+
+## Reference repos
+
+- `pui-react-boilerplate` — app with `app/` stories
+- `pui-mono-repo-boilerplate/libs/foo` — lib-only package
+- `pui-app-sdk/.storybook/` — dogfood ESM wrappers
+
+Full guide: [pui-cli 9 migration — Storybook 10](https://docs.pui.mortgagetech.q1.ice.com/cli/pui-cli-9-migration) (`docs/pui-cli-9-migration.md` in pui-cli).
+
+## Install this skill
+
+From a consumer repo (after `@elliemae/pui-cli` is installed):
+
+```bash
+pnpm exec pui-cli skills list
+pnpm exec pui-cli skills install migrate-storybook-out-of-cjs --target all
+```
+
+Skills are copied to `.cursor/skills/`, `.claude/skills/`, and `.github/skills/`.
+
+## What NOT to change
+
+- Production Webpack build config — Storybook migration is dev/docs tooling only
+- Business logic in stories unless types or CSF3 require it
+- Do not re-add `@storybook/*` addon packages to consumer `package.json` unless pui-cli docs explicitly require an exception

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

@@ -2,10 +2,11 @@
 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). Use when upgrading @elliemae/pui-cli, migrating from
-  .eslintrc.cjs to eslint.config.mjs, release.config.cjs to release.config.mjs, upgrading Husky 8
-  hooks, fixing Vitest 4 / coverage-v8 breakages, or adopting shared configs from pui-cli.
-  App/library production builds stay on Webpack.
+  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,
+  upgrading Husky 8 hooks, fixing Vitest 4 / coverage-v8 breakages, migrating monorepo nx.json from
+  @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
@@ -34,9 +35,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
@@ -221,29 +259,103 @@ export default {
 
 5. Dry-run: `pnpm exec semantic-release --dry-run`
 
-### Phase 9 — Verify
+### Phase 9 — Lerna 9 and Nx 22 (monorepos only)
+
+Skip for single-package apps/libs. Applies to repos with `lerna.json`, `nx.json`, and `libs/*` workspaces.
+
+1. After `@elliemae/pui-cli@9` is installed, confirm CLIs:
+
+```bash
+pnpm install
+pnpm exec nx --version    # 22.x
+pnpm exec lerna --version # 9.x
+```
+
+2. Remove legacy pins if present (`@nrwl/cli`, `@nrwl/tao`, `@nrwl/workspace`, direct `lerna`/`nx`).
+
+3. Migrate `nx.json`:
+   - `extends`: `@nrwl/workspace/presets/npm.json` → `nx/presets/npm.json`
+   - Add `$schema`: `./node_modules/nx/schemas/nx-schema.json`
+   - Replace `targetDependencies` with `targetDefaults.<target>.dependsOn` (use `^target` for dependency projects)
+   - 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.
+
+5. Smoke-test:
+
+```bash
+pnpm exec nx run-many --target=build --all --parallel
+pnpm exec nx affected --target=lint --uncommitted
+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 (out of CJS)
+
+Applies when the repo uses `pui-cli storybook`. Requires pui-cli 9 **and** a matching pui-app-sdk release.
+
+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 (`storybook/cjs/*` removed; use `.storybook/main.mjs` + `getStorybookConfig()`). Summary:
+
+1. Bump `@elliemae/pui-app-sdk` with `@elliemae/pui-cli@9`.
+2. Replace `.storybook/main.js` with `.storybook/main.mjs` importing `@elliemae/pui-app-sdk/storybook/main`.
+3. Delete `.storybook/middleware.js`; migrate `preview` / `manager` / `theme` to `.mjs` when customized.
+4. Update stories to CSF3 where types fail; remove SB6 webpack alias workarounds unless still required.
+
+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 addon removals and troubleshooting.
+
+### Phase 10 — Verify
 
+- [ ] `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)
 - [ ] `pnpm run build` (or `pui-cli build`) — Webpack, unchanged
 - [ ] Pre-commit / lint-staged passes (after Husky 9 migration if applicable)
+- [ ] Monorepos: `nx run-many --target=build --all` and `pui-cli version --help`
 - [ ] CI green on the target branch
 
 ## 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) |
+| 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`                                                                                             |
+| `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 `@elliemae/pui-app-sdk/storybook/main`                                                                           |
+| `Failed to load native binding` / SWC errors                | Ensure pui-app-sdk resolves Babel compiler from pui-cli; rebuild app-sdk and reinstall workspace deps                                                              |
+| `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 |
 
 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).
 
@@ -262,6 +374,7 @@ 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
+- **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/esm/testing/jest.config.cjs

@@ -80,7 +80,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',

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

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

package/dist/esm/webpack/webpack.storybook.js

@@ -1,9 +1,20 @@
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
 import webpack from "webpack";
 import MiniCssExtractPlugin from "mini-css-extract-plugin";
 import CopyWebpackPlugin from "copy-webpack-plugin";
 import ResolveTypeScriptPlugin from "resolve-typescript-plugin";
 import { getAlias, getLibraryAlias, getCompressionPlugins } from "./helpers.js";
+import { loadRoutes } from "../server/appRoutes.js";
 import { isApp } from "../utils.js";
+const puiCliRequire = createRequire(fileURLToPath(import.meta.url));
+const resolveStorybookAddon = (addonName) => {
+  try {
+    return puiCliRequire.resolve(addonName);
+  } catch {
+    return addonName;
+  }
+};
 const IS_APP = isApp();
 const CWD = process.cwd();
 const getAdditionalPlugins = () => [
@@ -50,12 +61,50 @@ const getModuleRules = () => [
     type: "asset/resource"
   }
 ];
+const setupStorybookMiddlewares = (middlewares, devServer) => {
+  if (devServer.app) {
+    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) {
@@ -84,6 +133,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) => {
@@ -93,5 +153,6 @@ const managerWebpack = (config) => {
 };
 export {
   managerWebpack,
+  resolveStorybookAddon,
   webpackFinal
 };

package/dist/types/lib/commands/storybook.d.ts

@@ -3,6 +3,7 @@ type Arguments = {
     build: boolean;
     docs: boolean;
     output: string;
+    port: number;
 };
 export declare const storybookCmd: CommandModule<Record<string, never>, Arguments>;
 export {};

package/dist/types/lib/lint-config/eslint/flat/compat.d.mts

@@ -4,6 +4,6 @@ export const reactPlugin: import("eslint").ESLint.Plugin;
 /** Redux-saga — uses context.getScope in no-yield-in-race. */
 /** @type {import('eslint').ESLint.Plugin} */
 export const reduxSagaPlugin: import("eslint").ESLint.Plugin;
-/** Storybook flat presets — uses legacy context APIs (eslint-plugin-storybook@0.12). */
+/** Storybook flat presets — native flat config (eslint-plugin-storybook@10). */
 /** @type {import('eslint').Linter.Config[]} */
 export const storybookFlatConfigs: import("eslint").Linter.Config[];

package/dist/types/lib/testing/setup-textencoder.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/types/lib/webpack/webpack.storybook.d.ts

@@ -1,4 +1,6 @@
 import webpack, { type Configuration } from 'webpack';
+/** Resolve Storybook addons from pui-cli's bundled dependencies. */
+export declare const resolveStorybookAddon: (addonName: string) => string;
 export declare const webpackFinal: (config: Configuration, { configType }: {
     configType: string;
 }) => webpack.Configuration;