@neut/ui 0.0.15 → 0.0.16

package/dist/components/context-menu/context-menu.context.js

@@ -0,0 +1,25 @@
+import { createContext as e, useContext as t } from "solid-js";
+//#region src/components/context-menu/context-menu.context.ts
+var n = e();
+function r(e) {
+	let r = t(n);
+	if (!r) throw Error(`<${e}> 必须渲染在 <ContextMenuContent> 内部`);
+	return r;
+}
+var i = e();
+function a(e) {
+	let n = t(i);
+	if (!n) throw Error(`<${e}> 必须渲染在 <ContextMenuSub> 内部`);
+	return n;
+}
+var o = e();
+function s(e) {
+	let n = t(o);
+	if (!n) throw Error(`<${e}> 必须渲染在 <ContextMenuRadioGroup> 内部`);
+	return n;
+}
+var c = e();
+//#endregion
+export { c as ContextMenuGroupContext, n as ContextMenuPopupContext, o as ContextMenuRadioGroupContext, i as ContextMenuSubmenuContext, r as useContextMenuPopup, s as useContextMenuRadioGroup, a as useContextMenuSubmenu };
+
+//# sourceMappingURL=context-menu.context.js.map

package/dist/components/context-menu/context-menu.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.context.js","names":["ContextMenuPopupContext","createContext","useContextMenuPopup","ctx","useContext","component","ContextMenuSubmenuContext","useContextMenuSubmenu","ContextMenuRadioGroupContext","useContextMenuRadioGroup","ContextMenuGroupContext"],"sources":["../../../src/components/context-menu/context-menu.context.ts"],"sourcesContent":["import { createContext, useContext } from \"solid-js\";\nimport type {\n  ContextMenuGroupContextValue,\n  ContextMenuPopupContextValue,\n  ContextMenuRadioGroupContextValue,\n  ContextMenuSubmenuContextValue,\n} from \"./context-menu.types\";\n\n/**\n * 内部运行时 context。与 `ContextMenu/ContextMenu.context.ts`(根状态)分开:\n * 根 context 由公开的 `<ContextMenu>` 提供,这里几个由各个浮层/分组组件提供,\n * 属于实现细节,不对外导出。\n */\n\nexport const ContextMenuPopupContext =\n  createContext<ContextMenuPopupContextValue>();\n\nexport function useContextMenuPopup(\n  component: string,\n): ContextMenuPopupContextValue {\n  const ctx = useContext(ContextMenuPopupContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <ContextMenuContent> 内部`);\n  }\n  return ctx;\n}\n\nexport const ContextMenuSubmenuContext =\n  createContext<ContextMenuSubmenuContextValue>();\n\nexport function useContextMenuSubmenu(\n  component: string,\n): ContextMenuSubmenuContextValue {\n  const ctx = useContext(ContextMenuSubmenuContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <ContextMenuSub> 内部`);\n  }\n  return ctx;\n}\n\nexport const ContextMenuRadioGroupContext =\n  createContext<ContextMenuRadioGroupContextValue>();\n\nexport function useContextMenuRadioGroup(\n  component: string,\n): ContextMenuRadioGroupContextValue {\n  const ctx = useContext(ContextMenuRadioGroupContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <ContextMenuRadioGroup> 内部`);\n  }\n  return ctx;\n}\n\nexport const ContextMenuGroupContext =\n  createContext<ContextMenuGroupContextValue>();\n\nexport function useContextMenuGroup(\n  component: string,\n): ContextMenuGroupContextValue {\n  const ctx = useContext(ContextMenuGroupContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <ContextMenuGroup> 内部`);\n  }\n  return ctx;\n}\n"],"mappings":";;AAcA,IAAaA,IACXC,EAA4C;AAE9C,SAAgBC,EACd,GAC8B;CAC9B,IAAMC,IAAMC,EAAWJ,CAAuB;CAC9C,IAAI,CAACG,GACH,MAAU,MAAM,IAAIE,EAAU,gCAAgC;CAEhE,OAAOF;AACT;AAEA,IAAaG,IACXL,EAA8C;AAEhD,SAAgBM,EACd,GACgC;CAChC,IAAMJ,IAAMC,EAAWE,CAAyB;CAChD,IAAI,CAACH,GACH,MAAU,MAAM,IAAIE,EAAU,4BAA4B;CAE5D,OAAOF;AACT;AAEA,IAAaK,IACXP,EAAiD;AAEnD,SAAgBQ,EACd,GACmC;CACnC,IAAMN,IAAMC,EAAWI,CAA4B;CACnD,IAAI,CAACL,GACH,MAAU,MAAM,IAAIE,EAAU,mCAAmC;CAEnE,OAAOF;AACT;AAEA,IAAaO,IACXT,EAA4C"}

package/dist/components/context-menu/context-menu.entry.d.ts

@@ -0,0 +1,28 @@
+import { ContextMenuChangeEventReason, ContextMenuPopupContextValue } from './context-menu.types';
+export interface UseContextMenuEntryOptions {
+    /** 用于报错信息里指明是哪个组件 */
+    component: string;
+    /** 菜单项的真实 DOM 元素 */
+    element: () => HTMLElement | undefined;
+    disabled: () => boolean;
+    /** 键盘字符导航用的文本;缺省时回退到元素的 textContent */
+    label: () => string | undefined;
+    hasPopup?: () => boolean;
+    /** 键盘 Enter/Space 激活:默认触发一次 click,复用同一条 onClick 逻辑 */
+    activate?: () => void;
+    openPopup?: (reason: ContextMenuChangeEventReason, event?: Event) => void;
+}
+export interface UseContextMenuEntryResult {
+    popup: ContextMenuPopupContextValue;
+    /** 稳定的 DOM id,直接用于 id / aria-activedescendant */
+    id: string;
+    isActive: () => boolean;
+    /** 鼠标进入时高亮(受 highlightItemOnHover 控制) */
+    highlight: () => void;
+}
+/**
+ * 菜单项(Item / CheckboxItem / RadioItem / SubmenuTrigger)共用的注册与高亮逻辑。
+ * 每个项在挂载时把自己登记到所属浮层,卸载时注销,键盘导航与 typeahead 都基于
+ * 这份注册表。
+ */
+export declare function useContextMenuEntry(options: UseContextMenuEntryOptions): UseContextMenuEntryResult;

package/dist/components/context-menu/context-menu.entry.js

