chore: upgrade monaco editor bundle

Author: SysAdminDoc

README.md

@@ -175,7 +175,7 @@ Two additional zero-config flows ship as separate modules: **Easy Cloud** for on
 - **Unsaved indicators** — Visual dot on tabs with pending changes
 - **5 editor themes** — Auto (system, follows OS dark/light preference), Dark, Light, Catppuccin Mocha, OLED
 - **Status bar** — Line count and cursor position display
-- **IntelliSense** — Autocomplete for GM API functions and `@metadata` directives
+- **IntelliSense** — Autocomplete for GM API functions and `@metadata` directives, backed by generated ScriptVault GM declarations in the Monaco sandbox
 - Code folding, bracket matching, bracket pair colorization, auto-close
 - Search & replace (`Ctrl+F` / `Ctrl+H`)
 - Real-time userscript metadata linting

ROADMAP.md

@@ -298,13 +298,6 @@ _(All Now-tier items are credential/compliance blocked — see `Roadmap_Blocked.
 - **Deliverable:** Partition ScriptStorage, ScriptValues, and BackupScheduler into separate storage buckets. Measure write throughput for libraries >500 scripts. Fall back to single-bucket on browsers that don't support the Storage Buckets API.
 - **Acceptance:** `navigator.storageBuckets` feature-detected. Backup restore and sync merge still work after partitioning. Large-library perf harness shows improvement.
 
-### RD-11. Monaco v0.55+ Upgrade for LSP Namespace
-- **Tier:** Under Consideration | **Priority:** P3 | **Impact:** 3 | **Effort:** M
-- **Source:** Monaco ESM migration plan, Monaco v0.55 changelog (LSP namespace)
-- **Problem:** ScriptVault ships Monaco v0.52.2. v0.55+ adds a native LSP namespace that could improve userscript IntelliSense beyond the current autocomplete (GM API completions, @metadata directive completions). v0.55 also renamed `EditorAutoClosingOvertypeStrategy` to `EditorAutoClosingEditStrategy`.
-- **Deliverable:** Evaluate: does the LSP namespace enable richer userscript editing (e.g., type-aware GM API completions from `lib/scriptvault.d.ts`)? If yes, upgrade Monaco, update ESM build budget, and verify sandbox CSP compatibility. If no, defer until a compelling reason appears.
-- **Risk:** Breaking API changes in v0.55. ESM bundle size may grow. Requires separate dependency-budget and browser-proof cycle.
-
 ### Appendix: Research-Driven Sources
 
 | ID | Source | URL |

docs/audit/monaco-esm-prototype-2026-06-06.json

@@ -1,58 +1,58 @@
 {
-  "generatedAt": "2026-06-06T20:00:34.508Z",
+  "generatedAt": "2026-06-28T02:34:13.452Z",
   "root": "lib/monaco-esm",
   "sizeBudgets": {
-    "maxTotalBytes": 26000000,
+    "maxTotalBytes": 28000000,
     "maxTotalGzipBytes": 5000000,
     "maxFileBytes": {
-      "lib/monaco-esm/editor.js": 9000000,
-      "lib/monaco-esm/workers/ts.worker.js": 13000000
+      "lib/monaco-esm/editor.js": 9600000,
+      "lib/monaco-esm/workers/ts.worker.js": 13500000
     }
   },
   "totals": {
-    "totalBytes": 25186387,
-    "totalGzipBytes": 4279263
+    "totalBytes": 27717062,
+    "totalGzipBytes": 4702243
   },
   "outputs": [
     {
-      "path": "lib/monaco-esm/assets/codicon-37A3DWZT.ttf",
-      "bytes": 80340,
-      "gzipBytes": 44393
+      "path": "lib/monaco-esm/assets/codicon-LN6W7LCM.ttf",
+      "bytes": 121972,
+      "gzipBytes": 59203
     },
     {
       "path": "lib/monaco-esm/editor.css",
-      "bytes": 158378,
-      "gzipBytes": 23224
+      "bytes": 172300,
+      "gzipBytes": 25407
     },
     {
       "path": "lib/monaco-esm/editor.js",
-      "bytes": 8231464,
-      "gzipBytes": 1433472
+      "bytes": 9405086,
+      "gzipBytes": 1618107
     },
     {
       "path": "lib/monaco-esm/workers/css.worker.js",
-      "bytes": 1883186,
-      "gzipBytes": 303112
+      "bytes": 1919513,
+      "gzipBytes": 308677
     },
     {
       "path": "lib/monaco-esm/workers/editor.worker.js",
-      "bytes": 555624,
-      "gzipBytes": 116865
+      "bytes": 589593,
+      "gzipBytes": 121849
     },
     {
       "path": "lib/monaco-esm/workers/html.worker.js",
-      "bytes": 1264765,
-      "gzipBytes": 242013
+      "bytes": 1300500,
+      "gzipBytes": 247008
     },
     {
       "path": "lib/monaco-esm/workers/json.worker.js",
-      "bytes": 856164,
-      "gzipBytes": 170016
+      "bytes": 891272,
+      "gzipBytes": 175214
     },
     {
       "path": "lib/monaco-esm/workers/ts.worker.js",
-      "bytes": 12156466,
-      "gzipBytes": 1946168
+      "bytes": 13316826,
+      "gzipBytes": 2146778
     }
   ],
   "failures": []

package-lock.json

@@ -100,13 +100,14 @@
     "esbuild": "^0.28.0",
     "fake-indexeddb": "^6.2.5",
     "jsdom": "^29.0.1",
-    "monaco-editor": "^0.52.0",
+    "monaco-editor": "^0.55.1",
     "puppeteer-core": "^25.2.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.9",
     "web-ext": "^10.3.0"
   },
   "overrides": {
+    "dompurify": "3.4.11",
     "web-ext": {
       "fx-runner": "1.5.0"
     }

package.json

@@ -86,6 +86,7 @@
   function initMonaco(monaco) {
     if (!monaco || !monaco.editor || !monaco.languages) throw new Error('Monaco ESM API unavailable');
     monacoApi = monaco;
+      registerScriptVaultTypes(monaco);
       // ── Custom userscript language extension ──────────────────────────────
       // Register @metadata keywords in the completion provider
       monaco.languages.registerCompletionItemProvider('javascript', {
@@ -373,6 +374,18 @@
   }
 
   // ── Message handler (from dashboard) ──────────────────────────────────────
+  async function registerScriptVaultTypes(monaco) {
+    const defaults = monaco.typescript?.javascriptDefaults || monaco.languages?.typescript?.javascriptDefaults;
+    if (!defaults || typeof defaults.addExtraLib !== 'function' || typeof fetch !== 'function') return;
+
+    try {
+      const response = await fetch('../lib/scriptvault.d.ts', { cache: 'force-cache' });
+      if (!response || !response.ok) return;
+      const source = await response.text();
+      defaults.addExtraLib(source, 'file:///scriptvault/lib/scriptvault.d.ts');
+    } catch (_) { /* local type hints are best-effort; editor loading must not fail */ }
+  }
+
   window.addEventListener('message', function (e) {
     const msg = e.data;
     if (!msg || typeof msg !== 'object') return;

pages/editor-sandbox.html

@@ -18,11 +18,11 @@ const REQUIRED_OUTPUTS = [
 ];
 
 export const DEFAULT_SIZE_BUDGETS = Object.freeze({
-  maxTotalBytes: 26_000_000,
+  maxTotalBytes: 28_000_000,
   maxTotalGzipBytes: 5_000_000,
   maxFileBytes: Object.freeze({
-    'lib/monaco-esm/editor.js': 9_000_000,
-    'lib/monaco-esm/workers/ts.worker.js': 13_000_000,
+    'lib/monaco-esm/editor.js': 9_600_000,
+    'lib/monaco-esm/workers/ts.worker.js': 13_500_000,
   }),
 });
 

scripts/check-monaco-esm-prototype.mjs

@@ -195,7 +195,7 @@ function checkPlan(files, failures) {
     'npm run build:monaco',
     'npm run monaco:esm:check',
     'docs/audit/monaco-esm-prototype-2026-06-06.json',
-    'maxTotalBytes: 26000000',
+    'maxTotalBytes: 28000000',
     'maxTotalGzipBytes: 5000000',
     'lib/monaco-esm/editor.js',
     'lib/monaco-esm/workers/ts.worker.js',

scripts/check-monaco-package-contract.mjs

@@ -27,13 +27,31 @@ describe('Monaco ESM migration plan', () => {
       expect(plan).toContain(heading);
     }
 
-    expect(plan).toContain('monaco-editor@^0.52.0');
+    expect(plan).toContain('monaco-editor@^0.55.1');
     expect(plan).toContain('Monaco 0.53.0 deprecated AMD support');
-    expect(plan).toContain('Monaco 0.55.0');
+    expect(plan).toContain('Monaco 0.55.1');
     expect(plan).toContain('lib/monaco-esm/editor.js');
     expect(plan).toContain('lib/monaco-esm/workers/');
   });
 
+  it('pins the Monaco 0.55 namespace contract used by the sandbox', () => {
+    const packageJson = JSON.parse(read('package.json'));
+    const packageLock = JSON.parse(read('package-lock.json'));
+    const editorTypes = read('node_modules/monaco-editor/esm/vs/editor/editor.main.d.ts');
+    const apiTypes = read('node_modules/monaco-editor/esm/vs/editor/editor.api.d.ts');
+    const sandbox = read('pages/editor-sandbox.html');
+
+    expect(packageJson.devDependencies['monaco-editor']).toBe('^0.55.1');
+    expect(packageLock.packages['node_modules/monaco-editor'].version).toBe('0.55.1');
+    expect(packageJson.overrides.dompurify).toBe('3.4.11');
+    expect(editorTypes).toContain('as lsp');
+    expect(editorTypes).toContain('as typescript');
+    expect(apiTypes).toContain('EditorAutoClosingEditStrategy');
+    expect(apiTypes).not.toContain('EditorAutoClosingOvertypeStrategy');
+    expect(sandbox).toContain('monaco.typescript?.javascriptDefaults');
+    expect(sandbox).not.toContain('monaco.languages.typescript');
+  });
+
   it('keeps extension packaging constraints explicit', () => {
     const plan = read('docs/monaco-esm-migration-plan.md');
 

tests/monaco-esm-plan.test.js

@@ -15,6 +15,9 @@ function sandboxScript() {
 }
 
 function createFakeMonaco() {
+  const javascriptDefaults = {
+    addExtraLib: vi.fn(),
+  };
   const editorInstance = {
     addCommand: vi.fn(),
     onDidChangeModelContent: vi.fn(),
@@ -43,6 +46,9 @@ function createFakeMonaco() {
         CompletionItemKind: { Keyword: 1, Value: 2 },
         registerCompletionItemProvider: vi.fn(),
       },
+      typescript: {
+        javascriptDefaults,
+      },
       editor: {
         EditorOption: { wordWrap: 'wordWrap' },
         create: vi.fn(() => editorInstance),
@@ -53,7 +59,7 @@ function createFakeMonaco() {
   };
 }
 
-function createHarness({ moduleFails = false, stylesheetFails = false } = {}) {
+function createHarness({ moduleFails = false, stylesheetFails = false, typeDefinitions = 'declare const GM_info: unknown;' } = {}) {
   const messages = [];
   const appendedLinks = [];
   const loading = { style: {}, innerHTML: '' };
@@ -90,6 +96,11 @@ function createHarness({ moduleFails = false, stylesheetFails = false } = {}) {
     Promise,
     queueMicrotask,
     location: { origin: 'https://scriptvault.local' },
+    fetch: vi.fn(async (url) => ({
+      ok: true,
+      url,
+      text: async () => typeDefinitions,
+    })),
     parent: {
       postMessage(message) {
         messages.push(message);
@@ -109,7 +120,7 @@ function createHarness({ moduleFails = false, stylesheetFails = false } = {}) {
 
 async function runSandbox(context) {
   vm.runInNewContext(sandboxScript(), context);
-  for (let i = 0; i < 6; i += 1) await Promise.resolve();
+  for (let i = 0; i < 12; i += 1) await Promise.resolve();
 }
 
 describe('Monaco ESM sandbox loader', () => {
@@ -128,6 +139,18 @@ describe('Monaco ESM sandbox loader', () => {
     expect(harness.messages).toContainEqual({ type: 'ready' });
   });
 
+  it('loads ScriptVault GM declarations through the Monaco TypeScript namespace', async () => {
+    const harness = createHarness({ typeDefinitions: 'declare function GM_getValue(name: string): unknown;' });
+
+    await runSandbox(harness.context);
+
+    expect(harness.context.fetch).toHaveBeenCalledWith('../lib/scriptvault.d.ts', { cache: 'force-cache' });
+    expect(harness.monaco.typescript.javascriptDefaults.addExtraLib).toHaveBeenCalledWith(
+      'declare function GM_getValue(name: string): unknown;',
+      'file:///scriptvault/lib/scriptvault.d.ts',
+    );
+  });
+
   it('posts the existing fallback message when the ESM bundle is missing', async () => {
     const harness = createHarness({ moduleFails: true });