@qw-ui/core 0.3.0-next.11 → 0.3.0-next.13

package/dist/index.d.ts

@@ -28,3 +28,7 @@ export { TAG_PARTS, TAG_SIZES, TAG_VARIANTS } from "./tag/index.js";
 export type { TagPart, TagSize, TagVariant, QwTagProps } from "./tag/index.js";
 export { createInputProps } from "./input/index.js";
 export type { QwInputProps, InputApi, InputMode, InputReadOnlyOverflow } from "./input/index.js";
+export { SWITCH_PARTS, getSwitchRootProps, getSwitchThumbProps, resolveSwitchState } from "./switch/index.js";
+export type { SwitchPart, QwSwitchProps, ResolvedSwitchState, SwitchRootProps, SwitchThumbProps } from "./switch/index.js";
+export { STEPPER_SIZES, STEPPER_PARTS, clampStepperValue, getStepperRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperValueProps, resolveStepperState, } from "./stepper/index.js";
+export type { StepperPart, StepperSize, QwStepperProps, ResolvedStepperState, StepperRootProps, StepperDecrementProps, StepperIncrementProps, StepperValueProps, } from "./stepper/index.js";

package/dist/index.js

@@ -13,4 +13,6 @@ import { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AV
 import { connect as connect$1, createTextAreaProps, machine } from "./textarea/index.js";
 import { TAG_PARTS, TAG_SIZES, TAG_VARIANTS } from "./tag/index.js";
 import { createInputProps } from "./input/index.js";
-export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, 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, TAG_PARTS, TAG_SIZES, TAG_VARIANTS, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, TOPBAR_VARIANTS, connect, createDialogProps, createInputProps, createTabsProps, createTextAreaProps, createTopBarProps, dialogMachine, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getButtonRootProps, isToastIconType, resolveAvatarState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };
+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";
+export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, BUTTON_ICON_POSITIONS, BUTTON_PARTS, BUTTON_SHAPES, BUTTON_SIZES, BUTTON_TONES, BUTTON_VARIANTS, 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, getButtonRootProps, getStepperDecrementProps, getStepperDecrementValue, getStepperIncrementProps, getStepperIncrementValue, getStepperRootProps, getStepperValueProps, getSwitchRootProps, getSwitchThumbProps, isToastIconType, resolveAvatarState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveStepperState, resolveSwitchState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };

package/dist/stepper/index.d.ts

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

package/dist/stepper/index.js

@@ -0,0 +1,111 @@
+//#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)
+	};
+}
+/** 计算减量后的目标值（已 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": "减少",
+		...disabled ? { "data-disabled": "true" } : {}
+	};
+}
+/** 生成增量按钮属性。 */
+function getStepperIncrementProps(state) {
+	const disabled = !state.canIncrement;
+	return {
+		type: "button",
+		disabled,
+		"data-scope": "stepper",
+		"data-part": "increment",
+		"aria-label": "增加",
+		...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}\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}\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  };\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\": \"减少\",\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\": \"增加\",\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;;AAwDvE,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;CAatE;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;EACd,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;EACd,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,113 @@
+/**
+ * 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;
+}
+/** 适配器唯一可消费的归一化结果。 */
+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;
+}
+/** 将数值约束在 [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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qw-ui/core",
-  "version": "0.3.0-next.11",
+  "version": "0.3.0-next.13",
   "description": "L2 · Headless Core — zag.js machine 薄包装，纯 TS / SSR-safe，零样式。",
   "license": "MIT",
   "author": "qw-ui contributors",
@@ -95,6 +95,14 @@
     "./input": {
       "types": "./dist/input/index.d.ts",
       "import": "./dist/input/index.js"
+    },
+    "./switch": {
+      "types": "./dist/switch/index.d.ts",
+      "import": "./dist/switch/index.js"
+    },
+    "./stepper": {
+      "types": "./dist/stepper/index.d.ts",
+      "import": "./dist/stepper/index.js"
     }
   },
   "sideEffects": false,
@@ -103,7 +111,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.11"
+    "@qw-ui/icons": "^0.3.0-next.13"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.58.9",
@@ -117,8 +125,8 @@
     "typescript": "^6.0.3",
     "unrun": "^0.3.1",
     "vitest": "^4.1.9",
-    "@qw-ui/eslint-config": "0.0.1",
-    "@qw-ui/tsconfig": "0.0.1"
+    "@qw-ui/tsconfig": "0.0.1",
+    "@qw-ui/eslint-config": "0.0.1"
   },
   "size-limit": [
     {