@neut/ui 0.0.15 → 0.0.17

package/dist/lib/positioner/auto-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.js","names":[],"sources":["../../../src/lib/positioner/auto-update.ts"],"sourcesContent":["import type { ReferenceElement } from \"./types\";\nimport { getOverflowAncestors } from \"./utils/dom\";\n\nexport interface AutoUpdateOptions {\n  /** 祖先滚动容器滚动时触发更新，默认 true */\n  ancestorScroll?: boolean;\n  /** 祖先容器 resize（依赖 ResizeObserver）时触发更新，默认 true */\n  ancestorResize?: boolean;\n  /** reference / floating 自身尺寸变化时触发更新，默认 true（虚拟参照元素没有尺寸，会被自动跳过） */\n  elementResize?: boolean;\n}\n\n/**\n * 自动监听所有可能影响定位的事件（滚动、窗口/元素尺寸变化），\n * 在变化时调用 update。返回一个清理函数，调用后移除所有监听。\n *\n * reference 如果是虚拟参照元素（比如锚定到鼠标坐标的右键菜单），\n * 没有真实的 DOM 节点可以查找祖先滚动容器或做尺寸观察：\n * - 如果虚拟元素提供了 `contextElement`，会用它代替去查找可滚动祖先；\n * - 否则只监听 window 的 resize（不含 scroll，因为没有关联容器可判断是否相关）。\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  options: AutoUpdateOptions = {},\n): () => void {\n  const {\n    ancestorScroll = true,\n    ancestorResize = true,\n    elementResize = true,\n  } = options;\n\n  const isRealElement = reference instanceof Element;\n  const ancestorAnchor: Element | null = isRealElement\n    ? reference\n    : ((reference as { contextElement?: Element }).contextElement ?? null);\n\n  const ancestors =\n    (ancestorScroll || ancestorResize) && ancestorAnchor\n      ? getOverflowAncestors(ancestorAnchor)\n      : [];\n\n  ancestors.forEach((ancestor) => {\n    if (ancestorScroll) {\n      ancestor.addEventListener(\"scroll\", update, { passive: true });\n    }\n  });\n\n  let resizeObserver: ResizeObserver | null = null;\n  if (\n    (ancestorResize || elementResize) &&\n    typeof ResizeObserver !== \"undefined\"\n  ) {\n    resizeObserver = new ResizeObserver(() => update());\n    // 虚拟参照元素没有真实尺寸可观察，只观察 floating 自身\n    if (elementResize) {\n      if (isRealElement) resizeObserver.observe(reference);\n      resizeObserver.observe(floating);\n    }\n    if (ancestorResize) {\n      ancestors.forEach((ancestor) => {\n        if (ancestor instanceof Element) resizeObserver!.observe(ancestor);\n      });\n    }\n  }\n\n  window.addEventListener(\"resize\", update);\n\n  return () => {\n    ancestors.forEach((ancestor) => {\n      ancestor.removeEventListener(\"scroll\", update);\n    });\n    resizeObserver?.disconnect();\n    window.removeEventListener(\"resize\", update);\n  };\n}\n"],"mappings":";;AAqBA,SAAgB,EACd,GACA,GACA,GACA,IAA6B,CAAC,GAClB;CACZ,IAAM,EACJ,oBAAiB,IACjB,oBAAiB,IACjB,mBAAgB,OACd,GAEE,IAAgB,aAAqB,SACrC,IAAiC,IACnC,IACE,EAA2C,kBAAkB,MAE7D,KACH,KAAkB,MAAmB,IAClC,EAAqB,CAAc,IACnC,CAAC;CAEP,EAAU,SAAS,MAAa;EAC9B,AAAI,KACF,EAAS,iBAAiB,UAAU,GAAQ,EAAE,SAAS,GAAK,CAAC;CAEjE,CAAC;CAED,IAAI,IAAwC;CAoB5C,QAlBG,KAAkB,MACnB,OAAO,iBAAmB,QAE1B,IAAiB,IAAI,qBAAqB,EAAO,CAAC,GAE9C,MACE,KAAe,EAAe,QAAQ,CAAS,GACnD,EAAe,QAAQ,CAAQ,IAE7B,KACF,EAAU,SAAS,MAAa;EAC9B,AAAI,aAAoB,WAAS,EAAgB,QAAQ,CAAQ;CACnE,CAAC,IAIL,OAAO,iBAAiB,UAAU,CAAM,SAE3B;EAKX,AAJA,EAAU,SAAS,MAAa;GAC9B,EAAS,oBAAoB,UAAU,CAAM;EAC/C,CAAC,GACD,GAAgB,WAAW,GAC3B,OAAO,oBAAoB,UAAU,CAAM;CAC7C;AACF"}
+{"version":3,"file":"auto-update.js","names":["autoUpdate","options","isRealElement","reference","ancestorAnchor","ancestors","ancestorScroll","ancestorResize","getOverflowAncestors","ancestor","update","resizeObserver","elementResize","floating"],"sources":["../../../src/lib/positioner/auto-update.ts"],"sourcesContent":["import type { ReferenceElement } from \"./types\";\nimport { getOverflowAncestors } from \"./utils/dom\";\n\nexport interface AutoUpdateOptions {\n  /** 祖先滚动容器滚动时触发更新，默认 true */\n  ancestorScroll?: boolean;\n  /** 祖先容器 resize（依赖 ResizeObserver）时触发更新，默认 true */\n  ancestorResize?: boolean;\n  /** reference / floating 自身尺寸变化时触发更新，默认 true（虚拟参照元素没有尺寸，会被自动跳过） */\n  elementResize?: boolean;\n}\n\n/**\n * 自动监听所有可能影响定位的事件（滚动、窗口/元素尺寸变化），\n * 在变化时调用 update。返回一个清理函数，调用后移除所有监听。\n *\n * reference 如果是虚拟参照元素（比如锚定到鼠标坐标的右键菜单），\n * 没有真实的 DOM 节点可以查找祖先滚动容器或做尺寸观察：\n * - 如果虚拟元素提供了 `contextElement`，会用它代替去查找可滚动祖先；\n * - 否则只监听 window 的 resize（不含 scroll，因为没有关联容器可判断是否相关）。\n */\nexport function autoUpdate(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  update: () => void,\n  options: AutoUpdateOptions = {},\n): () => void {\n  const {\n    ancestorScroll = true,\n    ancestorResize = true,\n    elementResize = true,\n  } = options;\n\n  const isRealElement = reference instanceof Element;\n  const ancestorAnchor: Element | null = isRealElement\n    ? reference\n    : ((reference as { contextElement?: Element }).contextElement ?? null);\n\n  const ancestors =\n    (ancestorScroll || ancestorResize) && ancestorAnchor\n      ? getOverflowAncestors(ancestorAnchor)\n      : [];\n\n  ancestors.forEach((ancestor) => {\n    if (ancestorScroll) {\n      ancestor.addEventListener(\"scroll\", update, { passive: true });\n    }\n  });\n\n  let resizeObserver: ResizeObserver | null = null;\n  if (\n    (ancestorResize || elementResize) &&\n    typeof ResizeObserver !== \"undefined\"\n  ) {\n    resizeObserver = new ResizeObserver(() => update());\n    // 虚拟参照元素没有真实尺寸可观察，只观察 floating 自身\n    if (elementResize) {\n      if (isRealElement) resizeObserver.observe(reference);\n      resizeObserver.observe(floating);\n    }\n    if (ancestorResize) {\n      ancestors.forEach((ancestor) => {\n        if (ancestor instanceof Element) resizeObserver!.observe(ancestor);\n      });\n    }\n  }\n\n  window.addEventListener(\"resize\", update);\n\n  return () => {\n    ancestors.forEach((ancestor) => {\n      ancestor.removeEventListener(\"scroll\", update);\n    });\n    resizeObserver?.disconnect();\n    window.removeEventListener(\"resize\", update);\n  };\n}\n"],"mappings":";;AAqBA,SAAgBA,EACd,GACA,GACA,GACA,IAA6B,CAAC,GAClB;CACZ,IAAM,EACJ,oBAAiB,IACjB,oBAAiB,IACjB,mBAAgB,OACdC,GAEEC,IAAgBC,aAAqB,SACrCC,IAAiCF,IACnCC,IACEA,EAA2C,kBAAkB,MAE7DE,KACHC,KAAkBC,MAAmBH,IAClCI,EAAqBJ,CAAc,IACnC,CAAC;CAEP,EAAU,SAAS,MAAa;EAC9B,AAAIE,KACFG,EAAS,iBAAiB,UAAUC,GAAQ,EAAE,SAAS,GAAK,CAAC;CAEjE,CAAC;CAED,IAAIC,IAAwC;CAoB5C,QAlBGJ,KAAkBK,MACnB,OAAO,iBAAmB,QAE1B,IAAiB,IAAI,qBAAqBF,EAAO,CAAC,GAE9CE,MACEV,KAAeS,EAAe,QAAQR,CAAS,GACnDQ,EAAe,QAAQE,CAAQ,IAE7BN,KACFF,EAAU,SAAS,MAAa;EAC9B,AAAII,aAAoB,WAASE,EAAgB,QAAQF,CAAQ;CACnE,CAAC,IAIL,OAAO,iBAAiB,UAAUC,CAAM,SAE3B;EAKX,AAJAL,EAAU,SAAS,MAAa;GAC9B,EAAS,oBAAoB,UAAUK,CAAM;EAC/C,CAAC,GACDC,GAAgB,WAAW,GAC3B,OAAO,oBAAoB,UAAUD,CAAM;CAC7C;AACF"}

package/dist/lib/positioner/core/compute-position.js.map

