@qw-ui/core 0.3.0-next.9 → 0.3.0

package/dist/timeline/timeline.d.ts

@@ -0,0 +1,79 @@
+/** Ordered event history. Status is always expressed by marker shape and text, never color alone. */
+export declare const TIMELINE_STATUSES: readonly ["finished", "process", "wait", "error"];
+export declare const TIMELINE_PARTS: readonly ["root", "item", "marker", "content", "header", "title", "time", "description", "status"];
+export type TimelineStatus = (typeof TIMELINE_STATUSES)[number];
+export type TimelinePart = (typeof TIMELINE_PARTS)[number];
+export declare const TIMELINE_DEFAULT_STATUS_LABELS: Readonly<Record<TimelineStatus, string>>;
+/** Decorative marker glyphs; each status has a distinct shape in addition to its color role. */
+export declare const TIMELINE_MARKER_GLYPHS: Readonly<Record<TimelineStatus, string>>;
+export interface TimelineItem {
+    id: string;
+    title: string;
+    description?: string;
+    /** Visible time text. */
+    time?: string;
+    /** Machine-readable datetime for the <time> element. */
+    dateTime?: string;
+    status?: TimelineStatus;
+}
+export interface QwTimelineProps {
+    items: readonly TimelineItem[];
+    /** Zero-based current index. Omitted: items default to finished and the first process item is current. */
+    current?: number;
+    /** Render newest first; indices and current identity stay those of `items`. */
+    reverse?: boolean;
+    /** Show the status text visibly instead of visually hidden. */
+    showStatus?: boolean;
+    statusLabels?: Partial<Record<TimelineStatus, string>>;
+}
+export interface ResolvedTimelineItem extends TimelineItem {
+    index: number;
+    status: TimelineStatus;
+    current: boolean;
+    statusText: string;
+    glyph: string;
+    last: boolean;
+}
+export interface ResolvedTimelineState {
+    current: number | undefined;
+    reverse: boolean;
+    showStatus: boolean;
+    /** Display order (reversed when `reverse`). */
+    items: ResolvedTimelineItem[];
+}
+export declare function resolveTimelineState(props: QwTimelineProps): ResolvedTimelineState;
+type Part<P extends TimelinePart> = {
+    "data-scope": "timeline";
+    "data-part": P;
+};
+export declare function getTimelineRootProps(state: ResolvedTimelineState): Part<"root"> & {
+    "data-reverse"?: "true";
+};
+export declare function getTimelineItemProps(item: ResolvedTimelineItem): Part<"item"> & {
+    "data-value": string;
+    "data-status": TimelineStatus;
+    "data-current"?: "true";
+    "data-last"?: "true";
+    "aria-current"?: "step";
+};
+export declare function getTimelineMarkerProps(item: ResolvedTimelineItem): Part<"marker"> & {
+    "data-status": TimelineStatus;
+    "aria-hidden": "true";
+};
+/** Status text precedes the title in reading order; visually hidden unless showStatus. */
+export declare function getTimelineStatusProps(state: ResolvedTimelineState, item: ResolvedTimelineItem): Part<"status"> & {
+    "data-status": TimelineStatus;
+    "data-visible": "true" | "false";
+    style?: Record<string, string>;
+};
+export declare function getTimelineTimeProps(item: ResolvedTimelineItem): Part<"time"> & {
+    dateTime?: string;
+    hidden?: true;
+};
+export declare function getTimelineDescriptionProps(item: ResolvedTimelineItem): Part<"description"> & {
+    hidden?: true;
+};
+export declare function getTimelinePartProps<P extends "content" | "header" | "title">(name: P): Part<P>;
+/** Hidden status text carries a separator so "异常，配送失败" reads naturally; visible text is the bare label. */
+export declare function getTimelineStatusText(state: ResolvedTimelineState, item: ResolvedTimelineItem): string;
+export {};

package/dist/toast/index.js

