@neut/ui 0.0.16 → 0.0.18

package/dist/lib/positioner/index.d.ts

@@ -4,6 +4,8 @@ export { computePosition } from './core/compute-position';
 export { getSide, getAlignment, getOppositePlacement, getOppositeAlignmentPlacement, ALL_PLACEMENTS, } from './core/placement';
 export { autoUpdate } from './auto-update';
 export type { AutoUpdateOptions } from './auto-update';
+export * from './utils/floating';
+export { getOverflowAncestors, getRectRelativeTo, getViewportBoundary, getViewportRect, isOverflowElement, } from './utils/dom';
 export { createVirtualElement } from './virtual-element';
 export type { PointOptions } from './virtual-element';
 export { offset, shift, flip, arrow, size, hide, containingBlockOffset, } from './middleware';

package/dist/lib/positioner/utils/dom.d.ts

@@ -12,5 +12,13 @@ export declare function getViewportRect(el: ReferenceElement): Rect;
 export declare function getRectRelativeTo(el: ReferenceElement, strategy: Strategy): Rect;
 /** 当前视口作为默认边界（用于 shift / flip 的溢出检测），strategy 决定坐标系 */
 export declare function getViewportBoundary(strategy: Strategy, padding?: number): Rect;
+/**
+ * 元素自身是否建立了滚动容器。
+ *
+ * 导出原因:`hooks/useScrollLock` 需要用它判断页面滚动条长在 html 还是 body 上,
+ * 之前那里也有一份逐字重复的实现。两处口径必须一致(同一个正则、同样只看
+ * overflow 三属性),否则"锁哪个元素"和"哪些祖先要监听 scroll"会不一致。
+ */
+export declare function isOverflowElement(el: Element): boolean;
 /** 找到所有可能影响布局的可滚动祖先 + window，用于 autoUpdate 监听 scroll/resize */
 export declare function getOverflowAncestors(node: Element): Array<Element | Window>;

package/dist/lib/positioner/utils/dom.js

@@ -38,6 +38,6 @@ function i(e) {
 	return t.push(window), t;
 }
 //#endregion
-export { i as getOverflowAncestors, t as getRectRelativeTo, n as getViewportBoundary, e as getViewportRect };
+export { i as getOverflowAncestors, t as getRectRelativeTo, n as getViewportBoundary, e as getViewportRect, r as isOverflowElement };
 
 //# sourceMappingURL=dom.js.map

