@qw-ui/core 0.3.0-next.40 → 0.3.0-next.43

package/dist/descriptions/descriptions.d.ts

@@ -0,0 +1,69 @@
+/** Semantic description list contract: dl/dt/dd grid, shared by every adapter. */
+export declare const DESCRIPTIONS_LAYOUTS: readonly ["horizontal", "vertical"];
+export declare const DESCRIPTIONS_PARTS: readonly ["root", "title", "list", "item", "label", "value"];
+export declare const DESCRIPTIONS_MAX_COLUMN = 4;
+export type DescriptionsLayout = (typeof DESCRIPTIONS_LAYOUTS)[number];
+export type DescriptionsPart = (typeof DESCRIPTIONS_PARTS)[number];
+/** One label/value pair. `T` lets framework adapters pass rich nodes without changing Core decisions. */
+export interface DescriptionsItem<T = string> {
+    /** Stable key; also exposed as data-value. */
+    id: string;
+    label: T;
+    /** undefined/null/"" renders `emptyText`. */
+    value?: T | null;
+    /** Columns occupied; integer clamped to 1..column. */
+    span?: number;
+}
+export interface QwDescriptionsProps<T = string> {
+    /** Optional caption above the list (plain region text, not a heading). */
+    title?: string;
+    items: readonly DescriptionsItem<T>[];
+    /** Integer 1–4; invalid values use 1. */
+    column?: number;
+    /** horizontal: label beside value (default); vertical: label above value. */
+    layout?: DescriptionsLayout;
+    bordered?: boolean;
+    /** Placeholder for empty values; default "-". */
+    emptyText?: string;
+}
+export interface ResolvedDescriptionsItem<T = string> extends DescriptionsItem<T> {
+    index: number;
+    span: number;
+    empty: boolean;
+}
+export interface ResolvedDescriptionsState<T = string> {
+    title?: string;
+    column: number;
+    layout: DescriptionsLayout;
+    bordered: boolean;
+    emptyText: string;
+    items: ResolvedDescriptionsItem<T>[];
+}
+export declare function normalizeDescriptionsColumn(column: unknown): number;
+export declare function resolveDescriptionsState<T = string>(props: QwDescriptionsProps<T>): ResolvedDescriptionsState<T>;
+type Part<P extends DescriptionsPart> = {
+    "data-scope": "descriptions";
+    "data-part": P;
+};
+export declare function getDescriptionsRootProps(state: ResolvedDescriptionsState<unknown>): Part<"root"> & {
+    "data-layout": DescriptionsLayout;
+    "data-bordered"?: "true";
+    style: Record<string, string>;
+};
+export declare function getDescriptionsTitleProps(present: boolean): Part<"title"> & {
+    hidden?: true;
+};
+export declare function getDescriptionsListProps(state: ResolvedDescriptionsState<unknown>): Part<"list"> & {
+    "data-column": number;
+};
+export declare function getDescriptionsItemProps(item: ResolvedDescriptionsItem<unknown>): Part<"item"> & {
+    "data-value": string;
+    "data-span": number;
+    "data-empty"?: "true";
+    style: Record<string, string>;
+};
+export declare function getDescriptionsLabelProps(): Part<"label">;
+export declare function getDescriptionsValueProps(item: ResolvedDescriptionsItem<unknown>): Part<"value"> & {
+    "data-empty"?: "true";
+};
+export {};

package/dist/descriptions/index.d.ts

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

package/dist/descriptions/index.js

@@ -0,0 +1,86 @@
+//#region src/descriptions/descriptions.ts
+/** Semantic description list contract: dl/dt/dd grid, shared by every adapter. */
+const DESCRIPTIONS_LAYOUTS = ["horizontal", "vertical"];
+const DESCRIPTIONS_PARTS = [
+	"root",
+	"title",
+	"list",
+	"item",
+	"label",
+	"value"
+];
+const DESCRIPTIONS_MAX_COLUMN = 4;
+function normalizeDescriptionsColumn(column) {
+	if (typeof column !== "number" || !Number.isFinite(column)) return 1;
+	const value = Math.floor(column);
+	return value < 1 ? 1 : Math.min(4, value);
+}
+function normalizeSpan(span, column) {
+	if (typeof span !== "number" || !Number.isFinite(span)) return 1;
+	return Math.max(1, Math.min(column, Math.floor(span)));
+}
+function isEmptyValue(value) {
+	return value === void 0 || value === null || value === "";
+}
+function resolveDescriptionsState(props) {
+	const column = normalizeDescriptionsColumn(props.column);
+	return {
+		title: typeof props.title === "string" && props.title !== "" ? props.title : void 0,
+		column,
+		layout: DESCRIPTIONS_LAYOUTS.includes(props.layout) ? props.layout : "horizontal",
+		bordered: props.bordered === true,
+		emptyText: typeof props.emptyText === "string" ? props.emptyText : "-",
+		items: (props.items ?? []).map((item, index) => ({
+			...item,
+			index,
+			span: normalizeSpan(item.span, column),
+			empty: isEmptyValue(item.value)
+		}))
+	};
+}
+const part = (name) => ({
+	"data-scope": "descriptions",
+	"data-part": name
+});
+function getDescriptionsRootProps(state) {
+	return {
+		...part("root"),
+		"data-layout": state.layout,
+		...state.bordered ? { "data-bordered": "true" } : {},
+		style: { "--qw-descriptions-column": String(state.column) }
+	};
+}
+function getDescriptionsTitleProps(present) {
+	return {
+		...part("title"),
+		...present ? {} : { hidden: true }
+	};
+}
+function getDescriptionsListProps(state) {
+	return {
+		...part("list"),
+		"data-column": state.column
+	};
+}
+function getDescriptionsItemProps(item) {
+	return {
+		...part("item"),
+		"data-value": item.id,
+		"data-span": item.span,
+		...item.empty ? { "data-empty": "true" } : {},
+		style: { gridColumnEnd: `span ${item.span}` }
+	};
+}
+function getDescriptionsLabelProps() {
+	return part("label");
+}
+function getDescriptionsValueProps(item) {
+	return {
+		...part("value"),
+		...item.empty ? { "data-empty": "true" } : {}
+	};
+}
+//#endregion
+export { DESCRIPTIONS_LAYOUTS, DESCRIPTIONS_MAX_COLUMN, DESCRIPTIONS_PARTS, getDescriptionsItemProps, getDescriptionsLabelProps, getDescriptionsListProps, getDescriptionsRootProps, getDescriptionsTitleProps, getDescriptionsValueProps, normalizeDescriptionsColumn, resolveDescriptionsState };
+
+//# sourceMappingURL=index.js.map

