@qw-ui/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qw-ui contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/dialog/index.d.ts

@@ -0,0 +1,56 @@
+import { Props } from '@zag-js/dialog';
+export { Api as QwDialogApi, connect, machine as dialogMachine } from '@zag-js/dialog';
+
+/**
+ * QwDialogProps — Dialog 的用户输入。
+ *
+ * 对 zag.js 输入做两件事 (§06)：
+ * 1. 默认值收口：closeOnEsc / closeOnOutside / scrollLock 默认全 true；
+ * 2. 命名 rebrand：把 zag 的 closeOnInteractOutside / preventScroll 改成业务易懂命名；
+ * 3. 业务 props 透出：onOpenChange / initialFocus / returnFocus 在 React/Vue 同名。
+ *
+ * 业务方只需 import 本类型，不需要直接 import `@zag-js/*`。
+ */
+interface QwDialogProps {
+    /** 唯一 id 前缀；不传时由 zag 安全生成 (SSR/CSR 一致)。 */
+    id?: string;
+    /** 受控开关。 */
+    open?: boolean;
+    /** 非受控初值。 */
+    defaultOpen?: boolean;
+    /** ESC 关闭，默认 true (zag 原名 closeOnEscape)。 */
+    closeOnEsc?: boolean;
+    /** 点击 backdrop 关闭，默认 true (zag 原名 closeOnInteractOutside)。 */
+    closeOnOutside?: boolean;
+    /** 滚动锁，默认 true (zag 原名 preventScroll)。 */
+    scrollLock?: boolean;
+    /** 模态遮蔽，默认 true。 */
+    modal?: boolean;
+    /** 角色，默认 dialog。 */
+    role?: "dialog" | "alertdialog";
+    /** 初始焦点策略；对象形式提供 selector，由 core 翻译成 zag 的 initialFocusEl。 */
+    initialFocus?: "autofocus" | "first" | "none" | {
+        selector: string;
+    };
+    /** 关闭回焦策略；对应 zag 的 restoreFocus + finalFocusEl。 */
+    returnFocus?: "previous" | "none" | {
+        selector: string;
+    };
+    /** 状态变化回调；zag 原生 onOpenChange。 */
+    onOpenChange?: (e: {
+        open: boolean;
+    }) => void;
+    /**
+     * 禁用 trigger：禁用后点击/键盘都不打开。
+     * adapter 层声明式属性（落到原生 button[disabled]）——zag dialog 无此 context，不进 machine。
+     */
+    disabled?: boolean;
+}
+
+/**
+ * 把 QwDialogProps 转成 zag dialog machine 的 context (默认值收口 + 命名 rebrand)。
+ * 用法：`useMachine(dialogMachine, createDialogProps(props))`。
+ */
+declare function createDialogProps(props?: QwDialogProps): Partial<Props>;
+
+export { type QwDialogProps, createDialogProps };

package/dist/dialog/index.js