package/dist/lib/positioner/utils/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":["getViewportRect","rect","el","getRectRelativeTo","strategy","scrollX","scrollY","getViewportBoundary","width","height","padding","isOverflowElement","overflow","overflowX","overflowY","getOverflowAncestors","result","node"],"sources":["../../../../src/lib/positioner/utils/dom.ts"],"sourcesContent":["import type { ReferenceElement, Rect, Strategy } from \"../types\";\n\n/** 把 DOMRect 转成纯数据对象（视口坐标系）；同时兼容虚拟参照元素 */\nexport function getViewportRect(el: ReferenceElement): Rect {\n  const rect = el.getBoundingClientRect();\n  return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };\n}\n\n/**\n * 根据 strategy 得到参与计算的矩形：\n * - fixed：直接用视口坐标（配合 position:fixed 使用最简单可靠）\n * - absolute：加上页面滚动偏移，换算成“文档坐标”\n *   （假设 floating 元素最终被挂载在 <body> 下，即最近定位祖先是 body/html，\n *    这是 Portal 到 body 的常见用法；如果你的 floating 元素有自定义的\n *    非 static 定位祖先，请优先使用 strategy: 'fixed'）\n */\nexport function getRectRelativeTo(\n  el: ReferenceElement,\n  strategy: Strategy,\n): Rect {\n  const rect = getViewportRect(el);\n  if (strategy === \"fixed\") return rect;\n  const scrollX = window.scrollX ?? window.pageXOffset;\n  const scrollY = window.scrollY ?? window.pageYOffset;\n  return {\n    x: rect.x + scrollX,\n    y: rect.y + scrollY,\n    width: rect.width,\n    height: rect.height,\n  };\n}\n\n/** 当前视口作为默认边界（用于 shift / flip 的溢出检测），strategy 决定坐标系 */\nexport function getViewportBoundary(strategy: Strategy, padding = 0): Rect {\n  const width = document.documentElement.clientWidth;\n  const height = document.documentElement.clientHeight;\n  const scrollX =\n    strategy === \"fixed\" ? 0 : (window.scrollX ?? window.pageXOffset);\n  const scrollY =\n    strategy === \"fixed\" ? 0 : (window.scrollY ?? window.pageYOffset);\n  return {\n    x: scrollX + padding,\n    y: scrollY + padding,\n    width: width - padding * 2,\n    height: height - padding * 2,\n  };\n}\n\nfunction isOverflowElement(el: Element): boolean {\n  const { overflow, overflowX, overflowY } = getComputedStyle(el);\n  return /auto|scroll|overlay|hidden/.test(overflow + overflowX + overflowY);\n}\n\n/** 找到所有可能影响布局的可滚动祖先 + window，用于 autoUpdate 监听 scroll/resize */\nexport function getOverflowAncestors(node: Element): Array<Element | Window> {\n  const result: Array<Element | Window> = [];\n  let el: Element | null = node.parentElement;\n\n  while (el) {\n    if (isOverflowElement(el)) {\n      result.push(el);\n    }\n    el = el.parentElement;\n  }\n\n  result.push(window);\n  return result;\n}\n"],"mappings":";AAGA,SAAgBA,EAAgB,GAA4B;CAC1D,IAAMC,IAAOC,EAAG,sBAAsB;CACtC,OAAO;EAAE,GAAGD,EAAK;EAAG,GAAGA,EAAK;EAAG,OAAOA,EAAK;EAAO,QAAQA,EAAK;CAAO;AACxE;AAUA,SAAgBE,EACd,GACA,GACM;CACN,IAAMF,IAAOD,EAAgBE,CAAE;CAC/B,IAAIE,MAAa,SAAS,OAAOH;CACjC,IAAMI,IAAU,OAAO,WAAW,OAAO,aACnCC,IAAU,OAAO,WAAW,OAAO;CACzC,OAAO;EACL,GAAGL,EAAK,IAAII;EACZ,GAAGJ,EAAK,IAAIK;EACZ,OAAOL,EAAK;EACZ,QAAQA,EAAK;CACf;AACF;AAGA,SAAgBM,EAAoB,GAAoB,IAAU,GAAS;CACzE,IAAMC,IAAQ,SAAS,gBAAgB,aACjCC,IAAS,SAAS,gBAAgB,cAClCJ,IACJD,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO,aACjDE,IACJF,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO;CACvD,OAAO;EACL,GAAGC,IAAUK;EACb,GAAGJ,IAAUI;EACb,OAAOF,IAAQE,IAAU;EACzB,QAAQD,IAASC,IAAU;CAC7B;AACF;AAEA,SAASC,EAAkB,GAAsB;CAC/C,IAAM,EAAE,aAAU,cAAW,iBAAc,iBAAiBT,CAAE;CAC9D,OAAO,6BAA6B,KAAKU,IAAWC,IAAYC,CAAS;AAC3E;AAGA,SAAgBC,EAAqB,GAAwC;CAC3E,IAAMC,IAAkC,CAAC,GACrCd,IAAqBe,EAAK;CAE9B,OAAOf,IAIL,AAHIS,EAAkBT,CAAE,KACtBc,EAAO,KAAKd,CAAE,GAEhB,IAAKA,EAAG;CAIV,OADAc,EAAO,KAAK,MAAM,GACXA;AACT"}
+{"version":3,"file":"dom.js","names":["getViewportRect","rect","el","getRectRelativeTo","strategy","scrollX","scrollY","getViewportBoundary","width","height","padding","isOverflowElement","overflow","overflowX","overflowY","getOverflowAncestors","result","node"],"sources":["../../../../src/lib/positioner/utils/dom.ts"],"sourcesContent":["import type { ReferenceElement, Rect, Strategy } from \"../types\";\n\n/** 把 DOMRect 转成纯数据对象（视口坐标系）；同时兼容虚拟参照元素 */\nexport function getViewportRect(el: ReferenceElement): Rect {\n  const rect = el.getBoundingClientRect();\n  return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };\n}\n\n/**\n * 根据 strategy 得到参与计算的矩形：\n * - fixed：直接用视口坐标（配合 position:fixed 使用最简单可靠）\n * - absolute：加上页面滚动偏移，换算成“文档坐标”\n *   （假设 floating 元素最终被挂载在 <body> 下，即最近定位祖先是 body/html，\n *    这是 Portal 到 body 的常见用法；如果你的 floating 元素有自定义的\n *    非 static 定位祖先，请优先使用 strategy: 'fixed'）\n */\nexport function getRectRelativeTo(\n  el: ReferenceElement,\n  strategy: Strategy,\n): Rect {\n  const rect = getViewportRect(el);\n  if (strategy === \"fixed\") return rect;\n  const scrollX = window.scrollX ?? window.pageXOffset;\n  const scrollY = window.scrollY ?? window.pageYOffset;\n  return {\n    x: rect.x + scrollX,\n    y: rect.y + scrollY,\n    width: rect.width,\n    height: rect.height,\n  };\n}\n\n/** 当前视口作为默认边界（用于 shift / flip 的溢出检测），strategy 决定坐标系 */\nexport function getViewportBoundary(strategy: Strategy, padding = 0): Rect {\n  const width = document.documentElement.clientWidth;\n  const height = document.documentElement.clientHeight;\n  const scrollX =\n    strategy === \"fixed\" ? 0 : (window.scrollX ?? window.pageXOffset);\n  const scrollY =\n    strategy === \"fixed\" ? 0 : (window.scrollY ?? window.pageYOffset);\n  return {\n    x: scrollX + padding,\n    y: scrollY + padding,\n    width: width - padding * 2,\n    height: height - padding * 2,\n  };\n}\n\n/**\n * 元素自身是否建立了滚动容器。\n *\n * 导出原因:`hooks/useScrollLock` 需要用它判断页面滚动条长在 html 还是 body 上,\n * 之前那里也有一份逐字重复的实现。两处口径必须一致(同一个正则、同样只看\n * overflow 三属性),否则\"锁哪个元素\"和\"哪些祖先要监听 scroll\"会不一致。\n */\nexport function isOverflowElement(el: Element): boolean {\n  const { overflow, overflowX, overflowY } = getComputedStyle(el);\n  return /auto|scroll|overlay|hidden/.test(overflow + overflowX + overflowY);\n}\n\n/** 找到所有可能影响布局的可滚动祖先 + window，用于 autoUpdate 监听 scroll/resize */\nexport function getOverflowAncestors(node: Element): Array<Element | Window> {\n  const result: Array<Element | Window> = [];\n  let el: Element | null = node.parentElement;\n\n  while (el) {\n    if (isOverflowElement(el)) {\n      result.push(el);\n    }\n    el = el.parentElement;\n  }\n\n  result.push(window);\n  return result;\n}\n"],"mappings":";AAGA,SAAgBA,EAAgB,GAA4B;CAC1D,IAAMC,IAAOC,EAAG,sBAAsB;CACtC,OAAO;EAAE,GAAGD,EAAK;EAAG,GAAGA,EAAK;EAAG,OAAOA,EAAK;EAAO,QAAQA,EAAK;CAAO;AACxE;AAUA,SAAgBE,EACd,GACA,GACM;CACN,IAAMF,IAAOD,EAAgBE,CAAE;CAC/B,IAAIE,MAAa,SAAS,OAAOH;CACjC,IAAMI,IAAU,OAAO,WAAW,OAAO,aACnCC,IAAU,OAAO,WAAW,OAAO;CACzC,OAAO;EACL,GAAGL,EAAK,IAAII;EACZ,GAAGJ,EAAK,IAAIK;EACZ,OAAOL,EAAK;EACZ,QAAQA,EAAK;CACf;AACF;AAGA,SAAgBM,EAAoB,GAAoB,IAAU,GAAS;CACzE,IAAMC,IAAQ,SAAS,gBAAgB,aACjCC,IAAS,SAAS,gBAAgB,cAClCJ,IACJD,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO,aACjDE,IACJF,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO;CACvD,OAAO;EACL,GAAGC,IAAUK;EACb,GAAGJ,IAAUI;EACb,OAAOF,IAAQE,IAAU;EACzB,QAAQD,IAASC,IAAU;CAC7B;AACF;AASA,SAAgBC,EAAkB,GAAsB;CACtD,IAAM,EAAE,aAAU,cAAW,iBAAc,iBAAiBT,CAAE;CAC9D,OAAO,6BAA6B,KAAKU,IAAWC,IAAYC,CAAS;AAC3E;AAGA,SAAgBC,EAAqB,GAAwC;CAC3E,IAAMC,IAAkC,CAAC,GACrCd,IAAqBe,EAAK;CAE9B,OAAOf,IAIL,AAHIS,EAAkBT,CAAE,KACtBc,EAAO,KAAKd,CAAE,GAEhB,IAAKA,EAAG;CAIV,OADAc,EAAO,KAAK,MAAM,GACXA;AACT"}

