@tenorlab/react-dashboard 1.5.26 → 1.5.42

package/dist/core.es.js

@@ -1,4 +1,4 @@
-const w = [
+const W = [
   {
     key: "grid-gap",
     name: "Gap",
@@ -76,7 +76,7 @@ const w = [
     defaultValue: "1.0rem",
     value: "1.0rem"
   }
-], S = ["rem", "pc", "cm", "in", "em", "vh", "vw", "%"], b = (e, t) => S.includes(e) ? t : 1, E = {
+], b = ["rem", "pc", "cm", "in", "em", "vh", "vw", "%"], S = (e, t) => b.includes(e) ? t : 1, E = {
   /**
    * @name incrementOrDecrementValue
    * @description Increments or decrement a value based on the direction parameter
@@ -85,65 +85,65 @@ const w = [
    * @returns the update item
    */
   incrementOrDecrementValue: (e, t) => {
-    const a = e.value.match(/([\d.]+)/), i = a ? parseFloat(a[1]) : 0, s = e.value.match(/([^\d.]+)/), n = s ? s[1] : e.defaultUnit, r = b(n, e.step) * t, c = `${Math.max(i + r, e.minValue).toFixed(1)}${n}`;
+    const i = e.value.match(/([\d.]+)/), a = i ? parseFloat(i[1]) : 0, r = e.value.match(/([^\d.]+)/), n = r ? r[1] : e.defaultUnit, s = S(n, e.step) * t, l = `${Math.max(a + s, e.minValue).toFixed(1)}${n}`;
     return {
       ...e,
-      value: c
+      value: l
     };
   }
-}, f = (e, t) => `dashboards_${t}_${e}`, v = async (e, t, a, i) => {
-  const s = localStorage.getItem(f(e, t));
-  if (s)
+}, y = (e, t) => `dashboards_${t}_${e}`, v = async (e, t, i, a) => {
+  const r = localStorage.getItem(y(e, t));
+  if (r)
     try {
-      const n = JSON.parse(s);
-      return n.length < 1 ? [i] : (n.forEach((r) => {
-        r.dashboardId || (r.dashboardId = "default"), r.dashboardName || (r.dashboardName = `Dashboard ${r.dashboardId}`), r.responsiveGrid = r.responsiveGrid ?? !1, (r.widgets || []).length < 1 && (r.widgets = i.widgets);
-        const c = (r.cssSettings || []).filter(
-          (o) => i.cssSettings.some((d) => d.key === o.key)
+      const n = JSON.parse(r);
+      return n.length < 1 ? [a] : (n.forEach((s) => {
+        s.dashboardId || (s.dashboardId = "default"), s.dashboardName || (s.dashboardName = `Dashboard ${s.dashboardId}`), s.responsiveGrid = s.responsiveGrid ?? !1, (s.widgets || []).length < 1 && (s.widgets = a.widgets);
+        const l = (s.cssSettings || []).filter(
+          (o) => a.cssSettings.some((d) => d.key === o.key)
         );
-        if (c.length < 1)
-          r.cssSettings = [...i.cssSettings];
+        if (l.length < 1)
+          s.cssSettings = [...a.cssSettings];
         else {
-          c.forEach((d) => {
+          l.forEach((d) => {
             d.value = (d.value || "").replace(/NaN/g, "");
-            const l = i.cssSettings.find(
+            const c = a.cssSettings.find(
               (g) => g.key === d.key
             );
-            l && (Object.keys(l).forEach((g) => {
-              g in d || (d[g] = l[g]);
-            }), d.step = l.step, d.minValue = l.minValue, d.defaultValue = l.defaultValue, d.defaultUnit = l.defaultUnit, /\d+/g.test(d.value) === !1 && (d.value = l ? l.value : "1.0rem"));
+            c && (Object.keys(c).forEach((g) => {
+              g in d || (d[g] = c[g]);
+            }), d.step = c.step, d.minValue = c.minValue, d.defaultValue = c.defaultValue, d.defaultUnit = c.defaultUnit, /\d+/g.test(d.value) === !1 && (d.value = c ? c.value : "1.0rem"));
           });
-          const o = i.cssSettings.filter((d) => !c.some(
-            (l) => l.key === d.key
+          const o = a.cssSettings.filter((d) => !l.some(
+            (c) => c.key === d.key
           ));
-          r.cssSettings = [...c, ...o];
+          s.cssSettings = [...l, ...o];
         }
-        r.widgets = r.widgets.filter(
-          (o) => o.includes("WidgetContainer") || a.has(o)
-        ), r.childWidgetsConfig = r.childWidgetsConfig.filter(
-          (o) => a.has(o.widgetKey)
-        ), r.zoomScale ? r.zoomScale < 0.7 && (r.zoomScale = 0.7) : r.zoomScale = 1;
+        s.widgets = s.widgets.filter(
+          (o) => o.includes("WidgetContainer") || i.has(o)
+        ), s.childWidgetsConfig = s.childWidgetsConfig.filter(
+          (o) => i.has(o.widgetKey)
+        ), s.zoomScale ? s.zoomScale < 0.7 && (s.zoomScale = 0.7) : s.zoomScale = 1;
       }), n);
     } catch (n) {
       console.warn("Error parsing saved dashboard config:", n);
     }
-  return [i];
-}, C = async (e, t, a, i) => {
-  a.forEach((n) => {
+  return [a];
+}, $ = async (e, t, i, a) => {
+  i.forEach((n) => {
     if (n.userID = e, n.clientAppKey = t, n.responsiveGrid = n.responsiveGrid ?? !1, typeof n != "object")
       throw new Error("Invalid dashboard configuration");
     n.widgets = n.widgets.filter(
-      (r) => r.includes("WidgetContainer") || i.has(r)
+      (s) => s.includes("WidgetContainer") || a.has(s)
     ), n.childWidgetsConfig = n.childWidgetsConfig.filter(
-      (r) => i.has(r.widgetKey)
+      (s) => a.has(s.widgetKey)
     ), n.zoomScale ? n.zoomScale < 0.7 && (n.zoomScale = 0.7) : n.zoomScale = 1;
   });
-  const s = JSON.stringify(a);
-  return localStorage.setItem(f(e, t), s), !0;
-}, W = {
+  const r = JSON.stringify(i);
+  return localStorage.setItem(y(e, t), r), !0;
+}, D = {
   getSavedDashboards: v,
-  saveDashboards: C
-}, P = () => W, z = {
+  saveDashboards: $
+}, P = () => D, U = {
   userID: 0,
   clientAppKey: "",
   dashboardId: "default",
@@ -152,158 +152,323 @@ const w = [
   responsiveGrid: !1,
   widgets: [],
   childWidgetsConfig: [],
-  cssSettings: [...w]
-}, U = (e) => {
+  cssSettings: [...W]
+}, z = (e) => {
   const t = `${e}`.split("_");
   return t.length > 1 ? t[1].replace(/(\D)(\d+)/, "$1 $2") : "Container";
-}, u = 0.7, p = 1, V = 0.05, D = (e) => {
+}, p = 0.7, h = 1, V = 0.05, K = (e) => {
   let t = Number(e || 0);
-  return t < u && (t = u), t > p && (t = p), t;
-}, j = (e, t) => {
-  let a = Number(Number((V * t).toFixed(2)).toFixed(2)), i = Number((Number(e) + a).toFixed(2));
-  return D(i);
-}, N = (e) => {
+  return t < p && (t = p), t > h && (t = h), t;
+}, L = (e, t) => {
+  let i = Number(Number((V * t).toFixed(2)).toFixed(2)), a = Number((Number(e) + i).toFixed(2));
+  return K(a);
+}, j = (e) => {
   let t = {
     ...e
   };
-  return t.widgets = t.widgets.filter((a) => {
-    if (`${a}`.includes("WidgetContainer")) {
-      const i = t.childWidgetsConfig.filter(
-        (s) => s.parentWidgetKey === a
+  return t.widgets = t.widgets.filter((i) => {
+    if (`${i}`.includes("WidgetContainer")) {
+      const a = t.childWidgetsConfig.filter(
+        (r) => r.parentWidgetKey === i
       );
-      if (!i || i.length === 0)
+      if (!a || a.length === 0)
         return t.widgets = t.widgets.filter(
-          (s) => s !== a
+          (r) => r !== i
         ), !1;
     }
     return !0;
   }), t;
 }, x = (e) => {
   const t = e.widgets.filter(
-    (i) => i.includes("WidgetContainer")
-  ), a = {};
-  return t.forEach((i, s) => {
-    const n = `${i.split("_container")[0]}_container${s + 1}`;
-    a[i] = n;
-  }), e.widgets = e.widgets.map((i) => a[i] || i), e.childWidgetsConfig = e.childWidgetsConfig.map((i) => {
-    const s = i.parentWidgetKey, n = a[s];
+    (a) => a.includes("WidgetContainer")
+  ), i = {};
+  return t.forEach((a, r) => {
+    const n = `${a.split("_container")[0]}_container${r + 1}`;
+    i[a] = n;
+  }), e.widgets = e.widgets.map((a) => i[a] || a), e.childWidgetsConfig = e.childWidgetsConfig.map((a) => {
+    const r = a.parentWidgetKey, n = i[r];
     return {
-      ...i,
+      ...a,
       // If a new key exists, use it. If not, keep the original key.
-      parentWidgetKey: n || s
+      parentWidgetKey: n || r
     };
   }), e;
 }, m = (e, t) => {
-  const a = `${e}`.includes("Container"), i = a ? ["Container"] : ["Widget"], s = t?.name || e, n = t?.description || (a ? "Container" : "Unknown");
+  const i = `${e}`.includes("Container"), a = i ? ["Container"] : ["Widget"], r = t?.name || e, n = t?.description || (i ? "Container" : "Unknown");
   return {
-    name: s,
+    name: r,
     description: n,
-    categories: i,
+    categories: a,
     noDuplicatedWidgets: !0,
     icon: void 0,
     externalDependencies: []
   };
-}, I = (e, t, a) => t[e] || m(e, a), M = (e, t) => t.get(e)?.meta || m(e), k = (e, t, a) => {
-  const i = a || m(e);
+}, M = (e, t, i) => t[e] || m(e, i), I = (e, t) => t.get(e)?.meta || m(e), k = (e, t, i) => {
+  const a = i || m(e);
   return [
     e,
     {
       key: e,
-      title: i.name,
+      title: a.name,
       isContainer: `${e}`.includes("Container"),
       isRemote: !1,
-      meta: i,
+      meta: a,
       component: t
     }
   ];
-}, h = (e, t, a, i) => {
-  const s = i || m(e);
+}, C = (e, t, i, a) => {
+  const r = a || m(e);
   return [
     e,
     {
       key: e,
-      title: s.name,
+      title: r.name,
       isContainer: !1,
-      isRemote: a,
-      meta: s,
+      isRemote: i,
+      meta: r,
       loader: t
     }
   ];
 }, F = (e) => {
   const t = e.match(/\/widget-([a-zA-Z0-9-]+)\/index\.ts$/);
   if (t && t[1]) {
-    const a = t[1], i = a.split("-"), s = `Widget${i.map((r) => r.charAt(0).toUpperCase() + r.slice(1)).join("")}`, n = i.map((r) => r.charAt(0).toUpperCase() + r.slice(1)).join(" ");
+    const i = t[1], a = i.split("-"), r = `Widget${a.map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("")}`, n = a.map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
     return {
-      key: s,
+      key: r,
       name: n,
-      folder: a
+      folder: i
     };
   }
   return null;
-}, $ = (e, t, a, i) => {
-  const s = `${t}/widget-${a}/meta.ts`, n = e[s];
+}, N = (e, t, i, a) => {
+  const r = `${t}/widget-${i}/meta.ts`, n = e[r];
   if (!n)
     return;
-  const r = `${i}Meta`;
-  return n[r] || void 0;
-}, A = async (e) => new Promise(async (t, a) => {
-  const i = [];
+  const s = `${a}Meta`;
+  return n[s] || void 0;
+}, A = async (e) => new Promise(async (t, i) => {
+  const a = [];
   try {
-    const s = await (await fetch(`${e}?${Math.random()}`)).json();
-    for (const n in s) {
-      const r = s[n], c = () => import(
+    const r = await (await fetch(`${e}?${Math.random()}`)).json();
+    for (const n in r) {
+      const s = r[n], l = () => import(
         /* @vite-ignore */
-        r.url
+        s.url
       ), o = {
-        name: r.meta?.name || "Unknown",
-        description: r.meta?.description || "Remote Plugin",
-        categories: r.meta?.categories || ["Widget"],
-        noDuplicatedWidgets: r.meta?.noDuplicatedWidgets ?? !0,
+        name: s.meta?.name || "Unknown",
+        description: s.meta?.description || "Remote Plugin",
+        categories: s.meta?.categories || ["Widget"],
+        noDuplicatedWidgets: s.meta?.noDuplicatedWidgets ?? !0,
         icon: void 0,
         // Or a logic to map a string name to a Lucide component
-        externalDependencies: r.meta?.externalDependencies || []
+        externalDependencies: s.meta?.externalDependencies || []
       };
-      i.push(h(n, c, !0, o));
+      a.push(C(n, l, !0, o));
     }
     t({
-      entries: i,
+      entries: a,
       message: "",
       details: ""
     });
-  } catch (s) {
-    console.error("Remote plugin discovery failed:", s), a({
+  } catch (r) {
+    console.error("Remote plugin discovery failed:", r), i({
       entries: [],
       message: "Remote plugin discovery failed:",
-      details: typeof s == "object" ? JSON.stringify(s) : s
+      details: typeof r == "object" ? JSON.stringify(r) : r
     });
   }
-}), K = (e, t, a, i = !0) => {
-  const s = [];
+}), R = (e, t, i, a = !0) => {
+  const r = [];
   for (const n in t) {
-    const r = t[n], c = F(n);
-    if (c && r) {
-      const { key: o, name: d, folder: l } = c;
-      let g = $(a, e, l, o);
+    const s = t[n], l = F(n);
+    if (l && s) {
+      const { key: o, name: d, folder: c } = l;
+      let g = N(i, e, c, o);
       if (g || (g = m(o, {
         name: d,
-        description: `Local ${i ? "dynamic" : "static"} widget`
-      })), i)
-        s.push(
-          h(o, r, !1, g)
+        description: `Local ${a ? "dynamic" : "static"} widget`
+      })), a)
+        r.push(
+          C(o, s, !1, g)
         );
       else {
-        const y = r.default || r;
-        s.push(k(o, y, g));
+        const f = s.default || s;
+        r.push(k(o, f, g));
       }
     }
   }
-  return s;
-}, R = (e, t = "color") => {
+  return r;
+}, w = (e) => {
+  const t = e.widgets.filter((i) => i.includes("WidgetContainer")).map((i) => Number(i.split("_")[1].replace("container", "")));
+  return `container${t.length > 0 ? Math.max(...t) + 1 : 1}`;
+}, O = {
+  /**
+   * @name getNextContainerName
+   * @description Generates the next container name based on existing containers in the dashboard configuration
+   * @param dashboardConfig
+   * @returns {string} The next container name in the format 'containerX', where X is the next available number
+   */
+  getNextContainerName: w,
+  /**
+   * @name getNextContainerKey
+   * @description Generates the next container widget key based on the dashboard configuration and a given container widget key
+   * @param dashboardConfig
+   * @param containerWidgetKey
+   * @returns {TDashboardWidgetKey} The next container widget key
+   */
+  getNextContainerKey: (e, t) => {
+    const i = w(e);
+    return `${t}_${i}`;
+  },
+  /**
+   * @description Adds a widget to the configuration. Supports root-level and nested containers.
+   * @param params - Configuration object for adding a widget.
+   * @param params.dashboardConfig - The current {@link IDashboardConfig}.
+   * @param params.widgetKey - The {@link TDashboardWidgetKey} to add.
+   * @param params.parentWidgetKey - Optional parent container key.
+   * @param params.noDuplicatedWidgets - If true, prevents adding the same key twice.
+   * @returns A {@link TCoreResponse} containing the success status and updated config.
+   */
+  addWidget: (e) => {
+    const { dashboardConfig: t, widgetKey: i, parentWidgetKey: a, noDuplicatedWidgets: r } = e;
+    if (a) {
+      if (r && t.childWidgetsConfig.find(
+        (s) => s.parentWidgetKey === a && s.widgetKey === i
+      ))
+        return {
+          success: !1,
+          message: `DashboardStore: addWidget: Widget already added (${i})`,
+          updatedDashboardConfig: t
+        };
+      const n = [
+        ...t.childWidgetsConfig,
+        { parentWidgetKey: a, widgetKey: i }
+        // new entry
+      ];
+      return {
+        success: !0,
+        updatedDashboardConfig: {
+          ...t,
+          childWidgetsConfig: n
+        }
+      };
+    } else {
+      if (r && t.widgets.includes(i))
+        return {
+          success: !1,
+          message: `DashboardStore: addWidget: Widget already added (${i})`,
+          updatedDashboardConfig: t
+        };
+      const n = [...t.widgets, i];
+      return {
+        success: !0,
+        updatedDashboardConfig: {
+          ...t,
+          widgets: n
+        }
+      };
+    }
+  },
+  /**
+   * @name removeWidget
+   * @description Removes a widget from the dashboard configuration, either from the root level or from a specified parent container
+   * @param dashboardConfig
+   * @param widgetKey
+   * @param parentWidgetKey
+   * @returns {TCoreResponse<TRemoveWidgetResponse>} The response indicating success or failure and the updated dashboard configuration
+   */
+  removeWidget: (e, t, i) => {
+    const a = `${t || ""}`.trim().toLowerCase(), r = `${i || ""}`.trim().toLowerCase();
+    if (r.length > 0) {
+      const n = e.childWidgetsConfig.filter(
+        (d) => `${d.parentWidgetKey}`.trim().toLowerCase() !== r
+      ), s = e.childWidgetsConfig.filter(
+        (d) => `${d.parentWidgetKey}`.trim().toLowerCase() === r && `${d.widgetKey}`.trim().toLowerCase() !== a
+      ), l = [...n, ...s];
+      let o = {
+        ...e,
+        childWidgetsConfig: l
+      };
+      return a.includes("container") && (o = x(o)), {
+        success: !0,
+        updatedDashboardConfig: o
+      };
+    } else {
+      const n = (e.widgets || []).filter(
+        (l) => `${l}`.trim().toLowerCase() !== a
+      ), s = e.childWidgetsConfig.filter(
+        (l) => `${l.parentWidgetKey}`.trim().toLowerCase() !== a
+      );
+      return {
+        success: !0,
+        updatedDashboardConfig: {
+          ...e,
+          widgets: n,
+          childWidgetsConfig: s
+        }
+      };
+    }
+  },
+  /**
+   * @description Moves a widget's position within its current depth (root or container).
+   * @param dashboardConfig - The current {@link IDashboardConfig}.
+   * @param direction - Use `1` for forward/down and `-1` for backward/up.
+   * @param widgetKey - The {@link TDashboardWidgetKey} to move.
+   * @param parentWidgetKey - The container key if the widget is nested.
+   * @returns A {@link TCoreResponse} with the new array order.
+   */
+  moveWidget: (e, t, i, a) => {
+    const r = `${i || ""}`.trim().toLowerCase(), n = `${a || ""}`.trim().toLowerCase();
+    if (n.length > 0) {
+      const s = e.childWidgetsConfig.filter(
+        (u) => `${u.parentWidgetKey}`.trim().toLowerCase() !== n
+      );
+      let l = e.childWidgetsConfig.filter(
+        (u) => `${u.parentWidgetKey}`.trim().toLowerCase() === n
+      );
+      const o = l.find(
+        (u) => `${u.widgetKey}`.trim().toLowerCase() === r
+      ), d = l.indexOf(o);
+      let c = d + t;
+      if (c = Math.max(0, c), c = Math.min(l.length - 1, c), c === d)
+        return {
+          success: !1,
+          message: `DashboardStore: moveWidget: Widget already at min/max position (${i})`,
+          updatedDashboardConfig: e
+        };
+      const g = [...l], [f] = g.splice(d, 1);
+      return g.splice(c, 0, f), {
+        success: !0,
+        updatedDashboardConfig: {
+          ...e,
+          childWidgetsConfig: [...s, ...g]
+        }
+      };
+    } else {
+      const s = e.widgets || [], l = s.map((g) => `${g}`.trim().toLowerCase()).indexOf(r);
+      let o = l + t;
+      if (o = Math.max(0, o), o = Math.min(s.length - 1, o), o === l)
+        return {
+          success: !1,
+          message: `DashboardStore: moveWidget: Widget already at min/max position (${i})`,
+          updatedDashboardConfig: e
+        };
+      const d = [...s], [c] = d.splice(l, 1);
+      return d.splice(o, 0, c), {
+        success: !0,
+        updatedDashboardConfig: {
+          ...e,
+          widgets: d
+        }
+      };
+    }
+  }
+}, _ = (e, t = "color") => {
   if (typeof window > "u") return "#FFFFFF";
-  const a = document.createElement("div");
-  Array.isArray(e) ? e.forEach((s) => a.classList.add(s)) : e.split(" ").forEach((s) => a.classList.add(s)), a.style.display = "none", document.body.appendChild(a);
-  const i = window.getComputedStyle(a)[t];
-  return document.body.removeChild(a), i;
+  const i = document.createElement("div");
+  Array.isArray(e) ? e.forEach((r) => i.classList.add(r)) : e.split(" ").forEach((r) => i.classList.add(r)), i.style.display = "none", document.body.appendChild(i);
+  const a = window.getComputedStyle(i)[t];
+  return document.body.removeChild(i), a;
 }, G = {
   /**
    * @name getCssVariableValue
@@ -333,8 +498,8 @@ const w = [
    */
   restoreCssVarsFromSettings: (e) => {
     const t = document.documentElement;
-    e.forEach((a) => {
-      t.style.setProperty(a.cssProperty, a.value);
+    e.forEach((i) => {
+      t.style.setProperty(i.cssProperty, i.value);
     });
   }
 }, Z = (e, ...t) => [
@@ -343,28 +508,29 @@ const w = [
   )
 ].join(" ").trim();
 export {
-  p as DashboardMaxZoomScale,
-  u as DashboardMinZoomScale,
+  h as DashboardMaxZoomScale,
+  p as DashboardMinZoomScale,
   V as DashboardZoomStep,
-  z as blankDashboardConfig,
-  h as createDynamicEntry,
+  U as blankDashboardConfig,
+  C as createDynamicEntry,
   k as createStaticEntry,
-  w as cssSettingsCatalog,
+  W as cssSettingsCatalog,
   G as cssVarsUtils,
   E as dashboardSettingsUtils,
+  O as dashboardStoreUtils,
   x as ensureContainersSequence,
-  D as ensureZoomScaleIsWithinRange,
+  K as ensureZoomScaleIsWithinRange,
   m as getDefaultWidgetMetaFromKey,
-  I as getDefaultWidgetMetaFromMap,
+  M as getDefaultWidgetMetaFromMap,
   Z as getDistinctCssClasses,
-  $ as getMetaInfoFromFile,
-  j as getNewZoomScaleWithinRange,
-  M as getWidgetMetaFromCatalog,
-  K as localWidgetDiscovery,
-  U as parseContainerTitle,
+  N as getMetaInfoFromFile,
+  L as getNewZoomScaleWithinRange,
+  I as getWidgetMetaFromCatalog,
+  R as localWidgetDiscovery,
+  z as parseContainerTitle,
   F as parseKeyAndTitleFromFilePath,
   A as remoteWidgetDiscovery,
-  N as removeEmptyContainers,
-  R as resolveColorFromClass,
+  j as removeEmptyContainers,
+  _ as resolveColorFromClass,
   P as useDashboardStorageService
 };

package/dist/react-dashboard.d.ts

@@ -323,6 +323,14 @@ export declare function SvgBaseWrapper({ children, className, }: {
 
 export declare function TabletSmartphoneIcon({ className }: TIconProps): JSX_2.Element;
 
+/**
+ * @name TAddWidgetResponse
+ * @description Type for the response of the addWidget mutation
+ * @property {boolean} success - Indicates if the widget was added successfully
+ * @property {string} [message] - Optional message providing additional information
+ * @property {IDashboardConfig} updatedDashboardConfig - The updated dashboard configuration after adding the widget
+ * @property {IDashboardConfig[]} allUpdatedDashboardConfigs - All updated dashboard configurations
+ */
 declare type TAddWidgetResponse = {
     success: boolean;
     message?: string;
@@ -526,6 +534,14 @@ export declare type TWidgetCategory = 'Widget' | 'Chart' | 'Container';
  */
 export declare type TWidgetDirection = 'row' | 'column';
 
+export declare type TWidgetErrorExtraProps = {
+    versionMismatch: boolean;
+    requiredVer: string;
+    hostVer: string;
+    errorMessage: string;
+    externalDependencies: string[];
+};
+
 /**
  * @name TWidgetFactory
  * @description A type representing a widget factory function specific to React framework.