@qw-ui/core 0.1.0 → 0.2.0

package/dist/tabs/tabs.d.ts

@@ -0,0 +1,61 @@
+import type { Props as ZagTabsProps } from "@zag-js/tabs";
+/**
+ * Tabs 契约 — 原型 B（有状态），core 包裹 zag.js tabs machine。
+ * 行为 props 进 createTabsProps → zag context；视觉 props（level/variant/size）
+ * 不进 machine，由适配层挂 data-* 属性驱动 CSS。
+ *
+ * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。
+ */
+/** 导航层级全集：primary 一级导航（默认）/ secondary 二级导航。 */
+export declare const TABS_LEVELS: readonly ["primary", "secondary"];
+export type TabsLevel = (typeof TABS_LEVELS)[number];
+/** 视觉形态全集：text 纯文本（默认）/ button 按钮。button 仅 secondary 支持。 */
+export declare const TABS_VARIANTS: readonly ["text", "button"];
+export type TabsVariant = (typeof TABS_VARIANTS)[number];
+/** 字号全集：仅 primary 生效，"14" / "16"（默认）。 */
+export declare const TABS_SIZES: readonly ["14", "16"];
+export type TabsSize = (typeof TABS_SIZES)[number];
+/**
+ * QwTabsProps — 双栈共享的行为 + 视觉契约。
+ * 行为 props（进 createTabsProps → zag machine）：
+ * - loop（默认 true）→ zag loopFocus；
+ * - value / defaultValue / activationMode 透传；
+ * - onValueChange 适配 zag details。
+ * 视觉 props（不进 machine，适配层挂 data-*）：
+ * - level / variant / size。
+ */
+export interface QwTabsProps {
+    /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */
+    id?: string;
+    /** 受控当前项。 */
+    value?: string | null;
+    /** 非受控初值。 */
+    defaultValue?: string | null;
+    /** 激活模式，默认 automatic（聚焦即激活）。 */
+    activationMode?: "manual" | "automatic";
+    /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */
+    loop?: boolean;
+    /** 选中项变化回调；zag 原生 onValueChange。 */
+    onValueChange?: (e: {
+        value: string;
+    }) => void;
+    /** 导航层级，默认 primary。 */
+    level?: TabsLevel;
+    /** 视觉形态，默认 text。level=primary 时强制 text。 */
+    variant?: TabsVariant;
+    /** 字号，默认 "16"。仅 level=primary 生效。 */
+    size?: TabsSize;
+}
+/**
+ * 直接 re-export zag tabs 的 machine 与 connect —— 不包一层。
+ * 用 re-export 保留原始可移植类型 (避免 TS2742)。
+ */
+export { machine as tabsMachine, connect } from "@zag-js/tabs";
+/** rebrand zag 的 TabsApi 类型对外。 */
+export type { Api as QwTabsApi } from "@zag-js/tabs";
+/**
+ * 把 QwTabsProps 的行为 props 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。
+ * 视觉 props（level/variant/size）不出现在返回值中——它们是适配层 data-* 属性。
+ * 用法：`useMachine(tabsMachine, createTabsProps(props))`。
+ */
+export declare function createTabsProps(props?: QwTabsProps): Partial<ZagTabsProps>;

package/dist/textarea/index.d.ts

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

package/dist/textarea/index.js