package/dist/lib/positioner/utils/floating.d.ts

@@ -0,0 +1,25 @@
+import { Alignment, Middleware, Placement, Side } from '../types';
+/** Base UI 的逻辑方向:按 dir 映射到物理方向 */
+export type LogicalSide = Side | "inline-start" | "inline-end";
+export declare function toPhysicalSide(side: LogicalSide, dir?: string): Side;
+/** shadcn/Base UI 风格的 side + align 组合成核心库的 Placement */
+export declare function toPlacement(side: LogicalSide, align: Alignment | "center", dir?: string): Placement;
+/** 缩放动画锚点落在贴近 trigger 的那条边(不是几何中心) */
+export declare function getTransformOrigin(placement: Placement): string;
+export interface FloatingMiddlewareOptions {
+    /** 沿主轴与 reference 的间距 */
+    sideOffset: number;
+    /** 沿交叉轴的偏移 */
+    alignOffset?: number;
+    /** 距视口边缘的最小间距 */
+    collisionPadding?: number;
+    /** 传入则加入 arrow middleware(必须排在 flip/shift 之后) */
+    arrowElement?: () => Element | undefined;
+    arrowPadding?: number;
+}
+/**
+ * Popover / Tooltip / HoverCard / Select 等浮层共用的定位管线:
+ * offset → flip → shift → [arrow] → hide → containingBlockOffset。
+ * 抽到 positioner 里,避免每个组件各抄一份。
+ */
+export declare function createFloatingMiddleware(options: FloatingMiddlewareOptions): Middleware[];

