@qw-ui/core 0.3.0-next.8 → 0.3.0

package/dist/switch/index.js

@@ -0,0 +1,168 @@
+import { createMachine } from "@zag-js/core";
+//#region src/switch/switch.ts
+/**
+* Switch 的跨框架行为契约。
+*
+* Core Zag bindable owns controlled/uncontrolled state, requests and click cancellation.
+* Browser button semantics supply keyboard/default form actions; adapters only project getters.
+*/
+/** Switch 各渲染部位全集（data-part 取值）。 */
+const SWITCH_PARTS = ["root", "thumb"];
+const SWITCH_TYPES = [
+	"button",
+	"submit",
+	"reset"
+];
+/** 将公开输入归一化为唯一的跨框架状态。 */
+function resolveSwitchState(props = {}) {
+	const normalized = createSwitchProps(props);
+	return {
+		checked: normalized.checked ?? normalized.defaultChecked ?? false,
+		disabled: normalized.disabled ?? false,
+		readOnly: normalized.readOnly ?? false,
+		type: normalized.type ?? "button"
+	};
+}
+function getSwitchRootProps(state, options = {}) {
+	const standards = {};
+	for (const key of [
+		"name",
+		"value",
+		"form",
+		"title",
+		"lang",
+		"dir",
+		"hidden"
+	]) if (options[key] !== void 0) standards[key] = options[key];
+	return {
+		type: state.type,
+		role: "switch",
+		disabled: state.disabled,
+		"aria-checked": state.checked ? "true" : "false",
+		"data-scope": "switch",
+		"data-part": "root",
+		"data-checked": state.checked ? "true" : "false",
+		...state.disabled ? { "data-disabled": "true" } : {},
+		...state.readOnly ? {
+			"aria-readonly": "true",
+			"data-readonly": "true"
+		} : {},
+		...options.accessibleLabel === void 0 ? {} : { "aria-label": options.accessibleLabel },
+		...options.labelledBy === void 0 ? {} : { "aria-labelledby": options.labelledBy },
+		...options.describedBy === void 0 ? {} : { "aria-describedby": options.describedBy },
+		...standards
+	};
+}
+/** Keep undefined checked uncontrolled, rather than filling it with a default. */
+function createSwitchProps(props = {}) {
+	return {
+		...props,
+		checked: typeof props.checked === "boolean" ? props.checked : void 0,
+		defaultChecked: typeof props.defaultChecked === "boolean" ? props.defaultChecked : false,
+		disabled: props.disabled === true,
+		readOnly: props.readOnly === true,
+		type: SWITCH_TYPES.includes(props.type) ? props.type : "button"
+	};
+}
+const cancelled = (event) => !!(event?.defaultPrevented || event?.nativeEvent?.defaultPrevented);
+function request(params, checked) {
+	const generation = params.refs.get("generation");
+	const apply = () => {
+		if (params.refs.get("active") && params.refs.get("generation") === generation && !params.prop("disabled") && !params.prop("readOnly") && !cancelled(params.event.activation)) params.context.set("checked", checked());
+	};
+	if (params.event.activation) queueMicrotask(apply);
+	else apply();
+}
+/** Shared request processing; final event cancellation includes later bubble listeners. */
+const switchMachine = createMachine({
+	props: ({ props }) => ({
+		...createSwitchProps(props),
+		initialSnapshot: props.initialSnapshot
+	}),
+	initialState: () => "ready",
+	states: { ready: {} },
+	context: ({ prop, bindable }) => {
+		const internalChecked = bindable(() => ({ defaultValue: typeof prop("initialSnapshot")?.internalChecked === "boolean" ? prop("initialSnapshot").internalChecked : prop("defaultChecked") ?? false }));
+		return {
+			checked: bindable(() => ({
+				defaultValue: internalChecked.get(),
+				value: prop("checked") ?? internalChecked.get(),
+				onChange(value) {
+					if (prop("checked") === void 0) internalChecked.set(value);
+					prop("onToggle")?.(value);
+				}
+			})),
+			internalChecked
+		};
+	},
+	refs: () => ({
+		active: false,
+		generation: 0
+	}),
+	effects: ["lifecycle"],
+	on: {
+		"CHECKED.TOGGLE": { actions: ["toggle"] },
+		"CHECKED.SET": { actions: ["setChecked"] }
+	},
+	implementations: {
+		effects: { lifecycle({ refs }) {
+			refs.set("active", true);
+			refs.set("generation", refs.get("generation") + 1);
+			return () => {
+				refs.set("active", false);
+				refs.set("generation", refs.get("generation") + 1);
+			};
+		} },
+		actions: {
+			toggle(params) {
+				request(params, () => !params.context.get("checked"));
+			},
+			setChecked(params) {
+				const event = params.event;
+				if (event.type === "CHECKED.SET" && typeof event.checked === "boolean") request(params, () => event.checked);
+			}
+		}
+	}
+});
+function connectSwitch(service, normalize, options = {}) {
+	const state = resolveSwitchState({
+		checked: service.context.get("checked"),
+		disabled: service.prop("disabled"),
+		readOnly: service.prop("readOnly"),
+		type: service.prop("type")
+	});
+	return {
+		checked: state.checked,
+		toggle: () => service.send({ type: "CHECKED.TOGGLE" }),
+		setChecked: (checked) => service.send({
+			type: "CHECKED.SET",
+			checked
+		}),
+		getSnapshot: () => Object.freeze({ internalChecked: service.context.get("internalChecked") }),
+		getThumbProps: () => normalize.element({ ...getSwitchThumbProps() }),
+		getRootProps: (root) => normalize.button({
+			...getSwitchRootProps(state, root ?? options.root),
+			onClick(event) {
+				if (service.prop("disabled")) return;
+				const callbacks = typeof options.onClick === "function" ? [options.onClick] : options.onClick ?? [];
+				for (const callback of callbacks) callback(event);
+				if (!cancelled(event)) service.send({
+					type: "CHECKED.TOGGLE",
+					activation: event
+				});
+			}
+		})
+	};
+}
+/** 生成旋钮属性。 */
+function getSwitchThumbProps() {
+	return {
+		"data-scope": "switch",
+		"data-part": "thumb",
+		"aria-hidden": "true"
+	};
+}
+//#endregion
+export { SWITCH_PARTS, SWITCH_TYPES, connectSwitch, createSwitchProps, getSwitchRootProps, getSwitchThumbProps, resolveSwitchState, switchMachine };
+
+//# sourceMappingURL=index.js.map