@@ -0,0 +1,31 @@
+import { useContextMenuPopup as e } from "./context-menu.context.js";
+import { createUniqueId as t, onCleanup as n, onMount as r } from "solid-js";
+//#region src/components/context-menu/context-menu.entry.ts
+function i(i) {
+	let a = e(i.component), o = `context-menu-item-${t()}`;
+	return r(() => {
+		let e = i.element();
+		if (!e) return;
+		let t = {
+			id: o,
+			element: e,
+			disabled: i.disabled,
+			label: () => i.label() ?? e.textContent?.trim() ?? "",
+			hasPopup: i.hasPopup ?? (() => !1),
+			activate: i.activate ?? (() => e.click()),
+			openPopup: i.openPopup
+		}, r = a.registerItem(t);
+		n(r);
+	}), {
+		popup: a,
+		id: o,
+		isActive: () => a.activeId() === o,
+		highlight: () => {
+			a.highlightItemOnHover() && !i.disabled() && a.highlight(o);
+		}
+	};
+}
+//#endregion
+export { i as useContextMenuEntry };
+
+//# sourceMappingURL=context-menu.entry.js.map

package/dist/components/context-menu/context-menu.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.entry.js","names":["useContextMenuEntry","popup","useContextMenuPopup","options","id","createUniqueId","onMount","element","entry","unregister"],"sources":["../../../src/components/context-menu/context-menu.entry.ts"],"sourcesContent":["import { createUniqueId, onCleanup, onMount } from \"solid-js\";\nimport { useContextMenuPopup } from \"./context-menu.context\";\nimport type {\n  ContextMenuChangeEventReason,\n  ContextMenuItemEntry,\n  ContextMenuPopupContextValue,\n} from \"./context-menu.types\";\n\nexport interface UseContextMenuEntryOptions {\n  /** 用于报错信息里指明是哪个组件 */\n  component: string;\n  /** 菜单项的真实 DOM 元素 */\n  element: () => HTMLElement | undefined;\n  disabled: () => boolean;\n  /** 键盘字符导航用的文本;缺省时回退到元素的 textContent */\n  label: () => string | undefined;\n  hasPopup?: () => boolean;\n  /** 键盘 Enter/Space 激活:默认触发一次 click,复用同一条 onClick 逻辑 */\n  activate?: () => void;\n  openPopup?: (reason: ContextMenuChangeEventReason, event?: Event) => void;\n}\n\nexport interface UseContextMenuEntryResult {\n  popup: ContextMenuPopupContextValue;\n  /** 稳定的 DOM id,直接用于 id / aria-activedescendant */\n  id: string;\n  isActive: () => boolean;\n  /** 鼠标进入时高亮(受 highlightItemOnHover 控制) */\n  highlight: () => void;\n}\n\n/**\n * 菜单项(Item / CheckboxItem / RadioItem / SubmenuTrigger)共用的注册与高亮逻辑。\n * 每个项在挂载时把自己登记到所属浮层,卸载时注销,键盘导航与 typeahead 都基于\n * 这份注册表。\n */\nexport function useContextMenuEntry(\n  options: UseContextMenuEntryOptions,\n): UseContextMenuEntryResult {\n  const popup = useContextMenuPopup(options.component);\n  const id = `context-menu-item-${createUniqueId()}`;\n\n  onMount(() => {\n    const element = options.element();\n    if (!element) return;\n\n    const entry: ContextMenuItemEntry = {\n      id,\n      element,\n      disabled: options.disabled,\n      label: () => options.label() ?? element.textContent?.trim() ?? \"\",\n      hasPopup: options.hasPopup ?? (() => false),\n      activate: options.activate ?? (() => element.click()),\n      openPopup: options.openPopup,\n    };\n\n    const unregister = popup.registerItem(entry);\n    onCleanup(unregister);\n  });\n\n  return {\n    popup,\n    id,\n    isActive: () => popup.activeId() === id,\n    highlight: () => {\n      if (!popup.highlightItemOnHover() || options.disabled()) return;\n      popup.highlight(id);\n    },\n  };\n}\n"],"mappings":";;;AAoCA,SAAgBA,EACd,GAC2B;CAC3B,IAAMC,IAAQC,EAAoBC,EAAQ,SAAS,GAC7CC,IAAK,qBAAqBC,EAAe;CAoB/C,OAlBAC,QAAc;EACZ,IAAMC,IAAUJ,EAAQ,QAAQ;EAChC,IAAI,CAACI,GAAS;EAEd,IAAMC,IAA8B;GAClC;GACA;GACA,UAAUL,EAAQ;GAClB,aAAaA,EAAQ,MAAM,KAAKI,EAAQ,aAAa,KAAK,KAAK;GAC/D,UAAUJ,EAAQ,mBAAmB;GACrC,UAAUA,EAAQ,mBAAmBI,EAAQ,MAAM;GACnD,WAAWJ,EAAQ;EACrB,GAEMM,IAAaR,EAAM,aAAaO,CAAK;EAC3C,EAAUC,CAAU;CACtB,CAAC,GAEM;EACL;EACA;EACA,gBAAgBR,EAAM,SAAS,MAAMG;EACrC,iBAAiB;GACf,AAAKH,EAAM,qBAAqB,KAAK,GAAQ,SAAS,KACtDA,EAAM,UAAUG,CAAE;EACpB;CACF;AACF"}

package/dist/components/context-menu/context-menu.styles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 各子组件的类名常量。直接对齐 shadcn base 版 `context-menu.tsx`,
+ * 唯一的系统性改动是把 `focus:` 系列变体换成 `data-highlighted:`
+ * ——本实现的焦点始终在 popup 上,高亮项通过 `aria-activedescendant` +
+ * `data-highlighted` 表达,而不是真实聚焦到每一项。
+ */
+/** 普通菜单项 */
+export declare const contextMenuItemClass = "group/context-menu-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/20 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-highlighted:*:[svg]:text-accent-foreground data-[variant=destructive]:*:[svg]:text-destructive";
+/** 子菜单触发器(带一个自带的 ChevronRight 图标) */
+export declare const contextMenuSubTriggerClass = "flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4";
+/** 可勾选项(CheckboxItem / RadioItem 共用),右侧预留指示器位置 */
+export declare const contextMenuCheckableItemClass = "relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground";
+/** GroupLabel */
+export declare const contextMenuLabelClass = "px-2 py-1.5 text-xs font-medium text-muted-foreground data-inset:pl-8";
+/** 快捷键提示 */
+export declare const contextMenuShortcutClass = "ml-auto text-xs tracking-widest text-muted-foreground group-data-[highlighted]/context-menu-item:text-accent-foreground";
+/** 勾选/单选指示器的定位容器 */
+export declare const contextMenuIndicatorClass = "pointer-events-none absolute right-2 flex items-center justify-center";

package/dist/components/context-menu/context-menu.styles.js

