@jc-times/business-ui 0.2.43 → 0.2.53

package/AGENTS.md

@@ -1,6 +1,6 @@
-# 公共组件维护入口
-
-- 开始组件使用、选型或修改前，先读 [Agent 使用指南](docs/agent-guide.md)，再按需读取 API 和专题文档。
-- 公共参数以当前源码和导出为准；消费项目以其安装版本的类型声明为准，不把本地新增能力当成已发布能力。
-- 新增或改变公共能力时，同步指南的场景选型、对应 API/专题和 package.json 发布文件清单。README 保持入口与导航，详细用法集中维护。
-- 通用交互、无障碍与响应式在本库实现；业务权限、接口、领域状态与文案由消费方组合。验证和发布遵循 docs/viewport-qa.md 与 docs/release.md。
+# 公共组件维护入口
+
+- 开始组件使用、选型或修改前，先读 [Agent 使用指南](docs/agent-guide.md)，再按需读取 API 和专题文档。
+- 公共参数以当前源码和导出为准；消费项目以其安装版本的类型声明为准，不把本地新增能力当成已发布能力。
+- 新增或改变公共能力时，同步指南的场景选型、对应 API/专题和 package.json 发布文件清单。README 保持入口与导航，详细用法集中维护。
+- 通用交互、无障碍与响应式在本库实现；业务权限、接口、领域状态与文案由消费方组合。验证和发布遵循 docs/viewport-qa.md 与 docs/release.md。

package/CHANGELOG.md

@@ -1,17 +1,40 @@
-# 0.2.43
-
-- 新增语义化 `LinkButton`，以真实链接承载导航和文件下载，并复用 Button 的变体、尺寸、图标无障碍和禁用样式。
-- 收紧 `LinkButton` 的必填 `href` 契约；禁用链接保留可访问语义并隔离父级点击，补充下载属性、可访问名称和真实浏览器下载回归。
-
-# 0.2.42
-
-- DataTable 新增可选底部吸附横向滚动条，在内容溢出时显示并与 MRT 原生滚动区双向同步；支持业务化无障碍名称，默认不改变既有表格布局。
-
-# 0.2.41
-
-- 修复高分屏上 PDFium 左侧缩略图按设备像素尺寸显示而被裁切的问题；缩略图按插件逻辑尺寸完整缩放并保持高清渲染。
-
-# 0.2.40
+# 0.2.53
+
+- 新增 `UserProfilePopover`：紧凑的人员标签和只读资料卡，支持姓名、编号、部门、身份标签、头像与受控打开状态；资料卡随视口在 300–560px 间缩放，并保留键盘关闭与焦点归还。
+
+## 0.2.51
+- Add MultilineAutoComplete: a single textarea with React Aria suggestions, explicit selection, free text and newlines. Preserves focus when choosing suggestions with mouse or touch.
+
+## 0.2.50
+- SortableList supports scoped transfers between nested lists, source placeholders and insertion highlights; consumers retain membership and order updates.
+- Fences stale/missing transfer items and resolves nested drop indicators to the unique current owner. Disabling drag remounts the React Aria grid to keep its hook topology stable.
+
+# 0.2.49
+
+- SortableList supports optional internal drop onto eligible items, with controlled domain callbacks and React Aria mouse, touch and keyboard behavior.
+
+# 0.2.47
+
+- 修复表格横向滚动同步条异步事件回写旧位置，避免中断触控板连续滚动；每帧最多同步一次，卸载时取消待执行同步。
+
+# 0.2.45
+
+- PDFium/Headless 正文和缩略图默认渲染 PDF 内已有批注（包括 Stamp 和 FreeText），修复审核文件签章提示缺失；不启用批注编辑，不改写源文件。
+
+# 0.2.43
+
+- 新增语义化 `LinkButton`，以真实链接承载导航和文件下载，并复用 Button 的变体、尺寸、图标无障碍和禁用样式。
+- 收紧 `LinkButton` 的必填 `href` 契约；禁用链接保留可访问语义并隔离父级点击，补充下载属性、可访问名称和真实浏览器下载回归。
+
+# 0.2.42
+
+- DataTable 新增可选底部吸附横向滚动条，在内容溢出时显示并与 MRT 原生滚动区双向同步；支持业务化无障碍名称，默认不改变既有表格布局。
+
+# 0.2.41
+
+- 修复高分屏上 PDFium 左侧缩略图按设备像素尺寸显示而被裁切的问题；缩略图按插件逻辑尺寸完整缩放并保持高清渲染。
+
+# 0.2.40
 
 - 公共 PDF 全屏在 Escape 时退出浏览器原生全屏，由 fullscreenchange 同步状态，避免退出按钮提前消失。
 