package/dist/lib/positioner/utils/floating.js

@@ -0,0 +1,42 @@
+import { getAlignment as e, getSide as t } from "../core/placement.js";
+import { offset as n } from "../middleware/offset.js";
+import { shift as r } from "../middleware/shift.js";
+import { flip as i } from "../middleware/flip.js";
+import { arrow as a } from "../middleware/arrow.js";
+import { hide as o } from "../middleware/hide.js";
+import { containingBlockOffset as s } from "../middleware/containing-block-offset.js";
+//#region src/lib/positioner/utils/floating.ts
+function c(e, t) {
+	return e === "inline-start" ? t === "rtl" ? "right" : "left" : e === "inline-end" ? t === "rtl" ? "left" : "right" : e;
+}
+function l(e, t, n) {
+	let r = c(e, n);
+	return t === "center" ? r : `${r}-${t}`;
+}
+function u(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 d(e) {
+	let t = [
+		n({
+			mainAxis: e.sideOffset,
+			crossAxis: e.alignOffset ?? 0
+		}),
+		i(),
+		r({ padding: e.collisionPadding ?? 8 })
+	];
+	return e.arrowElement && t.push(a({
+		element: e.arrowElement,
+		padding: e.arrowPadding ?? 6
+	})), t.push(o(), s()), t;
+}
+//#endregion
+export { d as createFloatingMiddleware, u as getTransformOrigin, c as toPhysicalSide, l as toPlacement };
+
+//# sourceMappingURL=floating.js.map

package/dist/lib/positioner/utils/floating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating.js","names":["toPhysicalSide","side","dir","toPlacement","physical","align","getTransformOrigin","getSide","placement","getAlignment","cross","createFloatingMiddleware","middleware","offset","options","flip","shift","arrow","hide","containingBlockOffset"],"sources":["../../../../src/lib/positioner/utils/floating.ts"],"sourcesContent":["import { getAlignment, getSide } from \"../core/placement\";\nimport {\n  arrow,\n  containingBlockOffset,\n  flip,\n  hide,\n  offset,\n  shift,\n} from \"../middleware\";\nimport type { Alignment, Middleware, Placement, Side } from \"../types\";\n\n/** Base UI 的逻辑方向:按 dir 映射到物理方向 */\nexport type LogicalSide = Side | \"inline-start\" | \"inline-end\";\n\nexport function toPhysicalSide(side: LogicalSide, dir?: string): Side {\n  if (side === \"inline-start\") return dir === \"rtl\" ? \"right\" : \"left\";\n  if (side === \"inline-end\") return dir === \"rtl\" ? \"left\" : \"right\";\n  return side;\n}\n\n/** shadcn/Base UI 风格的 side + align 组合成核心库的 Placement */\nexport function toPlacement(\n  side: LogicalSide,\n  align: Alignment | \"center\",\n  dir?: string,\n): Placement {\n  const physical = toPhysicalSide(side, dir);\n  return align === \"center\" ? physical : (`${physical}-${align}` as Placement);\n}\n\n/** 缩放动画锚点落在贴近 trigger 的那条边(不是几何中心) */\nexport function getTransformOrigin(placement: Placement): string {\n  const side = getSide(placement);\n  const align = getAlignment(placement);\n  const cross = align === \"start\" ? \"0%\" : align === \"end\" ? \"100%\" : \"50%\";\n  switch (side) {\n    case \"top\":\n      return `${cross} 100%`;\n    case \"bottom\":\n      return `${cross} 0%`;\n    case \"left\":\n      return `100% ${cross}`;\n    case \"right\":\n      return `0% ${cross}`;\n  }\n}\n\nexport interface FloatingMiddlewareOptions {\n  /** 沿主轴与 reference 的间距 */\n  sideOffset: number;\n  /** 沿交叉轴的偏移 */\n  alignOffset?: number;\n  /** 距视口边缘的最小间距 */\n  collisionPadding?: number;\n  /** 传入则加入 arrow middleware(必须排在 flip/shift 之后) */\n  arrowElement?: () => Element | undefined;\n  arrowPadding?: number;\n}\n\n/**\n * Popover / Tooltip / HoverCard / Select 等浮层共用的定位管线:\n * offset → flip → shift → [arrow] → hide → containingBlockOffset。\n * 抽到 positioner 里,避免每个组件各抄一份。\n */\nexport function createFloatingMiddleware(\n  options: FloatingMiddlewareOptions,\n): Middleware[] {\n  const middleware: Middleware[] = [\n    offset({\n      mainAxis: options.sideOffset,\n      crossAxis: options.alignOffset ?? 0,\n    }),\n    flip(),\n    shift({ padding: options.collisionPadding ?? 8 }),\n  ];\n  if (options.arrowElement) {\n    middleware.push(\n      arrow({\n        element: options.arrowElement,\n        padding: options.arrowPadding ?? 6,\n      }),\n    );\n  }\n  middleware.push(hide(), containingBlockOffset());\n  return middleware;\n}\n"],"mappings":";;;;;;;;AAcA,SAAgBA,EAAe,GAAmB,GAAoB;CAGpE,OAFIC,MAAS,iBAAuBC,MAAQ,QAAQ,UAAU,SAC1DD,MAAS,eAAqBC,MAAQ,QAAQ,SAAS,UACpDD;AACT;AAGA,SAAgBE,EACd,GACA,GACA,GACW;CACX,IAAMC,IAAWJ,EAAeC,GAAMC,CAAG;CACzC,OAAOG,MAAU,WAAWD,IAAY,GAAGA,EAAS,GAAGC;AACzD;AAGA,SAAgBC,EAAmB,GAA8B;CAC/D,IAAML,IAAOM,EAAQC,CAAS,GACxBH,IAAQI,EAAaD,CAAS,GAC9BE,IAAQL,MAAU,UAAU,OAAOA,MAAU,QAAQ,SAAS;CACpE,QAAQJ,GAAR;EACE,KAAK,OACH,OAAO,GAAGS,EAAM;EAClB,KAAK,UACH,OAAO,GAAGA,EAAM;EAClB,KAAK,QACH,OAAO,QAAQA;EACjB,KAAK,SACH,OAAO,MAAMA;CACjB;AACF;AAmBA,SAAgBC,EACd,GACc;CACd,IAAMC,IAA2B;EAC/BC,EAAO;GACL,UAAUC,EAAQ;GAClB,WAAWA,EAAQ,eAAe;EACpC,CAAC;EACDC,EAAK;EACLC,EAAM,EAAE,SAASF,EAAQ,oBAAoB,EAAE,CAAC;CAClD;CAUA,OATIA,EAAQ,gBACVF,EAAW,KACTK,EAAM;EACJ,SAASH,EAAQ;EACjB,SAASA,EAAQ,gBAAgB;CACnC,CAAC,CACH,GAEFF,EAAW,KAAKM,EAAK,GAAGC,EAAsB,CAAC,GACxCP;AACT"}

package/dist/types/props.types.d.ts

@@ -1,7 +1,7 @@
 import { ComponentProps, JSX, ValidComponent } from 'solid-js';
 import { DynamicProps } from 'solid-js/web';
 export type EmptyObject = Record<never, never>;
-export type MouseEventHandler<T extends keyof HTMLElementTagNameMap> = (e?: MouseEvent & {
+export type MouseEventHandler<T extends keyof HTMLElementTagNameMap> = (e: MouseEvent & {
     currentTarget: HTMLElementTagNameMap[T];
     target: Element;
 }) => void;