@@ -0,0 +1,6 @@
+//#region src/components/context-menu/context-menu.styles.ts
+var e = "group/context-menu-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/20 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-highlighted:*:[svg]:text-accent-foreground data-[variant=destructive]:*:[svg]:text-destructive", t = "flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", n = "relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground", r = "px-2 py-1.5 text-xs font-medium text-muted-foreground data-inset:pl-8", i = "ml-auto text-xs tracking-widest text-muted-foreground group-data-[highlighted]/context-menu-item:text-accent-foreground", a = "pointer-events-none absolute right-2 flex items-center justify-center";
+//#endregion
+export { n as contextMenuCheckableItemClass, a as contextMenuIndicatorClass, e as contextMenuItemClass, r as contextMenuLabelClass, i as contextMenuShortcutClass, t as contextMenuSubTriggerClass };
+
+//# sourceMappingURL=context-menu.styles.js.map

package/dist/components/context-menu/context-menu.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.styles.js","names":["contextMenuItemClass","contextMenuSubTriggerClass","contextMenuCheckableItemClass","contextMenuLabelClass","contextMenuShortcutClass","contextMenuIndicatorClass"],"sources":["../../../src/components/context-menu/context-menu.styles.ts"],"sourcesContent":["/**\n * 各子组件的类名常量。直接对齐 shadcn base 版 `context-menu.tsx`,\n * 唯一的系统性改动是把 `focus:` 系列变体换成 `data-highlighted:`\n * ——本实现的焦点始终在 popup 上,高亮项通过 `aria-activedescendant` +\n * `data-highlighted` 表达,而不是真实聚焦到每一项。\n */\n\n/** 普通菜单项 */\nexport const contextMenuItemClass =\n  \"group/context-menu-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/20 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-highlighted:*:[svg]:text-accent-foreground data-[variant=destructive]:*:[svg]:text-destructive\";\n\n/** 子菜单触发器(带一个自带的 ChevronRight 图标) */\nexport const contextMenuSubTriggerClass =\n  \"flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\";\n\n/** 可勾选项(CheckboxItem / RadioItem 共用),右侧预留指示器位置 */\nexport const contextMenuCheckableItemClass =\n  \"relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-hidden select-none data-inset:pl-8 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-highlighted:bg-accent data-highlighted:text-accent-foreground\";\n\n/** GroupLabel */\nexport const contextMenuLabelClass =\n  \"px-2 py-1.5 text-xs font-medium text-muted-foreground data-inset:pl-8\";\n\n/** 快捷键提示 */\nexport const contextMenuShortcutClass =\n  \"ml-auto text-xs tracking-widest text-muted-foreground group-data-[highlighted]/context-menu-item:text-accent-foreground\";\n\n/** 勾选/单选指示器的定位容器 */\nexport const contextMenuIndicatorClass =\n  \"pointer-events-none absolute right-2 flex items-center justify-center\";\n"],"mappings":";AAQA,IAAaA,IACX,mrBAGWC,IACX,mXAGWC,IACX,kVAGWC,IACX,yEAGWC,IACX,2HAGWC,IACX"}

package/dist/components/context-menu/context-menu.types.d.ts

