@neut/ui 0.0.15 → 0.0.16

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/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/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"}