@qw-ui/core 0.3.0-next.10 → 0.3.0-next.12

package/dist/index.d.ts

@@ -28,3 +28,5 @@ 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";

package/dist/index.js

@@ -13,4 +13,5 @@ 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";
+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, SWITCH_PARTS, 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, getSwitchRootProps, getSwitchThumbProps, isToastIconType, resolveAvatarState, resolveButtonState, resolveIconName, resolveOverlayPanelHeight, resolveSwitchState, resolveToastDuration, tabsMachine, connect$1 as textAreaConnect, machine as textAreaMachine };

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/visual-manifest.d.ts

@@ -16,6 +16,8 @@ export type QwVisualState = "default" | "hover" | "active" | "focus-visible" | "
 export type QwVisualTheme = "light" | "dark";
 /** 框架轴。 */
 export type QwVisualFramework = "react" | "vue";
+/** visual target 的查找作用域；省略时先查 demo canvas，再回退到整页。 */
+export type QwVisualTargetScope = "canvas" | "page";
 /** 视口配置（预留扩展；默认 mobile = 390×844 @2x，与 G3 一致）。 */
 export type QwVisualViewport = "mobile";
 /**
@@ -101,6 +103,8 @@ export interface QwVisualScenario {
     demo: string;
     /** 对应 demo 中 `data-visual-target` 的值。 */
     target: string;
+    /** Portal 等已知整页目标可声明 page，避免先等待 canvas 查找超时。 */
+    targetScope?: QwVisualTargetScope;
     /** 本场景要验证的视觉状态列表。 */
     states: QwVisualState[];
     /** 主题列表，默认 light + dark（主题 delta 使用；parity 仍跑双主题）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qw-ui/core",
-  "version": "0.3.0-next.10",
+  "version": "0.3.0-next.12",
   "description": "L2 · Headless Core — zag.js machine 薄包装，纯 TS / SSR-safe，零样式。",
   "license": "MIT",
   "author": "qw-ui contributors",
@@ -95,6 +95,10 @@
     "./input": {
       "types": "./dist/input/index.d.ts",
       "import": "./dist/input/index.js"
+    },
+    "./switch": {
+      "types": "./dist/switch/index.d.ts",
+      "import": "./dist/switch/index.js"
     }
   },
   "sideEffects": false,
@@ -103,7 +107,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.10"
+    "@qw-ui/icons": "^0.3.0-next.12"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.58.9",