@@ -0,0 +1,151 @@
+import { Accessor } from 'solid-js';
+import { ReferenceElement, VirtualElement } from '../../lib';
+/**
+ * Base UI 的 `Side`,额外支持逻辑方向 `inline-start` / `inline-end`。
+ * 逻辑方向会按 `dir` 解析成 left / right(RTL 下相反)。
+ */
+export type ContextMenuSide = "top" | "right" | "bottom" | "left" | "inline-start" | "inline-end";
+/** Base UI 的 `Align` */
+export type ContextMenuAlign = "start" | "center" | "end";
+/** Base UI 菜单的排列方向,决定方向键映射(默认 vertical) */
+export type ContextMenuOrientation = "vertical" | "horizontal";
+/**
+ * 对齐 Base UI 的 `ContextMenu.Root.ChangeEventReason`。
+ * 本实现会尽力给出语义正确的原因,部分原因(如 `trigger-hover`)只在子菜单里出现。
+ */
+export type ContextMenuChangeEventReason = "trigger-hover" | "trigger-focus" | "trigger-press" | "outside-press" | "focus-out" | "list-navigation" | "escape-key" | "item-press" | "close-press" | "sibling-open" | "cancel-open" | "imperative-action" | "none";
+/**
+ * 对齐 Base UI 的 `ChangeEventDetails`。`cancel()` / `allowPropagation()` 用于在
+ * 回调里干预组件的默认行为;Solid 下事件已派发,`allowPropagation` 只作为 API
+ * 对齐保留(本实现不主动阻止事件传播)。
+ */
+export interface ContextMenuChangeEventDetails<R extends string = ContextMenuChangeEventReason> {
+    reason: R;
+    event: Event | undefined;
+    trigger: Element | undefined;
+    /** 阻止组件处理本次变更(例如受控模式下不关闭) */
+    cancel: () => void;
+    /** API 对齐保留:允许事件继续传播 */
+    allowPropagation: () => void;
+    readonly isCanceled: boolean;
+    readonly isPropagationAllowed: boolean;
+}
+/** 一个已挂载菜单项在运行时的元信息,供键盘导航 / 无障碍 / 子菜单联动使用 */
+export interface ContextMenuItemEntry {
+    /** 稳定的 DOM id,同时用作 `aria-activedescendant` 的取值 */
+    id: string;
+    element: HTMLElement;
+    disabled: () => boolean;
+    /** 键盘字符导航时用于匹配的文本 */
+    label: () => string;
+    /** 是否是"打开子菜单"的项 */
+    hasPopup: () => boolean;
+    /** 键盘 Enter/Space 或点击时触发 */
+    activate: () => void;
+    /** 仅子菜单触发器:打开对应的子菜单 */
+    openPopup?: (reason: ContextMenuChangeEventReason, event?: Event) => void;
+}
+/** 根组件通过 context 暴露的状态与动作 */
+export interface ContextMenuContextValue {
+    open: Accessor<boolean>;
+    disabled: Accessor<boolean>;
+    loopFocus: Accessor<boolean>;
+    orientation: Accessor<ContextMenuOrientation>;
+    highlightItemOnHover: Accessor<boolean>;
+    /** 触发器元素,关闭时把焦点还给它 */
+    trigger: Accessor<HTMLElement | undefined>;
+    setTrigger: (el: HTMLElement | undefined) => void;
+    /** 右键菜单的虚拟锚点(鼠标坐标) */
+    anchor: Accessor<VirtualElement | undefined>;
+    contentId: string;
+    /** 关闭后是否把焦点还给触发器(Base UI Popup.finalFocus 的布尔子集) */
+    finalFocus: Accessor<boolean>;
+    setFinalFocus: (value: boolean) => void;
+    /** 在指定坐标打开(已打开时仅更新锚点) */
+    openAt: (x: number, y: number, contextElement: Element | undefined, event?: Event, reason?: ContextMenuChangeEventReason) => void;
+    /** 关闭整个菜单树 */
+    closeAll: (reason: ContextMenuChangeEventReason, event?: Event) => void;
+    /** 注册浮层容器元素(用于判断"点击是否发生在菜单内部") */
+    registerMenuElement: (el: HTMLElement) => () => void;
+    isInsideMenu: (node: Node | null) => boolean;
+}
+/** 每个浮层(根菜单 / 子菜单)各自维护的运行时上下文 */
+export interface ContextMenuPopupContextValue {
+    root: ContextMenuContextValue;
+    /** 父级浮层;根菜单为 undefined */
+    parent: ContextMenuPopupContextValue | undefined;
+    /** 该浮层所属的子菜单上下文;根菜单为 undefined */
+    submenu?: ContextMenuSubmenuContextValue;
+    menuId: string;
+    isSubmenu: boolean;
+    /** 真正承载焦点的 popup 元素 */
+    popup: Accessor<HTMLElement | undefined>;
+    setPopup: (el: HTMLElement | undefined) => void;
+    /** 以 DOM 顺序排列的已注册菜单项 */
+    items: Accessor<ContextMenuItemEntry[]>;
+    registerItem: (entry: ContextMenuItemEntry) => () => void;
+    activeId: Accessor<string | undefined>;
+    setActiveId: (id: string | undefined) => void;
+    activeEntry: () => ContextMenuItemEntry | undefined;
+    moveActive: (delta: 1 | -1) => void;
+    focusFirst: () => void;
+    focusLast: () => void;
+    /** 高亮指定项,并关闭其它项已打开的子菜单 */
+    highlight: (id: string | undefined) => void;
+    /** 当前由本浮层打开的二级菜单对应的项 id */
+    openPopupState: Accessor<ContextMenuOpenPopupState | undefined>;
+    openPopup: (id: string, reason: ContextMenuChangeEventReason, event?: Event) => void;
+    closeOpenPopup: () => void;
+    closeAll: (reason: ContextMenuChangeEventReason, event?: Event) => void;
+    highlightItemOnHover: Accessor<boolean>;
+}
+export interface ContextMenuOpenPopupState {
+    id: string;
+    reason: ContextMenuChangeEventReason;
+    event: Event | undefined;
+}
+/** 子菜单根组件提供的上下文 */
+export interface ContextMenuSubmenuContextValue {
+    root: ContextMenuContextValue;
+    /** 子菜单触发器所属的父浮层 */
+    parentPopup: ContextMenuPopupContextValue;
+    open: Accessor<boolean>;
+    setOpen: (open: boolean, reason: ContextMenuChangeEventReason, event?: Event) => void;
+    disabled: Accessor<boolean>;
+    closeParentOnEsc: Accessor<boolean>;
+    loopFocus: Accessor<boolean>;
+    orientation: Accessor<ContextMenuOrientation>;
+    highlightItemOnHover: Accessor<boolean>;
+    /** 子菜单触发器元素(同时是子菜单的定位锚点) */
+    trigger: Accessor<HTMLElement | undefined>;
+    setTrigger: (el: HTMLElement | undefined) => void;
+    /** 子菜单触发器在父浮层里注册的项 id */
+    itemId: Accessor<string | undefined>;
+    setItemId: (id: string | undefined) => void;
+    openSubmenu: (reason: ContextMenuChangeEventReason, event?: Event) => void;
+    closeSubmenu: (reason: ContextMenuChangeEventReason, event?: Event, focusTrigger?: boolean) => void;
+    /** 鼠标移出后延迟关闭(带防抖,避免穿越间隙时闪烁) */
+    scheduleClose: (delay?: number) => void;
+    cancelClose: () => void;
+}
+/** RadioGroup 共享给 RadioItem 的选中状态 */
+export interface ContextMenuRadioGroupContextValue {
+    value: Accessor<any>;
+    setValue: (value: any, event?: Event) => void;
+    disabled: Accessor<boolean>;
+}
+/** Group 与 GroupLabel 通过 id 建立 aria 关联 */
+export interface ContextMenuGroupContextValue {
+    labelId: Accessor<string | undefined>;
+    setLabelId: (id: string | undefined) => void;
+}
+/** Popup 定位所需的最小配置 */
+export interface ContextMenuPositioningOptions {
+    reference: Accessor<ReferenceElement | undefined>;
+    side: Accessor<ContextMenuSide>;
+    align: Accessor<ContextMenuAlign>;
+    sideOffset: Accessor<number>;
+    alignOffset: Accessor<number>;
+    collisionPadding: Accessor<number>;
+    dir: Accessor<"ltr" | "rtl" | "auto" | undefined>;
+}

package/dist/components/context-menu/context-menu.utils.d.ts

@@ -0,0 +1,28 @@
+import { Placement } from '../../lib';
+import { ContextMenuAlign, ContextMenuChangeEventDetails, ContextMenuChangeEventReason, ContextMenuSide, ContextMenuSubmenuContextValue } from './context-menu.types';
+type Dir = "ltr" | "rtl" | "auto" | undefined;
+/**
+ * 把 Base UI 风格的 `side` + `align` 拆成核心定位库统一的 `Placement`。
+ * `align="center"` 时不带后缀(即居中)。
+ */
+export declare function toContextMenuPlacement(side: ContextMenuSide, align: ContextMenuAlign, dir: Dir): Placement;
+/**
+ * 根据最终生效的 placement 计算动画缩放原点(贴在锚点上的那个角)。
+ * 逻辑与 Popover/Tooltip 保持一致。
+ */
+export declare function getContextMenuTransformOrigin(placement: Placement): string;
+/**
+ * 计算写回 DOM 的 `data-side`。若用户传入的是逻辑方向且最终没有翻转到另一侧,
+ * 依旧回写逻辑值,这样 shadcn 的 `data-[side=inline-end]:...` 样式才能命中。
+ */
+export declare function resolveContextMenuDataSide(requested: ContextMenuSide, placement: Placement, dir: Dir): ContextMenuSide;
+/** 生成对齐 Base UI 的 ChangeEventDetails */
+export declare function createChangeEventDetails<R extends string = ContextMenuChangeEventReason>(reason: R, event?: Event, trigger?: Element): ContextMenuChangeEventDetails<R>;
+/**
+ * 沿父链取消所有祖先子菜单已排期的关闭。
+ * 多级菜单里,鼠标从父级内容移到子级内容时,父级内容的 pointerleave 会给父级
+ * 排一个延迟关闭;子级内容的 pointerenter 必须把祖先的定时器一并取消,
+ * 否则父级会在 grace 后关闭,连带整棵菜单树消失。
+ */
+export declare function cancelSubmenuCloseChain(submenu: ContextMenuSubmenuContextValue | undefined): void;
+export {};

package/dist/components/context-menu/context-menu.utils.js