@@ -1 +1 @@
-{"version":3,"file":"compute-position.js","names":[],"sources":["../../../../src/lib/positioner/core/compute-position.ts"],"sourcesContent":["import type {\n  ComputePositionConfig,\n  ComputePositionReturn,\n  ElementRects,\n  Elements,\n  Placement,\n  ReferenceElement,\n  Strategy,\n} from \"../types\";\nimport { getRectRelativeTo } from \"../utils/dom\";\nimport { computeCoordsFromPlacement } from \"./placement\";\n\nfunction getElementRects(elements: Elements, strategy: Strategy): ElementRects {\n  return {\n    reference: getRectRelativeTo(elements.reference, strategy),\n    floating: getRectRelativeTo(elements.floating, strategy),\n  };\n}\n\nconst MAX_MIDDLEWARE_PASSES = 8;\n\n/**\n * 计算 floating 元素相对 reference 元素的最终坐标。\n * reference 既可以是真实 DOM 元素，也可以是虚拟参照元素（见 createVirtualElement），\n * 后者常用于锚定到一个坐标点，比如右键菜单的鼠标点击位置。\n * middleware 按顺序执行，任意 middleware 返回 reset 时会用新的 placement 重跑一轮，\n * 但最多重跑 MAX_MIDDLEWARE_PASSES 次，避免死循环。\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  config: ComputePositionConfig = {},\n): ComputePositionReturn {\n  const {\n    placement = \"bottom\",\n    strategy = \"absolute\",\n    middleware = [],\n  } = config;\n  const elements: Elements = { reference, floating };\n\n  let statePlacement: Placement = placement;\n  let rects = getElementRects(elements, strategy);\n  let { x, y } = computeCoordsFromPlacement(rects, statePlacement);\n  let middlewareData: Record<string, any> = {};\n\n  let passes = 0;\n  let i = 0;\n  while (i < middleware.length) {\n    const { name, fn } = middleware[i];\n    const result = fn({\n      x,\n      y,\n      initialPlacement: placement,\n      placement: statePlacement,\n      strategy,\n      rects,\n      elements,\n      middlewareData,\n    });\n\n    if (result.x !== undefined) x = result.x;\n    if (result.y !== undefined) y = result.y;\n    if (result.data !== undefined) {\n      middlewareData = { ...middlewareData, [name]: result.data };\n    }\n\n    if (result.reset && passes < MAX_MIDDLEWARE_PASSES) {\n      passes++;\n      if (typeof result.reset === \"object\" && result.reset.placement) {\n        statePlacement = result.reset.placement;\n      }\n      rects = getElementRects(elements, strategy);\n      ({ x, y } = computeCoordsFromPlacement(rects, statePlacement));\n      i = 0;\n      continue;\n    }\n\n    i++;\n  }\n\n  return { x, y, placement: statePlacement, strategy, middlewareData };\n}\n"],"mappings":";;;AAYA,SAAS,EAAgB,GAAoB,GAAkC;CAC7E,OAAO;EACL,WAAW,EAAkB,EAAS,WAAW,CAAQ;EACzD,UAAU,EAAkB,EAAS,UAAU,CAAQ;CACzD;AACF;AAEA,IAAM,IAAwB;AAS9B,SAAgB,EACd,GACA,GACA,IAAgC,CAAC,GACV;CACvB,IAAM,EACJ,eAAY,UACZ,cAAW,YACX,gBAAa,CAAC,MACZ,GACE,IAAqB;EAAE;EAAW;CAAS,GAE7C,IAA4B,GAC5B,IAAQ,EAAgB,GAAU,CAAQ,GAC1C,EAAE,MAAG,SAAM,EAA2B,GAAO,CAAc,GAC3D,IAAsC,CAAC,GAEvC,IAAS,GACT,IAAI;CACR,OAAO,IAAI,EAAW,SAAQ;EAC5B,IAAM,EAAE,SAAM,UAAO,EAAW,IAC1B,IAAS,EAAG;GAChB;GACA;GACA,kBAAkB;GAClB,WAAW;GACX;GACA;GACA;GACA;EACF,CAAC;EAQD,IANI,EAAO,MAAM,KAAA,MAAW,IAAI,EAAO,IACnC,EAAO,MAAM,KAAA,MAAW,IAAI,EAAO,IACnC,EAAO,SAAS,KAAA,MAClB,IAAiB;GAAE,GAAG;IAAiB,IAAO,EAAO;EAAK,IAGxD,EAAO,SAAS,IAAS,GAAuB;GAOlD,AANA,KACI,OAAO,EAAO,SAAU,YAAY,EAAO,MAAM,cACnD,IAAiB,EAAO,MAAM,YAEhC,IAAQ,EAAgB,GAAU,CAAQ,GACzC,eAAW,EAA2B,GAAO,CAAc,GAC5D,IAAI;GACJ;EACF;EAEA;CACF;CAEA,OAAO;EAAE;EAAG;EAAG,WAAW;EAAgB;EAAU;CAAe;AACrE"}
+{"version":3,"file":"compute-position.js","names":["getElementRects","getRectRelativeTo","elements","strategy","MAX_MIDDLEWARE_PASSES","computePosition","config","statePlacement","placement","rects","computeCoordsFromPlacement","middlewareData","passes","i","middleware","result","fn","name"],"sources":["../../../../src/lib/positioner/core/compute-position.ts"],"sourcesContent":["import type {\n  ComputePositionConfig,\n  ComputePositionReturn,\n  ElementRects,\n  Elements,\n  Placement,\n  ReferenceElement,\n  Strategy,\n} from \"../types\";\nimport { getRectRelativeTo } from \"../utils/dom\";\nimport { computeCoordsFromPlacement } from \"./placement\";\n\nfunction getElementRects(elements: Elements, strategy: Strategy): ElementRects {\n  return {\n    reference: getRectRelativeTo(elements.reference, strategy),\n    floating: getRectRelativeTo(elements.floating, strategy),\n  };\n}\n\nconst MAX_MIDDLEWARE_PASSES = 8;\n\n/**\n * 计算 floating 元素相对 reference 元素的最终坐标。\n * reference 既可以是真实 DOM 元素，也可以是虚拟参照元素（见 createVirtualElement），\n * 后者常用于锚定到一个坐标点，比如右键菜单的鼠标点击位置。\n * middleware 按顺序执行，任意 middleware 返回 reset 时会用新的 placement 重跑一轮，\n * 但最多重跑 MAX_MIDDLEWARE_PASSES 次，避免死循环。\n */\nexport function computePosition(\n  reference: ReferenceElement,\n  floating: HTMLElement,\n  config: ComputePositionConfig = {},\n): ComputePositionReturn {\n  const {\n    placement = \"bottom\",\n    strategy = \"absolute\",\n    middleware = [],\n  } = config;\n  const elements: Elements = { reference, floating };\n\n  let statePlacement: Placement = placement;\n  let rects = getElementRects(elements, strategy);\n  let { x, y } = computeCoordsFromPlacement(rects, statePlacement);\n  let middlewareData: Record<string, any> = {};\n\n  let passes = 0;\n  let i = 0;\n  while (i < middleware.length) {\n    const { name, fn } = middleware[i];\n    const result = fn({\n      x,\n      y,\n      initialPlacement: placement,\n      placement: statePlacement,\n      strategy,\n      rects,\n      elements,\n      middlewareData,\n    });\n\n    if (result.x !== undefined) x = result.x;\n    if (result.y !== undefined) y = result.y;\n    if (result.data !== undefined) {\n      middlewareData = { ...middlewareData, [name]: result.data };\n    }\n\n    if (result.reset && passes < MAX_MIDDLEWARE_PASSES) {\n      passes++;\n      if (typeof result.reset === \"object\" && result.reset.placement) {\n        statePlacement = result.reset.placement;\n      }\n      rects = getElementRects(elements, strategy);\n      ({ x, y } = computeCoordsFromPlacement(rects, statePlacement));\n      i = 0;\n      continue;\n    }\n\n    i++;\n  }\n\n  return { x, y, placement: statePlacement, strategy, middlewareData };\n}\n"],"mappings":";;;AAYA,SAASA,EAAgB,GAAoB,GAAkC;CAC7E,OAAO;EACL,WAAWC,EAAkBC,EAAS,WAAWC,CAAQ;EACzD,UAAUF,EAAkBC,EAAS,UAAUC,CAAQ;CACzD;AACF;AAEA,IAAMC,IAAwB;AAS9B,SAAgBC,EACd,GACA,GACA,IAAgC,CAAC,GACV;CACvB,IAAM,EACJ,eAAY,UACZ,cAAW,YACX,gBAAa,CAAC,MACZC,GACEJ,IAAqB;EAAE;EAAW;CAAS,GAE7CK,IAA4BC,GAC5BC,IAAQT,EAAgBE,GAAUC,CAAQ,GAC1C,EAAE,MAAG,SAAMO,EAA2BD,GAAOF,CAAc,GAC3DI,IAAsC,CAAC,GAEvCC,IAAS,GACTC,IAAI;CACR,OAAOA,IAAIC,EAAW,SAAQ;EAC5B,IAAM,EAAE,SAAM,UAAOA,EAAWD,IAC1BE,IAASC,EAAG;GAChB;GACA;GACA,kBAAkBR;GAClB,WAAWD;GACX;GACA;GACA;GACA;EACF,CAAC;EAQD,IANIQ,EAAO,MAAM,KAAA,MAAW,IAAIA,EAAO,IACnCA,EAAO,MAAM,KAAA,MAAW,IAAIA,EAAO,IACnCA,EAAO,SAAS,KAAA,MAClB,IAAiB;GAAE,GAAGJ;IAAiBM,IAAOF,EAAO;EAAK,IAGxDA,EAAO,SAASH,IAASR,GAAuB;GAOlD,AANA,KACI,OAAOW,EAAO,SAAU,YAAYA,EAAO,MAAM,cACnD,IAAiBA,EAAO,MAAM,YAEhC,IAAQf,EAAgBE,GAAUC,CAAQ,GACzC,eAAWO,EAA2BD,GAAOF,CAAc,GAC5D,IAAI;GACJ;EACF;EAEA;CACF;CAEA,OAAO;EAAE;EAAG;EAAG,WAAWA;EAAgB;EAAU;CAAe;AACrE"}

package/dist/lib/positioner/core/placement.js.map

@@ -1 +1 @@
-{"version":3,"file":"placement.js","names":[],"sources":["../../../../src/lib/positioner/core/placement.ts"],"sourcesContent":["import type {\n  Alignment,\n  ElementRects,\n  Placement,\n  Side,\n  Coords,\n} from \"../types\";\n\nexport function getSide(placement: Placement): Side {\n  return placement.split(\"-\")[0] as Side;\n}\n\nexport function getAlignment(placement: Placement): Alignment | undefined {\n  return placement.split(\"-\")[1] as Alignment | undefined;\n}\n\nexport function isVerticalSide(side: Side): boolean {\n  return side === \"top\" || side === \"bottom\";\n}\n\nexport function getOppositeSide(side: Side): Side {\n  const map: Record<Side, Side> = {\n    top: \"bottom\",\n    bottom: \"top\",\n    left: \"right\",\n    right: \"left\",\n  };\n  return map[side];\n}\n\nexport function getOppositePlacement(placement: Placement): Placement {\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  const opposite = getOppositeSide(side);\n  return (alignment ? `${opposite}-${alignment}` : opposite) as Placement;\n}\n\n/** 同一条边上，start <-> end 互换（用于 shift 后仍溢出时的对齐翻转） */\nexport function getOppositeAlignmentPlacement(placement: Placement): Placement {\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  if (!alignment) return placement;\n  const opposite = alignment === \"start\" ? \"end\" : \"start\";\n  return `${side}-${opposite}` as Placement;\n}\n\n/**\n * 根据 reference / floating 的矩形与 placement，计算 floating 左上角坐标。\n * 注意：这里只做“理想坐标”计算，不做视口裁剪，裁剪交给 shift middleware。\n */\nexport function computeCoordsFromPlacement(\n  rects: ElementRects,\n  placement: Placement,\n): Coords {\n  const { reference, floating } = rects;\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  const vertical = isVerticalSide(side);\n\n  const centerX = reference.x + reference.width / 2 - floating.width / 2;\n  const centerY = reference.y + reference.height / 2 - floating.height / 2;\n\n  let x: number;\n  let y: number;\n\n  switch (side) {\n    case \"top\":\n      x = centerX;\n      y = reference.y - floating.height;\n      break;\n    case \"bottom\":\n      x = centerX;\n      y = reference.y + reference.height;\n      break;\n    case \"left\":\n      x = reference.x - floating.width;\n      y = centerY;\n      break;\n    case \"right\":\n      x = reference.x + reference.width;\n      y = centerY;\n      break;\n  }\n\n  if (alignment === \"start\") {\n    if (vertical) x = reference.x;\n    else y = reference.y;\n  } else if (alignment === \"end\") {\n    if (vertical) x = reference.x + reference.width - floating.width;\n    else y = reference.y + reference.height - floating.height;\n  }\n\n  return { x, y };\n}\n\nexport const ALL_PLACEMENTS: Placement[] = [\n  \"top\",\n  \"top-start\",\n  \"top-end\",\n  \"right\",\n  \"right-start\",\n  \"right-end\",\n  \"bottom\",\n  \"bottom-start\",\n  \"bottom-end\",\n  \"left\",\n  \"left-start\",\n  \"left-end\",\n];\n"],"mappings":";AAQA,SAAgB,EAAQ,GAA4B;CAClD,OAAO,EAAU,MAAM,GAAG,CAAC,CAAC;AAC9B;AAEA,SAAgB,EAAa,GAA6C;CACxE,OAAO,EAAU,MAAM,GAAG,CAAC,CAAC;AAC9B;AAEA,SAAgB,EAAe,GAAqB;CAClD,OAAO,MAAS,SAAS,MAAS;AACpC;AAEA,SAAgB,EAAgB,GAAkB;CAOhD,OAAO;EALL,KAAK;EACL,QAAQ;EACR,MAAM;EACN,OAAO;CAEF,EAAI;AACb;AAEA,SAAgB,EAAqB,GAAiC;CACpE,IAAM,IAAO,EAAQ,CAAS,GACxB,IAAY,EAAa,CAAS,GAClC,IAAW,EAAgB,CAAI;CACrC,OAAQ,IAAY,GAAG,EAAS,GAAG,MAAc;AACnD;AAeA,SAAgB,EACd,GACA,GACQ;CACR,IAAM,EAAE,cAAW,gBAAa,GAC1B,IAAO,EAAQ,CAAS,GACxB,IAAY,EAAa,CAAS,GAClC,IAAW,EAAe,CAAI,GAE9B,IAAU,EAAU,IAAI,EAAU,QAAQ,IAAI,EAAS,QAAQ,GAC/D,IAAU,EAAU,IAAI,EAAU,SAAS,IAAI,EAAS,SAAS,GAEnE,GACA;CAEJ,QAAQ,GAAR;EACE,KAAK;GAEH,AADA,IAAI,GACJ,IAAI,EAAU,IAAI,EAAS;GAC3B;EACF,KAAK;GAEH,AADA,IAAI,GACJ,IAAI,EAAU,IAAI,EAAU;GAC5B;EACF,KAAK;GAEH,AADA,IAAI,EAAU,IAAI,EAAS,OAC3B,IAAI;GACJ;EACF,KAAK,SAEH,AADA,IAAI,EAAU,IAAI,EAAU,OAC5B,IAAI;CAER;CAUA,OARI,MAAc,UACZ,IAAU,IAAI,EAAU,IACvB,IAAI,EAAU,IACV,MAAc,UACnB,IAAU,IAAI,EAAU,IAAI,EAAU,QAAQ,EAAS,QACtD,IAAI,EAAU,IAAI,EAAU,SAAS,EAAS,SAG9C;EAAE;EAAG;CAAE;AAChB"}
+{"version":3,"file":"placement.js","names":["getSide","placement","getAlignment","isVerticalSide","side","getOppositeSide","getOppositePlacement","alignment","opposite","computeCoordsFromPlacement","rects","vertical","centerX","reference","floating","centerY","x","y"],"sources":["../../../../src/lib/positioner/core/placement.ts"],"sourcesContent":["import type {\n  Alignment,\n  ElementRects,\n  Placement,\n  Side,\n  Coords,\n} from \"../types\";\n\nexport function getSide(placement: Placement): Side {\n  return placement.split(\"-\")[0] as Side;\n}\n\nexport function getAlignment(placement: Placement): Alignment | undefined {\n  return placement.split(\"-\")[1] as Alignment | undefined;\n}\n\nexport function isVerticalSide(side: Side): boolean {\n  return side === \"top\" || side === \"bottom\";\n}\n\nexport function getOppositeSide(side: Side): Side {\n  const map: Record<Side, Side> = {\n    top: \"bottom\",\n    bottom: \"top\",\n    left: \"right\",\n    right: \"left\",\n  };\n  return map[side];\n}\n\nexport function getOppositePlacement(placement: Placement): Placement {\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  const opposite = getOppositeSide(side);\n  return (alignment ? `${opposite}-${alignment}` : opposite) as Placement;\n}\n\n/** 同一条边上，start <-> end 互换（用于 shift 后仍溢出时的对齐翻转） */\nexport function getOppositeAlignmentPlacement(placement: Placement): Placement {\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  if (!alignment) return placement;\n  const opposite = alignment === \"start\" ? \"end\" : \"start\";\n  return `${side}-${opposite}` as Placement;\n}\n\n/**\n * 根据 reference / floating 的矩形与 placement，计算 floating 左上角坐标。\n * 注意：这里只做“理想坐标”计算，不做视口裁剪，裁剪交给 shift middleware。\n */\nexport function computeCoordsFromPlacement(\n  rects: ElementRects,\n  placement: Placement,\n): Coords {\n  const { reference, floating } = rects;\n  const side = getSide(placement);\n  const alignment = getAlignment(placement);\n  const vertical = isVerticalSide(side);\n\n  const centerX = reference.x + reference.width / 2 - floating.width / 2;\n  const centerY = reference.y + reference.height / 2 - floating.height / 2;\n\n  let x: number;\n  let y: number;\n\n  switch (side) {\n    case \"top\":\n      x = centerX;\n      y = reference.y - floating.height;\n      break;\n    case \"bottom\":\n      x = centerX;\n      y = reference.y + reference.height;\n      break;\n    case \"left\":\n      x = reference.x - floating.width;\n      y = centerY;\n      break;\n    case \"right\":\n      x = reference.x + reference.width;\n      y = centerY;\n      break;\n  }\n\n  if (alignment === \"start\") {\n    if (vertical) x = reference.x;\n    else y = reference.y;\n  } else if (alignment === \"end\") {\n    if (vertical) x = reference.x + reference.width - floating.width;\n    else y = reference.y + reference.height - floating.height;\n  }\n\n  return { x, y };\n}\n\nexport const ALL_PLACEMENTS: Placement[] = [\n  \"top\",\n  \"top-start\",\n  \"top-end\",\n  \"right\",\n  \"right-start\",\n  \"right-end\",\n  \"bottom\",\n  \"bottom-start\",\n  \"bottom-end\",\n  \"left\",\n  \"left-start\",\n  \"left-end\",\n];\n"],"mappings":";AAQA,SAAgBA,EAAQ,GAA4B;CAClD,OAAOC,EAAU,MAAM,GAAG,CAAC,CAAC;AAC9B;AAEA,SAAgBC,EAAa,GAA6C;CACxE,OAAOD,EAAU,MAAM,GAAG,CAAC,CAAC;AAC9B;AAEA,SAAgBE,EAAe,GAAqB;CAClD,OAAOC,MAAS,SAASA,MAAS;AACpC;AAEA,SAAgBC,EAAgB,GAAkB;CAOhD,OAAO;EALL,KAAK;EACL,QAAQ;EACR,MAAM;EACN,OAAO;CAEF,EAAID;AACb;AAEA,SAAgBE,EAAqB,GAAiC;CACpE,IAAMF,IAAOJ,EAAQC,CAAS,GACxBM,IAAYL,EAAaD,CAAS,GAClCO,IAAWH,EAAgBD,CAAI;CACrC,OAAQG,IAAY,GAAGC,EAAS,GAAGD,MAAcC;AACnD;AAeA,SAAgBC,EACd,GACA,GACQ;CACR,IAAM,EAAE,cAAW,gBAAaC,GAC1BN,IAAOJ,EAAQC,CAAS,GACxBM,IAAYL,EAAaD,CAAS,GAClCU,IAAWR,EAAeC,CAAI,GAE9BQ,IAAUC,EAAU,IAAIA,EAAU,QAAQ,IAAIC,EAAS,QAAQ,GAC/DC,IAAUF,EAAU,IAAIA,EAAU,SAAS,IAAIC,EAAS,SAAS,GAEnEE,GACAC;CAEJ,QAAQb,GAAR;EACE,KAAK;GAEH,AADA,IAAIQ,GACJ,IAAIC,EAAU,IAAIC,EAAS;GAC3B;EACF,KAAK;GAEH,AADA,IAAIF,GACJ,IAAIC,EAAU,IAAIA,EAAU;GAC5B;EACF,KAAK;GAEH,AADA,IAAIA,EAAU,IAAIC,EAAS,OAC3B,IAAIC;GACJ;EACF,KAAK,SAEH,AADA,IAAIF,EAAU,IAAIA,EAAU,OAC5B,IAAIE;CAER;CAUA,OARIR,MAAc,UACZI,IAAU,IAAIE,EAAU,IACvB,IAAIA,EAAU,IACVN,MAAc,UACnBI,IAAU,IAAIE,EAAU,IAAIA,EAAU,QAAQC,EAAS,QACtD,IAAID,EAAU,IAAIA,EAAU,SAASC,EAAS,SAG9C;EAAE;EAAG;CAAE;AAChB"}