@@ -25,6 +48,11 @@
 
 # Changelog
 
+## 0.2.48
+
+- Cascader：按可见视口处理多列展开的边缘碰撞，修复右侧表单区县列超出屏幕的问题。
+- 回归：1280px 右侧340px表单旧逻辑浮层右边缘为1395px；修正后保持在1280px内。
+
 ## 0.2.37
 
 - Headless 新增可选 initialZoom="fit-width"，通过官方缩放插件适配窄屏；既有默认比例与受控 zoom 保持兼容。
@@ -265,3 +293,12 @@
 - Cascader 取消聚焦自动展开：标签点击和 Tab 只聚焦；保留点击、输入搜索与方向键展开。
 
 - StructuredAddressInput 默认取消地址类型，海外使用顶级地区；旧模式显式启用时复用公共 Select，不再手写原生 select。
+
+## 0.2.44 — 2026-09-14
+- PDFium 双指缩放使用统一引擎比例，修复松手边界回跳；增加 defaultRailCollapsed 侧栏初始配置。
+
+## 0.2.45 — 2026-09-14
+- 恢复官方低开销触控缩放；修复可见页码回传造成的跳页，触屏/滚轮预览和提交使用同一缩放边界。
+
+## 0.2.52
+- AutoComplete and Combobox accept grouped options with non-selectable, muted headings and preserve filtering and keyboard selection.

package/README.md

@@ -21,18 +21,18 @@ React 等 peer dependencies 按所安装版本的 package.json 配置。应用
 
 | 文档 | 用途 |
 | --- | --- |