@@ -0,0 +1,51 @@
+import { getAlignment as e, getSide as t } from "../../lib/positioner/core/placement.js";
+//#region src/components/context-menu/context-menu.utils.ts
+function n(e, t) {
+	let n = t === "rtl";
+	return e === "inline-start" ? n ? "right" : "left" : e === "inline-end" ? n ? "left" : "right" : e;
+}
+function r(e, t, r) {
+	let i = n(e, r);
+	return t === "center" ? i : `${i}-${t}`;
+}
+function i(n) {
+	let r = t(n), i = e(n), a = i === "start" ? "0%" : i === "end" ? "100%" : "50%";
+	switch (r) {
+		case "top": return `${a} 100%`;
+		case "bottom": return `${a} 0%`;
+		case "left": return `100% ${a}`;
+		case "right": return `0% ${a}`;
+	}
+}
+function a(e, r, i) {
+	let a = t(r);
+	return (e === "inline-start" || e === "inline-end") && n(e, i) === a ? e : a;
+}
+function o(e, t, n) {
+	let r = !1, i = !1;
+	return {
+		reason: e,
+		event: t,
+		trigger: n,
+		cancel: () => {
+			r = !0;
+		},
+		allowPropagation: () => {
+			i = !0;
+		},
+		get isCanceled() {
+			return r;
+		},
+		get isPropagationAllowed() {
+			return i;
+		}
+	};
+}
+function s(e) {
+	let t = e;
+	for (; t;) t.cancelClose(), t = t.parentPopup.submenu;
+}
+//#endregion
+export { s as cancelSubmenuCloseChain, o as createChangeEventDetails, i as getContextMenuTransformOrigin, a as resolveContextMenuDataSide, r as toContextMenuPlacement };
+
+//# sourceMappingURL=context-menu.utils.js.map

package/dist/components/context-menu/context-menu.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.utils.js","names":["resolveLogicalSide","rtl","dir","side","toContextMenuPlacement","physical","align","getContextMenuTransformOrigin","getSide","placement","getAlignment","crossAxisOrigin","resolveContextMenuDataSide","actual","requested","createChangeEventDetails","canceled","propagationAllowed","cancelSubmenuCloseChain","current","submenu"],"sources":["../../../src/components/context-menu/context-menu.utils.ts"],"sourcesContent":["import { getAlignment, getSide, type Placement, type Side } from \"~/lib\";\nimport type {\n  ContextMenuAlign,\n  ContextMenuChangeEventDetails,\n  ContextMenuChangeEventReason,\n  ContextMenuSide,\n  ContextMenuSubmenuContextValue,\n} from \"./context-menu.types\";\n\ntype Dir = \"ltr\" | \"rtl\" | \"auto\" | undefined;\n\n/** 逻辑方向 -> 物理方向(LTR 下 inline-start=left,inline-end=right;RTL 相反) */\nfunction resolveLogicalSide(side: ContextMenuSide, dir: Dir): Side {\n  const rtl = dir === \"rtl\";\n  if (side === \"inline-start\") return rtl ? \"right\" : \"left\";\n  if (side === \"inline-end\") return rtl ? \"left\" : \"right\";\n  return side;\n}\n\n/**\n * 把 Base UI 风格的 `side` + `align` 拆成核心定位库统一的 `Placement`。\n * `align=\"center\"` 时不带后缀(即居中)。\n */\nexport function toContextMenuPlacement(\n  side: ContextMenuSide,\n  align: ContextMenuAlign,\n  dir: Dir,\n): Placement {\n  const physical = resolveLogicalSide(side, dir);\n  return align === \"center\" ? physical : (`${physical}-${align}` as Placement);\n}\n\n/**\n * 根据最终生效的 placement 计算动画缩放原点(贴在锚点上的那个角)。\n * 逻辑与 Popover/Tooltip 保持一致。\n */\nexport function getContextMenuTransformOrigin(placement: Placement): string {\n  const side = getSide(placement);\n  const align = getAlignment(placement);\n  const crossAxisOrigin =\n    align === \"start\" ? \"0%\" : align === \"end\" ? \"100%\" : \"50%\";\n\n  switch (side) {\n    case \"top\":\n      return `${crossAxisOrigin} 100%`;\n    case \"bottom\":\n      return `${crossAxisOrigin} 0%`;\n    case \"left\":\n      return `100% ${crossAxisOrigin}`;\n    case \"right\":\n      return `0% ${crossAxisOrigin}`;\n  }\n}\n\n/**\n * 计算写回 DOM 的 `data-side`。若用户传入的是逻辑方向且最终没有翻转到另一侧,\n * 依旧回写逻辑值,这样 shadcn 的 `data-[side=inline-end]:...` 样式才能命中。\n */\nexport function resolveContextMenuDataSide(\n  requested: ContextMenuSide,\n  placement: Placement,\n  dir: Dir,\n): ContextMenuSide {\n  const actual = getSide(placement);\n  if (requested === \"inline-start\" || requested === \"inline-end\") {\n    const expected = resolveLogicalSide(requested, dir);\n    if (expected === actual) return requested;\n  }\n  return actual;\n}\n\n/** 生成对齐 Base UI 的 ChangeEventDetails */\nexport function createChangeEventDetails<\n  R extends string = ContextMenuChangeEventReason,\n>(\n  reason: R,\n  event?: Event,\n  trigger?: Element,\n): ContextMenuChangeEventDetails<R> {\n  let canceled = false;\n  let propagationAllowed = false;\n\n  return {\n    reason,\n    event,\n    trigger,\n    cancel: () => {\n      canceled = true;\n    },\n    allowPropagation: () => {\n      propagationAllowed = true;\n    },\n    get isCanceled() {\n      return canceled;\n    },\n    get isPropagationAllowed() {\n      return propagationAllowed;\n    },\n  };\n}\n\n/**\n * 沿父链取消所有祖先子菜单已排期的关闭。\n * 多级菜单里,鼠标从父级内容移到子级内容时,父级内容的 pointerleave 会给父级\n * 排一个延迟关闭;子级内容的 pointerenter 必须把祖先的定时器一并取消,\n * 否则父级会在 grace 后关闭,连带整棵菜单树消失。\n */\nexport function cancelSubmenuCloseChain(\n  submenu: ContextMenuSubmenuContextValue | undefined,\n): void {\n  let current = submenu;\n  while (current) {\n    current.cancelClose();\n    current = current.parentPopup.submenu;\n  }\n}\n"],"mappings":";;AAYA,SAASA,EAAmB,GAAuB,GAAgB;CACjE,IAAMC,IAAMC,MAAQ;CAGpB,OAFIC,MAAS,iBAAuBF,IAAM,UAAU,SAChDE,MAAS,eAAqBF,IAAM,SAAS,UAC1CE;AACT;AAMA,SAAgBC,EACd,GACA,GACA,GACW;CACX,IAAMC,IAAWL,EAAmBG,GAAMD,CAAG;CAC7C,OAAOI,MAAU,WAAWD,IAAY,GAAGA,EAAS,GAAGC;AACzD;AAMA,SAAgBC,EAA8B,GAA8B;CAC1E,IAAMJ,IAAOK,EAAQC,CAAS,GACxBH,IAAQI,EAAaD,CAAS,GAC9BE,IACJL,MAAU,UAAU,OAAOA,MAAU,QAAQ,SAAS;CAExD,QAAQH,GAAR;EACE,KAAK,OACH,OAAO,GAAGQ,EAAgB;EAC5B,KAAK,UACH,OAAO,GAAGA,EAAgB;EAC5B,KAAK,QACH,OAAO,QAAQA;EACjB,KAAK,SACH,OAAO,MAAMA;CACjB;AACF;AAMA,SAAgBC,EACd,GACA,GACA,GACiB;CACjB,IAAMC,IAASL,EAAQC,CAAS;CAKhC,QAJIK,MAAc,kBAAkBA,MAAc,iBAC/Bd,EAAmBc,GAAWZ,CAC3C,MAAaW,IAAeC,IAE3BD;AACT;AAGA,SAAgBE,EAGd,GACA,GACA,GACkC;CAClC,IAAIC,IAAW,IACXC,IAAqB;CAEzB,OAAO;EACL;EACA;EACA;EACA,cAAc;GACZ,IAAW;EACb;EACA,wBAAwB;GACtB,IAAqB;EACvB;EACA,IAAI,aAAa;GACf,OAAOD;EACT;EACA,IAAI,uBAAuB;GACzB,OAAOC;EACT;CACF;AACF;AAQA,SAAgBC,EACd,GACM;CACN,IAAIC,IAAUC;CACd,OAAOD,IAEL,AADAA,EAAQ,YAAY,GACpB,IAAUA,EAAQ,YAAY;AAElC"}