@@ -0,0 +1,231 @@
+import { createMachine } from "@zag-js/core";
+import { compact } from "@zag-js/utils";
+//#region src/textarea/textarea.ts
+/**
+* TextArea zag.js machine。
+* 所有交互逻辑唯一来源：value、focus、clear、pasteRecognize。
+*/
+const machine = createMachine({
+	props({ props }) {
+		return {
+			defaultValue: "",
+			disabled: false,
+			readOnly: false,
+			showActions: true,
+			autoSize: false,
+			rows: 4,
+			...props
+		};
+	},
+	initialState() {
+		return "idle";
+	},
+	context({ bindable, prop }) {
+		return {
+			value: bindable(() => {
+				const controlledValue = prop("value");
+				return {
+					defaultValue: prop("defaultValue") ?? "",
+					sync: true,
+					...controlledValue !== void 0 ? { value: controlledValue } : {},
+					onChange(value, prev) {
+						if (value !== prev) prop("onChange")?.(value);
+					}
+				};
+			}),
+			focused: bindable(() => ({ defaultValue: false }))
+		};
+	},
+	computed: {
+		charCount({ context }) {
+			return context.get("value").length;
+		},
+		hasMaxLength({ prop }) {
+			const max = prop("maxLength");
+			return max != null && max > 0;
+		},
+		showClear({ context, prop }) {
+			return context.get("value").length > 0 && !prop("disabled") && !prop("readOnly");
+		}
+	},
+	watch({ track, prop, context }) {
+		track([() => prop("value")], () => {
+			const external = prop("value");
+			if (external !== void 0 && external !== context.get("value")) context.set("value", external);
+		});
+	},
+	states: { idle: { on: {
+		"VALUE.SET": { actions: ["setValue"] },
+		"VALUE.CLEAR": { actions: ["clearValue", "invokeOnClear"] },
+		"FOCUS.SET": { actions: ["setFocused"] },
+		PASTE_RECOGNIZE: { actions: ["invokeOnPasteRecognize"] }
+	} } },
+	implementations: { actions: {
+		setValue({ context, event, prop }) {
+			if (event.type === "VALUE.SET") {
+				const maxLength = prop("maxLength") ?? 0;
+				let next = event.value;
+				if (maxLength > 0 && next.length > maxLength) next = next.slice(0, maxLength);
+				context.set("value", next);
+			}
+		},
+		clearValue({ context }) {
+			context.set("value", "");
+		},
+		setFocused({ context, event, prop }) {
+			if (event.type === "FOCUS.SET") {
+				const next = event.focused;
+				const prev = context.get("focused");
+				context.set("focused", next);
+				if (next && !prev) prop("onFocus")?.();
+				if (!next && prev) prop("onBlur")?.();
+			}
+		},
+		invokeOnClear({ prop }) {
+			prop("onClear")?.();
+		},
+		invokeOnPasteRecognize({ prop }) {
+			prop("onPasteRecognize")?.();
+		},
+		invokeOnFocus() {},
+		invokeOnBlur() {}
+	} }
+});
+/**
+* connect：把 service 接成业务友好的 prop-getter。
+* 适配层只需调用 connect(service, normalizeProps)。
+*/
+function connect(service, normalizeProps) {
+	const { context, computed, prop, send } = service;
+	const value = context.get("value");
+	const focused = context.get("focused");
+	const charCount = computed("charCount");
+	const hasMaxLength = computed("hasMaxLength");
+	const showClear = computed("showClear");
+	const disabled = !!prop("disabled");
+	const readOnly = !!prop("readOnly");
+	const showActions = prop("showActions") ?? true;
+	const autoSize = !!prop("autoSize");
+	const maxLength = prop("maxLength");
+	const rows = prop("rows") ?? 4;
+	const isEmpty = value.length === 0;
+	return {
+		value,
+		focused,
+		charCount,
+		hasMaxLength,
+		showClear,
+		clear() {
+			send({ type: "VALUE.CLEAR" });
+		},
+		pasteRecognize() {
+			send({ type: "PASTE_RECOGNIZE" });
+		},
+		getRootProps() {
+			return normalizeProps.element(compact({
+				"data-scope": "textarea",
+				"data-part": "root",
+				"data-focused": focused ? "true" : void 0,
+				"data-disabled": disabled ? "true" : void 0,
+				"data-readonly": readOnly ? "true" : void 0,
+				"data-show-actions": showActions ? "true" : "false",
+				"data-auto-size": autoSize ? "true" : void 0,
+				"data-empty": isEmpty ? "true" : "false"
+			}));
+		},
+		getTextareaProps() {
+			return normalizeProps.textarea(compact({
+				"data-scope": "textarea",
+				"data-part": "textarea",
+				value,
+				placeholder: prop("placeholder"),
+				disabled,
+				readOnly,
+				maxLength: maxLength && maxLength > 0 ? maxLength : void 0,
+				rows,
+				name: prop("name"),
+				"aria-disabled": disabled ? "true" : void 0,
+				"aria-readonly": readOnly ? "true" : void 0,
+				onFocus() {
+					send({
+						type: "FOCUS.SET",
+						focused: true
+					});
+				},
+				onBlur() {
+					send({
+						type: "FOCUS.SET",
+						focused: false
+					});
+				},
+				onChange(event) {
+					const target = event.target;
+					const isComposing = !!event.nativeEvent?.isComposing;
+					let next = target.value;
+					if (!isComposing) {
+						const maxLen = prop("maxLength") ?? 0;
+						if (maxLen > 0 && next.length > maxLen) next = next.slice(0, maxLen);
+					}
+					context.set("value", next);
+				}
+			}));
+		},
+		getBottomBarProps() {
+			return normalizeProps.element(compact({
+				"data-scope": "textarea",
+				"data-part": "bottom-bar",
+				"data-show-actions": showActions ? "true" : "false"
+			}));
+		},
+		getCounterProps() {
+			return normalizeProps.element(compact({
+				"data-scope": "textarea",
+				"data-part": "counter",
+				"data-has-max-length": hasMaxLength ? "true" : void 0,
+				"aria-live": "polite"
+			}));
+		},
+		getClearButtonProps() {
+			return normalizeProps.button(compact({
+				"data-scope": "textarea",
+				"data-part": "clear-button",
+				type: "button",
+				disabled: !showClear || disabled || readOnly,
+				"aria-label": "清除内容",
+				onClick() {
+					send({ type: "VALUE.CLEAR" });
+				}
+			}));
+		},
+		getPasteButtonProps() {
+			return normalizeProps.button(compact({
+				"data-scope": "textarea",
+				"data-part": "paste-button",
+				type: "button",
+				disabled,
+				"aria-label": "粘贴并识别",
+				onClick() {
+					send({ type: "PASTE_RECOGNIZE" });
+				}
+			}));
+		}
+	};
+}
+/**
+* 把 QwTextAreaProps 转成 machine context（默认值收口）。
+*/
+function createTextAreaProps(props = {}) {
+	return {
+		defaultValue: props.defaultValue ?? "",
+		disabled: props.disabled ?? false,
+		readOnly: props.readOnly ?? false,
+		showActions: props.showActions ?? true,
+		autoSize: props.autoSize ?? false,
+		rows: props.rows ?? 4,
+		...props
+	};
+}
+//#endregion
+export { connect, createTextAreaProps, machine };
+
+//# sourceMappingURL=index.js.map