package/dist/lib/positioner/create-positioner.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-positioner.js","names":[],"sources":["../../../src/lib/positioner/create-positioner.ts"],"sourcesContent":["import {\n  createEffect,\n  createMemo,\n  createSignal,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport type {\n  Middleware,\n  MiddlewareData,\n  Placement,\n  ReferenceElement,\n  Strategy,\n} from \"./types\";\nimport { computePosition } from \"./core/compute-position\";\nimport {\n  autoUpdate as attachAutoUpdate,\n  type AutoUpdateOptions,\n} from \"./auto-update\";\n\ntype MaybeAccessor<T> = T | Accessor<T>;\n\nfunction unwrap<T>(value: MaybeAccessor<T> | undefined, fallback: T): T {\n  if (value === undefined) return fallback;\n  return typeof value === \"function\" ? (value as Accessor<T>)() : value;\n}\n\nexport interface CreatePositionerOptions {\n  /** 期望的初始/首选摆放位置，默认 'bottom' */\n  placement?: MaybeAccessor<Placement>;\n  /** 定位方式：'absolute' 需要 floating 挂在 body 下且无非 static 定位祖先；不确定就用 'fixed' */\n  strategy?: MaybeAccessor<Strategy>;\n  /** middleware 数组，顺序执行，如 [offset(8), flip(), shift({padding: 8})] */\n  middleware?: MaybeAccessor<Middleware[]>;\n  /** 是否在滚动/尺寸变化时自动重新计算，默认 true；也可传细粒度配置 */\n  autoUpdate?: boolean | AutoUpdateOptions;\n}\n\nexport interface Positioner {\n  /** floating 元素相对定位坐标系的 x（细粒度信号，只在数值变化时更新） */\n  x: Accessor<number>;\n  /** floating 元素相对定位坐标系的 y（细粒度信号，只在数值变化时更新） */\n  y: Accessor<number>;\n  /** 经过 middleware（如 flip）调整后的最终 placement */\n  placement: Accessor<Placement>;\n  /** 实际生效的定位策略 */\n  strategy: Accessor<Strategy>;\n  /** 各 middleware 产出的附加数据，例如 arrow 的偏移量 */\n  middlewareData: Accessor<MiddlewareData>;\n  /** 是否已完成至少一次定位计算，可用于首次渲染前隐藏 floating 元素避免闪烁 */\n  isPositioned: Accessor<boolean>;\n  /** 手动触发一次重新计算 */\n  update: () => void;\n  /** 可直接展开到 style 上的便捷样式对象 */\n  floatingStyles: Accessor<{\n    position: Strategy;\n    top: string;\n    left: string;\n    transform: string;\n  }>;\n}\n\n/**\n * Solid 的细粒度浮窗定位 primitive。\n *\n * 传入 reference / floating 两个元素访问器，返回一组独立的响应式信号\n * （x、y、placement 等分别更新，不会因为其中一个变化而让另一个也重新渲染），\n * 上层组件（tooltip / dropdown / popover）只需订阅自己关心的信号。\n *\n * @example\n * ```tsx\n * const [reference, setReference] = createSignal<HTMLElement>();\n * const [floating, setFloating] = createSignal<HTMLElement>();\n * const pos = createPositioner(reference, floating, {\n *   placement: \"bottom-start\",\n *   middleware: [offset(8), flip(), shift({ padding: 8 })],\n * });\n *\n * <button ref={setReference}>trigger</button>\n * <Show when={open()}>\n *   <Portal>\n *     <div ref={setFloating} style={pos.floatingStyles()}>内容</div>\n *   </Portal>\n * </Show>\n * ```\n */\nexport function createPositioner(\n  reference: Accessor<ReferenceElement | null | undefined>,\n  floating: Accessor<HTMLElement | null | undefined>,\n  options: CreatePositionerOptions = {},\n): Positioner {\n  const [x, setX] = createSignal(0);\n  const [y, setY] = createSignal(0);\n  const [placement, setPlacement] = createSignal<Placement>(\n    unwrap(options.placement, \"bottom\"),\n  );\n  const [strategy, setStrategy] = createSignal<Strategy>(\n    unwrap(options.strategy, \"absolute\"),\n  );\n  const [middlewareData, setMiddlewareData] = createSignal<MiddlewareData>({});\n  const [isPositioned, setIsPositioned] = createSignal(false);\n\n  const update = () => {\n    const refEl = reference();\n    const floatEl = floating();\n    if (!refEl || !floatEl) {\n      setIsPositioned(false);\n      return;\n    }\n\n    const result = computePosition(refEl, floatEl, {\n      placement: unwrap(options.placement, \"bottom\"),\n      strategy: unwrap(options.strategy, \"absolute\"),\n      middleware: unwrap(options.middleware, []),\n    });\n\n    // 每个 setter 只有在值真正变化时才会触发下游更新（Solid 信号默认行为），\n    // 这就是“细粒度”的关键：只订阅 x 的节点不会因为 middlewareData 变化而重跑。\n    setX(result.x);\n    setY(result.y);\n    setPlacement(result.placement);\n    setStrategy(result.strategy);\n    setMiddlewareData(result.middlewareData);\n    setIsPositioned(true);\n  };\n\n  createEffect(() => {\n    const refEl = reference();\n    const floatEl = floating();\n    // 主动读取，建立依赖：placement/strategy/middleware 若是响应式访问器，\n    // 变化时也会重新进入这个 effect 并重新计算 + 重新挂 autoUpdate。\n    unwrap(options.placement, \"bottom\");\n    unwrap(options.strategy, \"absolute\");\n    unwrap(options.middleware, []);\n\n    if (!refEl || !floatEl) {\n      setIsPositioned(false);\n      return;\n    }\n\n    update();\n\n    if (options.autoUpdate !== false) {\n      const cleanup = attachAutoUpdate(\n        refEl,\n        floatEl,\n        update,\n        typeof options.autoUpdate === \"object\" ? options.autoUpdate : {},\n      );\n      onCleanup(cleanup);\n    }\n  });\n\n  const floatingStyles = createMemo(() => ({\n    position: strategy(),\n    top: \"0px\",\n    left: \"0px\",\n    // 用 transform 而非 top/left 赋值，避免触发 layout，性能更好\n    transform: `translate(${Math.round(x())}px, ${Math.round(y())}px)`,\n  }));\n\n  return {\n    x,\n    y,\n    placement,\n    strategy,\n    middlewareData,\n    isPositioned,\n    update,\n    floatingStyles,\n  };\n}\n"],"mappings":";;;;AAsBA,SAAS,EAAU,GAAqC,GAAgB;CAEtE,OADI,MAAU,KAAA,IAAkB,IACzB,OAAO,KAAU,aAAc,EAAsB,IAAI;AAClE;AA6DA,SAAgB,EACd,GACA,GACA,IAAmC,CAAC,GACxB;CACZ,IAAM,CAAC,GAAG,KAAQ,EAAa,CAAC,GAC1B,CAAC,GAAG,KAAQ,EAAa,CAAC,GAC1B,CAAC,GAAW,KAAgB,EAChC,EAAO,EAAQ,WAAW,QAAQ,CACpC,GACM,CAAC,GAAU,KAAe,EAC9B,EAAO,EAAQ,UAAU,UAAU,CACrC,GACM,CAAC,GAAgB,KAAqB,EAA6B,CAAC,CAAC,GACrE,CAAC,GAAc,KAAmB,EAAa,EAAK,GAEpD,UAAe;EACnB,IAAM,IAAQ,EAAU,GAClB,IAAU,EAAS;EACzB,IAAI,CAAC,KAAS,CAAC,GAAS;GACtB,EAAgB,EAAK;GACrB;EACF;EAEA,IAAM,IAAS,EAAgB,GAAO,GAAS;GAC7C,WAAW,EAAO,EAAQ,WAAW,QAAQ;GAC7C,UAAU,EAAO,EAAQ,UAAU,UAAU;GAC7C,YAAY,EAAO,EAAQ,YAAY,CAAC,CAAC;EAC3C,CAAC;EASD,AALA,EAAK,EAAO,CAAC,GACb,EAAK,EAAO,CAAC,GACb,EAAa,EAAO,SAAS,GAC7B,EAAY,EAAO,QAAQ,GAC3B,EAAkB,EAAO,cAAc,GACvC,EAAgB,EAAI;CACtB;CAqCA,OAnCA,QAAmB;EACjB,IAAM,IAAQ,EAAU,GAClB,IAAU,EAAS;EAOzB,IAJA,EAAO,EAAQ,WAAW,QAAQ,GAClC,EAAO,EAAQ,UAAU,UAAU,GACnC,EAAO,EAAQ,YAAY,CAAC,CAAC,GAEzB,CAAC,KAAS,CAAC,GAAS;GACtB,EAAgB,EAAK;GACrB;EACF;EAIA,IAFA,EAAO,GAEH,EAAQ,eAAe,IAAO;GAChC,IAAM,IAAU,EACd,GACA,GACA,GACA,OAAO,EAAQ,cAAe,WAAW,EAAQ,aAAa,CAAC,CACjE;GACA,EAAU,CAAO;EACnB;CACF,CAAC,GAUM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAhBqB,SAAkB;GACvC,UAAU,EAAS;GACnB,KAAK;GACL,MAAM;GAEN,WAAW,aAAa,KAAK,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,EAAE;EAChE,EAUE;CACF;AACF"}
+{"version":3,"file":"create-positioner.js","names":["attachAutoUpdate","unwrap","value","fallback","createPositioner","x","setX","createSignal","y","setY","placement","setPlacement","options","strategy","setStrategy","middlewareData","setMiddlewareData","isPositioned","setIsPositioned","update","refEl","reference","floatEl","floating","result","computePosition","createEffect","cleanup","autoUpdate","createMemo"],"sources":["../../../src/lib/positioner/create-positioner.ts"],"sourcesContent":["import {\n  createEffect,\n  createMemo,\n  createSignal,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport type {\n  Middleware,\n  MiddlewareData,\n  Placement,\n  ReferenceElement,\n  Strategy,\n} from \"./types\";\nimport { computePosition } from \"./core/compute-position\";\nimport {\n  autoUpdate as attachAutoUpdate,\n  type AutoUpdateOptions,\n} from \"./auto-update\";\n\ntype MaybeAccessor<T> = T | Accessor<T>;\n\nfunction unwrap<T>(value: MaybeAccessor<T> | undefined, fallback: T): T {\n  if (value === undefined) return fallback;\n  return typeof value === \"function\" ? (value as Accessor<T>)() : value;\n}\n\nexport interface CreatePositionerOptions {\n  /** 期望的初始/首选摆放位置，默认 'bottom' */\n  placement?: MaybeAccessor<Placement>;\n  /** 定位方式：'absolute' 需要 floating 挂在 body 下且无非 static 定位祖先；不确定就用 'fixed' */\n  strategy?: MaybeAccessor<Strategy>;\n  /** middleware 数组，顺序执行，如 [offset(8), flip(), shift({padding: 8})] */\n  middleware?: MaybeAccessor<Middleware[]>;\n  /** 是否在滚动/尺寸变化时自动重新计算，默认 true；也可传细粒度配置 */\n  autoUpdate?: boolean | AutoUpdateOptions;\n}\n\nexport interface Positioner {\n  /** floating 元素相对定位坐标系的 x（细粒度信号，只在数值变化时更新） */\n  x: Accessor<number>;\n  /** floating 元素相对定位坐标系的 y（细粒度信号，只在数值变化时更新） */\n  y: Accessor<number>;\n  /** 经过 middleware（如 flip）调整后的最终 placement */\n  placement: Accessor<Placement>;\n  /** 实际生效的定位策略 */\n  strategy: Accessor<Strategy>;\n  /** 各 middleware 产出的附加数据，例如 arrow 的偏移量 */\n  middlewareData: Accessor<MiddlewareData>;\n  /** 是否已完成至少一次定位计算，可用于首次渲染前隐藏 floating 元素避免闪烁 */\n  isPositioned: Accessor<boolean>;\n  /** 手动触发一次重新计算 */\n  update: () => void;\n  /** 可直接展开到 style 上的便捷样式对象 */\n  floatingStyles: Accessor<{\n    position: Strategy;\n    top: string;\n    left: string;\n    transform: string;\n  }>;\n}\n\n/**\n * Solid 的细粒度浮窗定位 primitive。\n *\n * 传入 reference / floating 两个元素访问器，返回一组独立的响应式信号\n * （x、y、placement 等分别更新，不会因为其中一个变化而让另一个也重新渲染），\n * 上层组件（tooltip / dropdown / popover）只需订阅自己关心的信号。\n *\n * @example\n * ```tsx\n * const [reference, setReference] = createSignal<HTMLElement>();\n * const [floating, setFloating] = createSignal<HTMLElement>();\n * const pos = createPositioner(reference, floating, {\n *   placement: \"bottom-start\",\n *   middleware: [offset(8), flip(), shift({ padding: 8 })],\n * });\n *\n * <button ref={setReference}>trigger</button>\n * <Show when={open()}>\n *   <Portal>\n *     <div ref={setFloating} style={pos.floatingStyles()}>内容</div>\n *   </Portal>\n * </Show>\n * ```\n */\nexport function createPositioner(\n  reference: Accessor<ReferenceElement | null | undefined>,\n  floating: Accessor<HTMLElement | null | undefined>,\n  options: CreatePositionerOptions = {},\n): Positioner {\n  const [x, setX] = createSignal(0);\n  const [y, setY] = createSignal(0);\n  const [placement, setPlacement] = createSignal<Placement>(\n    unwrap(options.placement, \"bottom\"),\n  );\n  const [strategy, setStrategy] = createSignal<Strategy>(\n    unwrap(options.strategy, \"absolute\"),\n  );\n  const [middlewareData, setMiddlewareData] = createSignal<MiddlewareData>({});\n  const [isPositioned, setIsPositioned] = createSignal(false);\n\n  const update = () => {\n    const refEl = reference();\n    const floatEl = floating();\n    if (!refEl || !floatEl) {\n      setIsPositioned(false);\n      return;\n    }\n\n    const result = computePosition(refEl, floatEl, {\n      placement: unwrap(options.placement, \"bottom\"),\n      strategy: unwrap(options.strategy, \"absolute\"),\n      middleware: unwrap(options.middleware, []),\n    });\n\n    // 每个 setter 只有在值真正变化时才会触发下游更新（Solid 信号默认行为），\n    // 这就是“细粒度”的关键：只订阅 x 的节点不会因为 middlewareData 变化而重跑。\n    setX(result.x);\n    setY(result.y);\n    setPlacement(result.placement);\n    setStrategy(result.strategy);\n    setMiddlewareData(result.middlewareData);\n    setIsPositioned(true);\n  };\n\n  createEffect(() => {\n    const refEl = reference();\n    const floatEl = floating();\n    // 主动读取，建立依赖：placement/strategy/middleware 若是响应式访问器，\n    // 变化时也会重新进入这个 effect 并重新计算 + 重新挂 autoUpdate。\n    unwrap(options.placement, \"bottom\");\n    unwrap(options.strategy, \"absolute\");\n    unwrap(options.middleware, []);\n\n    if (!refEl || !floatEl) {\n      setIsPositioned(false);\n      return;\n    }\n\n    update();\n\n    if (options.autoUpdate !== false) {\n      const cleanup = attachAutoUpdate(\n        refEl,\n        floatEl,\n        update,\n        typeof options.autoUpdate === \"object\" ? options.autoUpdate : {},\n      );\n      onCleanup(cleanup);\n    }\n  });\n\n  const floatingStyles = createMemo(() => ({\n    position: strategy(),\n    top: \"0px\",\n    left: \"0px\",\n    // 用 transform 而非 top/left 赋值，避免触发 layout，性能更好\n    transform: `translate(${Math.round(x())}px, ${Math.round(y())}px)`,\n  }));\n\n  return {\n    x,\n    y,\n    placement,\n    strategy,\n    middlewareData,\n    isPositioned,\n    update,\n    floatingStyles,\n  };\n}\n"],"mappings":";;;;AAsBA,SAASC,EAAU,GAAqC,GAAgB;CAEtE,OADIC,MAAU,KAAA,IAAkBC,IACzB,OAAOD,KAAU,aAAcA,EAAsB,IAAIA;AAClE;AA6DA,SAAgBE,EACd,GACA,GACA,IAAmC,CAAC,GACxB;CACZ,IAAM,CAACC,GAAGC,KAAQC,EAAa,CAAC,GAC1B,CAACC,GAAGC,KAAQF,EAAa,CAAC,GAC1B,CAACG,GAAWC,KAAgBJ,EAChCN,EAAOW,EAAQ,WAAW,QAAQ,CACpC,GACM,CAACC,GAAUC,KAAeP,EAC9BN,EAAOW,EAAQ,UAAU,UAAU,CACrC,GACM,CAACG,GAAgBC,KAAqBT,EAA6B,CAAC,CAAC,GACrE,CAACU,GAAcC,KAAmBX,EAAa,EAAK,GAEpDY,UAAe;EACnB,IAAMC,IAAQC,EAAU,GAClBC,IAAUC,EAAS;EACzB,IAAI,CAACH,KAAS,CAACE,GAAS;GACtB,EAAgB,EAAK;GACrB;EACF;EAEA,IAAME,IAASC,EAAgBL,GAAOE,GAAS;GAC7C,WAAWrB,EAAOW,EAAQ,WAAW,QAAQ;GAC7C,UAAUX,EAAOW,EAAQ,UAAU,UAAU;GAC7C,YAAYX,EAAOW,EAAQ,YAAY,CAAC,CAAC;EAC3C,CAAC;EASD,AALAN,EAAKkB,EAAO,CAAC,GACbf,EAAKe,EAAO,CAAC,GACbb,EAAaa,EAAO,SAAS,GAC7BV,EAAYU,EAAO,QAAQ,GAC3BR,EAAkBQ,EAAO,cAAc,GACvCN,EAAgB,EAAI;CACtB;CAqCA,OAnCAQ,QAAmB;EACjB,IAAMN,IAAQC,EAAU,GAClBC,IAAUC,EAAS;EAOzB,IAJAtB,EAAOW,EAAQ,WAAW,QAAQ,GAClCX,EAAOW,EAAQ,UAAU,UAAU,GACnCX,EAAOW,EAAQ,YAAY,CAAC,CAAC,GAEzB,CAACQ,KAAS,CAACE,GAAS;GACtB,EAAgB,EAAK;GACrB;EACF;EAIA,IAFAH,EAAO,GAEHP,EAAQ,eAAe,IAAO;GAChC,IAAMe,IAAU3B,EACdoB,GACAE,GACAH,GACA,OAAOP,EAAQ,cAAe,WAAWA,EAAQ,aAAa,CAAC,CACjE;GACA,EAAUe,CAAO;EACnB;CACF,CAAC,GAUM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAhBqBE,SAAkB;GACvC,UAAUhB,EAAS;GACnB,KAAK;GACL,MAAM;GAEN,WAAW,aAAa,KAAK,MAAMR,EAAE,CAAC,EAAE,MAAM,KAAK,MAAMG,EAAE,CAAC,EAAE;EAChE,EAUE;CACF;AACF"}

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

