@qw-ui/core 0.3.0-next.3 → 0.3.0-next.31

package/dist/side-nav/index.js

@@ -0,0 +1,99 @@
+//#region src/side-nav/side-nav.ts
+/**
+* SideNav 的跨框架行为契约。
+*
+* SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组
+* 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得
+* 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口
+* data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。
+*/
+const SIDENAV_PARTS = [
+	"root",
+	"group-label",
+	"item"
+];
+function resolveItem(item, selectedValue) {
+	return {
+		value: item.value,
+		label: item.label,
+		disabled: item.disabled ?? false,
+		selected: selectedValue !== void 0 && item.value === selectedValue
+	};
+}
+/** 组内邻接推导：仅与选中项索引差 1 的项获得 adjacent；分组标题为边界。 */
+function attachAdjacency(items) {
+	const selectedIndex = items.findIndex((item) => item.selected);
+	if (selectedIndex < 0) return;
+	for (const item of items) item.adjacent = null;
+	if (selectedIndex > 0) {
+		const prev = items[selectedIndex - 1];
+		if (prev) prev.adjacent = "prev";
+	}
+	if (selectedIndex < items.length - 1) {
+		const next = items[selectedIndex + 1];
+		if (next) next.adjacent = "next";
+	}
+}
+/**
+* 将公开输入归一化为唯一的跨框架状态。
+* items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；
+* 全部为空 → visible=false。
+*/
+function resolveSideNavState(props = {}) {
+	const selectedValue = props.value;
+	const rawGroups = [];
+	if ((props.items ?? []).length > 0) rawGroups.push({ items: props.items ?? [] });
+	for (const group of props.groups ?? []) rawGroups.push(group);
+	const groups = [];
+	let count = 0;
+	for (const raw of rawGroups) {
+		if (raw.items.length === 0) continue;
+		const items = raw.items.map((item) => ({
+			...resolveItem(item, selectedValue),
+			adjacent: null
+		}));
+		attachAdjacency(items);
+		groups.push({
+			...raw.title !== void 0 ? { title: raw.title } : {},
+			items
+		});
+		count += items.length;
+	}
+	return {
+		visible: count > 0,
+		count,
+		...selectedValue !== void 0 ? { selectedValue } : {},
+		groups
+	};
+}
+/** 将归一化结果转成 root 属性。 */
+function getSideNavRootProps(state) {
+	return {
+		"data-scope": "side-nav",
+		"data-part": "root",
+		"data-count": String(state.count)
+	};
+}
+/** 分组标题元素属性（无状态入参，纯收口）。 */
+function getSideNavGroupLabelProps() {
+	return {
+		"data-scope": "side-nav",
+		"data-part": "group-label"
+	};
+}
+/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */
+function getSideNavItemProps(item) {
+	return {
+		type: "button",
+		"data-scope": "side-nav",
+		"data-part": "item",
+		"data-state": item.selected ? "selected" : "default",
+		...item.selected ? { "aria-current": "true" } : {},
+		...item.adjacent !== null ? { "data-adjacent": item.adjacent } : {},
+		disabled: item.disabled
+	};
+}
+//#endregion
+export { SIDENAV_PARTS, getSideNavGroupLabelProps, getSideNavItemProps, getSideNavRootProps, resolveSideNavState };
+
+//# sourceMappingURL=index.js.map