package/dist/descriptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/descriptions/descriptions.ts"],"sourcesContent":["/** Semantic description list contract: dl/dt/dd grid, shared by every adapter. */\nexport const DESCRIPTIONS_LAYOUTS = [\"horizontal\", \"vertical\"] as const;\nexport const DESCRIPTIONS_PARTS = [\"root\", \"title\", \"list\", \"item\", \"label\", \"value\"] as const;\nexport const DESCRIPTIONS_MAX_COLUMN = 4;\nexport type DescriptionsLayout = (typeof DESCRIPTIONS_LAYOUTS)[number];\nexport type DescriptionsPart = (typeof DESCRIPTIONS_PARTS)[number];\n\n/** One label/value pair. `T` lets framework adapters pass rich nodes without changing Core decisions. */\nexport interface DescriptionsItem<T = string> {\n  /** Stable key; also exposed as data-value. */\n  id: string;\n  label: T;\n  /** undefined/null/\"\" renders `emptyText`. */\n  value?: T | null;\n  /** Columns occupied; integer clamped to 1..column. */\n  span?: number;\n}\nexport interface QwDescriptionsProps<T = string> {\n  /** Optional caption above the list (plain region text, not a heading). */\n  title?: string;\n  items: readonly DescriptionsItem<T>[];\n  /** Integer 1–4; invalid values use 1. */\n  column?: number;\n  /** horizontal: label beside value (default); vertical: label above value. */\n  layout?: DescriptionsLayout;\n  bordered?: boolean;\n  /** Placeholder for empty values; default \"-\". */\n  emptyText?: string;\n}\nexport interface ResolvedDescriptionsItem<T = string> extends DescriptionsItem<T> {\n  index: number;\n  span: number;\n  empty: boolean;\n}\nexport interface ResolvedDescriptionsState<T = string> {\n  title?: string;\n  column: number;\n  layout: DescriptionsLayout;\n  bordered: boolean;\n  emptyText: string;\n  items: ResolvedDescriptionsItem<T>[];\n}\n\nexport function normalizeDescriptionsColumn(column: unknown): number {\n  if (typeof column !== \"number\" || !Number.isFinite(column)) return 1;\n  const value = Math.floor(column);\n  return value < 1 ? 1 : Math.min(DESCRIPTIONS_MAX_COLUMN, value);\n}\nfunction normalizeSpan(span: unknown, column: number): number {\n  if (typeof span !== \"number\" || !Number.isFinite(span)) return 1;\n  return Math.max(1, Math.min(column, Math.floor(span)));\n}\nfunction isEmptyValue(value: unknown): boolean {\n  return value === undefined || value === null || value === \"\";\n}\n\nexport function resolveDescriptionsState<T = string>(props: QwDescriptionsProps<T>): ResolvedDescriptionsState<T> {\n  const column = normalizeDescriptionsColumn(props.column);\n  return {\n    title: typeof props.title === \"string\" && props.title !== \"\" ? props.title : undefined,\n    column,\n    layout: DESCRIPTIONS_LAYOUTS.includes(props.layout!) ? props.layout! : \"horizontal\",\n    bordered: props.bordered === true,\n    emptyText: typeof props.emptyText === \"string\" ? props.emptyText : \"-\",\n    items: (props.items ?? []).map((item, index) => ({ ...item, index, span: normalizeSpan(item.span, column), empty: isEmptyValue(item.value) })),\n  };\n}\n\ntype Part<P extends DescriptionsPart> = { \"data-scope\": \"descriptions\"; \"data-part\": P };\nconst part = <P extends DescriptionsPart>(name: P): Part<P> => ({ \"data-scope\": \"descriptions\", \"data-part\": name });\n\nexport function getDescriptionsRootProps(state: ResolvedDescriptionsState<unknown>): Part<\"root\"> & { \"data-layout\": DescriptionsLayout; \"data-bordered\"?: \"true\"; style: Record<string, string> } {\n  return { ...part(\"root\"), \"data-layout\": state.layout, ...(state.bordered ? { \"data-bordered\": \"true\" as const } : {}), style: { \"--qw-descriptions-column\": String(state.column) } };\n}\nexport function getDescriptionsTitleProps(present: boolean): Part<\"title\"> & { hidden?: true } {\n  return { ...part(\"title\"), ...(present ? {} : { hidden: true as const }) };\n}\nexport function getDescriptionsListProps(state: ResolvedDescriptionsState<unknown>): Part<\"list\"> & { \"data-column\": number } {\n  return { ...part(\"list\"), \"data-column\": state.column };\n}\nexport function getDescriptionsItemProps(item: ResolvedDescriptionsItem<unknown>): Part<\"item\"> & { \"data-value\": string; \"data-span\": number; \"data-empty\"?: \"true\"; style: Record<string, string> } {\n  return { ...part(\"item\"), \"data-value\": item.id, \"data-span\": item.span, ...(item.empty ? { \"data-empty\": \"true\" as const } : {}), style: { gridColumnEnd: `span ${item.span}` } };\n}\nexport function getDescriptionsLabelProps(): Part<\"label\"> { return part(\"label\"); }\nexport function getDescriptionsValueProps(item: ResolvedDescriptionsItem<unknown>): Part<\"value\"> & { \"data-empty\"?: \"true\" } {\n  return { ...part(\"value\"), ...(item.empty ? { \"data-empty\": \"true\" as const } : {}) };\n}\n"],"mappings":";;AACA,MAAa,uBAAuB,CAAC,cAAc,UAAU;AAC7D,MAAa,qBAAqB;CAAC;CAAQ;CAAS;CAAQ;CAAQ;CAAS;AAAO;AACpF,MAAa,0BAA0B;AAwCvC,SAAgB,4BAA4B,QAAyB;CACnE,IAAI,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,GAAG,OAAO;CACnE,MAAM,QAAQ,KAAK,MAAM,MAAM;CAC/B,OAAO,QAAQ,IAAI,IAAI,KAAK,IAAA,GAA6B,KAAK;AAChE;AACA,SAAS,cAAc,MAAe,QAAwB;CAC5D,IAAI,OAAO,SAAS,YAAY,CAAC,OAAO,SAAS,IAAI,GAAG,OAAO;CAC/D,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC;AACvD;AACA,SAAS,aAAa,OAAyB;CAC7C,OAAO,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU;AAC5D;AAEA,SAAgB,yBAAqC,OAA6D;CAChH,MAAM,SAAS,4BAA4B,MAAM,MAAM;CACvD,OAAO;EACL,OAAO,OAAO,MAAM,UAAU,YAAY,MAAM,UAAU,KAAK,MAAM,QAAQ,KAAA;EAC7E;EACA,QAAQ,qBAAqB,SAAS,MAAM,MAAO,IAAI,MAAM,SAAU;EACvE,UAAU,MAAM,aAAa;EAC7B,WAAW,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;EACnE,QAAQ,MAAM,SAAS,CAAC,EAAA,CAAG,KAAK,MAAM,WAAW;GAAE,GAAG;GAAM;GAAO,MAAM,cAAc,KAAK,MAAM,MAAM;GAAG,OAAO,aAAa,KAAK,KAAK;EAAE,EAAE;CAC/I;AACF;AAGA,MAAM,QAAoC,UAAsB;CAAE,cAAc;CAAgB,aAAa;AAAK;AAElH,SAAgB,yBAAyB,OAA0J;CACjM,OAAO;EAAE,GAAG,KAAK,MAAM;EAAG,eAAe,MAAM;EAAQ,GAAI,MAAM,WAAW,EAAE,iBAAiB,OAAgB,IAAI,CAAC;EAAI,OAAO,EAAE,4BAA4B,OAAO,MAAM,MAAM,EAAE;CAAE;AACtL;AACA,SAAgB,0BAA0B,SAAqD;CAC7F,OAAO;EAAE,GAAG,KAAK,OAAO;EAAG,GAAI,UAAU,CAAC,IAAI,EAAE,QAAQ,KAAc;CAAG;AAC3E;AACA,SAAgB,yBAAyB,OAAqF;CAC5H,OAAO;EAAE,GAAG,KAAK,MAAM;EAAG,eAAe,MAAM;CAAO;AACxD;AACA,SAAgB,yBAAyB,MAA6J;CACpM,OAAO;EAAE,GAAG,KAAK,MAAM;EAAG,cAAc,KAAK;EAAI,aAAa,KAAK;EAAM,GAAI,KAAK,QAAQ,EAAE,cAAc,OAAgB,IAAI,CAAC;EAAI,OAAO,EAAE,eAAe,QAAQ,KAAK,OAAO;CAAE;AACnL;AACA,SAAgB,4BAA2C;CAAE,OAAO,KAAK,OAAO;AAAG;AACnF,SAAgB,0BAA0B,MAAoF;CAC5H,OAAO;EAAE,GAAG,KAAK,OAAO;EAAG,GAAI,KAAK,QAAQ,EAAE,cAAc,OAAgB,IAAI,CAAC;CAAG;AACtF"}