@@ -4,6 +4,7 @@ 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 { createVirtualElement } from './virtual-element';
 export type { PointOptions } from './virtual-element';
 export { offset, shift, flip, arrow, size, hide, containingBlockOffset, } from './middleware';

package/dist/lib/positioner/middleware/arrow.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrow.js","names":[],"sources":["../../../../src/lib/positioner/middleware/arrow.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\nimport { getSide, isVerticalSide } from \"../core/placement\";\n\nexport interface ArrowOptions {\n  /**\n   * 箭头 DOM 元素，或返回该元素的函数（Solid 场景下常传一个访问器）。\n   * 类型是 Element 而不是 HTMLElement，是为了兼容 SVG 场景下用 <svg> 画箭头的写法\n   * （SVGSVGElement 不是 HTMLElement 的子类型）。\n   */\n  element: Element | undefined | (() => Element | undefined);\n  /** 箭头距 floating 边缘的最小间距，默认 4 */\n  padding?: number;\n}\n\nexport interface ArrowData {\n  x?: number;\n  y?: number;\n  /** 箭头应贴靠 floating 的哪一侧（与 floating 的 placement 主边相同） */\n  side: ReturnType<typeof getSide>;\n}\n\n/**\n * 计算箭头相对 floating 元素左上角的 x/y 偏移，\n * 使其始终指向 reference 元素中心，同时不超出 floating 边界。\n */\nexport function arrow(options: ArrowOptions): Middleware {\n  return {\n    name: \"arrow\",\n    fn(state) {\n      const el =\n        typeof options.element === \"function\"\n          ? options.element()\n          : options.element;\n      const side = getSide(state.placement);\n      if (!el) return { data: { side } };\n\n      const { rects, x, y } = state;\n      const padding = options.padding ?? 4;\n      const vertical = isVerticalSide(side);\n\n      // 用 getBoundingClientRect 而不是 offsetWidth/offsetHeight：后者只有\n      // HTMLElement 才有，SVG 元素（比如 <svg>/<g>）没有这两个属性；\n      // getBoundingClientRect 对所有 Element 都通用，只要箭头本身没有做\n      // CSS transform（本库的 TooltipArrow 就是特意不用 rotate 来避免这个问题）。\n      const arrowRect = el.getBoundingClientRect();\n      const arrowWidth = arrowRect.width || 0;\n      const arrowHeight = arrowRect.height || 0;\n\n      // 关键：floating 的宽高现读现用，不用 state.rects.floating（那是这一轮\n      // computePosition 刚开始时缓存的值）。如果 arrow 前面排了 size 这类会\n      // 通过 apply 回调产生 DOM 副作用（比如响应式地改 max-width）的 middleware，\n      // 而且这次副作用刚好同步生效了，state.rects.floating 就会是“改之前”的\n      // 旧尺寸，用它算出来的箭头位置会带着一个固定的偏移量，跟最终实际渲染的\n      // 盒子宽度对不上。这里现场重新measure，保证永远拿到当下最新的尺寸。\n      const freshFloatingRect = state.elements.floating.getBoundingClientRect();\n      const axisLen = vertical\n        ? freshFloatingRect.width\n        : freshFloatingRect.height;\n      const arrowLen = vertical ? arrowWidth : arrowHeight;\n\n      // reference 中心点相对 floating 左上角的位置\n      const refCenter = vertical\n        ? rects.reference.x + rects.reference.width / 2 - x\n        : rects.reference.y + rects.reference.height / 2 - y;\n\n      let pos = refCenter - arrowLen / 2;\n      const min = padding;\n      const max = axisLen - arrowLen - padding;\n      pos = Math.min(Math.max(pos, min), Math.max(min, max));\n\n      const data: ArrowData = vertical ? { x: pos, side } : { y: pos, side };\n      return { data };\n    },\n  };\n}\n"],"mappings":";;AAyBA,SAAgB,EAAM,GAAmC;CACvD,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,IACJ,OAAO,EAAQ,WAAY,aACvB,EAAQ,QAAQ,IAChB,EAAQ,SACR,IAAO,EAAQ,EAAM,SAAS;GACpC,IAAI,CAAC,GAAI,OAAO,EAAE,MAAM,EAAE,QAAK,EAAE;GAEjC,IAAM,EAAE,UAAO,MAAG,SAAM,GAClB,IAAU,EAAQ,WAAW,GAC7B,IAAW,EAAe,CAAI,GAM9B,IAAY,EAAG,sBAAsB,GACrC,IAAa,EAAU,SAAS,GAChC,IAAc,EAAU,UAAU,GAQlC,IAAoB,EAAM,SAAS,SAAS,sBAAsB,GAClE,IAAU,IACZ,EAAkB,QAClB,EAAkB,QAChB,IAAW,IAAW,IAAa,GAOrC,KAJc,IACd,EAAM,UAAU,IAAI,EAAM,UAAU,QAAQ,IAAI,IAChD,EAAM,UAAU,IAAI,EAAM,UAAU,SAAS,IAAI,KAE/B,IAAW,GAC3B,IAAM,GACN,IAAM,IAAU,IAAW;GAIjC,OAHA,IAAM,KAAK,IAAI,KAAK,IAAI,GAAK,CAAG,GAAG,KAAK,IAAI,GAAK,CAAG,CAAC,GAG9C,EAAE,MADe,IAAW;IAAE,GAAG;IAAK;GAAK,IAAI;IAAE,GAAG;IAAK;GAAK,EACvD;EAChB;CACF;AACF"}
+{"version":3,"file":"arrow.js","names":["arrow","el","options","side","getSide","state","padding","vertical","isVerticalSide","arrowRect","arrowWidth","arrowHeight","freshFloatingRect","axisLen","arrowLen","pos","rects","x","y","min","max"],"sources":["../../../../src/lib/positioner/middleware/arrow.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\nimport { getSide, isVerticalSide } from \"../core/placement\";\n\nexport interface ArrowOptions {\n  /**\n   * 箭头 DOM 元素，或返回该元素的函数（Solid 场景下常传一个访问器）。\n   * 类型是 Element 而不是 HTMLElement，是为了兼容 SVG 场景下用 <svg> 画箭头的写法\n   * （SVGSVGElement 不是 HTMLElement 的子类型）。\n   */\n  element: Element | undefined | (() => Element | undefined);\n  /** 箭头距 floating 边缘的最小间距，默认 4 */\n  padding?: number;\n}\n\nexport interface ArrowData {\n  x?: number;\n  y?: number;\n  /** 箭头应贴靠 floating 的哪一侧（与 floating 的 placement 主边相同） */\n  side: ReturnType<typeof getSide>;\n}\n\n/**\n * 计算箭头相对 floating 元素左上角的 x/y 偏移，\n * 使其始终指向 reference 元素中心，同时不超出 floating 边界。\n */\nexport function arrow(options: ArrowOptions): Middleware {\n  return {\n    name: \"arrow\",\n    fn(state) {\n      const el =\n        typeof options.element === \"function\"\n          ? options.element()\n          : options.element;\n      const side = getSide(state.placement);\n      if (!el) return { data: { side } };\n\n      const { rects, x, y } = state;\n      const padding = options.padding ?? 4;\n      const vertical = isVerticalSide(side);\n\n      // 用 getBoundingClientRect 而不是 offsetWidth/offsetHeight：后者只有\n      // HTMLElement 才有，SVG 元素（比如 <svg>/<g>）没有这两个属性；\n      // getBoundingClientRect 对所有 Element 都通用，只要箭头本身没有做\n      // CSS transform（本库的 TooltipArrow 就是特意不用 rotate 来避免这个问题）。\n      const arrowRect = el.getBoundingClientRect();\n      const arrowWidth = arrowRect.width || 0;\n      const arrowHeight = arrowRect.height || 0;\n\n      // 关键：floating 的宽高现读现用，不用 state.rects.floating（那是这一轮\n      // computePosition 刚开始时缓存的值）。如果 arrow 前面排了 size 这类会\n      // 通过 apply 回调产生 DOM 副作用（比如响应式地改 max-width）的 middleware，\n      // 而且这次副作用刚好同步生效了，state.rects.floating 就会是“改之前”的\n      // 旧尺寸，用它算出来的箭头位置会带着一个固定的偏移量，跟最终实际渲染的\n      // 盒子宽度对不上。这里现场重新measure，保证永远拿到当下最新的尺寸。\n      const freshFloatingRect = state.elements.floating.getBoundingClientRect();\n      const axisLen = vertical\n        ? freshFloatingRect.width\n        : freshFloatingRect.height;\n      const arrowLen = vertical ? arrowWidth : arrowHeight;\n\n      // reference 中心点相对 floating 左上角的位置\n      const refCenter = vertical\n        ? rects.reference.x + rects.reference.width / 2 - x\n        : rects.reference.y + rects.reference.height / 2 - y;\n\n      let pos = refCenter - arrowLen / 2;\n      const min = padding;\n      const max = axisLen - arrowLen - padding;\n      pos = Math.min(Math.max(pos, min), Math.max(min, max));\n\n      const data: ArrowData = vertical ? { x: pos, side } : { y: pos, side };\n      return { data };\n    },\n  };\n}\n"],"mappings":";;AAyBA,SAAgBA,EAAM,GAAmC;CACvD,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAMC,IACJ,OAAOC,EAAQ,WAAY,aACvBA,EAAQ,QAAQ,IAChBA,EAAQ,SACRC,IAAOC,EAAQC,EAAM,SAAS;GACpC,IAAI,CAACJ,GAAI,OAAO,EAAE,MAAM,EAAE,QAAK,EAAE;GAEjC,IAAM,EAAE,UAAO,MAAG,SAAMI,GAClBC,IAAUJ,EAAQ,WAAW,GAC7BK,IAAWC,EAAeL,CAAI,GAM9BM,IAAYR,EAAG,sBAAsB,GACrCS,IAAaD,EAAU,SAAS,GAChCE,IAAcF,EAAU,UAAU,GAQlCG,IAAoBP,EAAM,SAAS,SAAS,sBAAsB,GAClEQ,IAAUN,IACZK,EAAkB,QAClBA,EAAkB,QAChBE,IAAWP,IAAWG,IAAaC,GAOrCI,KAJcR,IACdS,EAAM,UAAU,IAAIA,EAAM,UAAU,QAAQ,IAAIC,IAChDD,EAAM,UAAU,IAAIA,EAAM,UAAU,SAAS,IAAIE,KAE/BJ,IAAW,GAC3BK,IAAMb,GACNc,IAAMP,IAAUC,IAAWR;GAIjC,OAHA,IAAM,KAAK,IAAI,KAAK,IAAIS,GAAKI,CAAG,GAAG,KAAK,IAAIA,GAAKC,CAAG,CAAC,GAG9C,EAAE,MADeb,IAAW;IAAE,GAAGQ;IAAK;GAAK,IAAI;IAAE,GAAGA;IAAK;GAAK,EACvD;EAChB;CACF;AACF"}

