@kanyun-ai-infra/band-plugin-react 0.0.0-stage → 0.1.2

package/dist/chunk-IJBJEU3H.js

@@ -0,0 +1,56 @@
+// src/first-delivery.ts
+var FIRST_DELIVERY_LABEL = "\u624B\u52A8\u4EA4\u7B2C\u4E00\u7248";
+var FIRST_DELIVERY_SUBMIT = "\u63D0\u4EA4\u7B2C\u4E00\u7248";
+function firstDeliveryNotStoreNote(typeLabel) {
+  return `\u300C${typeLabel}\u300D\u5B58\u653E\u5728\u76EE\u6807\u4ED3\u5E93\u91CC\uFF0C\u4E0D\u80FD\u5728\u8FD9\u91CC\u624B\u52A8\u4EA4\uFF0C\u8BF7\u91CD\u8BD5`;
+}
+function firstDeliveryEntry(failure, can) {
+  const fd = failure?.firstDelivery;
+  if (!fd) return { draw: false };
+  if (fd.state === "not_store")
+    return { draw: false, note: firstDeliveryNotStoreNote(fd.nonStoreType ?? "") };
+  if (!can.submitChange) return { draw: false };
+  if (fd.state === "blocked")
+    return { draw: true, disabled: true, title: fd.blocked ?? "\u4E0A\u6E38\u8FD8\u6CA1\u6279\u51C6\uFF0C\u4E0D\u80FD\u624B\u52A8\u4EA4\u7B2C\u4E00\u7248" };
+  return { draw: true, disabled: false, title: "\u81EA\u5DF1\u4EA4\u4E00\u4EFD\u8FD9\u4E2A\u9636\u6BB5\u7684\u4EA7\u7269\uFF0C\u4E0D\u518D\u7B49\u5B83\u8DD1\u5B8C" };
+}
+function firstDeliverySlots(fd) {
+  return fd.expected.flatMap(
+    (x) => x.keys && x.keys.length > 0 ? x.keys.map((key) => ({
+      id: `${x.type}\0${key}`,
+      type: x.type,
+      key,
+      label: `${x.label} \xB7 ${key}`
+    })) : [{ id: x.type, type: x.type, label: x.label }]
+  );
+}
+function firstDeliveryMissing(slots, filled) {
+  return slots.filter((s) => !filled.has(s.id));
+}
+function firstDeliveryMissingText(missing) {
+  return missing.length === 0 ? "" : `\u8FD8\u7F3A\uFF1A${missing.map((m) => m.label).join("\u3001")}`;
+}
+var FIRST_DELIVERY_PICK = "\u9009\u62E9\u6587\u4EF6";
+var FIRST_DELIVERY_REMOVE = "\u79FB\u9664";
+var FIRST_DELIVERY_REPLACED = "\u5DF2\u66FF\u6362";
+var firstDeliveryFilesText = (n) => `${n} \u4E2A\u6587\u4EF6`;
+function fileSizeText(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+
+export {
+  FIRST_DELIVERY_LABEL,
+  FIRST_DELIVERY_SUBMIT,
+  firstDeliveryNotStoreNote,
+  firstDeliveryEntry,
+  firstDeliverySlots,
+  firstDeliveryMissing,
+  firstDeliveryMissingText,
+  FIRST_DELIVERY_PICK,
+  FIRST_DELIVERY_REMOVE,
+  FIRST_DELIVERY_REPLACED,
+  firstDeliveryFilesText,
+  fileSizeText
+};

package/dist/chunk-VKASR4EL.js

@@ -0,0 +1,46 @@
+// src/scroll.ts
+function scrollIntoPanel(el, {
+  block = "nearest",
+  behavior = "auto",
+  page = false
+} = {}) {
+  const doc = el.ownerDocument;
+  const view = doc.defaultView;
+  const r = el.getBoundingClientRect();
+  if (r.width === 0 && r.height === 0) return;
+  let moved = 0;
+  for (const box of scrollersOf(el, page)) {
+    const rTop = r.top - moved;
+    const whole = box === (doc.scrollingElement ?? doc.documentElement);
+    const top = whole ? 0 : box.getBoundingClientRect().top + box.clientTop;
+    const height = whole ? view?.innerHeight ?? box.clientHeight : box.clientHeight;
+    let delta = 0;
+    if (block === "start") delta = rTop - top;
+    else if (rTop < top) delta = rTop - top;
+    else if (rTop + r.height > top + height)
+      delta = Math.min(rTop + r.height - (top + height), rTop - top);
+    const max = box.scrollHeight - box.clientHeight;
+    const to = Math.max(0, Math.min(box.scrollTop + delta, max));
+    if (Math.abs(to - box.scrollTop) >= 1) {
+      moved += to - box.scrollTop;
+      if (typeof box.scrollTo === "function") box.scrollTo({ top: to, behavior });
+      else box.scrollTop = to;
+    }
+    if (!page) return;
+  }
+}
+function scrollersOf(el, page) {
+  const doc = el.ownerDocument;
+  const out = [];
+  for (let p = el.parentElement; p && p !== doc.body && p !== doc.documentElement; p = p.parentElement) {
+    const y = getComputedStyle(p).overflowY;
+    if ((y === "auto" || y === "scroll") && p.scrollHeight > p.clientHeight) out.push(p);
+  }
+  const whole = doc.scrollingElement ?? doc.documentElement;
+  if (page && whole && whole.scrollHeight > whole.clientHeight) out.push(whole);
+  return out;
+}
+
+export {
+  scrollIntoPanel
+};

package/dist/chunk-X32B5VUS.js

@@ -0,0 +1,107 @@
+import {
+  failedBecause,
+  isForbidden
+} from "./chunk-6VMUZ4PQ.js";
+
+// src/upgrade-text.ts
+import { LOCKED_ROLE_LABELS } from "@kanyun-ai-infra/band-contracts";
+var labels = LOCKED_ROLE_LABELS;
+function upgradeRoleLabel(role) {
+  return Object.hasOwn(labels, role) ? labels[role] : role;
+}
+function roleList(roles) {
+  return roles.map(upgradeRoleLabel).join(" / ");
+}
+function projectName(p, index) {
+  return p.name ?? `\u9879\u76EE ${index + 1}`;
+}
+function namedProjects(projects, total = projects.length) {
+  if (total === 0 || projects.length !== total || projects.some((p) => p.name === void 0))
+    return "";
+  const shown = projects.slice(0, 3).map((p, i) => projectName(p, i)).join("\u3001");
+  return total > 3 ? `\uFF1A${shown} \u7B49 ${total} \u4E2A` : `\uFF1A${shown}`;
+}
+var UPGRADE_TEXT = {
+  /** 落后但兼容：只提示。 */
+  // 不写「升级后生效」：升完页面自动刷新，用户不用再点一次（note 决定第 6 条）。值保持字符串，钉着旧版的插件还按字符串读它。
+  outdated: "\u9879\u76EE\u6709\u65B0\u7248\u672C\u53EF\u7528\u3002\u5347\u7EA7\u540E\u9875\u9762\u4F1A\u81EA\u52A8\u5237\u65B0\u3002",
+  /** 不兼容：常显，写被挡。 */
+  incompatible: (roles) => `\u9700\u8981\u5347\u7EA7\u624D\u80FD\u7EE7\u7EED\u7528${roleList(roles)}`,
+  /** 部署回滚后，钉住的比本部署新。 */
+  rolledBack: "\u672C\u90E8\u7F72\u5DF2\u56DE\u9000\uFF0C\u5347\u7EA7\u4F1A\u6362\u56DE\u672C\u90E8\u7F72\u7684\u7248\u672C",
+  askAdmin: "\u8BF7\u9879\u76EE\u7BA1\u7406\u5458\u5347\u7EA7",
+  button: "\u5347\u7EA7",
+  busy: "\u6B63\u5728\u5347\u7EA7\uFF0C\u5B8C\u6210\u540E\u9875\u9762\u4F1A\u81EA\u52A8\u5237\u65B0",
+  /** 按钮上的短词（`busy` 是整句，给横幅 / 读屏）。 */
+  busyShort: "\u6B63\u5728\u5347\u7EA7\u2026",
+  upgraded: "\u5347\u7EA7\u6210\u529F\uFF0C\u6B63\u5728\u5237\u65B0\u9875\u9762\u2026",
+  /** 别人升级了、打开着的页面先落盘草稿再刷新。 */
+  refreshingOthers: "\u8FD9\u4E2A\u9879\u76EE\u521A\u5347\u7EA7\u4E86\uFF0C\u6B63\u5728\u4FDD\u5B58\u4F60\u7684\u8349\u7A3F\u5E76\u5237\u65B0\u9875\u9762\u2026",
+  /** 已登记的草稿或未保存内容阻止刷新时显示；旧项目首次升级前的旧组件可能尚未登记。`own` 是自己点的升级。 */
+  refreshStuck: (own) => `${own ? "\u5347\u7EA7\u6210\u529F\u4E86" : "\u8FD9\u4E2A\u9879\u76EE\u521A\u5347\u7EA7\u4E86"}\uFF0C\u4F46\u4F60\u6709\u5185\u5BB9\u6CA1\u80FD\u4FDD\u5B58\uFF0C\u6240\u4EE5\u9875\u9762\u6CA1\u6709\u5237\u65B0\u3002\u8BF7\u5148\u590D\u5236\u6216\u63D0\u4EA4\u5185\u5BB9\uFF0C\u518D\u70B9\u300C\u5237\u65B0\u300D\u3002`,
+  alreadyLatest: "\u5DF2\u7ECF\u662F\u6700\u65B0",
+  /** 实例钉点的阶段结构与当前版本不同，留在原版本；`n` 是几个实例。 */
+  keptInstances: (n) => `${n} \u4E2A\u6D41\u7A0B\u5B9E\u4F8B\u7684\u9636\u6BB5\u7ED3\u6784\u4E0E\u5F53\u524D\u7248\u672C\u4E0D\u540C\uFF0C\u7559\u5728\u539F\u7248\u672C`,
+  /** 升级检查没过：哪个钉点、什么原因。 */
+  checkFailed: (failures) => `\u5347\u7EA7\u6CA1\u505A\u6210\uFF1A${failures.map((f) => `${f.pin}\uFF08${f.problems.length > 0 ? f.problems.join("\uFF1B") : "\u68C0\u67E5\u6CA1\u8FC7"}\uFF09`).join("\uFF1B")}`,
+  noPermission: "\u6CA1\u6709\u5347\u7EA7\u7684\u6743\u9650",
+  /** 工坊页。 */
+  workshop: {
+    /** 落后的项目数：协作功能或本工坊自带的页面功能（工坊重新发布换了自己的插件）有新版本。 */
+    outdatedProjects: (n) => `${n} \u4E2A\u9879\u76EE\u6709\u65B0\u7248\u672C\u53EF\u7528`,
+    incompatibleProjects: (n) => `${n} \u4E2A\u9879\u76EE\u8981\u66F4\u65B0\u534F\u4F5C\u529F\u80FD\uFF0C\u624D\u80FD\u7EE7\u7EED\u63D0\u610F\u89C1\u3001\u6279\u51C6`,
+    button: "\u66F4\u65B0\u672C\u5DE5\u574A\u5168\u90E8\u9879\u76EE",
+    currentOutdated: "\u5E73\u53F0\u66F4\u65B0\u4E86\u534F\u4F5C\u529F\u80FD\uFF0C\u91CD\u65B0\u53D1\u5E03\u540E\uFF0C\u65B0\u9879\u76EE\u624D\u4F1A\u7528\u4E0A",
+    /** 副本里自带的插件和原版某个共享版本内容一致：可以改成引用，之后跟着原版升级。只提示，不挡任何操作。 */
+    referenceHint: {
+      title: (n) => `${n} \u4E2A\u63D2\u4EF6\u53EF\u4EE5\u6539\u4E3A\u5F15\u7528`,
+      /** `spec` 是该写进 `views.plugins` 的引用，如 `@teaching/wall@^1.0.0`。 */
+      row: (name, version) => `${name} \u548C\u539F\u7248\u7684 ${version} \u5185\u5BB9\u4E00\u81F4`,
+      how: (specs) => `\u628A\u5DE5\u574A\u4ED3\u5E93 band/workshop.yaml \u91CC views.plugins \u7684\u5BF9\u5E94\u6761\u76EE\u6362\u6210 ${specs.join("\u3001")}\uFF0C\u518D\u53D1\u5E03\u65B0\u7248\u3002\u4E4B\u540E\u6BCF\u6B21\u53D1\u5E03\uFF0C\u90FD\u4F1A\u53D6\u5230\u539F\u7248\u533A\u95F4\u5185\u6700\u65B0\u7684\u517C\u5BB9\u7248\u672C\uFF1B\u4E0D\u60F3\u6539\u5C31\u4FDD\u6301\u73B0\u72B6\u3002`
+    },
+    /** 点按钮后的确认弹窗：改哪些项目、什么不变、哪些不动、能不能撤回，都说清楚。 */
+    confirm: {
+      title: "\u66F4\u65B0\u672C\u5DE5\u574A\u5168\u90E8\u9879\u76EE",
+      /** 会有变化的项目；名字都有时点名。 */
+      willUpdate: (projects) => `\u5C06\u66F4\u65B0 ${projects.length} \u4E2A\u9879\u76EE${namedProjects(projects)}\u3002`,
+      unchanged: "\u5B83\u4EEC\u7528\u7684\u8BC4\u8BBA\u3001\u6279\u51C6\u3001\u961F\u5217\u3001\u7248\u672C\u5207\u6362\u548C\u672C\u5DE5\u574A\u81EA\u5E26\u7684\u9875\u9762\u529F\u80FD\u4F1A\u6362\u6210\u6700\u65B0\u7248\uFF1B\u9879\u76EE\u91CC\u7684\u4EA7\u7269\u3001\u610F\u89C1\u548C\u6210\u5458\u90FD\u4E0D\u53D8\u3002",
+      // 键名沿用（钉着旧版的插件还读它），内容换成现在的事实：升级不再逐个检查，换完正在看的页面自动刷新
+      checks: "\u5347\u7EA7\u540E\u9875\u9762\u4F1A\u81EA\u52A8\u5237\u65B0\uFF0C\u804A\u5929\u6846\u8349\u7A3F\u5148\u4FDD\u5B58\u3002\u5DF2\u5347\u7EA7\u5230\u542B\u672A\u4FDD\u5B58\u5185\u5BB9\u4FDD\u62A4\u7248\u672C\u7684\u9879\u76EE\uFF0C\u5199\u7740\u6CA1\u6CD5\u4FDD\u5B58\u7684\u5185\u5BB9\u65F6\u9875\u9762\u4E0D\u4F1A\u5237\u65B0\uFF0C\u4F1A\u63D0\u793A\u5148\u590D\u5236\u6216\u63D0\u4EA4\uFF0C\u518D\u70B9\u300C\u5237\u65B0\u300D\u3002\u65E7\u9879\u76EE\u9996\u6B21\u5347\u7EA7\u5230\u8BE5\u7248\u672C\u524D\uFF0C\u8BF7\u5148\u590D\u5236\u6216\u63D0\u4EA4\u8BC4\u8BBA\u3001\u610F\u89C1\u6D6E\u5C42\u548C\u9636\u6BB5\u53C2\u6570\u8868\u5355\u91CC\u7684\u5185\u5BB9\u3002",
+      archived: (n) => `\u5DF2\u5F52\u6863\u7684 ${n} \u4E2A\u9879\u76EE\u4E0D\u52A8\u3002`,
+      /** 工坊里已经是最新、这次不会有变化的那些：写出来，免得「将更新 3 个」和这个工坊的项目数对不上。 */
+      alreadyLatest: (n) => `\u5176\u4F59 ${n} \u4E2A\u9879\u76EE\u672C\u6765\u5C31\u662F\u6700\u65B0\u3002`,
+      noUndo: "\u66F4\u65B0\u540E\u4E0D\u80FD\u64A4\u56DE\u3002",
+      submit: "\u66F4\u65B0",
+      busy: "\u6B63\u5728\u66F4\u65B0\u2026"
+    },
+    /** 结果四类，逐类一句；这一类为零时界面不写。 */
+    result: {
+      /** `n` 是这一类有几个，`projects` 是有名字的那些（条数对不上时不点名）。 */
+      upgraded: (n, projects) => `\u5DF2\u66F4\u65B0 ${n} \u4E2A\u9879\u76EE${namedProjects(projects, n)}\u3002`,
+      current: (n) => `${n} \u4E2A\u9879\u76EE\u672C\u6765\u5C31\u662F\u6700\u65B0\u3002`,
+      archived: (n) => `${n} \u4E2A\u9879\u76EE\u5DF2\u5F52\u6863\uFF0C\u6CA1\u6709\u66F4\u65B0\u3002`,
+      /** 项目钉点换了，但有流程实例的阶段结构与当前版本不同、留在原版本；`n` 是实例数。 */
+      keptInstances: (n) => `${n} \u4E2A\u6D41\u7A0B\u5B9E\u4F8B\u7684\u9636\u6BB5\u7ED3\u6784\u4E0E\u5F53\u524D\u7248\u672C\u4E0D\u540C\uFF0C\u7559\u5728\u539F\u7248\u672C\u3002`,
+      /** 没更新成的项目逐个点名带原因：检查没过的是哪些问题。 */
+      failed: (projects) => `\u6CA1\u66F4\u65B0\u6210 ${projects.length} \u4E2A\u9879\u76EE\uFF1A${projects.map(
+        (p, i) => `${projectName(p, i)}\uFF08${p.problems.length > 0 ? p.problems.join("\uFF1B") : "\u68C0\u67E5\u6CA1\u8FC7"}\uFF09`
+      ).join("\uFF1B")}\u3002`
+    }
+  }
+};
+function upgradeErrorText(e) {
+  if (isForbidden(e)) return UPGRADE_TEXT.askAdmin;
+  const details = e?.details;
+  if (details?.reason === "UPGRADE_CHECK_FAILED" && Array.isArray(details.failures)) {
+    const failures = details.failures.filter(
+      (f) => typeof f === "object" && f !== null && typeof f.pin === "string" && Array.isArray(f.problems)
+    );
+    return UPGRADE_TEXT.checkFailed(failures);
+  }
+  return failedBecause(e, "\u7A0D\u540E\u518D\u8BD5");
+}
+
+export {
+  UPGRADE_TEXT,
+  upgradeErrorText
+};

package/dist/components.d.ts

@@ -0,0 +1,313 @@
+import * as react from 'react';
+import { ReactNode, Ref, MouseEvent } from 'react';
+import { MemberView } from '@kanyun-ai-infra/band-plugin-sdk';
+
+/**
+ * 一行错误提示：操作失败时显示在面板里。`children` 为空（null、undefined、空串、false）时什么也不渲染。
+ * 给了 `retry` 是「读失败」：整行是 alert，提示后面跟「重试」。全站读数据失败只走这一个出口，各页不自己拼；
+ * 原因里断网那句由宿主统一写（`errors` 的 `NETWORK_LOST`）。
+ */
+declare function ErrorNote({ children, retry }: {
+    children: ReactNode;
+    retry?: () => void;
+}): react.JSX.Element | null;
+/** 不是错误的一句说明（比如「已经交给 Rondo 了」）：不用红色，不抢眼。 */
+declare function InfoNote({ children }: {
+    children: ReactNode;
+}): react.JSX.Element | null;
+/** 面板头：标题（`h2`）在左，`children`（筛选、按钮、说明）在右。 */
+declare function PaneHeader({ title, children }: {
+    title: ReactNode;
+    children?: ReactNode;
+}): react.JSX.Element;
+/**
+ * 头像的底色（Band Design `--av1`…`--av5`）。给了 `order`（项目里人的 id，按成员列表的顺序）就按位置轮着取，
+ * 五人以内互不相同，同一页上对话、成员、@ 候选看到的是同一种颜色；不在里面的按 id 取一个固定的。
+ */
+declare function avatarTone(id: string, order?: readonly string[]): number;
+/** 项目里人的 id，按成员列表的顺序（Agent 不占底色）：传给 `Avatar` 的 `order`。 */
+declare function memberOrder(members: readonly MemberView[]): string[];
+/** 头像上的字：名字的第一个字（「王敏」写「王」），拉丁字母大写；没有名字写「?」。 */
+declare function avatarInitial(name: string): string;
+/**
+ * 成员头像（Band Design `.av`）：人是带底色的名字首字；Agent 是标志里的蓝色符头（DESIGN.md · Rondo）。
+ * 旁边已经写了名字时 `decorative` 让读屏跳过它；单独出现时读出名字。
+ */
+declare function Avatar({ id, name, agent, instrument, size, decorative, order, }: {
+    id: string;
+    name: string;
+    agent?: boolean;
+    /** 工坊 Agent 的乐器（`instrumentOf`）；不给就画 Rondo 的符头。只对 `agent` 有效。 */
+    instrument?: Instrument;
+    size?: "xs" | "sm" | "md";
+    decorative?: boolean;
+    /** 项目里人的 id（`memberOrder(members)`），决定底色；见 `avatarTone`。 */
+    order?: readonly string[];
+}): react.JSX.Element;
+/** 状态符号：每行最右边一个 16px 符号，含义全站一致（DESIGN.md「状态符号」，样式在 Band Design）。 */
+type GlyphKind = "working" | "needs" | "new" | "done" | "seen" | "waiting" | "queued" | "failed" | "";
+/** `bg`：后台还有排着的回合（符号底下垫一层）。装饰性，含义由同一行的文字给出。 */
+declare function Glyph({ kind, bg }: {
+    kind: GlyphKind;
+    bg?: boolean;
+}): react.JSX.Element;
+/** 项目里某个 Agent 的乐器（`instrumentOf`，同伴是项目里全部 Agent）；Rondo 没有。 */
+declare function agentInstrument(id: string, members: readonly MemberView[]): Instrument | undefined;
+/** 项目里某个 Agent 的头像：名字取成员显示名，工坊 Agent 画乐器，Rondo 画符头。 */
+declare function AgentAvatar({ id, members, size, decorative, }: {
+    id: string;
+    members: readonly MemberView[] | undefined;
+    size?: "xs" | "sm" | "md";
+    decorative?: boolean;
+}): react.JSX.Element;
+/** 工坊 Agent 的乐器（DESIGN.md「乐器：谁在演」），顺序就是 tokens `instruments/index.json` 的顺序。 */
+declare const INSTRUMENTS: readonly ["sax", "keys", "guitar", "drum", "trumpet", "violin"];
+type Instrument = (typeof INSTRUMENTS)[number];
+/**
+ * 一个工坊里各 Agent 的缺省乐器：名字的 FNV-1a 对乐器数取模，同工坊里撞了顺延到下一件空闲的；
+ * `peers` 是这个工坊的全部 Agent（顺序无关，按名字排序后依次分配，结果不随阶段顺序变）。
+ * Rondo 不拿乐器（返回 undefined，画符头）。超过六个时乐器会重复。
+ */
+declare function instrumentOf(name: string, peers: readonly string[]): Instrument | undefined;
+/**
+ * 工坊 icon（v8 §7「工坊 icon」）：`icon` 是工坊卡片上的字段，`genre:<曲风>` 画内置曲风；仓库内图片还读不到、
+ * 没写或认不出时画标志简版。画的是只有乐器的简版（见 `GENRE_COMPACT_SRC`），48px 及以上的完整版用
+ * `WorkshopEmblem`。装饰性，名称由旁边的文字给出。
+ */
+declare function WorkshopIcon({ icon, size, tile, }: {
+    icon?: string;
+    size?: number;
+    /** 画在方底板上（DESIGN.md「工坊 icon」：底板归宿主）。 */
+    tile?: boolean;
+}): react.JSX.Element;
+/**
+ * 工坊 icon 的完整版（带英文流派名），画在方底板上，给 48px 及以上的大卡与工坊页头用（DESIGN.md「工坊 icon」）。
+ * 和 `WorkshopIcon` 分开，是为了让只画小图标的插件打包时摇掉完整版的图。
+ */
+declare function WorkshopEmblem({ icon, size }: {
+    icon?: string;
+    size?: number;
+}): react.JSX.Element;
+/** Band 标志简版（三个连杠音符，中间那个蓝色的代表 Agent）。装饰性。 */
+declare function BandMark({ size, className }: {
+    size?: number;
+    className?: string;
+}): react.JSX.Element;
+/** Band 字标（五线谱 + 三个音符 + 「Band」，DESIGN.md「标志」）。样式在 Band Design 的 `.logo`。 */
+declare function LogoLockup(): react.JSX.Element;
+
+/** 一次页内跳转的目标：页键与地址参数，由调用方交给宿主。 */
+interface SettingsTarget {
+    page: string;
+    params?: Record<string, string>;
+}
+/** 导航里的一项（分区导航的链接）。 */
+interface SettingsNavItem extends SettingsTarget {
+    slug: string;
+    title: string;
+    href: string;
+    /** 右侧 16px 状态符号（同侧栏），可选。 */
+    glyph?: ReactNode;
+}
+interface SettingsGroup {
+    group: string;
+    sections: readonly SettingsNavItem[];
+}
+/** 页头上方那行返回（`‹ 设置`、`‹ 列表名`）。 */
+interface SettingsBackTarget extends SettingsTarget {
+    label: string;
+    href: string;
+}
+type Navigate = (target: SettingsTarget) => void;
+/** 只在主键上点（没按修饰键）时走页内跳转；其余交给浏览器（新标签页）。 */
+declare function settingsLinkHandler(go: Navigate | undefined, target: SettingsTarget): (e: MouseEvent<HTMLAnchorElement>) => void;
+/**
+ * 四个作用域共用的骨架（稿 §3.1、§3.7）：左边分区导航、右边内容。作用域只决定导航头与分区名单；
+ * 摆法与手机宽度（600px）下的两页切换不变。导航是链接列表（`aria-current="page"`），不是 tablist。
+ */
+declare function SettingsLayout({ navLabel, title, obj, crumb, groups, current, view, back, backMobile, onNavigate, mainRef, children, }: {
+    /** 分区导航的 aria-label（「设置分区」「项目设置分区」）。 */
+    navLabel: string;
+    title: string;
+    /** 导航头第二行（「只有你看得到这里」）。 */
+    obj?: ReactNode;
+    /** 导航头上方的面包屑；项目、工坊作用域的对象头沿用页面顶栏，一般不传。 */
+    crumb?: ReactNode;
+    groups: readonly SettingsGroup[];
+    /** 当前分区的 slug；目录页不传。 */
+    current?: string | undefined;
+    view?: "page" | "index";
+    /** 详情 / 新增页头上的「‹ 列表名」：宽窄都画（稿 §3.2）。 */
+    back?: SettingsBackTarget | undefined;
+    /** 分区页给手机宽度的「‹ 设置」：只在窄屏画（稿 §3.7）。 */
+    backMobile?: SettingsBackTarget | undefined;
+    /** 页内跳转；不给就按普通链接走。 */
+    onNavigate?: Navigate;
+    /** 内容区的 ref（接线层在上面装未保存离开的守卫）。 */
+    mainRef?: Ref<HTMLElement>;
+    children: ReactNode;
+}): react.JSX.Element;
+/** 「‹ 列表名」：详情、新增页头上方；`mobileOnly` 是只在手机宽度画的「‹ 设置」。 */
+declare function SettingsBack({ target, onNavigate, mobileOnly, }: {
+    target: SettingsBackTarget;
+    onNavigate?: Navigate | undefined;
+    mobileOnly?: boolean;
+}): react.JSX.Element;
+/** 页头：标题（分区名）+ 一句说明这里管什么、谁看得到 + 主操作（靠右，一页最多一个）。 */
+declare function SettingsHead({ title, desc, action, }: {
+    title: ReactNode;
+    desc?: ReactNode;
+    action?: ReactNode;
+}): react.JSX.Element;
+/** 列表：行不画框不画线，悬停垫浅底；整行进详情。 */
+declare function SettingsRows({ label, children }: {
+    label: string;
+    children: ReactNode;
+}): react.JSX.Element;
+/**
+ * 一行：（可选的头像 / 图标位）名称 + 标记 / 一行元信息 / 右端最多一个快捷操作 + 进详情的箭头。
+ * 给了 `onOpen` 时整行可点。
+ */
+declare function SettingsRow({ title, tags, meta, actions, leading, href, onOpen, mono, isNew, extra, }: {
+    title: ReactNode;
+    tags?: ReactNode;
+    meta?: readonly ReactNode[];
+    actions?: ReactNode;
+    /** 名称左边的头像或图标（成员行用 `Avatar`），占两行高。 */
+    leading?: ReactNode;
+    href?: string;
+    onOpen?: () => void;
+    mono?: boolean;
+    /** 刚保存的那一行垫 `--ok-soft`（回列表时标出来）。 */
+    isNew?: boolean;
+    /** 行内展开的一块，占满整行宽。画它时别给 `onOpen`：整行链接会盖住它。 */
+    extra?: ReactNode;
+}): react.JSX.Element;
+interface SettingsFact {
+    key: string;
+    value: ReactNode;
+}
+/** 详情概况：定义列表，不画框。 */
+declare function SettingsFacts({ items }: {
+    items: readonly SettingsFact[];
+}): react.JSX.Element;
+/** 一节：`h2` + 可选的一句说明 + 内容；节与节之间留白，不画线、不套卡（稿 §3.1）。 */
+declare function SettingsSection({ title, desc, children, }: {
+    title: string;
+    desc?: ReactNode;
+    children: ReactNode;
+}): react.JSX.Element;
+/**
+ * 只有一份设置的分区（提醒、批准）：不分节、不画 h2（稿 §3.2），控件、说明与反馈竖排。
+ * 名字给 `aria-label`；里面要成组的控件自己放 `fieldset`（组件抹掉它的默认框）。
+ */
+declare function SettingsSingle({ label, children }: {
+    label: string;
+    children: ReactNode;
+}): react.JSX.Element;
+/** 一排勾选（`.choice`）：自动折行。 */
+declare function SettingsChoices({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+/** 危险操作区：只在详情页最下面，每项一行（动作 + 后果一句 + 按钮），按钮是 `.btn.danger`（稿 §3.6）。 */
+declare function SettingsDanger({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+declare function SettingsDangerRow({ title, note, action, }: {
+    title: ReactNode;
+    note: ReactNode;
+    action: ReactNode;
+}): react.JSX.Element;
+/** 加载：页头照常画，内容区用 Band Design 的 `.tuning`（五线谱）配「正在读取<什么>…」；不画骨架条（稿 §3.3）。 */
+declare function SettingsLoading({ text }: {
+    text: string;
+}): react.JSX.Element;
+/** 空：休止符插画 + 一句「还没有什么、有了能做什么」+ 主操作（没有新增权限时不画按钮）。 */
+declare function SettingsEmpty({ children, action }: {
+    children: ReactNode;
+    action?: ReactNode;
+}): react.JSX.Element;
+/** 读失败：一行 `ErrorNote`（「<什么>没读出来：<原因>」+「重试」）。 */
+declare function SettingsReadError({ children, retry }: {
+    children: ReactNode;
+    retry: () => void;
+}): react.JSX.Element;
+/**
+ * 没有权限（读 403）与环境没开通：标题、谁能看 / 缺什么、去找谁，一个离开的按钮（可不给）；不画重试（稿 §3.3）。
+ */
+declare function SettingsNoAccess({ title, children, action, }: {
+    title: string;
+    children: ReactNode;
+    action?: {
+        label: string;
+        onClick: () => void;
+    } | undefined;
+}): react.JSX.Element;
+/** 保存后的读屏播报（「已保存」「已删除」，不抢眼、不占版面）。 */
+declare function SettingsNotice({ text }: {
+    text: string;
+}): react.JSX.Element;
+/** 「已保存」那一句（控件旁或按钮旁，停四拍由调用方的 `useSavedNote` 管）。 */
+declare function SettingsSaved({ text }: {
+    text?: ReactNode;
+}): react.JSX.Element;
+/**
+ * 确认弹窗（稿 §3.6）：`--scrim`、`--shadow-pop`、`--r-xl`；标题问动作，正文列后果，末尾写能不能恢复。
+ * 不用输入名字确认：弹窗已列后果，多打一遍字不增加信息。
+ */
+declare function SettingsDialog({ title, children, actions, onClose, }: {
+    title: string;
+    children: ReactNode;
+    actions: ReactNode;
+    onClose: () => void;
+}): react.JSX.Element;
+/** 设置里的表单：字段竖排，最宽 560。提交走 `onSubmit`（已 `preventDefault`）。 */
+declare function SettingsForm({ label, onSubmit, children, }: {
+    label?: string;
+    onSubmit?: () => void;
+    children: ReactNode;
+}): react.JSX.Element;
+/** 字段的输入要挂的属性：id、读屏说明、出错标记。 */
+interface SettingsFieldProps {
+    id: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: true;
+}
+/**
+ * 字段行：标签（必填写「必填」）、输入、下一行的提示或出错、计数。提示 / 出错 / 计数用 Band Design 的
+ * `.field-note`（出错加 `.err`）与 `.field-count`（DESIGN.md「控件」），出错时输入挂 `aria-invalid`。
+ * 输入本身由调用方用 Band Design 的 `.field` 画，组件只摆位置、接好 id 与读屏说明。
+ */
+declare function SettingsField({ label, required, optional, hint, error, count, over, children, }: {
+    label: ReactNode;
+    required?: boolean;
+    /** 选填：标签旁写「选填」（稿 §3.5 的样张两种都标）；与 `required` 不同时给。 */
+    optional?: boolean;
+    hint?: ReactNode;
+    /** 出错的话；有它时不画提示。 */
+    error?: ReactNode;
+    /** 计数（「12 / 200」），靠右。 */
+    count?: ReactNode;
+    /** 计数超了：计数变红。 */
+    over?: boolean;
+    children: (props: SettingsFieldProps) => ReactNode;
+}): react.JSX.Element;
+/** 表单末尾的操作行：按钮 + 保存反馈 / 还缺什么。 */
+declare function SettingsActions({ children, end, }: {
+    children: ReactNode;
+    end?: boolean;
+}): react.JSX.Element;
+/**
+ * 保存反馈（稿 §3.5）：`saving` 时写在做什么（「正在验证…」那一档的旁注），`saved` 停四拍的「已保存」，
+ * `failed` 是贴在按钮旁的整体错误（「没保存：」开头），`missing` 是按钮置灰时缺什么（「还差 key 没填」）。
+ * 不用吐司；读屏走 `aria-live`。
+ */
+declare function SettingsSaveState({ saving, saved, failed, missing, }: {
+    saving?: ReactNode;
+    /** `true` 写「已保存」；给文字或节点就照它写（「已保存，ModelGate 验证通过」）。 */
+    saved?: ReactNode;
+    failed?: ReactNode;
+    missing?: ReactNode;
+}): react.JSX.Element;
+
+export { AgentAvatar, Avatar, BandMark, ErrorNote, Glyph, type GlyphKind, INSTRUMENTS, InfoNote, type Instrument, LogoLockup, PaneHeader, SettingsActions, SettingsBack, type SettingsBackTarget, SettingsChoices, SettingsDanger, SettingsDangerRow, SettingsDialog, SettingsEmpty, type SettingsFact, SettingsFacts, SettingsField, type SettingsFieldProps, SettingsForm, type SettingsGroup, SettingsHead, SettingsLayout, SettingsLoading, type SettingsNavItem, SettingsNoAccess, SettingsNotice, SettingsReadError, SettingsRow, SettingsRows, SettingsSaveState, SettingsSaved, SettingsSection, SettingsSingle, type SettingsTarget, WorkshopEmblem, WorkshopIcon, agentInstrument, avatarInitial, avatarTone, instrumentOf, memberOrder, settingsLinkHandler };

package/dist/components.js

@@ -0,0 +1,94 @@
+/* band:inject-css */ /* @kanyun-ai-infra/band-plugin-react/components 的样式（scripts/tsup-inject-css.ts） */
+if (typeof document !== "undefined" && document.head) {
+  const css = "/* src/ui.css */\n.band-plugin-react-error {\n  font-size: var(--fs-ui);\n  padding: 7px 10px;\n  border-radius: 8px;\n  background: var(--bad-soft);\n  color: var(--bad);\n  font-family: var(--mono);\n}\n.band-plugin-react-info {\n  font-size: var(--fs-ui);\n  padding: 7px 10px;\n  border-radius: 8px;\n  background: var(--panel);\n  color: var(--muted);\n}\n.band-plugin-react-retry {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 10px;\n}\n.band-plugin-react-failed {\n  display: grid;\n  gap: 6px;\n  justify-items: start;\n  margin: auto;\n  padding: 8px 10px;\n  border-radius: var(--r);\n  background: var(--bad-soft);\n  color: var(--bad);\n  font-size: var(--fs-ui);\n}\n.band-plugin-react-failed p {\n  margin: 0;\n}\n.band-plugin-react-failed-title {\n  font-weight: 600;\n}\n.band-plugin-react-failed-reason {\n  overflow-wrap: anywhere;\n}\n.band-plugin-react-pane-head {\n  padding: 6px 14px 6px 16px;\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  min-height: 36px;\n}\n.band-plugin-react-pane-title {\n  margin: 0;\n  font-size: var(--fs-dense);\n  color: var(--muted);\n  font-weight: 500;\n  letter-spacing: 0.02em;\n}\n.band-plugin-react-wsicon {\n  flex: none;\n  display: block;\n}\n.band-plugin-react-wstile {\n  --band-wstile: 16px;\n  width: var(--band-wstile);\n  height: var(--band-wstile);\n  display: inline-grid;\n  place-items: center;\n  flex: none;\n  border-radius: calc(var(--band-wstile) * 0.26);\n  background: var(--panel);\n  box-shadow: var(--shadow-card);\n}\n.band-plugin-react-wstile > :where(.band-plugin-react-wsicon) {\n  width: 82%;\n  height: 82%;\n}\n.band-plugin-react-wstile:where(.is-large) {\n  border-radius: var(--r-xl);\n}\n.band-plugin-react-wstile:where(.is-large) > :where(.band-plugin-react-wsicon) {\n  width: 76%;\n  height: 76%;\n}\n.band-plugin-react-instrument {\n  width: 72%;\n  height: 72%;\n  background: currentColor;\n  -webkit-mask: var(--band-instrument) center / contain no-repeat;\n  mask: var(--band-instrument) center / contain no-repeat;\n}\n.band-plugin-react-model-hint {\n  margin: 0;\n}\n.band-plugin-react-target-repo {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  margin: 0;\n  font-size: var(--fs-meta);\n  line-height: 1.5;\n  color: var(--muted);\n}\n.band-plugin-react-target-repo code {\n  font-family: var(--mono);\n  color: var(--ink);\n}\n.band-plugin-react-target-repo a {\n  color: var(--accent-text);\n}\n.band-plugin-react-target-repo-request {\n  align-self: flex-start;\n}\n.band-plugin-react-target-repo-err {\n  color: var(--bad);\n}\n.band-plugin-react-first-delivery {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  flex-basis: 100%;\n  padding: 12px;\n  border: 1px solid var(--rule);\n  border-radius: var(--r-lg);\n  background: var(--panel);\n  margin: 0;\n  min-width: 0;\n}\n.band-plugin-react-first-delivery-slot {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  font-size: var(--fs-meta);\n}\n.band-plugin-react-first-delivery-pick,\n.band-plugin-react-first-delivery-file {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n}\n.band-plugin-react-first-delivery-list {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.band-plugin-react-first-delivery-name {\n  min-width: 0;\n  overflow-wrap: anywhere;\n}\n.band-plugin-react-first-delivery-size {\n  color: var(--muted);\n}\n.band-plugin-react-first-delivery-missing {\n  margin: 0;\n  font-size: var(--fs-meta);\n  color: var(--muted);\n}\n.band-plugin-react-first-delivery .btn {\n  align-self: flex-start;\n}\n.band-plugin-react-no-key {\n  margin: 0;\n  font-size: var(--fs-ui);\n  color: var(--bad);\n}\n\n/* src/settings/settings.css */\n.band-sf {\n  display: grid;\n  grid-template-columns: 216px minmax(0, 1fr);\n  min-height: 0;\n  height: 100%;\n}\n.band-sf-nav {\n  min-height: 0;\n  overflow: auto;\n  overscroll-behavior: contain;\n  padding: 24px 12px 24px 20px;\n  display: grid;\n  gap: 16px;\n  align-content: start;\n}\n.band-sf-head {\n  display: grid;\n  gap: 2px;\n  min-width: 0;\n  padding: 0 8px;\n}\n.band-sf-title {\n  font-size: var(--fs-title);\n  font-weight: 600;\n  line-height: 1.3;\n}\n.band-sf-obj {\n  font-size: var(--fs-ui);\n  color: var(--muted);\n}\n.band-sf-grp {\n  display: grid;\n  gap: 1px;\n}\n.band-sf-grp > span {\n  padding: 2px 8px;\n  color: var(--muted);\n  font-size: var(--fs-dense);\n}\n.band-sf-grp a {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 8px;\n  padding: 6px 8px;\n  border-radius: var(--r);\n  color: var(--ink);\n  text-decoration: none;\n  font-size: var(--fs-row);\n}\n.band-sf-grp a:hover {\n  background: var(--fill);\n}\n.band-sf-grp a[aria-current=page] {\n  background: var(--fill-2);\n  font-weight: 500;\n}\n.band-sf-grp a:focus-visible {\n  outline: none;\n  box-shadow: 0 0 0 2px var(--panel), 0 0 0 3.5px var(--accent);\n}\n.band-sf-grp a .band-sf-chev {\n  display: none;\n  color: var(--muted);\n}\n.band-sf-scroll {\n  min-height: 0;\n  overflow: auto;\n  overscroll-behavior: contain;\n}\n.band-sf-main {\n  box-sizing: border-box;\n  width: 100%;\n  max-width: 824px;\n  padding: 32px 32px 64px;\n  display: grid;\n  gap: 20px;\n  align-content: start;\n}\n.band-sf-crumb {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 4px;\n  min-width: 0;\n  color: var(--muted);\n  font-size: var(--fs-dense);\n}\n.band-sf-crumb-in {\n  display: inline-flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 4px;\n  min-width: 0;\n}\n.band-sf-crumb-ws {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  min-width: 0;\n  white-space: nowrap;\n}\n.band-sf-crumb-ws > span {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n.band-sf-crumb a,\n.band-sf-crumb button {\n  min-width: 0;\n  border: 0;\n  padding: 0;\n  background: none;\n  color: var(--muted);\n  font: inherit;\n  text-decoration: none;\n  border-radius: 4px;\n  overflow-wrap: anywhere;\n  cursor: pointer;\n}\n.band-sf-crumb button {\n  text-align: start;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.band-sf-crumb a:hover,\n.band-sf-crumb button:hover {\n  color: var(--ink);\n}\n.band-sf-crumb a:focus-visible,\n.band-sf-crumb button:focus-visible {\n  outline: none;\n  box-shadow: 0 0 0 2px var(--accent);\n}\n.band-sf-back {\n  display: inline-flex;\n  align-self: start;\n  justify-self: start;\n  gap: 4px;\n  color: var(--muted);\n  text-decoration: none;\n  font-size: var(--fs-ui);\n  border-radius: 4px;\n}\n.band-sf-back-m {\n  display: none;\n}\n.band-sf-back:hover {\n  color: var(--ink);\n}\n.band-sf-back:focus-visible {\n  outline: none;\n  box-shadow: 0 0 0 2px var(--panel), 0 0 0 3.5px var(--accent);\n}\n.band-sf-h {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n}\n.band-sf-h > div {\n  display: grid;\n  gap: 4px;\n  min-width: 0;\n}\n.band-sf-h h1 {\n  margin: 0;\n  font-size: var(--fs-h2);\n  font-weight: 600;\n  line-height: 1.3;\n}\n.band-sf-h p {\n  margin: 0;\n  color: var(--muted);\n  font-size: var(--fs-ui);\n  max-width: 560px;\n}\n.band-sf-h-a {\n  flex: none;\n}\n.band-sf-sec {\n  display: grid;\n  gap: 10px;\n}\n.band-sf-sec h2 {\n  margin: 0;\n  font-size: var(--fs-lead);\n  font-weight: 600;\n}\n.band-sf-sec > p {\n  margin: 0;\n  color: var(--muted);\n  font-size: var(--fs-ui);\n}\n.band-sf-rows {\n  display: grid;\n  gap: 2px;\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n.band-sf-row {\n  position: relative;\n  display: grid;\n  grid-template-columns: minmax(0, 1fr) auto;\n  gap: 2px 12px;\n  align-items: center;\n  padding: 10px 12px;\n  margin: 0 -12px;\n  border-radius: var(--r-lg);\n}\n.band-sf-row:hover {\n  background: var(--fill);\n}\n.band-sf-row.is-new,\n.band-sf-row.is-new:hover {\n  background: var(--ok-soft);\n}\n.band-sf-row-t {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 4px 8px;\n  min-width: 0;\n}\n.band-sf-row-t b {\n  font-weight: 600;\n  overflow-wrap: anywhere;\n}\n.band-sf-row-link {\n  color: inherit;\n  text-decoration: none;\n  border-radius: 4px;\n}\n.band-sf-row-link::after {\n  content: \"\";\n  position: absolute;\n  inset: 0;\n  border-radius: var(--r-lg);\n}\n.band-sf-row-a {\n  position: relative;\n  z-index: 1;\n}\n.band-sf-row-link:focus-visible {\n  outline: none;\n  box-shadow: 0 0 0 2px var(--panel), 0 0 0 3.5px var(--accent);\n}\n.band-sf-row-m {\n  grid-column: 1;\n  display: flex;\n  flex-wrap: wrap;\n  gap: 2px 14px;\n  color: var(--muted);\n  font-size: var(--fs-dense);\n  min-width: 0;\n}\n.band-sf-row-m > span {\n  min-width: 0;\n  overflow-wrap: anywhere;\n}\n.band-sf-row-a {\n  grid-column: 2;\n  grid-row: 1 / span 2;\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.band-sf-row-a .btn {\n  position: relative;\n  z-index: 1;\n}\n.band-sf-chev {\n  color: var(--muted);\n}\n.band-sf-mono {\n  font-family: var(--mono);\n  font-size: 0.92em;\n}\n.band-sf-facts {\n  display: grid;\n  gap: 6px 16px;\n  margin: 0;\n  font-size: var(--fs-ui);\n}\n.band-sf-fact {\n  display: grid;\n  grid-template-columns: 112px minmax(0, 1fr);\n  gap: 16px;\n}\n.band-sf-facts dt {\n  color: var(--muted);\n}\n.band-sf-facts dd {\n  margin: 0;\n  min-width: 0;\n  overflow-wrap: anywhere;\n}\n.band-sf-dz {\n  display: grid;\n  gap: 10px;\n  padding-top: 8px;\n}\n.band-sf-dz h2 {\n  margin: 0;\n  font-size: var(--fs-lead);\n  font-weight: 600;\n}\n.band-sf-dz-r {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 16px;\n}\n.band-sf-dz-r > div {\n  display: grid;\n  gap: 2px;\n  min-width: 0;\n}\n.band-sf-dz-r span {\n  color: var(--muted);\n  font-size: var(--fs-dense);\n}\n.band-sf-dz-r .btn {\n  flex: none;\n}\n.band-sf-empty,\n.band-sf .band-sf-empty.rest {\n  display: grid;\n  justify-items: start;\n  text-align: start;\n  gap: 10px;\n  padding: 24px 0;\n  max-width: 480px;\n}\n.band-sf-empty p {\n  margin: 0;\n  color: var(--muted);\n}\n.band-sf-error {\n  min-width: 0;\n}\n.band-sf-load {\n  padding: 40px 0;\n  display: grid;\n  justify-items: start;\n}\n.band-sf-ok {\n  margin: 0;\n  color: var(--ok);\n  font-size: var(--fs-ui);\n}\n.band-sf-muted {\n  margin: 0;\n  color: var(--muted);\n  font-size: var(--fs-ui);\n}\n.band-sf-banner {\n  margin: 0;\n  padding: 10px 12px;\n  border-radius: var(--r-lg);\n  background: var(--fill);\n  font-size: var(--fs-ui);\n}\n.band-sf-banner.is-warn {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  background: var(--warn-soft);\n}\n.band-sf-form {\n  display: grid;\n  gap: 16px;\n  max-width: 560px;\n  min-width: 0;\n}\n.band-sf-form code {\n  overflow-wrap: anywhere;\n}\n.band-sf-fld {\n  display: grid;\n  gap: 6px;\n  min-width: 0;\n}\n.band-sf-fld > label {\n  font-size: var(--fs-ui);\n  font-weight: 500;\n}\n.band-sf-fld .field {\n  box-sizing: border-box;\n  width: 100%;\n  min-width: 0;\n}\n.band-sf-fld textarea.field {\n  resize: vertical;\n  line-height: 1.5;\n}\n.band-sf-req {\n  margin-left: 6px;\n  color: var(--muted);\n  font-weight: 400;\n}\n.band-sf-optional {\n  margin-left: 6px;\n  color: var(--muted);\n  font-weight: 400;\n}\n.band-sf-one {\n  display: grid;\n  gap: 10px;\n  min-width: 0;\n}\n.band-sf-one fieldset {\n  margin: 0;\n  padding: 0;\n  border: 0;\n  min-width: 0;\n  display: grid;\n  gap: 10px;\n}\n.band-sf-choices {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px 12px;\n}\n.band-sf-hint {\n  color: var(--muted);\n  font-size: var(--fs-dense);\n}\n.band-sf-hint a,\n.band-sf-fld .field-note a,\n.band-sf-muted a {\n  color: var(--accent-text);\n  text-decoration: underline;\n  text-underline-offset: 2px;\n}\n.band-sf-err {\n  margin: 0;\n  color: var(--bad);\n  font-size: var(--fs-ui);\n}\n.band-sf-fail {\n  grid-column: 1 / -1;\n  display: flex;\n  align-items: flex-start;\n  gap: 8px;\n  overflow-wrap: anywhere;\n}\n.band-sf-given {\n  margin: 0;\n  padding: 10px 12px;\n  border-radius: var(--r-lg);\n  background: var(--fill);\n  font-size: var(--fs-ui);\n}\ndl.band-sf-given {\n  display: grid;\n  grid-template-columns: 56px minmax(0, 1fr);\n  gap: 2px 12px;\n}\ndl.band-sf-given dt {\n  color: var(--muted);\n}\ndl.band-sf-given dd {\n  margin: 0;\n  min-width: 0;\n}\ndl.band-sf-given p {\n  grid-column: 1 / -1;\n  margin: 0;\n  color: var(--muted);\n  font-size: var(--fs-dense);\n}\n.band-sf-stepback {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  align-self: start;\n  justify-self: start;\n  padding: 0;\n  border: 0;\n  background: none;\n  color: var(--muted);\n  font: inherit;\n  font-size: var(--fs-ui);\n  cursor: pointer;\n  border-radius: 4px;\n}\n.band-sf-stepback:hover {\n  color: var(--ink);\n}\n.band-sf-stepback:focus-visible {\n  outline: none;\n  box-shadow: 0 0 0 2px var(--panel), 0 0 0 3.5px var(--accent);\n}\n.band-sf-acts {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px 12px;\n}\n.band-sf-acts-end {\n  justify-content: flex-end;\n}\n.band-sf-state {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  color: var(--muted);\n  font-size: var(--fs-ui);\n}\n.band-settings-no-access {\n  display: grid;\n  gap: 10px;\n  justify-items: start;\n  max-width: 560px;\n  padding-top: 8px;\n}\n.band-settings-no-access h2 {\n  margin: 0;\n  font-size: var(--fs-title);\n}\n.band-settings-no-access p {\n  margin: 0;\n  color: var(--muted);\n}\n.band-sf-dialog {\n  box-sizing: border-box;\n  width: min(460px, calc(100vw - 32px));\n  max-height: calc(100dvh - 32px);\n  overflow: auto;\n  overscroll-behavior: contain;\n  border: 0;\n  border-radius: var(--r-xl);\n  box-shadow: var(--shadow-pop);\n  background: var(--panel);\n  color: var(--ink);\n  padding: 22px 24px;\n}\n.band-sf-dialog[open] {\n  display: grid;\n  gap: 14px;\n}\n.band-sf-dialog::backdrop {\n  background: var(--scrim);\n}\n.band-sf-dialog h2 {\n  margin: 0;\n  font-size: var(--fs-title);\n  overflow-wrap: anywhere;\n}\n.band-sf-dialog ul {\n  margin: 0;\n  padding-left: 18px;\n  display: grid;\n  gap: 4px;\n}\n.band-sf-row-x {\n  grid-column: 1 / -1;\n  margin-top: 8px;\n  min-width: 0;\n}\n.band-sf-row.has-lead {\n  grid-template-columns: auto minmax(0, 1fr) auto;\n}\n.band-sf-row-l {\n  grid-column: 1;\n  grid-row: 1 / span 2;\n  display: flex;\n  align-items: center;\n}\n.band-sf-row.has-lead .band-sf-row-t,\n.band-sf-row.has-lead .band-sf-row-m {\n  grid-column: 2;\n}\n.band-sf-row.has-lead .band-sf-row-a {\n  grid-column: 3;\n}\n@media (max-width: 600px) {\n  .band-sf {\n    grid-template-columns: minmax(0, 1fr);\n  }\n  .band-sf[data-view=page] .band-sf-nav {\n    display: none;\n  }\n  .band-sf[data-view=index] .band-sf-scroll {\n    display: none;\n  }\n  .band-sf-nav {\n    padding: 16px;\n  }\n  .band-sf-grp a {\n    padding: 10px 8px;\n    font-size: var(--fs-body);\n  }\n  .band-sf-grp a .band-sf-chev {\n    display: inline;\n  }\n  .band-sf-grp a[aria-current=page] {\n    background: none;\n    font-weight: 400;\n  }\n  .band-sf-main {\n    padding: 12px 16px 48px;\n    gap: 16px;\n  }\n  .band-sf-back-m {\n    display: inline-flex;\n  }\n  .band-sf-h {\n    display: grid;\n    gap: 10px;\n  }\n  .band-sf-h-a .btn {\n    justify-self: start;\n  }\n  .band-sf-row-a {\n    grid-column: 1 / -1;\n    grid-row: auto;\n    justify-content: flex-start;\n    margin-top: 4px;\n  }\n  .band-sf-row-a .band-sf-chev {\n    margin-left: auto;\n  }\n  .band-sf-row-a:has(.band-sf-chev:only-child) {\n    grid-column: 2;\n    grid-row: 1 / span 2;\n    justify-content: flex-end;\n    margin-top: 0;\n  }\n  .band-sf-row > .band-sf-acts {\n    grid-column: 1 / -1;\n    justify-content: flex-start;\n    margin-top: 4px;\n  }\n  .band-sf-fact {\n    grid-template-columns: 88px minmax(0, 1fr);\n    gap: 12px;\n  }\n  .band-sf-dz-r {\n    display: grid;\n    gap: 8px;\n  }\n  .band-sf-dz-r .btn {\n    justify-self: start;\n  }\n  .band-sf-dialog {\n    padding: 18px 16px;\n  }\n  .band-sf-row.has-lead .band-sf-row-a {\n    grid-column: 2 / -1;\n  }\n}\n";
+  let el = document.head.querySelector("style[data-band-style=\"@kanyun-ai-infra/band-plugin-react/components\"]");
+  if (!el) {
+    el = document.createElement("style");
+    el.setAttribute("data-band-style", "@kanyun-ai-infra/band-plugin-react/components");
+    document.head.prepend(el);
+  }
+  el.textContent = css;
+}
+/* band:inject-css */
+import {
+  AgentAvatar,
+  Avatar,
+  BandMark,
+  ErrorNote,
+  Glyph,
+  INSTRUMENTS,
+  InfoNote,
+  LogoLockup,
+  PaneHeader,
+  SettingsActions,
+  SettingsBack,
+  SettingsChoices,
+  SettingsDanger,
+  SettingsDangerRow,
+  SettingsDialog,
+  SettingsEmpty,
+  SettingsFacts,
+  SettingsField,
+  SettingsForm,
+  SettingsHead,
+  SettingsLayout,
+  SettingsLoading,
+  SettingsNoAccess,
+  SettingsNotice,
+  SettingsReadError,
+  SettingsRow,
+  SettingsRows,
+  SettingsSaveState,
+  SettingsSaved,
+  SettingsSection,
+  SettingsSingle,
+  WorkshopEmblem,
+  WorkshopIcon,
+  agentInstrument,
+  avatarInitial,
+  avatarTone,
+  instrumentOf,
+  memberOrder,
+  settingsLinkHandler
+} from "./chunk-HX653UQN.js";
+export {
+  AgentAvatar,
+  Avatar,
+  BandMark,
+  ErrorNote,
+  Glyph,
+  INSTRUMENTS,
+  InfoNote,
+  LogoLockup,
+  PaneHeader,
+  SettingsActions,
+  SettingsBack,
+  SettingsChoices,
+  SettingsDanger,
+  SettingsDangerRow,
+  SettingsDialog,
+  SettingsEmpty,
+  SettingsFacts,
+  SettingsField,
+  SettingsForm,
+  SettingsHead,
+  SettingsLayout,
+  SettingsLoading,
+  SettingsNoAccess,
+  SettingsNotice,
+  SettingsReadError,
+  SettingsRow,
+  SettingsRows,
+  SettingsSaveState,
+  SettingsSaved,
+  SettingsSection,
+  SettingsSingle,
+  WorkshopEmblem,
+  WorkshopIcon,
+  agentInstrument,
+  avatarInitial,
+  avatarTone,
+  instrumentOf,
+  memberOrder,
+  settingsLinkHandler
+};