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

package/dist/locales/zh/messages.json

@@ -0,0 +1 @@
+{ "messages": { "-HLPDJ": ["正在检查集合设置…"], "-JeNKB": ["管理访问权限"], "-ujXuR": ["浏览器、操作系统、视口和近期错误代码。不包含笔记内容、路径或凭据。"], "06ZW-I": ["屏幕截图大于 3 MB。请选择较小的图片。"], "0LOjOR": ["无法在此浏览器中清理屏幕截图。"], "0MeszW": [["app"], " 无法在此处打开集合"], "0VE881": ["你和其他所有人都将立即无法在任何设备或应用中访问此集合。此操作无法撤销。"], "13DGsZ": ["正在完成切换。请保持所有者的设备在线。"], "15fVx1": ["已丢弃标记，未包含屏幕截图。"], "1AZHba": ["重置"], "1AjSFS": ["正在打开你的集合"], "1CWcjd": ["无法发送反馈。请检查网络连接后重试。"], "1MMyGb": ["可查看"], "1P-z0J": ["取消"], "25QKdy": ["已截取屏幕截图。共享已停止。"], "2UA-qq": ["移动"], "2apdee": ["正在打开本地集合…"], "2cqK5k": ["打开"], "2ulUVC": ["登录"], "2vTp2v": ["绘制"], "37unnc": ["无法保存屏幕截图。"], "38fGkV": ["在其他 mdbase 应用中打开"], "3FYCb9": ["请在所有者的一台设备上打开 mdbase connect，以完成切换。"], "3Yf9Gk": ["正在应用集合更新…"], "3w1RWH": ["正在等待设备更新。"], "3xE-Bk": ["正在处理…"], "45MZFs": ["命令"], "45a64b": ["在 ", ["app"], " 中打开你的集合"], "480CfR": ["这比平时花费的时间更长。"], "4GiuPT": ["集合存储模式"], "52vV7a": ["集合"], "54P3Y1": ["mdbase ", ["current"], "：在其他应用中打开此集合"], "5GwjfZ": ["选择其他集合"], "5u4cOF": ["无法截取屏幕截图。请重试。"], "6Qrxry": ["正在连接你的集合…"], "6rFO9K": ["已以 ", ["account"], " 身份登录"], "6vUPNB": ["无法截取屏幕截图。"], "7-61s4": ["包含技术诊断信息"], "75iTY6": ["（在新标签页中打开）"], "7INsea": ["你已在此设备上退出 ", ["app"], "。"], "7qrUoz": ["发生了问题。你可以通过“发送反馈”进行报告。"], "88OB58": ["请选择小于 3 MB 的屏幕截图。"], "88u4WE": ["反馈类型"], "8FvMqa": ["无法继续"], "8wcYeu": ["你的集合"], "9fWts8": ["删除 ", ["collection"], "？"], "9mrfxN": ["无法读取屏幕截图。"], "9uI_rE": ["撤销"], "9yK4bJ": ["返回工作"], "A--pCj": ["包含集合名称："], "A3CVZb": ["要从此列表中移除 ", ["collection"], " 吗？"], "AA2dPS": ["在那里选择或创建集合。"], "AbNeva": ["搜索命令"], "AiGGIB": ["添加集合…"], "Arxv23": ["附加屏幕截图"], "B5WwSc": ["选择集合"], "B5v8nx": ["将发送的内容"], "BCJqT2": ["请选择小于 1600 万像素的屏幕截图。"], "BOOryO": ["选择图片"], "BcddXE": [["app"], " 需要先向此集合添加一些内容，才能使用它。"], "BfJnph": ["最多可以添加 100 处标记。撤销或重置后可继续添加。"], "CRx2Ry": ["重新截取屏幕截图"], "DJxqCW": ["正在截取屏幕截图…"], "DViXWV": ["没有匹配项"], "DWBQ45": ["此浏览器不支持屏幕捕获。你可以改为附加图片。"], "DXe-Ku": ["无法创建屏幕截图。"], "Dg50Vr": ["什么带来了改变？"], "Ds8lGj": ["所有者"], "EIDHh1": ["私有"], "EbTBqo": ["浅色"], "EfTCex": ["未截取屏幕截图。你仍可以发送反馈。"], "FHz4md": ["切换完成后，只有你的设备能够读取新内容。mdbase 可能仍能读取旧内容。"], "FKgWWQ": ["在 mdbase 窗口中继续"], "FPIkyE": ["深色"], "FZqxYo": ["正在打开 mdbase…"], "GaeNkI": ["分享你喜欢的内容"], "GnOlBF": ["包含屏幕截图"], "GtzbT7": ["感谢你的反馈。"], "H-19b6": ["正在等待集合密钥…"], "HVAS1o": ["你的消息、回复邮箱、附加的屏幕截图，以及这些应用和构建信息。"], "HfGSuv": ["无法打开 ", ["collection"]], "Hp1l6f": ["当前"], "IMgxe8": ["请重新加载以继续。"], "ITLqil": [["count", "plural", { "other": ["已应用 ", "#", " 处标记。"] }]], "IcLToz": ["正在同步你的集合…"], "IrbugM": ["保存在你的电脑上，不由 mdbase 存储"], "IseQAg": ["浏览和编辑记录"], "IspNTR": ["颜色主题"], "Iu3ZPh": ["无法确认进度。请刷新状态后重试。中断的切换可能已经开始。"], "IxyZXD": ["屏幕截图"], "J2kszk": ["添加私有集合"], "J9remp": ["在账户中移除此设备之前，它仍会显示在设备列表中。"], "JKLDUc": ["在此设备上继续"], "KDw4GX": ["重试"], "KZ2qhj": ["切换集合，当前：", ["collection"]], "LLAa_9": ["可选"], "LSW6J8": ["在那里查看对 ", ["collection"], " 的访问权限。"], "LTtPi0": ["关闭"], "LgBzMv": ["集合中的内容不会发生变化。"], "MSpXh1": ["正在加载集合快照…"], "MuHIRH": ["正在删除…"], "NNvuBg": [["collection"], " 的更多内容"], "Nj4zfV": ["已将屏幕截图附加到反馈"], "OFWAjq": ["集合"], "OQBR5K": ["发送超时。请重试。"], "P71euV": ["拖动以标记。键盘操作：使用方向键移动；按空格键开始或完成。遮盖会移除像素。"], "P74TOi": ["未保存"], "PCi-MK": ["正在退出登录…"], "PWh9Ii": ["应用更改"], "Qymvdk": ["无法在此浏览器中创建屏幕截图。"], "Rg_OK9": [["app"], " 需要先在 mdbase 中获得你的批准，才能打开集合。"], "RoafuO": ["发送反馈"], "Sad2tK": ["正在发送…"], "TKM0Sf": ["你希望改进什么？"], "UE2Ue9": ["删除集合…"], "URmyfc": ["详情"], "UbVgIu": ["关闭"], "UfEFtR": ["发送给 mdbase 团队的私密反馈。"], "UoMXZp": ["感谢你的赞许。"], "V8XQf0": ["未授予访问权限。你可以重试或选择其他集合。"], "VBhfTn": ["发送前请检查是否包含私人信息。"], "VON31G": ["取消切换"], "VSywLq": ["正在连接同步服务…"], "Vij4PB": ["需要决定"], "Vt4P0G": ["从此列表中移除"], "VyuLii": ["屏幕截图工具"], "WbUtOC": ["关闭 ", ["label"]], "WtBLy2": ["屏幕截图不是有效的 PNG 或 JPEG 图片。"], "XAe57G": ["系统"], "XDzAnp": ["在新标签页中打开"], "Y1f4bJ": ["退出登录"], "YN0Hkf": ["允许 ", ["app"], " 访问 ", ["collection"], "？"], "YQ2gus": ["请先更新以下设备或撤销其访问权限，再继续："], "YZNdEb": ["正在设置…"], "YdeEye": ["正在打开 ", ["collection"]], "ZZ4v5y": [["0", "plural", { "other": ["还有 ", "#", " 行更改"] }]], "ZyjhMF": ["图片格式：PNG 或 JPEG，最大 3 MB。遮盖会替换像素；仅附加最终图片。"], "_Bhy0W": ["移除"], "_CVuTO": ["未更改的行"], "_qM4x2": ["重新打开 mdbase 窗口"], "aPgjJq": ["提出改进建议"], "ak4q13": ["重试验证"], "alKzE8": ["允许 ", ["app"], " 访问此集合？"], "bDIp4a": ["没有匹配“", ["query"], "”的集合。"], "bRZJdX": ["请选择 PNG 或 JPEG 屏幕截图。"], "bcDV8T": ["mdbase 将能够读取此集合及其现有历史记录，并在你的设备关闭时提供访问。"], "c3AIR_": ["ID ", ["id"]], "cM8Pei": ["屏幕截图标注画布"], "dEgA5A": ["取消"], "dirPmM": ["更改内容"], "eeDGOj": ["输入 ", ["collection"], " 以确认"], "ejJPcY": ["请在 ", ["0"], " 之后继续。"], "elJq5_": [["app"], " 已停止"], "fAUSZy": ["需要处理"], "fF_d4m": ["使用 mdbase 账户登录。你可以选择 ", ["app"], " 可使用的集合。"], "fnoot2": ["使用 ", ["app"], " 的版本"], "gtEbeW": ["高亮"], "gvuZjZ": ["无法加载验证。请检查网络连接后重试。"], "h3I7av": ["可编辑"], "hV3yAb": ["报告问题"], "hhTpZ9": ["查看访问权限"], "i5ZjUk": ["我们无法保证会回复。请勿用于安全问题报告或紧急支持。"], "iXx1Vf": ["正在检查设置将带来的更改…"], "idD8Ev": ["已保存"], "jRkyhM": ["删除集合"], "kC9O29": ["无法完成验证。请重试。"], "kHiGeJ": ["阅读和注释来源"], "kQhT09": ["为 ", ["app"], " 授予集合访问权限"], "ktO6Lq": ["这会如何帮助你？"], "kx0s-n": ["结果"], "lnc6-d": ["无法打开屏幕截图以添加标记。"], "lnj9gP": ["关闭反馈"], "lx5IrT": ["正在等待旧设备连接过期。切换完成之前，云端副本将保持启用。"], "lxkOy-": ["仍要退出登录"], "mRd7qL": ["无法发送反馈。请重试。"], "nVYD2-": ["启用云端副本"], "n_oBJu": ["重试"], "nb4xuL": [["app"], " 将不再在此设备上显示该集合。集合内容不会被删除，且 ", ["app"], " 仍保有访问权限。如需撤销访问权限，请使用“管理访问权限”。"], "ngIpWJ": ["感谢你的想法。"], "njBr8W": ["例如：you@example.com"], "nne584": ["哪些方面对你很有帮助？"], "o7QK4c": ["遮盖"], "oKQdii": ["云端副本"], "oU3FgQ": ["查找集合"], "pM91Yr": ["继续"], "pqfLKM": ["重新加载"], "qOfTOd": ["正在启动 ", ["app"], "…"], "r4xubm": ["正在打开…"], "rO1a9-": ["设为私有"], "rqijZ-": ["正在检查集合是否可读…"], "sHfOYg": ["登录并在那里选择集合。"], "semCbT": ["未添加集合。"], "t7D5Ym": ["为 ", ["app"], " 设置 ", ["collection"]], "tHHSXx": ["刷新状态"], "tHdrmM": ["已私密发送给 mdbase 团队。"], "t_YqKh": ["移除"], "uF9ruK": ["正在保存"], "uby1H2": ["私有"], "vAr5Dp": ["存储模式"], "vDwCOr": ["mdbase 应用"], "vTX5bg": ["未授予访问权限。"], "vYhHlc": ["设置"], "wdMwII": ["立即打开"], "wdRxTD": ["正在应用…"], "wsx-_Y": ["标记屏幕截图"], "wv1f8v": ["撰写引用来源的手稿"], "xGv9ZK": [["app"], " 尚无权访问任何集合。请选择已有集合，或新建一个。"], "xxbaLR": ["在此处打开此集合"], "y93Tfg": ["此集合"], "yObBTM": ["GitHub 上的 ", ["0"]], "y_K0Dz": ["发生了什么？"], "yz7wBu": ["关闭"], "zDJycW": ["你当时想做什么？"], "zJfG-M": ["屏幕共享在截取屏幕截图前已结束。"], "zO1gmR": ["Esc"], "zVYLbq": ["回复邮箱"] } }