package/dist/dialog/dialog.d.ts

@@ -1,4 +1,5 @@
-import type { Props as ZagDialogProps } from "@zag-js/dialog";
+import { type Api, type Props as ZagDialogProps, type Service } from "@zag-js/dialog";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
 /**
  * QwDialogProps — H5 系统 Dialog 的跨框架行为输入。
  *
@@ -36,13 +37,41 @@ export interface QwDialogActionState {
     confirmLoading: boolean;
 }
 /**
- * 直接 re-export zag 的 dialog machine 与 connect。
+ * 共用 Core 的 Zag dialog 薄包装；connect 只追加纯声明属性 getter。
  * 各框架适配层只实例化 service 并摊 prop-getter。
  */
-export { machine as dialogMachine, connect } from "@zag-js/dialog";
+export declare function connect<T extends PropTypes>(service: Service, normalize: NormalizeProps<T>): Api<T> & {
+    getOriginProps(): T["element"];
+};
+export { modalDialogMachine as dialogMachine } from "../modal-dialog-machine.js";
 /** rebrand zag 的 DialogApi 类型对外。 */
 export type { Api as QwDialogApi } from "@zag-js/dialog";
 /** 把 H5 Dialog 公开 props 转成 zag dialog machine context。 */
 export declare function createDialogProps(props?: QwDialogProps): Partial<ZagDialogProps>;
+/** 键盘激活时适配层传入的最小事件。Core 不查询 document。 */
+export interface DialogTriggerKeyEvent {
+    readonly key: string;
+    readonly defaultPrevented: boolean;
+    preventDefault(): void;
+    readonly currentTarget: object | null;
+}
+/**
+ * 非按钮触发器的 Enter / Space。先交给已有 keydown（例如 zag），
+ * 未被取消时 preventDefault，并点击 currentTarget，让点击路径统一打开。
+ */
+export declare function handleDialogTriggerKey<E extends DialogTriggerKeyEvent>(event: E, previous?: (event: E) => void): void;
+export interface DialogActionTask {
+    /** 动作当前不可用（含确认中的忙碌）。 */
+    disabled: boolean;
+    /** 先通知调用方。返回 Promise 时，关闭推迟到它完成。 */
+    invoke?: () => unknown;
+    close: () => void;
+}
+/** 禁用的动作不通知、不关闭。启用的动作先通知，再关闭；Promise 要等它完成。 */
+export declare function runDialogAction(task: DialogActionTask): void;
+/** 把触发器上的可序列化属性交给真实 button。函数和 type 留在适配层。 */
+export declare function dialogSlottedTriggerAttrs(source: object): Array<[string, string]>;
 /** 双栈共享的 Dialog 操作区状态归一化。 */
 export declare function resolveDialogActionState(props?: QwDialogActionProps): QwDialogActionState;
+export { createPortalPlan, readPortalHostLocale, resolvePortalCopy } from "../portal.js";
+export type { PortalCopy, PortalCopyAttribute, PortalKind, PortalPart, PortalPlan, PortalResolvedCopy, PortalSnapshot, PortalTarget, PortalVariableMode, } from "../portal.js";

package/dist/dialog/index.js

@@ -1,11 +1,28 @@
-import { connect, machine as dialogMachine } from "@zag-js/dialog";
+import { i as modalOriginAttrs, o as modalRequestService, r as modalDialogMachine, t as cancelModalClose } from "../modal-dialog-machine-CF9_z3Dm.js";
+import { n as readPortalHostLocale, r as resolvePortalCopy, t as createPortalPlan } from "../portal-BHCNTWhg.js";
+import { connect as connect$1 } from "@zag-js/dialog";
 //#region src/dialog/dialog.ts