package/dist/side-nav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/side-nav/side-nav.ts"],"sourcesContent":["/**\n * SideNav 的跨框架行为契约。\n *\n * SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组\n * 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得\n * 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口\n * data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。\n */\n\nexport const SIDENAV_PARTS = [\"root\", \"group-label\", \"item\"] as const;\n\nexport type SideNavPart = (typeof SIDENAV_PARTS)[number];\n\n/** 与选中项直接相邻的方位：prev=上邻项（右下角圆角）、next=下邻项（右上角圆角）。 */\nexport type SideNavItemAdjacent = \"prev\" | \"next\";\n\n/** 单个导航项声明；双栈共享，框架特有的事件通道不进入 Core。 */\nexport interface QwSideNavItemProps {\n  /** 唯一标识；受控选中值与 onChange 回传值均用它比对。 */\n  value: string;\n  /** 纯文本标签，同时作为按钮可访问名。 */\n  label: string;\n  /** 禁用标记：保留灰底、文字降为 placeholder 语义色，不可激活。 */\n  disabled?: boolean;\n}\n\n/** 分组声明；分组标题仅作视觉区隔，不参与选中语义。 */\nexport interface QwSideNavGroupProps {\n  /** 分组标题；缺省时该组无标题行。 */\n  title?: string;\n  /** 该组导航项。 */\n  items: readonly QwSideNavItemProps[];\n}\n\n/** 双栈共享的标量 props。 */\nexport interface QwSideNavProps {\n  /** 扁平声明；归一化为最前的无标题隐式组。 */\n  items?: readonly QwSideNavItemProps[];\n  /** 分组声明；追加在隐式组之后。 */\n  groups?: readonly QwSideNavGroupProps[];\n  /** 受控选中项 value；缺省时全部为默认态。 */\n  value?: string;\n  /** 项被激活（点击/回车/空格）时回传该项 value；点击已选中项同样触发。 */\n  onChange?: (value: string) => void;\n}\n\n/** 逐项归一化结果。 */\nexport interface ResolvedSideNavItemState {\n  value: string;\n  label: string;\n  disabled: boolean;\n  /** value 与受控选中值全等。 */\n  selected: boolean;\n  /** 组内与选中项直接相邻：prev=上邻、next=下邻；否则 null。 */\n  adjacent: SideNavItemAdjacent | null;\n}\n\n/** 归一化分组结果。 */\nexport interface ResolvedSideNavGroupState {\n  title?: string;\n  items: ResolvedSideNavItemState[];\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedSideNavState {\n  visible: boolean;\n  count: number;\n  selectedValue?: string;\n  groups: ResolvedSideNavGroupState[];\n}\n\n/** Core 生成、由适配器摊到根元素（原生 nav）的属性。 */\nexport interface SideNavRootProps {\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"root\";\n  \"data-count\": string;\n}\n\n/** Core 生成、由适配器摊到分组标题元素的属性。 */\nexport interface SideNavGroupLabelProps {\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"group-label\";\n}\n\n/** Core 生成、由适配器摊到导航项（原生 button）的属性。 */\nexport interface SideNavItemProps {\n  type: \"button\";\n  \"data-scope\": \"side-nav\";\n  \"data-part\": \"item\";\n  \"data-state\": \"selected\" | \"default\";\n  \"aria-current\"?: \"true\";\n  \"data-adjacent\"?: SideNavItemAdjacent;\n  disabled: boolean;\n}\n\nfunction resolveItem(\n  item: QwSideNavItemProps,\n  selectedValue: string | undefined,\n): Omit<ResolvedSideNavItemState, \"adjacent\"> {\n  return {\n    value: item.value,\n    label: item.label,\n    disabled: item.disabled ?? false,\n    selected: selectedValue !== undefined && item.value === selectedValue,\n  };\n}\n\n/** 组内邻接推导：仅与选中项索引差 1 的项获得 adjacent；分组标题为边界。 */\nfunction attachAdjacency(items: ResolvedSideNavItemState[]): void {\n  const selectedIndex = items.findIndex((item) => item.selected);\n  if (selectedIndex < 0) return;\n  for (const item of items) item.adjacent = null;\n  if (selectedIndex > 0) {\n    const prev = items[selectedIndex - 1];\n    if (prev) prev.adjacent = \"prev\";\n  }\n  if (selectedIndex < items.length - 1) {\n    const next = items[selectedIndex + 1];\n    if (next) next.adjacent = \"next\";\n  }\n}\n\n/**\n * 将公开输入归一化为唯一的跨框架状态。\n * items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；\n * 全部为空 → visible=false。\n */\nexport function resolveSideNavState(props: QwSideNavProps = {}): ResolvedSideNavState {\n  const selectedValue = props.value;\n  const rawGroups: QwSideNavGroupProps[] = [];\n  if ((props.items ?? []).length > 0) rawGroups.push({ items: props.items ?? [] });\n  for (const group of props.groups ?? []) rawGroups.push(group);\n\n  const groups: ResolvedSideNavGroupState[] = [];\n  let count = 0;\n  for (const raw of rawGroups) {\n    if (raw.items.length === 0) continue;\n    const items = raw.items.map((item) => ({\n      ...resolveItem(item, selectedValue),\n      adjacent: null as SideNavItemAdjacent | null,\n    }));\n    attachAdjacency(items);\n    groups.push({ ...(raw.title !== undefined ? { title: raw.title } : {}), items });\n    count += items.length;\n  }\n\n  return {\n    visible: count > 0,\n    count,\n    ...(selectedValue !== undefined ? { selectedValue } : {}),\n    groups,\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport function getSideNavRootProps(state: ResolvedSideNavState): SideNavRootProps {\n  return {\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"root\",\n    \"data-count\": String(state.count),\n  };\n}\n\n/** 分组标题元素属性（无状态入参，纯收口）。 */\nexport function getSideNavGroupLabelProps(): SideNavGroupLabelProps {\n  return {\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"group-label\",\n  };\n}\n\n/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */\nexport function getSideNavItemProps(item: ResolvedSideNavItemState): SideNavItemProps {\n  return {\n    type: \"button\",\n    \"data-scope\": \"side-nav\",\n    \"data-part\": \"item\",\n    \"data-state\": item.selected ? \"selected\" : \"default\",\n    ...(item.selected ? { \"aria-current\": \"true\" as const } : {}),\n    ...(item.adjacent !== null ? { \"data-adjacent\": item.adjacent } : {}),\n    disabled: item.disabled,\n  };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,gBAAgB;CAAC;CAAQ;CAAe;AAAM;AAsF3D,SAAS,YACP,MACA,eAC4C;CAC5C,OAAO;EACL,OAAO,KAAK;EACZ,OAAO,KAAK;EACZ,UAAU,KAAK,YAAY;EAC3B,UAAU,kBAAkB,KAAA,KAAa,KAAK,UAAU;CAC1D;AACF;;AAGA,SAAS,gBAAgB,OAAyC;CAChE,MAAM,gBAAgB,MAAM,WAAW,SAAS,KAAK,QAAQ;CAC7D,IAAI,gBAAgB,GAAG;CACvB,KAAK,MAAM,QAAQ,OAAO,KAAK,WAAW;CAC1C,IAAI,gBAAgB,GAAG;EACrB,MAAM,OAAO,MAAM,gBAAgB;EACnC,IAAI,MAAM,KAAK,WAAW;CAC5B;CACA,IAAI,gBAAgB,MAAM,SAAS,GAAG;EACpC,MAAM,OAAO,MAAM,gBAAgB;EACnC,IAAI,MAAM,KAAK,WAAW;CAC5B;AACF;;;;;;AAOA,SAAgB,oBAAoB,QAAwB,CAAC,GAAyB;CACpF,MAAM,gBAAgB,MAAM;CAC5B,MAAM,YAAmC,CAAC;CAC1C,KAAK,MAAM,SAAS,CAAC,EAAA,CAAG,SAAS,GAAG,UAAU,KAAK,EAAE,OAAO,MAAM,SAAS,CAAC,EAAE,CAAC;CAC/E,KAAK,MAAM,SAAS,MAAM,UAAU,CAAC,GAAG,UAAU,KAAK,KAAK;CAE5D,MAAM,SAAsC,CAAC;CAC7C,IAAI,QAAQ;CACZ,KAAK,MAAM,OAAO,WAAW;EAC3B,IAAI,IAAI,MAAM,WAAW,GAAG;EAC5B,MAAM,QAAQ,IAAI,MAAM,KAAK,UAAU;GACrC,GAAG,YAAY,MAAM,aAAa;GAClC,UAAU;EACZ,EAAE;EACF,gBAAgB,KAAK;EACrB,OAAO,KAAK;GAAE,GAAI,IAAI,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;GAAI;EAAM,CAAC;EAC/E,SAAS,MAAM;CACjB;CAEA,OAAO;EACL,SAAS,QAAQ;EACjB;EACA,GAAI,kBAAkB,KAAA,IAAY,EAAE,cAAc,IAAI,CAAC;EACvD;CACF;AACF;;AAGA,SAAgB,oBAAoB,OAA+C;CACjF,OAAO;EACL,cAAc;EACd,aAAa;EACb,cAAc,OAAO,MAAM,KAAK;CAClC;AACF;;AAGA,SAAgB,4BAAoD;CAClE,OAAO;EACL,cAAc;EACd,aAAa;CACf;AACF;;AAGA,SAAgB,oBAAoB,MAAkD;CACpF,OAAO;EACL,MAAM;EACN,cAAc;EACd,aAAa;EACb,cAAc,KAAK,WAAW,aAAa;EAC3C,GAAI,KAAK,WAAW,EAAE,gBAAgB,OAAgB,IAAI,CAAC;EAC3D,GAAI,KAAK,aAAa,OAAO,EAAE,iBAAiB,KAAK,SAAS,IAAI,CAAC;EACnE,UAAU,KAAK;CACjB;AACF"}