@@ -0,0 +1,34 @@
+export { connect, machine as dialogMachine } from '@zag-js/dialog';
+
+// src/dialog/index.ts
+function createDialogProps(props = {}) {
+  const ctx = {
+    id: props.id,
+    open: props.open,
+    defaultOpen: props.defaultOpen,
+    role: props.role,
+    closeOnEscape: props.closeOnEsc !== false,
+    closeOnInteractOutside: props.closeOnOutside !== false,
+    preventScroll: props.scrollLock !== false
+  };
+  if (props.modal !== void 0) ctx.modal = props.modal;
+  if (props.onOpenChange) {
+    const cb = props.onOpenChange;
+    ctx.onOpenChange = (d) => cb({ open: d.open });
+  }
+  if (typeof props.initialFocus === "object") {
+    const sel = props.initialFocus.selector;
+    ctx.initialFocusEl = () => document.querySelector(sel);
+  }
+  if (typeof props.returnFocus === "object") {
+    const sel = props.returnFocus.selector;
+    ctx.finalFocusEl = () => document.querySelector(sel);
+  } else if (props.returnFocus === "none") {
+    ctx.restoreFocus = false;
+  }
+  return ctx;
+}
+
+export { createDialogProps };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/dialog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dialog/index.ts"],"names":[],"mappings":";;;AAwDO,SAAS,iBAAA,CAAkB,KAAA,GAAuB,EAAC,EAA4B;AACpF,EAAA,MAAM,GAAA,GAA+B;AAAA,IACnC,IAAI,KAAA,CAAM,EAAA;AAAA,IACV,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,aAAA,EAAe,MAAM,UAAA,KAAe,KAAA;AAAA,IACpC,sBAAA,EAAwB,MAAM,cAAA,KAAmB,KAAA;AAAA,IACjD,aAAA,EAAe,MAAM,UAAA,KAAe;AAAA,GACtC;AAEA,EAAA,IAAI,KAAA,CAAM,KAAA,KAAU,MAAA,EAAW,GAAA,CAAI,QAAQ,KAAA,CAAM,KAAA;AAEjD,EAAA,IAAI,MAAM,YAAA,EAAc;AACtB,IAAA,MAAM,KAAK,KAAA,CAAM,YAAA;AACjB,IAAA,GAAA,CAAI,YAAA,GAAe,CAAC,CAAA,KAAyB,EAAA,CAAG,EAAE,IAAA,EAAM,CAAA,CAAE,MAAM,CAAA;AAAA,EAClE;AAGA,EAAA,IAAI,OAAO,KAAA,CAAM,YAAA,KAAiB,QAAA,EAAU;AAC1C,IAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAAa,QAAA;AAC/B,IAAA,GAAA,CAAI,cAAA,GAAiB,MAAM,QAAA,CAAS,aAAA,CAA2B,GAAG,CAAA;AAAA,EACpE;AAGA,EAAA,IAAI,OAAO,KAAA,CAAM,WAAA,KAAgB,QAAA,EAAU;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,WAAA,CAAY,QAAA;AAC9B,IAAA,GAAA,CAAI,YAAA,GAAe,MAAM,QAAA,CAAS,aAAA,CAA2B,GAAG,CAAA;AAAA,EAClE,CAAA,MAAA,IAAW,KAAA,CAAM,WAAA,KAAgB,MAAA,EAAQ;AACvC,IAAA,GAAA,CAAI,YAAA,GAAe,KAAA;AAAA,EACrB;AAEA,EAAA,OAAO,GAAA;AACT","file":"index.js","sourcesContent":["import type { Props as ZagDialogProps, OpenChangeDetails } from \"@zag-js/dialog\";\n\n/**\n * QwDialogProps — Dialog 的用户输入。\n *\n * 对 zag.js 输入做两件事 (§06)：\n * 1. 默认值收口：closeOnEsc / closeOnOutside / scrollLock 默认全 true；\n * 2. 命名 rebrand：把 zag 的 closeOnInteractOutside / preventScroll 改成业务易懂命名；\n * 3. 业务 props 透出：onOpenChange / initialFocus / returnFocus 在 React/Vue 同名。\n *\n * 业务方只需 import 本类型，不需要直接 import `@zag-js/*`。\n */\nexport interface QwDialogProps {\n  /** 唯一 id 前缀；不传时由 zag 安全生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控开关。 */\n  open?: boolean;\n  /** 非受控初值。 */\n  defaultOpen?: boolean;\n  /** ESC 关闭，默认 true (zag 原名 closeOnEscape)。 */\n  closeOnEsc?: boolean;\n  /** 点击 backdrop 关闭，默认 true (zag 原名 closeOnInteractOutside)。 */\n  closeOnOutside?: boolean;\n  /** 滚动锁，默认 true (zag 原名 preventScroll)。 */\n  scrollLock?: boolean;\n  /** 模态遮蔽，默认 true。 */\n  modal?: boolean;\n  /** 角色，默认 dialog。 */\n  role?: \"dialog\" | \"alertdialog\";\n  /** 初始焦点策略；对象形式提供 selector，由 core 翻译成 zag 的 initialFocusEl。 */\n  initialFocus?: \"autofocus\" | \"first\" | \"none\" | { selector: string };\n  /** 关闭回焦策略；对应 zag 的 restoreFocus + finalFocusEl。 */\n  returnFocus?: \"previous\" | \"none\" | { selector: string };\n  /** 状态变化回调；zag 原生 onOpenChange。 */\n  onOpenChange?: (e: { open: boolean }) => void;\n  /**\n   * 禁用 trigger：禁用后点击/键盘都不打开。\n   * adapter 层声明式属性（落到原生 button[disabled]）——zag dialog 无此 context，不进 machine。\n   */\n  disabled?: boolean;\n}\n\n/**\n * 直接 re-export zag 的 dialog machine 与 connect —— 不再包一层。\n * machine 由各框架 useMachine 消费；connect 把 service 接成 prop-getter。\n * 用 re-export 而非 `const x = dialog.x` 以保留原始可移植类型 (避免 TS2742)。\n */\nexport { machine as dialogMachine, connect } from \"@zag-js/dialog\";\n\n/** rebrand zag 的 DialogApi 类型对外。 */\nexport type { Api as QwDialogApi } from \"@zag-js/dialog\";\n\n/**\n * 把 QwDialogProps 转成 zag dialog machine 的 context (默认值收口 + 命名 rebrand)。\n * 用法：`useMachine(dialogMachine, createDialogProps(props))`。\n */\nexport function createDialogProps(props: QwDialogProps = {}): Partial<ZagDialogProps> {\n  const ctx: Partial<ZagDialogProps> = {\n    id: props.id,\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    role: props.role,\n    closeOnEscape: props.closeOnEsc !== false,\n    closeOnInteractOutside: props.closeOnOutside !== false,\n    preventScroll: props.scrollLock !== false,\n  };\n\n  if (props.modal !== undefined) ctx.modal = props.modal;\n\n  if (props.onOpenChange) {\n    const cb = props.onOpenChange;\n    ctx.onOpenChange = (d: OpenChangeDetails) => cb({ open: d.open });\n  }\n\n  // initialFocus: { selector } → initialFocusEl 回调；'none' 关闭自动聚焦\n  if (typeof props.initialFocus === \"object\") {\n    const sel = props.initialFocus.selector;\n    ctx.initialFocusEl = () => document.querySelector<HTMLElement>(sel);\n  }\n\n  // returnFocus: { selector } → finalFocusEl；'none' → restoreFocus=false\n  if (typeof props.returnFocus === \"object\") {\n    const sel = props.returnFocus.selector;\n    ctx.finalFocusEl = () => document.querySelector<HTMLElement>(sel);\n  } else if (props.returnFocus === \"none\") {\n    ctx.restoreFocus = false;\n  }\n\n  return ctx;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { QwDialogProps, createDialogProps } from './dialog/index.js';
+export { QwTabsProps, createTabsProps } from './tabs/index.js';
+export { Api as QwDialogApi, connect, machine as dialogMachine } from '@zag-js/dialog';
+export { Api as QwTabsApi, machine as tabsMachine } from '@zag-js/tabs';