package/dist/switch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/switch/switch.ts"],"sourcesContent":["/**\n * Switch 的跨框架行为契约。\n *\n * Core Zag bindable owns controlled/uncontrolled state, requests and click cancellation.\n * Browser button semantics supply keyboard/default form actions; adapters only project getters.\n */\nimport { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\n\n/** Switch 各渲染部位全集（data-part 取值）。 */\nexport const SWITCH_PARTS = [\"root\", \"thumb\"] as const;\nexport const SWITCH_TYPES = [\"button\", \"submit\", \"reset\"] as const;\nexport type SwitchButtonType=(typeof SWITCH_TYPES)[number];\n\nexport type SwitchPart = (typeof SWITCH_PARTS)[number];\n\n/**\n * QwSwitchProps — 双栈共享的行为契约（全字段可选）。\n * checked 未传时走非受控模式，由Core bindable管理内部状态。\n */\nexport interface QwSwitchProps {\n  /** 受控值。未传时走非受控模式。 */\n  checked?: boolean;\n  /** 非受控初始值，默认 false。仅在 checked 未传时生效。 */\n  defaultChecked?: boolean;\n  /** 状态变化回调，参数为新的 checked 值。 */\n  onToggle?: (checked: boolean) => void;\n  /** 禁用状态。 */\n  disabled?: boolean;\n  /** Prevent switch requests while keeping native focus and explicit submit/reset behavior. */\n  readOnly?:boolean;\n  /** 原生 button 类型，默认 `button`。 */\n  type?: SwitchButtonType;\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedSwitchState {\n  checked: boolean;\n  disabled: boolean;\n  readOnly:boolean;\n  type: \"button\" | \"submit\" | \"reset\";\n}\n\n/** Core 生成、由适配器最后覆盖到根元素的属性。 */\nexport interface SwitchRootProps {\n  type: \"button\" | \"submit\" | \"reset\";\n  role: \"switch\";\n  disabled: boolean;\n  \"aria-checked\": \"true\" | \"false\";\n  \"data-scope\": \"switch\";\n  \"data-part\": \"root\";\n  \"data-checked\": \"true\" | \"false\";\n  \"data-disabled\"?: \"true\";\n}\n\n/** 旋钮属性（纯视觉元素）。 */\nexport interface SwitchThumbProps {\n  \"data-scope\": \"switch\";\n  \"data-part\": \"thumb\";\n  \"aria-hidden\": \"true\";\n}\n\n/** 将公开输入归一化为唯一的跨框架状态。 */\nexport function resolveSwitchState(props: QwSwitchProps = {}): ResolvedSwitchState {\n  const normalized=createSwitchProps(props);\n  return {\n    checked: normalized.checked ?? normalized.defaultChecked ?? false,\n    disabled: normalized.disabled ?? false,\n    readOnly:normalized.readOnly ?? false,\n    type: normalized.type ?? \"button\",\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport interface SwitchRootOptions {accessibleLabel?:string;labelledBy?:string;describedBy?:string;name?:string;value?:string;form?:string;title?:string;lang?:string;dir?:string;hidden?:boolean}\nexport function getSwitchRootProps(state: ResolvedSwitchState,options:SwitchRootOptions={}): SwitchRootProps & {\"aria-readonly\"?:\"true\";\"data-readonly\"?:\"true\";\"aria-label\"?:string;\"aria-labelledby\"?:string;\"aria-describedby\"?:string;name?:string;value?:string;form?:string;title?:string;lang?:string;dir?:string;hidden?:boolean} {\n  const standards:Record<string,string|boolean>={};\n  for(const key of [\"name\",\"value\",\"form\",\"title\",\"lang\",\"dir\",\"hidden\"] as const)if(options[key]!==undefined)standards[key]=options[key]!;\n  return {\n    type: state.type,\n    role: \"switch\",\n    disabled: state.disabled,\n    \"aria-checked\": state.checked ? \"true\" : \"false\",\n    \"data-scope\": \"switch\",\n    \"data-part\": \"root\",\n    \"data-checked\": state.checked ? \"true\" : \"false\",\n    ...(state.disabled ? { \"data-disabled\": \"true\" as const } : {}),\n    ...(state.readOnly?{\"aria-readonly\":\"true\" as const,\"data-readonly\":\"true\" as const}:{}),\n    ...(options.accessibleLabel===undefined?{}:{\"aria-label\":options.accessibleLabel}),\n    ...(options.labelledBy===undefined?{}:{\"aria-labelledby\":options.labelledBy}),\n    ...(options.describedBy===undefined?{}:{\"aria-describedby\":options.describedBy}),...standards,\n  };\n}\n\n/** Common cancellation contract; framework/native events are transported without copying state rules. */\nexport interface SwitchActivationEvent {readonly defaultPrevented:boolean;readonly nativeEvent?:{readonly defaultPrevented:boolean};preventDefault?:()=>void}\nexport type SwitchClickHandler=(event:SwitchActivationEvent)=>void;\nexport interface SwitchConnectOptions {root?:SwitchRootOptions;onClick?:SwitchClickHandler|readonly SwitchClickHandler[]}\n/** Independent uncontrolled memory transported by adapter lifecycle snapshots. */\nexport interface SwitchStateSnapshot {readonly internalChecked:boolean}\n/** Keep undefined checked uncontrolled, rather than filling it with a default. */\nexport function createSwitchProps(props:QwSwitchProps={}):QwSwitchProps {\n  return {...props,checked:typeof props.checked===\"boolean\"?props.checked:undefined,defaultChecked:typeof props.defaultChecked===\"boolean\"?props.defaultChecked:false,\n    disabled:props.disabled===true,readOnly:props.readOnly===true,type:SWITCH_TYPES.includes(props.type!)?props.type!:\"button\"};\n}\nexport interface QwSwitchSchema {\n  props:QwSwitchProps & {initialSnapshot?:SwitchStateSnapshot};context:{checked:boolean;internalChecked:boolean};state:\"ready\";action:\"toggle\"|\"setChecked\";\n  refs:{active:boolean;generation:number};effect:\"lifecycle\";\n  event:{type:\"CHECKED.TOGGLE\";activation?:SwitchActivationEvent}|{type:\"CHECKED.SET\";checked:boolean;activation?:SwitchActivationEvent};\n}\nexport type QwSwitchMachine=Machine<QwSwitchSchema>;\nexport type QwSwitchService=Service<QwSwitchSchema>;\nconst cancelled=(event:SwitchActivationEvent|undefined)=>!!(event?.defaultPrevented || event?.nativeEvent?.defaultPrevented);\nfunction request(params:Params<QwSwitchSchema>,checked:()=>boolean):void {\n  const generation=params.refs.get(\"generation\");\n  const apply=()=>{if(params.refs.get(\"active\") && params.refs.get(\"generation\")===generation && !params.prop(\"disabled\") && !params.prop(\"readOnly\") && !cancelled(params.event.activation))params.context.set(\"checked\",checked());};\n  // Framework services can send synchronously. Wait for complete click propagation in Core,\n  // while the immediate send still establishes the native updateComplete barrier.\n  if(params.event.activation)queueMicrotask(apply);else apply();\n}\n/** Shared request processing; final event cancellation includes later bubble listeners. */\nexport const switchMachine:QwSwitchMachine=createMachine<QwSwitchSchema>({\n  props:({props})=>({...createSwitchProps(props),initialSnapshot:props.initialSnapshot}),initialState:()=>\"ready\",states:{ready:{}},\n  context:({prop,bindable})=>{\n    // Preserve the existing adapters' independent uncontrolled memory, even when first mounted controlled.\n    const internalChecked=bindable<boolean>(()=>({defaultValue:typeof prop(\"initialSnapshot\")?.internalChecked===\"boolean\"?prop(\"initialSnapshot\")!.internalChecked:prop(\"defaultChecked\")??false}));\n    const checked=bindable<boolean>(()=>({defaultValue:internalChecked.get(),value:prop(\"checked\")??internalChecked.get(),onChange(value){if(prop(\"checked\")===undefined)internalChecked.set(value);prop(\"onToggle\")?.(value);}}));\n    return {checked,internalChecked};\n  },\n  refs:()=>({active:false,generation:0}),effects:[\"lifecycle\"],\n  on:{\"CHECKED.TOGGLE\":{actions:[\"toggle\"]},\"CHECKED.SET\":{actions:[\"setChecked\"]}},\n  implementations:{effects:{lifecycle({refs}){refs.set(\"active\",true);refs.set(\"generation\",refs.get(\"generation\")+1);return()=>{refs.set(\"active\",false);refs.set(\"generation\",refs.get(\"generation\")+1);};}},actions:{\n    toggle(params){request(params,()=>!params.context.get(\"checked\"));},\n    setChecked(params){const event=params.event;if(event.type===\"CHECKED.SET\" && typeof event.checked===\"boolean\")request(params,()=>event.checked);},\n  }},\n});\nexport interface QwSwitchApi<T extends PropTypes=PropTypes>{checked:boolean;toggle():void;setChecked(checked:boolean):void;getSnapshot():SwitchStateSnapshot;getRootProps(root?:SwitchRootOptions):T[\"button\"];getThumbProps():T[\"element\"]}\nexport function connectSwitch<T extends PropTypes>(service:QwSwitchService,normalize:NormalizeProps<T>,options:SwitchConnectOptions={}):QwSwitchApi<T> {\n  const state=resolveSwitchState({checked:service.context.get(\"checked\"),disabled:service.prop(\"disabled\"),readOnly:service.prop(\"readOnly\"),type:service.prop(\"type\")});\n  return {checked:state.checked,toggle:()=>service.send({type:\"CHECKED.TOGGLE\"}),setChecked:checked=>service.send({type:\"CHECKED.SET\",checked}),\n    getSnapshot:()=>Object.freeze({internalChecked:service.context.get(\"internalChecked\")}),\n    getThumbProps:()=>normalize.element({...getSwitchThumbProps()}),\n    getRootProps:root=>normalize.button({...getSwitchRootProps(state,root??options.root),onClick(event:SwitchActivationEvent){\n      if(service.prop(\"disabled\"))return;\n      const callbacks=typeof options.onClick===\"function\"?[options.onClick]:options.onClick??[];\n      for(const callback of callbacks)callback(event);\n      if(!cancelled(event))service.send({type:\"CHECKED.TOGGLE\",activation:event});\n    }}),\n  };\n}\n\n/** 生成旋钮属性。 */\nexport function getSwitchThumbProps(): SwitchThumbProps {\n  return {\n    \"data-scope\": \"switch\",\n    \"data-part\": \"thumb\",\n    \"aria-hidden\": \"true\",\n  };\n}\n"],"mappings":"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"}