-| [Agent 使用指南](docs/agent-guide.md) | 场景选型、组件组合、边界和接入检查 |
-| [依赖维护](docs/dependencies.md) | 稳定版本核查、兼容例外、消费迁移要求 |
-| [公共 API](docs/api.md) | 公共行为、参数说明、数字输入与装饰示例；完整签名见安装包类型声明 |
-| [DataTable 与 MRT 迁移](docs/data-table.md) | 公共表格替代、旧参数兼容、完整配置、独立入口与合并明细；0.2.31起提供 |
-| [表格能力与 MRT 样例](docs/mrt-poc.md) | DataTable边界、筛选/列管理、产品行合并/展开、配置及性能；包含业务样例与公共API边界 |
+| [Agent 使用指南](docs/agent-guide.md) | 场景选型、组件组合、边界和接入检查 |
+| [依赖维护](docs/dependencies.md) | 稳定版本核查、兼容例外、消费迁移要求 |
+| [公共 API](docs/api.md) | 公共行为、参数说明、数字输入与装饰示例；完整签名见安装包类型声明 |
+| [DataTable 与 MRT 迁移](docs/data-table.md) | 公共表格替代、旧参数兼容、完整配置、独立入口与合并明细；0.2.31起提供 |
+| [表格能力与 MRT 样例](docs/mrt-poc.md) | DataTable边界、筛选/列管理、产品行合并/展开、配置及性能；包含业务样例与公共API边界 |
 | [分段控制器](docs/api.md#分段控制器-segmentedcontrol) | 少量互斥选项、浅底/图标/纵向示例、兼容边界 |
 | [组件设计策略](docs/component-strategy.md) | 设计依据、公共能力范围和交互内核策略 |
 | [弹窗迁移](docs/modal-shell-migration.md) | header/content/footer 稳定插槽与历史写法迁移 |
 | [成熟度迁移](docs/maturity-migration.md) | 日期、多选、目录缓存、表格、文件限制及 Toast 行为 |
 | [上传前处理](docs/file-preparation.md) | 文件异步前处理、整批提交与取消 |
 | [文档查看器](docs/document-viewer.md) | PDF.js 与图片查看入口 |
-| [文档与图片查看器 V2](docs/document-viewer-v2.md) | PDFium/WASM、原生页面叠层、图片及 V1 兼容入口与迁移边界 |
+| [文档与图片查看器 V2](docs/document-viewer-v2.md) | PDFium/WASM、原生页面叠层、图片及 V1 兼容入口与迁移边界 |
 | [多视口验收](docs/viewport-qa.md) | 桌面、移动与交互验证 |
 | [发布流程](docs/release.md) | registry、版本、制品与发布检查 |
 | [变更记录](CHANGELOG.md) | 按版本查看变化 |
@@ -52,4 +52,4 @@ React 等 peer dependencies 按所安装版本的 package.json 配置。应用
 
 仓库通过 `v<package.version>` 标签触发受控发布。公共包本地验证、正式发布、消费应用升级和生产部署是不同状态，应分别验证和记录。
 
-- [通用级联选择与部门/地址适配](docs/cascader.md)
+- [通用级联选择与部门/地址适配](docs/cascader.md)

package/THIRD_PARTY_NOTICES.md

@@ -2,16 +2,16 @@
 
 `@jc-times/business-ui` 使用以下固定版本开源依赖。依赖源码未复制到本仓库；最终安装包由包管理器连同各自许可证一并解析。
 
-| Package | Version | License | Project |
-| --- | --- | --- | --- |
-| `lucide-react` | 1.45.0（开发验证版本） | ISC | https://github.com/lucide-icons/lucide |
-| `pdfjs-dist` | 6.3.289 | Apache-2.0 | https://github.com/mozilla/pdf.js |
-| `material-react-table` | 3.2.1 | MIT | https://github.com/KevinVandy/material-react-table |
-| `@mui/material`, `@mui/icons-material` | 7.3.11 | MIT | https://github.com/mui/material-ui |
-| `@mui/x-date-pickers` | 9.13.0 | MIT | https://github.com/mui/mui-x |
-| `@emotion/react`, `@emotion/styled` | 11.14.0 / 11.14.1 | MIT | https://github.com/emotion-js/emotion |
-| `@embedpdf/react-pdf-viewer` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
-| `@embedpdf/core`, `@embedpdf/engines`, `@embedpdf/plugin-document-manager`, `@embedpdf/plugin-viewport`, `@embedpdf/plugin-scroll`, `@embedpdf/plugin-render`, `@embedpdf/plugin-zoom`, `@embedpdf/plugin-rotate`, `@embedpdf/plugin-thumbnail` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
+| Package | Version | License | Project |
+| --- | --- | --- | --- |
+| `lucide-react` | 1.45.0（开发验证版本） | ISC | https://github.com/lucide-icons/lucide |
+| `pdfjs-dist` | 6.3.289 | Apache-2.0 | https://github.com/mozilla/pdf.js |
+| `material-react-table` | 3.2.1 | MIT | https://github.com/KevinVandy/material-react-table |
+| `@mui/material`, `@mui/icons-material` | 7.3.11 | MIT | https://github.com/mui/material-ui |
+| `@mui/x-date-pickers` | 9.13.0 | MIT | https://github.com/mui/mui-x |
+| `@emotion/react`, `@emotion/styled` | 11.14.0 / 11.14.1 | MIT | https://github.com/emotion-js/emotion |
+| `@embedpdf/react-pdf-viewer` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
+| `@embedpdf/core`, `@embedpdf/engines`, `@embedpdf/plugin-document-manager`, `@embedpdf/plugin-viewport`, `@embedpdf/plugin-scroll`, `@embedpdf/plugin-render`, `@embedpdf/plugin-zoom`, `@embedpdf/plugin-rotate`, `@embedpdf/plugin-thumbnail` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
 | PDFium（由 `@embedpdf/pdfium` 随查看器分发） | 2.15.0 | BSD-3-Clause / Apache-2.0 等，详见依赖内 `LICENSE.pdfium` | https://pdfium.googlesource.com/pdfium/ |
 | `@radix-ui/react-popover` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
 | `@radix-ui/react-dialog` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
@@ -27,3 +27,5 @@
 ## @rc-component/cascader 1.25.0
 
 MIT, Copyright (c) 2019-present react-component. Source: https://github.com/react-component/cascader. Used as the external Cascader interaction dependency; license reproduced in licenses/rc-cascader-MIT.txt. Transitive dependencies retain their own notices in their installed packages.
+
+0.2.46 additionally bundles the React gesture entry of @embedpdf/plugin-zoom@2.15.0 with a pinned bounds/precision patch. Original MIT license: licenses/embedpdf-MIT.txt; patch: patches/@embedpdf__plugin-zoom@2.15.0.patch. Engine and core plugin implementations remain external.

package/dist/Cascader.js

@@ -53,6 +53,14 @@ function m(m) {
 		displayRender: (e) => e.join(" / "),
 		getPopupContainer: (e) => x instanceof HTMLElement ? x : e.ownerDocument.body,
 		popupMatchSelectWidth: !1,
+		popupAlign: {
+			htmlRegion: "visible",
+			overflow: {
+				adjustX: 1,
+				adjustY: 1,
+				shiftX: !0
+			}
+		},
 		components: { input: /* @__PURE__ */ d("input", {
 			...S,
 			ref: O,

package/dist/Combobox.js

@@ -1,106 +1,149 @@
 import { useOverlayContainer as e } from "./OverlayContainer.js";
 import { Check as t, ChevronDown as n, LoaderCircle as r } from "lucide-react";
-import { useId as i, useMemo as a } from "react";
-import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
-import { Button as l, ComboBox as u, Input as d, Label as f, ListBox as p, ListBoxItem as m, Popover as h, Text as g } from "react-aria-components";
-import { ListLayout as _, Virtualizer as v } from "react-aria-components/Virtualizer";
+import { useContext as i, useEffect as a, useId as o, useMemo as s, useRef as c } from "react";
+import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
+import { Button as f, Collection as p, ComboBox as m, ComboBoxStateContext as h, Header as g, Input as _, Label as v, ListBox as y, ListBoxItem as b, ListBoxSection as x, Popover as S, Text as C } from "react-aria-components";
+import { ListLayout as w, Virtualizer as T } from "react-aria-components/Virtualizer";
 //#region src/Combobox.tsx
-var y = {
+var E = {
 	rowSize: 48,
 	gap: 2,
 	padding: 4
 };
-function b({ items: b, label: x, placeholder: S = "搜索或选择", inputValue: C, defaultInputValue: w, selectedKey: T, defaultSelectedKey: E, onInputChange: D, onSelectionChange: O, loading: k = !1, disabled: A = !1, required: j = !1, allowsCustomValue: M = !1, emptyText: N = "没有匹配项", helpText: P, error: F, virtualized: I = b.length > 100, className: L = "", inputRef: R, inputProps: z, placement: B = "bottom start", portalContainer: V }) {
-	let H = `ui-combobox-${i().replaceAll(":", "")}`, U = e(V), W = a(() => Array.from(b), [b]), G = /* @__PURE__ */ s(p, {
+function D({ items: i, label: a, placeholder: c = "搜索或选择", inputValue: h, defaultInputValue: D, selectedKey: k, defaultSelectedKey: A, onInputChange: j, onSelectionChange: M, loading: N = !1, disabled: P = !1, required: F = !1, allowsCustomValue: I = !1, emptyText: L = "没有匹配项", helpText: R, error: z, virtualized: B = i.length > 100, className: V = "", inputRef: H, inputProps: U, placement: W = "bottom start", portalContainer: G }) {
+	let K = `ui-combobox-${o().replaceAll(":", "")}`, q = e(G), J = s(() => Array.from(i), [i]), Y = s(() => {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of J) {
+			let n = t.group ?? "";
+			e.has(n) || e.set(n, {
+				id: `group:${n}`,
+				label: n,
+				items: []
+			}), e.get(n).items.push(t);
+		}
+		return Array.from(e.values());
+	}, [J]), X = J.some((e) => e.group !== void 0), Z = (e) => /* @__PURE__ */ u(b, {
+		id: e.id,
+		textValue: e.label,
+		isDisabled: e.disabled,
+		className: "ui-combobox-item",
+		children: ({ isSelected: n }) => /* @__PURE__ */ d(l, { children: [/* @__PURE__ */ d("span", { children: [/* @__PURE__ */ u("strong", { children: e.label }), e.description && /* @__PURE__ */ u("small", { children: e.description })] }), n && /* @__PURE__ */ u(t, {
+			size: 15,
+			"aria-hidden": "true"
+		})] })
+	}), Q = () => /* @__PURE__ */ u("div", {
+		className: "ui-combobox-empty",
+		children: N ? "正在加载…" : L
+	}), $ = X ? /* @__PURE__ */ u(y, {
 		className: "ui-combobox-list",
-		items: W,
-		layout: I ? "grid" : "stack",
-		renderEmptyState: () => /* @__PURE__ */ s("div", {
-			className: "ui-combobox-empty",
-			children: k ? "正在加载…" : N
-		}),
-		children: (e) => /* @__PURE__ */ s(m, {
+		items: Y,
+		layout: "stack",
+		renderEmptyState: Q,
+		children: (e) => /* @__PURE__ */ d(x, {
 			id: e.id,
-			textValue: e.label,
-			isDisabled: e.disabled,
-			className: "ui-combobox-item",
-			children: ({ isSelected: n }) => /* @__PURE__ */ c(o, { children: [/* @__PURE__ */ c("span", { children: [/* @__PURE__ */ s("strong", { children: e.label }), e.description && /* @__PURE__ */ s("small", { children: e.description })] }), n && /* @__PURE__ */ s(t, {
-				size: 15,
-				"aria-hidden": "true"
-			})] })
+			"aria-label": e.label || "选项",
+			children: [e.label && /* @__PURE__ */ u(g, {
+				className: "ui-combobox-group-heading",
+				children: e.label
+			}), /* @__PURE__ */ u(p, {
+				items: e.items,
+				children: Z
+			})]
 		})
+	}) : /* @__PURE__ */ u(y, {
+		className: "ui-combobox-list",
+		items: J,
+		layout: B ? "grid" : "stack",
+		renderEmptyState: Q,
+		children: Z
 	});
-	return /* @__PURE__ */ c(u, {
-		className: `ui-combobox ${L}`.trim(),
-		inputValue: C,
-		defaultInputValue: w,
-		selectedKey: T,
-		defaultSelectedKey: E,
-		onInputChange: D,
-		onSelectionChange: (e) => O?.(e === null ? null : String(e)),
-		isDisabled: A,
-		isRequired: j,
-		allowsCustomValue: M,
+	return /* @__PURE__ */ d(m, {
+		items: J,
+		className: `ui-combobox ${V}`.trim(),
+		inputValue: h,
+		defaultInputValue: D,
+		selectedKey: k,
+		defaultSelectedKey: A,
+		onInputChange: j,
+		onSelectionChange: (e) => M?.(e === null ? null : String(e)),
+		isDisabled: P,
+		isRequired: F,
+		allowsCustomValue: I,
 		menuTrigger: "focus",
-		"aria-label": x === void 0 ? z?.["aria-label"] : void 0,
-		"aria-labelledby": x === void 0 ? z?.["aria-labelledby"] : void 0,
+		"aria-label": a === void 0 ? U?.["aria-label"] : void 0,
+		"aria-labelledby": a === void 0 ? U?.["aria-labelledby"] : void 0,
 		children: [
-			x === void 0 ? null : /* @__PURE__ */ c(f, {
+			a === void 0 ? null : /* @__PURE__ */ d(v, {
 				className: "ui-form-label",
-				children: [x, j && /* @__PURE__ */ s("span", {
+				children: [a, F && /* @__PURE__ */ u("span", {
 					className: "ui-form-required",
 					"aria-hidden": "true",
 					children: "*"
 				})]
 			}),
-			/* @__PURE__ */ c("div", {
+			I && /* @__PURE__ */ u(O, {
+				count: J.length,
+				loading: N
+			}),
+			/* @__PURE__ */ d("div", {
 				className: "ui-combobox-control",
-				children: [/* @__PURE__ */ s(d, {
-					...z,
-					ref: R,
-					id: H,
+				children: [/* @__PURE__ */ u(_, {
+					...U,
+					ref: H,
+					id: K,
 					className: "ui-input",
-					placeholder: S,
-					"aria-invalid": F ? !0 : z?.["aria-invalid"]
-				}), /* @__PURE__ */ s(l, {
+					placeholder: c,
+					"aria-invalid": z ? !0 : U?.["aria-invalid"]
+				}), /* @__PURE__ */ u(f, {
 					className: "ui-combobox-trigger",
 					"aria-label": "展开选项",
-					children: k ? /* @__PURE__ */ s(r, {
+					children: N ? /* @__PURE__ */ u(r, {
 						className: "spin",
 						size: 16
-					}) : /* @__PURE__ */ s(n, { size: 16 })
+					}) : /* @__PURE__ */ u(n, { size: 16 })
 				})]
 			}),
-			P === void 0 ? null : /* @__PURE__ */ s(g, {
+			R === void 0 ? null : /* @__PURE__ */ u(C, {
 				slot: "description",
 				className: "ui-form-help",
-				children: P
+				children: R
 			}),
-			F === void 0 || F === "" ? null : /* @__PURE__ */ s(g, {
+			z === void 0 || z === "" ? null : /* @__PURE__ */ u(C, {
 				slot: "errorMessage",
 				className: "ui-form-error",
-				children: F
+				children: z
 			}),
-			/* @__PURE__ */ c(h, {
+			/* @__PURE__ */ d(S, {
 				className: "ui-combobox-popover",
 				"data-ui-aria-overlay": "",
 				maxHeight: 320,
-				placement: B,
-				UNSTABLE_portalContainer: U,
-				children: [k && /* @__PURE__ */ c("div", {
+				placement: W,
+				UNSTABLE_portalContainer: q,
+				children: [N && /* @__PURE__ */ d("div", {
 					className: "ui-combobox-loading",
-					children: [/* @__PURE__ */ s(r, {
+					children: [/* @__PURE__ */ u(r, {
 						className: "spin",
 						size: 15
 					}), "正在加载"]
-				}), I ? /* @__PURE__ */ s(v, {
-					layout: _,
-					layoutOptions: y,
-					children: G
-				}) : G]
+				}), B ? /* @__PURE__ */ u(T, {
+					layout: w,
+					layoutOptions: E,
+					children: $
+				}) : $]
 			})
 		]
 	});
 }
+function O({ count: e, loading: t }) {
+	let n = i(h), r = c(n);
+	return r.current = n, a(() => {
+		let n = r.current;
+		e && !t && n?.isFocused && !n.isOpen && n.open(null, "manual");
+	}, [
+		e,
+		t,
+		n?.collection.size
+	]), null;
+}
 //#endregion
-export { b as Combobox };
+export { D as Combobox };

package/dist/DataTableHorizontalScrollbar.js

@@ -7,18 +7,21 @@ function a({ children: a, enabled: o = !1, label: s = "表格横向滚动" }) {
 		if (!o) return;
 		let e = c.current, t = l.current, n = e?.querySelector(".MuiTableContainer-root"), r = n?.querySelector("table");
 		if (!e || !t || !n || !r) return;
-		let i = !1, a = () => {
+		let i = /* @__PURE__ */ new WeakMap(), a, s, u = (e, t) => {
+			t.scrollLeft !== e.scrollLeft && (t.scrollLeft = e.scrollLeft, i.set(t, t.scrollLeft));
+		}, f = (e) => {
+			let r = e === n ? t : n;
+			i.get(e) !== e.scrollLeft && r.scrollLeft !== e.scrollLeft && (i.delete(e), s = e, a === void 0 && (a = requestAnimationFrame(() => {
+				a = void 0, s && u(s, s === n ? t : n);
+			})));
+		}, p = () => {
 			let e = n.scrollWidth > n.clientWidth + 1;
-			d(e ? n.scrollWidth : 0), e && (t.scrollLeft = n.scrollLeft);
-		}, s = () => {
-			i ||= (i = !0, n.scrollLeft = t.scrollLeft, !1);
-		}, u = () => {
-			i ||= (i = !0, t.scrollLeft = n.scrollLeft, !1);
-		};
-		a();
-		let f = typeof ResizeObserver > "u" ? null : new ResizeObserver(a);
-		return f?.observe(n), f?.observe(r), t.addEventListener("scroll", s, { passive: !0 }), n.addEventListener("scroll", u, { passive: !0 }), () => {
-			f?.disconnect(), t.removeEventListener("scroll", s), n.removeEventListener("scroll", u);
+			d(e ? n.scrollWidth : 0), e && u(n, t);
+		}, m = () => f(t), h = () => f(n);
+		p();
+		let g = typeof ResizeObserver > "u" ? null : new ResizeObserver(p);
+		return g?.observe(n), g?.observe(r), t.addEventListener("scroll", m, { passive: !0 }), n.addEventListener("scroll", h, { passive: !0 }), () => {
+			g?.disconnect(), a !== void 0 && cancelAnimationFrame(a), t.removeEventListener("scroll", m), n.removeEventListener("scroll", h);
 		};
 	}, [o]), o ? /* @__PURE__ */ i("div", {
 		ref: c,

package/dist/FloatingControls.js

@@ -30,34 +30,35 @@ function l({ children: e, content: n, side: r = "top", delayDuration: i = 450, d
 		})] })
 	});
 }
-function u({ trigger: e, children: i, title: c, closeLabel: l = "关闭", side: u = "bottom", align: d = "start", open: f, defaultOpen: p, modal: m = !1, onOpenChange: h, contentClassName: g = "" }) {
-	let _ = t(), v = `ui-popover-title-${r().replaceAll(":", "")}`;
+function u({ trigger: e, children: i, title: c, contentLabel: l, closeLabel: u = "关闭", side: d = "bottom", align: f = "start", open: p, defaultOpen: m, modal: h = !1, onOpenChange: g, contentClassName: _ = "" }) {
+	let v = t(), y = `ui-popover-title-${r().replaceAll(":", "")}`;
 	return /* @__PURE__ */ o(s.Root, {
-		open: f,
-		defaultOpen: p,
-		modal: m,
-		onOpenChange: h,
+		open: p,
+		defaultOpen: m,
+		modal: h,
+		onOpenChange: g,
 		children: [/* @__PURE__ */ a(s.Trigger, {
 			asChild: !0,
 			children: e
 		}), /* @__PURE__ */ a(s.Portal, {
-			container: _,
+			container: v,
 			children: /* @__PURE__ */ o(s.Content, {
-				className: `ui-popover ${g}`.trim(),
-				side: u,
-				align: d,
+				className: `ui-popover ${_}`.trim(),
+				side: d,
+				align: f,
 				sideOffset: 8,
 				collisionPadding: 12,
-				"aria-labelledby": c === void 0 ? void 0 : v,
+				"aria-label": l,
+				"aria-labelledby": c === void 0 ? void 0 : y,
 				children: [
 					c === void 0 ? null : /* @__PURE__ */ o("div", {
 						className: "ui-popover-heading",
 						children: [/* @__PURE__ */ a("strong", {
-							id: v,
+							id: y,
 							children: c
 						}), /* @__PURE__ */ a(s.Close, {
 							className: "ui-floating-close",
-							"aria-label": l,
+							"aria-label": u,
 							children: /* @__PURE__ */ a(n, { size: 16 })
 						})]
 					}),

package/dist/MultilineAutoComplete.js

@@ -0,0 +1,80 @@
+import { useOverlayContainer as e } from "./OverlayContainer.js";
+import { useRef as t, useState as n } from "react";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+import { Autocomplete as a, Label as o, ListBox as s, ListBoxItem as c, Popover as l, TextArea as u, TextField as d } from "react-aria-components";
+//#region src/MultilineAutoComplete.tsx
+function f(f) {
+	let p = t(null), m = t(null), [h, g] = n(!1), [_, v] = n(!1), y = e(f.portalContainer), b = f.items.filter((e) => e.label.toLocaleLowerCase().includes(f.value.toLocaleLowerCase()));
+	return /* @__PURE__ */ i("div", {
+		className: `ui-multiline-autocomplete ${f.className ?? ""}`,
+		children: [
+			/* @__PURE__ */ i(a, {
+				disableAutoFocusFirst: !0,
+				inputValue: f.value,
+				onInputChange: (e) => {
+					v(!1), f.onChange(e);
+				},
+				children: [/* @__PURE__ */ i(d, {
+					"aria-label": f["aria-label"],
+					isDisabled: f.disabled,
+					onFocus: () => {
+						g(!0), v(!1), f.onFocus?.();
+					},
+					onBlur: (e) => {
+						m.current?.contains(e.relatedTarget) || (g(!1), f.onBlur?.());
+					},
+					children: [f.label !== void 0 && /* @__PURE__ */ r(o, {
+						className: "ui-form-label",
+						children: f.label
+					}), /* @__PURE__ */ r(u, {
+						ref: p,
+						className: "ui-input ui-multiline-input",
+						placeholder: f.placeholder,
+						rows: Math.min(6, f.value.split("\n").length)
+					})]
+				}), /* @__PURE__ */ r(l, {
+					ref: m,
+					triggerRef: p,
+					isNonModal: !0,
+					isOpen: h && !_ && !f.disabled && b.length > 0,
+					onOpenChange: (e) => {
+						e || v(!0);
+					},
+					UNSTABLE_portalContainer: y,
+					placement: "bottom start",
+					className: "ui-combobox-popover",
+					"data-ui-aria-overlay": "",
+					maxHeight: 260,
+					children: /* @__PURE__ */ r(s, {
+						"aria-label": "输入建议",
+						className: "ui-combobox-list",
+						items: b,
+						selectionMode: "none",
+						onAction: (e) => {
+							let t = b.find((t) => t.id === String(e));
+							t && !t.disabled && (f.onChange(t.label), f.onSelect?.(t), v(!0), p.current?.focus());
+						},
+						children: (e) => /* @__PURE__ */ r(c, {
+							id: e.id,
+							textValue: e.label,
+							isDisabled: e.disabled,
+							className: "ui-combobox-item",
+							children: /* @__PURE__ */ i("span", { children: [/* @__PURE__ */ r("strong", { children: e.label }), e.description && /* @__PURE__ */ r("small", { children: e.description })] })
+						})
+					})
+				})]
+			}),
+			f.loading && /* @__PURE__ */ r("span", {
+				role: "status",
+				className: "ui-form-help",
+				children: "正在查找…"
+			}),
+			f.helpText && /* @__PURE__ */ r("span", {
+				className: "ui-form-help",
+				children: f.helpText
+			})
+		]
+	});
+}
+//#endregion
+export { f as MultilineAutoComplete };