@design.estate/dees-catalog 3.95.0 → 3.96.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "3.95.0",
+  "version": "3.96.0",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-catalog',
-  version: '3.95.0',
+  version: '3.96.0',
   description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 }

package/ts_web/services/DeesServiceLibLoader.ts

@@ -121,6 +121,16 @@ export interface ITiptapBundle {
  * const terminal = new xterm.Terminal({ ... });
  * ```
  */
+// Fix for xterm.js WidthCache measurement container causing horizontal
+// scrollbar: xterm creates it on document.body with width 50000px/top
+// -50000px; moving it off-screen horizontally prevents scrollWidth expansion.
+const xtermMeasurementFixCss = `
+/* Fix xterm.js WidthCache measurement container causing horizontal scrollbar */
+body > div[style*="top: -50000px"][style*="width: 50000px"] {
+  left: -50000px !important;
+}
+`;
+
 export class DeesServiceLibLoader {
   private static instance: DeesServiceLibLoader;
 
@@ -183,6 +193,37 @@ export class DeesServiceLibLoader {
     return this.xtermLoadingPromise;
   }
 
+  /**
+   * Provides xterm modules from the host application instead of the CDN.
+   * Hosts that bundle xterm (e.g. Electron apps that must work offline)
+   * call this before any terminal component initializes; subsequent
+   * loadXterm/loadXtermFitAddon calls resolve from these caches without
+   * network access. Pass the css text of xterm.css so the document-level
+   * styles (normally fetched from the CDN) are injected too.
+   */
+  public provideXtermModules(input: {
+    xterm: IXtermBundle;
+    fitAddon?: IXtermFitAddonBundle;
+    cssText?: string;
+  }): void {
+    this.xtermLib = { Terminal: input.xterm.Terminal };
+    if (input.fitAddon) {
+      this.xtermFitAddonLib = { FitAddon: input.fitAddon.FitAddon };
+    }
+    if (input.cssText) {
+      this.injectProvidedXtermStyles(input.cssText);
+    }
+  }
+
+  private injectProvidedXtermStyles(cssText: string): void {
+    const styleId = 'xterm-cdn-styles';
+    if (document.getElementById(styleId)) return;
+    const style = document.createElement('style');
+    style.id = styleId;
+    style.textContent = cssText + xtermMeasurementFixCss;
+    document.head.appendChild(style);
+  }
+
   /**
    * Load xterm-addon-fit from CDN
    * @returns Promise resolving to FitAddon class
@@ -248,20 +289,9 @@ export class DeesServiceLibLoader {
     const response = await fetch(cssUrl);
     const cssText = await response.text();
 
-    // Fix for xterm.js WidthCache measurement container causing horizontal scrollbar
-    // xterm.js creates this on document.body with width: 50000px, top: -50000px
-    // Moving it off-screen horizontally prevents scrollWidth expansion
-    const xtermMeasurementFix = `
-/* Fix xterm.js WidthCache measurement container causing horizontal scrollbar */
-/* xterm creates this on document.body - move it off-screen horizontally too */
-body > div[style*="top: -50000px"][style*="width: 50000px"] {
-  left: -50000px !important;
-}
-`;
-
     const style = document.createElement('style');
     style.id = styleId;
-    style.textContent = cssText + xtermMeasurementFix;
+    style.textContent = cssText + xtermMeasurementFixCss;
     document.head.appendChild(style);
   }