package/dist/textarea/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/textarea/textarea.ts"],"sourcesContent":["import { createMachine } from \"@zag-js/core\";\nimport type { MachineSchema, Service } from \"@zag-js/core\";\nimport type { PropTypes, NormalizeProps } from \"@zag-js/types\";\nimport type { JSX } from \"@zag-js/types\";\nimport { compact } from \"@zag-js/utils\";\n\n/**\n * TextArea 公共 props 契约（双栈共享）。\n */\nexport interface QwTextAreaProps {\n  /** 唯一 id 前缀。 */\n  id?: string;\n  /** 受控值。 */\n  value?: string;\n  /** 非受控初始值。 */\n  defaultValue?: string;\n  /** 占位符。 */\n  placeholder?: string;\n  /** 最大字符数。 */\n  maxLength?: number;\n  /** 禁用态。 */\n  disabled?: boolean;\n  /** 只读态。 */\n  readOnly?: boolean;\n  /** 可视行数（影响最小高度）。 */\n  rows?: number;\n  /** 自适应高度。 */\n  autoSize?: boolean;\n  /** 显示底部操作按钮。 */\n  showActions?: boolean;\n  /** name 属性。 */\n  name?: string;\n  /** 输入变化回调。 */\n  onChange?: (value: string) => void;\n  /** 清空回调。 */\n  onClear?: () => void;\n  /** 粘贴并识别回调。 */\n  onPasteRecognize?: () => void;\n  /** 聚焦回调。 */\n  onFocus?: () => void;\n  /** 失焦回调。 */\n  onBlur?: () => void;\n}\n\n/**\n * 内部 schema，用于 createMachine 类型推导。\n */\ninterface TextAreaSchema extends MachineSchema {\n  props: QwTextAreaProps;\n  context: {\n    value: string;\n    focused: boolean;\n  };\n  computed: {\n    charCount: number;\n    hasMaxLength: boolean;\n    showClear: boolean;\n  };\n  state: \"idle\";\n  event:\n    | { type: \"VALUE.SET\"; value: string }\n    | { type: \"VALUE.CLEAR\" }\n    | { type: \"FOCUS.SET\"; focused: boolean }\n    | { type: \"PASTE_RECOGNIZE\" };\n  action:\n    | \"setValue\"\n    | \"clearValue\"\n    | \"setFocused\"\n    | \"invokeOnClear\"\n    | \"invokeOnPasteRecognize\"\n    | \"invokeOnFocus\"\n    | \"invokeOnBlur\";\n}\n\n/**\n * TextArea zag.js machine。\n * 所有交互逻辑唯一来源：value、focus、clear、pasteRecognize。\n */\nexport const machine = createMachine<TextAreaSchema>({\n  props({ props }) {\n    return {\n      defaultValue: \"\",\n      disabled: false,\n      readOnly: false,\n      showActions: true,\n      autoSize: false,\n      rows: 4,\n      ...props,\n    };\n  },\n\n  initialState() {\n    return \"idle\";\n  },\n\n  context({ bindable, prop }) {\n    return {\n      value: bindable<string>(() => {\n        const controlledValue = prop(\"value\");\n        return {\n          defaultValue: prop(\"defaultValue\") ?? \"\",\n          sync: true,\n          ...(controlledValue !== undefined ? { value: controlledValue } : {}),\n          onChange(value, prev) {\n            if (value !== prev) {\n              prop(\"onChange\")?.(value);\n            }\n          },\n        };\n      }),\n      focused: bindable(() => ({\n        defaultValue: false,\n      })),\n    };\n  },\n\n  computed: {\n    charCount({ context }) {\n      return context.get(\"value\").length;\n    },\n    hasMaxLength({ prop }) {\n      const max = prop(\"maxLength\");\n      return max != null && max > 0;\n    },\n    showClear({ context, prop }) {\n      return context.get(\"value\").length > 0 && !prop(\"disabled\") && !prop(\"readOnly\");\n    },\n  },\n\n  watch({ track, prop, context }) {\n    track([() => prop(\"value\")], () => {\n      const external = prop(\"value\");\n      if (external !== undefined && external !== context.get(\"value\")) {\n        context.set(\"value\", external);\n      }\n    });\n  },\n\n  states: {\n    idle: {\n      on: {\n        \"VALUE.SET\": {\n          actions: [\"setValue\"],\n        },\n        \"VALUE.CLEAR\": {\n          actions: [\"clearValue\", \"invokeOnClear\"],\n        },\n        \"FOCUS.SET\": {\n          actions: [\"setFocused\"],\n        },\n        PASTE_RECOGNIZE: {\n          actions: [\"invokeOnPasteRecognize\"],\n        },\n      },\n    },\n  },\n\n  implementations: {\n    actions: {\n      setValue({ context, event, prop }) {\n        if (event.type === \"VALUE.SET\") {\n          const maxLength = prop(\"maxLength\") ?? 0;\n          let next = event.value;\n          if (maxLength > 0 && next.length > maxLength) {\n            next = next.slice(0, maxLength);\n          }\n          context.set(\"value\", next);\n        }\n      },\n      clearValue({ context }) {\n        context.set(\"value\", \"\");\n      },\n      setFocused({ context, event, prop }) {\n        if (event.type === \"FOCUS.SET\") {\n          const next = event.focused;\n          const prev = context.get(\"focused\");\n          context.set(\"focused\", next);\n          if (next && !prev) prop(\"onFocus\")?.();\n          if (!next && prev) prop(\"onBlur\")?.();\n        }\n      },\n      invokeOnClear({ prop }) {\n        prop(\"onClear\")?.();\n      },\n      invokeOnPasteRecognize({ prop }) {\n        prop(\"onPasteRecognize\")?.();\n      },\n      invokeOnFocus() {\n        // focus 回调在 setFocused 中已触发\n      },\n      invokeOnBlur() {\n        // blur 回调在 setFocused 中已触发\n      },\n    },\n  },\n});\n\n/**\n * TextArea api 类型（由 connect 返回）。\n */\nexport interface TextAreaApi<T extends PropTypes = PropTypes> {\n  /** 当前输入值。 */\n  value: string;\n  /** 当前是否聚焦。 */\n  focused: boolean;\n  /** 当前字符数。 */\n  charCount: number;\n  /** 是否有字数限制。 */\n  hasMaxLength: boolean;\n  /** 是否显示清除按钮。 */\n  showClear: boolean;\n  /** 清空输入。 */\n  clear(): void;\n  /** 触发粘贴并识别回调。 */\n  pasteRecognize(): void;\n  /** 根容器 prop-getter。 */\n  getRootProps(): T[\"element\"];\n  /** textarea 元素 prop-getter。 */\n  getTextareaProps(): T[\"textarea\"];\n  /** 底部栏 prop-getter。 */\n  getBottomBarProps(): T[\"element\"];\n  /** 字数统计 prop-getter。 */\n  getCounterProps(): T[\"element\"];\n  /** 清除按钮 prop-getter。 */\n  getClearButtonProps(): T[\"button\"];\n  /** 粘贴按钮 prop-getter。 */\n  getPasteButtonProps(): T[\"button\"];\n}\n\n/**\n * connect：把 service 接成业务友好的 prop-getter。\n * 适配层只需调用 connect(service, normalizeProps)。\n */\nexport function connect<T extends PropTypes>(service: Service<TextAreaSchema>, normalizeProps: NormalizeProps<T>): TextAreaApi<T> {\n  const { context, computed, prop, send } = service;\n\n  const value = context.get(\"value\");\n  const focused = context.get(\"focused\");\n  const charCount = computed(\"charCount\");\n  const hasMaxLength = computed(\"hasMaxLength\");\n  const showClear = computed(\"showClear\");\n  const disabled = !!prop(\"disabled\");\n  const readOnly = !!prop(\"readOnly\");\n  const showActions = prop(\"showActions\") ?? true;\n  const autoSize = !!prop(\"autoSize\");\n  const maxLength = prop(\"maxLength\");\n  const rows = prop(\"rows\") ?? 4;\n  const isEmpty = value.length === 0;\n\n  return {\n    value,\n    focused,\n    charCount,\n    hasMaxLength,\n    showClear,\n\n    clear() {\n      send({ type: \"VALUE.CLEAR\" });\n    },\n\n    pasteRecognize() {\n      send({ type: \"PASTE_RECOGNIZE\" });\n    },\n\n    getRootProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"root\",\n          \"data-focused\": focused ? \"true\" : undefined,\n          \"data-disabled\": disabled ? \"true\" : undefined,\n          \"data-readonly\": readOnly ? \"true\" : undefined,\n          \"data-show-actions\": showActions ? \"true\" : \"false\",\n          \"data-auto-size\": autoSize ? \"true\" : undefined,\n          \"data-empty\": isEmpty ? \"true\" : \"false\",\n        }),\n      );\n    },\n\n    getTextareaProps() {\n      return normalizeProps.textarea(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"textarea\",\n          value,\n          placeholder: prop(\"placeholder\"),\n          disabled,\n          readOnly,\n          maxLength: maxLength && maxLength > 0 ? maxLength : undefined,\n          rows,\n          name: prop(\"name\"),\n          \"aria-disabled\": disabled ? (\"true\" as const) : undefined,\n          \"aria-readonly\": readOnly ? (\"true\" as const) : undefined,\n          onFocus() {\n            send({ type: \"FOCUS.SET\", focused: true });\n          },\n          onBlur() {\n            send({ type: \"FOCUS.SET\", focused: false });\n          },\n          onChange(event: JSX.ChangeEvent<HTMLTextAreaElement>) {\n            const target = event.target as unknown as HTMLTextAreaElement;\n            const nativeEvent = (event as { nativeEvent?: { isComposing?: boolean } }).nativeEvent;\n            const isComposing = !!nativeEvent?.isComposing;\n            let next = target.value;\n            // IME composing 期间跳过 maxLength 截断，允许拼音中间态值流过\n            // 防止 React 受控组件因值未更新而重置 DOM，打断输入法\n            if (!isComposing) {\n              const maxLen = prop(\"maxLength\") ?? 0;\n              if (maxLen > 0 && next.length > maxLen) {\n                next = next.slice(0, maxLen);\n              }\n            }\n            // 直接同步更新，绕过 send() 的 queueMicrotask 延迟\n            context.set(\"value\", next);\n          },\n        }),\n      );\n    },\n\n    getBottomBarProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"bottom-bar\",\n          \"data-show-actions\": showActions ? \"true\" : \"false\",\n        }),\n      );\n    },\n\n    getCounterProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"counter\",\n          \"data-has-max-length\": hasMaxLength ? \"true\" : undefined,\n          \"aria-live\": \"polite\" as const,\n        }),\n      );\n    },\n\n    getClearButtonProps() {\n      return normalizeProps.button(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"clear-button\",\n          type: \"button\" as const,\n          disabled: !showClear || disabled || readOnly,\n          \"aria-label\": \"清除内容\" as const,\n          onClick() {\n            send({ type: \"VALUE.CLEAR\" });\n          },\n        }),\n      );\n    },\n\n    getPasteButtonProps() {\n      return normalizeProps.button(\n        compact({\n          \"data-scope\": \"textarea\",\n          \"data-part\": \"paste-button\",\n          type: \"button\" as const,\n          disabled,\n          \"aria-label\": \"粘贴并识别\" as const,\n          onClick() {\n            send({ type: \"PASTE_RECOGNIZE\" });\n          },\n        }),\n      );\n    },\n  };\n}\n\n/**\n * 把 QwTextAreaProps 转成 machine context（默认值收口）。\n */\nexport function createTextAreaProps(props: QwTextAreaProps = {}): Partial<QwTextAreaProps> {\n  return {\n    defaultValue: props.defaultValue ?? \"\",\n    disabled: props.disabled ?? false,\n    readOnly: props.readOnly ?? false,\n    showActions: props.showActions ?? true,\n    autoSize: props.autoSize ?? false,\n    rows: props.rows ?? 4,\n    ...props,\n  };\n}\n"],"mappings":"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"}

