@qw-ui/core 0.3.0-next.19 → 0.3.0-next.20

package/dist/index.d.ts

@@ -34,3 +34,5 @@ export { STEPPER_SIZES, STEPPER_PARTS, clampStepperValue, getStepperRootProps, g
 export type { StepperPart, StepperSize, QwStepperProps, ResolvedStepperState, StepperRootProps, StepperDecrementProps, StepperIncrementProps, StepperValueProps, } from "./stepper/index.js";
 export { BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, DEFAULT_BADGE_MAX_COUNT, getBadgeRootProps, resolveBadgeState, } from "./badge/index.js";
 export type { BadgeAriaTexts, BadgeKind, BadgePart, BadgeRootProps, BadgeVariant, QwBadgeProps, ResolvedBadgeState, } from "./badge/index.js";
+export { TABBAR_ITEM_TONES, TABBAR_ITEM_VARIANTS, TABBAR_PARTS, getTabBarItemButtonProps, getTabBarRootProps, resolveTabBarState, } from "./tabbar/index.js";
+export type { QwTabBarItemProps, QwTabBarProps, ResolvedTabBarItemState, ResolvedTabBarState, TabBarItemButtonProps, TabBarItemTone, TabBarItemVariant, TabBarPart, TabBarRootProps, } from "./tabbar/index.js";

package/dist/index.js

@@ -16,4 +16,5 @@ import { createInputProps } from "./input/index.js";
 import { SWITCH_PARTS, getSwitchRootProps, getSwitchThumbProps, resolveSwitchState } from "./switch/index.js";
 import { STEPPER_PARTS, STEPPER_SIZES, clampStepperValue, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, resolveStepperState } from "./stepper/index.js";
 import { BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, DEFAULT_BADGE_MAX_COUNT, getBadgeRootProps, resolveBadgeState } from "./badge/index.js";
-export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, DEFAULT_BADGE_MAX_COUNT, DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS, EMPTY_PARTS, ICON_FALLBACK_NAME, ICON_PARTS, LOADING_SIZES, OVERLAY_PANEL_PARTS, SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS, STEPPER_PARTS, STEPPER_SIZES, SWITCH_PARTS, TAG_PARTS, TAG_SIZES, TAG_VARIANTS, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, TOPBAR_VARIANTS, clampStepperValue, connect, createDialogProps, createInputProps, createTabsProps, createTextAreaProps, createTopBarProps, dialogMachine, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getBadgeRootProps, getButtonRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, getSwitchRootProps, getSwitchThumbProps, isToastIconType, resolveAvatarState, resolveBadgeState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveStepperState, resolveSwitchState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };
+import { TABBAR_ITEM_TONES, TABBAR_ITEM_VARIANTS, TABBAR_PARTS, getTabBarItemButtonProps, getTabBarRootProps, resolveTabBarState } from "./tabbar/index.js";
+export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BADGE_KINDS, BADGE_PARTS, BADGE_VARIANTS, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, DEFAULT_BADGE_MAX_COUNT, DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS, EMPTY_PARTS, ICON_FALLBACK_NAME, ICON_PARTS, LOADING_SIZES, OVERLAY_PANEL_PARTS, SKELETON_ANIMATIONS, SKELETON_PARTS, SKELETON_RADII, SKELETON_VARIANTS, STEPPER_PARTS, STEPPER_SIZES, SWITCH_PARTS, TABBAR_ITEM_TONES, TABBAR_ITEM_VARIANTS, TABBAR_PARTS, TAG_PARTS, TAG_SIZES, TAG_VARIANTS, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, TOPBAR_VARIANTS, clampStepperValue, connect, createDialogProps, createInputProps, createTabsProps, createTextAreaProps, createTopBarProps, dialogMachine, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getBadgeRootProps, getButtonRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, getSwitchRootProps, getSwitchThumbProps, getTabBarItemButtonProps, getTabBarRootProps, isToastIconType, resolveAvatarState, resolveBadgeState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveStepperState, resolveSwitchState, resolveTabBarState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };

package/dist/tabbar/index.d.ts

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

package/dist/tabbar/index.js

@@ -0,0 +1,50 @@
+//#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
+	};
+}
+//#endregion
+export { TABBAR_ITEM_TONES, TABBAR_ITEM_VARIANTS, TABBAR_PARTS, getTabBarItemButtonProps, getTabBarRootProps, 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  /** 操作项列表；缺省或空数组时组件不渲染。 */\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"],"mappings":";;;;;;;;;AASA,MAAa,uBAAuB,CAAC,WAAW,WAAW;AAC3D,MAAa,oBAAoB,CAAC,SAAS,SAAS;AACpD,MAAa,eAAe,CAAC,MAAM;;AA8DnC,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"}

package/dist/tabbar/tabbar.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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 {
+    /** 操作项列表；缺省或空数组时组件不渲染。 */
+    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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qw-ui/core",
-  "version": "0.3.0-next.19",
+  "version": "0.3.0-next.20",
   "description": "L2 · Headless Core — zag.js machine 薄包装，纯 TS / SSR-safe，零样式。",
   "license": "MIT",
   "author": "qw-ui contributors",
@@ -107,6 +107,10 @@
     "./badge": {
       "types": "./dist/badge/index.d.ts",
       "import": "./dist/badge/index.js"
+    },
+    "./tabbar": {
+      "types": "./dist/tabbar/index.d.ts",
+      "import": "./dist/tabbar/index.js"
     }
   },
   "sideEffects": false,
@@ -115,7 +119,7 @@
     "@zag-js/dialog": "^1.42.0",
     "@zag-js/tabs": "^1.42.0",
     "@zag-js/utils": "1.42.0",
-    "@qw-ui/icons": "^0.3.0-next.19"
+    "@qw-ui/icons": "^0.3.0-next.20"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.58.9",