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

package/dist/scroll.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 把一个元素滚进它所在的那个滚动面板里，只滚这一个面板（owner 10-28 [M0]「整页被滚走」）。不依赖 React，
+ * 不用 React 的插件从子路径 `@kanyun-ai-infra/band-plugin-react/scroll` 引。
+ *
+ * 不用 `scrollIntoView`：它会把目标的所有可滚祖先都滚一遍，包括整页和外层页面；文档只要比视口高一点，整页就被
+ * 带起来，顶栏被切、底下露出空白。找不到可滚的面板就不动：外壳的整页不滚。全仓门禁见 `scripts/check-scroll-and-sr.mjs`。
+ *
+ * - `nearest`（缺省）：已经整个看得见就不动，否则滚到贴近的那一边。
+ * - `start`：顶边对齐。
+ * - 目标没有盒子（`display: none`，比如藏在没切到的标签页里）：不动，和 `scrollIntoView` 一样。
+ * - `page`：元素在预览页自己的文档里（网页查看器的壳页）：由内往外滚每一层可滚祖先，最后滚这一页本身；
+ *   不越过它所在的 iframe。
+ */
+declare function scrollIntoPanel(el: Element, { block, behavior, page, }?: {
+    block?: "nearest" | "start";
+    behavior?: ScrollBehavior;
+    page?: boolean;
+}): void;
+
+export { scrollIntoPanel };

package/dist/scroll.js

@@ -0,0 +1,6 @@
+import {
+  scrollIntoPanel
+} from "./chunk-VKASR4EL.js";
+export {
+  scrollIntoPanel
+};

package/dist/stopped-turn.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 人停下了一个回合的唯一说法：「停下了回合 #3」，给了 `who` 前面带名字（「kld 停下了回合 #3」）。线程里那一行、回合栏、
+ * 第一版之前的主区与阶段回看、对话框上方都读它，别在调用点再写一遍。不依赖 React：端到端用例也从子路径
+ * `@kanyun-ai-infra/band-plugin-react/stopped-turn` 引，断言跟着说法走，不抄一遍字面文案。
+ */
+declare function stoppedTurnText(number: number, who?: string): string;
+
+export { stoppedTurnText };

package/dist/stopped-turn.js

@@ -0,0 +1,6 @@
+import {
+  stoppedTurnText
+} from "./chunk-47BPPTXZ.js";
+export {
+  stoppedTurnText
+};

package/dist/upgrade-text.d.ts

