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

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,99 @@
+import * as react from 'react';
+import { ReactNode } 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;
+
+export { AgentAvatar, Avatar, BandMark, ErrorNote, Glyph, type GlyphKind, INSTRUMENTS, InfoNote, type Instrument, LogoLockup, PaneHeader, WorkshopEmblem, WorkshopIcon, agentInstrument, avatarInitial, avatarTone, instrumentOf, memberOrder };

package/dist/components.js

@@ -0,0 +1,48 @@
+/* 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";
+  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,
+  WorkshopEmblem,
+  WorkshopIcon,
+  agentInstrument,
+  avatarInitial,
+  avatarTone,
+  instrumentOf,
+  memberOrder
+} from "./chunk-ULDBT77D.js";
+export {
+  AgentAvatar,
+  Avatar,
+  BandMark,
+  ErrorNote,
+  Glyph,
+  INSTRUMENTS,
+  InfoNote,
+  LogoLockup,
+  PaneHeader,
+  WorkshopEmblem,
+  WorkshopIcon,
+  agentInstrument,
+  avatarInitial,
+  avatarTone,
+  instrumentOf,
+  memberOrder
+};

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 错误怎么写给人看。不依赖 React：宿主的数据层（apps/web）也从子路径 `@kanyun-ai-infra/band-plugin-react/errors` 引，
+ * 和插件用同一个出口、同一句话。
+ */
+declare function errorText(e: unknown): string;
+/**
+ * 请求根本没到服务端（断网、DNS、被代理拦下）：宿主抛的错误带这个 `code`，插件按它认，不看各家浏览器的报错原文。
+ * 全站对这类失败只有这一个出口、这一句话（card-1810 先合定下，card-1794 的「全站 fetch 失败」复用）：
+ * 原因写 `NETWORK_LOST`，后面跟这一处能做的下一步，见 `failedBecause`。
+ */
+declare const NETWORK_LOST_CODE = "NETWORK";
+declare const NETWORK_LOST = "\u7F51\u7EDC\u65AD\u4E86";
+declare function isNetworkLost(e: unknown): boolean;
+/**
+ * 写在「…没传上去：」「…没撤成：」后面的原因。网络断了写「网络断了，<下一步>」，下一步写这一处界面上真有的按钮名
+ * （附件旁有「重试」写「点重试」，队列行上只有「撤回」写「再点一次撤回」，没有按钮写「稍后再试」；pm 10-29），
+ * 其余照错误原文：宿主的话已经写清上限、配额还剩多少这类能照着做的事。
+ */
+declare function failedBecause(e: unknown, next: string): string;
+/**
+ * 服务端回了 403（没有权限）：宿主抛的错误带服务端的错误码 `code` = `FORBIDDEN_CODE`，插件按它认。
+ * 读接口的 403 不是「没读出来」，重试也不会好：画「没有权限」说明（谁能看、去找谁），不放「重试」。
+ * 写接口的 403 照旧写原因（服务端的话已经说清为什么不让做）。
+ */
+declare const FORBIDDEN_CODE = "FORBIDDEN";
+declare function isForbidden(e: unknown): boolean;
+
+export { FORBIDDEN_CODE, NETWORK_LOST, NETWORK_LOST_CODE, errorText, failedBecause, isForbidden, isNetworkLost };

package/dist/errors.js

@@ -0,0 +1,18 @@
+import {
+  FORBIDDEN_CODE,
+  NETWORK_LOST,
+  NETWORK_LOST_CODE,
+  errorText,
+  failedBecause,
+  isForbidden,
+  isNetworkLost
+} from "./chunk-6VMUZ4PQ.js";
+export {
+  FORBIDDEN_CODE,
+  NETWORK_LOST,
+  NETWORK_LOST_CODE,
+  errorText,
+  failedBecause,
+  isForbidden,
+  isNetworkLost
+};

package/dist/first-delivery.d.ts