package/dist/textarea/textarea.d.ts

@@ -0,0 +1,113 @@
+import type { MachineSchema, Service } from "@zag-js/core";
+import type { PropTypes, NormalizeProps } from "@zag-js/types";
+/**
+ * TextArea 公共 props 契约（双栈共享）。
+ */
+export interface QwTextAreaProps {
+    /** 唯一 id 前缀。 */
+    id?: string;
+    /** 受控值。 */
+    value?: string;
+    /** 非受控初始值。 */
+    defaultValue?: string;
+    /** 占位符。 */
+    placeholder?: string;
+    /** 最大字符数。 */
+    maxLength?: number;
+    /** 禁用态。 */
+    disabled?: boolean;
+    /** 只读态。 */
+    readOnly?: boolean;
+    /** 可视行数（影响最小高度）。 */
+    rows?: number;
+    /** 自适应高度。 */
+    autoSize?: boolean;
+    /** 显示底部操作按钮。 */
+    showActions?: boolean;
+    /** name 属性。 */
+    name?: string;
+    /** 输入变化回调。 */
+    onChange?: (value: string) => void;
+    /** 清空回调。 */
+    onClear?: () => void;
+    /** 粘贴并识别回调。 */
+    onPasteRecognize?: () => void;
+    /** 聚焦回调。 */
+    onFocus?: () => void;
+    /** 失焦回调。 */
+    onBlur?: () => void;
+}
+/**
+ * 内部 schema，用于 createMachine 类型推导。
+ */
+interface TextAreaSchema extends MachineSchema {
+    props: QwTextAreaProps;
+    context: {
+        value: string;
+        focused: boolean;
+    };
+    computed: {
+        charCount: number;
+        hasMaxLength: boolean;
+        showClear: boolean;
+    };
+    state: "idle";
+    event: {
+        type: "VALUE.SET";
+        value: string;
+    } | {
+        type: "VALUE.CLEAR";
+    } | {
+        type: "FOCUS.SET";
+        focused: boolean;
+    } | {
+        type: "PASTE_RECOGNIZE";
+    };
+    action: "setValue" | "clearValue" | "setFocused" | "invokeOnClear" | "invokeOnPasteRecognize" | "invokeOnFocus" | "invokeOnBlur";
+}
+/**
+ * TextArea zag.js machine。
+ * 所有交互逻辑唯一来源：value、focus、clear、pasteRecognize。
+ */
+export declare const machine: import("@zag-js/core").Machine<TextAreaSchema>;
+/**
+ * TextArea api 类型（由 connect 返回）。
+ */
+export interface TextAreaApi<T extends PropTypes = PropTypes> {
+    /** 当前输入值。 */
+    value: string;
+    /** 当前是否聚焦。 */
+    focused: boolean;
+    /** 当前字符数。 */
+    charCount: number;
+    /** 是否有字数限制。 */
+    hasMaxLength: boolean;
+    /** 是否显示清除按钮。 */
+    showClear: boolean;
+    /** 清空输入。 */
+    clear(): void;
+    /** 触发粘贴并识别回调。 */
+    pasteRecognize(): void;
+    /** 根容器 prop-getter。 */
+    getRootProps(): T["element"];
+    /** textarea 元素 prop-getter。 */
+    getTextareaProps(): T["textarea"];
+    /** 底部栏 prop-getter。 */
+    getBottomBarProps(): T["element"];
+    /** 字数统计 prop-getter。 */
+    getCounterProps(): T["element"];
+    /** 清除按钮 prop-getter。 */
+    getClearButtonProps(): T["button"];
+    /** 粘贴按钮 prop-getter。 */
+    getPasteButtonProps(): T["button"];
+}
+/**
+ * connect：把 service 接成业务友好的 prop-getter。
+ * 适配层只需调用 connect(service, normalizeProps)。
+ */
+export declare function connect<T extends PropTypes>(service: Service<TextAreaSchema>, normalizeProps: NormalizeProps<T>): TextAreaApi<T>;
+/**
+ * 把 QwTextAreaProps 转成 machine context（默认值收口）。
+ */
+export declare function createTextAreaProps(props?: QwTextAreaProps): Partial<QwTextAreaProps>;
+export {};

