@tristan2828/ui-foundation 4.61.0 → 4.61.1

package/dist/components/app/milkdown-editor.js

@@ -814,8 +814,9 @@ export default function MilkdownEditor({ id, defaultValue, onChange, onProblem,
                 void editor.destroy();
             root.replaceChildren();
         };
-        // Made once per mount: later changes to defaultValue are ignored, as
-        // with any uncontrolled input. Attributes and read-only follow below.
+        // Made once per mount. A new defaultValue the editor didn't report
+        // remounts it (RichTextEditor's key), so it isn't read here.
+        // Attributes and read-only follow below.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
     // Read-only and the ARIA attributes follow their props.

package/dist/components/app/rich-text-editor.d.ts

@@ -3,7 +3,11 @@ import type { HeadingFrom, HeadingLevel } from './prose-look.js';
 export type RichTextEditorProps = {
     /** The editable element's id, for a label's `htmlFor` or a test. */
     id?: string;
-    /** The Markdown it opens with. Read once, when it mounts (uncontrolled). */
+    /**
+     * The Markdown it opens with. A later value the editor didn't report
+     * (a record loaded after it mounted, a reset) replaces the text; the
+     * value it reported, passed back, changes nothing.
+     */
     defaultValue: string;
     /** The Markdown to save, after every edit: untouched blocks as originally written. */
     onChange: (markdown: string) => void;

package/dist/components/app/rich-text-editor.js

@@ -26,13 +26,41 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // With `foldKey`, the text folds by its headings (NotesOutline lists them
 // beside it), the Markdown untouched.
 //
+// `defaultValue` is read when it mounts, then followed: a new value the
+// editor didn't report itself (a form's loaded record arriving after the
+// editor, a reset) replaces the text, as if it opened with it. Its own
+// edits, coming back as the value, change nothing, so the caret stays
+// where it is. A caller that never feeds `onChange` back keeps its text.
+//
 // The editor (Milkdown) is loaded on first use, so a page that only reads
 // Markdown never downloads it. Until it arrives, a placeholder the size of
 // the field shows.
-import { lazy, Suspense } from 'react';
+import { lazy, Suspense, useState } from 'react';
 import { cn } from 'cn';
 import { Skeleton } from '../ui/skeleton.js';
 const MilkdownEditor = lazy(() => import('./milkdown-editor.js'));
+// When the editor opens again: each time `defaultValue` changes to
+// Markdown it didn't report. Adjusted while rendering (React's "storing
+// information from previous renders"), so the new text never shows a
+// frame late.
+function useOpenings(defaultValue) {
+    const [seen, setSeen] = useState(defaultValue);
+    const [reported, setReported] = useState(defaultValue);
+    const [opening, setOpening] = useState(0);
+    if (defaultValue !== seen) {
+        setSeen(defaultValue);
+        if (defaultValue !== reported) {
+            setReported(defaultValue);
+            setOpening(opening + 1);
+        }
+    }
+    return { opening, report: setReported };
+}
 export function RichTextEditor(props) {
-    return (_jsx(Suspense, { fallback: _jsxs("div", { "data-slot": "rich-text-editor", "data-state": "loading", className: cn('flex w-full flex-col', !props.inline && 'rounded-lg border border-input', props.className), children: [(props.toolbar ?? true) === true && _jsx("div", { className: "h-9 border-b border-input" }), _jsxs("div", { className: cn('flex flex-col gap-2', props.inline ? 'py-0.5' : 'min-h-24 px-2.5 py-2'), children: [_jsx(Skeleton, { className: "h-4 w-3/4" }), _jsx(Skeleton, { className: "h-4 w-1/2" })] })] }), children: _jsx(MilkdownEditor, { ...props, foldKey: props.foldable === false ? undefined : props.foldKey }) }));
+    const { opening, report } = useOpenings(props.defaultValue);
+    const { onChange } = props;
+    return (_jsx(Suspense, { fallback: _jsxs("div", { "data-slot": "rich-text-editor", "data-state": "loading", className: cn('flex w-full flex-col', !props.inline && 'rounded-lg border border-input', props.className), children: [(props.toolbar ?? true) === true && _jsx("div", { className: "h-9 border-b border-input" }), _jsxs("div", { className: cn('flex flex-col gap-2', props.inline ? 'py-0.5' : 'min-h-24 px-2.5 py-2'), children: [_jsx(Skeleton, { className: "h-4 w-3/4" }), _jsx(Skeleton, { className: "h-4 w-1/2" })] })] }), children: _jsx(MilkdownEditor, { ...props, onChange: (markdown) => {
+                report(markdown);
+                onChange(markdown);
+            }, foldKey: props.foldable === false ? undefined : props.foldKey }, opening) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tristan2828/ui-foundation",
-  "version": "4.61.0",
+  "version": "4.61.1",
   "description": "Shared UI foundation for contract-first, database-backed React apps: shadcn primitives, DataTable/EntityForm composites, auth, the gateway error seam, design tokens, lint rules and the AI playbook.",
   "license": "MIT",
   "repository": {