@richardmcquiston01/dashboard-widgets-toolkit 0.16.0 → 0.17.0

package/dist/react.cjs

@@ -2068,6 +2068,9 @@ function viewChoices(item) {
     }))
   ];
 }
+function isProviderView(view) {
+  return view.convert === void 0;
+}
 function isKnownView(item, key) {
   return key !== void 0 && (key === BASE_VIEW_KEY || findView(item, key) !== void 0);
 }
@@ -2077,6 +2080,14 @@ function effectiveViewKey(item, chosen) {
   if (isKnownView(item, item.defaultView)) return item.defaultView;
   return BASE_VIEW_KEY;
 }
+function loadViewKey(item, chosen) {
+  const key = effectiveViewKey(item, chosen);
+  const view = findView(item, key);
+  return view !== void 0 && isProviderView(view) ? key : BASE_VIEW_KEY;
+}
+function loadViewKind(item, chosen) {
+  return findView(item, loadViewKey(item, chosen))?.kind ?? item.kind;
+}
 function cellValue2(cell) {
   const value = cell?.value;
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
@@ -2211,6 +2222,11 @@ function convertView(widgetKey, view, data, options = {}) {
     where: `Widget ${JSON.stringify(widgetKey)} view ${JSON.stringify(view.key)}`,
     ...options.locale === void 0 ? {} : { locale: options.locale }
   };
+  if (conversion === void 0) {
+    return err(
+      `${context.where}: the provider supplies this view, so there is nothing to convert.`
+    );
+  }
   const expected = VIEW_CONVERSIONS[conversion.type]?.from;
   if (expected === void 0) {
     return err(
@@ -2238,14 +2254,29 @@ function convertView(widgetKey, view, data, options = {}) {
 function applyView(widget, chosen, options = {}) {
   const key = effectiveViewKey(widget.definition, chosen);
   const view = findView(widget.definition, key);
-  if (view === void 0) return widget;
+  const wanted = loadViewKey(widget.definition, chosen);
+  const loaded = widget.status === "ok" ? widget.view ?? BASE_VIEW_KEY : void 0;
+  const mismatched = loaded !== void 0 && loaded !== wanted;
+  if (view === void 0) {
+    return mismatched ? {
+      definition: widget.definition,
+      status: "loading",
+      ...widget.options === void 0 ? {} : { options: widget.options }
+    } : widget;
+  }
   const definition = {
     ...widget.definition,
     kind: view.kind
   };
-  if (widget.status === "loading") return { ...widget, definition };
-  if (widget.status === "empty") return { ...widget, definition };
-  if (widget.status === "error") return { ...widget, definition };
+  if (widget.status !== "ok") return { ...widget, definition };
+  if (mismatched) {
+    return {
+      definition,
+      status: "loading",
+      ...widget.options === void 0 ? {} : { options: widget.options }
+    };
+  }
+  if (isProviderView(view)) return { ...widget, definition };
   const converted = convertView(
     widget.definition.key,
     view,
@@ -5679,7 +5710,10 @@ function resolvePayload(definition, payload, options = {}) {
   } else {
     const result = validateWidgetData(payload, {
       widgetKey: definition.key,
-      expectedKind: definition.kind
+      expectedKind: loadViewKind(
+        definition,
+        options.viewValues?.[definition.key]
+      )
     });
     if (!result.ok) {
       return { definition, status: "error", error: result.error };
@@ -5690,7 +5724,14 @@ function resolvePayload(definition, payload, options = {}) {
   if (emptyText !== null) {
     return { definition, status: "empty", emptyText };
   }
-  return { definition, status: "ok", data: checked };
+  return {
+    definition,
+    status: "ok",
+    data: checked,
+    ...hasViews(definition) ? {
+      view: loadViewKey(definition, options.viewValues?.[definition.key])
+    } : {}
+  };
 }
 function failedWidget(definition, error) {
   return { definition, status: "error", error };
@@ -5700,7 +5741,14 @@ function loadingWidgets(definitions) {
 }
 function cacheKeyFor(definition, options, values) {
   const base = options.cacheKey === void 0 ? definition.sourceKey ?? definition.key : options.cacheKey(definition);
-  return values === void 0 ? base : `${base}${optionsCacheSuffix(definition, values, options)}`;
+  const view = loadViewKey(
+    definition,
+    options.viewValues?.[definition.key]
+  );
+  const viewPart = view === BASE_VIEW_KEY ? "" : `view=${encodeURIComponent(view)}`;
+  const optionPart = values === void 0 ? "" : optionsCacheSuffix(definition, values, options);
+  if (viewPart === "") return `${base}${optionPart}`;
+  return optionPart === "" ? `${base}?${viewPart}` : `${base}?${viewPart}&${optionPart.slice(1)}`;
 }
 function optionValuesFor(definition, options) {
   return resolveOptionValues(
@@ -5711,6 +5759,9 @@ function optionValuesFor(definition, options) {
 }
 function finalizeWidget(widget, values) {
   if (Object.keys(values).length === 0) return widget;
+  if (widget.status === "ok" && widget.view !== void 0 && widget.view !== BASE_VIEW_KEY) {
+    return { ...widget, options: values };
+  }
   if (widget.status === "ok") {
     const data = applyClientOptions(
       widget.definition,
@@ -5761,7 +5812,8 @@ async function resolveWidgetUnapplied(definition, provider, context, options = {
         if (controller.signal.aborted) throw new LoadInterruption();
         return provider(context, definition, {
           signal: controller.signal,
-          options: values
+          options: values,
+          view: loadViewKey(definition, options.viewValues?.[definition.key])
         });
       }),
       interrupted
@@ -5809,9 +5861,18 @@ function createWidgetLoader(options) {
       ([key, values]) => values === void 0 ? [] : [[key, values]]
     )
   );
+  const chosenViews = new Map(
+    Object.entries(baseOptions.viewValues ?? {}).flatMap(
+      ([key, view]) => view === void 0 ? [] : [[key, view]]
+    )
+  );
   const resolveOptions = baseOptions;
   function currentOptions() {
-    return { ...resolveOptions, optionValues: Object.fromEntries(chosen) };
+    return {
+      ...resolveOptions,
+      optionValues: Object.fromEntries(chosen),
+      viewValues: Object.fromEntries(chosenViews)
+    };
   }
   const unapplied = /* @__PURE__ */ new Map();
   const visible = widgetsFor(definitions, context.roles);
@@ -5944,6 +6005,23 @@ function createWidgetLoader(options) {
     }
     start(definition, true);
   }
+  function setView(key, view) {
+    if (disposed) return;
+    const definition = definitionFor(key);
+    if (definition === void 0) return;
+    const before = loadViewKey(definition, chosenViews.get(key));
+    if (view === void 0 || view === "") chosenViews.delete(key);
+    else chosenViews.set(key, view);
+    const after = loadViewKey(definition, chosenViews.get(key));
+    if (before === after || !started.has(key)) return;
+    const current = snapshot.find(
+      (widget) => widget.definition.key === key
+    );
+    if (current !== void 0 && current.status !== "loading") {
+      replace(key, { definition, status: "loading" });
+    }
+    start(definition, true);
+  }
   function dispose() {
     disposed = true;
     abortAll(new Error("The widget loader was disposed."));
@@ -5962,6 +6040,7 @@ function createWidgetLoader(options) {
     loadAll,
     refresh,
     setOptions,
+    setView,
     dispose
   };
 }
@@ -5977,7 +6056,8 @@ function useWidgets(definitions, providers, context, options = {}) {
     signal,
     cache,
     cacheKey,
-    optionValues
+    optionValues,
+    viewValues
   } = options;
   const placeholders = react.useMemo(
     () => loadingWidgets(widgetsFor(definitions, context.roles)),
@@ -5989,6 +6069,8 @@ function useWidgets(definitions, providers, context, options = {}) {
   const gridRef = react.useRef(null);
   const optionValuesRef = react.useRef(optionValues);
   optionValuesRef.current = optionValues;
+  const viewValuesRef = react.useRef(viewValues);
+  viewValuesRef.current = viewValues;
   react.useEffect(() => {
     const created = createWidgetLoader({
       definitions,
@@ -5999,7 +6081,8 @@ function useWidgets(definitions, providers, context, options = {}) {
       ...signal === void 0 ? {} : { signal },
       ...cache === void 0 ? {} : { cache },
       ...cacheKey === void 0 ? {} : { cacheKey },
-      ...optionValuesRef.current === void 0 ? {} : { optionValues: optionValuesRef.current }
+      ...optionValuesRef.current === void 0 ? {} : { optionValues: optionValuesRef.current },
+      ...viewValuesRef.current === void 0 ? {} : { viewValues: viewValuesRef.current }
     });
     loaderRef.current = created;
     setWidgets(created.getSnapshot());
@@ -6078,6 +6161,16 @@ function useWidgets(definitions, providers, context, options = {}) {
       if (chosen !== void 0) loader.setOptions(key, chosen);
     }
   }, [loader, optionSignature]);
+  const viewSignature = JSON.stringify(viewValues ?? {});
+  react.useEffect(() => {
+    if (loader === null) return;
+    for (const [key, view] of Object.entries(viewValuesRef.current ?? {})) {
+      loader.setView(key, view);
+    }
+  }, [loader, viewSignature]);
+  const setView = react.useCallback((key, view) => {
+    loaderRef.current?.setView(key, view);
+  }, []);
   const setOptions = react.useCallback(
     (key, chosen) => {
       loaderRef.current?.setOptions(key, chosen);
@@ -6087,7 +6180,7 @@ function useWidgets(definitions, providers, context, options = {}) {
   const refresh = react.useCallback((key) => {
     loaderRef.current?.refresh(key);
   }, []);
-  return { widgets, refresh, setOptions, gridRef };
+  return { widgets, refresh, setOptions, setView, gridRef };
 }
 
 exports.AlertListWidget = AlertListWidget;