package/dist/toast/index.d.ts

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

package/dist/toast/index.js

@@ -0,0 +1,44 @@
+//#region src/toast/toast.ts
+/**
+* @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）
+* ─────────────────────────────────────────────────────────────
+* 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：
+* 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）
+* 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。
+*/
+/** 垂直显示位置。 */
+const TOAST_POSITIONS = [
+	"top",
+	"bottom",
+	"center"
+];
+/** 内建状态图标类型。 */
+const TOAST_ICON_TYPES = [
+	"success",
+	"fail",
+	"loading"
+];
+/** 逻辑部件（承载 data-part 样式与 parity 指纹）。 */
+const TOAST_PARTS = [
+	"mask",
+	"wrap",
+	"body",
+	"icon",
+	"content"
+];
+/** 默认展示时长（ms）。 */
+const DEFAULT_TOAST_DURATION = 3e3;
+/** 默认垂直位置（对齐设计稿：默认顶部）。 */
+const DEFAULT_TOAST_POSITION = "top";
+/** 判断 icon 是否为内建状态图标类型。 */
+function isToastIconType(icon) {
+	return typeof icon === "string" && TOAST_ICON_TYPES.includes(icon);
+}
+/** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */
+function resolveToastDuration(duration) {
+	return duration == null ? DEFAULT_TOAST_DURATION : duration;
+}
+//#endregion
+export { DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, isToastIconType, resolveToastDuration };
+
+//# sourceMappingURL=index.js.map