package/dist/side-nav/side-nav.d.ts

@@ -0,0 +1,94 @@
+/**
+ * SideNav 的跨框架行为契约。
+ *
+ * SideNav 是受控单选的 Prototype A 侧导航列：纵向堆叠的导航项（可选分组
+ * 标题），多用于 H5 浮层分类切换。选中项白底加粗，组内直接相邻项获得
+ * 16px 邻接圆角。这里仅归一化公开 props、推导选中/邻接视觉态并收口
+ * data/aria 属性，React/Vue 适配器不得复制归一化、可见性或推导规则。
+ */
+export declare const SIDENAV_PARTS: readonly ["root", "group-label", "item"];
+export type SideNavPart = (typeof SIDENAV_PARTS)[number];
+/** 与选中项直接相邻的方位：prev=上邻项（右下角圆角）、next=下邻项（右上角圆角）。 */
+export type SideNavItemAdjacent = "prev" | "next";
+/** 单个导航项声明；双栈共享，框架特有的事件通道不进入 Core。 */
+export interface QwSideNavItemProps {
+    /** 唯一标识；受控选中值与 onChange 回传值均用它比对。 */
+    value: string;
+    /** 纯文本标签，同时作为按钮可访问名。 */
+    label: string;
+    /** 禁用标记：保留灰底、文字降为 placeholder 语义色，不可激活。 */
+    disabled?: boolean;
+}
+/** 分组声明；分组标题仅作视觉区隔，不参与选中语义。 */
+export interface QwSideNavGroupProps {
+    /** 分组标题；缺省时该组无标题行。 */
+    title?: string;
+    /** 该组导航项。 */
+    items: readonly QwSideNavItemProps[];
+}
+/** 双栈共享的标量 props。 */
+export interface QwSideNavProps {
+    /** 扁平声明；归一化为最前的无标题隐式组。 */
+    items?: readonly QwSideNavItemProps[];
+    /** 分组声明；追加在隐式组之后。 */
+    groups?: readonly QwSideNavGroupProps[];
+    /** 受控选中项 value；缺省时全部为默认态。 */
+    value?: string;
+    /** 项被激活（点击/回车/空格）时回传该项 value；点击已选中项同样触发。 */
+    onChange?: (value: string) => void;
+}
+/** 逐项归一化结果。 */
+export interface ResolvedSideNavItemState {
+    value: string;
+    label: string;
+    disabled: boolean;
+    /** value 与受控选中值全等。 */
+    selected: boolean;
+    /** 组内与选中项直接相邻：prev=上邻、next=下邻；否则 null。 */
+    adjacent: SideNavItemAdjacent | null;
+}
+/** 归一化分组结果。 */
+export interface ResolvedSideNavGroupState {
+    title?: string;
+    items: ResolvedSideNavItemState[];
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedSideNavState {
+    visible: boolean;
+    count: number;
+    selectedValue?: string;
+    groups: ResolvedSideNavGroupState[];
+}
+/** Core 生成、由适配器摊到根元素（原生 nav）的属性。 */
+export interface SideNavRootProps {
+    "data-scope": "side-nav";
+    "data-part": "root";
+    "data-count": string;
+}
+/** Core 生成、由适配器摊到分组标题元素的属性。 */
+export interface SideNavGroupLabelProps {
+    "data-scope": "side-nav";
+    "data-part": "group-label";
+}
+/** Core 生成、由适配器摊到导航项（原生 button）的属性。 */
+export interface SideNavItemProps {
+    type: "button";
+    "data-scope": "side-nav";
+    "data-part": "item";
+    "data-state": "selected" | "default";
+    "aria-current"?: "true";
+    "data-adjacent"?: SideNavItemAdjacent;
+    disabled: boolean;
+}
+/**
+ * 将公开输入归一化为唯一的跨框架状态。
+ * items 非空时作为最前的无标题隐式组；空组（无项）不产生渲染；
+ * 全部为空 → visible=false。
+ */
+export declare function resolveSideNavState(props?: QwSideNavProps): ResolvedSideNavState;
+/** 将归一化结果转成 root 属性。 */
+export declare function getSideNavRootProps(state: ResolvedSideNavState): SideNavRootProps;
+/** 分组标题元素属性（无状态入参，纯收口）。 */
+export declare function getSideNavGroupLabelProps(): SideNavGroupLabelProps;
+/** 将单个归一化导航项转成 button 属性（选中/邻接/禁用收口，适配器不得覆盖）。 */
+export declare function getSideNavItemProps(item: ResolvedSideNavItemState): SideNavItemProps;

package/dist/stepper/index.d.ts

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

package/dist/stepper/index.js

@@ -0,0 +1,113 @@
+//#region src/stepper/stepper.ts
+/**
+* Stepper 加减（数量步进器）的跨框架行为契约。
+*
+* Stepper 是原型 A（无状态 Core 状态机）：交互由原生 `<button>` 承担，
+* core 只负责数值归一化、边界 clamp、按钮可用性计算与 prop-getter 生成。
+*/
+/** 尺寸全集：s = 15×15px，m = 18×18px。 */
+const STEPPER_SIZES = ["s", "m"];
+/** 形态变体全集：default = 裸按钮组合，bordered = 带边框卡片形态。 */
+const STEPPER_VARIANTS = ["default", "bordered"];
+/** 渲染部位全集（data-part 取值）。 */
+const STEPPER_PARTS = [
+	"root",
+	"decrement",
+	"value",
+	"increment"
+];
+/** 将数值约束在 [min, max] 范围内；边界未定义时跳过对应侧。 */
+function clampStepperValue(value, min, max) {
+	let result = value;
+	if (typeof min === "number" && !Number.isNaN(min)) result = Math.max(result, min);
+	if (typeof max === "number" && !Number.isNaN(max)) result = Math.min(result, max);
+	return result;
+}
+/** 规范化 step：仅接受正数，否则回退到 1。 */
+function normalizeStepperStep(step) {
+	return typeof step === "number" && step > 0 && !Number.isNaN(step) ? step : 1;
+}
+/** 规范化 min：未指定时按规格默认 0（不做负数默认值）。 */
+function normalizeStepperMin(min) {
+	return typeof min === "number" && !Number.isNaN(min) ? min : 0;
+}
+/** 将公开输入归一化为唯一的跨框架状态。 */
+function resolveStepperState(props = {}) {
+	const min = normalizeStepperMin(props.min);
+	const max = props.max;
+	const step = normalizeStepperStep(props.step);
+	const disabled = props.disabled ?? false;
+	const variant = props.variant ?? "default";
+	const value = clampStepperValue(props.value !== void 0 ? props.value : props.defaultValue ?? min, min, max);
+	return {
+		value,
+		min,
+		max,
+		step,
+		disabled,
+		size: props.size ?? "m",
+		variant,
+		selected: value > min,
+		canDecrement: !disabled && value > min,
+		canIncrement: !disabled && (typeof max !== "number" || value < max),
+		decrementLabel: props.decrementLabel ?? "减少",
+		incrementLabel: props.incrementLabel ?? "增加"
+	};
+}
+/** 计算减量后的目标值（已 clamp）。 */
+function getStepperDecrementValue(state) {
+	return clampStepperValue(state.value - state.step, state.min, state.max);
+}
+/** 计算增量后的目标值（已 clamp）。 */
+function getStepperIncrementValue(state) {
+	return clampStepperValue(state.value + state.step, state.min, state.max);
+}
+/** 生成根容器属性。 */
+function getStepperRootProps(state) {
+	return {
+		role: "group",
+		"data-scope": "stepper",
+		"data-part": "root",
+		"data-size": state.size,
+		"data-variant": state.variant,
+		...state.selected ? { "data-selected": "true" } : {},
+		...state.disabled ? { "data-disabled": "true" } : {}
+	};
+}
+/** 生成减量按钮属性。 */
+function getStepperDecrementProps(state) {
+	const disabled = !state.canDecrement;
+	return {
+		type: "button",
+		disabled,
+		"data-scope": "stepper",
+		"data-part": "decrement",
+		"aria-label": state.decrementLabel,
+		...disabled ? { "data-disabled": "true" } : {}
+	};
+}
+/** 生成增量按钮属性。 */
+function getStepperIncrementProps(state) {
+	const disabled = !state.canIncrement;
+	return {
+		type: "button",
+		disabled,
+		"data-scope": "stepper",
+		"data-part": "increment",
+		"aria-label": state.incrementLabel,
+		...disabled ? { "data-disabled": "true" } : {}
+	};
+}
+/** 生成数值展示属性。 */
+function getStepperValueProps() {
+	return {
+		"data-scope": "stepper",
+		"data-part": "value",
+		"aria-live": "polite",
+		"aria-atomic": "true"
+	};
+}
+//#endregion
+export { STEPPER_PARTS, STEPPER_SIZES, STEPPER_VARIANTS, clampStepperValue, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, resolveStepperState };
+
+//# sourceMappingURL=index.js.map

package/dist/stepper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/stepper/stepper.ts"],"sourcesContent":["/**\n * Stepper 加减（数量步进器）的跨框架行为契约。\n *\n * Stepper 是原型 A（无状态 Core 状态机）：交互由原生 `<button>` 承担，\n * core 只负责数值归一化、边界 clamp、按钮可用性计算与 prop-getter 生成。\n */\n\n/** 尺寸全集：s = 15×15px，m = 18×18px。 */\nexport const STEPPER_SIZES = [\"s\", \"m\"] as const;\n\n/** 形态变体全集：default = 裸按钮组合，bordered = 带边框卡片形态。 */\nexport const STEPPER_VARIANTS = [\"default\", \"bordered\"] as const;\n\n/** 渲染部位全集（data-part 取值）。 */\nexport const STEPPER_PARTS = [\"root\", \"decrement\", \"value\", \"increment\"] as const;\n\nexport type StepperSize = (typeof STEPPER_SIZES)[number];\nexport type StepperVariant = (typeof STEPPER_VARIANTS)[number];\nexport type StepperPart = (typeof STEPPER_PARTS)[number];\n\n/**\n * QwStepperProps — 双栈共享的行为契约（全字段可选）。\n * `value` 未传时走非受控模式，由适配层管理内部数值。\n */\nexport interface QwStepperProps {\n  /** 受控值。未传时走非受控模式。 */\n  value?: number;\n  /** 非受控初始值，默认 `0`（若 `min > 0` 则取 `min`）。仅在 `value` 未传时生效。 */\n  defaultValue?: number;\n  /** 数值变化回调，参数为新的 value。 */\n  onChange?: (value: number) => void;\n  /** 最小值。 */\n  min?: number;\n  /** 最大值。 */\n  max?: number;\n  /** 步长，默认 1；非法值（非正数）回退到 1。 */\n  step?: number;\n  /** 禁用状态。 */\n  disabled?: boolean;\n  /** 按钮尺寸，默认 m。 */\n  size?: StepperSize;\n  /** 形态变体，默认 default；bordered 为带边框卡片形态。 */\n  variant?: StepperVariant;\n  /** 减量按钮 aria-label，默认「减少」（适配层可注入语言包取值）。 */\n  decrementLabel?: string;\n  /** 增量按钮 aria-label，默认「增加」（适配层可注入语言包取值）。 */\n  incrementLabel?: string;\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedStepperState {\n  /** 当前数值（已按 min/max clamp）。 */\n  value: number;\n  /** 最小值。 */\n  min: number | undefined;\n  /** 最大值。 */\n  max: number | undefined;\n  /** 实际生效的步长。 */\n  step: number;\n  /** 是否整体禁用。 */\n  disabled: boolean;\n  /** 按钮尺寸。 */\n  size: StepperSize;\n  /** 形态变体。 */\n  variant: StepperVariant;\n  /** 选中态：value > min 派生，仅影响 bordered 视觉。 */\n  selected: boolean;\n  /** 减量按钮是否可用。 */\n  canDecrement: boolean;\n  /** 增量按钮是否可用。 */\n  canIncrement: boolean;\n  /** 减量按钮 aria-label（per-prop > 适配层注入 > 内置「减少」）。 */\n  decrementLabel: string;\n  /** 增量按钮 aria-label（per-prop > 适配层注入 > 内置「增加」）。 */\n  incrementLabel: string;\n}\n\n/** 将数值约束在 [min, max] 范围内；边界未定义时跳过对应侧。 */\nexport function clampStepperValue(\n  value: number,\n  min: number | undefined,\n  max: number | undefined,\n): number {\n  let result = value;\n  if (typeof min === \"number\" && !Number.isNaN(min)) {\n    result = Math.max(result, min);\n  }\n  if (typeof max === \"number\" && !Number.isNaN(max)) {\n    result = Math.min(result, max);\n  }\n  return result;\n}\n\n/** 规范化 step：仅接受正数，否则回退到 1。 */\nfunction normalizeStepperStep(step: number | undefined): number {\n  return typeof step === \"number\" && step > 0 && !Number.isNaN(step) ? step : 1;\n}\n\n/** 规范化 min：未指定时按规格默认 0（不做负数默认值）。 */\nfunction normalizeStepperMin(min: number | undefined): number {\n  return typeof min === \"number\" && !Number.isNaN(min) ? min : 0;\n}\n\n/** 将公开输入归一化为唯一的跨框架状态。 */\nexport function resolveStepperState(props: QwStepperProps = {}): ResolvedStepperState {\n  const min = normalizeStepperMin(props.min);\n  const max = props.max;\n  const step = normalizeStepperStep(props.step);\n  const disabled = props.disabled ?? false;\n  const variant = props.variant ?? \"default\";\n\n  const isControlled = props.value !== undefined;\n  const rawValue = isControlled\n    ? props.value!\n    : (props.defaultValue ?? min);\n\n  const value = clampStepperValue(rawValue, min, max);\n\n  const size = props.size ?? \"m\";\n\n  const selected = value > min;\n\n  const canDecrement = !disabled && value > min;\n  const canIncrement = !disabled && (typeof max !== \"number\" || value < max);\n\n  return {\n    value,\n    min,\n    max,\n    step,\n    disabled,\n    size,\n    variant,\n    selected,\n    canDecrement,\n    canIncrement,\n    decrementLabel: props.decrementLabel ?? \"减少\",\n    incrementLabel: props.incrementLabel ?? \"增加\",\n  };\n}\n\n/** 计算减量后的目标值（已 clamp）。 */\nexport function getStepperDecrementValue(state: ResolvedStepperState): number {\n  return clampStepperValue(state.value - state.step, state.min, state.max);\n}\n\n/** 计算增量后的目标值（已 clamp）。 */\nexport function getStepperIncrementValue(state: ResolvedStepperState): number {\n  return clampStepperValue(state.value + state.step, state.min, state.max);\n}\n\n/** Core 生成、由适配器最后覆盖到根元素的属性。 */\nexport interface StepperRootProps {\n  role: \"group\";\n  \"data-scope\": \"stepper\";\n  \"data-part\": \"root\";\n  \"data-size\": StepperSize;\n  \"data-variant\": StepperVariant;\n  \"data-selected\"?: \"true\";\n  \"data-disabled\"?: \"true\";\n}\n\n/** 生成根容器属性。 */\nexport function getStepperRootProps(state: ResolvedStepperState): StepperRootProps {\n  return {\n    role: \"group\",\n    \"data-scope\": \"stepper\",\n    \"data-part\": \"root\",\n    \"data-size\": state.size,\n    \"data-variant\": state.variant,\n    ...(state.selected ? { \"data-selected\": \"true\" as const } : {}),\n    ...(state.disabled ? { \"data-disabled\": \"true\" as const } : {}),\n  };\n}\n\n/** 减量按钮属性。 */\nexport interface StepperDecrementProps {\n  type: \"button\";\n  disabled: boolean;\n  \"data-scope\": \"stepper\";\n  \"data-part\": \"decrement\";\n  \"aria-label\": string;\n  \"data-disabled\"?: \"true\";\n}\n\n/** 生成减量按钮属性。 */\nexport function getStepperDecrementProps(state: ResolvedStepperState): StepperDecrementProps {\n  const disabled = !state.canDecrement;\n  return {\n    type: \"button\",\n    disabled,\n    \"data-scope\": \"stepper\",\n    \"data-part\": \"decrement\",\n    \"aria-label\": state.decrementLabel,\n    ...(disabled ? { \"data-disabled\": \"true\" as const } : {}),\n  };\n}\n\n/** 增量按钮属性。 */\nexport interface StepperIncrementProps {\n  type: \"button\";\n  disabled: boolean;\n  \"data-scope\": \"stepper\";\n  \"data-part\": \"increment\";\n  \"aria-label\": string;\n  \"data-disabled\"?: \"true\";\n}\n\n/** 生成增量按钮属性。 */\nexport function getStepperIncrementProps(state: ResolvedStepperState): StepperIncrementProps {\n  const disabled = !state.canIncrement;\n  return {\n    type: \"button\",\n    disabled,\n    \"data-scope\": \"stepper\",\n    \"data-part\": \"increment\",\n    \"aria-label\": state.incrementLabel,\n    ...(disabled ? { \"data-disabled\": \"true\" as const } : {}),\n  };\n}\n\n/** 数值展示属性。 */\nexport interface StepperValueProps {\n  \"data-scope\": \"stepper\";\n  \"data-part\": \"value\";\n  \"aria-live\": \"polite\";\n  \"aria-atomic\": \"true\";\n}\n\n/** 生成数值展示属性。 */\nexport function getStepperValueProps(): StepperValueProps {\n  return {\n    \"data-scope\": \"stepper\",\n    \"data-part\": \"value\",\n    \"aria-live\": \"polite\",\n    \"aria-atomic\": \"true\",\n  };\n}\n"],"mappings":";;;;;;;;AAQA,MAAa,gBAAgB,CAAC,KAAK,GAAG;;AAGtC,MAAa,mBAAmB,CAAC,WAAW,UAAU;;AAGtD,MAAa,gBAAgB;CAAC;CAAQ;CAAa;CAAS;AAAW;;AAgEvE,SAAgB,kBACd,OACA,KACA,KACQ;CACR,IAAI,SAAS;CACb,IAAI,OAAO,QAAQ,YAAY,CAAC,OAAO,MAAM,GAAG,GAC9C,SAAS,KAAK,IAAI,QAAQ,GAAG;CAE/B,IAAI,OAAO,QAAQ,YAAY,CAAC,OAAO,MAAM,GAAG,GAC9C,SAAS,KAAK,IAAI,QAAQ,GAAG;CAE/B,OAAO;AACT;;AAGA,SAAS,qBAAqB,MAAkC;CAC9D,OAAO,OAAO,SAAS,YAAY,OAAO,KAAK,CAAC,OAAO,MAAM,IAAI,IAAI,OAAO;AAC9E;;AAGA,SAAS,oBAAoB,KAAiC;CAC5D,OAAO,OAAO,QAAQ,YAAY,CAAC,OAAO,MAAM,GAAG,IAAI,MAAM;AAC/D;;AAGA,SAAgB,oBAAoB,QAAwB,CAAC,GAAyB;CACpF,MAAM,MAAM,oBAAoB,MAAM,GAAG;CACzC,MAAM,MAAM,MAAM;CAClB,MAAM,OAAO,qBAAqB,MAAM,IAAI;CAC5C,MAAM,WAAW,MAAM,YAAY;CACnC,MAAM,UAAU,MAAM,WAAW;CAOjC,MAAM,QAAQ,kBALO,MAAM,UAAU,KAAA,IAEjC,MAAM,QACL,MAAM,gBAAgB,KAEe,KAAK,GAAG;CASlD,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,MAbW,MAAM,QAAQ;EAczB;EACA,UAbe,QAAQ;EAcvB,cAZmB,CAAC,YAAY,QAAQ;EAaxC,cAZmB,CAAC,aAAa,OAAO,QAAQ,YAAY,QAAQ;EAapE,gBAAgB,MAAM,kBAAkB;EACxC,gBAAgB,MAAM,kBAAkB;CAC1C;AACF;;AAGA,SAAgB,yBAAyB,OAAqC;CAC5E,OAAO,kBAAkB,MAAM,QAAQ,MAAM,MAAM,MAAM,KAAK,MAAM,GAAG;AACzE;;AAGA,SAAgB,yBAAyB,OAAqC;CAC5E,OAAO,kBAAkB,MAAM,QAAQ,MAAM,MAAM,MAAM,KAAK,MAAM,GAAG;AACzE;;AAcA,SAAgB,oBAAoB,OAA+C;CACjF,OAAO;EACL,MAAM;EACN,cAAc;EACd,aAAa;EACb,aAAa,MAAM;EACnB,gBAAgB,MAAM;EACtB,GAAI,MAAM,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;EAC7D,GAAI,MAAM,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;CAC/D;AACF;;AAaA,SAAgB,yBAAyB,OAAoD;CAC3F,MAAM,WAAW,CAAC,MAAM;CACxB,OAAO;EACL,MAAM;EACN;EACA,cAAc;EACd,aAAa;EACb,cAAc,MAAM;EACpB,GAAI,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;CACzD;AACF;;AAaA,SAAgB,yBAAyB,OAAoD;CAC3F,MAAM,WAAW,CAAC,MAAM;CACxB,OAAO;EACL,MAAM;EACN;EACA,cAAc;EACd,aAAa;EACb,cAAc,MAAM;EACpB,GAAI,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;CACzD;AACF;;AAWA,SAAgB,uBAA0C;CACxD,OAAO;EACL,cAAc;EACd,aAAa;EACb,aAAa;EACb,eAAe;CACjB;AACF"}