+/**
+* 共用 Core 的 Zag dialog 薄包装；connect 只追加纯声明属性 getter。
+* 各框架适配层只实例化 service 并摊 prop-getter。
+*/
+function connect(service, normalize) {
+	const api = connect$1(modalRequestService(service), normalize);
+	return {
+		...api,
+		setOpen(open) {
+			if (open) cancelModalClose(service);
+			api.setOpen(open);
+		},
+		getOriginProps: () => normalize.element(modalOriginAttrs(service.scope.id, "dialog"))
+	};
+}
 /** 把 H5 Dialog 公开 props 转成 zag dialog machine context。 */
 function createDialogProps(props = {}) {
 	const ctx = {
 		id: props.id,
 		open: props.open,
-		defaultOpen: props.defaultOpen,
+		defaultOpen: typeof props.open === "boolean" ? false : props.defaultOpen,
 		role: "dialog",
 		modal: true,
 		closeOnEscape: true,
@@ -18,6 +35,44 @@ function createDialogProps(props = {}) {
 	}
 	return ctx;
 }
+function clickTarget(target) {
+	if (target && "click" in target && typeof target.click === "function") target.click();
+}
+/**
+* 非按钮触发器的 Enter / Space。先交给已有 keydown（例如 zag），
+* 未被取消时 preventDefault，并点击 currentTarget，让点击路径统一打开。
+*/
+function handleDialogTriggerKey(event, previous) {
+	previous?.(event);
+	if (event.defaultPrevented) return;
+	if (event.key !== "Enter" && event.key !== " ") return;
+	event.preventDefault();
+	clickTarget(event.currentTarget);
+}
+function isThenable(value) {
+	return !!value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+}
+/** 禁用的动作不通知、不关闭。启用的动作先通知，再关闭；Promise 要等它完成。 */
+function runDialogAction(task) {
+	if (task.disabled) return;
+	const result = task.invoke?.();
+	if (isThenable(result)) {
+		result.then(() => task.close());
+		return;
+	}
+	task.close();
+}
+/** 把触发器上的可序列化属性交给真实 button。函数和 type 留在适配层。 */
+function dialogSlottedTriggerAttrs(source) {
+	const assigned = [];
+	for (const [key, value] of Object.entries(source)) {
+		if (value == null || typeof value === "function") continue;
+		if (key === "type" || key === "style" || key === "tabIndex" || key === "tabindex") continue;
+		if (typeof value === "boolean") assigned.push([key, value ? "true" : "false"]);
+		else if (typeof value === "string" || typeof value === "number") assigned.push([key, String(value)]);
+	}
+	return assigned;
+}
 /** 双栈共享的 Dialog 操作区状态归一化。 */
 function resolveDialogActionState(props = {}) {
 	const confirmLoading = props.confirmLoading ?? false;
@@ -29,6 +84,6 @@ function resolveDialogActionState(props = {}) {
 	};
 }
 //#endregion
-export { connect, createDialogProps, dialogMachine, resolveDialogActionState };
+export { connect, createDialogProps, createPortalPlan, modalDialogMachine as dialogMachine, dialogSlottedTriggerAttrs, handleDialogTriggerKey, readPortalHostLocale, resolveDialogActionState, resolvePortalCopy, runDialogAction };
 
 //# sourceMappingURL=index.js.map

package/dist/dialog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/dialog/dialog.ts"],"sourcesContent":["import type { OpenChangeDetails, Props as ZagDialogProps } from \"@zag-js/dialog\";\n\n/**\n * QwDialogProps — H5 系统 Dialog 的跨框架行为输入。\n *\n * 只暴露业务能理解的开合、遮罩点击、body 滚动控制；modal / role / focus\n * 策略是组件内部无障碍政策，不作为业务 API。\n */\nexport interface QwDialogProps {\n  /** 唯一 id 前缀；不传时由适配层提供 SSR/CSR 稳定 id。 */\n  id?: string;\n  /** 受控开关。 */\n  open?: boolean;\n  /** 非受控初值。 */\n  defaultOpen?: boolean;\n  /** 点击遮罩关闭，默认 true。 */\n  closeOnMaskClick?: boolean;\n  /** Dialog 打开时禁止 body 滚动，默认 true。 */\n  disableBodyScroll?: boolean;\n  /** 状态变化回调。 */\n  onOpenChange?: (open: boolean) => void;\n}\n\nexport interface QwDialogActionProps {\n  /** 是否展示取消按钮，默认 true。 */\n  showCancel?: boolean;\n  /** 取消按钮禁用。 */\n  cancelDisabled?: boolean;\n  /** 确认按钮禁用。 */\n  confirmDisabled?: boolean;\n  /** 确认按钮忙碌；忙碌时视为禁用。 */\n  confirmLoading?: boolean;\n}\n\nexport interface QwDialogActionState {\n  showCancel: boolean;\n  cancelDisabled: boolean;\n  confirmDisabled: boolean;\n  confirmLoading: boolean;\n}\n\n/**\n * 直接 re-export zag 的 dialog machine 与 connect。\n * 各框架适配层只实例化 service 并摊 prop-getter。\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/** 把 H5 Dialog 公开 props 转成 zag dialog machine context。 */\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: \"dialog\",\n    modal: true,\n    closeOnEscape: true,\n    closeOnInteractOutside: props.closeOnMaskClick !== false,\n    preventScroll: props.disableBodyScroll !== false,\n  };\n\n  if (props.onOpenChange) {\n    const cb = props.onOpenChange;\n    ctx.onOpenChange = (d: OpenChangeDetails) => cb(d.open);\n  }\n\n  return ctx;\n}\n\n/** 双栈共享的 Dialog 操作区状态归一化。 */\nexport function resolveDialogActionState(\n  props: QwDialogActionProps = {},\n): QwDialogActionState {\n  const confirmLoading = props.confirmLoading ?? false;\n  return {\n    showCancel: props.showCancel !== false,\n    cancelDisabled: props.cancelDisabled ?? false,\n    confirmDisabled: (props.confirmDisabled ?? false) || confirmLoading,\n    confirmLoading,\n  };\n}\n"],"mappings":";;;AAmDA,SAAgB,kBAAkB,QAAuB,CAAC,GAA4B;CACpF,MAAM,MAA+B;EACnC,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,MAAM;EACN,OAAO;EACP,eAAe;EACf,wBAAwB,MAAM,qBAAqB;EACnD,eAAe,MAAM,sBAAsB;CAC7C;CAEA,IAAI,MAAM,cAAc;EACtB,MAAM,KAAK,MAAM;EACjB,IAAI,gBAAgB,MAAyB,GAAG,EAAE,IAAI;CACxD;CAEA,OAAO;AACT;;AAGA,SAAgB,yBACd,QAA6B,CAAC,GACT;CACrB,MAAM,iBAAiB,MAAM,kBAAkB;CAC/C,OAAO;EACL,YAAY,MAAM,eAAe;EACjC,gBAAgB,MAAM,kBAAkB;EACxC,kBAAkB,MAAM,mBAAmB,UAAU;EACrD;CACF;AACF"}
+{"version":3,"file":"index.js","names":["zagConnect"],"sources":["../../src/dialog/dialog.ts"],"sourcesContent":["import { connect as zagConnect, type Api, type OpenChangeDetails, type Props as ZagDialogProps, type Service } from \"@zag-js/dialog\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\nimport { modalOriginAttrs, modalRequestService, cancelModalClose } from \"../modal-dialog-machine.js\";\n\n/**\n * QwDialogProps — H5 系统 Dialog 的跨框架行为输入。\n *\n * 只暴露业务能理解的开合、遮罩点击、body 滚动控制；modal / role / focus\n * 策略是组件内部无障碍政策，不作为业务 API。\n */\nexport interface QwDialogProps {\n  /** 唯一 id 前缀；不传时由适配层提供 SSR/CSR 稳定 id。 */\n  id?: string;\n  /** 受控开关。 */\n  open?: boolean;\n  /** 非受控初值。 */\n  defaultOpen?: boolean;\n  /** 点击遮罩关闭，默认 true。 */\n  closeOnMaskClick?: boolean;\n  /** Dialog 打开时禁止 body 滚动，默认 true。 */\n  disableBodyScroll?: boolean;\n  /** 状态变化回调。 */\n  onOpenChange?: (open: boolean) => void;\n}\n\nexport interface QwDialogActionProps {\n  /** 是否展示取消按钮，默认 true。 */\n  showCancel?: boolean;\n  /** 取消按钮禁用。 */\n  cancelDisabled?: boolean;\n  /** 确认按钮禁用。 */\n  confirmDisabled?: boolean;\n  /** 确认按钮忙碌；忙碌时视为禁用。 */\n  confirmLoading?: boolean;\n}\n\nexport interface QwDialogActionState {\n  showCancel: boolean;\n  cancelDisabled: boolean;\n  confirmDisabled: boolean;\n  confirmLoading: boolean;\n}\n\n/**\n * 共用 Core 的 Zag dialog 薄包装；connect 只追加纯声明属性 getter。\n * 各框架适配层只实例化 service 并摊 prop-getter。\n */\nexport function connect<T extends PropTypes>(service: Service, normalize: NormalizeProps<T>): Api<T> & { getOriginProps(): T[\"element\"] } {\n  const api = zagConnect(modalRequestService(service), normalize);\n  return { ...api, setOpen(open) { if (open) cancelModalClose(service); api.setOpen(open); }, getOriginProps: () => normalize.element(modalOriginAttrs(service.scope.id, \"dialog\")) };\n}\nexport { modalDialogMachine as dialogMachine } from \"../modal-dialog-machine.js\";\n\n/** rebrand zag 的 DialogApi 类型对外。 */\nexport type { Api as QwDialogApi } from \"@zag-js/dialog\";\n\n/** 把 H5 Dialog 公开 props 转成 zag dialog machine context。 */\nexport function createDialogProps(props: QwDialogProps = {}): Partial<ZagDialogProps> {\n  const ctx: Partial<ZagDialogProps> = {\n    id: props.id,\n    open: props.open,\n    // Zag seeds initialState with open || defaultOpen; a controlled boolean owns the initial state.\n    defaultOpen: typeof props.open === \"boolean\" ? false : props.defaultOpen,\n    role: \"dialog\",\n    modal: true,\n    closeOnEscape: true,\n    closeOnInteractOutside: props.closeOnMaskClick !== false,\n    preventScroll: props.disableBodyScroll !== false,\n  };\n\n  if (props.onOpenChange) {\n    const cb = props.onOpenChange;\n    ctx.onOpenChange = (d: OpenChangeDetails) => cb(d.open);\n  }\n\n  return ctx;\n}\n\n/** 键盘激活时适配层传入的最小事件。Core 不查询 document。 */\nexport interface DialogTriggerKeyEvent {\n  readonly key: string;\n  readonly defaultPrevented: boolean;\n  preventDefault(): void;\n  readonly currentTarget: object | null;\n}\n\nfunction clickTarget(target: object | null): void {\n  if (target && \"click\" in target && typeof target.click === \"function\") target.click();\n}\n\n/**\n * 非按钮触发器的 Enter / Space。先交给已有 keydown（例如 zag），\n * 未被取消时 preventDefault，并点击 currentTarget，让点击路径统一打开。\n */\nexport function handleDialogTriggerKey<E extends DialogTriggerKeyEvent>(\n  event: E,\n  previous?: (event: E) => void,\n): void {\n  previous?.(event);\n  if (event.defaultPrevented) return;\n  if (event.key !== \"Enter\" && event.key !== \" \") return;\n  event.preventDefault();\n  clickTarget(event.currentTarget);\n}\n\nexport interface DialogActionTask {\n  /** 动作当前不可用（含确认中的忙碌）。 */\n  disabled: boolean;\n  /** 先通知调用方。返回 Promise 时，关闭推迟到它完成。 */\n  invoke?: () => unknown;\n  close: () => void;\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return !!value && (typeof value === \"object\" || typeof value === \"function\") && typeof (value as PromiseLike<unknown>).then === \"function\";\n}\n\n/** 禁用的动作不通知、不关闭。启用的动作先通知，再关闭；Promise 要等它完成。 */\nexport function runDialogAction(task: DialogActionTask): void {\n  if (task.disabled) return;\n  const result = task.invoke?.();\n  if (isThenable(result)) {\n    void result.then(() => task.close());\n    return;\n  }\n  task.close();\n}\n\n/** 把触发器上的可序列化属性交给真实 button。函数和 type 留在适配层。 */\nexport function dialogSlottedTriggerAttrs(source: object): Array<[string, string]> {\n  const assigned: Array<[string, string]> = [];\n  for (const [key, value] of Object.entries(source)) {\n    if (value == null || typeof value === \"function\") continue;\n    if (key === \"type\" || key === \"style\" || key === \"tabIndex\" || key === \"tabindex\") continue;\n    if (typeof value === \"boolean\") assigned.push([key, value ? \"true\" : \"false\"]);\n    else if (typeof value === \"string\" || typeof value === \"number\") assigned.push([key, String(value)]);\n  }\n  return assigned;\n}\n\n/** 双栈共享的 Dialog 操作区状态归一化。 */\nexport function resolveDialogActionState(\n  props: QwDialogActionProps = {},\n): QwDialogActionState {\n  const confirmLoading = props.confirmLoading ?? false;\n  return {\n    showCancel: props.showCancel !== false,\n    cancelDisabled: props.cancelDisabled ?? false,\n    confirmDisabled: (props.confirmDisabled ?? false) || confirmLoading,\n    confirmLoading,\n  };\n}\n\nexport { createPortalPlan, readPortalHostLocale, resolvePortalCopy } from \"../portal.js\";\nexport type {\n  PortalCopy,\n  PortalCopyAttribute,\n  PortalKind,\n  PortalPart,\n  PortalPlan,\n  PortalResolvedCopy,\n  PortalSnapshot,\n  PortalTarget,\n  PortalVariableMode,\n} from \"../portal.js\";\n"],"mappings":";;;;;;;;AA+CA,SAAgB,QAA6B,SAAkB,WAA2E;CACxI,MAAM,MAAMA,UAAW,oBAAoB,OAAO,GAAG,SAAS;CAC9D,OAAO;EAAE,GAAG;EAAK,QAAQ,MAAM;GAAE,IAAI,MAAM,iBAAiB,OAAO;GAAG,IAAI,QAAQ,IAAI;EAAG;EAAG,sBAAsB,UAAU,QAAQ,iBAAiB,QAAQ,MAAM,IAAI,QAAQ,CAAC;CAAE;AACpL;;AAOA,SAAgB,kBAAkB,QAAuB,CAAC,GAA4B;CACpF,MAAM,MAA+B;EACnC,IAAI,MAAM;EACV,MAAM,MAAM;EAEZ,aAAa,OAAO,MAAM,SAAS,YAAY,QAAQ,MAAM;EAC7D,MAAM;EACN,OAAO;EACP,eAAe;EACf,wBAAwB,MAAM,qBAAqB;EACnD,eAAe,MAAM,sBAAsB;CAC7C;CAEA,IAAI,MAAM,cAAc;EACtB,MAAM,KAAK,MAAM;EACjB,IAAI,gBAAgB,MAAyB,GAAG,EAAE,IAAI;CACxD;CAEA,OAAO;AACT;AAUA,SAAS,YAAY,QAA6B;CAChD,IAAI,UAAU,WAAW,UAAU,OAAO,OAAO,UAAU,YAAY,OAAO,MAAM;AACtF;;;;;AAMA,SAAgB,uBACd,OACA,UACM;CACN,WAAW,KAAK;CAChB,IAAI,MAAM,kBAAkB;CAC5B,IAAI,MAAM,QAAQ,WAAW,MAAM,QAAQ,KAAK;CAChD,MAAM,eAAe;CACrB,YAAY,MAAM,aAAa;AACjC;AAUA,SAAS,WAAW,OAA+C;CACjE,OAAO,CAAC,CAAC,UAAU,OAAO,UAAU,YAAY,OAAO,UAAU,eAAe,OAAQ,MAA+B,SAAS;AAClI;;AAGA,SAAgB,gBAAgB,MAA8B;CAC5D,IAAI,KAAK,UAAU;CACnB,MAAM,SAAS,KAAK,SAAS;CAC7B,IAAI,WAAW,MAAM,GAAG;EACtB,OAAY,WAAW,KAAK,MAAM,CAAC;EACnC;CACF;CACA,KAAK,MAAM;AACb;;AAGA,SAAgB,0BAA0B,QAAyC;CACjF,MAAM,WAAoC,CAAC;CAC3C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;EACjD,IAAI,SAAS,QAAQ,OAAO,UAAU,YAAY;EAClD,IAAI,QAAQ,UAAU,QAAQ,WAAW,QAAQ,cAAc,QAAQ,YAAY;EACnF,IAAI,OAAO,UAAU,WAAW,SAAS,KAAK,CAAC,KAAK,QAAQ,SAAS,OAAO,CAAC;OACxE,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,SAAS,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,CAAC;CACrG;CACA,OAAO;AACT;;AAGA,SAAgB,yBACd,QAA6B,CAAC,GACT;CACrB,MAAM,iBAAiB,MAAM,kBAAkB;CAC/C,OAAO;EACL,YAAY,MAAM,eAAe;EACjC,gBAAgB,MAAM,kBAAkB;EACxC,kBAAkB,MAAM,mBAAmB,UAAU;EACrD;CACF;AACF"}