package/dist/toast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/toast/toast.ts"],"sourcesContent":["/**\n * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）\n * ─────────────────────────────────────────────────────────────\n * 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：\n * 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）\n * 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。\n */\n\n/** 垂直显示位置。 */\nexport const TOAST_POSITIONS = [\"top\", \"bottom\", \"center\"] as const;\nexport type QwToastPosition = (typeof TOAST_POSITIONS)[number];\n\n/** 内建状态图标类型。 */\nexport const TOAST_ICON_TYPES = [\"success\", \"fail\", \"loading\"] as const;\nexport type QwToastIconType = (typeof TOAST_ICON_TYPES)[number];\n\n/** 逻辑部件（承载 data-part 样式与 parity 指纹）。 */\nexport const TOAST_PARTS = [\"mask\", \"wrap\", \"body\", \"icon\", \"content\"] as const;\nexport type QwToastPart = (typeof TOAST_PARTS)[number];\n\n/** 默认展示时长（ms）。 */\nexport const DEFAULT_TOAST_DURATION = 3000;\n\n/** 默认垂直位置（对齐设计稿：默认顶部）。 */\nexport const DEFAULT_TOAST_POSITION: QwToastPosition = \"top\";\n\n/**\n * Toast 选项契约。`Node` / `Style` 由适配层具体化\n * （React `ReactNode` / `CSSProperties`；Vue `VNode` / `StyleValue`）。\n * 与 antd-mobile 风格对齐：命令式 `Toast.show(options)`。\n */\nexport interface QwToastOptions<Node = unknown, Style = unknown> {\n  /** 提示主文案。可空（纯图标提示）。 */\n  content?: Node;\n  /** 前置图标：内建类型 `success | fail | loading`，或任意自定义节点；不传则不展示图标。 */\n  icon?: QwToastIconType | Node;\n  /** 持续时间（ms），默认 3000；为 0 时不自动关闭。 */\n  duration?: number;\n  /** 垂直显示位置，默认 top。 */\n  position?: QwToastPosition;\n  /** 自定义遮罩层内联样式。 */\n  maskStyle?: Style;\n  /** 自定义遮罩层 class。 */\n  maskClassName?: string;\n  /** 关闭后回调（自动消失或手动 clear 均触发）。 */\n  afterClose?: () => void;\n}\n\n/** 命令式 Toast 单例接口（各框架适配层实现同名同义）。 */\nexport interface QwToast<Node = unknown, Style = unknown> {\n  /** 展示一条提示（替换上一条）。 */\n  show: (options?: QwToastOptions<Node, Style>) => void;\n  /** 立即收起当前提示。 */\n  clear: () => void;\n}\n\n/** 判断 icon 是否为内建状态图标类型。 */\nexport function isToastIconType(icon: unknown): icon is QwToastIconType {\n  return typeof icon === \"string\" && (TOAST_ICON_TYPES as readonly string[]).includes(icon);\n}\n\n/** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */\nexport function resolveToastDuration(duration?: number): number {\n  return duration == null ? DEFAULT_TOAST_DURATION : duration;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,kBAAkB;CAAC;CAAO;CAAU;AAAQ;;AAIzD,MAAa,mBAAmB;CAAC;CAAW;CAAQ;AAAS;;AAI7D,MAAa,cAAc;CAAC;CAAQ;CAAQ;CAAQ;CAAQ;AAAS;;AAIrE,MAAa,yBAAyB;;AAGtC,MAAa,yBAA0C;;AAiCvD,SAAgB,gBAAgB,MAAwC;CACtE,OAAO,OAAO,SAAS,YAAa,iBAAuC,SAAS,IAAI;AAC1F;;AAGA,SAAgB,qBAAqB,UAA2B;CAC9D,OAAO,YAAY,OAAO,yBAAyB;AACrD"}

