@jxsuite/studio 5.5.0 → 5.7.0

package/src/panels/style-panel.ts

@@ -813,7 +813,7 @@ function buttonGroup(
     return {
       icon,
       row: rowKey,
-      selected: v === value,
+      checked: v === value ? ("true" as const) : ("false" as const),
       text: icon === "" ? v : "",
       title: v,
       value: v,
@@ -2112,7 +2112,7 @@ function rememberButtons(view: StylePanelView): void {
   for (const section of view.sections) {
     for (const row of section.rows) {
       if (row.widget === "buttons") {
-        _buttonValues.set(row.key, row.buttons.find((b) => b.selected)?.value ?? "");
+        _buttonValues.set(row.key, row.buttons.find((b) => b.checked === "true")?.value ?? "");
       }
     }
   }

package/src/platform-errors.ts

@@ -13,10 +13,55 @@
  */
 
 import { problemSlug } from "@jxsuite/protocol";
+import type { OfferedAction, RetryHint } from "@jxsuite/protocol";
 
 export interface PlatformErrorInfo {
   code?: string;
   installUrl?: string;
+  /** What an `action-required` refusal offers the user (desktop.md §10.4). */
+  actions?: OfferedAction[];
+  /** That refusal's heading, in the backend's words. */
+  heading?: string;
+  /** What to do once one of its actions is done. */
+  retry?: RetryHint;
+}
+
+const RETRY_HINTS = new Set<string>(["reload", "repeat", "none"]);
+
+/**
+ * The offered actions a wire value holds, each one checked: an action needs an `id` and a `label`
+ * to be drawn at all, and anything else it carries is kept only when it has the right type. A
+ * malformed entry is dropped rather than drawn as a button that does nothing.
+ */
+export function offeredActions(value: unknown): OfferedAction[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.flatMap((entry): OfferedAction[] => {
+    const raw = entry as Partial<Record<keyof OfferedAction, unknown>> | null;
+    if (
+      !raw ||
+      typeof raw.id !== "string" ||
+      !raw.id ||
+      typeof raw.label !== "string" ||
+      !raw.label
+    ) {
+      return [];
+    }
+    return [
+      {
+        id: raw.id,
+        label: raw.label,
+        ...(typeof raw.href === "string" && raw.href ? { href: raw.href } : {}),
+        ...(raw.primary === true ? { primary: true } : {}),
+      },
+    ];
+  });
+}
+
+/** The retry hint a wire value names, or undefined when it names none we know. */
+export function retryHint(value: unknown): RetryHint | undefined {
+  return typeof value === "string" && RETRY_HINTS.has(value) ? (value as RetryHint) : undefined;
 }
 
 /**
@@ -33,16 +78,23 @@ export function platformErrorInfo(error: unknown): PlatformErrorInfo {
   if (!error || typeof error !== "object") {
     return {};
   }
-  const { code, installUrl, type } = error as {
+  const { actions, code, heading, installUrl, retry, type } = error as {
+    actions?: unknown;
     code?: unknown;
+    heading?: unknown;
     installUrl?: unknown;
+    retry?: unknown;
     type?: unknown;
   };
+  const hint = retryHint(retry);
   // A problem type wins over a legacy code: it is the shape the backend is migrating toward.
   const derived = problemSlug(type) ?? (typeof code === "string" ? normalizeCode(code) : null);
   return {
     ...(derived === null ? {} : { code: derived }),
     ...(typeof installUrl === "string" ? { installUrl } : {}),
+    ...(actions === undefined ? {} : { actions: offeredActions(actions) }),
+    ...(typeof heading === "string" && heading ? { heading } : {}),
+    ...(hint === undefined ? {} : { retry: hint }),
   };
 }
 
@@ -51,3 +103,11 @@ export function installUrlOf(error: unknown): string | null {
   const info = platformErrorInfo(error);
   return info.code === "needs-installation-access" && info.installUrl ? info.installUrl : null;
 }
+
+/**
+ * True when the error is an `action-required` refusal (HTTP 403, desktop.md §10.4) — whether the
+ * backend sent the problem type or the legacy `action_required` code.
+ */
+export function isActionRequired(error: unknown): boolean {
+  return platformErrorInfo(error).code === "action-required";
+}