package/dist/stepper/stepper.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Stepper 加减（数量步进器）的跨框架行为契约。
+ *
+ * Stepper 是原型 A（无状态 Core 状态机）：交互由原生 `<button>` 承担，
+ * core 只负责数值归一化、边界 clamp、按钮可用性计算与 prop-getter 生成。
+ */
+/** 尺寸全集：s = 15×15px，m = 18×18px。 */
+export declare const STEPPER_SIZES: readonly ["s", "m"];
+/** 形态变体全集：default = 裸按钮组合，bordered = 带边框卡片形态。 */
+export declare const STEPPER_VARIANTS: readonly ["default", "bordered"];
+/** 渲染部位全集（data-part 取值）。 */
+export declare const STEPPER_PARTS: readonly ["root", "decrement", "value", "increment"];
+export type StepperSize = (typeof STEPPER_SIZES)[number];
+export type StepperVariant = (typeof STEPPER_VARIANTS)[number];
+export type StepperPart = (typeof STEPPER_PARTS)[number];
+/**
+ * QwStepperProps — 双栈共享的行为契约（全字段可选）。
+ * `value` 未传时走非受控模式，由适配层管理内部数值。
+ */
+export interface QwStepperProps {
+    /** 受控值。未传时走非受控模式。 */
+    value?: number;
+    /** 非受控初始值，默认 `0`（若 `min > 0` 则取 `min`）。仅在 `value` 未传时生效。 */
+    defaultValue?: number;
+    /** 数值变化回调，参数为新的 value。 */
+    onChange?: (value: number) => void;
+    /** 最小值。 */
+    min?: number;
+    /** 最大值。 */
+    max?: number;
+    /** 步长，默认 1；非法值（非正数）回退到 1。 */
+    step?: number;
+    /** 禁用状态。 */
+    disabled?: boolean;
+    /** 按钮尺寸，默认 m。 */
+    size?: StepperSize;
+    /** 形态变体，默认 default；bordered 为带边框卡片形态。 */
+    variant?: StepperVariant;
+    /** 减量按钮 aria-label，默认「减少」（适配层可注入语言包取值）。 */
+    decrementLabel?: string;
+    /** 增量按钮 aria-label，默认「增加」（适配层可注入语言包取值）。 */
+    incrementLabel?: string;
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedStepperState {
+    /** 当前数值（已按 min/max clamp）。 */
+    value: number;
+    /** 最小值。 */
+    min: number | undefined;
+    /** 最大值。 */
+    max: number | undefined;
+    /** 实际生效的步长。 */
+    step: number;
+    /** 是否整体禁用。 */
+    disabled: boolean;
+    /** 按钮尺寸。 */
+    size: StepperSize;
+    /** 形态变体。 */
+    variant: StepperVariant;
+    /** 选中态：value > min 派生，仅影响 bordered 视觉。 */
+    selected: boolean;
+    /** 减量按钮是否可用。 */
+    canDecrement: boolean;
+    /** 增量按钮是否可用。 */
+    canIncrement: boolean;
+    /** 减量按钮 aria-label（per-prop > 适配层注入 > 内置「减少」）。 */
+    decrementLabel: string;
+    /** 增量按钮 aria-label（per-prop > 适配层注入 > 内置「增加」）。 */
+    incrementLabel: string;
+}
+/** 将数值约束在 [min, max] 范围内；边界未定义时跳过对应侧。 */
+export declare function clampStepperValue(value: number, min: number | undefined, max: number | undefined): number;
+/** 将公开输入归一化为唯一的跨框架状态。 */
+export declare function resolveStepperState(props?: QwStepperProps): ResolvedStepperState;
+/** 计算减量后的目标值（已 clamp）。 */
+export declare function getStepperDecrementValue(state: ResolvedStepperState): number;
+/** 计算增量后的目标值（已 clamp）。 */
+export declare function getStepperIncrementValue(state: ResolvedStepperState): number;
+/** Core 生成、由适配器最后覆盖到根元素的属性。 */
+export interface StepperRootProps {
+    role: "group";
+    "data-scope": "stepper";
+    "data-part": "root";
+    "data-size": StepperSize;
+    "data-variant": StepperVariant;
+    "data-selected"?: "true";
+    "data-disabled"?: "true";
+}
+/** 生成根容器属性。 */
+export declare function getStepperRootProps(state: ResolvedStepperState): StepperRootProps;
+/** 减量按钮属性。 */
+export interface StepperDecrementProps {
+    type: "button";
+    disabled: boolean;
+    "data-scope": "stepper";
+    "data-part": "decrement";
+    "aria-label": string;
+    "data-disabled"?: "true";
+}
+/** 生成减量按钮属性。 */
+export declare function getStepperDecrementProps(state: ResolvedStepperState): StepperDecrementProps;
+/** 增量按钮属性。 */
+export interface StepperIncrementProps {
+    type: "button";
+    disabled: boolean;
+    "data-scope": "stepper";
+    "data-part": "increment";
+    "aria-label": string;
+    "data-disabled"?: "true";
+}
+/** 生成增量按钮属性。 */
+export declare function getStepperIncrementProps(state: ResolvedStepperState): StepperIncrementProps;
+/** 数值展示属性。 */
+export interface StepperValueProps {
+    "data-scope": "stepper";
+    "data-part": "value";
+    "aria-live": "polite";
+    "aria-atomic": "true";
+}
+/** 生成数值展示属性。 */
+export declare function getStepperValueProps(): StepperValueProps;

package/dist/switch/index.d.ts

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

package/dist/switch/index.js

@@ -0,0 +1,43 @@
+//#region src/switch/switch.ts
+/**
+* Switch 的跨框架行为契约。
+*
+* Switch 是无状态的 Prototype A：交互由原生 button 承担，
+* 这里仅归一化公开 props（checked / defaultChecked / disabled）。
+* React/Vue 适配器不得复制 disabled 或 checked 的组合规则。
+*/
+/** Switch 各渲染部位全集（data-part 取值）。 */
+const SWITCH_PARTS = ["root", "thumb"];
+/** 将公开输入归一化为唯一的跨框架状态。 */
+function resolveSwitchState(props = {}) {
+	return {
+		checked: props.checked ?? props.defaultChecked ?? false,
+		disabled: props.disabled ?? false,
+		type: props.type ?? "button"
+	};
+}
+/** 将归一化结果转成 root 属性。 */
+function getSwitchRootProps(state) {
+	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" } : {}
+	};
+}
+/** 生成旋钮属性。 */
+function getSwitchThumbProps() {
+	return {
+		"data-scope": "switch",
+		"data-part": "thumb",
+		"aria-hidden": "true"
+	};
+}
+//#endregion
+export { SWITCH_PARTS, getSwitchRootProps, getSwitchThumbProps, resolveSwitchState };
+
+//# 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 * Switch 是无状态的 Prototype A：交互由原生 button 承担，\n * 这里仅归一化公开 props（checked / defaultChecked / disabled）。\n * React/Vue 适配器不得复制 disabled 或 checked 的组合规则。\n */\n\n/** Switch 各渲染部位全集（data-part 取值）。 */\nexport const SWITCH_PARTS = [\"root\", \"thumb\"] as const;\n\nexport type SwitchPart = (typeof SWITCH_PARTS)[number];\n\n/**\n * QwSwitchProps — 双栈共享的行为契约（全字段可选）。\n * checked 未传时走非受控模式，由适配层管理内部状态。\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  /** 原生 button 类型，默认 `button`。 */\n  type?: \"button\" | \"submit\" | \"reset\";\n}\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedSwitchState {\n  checked: boolean;\n  disabled: 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  return {\n    checked: props.checked ?? props.defaultChecked ?? false,\n    disabled: props.disabled ?? false,\n    type: props.type ?? \"button\",\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport function getSwitchRootProps(state: ResolvedSwitchState): SwitchRootProps {\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  };\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":";;;;;;;;;AASA,MAAa,eAAe,CAAC,QAAQ,OAAO;;AAgD5C,SAAgB,mBAAmB,QAAuB,CAAC,GAAwB;CACjF,OAAO;EACL,SAAS,MAAM,WAAW,MAAM,kBAAkB;EAClD,UAAU,MAAM,YAAY;EAC5B,MAAM,MAAM,QAAQ;CACtB;AACF;;AAGA,SAAgB,mBAAmB,OAA6C;CAC9E,OAAO;EACL,MAAM,MAAM;EACZ,MAAM;EACN,UAAU,MAAM;EAChB,gBAAgB,MAAM,UAAU,SAAS;EACzC,cAAc;EACd,aAAa;EACb,gBAAgB,MAAM,UAAU,SAAS;EACzC,GAAI,MAAM,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;CAC/D;AACF;;AAGA,SAAgB,sBAAwC;CACtD,OAAO;EACL,cAAc;EACd,aAAa;EACb,eAAe;CACjB;AACF"}