package/dist/toast/toast.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）
+ * ─────────────────────────────────────────────────────────────
+ * 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：
+ * 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）
+ * 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。
+ */
+/** 垂直显示位置。 */
+export declare const TOAST_POSITIONS: readonly ["top", "bottom", "center"];
+export type QwToastPosition = (typeof TOAST_POSITIONS)[number];
+/** 内建状态图标类型。 */
+export declare const TOAST_ICON_TYPES: readonly ["success", "fail", "loading"];
+export type QwToastIconType = (typeof TOAST_ICON_TYPES)[number];
+/** 逻辑部件（承载 data-part 样式与 parity 指纹）。 */
+export declare const TOAST_PARTS: readonly ["mask", "wrap", "body", "icon", "content"];
+export type QwToastPart = (typeof TOAST_PARTS)[number];
+/** 默认展示时长（ms）。 */
+export declare const DEFAULT_TOAST_DURATION = 3000;
+/** 默认垂直位置（对齐设计稿：默认顶部）。 */
+export declare const DEFAULT_TOAST_POSITION: QwToastPosition;
+/**
+ * Toast 选项契约。`Node` / `Style` 由适配层具体化
+ * （React `ReactNode` / `CSSProperties`；Vue `VNode` / `StyleValue`）。
+ * 与 antd-mobile 风格对齐：命令式 `Toast.show(options)`。
+ */
+export interface QwToastOptions<Node = unknown, Style = unknown> {
+    /** 提示主文案。可空（纯图标提示）。 */
+    content?: Node;
+    /** 前置图标：内建类型 `success | fail | loading`，或任意自定义节点；不传则不展示图标。 */
+    icon?: QwToastIconType | Node;
+    /** 持续时间（ms），默认 3000；为 0 时不自动关闭。 */
+    duration?: number;
+    /** 垂直显示位置，默认 top。 */
+    position?: QwToastPosition;
+    /** 自定义遮罩层内联样式。 */
+    maskStyle?: Style;
+    /** 自定义遮罩层 class。 */
+    maskClassName?: string;
+    /** 关闭后回调（自动消失或手动 clear 均触发）。 */
+    afterClose?: () => void;
+}
+/** 命令式 Toast 单例接口（各框架适配层实现同名同义）。 */
+export interface QwToast<Node = unknown, Style = unknown> {
+    /** 展示一条提示（替换上一条）。 */
+    show: (options?: QwToastOptions<Node, Style>) => void;
+    /** 立即收起当前提示。 */
+    clear: () => void;
+}
+/** 判断 icon 是否为内建状态图标类型。 */
+export declare function isToastIconType(icon: unknown): icon is QwToastIconType;
+/** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */
+export declare function resolveToastDuration(duration?: number): number;

package/dist/top-bar/index.d.ts

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

package/dist/top-bar/index.js

@@ -0,0 +1,43 @@
+//#region src/top-bar/top-bar.ts
+/**
+* Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
+* React/Vue 适配层从这里 import 类型与 createTopBarProps，不允许各自再定义一份。
+*
+* Top Bar 是内容面板的头部组件，通过 `variant` prop 选择三种互斥结构形式：
+* basic（标题 + 收起 icon）、tab（tablist + 收起 icon）、extended（返回箭头 + 自定义中间 + 关闭 icon）。
+* Tab 切换复用 @qw-ui/core/tabs。
+*
+* 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。
+*/
+/** variant 全集：basic 基础 / tab 标签页 / extended 拓展。 */
+const TOPBAR_VARIANTS = [
+	"basic",
+	"tab",
+	"extended"
+];
+/**
+* 把 QwTopBarProps 收口默认值，返回适配层配置对象。
+* 不进 machine（原型 A）。纯函数，SSR-safe。
+*/
+function createTopBarProps(props) {
+	const items = props.items;
+	return {
+		variant: props.variant,
+		title: props.title,
+		items,
+		defaultValue: props.defaultValue ?? null,
+		value: props.value ?? null,
+		onValueChange: props.onValueChange,
+		onCollapse: props.onCollapse,
+		collapseLabel: props.collapseLabel ?? "收起",
+		onBack: props.onBack,
+		backLabel: props.backLabel ?? "返回",
+		onClose: props.onClose,
+		closeLabel: props.closeLabel ?? "关闭",
+		hasTabs: items !== void 0 && items.length > 0
+	};
+}
+//#endregion
+export { TOPBAR_VARIANTS, createTopBarProps };
+
+//# sourceMappingURL=index.js.map