package/dist/components/context-menu/index.d.ts

@@ -0,0 +1,31 @@
+export { ContextMenu } from './ContextMenu';
+export type { ContextMenuProps } from './ContextMenu';
+export { ContextMenuTrigger } from './ContextMenuTrigger';
+export type { ContextMenuTriggerProps } from './ContextMenuTrigger';
+export { ContextMenuPortal } from './ContextMenuPortal';
+export type { ContextMenuPortalProps } from './ContextMenuPortal';
+export { ContextMenuContent } from './ContextMenuContent';
+export type { ContextMenuContentProps } from './ContextMenuContent';
+export { ContextMenuItem } from './ContextMenuItem';
+export type { ContextMenuItemProps, ContextMenuItemVariant, } from './ContextMenuItem';
+export { ContextMenuCheckboxItem } from './ContextMenuCheckboxItem';
+export type { ContextMenuCheckboxItemProps } from './ContextMenuCheckboxItem';
+export { ContextMenuRadioGroup } from './ContextMenuRadioGroup';
+export type { ContextMenuRadioGroupProps } from './ContextMenuRadioGroup';
+export { ContextMenuRadioItem } from './ContextMenuRadioItem';
+export type { ContextMenuRadioItemProps } from './ContextMenuRadioItem';
+export { ContextMenuGroup } from './ContextMenuGroup';
+export type { ContextMenuGroupProps } from './ContextMenuGroup';
+export { ContextMenuLabel } from './ContextMenuLabel';
+export type { ContextMenuLabelProps } from './ContextMenuLabel';
+export { ContextMenuSeparator } from './ContextMenuSeparator';
+export type { ContextMenuSeparatorProps } from './ContextMenuSeparator';
+export { ContextMenuShortcut } from './ContextMenuShortcut';
+export type { ContextMenuShortcutProps } from './ContextMenuShortcut';
+export { ContextMenuSub } from './ContextMenuSub';
+export type { ContextMenuSubProps } from './ContextMenuSub';
+export { ContextMenuSubTrigger } from './ContextMenuSubTrigger';
+export type { ContextMenuSubTriggerProps } from './ContextMenuSubTrigger';
+export { ContextMenuSubContent } from './ContextMenuSubContent';
+export type { ContextMenuSubContentProps } from './ContextMenuSubContent';
+export type { ContextMenuSide, ContextMenuAlign, ContextMenuOrientation, ContextMenuChangeEventReason, ContextMenuChangeEventDetails, } from './context-menu.types';

package/dist/components/context-menu/index.js

@@ -0,0 +1,16 @@
+import { ContextMenu as e } from "./ContextMenu/ContextMenu.js";
+import { ContextMenuTrigger as t } from "./ContextMenuTrigger/ContextMenuTrigger.js";
+import { ContextMenuPortal as n } from "./ContextMenuPortal/ContextMenuPortal.js";
+import { ContextMenuContent as r } from "./ContextMenuContent/ContextMenuContent.js";
+import { ContextMenuItem as i } from "./ContextMenuItem/ContextMenuItem.js";
+import { ContextMenuCheckboxItem as a } from "./ContextMenuCheckboxItem/ContextMenuCheckboxItem.js";
+import { ContextMenuRadioGroup as o } from "./ContextMenuRadioGroup/ContextMenuRadioGroup.js";
+import { ContextMenuRadioItem as s } from "./ContextMenuRadioItem/ContextMenuRadioItem.js";
+import { ContextMenuGroup as c } from "./ContextMenuGroup/ContextMenuGroup.js";
+import { ContextMenuLabel as l } from "./ContextMenuLabel/ContextMenuLabel.js";
+import { ContextMenuSeparator as u } from "./ContextMenuSeparator/ContextMenuSeparator.js";
+import { ContextMenuShortcut as d } from "./ContextMenuShortcut/ContextMenuShortcut.js";
+import { ContextMenuSub as f } from "./ContextMenuSub/ContextMenuSub.js";
+import { ContextMenuSubTrigger as p } from "./ContextMenuSubTrigger/ContextMenuSubTrigger.js";
+import { ContextMenuSubContent as m } from "./ContextMenuSubContent/ContextMenuSubContent.js";
+export { e as ContextMenu, a as ContextMenuCheckboxItem, r as ContextMenuContent, c as ContextMenuGroup, i as ContextMenuItem, l as ContextMenuLabel, n as ContextMenuPortal, o as ContextMenuRadioGroup, s as ContextMenuRadioItem, u as ContextMenuSeparator, d as ContextMenuShortcut, f as ContextMenuSub, m as ContextMenuSubContent, p as ContextMenuSubTrigger, t as ContextMenuTrigger };

package/dist/components/data-table/createRowModel.d.ts

