@mdbase-dev/ui 0.1.0-beta.126 → 0.1.0-beta.148

package/dist/CollectionModeControl.js

@@ -0,0 +1,290 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { i18n, useLocaleRevision } from "./i18n.js";
+function read(value) {
+  if (!value || typeof value !== "object") return null;
+  const v = value;
+  if (v.execution_available !== true || v.current_mode !== "private" && v.current_mode !== "cloud_copy") return null;
+  if (v.change !== null) {
+    if (!v.change || typeof v.change !== "object") return null;
+    const c = v.change;
+    if (c.target_mode !== "private" && c.target_mode !== "cloud_copy" || typeof c.phase !== "string") return null;
+  }
+  return v;
+}
+/** Owner controls only. Visibility follows actual executor registration, not a
+ * mode flag. Browser intent cannot produce native key/source consent. */
+export function CollectionModeControl({
+  collectionId,
+  load,
+  change,
+  cancel,
+  native = false
+}) {
+  useLocaleRevision();
+  const [status, setStatus] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const [failure, setFailure] = useState(false);
+  const [step, setStep] = useState(null);
+  const intent = useRef(null);
+  const generation = useRef(0);
+  // Callback identity changes with parent renders; it must not restart I/O.
+  const callbacks = useRef({
+    load,
+    change,
+    cancel
+  });
+  callbacks.current = {
+    load,
+    change,
+    cancel
+  };
+  useEffect(() => {
+    const active = ++generation.current;
+    setStatus(null);
+    setStep(null);
+    setFailure(false);
+    setBusy(false);
+    intent.current = null;
+    void callbacks.current.load().then(value => {
+      if (generation.current === active) setStatus(read(value));
+    }).catch(() => {});
+    return () => {
+      ++generation.current;
+    };
+  }, [collectionId]);
+  async function refresh() {
+    const active = generation.current;
+    setBusy(true);
+    setFailure(false);
+    try {
+      const next = read(await callbacks.current.load());
+      if (active !== generation.current) return;
+      setStatus(next);
+      if (next && !next.change) {
+        setStep(null);
+        intent.current = null;
+      }
+    } catch {
+      if (active === generation.current) setFailure(true);
+    } finally {
+      if (active === generation.current) setBusy(false);
+    }
+  }
+  async function commit(target) {
+    const active = generation.current;
+    if (intent.current?.target !== target) intent.current = {
+      target,
+      id: crypto.randomUUID()
+    };
+    setBusy(true);
+    setFailure(false);
+    try {
+      const result = await callbacks.current.change(target, intent.current.id);
+      if (active !== generation.current) return;
+      const next = read(await callbacks.current.load());
+      if (active !== generation.current) return;
+      setStatus(next);
+      if (next && !next.change) intent.current = null;
+      setStep(result && typeof result === "object" ? result : null);
+    } catch {
+      if (active === generation.current) setFailure(true);
+    } finally {
+      if (active === generation.current) setBusy(false);
+    }
+  }
+  async function cancelPending() {
+    if (!status?.change?.request_id || !callbacks.current.cancel) return;
+    const active = generation.current;
+    setBusy(true);
+    setFailure(false);
+    try {
+      await callbacks.current.cancel(status.change.target_mode, status.change.request_id);
+      const next = read(await callbacks.current.load());
+      if (active !== generation.current) return;
+      setStatus(next);
+      setStep(null);
+      intent.current = null;
+    } catch {
+      if (active === generation.current) setFailure(true);
+    } finally {
+      if (active === generation.current) setBusy(false);
+    }
+  }
+  if (!status) return null;
+  const pending = status.change;
+  const target = pending?.target_mode ?? (status.current_mode === "private" ? "cloud_copy" : "private");
+  const blocked = step?.phase === "waiting_for_devices" && Array.isArray(step.devices) ? step.devices.filter(v => typeof v === "string") : [];
+  const retryAt = typeof step?.retry_at === "string" ? step.retry_at : typeof pending?.retry_at === "string" ? pending.retry_at : undefined;
+  return _jsxs("section", {
+    className: "mdbase-collection-mode",
+    "aria-label": i18n._(
+    /** i18n */
+    {
+      id: "4GiuPT",
+      message: "Collection storage mode",
+      context: "Collection storage mode"
+    }),
+    "aria-busy": busy,
+    children: [_jsx("h3", {
+      children: i18n._(
+      /** i18n */
+      {
+        id: "vAr5Dp",
+        message: "Storage mode",
+        context: "Collection storage mode"
+      })
+    }), _jsx("p", {
+      children: status.current_mode === "private" ? i18n._(
+      /** i18n */
+      {
+        id: "EIDHh1",
+        message: "Private",
+        context: "Collection storage mode"
+      }) : i18n._(
+      /** i18n */
+      {
+        id: "oKQdii",
+        message: "Cloud copy",
+        context: "Collection storage mode"
+      })
+    }), _jsx("p", {
+      children: target === "private" ? i18n._(
+      /** i18n */
+      {
+        id: "FHz4md",
+        message: "Only your devices can read new content after the switch finishes. mdbase may still be able to read older content.",
+        context: "Collection storage mode"
+      }) : i18n._(
+      /** i18n */
+      {
+        id: "bcDV8T",
+        message: "mdbase will be able to read the collection, including its existing history, and serve it while your devices are off.",
+        context: "Collection storage mode"
+      })
+    }), pending && _jsx("p", {
+      role: "status",
+      children: blocked.length > 0 ? i18n._(
+      /** i18n */
+      {
+        id: "3w1RWH",
+        message: "Waiting for devices to update.",
+        context: "Collection storage mode"
+      }) : pending.phase === "waiting_for_token_expiry" ? i18n._(
+      /** i18n */
+      {
+        id: "lx5IrT",
+        message: "Waiting for older device connections to expire. Cloud copy remains on until the switch finishes.",
+        context: "Collection storage mode"
+      }) : pending.phase === "waiting_for_device" ? i18n._(
+      /** i18n */
+      {
+        id: "3FYCb9",
+        message: "Open mdbase connect on one of the owner's devices to finish the switch.",
+        context: "Collection storage mode"
+      }) : i18n._(
+      /** i18n */
+      {
+        id: "13DGsZ",
+        message: "Finishing the switch. Keep the owner device connected.",
+        context: "Collection storage mode"
+      })
+    }), retryAt && Number.isFinite(Date.parse(retryAt)) && _jsx("p", {
+      children: _jsx("time", {
+        dateTime: retryAt,
+        children: i18n._(
+        /** i18n */
+        {
+          id: "ejJPcY",
+          message: "Continue after {0}.",
+          context: "Collection storage mode",
+          values: {
+            0: new Date(retryAt).toLocaleString()
+          }
+        })
+      })
+    }), blocked.length > 0 && _jsxs("div", {
+      role: "status",
+      children: [_jsx("p", {
+        children: i18n._(
+        /** i18n */
+        {
+          id: "YQ2gus",
+          message: "Update or revoke these devices before continuing:",
+          context: "Collection storage mode"
+        })
+      }), _jsx("ul", {
+        children: blocked.map(id => _jsx("li", {
+          children: _jsx("code", {
+            children: id
+          })
+        }, id))
+      })]
+    }), failure && _jsx("p", {
+      role: "alert",
+      children: i18n._(
+      /** i18n */
+      {
+        id: "Iu3ZPh",
+        message: "We couldn\u2019t confirm progress. Refresh, then retry. An interrupted switch may already have started.",
+        context: "Collection storage mode"
+      })
+    }), _jsxs("div", {
+      children: [(!pending || native) && _jsx("button", {
+        type: "button",
+        className: "mdbase-button",
+        disabled: busy,
+        onClick: () => void commit(target),
+        children: busy ? i18n._(
+        /** i18n */
+        {
+          id: "3xE-Bk",
+          message: "Working\u2026",
+          context: "Collection storage mode"
+        }) : pending ? i18n._(
+        /** i18n */
+        {
+          id: "JKLDUc",
+          message: "Continue on this device",
+          context: "Collection storage mode"
+        }) : target === "private" ? i18n._(
+        /** i18n */
+        {
+          id: "rO1a9-",
+          message: "Make private",
+          context: "Collection storage mode"
+        }) : i18n._(
+        /** i18n */
+        {
+          id: "nVYD2-",
+          message: "Turn on Cloud copy",
+          context: "Collection storage mode"
+        })
+      }), cancel && pending?.request_id && ["waiting_for_device", "waiting_for_token_expiry"].includes(pending.phase) && _jsx("button", {
+        type: "button",
+        className: "mdbase-button is-tertiary",
+        disabled: busy,
+        onClick: () => void cancelPending(),
+        children: i18n._(
+        /** i18n */
+        {
+          id: "VON31G",
+          message: "Cancel switch",
+          context: "Collection storage mode"
+        })
+      }), _jsx("button", {
+        type: "button",
+        className: "mdbase-button is-tertiary",
+        disabled: busy,
+        onClick: () => void refresh(),
+        children: i18n._(
+        /** i18n */
+        {
+          id: "tHHSXx",
+          message: "Refresh status",
+          context: "Collection storage mode"
+        })
+      })]
+    })]
+  });
+}