package/dist/mark-activity.js

@@ -1,9 +1,16 @@
 import { useEffect, useRef, useSyncExternalStore } from "react";
 /** Matches the signal animations in `motion.css`. */
-const SIGNAL_MS = { saved: 900, error: 1500 };
+const SIGNAL_MS = {
+  saved: 900,
+  error: 1500
+};
 /** Several notices often report the same save; one reaction is enough. */
 const REPEAT_MS = 400;
-const IDLE = { signal: null, progress: null, busy: null };
+const IDLE = {
+  signal: null,
+  progress: null,
+  busy: null
+};
 let snapshot = IDLE;
 let signal = null;
 let signalAt = 0;
@@ -13,109 +20,109 @@ const tasks = new Map();
 const holds = [];
 const listeners = new Set();
 function publish() {
-    const progress = tasks.size
-        ? [...tasks.values()].reduce((sum, fraction) => sum + fraction, 0) / tasks.size
-        : null;
-    snapshot = { signal, progress, busy: holds.at(-1)?.loop ?? null };
-    for (const listener of listeners)
-        listener();
+  const progress = tasks.size ? [...tasks.values()].reduce((sum, fraction) => sum + fraction, 0) / tasks.size : null;
+  snapshot = {
+    signal,
+    progress,
+    busy: holds.at(-1)?.loop ?? null
+  };
+  for (const listener of listeners) listener();
 }
 function clamp(fraction) {
-    return Number.isFinite(fraction) ? Math.min(1, Math.max(0, fraction)) : 0;
+  return Number.isFinite(fraction) ? Math.min(1, Math.max(0, fraction)) : 0;
 }
 /** Plays a one-shot reaction on the mark. A fresh error is never covered by a save. */
 export function signalMdbaseMark(kind) {
-    const now = Date.now();
-    if (signal && now - signalAt < REPEAT_MS && (signal.kind === kind || signal.kind === "error"))
-        return;
-    signal = { kind, id: nextId++ };
-    signalAt = now;
-    clearTimeout(signalTimer);
-    signalTimer = setTimeout(() => {
-        signal = null;
-        publish();
-    }, SIGNAL_MS[kind]);
+  const now = Date.now();
+  if (signal && now - signalAt < REPEAT_MS && (signal.kind === kind || signal.kind === "error")) return;
+  signal = {
+    kind,
+    id: nextId++
+  };
+  signalAt = now;
+  clearTimeout(signalTimer);
+  signalTimer = setTimeout(() => {
+    signal = null;
     publish();
+  }, SIGNAL_MS[kind]);
+  publish();
 }
 /** Shows an operation's known progress on the mark until it finishes, fails or is cancelled. */
 export function trackMdbaseMarkProgress(initial = 0) {
-    const id = nextId++;
-    tasks.set(id, clamp(initial));
+  const id = nextId++;
+  tasks.set(id, clamp(initial));
+  publish();
+  const end = kind => {
+    if (!tasks.delete(id)) return;
     publish();
-    const end = (kind) => {
-        if (!tasks.delete(id))
-            return;
-        publish();
-        if (kind)
-            signalMdbaseMark(kind);
-    };
-    return {
-        update(fraction) {
-            if (!tasks.has(id))
-                return;
-            tasks.set(id, clamp(fraction));
-            publish();
-        },
-        finish: () => end("saved"),
-        fail: () => end("error"),
-        cancel: () => end()
-    };
+    if (kind) signalMdbaseMark(kind);
+  };
+  return {
+    update(fraction) {
+      if (!tasks.has(id)) return;
+      tasks.set(id, clamp(fraction));
+      publish();
+    },
+    finish: () => end("saved"),
+    fail: () => end("error"),
+    cancel: () => end()
+  };
 }
 /** Loops the mark until the returned release is called. Releasing twice is harmless. */
 export function holdMdbaseMarkBusy(loop) {
-    const id = nextId++;
-    holds.push({ id, loop });
+  const id = nextId++;
+  holds.push({
+    id,
+    loop
+  });
+  publish();
+  return () => {
+    const index = holds.findIndex(hold => hold.id === id);
+    if (index < 0) return;
+    holds.splice(index, 1);
     publish();
-    return () => {
-        const index = holds.findIndex((hold) => hold.id === id);
-        if (index < 0)
-            return;
-        holds.splice(index, 1);
-        publish();
-    };
+  };
 }
 function subscribe(listener) {
-    listeners.add(listener);
-    return () => listeners.delete(listener);
+  listeners.add(listener);
+  return () => listeners.delete(listener);
 }
 export function getMdbaseMarkActivity() {
-    return snapshot;
+  return snapshot;
 }
 export function useMdbaseMarkActivity() {
-    return useSyncExternalStore(subscribe, getMdbaseMarkActivity, () => IDLE);
+  return useSyncExternalStore(subscribe, getMdbaseMarkActivity, () => IDLE);
 }
 /**
  * Shows `fraction` on the mark while it is a number. Becoming null or unmounting ends the
  * operation quietly; call `signalMdbaseMark` separately if the end deserves a reaction.
  */
 export function useMdbaseMarkProgress(fraction) {
-    const handle = useRef(null);
-    const tracking = typeof fraction === "number";
-    useEffect(() => {
-        if (!tracking)
-            return;
-        const progress = trackMdbaseMarkProgress();
-        handle.current = progress;
-        return () => {
-            progress.cancel();
-            handle.current = null;
-        };
-    }, [tracking]);
-    useEffect(() => {
-        if (typeof fraction === "number")
-            handle.current?.update(fraction);
-    }, [fraction]);
+  const handle = useRef(null);
+  const tracking = typeof fraction === "number";
+  useEffect(() => {
+    if (!tracking) return;
+    const progress = trackMdbaseMarkProgress();
+    handle.current = progress;
+    return () => {
+      progress.cancel();
+      handle.current = null;
+    };
+  }, [tracking]);
+  useEffect(() => {
+    if (typeof fraction === "number") handle.current?.update(fraction);
+  }, [fraction]);
 }
 /** Loops the mark while `loop` is set. */
 export function useMdbaseMarkBusy(loop) {
-    useEffect(() => (loop ? holdMdbaseMarkBusy(loop) : undefined), [loop]);
+  useEffect(() => loop ? holdMdbaseMarkBusy(loop) : undefined, [loop]);
 }
 /** For tests: forget every signal, operation and hold. */
 export function resetMdbaseMarkActivity() {
-    clearTimeout(signalTimer);
-    signal = null;
-    signalAt = 0;
-    tasks.clear();
-    holds.length = 0;
-    publish();
+  clearTimeout(signalTimer);
+  signal = null;
+  signalAt = 0;
+  tasks.clear();
+  holds.length = 0;
+  publish();
 }