package/dist/lib/positioner/middleware/containing-block-offset.js.map

@@ -1 +1 @@
-{"version":3,"file":"containing-block-offset.js","names":[],"sources":["../../../../src/lib/positioner/middleware/containing-block-offset.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\n\nconst TRANSFORM_STYLE_PROPS = [\n  \"transform\",\n  \"perspective\",\n  \"filter\",\n  \"backdropFilter\",\n] as const;\n\nfunction establishesContainingBlock(style: CSSStyleDeclaration): boolean {\n  for (const prop of TRANSFORM_STYLE_PROPS) {\n    const value = style[prop as keyof CSSStyleDeclaration] as\n      | string\n      | undefined;\n    if (value && value !== \"none\") return true;\n  }\n  const willChange = style.willChange || \"\";\n  if (/transform|perspective|filter/.test(willChange)) return true;\n  const contain = style.contain || \"\";\n  if (/paint|layout|strict|content/.test(contain)) return true;\n  return false;\n}\n\n/**\n * 修正因祖先元素设置了 transform / filter / perspective / backdrop-filter /\n * will-change / contain 等 CSS 属性，导致 position:fixed（部分情况下\n * position:absolute 也一样）的包含块被从“视口”重新定义成该祖先自身，\n * 从而让按视口坐标算出来的 x/y 出现系统性偏移的问题。\n *\n * 典型症状：demo 页面里定位完全正常，放进真实项目（尤其是大量使用\n * transform 做拖拽/缩放/面板动画的应用，比如设计工具、看板、画布编辑器）\n * 后，浮层整体固定偏移某个方向，但相对位置关系（比如箭头跟着内容一起偏）\n * 保持不变——这正是“坐标系被祖先重新定义”而不是“定位算法算错了”的特征。\n *\n * 原理：从 floating 元素实际的 DOM 父节点开始向上查找，找到第一个会重新\n * 定义包含块的祖先，用它的 getBoundingClientRect() 反推出这个“意外包含块”\n * 相对视口的偏移量，从最终坐标里减掉，抵消这个偏移。\n *\n * 局限：只处理纯平移类的偏移（比如 translate、面板展开动画、GPU 加速常见的\n * translateZ(0)）。如果那个祖先同时还做了 scale/rotate，这里不会做矩阵换算，\n * 位置依然会有偏差——遇到这种情况，更彻底的办法是让 Portal 挂载点脱离那个\n * 祖先（比如手动把挂载点换成真正不受影响的 document.body，而不是应用内部\n * 某个嵌套很深的容器）。\n *\n * 建议放在 middleware 数组的最后一位——它修正的是“最终要写进 DOM 的坐标”，\n * 前面 offset/flip/shift/size/arrow 等都在统一的视口坐标系里计算，不受影响，\n * 只有真正落地前的这一步需要额外修正。\n */\nexport function containingBlockOffset(): Middleware {\n  return {\n    name: \"containingBlockOffset\",\n    fn(state) {\n      const floatingEl = state.elements.floating;\n      let node: Element | null = floatingEl.parentElement;\n      let offsetX = 0;\n      let offsetY = 0;\n      let foundAncestor: Element | null = null;\n\n      while (node && node !== document.documentElement) {\n        const style = getComputedStyle(node);\n        if (establishesContainingBlock(style)) {\n          const rect = node.getBoundingClientRect();\n          offsetX = rect.x;\n          offsetY = rect.y;\n          foundAncestor = node;\n          break;\n        }\n        node = node.parentElement;\n      }\n\n      if (!foundAncestor || (offsetX === 0 && offsetY === 0)) {\n        return { data: { ancestor: null } };\n      }\n\n      return {\n        x: state.x - offsetX,\n        y: state.y - offsetY,\n        data: { ancestor: foundAncestor, offsetX, offsetY },\n      };\n    },\n  };\n}\n"],"mappings":";AAEA,IAAM,IAAwB;CAC5B;CACA;CACA;CACA;AACF;AAEA,SAAS,EAA2B,GAAqC;CACvE,KAAK,IAAM,KAAQ,GAAuB;EACxC,IAAM,IAAQ,EAAM;EAGpB,IAAI,KAAS,MAAU,QAAQ,OAAO;CACxC;CACA,IAAM,IAAa,EAAM,cAAc;CACvC,IAAI,+BAA+B,KAAK,CAAU,GAAG,OAAO;CAC5D,IAAM,IAAU,EAAM,WAAW;CAEjC,OADA,EAAI,8BAA8B,KAAK,CAAO;AAEhD;AA2BA,SAAgB,IAAoC;CAClD,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GAER,IAAI,IADe,EAAM,SAAS,SACI,eAClC,IAAU,GACV,IAAU,GACV,IAAgC;GAEpC,OAAO,KAAQ,MAAS,SAAS,kBAAiB;IAEhD,IAAI,EADU,iBAAiB,CACA,CAAK,GAAG;KACrC,IAAM,IAAO,EAAK,sBAAsB;KAGxC,AAFA,IAAU,EAAK,GACf,IAAU,EAAK,GACf,IAAgB;KAChB;IACF;IACA,IAAO,EAAK;GACd;GAMA,OAJI,CAAC,KAAkB,MAAY,KAAK,MAAY,IAC3C,EAAE,MAAM,EAAE,UAAU,KAAK,EAAE,IAG7B;IACL,GAAG,EAAM,IAAI;IACb,GAAG,EAAM,IAAI;IACb,MAAM;KAAE,UAAU;KAAe;KAAS;IAAQ;GACpD;EACF;CACF;AACF"}
+{"version":3,"file":"containing-block-offset.js","names":["TRANSFORM_STYLE_PROPS","establishesContainingBlock","prop","value","style","willChange","contain","containingBlockOffset","node","state","offsetX","offsetY","foundAncestor","rect"],"sources":["../../../../src/lib/positioner/middleware/containing-block-offset.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\n\nconst TRANSFORM_STYLE_PROPS = [\n  \"transform\",\n  \"perspective\",\n  \"filter\",\n  \"backdropFilter\",\n] as const;\n\nfunction establishesContainingBlock(style: CSSStyleDeclaration): boolean {\n  for (const prop of TRANSFORM_STYLE_PROPS) {\n    const value = style[prop as keyof CSSStyleDeclaration] as\n      | string\n      | undefined;\n    if (value && value !== \"none\") return true;\n  }\n  const willChange = style.willChange || \"\";\n  if (/transform|perspective|filter/.test(willChange)) return true;\n  const contain = style.contain || \"\";\n  if (/paint|layout|strict|content/.test(contain)) return true;\n  return false;\n}\n\n/**\n * 修正因祖先元素设置了 transform / filter / perspective / backdrop-filter /\n * will-change / contain 等 CSS 属性，导致 position:fixed（部分情况下\n * position:absolute 也一样）的包含块被从“视口”重新定义成该祖先自身，\n * 从而让按视口坐标算出来的 x/y 出现系统性偏移的问题。\n *\n * 典型症状：demo 页面里定位完全正常，放进真实项目（尤其是大量使用\n * transform 做拖拽/缩放/面板动画的应用，比如设计工具、看板、画布编辑器）\n * 后，浮层整体固定偏移某个方向，但相对位置关系（比如箭头跟着内容一起偏）\n * 保持不变——这正是“坐标系被祖先重新定义”而不是“定位算法算错了”的特征。\n *\n * 原理：从 floating 元素实际的 DOM 父节点开始向上查找，找到第一个会重新\n * 定义包含块的祖先，用它的 getBoundingClientRect() 反推出这个“意外包含块”\n * 相对视口的偏移量，从最终坐标里减掉，抵消这个偏移。\n *\n * 局限：只处理纯平移类的偏移（比如 translate、面板展开动画、GPU 加速常见的\n * translateZ(0)）。如果那个祖先同时还做了 scale/rotate，这里不会做矩阵换算，\n * 位置依然会有偏差——遇到这种情况，更彻底的办法是让 Portal 挂载点脱离那个\n * 祖先（比如手动把挂载点换成真正不受影响的 document.body，而不是应用内部\n * 某个嵌套很深的容器）。\n *\n * 建议放在 middleware 数组的最后一位——它修正的是“最终要写进 DOM 的坐标”，\n * 前面 offset/flip/shift/size/arrow 等都在统一的视口坐标系里计算，不受影响，\n * 只有真正落地前的这一步需要额外修正。\n */\nexport function containingBlockOffset(): Middleware {\n  return {\n    name: \"containingBlockOffset\",\n    fn(state) {\n      const floatingEl = state.elements.floating;\n      let node: Element | null = floatingEl.parentElement;\n      let offsetX = 0;\n      let offsetY = 0;\n      let foundAncestor: Element | null = null;\n\n      while (node && node !== document.documentElement) {\n        const style = getComputedStyle(node);\n        if (establishesContainingBlock(style)) {\n          const rect = node.getBoundingClientRect();\n          offsetX = rect.x;\n          offsetY = rect.y;\n          foundAncestor = node;\n          break;\n        }\n        node = node.parentElement;\n      }\n\n      if (!foundAncestor || (offsetX === 0 && offsetY === 0)) {\n        return { data: { ancestor: null } };\n      }\n\n      return {\n        x: state.x - offsetX,\n        y: state.y - offsetY,\n        data: { ancestor: foundAncestor, offsetX, offsetY },\n      };\n    },\n  };\n}\n"],"mappings":";AAEA,IAAMA,IAAwB;CAC5B;CACA;CACA;CACA;AACF;AAEA,SAASC,EAA2B,GAAqC;CACvE,KAAK,IAAMC,KAAQF,GAAuB;EACxC,IAAMG,IAAQC,EAAMF;EAGpB,IAAIC,KAASA,MAAU,QAAQ,OAAO;CACxC;CACA,IAAME,IAAaD,EAAM,cAAc;CACvC,IAAI,+BAA+B,KAAKC,CAAU,GAAG,OAAO;CAC5D,IAAMC,IAAUF,EAAM,WAAW;CAEjC,OADA,EAAI,8BAA8B,KAAKE,CAAO;AAEhD;AA2BA,SAAgBC,IAAoC;CAClD,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GAER,IAAIC,IADeC,EAAM,SAAS,SACI,eAClCC,IAAU,GACVC,IAAU,GACVC,IAAgC;GAEpC,OAAOJ,KAAQA,MAAS,SAAS,kBAAiB;IAEhD,IAAIP,EADU,iBAAiBO,CACA,CAAK,GAAG;KACrC,IAAMK,IAAOL,EAAK,sBAAsB;KAGxC,AAFA,IAAUK,EAAK,GACf,IAAUA,EAAK,GACf,IAAgBL;KAChB;IACF;IACA,IAAOA,EAAK;GACd;GAMA,OAJI,CAACI,KAAkBF,MAAY,KAAKC,MAAY,IAC3C,EAAE,MAAM,EAAE,UAAU,KAAK,EAAE,IAG7B;IACL,GAAGF,EAAM,IAAIC;IACb,GAAGD,EAAM,IAAIE;IACb,MAAM;KAAE,UAAUC;KAAe;KAAS;IAAQ;GACpD;EACF;CACF;AACF"}