package/dist/divider/divider.d.ts

@@ -1,5 +1,5 @@
 /**
- * Divider 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
+ * Divider 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。
  * 渲染契约：`role="separator"`，`data-scope="divider"`，`data-part="root"`；
  * `data-orientation` / `data-weight` 摊平枚举，`vertical` 额外输出 `aria-orientation`。
  *
@@ -14,10 +14,26 @@ export declare const DIVIDER_PARTS: readonly ["root"];
 export type DividerOrientation = (typeof DIVIDER_ORIENTATIONS)[number];
 export type DividerWeight = (typeof DIVIDER_WEIGHTS)[number];
 export type DividerPart = (typeof DIVIDER_PARTS)[number];
-/** QwDividerProps — 双栈共享的行为契约（全字段可选）。 */
+/** QwDividerProps — 三栈共享的行为与渲染契约（全字段可选）。 */
 export interface QwDividerProps {
     /** 方向，默认 horizontal。 */
     orientation?: DividerOrientation;
     /** 粗细，默认 thin（细，0.5px）。 */
     weight?: DividerWeight;
 }
+export interface ResolvedDividerState {
+    orientation: DividerOrientation;
+    weight: DividerWeight;
+}
+/** Resolve the passive display contract once for every adapter. */
+export declare function resolveDividerState(props?: QwDividerProps): ResolvedDividerState;
+export interface DividerRootProps {
+    role: "separator";
+    "data-scope": "divider";
+    "data-part": "root";
+    "data-orientation": DividerOrientation;
+    "data-weight": DividerWeight;
+    "aria-orientation"?: "vertical";
+}
+/** Spread after caller attributes: Core owns these semantics. */
+export declare function getDividerRootProps(state: ResolvedDividerState): DividerRootProps;