package/dist/permission-selection.js

@@ -1,21 +1,31 @@
 import { useEffect, useState } from "react";
 /** A permission review survives polling, but never silently rebases onto changed access. */
 export function usePermissionSelection(id, allowed) {
-    const key = JSON.stringify([id, [...allowed].sort()]);
-    const [review, setReview] = useState(() => ({ key, selected: [...allowed], needsReview: false }));
-    const changedExternally = review.key !== key;
-    const needsReview = changedExternally && JSON.stringify([id, [...review.selected].sort()]) !== key;
-    useEffect(() => {
-        if (changedExternally)
-            setReview({ key, selected: [...allowed], needsReview });
-    }, [key, changedExternally, needsReview]);
-    return {
-        selected: changedExternally ? [...allowed] : review.selected,
-        needsReview: changedExternally ? needsReview : review.needsReview,
-        setSelected: (selected) => setReview((current) => ({
-            ...current,
-            selected: typeof selected === "function" ? selected(current.selected) : selected
-        })),
-        acknowledge: () => setReview((current) => ({ ...current, needsReview: false }))
-    };
+  const key = JSON.stringify([id, [...allowed].sort()]);
+  const [review, setReview] = useState(() => ({
+    key,
+    selected: [...allowed],
+    needsReview: false
+  }));
+  const changedExternally = review.key !== key;
+  const needsReview = changedExternally && JSON.stringify([id, [...review.selected].sort()]) !== key;
+  useEffect(() => {
+    if (changedExternally) setReview({
+      key,
+      selected: [...allowed],
+      needsReview
+    });
+  }, [key, changedExternally, needsReview]);
+  return {
+    selected: changedExternally ? [...allowed] : review.selected,
+    needsReview: changedExternally ? needsReview : review.needsReview,
+    setSelected: selected => setReview(current => ({
+      ...current,
+      selected: typeof selected === "function" ? selected(current.selected) : selected
+    })),
+    acknowledge: () => setReview(current => ({
+      ...current,
+      needsReview: false
+    }))
+  };
 }