package/dist/lib/positioner/middleware/flip.js.map

@@ -1 +1 @@
-{"version":3,"file":"flip.js","names":[],"sources":["../../../../src/lib/positioner/middleware/flip.ts"],"sourcesContent":["import type { Boundary, Middleware, Placement, Side } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\nimport {\n  computeCoordsFromPlacement,\n  getOppositePlacement,\n  getSide,\n} from \"../core/placement\";\n\nexport interface FlipOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /** 翻转候选 placement 列表，按顺序尝试，默认只翻转到正对面 */\n  fallbackPlacements?: Placement[];\n}\n\ninterface SideOverflow {\n  top: number;\n  right: number;\n  bottom: number;\n  left: number;\n}\n\nfunction getSideOverflow(\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n  boundary: Boundary,\n): SideOverflow {\n  return {\n    top: boundary.y - y,\n    left: boundary.x - x,\n    right: x + width - (boundary.x + boundary.width),\n    bottom: y + height - (boundary.y + boundary.height),\n  };\n}\n\n/** 取某个 placement 主轴方向对应的溢出量（正数代表溢出了多少像素） */\nfunction getMainAxisOverflow(side: Side, overflow: SideOverflow): number {\n  switch (side) {\n    case \"top\":\n      return overflow.top;\n    case \"bottom\":\n      return overflow.bottom;\n    case \"left\":\n      return overflow.left;\n    case \"right\":\n      return overflow.right;\n  }\n}\n\n/** 当主轴方向空间不够时，翻转到相对的 placement（如 bottom -> top） */\nexport function flip(options: FlipOptions = {}): Middleware {\n  return {\n    name: \"flip\",\n    fn(state) {\n      const {\n        x,\n        y,\n        rects,\n        placement,\n        strategy,\n        middlewareData,\n        initialPlacement,\n      } = state;\n\n      // 已经翻转过一次就不再继续翻，避免来回震荡\n      if (middlewareData.flip?.flipped) return {};\n\n      const { padding = 0 } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      const currentOverflow = getSideOverflow(\n        x,\n        y,\n        rects.floating.width,\n        rects.floating.height,\n        boundary,\n      );\n      const currentMainOverflow = getMainAxisOverflow(\n        getSide(placement),\n        currentOverflow,\n      );\n\n      // 当前方向够放，不需要翻\n      if (currentMainOverflow <= 0) return {};\n\n      const candidates = options.fallbackPlacements ?? [\n        getOppositePlacement(initialPlacement),\n      ];\n\n      let best: { placement: Placement; overflow: number } | null = null;\n\n      for (const candidate of candidates) {\n        if (candidate === placement) continue;\n\n        // 关键修复点：真正代入候选 placement 算出它的坐标，再算它自己的真实溢出量，\n        // 而不是用当前（本就溢出的）placement 的 overflow 去做错误的镜像估算。\n        const candidateCoords = computeCoordsFromPlacement(rects, candidate);\n        const candidateOverflow = getSideOverflow(\n          candidateCoords.x,\n          candidateCoords.y,\n          rects.floating.width,\n          rects.floating.height,\n          boundary,\n        );\n        const candidateMainOverflow = getMainAxisOverflow(\n          getSide(candidate),\n          candidateOverflow,\n        );\n\n        if (candidateMainOverflow <= 0) {\n          best = { placement: candidate, overflow: candidateMainOverflow };\n          break; // 找到完全不溢出的候选，直接采用\n        }\n        if (!best || candidateMainOverflow < best.overflow) {\n          best = { placement: candidate, overflow: candidateMainOverflow };\n        }\n      }\n\n      // 没有候选，或翻过去也不比现在好，就不翻\n      if (!best || best.overflow >= currentMainOverflow) return {};\n\n      return {\n        reset: { placement: best.placement },\n        data: { flipped: true },\n      };\n    },\n  };\n}\n"],"mappings":";;;AAsBA,SAAS,EACP,GACA,GACA,GACA,GACA,GACc;CACd,OAAO;EACL,KAAK,EAAS,IAAI;EAClB,MAAM,EAAS,IAAI;EACnB,OAAO,IAAI,KAAS,EAAS,IAAI,EAAS;EAC1C,QAAQ,IAAI,KAAU,EAAS,IAAI,EAAS;CAC9C;AACF;AAGA,SAAS,EAAoB,GAAY,GAAgC;CACvE,QAAQ,GAAR;EACE,KAAK,OACH,OAAO,EAAS;EAClB,KAAK,UACH,OAAO,EAAS;EAClB,KAAK,QACH,OAAO,EAAS;EAClB,KAAK,SACH,OAAO,EAAS;CACpB;AACF;AAGA,SAAgB,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EACJ,MACA,MACA,UACA,cACA,aACA,mBACA,wBACE;GAGJ,IAAI,EAAe,MAAM,SAAS,OAAO,CAAC;GAE1C,IAAM,EAAE,aAAU,MAAM,GAClB,IACJ,EAAQ,YAAY,EAAoB,GAAU,CAAO,GAErD,IAAkB,EACtB,GACA,GACA,EAAM,SAAS,OACf,EAAM,SAAS,QACf,CACF,GACM,IAAsB,EAC1B,EAAQ,CAAS,GACjB,CACF;GAGA,IAAI,KAAuB,GAAG,OAAO,CAAC;GAEtC,IAAM,IAAa,EAAQ,sBAAsB,CAC/C,EAAqB,CAAgB,CACvC,GAEI,IAA0D;GAE9D,KAAK,IAAM,KAAa,GAAY;IAClC,IAAI,MAAc,GAAW;IAI7B,IAAM,IAAkB,EAA2B,GAAO,CAAS,GAC7D,IAAoB,EACxB,EAAgB,GAChB,EAAgB,GAChB,EAAM,SAAS,OACf,EAAM,SAAS,QACf,CACF,GACM,IAAwB,EAC5B,EAAQ,CAAS,GACjB,CACF;IAEA,IAAI,KAAyB,GAAG;KAC9B,IAAO;MAAE,WAAW;MAAW,UAAU;KAAsB;KAC/D;IACF;IACA,CAAI,CAAC,KAAQ,IAAwB,EAAK,cACxC,IAAO;KAAE,WAAW;KAAW,UAAU;IAAsB;GAEnE;GAKA,OAFI,CAAC,KAAQ,EAAK,YAAY,IAA4B,CAAC,IAEpD;IACL,OAAO,EAAE,WAAW,EAAK,UAAU;IACnC,MAAM,EAAE,SAAS,GAAK;GACxB;EACF;CACF;AACF"}
+{"version":3,"file":"flip.js","names":["getSideOverflow","boundary","y","x","width","height","getMainAxisOverflow","side","overflow","flip","state","middlewareData","options","getViewportBoundary","strategy","padding","currentOverflow","rects","currentMainOverflow","getSide","placement","candidates","getOppositePlacement","initialPlacement","best","candidate","candidateCoords","computeCoordsFromPlacement","candidateOverflow","candidateMainOverflow"],"sources":["../../../../src/lib/positioner/middleware/flip.ts"],"sourcesContent":["import type { Boundary, Middleware, Placement, Side } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\nimport {\n  computeCoordsFromPlacement,\n  getOppositePlacement,\n  getSide,\n} from \"../core/placement\";\n\nexport interface FlipOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /** 翻转候选 placement 列表，按顺序尝试，默认只翻转到正对面 */\n  fallbackPlacements?: Placement[];\n}\n\ninterface SideOverflow {\n  top: number;\n  right: number;\n  bottom: number;\n  left: number;\n}\n\nfunction getSideOverflow(\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n  boundary: Boundary,\n): SideOverflow {\n  return {\n    top: boundary.y - y,\n    left: boundary.x - x,\n    right: x + width - (boundary.x + boundary.width),\n    bottom: y + height - (boundary.y + boundary.height),\n  };\n}\n\n/** 取某个 placement 主轴方向对应的溢出量（正数代表溢出了多少像素） */\nfunction getMainAxisOverflow(side: Side, overflow: SideOverflow): number {\n  switch (side) {\n    case \"top\":\n      return overflow.top;\n    case \"bottom\":\n      return overflow.bottom;\n    case \"left\":\n      return overflow.left;\n    case \"right\":\n      return overflow.right;\n  }\n}\n\n/** 当主轴方向空间不够时，翻转到相对的 placement（如 bottom -> top） */\nexport function flip(options: FlipOptions = {}): Middleware {\n  return {\n    name: \"flip\",\n    fn(state) {\n      const {\n        x,\n        y,\n        rects,\n        placement,\n        strategy,\n        middlewareData,\n        initialPlacement,\n      } = state;\n\n      // 已经翻转过一次就不再继续翻，避免来回震荡\n      if (middlewareData.flip?.flipped) return {};\n\n      const { padding = 0 } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      const currentOverflow = getSideOverflow(\n        x,\n        y,\n        rects.floating.width,\n        rects.floating.height,\n        boundary,\n      );\n      const currentMainOverflow = getMainAxisOverflow(\n        getSide(placement),\n        currentOverflow,\n      );\n\n      // 当前方向够放，不需要翻\n      if (currentMainOverflow <= 0) return {};\n\n      const candidates = options.fallbackPlacements ?? [\n        getOppositePlacement(initialPlacement),\n      ];\n\n      let best: { placement: Placement; overflow: number } | null = null;\n\n      for (const candidate of candidates) {\n        if (candidate === placement) continue;\n\n        // 关键修复点：真正代入候选 placement 算出它的坐标，再算它自己的真实溢出量，\n        // 而不是用当前（本就溢出的）placement 的 overflow 去做错误的镜像估算。\n        const candidateCoords = computeCoordsFromPlacement(rects, candidate);\n        const candidateOverflow = getSideOverflow(\n          candidateCoords.x,\n          candidateCoords.y,\n          rects.floating.width,\n          rects.floating.height,\n          boundary,\n        );\n        const candidateMainOverflow = getMainAxisOverflow(\n          getSide(candidate),\n          candidateOverflow,\n        );\n\n        if (candidateMainOverflow <= 0) {\n          best = { placement: candidate, overflow: candidateMainOverflow };\n          break; // 找到完全不溢出的候选，直接采用\n        }\n        if (!best || candidateMainOverflow < best.overflow) {\n          best = { placement: candidate, overflow: candidateMainOverflow };\n        }\n      }\n\n      // 没有候选，或翻过去也不比现在好，就不翻\n      if (!best || best.overflow >= currentMainOverflow) return {};\n\n      return {\n        reset: { placement: best.placement },\n        data: { flipped: true },\n      };\n    },\n  };\n}\n"],"mappings":";;;AAsBA,SAASA,EACP,GACA,GACA,GACA,GACA,GACc;CACd,OAAO;EACL,KAAKC,EAAS,IAAIC;EAClB,MAAMD,EAAS,IAAIE;EACnB,OAAOA,IAAIC,KAASH,EAAS,IAAIA,EAAS;EAC1C,QAAQC,IAAIG,KAAUJ,EAAS,IAAIA,EAAS;CAC9C;AACF;AAGA,SAASK,EAAoB,GAAY,GAAgC;CACvE,QAAQC,GAAR;EACE,KAAK,OACH,OAAOC,EAAS;EAClB,KAAK,UACH,OAAOA,EAAS;EAClB,KAAK,QACH,OAAOA,EAAS;EAClB,KAAK,SACH,OAAOA,EAAS;CACpB;AACF;AAGA,SAAgBC,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EACJ,MACA,MACA,UACA,cACA,aACA,mBACA,wBACEC;GAGJ,IAAIC,EAAe,MAAM,SAAS,OAAO,CAAC;GAE1C,IAAM,EAAE,aAAU,MAAMC,GAClBX,IACJW,EAAQ,YAAYC,EAAoBC,GAAUC,CAAO,GAErDC,IAAkBhB,EACtBG,GACAD,GACAe,EAAM,SAAS,OACfA,EAAM,SAAS,QACfhB,CACF,GACMiB,IAAsBZ,EAC1Ba,EAAQC,CAAS,GACjBJ,CACF;GAGA,IAAIE,KAAuB,GAAG,OAAO,CAAC;GAEtC,IAAMG,IAAaT,EAAQ,sBAAsB,CAC/CU,EAAqBC,CAAgB,CACvC,GAEIC,IAA0D;GAE9D,KAAK,IAAMC,KAAaJ,GAAY;IAClC,IAAII,MAAcL,GAAW;IAI7B,IAAMM,IAAkBC,EAA2BV,GAAOQ,CAAS,GAC7DG,IAAoB5B,EACxB0B,EAAgB,GAChBA,EAAgB,GAChBT,EAAM,SAAS,OACfA,EAAM,SAAS,QACfhB,CACF,GACM4B,IAAwBvB,EAC5Ba,EAAQM,CAAS,GACjBG,CACF;IAEA,IAAIC,KAAyB,GAAG;KAC9B,IAAO;MAAE,WAAWJ;MAAW,UAAUI;KAAsB;KAC/D;IACF;IACA,CAAI,CAACL,KAAQK,IAAwBL,EAAK,cACxC,IAAO;KAAE,WAAWC;KAAW,UAAUI;IAAsB;GAEnE;GAKA,OAFI,CAACL,KAAQA,EAAK,YAAYN,IAA4B,CAAC,IAEpD;IACL,OAAO,EAAE,WAAWM,EAAK,UAAU;IACnC,MAAM,EAAE,SAAS,GAAK;GACxB;EACF;CACF;AACF"}