package/dist/divider/index.js

@@ -1,6 +1,6 @@
 //#region src/divider/divider.ts
 /**
-* Divider 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
+* Divider 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。
 * 渲染契约：`role="separator"`，`data-scope="divider"`，`data-part="root"`；
 * `data-orientation` / `data-weight` 摊平枚举，`vertical` 额外输出 `aria-orientation`。
 *
@@ -12,7 +12,25 @@ const DIVIDER_ORIENTATIONS = ["horizontal", "vertical"];
 const DIVIDER_WEIGHTS = ["thin", "thick"];
 /** Divider 各渲染部位全集（data-part 取值）。 */
 const DIVIDER_PARTS = ["root"];
+/** Resolve the passive display contract once for every adapter. */
+function resolveDividerState(props = {}) {
+	return {
+		orientation: DIVIDER_ORIENTATIONS.includes(props.orientation) ? props.orientation : "horizontal",
+		weight: DIVIDER_WEIGHTS.includes(props.weight) ? props.weight : "thin"
+	};
+}
+/** Spread after caller attributes: Core owns these semantics. */
+function getDividerRootProps(state) {
+	return {
+		role: "separator",
+		"data-scope": "divider",
+		"data-part": "root",
+		"data-orientation": state.orientation,
+		"data-weight": state.weight,
+		"aria-orientation": state.orientation === "vertical" ? "vertical" : void 0
+	};
+}
 //#endregion
-export { DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS };
+export { DIVIDER_ORIENTATIONS, DIVIDER_PARTS, DIVIDER_WEIGHTS, getDividerRootProps, resolveDividerState };
 
 //# sourceMappingURL=index.js.map