@@ -0,0 +1,81 @@
+/** 弹窗与结果里点到的一个项目：旧宿主可以不给名字，界面用序号顶上，不露 projectId。 */
+interface UpgradeProjectRef {
+    name?: string | undefined;
+}
+declare const UPGRADE_TEXT: {
+    /** 落后但兼容：只提示。 */
+    readonly outdated: "项目有新版本可用。升级后页面会自动刷新。";
+    /** 不兼容：常显，写被挡。 */
+    readonly incompatible: (roles: readonly string[]) => string;
+    /** 部署回滚后，钉住的比本部署新。 */
+    readonly rolledBack: "本部署已回退，升级会换回本部署的版本";
+    readonly askAdmin: "请项目管理员升级";
+    readonly button: "升级";
+    readonly busy: "正在升级，完成后页面会自动刷新";
+    /** 按钮上的短词（`busy` 是整句，给横幅 / 读屏）。 */
+    readonly busyShort: "正在升级…";
+    readonly upgraded: "升级成功，正在刷新页面…";
+    /** 别人升级了、打开着的页面先落盘草稿再刷新。 */
+    readonly refreshingOthers: "这个项目刚升级了，正在保存你的草稿并刷新页面…";
+    /** 已登记的草稿或未保存内容阻止刷新时显示；旧项目首次升级前的旧组件可能尚未登记。`own` 是自己点的升级。 */
+    readonly refreshStuck: (own: boolean) => string;
+    readonly alreadyLatest: "已经是最新";
+    /** 实例钉点的阶段结构与当前版本不同，留在原版本；`n` 是几个实例。 */
+    readonly keptInstances: (n: number) => string;
+    /** 升级检查没过：哪个钉点、什么原因。 */
+    readonly checkFailed: (failures: readonly {
+        pin: string;
+        problems: readonly string[];
+    }[]) => string;
+    readonly noPermission: "没有升级的权限";
+    /** 工坊页。 */
+    readonly workshop: {
+        /** 落后的项目数：协作功能或本工坊自带的页面功能（工坊重新发布换了自己的插件）有新版本。 */
+        readonly outdatedProjects: (n: number) => string;
+        readonly incompatibleProjects: (n: number) => string;
+        readonly button: "更新本工坊全部项目";
+        readonly currentOutdated: "平台更新了协作功能，重新发布后，新项目才会用上";
+        /** 副本里自带的插件和原版某个共享版本内容一致：可以改成引用，之后跟着原版升级。只提示，不挡任何操作。 */
+        readonly referenceHint: {
+            readonly title: (n: number) => string;
+            /** `spec` 是该写进 `views.plugins` 的引用，如 `@teaching/wall@^1.0.0`。 */
+            readonly row: (name: string, version: string) => string;
+            readonly how: (specs: readonly string[]) => string;
+        };
+        /** 点按钮后的确认弹窗：改哪些项目、什么不变、哪些不动、能不能撤回，都说清楚。 */
+        readonly confirm: {
+            readonly title: "更新本工坊全部项目";
+            /** 会有变化的项目；名字都有时点名。 */
+            readonly willUpdate: (projects: readonly UpgradeProjectRef[]) => string;
+            readonly unchanged: "它们用的评论、批准、队列、版本切换和本工坊自带的页面功能会换成最新版；项目里的产物、意见和成员都不变。";
+            readonly checks: "升级后页面会自动刷新，聊天框草稿先保存。已升级到含未保存内容保护版本的项目，写着没法保存的内容时页面不会刷新，会提示先复制或提交，再点「刷新」。旧项目首次升级到该版本前，请先复制或提交评论、意见浮层和阶段参数表单里的内容。";
+            readonly archived: (n: number) => string;
+            /** 工坊里已经是最新、这次不会有变化的那些：写出来，免得「将更新 3 个」和这个工坊的项目数对不上。 */
+            readonly alreadyLatest: (n: number) => string;
+            readonly noUndo: "更新后不能撤回。";
+            readonly submit: "更新";
+            readonly busy: "正在更新…";
+        };
+        /** 结果四类，逐类一句；这一类为零时界面不写。 */
+        readonly result: {
+            /** `n` 是这一类有几个，`projects` 是有名字的那些（条数对不上时不点名）。 */
+            readonly upgraded: (n: number, projects: readonly UpgradeProjectRef[]) => string;
+            readonly current: (n: number) => string;
+            readonly archived: (n: number) => string;
+            /** 项目钉点换了，但有流程实例的阶段结构与当前版本不同、留在原版本；`n` 是实例数。 */
+            readonly keptInstances: (n: number) => string;
+            /** 没更新成的项目逐个点名带原因：检查没过的是哪些问题。 */
+            readonly failed: (projects: readonly {
+                name?: string | undefined;
+                problems: readonly string[];
+            }[]) => string;
+        };
+    };
+};
+/**
+ * 发起升级被拒的话：403 是没有升级的权限（服务端判，界面不另判）；检查没过（`UPGRADE_CHECK_FAILED`）写清哪个钉点、
+ * 什么原因；别的照 `failedBecause`。
+ */
+declare function upgradeErrorText(e: unknown): string;
+
+export { UPGRADE_TEXT, type UpgradeProjectRef, upgradeErrorText };

package/dist/upgrade-text.js

@@ -0,0 +1,9 @@
+import {
+  UPGRADE_TEXT,
+  upgradeErrorText
+} from "./chunk-X32B5VUS.js";
+import "./chunk-6VMUZ4PQ.js";
+export {
+  UPGRADE_TEXT,
+  upgradeErrorText
+};

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@kanyun-ai-infra/band-plugin-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2",
+  "description": "用 React 写 Band 插件的小工具：挂载、hooks、PromptInput 等共用组件",
+  "license": "UNLICENSED",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./components": {
+      "types": "./dist/components.d.ts",
+      "import": "./dist/components.js"
+    },
+    "./image-view": {
+      "types": "./dist/image-view.d.ts",
+      "import": "./dist/image-view.js"
+    },
+    "./scroll": {
+      "types": "./dist/scroll.d.ts",
+      "import": "./dist/scroll.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    },
+    "./first-delivery": {
+      "types": "./dist/first-delivery.d.ts",
+      "import": "./dist/first-delivery.js"
+    },
+    "./stopped-turn": {
+      "types": "./dist/stopped-turn.d.ts",
+      "import": "./dist/stopped-turn.js"
+    },
+    "./upgrade-text": {
+      "types": "./dist/upgrade-text.d.ts",
+      "import": "./dist/upgrade-text.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@kanyun-ai-infra/band-contracts": "^0.1.2",
+    "@kanyun-ai-infra/band-plugin-sdk": "^1.222.0",
+    "mdast-util-from-markdown": "^2.1.0",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-to-string": "^4.0.0",
+    "micromark-extension-gfm": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kanyun-ai-explore/band.git",
+    "directory": "packages/plugin-react"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.