monaco-line-locks 0.1.1

package/README.md

@@ -0,0 +1,191 @@
+# monaco-line-locks
+
+Lock specific lines in Monaco Editor to prevent editing. A lightweight alternative to constrained-editor-plugin with a simpler mental model.
+
+## Features
+
+- **Lock by line number** — blacklist approach (vs editable ranges whitelist)
+- **Prevents edits** via keyboard blocking (not undo-after-the-fact)
+- **Auto-adjusts** locked line positions when document changes
+- **Visual feedback** — CSS decorations for locked lines + gutter icons
+- **React hook** included
+- **No model monkey-patching**
+
+## Install
+
+```bash
+# pnpm (recommended)
+pnpm add monaco-line-locks
+
+# npm
+npm install monaco-line-locks
+```
+
+## Basic Usage
+
+### Vanilla JS
+
+```typescript
+import { LineLockManager } from 'monaco-line-locks'
+import * as monaco from 'monaco-editor'
+
+const editor = monaco.editor.create(document.getElementById('editor'), {
+  value: '// Line 1\n// Line 2\n// Line 3',
+  language: 'javascript',
+})
+
+const locks = new LineLockManager(monaco, editor, {
+  lockedLines: [2], // Lock line 2
+})
+
+// Later: update locks
+locks.setLockedLines([2, 3])
+
+// Get current locks
+console.log(locks.getLockedLines()) // [2, 3]
+
+// Cleanup
+locks.dispose()
+```
+
+### React
+
+```tsx
+import { useLineLocks } from 'monaco-line-locks/react'
+import { useState } from 'react'
+import Editor from '@monaco-editor/react'
+
+function MyEditor() {
+  const [lockedLines, setLockedLines] = useState([3, 5])
+
+  const handleMount = (editor, monaco) => {
+    useLineLocks(editor, monaco, lockedLines, {
+      onChange: setLockedLines,
+    })
+  }
+
+  return <Editor onMount={handleMount} />
+}
+```
+
+## CSS
+
+Add these classes to your stylesheet:
+
+```css
+/* Yellow background on locked lines */
+.locked-line {
+  background: rgba(255, 200, 0, 0.06);
+}
+
+/* Lock icon in gutter (requires Codicon font) */
+.locked-deco::before {
+  content: '\ea75';
+  font-family: 'codicon';
+  font-size: 12px;
+  color: rgba(255, 200, 0, 0.7);
+}
+```
+
+## API
+
+### `LineLockManager`
+
+| Method                                  | Description                                                |
+| --------------------------------------- | ---------------------------------------------------------- |
+| `constructor(monaco, editor, options?)` | Create manager                                             |
+| `setLockedLines(lines)`                 | Replace all locked lines                                   |
+| `getLockedLines()`                      | Get sorted copy of current locks                           |
+| `hasLockInRange(start, end)`            | Check if any line in [start, end] is locked — **O(log L)** |
+| `dispose()`                             | Cleanup listeners and decorations                          |
+
+### Options
+
+| Option                      | Type                        | Default                 | Description                               |
+| --------------------------- | --------------------------- | ----------------------- | ----------------------------------------- |
+| `lockedLines`               | `number[]`                  | `[]`                    | Initial locked line numbers               |
+| `decorationClassName`       | `string`                    | `'locked-line'`         | CSS class for line background             |
+| `decorationGutterClassName` | `string`                    | `'locked-deco'`         | CSS class for gutter icon                 |
+| `hoverMessage`              | `string \| IMarkdownString` | `'This line is locked'` | Message when trying to edit a locked line |
+| `blockKeyboard`             | `boolean`                   | `true`                  | Block keyboard input on locked lines      |
+| `blockMouse`                | `boolean`                   | `false`                 | Block mouse input on locked lines         |
+| `onChange`                  | `(lines: number[]) => void` | —                       | Called when locks change due to edits     |
+
+## How it works
+
+1. **Keyboard blocking** — `onKeyDown` listener prevents typing/deleting on locked lines via binary search (O(log L))
+2. **Line tracking** — `onDidChangeModelContent` adjusts lock positions when lines are inserted/deleted
+3. **Decorations** — Monaco `deltaDecorations` for visual feedback
+
+## Differences from constrained-editor-plugin
+
+|            | constrained-editor-plugin   | monaco-line-locks         |
+| ---------- | --------------------------- | ------------------------- |
+| Approach   | Editable ranges (whitelist) | Locked lines (blacklist)  |
+| Validation | Undo after invalid edit     | Prevent before it happens |
+| Model      | Monkey-patched              | Clean                     |
+| Columns    | Full range support          | Line-level only           |
+| Size       | ~15KB                       | ~2KB                      |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/yourusername/monaco-line-locks.git
+cd monaco-line-locks
+
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm exec tsc --noEmit
+
+# Check for unused code
+pnpm knip
+
+# Build for publish
+pnpm run build
+```
+
+## Examples
+
+### Basic (Vanilla JS)
+
+```bash
+# Build the library first
+pnpm run build
+
+# Serve the example (browsers block file:// URLs for ES modules)
+cd examples
+pnpm install
+pnpm run serve:basic
+# Open http://localhost:3000
+```
+
+### React
+
+```bash
+cd examples
+pnpm install
+pnpm run serve:react
+# Open http://localhost:5173
+```
+
+## Contributing
+
+Issues and PRs welcome. Focus areas:
+
+- Mouse/paste blocking
+- Multi-cursor support
+- Performance benchmarks
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import type * as monacoEditor from 'monaco-editor';
+export interface LineLockOptions {
+    /** Initial locked line numbers (1-indexed) */
+    lockedLines?: number[];
+    /** CSS class for the line background decoration */
+    decorationClassName?: string;
+    /** CSS class for the gutter decoration (lock icon) */
+    decorationGutterClassName?: string;
+    /** Message shown when trying to edit a locked line (default: "This line is locked") */
+    hoverMessage?: string | monacoEditor.IMarkdownString;
+    /** Whether to block keyboard input on locked lines (default: true) */
+    blockKeyboard?: boolean;
+    /** Whether to block mouse input on locked lines (default: false) */
+    blockMouse?: boolean;
+    /** Called whenever locked lines change due to document edits */
+    onChange?: (lines: number[]) => void;
+}
+/**
+ * Variables:
+ *   L = total number of lines in the document
+ *   S = number of lines in the current selection (S ≤ L)
+ *   D = number of deleted lines in a change (D ≤ L)
+ *   C = number of changes in a batch
+ */
+export declare class LineLockManager {
+    private monaco;
+    private editor;
+    private options;
+    private lockedLinesSet;
+    private lockedLinesSorted;
+    private decorations;
+    private disposables;
+    constructor(monaco: typeof monacoEditor, editor: monacoEditor.editor.IStandaloneCodeEditor, options?: LineLockOptions);
+    /** Filter lines outside the current model's bounds */
+    private clampLines;
+    /** O(L log L) — sorts at most L locked lines */
+    private sortLines;
+    /** O(L) — registers listeners and applies decorations (at most L locked lines) */
+    private init;
+    /** O(log L) per keystroke — binary search over at most L locked lines */
+    private setupKeyboardBlocking;
+    /** O(1) — registers the content change listener */
+    private setupLineTracking;
+    /** O(C·(D + L) + L log L) = O(C·L + L log L) — worst case */
+    private adjustLocks;
+    /** O(L) — applies Monaco deltaDecorations for at most L locked lines */
+    private updateDecorations;
+    /** O(L log L) — replace all locked lines (at most L) and update decorations */
+    setLockedLines(lines: number[]): void;
+    /** O(log L) — check if any line in [start, end] is locked (binary search over ≤ L lines) */
+    hasLockInRange(start: number, end: number): boolean;
+    /** O(log L) — binary search over at most L locked lines */
+    private lowerBound;
+    /** Show message overlay at cursor position using Monaco's MessageController */
+    private showLockMessage;
+    /** O(L) — copy at most L locked lines */
+    getLockedLines(): number[];
+    /** O(L) — clean up listeners + decorations (at most L locked lines) */
+    dispose(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,YAAY,MAAM,eAAe,CAAA;AAElD,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,sDAAsD;IACtD,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,eAAe,CAAA;IACpD,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,oEAAoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CACrC;AAED;;;;;;GAMG;AAEH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAgB;gBAEjC,MAAM,EAAE,OAAO,YAAY,EAC3B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,qBAAqB,EACjD,OAAO,GAAE,eAAoB;IAuB/B,sDAAsD;IACtD,OAAO,CAAC,UAAU;IAOlB,gDAAgD;IAChD,OAAO,CAAC,SAAS;IAIjB,kFAAkF;IAClF,OAAO,CAAC,IAAI;IAQZ,yEAAyE;IACzE,OAAO,CAAC,qBAAqB;IA0D7B,mDAAmD;IACnD,OAAO,CAAC,iBAAiB;IAQzB,6DAA6D;IAC7D,OAAO,CAAC,WAAW;IA+CnB,wEAAwE;IACxE,OAAO,CAAC,iBAAiB;IAoBzB,+EAA+E;IAC/E,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE;IAO9B,4FAA4F;IAC5F,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAKnD,2DAA2D;IAC3D,OAAO,CAAC,UAAU;IAWlB,+EAA+E;IAC/E,OAAO,CAAC,eAAe;IAgBvB,yCAAyC;IACzC,cAAc,IAAI,MAAM,EAAE;IAI1B,uEAAuE;IACvE,OAAO;CAUR"}

package/dist/index.js

@@ -0,0 +1,241 @@
+/**
+ * Variables:
+ *   L = total number of lines in the document
+ *   S = number of lines in the current selection (S ≤ L)
+ *   D = number of deleted lines in a change (D ≤ L)
+ *   C = number of changes in a batch
+ */
+export class LineLockManager {
+    monaco;
+    editor;
+    options;
+    lockedLinesSet;
+    lockedLinesSorted;
+    decorations;
+    disposables;
+    constructor(monaco, editor, options = {}) {
+        this.monaco = monaco;
+        this.editor = editor;
+        this.options = {
+            lockedLines: [],
+            decorationClassName: 'locked-line',
+            decorationGutterClassName: 'locked-deco',
+            hoverMessage: 'This line is locked',
+            blockKeyboard: true,
+            blockMouse: false,
+            onChange: () => { },
+            ...options,
+        };
+        const clamped = this.clampLines(this.options.lockedLines);
+        this.lockedLinesSet = new Set(clamped);
+        this.lockedLinesSorted = this.sortLines(clamped);
+        this.decorations = [];
+        this.disposables = [];
+        this.init();
+    }
+    /** Filter lines outside the current model's bounds */
+    clampLines(lines) {
+        const model = this.editor.getModel();
+        if (!model)
+            return lines;
+        const max = model.getLineCount();
+        return lines.filter((l) => l >= 1 && l <= max);
+    }
+    /** O(L log L) — sorts at most L locked lines */
+    sortLines(lines) {
+        return [...lines].sort((a, b) => a - b);
+    }
+    /** O(L) — registers listeners and applies decorations (at most L locked lines) */
+    init() {
+        if (this.options.blockKeyboard) {
+            this.setupKeyboardBlocking();
+        }
+        this.setupLineTracking();
+        this.updateDecorations();
+    }
+    /** O(log L) per keystroke — binary search over at most L locked lines */
+    setupKeyboardBlocking() {
+        const NAV = [
+            this.monaco.KeyCode.LeftArrow,
+            this.monaco.KeyCode.RightArrow,
+            this.monaco.KeyCode.UpArrow,
+            this.monaco.KeyCode.DownArrow,
+            this.monaco.KeyCode.Home,
+            this.monaco.KeyCode.End,
+            this.monaco.KeyCode.PageUp,
+            this.monaco.KeyCode.PageDown,
+            this.monaco.KeyCode.Escape,
+        ];
+        const SAFE = [
+            this.monaco.KeyCode.KeyA,
+            this.monaco.KeyCode.KeyC,
+            this.monaco.KeyCode.KeyF,
+            this.monaco.KeyCode.KeyH,
+            this.monaco.KeyCode.KeyZ,
+        ];
+        const isNav = (k) => NAV.includes(k);
+        const isSafe = (k, ctrl) => ctrl && SAFE.includes(k);
+        const disposable = this.editor.onKeyDown((e) => {
+            const locks = this.lockedLinesSet;
+            if (!locks.size)
+                return;
+            const sel = this.editor.getSelection();
+            if (!sel)
+                return;
+            let start = sel.startLineNumber;
+            let end = sel.endLineNumber;
+            if (e.keyCode === this.monaco.KeyCode.Backspace) {
+                const pos = this.editor.getPosition();
+                if (pos?.column === 1)
+                    start = Math.max(1, start - 1);
+            }
+            if (e.keyCode === this.monaco.KeyCode.Delete) {
+                const pos = this.editor.getPosition();
+                const model = this.editor.getModel();
+                if (pos && model && pos.column >= model.getLineMaxColumn(pos.lineNumber)) {
+                    end = Math.min(model.getLineCount(), end + 1);
+                }
+            }
+            if (this.hasLockInRange(start, end)) {
+                if (isNav(e.keyCode) || isSafe(e.keyCode, e.ctrlKey || e.metaKey))
+                    return;
+                this.showLockMessage();
+                e.preventDefault();
+                e.browserEvent.preventDefault();
+                e.browserEvent.stopPropagation();
+                return;
+            }
+        });
+        this.disposables.push(() => disposable.dispose());
+    }
+    /** O(1) — registers the content change listener */
+    setupLineTracking() {
+        const disposable = this.editor.onDidChangeModelContent((e) => {
+            if (e.isFlush)
+                return;
+            this.adjustLocks(e);
+        });
+        this.disposables.push(() => disposable.dispose());
+    }
+    /** O(C·(D + L) + L log L) = O(C·L + L log L) — worst case */
+    adjustLocks(e) {
+        const locks = this.lockedLinesSet;
+        if (!locks.size)
+            return;
+        let modified = false;
+        for (const change of [...e.changes].sort((a, b) => b.range.startLineNumber - a.range.startLineNumber)) {
+            const { startLineNumber: start, endLineNumber: end } = change.range;
+            const deleted = end - start;
+            const inserted = change.text.split('\n').length - 1;
+            const delta = inserted - deleted;
+            if (!delta && !deleted)
+                continue;
+            // Remove locks for deleted lines — O(deleted) with Set
+            for (let i = 0; i < deleted; i++) {
+                if (locks.delete(start + i)) {
+                    modified = true;
+                }
+            }
+            // Shift locks after the change range — O(locks)
+            if (delta) {
+                const toShift = [];
+                for (const line of locks) {
+                    if (line >= start + deleted) {
+                        toShift.push(line);
+                    }
+                }
+                for (const line of toShift) {
+                    locks.delete(line);
+                }
+                for (const line of toShift) {
+                    locks.add(line + delta);
+                }
+                if (toShift.length)
+                    modified = true;
+            }
+        }
+        if (modified) {
+            this.lockedLinesSorted = this.sortLines([...locks]);
+            this.updateDecorations();
+            this.options.onChange([...this.lockedLinesSorted]);
+        }
+    }
+    /** O(L) — applies Monaco deltaDecorations for at most L locked lines */
+    updateDecorations() {
+        const model = this.editor.getModel();
+        if (!model)
+            return;
+        this.decorations = model.deltaDecorations(this.decorations, []);
+        if (this.lockedLinesSorted.length) {
+            const decos = this.lockedLinesSorted.map((line) => ({
+                range: new this.monaco.Range(line, 1, line, 1),
+                options: {
+                    isWholeLine: true,
+                    className: this.options.decorationClassName,
+                    linesDecorationsClassName: this.options.decorationGutterClassName,
+                    stickiness: this.monaco.editor.TrackedRangeStickiness.NeverGrowsWhenTypingAtEdges,
+                },
+            }));
+            this.decorations = model.deltaDecorations([], decos);
+        }
+    }
+    /** O(L log L) — replace all locked lines (at most L) and update decorations */
+    setLockedLines(lines) {
+        const clamped = this.clampLines(lines);
+        this.lockedLinesSet = new Set(clamped);
+        this.lockedLinesSorted = this.sortLines(clamped);
+        this.updateDecorations();
+    }
+    /** O(log L) — check if any line in [start, end] is locked (binary search over ≤ L lines) */
+    hasLockInRange(start, end) {
+        const idx = this.lowerBound(this.lockedLinesSorted, start);
+        return idx < this.lockedLinesSorted.length && this.lockedLinesSorted[idx] <= end;
+    }
+    /** O(log L) — binary search over at most L locked lines */
+    lowerBound(arr, target) {
+        let lo = 0;
+        let hi = arr.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (arr[mid] < target)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return lo;
+    }
+    /** Show message overlay at cursor position using Monaco's MessageController */
+    showLockMessage() {
+        try {
+            const ctrl = this.editor.getContribution('editor.contrib.messageController');
+            if (ctrl) {
+                const msg = this.options.hoverMessage
+                    ? typeof this.options.hoverMessage === 'string'
+                        ? this.options.hoverMessage
+                        : this.options.hoverMessage.value
+                    : undefined;
+                if (msg)
+                    ctrl.showMessage(msg, this.editor.getPosition());
+            }
+        }
+        catch {
+            // MessageController may not be available in some Monaco builds
+        }
+    }
+    /** O(L) — copy at most L locked lines */
+    getLockedLines() {
+        return [...this.lockedLinesSorted];
+    }
+    /** O(L) — clean up listeners + decorations (at most L locked lines) */
+    dispose() {
+        this.disposables.forEach((d) => d());
+        this.disposables = [];
+        const model = this.editor.getModel();
+        if (model) {
+            this.decorations = model.deltaDecorations(this.decorations, []);
+        }
+        this.lockedLinesSet.clear();
+        this.lockedLinesSorted = [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/react.d.ts

@@ -0,0 +1,24 @@
+import { LineLockOptions } from './index.js';
+import type * as monacoEditor from 'monaco-editor';
+/**
+ * React hook to manage line locks in a Monaco editor.
+ *
+ * @example
+ * ```tsx
+ * import { useLineLocks } from 'monaco-line-locks/react'
+ *
+ * function Editor() {
+ *   const [lockedLines, setLockedLines] = useState([3, 5])
+ *   const [editor, setEditor] = useState(null)
+ *   const [monaco, setMonaco] = useState(null)
+ *
+ *   useLineLocks(editor, monaco, lockedLines, {
+ *     onChange: setLockedLines,
+ *   })
+ *
+ *   return <MonacoEditor onMount={(ed, mon) => { setEditor(ed); setMonaco(mon) }} />
+ * }
+ * ```
+ */
+export declare function useLineLocks(editor: monacoEditor.editor.IStandaloneCodeEditor | null, monaco: typeof monacoEditor | null, lockedLines: number[], options?: LineLockOptions): void;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,eAAe,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,KAAK,YAAY,MAAM,eAAe,CAAA;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,qBAAqB,GAAG,IAAI,EACxD,MAAM,EAAE,OAAO,YAAY,GAAG,IAAI,EAClC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,eAAe,QAuB1B"}

package/dist/react.js

@@ -0,0 +1,43 @@
+import { useEffect, useRef } from 'react';
+import { LineLockManager } from './index.js';
+/**
+ * React hook to manage line locks in a Monaco editor.
+ *
+ * @example
+ * ```tsx
+ * import { useLineLocks } from 'monaco-line-locks/react'
+ *
+ * function Editor() {
+ *   const [lockedLines, setLockedLines] = useState([3, 5])
+ *   const [editor, setEditor] = useState(null)
+ *   const [monaco, setMonaco] = useState(null)
+ *
+ *   useLineLocks(editor, monaco, lockedLines, {
+ *     onChange: setLockedLines,
+ *   })
+ *
+ *   return <MonacoEditor onMount={(ed, mon) => { setEditor(ed); setMonaco(mon) }} />
+ * }
+ * ```
+ */
+export function useLineLocks(editor, monaco, lockedLines, options) {
+    const managerRef = useRef(null);
+    // Initialize manager when editor/monaco become available
+    useEffect(() => {
+        if (!editor || !monaco)
+            return;
+        managerRef.current = new LineLockManager(monaco, editor, {
+            ...options,
+            lockedLines,
+        });
+        return () => {
+            managerRef.current?.dispose();
+            managerRef.current = null;
+        };
+    }, [editor, monaco]); // eslint-disable-line react-hooks/exhaustive-deps
+    // Update locked lines when they change externally
+    useEffect(() => {
+        managerRef.current?.setLockedLines(lockedLines);
+    }, [lockedLines]);
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAA;AAG7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAwD,EACxD,MAAkC,EAClC,WAAqB,EACrB,OAAyB;IAEzB,MAAM,UAAU,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAA;IAEvD,yDAAyD;IACzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;YAAE,OAAM;QAE9B,UAAU,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE;YACvD,GAAG,OAAO;YACV,WAAW;SACZ,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAA;YAC7B,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;QAC3B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA,CAAC,kDAAkD;IAEvE,kDAAkD;IAClD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "monaco-line-locks",
+  "version": "0.1.1",
+  "description": "Lock specific lines in Monaco Editor to prevent editing",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.js",
+      "types": "./dist/react.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "monaco-editor",
+    "readonly",
+    "locked-lines",
+    "code-editor",
+    "restrictions"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "monaco-editor": ">=0.30.0",
+    "react": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.15",
+    "knip": "^6.14.2",
+    "monaco-editor": "^0.55.0",
+    "prettier": "^3.8.3",
+    "react": "^19.2.6",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "knip": "knip",
+    "fmt": "prettier --write .",
+    "example:react": "pnpm run build && cd examples/react && rm -rf node_modules && pnpm install && pnpm run dev",
+    "example:basic": "pnpm run build && python3 -m http.server 3000"
+  }
+}