@podlite/editor-react 0.0.40 → 0.0.42

package/esm/foldPodlite.d.ts

@@ -0,0 +1,2 @@
+import type { Extension } from '@codemirror/state';
+export declare const podliteFoldService: Extension;

package/esm/foldPodlite.js

@@ -0,0 +1,108 @@
+import { foldService } from '@codemirror/language';
+// =begin Name ... =end Name
+const beginRe = /^(\s*)=begin\s+(\S+)/;
+const endRe = /^(\s*)=end\s+(\S+)/;
+// =headN (level 1-6)
+const headRe = /^(\s*)=head(\d+)\s/;
+// Verbatim block types where content should not be folded
+const verbatimTypes = new Set(['code', 'comment', 'data', 'input', 'output']);
+// Parse =begin line, return block name or null
+function parseBeginLine(lineText) {
+    const m = lineText.match(beginRe);
+    return m ? m[2] ?? null : null;
+}
+// Cache verbatim ranges per document version to avoid rescanning on every fold query
+let _cachedVerbatimDoc = null;
+let _cachedVerbatimRanges = [];
+function getVerbatimRanges(state) {
+    // EditorState.doc is immutable — same reference means same content
+    if (_cachedVerbatimDoc === state.doc)
+        return _cachedVerbatimRanges;
+    const ranges = [];
+    for (let i = 1; i <= state.doc.lines; i++) {
+        const line = state.doc.line(i);
+        const m = line.text.match(beginRe);
+        if (m && verbatimTypes.has(m[2])) {
+            for (let j = i + 1; j <= state.doc.lines; j++) {
+                const endLine = state.doc.line(j);
+                const em = endLine.text.match(endRe);
+                if (em && em[2] === m[2]) {
+                    if (i + 1 <= j - 1) {
+                        ranges.push({ from: i + 1, to: j - 1 });
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    _cachedVerbatimDoc = state.doc;
+    _cachedVerbatimRanges = ranges;
+    return ranges;
+}
+function isInsideVerbatim(lineNumber, ranges) {
+    return ranges.some(r => lineNumber >= r.from && lineNumber <= r.to);
+}
+// Fold =begin Name ... =end Name: fold from end of =begin line to start of =end line
+function foldBeginEnd(state, lineStart) {
+    const line = state.doc.lineAt(lineStart);
+    const blockName = parseBeginLine(line.text);
+    if (!blockName)
+        return null;
+    // Search forward for matching =end
+    for (let i = line.number + 1; i <= state.doc.lines; i++) {
+        const candidate = state.doc.line(i);
+        const m = candidate.text.match(endRe);
+        if (m && m[2] === blockName) {
+            // Fold from end of =begin line to start of =end line
+            if (line.to >= candidate.from)
+                return null;
+            return { from: line.to, to: candidate.from };
+        }
+    }
+    return null;
+}
+// Fold =headN: from end of heading line to start of next heading of same or higher level (or EOF)
+function foldHeadSection(state, lineStart) {
+    const line = state.doc.lineAt(lineStart);
+    const m = line.text.match(headRe);
+    if (!m)
+        return null;
+    const level = parseInt(m[2] ?? '1', 10);
+    // Search forward for next heading of same or higher level
+    let foldEnd = state.doc.length;
+    for (let i = line.number + 1; i <= state.doc.lines; i++) {
+        const candidate = state.doc.line(i);
+        const hm = candidate.text.match(headRe);
+        if (hm) {
+            const candidateLevel = parseInt(hm[2] ?? '1', 10);
+            if (candidateLevel <= level) {
+                foldEnd = candidate.from;
+                break;
+            }
+        }
+    }
+    // Nothing to fold if heading is last line or only whitespace follows
+    if (line.to >= foldEnd)
+        return null;
+    // Trim trailing blank lines from fold range
+    let endPos = foldEnd;
+    while (endPos > line.to) {
+        const prevLine = state.doc.lineAt(endPos - 1);
+        if (prevLine.text.trim() !== '') {
+            endPos = prevLine.to;
+            break;
+        }
+        endPos = prevLine.from;
+    }
+    if (line.to >= endPos)
+        return null;
+    return { from: line.to, to: endPos };
+}
+export const podliteFoldService = foldService.of((state, lineStart) => {
+    const line = state.doc.lineAt(lineStart);
+    const verbatimRanges = getVerbatimRanges(state);
+    if (isInsideVerbatim(line.number, verbatimRanges))
+        return null;
+    return foldBeginEnd(state, lineStart) ?? foldHeadSection(state, lineStart);
+});
+//# sourceMappingURL=foldPodlite.js.map

package/esm/foldPodlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foldPodlite.js","sourceRoot":"","sources":["../src/foldPodlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAOlD,4BAA4B;AAC5B,MAAM,OAAO,GAAG,sBAAsB,CAAA;AACtC,MAAM,KAAK,GAAG,oBAAoB,CAAA;AAElC,qBAAqB;AACrB,MAAM,MAAM,GAAG,oBAAoB,CAAA;AAEnC,0DAA0D;AAC1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE7E,+CAA+C;AAC/C,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACjC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC;AAED,qFAAqF;AACrF,IAAI,kBAAkB,GAAY,IAAI,CAAA;AACtC,IAAI,qBAAqB,GAAgB,EAAE,CAAA;AAE3C,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,mEAAmE;IACnE,IAAI,kBAAkB,KAAK,KAAK,CAAC,GAAG;QAAE,OAAO,qBAAqB,CAAA;IAElE,MAAM,MAAM,GAAgB,EAAE,CAAA;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACjC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACpC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;oBACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;wBAClB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;qBACxC;oBACD,MAAK;iBACN;aACF;SACF;KACF;IACD,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAA;IAC9B,qBAAqB,GAAG,MAAM,CAAA;IAC9B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,MAAmB;IAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED,qFAAqF;AACrF,SAAS,YAAY,CAAC,KAAkB,EAAE,SAAiB;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IAE3B,mCAAmC;IACnC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;YAC3B,qDAAqD;YACrD,IAAI,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC1C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,IAAI,EAAE,CAAA;SAC7C;KACF;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,kGAAkG;AAClG,SAAS,eAAe,CAAC,KAAkB,EAAE,SAAiB;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IAEvC,0DAA0D;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAA;IAC9B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACvC,IAAI,EAAE,EAAE;YACN,MAAM,cAAc,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;YACjD,IAAI,cAAc,IAAI,KAAK,EAAE;gBAC3B,OAAO,GAAG,SAAS,CAAC,IAAI,CAAA;gBACxB,MAAK;aACN;SACF;KACF;IAED,qEAAqE;IACrE,IAAI,IAAI,CAAC,EAAE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAA;IAEnC,4CAA4C;IAC5C,IAAI,MAAM,GAAG,OAAO,CAAA;IACpB,OAAO,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC7C,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC/B,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAA;YACpB,MAAK;SACN;QACD,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAA;KACvB;IAED,IAAI,IAAI,CAAC,EAAE,IAAI,MAAM;QAAE,OAAO,IAAI,CAAA;IAElC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAc,WAAW,CAAC,EAAE,CACzD,CAAC,KAAkB,EAAE,SAAiB,EAAoB,EAAE;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9D,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;AAC5E,CAAC,CACF,CAAA"}

package/esm/index.d.ts

@@ -4,4 +4,6 @@ import HighlightedCode from './HighlightedCode';
 export { Editor2 as Editor2 };
 export { WindowWrapper as WindowWrapper };
 export { HighlightedCode as HighlightedCode };
+export type { EditorSessionState } from './types';
+export type { ConverterResult, IPodliteEditor, PodliteEditorRef } from './Editor';
 export default Editor2;

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAA;AAC9B,OAAO,aAAa,MAAM,WAAW,CAAA;AACrC,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,CAAA;AAC7B,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,CAAA;AACzC,OAAO,EAAE,eAAe,IAAI,eAAe,EAAE,CAAA;AAC7C,eAAe,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAA;AAC9B,OAAO,aAAa,MAAM,WAAW,CAAA;AACrC,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,CAAA;AAC7B,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,CAAA;AACzC,OAAO,EAAE,eAAe,IAAI,eAAe,EAAE,CAAA;AAG7C,eAAe,OAAO,CAAA"}

package/esm/listContinuation.d.ts

@@ -0,0 +1,3 @@
+import type { Extension } from '@codemirror/state';
+export declare const listContinuationKeymap: Extension;
+export declare const itemLevelKeymap: Extension;

package/esm/listContinuation.js

@@ -0,0 +1,124 @@
+import { keymap } from '@codemirror/view';
+// Regex: =item with optional level digit(s) + separator
+const itemRe = /^(\s*=item)(\d*)([ \t])/;
+// Detect list type prefix at start of content
+const prefixRe = /^(\[ \]|\[x\]|\[X\]|#)\s*/;
+// Item is "empty" if content is nothing or only a type prefix
+const emptyContentRe = /^(\[ \]|\[x\]|\[X\]|#)?\s*$/;
+// Parse, Don't Validate — returns typed structure or null
+function parseItemLine(lineText, lineFrom) {
+    const m = lineText.match(itemRe);
+    if (!m)
+        return null;
+    const prefix = m[1] ?? ''; // "\s*=item"
+    const digits = m[2] ?? ''; // level digits, may be empty
+    const sep = m[3] ?? ' '; // separator char
+    const indent = prefix.slice(0, prefix.length - 5); // whitespace before "=item"
+    const level = digits === '' ? 1 : parseInt(digits, 10);
+    const marker = `${indent}=item${digits}`;
+    return {
+        indent,
+        marker,
+        level,
+        separator: sep,
+        markerEnd: lineFrom + prefix.length + digits.length + sep.length,
+        content: lineText.slice(prefix.length + digits.length + sep.length),
+    };
+}
+// Get the prefix to insert for the new item (checked → unchecked, # → #, none → '')
+function resolveNewPrefix(content) {
+    const m = content.trim().match(prefixRe);
+    if (!m)
+        return '';
+    const prefix = m[1] ?? '';
+    if (prefix === '[x]' || prefix === '[X]' || prefix === '[ ]')
+        return '[ ] ';
+    if (prefix === '#')
+        return '# ';
+    return '';
+}
+// ─── List Continuation on Enter ────────────────────────────────────────────
+export const listContinuationKeymap = keymap.of([
+    {
+        key: 'Enter',
+        run: (view) => {
+            const { state } = view;
+            const { head, from, to } = state.selection.main;
+            // Only single cursor (no selection)
+            if (from !== to)
+                return false;
+            const line = state.doc.lineAt(head);
+            const item = parseItemLine(line.text, line.from);
+            if (!item)
+                return false;
+            // Cursor inside marker → default
+            if (head < item.markerEnd)
+                return false;
+            const trimmedContent = item.content.trim();
+            // Empty item (including prefix-only like "[ ]" or "#") → remove marker, exit list
+            if (emptyContentRe.test(trimmedContent)) {
+                view.dispatch({
+                    changes: { from: line.from, to: line.to, insert: '' },
+                    selection: { anchor: line.from },
+                });
+                return true;
+            }
+            // Determine type prefix for new item
+            const newPrefix = resolveNewPrefix(trimmedContent);
+            // Split: text before cursor stays, text after → new =itemN [prefix]
+            const textAfterCursor = line.text.slice(head - line.from);
+            const newItem = `\n${item.marker} ${newPrefix}`;
+            view.dispatch({
+                changes: {
+                    from: head,
+                    to: line.to,
+                    insert: newItem + textAfterCursor.trimStart(),
+                },
+                selection: {
+                    anchor: head + newItem.length,
+                },
+            });
+            return true;
+        },
+    },
+]);
+// ─── Tab / Shift-Tab: change item level ────────────────────────────────────
+const maxItemLevel = 6;
+const minItemLevel = 1;
+const indentPerLevel = '  '; // 2 spaces per level
+function changeItemLevel(view, delta) {
+    const { state } = view;
+    const { from, to } = state.selection.main;
+    const startLine = state.doc.lineAt(from);
+    const endLine = state.doc.lineAt(to);
+    const changes = [];
+    for (let lineNum = startLine.number; lineNum <= endLine.number; lineNum++) {
+        const line = state.doc.line(lineNum);
+        const item = parseItemLine(line.text, line.from);
+        if (!item)
+            continue;
+        const newLevel = item.level + delta;
+        if (newLevel < minItemLevel || newLevel > maxItemLevel)
+            continue;
+        // Adjust indentation: each level = 4 spaces
+        const newIndent = delta === 1 ? item.indent + indentPerLevel : item.indent.slice(indentPerLevel.length);
+        const oldMarkerLen = item.markerEnd - line.from;
+        const newMarker = `${newIndent}=item${newLevel}${item.separator}`;
+        changes.push({ from: line.from, to: line.from + oldMarkerLen, insert: newMarker });
+    }
+    if (changes.length === 0)
+        return false;
+    view.dispatch({ changes });
+    return true;
+}
+export const itemLevelKeymap = keymap.of([
+    {
+        key: 'Tab',
+        run: (view) => changeItemLevel(view, 1),
+    },
+    {
+        key: 'Shift-Tab',
+        run: (view) => changeItemLevel(view, -1),
+    },
+]);
+//# sourceMappingURL=listContinuation.js.map

package/esm/listContinuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listContinuation.js","sourceRoot":"","sources":["../src/listContinuation.ts"],"names":[],"mappings":"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"}

package/esm/types.d.ts

@@ -0,0 +1,12 @@
+declare type FoldRange = {
+    readonly from: number;
+    readonly to: number;
+};
+export declare type EditorSessionState = {
+    readonly cursorOffset?: number;
+    readonly scrollTop?: number;
+    readonly foldedRanges?: ReadonlyArray<FoldRange>;
+    readonly isPreviewMode?: boolean;
+    readonly isHalfPreviewMode?: boolean;
+};
+export {};

package/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/Editor.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { ViewUpdate, ReactCodeMirrorProps, ReactCodeMirrorRef } from '@uiw/react-codemirror';
+import type { EditorSessionState } from './types';
 export interface ConverterResult {
     errors?: any;
     result: JSX.Element | string;
@@ -27,6 +28,10 @@ export interface IPodliteEditor extends ReactCodeMirrorProps {
     onOpenLink?: (url: string) => void;
     /** Enable code highlighting */
     enableHighlighting?: boolean;
+    /** Initial editor session state to restore (cursor, scroll, folds) */
+    initialEditorState?: EditorSessionState;
+    /** Called when editor state changes (cursor move, scroll, fold/unfold) */
+    onEditorStateChange?: (state: EditorSessionState) => void;
 }
 export interface PodliteEditorRef {
     editor: React.RefObject<ReactCodeMirrorRef>;

package/lib/Editor.js

@@ -10,9 +10,12 @@ const podlite_2 = require("./podlite");
 const theme_1 = require("./theme");
 const view_1 = require("@codemirror/view");
 const commands_1 = require("@codemirror/commands");
+const language_1 = require("@codemirror/language");
 const react_is_1 = require("react-is");
 const autocomplete_1 = require("@codemirror/autocomplete");
 const dict_1 = (0, tslib_1.__importDefault)(require("./dict"));
+const listContinuation_1 = require("./listContinuation");
+const foldPodlite_1 = require("./foldPodlite");
 const HighlightedCode_1 = (0, tslib_1.__importDefault)(require("./HighlightedCode"));
 function useDebouncedEffect(fn, deps, time) {
     const dependencies = [...deps, time];
@@ -30,10 +33,10 @@ function PodliteEditorInternal(props, ref) {
     if (!isBrowser)
         return null;
     const { onChange, enableScroll = true, enablePreview = true, extensions = [], previewWidth = '50%', onPreviewMode, isFullscreen, makePreviewComponent, startLinePreview = 1, // start line number
-    enableAutocompletion = false, onOpenLink, enableHighlighting = false, ...codemirrorProps } = props;
+    enableAutocompletion = false, onOpenLink, enableHighlighting = false, initialEditorState, onEditorStateChange, ...codemirrorProps } = props;
     const full_preview = previewWidth === '100%';
     const [value, setValue] = (0, react_1.useState)(props.value || '');
-    const [text1, setText] = (0, react_1.useState)(props.value || '');
+    const pendingTextRef = (0, react_1.useRef)(props.value || '');
     const codeMirror = (0, react_1.useRef)(null);
     const container = (0, react_1.useRef)(null);
     const containerEditor = (0, react_1.useRef)(null);
@@ -41,10 +44,93 @@ function PodliteEditorInternal(props, ref) {
     const active = (0, react_1.useRef)(full_preview ? 'preview' : 'editor');
     const topLine = (0, react_1.useRef)(startLinePreview);
     const $viewHeight = (0, react_1.useRef)(0);
+    const initialStateApplied = (0, react_1.useRef)(false);
+    // Stable refs for callbacks used in memoized extensions
+    // Stable refs for callbacks used in memoized extensions
+    const onEditorStateChangeRef = (0, react_1.useRef)(onEditorStateChange);
+    onEditorStateChangeRef.current = onEditorStateChange;
+    const onOpenLinkRef = (0, react_1.useRef)(onOpenLink);
+    onOpenLinkRef.current = onOpenLink;
+    // Stable basicSetup config to prevent CodeMirror reconfiguration on re-render
+    const basicSetupConfig = react_1.default.useMemo(() => ({ defaultKeymap: false }), []);
     (0, react_1.useImperativeHandle)(ref, () => ({
         editor: codeMirror,
         preview: preview,
     }), [codeMirror]);
+    // Helper: serialize current fold ranges from EditorState
+    const serializeFoldedRanges = (0, react_1.useCallback)((view) => {
+        const ranges = [];
+        const folded = (0, language_1.foldedRanges)(view.state);
+        const iter = folded.iter();
+        while (iter.value) {
+            ranges.push({ from: iter.from, to: iter.to });
+            iter.next();
+        }
+        return ranges;
+    }, []);
+    // Reset applied flag when initialEditorState changes (new file opened)
+    (0, react_1.useEffect)(() => {
+        initialStateApplied.current = false;
+    }, [initialEditorState]);
+    // Restore editor session state once after mount or file change
+    (0, react_1.useEffect)(() => {
+        if (initialStateApplied.current || !initialEditorState)
+            return;
+        const view = codeMirror.current?.view;
+        if (!view)
+            return;
+        initialStateApplied.current = true;
+        // Restore cursor position
+        if (initialEditorState.cursorOffset != null) {
+            const offset = Math.min(initialEditorState.cursorOffset, view.state.doc.length);
+            view.dispatch({ selection: { anchor: offset } });
+        }
+        // Restore fold ranges
+        if (initialEditorState.foldedRanges && initialEditorState.foldedRanges.length > 0) {
+            const effects = initialEditorState.foldedRanges
+                .filter(r => r.from < view.state.doc.length && r.to <= view.state.doc.length)
+                .map(r => language_1.foldEffect.of({ from: r.from, to: r.to }));
+            if (effects.length > 0) {
+                view.dispatch({ effects });
+            }
+        }
+        // Restore scroll position (after folds applied, so layout is correct)
+        // and focus the editor so the blinking cursor is visible
+        requestAnimationFrame(() => {
+            if (initialEditorState.scrollTop != null) {
+                view.scrollDOM.scrollTop = initialEditorState.scrollTop;
+            }
+            view.focus();
+        });
+    }, [initialEditorState, codeMirror.current?.view]);
+    // Expose editor state changes via callback
+    (0, react_1.useEffect)(() => {
+        if (!onEditorStateChange)
+            return;
+        const view = codeMirror.current?.view;
+        if (!view)
+            return;
+        const emitState = () => {
+            onEditorStateChange({
+                cursorOffset: view.state.selection.main.head,
+                scrollTop: view.scrollDOM.scrollTop,
+                foldedRanges: serializeFoldedRanges(view),
+            });
+        };
+        // Debounce scroll events
+        let scrollTimer = null;
+        const handleScroll = () => {
+            if (scrollTimer)
+                clearTimeout(scrollTimer);
+            scrollTimer = setTimeout(emitState, 200);
+        };
+        view.scrollDOM.addEventListener('scroll', handleScroll);
+        return () => {
+            view.scrollDOM.removeEventListener('scroll', handleScroll);
+            if (scrollTimer)
+                clearTimeout(scrollTimer);
+        };
+    }, [onEditorStateChange, codeMirror.current?.view, serializeFoldedRanges]);
     const height = isFullscreen
         ? '100%'
         : typeof codemirrorProps.height === 'number'
@@ -52,7 +138,9 @@ function PodliteEditorInternal(props, ref) {
             : codemirrorProps.height;
     const preValue = props.value;
     (0, react_1.useEffect)(() => setValue(preValue ?? ''), [preValue]);
-    (0, react_1.useEffect)(() => setText(preValue ?? ''), [preValue]);
+    (0, react_1.useEffect)(() => {
+        pendingTextRef.current = preValue ?? '';
+    }, [preValue]);
     const fullRef = (0, react_1.useRef)(isFullscreen);
     (0, react_1.useEffect)(() => {
         fullRef.current = isFullscreen;
@@ -207,8 +295,9 @@ function PodliteEditorInternal(props, ref) {
         },
         ...commands_1.defaultKeymap,
     ]);
-    // Add/remove a class on the editor root while Mod (Cmd/Ctrl) is pressed
-    const modKeyClass = view_1.EditorView.domEventHandlers({
+    // Memoized extensions to prevent CodeMirror reconfiguration on re-render
+    // (reconfiguration closes panels like search)
+    const modKeyClass = react_1.default.useMemo(() => view_1.EditorView.domEventHandlers({
         keydown(e, view) {
             if (e.metaKey || e.ctrlKey)
                 view.dom.classList.add('cm-mod-pressed');
@@ -220,12 +309,11 @@ function PodliteEditorInternal(props, ref) {
         blur(_, view) {
             view.dom.classList.remove('cm-mod-pressed');
         },
-        // defensive: if mouse leaves, clear the class (helps when key is released elsewhere)
         mouseleave(_, view) {
             view.dom.classList.remove('cm-mod-pressed');
         },
-    });
-    const openStyledLinkOnClick = view_1.EditorView.domEventHandlers({
+    }), []);
+    const openStyledLinkOnClick = react_1.default.useMemo(() => view_1.EditorView.domEventHandlers({
         click(event, view) {
             const target = event.target;
             if (!target)
@@ -233,35 +321,42 @@ function PodliteEditorInternal(props, ref) {
             const el = target.closest('.cm-clickable-link');
             if (!el)
                 return;
-            // require Cmd/Ctrl for activation
             const modPressed = event.metaKey || event.ctrlKey;
             if (!modPressed)
                 return;
             const from = view.posAtDOM(el, 0);
             const to = view.posAtDOM(el, el.childNodes.length);
             const text = view.state.doc.sliceString(from, to).trim();
-            if (onOpenLink) {
-                onOpenLink(text); // i.e window.open(text, '_blank', 'noopener')
-            }
+            onOpenLinkRef.current?.(text);
             event.preventDefault();
             event.stopPropagation();
         },
-    });
-    let extensionsData = [(0, podlite_2.podliteLang)(), view_1.EditorView.lineWrapping, preventToggleComment];
-    if (onOpenLink) {
-        extensionsData.push(modKeyClass, openStyledLinkOnClick, view_1.EditorView.theme({
-            '&.cm-editor.cm-mod-pressed .cm-clickable-link:hover': {
-                cursor: 'pointer',
-            },
-        }));
-    }
-    if (enableScroll) {
-        extensionsData.push(scrollExtensions);
-    }
-    const makeApply = (text) => (editor, completion, from, to) => {
+    }), []);
+    // Track fold/unfold and cursor changes to emit editor state
+    const stateChangeListener = react_1.default.useMemo(() => onEditorStateChange
+        ? view_1.EditorView.updateListener.of(update => {
+            const hasFoldChange = update.transactions.some(tr => tr.effects.some(e => e.is(language_1.foldEffect) || e.is(language_1.unfoldEffect)));
+            const hasCursorChange = update.selectionSet;
+            if (hasFoldChange || hasCursorChange) {
+                onEditorStateChangeRef.current?.({
+                    cursorOffset: update.state.selection.main.head,
+                    scrollTop: update.view.scrollDOM.scrollTop,
+                    foldedRanges: serializeFoldedRanges(update.view),
+                });
+            }
+        })
+        : [], [!!onEditorStateChange, serializeFoldedRanges]);
+    const linkTheme = react_1.default.useMemo(() => view_1.EditorView.theme({
+        '&.cm-editor.cm-mod-pressed .cm-clickable-link:hover': {
+            cursor: 'pointer',
+        },
+    }), []);
+    const makeApply = (0, react_1.useCallback)((text) => (editor, completion, from, to) => {
         return (0, autocomplete_1.snippet)(text)(editor, completion, from - 1, to);
-    };
-    if (enableAutocompletion) {
+    }, []);
+    const autocompletionExt = react_1.default.useMemo(() => {
+        if (!enableAutocompletion)
+            return null;
         const langDict = dict_1.default.filter(({ lang = 'pod6' }) => lang === 'pod6');
         const completions = langDict.map(({ displayText, text }) => {
             function cleanBraces(text) {
@@ -276,8 +371,6 @@ function PodliteEditorInternal(props, ref) {
         });
         function myCompletions(context) {
             let before = context.matchBefore(/^\s*=\w*/);
-            // If completion wasn't explicitly started and there
-            // is no word before the cursor, don't open completions.
             if (!context.explicit && !before)
                 return null;
             return {
@@ -286,11 +379,50 @@ function PodliteEditorInternal(props, ref) {
                 validFor: /^=\w*$/,
             };
         }
-        extensionsData.push((0, autocomplete_1.autocompletion)({ override: [myCompletions] }));
-    }
-    useDebouncedEffect(() => {
-        setValue(text1);
-    }, [text1], 50);
+        return (0, autocomplete_1.autocompletion)({ override: [myCompletions] });
+    }, [enableAutocompletion, makeApply]);
+    const extensionsData = react_1.default.useMemo(() => {
+        const exts = [
+            (0, podlite_2.podliteLang)(),
+            view_1.EditorView.lineWrapping,
+            foldPodlite_1.podliteFoldService,
+            (0, language_1.foldGutter)(),
+            view_1.keymap.of(language_1.foldKeymap),
+            stateChangeListener,
+            listContinuation_1.itemLevelKeymap,
+            listContinuation_1.listContinuationKeymap,
+            preventToggleComment,
+        ];
+        if (onOpenLink) {
+            exts.push(modKeyClass, openStyledLinkOnClick, linkTheme);
+        }
+        if (enableScroll) {
+            exts.push(scrollExtensions);
+        }
+        if (autocompletionExt) {
+            exts.push(autocompletionExt);
+        }
+        return exts;
+    }, [
+        stateChangeListener,
+        modKeyClass,
+        openStyledLinkOnClick,
+        linkTheme,
+        !!onOpenLink,
+        enableScroll,
+        scrollExtensions,
+        preventToggleComment,
+        autocompletionExt,
+    ]);
+    // Debounced preview update: check ref every 300ms, update value state only when text changed
+    (0, react_1.useEffect)(() => {
+        const interval = setInterval(() => {
+            if (pendingTextRef.current !== value) {
+                setValue(pendingTextRef.current);
+            }
+        }, 300);
+        return () => clearInterval(interval);
+    }, [value]);
     (0, react_1.useEffect)(() => {
         if (!isBrowser || !container.current)
             return;
@@ -328,10 +460,14 @@ function PodliteEditorInternal(props, ref) {
         }, 100);
         return () => clearTimeout(timer);
     }, [startLinePreview, enablePreview]); // Only run when startLinePreview or enablePreview changes
-    const handleChange = (value, viewUpdate) => {
-        setText(value);
-        onChange && onChange(value, viewUpdate);
-    };
+    const handleChange = (0, react_1.useCallback)((value, viewUpdate) => {
+        pendingTextRef.current = value;
+        // Defer parent callback to next frame so CodeMirror textupdate handler
+        // completes immediately and the typed character appears without delay
+        requestAnimationFrame(() => {
+            onChange?.(value, viewUpdate);
+        });
+    }, [onChange]);
     (0, react_1.useEffect)(() => {
         if (preview.current) {
             const $preview = preview.current;
@@ -482,7 +618,7 @@ function PodliteEditorInternal(props, ref) {
     };
     const conentView = (react_1.default.createElement("div", { className: `podlite-editor-content`, style: { height: codemirrorProps?.height } },
         react_1.default.createElement("div", { className: `podlite-editor-content-editor`, ref: containerEditor },
-            react_1.default.createElement(react_codemirror_1.default, { theme: theme_1.defaultTheme, ...{ ...codemirrorProps, ...{ basicSetup: { defaultKeymap: false } } }, className: `podlite-editor-inner`, extensions: extensionsData, height: height, ref: codeMirror, onChange: handleChange })),
+            react_1.default.createElement(react_codemirror_1.default, { theme: theme_1.defaultTheme, indentWithTab: false, autoFocus: true, ...codemirrorProps, basicSetup: basicSetupConfig, className: `podlite-editor-inner`, extensions: extensionsData, height: height, ref: codeMirror, onChange: handleChange })),
         enablePreview && (react_1.default.createElement("div", { className: clsPreview, style: { overflow: full_preview ? 'visible' : 'hidden' }, ref: preview }, previewContent()))));
     return (react_1.default.createElement("div", null,
         react_1.default.createElement("div", { className: cls, ref: container }, conentView),