package/dist/popover.js

@@ -3,160 +3,168 @@ import { useEffect, useEffectEvent, useLayoutEffect } from "react";
  * Where a popover opens beside its trigger: below when it fits, otherwise on whichever side
  * has more room, lined up with the trigger's start (or end) edge and kept inside the viewport.
  */
-export function anchoredPlacement(trigger, popover, viewport, { gap = 4, margin = 8, align = "start" } = {}) {
-    const below = viewport.height - trigger.bottom - gap - margin;
-    const above = trigger.top - gap - margin;
-    const opensUp = popover.height > below && above > below;
-    const room = Math.max(120, opensUp ? above : below);
-    const height = Math.min(popover.height, room);
-    const width = Math.max(popover.width, trigger.width);
-    const start = align === "end" ? trigger.left + trigger.width - width : trigger.left;
-    return {
-        top: opensUp ? trigger.top - gap - height : trigger.bottom + gap,
-        left: Math.max(margin, Math.min(start, viewport.width - width - margin)),
-        maxHeight: room
-    };
+export function anchoredPlacement(trigger, popover, viewport, {
+  gap = 4,
+  margin = 8,
+  align = "start"
+} = {}) {
+  const below = viewport.height - trigger.bottom - gap - margin;
+  const above = trigger.top - gap - margin;
+  const opensUp = popover.height > below && above > below;
+  const room = Math.max(120, opensUp ? above : below);
+  const height = Math.min(popover.height, room);
+  const width = Math.max(popover.width, trigger.width);
+  const start = align === "end" ? trigger.left + trigger.width - width : trigger.left;
+  return {
+    top: opensUp ? trigger.top - gap - height : trigger.bottom + gap,
+    left: Math.max(margin, Math.min(start, viewport.width - width - margin)),
+    maxHeight: room
+  };
 }
 function place(trigger, popover, options) {
-    const box = trigger.getBoundingClientRect();
-    if (options.matchWidth)
-        popover.style.minWidth = `${box.width}px`;
-    popover.style.maxHeight = "";
-    const placement = anchoredPlacement(box, { width: popover.offsetWidth, height: popover.scrollHeight }, { width: window.innerWidth, height: window.innerHeight }, options);
-    popover.style.top = `${placement.top}px`;
-    popover.style.left = `${placement.left}px`;
-    popover.style.maxHeight = `${placement.maxHeight}px`;
+  const box = trigger.getBoundingClientRect();
+  if (options.matchWidth) popover.style.minWidth = `${box.width}px`;
+  popover.style.maxHeight = "";
+  const placement = anchoredPlacement(box, {
+    width: popover.offsetWidth,
+    height: popover.scrollHeight
+  }, {
+    width: window.innerWidth,
+    height: window.innerHeight
+  }, options);
+  popover.style.top = `${placement.top}px`;
+  popover.style.left = `${placement.left}px`;
+  popover.style.maxHeight = `${placement.maxHeight}px`;
 }
 // Browsers without the Popover API (and jsdom) keep the element in place instead.
 function showInTopLayer(element) {
-    if (typeof element.showPopover === "function")
-        element.showPopover();
+  if (typeof element.showPopover === "function") element.showPopover();
 }
 function hideFromTopLayer(element) {
-    if (typeof element.hidePopover === "function" && element.matches(":popover-open"))
-        element.hidePopover();
+  if (typeof element.hidePopover === "function" && element.matches(":popover-open")) element.hidePopover();
 }
 function onScreen(element) {
-    const box = element.getBoundingClientRect();
-    return box.width > 0 && box.bottom > 0 && box.top < window.innerHeight
-        && box.right > 0 && box.left < window.innerWidth;
+  const box = element.getBoundingClientRect();
+  return box.width > 0 && box.bottom > 0 && box.top < window.innerHeight && box.right > 0 && box.left < window.innerWidth;
 }
 /**
  * Shows a select's list in the top layer beside its trigger, focuses it, and dismisses it when
  * the pointer lands elsewhere or the page scrolls or resizes underneath it.
  */
 export function useSelectPopover(open, triggerRef, listRef, onDismiss) {
-    const dismiss = useEffectEvent(onDismiss);
-    useLayoutEffect(() => {
-        const list = listRef.current;
-        const trigger = triggerRef.current;
-        if (!open || !list || !trigger)
-            return undefined;
-        showInTopLayer(list);
-        place(trigger, list, { matchWidth: true });
-        list.focus({ preventScroll: true });
-        return () => {
-            hideFromTopLayer(list);
-        };
-    }, [open, triggerRef, listRef]);
-    useEffect(() => {
-        const list = listRef.current;
-        const trigger = triggerRef.current;
-        if (!open || !list || !trigger)
-            return undefined;
-        const outside = (event) => {
-            const target = event.target;
-            if (target && !list.contains(target) && !trigger.contains(target))
-                dismiss();
-        };
-        // Content under the list can move (a panel scrolls, a list re-renders): the list follows
-        // its trigger, and closes only once the trigger has left the screen.
-        const follow = (event) => {
-            if (list.contains(event.target))
-                return;
-            if (onScreen(trigger))
-                place(trigger, list, { matchWidth: true });
-            else
-                dismiss();
-        };
-        const onResize = () => dismiss();
-        document.addEventListener("pointerdown", outside, true);
-        document.addEventListener("scroll", follow, true);
-        window.addEventListener("resize", onResize);
-        return () => {
-            document.removeEventListener("pointerdown", outside, true);
-            document.removeEventListener("scroll", follow, true);
-            window.removeEventListener("resize", onResize);
-        };
-    }, [open, triggerRef, listRef]);
+  const dismiss = useEffectEvent(onDismiss);
+  useLayoutEffect(() => {
+    const list = listRef.current;
+    const trigger = triggerRef.current;
+    if (!open || !list || !trigger) return undefined;
+    showInTopLayer(list);
+    place(trigger, list, {
+      matchWidth: true
+    });
+    list.focus({
+      preventScroll: true
+    });
+    return () => {
+      hideFromTopLayer(list);
+    };
+  }, [open, triggerRef, listRef]);
+  useEffect(() => {
+    const list = listRef.current;
+    const trigger = triggerRef.current;
+    if (!open || !list || !trigger) return undefined;
+    const outside = event => {
+      const target = event.target;
+      if (target && !list.contains(target) && !trigger.contains(target)) dismiss();
+    };
+    // Content under the list can move (a panel scrolls, a list re-renders): the list follows
+    // its trigger, and closes only once the trigger has left the screen.
+    const follow = event => {
+      if (list.contains(event.target)) return;
+      if (onScreen(trigger)) place(trigger, list, {
+        matchWidth: true
+      });else dismiss();
+    };
+    const onResize = () => dismiss();
+    document.addEventListener("pointerdown", outside, true);
+    document.addEventListener("scroll", follow, true);
+    window.addEventListener("resize", onResize);
+    return () => {
+      document.removeEventListener("pointerdown", outside, true);
+      document.removeEventListener("scroll", follow, true);
+      window.removeEventListener("resize", onResize);
+    };
+  }, [open, triggerRef, listRef]);
 }
 /**
  * Keeps a mounted menu in the top layer beside its trigger. It closes on an outside press,
  * Escape (returning focus to the trigger), Tab or a resize.
  */
-export function useMenuPopover(menuRef, triggerRef, onClose, { width, align = "start", focus = '[aria-checked="true"], [role^="menuitem"]', busy = false }) {
-    const close = useEffectEvent(onClose);
-    const locked = useEffectEvent(() => busy);
-    useLayoutEffect(() => {
-        const menu = menuRef.current;
-        const trigger = triggerRef.current;
-        if (!menu || !trigger)
-            return undefined;
-        showInTopLayer(menu);
-        if (width !== undefined)
-            menu.style.width = `${Math.min(width, window.innerWidth - 16)}px`;
-        place(trigger, menu, { gap: 6, align, matchWidth: false });
-        (menu.querySelector(focus) ?? menu).focus({ preventScroll: true });
-        return () => {
-            hideFromTopLayer(menu);
-        };
-    }, [menuRef, triggerRef, width, align, focus]);
-    useEffect(() => {
-        const onPointerDown = (event) => {
-            const target = event.target;
-            if (target && !locked() && !menuRef.current?.contains(target) && !triggerRef.current?.contains(target)) {
-                close(false);
-            }
-        };
-        const onKeyDown = (event) => {
-            if ((event.key === "Escape" || event.key === "Tab") && !locked()) {
-                if (event.key === "Escape") {
-                    event.preventDefault();
-                    event.stopPropagation();
-                }
-                close(event.key === "Escape");
-            }
-        };
-        const onResize = () => close(false);
-        document.addEventListener("pointerdown", onPointerDown, true);
-        document.addEventListener("keydown", onKeyDown, true);
-        window.addEventListener("resize", onResize);
-        return () => {
-            document.removeEventListener("pointerdown", onPointerDown, true);
-            document.removeEventListener("keydown", onKeyDown, true);
-            window.removeEventListener("resize", onResize);
-        };
-    }, [menuRef, triggerRef]);
+export function useMenuPopover(menuRef, triggerRef, onClose, {
+  width,
+  align = "start",
+  focus = '[aria-checked="true"], [role^="menuitem"]',
+  busy = false
+}) {
+  const close = useEffectEvent(onClose);
+  const locked = useEffectEvent(() => busy);
+  useLayoutEffect(() => {
+    const menu = menuRef.current;
+    const trigger = triggerRef.current;
+    if (!menu || !trigger) return undefined;
+    showInTopLayer(menu);
+    if (width !== undefined) menu.style.width = `${Math.min(width, window.innerWidth - 16)}px`;
+    place(trigger, menu, {
+      gap: 6,
+      align,
+      matchWidth: false
+    });
+    (menu.querySelector(focus) ?? menu).focus({
+      preventScroll: true
+    });
+    return () => {
+      hideFromTopLayer(menu);
+    };
+  }, [menuRef, triggerRef, width, align, focus]);
+  useEffect(() => {
+    const onPointerDown = event => {
+      const target = event.target;
+      if (target && !locked() && !menuRef.current?.contains(target) && !triggerRef.current?.contains(target)) {
+        close(false);
+      }
+    };
+    const onKeyDown = event => {
+      if ((event.key === "Escape" || event.key === "Tab") && !locked()) {
+        if (event.key === "Escape") {
+          event.preventDefault();
+          event.stopPropagation();
+        }
+        close(event.key === "Escape");
+      }
+    };
+    const onResize = () => close(false);
+    document.addEventListener("pointerdown", onPointerDown, true);
+    document.addEventListener("keydown", onKeyDown, true);
+    window.addEventListener("resize", onResize);
+    return () => {
+      document.removeEventListener("pointerdown", onPointerDown, true);
+      document.removeEventListener("keydown", onKeyDown, true);
+      window.removeEventListener("resize", onResize);
+    };
+  }, [menuRef, triggerRef]);
 }
 /**
  * Arrow keys, Home and End move between a menu's enabled items. From a text field inside the
  * menu (a filter), Home and End stay in the field and the arrows enter the list.
  */
 export function moveMenuFocus(event, menu) {
-    if (!menu || !["ArrowDown", "ArrowUp", "Home", "End"].includes(event.key))
-        return;
-    const items = [...menu.querySelectorAll('[role^="menuitem"]:not(:disabled)')];
-    const inField = document.activeElement instanceof HTMLInputElement && menu.contains(document.activeElement);
-    if (inField && (event.key === "Home" || event.key === "End"))
-        return;
-    event.preventDefault();
-    const current = items.indexOf(document.activeElement);
-    const next = event.key === "Home"
-        ? 0
-        : event.key === "End"
-            ? items.length - 1
-            : inField
-                ? 0
-                : (current + (event.key === "ArrowDown" ? 1 : -1) + items.length) % items.length;
-    items[next]?.focus({ preventScroll: true });
+  if (!menu || !["ArrowDown", "ArrowUp", "Home", "End"].includes(event.key)) return;
+  const items = [...menu.querySelectorAll('[role^="menuitem"]:not(:disabled)')];
+  const inField = document.activeElement instanceof HTMLInputElement && menu.contains(document.activeElement);
+  if (inField && (event.key === "Home" || event.key === "End")) return;
+  event.preventDefault();
+  const current = items.indexOf(document.activeElement);
+  const next = event.key === "Home" ? 0 : event.key === "End" ? items.length - 1 : inField ? 0 : (current + (event.key === "ArrowDown" ? 1 : -1) + items.length) % items.length;
+  items[next]?.focus({
+    preventScroll: true
+  });
 }

package/dist/screens.d.ts

@@ -1,16 +1,27 @@
-import type { JSX, ReactNode } from "react";
+import { type JSX, type ReactNode } from "react";
 import type { MdbaseAppId } from "./apps.js";
 /**
  * What an app shows while it opens a collection: its wordmark, scanning, and a quiet line
  * saying what it is waiting for. A failure keeps the same place, shakes the mark once and
  * offers a retry.
+ *
+ * With `entrance="flock"` it is the launch screen: a 42px mark that the flock flies onto
+ * from the edges of the screen, once per page, before it starts scanning. Pair it with
+ * `useLaunchEntrancePlaying()` so a fast open does not cut the entrance off.
  */
-export declare function OpeningScreen({ app, title, detail, error, onRetry }: {
-    readonly app: MdbaseAppId;
+export declare function OpeningScreen(props: {
+    /** A built-in app wordmark, or the name of an independent collection app. */
+    readonly app: MdbaseAppId | {
+        readonly name: string;
+        readonly mark?: ReactNode;
+    };
+    /** Embedded gates must not add a second main landmark. */
+    readonly layout?: "page" | "panel" | undefined;
     readonly title: string;
     readonly detail?: string | undefined;
     readonly error?: string | null | undefined;
     readonly onRetry?: (() => void) | undefined;
+    readonly entrance?: "flock" | undefined;
 }): JSX.Element;
 /**
  * The screen before a collection is open: the app's wordmark, a headline, what the app will
@@ -28,3 +39,9 @@ export declare function ConnectLayout({ app, title, lead, status, error, detail,
     readonly footnote?: ReactNode | undefined;
     readonly children?: ReactNode | undefined;
 }): JSX.Element;
+/**
+ * True while the launch entrance is flying. An app that opens quickly keeps its
+ * opening screen until this is false, so the entrance is never cut off mid-flight;
+ * it lasts at most two seconds.
+ */
+export declare function useLaunchEntrancePlaying(): boolean;