package/dist/switch/switch.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Switch 的跨框架行为契约。
+ *
+ * Switch 是无状态的 Prototype A：交互由原生 button 承担，
+ * 这里仅归一化公开 props（checked / defaultChecked / disabled）。
+ * React/Vue 适配器不得复制 disabled 或 checked 的组合规则。
+ */
+/** Switch 各渲染部位全集（data-part 取值）。 */
+export declare const SWITCH_PARTS: readonly ["root", "thumb"];
+export type SwitchPart = (typeof SWITCH_PARTS)[number];
+/**
+ * QwSwitchProps — 双栈共享的行为契约（全字段可选）。
+ * checked 未传时走非受控模式，由适配层管理内部状态。
+ */
+export interface QwSwitchProps {
+    /** 受控值。未传时走非受控模式。 */
+    checked?: boolean;
+    /** 非受控初始值，默认 false。仅在 checked 未传时生效。 */
+    defaultChecked?: boolean;
+    /** 状态变化回调，参数为新的 checked 值。 */
+    onToggle?: (checked: boolean) => void;
+    /** 禁用状态。 */
+    disabled?: boolean;
+    /** 原生 button 类型，默认 `button`。 */
+    type?: "button" | "submit" | "reset";
+}
+/** 适配器唯一可消费的归一化结果。 */
+export interface ResolvedSwitchState {
+    checked: boolean;
+    disabled: 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 declare function getSwitchRootProps(state: ResolvedSwitchState): SwitchRootProps;
+/** 生成旋钮属性。 */
+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,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"}