package/dist/switch/switch.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Switch 的跨框架行为契约。
+ *
+ * Core Zag bindable owns controlled/uncontrolled state, requests and click cancellation.
+ * Browser button semantics supply keyboard/default form actions; adapters only project getters.
+ */
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+/** Switch 各渲染部位全集（data-part 取值）。 */
+export declare const SWITCH_PARTS: readonly ["root", "thumb"];
+export declare const SWITCH_TYPES: readonly ["button", "submit", "reset"];
+export type SwitchButtonType = (typeof SWITCH_TYPES)[number];
+export type SwitchPart = (typeof SWITCH_PARTS)[number];
+/**
+ * QwSwitchProps — 双栈共享的行为契约（全字段可选）。
+ * checked 未传时走非受控模式，由Core bindable管理内部状态。
+ */
+export interface QwSwitchProps {
+    /** 受控值。未传时走非受控模式。 */
+    checked?: boolean;
+    /** 非受控初始值，默认 false。仅在 checked 未传时生效。 */
+    defaultChecked?: boolean;
+    /** 状态变化回调，参数为新的 checked 值。 */
+    onToggle?: (checked: boolean) => void;
+    /** 禁用状态。 */
+    disabled?: boolean;
+    /** Prevent switch requests while keeping native focus and explicit submit/reset behavior. */
+    readOnly?: boolean;
+    /** 原生 button 类型，默认 `button`。 */
+    type?: SwitchButtonType;
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedSwitchState {
+    checked: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    type: "button" | "submit" | "reset";
+}
+/** Core 生成、由适配器最后覆盖到根元素的属性。 */
+export interface SwitchRootProps {
+    type: "button" | "submit" | "reset";
+    role: "switch";
+    disabled: boolean;
+    "aria-checked": "true" | "false";
+    "data-scope": "switch";
+    "data-part": "root";
+    "data-checked": "true" | "false";
+    "data-disabled"?: "true";
+}
+/** 旋钮属性（纯视觉元素）。 */
+export interface SwitchThumbProps {
+    "data-scope": "switch";
+    "data-part": "thumb";
+    "aria-hidden": "true";
+}
+/** 将公开输入归一化为唯一的跨框架状态。 */
+export declare function resolveSwitchState(props?: QwSwitchProps): ResolvedSwitchState;
+/** 将归一化结果转成 root 属性。 */
+export interface SwitchRootOptions {
+    accessibleLabel?: string;
+    labelledBy?: string;
+    describedBy?: string;
+    name?: string;
+    value?: string;
+    form?: string;
+    title?: string;
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+}
+export declare function getSwitchRootProps(state: ResolvedSwitchState, options?: SwitchRootOptions): SwitchRootProps & {
+    "aria-readonly"?: "true";
+    "data-readonly"?: "true";
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    name?: string;
+    value?: string;
+    form?: string;
+    title?: string;
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+};
+/** Common cancellation contract; framework/native events are transported without copying state rules. */
+export interface SwitchActivationEvent {
+    readonly defaultPrevented: boolean;
+    readonly nativeEvent?: {
+        readonly defaultPrevented: boolean;
+    };
+    preventDefault?: () => void;
+}
+export type SwitchClickHandler = (event: SwitchActivationEvent) => void;
+export interface SwitchConnectOptions {
+    root?: SwitchRootOptions;
+    onClick?: SwitchClickHandler | readonly SwitchClickHandler[];
+}
+/** Independent uncontrolled memory transported by adapter lifecycle snapshots. */
+export interface SwitchStateSnapshot {
+    readonly internalChecked: boolean;
+}
+/** Keep undefined checked uncontrolled, rather than filling it with a default. */
+export declare function createSwitchProps(props?: QwSwitchProps): QwSwitchProps;
+export interface QwSwitchSchema {
+    props: QwSwitchProps & {
+        initialSnapshot?: SwitchStateSnapshot;
+    };
+    context: {
+        checked: boolean;
+        internalChecked: boolean;
+    };
+    state: "ready";
+    action: "toggle" | "setChecked";
+    refs: {
+        active: boolean;
+        generation: number;
+    };
+    effect: "lifecycle";
+    event: {
+        type: "CHECKED.TOGGLE";
+        activation?: SwitchActivationEvent;
+    } | {
+        type: "CHECKED.SET";
+        checked: boolean;
+        activation?: SwitchActivationEvent;
+    };
+}
+export type QwSwitchMachine = Machine<QwSwitchSchema>;
+export type QwSwitchService = Service<QwSwitchSchema>;
+/** Shared request processing; final event cancellation includes later bubble listeners. */
+export declare const switchMachine: QwSwitchMachine;
+export interface QwSwitchApi<T extends PropTypes = PropTypes> {
+    checked: boolean;
+    toggle(): void;
+    setChecked(checked: boolean): void;
+    getSnapshot(): SwitchStateSnapshot;
+    getRootProps(root?: SwitchRootOptions): T["button"];
+    getThumbProps(): T["element"];
+}
+export declare function connectSwitch<T extends PropTypes>(service: QwSwitchService, normalize: NormalizeProps<T>, options?: SwitchConnectOptions): QwSwitchApi<T>;
+/** 生成旋钮属性。 */
+export declare function getSwitchThumbProps(): SwitchThumbProps;

package/dist/tabbar/index.d.ts

@@ -0,0 +1 @@
+export * from "./tabbar.js";

package/dist/tabbar/index.js

@@ -0,0 +1,95 @@
+//#region src/tabbar/tabbar.ts
+/**
+* TabBar 的跨框架行为契约。
+*
+* TabBar 是无状态的 Prototype A 底部操作栏：白底容器 + 顶部 1px 分割线 +
+* 1–N 个等宽 L 号按钮（组合已交付的 Button）。这里仅归一化公开 props 与
+* item → Button 的档位映射，React/Vue 适配器不得复制可见性、默认档位或
+* 映射规则。
+*/
+const TABBAR_ITEM_VARIANTS = ["primary", "secondary"];
+const TABBAR_ITEM_TONES = ["brand", "neutral"];
+const TABBAR_PARTS = ["root"];
+/** 将公开输入归一化为唯一的跨框架状态；items 缺省/空 → 不可见。 */
+function resolveTabBarState(props = {}) {
+	const items = (props.items ?? []).map((item) => ({
+		text: item.text,
+		variant: item.variant ?? "primary",
+		tone: item.tone ?? "brand",
+		disabled: item.disabled ?? false,
+		loading: item.loading ?? false,
+		...item.onClick ? { onClick: item.onClick } : {}
+	}));
+	return {
+		visible: items.length > 0,
+		count: items.length,
+		items
+	};
+}
+/** 将归一化结果转成 root 属性。 */
+function getTabBarRootProps(state) {
+	return {
+		"data-scope": "tabbar",
+		"data-part": "root",
+		"data-count": String(state.count)
+	};
+}
+/** 将单个操作项映射为 Button props（档位收口，适配器不得覆盖）。 */
+function getTabBarItemButtonProps(item) {
+	return {
+		variant: item.variant === "primary" ? "solid" : "soft",
+		tone: item.tone,
+		size: "l",
+		disabled: item.disabled,
+		loading: item.loading
+	};
+}
+function resolveTabBarNavigation(props) {
+	return {
+		navigation: props.mode === "navigation",
+		tag: props.mode === "navigation" ? "nav" : "div",
+		items: props.mode === "navigation" ? [...props.navigationItems ?? []] : []
+	};
+}
+function getTabBarNavigationRootProps(props) {
+	return {
+		"data-scope": "tabbar",
+		"data-part": "root",
+		"data-mode": "navigation",
+		"aria-label": props.label ?? "Page navigation"
+	};
+}
+function getTabBarNavigationItemTag(item) {
+	return item.href ? "a" : "button";
+}
+function getTabBarNavigationItemProps(props, item) {
+	return {
+		"data-scope": "tabbar",
+		"data-part": "navigation-item",
+		"data-value": item.id,
+		"data-active": props.value === item.id ? "true" : "false",
+		...props.value === item.id ? { "aria-current": "page" } : {},
+		...item.href ? item.disabled ? {
+			role: "link",
+			"aria-disabled": true,
+			tabIndex: -1
+		} : { href: item.href } : {
+			type: "button",
+			disabled: item.disabled ?? false
+		},
+		onClick(event) {
+			if (props.mode !== "navigation" || item.disabled) {
+				event.preventDefault();
+				return;
+			}
+			props.onValueChange?.({
+				value: item.id,
+				previousValue: props.value
+			});
+		}
+	};
+}
+//#endregion
+export { TABBAR_ITEM_TONES, TABBAR_ITEM_VARIANTS, TABBAR_PARTS, getTabBarItemButtonProps, getTabBarNavigationItemProps, getTabBarNavigationItemTag, getTabBarNavigationRootProps, getTabBarRootProps, resolveTabBarNavigation, resolveTabBarState };
+
+//# sourceMappingURL=index.js.map

package/dist/tabbar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tabbar/tabbar.ts"],"sourcesContent":["/**\n * TabBar 的跨框架行为契约。\n *\n * TabBar 是无状态的 Prototype A 底部操作栏：白底容器 + 顶部 1px 分割线 +\n * 1–N 个等宽 L 号按钮（组合已交付的 Button）。这里仅归一化公开 props 与\n * item → Button 的档位映射，React/Vue 适配器不得复制可见性、默认档位或\n * 映射规则。\n */\n\nexport const TABBAR_ITEM_VARIANTS = [\"primary\", \"secondary\"] as const;\nexport const TABBAR_ITEM_TONES = [\"brand\", \"neutral\"] as const;\nexport const TABBAR_PARTS = [\"root\"] as const;\n\nexport type TabBarItemVariant = (typeof TABBAR_ITEM_VARIANTS)[number];\nexport type TabBarItemTone = (typeof TABBAR_ITEM_TONES)[number];\nexport type TabBarPart = (typeof TABBAR_PARTS)[number];\n\n/** 单个操作项声明；双栈共享，框架特有的事件通道不进入 Core。 */\nexport interface QwTabBarItemProps {\n  /** 按钮文案，同时作为可访问名。 */\n  text: string;\n  /** 视觉档位，默认 `primary`。primary→Button solid；secondary→Button soft。 */\n  variant?: TabBarItemVariant;\n  /** 语气，默认 `brand`。 */\n  tone?: TabBarItemTone;\n  /** 原生禁用状态。 */\n  disabled?: boolean;\n  /** 忙碌态，沿用 Button loading 契约。 */\n  loading?: boolean;\n  /** 点击（含键盘激活）回调。 */\n  onClick?: () => void;\n}\n\n/** 双栈共享的标量 props。 */\nexport interface QwTabBarProps {\n  /** Beta: opt-in page navigation; the default remains the legacy action bar. */\n  mode?: \"actions\" | \"navigation\";\n  navigationItems?: readonly TabBarNavigationItem[];\n  /** Controlled active page id; requesting a value never changes it automatically. */\n  value?: string;\n  /** Navigation landmark accessible name. */\n  label?: string;\n  onValueChange?: (details: TabBarValueChangeDetails) => void;\n  /** 操作项列表；缺省或空数组时组件不渲染。 */\n  items?: readonly QwTabBarItemProps[];\n}\n\n/** 逐项归一化结果。 */\nexport interface ResolvedTabBarItemState {\n  text: string;\n  variant: TabBarItemVariant;\n  tone: TabBarItemTone;\n  disabled: boolean;\n  loading: boolean;\n  onClick?: () => void;\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedTabBarState {\n  visible: boolean;\n  count: number;\n  items: ResolvedTabBarItemState[];\n}\n\n/** Core 生成、由适配器摊到根元素的属性。 */\nexport interface TabBarRootProps {\n  \"data-scope\": \"tabbar\";\n  \"data-part\": \"root\";\n  \"data-count\": string;\n}\n\n/** item → Button 的档位映射结果（size 固定 l）。 */\nexport interface TabBarItemButtonProps {\n  variant: \"solid\" | \"soft\";\n  tone: \"brand\" | \"neutral\";\n  size: \"l\";\n  disabled: boolean;\n  loading: boolean;\n}\n\n/** 将公开输入归一化为唯一的跨框架状态；items 缺省/空 → 不可见。 */\nexport function resolveTabBarState(props: QwTabBarProps = {}): ResolvedTabBarState {\n  const items = (props.items ?? []).map((item) => ({\n    text: item.text,\n    variant: item.variant ?? \"primary\",\n    tone: item.tone ?? \"brand\",\n    disabled: item.disabled ?? false,\n    loading: item.loading ?? false,\n    ...(item.onClick ? { onClick: item.onClick } : {}),\n  }));\n  return {\n    visible: items.length > 0,\n    count: items.length,\n    items,\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport function getTabBarRootProps(state: ResolvedTabBarState): TabBarRootProps {\n  return {\n    \"data-scope\": \"tabbar\",\n    \"data-part\": \"root\",\n    \"data-count\": String(state.count),\n  };\n}\n\n/** 将单个操作项映射为 Button props（档位收口，适配器不得覆盖）。 */\nexport function getTabBarItemButtonProps(item: ResolvedTabBarItemState): TabBarItemButtonProps {\n  return {\n    variant: item.variant === \"primary\" ? \"solid\" : \"soft\",\n    tone: item.tone,\n    size: \"l\",\n    disabled: item.disabled,\n    loading: item.loading,\n  };\n}\n\n/** Beta page navigation item. icon is a decorative text glyph, not an icon asset name. */\nexport interface TabBarNavigationItem { id: string; text: string; icon?: string; iconSrc?: string; href?: string; disabled?: boolean }\nexport interface TabBarValueChangeDetails { value: string; previousValue: string | undefined }\nexport interface TabBarNavigationItemProps {\n  \"data-scope\": \"tabbar\";\n  \"data-part\": \"navigation-item\";\n  \"data-value\": string;\n  \"data-active\": \"true\" | \"false\";\n  \"aria-current\"?: \"page\";\n  \"aria-disabled\"?: true;\n  disabled?: boolean;\n  href?: string;\n  role?: \"link\";\n  tabIndex?: number;\n  type?: \"button\";\n  onClick: (event: { preventDefault(): void }) => void;\n}\nexport function resolveTabBarNavigation(props: QwTabBarProps) {\n  return {\n    navigation: props.mode === \"navigation\",\n    tag: props.mode === \"navigation\" ? \"nav\" as const : \"div\" as const,\n    items: props.mode === \"navigation\" ? [...(props.navigationItems ?? [])] : [],\n  };\n}\nexport function getTabBarNavigationRootProps(props: QwTabBarProps) {\n  return { \"data-scope\": \"tabbar\", \"data-part\": \"root\", \"data-mode\": \"navigation\", \"aria-label\": props.label ?? \"Page navigation\" } as const;\n}\nexport function getTabBarNavigationItemTag(item: TabBarNavigationItem): \"a\" | \"button\" { return item.href ? \"a\" : \"button\"; }\nexport function getTabBarNavigationItemProps(props: QwTabBarProps, item: TabBarNavigationItem): TabBarNavigationItemProps {\n  return {\n    \"data-scope\": \"tabbar\", \"data-part\": \"navigation-item\", \"data-value\": item.id, \"data-active\": props.value === item.id ? \"true\" : \"false\",\n    ...(props.value === item.id ? { \"aria-current\": \"page\" as const } : {}),\n    ...(item.href ? item.disabled ? { role: \"link\" as const, \"aria-disabled\": true as const, tabIndex: -1 } : { href: item.href }\n      : { type: \"button\" as const, disabled: item.disabled ?? false }),\n    onClick(event) {\n      if (props.mode !== \"navigation\" || item.disabled) { event.preventDefault(); return; }\n      props.onValueChange?.({ value: item.id, previousValue: props.value });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,uBAAuB,CAAC,WAAW,WAAW;AAC3D,MAAa,oBAAoB,CAAC,SAAS,SAAS;AACpD,MAAa,eAAe,CAAC,MAAM;;AAsEnC,SAAgB,mBAAmB,QAAuB,CAAC,GAAwB;CACjF,MAAM,SAAS,MAAM,SAAS,CAAC,EAAA,CAAG,KAAK,UAAU;EAC/C,MAAM,KAAK;EACX,SAAS,KAAK,WAAW;EACzB,MAAM,KAAK,QAAQ;EACnB,UAAU,KAAK,YAAY;EAC3B,SAAS,KAAK,WAAW;EACzB,GAAI,KAAK,UAAU,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;CAClD,EAAE;CACF,OAAO;EACL,SAAS,MAAM,SAAS;EACxB,OAAO,MAAM;EACb;CACF;AACF;;AAGA,SAAgB,mBAAmB,OAA6C;CAC9E,OAAO;EACL,cAAc;EACd,aAAa;EACb,cAAc,OAAO,MAAM,KAAK;CAClC;AACF;;AAGA,SAAgB,yBAAyB,MAAsD;CAC7F,OAAO;EACL,SAAS,KAAK,YAAY,YAAY,UAAU;EAChD,MAAM,KAAK;EACX,MAAM;EACN,UAAU,KAAK;EACf,SAAS,KAAK;CAChB;AACF;AAmBA,SAAgB,wBAAwB,OAAsB;CAC5D,OAAO;EACL,YAAY,MAAM,SAAS;EAC3B,KAAK,MAAM,SAAS,eAAe,QAAiB;EACpD,OAAO,MAAM,SAAS,eAAe,CAAC,GAAI,MAAM,mBAAmB,CAAC,CAAE,IAAI,CAAC;CAC7E;AACF;AACA,SAAgB,6BAA6B,OAAsB;CACjE,OAAO;EAAE,cAAc;EAAU,aAAa;EAAQ,aAAa;EAAc,cAAc,MAAM,SAAS;CAAkB;AAClI;AACA,SAAgB,2BAA2B,MAA4C;CAAE,OAAO,KAAK,OAAO,MAAM;AAAU;AAC5H,SAAgB,6BAA6B,OAAsB,MAAuD;CACxH,OAAO;EACL,cAAc;EAAU,aAAa;EAAmB,cAAc,KAAK;EAAI,eAAe,MAAM,UAAU,KAAK,KAAK,SAAS;EACjI,GAAI,MAAM,UAAU,KAAK,KAAK,EAAE,gBAAgB,OAAgB,IAAI,CAAC;EACrE,GAAI,KAAK,OAAO,KAAK,WAAW;GAAE,MAAM;GAAiB,iBAAiB;GAAe,UAAU;EAAG,IAAI,EAAE,MAAM,KAAK,KAAK,IACxH;GAAE,MAAM;GAAmB,UAAU,KAAK,YAAY;EAAM;EAChE,QAAQ,OAAO;GACb,IAAI,MAAM,SAAS,gBAAgB,KAAK,UAAU;IAAE,MAAM,eAAe;IAAG;GAAQ;GACpF,MAAM,gBAAgB;IAAE,OAAO,KAAK;IAAI,eAAe,MAAM;GAAM,CAAC;EACtE;CACF;AACF"}

package/dist/tabbar/tabbar.d.ts

@@ -0,0 +1,119 @@
+/**
+ * TabBar 的跨框架行为契约。
+ *
+ * TabBar 是无状态的 Prototype A 底部操作栏：白底容器 + 顶部 1px 分割线 +
+ * 1–N 个等宽 L 号按钮（组合已交付的 Button）。这里仅归一化公开 props 与
+ * item → Button 的档位映射，React/Vue 适配器不得复制可见性、默认档位或
+ * 映射规则。
+ */
+export declare const TABBAR_ITEM_VARIANTS: readonly ["primary", "secondary"];
+export declare const TABBAR_ITEM_TONES: readonly ["brand", "neutral"];
+export declare const TABBAR_PARTS: readonly ["root"];
+export type TabBarItemVariant = (typeof TABBAR_ITEM_VARIANTS)[number];
+export type TabBarItemTone = (typeof TABBAR_ITEM_TONES)[number];
+export type TabBarPart = (typeof TABBAR_PARTS)[number];
+/** 单个操作项声明；双栈共享，框架特有的事件通道不进入 Core。 */
+export interface QwTabBarItemProps {
+    /** 按钮文案，同时作为可访问名。 */
+    text: string;
+    /** 视觉档位，默认 `primary`。primary→Button solid；secondary→Button soft。 */
+    variant?: TabBarItemVariant;
+    /** 语气，默认 `brand`。 */
+    tone?: TabBarItemTone;
+    /** 原生禁用状态。 */
+    disabled?: boolean;
+    /** 忙碌态，沿用 Button loading 契约。 */
+    loading?: boolean;
+    /** 点击（含键盘激活）回调。 */
+    onClick?: () => void;
+}
+/** 双栈共享的标量 props。 */
+export interface QwTabBarProps {
+    /** Beta: opt-in page navigation; the default remains the legacy action bar. */
+    mode?: "actions" | "navigation";
+    navigationItems?: readonly TabBarNavigationItem[];
+    /** Controlled active page id; requesting a value never changes it automatically. */
+    value?: string;
+    /** Navigation landmark accessible name. */
+    label?: string;
+    onValueChange?: (details: TabBarValueChangeDetails) => void;
+    /** 操作项列表；缺省或空数组时组件不渲染。 */
+    items?: readonly QwTabBarItemProps[];
+}
+/** 逐项归一化结果。 */
+export interface ResolvedTabBarItemState {
+    text: string;
+    variant: TabBarItemVariant;
+    tone: TabBarItemTone;
+    disabled: boolean;
+    loading: boolean;
+    onClick?: () => void;
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedTabBarState {
+    visible: boolean;
+    count: number;
+    items: ResolvedTabBarItemState[];
+}
+/** Core 生成、由适配器摊到根元素的属性。 */
+export interface TabBarRootProps {
+    "data-scope": "tabbar";
+    "data-part": "root";
+    "data-count": string;
+}
+/** item → Button 的档位映射结果（size 固定 l）。 */
+export interface TabBarItemButtonProps {
+    variant: "solid" | "soft";
+    tone: "brand" | "neutral";
+    size: "l";
+    disabled: boolean;
+    loading: boolean;
+}
+/** 将公开输入归一化为唯一的跨框架状态；items 缺省/空 → 不可见。 */
+export declare function resolveTabBarState(props?: QwTabBarProps): ResolvedTabBarState;
+/** 将归一化结果转成 root 属性。 */
+export declare function getTabBarRootProps(state: ResolvedTabBarState): TabBarRootProps;
+/** 将单个操作项映射为 Button props（档位收口，适配器不得覆盖）。 */
+export declare function getTabBarItemButtonProps(item: ResolvedTabBarItemState): TabBarItemButtonProps;
+/** Beta page navigation item. icon is a decorative text glyph, not an icon asset name. */
+export interface TabBarNavigationItem {
+    id: string;
+    text: string;
+    icon?: string;
+    iconSrc?: string;
+    href?: string;
+    disabled?: boolean;
+}
+export interface TabBarValueChangeDetails {
+    value: string;
+    previousValue: string | undefined;
+}
+export interface TabBarNavigationItemProps {
+    "data-scope": "tabbar";
+    "data-part": "navigation-item";
+    "data-value": string;
+    "data-active": "true" | "false";
+    "aria-current"?: "page";
+    "aria-disabled"?: true;
+    disabled?: boolean;
+    href?: string;
+    role?: "link";
+    tabIndex?: number;
+    type?: "button";
+    onClick: (event: {
+        preventDefault(): void;
+    }) => void;
+}
+export declare function resolveTabBarNavigation(props: QwTabBarProps): {
+    navigation: boolean;
+    tag: "div" | "nav";
+    items: TabBarNavigationItem[];
+};
+export declare function getTabBarNavigationRootProps(props: QwTabBarProps): {
+    readonly "data-scope": "tabbar";
+    readonly "data-part": "root";
+    readonly "data-mode": "navigation";
+    readonly "aria-label": string;
+};
+export declare function getTabBarNavigationItemTag(item: TabBarNavigationItem): "a" | "button";
+export declare function getTabBarNavigationItemProps(props: QwTabBarProps, item: TabBarNavigationItem): TabBarNavigationItemProps;

package/dist/tabs/index.js

@@ -1,4 +1,4 @@
-import { connect, machine as tabsMachine } from "@zag-js/tabs";
+import { connect as connect$1, machine as tabsMachine } from "@zag-js/tabs";
 //#region src/tabs/tabs.ts
 /**
 * Tabs 契约 — 原型 B（有状态），core 包裹 zag.js tabs machine。
@@ -13,6 +13,27 @@ const TABS_LEVELS = ["primary", "secondary"];
 const TABS_VARIANTS = ["text", "button"];
 /** 字号全集：仅 primary 生效，"14" / "16"（默认）。 */
 const TABS_SIZES = ["14", "16"];
+/** Nonempty all-disabled lists retain native keyboard scrolling without activating a trigger. */
+function connect(service, normalize) {
+	const api = connect$1(service, normalize);
+	return {
+		...api,
+		getListProps(items) {
+			if (!items?.length || !items.every((item) => item.disabled)) return api.getListProps();
+			return connect$1(service, {
+				...normalize,
+				element(raw) {
+					const props = {
+						...raw,
+						tabIndex: 0
+					};
+					delete props.onKeyDown;
+					return normalize.element(props);
+				}
+			}).getListProps();
+		}
+	};
+}
 /**
 * 把 QwTabsProps 的行为 props 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。
 * 视觉 props（level/variant/size）不出现在返回值中——它们是适配层 data-* 属性。

package/dist/tabs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/tabs/tabs.ts"],"sourcesContent":["import type { Props as ZagTabsProps, ValueChangeDetails } from \"@zag-js/tabs\";\n\n/**\n * Tabs 契约 — 原型 B（有状态），core 包裹 zag.js tabs machine。\n * 行为 props 进 createTabsProps → zag context；视觉 props（level/variant/size）\n * 不进 machine，由适配层挂 data-* 属性驱动 CSS。\n *\n * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。\n */\n\n/** 导航层级全集：primary 一级导航（默认）/ secondary 二级导航。 */\nexport const TABS_LEVELS = [\"primary\", \"secondary\"] as const;\nexport type TabsLevel = (typeof TABS_LEVELS)[number];\n\n/** 视觉形态全集：text 纯文本（默认）/ button 按钮。button 仅 secondary 支持。 */\nexport const TABS_VARIANTS = [\"text\", \"button\"] as const;\nexport type TabsVariant = (typeof TABS_VARIANTS)[number];\n\n/** 字号全集：仅 primary 生效，\"14\" / \"16\"（默认）。 */\nexport const TABS_SIZES = [\"14\", \"16\"] as const;\nexport type TabsSize = (typeof TABS_SIZES)[number];\n\n/**\n * QwTabsProps — 双栈共享的行为 + 视觉契约。\n * 行为 props（进 createTabsProps → zag machine）：\n * - loop（默认 true）→ zag loopFocus；\n * - value / defaultValue / activationMode 透传；\n * - onValueChange 适配 zag details。\n * 视觉 props（不进 machine，适配层挂 data-*）：\n * - level / variant / size。\n */\nexport interface QwTabsProps {\n  /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控当前项。 */\n  value?: string | null;\n  /** 非受控初值。 */\n  defaultValue?: string | null;\n  /** 激活模式，默认 automatic（聚焦即激活）。 */\n  activationMode?: \"manual\" | \"automatic\";\n  /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */\n  loop?: boolean;\n  /** 选中项变化回调；zag 原生 onValueChange。 */\n  onValueChange?: (e: { value: string }) => void;\n  /** 导航层级，默认 primary。 */\n  level?: TabsLevel;\n  /** 视觉形态，默认 text。level=primary 时强制 text。 */\n  variant?: TabsVariant;\n  /** 字号，默认 \"16\"。仅 level=primary 生效。 */\n  size?: TabsSize;\n}\n\n/**\n * 直接 re-export zag tabs 的 machine 与 connect —— 不包一层。\n * 用 re-export 保留原始可移植类型 (避免 TS2742)。\n */\nexport { machine as tabsMachine, connect } from \"@zag-js/tabs\";\n\n/** rebrand zag 的 TabsApi 类型对外。 */\nexport type { Api as QwTabsApi } from \"@zag-js/tabs\";\n\n/**\n * 把 QwTabsProps 的行为 props 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。\n * 视觉 props（level/variant/size）不出现在返回值中——它们是适配层 data-* 属性。\n * 用法：`useMachine(tabsMachine, createTabsProps(props))`。\n */\nexport function createTabsProps(props: QwTabsProps = {}): Partial<ZagTabsProps> {\n  const ctx: Partial<ZagTabsProps> = {\n    id: props.id,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    activationMode: props.activationMode,\n    loopFocus: props.loop !== false,\n  };\n\n  if (props.onValueChange) {\n    const cb = props.onValueChange;\n    ctx.onValueChange = (d: ValueChangeDetails) => cb({ value: d.value });\n  }\n\n  return ctx;\n}\n"],"mappings":";;;;;;;;;;AAWA,MAAa,cAAc,CAAC,WAAW,WAAW;;AAIlD,MAAa,gBAAgB,CAAC,QAAQ,QAAQ;;AAI9C,MAAa,aAAa,CAAC,MAAM,IAAI;;;;;;AA+CrC,SAAgB,gBAAgB,QAAqB,CAAC,GAA0B;CAC9E,MAAM,MAA6B;EACjC,IAAI,MAAM;EACV,OAAO,MAAM;EACb,cAAc,MAAM;EACpB,gBAAgB,MAAM;EACtB,WAAW,MAAM,SAAS;CAC5B;CAEA,IAAI,MAAM,eAAe;EACvB,MAAM,KAAK,MAAM;EACjB,IAAI,iBAAiB,MAA0B,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;CACtE;CAEA,OAAO;AACT"}
+{"version":3,"file":"index.js","names":["zagConnect"],"sources":["../../src/tabs/tabs.ts"],"sourcesContent":["import { connect as zagConnect, type Api as ZagTabsApi, type Props as ZagTabsProps, type Service as ZagTabsService, type ValueChangeDetails } from \"@zag-js/tabs\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\n\n/**\n * Tabs 契约 — 原型 B（有状态），core 包裹 zag.js tabs machine。\n * 行为 props 进 createTabsProps → zag context；视觉 props（level/variant/size）\n * 不进 machine，由适配层挂 data-* 属性驱动 CSS。\n *\n * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。\n */\n\n/** 导航层级全集：primary 一级导航（默认）/ secondary 二级导航。 */\nexport const TABS_LEVELS = [\"primary\", \"secondary\"] as const;\nexport type TabsLevel = (typeof TABS_LEVELS)[number];\n\n/** 视觉形态全集：text 纯文本（默认）/ button 按钮。button 仅 secondary 支持。 */\nexport const TABS_VARIANTS = [\"text\", \"button\"] as const;\nexport type TabsVariant = (typeof TABS_VARIANTS)[number];\n\n/** 字号全集：仅 primary 生效，\"14\" / \"16\"（默认）。 */\nexport const TABS_SIZES = [\"14\", \"16\"] as const;\nexport type TabsSize = (typeof TABS_SIZES)[number];\n\n/**\n * QwTabsProps — 双栈共享的行为 + 视觉契约。\n * 行为 props（进 createTabsProps → zag machine）：\n * - loop（默认 true）→ zag loopFocus；\n * - value / defaultValue / activationMode 透传；\n * - onValueChange 适配 zag details。\n * 视觉 props（不进 machine，适配层挂 data-*）：\n * - level / variant / size。\n */\nexport interface QwTabsProps {\n  /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控当前项。 */\n  value?: string | null;\n  /** 非受控初值。 */\n  defaultValue?: string | null;\n  /** 激活模式，默认 automatic（聚焦即激活）。 */\n  activationMode?: \"manual\" | \"automatic\";\n  /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */\n  loop?: boolean;\n  /** 选中项变化回调；zag 原生 onValueChange。 */\n  onValueChange?: (e: { value: string }) => void;\n  /** 导航层级，默认 primary。 */\n  level?: TabsLevel;\n  /** 视觉形态，默认 text。level=primary 时强制 text。 */\n  variant?: TabsVariant;\n  /** 字号，默认 \"16\"。仅 level=primary 生效。 */\n  size?: TabsSize;\n}\n\n/** The Zag machine remains the sole selected-value/focus owner. */\nexport { machine as tabsMachine } from \"@zag-js/tabs\";\n\n/** Shared list-props transport; omitted item information keeps the original getter. */\nexport type QwTabsApi<T extends PropTypes = PropTypes> = Omit<ZagTabsApi<T>, \"getListProps\"> & {\n  getListProps(items?: readonly { disabled?: boolean }[]): T[\"element\"];\n};\n\n/** Nonempty all-disabled lists retain native keyboard scrolling without activating a trigger. */\nexport function connect<T extends PropTypes>(service: ZagTabsService, normalize: NormalizeProps<T>): QwTabsApi<T> {\n  const api = zagConnect(service, normalize);\n  return {\n    ...api,\n    getListProps(items) {\n      if (!items?.length || !items.every(item => item.disabled)) return api.getListProps();\n      return zagConnect(service, {\n        ...normalize,\n        element(raw) {\n          const props = { ...raw, tabIndex: 0 };\n          delete props.onKeyDown;\n          return normalize.element(props);\n        },\n      }).getListProps();\n    },\n  };\n}\n\n/**\n * 把 QwTabsProps 的行为 props 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。\n * 视觉 props（level/variant/size）不出现在返回值中——它们是适配层 data-* 属性。\n * 用法：`useMachine(tabsMachine, createTabsProps(props))`。\n */\nexport function createTabsProps(props: QwTabsProps = {}): Partial<ZagTabsProps> {\n  const ctx: Partial<ZagTabsProps> = {\n    id: props.id,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    activationMode: props.activationMode,\n    loopFocus: props.loop !== false,\n  };\n\n  if (props.onValueChange) {\n    const cb = props.onValueChange;\n    ctx.onValueChange = (d: ValueChangeDetails) => cb({ value: d.value });\n  }\n\n  return ctx;\n}\n"],"mappings":";;;;;;;;;;AAYA,MAAa,cAAc,CAAC,WAAW,WAAW;;AAIlD,MAAa,gBAAgB,CAAC,QAAQ,QAAQ;;AAI9C,MAAa,aAAa,CAAC,MAAM,IAAI;;AA0CrC,SAAgB,QAA6B,SAAyB,WAA4C;CAChH,MAAM,MAAMA,UAAW,SAAS,SAAS;CACzC,OAAO;EACL,GAAG;EACH,aAAa,OAAO;GAClB,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,OAAM,SAAQ,KAAK,QAAQ,GAAG,OAAO,IAAI,aAAa;GACnF,OAAOA,UAAW,SAAS;IACzB,GAAG;IACH,QAAQ,KAAK;KACX,MAAM,QAAQ;MAAE,GAAG;MAAK,UAAU;KAAE;KACpC,OAAO,MAAM;KACb,OAAO,UAAU,QAAQ,KAAK;IAChC;GACF,CAAC,CAAC,CAAC,aAAa;EAClB;CACF;AACF;;;;;;AAOA,SAAgB,gBAAgB,QAAqB,CAAC,GAA0B;CAC9E,MAAM,MAA6B;EACjC,IAAI,MAAM;EACV,OAAO,MAAM;EACb,cAAc,MAAM;EACpB,gBAAgB,MAAM;EACtB,WAAW,MAAM,SAAS;CAC5B;CAEA,IAAI,MAAM,eAAe;EACvB,MAAM,KAAK,MAAM;EACjB,IAAI,iBAAiB,MAA0B,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;CACtE;CAEA,OAAO;AACT"}