@@ -0,0 +1,52 @@
+import { StageRunSummary } from '@kanyun-ai-infra/band-plugin-sdk';
+
+/**
+ * 从没产出过产物的失败阶段「手动交第一版」的唯一说法与判定：按钮名、置灰原因、非 store 说明、还缺哪几项。
+ * 失败阶段上能看到的地方（回合栏等）、对话框、端到端用例都读这里，调用处不各自再判。不依赖 React：端到端用例从
+ * 子路径 `@kanyun-ai-infra/band-plugin-react/first-delivery` 引。
+ */
+
+declare const FIRST_DELIVERY_LABEL = "\u624B\u52A8\u4EA4\u7B2C\u4E00\u7248";
+declare const FIRST_DELIVERY_SUBMIT = "\u63D0\u4EA4\u7B2C\u4E00\u7248";
+type Failure = NonNullable<StageRunSummary["failure"]>;
+type FirstDelivery = NonNullable<Failure["firstDelivery"]>;
+/** 目标仓库或外部存放的产物不能在这里手动交，只留「重试」时失败原因下的那一行。 */
+declare function firstDeliveryNotStoreNote(typeLabel: string): string;
+type FirstDeliveryEntry = 
+/** 不画入口；`note` 有就写在失败原因下面。 */
+{
+    draw: false;
+    note?: string;
+}
+/** 画入口；`disabled` 时置灰，`title` 写原因。 */
+ | {
+    draw: true;
+    disabled: boolean;
+    title: string;
+};
+/**
+ * 该不该画入口、为什么置灰。没有 `submit-change` 不画（不分原因）；上游不满足画出来置灰，`title` 写原因；
+ * 非 store 不画，只给说明。不是从没产出过的失败阶段（没有 `firstDelivery`）不画。
+ */
+declare function firstDeliveryEntry(failure: Failure | undefined, can: {
+    submitChange: boolean;
+}): FirstDeliveryEntry;
+/** 清单里要交的一格：产物类型加扇出键（键由提交人定时没有 `key`）。 */
+interface FirstDeliverySlot {
+    id: string;
+    type: string;
+    key?: string;
+    label: string;
+}
+declare function firstDeliverySlots(fd: FirstDelivery): FirstDeliverySlot[];
+/** 还缺哪几项：`filled` 是已选了文件的格子 id。 */
+declare function firstDeliveryMissing(slots: readonly FirstDeliverySlot[], filled: ReadonlySet<string>): FirstDeliverySlot[];
+declare function firstDeliveryMissingText(missing: readonly FirstDeliverySlot[]): string;
+declare const FIRST_DELIVERY_PICK = "\u9009\u62E9\u6587\u4EF6";
+declare const FIRST_DELIVERY_REMOVE = "\u79FB\u9664";
+/** 同一格再选同名文件：新的替换旧的，那一行这样标。 */
+declare const FIRST_DELIVERY_REPLACED = "\u5DF2\u66FF\u6362";
+declare const firstDeliveryFilesText: (n: number) => string;
+declare function fileSizeText(bytes: number): string;
+
+export { FIRST_DELIVERY_LABEL, FIRST_DELIVERY_PICK, FIRST_DELIVERY_REMOVE, FIRST_DELIVERY_REPLACED, FIRST_DELIVERY_SUBMIT, type FirstDelivery, type FirstDeliveryEntry, type FirstDeliverySlot, fileSizeText, firstDeliveryEntry, firstDeliveryFilesText, firstDeliveryMissing, firstDeliveryMissingText, firstDeliveryNotStoreNote, firstDeliverySlots };

package/dist/first-delivery.js

@@ -0,0 +1,28 @@
+import {
+  FIRST_DELIVERY_LABEL,
+  FIRST_DELIVERY_PICK,
+  FIRST_DELIVERY_REMOVE,
+  FIRST_DELIVERY_REPLACED,
+  FIRST_DELIVERY_SUBMIT,
+  fileSizeText,
+  firstDeliveryEntry,
+  firstDeliveryFilesText,
+  firstDeliveryMissing,
+  firstDeliveryMissingText,
+  firstDeliveryNotStoreNote,
+  firstDeliverySlots
+} from "./chunk-IJBJEU3H.js";
+export {
+  FIRST_DELIVERY_LABEL,
+  FIRST_DELIVERY_PICK,
+  FIRST_DELIVERY_REMOVE,
+  FIRST_DELIVERY_REPLACED,
+  FIRST_DELIVERY_SUBMIT,
+  fileSizeText,
+  firstDeliveryEntry,
+  firstDeliveryFilesText,
+  firstDeliveryMissing,
+  firstDeliveryMissingText,
+  firstDeliveryNotStoreNote,
+  firstDeliverySlots
+};

package/dist/image-view.d.ts