package/dist/divider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/divider/divider.ts"],"sourcesContent":["/**\n * Divider 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。\n * 渲染契约：`role=\"separator\"`，`data-scope=\"divider\"`，`data-part=\"root\"`；\n * `data-orientation` / `data-weight` 摊平枚举，`vertical` 额外输出 `aria-orientation`。\n *\n * 方向 / 粗细词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** 方向全集：horizontal 水平（默认）/ vertical 垂直。 */\nexport const DIVIDER_ORIENTATIONS = [\"horizontal\", \"vertical\"] as const;\n\n/** 粗细全集：thin 细 0.5px（默认）/ thick 粗 1px。 */\nexport const DIVIDER_WEIGHTS = [\"thin\", \"thick\"] as const;\n\n/** Divider 各渲染部位全集（data-part 取值）。 */\nexport const DIVIDER_PARTS = [\"root\"] as const;\n\nexport type DividerOrientation = (typeof DIVIDER_ORIENTATIONS)[number];\nexport type DividerWeight = (typeof DIVIDER_WEIGHTS)[number];\nexport type DividerPart = (typeof DIVIDER_PARTS)[number];\n\n/** QwDividerProps — 双栈共享的行为契约（全字段可选）。 */\nexport interface QwDividerProps {\n  /** 方向，默认 horizontal。 */\n  orientation?: DividerOrientation;\n  /** 粗细，默认 thin（细，0.5px）。 */\n  weight?: DividerWeight;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,uBAAuB,CAAC,cAAc,UAAU;;AAG7D,MAAa,kBAAkB,CAAC,QAAQ,OAAO;;AAG/C,MAAa,gBAAgB,CAAC,MAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/divider/divider.ts"],"sourcesContent":["/**\n * Divider 契约 — 原型 A（无状态），Core 无 machine，承载三栈共享的类型与渲染契约。\n * 渲染契约：`role=\"separator\"`，`data-scope=\"divider\"`，`data-part=\"root\"`；\n * `data-orientation` / `data-weight` 摊平枚举，`vertical` 额外输出 `aria-orientation`。\n *\n * 方向 / 粗细词表以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死。\n */\n\n/** 方向全集：horizontal 水平（默认）/ vertical 垂直。 */\nexport const DIVIDER_ORIENTATIONS = [\"horizontal\", \"vertical\"] as const;\n\n/** 粗细全集：thin 细 0.5px（默认）/ thick 粗 1px。 */\nexport const DIVIDER_WEIGHTS = [\"thin\", \"thick\"] as const;\n\n/** Divider 各渲染部位全集（data-part 取值）。 */\nexport const DIVIDER_PARTS = [\"root\"] as const;\n\nexport type DividerOrientation = (typeof DIVIDER_ORIENTATIONS)[number];\nexport type DividerWeight = (typeof DIVIDER_WEIGHTS)[number];\nexport type DividerPart = (typeof DIVIDER_PARTS)[number];\n\n/** QwDividerProps — 三栈共享的行为与渲染契约（全字段可选）。 */\nexport interface QwDividerProps {\n  /** 方向，默认 horizontal。 */\n  orientation?: DividerOrientation;\n  /** 粗细，默认 thin（细，0.5px）。 */\n  weight?: DividerWeight;\n}\n\n\nexport interface ResolvedDividerState { orientation: DividerOrientation; weight: DividerWeight }\n/** Resolve the passive display contract once for every adapter. */\nexport function resolveDividerState(props: QwDividerProps = {}): ResolvedDividerState {\n  return { orientation: DIVIDER_ORIENTATIONS.includes(props.orientation!) ? props.orientation! : \"horizontal\", weight: DIVIDER_WEIGHTS.includes(props.weight!) ? props.weight! : \"thin\" };\n}\nexport interface DividerRootProps {\n  role: \"separator\"; \"data-scope\": \"divider\"; \"data-part\": \"root\";\n  \"data-orientation\": DividerOrientation; \"data-weight\": DividerWeight; \"aria-orientation\"?: \"vertical\";\n}\n/** Spread after caller attributes: Core owns these semantics. */\nexport function getDividerRootProps(state: ResolvedDividerState): DividerRootProps {\n  return { role: \"separator\", \"data-scope\": \"divider\", \"data-part\": \"root\", \"data-orientation\": state.orientation, \"data-weight\": state.weight, \"aria-orientation\": state.orientation === \"vertical\" ? \"vertical\" : undefined };\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,uBAAuB,CAAC,cAAc,UAAU;;AAG7D,MAAa,kBAAkB,CAAC,QAAQ,OAAO;;AAG/C,MAAa,gBAAgB,CAAC,MAAM;;AAiBpC,SAAgB,oBAAoB,QAAwB,CAAC,GAAyB;CACpF,OAAO;EAAE,aAAa,qBAAqB,SAAS,MAAM,WAAY,IAAI,MAAM,cAAe;EAAc,QAAQ,gBAAgB,SAAS,MAAM,MAAO,IAAI,MAAM,SAAU;CAAO;AACxL;;AAMA,SAAgB,oBAAoB,OAA+C;CACjF,OAAO;EAAE,MAAM;EAAa,cAAc;EAAW,aAAa;EAAQ,oBAAoB,MAAM;EAAa,eAAe,MAAM;EAAQ,oBAAoB,MAAM,gBAAgB,aAAa,aAAa,KAAA;CAAU;AAC9N"}

package/dist/dropdown/dropdown.d.ts