package/dist/index.js

@@ -0,0 +1,50 @@
+export { connect, machine as dialogMachine } from '@zag-js/dialog';
+export { machine as tabsMachine } from '@zag-js/tabs';
+
+// src/dialog/index.ts
+function createDialogProps(props = {}) {
+  const ctx = {
+    id: props.id,
+    open: props.open,
+    defaultOpen: props.defaultOpen,
+    role: props.role,
+    closeOnEscape: props.closeOnEsc !== false,
+    closeOnInteractOutside: props.closeOnOutside !== false,
+    preventScroll: props.scrollLock !== false
+  };
+  if (props.modal !== void 0) ctx.modal = props.modal;
+  if (props.onOpenChange) {
+    const cb = props.onOpenChange;
+    ctx.onOpenChange = (d) => cb({ open: d.open });
+  }
+  if (typeof props.initialFocus === "object") {
+    const sel = props.initialFocus.selector;
+    ctx.initialFocusEl = () => document.querySelector(sel);
+  }
+  if (typeof props.returnFocus === "object") {
+    const sel = props.returnFocus.selector;
+    ctx.finalFocusEl = () => document.querySelector(sel);
+  } else if (props.returnFocus === "none") {
+    ctx.restoreFocus = false;
+  }
+  return ctx;
+}
+function createTabsProps(props = {}) {
+  const ctx = {
+    id: props.id,
+    value: props.value,
+    defaultValue: props.defaultValue,
+    orientation: props.orientation,
+    activationMode: props.activationMode,
+    loopFocus: props.loop !== false
+  };
+  if (props.onValueChange) {
+    const cb = props.onValueChange;
+    ctx.onValueChange = (d) => cb({ value: d.value });
+  }
+  return ctx;
+}
+
+export { createDialogProps, createTabsProps };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dialog/index.ts","../src/tabs/index.ts"],"names":[],"mappings":";;;;AAwDO,SAAS,iBAAA,CAAkB,KAAA,GAAuB,EAAC,EAA4B;AACpF,EAAA,MAAM,GAAA,GAA+B;AAAA,IACnC,IAAI,KAAA,CAAM,EAAA;AAAA,IACV,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,aAAA,EAAe,MAAM,UAAA,KAAe,KAAA;AAAA,IACpC,sBAAA,EAAwB,MAAM,cAAA,KAAmB,KAAA;AAAA,IACjD,aAAA,EAAe,MAAM,UAAA,KAAe;AAAA,GACtC;AAEA,EAAA,IAAI,KAAA,CAAM,KAAA,KAAU,MAAA,EAAW,GAAA,CAAI,QAAQ,KAAA,CAAM,KAAA;AAEjD,EAAA,IAAI,MAAM,YAAA,EAAc;AACtB,IAAA,MAAM,KAAK,KAAA,CAAM,YAAA;AACjB,IAAA,GAAA,CAAI,YAAA,GAAe,CAAC,CAAA,KAAyB,EAAA,CAAG,EAAE,IAAA,EAAM,CAAA,CAAE,MAAM,CAAA;AAAA,EAClE;AAGA,EAAA,IAAI,OAAO,KAAA,CAAM,YAAA,KAAiB,QAAA,EAAU;AAC1C,IAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAAa,QAAA;AAC/B,IAAA,GAAA,CAAI,cAAA,GAAiB,MAAM,QAAA,CAAS,aAAA,CAA2B,GAAG,CAAA;AAAA,EACpE;AAGA,EAAA,IAAI,OAAO,KAAA,CAAM,WAAA,KAAgB,QAAA,EAAU;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,WAAA,CAAY,QAAA;AAC9B,IAAA,GAAA,CAAI,YAAA,GAAe,MAAM,QAAA,CAAS,aAAA,CAA2B,GAAG,CAAA;AAAA,EAClE,CAAA,MAAA,IAAW,KAAA,CAAM,WAAA,KAAgB,MAAA,EAAQ;AACvC,IAAA,GAAA,CAAI,YAAA,GAAe,KAAA;AAAA,EACrB;AAEA,EAAA,OAAO,GAAA;AACT;AClDO,SAAS,eAAA,CAAgB,KAAA,GAAqB,EAAC,EAA0B;AAC9E,EAAA,MAAM,GAAA,GAA6B;AAAA,IACjC,IAAI,KAAA,CAAM,EAAA;AAAA,IACV,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,cAAc,KAAA,CAAM,YAAA;AAAA,IACpB,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,gBAAgB,KAAA,CAAM,cAAA;AAAA,IACtB,SAAA,EAAW,MAAM,IAAA,KAAS;AAAA,GAC5B;AAEA,EAAA,IAAI,MAAM,aAAA,EAAe;AACvB,IAAA,MAAM,KAAK,KAAA,CAAM,aAAA;AACjB,IAAA,GAAA,CAAI,aAAA,GAAgB,CAAC,CAAA,KAA0B,EAAA,CAAG,EAAE,KAAA,EAAO,CAAA,CAAE,OAAO,CAAA;AAAA,EACtE;AAEA,EAAA,OAAO,GAAA;AACT","file":"index.js","sourcesContent":["import type { Props as ZagDialogProps, OpenChangeDetails } from \"@zag-js/dialog\";\n\n/**\n * QwDialogProps — Dialog 的用户输入。\n *\n * 对 zag.js 输入做两件事 (§06)：\n * 1. 默认值收口：closeOnEsc / closeOnOutside / scrollLock 默认全 true；\n * 2. 命名 rebrand：把 zag 的 closeOnInteractOutside / preventScroll 改成业务易懂命名；\n * 3. 业务 props 透出：onOpenChange / initialFocus / returnFocus 在 React/Vue 同名。\n *\n * 业务方只需 import 本类型，不需要直接 import `@zag-js/*`。\n */\nexport interface QwDialogProps {\n  /** 唯一 id 前缀；不传时由 zag 安全生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控开关。 */\n  open?: boolean;\n  /** 非受控初值。 */\n  defaultOpen?: boolean;\n  /** ESC 关闭，默认 true (zag 原名 closeOnEscape)。 */\n  closeOnEsc?: boolean;\n  /** 点击 backdrop 关闭，默认 true (zag 原名 closeOnInteractOutside)。 */\n  closeOnOutside?: boolean;\n  /** 滚动锁，默认 true (zag 原名 preventScroll)。 */\n  scrollLock?: boolean;\n  /** 模态遮蔽，默认 true。 */\n  modal?: boolean;\n  /** 角色，默认 dialog。 */\n  role?: \"dialog\" | \"alertdialog\";\n  /** 初始焦点策略；对象形式提供 selector，由 core 翻译成 zag 的 initialFocusEl。 */\n  initialFocus?: \"autofocus\" | \"first\" | \"none\" | { selector: string };\n  /** 关闭回焦策略；对应 zag 的 restoreFocus + finalFocusEl。 */\n  returnFocus?: \"previous\" | \"none\" | { selector: string };\n  /** 状态变化回调；zag 原生 onOpenChange。 */\n  onOpenChange?: (e: { open: boolean }) => void;\n  /**\n   * 禁用 trigger：禁用后点击/键盘都不打开。\n   * adapter 层声明式属性（落到原生 button[disabled]）——zag dialog 无此 context，不进 machine。\n   */\n  disabled?: boolean;\n}\n\n/**\n * 直接 re-export zag 的 dialog machine 与 connect —— 不再包一层。\n * machine 由各框架 useMachine 消费；connect 把 service 接成 prop-getter。\n * 用 re-export 而非 `const x = dialog.x` 以保留原始可移植类型 (避免 TS2742)。\n */\nexport { machine as dialogMachine, connect } from \"@zag-js/dialog\";\n\n/** rebrand zag 的 DialogApi 类型对外。 */\nexport type { Api as QwDialogApi } from \"@zag-js/dialog\";\n\n/**\n * 把 QwDialogProps 转成 zag dialog machine 的 context (默认值收口 + 命名 rebrand)。\n * 用法：`useMachine(dialogMachine, createDialogProps(props))`。\n */\nexport function createDialogProps(props: QwDialogProps = {}): Partial<ZagDialogProps> {\n  const ctx: Partial<ZagDialogProps> = {\n    id: props.id,\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    role: props.role,\n    closeOnEscape: props.closeOnEsc !== false,\n    closeOnInteractOutside: props.closeOnOutside !== false,\n    preventScroll: props.scrollLock !== false,\n  };\n\n  if (props.modal !== undefined) ctx.modal = props.modal;\n\n  if (props.onOpenChange) {\n    const cb = props.onOpenChange;\n    ctx.onOpenChange = (d: OpenChangeDetails) => cb({ open: d.open });\n  }\n\n  // initialFocus: { selector } → initialFocusEl 回调；'none' 关闭自动聚焦\n  if (typeof props.initialFocus === \"object\") {\n    const sel = props.initialFocus.selector;\n    ctx.initialFocusEl = () => document.querySelector<HTMLElement>(sel);\n  }\n\n  // returnFocus: { selector } → finalFocusEl；'none' → restoreFocus=false\n  if (typeof props.returnFocus === \"object\") {\n    const sel = props.returnFocus.selector;\n    ctx.finalFocusEl = () => document.querySelector<HTMLElement>(sel);\n  } else if (props.returnFocus === \"none\") {\n    ctx.restoreFocus = false;\n  }\n\n  return ctx;\n}\n","import type { Props as ZagTabsProps, ValueChangeDetails } from \"@zag-js/tabs\";\n\n/**\n * QwTabsProps — Tabs 的用户输入。对 zag.js 输入做默认值收口 + 命名 rebrand：\n * - loop（默认 true）→ zag loopFocus；\n * - value / defaultValue / orientation / activationMode 透传；\n * - onValueChange 适配 zag details。\n * 业务方只 import 本类型，不直接 import `@zag-js/*`。\n */\nexport interface QwTabsProps {\n  /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控当前项。 */\n  value?: string | null;\n  /** 非受控初值。 */\n  defaultValue?: string | null;\n  /** 方向，默认 horizontal。 */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** 激活模式，默认 automatic（聚焦即激活）。 */\n  activationMode?: \"manual\" | \"automatic\";\n  /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */\n  loop?: boolean;\n  /** 选中项变化回调；zag 原生 onValueChange。 */\n  onValueChange?: (e: { value: string }) => void;\n}\n\n/**\n * 直接 re-export zag tabs 的 machine 与 connect —— 不包一层。\n * 用 re-export 保留原始可移植类型 (避免 TS2742)。\n */\nexport { machine as tabsMachine, connect } from \"@zag-js/tabs\";\n\n/** rebrand zag 的 TabsApi 类型对外。 */\nexport type { Api as QwTabsApi } from \"@zag-js/tabs\";\n\n/**\n * 把 QwTabsProps 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。\n * 用法：`useMachine(tabsMachine, createTabsProps(props))`。\n */\nexport function createTabsProps(props: QwTabsProps = {}): Partial<ZagTabsProps> {\n  const ctx: Partial<ZagTabsProps> = {\n    id: props.id,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    orientation: props.orientation,\n    activationMode: props.activationMode,\n    loopFocus: props.loop !== false,\n  };\n\n  if (props.onValueChange) {\n    const cb = props.onValueChange;\n    ctx.onValueChange = (d: ValueChangeDetails) => cb({ value: d.value });\n  }\n\n  return ctx;\n}\n"]}

