@design.estate/dees-catalog 10.0.0 → 11.1.0

package/ts_web/services/DeesServiceLibLoader.ts

@@ -164,6 +164,26 @@ export class DeesServiceLibLoader {
     return DeesServiceLibLoader.instance;
   }
 
+  /**
+   * Shares one in-flight load between concurrent callers — but only for as long
+   * as that load can still succeed. A rejected load clears its own cache entry,
+   * so the next call makes a fresh attempt instead of replaying a stale failure
+   * for the lifetime of the page. Every load below goes through this.
+   */
+  private shareLoad<T>(
+    loadArg: () => Promise<T>,
+    readArg: () => Promise<T> | null,
+    writeArg: (promiseArg: Promise<T> | null) => void,
+  ): Promise<T> {
+    const pending = loadArg();
+    writeArg(pending);
+    pending.catch(() => {
+      // Retract only this attempt; a newer one may already own the entry.
+      if (readArg() === pending) writeArg(null);
+    });
+    return pending;
+  }
+
   /**
    * Load xterm terminal emulator from CDN
    * @returns Promise resolving to xterm module with Terminal class
@@ -177,20 +197,24 @@ export class DeesServiceLibLoader {
       return this.xtermLoadingPromise;
     }
 
-    this.xtermLoadingPromise = (async () => {
-      const url = `${CDN_BASE}/xterm@${CDN_VERSIONS.xterm}/+esm`;
-      const module = await import(/* @vite-ignore */ url);
-
-      // Also load and inject xterm CSS
-      await this.injectXtermStyles();
-
-      this.xtermLib = {
-        Terminal: module.Terminal,
-      };
-      return this.xtermLib;
-    })();
-
-    return this.xtermLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        const url = `${CDN_BASE}/xterm@${CDN_VERSIONS.xterm}/+esm`;
+        const module = await import(/* @vite-ignore */ url);
+
+        // Also load and inject xterm CSS
+        await this.injectXtermStyles();
+
+        this.xtermLib = {
+          Terminal: module.Terminal,
+        };
+        return this.xtermLib;
+      },
+      () => this.xtermLoadingPromise,
+      (promiseArg) => {
+        this.xtermLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -237,17 +261,21 @@ export class DeesServiceLibLoader {
       return this.xtermFitAddonLoadingPromise;
     }
 
-    this.xtermFitAddonLoadingPromise = (async () => {
-      const url = `${CDN_BASE}/xterm-addon-fit@${CDN_VERSIONS.xtermAddonFit}/+esm`;
-      const module = await import(/* @vite-ignore */ url);
-
-      this.xtermFitAddonLib = {
-        FitAddon: module.FitAddon,
-      };
-      return this.xtermFitAddonLib;
-    })();
-
-    return this.xtermFitAddonLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        const url = `${CDN_BASE}/xterm-addon-fit@${CDN_VERSIONS.xtermAddonFit}/+esm`;
+        const module = await import(/* @vite-ignore */ url);
+
+        this.xtermFitAddonLib = {
+          FitAddon: module.FitAddon,
+        };
+        return this.xtermFitAddonLib;
+      },
+      () => this.xtermFitAddonLoadingPromise,
+      (promiseArg) => {
+        this.xtermFitAddonLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -263,17 +291,21 @@ export class DeesServiceLibLoader {
       return this.xtermSearchAddonLoadingPromise;
     }
 
-    this.xtermSearchAddonLoadingPromise = (async () => {
-      const url = `${CDN_BASE}/xterm-addon-search@${CDN_VERSIONS.xtermAddonSearch}/+esm`;
-      const module = await import(/* @vite-ignore */ url);
-
-      this.xtermSearchAddonLib = {
-        SearchAddon: module.SearchAddon,
-      };
-      return this.xtermSearchAddonLib;
-    })();
-
-    return this.xtermSearchAddonLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        const url = `${CDN_BASE}/xterm-addon-search@${CDN_VERSIONS.xtermAddonSearch}/+esm`;
+        const module = await import(/* @vite-ignore */ url);
+
+        this.xtermSearchAddonLib = {
+          SearchAddon: module.SearchAddon,
+        };
+        return this.xtermSearchAddonLib;
+      },
+      () => this.xtermSearchAddonLoadingPromise,
+      (promiseArg) => {
+        this.xtermSearchAddonLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -319,15 +351,19 @@ export class DeesServiceLibLoader {
       return this.highlightJsLoadingPromise;
     }
 
-    this.highlightJsLoadingPromise = (async () => {
-      const url = `${CDN_BASE}/highlight.js@${CDN_VERSIONS.highlightJs}/+esm`;
-      const module = await import(/* @vite-ignore */ url);
-
-      this.highlightJsLib = module.default;
-      return this.highlightJsLib!;
-    })();
-
-    return this.highlightJsLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        const url = `${CDN_BASE}/highlight.js@${CDN_VERSIONS.highlightJs}/+esm`;
+        const module = await import(/* @vite-ignore */ url);
+
+        this.highlightJsLib = module.default;
+        return this.highlightJsLib!;
+      },
+      () => this.highlightJsLoadingPromise,
+      (promiseArg) => {
+        this.highlightJsLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -343,22 +379,26 @@ export class DeesServiceLibLoader {
       return this.lightweightChartsLoadingPromise;
     }
 
-    this.lightweightChartsLoadingPromise = (async () => {
-      const url = `${CDN_BASE}/lightweight-charts@${CDN_VERSIONS.lightweightCharts}/+esm`;
-      const module = await import(/* @vite-ignore */ url);
-
-      this.lightweightChartsLib = {
-        createChart: module.createChart,
-        AreaSeries: module.AreaSeries,
-        LineSeries: module.LineSeries,
-        ColorType: module.ColorType,
-        LineType: module.LineType,
-        CrosshairMode: module.CrosshairMode,
-      };
-      return this.lightweightChartsLib;
-    })();
-
-    return this.lightweightChartsLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        const url = `${CDN_BASE}/lightweight-charts@${CDN_VERSIONS.lightweightCharts}/+esm`;
+        const module = await import(/* @vite-ignore */ url);
+
+        this.lightweightChartsLib = {
+          createChart: module.createChart,
+          AreaSeries: module.AreaSeries,
+          LineSeries: module.LineSeries,
+          ColorType: module.ColorType,
+          LineType: module.LineType,
+          CrosshairMode: module.CrosshairMode,
+        };
+        return this.lightweightChartsLib;
+      },
+      () => this.lightweightChartsLoadingPromise,
+      (promiseArg) => {
+        this.lightweightChartsLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -374,21 +414,25 @@ export class DeesServiceLibLoader {
       return this.echartsLoadingPromise;
     }
 
-    this.echartsLoadingPromise = (async () => {
-      // Use the pre-built ESM bundle which includes all chart types and components.
-      // The +esm wrapper only exports the core without auto-registered chart types.
-      const url = `${CDN_BASE}/echarts@${CDN_VERSIONS.echarts}/dist/echarts.esm.min.js`;
-      const module = await import(/* @vite-ignore */ url);
-
-      this.echartsLib = {
-        init: module.init,
-        dispose: module.dispose,
-        getInstanceByDom: module.getInstanceByDom,
-      };
-      return this.echartsLib;
-    })();
-
-    return this.echartsLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        // Use the pre-built ESM bundle which includes all chart types and components.
+        // The +esm wrapper only exports the core without auto-registered chart types.
+        const url = `${CDN_BASE}/echarts@${CDN_VERSIONS.echarts}/dist/echarts.esm.min.js`;
+        const module = await import(/* @vite-ignore */ url);
+
+        this.echartsLib = {
+          init: module.init,
+          dispose: module.dispose,
+          getInstanceByDom: module.getInstanceByDom,
+        };
+        return this.echartsLib;
+      },
+      () => this.echartsLoadingPromise,
+      (promiseArg) => {
+        this.echartsLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**
@@ -404,32 +448,36 @@ export class DeesServiceLibLoader {
       return this.tiptapLoadingPromise;
     }
 
-    this.tiptapLoadingPromise = (async () => {
-      // Import directly from npm packages — bundled by esbuild into a single
-      // module graph. CDN loading caused duplicate ProseMirror instances because
-      // jsdelivr resolves each package's dependencies independently.
-      const [coreModule, starterKitModule, underlineModule, textAlignModule, linkModule, typographyModule] = await Promise.all([
-        import('@tiptap/core'),
-        import('@tiptap/starter-kit'),
-        import('@tiptap/extension-underline'),
-        import('@tiptap/extension-text-align'),
-        import('@tiptap/extension-link'),
-        import('@tiptap/extension-typography'),
-      ]);
-
-      this.tiptapLib = {
-        Editor: coreModule.Editor,
-        StarterKit: starterKitModule.default || starterKitModule.StarterKit,
-        Underline: underlineModule.default || underlineModule.Underline,
-        TextAlign: textAlignModule.default || textAlignModule.TextAlign,
-        Link: linkModule.default || linkModule.Link,
-        Typography: typographyModule.default || typographyModule.Typography,
-      };
-
-      return this.tiptapLib;
-    })();
-
-    return this.tiptapLoadingPromise;
+    return this.shareLoad(
+      async () => {
+        // Import directly from npm packages — bundled by esbuild into a single
+        // module graph. CDN loading caused duplicate ProseMirror instances because
+        // jsdelivr resolves each package's dependencies independently.
+        const [coreModule, starterKitModule, underlineModule, textAlignModule, linkModule, typographyModule] = await Promise.all([
+          import('@tiptap/core'),
+          import('@tiptap/starter-kit'),
+          import('@tiptap/extension-underline'),
+          import('@tiptap/extension-text-align'),
+          import('@tiptap/extension-link'),
+          import('@tiptap/extension-typography'),
+        ]);
+
+        this.tiptapLib = {
+          Editor: coreModule.Editor,
+          StarterKit: starterKitModule.default || starterKitModule.StarterKit,
+          Underline: underlineModule.default || underlineModule.Underline,
+          TextAlign: textAlignModule.default || textAlignModule.TextAlign,
+          Link: linkModule.default || linkModule.Link,
+          Typography: typographyModule.default || typographyModule.Typography,
+        };
+
+        return this.tiptapLib;
+      },
+      () => this.tiptapLoadingPromise,
+      (promiseArg) => {
+        this.tiptapLoadingPromise = promiseArg;
+      },
+    );
   }
 
   /**

package/.smartconfig.json

@@ -1,86 +0,0 @@
-{
-  "@git.zone/cli": {
-    "projectType": "wcc",
-    "module": {
-      "githost": "code.foss.global",
-      "gitscope": "design.estate",
-      "gitrepo": "dees-catalog",
-      "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
-      "npmPackagename": "@design.estate/dees-catalog",
-      "license": "MIT",
-      "projectDomain": "design.estate",
-      "keywords": [
-        "Web Components",
-        "User Interface",
-        "UI Library",
-        "Component Library",
-        "JavaScript",
-        "TypeScript",
-        "Dynamic Components",
-        "Modular Architecture",
-        "Reusable Components",
-        "Web Development",
-        "Application UI",
-        "Custom Elements",
-        "Shadow DOM",
-        "UI Elements",
-        "Dashboard Interfaces",
-        "Form Handling",
-        "Data Display",
-        "Visualization",
-        "Charting",
-        "Interactive Components",
-        "Responsive Design",
-        "Web Applications",
-        "Modern Web",
-        "Frontend Development"
-      ]
-    },
-    "release": {
-      "targets": {
-        "git": {
-          "enabled": true,
-          "remote": "origin",
-          "pushBranch": true,
-          "pushTags": true
-        },
-        "npm": {
-          "enabled": true,
-          "registries": [
-            "https://verdaccio.lossless.digital",
-            "https://registry.npmjs.org"
-          ],
-          "accessLevel": "public",
-          "alreadyPublished": "success"
-        }
-      }
-    },
-    "schemaVersion": 2
-  },
-  "@git.zone/tsdoc": {
-    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
-  },
-  "@ship.zone/szci": {
-    "npmGlobalTools": []
-  },
-  "@git.zone/tsbundle": {
-    "bundles": [
-      {
-        "from": "./ts_web/index.ts",
-        "to": "./dist_bundle/bundle.js",
-        "outputMode": "bundle",
-        "bundler": "esbuild",
-        "banner": "/*!\n * Includes PDF.js 4.10.38, Copyright 2024 Mozilla Foundation.\n * PDF.js is licensed under the Apache License, Version 2.0.\n * This file was generated by bundling PDF.js with @design.estate/dees-catalog.\n * See third-party-notices.md for attribution, modification notice, and license terms.\n */",
-        "includeFiles": [
-          "./third-party-notices.md"
-        ]
-      }
-    ]
-  },
-  "@git.zone/tswatch": {
-    "preset": "element",
-    "server": {
-      "enabled": true
-    }
-  }
-}