ux4g-components-web 1.1.1 → 1.2.0

package/dist/runtime/index.d.ts

@@ -1,17 +1,33 @@
 /**
  * UX4G Runtime Module
  *
- * Framework-agnostic runtime that encapsulates ALL interactive behaviors
- * from the vendor CDN scripts (ux4g.js + ux4g-custom.js).
+ * Injects the vendor JS (ux4g.js + ux4g-custom.js) into the page as inline scripts.
+ * These files handle all interactive behaviors: dropdowns, modals, tooltips,
+ * accordions, carousels, drawers, tabs, popovers, toasts, scrollspy, etc.
+ *
+ * The vendor JS is inlined at build time by the Rollup virtual plugin.
+ * At runtime, initRuntime() creates <script> elements with the inlined code.
  *
  * Uses a singleton guard (window.__UX4G_RUNTIME_INITIALIZED__) to ensure
- * initialization happens exactly once.
+ * the scripts are injected exactly once.
  */
 declare global {
     interface Window {
         __UX4G_RUNTIME_INITIALIZED__?: boolean;
-        __ux4gInitRaf?: number;
+        ux4g?: Record<string, unknown>;
     }
 }
+/**
+ * Initialize the UX4G runtime by injecting the vendor JS scripts into the page.
+ *
+ * - Safe for SSR — no-ops when window/document are unavailable.
+ * - Singleton guard prevents double-injection.
+ * - The vendor JS handles its own DOMContentLoaded timing internally.
+ * - MutationObserver in the vendor JS auto-initializes dynamically added elements.
+ */
 export declare function initRuntime(): void;
+/**
+ * Destroy the UX4G runtime.
+ * Removes injected scripts and resets the singleton guard.
+ */
 export declare function destroyRuntime(): void;