@mieweb/ui 0.11.0-dev.48 → 0.11.0-dev.49

package/MIGRATION.md

@@ -23,10 +23,30 @@ and `@kerebron/wasm` (tested together at 0.8.12). Import `@mieweb/ui/kerebron.cs
 and serve `@kerebron/wasm/assets` at `/kerebron-wasm`. Apply the Kerebron patches
 described by the RichEditor documentation for its toolbar and Markdown marks.
 
-**Required for Kerebron 0.8.12:** configure the consuming application's package
-manager to resolve every `prosemirror-view` dependency to **1.42.3**. Kerebron
-pins 1.40.0, while the protected MDY link bridge uses 1.42.3. Two view instances
-can make decorations incompatible and leave the older view's behavior active.
+**Required for Kerebron 0.8.12:** install the `@kerebron/*` peers at **exactly
+0.8.12** (the tested set) and configure the consuming application's package
+manager to resolve every ProseMirror core package to a **single version**.
+Without this, a fresh install loads multiple copies of `prosemirror-model`
+and typing throws:
+
+```
+RangeError: Can not convert <…> to a Fragment
+(looks like multiple versions of prosemirror-model were loaded)
+```
+
+Two mechanisms split the versions (mieweb/ui#709). First, `@mieweb/ui` and
+Kerebron 0.8.12 both pin `prosemirror-model` 1.25.9 / `prosemirror-state`
+1.4.3 exactly, but Kerebron 0.8.13 pins different versions — a `^0.8.12`
+range drifts onto it, and the exact pins can never dedupe. Second, even with
+matching pins, ProseMirror's own `^`-ranged internal dependencies (for
+example `prosemirror-state → prosemirror-model ^1.0.0`) resolve to the
+newest release on any fresh install; this repository is only protected by
+its frozen lockfile. `pnpm dedupe` cannot fix either case, so overrides are
+required. (`prosemirror-view` additionally needs 1.42.3 rather than
+Kerebron's pinned 1.40.0: the protected MDY link bridge uses 1.42.3, and two
+view instances can make decorations incompatible and leave the older view's
+behavior active.)
+
 The overrides in this library's checkout do not propagate to installed apps.
 
 For pnpm 10, add to the host's `pnpm-workspace.yaml`:
@@ -34,6 +54,9 @@ For pnpm 10, add to the host's `pnpm-workspace.yaml`:
 ```yaml
 overrides:
   prosemirror-view: "1.42.3"
+  prosemirror-model: "1.25.9"
+  prosemirror-state: "1.4.3"
+  prosemirror-transform: "1.10.4"
 ```
 
 For npm, add to the host's `package.json`:
@@ -41,7 +64,10 @@ For npm, add to the host's `package.json`:
 ```json
 {
   "overrides": {
-    "prosemirror-view": "1.42.3"
+    "prosemirror-view": "1.42.3",
+    "prosemirror-model": "1.25.9",
+    "prosemirror-state": "1.4.3",
+    "prosemirror-transform": "1.10.4"
   }
 }
 ```
@@ -51,16 +77,20 @@ For Yarn, add to the host's `package.json`:
 ```json
 {
   "resolutions": {
-    "prosemirror-view": "1.42.3"
+    "prosemirror-view": "1.42.3",
+    "prosemirror-model": "1.25.9",
+    "prosemirror-state": "1.4.3",
+    "prosemirror-transform": "1.10.4"
   }
 }
 ```
 
-If the host also declares `prosemirror-view` directly, pin that dependency to
-1.42.3. Reinstall and inspect `pnpm why prosemirror-view`,
-`npm ls prosemirror-view` or `yarn why prosemirror-view`: every resolved instance
-must be 1.42.3. Keep this requirement until a tested Kerebron release shares the
-same view version without an override.
+If the host also declares any of these packages directly, pin those
+dependencies to the same versions. Reinstall and inspect
+`pnpm why prosemirror-model` / `pnpm why prosemirror-view` (or the
+`npm ls` / `yarn why` equivalents): every resolved instance of each package
+must be a single version. Keep this requirement until a tested Kerebron
+release shares the same ProseMirror versions without an override.
 
 **Recommended for EncounterVisit hosts:** resolve `js-yaml` to **4.3.2 or
 newer**. `@mieweb/templit` 0.2.0 (a direct dependency used by
@@ -87,8 +117,9 @@ peers** (only the Yjs collaboration peers — `@kerebron/extension-yjs`,
 `yjs`, `y-protocols` — remain optional):
 
 ```sh
-npm install @kerebron/editor @kerebron/editor-kits \
-  @kerebron/extension-basic-editor @kerebron/extension-menu @kerebron/wasm
+npm install --save-exact @kerebron/editor@0.8.12 @kerebron/editor-kits@0.8.12 \
+  @kerebron/extension-basic-editor@0.8.12 @kerebron/extension-menu@0.8.12 \
+  @kerebron/wasm@0.8.12
 ```
 
 ```ts
@@ -102,8 +133,8 @@ serve `@kerebron/wasm`'s `assets/` directory at that path (or pass your own
 `<Textarea richText={false}>` or `TextAreaPlain` — but the peers must be
 installable for the package to resolve.
 
-Because every consumer now resolves Kerebron, the **`prosemirror-view`
-1.42.3 override and the Kerebron patches** described under
+Because every consumer now resolves Kerebron, the **ProseMirror version
+overrides and the Kerebron patches** described under
 [eSheet and EncounterVisit](#esheet-and-encountervisit) above also apply to
 every consumer — previously only EncounterVisit RichEdit hosts needed them.
 Note that package managers that auto-install peers (npm 7+, pnpm 8+ by

package/README.md

@@ -166,7 +166,9 @@ AGGrid is deprecated for new work; start with DataVis NITRO for tabular data.
 Their shared `@esheet/styles` dependency supplies eSheet CSS automatically;
 keep loading `@mieweb/ui/styles.css` for the composed controls. EncounterVisit's
 RichEdit mode also needs the Kerebron peers, CSS and WASM assets. **With Kerebron
-0.8.12, the host must override every `prosemirror-view` resolution to 1.42.3.**
+0.8.12, the host must override the ProseMirror core packages to single
+versions (`prosemirror-view` 1.42.3, `prosemirror-model` 1.25.9,
+`prosemirror-state` 1.4.3, `prosemirror-transform` 1.10.4).**
 The library's development override does not configure an installed consumer.
 Follow the shipped [eSheet and EncounterVisit setup](https://github.com/mieweb/ui/blob/main/MIGRATION.md#esheet-and-encountervisit)
 for the package-manager configuration and verification command.

package/agent/skills/mieweb-ui-tailwind4/SKILL.md

@@ -14,7 +14,7 @@ npm install @mieweb/ui react react-dom
 npm install -D tailwindcss@4 @tailwindcss/postcss autoprefixer
 ```
 
-`react` / `react-dom` (>=18) are **required** peers, and so are the five `@kerebron/*` runtime packages (`editor`, `editor-kits`, `extension-basic-editor`, `extension-menu`, `wasm`) — the main-barrel `Textarea` rides the Kerebron engine, and bundling it would duplicate `prosemirror-state` in consumer apps. Every other peer is **optional** and only needed when you import the entry that uses it (`/maps` → leaflet, `/globe` → react-globe.gl + three, collab → @kerebron/extension-yjs + yjs + y-protocols, `/motion` → motion, `/q` → @mieweb/q, …) — see the catalog skill's entry-point table. A peer-dep warning for an entry you never import is noise, not a problem. Under pnpm's strict node_modules there is no hoisting: required peers must be in the app's own `package.json`; diagnose resolution with `pnpm why <pkg>`.
+`react` / `react-dom` (>=18) are **required** peers, and so are the five `@kerebron/*` runtime packages (`editor`, `editor-kits`, `extension-basic-editor`, `extension-menu`, `wasm`) — the main-barrel `Textarea` rides the Kerebron engine, and bundling it would duplicate `prosemirror-state` in consumer apps. Install the Kerebron peers at **exactly 0.8.12** (the tested set) and add the ProseMirror overrides from [MIGRATION.md](https://github.com/mieweb/ui/blob/main/MIGRATION.md#esheet-and-encountervisit) — `prosemirror-view` 1.42.3, `prosemirror-model` 1.25.9, `prosemirror-state` 1.4.3, `prosemirror-transform` 1.10.4 (pnpm 10: `overrides:` in `pnpm-workspace.yaml`; npm: `"overrides"`; Yarn: `"resolutions"`). Without the overrides a fresh install resolves multiple `prosemirror-model` copies and typing in every editor breaks (mieweb/ui#709); `pnpm dedupe` cannot fix it. Every other peer is **optional** and only needed when you import the entry that uses it (`/maps` → leaflet, `/globe` → react-globe.gl + three, collab → @kerebron/extension-yjs + yjs + y-protocols, `/motion` → motion, `/q` → @mieweb/q, …) — see the catalog skill's entry-point table. A peer-dep warning for an entry you never import is noise, not a problem. Under pnpm's strict node_modules there is no hoisting: required peers must be in the app's own `package.json`; diagnose resolution with `pnpm why <pkg>`.
 
 Install the **published package from the npm registry**. Installing from the git repo (`npm install github:mieweb/ui`) is unsupported — the source tree is a pnpm workspace with `link:` dependencies and submodules (mieweb/ui#489).
 
@@ -118,6 +118,7 @@ Filters/selection/pagination state is yours (usually the URL); `ViewSet` owns on
 | Peer-dep install errors | Required vs optional confusion | react/react-dom + the five @kerebron/* runtime peers are required; match optional peers to imported entries |
 | Dark variant + brand tokens missing; build warns `@import statements must precede…` | `@source` placed between the `@import`s — PostCSS silently drops the late `init.css` import (mieweb/ui#705) | Both `@import`s first and consecutive, `@source` after them |
 | `vite build` fails: `MISSING_EXPORT` from `@kerebron/extension-yjs` / `y-websocket` in a `collabKit-*` chunk | Optional collab peers not installed; @mieweb/ui versions before the mieweb/ui#706 fix had static named imports in the lazy collab chunk, and Vite's optional-peer stub has no named exports | Upgrade @mieweb/ui; on older versions, externalize: `build.rollupOptions.external: [/^@kerebron\/extension-yjs/, /^y-websocket/]` (collab stays optional either way) |
+| Editor renders but typing throws `Can not convert … to a Fragment (looks like multiple versions of prosemirror-model)` | Multiple ProseMirror copies: Kerebron 0.8.13 pins different versions than @mieweb/ui, and transitive `^`-ranges float to the newest release on fresh installs (mieweb/ui#709) | Pin `@kerebron/*` to 0.8.12 exactly + add the four ProseMirror overrides (see Install above); verify with `pnpm why prosemirror-model` — a single version must remain |
 | Module shows failed action as success | `on*` promise swallowed | Return the real promise (`mutateAsync` / `callAsync`) |
 | Views regroup on every render | Unstable `accessors` | Module scope or `useMemo` |
 | `transition-*` utilities stop working after theme/brand CSS | The brand CSS's unlayered `*` transition shorthand resets `transition-property` on every element and beats layered utilities, even though it lists only color properties (mieweb/ui#460, #682) | Move the transition rule into `@layer base` (or remove/narrow it) so component transitions win; keep brand token declarations unlayered |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mieweb/ui",
-  "version": "0.11.0-dev.48",
+  "version": "0.11.0-dev.49",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",