package/dist/CommandPalette.d.ts

@@ -3,7 +3,7 @@ export interface Command {
     readonly id: string;
     readonly label: string;
     readonly detail?: string | undefined;
-    /** Commands show under their group's heading, in the order the groups first appear. */
+    /** Stable group ID; headings follow first appearance and may be presented by groupLabel. */
     readonly group: string;
     readonly keywords?: string | undefined;
     /** For example "mod+shift+f"; see shortcutLabel. */
@@ -27,11 +27,13 @@ export declare function matchingCommands(commands: readonly Command[], query: st
  * Find or run anything: every mdbase app opens it with Mod+K. Typing filters commands; the
  * arrows move, Enter runs, Shift+Enter runs a command's alternate, Escape closes.
  */
-export declare function CommandPalette({ open, commands, onClose, label, placeholder, showAll }: {
+export declare function CommandPalette({ open, commands, onClose, label, placeholder, showAll, groupLabel }: {
     readonly open: boolean;
     readonly commands: readonly Command[];
     readonly onClose: () => void;
     readonly label?: string | undefined;
     readonly placeholder?: string | undefined;
     readonly showAll?: readonly string[] | undefined;
+    /** Presentation only: translate headings without changing group or showAll IDs. */
+    readonly groupLabel?: ((group: string) => string) | undefined;
 }): JSX.Element | null;