package/dist/lib/positioner/middleware/hide.js.map

@@ -1 +1 @@
-{"version":3,"file":"hide.js","names":[],"sources":["../../../../src/lib/positioner/middleware/hide.ts"],"sourcesContent":["import type { Boundary, Middleware } from \"../types\";\nimport { getViewportBoundary, getRectRelativeTo } from \"../utils/dom\";\n\nexport interface HideOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /**\n   * 'referenceHidden'：reference 元素被自身滚动容器完全裁掉（比如滚出了可滚动的父级）\n   * 'escaped'：floating 元素虽然还在视口内，但已经完全脱离了 reference 所在的边界\n   *（比如 reference 在一个卡片里被横向滚动挡住了一半，虽然 floating 还能摆在视口里，\n   *  但已经不该再显示，否则看起来像是\"飘\"在别的内容上）\n   * 默认只做 referenceHidden 检测，这是最常见也最需要的场景。\n   */\n  strategy?: \"referenceHidden\" | \"escaped\";\n}\n\nexport interface HideData {\n  referenceHidden?: boolean;\n  escaped?: boolean;\n}\n\n/**\n * 不改变坐标，只产出\"是否应该隐藏浮层\"的判断数据，交给上层组件决定要不要渲染。\n * 用法：在业务组件里读 `middlewareData().hide?.referenceHidden`，为 true 时关闭浮层。\n */\nexport function hide(options: HideOptions = {}): Middleware {\n  return {\n    name: \"hide\",\n    fn(state) {\n      const { x, y, rects, strategy: positionStrategy, elements } = state;\n      const { padding = 0, strategy = \"referenceHidden\" } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(positionStrategy, padding);\n\n      const data: HideData = {};\n\n      if (strategy === \"referenceHidden\") {\n        const refRect = getRectRelativeTo(elements.reference, positionStrategy);\n        const referenceHidden =\n          refRect.x + refRect.width <= boundary.x ||\n          refRect.y + refRect.height <= boundary.y ||\n          refRect.x >= boundary.x + boundary.width ||\n          refRect.y >= boundary.y + boundary.height;\n        data.referenceHidden = referenceHidden;\n      }\n\n      if (strategy === \"escaped\") {\n        const escaped =\n          x + rects.floating.width <= boundary.x ||\n          y + rects.floating.height <= boundary.y ||\n          x >= boundary.x + boundary.width ||\n          y >= boundary.y + boundary.height;\n        data.escaped = escaped;\n      }\n\n      return { data };\n    },\n  };\n}\n"],"mappings":";;AAyBA,SAAgB,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,UAAO,UAAU,GAAkB,gBAAa,GACxD,EAAE,aAAU,GAAG,cAAW,sBAAsB,GAChD,IACJ,EAAQ,YAAY,EAAoB,GAAkB,CAAO,GAE7D,IAAiB,CAAC;GAExB,IAAI,MAAa,mBAAmB;IAClC,IAAM,IAAU,EAAkB,EAAS,WAAW,CAAgB;IAMtE,EAAK,kBAJH,EAAQ,IAAI,EAAQ,SAAS,EAAS,KACtC,EAAQ,IAAI,EAAQ,UAAU,EAAS,KACvC,EAAQ,KAAK,EAAS,IAAI,EAAS,SACnC,EAAQ,KAAK,EAAS,IAAI,EAAS;GAEvC;GAWA,OATI,MAAa,cAMf,EAAK,UAJH,IAAI,EAAM,SAAS,SAAS,EAAS,KACrC,IAAI,EAAM,SAAS,UAAU,EAAS,KACtC,KAAK,EAAS,IAAI,EAAS,SAC3B,KAAK,EAAS,IAAI,EAAS,SAIxB,EAAE,QAAK;EAChB;CACF;AACF"}
+{"version":3,"file":"hide.js","names":["hide","positionStrategy","state","options","boundary","getViewportBoundary","padding","data","strategy","refRect","getRectRelativeTo","elements","x","rects","y"],"sources":["../../../../src/lib/positioner/middleware/hide.ts"],"sourcesContent":["import type { Boundary, Middleware } from \"../types\";\nimport { getViewportBoundary, getRectRelativeTo } from \"../utils/dom\";\n\nexport interface HideOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /**\n   * 'referenceHidden'：reference 元素被自身滚动容器完全裁掉（比如滚出了可滚动的父级）\n   * 'escaped'：floating 元素虽然还在视口内，但已经完全脱离了 reference 所在的边界\n   *（比如 reference 在一个卡片里被横向滚动挡住了一半，虽然 floating 还能摆在视口里，\n   *  但已经不该再显示，否则看起来像是\"飘\"在别的内容上）\n   * 默认只做 referenceHidden 检测，这是最常见也最需要的场景。\n   */\n  strategy?: \"referenceHidden\" | \"escaped\";\n}\n\nexport interface HideData {\n  referenceHidden?: boolean;\n  escaped?: boolean;\n}\n\n/**\n * 不改变坐标，只产出\"是否应该隐藏浮层\"的判断数据，交给上层组件决定要不要渲染。\n * 用法：在业务组件里读 `middlewareData().hide?.referenceHidden`，为 true 时关闭浮层。\n */\nexport function hide(options: HideOptions = {}): Middleware {\n  return {\n    name: \"hide\",\n    fn(state) {\n      const { x, y, rects, strategy: positionStrategy, elements } = state;\n      const { padding = 0, strategy = \"referenceHidden\" } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(positionStrategy, padding);\n\n      const data: HideData = {};\n\n      if (strategy === \"referenceHidden\") {\n        const refRect = getRectRelativeTo(elements.reference, positionStrategy);\n        const referenceHidden =\n          refRect.x + refRect.width <= boundary.x ||\n          refRect.y + refRect.height <= boundary.y ||\n          refRect.x >= boundary.x + boundary.width ||\n          refRect.y >= boundary.y + boundary.height;\n        data.referenceHidden = referenceHidden;\n      }\n\n      if (strategy === \"escaped\") {\n        const escaped =\n          x + rects.floating.width <= boundary.x ||\n          y + rects.floating.height <= boundary.y ||\n          x >= boundary.x + boundary.width ||\n          y >= boundary.y + boundary.height;\n        data.escaped = escaped;\n      }\n\n      return { data };\n    },\n  };\n}\n"],"mappings":";;AAyBA,SAAgBA,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,UAAO,UAAUC,GAAkB,gBAAaC,GACxD,EAAE,aAAU,GAAG,cAAW,sBAAsBC,GAChDC,IACJD,EAAQ,YAAYE,EAAoBJ,GAAkBK,CAAO,GAE7DC,IAAiB,CAAC;GAExB,IAAIC,MAAa,mBAAmB;IAClC,IAAMC,IAAUC,EAAkBC,EAAS,WAAWV,CAAgB;IAMtE,EAAK,kBAJHQ,EAAQ,IAAIA,EAAQ,SAASL,EAAS,KACtCK,EAAQ,IAAIA,EAAQ,UAAUL,EAAS,KACvCK,EAAQ,KAAKL,EAAS,IAAIA,EAAS,SACnCK,EAAQ,KAAKL,EAAS,IAAIA,EAAS;GAEvC;GAWA,OATII,MAAa,cAMf,EAAK,UAJHI,IAAIC,EAAM,SAAS,SAAST,EAAS,KACrCU,IAAID,EAAM,SAAS,UAAUT,EAAS,KACtCQ,KAAKR,EAAS,IAAIA,EAAS,SAC3BU,KAAKV,EAAS,IAAIA,EAAS,SAIxB,EAAE,QAAK;EAChB;CACF;AACF"}

package/dist/lib/positioner/middleware/offset.js.map

@@ -1 +1 @@
-{"version":3,"file":"offset.js","names":[],"sources":["../../../../src/lib/positioner/middleware/offset.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\nimport { getSide, isVerticalSide } from \"../core/placement\";\n\nexport interface OffsetValue {\n  /** 沿主轴方向的偏移（远离/靠近 reference），默认 0 */\n  mainAxis?: number;\n  /** 沿交叉轴方向的偏移（左右或上下平移），默认 0 */\n  crossAxis?: number;\n}\n\nexport type OffsetOptions = number | OffsetValue;\n\n/** 让 floating 元素与 reference 保持一定间距，或沿对齐轴做微调 */\nexport function offset(value: OffsetOptions = 0): Middleware {\n  return {\n    name: \"offset\",\n    fn(state) {\n      const { x, y, placement } = state;\n      const side = getSide(placement);\n      const vertical = isVerticalSide(side);\n\n      const mainAxis =\n        typeof value === \"number\" ? value : (value.mainAxis ?? 0);\n      const crossAxis = typeof value === \"number\" ? 0 : (value.crossAxis ?? 0);\n\n      // top/left 是\"负方向\"，bottom/right 是\"正方向\"\n      const mainSign = side === \"bottom\" || side === \"right\" ? 1 : -1;\n\n      const diffMain = mainAxis * mainSign;\n\n      return vertical\n        ? { x: x + crossAxis, y: y + diffMain }\n        : { x: x + diffMain, y: y + crossAxis };\n    },\n  };\n}\n"],"mappings":";;AAaA,SAAgB,EAAO,IAAuB,GAAe;CAC3D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,iBAAc,GACtB,IAAO,EAAQ,CAAS,GACxB,IAAW,EAAe,CAAI,GAE9B,IACJ,OAAO,KAAU,WAAW,IAAS,EAAM,YAAY,GACnD,IAAY,OAAO,KAAU,WAAW,IAAK,EAAM,aAAa,GAKhE,IAAW,KAFA,MAAS,YAAY,MAAS,UAAU,IAAI;GAI7D,OAAO,IACH;IAAE,GAAG,IAAI;IAAW,GAAG,IAAI;GAAS,IACpC;IAAE,GAAG,IAAI;IAAU,GAAG,IAAI;GAAU;EAC1C;CACF;AACF"}
+{"version":3,"file":"offset.js","names":["offset","state","side","getSide","placement","vertical","isVerticalSide","mainAxis","value","crossAxis","diffMain","x","y"],"sources":["../../../../src/lib/positioner/middleware/offset.ts"],"sourcesContent":["import type { Middleware } from \"../types\";\nimport { getSide, isVerticalSide } from \"../core/placement\";\n\nexport interface OffsetValue {\n  /** 沿主轴方向的偏移（远离/靠近 reference），默认 0 */\n  mainAxis?: number;\n  /** 沿交叉轴方向的偏移（左右或上下平移），默认 0 */\n  crossAxis?: number;\n}\n\nexport type OffsetOptions = number | OffsetValue;\n\n/** 让 floating 元素与 reference 保持一定间距，或沿对齐轴做微调 */\nexport function offset(value: OffsetOptions = 0): Middleware {\n  return {\n    name: \"offset\",\n    fn(state) {\n      const { x, y, placement } = state;\n      const side = getSide(placement);\n      const vertical = isVerticalSide(side);\n\n      const mainAxis =\n        typeof value === \"number\" ? value : (value.mainAxis ?? 0);\n      const crossAxis = typeof value === \"number\" ? 0 : (value.crossAxis ?? 0);\n\n      // top/left 是\"负方向\"，bottom/right 是\"正方向\"\n      const mainSign = side === \"bottom\" || side === \"right\" ? 1 : -1;\n\n      const diffMain = mainAxis * mainSign;\n\n      return vertical\n        ? { x: x + crossAxis, y: y + diffMain }\n        : { x: x + diffMain, y: y + crossAxis };\n    },\n  };\n}\n"],"mappings":";;AAaA,SAAgBA,EAAO,IAAuB,GAAe;CAC3D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,iBAAcC,GACtBC,IAAOC,EAAQC,CAAS,GACxBC,IAAWC,EAAeJ,CAAI,GAE9BK,IACJ,OAAOC,KAAU,WAAWA,IAASA,EAAM,YAAY,GACnDC,IAAY,OAAOD,KAAU,WAAW,IAAKA,EAAM,aAAa,GAKhEE,IAAWH,KAFAL,MAAS,YAAYA,MAAS,UAAU,IAAI;GAI7D,OAAOG,IACH;IAAE,GAAGM,IAAIF;IAAW,GAAGG,IAAIF;GAAS,IACpC;IAAE,GAAGC,IAAID;IAAU,GAAGE,IAAIH;GAAU;EAC1C;CACF;AACF"}

package/dist/lib/positioner/middleware/shift.js.map