@@ -1,10 +1,10 @@
+import { r as resolvePortalCopy, t as createPortalPlan } from "../portal-BHCNTWhg.js";
 //#region src/toast/toast.ts
 /**
 * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）
 * ─────────────────────────────────────────────────────────────
-* 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：
-* 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）
-* 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。
+* 纯 TS / SSR-safe，零框架依赖。单例、计时和关闭回调在 Core。
+* 适配层只负责挂载和卸载节点。节点类型由适配层具体化。
 */
 /** 垂直显示位置。 */
 const TOAST_POSITIONS = [
@@ -38,7 +38,50 @@ function isToastIconType(icon) {
 function resolveToastDuration(duration) {
 	return duration == null ? DEFAULT_TOAST_DURATION : duration;
 }
+/** 一条提示的生命周期。每个适配层持有自己的一份，规则相同。 */
+function createToastRuntime() {
+	let current = null;
+	const dismiss = (notify) => {
+		const session = current;
+		if (!session) return;
+		current = null;
+		if (session.timer != null) clearTimeout(session.timer);
+		session.unmount();
+		if (notify) session.afterClose?.();
+	};
+	const install = (options, mount) => {
+		dismiss(false);
+		const ticket = Symbol();
+		const session = {
+			ticket,
+			unmount: mount(),
+			afterClose: options.afterClose
+		};
+		current = session;
+		const duration = resolveToastDuration(options.duration);
+		if (duration > 0) session.timer = setTimeout(() => {
+			if (current === session) dismiss(true);
+		}, duration);
+		return ticket;
+	};
+	return {
+		show(options, mount) {
+			install(options, mount);
+		},
+		showOwned(options, mount) {
+			const ticket = install(options, mount);
+			return { clear() {
+				if (current?.ticket !== ticket) return false;
+				dismiss(true);
+				return true;
+			} };
+		},
+		clear() {
+			dismiss(true);
+		}
+	};
+}
 //#endregion
-export { DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, isToastIconType, resolveToastDuration };
+export { DEFAULT_TOAST_DURATION, DEFAULT_TOAST_POSITION, TOAST_ICON_TYPES, TOAST_PARTS, TOAST_POSITIONS, createPortalPlan, createToastRuntime, isToastIconType, resolvePortalCopy, resolveToastDuration };
 
 //# sourceMappingURL=index.js.map

package/dist/toast/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/toast/toast.ts"],"sourcesContent":["/**\n * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）\n * ─────────────────────────────────────────────────────────────\n * 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：\n * 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）\n * 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。\n */\n\n/** 垂直显示位置。 */\nexport const TOAST_POSITIONS = [\"top\", \"bottom\", \"center\"] as const;\nexport type QwToastPosition = (typeof TOAST_POSITIONS)[number];\n\n/** 内建状态图标类型。 */\nexport const TOAST_ICON_TYPES = [\"success\", \"fail\", \"loading\"] as const;\nexport type QwToastIconType = (typeof TOAST_ICON_TYPES)[number];\n\n/** 逻辑部件（承载 data-part 样式与 parity 指纹）。 */\nexport const TOAST_PARTS = [\"mask\", \"wrap\", \"body\", \"icon\", \"content\"] as const;\nexport type QwToastPart = (typeof TOAST_PARTS)[number];\n\n/** 默认展示时长（ms）。 */\nexport const DEFAULT_TOAST_DURATION = 3000;\n\n/** 默认垂直位置（对齐设计稿：默认顶部）。 */\nexport const DEFAULT_TOAST_POSITION: QwToastPosition = \"top\";\n\n/**\n * Toast 选项契约。`Node` / `Style` 由适配层具体化\n * （React `ReactNode` / `CSSProperties`；Vue `VNode` / `StyleValue`）。\n * 与 antd-mobile 风格对齐：命令式 `Toast.show(options)`。\n */\nexport interface QwToastOptions<Node = unknown, Style = unknown> {\n  /** 提示主文案。可空（纯图标提示）。 */\n  content?: Node;\n  /** 前置图标：内建类型 `success | fail | loading`，或任意自定义节点；不传则不展示图标。 */\n  icon?: QwToastIconType | Node;\n  /** 持续时间（ms），默认 3000；为 0 时不自动关闭。 */\n  duration?: number;\n  /** 垂直显示位置，默认 top。 */\n  position?: QwToastPosition;\n  /** 自定义遮罩层内联样式。 */\n  maskStyle?: Style;\n  /** 自定义遮罩层 class。 */\n  maskClassName?: string;\n  /** 关闭后回调（自动消失或手动 clear 均触发）。 */\n  afterClose?: () => void;\n}\n\n/** 命令式 Toast 单例接口（各框架适配层实现同名同义）。 */\nexport interface QwToast<Node = unknown, Style = unknown> {\n  /** 展示一条提示（替换上一条）。 */\n  show: (options?: QwToastOptions<Node, Style>) => void;\n  /** 立即收起当前提示。 */\n  clear: () => void;\n}\n\n/** 判断 icon 是否为内建状态图标类型。 */\nexport function isToastIconType(icon: unknown): icon is QwToastIconType {\n  return typeof icon === \"string\" && (TOAST_ICON_TYPES as readonly string[]).includes(icon);\n}\n\n/** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */\nexport function resolveToastDuration(duration?: number): number {\n  return duration == null ? DEFAULT_TOAST_DURATION : duration;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,kBAAkB;CAAC;CAAO;CAAU;AAAQ;;AAIzD,MAAa,mBAAmB;CAAC;CAAW;CAAQ;AAAS;;AAI7D,MAAa,cAAc;CAAC;CAAQ;CAAQ;CAAQ;CAAQ;AAAS;;AAIrE,MAAa,yBAAyB;;AAGtC,MAAa,yBAA0C;;AAiCvD,SAAgB,gBAAgB,MAAwC;CACtE,OAAO,OAAO,SAAS,YAAa,iBAAuC,SAAS,IAAI;AAC1F;;AAGA,SAAgB,qBAAqB,UAA2B;CAC9D,OAAO,YAAY,OAAO,yBAAyB;AACrD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/toast/toast.ts"],"sourcesContent":["/**\n * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）\n * ─────────────────────────────────────────────────────────────\n * 纯 TS / SSR-safe，零框架依赖。单例、计时和关闭回调在 Core。\n * 适配层只负责挂载和卸载节点。节点类型由适配层具体化。\n */\n\n/** 垂直显示位置。 */\nexport const TOAST_POSITIONS = [\"top\", \"bottom\", \"center\"] as const;\nexport type QwToastPosition = (typeof TOAST_POSITIONS)[number];\n\n/** 内建状态图标类型。 */\nexport const TOAST_ICON_TYPES = [\"success\", \"fail\", \"loading\"] as const;\nexport type QwToastIconType = (typeof TOAST_ICON_TYPES)[number];\n\n/** 逻辑部件（承载 data-part 样式与 parity 指纹）。 */\nexport const TOAST_PARTS = [\"mask\", \"wrap\", \"body\", \"icon\", \"content\"] as const;\nexport type QwToastPart = (typeof TOAST_PARTS)[number];\n\n/** 默认展示时长（ms）。 */\nexport const DEFAULT_TOAST_DURATION = 3000;\n\n/** 默认垂直位置（对齐设计稿：默认顶部）。 */\nexport const DEFAULT_TOAST_POSITION: QwToastPosition = \"top\";\n\n/**\n * Toast 选项契约。`Node` / `Style` 由适配层具体化\n * （React `ReactNode` / `CSSProperties`；Vue `VNode` / `StyleValue`）。\n * 与 antd-mobile 风格对齐：命令式 `Toast.show(options)`。\n */\nexport interface QwToastOptions<Node = unknown, Style = unknown> {\n  /** 提示主文案。可空（纯图标提示）。 */\n  content?: Node;\n  /** 前置图标：内建类型 `success | fail | loading`，或任意自定义节点；不传则不展示图标。 */\n  icon?: QwToastIconType | Node;\n  /** 持续时间（ms），默认 3000；为 0 时不自动关闭。 */\n  duration?: number;\n  /** 垂直显示位置，默认 top。 */\n  position?: QwToastPosition;\n  /** 自定义遮罩层内联样式。 */\n  maskStyle?: Style;\n  /** 自定义遮罩层 class。 */\n  maskClassName?: string;\n  /** 关闭后回调（自动消失或手动 clear 均触发）。 */\n  afterClose?: () => void;\n}\n\n/** 命令式 Toast 单例接口（各框架适配层实现同名同义）。 */\nexport interface QwToast<Node = unknown, Style = unknown> {\n  /** 展示一条提示（替换上一条）。 */\n  show: (options?: QwToastOptions<Node, Style>) => void;\n  /** 立即收起当前提示。 */\n  clear: () => void;\n}\n\n/** 只允许清理自己仍为当前提示的 session；过期、被替换或已清理时返回 false。 */\nexport interface ToastOwnedHandle {\n  clear(): boolean;\n}\n\n/** 判断 icon 是否为内建状态图标类型。 */\nexport function isToastIconType(icon: unknown): icon is QwToastIconType {\n  return typeof icon === \"string\" && (TOAST_ICON_TYPES as readonly string[]).includes(icon);\n}\n\n/** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */\nexport function resolveToastDuration(duration?: number): number {\n  return duration == null ? DEFAULT_TOAST_DURATION : duration;\n}\n\nexport interface ToastRuntimeOptions {\n  duration?: number;\n  afterClose?: () => void;\n}\n\nexport interface ToastRuntime {\n  /**\n   * 替换当前提示。上一条被卸掉，且不调用它的 afterClose。\n   * `mount` 同步挂载并返回卸载函数。\n   */\n  show(options: ToastRuntimeOptions, mount: () => () => void): void;\n  /** 收起当前提示，并调用它的 afterClose。没有当前提示时什么都不做。 */\n  clear(): void;\n}\n\ninterface ToastSession {\n  ticket: symbol;\n  unmount: () => void;\n  afterClose?: () => void;\n  timer?: ReturnType<typeof setTimeout>;\n}\n\n/** 一条提示的生命周期。每个适配层持有自己的一份，规则相同。 */\nexport function createToastRuntime(): ToastRuntime & {\n  /** 同 show 的单例安装路径，返回仅持有私有 ticket 的有限归属句柄。 */\n  showOwned(options: ToastRuntimeOptions, mount: () => () => void): ToastOwnedHandle;\n} {\n  let current: ToastSession | null = null;\n  const dismiss = (notify: boolean) => {\n    const session = current;\n    if (!session) return;\n    current = null;\n    if (session.timer != null) clearTimeout(session.timer);\n    session.unmount();\n    if (notify) session.afterClose?.();\n  };\n  const install = (options: ToastRuntimeOptions, mount: () => () => void) => {\n    dismiss(false);\n    const ticket = Symbol();\n    const session: ToastSession = { ticket, unmount: mount(), afterClose: options.afterClose };\n    current = session;\n    const duration = resolveToastDuration(options.duration);\n    if (duration > 0) {\n      session.timer = setTimeout(() => {\n        if (current === session) dismiss(true);\n      }, duration);\n    }\n    return ticket;\n  };\n  return {\n    show(options, mount) {\n      install(options, mount);\n    },\n    showOwned(options, mount) {\n      const ticket = install(options, mount);\n      return { clear() {\n        if (current?.ticket !== ticket) return false;\n        dismiss(true);\n        return true;\n      } };\n    },\n    clear() {\n      dismiss(true);\n    },\n  };\n}\n\nexport { createPortalPlan, 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":";;;;;;;;;AAQA,MAAa,kBAAkB;CAAC;CAAO;CAAU;AAAQ;;AAIzD,MAAa,mBAAmB;CAAC;CAAW;CAAQ;AAAS;;AAI7D,MAAa,cAAc;CAAC;CAAQ;CAAQ;CAAQ;CAAQ;AAAS;;AAIrE,MAAa,yBAAyB;;AAGtC,MAAa,yBAA0C;;AAsCvD,SAAgB,gBAAgB,MAAwC;CACtE,OAAO,OAAO,SAAS,YAAa,iBAAuC,SAAS,IAAI;AAC1F;;AAGA,SAAgB,qBAAqB,UAA2B;CAC9D,OAAO,YAAY,OAAO,yBAAyB;AACrD;;AAyBA,SAAgB,qBAGd;CACA,IAAI,UAA+B;CACnC,MAAM,WAAW,WAAoB;EACnC,MAAM,UAAU;EAChB,IAAI,CAAC,SAAS;EACd,UAAU;EACV,IAAI,QAAQ,SAAS,MAAM,aAAa,QAAQ,KAAK;EACrD,QAAQ,QAAQ;EAChB,IAAI,QAAQ,QAAQ,aAAa;CACnC;CACA,MAAM,WAAW,SAA8B,UAA4B;EACzE,QAAQ,KAAK;EACb,MAAM,SAAS,OAAO;EACtB,MAAM,UAAwB;GAAE;GAAQ,SAAS,MAAM;GAAG,YAAY,QAAQ;EAAW;EACzF,UAAU;EACV,MAAM,WAAW,qBAAqB,QAAQ,QAAQ;EACtD,IAAI,WAAW,GACb,QAAQ,QAAQ,iBAAiB;GAC/B,IAAI,YAAY,SAAS,QAAQ,IAAI;EACvC,GAAG,QAAQ;EAEb,OAAO;CACT;CACA,OAAO;EACL,KAAK,SAAS,OAAO;GACnB,QAAQ,SAAS,KAAK;EACxB;EACA,UAAU,SAAS,OAAO;GACxB,MAAM,SAAS,QAAQ,SAAS,KAAK;GACrC,OAAO,EAAE,QAAQ;IACf,IAAI,SAAS,WAAW,QAAQ,OAAO;IACvC,QAAQ,IAAI;IACZ,OAAO;GACT,EAAE;EACJ;EACA,QAAQ;GACN,QAAQ,IAAI;EACd;CACF;AACF"}

package/dist/toast/toast.d.ts

@@ -1,9 +1,8 @@
 /**
  * @qw-ui/core · Toast 契约（原型 D · 自研命令式单例）
  * ─────────────────────────────────────────────────────────────
- * 纯 TS / SSR-safe，零框架依赖。只收口「框架无关的选项契约 + 纯函数」：
- * 交互（命令式挂载 / 计时 / 渲染）落在各框架适配层，节点类型（icon/content）
- * 由适配层用 `ReactNode` / `VNode` 具体化 `QwToastOptions<Node>`。
+ * 纯 TS / SSR-safe，零框架依赖。单例、计时和关闭回调在 Core。
+ * 适配层只负责挂载和卸载节点。节点类型由适配层具体化。
  */
 /** 垂直显示位置。 */
 export declare const TOAST_POSITIONS: readonly ["top", "bottom", "center"];
@@ -46,7 +45,31 @@ export interface QwToast<Node = unknown, Style = unknown> {
     /** 立即收起当前提示。 */
     clear: () => void;
 }
+/** 只允许清理自己仍为当前提示的 session；过期、被替换或已清理时返回 false。 */
+export interface ToastOwnedHandle {
+    clear(): boolean;
+}
 /** 判断 icon 是否为内建状态图标类型。 */
 export declare function isToastIconType(icon: unknown): icon is QwToastIconType;
 /** 解析持续时间：未传用默认 3000；显式 0 透传（不自动关闭）。 */
 export declare function resolveToastDuration(duration?: number): number;
+export interface ToastRuntimeOptions {
+    duration?: number;
+    afterClose?: () => void;
+}
+export interface ToastRuntime {
+    /**
+     * 替换当前提示。上一条被卸掉，且不调用它的 afterClose。
+     * `mount` 同步挂载并返回卸载函数。
+     */
+    show(options: ToastRuntimeOptions, mount: () => () => void): void;
+    /** 收起当前提示，并调用它的 afterClose。没有当前提示时什么都不做。 */
+    clear(): void;
+}
+/** 一条提示的生命周期。每个适配层持有自己的一份，规则相同。 */
+export declare function createToastRuntime(): ToastRuntime & {
+    /** 同 show 的单例安装路径，返回仅持有私有 ticket 的有限归属句柄。 */
+    showOwned(options: ToastRuntimeOptions, mount: () => () => void): ToastOwnedHandle;
+};
+export { createPortalPlan, resolvePortalCopy } from "../portal.js";
+export type { PortalCopy, PortalCopyAttribute, PortalKind, PortalPart, PortalPlan, PortalResolvedCopy, PortalSnapshot, PortalTarget, PortalVariableMode, } from "../portal.js";

package/dist/top-bar/index.js

@@ -1,3 +1,4 @@
+import { createNavBarProps } from "../nav-bar/index.js";
 //#region src/top-bar/top-bar.ts
 /**
 * Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
@@ -13,7 +14,8 @@
 const TOPBAR_VARIANTS = [
 	"basic",
 	"tab",
-	"extended"
+	"extended",
+	"navigation"
 ];
 /**
 * 把 QwTopBarProps 收口默认值，返回适配层配置对象。
@@ -37,7 +39,19 @@ function createTopBarProps(props) {
 		hasTabs: items !== void 0 && items.length > 0
 	};
 }
+/** Page navigation delegates its behavior and defaults to the NavBar contract. */
+function createTopBarNavigationProps(props) {
+	return createNavBarProps({
+		title: props.title,
+		subtitle: props.subtitle,
+		back: props.back,
+		backText: props.backText,
+		backLabel: props.backLabel,
+		safeAreaTop: props.safeAreaTop,
+		onBack: () => props.onBack?.()
+	});
+}
 //#endregion
-export { TOPBAR_VARIANTS, createTopBarProps };
+export { TOPBAR_VARIANTS, createTopBarNavigationProps, createTopBarProps };
 
 //# sourceMappingURL=index.js.map

package/dist/top-bar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/top-bar/top-bar.ts"],"sourcesContent":["/**\n * Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。\n * React/Vue 适配层从这里 import 类型与 createTopBarProps，不允许各自再定义一份。\n *\n * Top Bar 是内容面板的头部组件，通过 `variant` prop 选择三种互斥结构形式：\n * basic（标题 + 收起 icon）、tab（tablist + 收起 icon）、extended（返回箭头 + 自定义中间 + 关闭 icon）。\n * Tab 切换复用 @qw-ui/core/tabs。\n *\n * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。\n */\n\n/** variant 全集：basic 基础 / tab 标签页 / extended 拓展。 */\nexport const TOPBAR_VARIANTS = [\"basic\", \"tab\", \"extended\"] as const;\n\n/** 结构形式。 */\nexport type TopBarVariant = (typeof TOPBAR_VARIANTS)[number];\n\n/**\n * TopBarItem — Tab 项契约，与 @qw-ui/react/tabs 和 @qw-ui/vue/tabs 的 TabItem 同构。\n * core 定义最小形状（label/content 为 string），适配层各自扩展为 ReactNode / slot。\n */\nexport interface TopBarItem {\n  /** 选项唯一值。 */\n  value: string;\n  /** 选项标签文本。 */\n  label: string;\n  /** 选项内容（简单文本）。 */\n  content?: string;\n  /** 禁用该选项：跳过键盘漫游、不可点击。 */\n  disabled?: boolean;\n}\n\n/**\n * QwTopBarProps — 双栈共享的行为 + 视觉契约。\n * Tab 相关 props（items/value/defaultValue/onValueChange）透传给 @qw-ui/core/tabs。\n * variant 为必填，其余 props 按 variant 条件可选（flat interface，非 discriminated union）。\n */\nexport interface QwTopBarProps {\n  /** 结构形式（必填）。 */\n  variant: TopBarVariant;\n\n  // ── basic 专用 ──\n  /** 标题名称（basic 专用）。 */\n  title?: string;\n\n  // ── tab 专用 ──\n  /** Tab 切换模式的数据项。 */\n  items?: TopBarItem[];\n  /** Tab 非受控初值。 */\n  defaultValue?: string | null;\n  /** Tab 受控当前项。 */\n  value?: string | null;\n  /** Tab 选中项变化回调。 */\n  onValueChange?: (e: { value: string }) => void;\n\n  // ── basic + tab 共用 ──\n  /** 收起 icon 点击回调（关闭内容面板）。 */\n  onCollapse?: () => void;\n  /** 收起 icon 的 aria-label，默认「收起」。 */\n  collapseLabel?: string;\n\n  // ── extended 专用 ──\n  /** 返回箭头点击回调（面板内导航回退）。 */\n  onBack?: () => void;\n  /** 返回箭头的 aria-label，默认「返回」。 */\n  backLabel?: string;\n  /** 关闭 icon 点击回调（关闭面板）。 */\n  onClose?: () => void;\n  /** 关闭 icon 的 aria-label，默认「关闭」。 */\n  closeLabel?: string;\n}\n\n/**\n * ResolvedTopBarProps — createTopBarProps 返回值，适配层消费此对象渲染。\n */\nexport interface ResolvedTopBarProps {\n  variant: TopBarVariant;\n  title: string | undefined;\n  items: TopBarItem[] | undefined;\n  defaultValue: string | null;\n  value: string | null;\n  onValueChange: ((e: { value: string }) => void) | undefined;\n  onCollapse: (() => void) | undefined;\n  collapseLabel: string;\n  onBack: (() => void) | undefined;\n  backLabel: string;\n  onClose: (() => void) | undefined;\n  closeLabel: string;\n  hasTabs: boolean;\n}\n\n/**\n * 把 QwTopBarProps 收口默认值，返回适配层配置对象。\n * 不进 machine（原型 A）。纯函数，SSR-safe。\n */\nexport function createTopBarProps(props: QwTopBarProps): ResolvedTopBarProps {\n  const items = props.items;\n\n  return {\n    variant: props.variant,\n    title: props.title,\n    items,\n    defaultValue: props.defaultValue ?? null,\n    value: props.value ?? null,\n    onValueChange: props.onValueChange,\n    onCollapse: props.onCollapse,\n    collapseLabel: props.collapseLabel ?? \"收起\",\n    onBack: props.onBack,\n    backLabel: props.backLabel ?? \"返回\",\n    onClose: props.onClose,\n    closeLabel: props.closeLabel ?? \"关闭\",\n    hasTabs: items !== undefined && items.length > 0,\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,kBAAkB;CAAC;CAAS;CAAO;AAAU;;;;;AAmF1D,SAAgB,kBAAkB,OAA2C;CAC3E,MAAM,QAAQ,MAAM;CAEpB,OAAO;EACL,SAAS,MAAM;EACf,OAAO,MAAM;EACb;EACA,cAAc,MAAM,gBAAgB;EACpC,OAAO,MAAM,SAAS;EACtB,eAAe,MAAM;EACrB,YAAY,MAAM;EAClB,eAAe,MAAM,iBAAiB;EACtC,QAAQ,MAAM;EACd,WAAW,MAAM,aAAa;EAC9B,SAAS,MAAM;EACf,YAAY,MAAM,cAAc;EAChC,SAAS,UAAU,KAAA,KAAa,MAAM,SAAS;CACjD;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/top-bar/top-bar.ts"],"sourcesContent":["import { createNavBarProps, type QwNavBarProps } from \"../nav-bar/index.js\";\n/**\n * Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。\n * React/Vue 适配层从这里 import 类型与 createTopBarProps，不允许各自再定义一份。\n *\n * Top Bar 是内容面板的头部组件，通过 `variant` prop 选择三种互斥结构形式：\n * basic（标题 + 收起 icon）、tab（tablist + 收起 icon）、extended（返回箭头 + 自定义中间 + 关闭 icon）。\n * Tab 切换复用 @qw-ui/core/tabs。\n *\n * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。\n */\n\n/** variant 全集：basic 基础 / tab 标签页 / extended 拓展。 */\nexport const TOPBAR_VARIANTS = [\"basic\", \"tab\", \"extended\", \"navigation\"] as const;\n\n/** 结构形式。 */\nexport type TopBarVariant = (typeof TOPBAR_VARIANTS)[number];\n\n/**\n * TopBarItem — Tab 项契约，与 @qw-ui/react/tabs 和 @qw-ui/vue/tabs 的 TabItem 同构。\n * core 定义最小形状（label/content 为 string），适配层各自扩展为 ReactNode / slot。\n */\nexport interface TopBarItem {\n  /** 选项唯一值。 */\n  value: string;\n  /** 选项标签文本。 */\n  label: string;\n  /** 选项内容（简单文本）。 */\n  content?: string;\n  /** 禁用该选项：跳过键盘漫游、不可点击。 */\n  disabled?: boolean;\n}\n\n/**\n * QwTopBarProps — 双栈共享的行为 + 视觉契约。\n * Tab 相关 props（items/value/defaultValue/onValueChange）透传给 @qw-ui/core/tabs。\n * variant 为必填，其余 props 按 variant 条件可选（flat interface，非 discriminated union）。\n */\nexport interface QwTopBarProps {\n  /** 结构形式（必填）。 */\n  variant: TopBarVariant;\n  /** navigation 模式：是否显示默认返回按钮，默认 true。 */\n  back?: boolean;\n  /** navigation 模式：返回文字。 */\n  backText?: string;\n  /** navigation 模式：标题下的补充信息。 */\n  subtitle?: string;\n  /** navigation 模式：顶部安全区，默认 true；面板模式不消费。 */\n  safeAreaTop?: boolean;\n\n  // ── basic 专用 ──\n  /** 标题名称（basic / navigation）。 */\n  title?: string;\n\n  // ── tab 专用 ──\n  /** Tab 切换模式的数据项。 */\n  items?: TopBarItem[];\n  /** Tab 非受控初值。 */\n  defaultValue?: string | null;\n  /** Tab 受控当前项。 */\n  value?: string | null;\n  /** Tab 选中项变化回调。 */\n  onValueChange?: (e: { value: string }) => void;\n\n  // ── basic + tab 共用 ──\n  /** 收起 icon 点击回调（关闭内容面板）。 */\n  onCollapse?: () => void;\n  /** 收起 icon 的 aria-label，默认「收起」。 */\n  collapseLabel?: string;\n\n  // ── extended 专用 ──\n  /** 返回箭头点击回调（面板内导航回退）。 */\n  onBack?: () => void;\n  /** 返回箭头的 aria-label，默认「返回」。 */\n  backLabel?: string;\n  /** 关闭 icon 点击回调（关闭面板）。 */\n  onClose?: () => void;\n  /** 关闭 icon 的 aria-label，默认「关闭」。 */\n  closeLabel?: string;\n}\n\n/**\n * ResolvedTopBarProps — createTopBarProps 返回值，适配层消费此对象渲染。\n */\nexport interface ResolvedTopBarProps {\n  variant: TopBarVariant;\n  title: string | undefined;\n  items: TopBarItem[] | undefined;\n  defaultValue: string | null;\n  value: string | null;\n  onValueChange: ((e: { value: string }) => void) | undefined;\n  onCollapse: (() => void) | undefined;\n  collapseLabel: string;\n  onBack: (() => void) | undefined;\n  backLabel: string;\n  onClose: (() => void) | undefined;\n  closeLabel: string;\n  hasTabs: boolean;\n}\n\n/**\n * 把 QwTopBarProps 收口默认值，返回适配层配置对象。\n * 不进 machine（原型 A）。纯函数，SSR-safe。\n */\nexport function createTopBarProps(props: QwTopBarProps): ResolvedTopBarProps {\n  const items = props.items;\n\n  return {\n    variant: props.variant,\n    title: props.title,\n    items,\n    defaultValue: props.defaultValue ?? null,\n    value: props.value ?? null,\n    onValueChange: props.onValueChange,\n    onCollapse: props.onCollapse,\n    collapseLabel: props.collapseLabel ?? \"收起\",\n    onBack: props.onBack,\n    backLabel: props.backLabel ?? \"返回\",\n    onClose: props.onClose,\n    closeLabel: props.closeLabel ?? \"关闭\",\n    hasTabs: items !== undefined && items.length > 0,\n  };\n}\n\n/** Page navigation delegates its behavior and defaults to the NavBar contract. */\nexport function createTopBarNavigationProps(props: QwTopBarProps): QwNavBarProps {\n  return createNavBarProps({ title: props.title, subtitle: props.subtitle, back: props.back,\n    backText: props.backText, backLabel: props.backLabel, safeAreaTop: props.safeAreaTop, onBack: () => props.onBack?.() });\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,kBAAkB;CAAC;CAAS;CAAO;CAAY;AAAY;;;;;AA2FxE,SAAgB,kBAAkB,OAA2C;CAC3E,MAAM,QAAQ,MAAM;CAEpB,OAAO;EACL,SAAS,MAAM;EACf,OAAO,MAAM;EACb;EACA,cAAc,MAAM,gBAAgB;EACpC,OAAO,MAAM,SAAS;EACtB,eAAe,MAAM;EACrB,YAAY,MAAM;EAClB,eAAe,MAAM,iBAAiB;EACtC,QAAQ,MAAM;EACd,WAAW,MAAM,aAAa;EAC9B,SAAS,MAAM;EACf,YAAY,MAAM,cAAc;EAChC,SAAS,UAAU,KAAA,KAAa,MAAM,SAAS;CACjD;AACF;;AAGA,SAAgB,4BAA4B,OAAqC;CAC/E,OAAO,kBAAkB;EAAE,OAAO,MAAM;EAAO,UAAU,MAAM;EAAU,MAAM,MAAM;EACnF,UAAU,MAAM;EAAU,WAAW,MAAM;EAAW,aAAa,MAAM;EAAa,cAAc,MAAM,SAAS;CAAE,CAAC;AAC1H"}

package/dist/top-bar/top-bar.d.ts

@@ -1,3 +1,4 @@
+import { type QwNavBarProps } from "../nav-bar/index.js";
 /**
  * Top Bar 契约 — 原型 A（无状态），core 无 machine，只承载双栈共享的类型契约。
  * React/Vue 适配层从这里 import 类型与 createTopBarProps，不允许各自再定义一份。
@@ -9,7 +10,7 @@
  * 枚举以运行时常量数组为唯一事实源（类型从常量推导），__test__ 直接锁死词表。
  */
 /** variant 全集：basic 基础 / tab 标签页 / extended 拓展。 */
-export declare const TOPBAR_VARIANTS: readonly ["basic", "tab", "extended"];
+export declare const TOPBAR_VARIANTS: readonly ["basic", "tab", "extended", "navigation"];
 /** 结构形式。 */
 export type TopBarVariant = (typeof TOPBAR_VARIANTS)[number];
 /**
@@ -34,7 +35,15 @@ export interface TopBarItem {
 export interface QwTopBarProps {
     /** 结构形式（必填）。 */
     variant: TopBarVariant;
-    /** 标题名称（basic 专用）。 */
+    /** navigation 模式：是否显示默认返回按钮，默认 true。 */
+    back?: boolean;
+    /** navigation 模式：返回文字。 */
+    backText?: string;
+    /** navigation 模式：标题下的补充信息。 */
+    subtitle?: string;
+    /** navigation 模式：顶部安全区，默认 true；面板模式不消费。 */
+    safeAreaTop?: boolean;
+    /** 标题名称（basic / navigation）。 */
     title?: string;
     /** Tab 切换模式的数据项。 */
     items?: TopBarItem[];
@@ -84,3 +93,5 @@ export interface ResolvedTopBarProps {
  * 不进 machine（原型 A）。纯函数，SSR-safe。
  */
 export declare function createTopBarProps(props: QwTopBarProps): ResolvedTopBarProps;
+/** Page navigation delegates its behavior and defaults to the NavBar contract. */
+export declare function createTopBarNavigationProps(props: QwTopBarProps): QwNavBarProps;

package/dist/tree-select/index.d.ts

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