package/dist/tabs/index.d.ts

@@ -0,0 +1,36 @@
+import { Props } from '@zag-js/tabs';
+export { Api as QwTabsApi, connect, machine as tabsMachine } from '@zag-js/tabs';
+
+/**
+ * QwTabsProps — Tabs 的用户输入。对 zag.js 输入做默认值收口 + 命名 rebrand：
+ * - loop（默认 true）→ zag loopFocus；
+ * - value / defaultValue / orientation / activationMode 透传；
+ * - onValueChange 适配 zag details。
+ * 业务方只 import 本类型，不直接 import `@zag-js/*`。
+ */
+interface QwTabsProps {
+    /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */
+    id?: string;
+    /** 受控当前项。 */
+    value?: string | null;
+    /** 非受控初值。 */
+    defaultValue?: string | null;
+    /** 方向，默认 horizontal。 */
+    orientation?: "horizontal" | "vertical";
+    /** 激活模式，默认 automatic（聚焦即激活）。 */
+    activationMode?: "manual" | "automatic";
+    /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */
+    loop?: boolean;
+    /** 选中项变化回调；zag 原生 onValueChange。 */
+    onValueChange?: (e: {
+        value: string;
+    }) => void;
+}
+
+/**
+ * 把 QwTabsProps 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。
+ * 用法：`useMachine(tabsMachine, createTabsProps(props))`。
+ */
+declare function createTabsProps(props?: QwTabsProps): Partial<Props>;
+
+export { type QwTabsProps, createTabsProps };

