@greypan/web-ui 11.1.0 → 12.0.0

package/dist/shared/focus/pointer-focus.js

@@ -1,39 +1,65 @@
-//#region src/shared/focus/pointer-focus.ts
-var e = !1, t = 0, n = !1;
-function r() {
-	n = !0, t = Date.now();
+// src/shared/focus/pointer-focus.ts
+/**
+* 指针输入期间的 focus ring 抑制。
+*
+* Safari 等浏览器在 pointer 点击后仍可能让 `:focus-visible` 命中新聚焦元素，
+* 导致点击打开 drawer/dialog 时内部 button 自动出现 focus ring。这里记录最近一次
+* 指针输入，并在 focusin 时给聚焦元素打 `data-wui-pointer-focus` 标记；组件样式
+* 用该标记将 focus ring 透明化，键盘导航（Tab/方向键等）会清除标记并恢复可见。
+*/
+const POINTER_FOCUS_WINDOW_MS = 1e3;
+let installed = false;
+let lastPointerAt = 0;
+let pointerActive = false;
+function markPointer() {
+	pointerActive = true;
+	lastPointerAt = Date.now();
 }
-function i() {
-	n = !1, t = 0;
+function markKeyboard() {
+	pointerActive = false;
+	lastPointerAt = 0;
 }
-function a() {
-	r();
+function onPointerDown() {
+	markPointer();
 }
-function o(e) {
-	if (!e) return;
-	e.removeAttribute("data-wui-pointer-focus");
-	let t = e.getRootNode();
-	t instanceof ShadowRoot && t.host instanceof HTMLElement && t.host.removeAttribute("data-wui-pointer-focus");
+function clearPointerFocusMark(target) {
+	if (!target) return;
+	target.removeAttribute("data-wui-pointer-focus");
+	const root = target.getRootNode();
+	if (root instanceof ShadowRoot && root.host instanceof HTMLElement) root.host.removeAttribute("data-wui-pointer-focus");
 }
-function s(e) {
-	(e.key === "Tab" || e.key.startsWith("Arrow") || e.key === "Enter" || e.key === " " || e.key === "Home" || e.key === "End" || e.key === "PageUp" || e.key === "PageDown") && (i(), o(document.activeElement));
-}
-function c(e) {
-	let r = e.target;
-	if (r instanceof HTMLElement) {
-		if (n && Date.now() - t <= 1e3) {
-			r.dataset.wuiPointerFocus = "true";
-			let e = r.getRootNode();
-			e instanceof ShadowRoot && e.host instanceof HTMLElement && (e.host.dataset.wuiPointerFocus = "true");
-		} else o(r);
+function onKeyDown(event) {
+	if (event.key === "Tab" || event.key.startsWith("Arrow") || event.key === "Enter" || event.key === " " || event.key === "Home" || event.key === "End" || event.key === "PageUp" || event.key === "PageDown") {
+		markKeyboard();
+		clearPointerFocusMark(document.activeElement);
 	}
 }
-function l() {
-	return typeof window > "u" || typeof document > "u" || e ? () => {} : (e = !0, document.addEventListener("pointerdown", a, !0), document.addEventListener("keydown", s, !0), document.addEventListener("focusin", c, !0), () => {
-		e = !1, document.removeEventListener("pointerdown", a, !0), document.removeEventListener("keydown", s, !0), document.removeEventListener("focusin", c, !0);
-	});
+function onFocusIn(event) {
+	const target = event.target;
+	if (!(target instanceof HTMLElement)) return;
+	if (pointerActive && Date.now() - lastPointerAt <= POINTER_FOCUS_WINDOW_MS) {
+		target.dataset.wuiPointerFocus = "true";
+		const root = target.getRootNode();
+		if (root instanceof ShadowRoot && root.host instanceof HTMLElement) root.host.dataset.wuiPointerFocus = "true";
+	} else clearPointerFocusMark(target);
+}
+/**
+* 安装一次全局 pointer/keyboard/focus 监听。重复调用幂等。
+*/
+function installPointerFocusSuppression() {
+	if (typeof window === "undefined" || typeof document === "undefined") return () => {};
+	if (installed) return () => {};
+	installed = true;
+	document.addEventListener("pointerdown", onPointerDown, true);
+	document.addEventListener("keydown", onKeyDown, true);
+	document.addEventListener("focusin", onFocusIn, true);
+	return () => {
+		installed = false;
+		document.removeEventListener("pointerdown", onPointerDown, true);
+		document.removeEventListener("keydown", onKeyDown, true);
+		document.removeEventListener("focusin", onFocusIn, true);
+	};
 }
-//#endregion
-export { l as installPointerFocusSuppression };
+export { installPointerFocusSuppression };
 
 //# sourceMappingURL=pointer-focus.js.map

package/dist/shared/focus/pointer-focus.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-focus.js","names":[],"sources":["../../../src/shared/focus/pointer-focus.ts"],"sourcesContent":["/**\n * 指针输入期间的 focus ring 抑制。\n *\n * Safari 等浏览器在 pointer 点击后仍可能让 `:focus-visible` 命中新聚焦元素，\n * 导致点击打开 drawer/dialog 时内部 button 自动出现 focus ring。这里记录最近一次\n * 指针输入，并在 focusin 时给聚焦元素打 `data-wui-pointer-focus` 标记；组件样式\n * 用该标记将 focus ring 透明化，键盘导航（Tab/方向键等）会清除标记并恢复可见。\n */\n\nconst POINTER_FOCUS_WINDOW_MS = 1000\n\nlet installed = false\nlet lastPointerAt = 0\nlet pointerActive = false\n\nfunction markPointer() {\n  pointerActive = true\n  lastPointerAt = Date.now()\n}\n\nfunction markKeyboard() {\n  pointerActive = false\n  lastPointerAt = 0\n}\n\nfunction onPointerDown() {\n  markPointer()\n}\n\nfunction clearPointerFocusMark(target: Element | null) {\n  if (!target) return\n\n  target.removeAttribute('data-wui-pointer-focus')\n  const root = target.getRootNode()\n  if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\n    root.host.removeAttribute('data-wui-pointer-focus')\n  }\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (\n    event.key === 'Tab' ||\n    event.key.startsWith('Arrow') ||\n    event.key === 'Enter' ||\n    event.key === ' ' ||\n    event.key === 'Home' ||\n    event.key === 'End' ||\n    event.key === 'PageUp' ||\n    event.key === 'PageDown'\n  ) {\n    markKeyboard()\n    clearPointerFocusMark(document.activeElement)\n  }\n}\n\nfunction onFocusIn(event: FocusEvent) {\n  const target = event.target\n  if (!(target instanceof HTMLElement)) return\n\n  if (pointerActive && Date.now() - lastPointerAt <= POINTER_FOCUS_WINDOW_MS) {\n    target.dataset.wuiPointerFocus = 'true'\n    const root = target.getRootNode()\n    if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\n      root.host.dataset.wuiPointerFocus = 'true'\n    }\n  } else {\n    clearPointerFocusMark(target)\n  }\n}\n\n/**\n * 安装一次全局 pointer/keyboard/focus 监听。重复调用幂等。\n */\nexport function installPointerFocusSuppression(): () => void {\n  if (typeof window === 'undefined' || typeof document === 'undefined') return () => {}\n  if (installed) return () => {}\n  installed = true\n\n  // 只用 document 一份 capture 监听：shadow DOM 内的 pointerdown/keydown/focusin\n  // 都会 composed 冒泡到 document，避免 window/document 双份导致同一事件处理两次。\n  document.addEventListener('pointerdown', onPointerDown, true)\n  document.addEventListener('keydown', onKeyDown, true)\n  document.addEventListener('focusin', onFocusIn, true)\n\n  return () => {\n    installed = false\n    document.removeEventListener('pointerdown', onPointerDown, true)\n    document.removeEventListener('keydown', onKeyDown, true)\n    document.removeEventListener('focusin', onFocusIn, true)\n  }\n}\n\n/**\n * 测试辅助：清除指针输入状态，避免用例间泄漏。\n */\nexport function resetPointerFocusState(): void {\n  markKeyboard()\n}\n"],"mappings":";AASA,IAEI,IAAY,IACZ,IAAgB,GAChB,IAAgB;AAEpB,SAAS,IAAc;CAErB,AADA,IAAgB,IAChB,IAAgB,KAAK,IAAI;AAC3B;AAEA,SAAS,IAAe;CAEtB,AADA,IAAgB,IAChB,IAAgB;AAClB;AAEA,SAAS,IAAgB;CACvB,EAAY;AACd;AAEA,SAAS,EAAsB,GAAwB;CACrD,IAAI,CAAC,GAAQ;CAEb,EAAO,gBAAgB,wBAAwB;CAC/C,IAAM,IAAO,EAAO,YAAY;CAChC,AAAI,aAAgB,cAAc,EAAK,gBAAgB,eACrD,EAAK,KAAK,gBAAgB,wBAAwB;AAEtD;AAEA,SAAS,EAAU,GAAsB;CACvC,CACE,EAAM,QAAQ,SACd,EAAM,IAAI,WAAW,OAAO,KAC5B,EAAM,QAAQ,WACd,EAAM,QAAQ,OACd,EAAM,QAAQ,UACd,EAAM,QAAQ,SACd,EAAM,QAAQ,YACd,EAAM,QAAQ,gBAEd,EAAa,GACb,EAAsB,SAAS,aAAa;AAEhD;AAEA,SAAS,EAAU,GAAmB;CACpC,IAAM,IAAS,EAAM;CACf,iBAAkB,aAExB;MAAI,KAAiB,KAAK,IAAI,IAAI,KAAiB,KAAyB;GAC1E,EAAO,QAAQ,kBAAkB;GACjC,IAAM,IAAO,EAAO,YAAY;GAChC,AAAI,aAAgB,cAAc,EAAK,gBAAgB,gBACrD,EAAK,KAAK,QAAQ,kBAAkB;EAExC,OACE,EAAsB,CAAM;CAAA;AAEhC;AAKA,SAAgB,IAA6C;CAW3D,OAVI,OAAO,SAAW,OAAe,OAAO,WAAa,OACrD,UAAwB,CAAC,KAC7B,IAAY,IAIZ,SAAS,iBAAiB,eAAe,GAAe,EAAI,GAC5D,SAAS,iBAAiB,WAAW,GAAW,EAAI,GACpD,SAAS,iBAAiB,WAAW,GAAW,EAAI,SAEvC;EAIX,AAHA,IAAY,IACZ,SAAS,oBAAoB,eAAe,GAAe,EAAI,GAC/D,SAAS,oBAAoB,WAAW,GAAW,EAAI,GACvD,SAAS,oBAAoB,WAAW,GAAW,EAAI;CACzD;AACF"}
+{"version":3,"file":"pointer-focus.js","names":[],"sources":["../../../src/shared/focus/pointer-focus.ts"],"sourcesContent":["/**\n * 指针输入期间的 focus ring 抑制。\n *\n * Safari 等浏览器在 pointer 点击后仍可能让 `:focus-visible` 命中新聚焦元素，\n * 导致点击打开 drawer/dialog 时内部 button 自动出现 focus ring。这里记录最近一次\n * 指针输入，并在 focusin 时给聚焦元素打 `data-wui-pointer-focus` 标记；组件样式\n * 用该标记将 focus ring 透明化，键盘导航（Tab/方向键等）会清除标记并恢复可见。\n */\n\nconst POINTER_FOCUS_WINDOW_MS = 1000\n\nlet installed = false\nlet lastPointerAt = 0\nlet pointerActive = false\n\nfunction markPointer() {\n  pointerActive = true\n  lastPointerAt = Date.now()\n}\n\nfunction markKeyboard() {\n  pointerActive = false\n  lastPointerAt = 0\n}\n\nfunction onPointerDown() {\n  markPointer()\n}\n\nfunction clearPointerFocusMark(target: Element | null) {\n  if (!target) return\n\n  target.removeAttribute('data-wui-pointer-focus')\n  const root = target.getRootNode()\n  if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\n    root.host.removeAttribute('data-wui-pointer-focus')\n  }\n}\n\nfunction onKeyDown(event: KeyboardEvent) {\n  if (\n    event.key === 'Tab' ||\n    event.key.startsWith('Arrow') ||\n    event.key === 'Enter' ||\n    event.key === ' ' ||\n    event.key === 'Home' ||\n    event.key === 'End' ||\n    event.key === 'PageUp' ||\n    event.key === 'PageDown'\n  ) {\n    markKeyboard()\n    clearPointerFocusMark(document.activeElement)\n  }\n}\n\nfunction onFocusIn(event: FocusEvent) {\n  const target = event.target\n  if (!(target instanceof HTMLElement)) return\n\n  if (pointerActive && Date.now() - lastPointerAt <= POINTER_FOCUS_WINDOW_MS) {\n    target.dataset.wuiPointerFocus = 'true'\n    const root = target.getRootNode()\n    if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\n      root.host.dataset.wuiPointerFocus = 'true'\n    }\n  } else {\n    clearPointerFocusMark(target)\n  }\n}\n\n/**\n * 安装一次全局 pointer/keyboard/focus 监听。重复调用幂等。\n */\nexport function installPointerFocusSuppression(): () => void {\n  if (typeof window === 'undefined' || typeof document === 'undefined') return () => {}\n  if (installed) return () => {}\n  installed = true\n\n  // 只用 document 一份 capture 监听：shadow DOM 内的 pointerdown/keydown/focusin\n  // 都会 composed 冒泡到 document，避免 window/document 双份导致同一事件处理两次。\n  document.addEventListener('pointerdown', onPointerDown, true)\n  document.addEventListener('keydown', onKeyDown, true)\n  document.addEventListener('focusin', onFocusIn, true)\n\n  return () => {\n    installed = false\n    document.removeEventListener('pointerdown', onPointerDown, true)\n    document.removeEventListener('keydown', onKeyDown, true)\n    document.removeEventListener('focusin', onFocusIn, true)\n  }\n}\n\n/**\n * 测试辅助：清除指针输入状态，避免用例间泄漏。\n */\nexport function resetPointerFocusState(): void {\n  markKeyboard()\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,0BAA0B;AAEhC,IAAI,YAAY;AAChB,IAAI,gBAAgB;AACpB,IAAI,gBAAgB;AAEpB,SAAS,cAAc;CACrB,gBAAgB;CAChB,gBAAgB,KAAK,IAAI;AAC3B;AAEA,SAAS,eAAe;CACtB,gBAAgB;CAChB,gBAAgB;AAClB;AAEA,SAAS,gBAAgB;CACvB,YAAY;AACd;AAEA,SAAS,sBAAsB,QAAwB;CACrD,IAAI,CAAC,QAAQ;CAEb,OAAO,gBAAgB,wBAAwB;CAC/C,MAAM,OAAO,OAAO,YAAY;CAChC,IAAI,gBAAgB,cAAc,KAAK,gBAAgB,aACrD,KAAK,KAAK,gBAAgB,wBAAwB;AAEtD;AAEA,SAAS,UAAU,OAAsB;CACvC,IACE,MAAM,QAAQ,SACd,MAAM,IAAI,WAAW,OAAO,KAC5B,MAAM,QAAQ,WACd,MAAM,QAAQ,OACd,MAAM,QAAQ,UACd,MAAM,QAAQ,SACd,MAAM,QAAQ,YACd,MAAM,QAAQ,YACd;EACA,aAAa;EACb,sBAAsB,SAAS,aAAa;CAC9C;AACF;AAEA,SAAS,UAAU,OAAmB;CACpC,MAAM,SAAS,MAAM;CACrB,IAAI,EAAE,kBAAkB,cAAc;CAEtC,IAAI,iBAAiB,KAAK,IAAI,IAAI,iBAAiB,yBAAyB;EAC1E,OAAO,QAAQ,kBAAkB;EACjC,MAAM,OAAO,OAAO,YAAY;EAChC,IAAI,gBAAgB,cAAc,KAAK,gBAAgB,aACrD,KAAK,KAAK,QAAQ,kBAAkB;CAExC,OACE,sBAAsB,MAAM;AAEhC;;;;AAKA,SAAgB,iCAA6C;CAC3D,IAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa,aAAa,CAAC;CACpF,IAAI,WAAW,aAAa,CAAC;CAC7B,YAAY;CAIZ,SAAS,iBAAiB,eAAe,eAAe,IAAI;CAC5D,SAAS,iBAAiB,WAAW,WAAW,IAAI;CACpD,SAAS,iBAAiB,WAAW,WAAW,IAAI;CAEpD,aAAa;EACX,YAAY;EACZ,SAAS,oBAAoB,eAAe,eAAe,IAAI;EAC/D,SAAS,oBAAoB,WAAW,WAAW,IAAI;EACvD,SAAS,oBAAoB,WAAW,WAAW,IAAI;CACzD;AACF"}

package/dist/shared/focus/tabbable.js

@@ -0,0 +1,96 @@
+// src/shared/focus/tabbable.ts
+[
+	"a[href]",
+	"area[href]",
+	"button",
+	"input:not([type=\"hidden\"])",
+	"select",
+	"textarea",
+	"iframe",
+	"summary",
+	"audio[controls]",
+	"video[controls]",
+	"[contenteditable]:not([contenteditable=\"false\"])",
+	"[tabindex]"
+].join(",");
+function isInert(element) {
+	let current = element;
+	while (current) {
+		if (current.hasAttribute("inert")) return true;
+		const root = current.getRootNode();
+		current = current.parentElement ?? (root instanceof ShadowRoot ? root.host : null);
+	}
+	return false;
+}
+function isTabbable(element) {
+	if (element.tabIndex < 0) return false;
+	if (element.matches(":disabled")) return false;
+	if (element.hidden) return false;
+	if (isInert(element)) return false;
+	if (element.closest("details:not([open])") && element.tagName !== "SUMMARY") return false;
+	const style = getComputedStyle(element);
+	return style.display !== "none" && style.visibility !== "hidden";
+}
+/**
+* 按 flat tree（含 slot 分配与 open shadow root）收集可 Tab 聚焦元素。
+* 自定义元素宿主本身通常不可聚焦，真正进入 Tab 序的是其 shadow 内的原生控件。
+*/
+function getTabbables(root) {
+	const tabbables = [];
+	const visitChildren = (parent) => {
+		for (const child of parent.children) {
+			if (typeof HTMLSlotElement !== "undefined" && child instanceof HTMLSlotElement) {
+				const assigned = child.assignedElements({ flatten: true });
+				if (assigned.length > 0) for (const element of assigned) visitElement(element);
+				else visitChildren(child);
+				continue;
+			}
+			visitElement(child);
+		}
+	};
+	const visitElement = (element) => {
+		if (!(element instanceof HTMLElement)) return;
+		if (isTabbable(element)) tabbables.push(element);
+		visitChildren(element.shadowRoot ?? element);
+	};
+	visitChildren(root);
+	return tabbables;
+}
+/** 深入 open shadow root，返回实际持有焦点的元素（document.activeElement 会重定向到宿主）。 */
+function getDeepActiveElement(root) {
+	let active = root.ownerDocument?.activeElement ?? null;
+	while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement;
+	return active;
+}
+/**
+* 原生 modal dialog 在 Chromium 里从末项 Tab 时会先落到 body。这里在首尾边界显式回卷，
+* 保证焦点始终停在浮层内。
+*/
+function trapTabKey(event, root) {
+	if (event.key !== "Tab" || event.defaultPrevented) return;
+	const tabbables = getTabbables(root);
+	if (tabbables.length === 0) {
+		event.preventDefault();
+		return;
+	}
+	const active = getDeepActiveElement(root);
+	if (!active || !tabbables.includes(active)) return;
+	const first = tabbables[0];
+	const last = tabbables[tabbables.length - 1];
+	if (event.shiftKey && active === first) {
+		event.preventDefault();
+		last.focus();
+	} else if (!event.shiftKey && active === last) {
+		event.preventDefault();
+		first.focus();
+	}
+}
+/** 找到 trigger 内真正接收焦点的元素；trigger 本身可聚焦时就是它。 */
+function findFocusTarget(trigger) {
+	if (trigger instanceof HTMLElement && isTabbable(trigger)) return trigger;
+	if (trigger.shadowRoot) return getTabbables(trigger.shadowRoot)[0] ?? null;
+	return null;
+}
+export { findFocusTarget, getDeepActiveElement, getTabbables, trapTabKey };
+
+//# sourceMappingURL=tabbable.js.map

package/dist/shared/focus/tabbable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabbable.js","names":[],"sources":["../../../src/shared/focus/tabbable.ts"],"sourcesContent":["const FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'area[href]',\n  'button',\n  'input:not([type=\"hidden\"])',\n  'select',\n  'textarea',\n  'iframe',\n  'summary',\n  'audio[controls]',\n  'video[controls]',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]'\n].join(',')\n\nfunction isInert(element: Element): boolean {\n  let current: Element | null = element\n  while (current) {\n    if (current.hasAttribute('inert')) return true\n    const root = current.getRootNode()\n    current = current.parentElement ?? (root instanceof ShadowRoot ? root.host : null)\n  }\n  return false\n}\n\nfunction isTabbable(element: HTMLElement): boolean {\n  if (element.tabIndex < 0) return false\n  if (element.matches(':disabled')) return false\n  if (element.hidden) return false\n  if (isInert(element)) return false\n  if (element.closest('details:not([open])') && element.tagName !== 'SUMMARY') return false\n  const style = getComputedStyle(element)\n  return style.display !== 'none' && style.visibility !== 'hidden'\n}\n\n/**\n * 按 flat tree（含 slot 分配与 open shadow root）收集可 Tab 聚焦元素。\n * 自定义元素宿主本身通常不可聚焦，真正进入 Tab 序的是其 shadow 内的原生控件。\n */\nexport function getTabbables(root: ParentNode): HTMLElement[] {\n  const tabbables: HTMLElement[] = []\n\n  const visitChildren = (parent: ParentNode) => {\n    for (const child of parent.children) {\n      if (typeof HTMLSlotElement !== 'undefined' && child instanceof HTMLSlotElement) {\n        const assigned = child.assignedElements({ flatten: true })\n        if (assigned.length > 0) {\n          for (const element of assigned) visitElement(element)\n        } else {\n          visitChildren(child)\n        }\n        continue\n      }\n      visitElement(child)\n    }\n  }\n\n  const visitElement = (element: Element) => {\n    if (!(element instanceof HTMLElement)) return\n    if (isTabbable(element)) tabbables.push(element)\n    visitChildren(element.shadowRoot ?? element)\n  }\n\n  visitChildren(root)\n  return tabbables\n}\n\n/** 深入 open shadow root，返回实际持有焦点的元素（document.activeElement 会重定向到宿主）。 */\nexport function getDeepActiveElement(root: HTMLElement): Element | null {\n  let active: Element | null = root.ownerDocument?.activeElement ?? null\n  while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement\n  return active\n}\n\n/**\n * 原生 modal dialog 在 Chromium 里从末项 Tab 时会先落到 body。这里在首尾边界显式回卷，\n * 保证焦点始终停在浮层内。\n */\nexport function trapTabKey(event: KeyboardEvent, root: HTMLElement): void {\n  if (event.key !== 'Tab' || event.defaultPrevented) return\n\n  const tabbables = getTabbables(root)\n  if (tabbables.length === 0) {\n    event.preventDefault()\n    return\n  }\n\n  const active = getDeepActiveElement(root)\n  if (!active || !tabbables.includes(active as HTMLElement)) return\n\n  const first = tabbables[0]\n  const last = tabbables[tabbables.length - 1]\n  if (event.shiftKey && active === first) {\n    event.preventDefault()\n    last.focus()\n  } else if (!event.shiftKey && active === last) {\n    event.preventDefault()\n    first.focus()\n  }\n}\n\n/** 找到 trigger 内真正接收焦点的元素；trigger 本身可聚焦时就是它。 */\nexport function findFocusTarget(trigger: Element): HTMLElement | null {\n  if (trigger instanceof HTMLElement && isTabbable(trigger)) return trigger\n  if (trigger.shadowRoot) return getTabbables(trigger.shadowRoot)[0] ?? null\n  return null\n}\n"],"mappings":";AAA2B;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,GAAG;AAEV,SAAS,QAAQ,SAA2B;CAC1C,IAAI,UAA0B;CAC9B,OAAO,SAAS;EACd,IAAI,QAAQ,aAAa,OAAO,GAAG,OAAO;EAC1C,MAAM,OAAO,QAAQ,YAAY;EACjC,UAAU,QAAQ,kBAAkB,gBAAgB,aAAa,KAAK,OAAO;CAC/E;CACA,OAAO;AACT;AAEA,SAAS,WAAW,SAA+B;CACjD,IAAI,QAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,QAAQ,QAAQ,WAAW,GAAG,OAAO;CACzC,IAAI,QAAQ,QAAQ,OAAO;CAC3B,IAAI,QAAQ,OAAO,GAAG,OAAO;CAC7B,IAAI,QAAQ,QAAQ,qBAAqB,KAAK,QAAQ,YAAY,WAAW,OAAO;CACpF,MAAM,QAAQ,iBAAiB,OAAO;CACtC,OAAO,MAAM,YAAY,UAAU,MAAM,eAAe;AAC1D;;;;;AAMA,SAAgB,aAAa,MAAiC;CAC5D,MAAM,YAA2B,CAAC;CAElC,MAAM,iBAAiB,WAAuB;EAC5C,KAAK,MAAM,SAAS,OAAO,UAAU;GACnC,IAAI,OAAO,oBAAoB,eAAe,iBAAiB,iBAAiB;IAC9E,MAAM,WAAW,MAAM,iBAAiB,EAAE,SAAS,KAAK,CAAC;IACzD,IAAI,SAAS,SAAS,GACpB,KAAK,MAAM,WAAW,UAAU,aAAa,OAAO;SAEpD,cAAc,KAAK;IAErB;GACF;GACA,aAAa,KAAK;EACpB;CACF;CAEA,MAAM,gBAAgB,YAAqB;EACzC,IAAI,EAAE,mBAAmB,cAAc;EACvC,IAAI,WAAW,OAAO,GAAG,UAAU,KAAK,OAAO;EAC/C,cAAc,QAAQ,cAAc,OAAO;CAC7C;CAEA,cAAc,IAAI;CAClB,OAAO;AACT;;AAGA,SAAgB,qBAAqB,MAAmC;CACtE,IAAI,SAAyB,KAAK,eAAe,iBAAiB;CAClE,OAAO,QAAQ,YAAY,eAAe,SAAS,OAAO,WAAW;CACrE,OAAO;AACT;;;;;AAMA,SAAgB,WAAW,OAAsB,MAAyB;CACxE,IAAI,MAAM,QAAQ,SAAS,MAAM,kBAAkB;CAEnD,MAAM,YAAY,aAAa,IAAI;CACnC,IAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,eAAe;EACrB;CACF;CAEA,MAAM,SAAS,qBAAqB,IAAI;CACxC,IAAI,CAAC,UAAU,CAAC,UAAU,SAAS,MAAqB,GAAG;CAE3D,MAAM,QAAQ,UAAU;CACxB,MAAM,OAAO,UAAU,UAAU,SAAS;CAC1C,IAAI,MAAM,YAAY,WAAW,OAAO;EACtC,MAAM,eAAe;EACrB,KAAK,MAAM;CACb,OAAO,IAAI,CAAC,MAAM,YAAY,WAAW,MAAM;EAC7C,MAAM,eAAe;EACrB,MAAM,MAAM;CACd;AACF;;AAGA,SAAgB,gBAAgB,SAAsC;CACpE,IAAI,mBAAmB,eAAe,WAAW,OAAO,GAAG,OAAO;CAClE,IAAI,QAAQ,YAAY,OAAO,aAAa,QAAQ,UAAU,CAAC,CAAC,MAAM;CACtE,OAAO;AACT"}

package/dist/shared/form-association/field-id.js

@@ -1,9 +1,16 @@
-//#region src/shared/form-association/field-id.ts
-var e = 0;
-function t(t) {
-	return e += 1, `${t}-${e}`;
+// src/shared/form-association/field-id.ts
+let nextFieldId = 0;
+/**
+* 为 shadow 内原生表单控件生成实例级稳定 id。
+*
+* Chrome 的表单 a11y 审计要求 input / textarea 至少有 id 或 name；
+* 生成 id 让消费者无需显式传 host 属性也始终满足该契约。
+* id 在组件构造时生成一次，后续重渲染复用，避免 aria 引用与焦点时序抖动。
+*/
+function createFieldId(prefix) {
+	nextFieldId += 1;
+	return `${prefix}-${nextFieldId}`;
 }
-//#endregion
-export { t as createFieldId };
+export { createFieldId };
 
 //# sourceMappingURL=field-id.js.map

package/dist/shared/form-association/field-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-id.js","names":[],"sources":["../../../src/shared/form-association/field-id.ts"],"sourcesContent":["let nextFieldId = 0\n\n/**\n * 为 shadow 内原生表单控件生成实例级稳定 id。\n *\n * Chrome 的表单 a11y 审计要求 input / textarea 至少有 id 或 name；\n * 生成 id 让消费者无需显式传 host 属性也始终满足该契约。\n * id 在组件构造时生成一次，后续重渲染复用，避免 aria 引用与焦点时序抖动。\n */\nexport function createFieldId(prefix: string): string {\n  nextFieldId += 1\n  return `${prefix}-${nextFieldId}`\n}\n"],"mappings":";AAAA,IAAI,IAAc;AASlB,SAAgB,EAAc,GAAwB;CAEpD,OADA,KAAe,GACR,GAAG,EAAO,GAAG;AACtB"}
+{"version":3,"file":"field-id.js","names":[],"sources":["../../../src/shared/form-association/field-id.ts"],"sourcesContent":["let nextFieldId = 0\n\n/**\n * 为 shadow 内原生表单控件生成实例级稳定 id。\n *\n * Chrome 的表单 a11y 审计要求 input / textarea 至少有 id 或 name；\n * 生成 id 让消费者无需显式传 host 属性也始终满足该契约。\n * id 在组件构造时生成一次，后续重渲染复用，避免 aria 引用与焦点时序抖动。\n */\nexport function createFieldId(prefix: string): string {\n  nextFieldId += 1\n  return `${prefix}-${nextFieldId}`\n}\n"],"mappings":";AAAA,IAAI,cAAc;;;;;;;;AASlB,SAAgB,cAAc,QAAwB;CACpD,eAAe;CACf,OAAO,GAAG,OAAO,GAAG;AACtB"}

package/dist/shared/form-association/index.js

@@ -1,67 +1,101 @@
-import { definePlugin as e } from "@greypan/js-kit";
-//#region src/shared/form-association/index.ts
-function t(e, t, n, r = !1) {
-	if (typeof e.setValidity != "function") return;
-	if (r || t.validity.valid) {
-		e.setValidity({});
+import { definePlugin } from "@greypan/js-kit";
+// src/shared/form-association/index.ts
+/**
+* 把原生 input 的 ValidityState 转发为 ElementInternals 的校验状态。
+* flagNames 是控件自己声明的校验契约（input 转发文本类 5 项、input-number
+* 转发范围类 4 项），这里只收敛 guard / valid 判定 / setValidity 接线。
+* disabled 元素被约束验证豁免，必须上报干净状态；isDisabled 传入控件的
+* 组合禁用态（含 formDisabled），因为 formDisabledCallback 触发时原生
+* input 的 disabled 属性可能尚未重渲染，不能依赖 input.validity.valid。
+*/
+function forwardInputValidity(internals, input, flagNames, isDisabled = false) {
+	if (typeof internals.setValidity !== "function") return;
+	if (isDisabled || input.validity.valid) {
+		internals.setValidity({});
 		return;
 	}
-	let i = {};
-	for (let e of n) t.validity[e] && (i[e] = !0);
-	e.setValidity(i, t.validationMessage, t);
+	const flags = {};
+	for (const name of flagNames) if (input.validity[name]) flags[name] = true;
+	internals.setValidity(flags, input.validationMessage, input);
 }
-function n(t) {
-	return e(() => {
-		let e, n, r = !1, i = !1, a = t.copyState ?? ((e) => e), o = () => {
-			e && (e.setFormValue?.(t.getFormValue(), t.getFormState()), t.syncValidity?.(e));
+/**
+* 承接原生 custom element 表单生命周期，值序列化与校验语义仍由各控件组件自己表达。
+*/
+function defineFormAssociation(options) {
+	return definePlugin(() => {
+		let internals;
+		let initialState;
+		let initialized = false;
+		let formDisabled = false;
+		const copyState = options.copyState ?? ((state) => state);
+		const sync = () => {
+			if (!internals) return;
+			internals.setFormValue?.(options.getFormValue(), options.getFormState());
+			options.syncValidity?.(internals);
 		};
 		return {
 			connect() {
-				e ||= t.host.attachInternals(), r ||= (t.initialize?.(), n = a(t.getState()), !0), o();
+				if (!internals) internals = options.host.attachInternals();
+				if (!initialized) {
+					options.initialize?.();
+					initialState = copyState(options.getState());
+					initialized = true;
+				}
+				sync();
 			},
-			sync: o,
+			sync,
 			reset() {
-				r && !t.isStateManaged?.() && (t.setState(a(n)), o());
+				if (!initialized || options.isStateManaged?.()) return;
+				options.setState(copyState(initialState));
+				sync();
 			},
-			restore(e) {
-				t.isStateManaged?.() || (t.restoreState(e), o());
+			restore(state) {
+				if (options.isStateManaged?.()) return;
+				options.restoreState(state);
+				sync();
 			},
-			setDisabled(e) {
-				if (i !== e) {
-					if (i = e, o(), t.host.isUpdatePending) {
-						queueMicrotask(() => {
-							t.host.requestUpdate(), o();
-						});
-						return;
-					}
-					t.host.requestUpdate();
+			setDisabled(disabled) {
+				if (formDisabled === disabled) return;
+				formDisabled = disabled;
+				sync();
+				if (options.host.isUpdatePending) {
+					queueMicrotask(() => {
+						options.host.requestUpdate();
+						sync();
+					});
+					return;
 				}
+				options.host.requestUpdate();
 			},
-			isFormDisabled: () => i,
-			getInternals: () => e
+			isFormDisabled: () => formDisabled,
+			getInternals: () => internals
 		};
 	});
 }
-function r(e) {
-	class t extends e {
+function FormAssociated(superClass) {
+	class FormAssociatedElement extends superClass {
 		static {
-			this.formAssociated = !0;
+			this.formAssociated = true;
 		}
 		formResetCallback() {
 			this.__formLifecycleProvider?.().reset();
 		}
-		formDisabledCallback(e) {
-			this.__formLifecycleProvider?.().setDisabled(e);
+		formDisabledCallback(disabled) {
+			this.__formLifecycleProvider?.().setDisabled(disabled);
 		}
-		formStateRestoreCallback(e) {
-			this.__formLifecycleProvider?.().restore(e);
+		formStateRestoreCallback(state) {
+			this.__formLifecycleProvider?.().restore(state);
 		}
 	}
-	return t;
+	return FormAssociatedElement;
 }
-var i = class {
-	constructor(e, t) {
-		this.host = e, this.lifecycle = t, e.addController(this), e.__formLifecycleProvider = () => t;
+/** 把表单生命周期插件接入宿主（回调接线经 FormAssociated mixin，无需共享基类）。 */
+var FormAssociationController = class {
+	constructor(host, lifecycle) {
+		this.host = host;
+		this.lifecycle = lifecycle;
+		host.addController(this);
+		host.__formLifecycleProvider = () => lifecycle;
 	}
 	hostConnected() {
 		this.lifecycle.connect();
@@ -70,7 +104,6 @@ var i = class {
 		this.lifecycle.sync();
 	}
 };
-//#endregion
-export { r as FormAssociated, i as FormAssociationController, n as defineFormAssociation, t as forwardInputValidity };
+export { FormAssociated, FormAssociationController, defineFormAssociation, forwardInputValidity };
 
 //# sourceMappingURL=index.js.map

package/dist/shared/form-association/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/form-association/index.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\nimport type { ReactiveController, ReactiveControllerHost } from 'lit'\n\n// Lit 官方 mixin 签名需要构造器接受任意参数（paramCount 各异的子类构造器都要能赋给\n// 基座）；never[] 变体在 extends 链上会丢失 Lit 静态侧类型。any 收敛在这个类型别名内。\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor<T = object> = new (...args: any[]) => T\n\ntype FormSubmissionValue = File | FormData | string | null\ntype FormStateValue = File | FormData | string | null\n\ninterface FormAssociationHost extends HTMLElement, ReactiveControllerHost {\n  /** Lit 的更新窗口判据：反射属性触发的回调落在本轮 performUpdate 之内时为 true。 */\n  isUpdatePending: boolean\n}\n\nexport interface FormAssociationOptions<State> {\n  readonly host: FormAssociationHost\n  readonly initialize?: () => void\n  readonly getState: () => State\n  readonly setState: (state: State) => void\n  readonly copyState?: (state: State) => State\n  readonly getFormValue: () => FormSubmissionValue\n  readonly getFormState: () => FormStateValue\n  readonly restoreState: (state: FormStateValue) => void\n  readonly isStateManaged?: () => boolean\n  readonly syncValidity?: (internals: ElementInternals) => void\n}\n\nexport interface FormAssociationLifecycle {\n  connect(): void\n  sync(): void\n  reset(): void\n  restore(state: FormStateValue): void\n  setDisabled(disabled: boolean): void\n  isFormDisabled(): boolean\n  getInternals(): ElementInternals | undefined\n}\n\n/**\n * 把原生 input 的 ValidityState 转发为 ElementInternals 的校验状态。\n * flagNames 是控件自己声明的校验契约（input 转发文本类 5 项、input-number\n * 转发范围类 4 项），这里只收敛 guard / valid 判定 / setValidity 接线。\n * disabled 元素被约束验证豁免，必须上报干净状态；isDisabled 传入控件的\n * 组合禁用态（含 formDisabled），因为 formDisabledCallback 触发时原生\n * input 的 disabled 属性可能尚未重渲染，不能依赖 input.validity.valid。\n */\nexport function forwardInputValidity(\n  internals: ElementInternals,\n  input: HTMLInputElement | HTMLTextAreaElement,\n  flagNames: readonly (keyof ValidityStateFlags)[],\n  isDisabled = false\n): void {\n  if (typeof internals.setValidity !== 'function') return\n  if (isDisabled || input.validity.valid) {\n    internals.setValidity({})\n    return\n  }\n  const flags: ValidityStateFlags = {}\n  for (const name of flagNames) {\n    if (input.validity[name]) flags[name] = true\n  }\n  internals.setValidity(flags, input.validationMessage, input)\n}\n\n/**\n * 承接原生 custom element 表单生命周期，值序列化与校验语义仍由各控件组件自己表达。\n */\nexport function defineFormAssociation<State>(options: FormAssociationOptions<State>) {\n  return definePlugin((): FormAssociationLifecycle => {\n    let internals: ElementInternals | undefined\n    let initialState: State | undefined\n    let initialized = false\n    let formDisabled = false\n    const copyState = options.copyState ?? (state => state)\n\n    const sync = () => {\n      if (!internals) return\n      internals.setFormValue?.(options.getFormValue(), options.getFormState())\n      options.syncValidity?.(internals)\n    }\n\n    return {\n      connect() {\n        if (!internals) internals = options.host.attachInternals()\n        if (!initialized) {\n          options.initialize?.()\n          initialState = copyState(options.getState())\n          initialized = true\n        }\n        sync()\n      },\n      sync,\n      reset() {\n        if (!initialized || options.isStateManaged?.()) return\n        options.setState(copyState(initialState as State))\n        sync()\n      },\n      restore(state) {\n        if (options.isStateManaged?.()) return\n        options.restoreState(state)\n        sync()\n      },\n      setDisabled(disabled) {\n        if (formDisabled === disabled) return\n        formDisabled = disabled\n        sync()\n        if (options.host.isUpdatePending) {\n          /*\n           * 宿主 disabled 的反射会同步触发 formDisabledCallback，那一轮 render 已经读过旧值；\n           * 而 Lit 在 isUpdatePending 为 true 时会丢掉 requestUpdate()（reactive-element 2.1.2\n           * 的 requestUpdate 尾部判据），控件就会停在旧禁用态且再无渲染。等本轮更新结束再排一次。\n           */\n          queueMicrotask(() => {\n            options.host.requestUpdate()\n            sync()\n          })\n          return\n        }\n        options.host.requestUpdate()\n      },\n      isFormDisabled: () => formDisabled,\n      getInternals: () => internals\n    }\n  })\n}\n\n/**\n * 表单关联元素 mixin：安装 `formAssociated` 与三个生命周期回调。\n *\n * 生命周期实现仍由 defineFormAssociation 表达；FormAssociationController\n * 在构造时把 lifecycle 注册到实例的 provider，回调经它转发。组件可继续\n * 覆写单个回调注入自己的额外逻辑（如 autocomplete 的禁用收口）。\n * 这是字段组合（mixin），不是共享基类：除回调接线外不继承任何实现。\n */\nexport interface FormAssociatedLifecycleProvider {\n  __formLifecycleProvider?: () => FormAssociationLifecycle\n}\n\nexport function FormAssociated<T extends Constructor<HTMLElement>>(superClass: T) {\n  class FormAssociatedElement extends superClass {\n    static formAssociated = true\n\n    formResetCallback(): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().reset()\n    }\n\n    formDisabledCallback(disabled: boolean): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().setDisabled(disabled)\n    }\n\n    formStateRestoreCallback(state: File | FormData | string | null): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().restore(state)\n    }\n  }\n  return FormAssociatedElement\n}\n\n/** 把表单生命周期插件接入宿主（回调接线经 FormAssociated mixin，无需共享基类）。 */\nexport class FormAssociationController implements ReactiveController {\n  constructor(\n    private readonly host: FormAssociationHost,\n    private readonly lifecycle: FormAssociationLifecycle\n  ) {\n    host.addController(this)\n    ;(host as FormAssociationHost & FormAssociatedLifecycleProvider).__formLifecycleProvider = () => lifecycle\n  }\n\n  hostConnected() {\n    this.lifecycle.connect()\n  }\n\n  hostUpdated() {\n    this.lifecycle.sync()\n  }\n}\n"],"mappings":";;AA+CA,SAAgB,EACd,GACA,GACA,GACA,IAAa,IACP;CACN,IAAI,OAAO,EAAU,eAAgB,YAAY;CACjD,IAAI,KAAc,EAAM,SAAS,OAAO;EACtC,EAAU,YAAY,CAAC,CAAC;EACxB;CACF;CACA,IAAM,IAA4B,CAAC;CACnC,KAAK,IAAM,KAAQ,GACjB,AAAI,EAAM,SAAS,OAAO,EAAM,KAAQ;CAE1C,EAAU,YAAY,GAAO,EAAM,mBAAmB,CAAK;AAC7D;AAKA,SAAgB,EAA6B,GAAwC;CACnF,OAAO,QAA6C;EAClD,IAAI,GACA,GACA,IAAc,IACd,IAAe,IACb,IAAY,EAAQ,eAAc,MAAS,IAE3C,UAAa;GACZ,MACL,EAAU,eAAe,EAAQ,aAAa,GAAG,EAAQ,aAAa,CAAC,GACvE,EAAQ,eAAe,CAAS;EAClC;EAEA,OAAO;GACL,UAAU;IAOR,AANA,AAAgB,MAAY,EAAQ,KAAK,gBAAgB,GACzD,AAGE,OAFA,EAAQ,aAAa,GACrB,IAAe,EAAU,EAAQ,SAAS,CAAC,GAC7B,KAEhB,EAAK;GACP;GACA;GACA,QAAQ;IACF,AAAC,KAAe,GAAQ,iBAAiB,MAC7C,EAAQ,SAAS,EAAU,CAAqB,CAAC,GACjD,EAAK;GACP;GACA,QAAQ,GAAO;IACT,EAAQ,iBAAiB,MAC7B,EAAQ,aAAa,CAAK,GAC1B,EAAK;GACP;GACA,YAAY,GAAU;IAChB,UAAiB,GAGrB;SAFA,IAAe,GACf,EAAK,GACD,EAAQ,KAAK,iBAAiB;MAMhC,qBAAqB;OAEnB,AADA,EAAQ,KAAK,cAAc,GAC3B,EAAK;MACP,CAAC;MACD;KACF;KACA,EAAQ,KAAK,cAAc;IAD3B;GAEF;GACA,sBAAsB;GACtB,oBAAoB;EACtB;CACF,CAAC;AACH;AAcA,SAAgB,EAAmD,GAAe;CAChF,MAAM,UAA8B,EAAW;;GACrB,KAAA,iBAAA;;EAExB,oBAA0B;GACvB,KAA0C,0BAA0B,CAAC,CAAC,MAAM;EAC/E;EAEA,qBAAqB,GAAyB;GAC3C,KAA0C,0BAA0B,CAAC,CAAC,YAAY,CAAQ;EAC7F;EAEA,yBAAyB,GAA8C;GACpE,KAA0C,0BAA0B,CAAC,CAAC,QAAQ,CAAK;EACtF;CACF;CACA,OAAO;AACT;AAGA,IAAa,IAAb,MAAqE;CACnE,YACE,GACA,GACA;EAEC,AAJgB,KAAA,OAAA,GACA,KAAA,YAAA,GAEjB,EAAK,cAAc,IAAI,GACtB,EAAgE,gCAAgC;CACnG;CAEA,gBAAgB;EACd,KAAK,UAAU,QAAQ;CACzB;CAEA,cAAc;EACZ,KAAK,UAAU,KAAK;CACtB;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/form-association/index.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\nimport type { ReactiveController, ReactiveControllerHost } from 'lit'\n\n// Lit 官方 mixin 签名需要构造器接受任意参数（paramCount 各异的子类构造器都要能赋给\n// 基座）；never[] 变体在 extends 链上会丢失 Lit 静态侧类型。any 收敛在这个类型别名内。\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype Constructor<T = object> = new (...args: any[]) => T\n\ntype FormSubmissionValue = File | FormData | string | null\ntype FormStateValue = File | FormData | string | null\n\ninterface FormAssociationHost extends HTMLElement, ReactiveControllerHost {\n  /** Lit 的更新窗口判据：反射属性触发的回调落在本轮 performUpdate 之内时为 true。 */\n  isUpdatePending: boolean\n}\n\nexport interface FormAssociationOptions<State> {\n  readonly host: FormAssociationHost\n  readonly initialize?: () => void\n  readonly getState: () => State\n  readonly setState: (state: State) => void\n  readonly copyState?: (state: State) => State\n  readonly getFormValue: () => FormSubmissionValue\n  readonly getFormState: () => FormStateValue\n  readonly restoreState: (state: FormStateValue) => void\n  readonly isStateManaged?: () => boolean\n  readonly syncValidity?: (internals: ElementInternals) => void\n}\n\nexport interface FormAssociationLifecycle {\n  connect(): void\n  sync(): void\n  reset(): void\n  restore(state: FormStateValue): void\n  setDisabled(disabled: boolean): void\n  isFormDisabled(): boolean\n  getInternals(): ElementInternals | undefined\n}\n\n/**\n * 把原生 input 的 ValidityState 转发为 ElementInternals 的校验状态。\n * flagNames 是控件自己声明的校验契约（input 转发文本类 5 项、input-number\n * 转发范围类 4 项），这里只收敛 guard / valid 判定 / setValidity 接线。\n * disabled 元素被约束验证豁免，必须上报干净状态；isDisabled 传入控件的\n * 组合禁用态（含 formDisabled），因为 formDisabledCallback 触发时原生\n * input 的 disabled 属性可能尚未重渲染，不能依赖 input.validity.valid。\n */\nexport function forwardInputValidity(\n  internals: ElementInternals,\n  input: HTMLInputElement | HTMLTextAreaElement,\n  flagNames: readonly (keyof ValidityStateFlags)[],\n  isDisabled = false\n): void {\n  if (typeof internals.setValidity !== 'function') return\n  if (isDisabled || input.validity.valid) {\n    internals.setValidity({})\n    return\n  }\n  const flags: ValidityStateFlags = {}\n  for (const name of flagNames) {\n    if (input.validity[name]) flags[name] = true\n  }\n  internals.setValidity(flags, input.validationMessage, input)\n}\n\n/**\n * 承接原生 custom element 表单生命周期，值序列化与校验语义仍由各控件组件自己表达。\n */\nexport function defineFormAssociation<State>(options: FormAssociationOptions<State>) {\n  return definePlugin((): FormAssociationLifecycle => {\n    let internals: ElementInternals | undefined\n    let initialState: State | undefined\n    let initialized = false\n    let formDisabled = false\n    const copyState = options.copyState ?? (state => state)\n\n    const sync = () => {\n      if (!internals) return\n      internals.setFormValue?.(options.getFormValue(), options.getFormState())\n      options.syncValidity?.(internals)\n    }\n\n    return {\n      connect() {\n        if (!internals) internals = options.host.attachInternals()\n        if (!initialized) {\n          options.initialize?.()\n          initialState = copyState(options.getState())\n          initialized = true\n        }\n        sync()\n      },\n      sync,\n      reset() {\n        if (!initialized || options.isStateManaged?.()) return\n        options.setState(copyState(initialState as State))\n        sync()\n      },\n      restore(state) {\n        if (options.isStateManaged?.()) return\n        options.restoreState(state)\n        sync()\n      },\n      setDisabled(disabled) {\n        if (formDisabled === disabled) return\n        formDisabled = disabled\n        sync()\n        if (options.host.isUpdatePending) {\n          /*\n           * 宿主 disabled 的反射会同步触发 formDisabledCallback，那一轮 render 已经读过旧值；\n           * 而 Lit 在 isUpdatePending 为 true 时会丢掉 requestUpdate()（reactive-element 2.1.2\n           * 的 requestUpdate 尾部判据），控件就会停在旧禁用态且再无渲染。等本轮更新结束再排一次。\n           */\n          queueMicrotask(() => {\n            options.host.requestUpdate()\n            sync()\n          })\n          return\n        }\n        options.host.requestUpdate()\n      },\n      isFormDisabled: () => formDisabled,\n      getInternals: () => internals\n    }\n  })\n}\n\n/**\n * 表单关联元素 mixin：安装 `formAssociated` 与三个生命周期回调。\n *\n * 生命周期实现仍由 defineFormAssociation 表达；FormAssociationController\n * 在构造时把 lifecycle 注册到实例的 provider，回调经它转发。组件可继续\n * 覆写单个回调注入自己的额外逻辑（如 autocomplete 的禁用收口）。\n * 这是字段组合（mixin），不是共享基类：除回调接线外不继承任何实现。\n */\nexport interface FormAssociatedLifecycleProvider {\n  __formLifecycleProvider?: () => FormAssociationLifecycle\n}\n\nexport function FormAssociated<T extends Constructor<HTMLElement>>(superClass: T) {\n  class FormAssociatedElement extends superClass {\n    static formAssociated = true\n\n    formResetCallback(): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().reset()\n    }\n\n    formDisabledCallback(disabled: boolean): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().setDisabled(disabled)\n    }\n\n    formStateRestoreCallback(state: File | FormData | string | null): void {\n      ;(this as FormAssociatedLifecycleProvider).__formLifecycleProvider?.().restore(state)\n    }\n  }\n  return FormAssociatedElement\n}\n\n/** 把表单生命周期插件接入宿主（回调接线经 FormAssociated mixin，无需共享基类）。 */\nexport class FormAssociationController implements ReactiveController {\n  constructor(\n    private readonly host: FormAssociationHost,\n    private readonly lifecycle: FormAssociationLifecycle\n  ) {\n    host.addController(this)\n    ;(host as FormAssociationHost & FormAssociatedLifecycleProvider).__formLifecycleProvider = () => lifecycle\n  }\n\n  hostConnected() {\n    this.lifecycle.connect()\n  }\n\n  hostUpdated() {\n    this.lifecycle.sync()\n  }\n}\n"],"mappings":";;;;;;;;;;AA+CA,SAAgB,qBACd,WACA,OACA,WACA,aAAa,OACP;CACN,IAAI,OAAO,UAAU,gBAAgB,YAAY;CACjD,IAAI,cAAc,MAAM,SAAS,OAAO;EACtC,UAAU,YAAY,CAAC,CAAC;EACxB;CACF;CACA,MAAM,QAA4B,CAAC;CACnC,KAAK,MAAM,QAAQ,WACjB,IAAI,MAAM,SAAS,OAAO,MAAM,QAAQ;CAE1C,UAAU,YAAY,OAAO,MAAM,mBAAmB,KAAK;AAC7D;;;;AAKA,SAAgB,sBAA6B,SAAwC;CACnF,OAAO,mBAA6C;EAClD,IAAI;EACJ,IAAI;EACJ,IAAI,cAAc;EAClB,IAAI,eAAe;EACnB,MAAM,YAAY,QAAQ,eAAc,UAAS;EAEjD,MAAM,aAAa;GACjB,IAAI,CAAC,WAAW;GAChB,UAAU,eAAe,QAAQ,aAAa,GAAG,QAAQ,aAAa,CAAC;GACvE,QAAQ,eAAe,SAAS;EAClC;EAEA,OAAO;GACL,UAAU;IACR,IAAI,CAAC,WAAW,YAAY,QAAQ,KAAK,gBAAgB;IACzD,IAAI,CAAC,aAAa;KAChB,QAAQ,aAAa;KACrB,eAAe,UAAU,QAAQ,SAAS,CAAC;KAC3C,cAAc;IAChB;IACA,KAAK;GACP;GACA;GACA,QAAQ;IACN,IAAI,CAAC,eAAe,QAAQ,iBAAiB,GAAG;IAChD,QAAQ,SAAS,UAAU,YAAqB,CAAC;IACjD,KAAK;GACP;GACA,QAAQ,OAAO;IACb,IAAI,QAAQ,iBAAiB,GAAG;IAChC,QAAQ,aAAa,KAAK;IAC1B,KAAK;GACP;GACA,YAAY,UAAU;IACpB,IAAI,iBAAiB,UAAU;IAC/B,eAAe;IACf,KAAK;IACL,IAAI,QAAQ,KAAK,iBAAiB;KAMhC,qBAAqB;MACnB,QAAQ,KAAK,cAAc;MAC3B,KAAK;KACP,CAAC;KACD;IACF;IACA,QAAQ,KAAK,cAAc;GAC7B;GACA,sBAAsB;GACtB,oBAAoB;EACtB;CACF,CAAC;AACH;AAcA,SAAgB,eAAmD,YAAe;CAChF,MAAM,8BAA8B,WAAW;;GACrB,KAAA,iBAAA;;EAExB,oBAA0B;GACvB,KAA0C,0BAA0B,CAAC,CAAC,MAAM;EAC/E;EAEA,qBAAqB,UAAyB;GAC3C,KAA0C,0BAA0B,CAAC,CAAC,YAAY,QAAQ;EAC7F;EAEA,yBAAyB,OAA8C;GACpE,KAA0C,0BAA0B,CAAC,CAAC,QAAQ,KAAK;EACtF;CACF;CACA,OAAO;AACT;;AAGA,IAAa,4BAAb,MAAqE;CACnE,YACE,MACA,WACA;EAFiB,KAAA,OAAA;EACA,KAAA,YAAA;EAEjB,KAAK,cAAc,IAAI;EACtB,KAAgE,gCAAgC;CACnG;CAEA,gBAAgB;EACd,KAAK,UAAU,QAAQ;CACzB;CAEA,cAAc;EACZ,KAAK,UAAU,KAAK;CACtB;AACF"}