@@ -0,0 +1,20 @@
+import { Accessor } from 'solid-js';
+import { Column, Row } from './data-table.types';
+import { TableStateAccessors } from './createTableState';
+/**
+ * 行模型流水线：core → filtered → sorted → page，逐级 createMemo。
+ * 过滤/排序的实现细节（访问器、比较器、过滤函数）由外部注入。
+ */
+export declare function createRowModel<TData>(options: {
+    coreRows: Accessor<Row<TData>[]>;
+    state: TableStateAccessors;
+    getColumn: (id: string) => Column<TData> | undefined;
+    getAccessor: (id: string) => ((row: TData) => unknown) | undefined;
+    getComparator: (id: string) => ((a: TData, b: TData) => number) | undefined;
+    getFilterFn: (id: string) => ((row: TData, value: unknown) => boolean) | undefined;
+}): {
+    filteredRows: Accessor<Row<TData>[]>;
+    sortedRows: Accessor<Row<TData>[]>;
+    pageRows: Accessor<Row<TData>[]>;
+    pageCount: Accessor<number>;
+};

package/dist/components/data-table/createRowModel.js

@@ -0,0 +1,46 @@
+import { includesFilterValue as e } from "./data-table.utils.js";
+import { createEffect as t, createMemo as n } from "solid-js";
+//#region src/components/data-table/createRowModel.ts
+function r(r) {
+	let { state: i } = r, a = n(() => {
+		let t = i.columnFilters();
+		return t.length === 0 ? r.coreRows() : r.coreRows().filter((n) => t.every((t) => {
+			let i = r.getColumn(t.id);
+			if (!i || i.columnDef.enableColumnFilter === !1) return !0;
+			let a = r.getFilterFn(t.id);
+			return a ? a(n.original, t.value) : e(r.getAccessor(t.id)?.(n.original), t.value);
+		}));
+	}), o = n(() => {
+		let e = i.sorting();
+		if (e.length === 0) return a();
+		let t = [...a()];
+		return t.sort((t, n) => {
+			for (let i of e) {
+				let e = r.getComparator(i.id);
+				if (!e) continue;
+				let a = e(t.original, n.original);
+				if (a !== 0) return i.desc ? -a : a;
+			}
+			return 0;
+		}), t;
+	}), s = n(() => Math.max(1, Math.ceil(a().length / i.pagination().pageSize)));
+	return t(() => {
+		let e = s(), t = i.pagination();
+		t.pageIndex > e - 1 && i.setPagination({
+			...t,
+			pageIndex: e - 1
+		});
+	}), {
+		filteredRows: a,
+		sortedRows: o,
+		pageRows: n(() => {
+			let { pageIndex: e, pageSize: t } = i.pagination(), n = e * t;
+			return o().slice(n, n + t);
+		}),
+		pageCount: s
+	};
+}
+//#endregion
+export { r as createRowModel };
+
+//# sourceMappingURL=createRowModel.js.map

package/dist/components/data-table/createRowModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRowModel.js","names":["createRowModel","options","filteredRows","createMemo","filters","state","column","filter","customFn","row","includesFilterValue","sortedRows","entries","list","entry","comparator","diff","a","b","pageCount","createEffect","count","current","start","pageIndex","pageSize"],"sources":["../../../src/components/data-table/createRowModel.ts"],"sourcesContent":["import { createEffect, createMemo, type Accessor } from \"solid-js\";\nimport type { Column, Row } from \"./data-table.types\";\nimport { includesFilterValue } from \"./data-table.utils\";\nimport type { TableStateAccessors } from \"./createTableState\";\n\n/**\n * 行模型流水线：core → filtered → sorted → page，逐级 createMemo。\n * 过滤/排序的实现细节（访问器、比较器、过滤函数）由外部注入。\n */\nexport function createRowModel<TData>(options: {\n  coreRows: Accessor<Row<TData>[]>;\n  state: TableStateAccessors;\n  getColumn: (id: string) => Column<TData> | undefined;\n  getAccessor: (id: string) => ((row: TData) => unknown) | undefined;\n  getComparator: (id: string) => ((a: TData, b: TData) => number) | undefined;\n  getFilterFn: (\n    id: string,\n  ) => ((row: TData, value: unknown) => boolean) | undefined;\n}): {\n  filteredRows: Accessor<Row<TData>[]>;\n  sortedRows: Accessor<Row<TData>[]>;\n  pageRows: Accessor<Row<TData>[]>;\n  pageCount: Accessor<number>;\n} {\n  const { state } = options;\n\n  const filteredRows = createMemo(() => {\n    const filters = state.columnFilters();\n    if (filters.length === 0) return options.coreRows();\n    return options.coreRows().filter((row) =>\n      filters.every((filter) => {\n        const column = options.getColumn(filter.id);\n        if (!column) return true;\n        if (column.columnDef.enableColumnFilter === false) return true;\n        const customFn = options.getFilterFn(filter.id);\n        if (customFn) return customFn(row.original, filter.value);\n        return includesFilterValue(\n          options.getAccessor(filter.id)?.(row.original),\n          filter.value,\n        );\n      }),\n    );\n  });\n\n  const sortedRows = createMemo(() => {\n    const entries = state.sorting();\n    if (entries.length === 0) return filteredRows();\n    const list = [...filteredRows()];\n    list.sort((a, b) => {\n      for (const entry of entries) {\n        const comparator = options.getComparator(entry.id);\n        if (!comparator) continue;\n        const diff = comparator(a.original, b.original);\n        if (diff !== 0) return entry.desc ? -diff : diff;\n      }\n      return 0;\n    });\n    return list;\n  });\n\n  const pageCount = createMemo(() =>\n    Math.max(1, Math.ceil(filteredRows().length / state.pagination().pageSize)),\n  );\n\n  // 过滤后页数变小时把页码收敛回合法范围\n  createEffect(() => {\n    const count = pageCount();\n    const current = state.pagination();\n    if (current.pageIndex > count - 1) {\n      state.setPagination({ ...current, pageIndex: count - 1 });\n    }\n  });\n\n  const pageRows = createMemo(() => {\n    const { pageIndex, pageSize } = state.pagination();\n    const start = pageIndex * pageSize;\n    return sortedRows().slice(start, start + pageSize);\n  });\n\n  return { filteredRows, sortedRows, pageRows, pageCount };\n}\n"],"mappings":";;;AASA,SAAgBA,EAAsB,GAcpC;CACA,IAAM,EAAE,aAAUC,GAEZC,IAAeC,QAAiB;EACpC,IAAMC,IAAUC,EAAM,cAAc;EAEpC,OADID,EAAQ,WAAW,IAAUH,EAAQ,SAAS,IAC3CA,EAAQ,SAAS,CAAC,CAAC,QAAQ,MAChCG,EAAQ,OAAO,MAAW;GACxB,IAAME,IAASL,EAAQ,UAAUM,EAAO,EAAE;GAE1C,IADI,CAACD,KACDA,EAAO,UAAU,uBAAuB,IAAO,OAAO;GAC1D,IAAME,IAAWP,EAAQ,YAAYM,EAAO,EAAE;GAE9C,OADIC,IAAiBA,EAASC,EAAI,UAAUF,EAAO,KAAK,IACjDG,EACLT,EAAQ,YAAYM,EAAO,EAAE,CAAC,GAAGE,EAAI,QAAQ,GAC7CF,EAAO,KACT;EACF,CAAC,CACH;CACF,CAAC,GAEKI,IAAaR,QAAiB;EAClC,IAAMS,IAAUP,EAAM,QAAQ;EAC9B,IAAIO,EAAQ,WAAW,GAAG,OAAOV,EAAa;EAC9C,IAAMW,IAAO,CAAC,GAAGX,EAAa,CAAC;EAU/B,OATAW,EAAK,MAAM,GAAG,MAAM;GAClB,KAAK,IAAMC,KAASF,GAAS;IAC3B,IAAMG,IAAad,EAAQ,cAAca,EAAM,EAAE;IACjD,IAAI,CAACC,GAAY;IACjB,IAAMC,IAAOD,EAAWE,EAAE,UAAUC,EAAE,QAAQ;IAC9C,IAAIF,MAAS,GAAG,OAAOF,EAAM,OAAO,CAACE,IAAOA;GAC9C;GACA,OAAO;EACT,CAAC,GACMH;CACT,CAAC,GAEKM,IAAYhB,QAChB,KAAK,IAAI,GAAG,KAAK,KAAKD,EAAa,CAAC,CAAC,SAASG,EAAM,WAAW,CAAC,CAAC,QAAQ,CAAC,CAC5E;CAiBA,OAdAe,QAAmB;EACjB,IAAMC,IAAQF,EAAU,GAClBG,IAAUjB,EAAM,WAAW;EACjC,AAAIiB,EAAQ,YAAYD,IAAQ,KAC9BhB,EAAM,cAAc;GAAE,GAAGiB;GAAS,WAAWD,IAAQ;EAAE,CAAC;CAE5D,CAAC,GAQM;EAAE;EAAc;EAAY,UANlBlB,QAAiB;GAChC,IAAM,EAAE,cAAW,gBAAaE,EAAM,WAAW,GAC3CkB,IAAQC,IAAYC;GAC1B,OAAOd,EAAW,CAAC,CAAC,MAAMY,GAAOA,IAAQE,CAAQ;EACnD,CAEmC;EAAU;CAAU;AACzD"}