package/dist/tabs/index.js

@@ -0,0 +1,22 @@
+export { connect, machine as tabsMachine } from '@zag-js/tabs';
+
+// src/tabs/index.ts
+function createTabsProps(props = {}) {
+  const ctx = {
+    id: props.id,
+    value: props.value,
+    defaultValue: props.defaultValue,
+    orientation: props.orientation,
+    activationMode: props.activationMode,
+    loopFocus: props.loop !== false
+  };
+  if (props.onValueChange) {
+    const cb = props.onValueChange;
+    ctx.onValueChange = (d) => cb({ value: d.value });
+  }
+  return ctx;
+}
+
+export { createTabsProps };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tabs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tabs/index.ts"],"names":[],"mappings":";;;AAuCO,SAAS,eAAA,CAAgB,KAAA,GAAqB,EAAC,EAA0B;AAC9E,EAAA,MAAM,GAAA,GAA6B;AAAA,IACjC,IAAI,KAAA,CAAM,EAAA;AAAA,IACV,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,cAAc,KAAA,CAAM,YAAA;AAAA,IACpB,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,gBAAgB,KAAA,CAAM,cAAA;AAAA,IACtB,SAAA,EAAW,MAAM,IAAA,KAAS;AAAA,GAC5B;AAEA,EAAA,IAAI,MAAM,aAAA,EAAe;AACvB,IAAA,MAAM,KAAK,KAAA,CAAM,aAAA;AACjB,IAAA,GAAA,CAAI,aAAA,GAAgB,CAAC,CAAA,KAA0B,EAAA,CAAG,EAAE,KAAA,EAAO,CAAA,CAAE,OAAO,CAAA;AAAA,EACtE;AAEA,EAAA,OAAO,GAAA;AACT","file":"index.js","sourcesContent":["import type { Props as ZagTabsProps, ValueChangeDetails } from \"@zag-js/tabs\";\n\n/**\n * QwTabsProps — Tabs 的用户输入。对 zag.js 输入做默认值收口 + 命名 rebrand：\n * - loop（默认 true）→ zag loopFocus；\n * - value / defaultValue / orientation / activationMode 透传；\n * - onValueChange 适配 zag details。\n * 业务方只 import 本类型，不直接 import `@zag-js/*`。\n */\nexport interface QwTabsProps {\n  /** 唯一 id 前缀；不传由适配层生成 (SSR/CSR 一致)。 */\n  id?: string;\n  /** 受控当前项。 */\n  value?: string | null;\n  /** 非受控初值。 */\n  defaultValue?: string | null;\n  /** 方向，默认 horizontal。 */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** 激活模式，默认 automatic（聚焦即激活）。 */\n  activationMode?: \"manual\" | \"automatic\";\n  /** 方向键首尾循环，默认 true (zag 原名 loopFocus)。 */\n  loop?: boolean;\n  /** 选中项变化回调；zag 原生 onValueChange。 */\n  onValueChange?: (e: { value: string }) => void;\n}\n\n/**\n * 直接 re-export zag tabs 的 machine 与 connect —— 不包一层。\n * 用 re-export 保留原始可移植类型 (避免 TS2742)。\n */\nexport { machine as tabsMachine, connect } from \"@zag-js/tabs\";\n\n/** rebrand zag 的 TabsApi 类型对外。 */\nexport type { Api as QwTabsApi } from \"@zag-js/tabs\";\n\n/**\n * 把 QwTabsProps 转成 zag tabs machine 的 props (默认值收口 + 命名 rebrand)。\n * 用法：`useMachine(tabsMachine, createTabsProps(props))`。\n */\nexport function createTabsProps(props: QwTabsProps = {}): Partial<ZagTabsProps> {\n  const ctx: Partial<ZagTabsProps> = {\n    id: props.id,\n    value: props.value,\n    defaultValue: props.defaultValue,\n    orientation: props.orientation,\n    activationMode: props.activationMode,\n    loopFocus: props.loop !== false,\n  };\n\n  if (props.onValueChange) {\n    const cb = props.onValueChange;\n    ctx.onValueChange = (d: ValueChangeDetails) => cb({ value: d.value });\n  }\n\n  return ctx;\n}\n"]}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@qw-ui/core",
+  "version": "0.1.0",
+  "description": "L2 · Headless Core — zag.js machine 薄包装，纯 TS / SSR-safe，零样式。",
+  "license": "MIT",
+  "author": "qw-ui contributors",
+  "keywords": [
+    "headless",
+    "components",
+    "zag",
+    "state-machine",
+    "ssr",
+    "qw-ui"
+  ],
+  "homepage": "http://gitlab.alibaba-inc.com/qianwen/qw-ui",
+  "repository": {
+    "type": "git",
+    "url": "git+http://gitlab.alibaba-inc.com/qianwen/qw-ui.git",
+    "directory": "packages/core"
+  },
+  "bugs": "http://gitlab.alibaba-inc.com/qianwen/qw-ui/issues",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./dialog": {
+      "types": "./dist/dialog/index.d.ts",
+      "import": "./dist/dialog/index.js"
+    },
+    "./tabs": {
+      "types": "./dist/tabs/index.d.ts",
+      "import": "./dist/tabs/index.js"
+    }
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@zag-js/dialog": "^1.42.0",
+    "@zag-js/tabs": "^1.42.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.58.9",
+    "@size-limit/preset-small-lib": "^12.1.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "@zag-js/types": "1.42.0",
+    "@zag-js/vanilla": "^1.42.0",
+    "jsdom": "^29.1.1",
+    "size-limit": "^12.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9",
+    "@qw-ui/eslint-config": "0.0.0",
+    "@qw-ui/tsconfig": "0.0.0"
+  },
+  "size-limit": [
+    {
+      "path": "dist/dialog/index.js",
+      "limit": "6 kB",
+      "ignore": [
+        "@zag-js/dialog"
+      ]
+    },
+    {
+      "path": "dist/tabs/index.js",
+      "limit": "6 kB",
+      "ignore": [
+        "@zag-js/tabs"
+      ]
+    }
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "size": "size-limit",
+    "api": "api-extractor run --local",
+    "clean": "rm -rf dist .turbo etc/*.api.json temp"
+  }
+}