package/dist/top-bar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/top-bar/top-bar.ts"],"sourcesContent":["/**\n * Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。\n * React/Vue 适配层从这里 import 类型与 createTopBarProps，不允许各自再定义一份。\n *\n * Top Bar 是内容面板的头部组件，通过 `variant` prop 选择三种互斥结构形式：\n * basic（标题 + 收起 icon）、tab（tablist + 收起 icon）、extended（返回箭头 + 自定义中间 + 关闭 icon）。\n * Tab 切换复用 @qw-ui/core/tabs。\n *\n * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。\n */\n\n/** variant 全集：basic 基础 / tab 标签页 / extended 拓展。 */\nexport const TOPBAR_VARIANTS = [\"basic\", \"tab\", \"extended\"] as const;\n\n/** 结构形式。 */\nexport type TopBarVariant = (typeof TOPBAR_VARIANTS)[number];\n\n/**\n * TopBarItem — Tab 项契约，与 @qw-ui/react/tabs 和 @qw-ui/vue/tabs 的 TabItem 同构。\n * core 定义最小形状（label/content 为 string），适配层各自扩展为 ReactNode / slot。\n */\nexport interface TopBarItem {\n  /** 选项唯一值。 */\n  value: string;\n  /** 选项标签文本。 */\n  label: string;\n  /** 选项内容（简单文本）。 */\n  content?: string;\n  /** 禁用该选项：跳过键盘漫游、不可点击。 */\n  disabled?: boolean;\n}\n\n/**\n * QwTopBarProps — 双栈共享的行为 + 视觉契约。\n * Tab 相关 props（items/value/defaultValue/onValueChange）透传给 @qw-ui/core/tabs。\n * variant 为必填，其余 props 按 variant 条件可选（flat interface，非 discriminated union）。\n */\nexport interface QwTopBarProps {\n  /** 结构形式（必填）。 */\n  variant: TopBarVariant;\n\n  // ── basic 专用 ──\n  /** 标题名称（basic 专用）。 */\n  title?: string;\n\n  // ── tab 专用 ──\n  /** Tab 切换模式的数据项。 */\n  items?: TopBarItem[];\n  /** Tab 非受控初值。 */\n  defaultValue?: string | null;\n  /** Tab 受控当前项。 */\n  value?: string | null;\n  /** Tab 选中项变化回调。 */\n  onValueChange?: (e: { value: string }) => void;\n\n  // ── basic + tab 共用 ──\n  /** 收起 icon 点击回调（关闭内容面板）。 */\n  onCollapse?: () => void;\n  /** 收起 icon 的 aria-label，默认「收起」。 */\n  collapseLabel?: string;\n\n  // ── extended 专用 ──\n  /** 返回箭头点击回调（面板内导航回退）。 */\n  onBack?: () => void;\n  /** 返回箭头的 aria-label，默认「返回」。 */\n  backLabel?: string;\n  /** 关闭 icon 点击回调（关闭面板）。 */\n  onClose?: () => void;\n  /** 关闭 icon 的 aria-label，默认「关闭」。 */\n  closeLabel?: string;\n}\n\n/**\n * ResolvedTopBarProps — createTopBarProps 返回值，适配层消费此对象渲染。\n */\nexport interface ResolvedTopBarProps {\n  variant: TopBarVariant;\n  title: string | undefined;\n  items: TopBarItem[] | undefined;\n  defaultValue: string | null;\n  value: string | null;\n  onValueChange: ((e: { value: string }) => void) | undefined;\n  onCollapse: (() => void) | undefined;\n  collapseLabel: string;\n  onBack: (() => void) | undefined;\n  backLabel: string;\n  onClose: (() => void) | undefined;\n  closeLabel: string;\n  hasTabs: boolean;\n}\n\n/**\n * 把 QwTopBarProps 收口默认值，返回适配层配置对象。\n * 不进 machine（原型 A）。纯函数，SSR-safe。\n */\nexport function createTopBarProps(props: QwTopBarProps): ResolvedTopBarProps {\n  const items = props.items;\n\n  return {\n    variant: props.variant,\n    title: props.title,\n    items,\n    defaultValue: props.defaultValue ?? null,\n    value: props.value ?? null,\n    onValueChange: props.onValueChange,\n    onCollapse: props.onCollapse,\n    collapseLabel: props.collapseLabel ?? \"收起\",\n    onBack: props.onBack,\n    backLabel: props.backLabel ?? \"返回\",\n    onClose: props.onClose,\n    closeLabel: props.closeLabel ?? \"关闭\",\n    hasTabs: items !== undefined && items.length > 0,\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,kBAAkB;CAAC;CAAS;CAAO;AAAU;;;;;AAmF1D,SAAgB,kBAAkB,OAA2C;CAC3E,MAAM,QAAQ,MAAM;CAEpB,OAAO;EACL,SAAS,MAAM;EACf,OAAO,MAAM;EACb;EACA,cAAc,MAAM,gBAAgB;EACpC,OAAO,MAAM,SAAS;EACtB,eAAe,MAAM;EACrB,YAAY,MAAM;EAClB,eAAe,MAAM,iBAAiB;EACtC,QAAQ,MAAM;EACd,WAAW,MAAM,aAAa;EAC9B,SAAS,MAAM;EACf,YAAY,MAAM,cAAc;EAChC,SAAS,UAAU,KAAA,KAAa,MAAM,SAAS;CACjD;AACF"}