package/dist/components/data-table/createTable.d.ts

@@ -0,0 +1,16 @@
+import { CreateTableOptions, DataTable } from './data-table.types';
+/**
+ * 自研 Solid 表格引擎（headless，不依赖 TanStack）。
+ *
+ * 只负责**组装**各部分：
+ * - 状态切片 `createTableState`
+ * - 列 `createTableColumns`
+ * - 行与缓存 `createTableRows`
+ * - 行模型流水线 `createRowModel`（过滤 → 排序 → 分页）
+ * - 选择 `createTableSelection`
+ * - 表头 `createTableHeaderGroups`
+ *
+ * 性能取向：流水线全程 `createMemo`、Row/Column 身份稳定、选中态走 signal；
+ * 详见同目录 DESIGN.md。
+ */
+export declare function createTable<TData>(options: CreateTableOptions<TData>): DataTable<TData>;

package/dist/components/data-table/createTable.js

@@ -0,0 +1,94 @@
+import { createTableColumns as e } from "./createTableColumns.js";
+import { createTableHeaderGroups as t } from "./createTableHeaders.js";
+import { createTableRows as n } from "./createTableRows.js";
+import { createRowModel as r } from "./createRowModel.js";
+import { createTableSelection as i } from "./createTableSelection.js";
+import { createTableState as a } from "./createTableState.js";
+//#region src/components/data-table/createTable.ts
+function o(o) {
+	let s = a(o), c = e({
+		columns: o.columns,
+		state: s
+	}), { coreRows: l } = n({
+		data: o.data,
+		getRowId: o.getRowId,
+		getAccessor: c.getAccessor,
+		getVisibleColumns: c.visibleColumns,
+		state: s
+	}), { filteredRows: u, pageRows: d, pageCount: f } = r({
+		coreRows: l,
+		state: s,
+		getColumn: c.getColumn,
+		getAccessor: c.getAccessor,
+		getComparator: c.getComparator,
+		getFilterFn: c.getFilterFn
+	}), p = i({
+		pageRows: d,
+		state: s
+	}), m;
+	return m = {
+		getHeaderGroups: t({
+			visibleColumns: c.visibleColumns,
+			getTable: () => m
+		}),
+		getRowModel: () => ({ rows: d() }),
+		getFilteredRowModel: () => ({ rows: u() }),
+		getFilteredSelectedRowModel: () => ({ rows: u().filter((e) => e.getIsSelected()) }),
+		getColumn: c.getColumn,
+		getAllColumns: () => c.allColumns,
+		getIsAllPageRowsSelected: p.getIsAllPageRowsSelected,
+		getIsSomePageRowsSelected: p.getIsSomePageRowsSelected,
+		toggleAllPageRowsSelected: p.toggleAllPageRowsSelected,
+		getCanPreviousPage: () => s.pagination().pageIndex > 0,
+		getCanNextPage: () => s.pagination().pageIndex < f() - 1,
+		getPageCount: () => f(),
+		previousPage: () => {
+			let e = s.pagination();
+			e.pageIndex > 0 && s.setPagination({
+				...e,
+				pageIndex: e.pageIndex - 1
+			});
+		},
+		nextPage: () => {
+			let e = s.pagination();
+			e.pageIndex < f() - 1 && s.setPagination({
+				...e,
+				pageIndex: e.pageIndex + 1
+			});
+		},
+		setPageIndex: (e) => {
+			let t = Math.min(Math.max(e, 0), f() - 1);
+			s.setPagination({
+				...s.pagination(),
+				pageIndex: t
+			});
+		},
+		setPageSize: (e) => {
+			s.setPagination({
+				pageIndex: 0,
+				pageSize: Math.max(1, e)
+			});
+		},
+		state: {
+			get sorting() {
+				return s.sorting();
+			},
+			get columnFilters() {
+				return s.columnFilters();
+			},
+			get columnVisibility() {
+				return s.columnVisibility();
+			},
+			get rowSelection() {
+				return s.rowSelection();
+			},
+			get pagination() {
+				return s.pagination();
+			}
+		}
+	}, m;
+}
+//#endregion
+export { o as createTable };
+
+//# sourceMappingURL=createTable.js.map