@@ -0,0 +1,153 @@
+import { Anchor, ProjectCtx, AnchorPlace, ThreadView } from '@kanyun-ai-infra/band-plugin-sdk';
+
+/** 图片、视频与分镜共用的几何纯函数。由 viewer-image/image 与 viewer-media/media 原样搬入；不依赖 React 或插件实例。 */
+/** 0–1 相对内容本身的矩形；点是 `w = h = 0`。 */
+interface UnitRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** 读 `rect`：坐标出界、缺字段的不认（schema 同 `region`，标注 §3.2）。 */
+declare function unitRectFrom(value: unknown): UnitRect | null;
+interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 按下后移动不到这么多像素算点，不算拖（标注 §4.4，各查看器同一个阈值）。 */
+declare const DRAG_PX = 4;
+/**
+ * 屏幕上从 `a` 拖到 `b`（或只点了 `a`）换成相对内容的矩形：限制在内容内，取到千分之一。
+ * 内容还没显示出来（宽或高为 0）给 null。
+ */
+declare function unitRectOf(content: Box, a: {
+    x: number;
+    y: number;
+}, b?: {
+    x: number;
+    y: number;
+}): UnitRect | null;
+declare const MIN_SCALE = 1;
+declare const MAX_SCALE = 8;
+/** 缩到这个倍数以下自动回到适应窗口（产物交付 §3「看图手感」）。 */
+declare const SNAP_SCALE = 1.05;
+/** 缩放与平移：`scale` 相对「适应窗口」的大小，`x`、`y` 是图片中心偏离窗口中心的像素。 */
+interface View {
+    scale: number;
+    x: number;
+    y: number;
+}
+declare const FIT: View;
+/**
+ * 图片在窗口里适应时的大小：整张放得下，小图不放大（放大会糊，用户自己点放大）。
+ */
+declare function fitSize(natural: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+};
+/** 平移不让图片边缘离开窗口：图比窗口小的那一维居中。`max` 默认 `MAX_SCALE`；超大图要放到实际像素时调用方给更大的。 */
+declare function clampView(v: View, base: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, max?: number): View;
+/**
+ * 以窗口里的一点（相对窗口中心的像素）为中心缩放：那一点下面的图片内容缩放前后不动。
+ * 往小缩到 `SNAP_SCALE` 以下回到适应窗口；往大不吸附，触控板双指每次只放大百分之几，吸附会让它永远放不大。
+ */
+declare function zoomAt(v: View, factor: number, at: {
+    x: number;
+    y: number;
+}, base: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, max?: number): View;
+
+declare const LIGHTBOX_MAX_SCALE: number;
+declare const LIGHTBOX_DRAG_PX: number;
+interface Size {
+    width: number;
+    height: number;
+}
+declare function lightboxSize(natural: Size, viewport: Size, narrow: boolean): Size;
+/** 和原型一样，放大后的边缘允许离舞台边最多 40px；适应时不平移。 */
+declare function lightboxClamp(view: View, base: Size, viewport: Size): View;
+declare function lightboxZoom(view: View, factor: number, at: {
+    x: number;
+    y: number;
+}, base: Size, viewport: Size): View;
+declare function focusRegion(rect: UnitRect, base: Size, viewport: Size): View;
+/** 首尾不环绕；切图是否真的发生由返回值判断，边界上不收用户的草稿。 */
+declare function nextImage(index: number, delta: number, count: number): number;
+
+/** 由分镜大图抽出的共用控制器；业务信息与锚点语义由查看器提供。 */
+
+declare const LIGHTBOX_STYLE = "\n.bs-frame { position: relative; min-height: 0; height: 100%; display: grid; }\n.bs-frame .bs-lb [hidden] { display: none; }\n.bs-picture { display: block; position: relative; padding: 0; border: 0; background: none; border-radius: var(--r-sm); cursor: zoom-in; justify-self: start; }\n.bs-picture:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }\n.bs-wall .bs-picture { width: 100%; justify-self: stretch; }\n.bs-wall .bs-thumb { max-width: 100%; }\n.bs-magnify { position: absolute; right: 4px; bottom: 4px; width: 24px; height: 24px; display: grid; place-items: center; border-radius: 6px; background: rgba(0,0,0,.45); color: var(--media-ink); opacity: 0; }\n.bs-magnify svg { width: 14px; height: 14px; }\n.bs-picture:hover .bs-magnify, .bs-picture:focus-visible .bs-magnify { opacity: 1; }\n.bs-count { position: absolute; top: 4px; left: 4px; min-width: 16px; height: 16px; padding: 0 4px; border-radius: 8px; background: var(--accent); color: var(--accent-ink); font: 600 10px var(--mono); }\n.bs-returned { outline: 2px solid var(--accent); outline-offset: -2px; }\n.bs-lb { position: absolute; inset: 0; display: grid; grid-template-rows: auto minmax(0,1fr) auto; background: var(--media); color: var(--media-ink); min-width: 0; }\n/* \u5168\u5C4F\u5C42\u7EA7\u7531\u771F\u5B9E\u6302\u8F7D\u70B9\u7BA1\u7406\uFF1B\u9501\u5B9A\u8BC4\u8BBA\u5BBF\u4E3B\u540C\u6863\u540E\u7F6E\uFF0C\u7EE7\u7EED\u753B\u5728\u5927\u56FE\u4E0A\u9762\u3002 */\n.bs-lb[data-full=\"true\"] { position: fixed; inset: 0; }\n.bs-lb-bar { display: flex; align-items: center; gap: 4px; padding: 8px 12px; min-width: 0; }\n.bs-lb-title { font-size: var(--fs-ui); font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; min-width: 0; margin: 0 6px; }\n.bs-lb-title span { color: rgba(255,255,255,.6); font: var(--fs-meta) var(--mono); margin-left: 6px; }\n.bs-lb-grow { flex: 1; }\n.bs-lb .bs-lb-button { width: 32px; height: 32px; padding: 0; border: 0; border-radius: 8px; display: inline-grid; place-items: center; background: transparent; color: rgba(255,255,255,.85); cursor: pointer; flex: none; }\n.bs-lb-button svg { width: 18px; height: 18px; }\n.bs-lb .bs-lb-button:hover, .bs-lb-back:hover, .bs-lb-zoom:hover { background: rgba(255,255,255,.12); }\n.bs-lb button:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; }\n.bs-lb button:disabled { opacity: .3; cursor: default; }\n.bs-lb-back { display: inline-flex; align-items: center; gap: 4px; border: 0; background: transparent; color: rgba(255,255,255,.85); font: var(--fs-ui) var(--font); padding: 5px 8px 5px 4px; border-radius: var(--r); cursor: pointer; white-space: nowrap; }\n.bs-lb-back svg { width: 16px; height: 16px; }\n.bs-lb-zoom { font: 500 var(--fs-meta) var(--mono); color: rgba(255,255,255,.8); min-width: 48px; text-align: center; border: 0; background: transparent; cursor: pointer; border-radius: var(--r-sm); padding: 4px 2px; font-variant-numeric: tabular-nums; }\n.bs-lb-main { display: grid; grid-template-columns: minmax(0,1fr) 300px; min-height: 0; }\n.bs-lb-stage { position: relative; overflow: hidden; touch-action: none; user-select: none; min-height: 0; outline: none; }\n.bs-lb-stage[data-pan=\"true\"] { cursor: grab; }\n.bs-lb-stage[data-pan=\"true\"]:active { cursor: grabbing; }\n.bs-lb-stage[data-mark=\"true\"] { cursor: crosshair; }\n.bs-lb-image { position: absolute; border-radius: 2px; box-shadow: 0 8px 30px rgba(0,0,0,.5); max-width: none; object-fit: fill; pointer-events: none; }\n.bs-lb-regions { position: absolute; inset: 0; pointer-events: none; }\n.bs-lb-region { position: absolute; border: 2px solid var(--accent); background: color-mix(in srgb,var(--accent) 13%,transparent); border-radius: 2px; }\n.bs-lb-region.old { border-width: 1.5px; border-style: dashed; background: color-mix(in srgb,var(--accent) 8%,transparent); }\n.bs-lb-point { position: absolute; width: 14px; height: 14px; border-radius: 50%; background: var(--accent); box-shadow: 0 0 0 3px color-mix(in srgb,var(--accent) 30%,transparent); translate: -50% -50%; }\n.bs-lb-nav { position: absolute; top: 50%; translate: 0 -50%; width: 40px; height: 40px; border-radius: 20px; border: 0; background: rgba(0,0,0,.45); color: var(--media-ink); display: grid; place-items: center; cursor: pointer; }\n.bs-lb-nav:hover { background: rgba(0,0,0,.7); }\n.bs-lb-nav svg { width: 20px; height: 20px; }\n.bs-lb-nav.prev { left: 12px; } .bs-lb-nav.next { right: 12px; }\n.bs-lb-side { background: var(--panel); color: var(--ink); overflow: auto; overscroll-behavior: contain; padding: 16px; display: grid; gap: 12px; align-content: start; border-left: 1px solid var(--rule); min-width: 0; }\n.bs-lb-side h3 { margin: 0; font-size: var(--fs-title); display: flex; align-items: baseline; gap: 8px; }\n.bs-lb-side h3 span { font: var(--fs-meta) var(--mono); color: var(--muted); font-weight: 400; }\n.bs-lb-side dl { margin: 0; display: grid; grid-template-columns: 40px minmax(0,1fr); gap: 6px 8px; font-size: var(--fs-ui); }\n.bs-lb-side dt { color: var(--muted); font-size: var(--fs-meta); padding-top: 1px; }\n.bs-lb-side dd { margin: 0; overflow-wrap: anywhere; }\n.bs-lb-path { font-family: var(--mono); }\n.bs-lb-cm-head { font-size: var(--fs-meta); color: var(--muted); border-top: 1px solid var(--rule); padding-top: 10px; }\n.bs-lb-cm { border: 0; background: none; text-align: left; display: grid; grid-template-columns: 18px minmax(0,1fr); gap: 8px; padding: 6px; border-radius: var(--r); cursor: pointer; font: var(--fs-ui) var(--font); color: var(--ink); }\n.bs-lb-cm:hover { background: var(--fill-2); }\n.bs-lb-excerpt { overflow: hidden; text-overflow: ellipsis; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; }\n.bs-lb-hint { margin: 0; font-size: var(--fs-meta); color: var(--muted); }\n.bs-lb-stage .bs-lb-hint { padding: 40px; color: var(--media-ink); }\n.bs-lb-strip { display: flex; gap: 6px; padding: 8px 12px 10px; overflow-x: auto; overscroll-behavior: contain; justify-content: safe center; }\n.bs-lb-strip button { flex: none; width: 88px; aspect-ratio: 16/9; border-radius: 4px; border: 2px solid transparent; padding: 0; position: relative; overflow: hidden; cursor: pointer; background: none; opacity: .65; }\n.bs-lb-strip button[aria-current=\"true\"] { border-color: rgba(255,255,255,1); opacity: 1; }\n.bs-lb-strip button:hover { opacity: 1; }\n.bs-lb-strip img { width: 100%; height: 100%; object-fit: cover; }\n.bs-lb-strip span { position: absolute; left: 4px; bottom: 2px; font: 600 10px var(--mono); color: var(--media-ink); text-shadow: 0 1px 2px rgba(0,0,0,.6); }\n@media (max-width: 600px) {\n .bs-lb-main { grid-template-columns: minmax(0,1fr); grid-template-rows: minmax(0,1fr) minmax(0,1fr); }\n .bs-lb-side { border-left: 0; border-top: 1px solid var(--rule); }\n .bs-lb-strip { display: none; }\n .bs-lb-nav { width: 34px; height: 34px; }\n .bs-lb-title { margin: 0; }\n .bs-lb-back { font-size: 0; padding: 5px 4px; }\n}\n";
+declare const ICONS: {
+    back: string;
+    next: string;
+    minus: string;
+    plus: string;
+    full: string;
+    comment: string;
+};
+declare function lightboxIcon(doc: Document, name: keyof typeof ICONS): SVGSVGElement;
+interface ImageLightboxItem {
+    title: string;
+    path: string | null;
+    alt?: string;
+}
+interface ImageLightboxOptions {
+    items(): readonly ImageLightboxItem[];
+    imageUrl(path: string): Promise<string>;
+    canComment(): boolean;
+    region(anchor: Anchor): {
+        index: number;
+        path: string;
+        rect: UnitRect;
+    } | null;
+    makeAnchor?(index: number, rect: UnitRect): Anchor | null;
+    changed(anchor: Anchor, path: string): boolean;
+    renderSide(side: HTMLElement, index: number): void;
+    heading(index: number): {
+        title: string;
+        meta?: string;
+    };
+    labels: {
+        layer: string;
+        back: string;
+        stage: string;
+        side: string;
+        strip: string;
+        previous: string;
+        next: string;
+        item(index: number): string;
+        error: string;
+    };
+    notify(): void;
+    returned(index: number): void;
+}
+declare function createImageLightbox(ctx: ProjectCtx, root: HTMLElement, frame: HTMLElement, options: ImageLightboxOptions): {
+    open: (next: number) => void;
+    locate: (anchor: Anchor) => AnchorPlace;
+    reveal: (anchor: Anchor) => Promise<boolean>;
+    setThreads(next: ThreadView[]): void;
+    close: () => void;
+    refresh(): void;
+    dispose(): void;
+};
+
+export { DRAG_PX, FIT, type ImageLightboxItem, type ImageLightboxOptions, LIGHTBOX_DRAG_PX, LIGHTBOX_MAX_SCALE, LIGHTBOX_STYLE, MAX_SCALE, MIN_SCALE, SNAP_SCALE, type Size, type UnitRect, type View, clampView, createImageLightbox, fitSize, focusRegion, lightboxClamp, lightboxIcon, lightboxSize, lightboxZoom, nextImage, unitRectFrom, unitRectOf, zoomAt };