@@ -0,0 +1,172 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type FloatingAlign, type FloatingLayout, type FloatingPlacement, type FloatingSide } from "../popover/positioning.js";
+import { type FloatingCloseRequest } from "../popover/layer.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const DROPDOWN_PARTS: readonly ["trigger", "positioner", "content", "item"];
+export type DropdownPlacement = FloatingPlacement;
+export declare const DROPDOWN_DEFAULT_PLACEMENT: DropdownPlacement;
+/** Main-axis gap between the trigger and the menu in CSS px. */
+export declare const DROPDOWN_DEFAULT_OFFSET = 4;
+/** Characters typed within this many milliseconds extend the typeahead query. */
+export declare const DROPDOWN_TYPEAHEAD_TIMEOUT = 500;
+export declare const DROPDOWN_MOVES: readonly ["first", "last", "next", "prev"];
+export type DropdownMove = (typeof DROPDOWN_MOVES)[number];
+/** One text menu item. value is the exact selection notification; label is the visible and typeahead text. */
+export interface QwDropdownItem {
+    value: string;
+    label: string;
+    /** Visible and announced (aria-disabled) but skipped by roving focus and never selected. */
+    disabled?: boolean;
+    /** Destructive styling only; there is no second confirmation. */
+    danger?: boolean;
+}
+export interface QwResolvedDropdownItem {
+    readonly source: QwDropdownItem;
+    /** Position in the caller's items array; part of the item id. */
+    readonly index: number;
+    readonly value: string;
+    readonly label: string;
+    /** Disabled by the caller, or a later duplicate of an earlier value. */
+    readonly disabled: boolean;
+    readonly danger: boolean;
+    readonly duplicate: boolean;
+}
+/** keyboard: ArrowDown/ArrowUp on the trigger; tab / focus-outside: focus left the menu; select: an item was chosen. */
+export type DropdownOpenChangeReason = "trigger" | "keyboard" | "escape" | "outside" | "focus-outside" | "tab" | "select" | "api";
+export interface DropdownOpenChangeDetails {
+    open: boolean;
+    reason: DropdownOpenChangeReason;
+}
+export interface DropdownSelectDetails {
+    value: string;
+}
+export interface QwDropdownProps {
+    /** Page-unique instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Caller-owned menu items, never mutated; default []. */
+    items?: readonly QwDropdownItem[];
+    /** Controlled open state; undefined lets Core own it. */
+    open?: boolean;
+    /** Initial open state when uncontrolled. */
+    defaultOpen?: boolean;
+    /** Every open/close request, controlled or not; controlled owners accept by updating open, or refuse by keeping it. */
+    onOpenChange?: (details: DropdownOpenChangeDetails) => void;
+    /** An enabled item was activated (click, Enter or Space); a close request (reason select) follows. */
+    onSelect?: (details: DropdownSelectDetails) => void;
+    /** Preferred placement (default bottom-start; unknown values use it); positioning is Popover's Core module. */
+    placement?: DropdownPlacement;
+    /** Main-axis gap in CSS px; default 4. */
+    offset?: number;
+    /** Accessible name of the menu; omitted names it by the trigger (aria-labelledby). */
+    label?: string;
+}
+export interface ResolvedDropdownState {
+    placement: DropdownPlacement;
+    offset: number;
+    label: string | undefined;
+}
+export declare function resolveDropdownState(props?: QwDropdownProps): ResolvedDropdownState;
+/** Keeps every item in order; a repeated value only keeps its first item enabled (a disabled first item does not promote a later one). */
+export declare function resolveDropdownItems(items: readonly QwDropdownItem[] | undefined): readonly QwResolvedDropdownItem[];
+/** Source index of the enabled item a move lands on, or -1 when nothing is enabled. next/prev wrap; from no highlight they start at the ends. */
+export declare function getDropdownMoveTarget(items: readonly QwResolvedDropdownItem[], current: string | null, move: DropdownMove): number;
+/**
+ * Explicit text match: the first enabled item, searching forward and wrapping, whose trimmed label starts
+ * with the query (locale lower case). A single or repeated character starts after the current item (so
+ * repeating it cycles); a longer query keeps the current item while it still matches. -1 when none matches.
+ */
+export declare function getDropdownTypeaheadTarget(items: readonly QwResolvedDropdownItem[], current: string | null, query: string): number;
+export declare function createDropdownProps(props?: QwDropdownProps): QwDropdownProps;
+type FocusIntent = "first" | "last";
+export interface QwDropdownSchema {
+    props: QwDropdownProps;
+    context: {
+        dismissReady: boolean;
+        layout: FloatingLayout | null;
+        highlighted: string | null;
+    };
+    refs: {
+        request: FloatingCloseRequest | null;
+        focus: FocusIntent | null;
+        typeahead: {
+            query: string;
+            at: number;
+        };
+        cancelFocus: (() => void) | null;
+    };
+    state: "open" | "closed";
+    guard: "isControlled";
+    action: "notifyOpen" | "notifyClose" | "restoreFocus" | "setLayout" | "dismissReady" | "clearLayout" | "syncControlled" | "highlight" | "move" | "typeahead" | "select" | "reconcile";
+    effect: "trackLayout" | "trackDismiss";
+    event: {
+        type: "DISMISS.READY";
+    } | {
+        type: "OPEN" | "TOGGLE";
+        reason?: DropdownOpenChangeReason;
+        focus?: FocusIntent;
+    } | {
+        type: "CLOSE";
+        reason?: DropdownOpenChangeReason;
+        focusable?: boolean;
+    } | {
+        type: "CONTROLLED.OPEN" | "CONTROLLED.CLOSE";
+    } | {
+        type: "LAYOUT";
+        layout: FloatingLayout;
+    } | {
+        type: "HIGHLIGHT";
+        value: string;
+    } | {
+        type: "MOVE";
+        to: DropdownMove;
+    } | {
+        type: "TYPEAHEAD";
+        key: string;
+    } | {
+        type: "SELECT";
+        index: number;
+        value: string;
+    };
+}
+export type QwDropdownMachine = Machine<QwDropdownSchema>;
+export type QwDropdownService = Service<QwDropdownSchema>;
+/**
+ * Core owns the menu: open/close with controlled refusal, Popover's positioning module while open, the
+ * shared non-modal layer (Escape, outside pointer, focus leaving), roving focus, typeahead, selection and
+ * focus return to the original trigger.
+ */
+export declare const dropdownMachine: QwDropdownMachine;
+/** Minimal event surfaces shared by React, Vue and native events. */
+export interface DropdownDomEvent {
+    readonly defaultPrevented: boolean;
+    preventDefault(): void;
+}
+export interface DropdownKeyboardEvent extends DropdownDomEvent {
+    readonly key: string;
+    readonly shiftKey?: boolean;
+    readonly altKey?: boolean;
+    readonly ctrlKey?: boolean;
+    readonly metaKey?: boolean;
+    readonly isComposing?: boolean;
+}
+export interface QwDropdownApi<T extends PropTypes = PropTypes> {
+    open: boolean;
+    /** The measured placement while open (after flipping), otherwise the preferred one. */
+    placement: DropdownPlacement;
+    side: FloatingSide;
+    align: FloatingAlign;
+    positioned: boolean;
+    items: readonly QwResolvedDropdownItem[];
+    /** Value of the item holding roving focus. */
+    highlighted: string | null;
+    /** Request a state; controlled owners decide through onOpenChange (reason api). */
+    setOpen(open: boolean): void;
+    /** Merge onto the caller's own trigger node (click toggles; ArrowDown/ArrowUp open on the first/last item); preventDefault() in its handlers skips Core. */
+    getTriggerProps(): T["element"];
+    getPositionerProps(): T["element"];
+    getContentProps(): T["element"];
+    getItemProps(item: QwResolvedDropdownItem): T["element"];
+}
+export declare function connectDropdown<T extends PropTypes>(service: QwDropdownService, normalize: NormalizeProps<T>): QwDropdownApi<T>;
+export {};

package/dist/dropdown/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./dropdown.js";
+export type { FloatingAlign, FloatingLayout, FloatingPlacement, FloatingSide } from "../popover/positioning.js";