@@ -1 +1 @@
-{"version":3,"file":"shift.js","names":[],"sources":["../../../../src/lib/positioner/middleware/shift.ts"],"sourcesContent":["import type { Boundary, Middleware } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\n\nexport interface ShiftOptions {\n  /** 距边界的最小间距，默认 0 */\n  padding?: number;\n  /** 自定义边界矩形，默认使用视口 */\n  boundary?: Boundary;\n  /** 是否限制主轴方向（如 top/bottom placement 的 y 方向），默认 true */\n  mainAxis?: boolean;\n  /** 是否限制交叉轴方向（如 top/bottom placement 的 x 方向），默认 true */\n  crossAxis?: boolean;\n}\n\n/** 平移 floating 元素，使其尽量停留在边界（默认视口）内，不做 placement 翻转 */\nexport function shift(options: ShiftOptions = {}): Middleware {\n  return {\n    name: \"shift\",\n    fn(state) {\n      const { x, y, rects, strategy } = state;\n      const { padding = 0, mainAxis = true, crossAxis = true } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      let nextX = x;\n      let nextY = y;\n\n      if (crossAxis) {\n        const minX = boundary.x;\n        const maxX = boundary.x + boundary.width - rects.floating.width;\n        nextX = Math.min(Math.max(x, minX), Math.max(minX, maxX));\n      }\n\n      if (mainAxis) {\n        const minY = boundary.y;\n        const maxY = boundary.y + boundary.height - rects.floating.height;\n        nextY = Math.min(Math.max(y, minY), Math.max(minY, maxY));\n      }\n\n      return {\n        x: nextX,\n        y: nextY,\n        data: { x: nextX - x, y: nextY - y },\n      };\n    },\n  };\n}\n"],"mappings":";;AAeA,SAAgB,EAAM,IAAwB,CAAC,GAAe;CAC5D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,UAAO,gBAAa,GAC5B,EAAE,aAAU,GAAG,cAAW,IAAM,eAAY,OAAS,GACrD,IACJ,EAAQ,YAAY,EAAoB,GAAU,CAAO,GAEvD,IAAQ,GACR,IAAQ;GAEZ,IAAI,GAAW;IACb,IAAM,IAAO,EAAS,GAChB,IAAO,EAAS,IAAI,EAAS,QAAQ,EAAM,SAAS;IAC1D,IAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,CAAI,GAAG,KAAK,IAAI,GAAM,CAAI,CAAC;GAC1D;GAEA,IAAI,GAAU;IACZ,IAAM,IAAO,EAAS,GAChB,IAAO,EAAS,IAAI,EAAS,SAAS,EAAM,SAAS;IAC3D,IAAQ,KAAK,IAAI,KAAK,IAAI,GAAG,CAAI,GAAG,KAAK,IAAI,GAAM,CAAI,CAAC;GAC1D;GAEA,OAAO;IACL,GAAG;IACH,GAAG;IACH,MAAM;KAAE,GAAG,IAAQ;KAAG,GAAG,IAAQ;IAAE;GACrC;EACF;CACF;AACF"}
+{"version":3,"file":"shift.js","names":["shift","state","options","boundary","getViewportBoundary","strategy","padding","nextX","x","nextY","y","crossAxis","minX","maxX","rects","mainAxis","minY","maxY"],"sources":["../../../../src/lib/positioner/middleware/shift.ts"],"sourcesContent":["import type { Boundary, Middleware } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\n\nexport interface ShiftOptions {\n  /** 距边界的最小间距，默认 0 */\n  padding?: number;\n  /** 自定义边界矩形，默认使用视口 */\n  boundary?: Boundary;\n  /** 是否限制主轴方向（如 top/bottom placement 的 y 方向），默认 true */\n  mainAxis?: boolean;\n  /** 是否限制交叉轴方向（如 top/bottom placement 的 x 方向），默认 true */\n  crossAxis?: boolean;\n}\n\n/** 平移 floating 元素，使其尽量停留在边界（默认视口）内，不做 placement 翻转 */\nexport function shift(options: ShiftOptions = {}): Middleware {\n  return {\n    name: \"shift\",\n    fn(state) {\n      const { x, y, rects, strategy } = state;\n      const { padding = 0, mainAxis = true, crossAxis = true } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      let nextX = x;\n      let nextY = y;\n\n      if (crossAxis) {\n        const minX = boundary.x;\n        const maxX = boundary.x + boundary.width - rects.floating.width;\n        nextX = Math.min(Math.max(x, minX), Math.max(minX, maxX));\n      }\n\n      if (mainAxis) {\n        const minY = boundary.y;\n        const maxY = boundary.y + boundary.height - rects.floating.height;\n        nextY = Math.min(Math.max(y, minY), Math.max(minY, maxY));\n      }\n\n      return {\n        x: nextX,\n        y: nextY,\n        data: { x: nextX - x, y: nextY - y },\n      };\n    },\n  };\n}\n"],"mappings":";;AAeA,SAAgBA,EAAM,IAAwB,CAAC,GAAe;CAC5D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,UAAO,gBAAaC,GAC5B,EAAE,aAAU,GAAG,cAAW,IAAM,eAAY,OAASC,GACrDC,IACJD,EAAQ,YAAYE,EAAoBC,GAAUC,CAAO,GAEvDC,IAAQC,GACRC,IAAQC;GAEZ,IAAIC,GAAW;IACb,IAAMC,IAAOT,EAAS,GAChBU,IAAOV,EAAS,IAAIA,EAAS,QAAQW,EAAM,SAAS;IAC1D,IAAQ,KAAK,IAAI,KAAK,IAAIN,GAAGI,CAAI,GAAG,KAAK,IAAIA,GAAMC,CAAI,CAAC;GAC1D;GAEA,IAAIE,GAAU;IACZ,IAAMC,IAAOb,EAAS,GAChBc,IAAOd,EAAS,IAAIA,EAAS,SAASW,EAAM,SAAS;IAC3D,IAAQ,KAAK,IAAI,KAAK,IAAIJ,GAAGM,CAAI,GAAG,KAAK,IAAIA,GAAMC,CAAI,CAAC;GAC1D;GAEA,OAAO;IACL,GAAGV;IACH,GAAGE;IACH,MAAM;KAAE,GAAGF,IAAQC;KAAG,GAAGC,IAAQC;IAAE;GACrC;EACF;CACF;AACF"}

package/dist/lib/positioner/middleware/size.js.map

@@ -1 +1 @@
-{"version":3,"file":"size.js","names":[],"sources":["../../../../src/lib/positioner/middleware/size.ts"],"sourcesContent":["import type { Boundary, Middleware, MiddlewareState } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\n\nexport interface SizeAvailableSpace {\n  availableWidth: number;\n  availableHeight: number;\n}\n\nexport interface SizeOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /** 拿到可用空间后自行处理，比如设置 floating 的 maxHeight */\n  apply?: (space: SizeAvailableSpace, state: MiddlewareState) => void;\n}\n\n/** 计算 floating 在当前边界内的可用宽高，交给 apply 回调去应用（如设置 max-height 实现滚动） */\nexport function size(options: SizeOptions = {}): Middleware {\n  return {\n    name: \"size\",\n    fn(state) {\n      const { x, y, strategy } = state;\n      const { padding = 0 } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      const availableWidth = boundary.x + boundary.width - x;\n      const availableHeight = boundary.y + boundary.height - y;\n\n      options.apply?.({ availableWidth, availableHeight }, state);\n\n      return { data: { availableWidth, availableHeight } };\n    },\n  };\n}\n"],"mappings":";;AAgBA,SAAgB,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,gBAAa,GACrB,EAAE,aAAU,MAAM,GAClB,IACJ,EAAQ,YAAY,EAAoB,GAAU,CAAO,GAErD,IAAiB,EAAS,IAAI,EAAS,QAAQ,GAC/C,IAAkB,EAAS,IAAI,EAAS,SAAS;GAIvD,OAFA,EAAQ,QAAQ;IAAE;IAAgB;GAAgB,GAAG,CAAK,GAEnD,EAAE,MAAM;IAAE;IAAgB;GAAgB,EAAE;EACrD;CACF;AACF"}
+{"version":3,"file":"size.js","names":["size","state","options","boundary","getViewportBoundary","strategy","padding","availableWidth","x","availableHeight","y"],"sources":["../../../../src/lib/positioner/middleware/size.ts"],"sourcesContent":["import type { Boundary, Middleware, MiddlewareState } from \"../types\";\nimport { getViewportBoundary } from \"../utils/dom\";\n\nexport interface SizeAvailableSpace {\n  availableWidth: number;\n  availableHeight: number;\n}\n\nexport interface SizeOptions {\n  padding?: number;\n  boundary?: Boundary;\n  /** 拿到可用空间后自行处理，比如设置 floating 的 maxHeight */\n  apply?: (space: SizeAvailableSpace, state: MiddlewareState) => void;\n}\n\n/** 计算 floating 在当前边界内的可用宽高，交给 apply 回调去应用（如设置 max-height 实现滚动） */\nexport function size(options: SizeOptions = {}): Middleware {\n  return {\n    name: \"size\",\n    fn(state) {\n      const { x, y, strategy } = state;\n      const { padding = 0 } = options;\n      const boundary =\n        options.boundary ?? getViewportBoundary(strategy, padding);\n\n      const availableWidth = boundary.x + boundary.width - x;\n      const availableHeight = boundary.y + boundary.height - y;\n\n      options.apply?.({ availableWidth, availableHeight }, state);\n\n      return { data: { availableWidth, availableHeight } };\n    },\n  };\n}\n"],"mappings":";;AAgBA,SAAgBA,EAAK,IAAuB,CAAC,GAAe;CAC1D,OAAO;EACL,MAAM;EACN,GAAG,GAAO;GACR,IAAM,EAAE,MAAG,MAAG,gBAAaC,GACrB,EAAE,aAAU,MAAMC,GAClBC,IACJD,EAAQ,YAAYE,EAAoBC,GAAUC,CAAO,GAErDC,IAAiBJ,EAAS,IAAIA,EAAS,QAAQK,GAC/CC,IAAkBN,EAAS,IAAIA,EAAS,SAASO;GAIvD,OAFAR,EAAQ,QAAQ;IAAE;IAAgB;GAAgB,GAAGD,CAAK,GAEnD,EAAE,MAAM;IAAE;IAAgB;GAAgB,EAAE;EACrD;CACF;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":[],"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,SAAgB,EAAgB,GAA4B;CAC1D,IAAM,IAAO,EAAG,sBAAsB;CACtC,OAAO;EAAE,GAAG,EAAK;EAAG,GAAG,EAAK;EAAG,OAAO,EAAK;EAAO,QAAQ,EAAK;CAAO;AACxE;AAUA,SAAgB,EACd,GACA,GACM;CACN,IAAM,IAAO,EAAgB,CAAE;CAC/B,IAAI,MAAa,SAAS,OAAO;CACjC,IAAM,IAAU,OAAO,WAAW,OAAO,aACnC,IAAU,OAAO,WAAW,OAAO;CACzC,OAAO;EACL,GAAG,EAAK,IAAI;EACZ,GAAG,EAAK,IAAI;EACZ,OAAO,EAAK;EACZ,QAAQ,EAAK;CACf;AACF;AAGA,SAAgB,EAAoB,GAAoB,IAAU,GAAS;CACzE,IAAM,IAAQ,SAAS,gBAAgB,aACjC,IAAS,SAAS,gBAAgB,cAClC,IACJ,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO,aACjD,IACJ,MAAa,UAAU,IAAK,OAAO,WAAW,OAAO;CACvD,OAAO;EACL,GAAG,IAAU;EACb,GAAG,IAAU;EACb,OAAO,IAAQ,IAAU;EACzB,QAAQ,IAAS,IAAU;CAC7B;AACF;AAEA,SAAS,EAAkB,GAAsB;CAC/C,IAAM,EAAE,aAAU,cAAW,iBAAc,iBAAiB,CAAE;CAC9D,OAAO,6BAA6B,KAAK,IAAW,IAAY,CAAS;AAC3E;AAGA,SAAgB,EAAqB,GAAwC;CAC3E,IAAM,IAAkC,CAAC,GACrC,IAAqB,EAAK;CAE9B,OAAO,IAIL,AAHI,EAAkB,CAAE,KACtB,EAAO,KAAK,CAAE,GAEhB,IAAK,EAAG;CAIV,OADA,EAAO,KAAK,MAAM,GACX;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\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"}

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/lib/positioner/virtual-element.js

@@ -0,0 +1,18 @@
+//#region src/lib/positioner/virtual-element.ts
+function e(e) {
+	return {
+		contextElement: e.contextElement,
+		getBoundingClientRect() {
+			return {
+				x: e.x,
+				y: e.y,
+				width: 0,
+				height: 0
+			};
+		}
+	};
+}
+//#endregion
+export { e as createVirtualElement };
+
+//# sourceMappingURL=virtual-element.js.map

package/dist/lib/positioner/virtual-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-element.js","names":["createVirtualElement","point"],"sources":["../../../src/lib/positioner/virtual-element.ts"],"sourcesContent":["import type { VirtualElement } from \"./types\";\n\nexport interface PointOptions {\n  x: number;\n  y: number;\n  /** 可选：关联一个真实 DOM 节点，供 autoUpdate 查找可滚动祖先使用 */\n  contextElement?: Element;\n}\n\n/**\n * 创建一个锚定到具体像素坐标的虚拟参照元素（宽高均为 0），\n * 常见用途：右键菜单锚定到鼠标点击位置、拖拽跟随光标、按坐标弹出的提示等。\n *\n * @example\n * ```ts\n * const [point, setPoint] = createSignal<VirtualElement>();\n * el.addEventListener('contextmenu', (e) => {\n *   e.preventDefault();\n *   setPoint(createVirtualElement({ x: e.clientX, y: e.clientY, contextElement: el }));\n * });\n * ```\n */\nexport function createVirtualElement(point: PointOptions): VirtualElement {\n  return {\n    contextElement: point.contextElement,\n    getBoundingClientRect() {\n      return { x: point.x, y: point.y, width: 0, height: 0 };\n    },\n  };\n}\n"],"mappings":";AAsBA,SAAgBA,EAAqB,GAAqC;CACxE,OAAO;EACL,gBAAgBC,EAAM;EACtB,wBAAwB;GACtB,OAAO;IAAE,GAAGA,EAAM;IAAG,GAAGA,EAAM;IAAG,OAAO;IAAG,QAAQ;GAAE;EACvD;CACF;AACF"}