@destyler/popper 0.0.3 → 0.0.5

package/README.md

@@ -0,0 +1,7 @@
+# @destyler/popper
+
+[![NPM version](https://img.shields.io/npm/v/@destyler/popper?color=a1b858&popper=)](https://www.npmjs.com/package/@destyler/popper)
+
+> popper is a component that allows you to create popups, tooltips, and dropdowns.
+
+[GitHub](https://github.com/destyler/destyler) | [Documentation](https://destyler-dev.zeabur.app/)

package/dist/component.cjs

@@ -1,16 +1,460 @@
 'use strict';
 
-const index = require('./index.cjs');
-require('vue');
-require('@destyler/shared');
-require('@destyler/primitive');
-require('@destyler/composition');
-require('@floating-ui/vue');
-require('@destyler/arrow');
+const vue = require('vue');
+const shared = require('@destyler/shared');
+const primitive = require('@destyler/primitive');
+const composition = require('@destyler/composition');
+const vue$1 = require('@floating-ui/vue');
+const arrow = require('@destyler/arrow');
+const component = require('@destyler/arrow/component');
 
+const [injectPopperRootContext, providePopperRootContext] = shared.createContext("DestylerPopperRoot");
+const PopperRoot = vue.defineComponent({
+  name: "PopperRoot",
+  setup() {
+    const anchor = vue.ref();
+    providePopperRootContext({
+      anchor,
+      onAnchorChange: (element) => anchor.value = element
+    });
+  },
+  render() {
+    return this.$slots.default?.();
+  }
+});
 
+const popperAnchorProps = {
+  ...primitive.primitiveProps,
+  element: {
+    type: Object,
+    required: false
+  }
+};
+const PopperAnchor = vue.defineComponent({
+  name: "DestylerPopperAnchor",
+  props: popperAnchorProps,
+  setup(props) {
+    const { forwardRef, currentElement } = composition.useForwardExpose();
+    const rootContext = injectPopperRootContext();
+    vue.watch(currentElement, () => {
+      rootContext.onAnchorChange(props.element ?? currentElement.value);
+    });
+    return {
+      forwardRef
+    };
+  },
+  render() {
+    return vue.h(primitive.Primitive, {
+      as: this.$props.as,
+      asChild: this.$props.asChild,
+      ref: (el) => this.forwardRef(el)
+    }, () => this.$slots.default?.());
+  }
+});
 
-exports.DestylerPopperAnchor = index.DestylerPopperAnchor;
-exports.DestylerPopperArrow = index.DestylerPopperArrow;
-exports.DestylerPopperContent = index.DestylerPopperContent;
-exports.DestylerPopperRoot = index.DestylerPopperRoot;
+function isNotNull(value) {
+  return value !== null;
+}
+function transformOrigin(options) {
+  return {
+    name: "transformOrigin",
+    options,
+    fn(data) {
+      const { placement, rects, middlewareData } = data;
+      const cannotCenterArrow = middlewareData.arrow?.centerOffset !== 0;
+      const isArrowHidden = cannotCenterArrow;
+      const arrowWidth = isArrowHidden ? 0 : options.arrowWidth;
+      const arrowHeight = isArrowHidden ? 0 : options.arrowHeight;
+      const [placedSide, placedAlign] = getSideAndAlignFromPlacement(placement);
+      const noArrowAlign = { start: "0%", center: "50%", end: "100%" }[placedAlign];
+      const arrowXCenter = (middlewareData.arrow?.x ?? 0) + arrowWidth / 2;
+      const arrowYCenter = (middlewareData.arrow?.y ?? 0) + arrowHeight / 2;
+      let x = "";
+      let y = "";
+      if (placedSide === "bottom") {
+        x = isArrowHidden ? noArrowAlign : `${arrowXCenter}px`;
+        y = `${-arrowHeight}px`;
+      } else if (placedSide === "top") {
+        x = isArrowHidden ? noArrowAlign : `${arrowXCenter}px`;
+        y = `${rects.floating.height + arrowHeight}px`;
+      } else if (placedSide === "right") {
+        x = `${-arrowHeight}px`;
+        y = isArrowHidden ? noArrowAlign : `${arrowYCenter}px`;
+      } else if (placedSide === "left") {
+        x = `${rects.floating.width + arrowHeight}px`;
+        y = isArrowHidden ? noArrowAlign : `${arrowYCenter}px`;
+      }
+      return { data: { x, y } };
+    }
+  };
+}
+function getSideAndAlignFromPlacement(placement) {
+  const [side, align = "center"] = placement.split("-");
+  return [side, align];
+}
+
+const [injectPopperContentContext, providePopperContentContext] = shared.createContext("DestylerPopperContent");
+const popperContentProps = {
+  ...primitive.primitiveProps,
+  /**
+   * The preferred side of the trigger to render against when open.
+   * Will be reversed when collisions occur and avoidCollisions
+   * is enabled.
+   *
+   * @default bottom
+   */
+  side: {
+    type: String,
+    required: false,
+    default: "bottom"
+  },
+  /**
+   * The distance in pixels from the trigger.
+   *
+   * @default 0
+   */
+  sideOffset: {
+    type: Number,
+    required: false,
+    default: 0
+  },
+  /**
+   * The preferred alignment against the trigger.
+   * May change when collisions occur.
+   *
+   * @default center
+   */
+  align: {
+    type: String,
+    required: false,
+    default: "center"
+  },
+  /**
+   * An offset in pixels from the `start` or `end` alignment options.
+   *
+   * @default 0
+   */
+  alignOffset: {
+    type: Number,
+    required: false,
+    default: 0
+  },
+  /**
+   * When `true`, overrides the side andalign preferences
+   * to prevent collisions with boundary edges.
+   *
+   * @default true
+   */
+  avoidCollisions: {
+    type: Boolean,
+    required: false,
+    default: true
+  },
+  /**
+   * The element used as the collision boundary. By default
+   * this is the viewport, though you can provide additional
+   * element(s) to be included in this check.
+   *
+   * @default () => []
+   */
+  collisionBoundary: {
+    type: [Object, Array, null],
+    required: false,
+    default: () => []
+  },
+  /**
+   * The distance in pixels from the boundary edges where collision
+   * detection should occur. Accepts a number (same for all sides),
+   * or a partial padding object, for example: { top: 20, left: 20 }.
+   *
+   * @default 0
+   */
+  collisionPadding: {
+    type: [Number, Object],
+    required: false,
+    default: 0
+  },
+  /**
+   * The distance in pixels from the boundary edges where collision
+   * detection should occur. Accepts a number (same for all sides),
+   * or a partial padding object, for example: { top: 20, left: 20 }.
+   *
+   * @default 0
+   */
+  arrowPadding: {
+    type: Number,
+    required: false,
+    default: 0
+  },
+  /**
+   * The sticky behavior on the align axis. `partial` will keep the
+   * content in the boundary as long as the trigger is at least partially
+   * in the boundary whilst "always" will keep the content in the boundary
+   * regardless.
+   *
+   * @default partial
+   */
+  sticky: {
+    type: String,
+    required: false,
+    default: "partial"
+  },
+  /**
+   * Whether to hide the content when the trigger becomes fully occluded.
+   *
+   * @default false
+   */
+  hideWhenDetached: {
+    type: Boolean,
+    required: false,
+    default: false
+  },
+  /**
+   * Strategy to update the position of the floating element on every animation frame.
+   *
+   * @default optimized
+   */
+  updatePositionStrategy: {
+    type: String,
+    required: false,
+    default: "optimized"
+  },
+  /**
+   * Force content to be position within the viewport.
+   *
+   * Might overlap the reference element, which may not be desired.
+   *
+   * @default false
+   */
+  prioritizePosition: {
+    type: Boolean,
+    required: false,
+    default: false
+  }
+};
+const popperContentEmits = {
+  placed: () => true
+};
+const PopperContent = vue.defineComponent({
+  name: "DestylerPopperContent",
+  inheritAttrs: false,
+  props: popperContentProps,
+  emits: popperContentEmits,
+  setup(props, { attrs, emit }) {
+    const rootContext = injectPopperRootContext();
+    const { forwardRef, currentElement: contentElement } = composition.useForwardExpose();
+    const floatingRef = vue.ref();
+    const arrow = vue.ref();
+    const { width: arrowWidth, height: arrowHeight } = composition.useSize(arrow);
+    const desiredPlacement = vue.computed(() => props.side + (props.align !== "center" ? `-${props.align}` : ""));
+    const collisionPadding = vue.computed(() => {
+      return typeof props.collisionPadding === "number" ? props.collisionPadding : { top: 0, right: 0, bottom: 0, left: 0, ...props.collisionPadding };
+    });
+    const boundary = vue.computed(() => {
+      return Array.isArray(props.collisionBoundary) ? props.collisionBoundary : [props.collisionBoundary];
+    });
+    const detectOverflowOptions = vue.computed(() => {
+      return {
+        padding: collisionPadding.value,
+        boundary: boundary.value.filter(isNotNull),
+        // with `strategy: 'fixed'`, this is the only way to get it to respect boundaries
+        altBoundary: boundary.value.length > 0
+      };
+    });
+    const computedMiddleware = shared.computedEager(() => {
+      return [
+        vue$1.offset({
+          mainAxis: props.sideOffset + arrowHeight.value,
+          alignmentAxis: props.alignOffset
+        }),
+        props.avoidCollisions && vue$1.shift({
+          mainAxis: true,
+          crossAxis: !!props.prioritizePosition,
+          limiter: props.sticky === "partial" ? vue$1.limitShift() : void 0,
+          ...detectOverflowOptions.value
+        }),
+        !props.prioritizePosition && props.avoidCollisions && vue$1.flip({
+          ...detectOverflowOptions.value
+        }),
+        vue$1.size({
+          ...detectOverflowOptions.value,
+          apply: ({ elements, rects, availableWidth, availableHeight }) => {
+            const { width: anchorWidth, height: anchorHeight } = rects.reference;
+            const contentStyle = elements.floating.style;
+            Object.assign(elements.floating.style, {
+              maxWidth: `${availableWidth}px`,
+              maxHeight: `${availableHeight}px`
+            });
+            contentStyle.setProperty(
+              "--destyler-popper-available-width",
+              `${availableWidth}px`
+            );
+            contentStyle.setProperty(
+              "--destyler-popper-available-height",
+              `${availableHeight}px`
+            );
+            contentStyle.setProperty(
+              "--destyler-popper-anchor-width",
+              `${anchorWidth}px`
+            );
+            contentStyle.setProperty(
+              "--destyler-popper-anchor-height",
+              `${anchorHeight}px`
+            );
+          }
+        }),
+        arrow.value && vue$1.arrow({ element: arrow.value, padding: props.arrowPadding }),
+        transformOrigin({
+          arrowWidth: arrowWidth.value,
+          arrowHeight: arrowHeight.value
+        }),
+        props.hideWhenDetached && vue$1.hide({ strategy: "referenceHidden", ...detectOverflowOptions.value })
+      ];
+    });
+    const { floatingStyles, placement, isPositioned, middlewareData } = vue$1.useFloating(
+      rootContext.anchor,
+      floatingRef,
+      {
+        strategy: "fixed",
+        placement: desiredPlacement,
+        whileElementsMounted: (...args) => {
+          const cleanup = vue$1.autoUpdate(...args, {
+            animationFrame: props.updatePositionStrategy === "always"
+          });
+          return cleanup;
+        },
+        middleware: computedMiddleware
+      }
+    );
+    const placedSide = vue.computed(() => getSideAndAlignFromPlacement(placement.value)[0]);
+    const placedAlign = vue.computed(() => getSideAndAlignFromPlacement(placement.value)[1]);
+    vue.watchEffect(() => {
+      if (isPositioned.value)
+        emit("placed");
+    });
+    const cannotCenterArrow = vue.computed(
+      () => middlewareData.value.arrow?.centerOffset !== 0
+    );
+    const contentZIndex = vue.ref("");
+    vue.watchEffect(() => {
+      if (contentElement.value)
+        contentZIndex.value = window.getComputedStyle(contentElement.value).zIndex;
+    });
+    const arrowX = vue.computed(() => middlewareData.value.arrow?.x ?? 0);
+    const arrowY = vue.computed(() => middlewareData.value.arrow?.y ?? 0);
+    providePopperContentContext({
+      placedSide,
+      onArrowChange: (element) => arrow.value = element,
+      arrowX,
+      arrowY,
+      shouldHideArrow: cannotCenterArrow
+    });
+    return {
+      floatingRef,
+      floatingStyles,
+      isPositioned,
+      contentZIndex,
+      middlewareData,
+      forwardRef,
+      placedSide,
+      placedAlign,
+      attrStyle: attrs.style
+    };
+  },
+  render() {
+    return vue.h("div", {
+      "data-destyler-popper-content-wrapper": "",
+      "ref": "floatingRef",
+      "style": {
+        ...this.floatingStyles,
+        transform: this.isPositioned ? this.floatingStyles.transform : "translate(0, -200%)",
+        minWidth: "max-content",
+        zIndex: this.contentZIndex,
+        ["--destyler-popper-transform-origin"]: [
+          this.middlewareData.transformOrigin?.x,
+          this.middlewareData.transformOrigin?.y
+        ].join(" "),
+        ...this.middlewareData.hide?.referenceHidden && {
+          visibility: "hidden",
+          pointerEvents: "none"
+        }
+      }
+    }, vue.h(primitive.Primitive, vue.mergeProps(this.$attrs, {
+      "ref": (el) => this.forwardRef(el),
+      "as": this.$props.as,
+      "asChild": this.$props.asChild,
+      "data-side": this.placedSide,
+      "data-align": this.placedAlign,
+      "style": {
+        animation: !this.isPositioned ? "none" : void 0
+      }
+    }), () => this.$slots.default?.()));
+  }
+});
+
+const OPPOSITE_SIDE = {
+  top: "bottom",
+  right: "left",
+  bottom: "top",
+  left: "right"
+};
+const popperArrowProps = {
+  ...component.arrowProps
+};
+const PopperArrow = vue.defineComponent({
+  name: "DestylerPopperArrow",
+  inheritAttrs: false,
+  props: popperArrowProps,
+  setup() {
+    const contentContext = injectPopperContentContext();
+    const baseSide = vue.computed(() => OPPOSITE_SIDE[contentContext.placedSide.value]);
+    return {
+      contentContext,
+      baseSide
+    };
+  },
+  render() {
+    return vue.h("span", {
+      ref: (el) => {
+        this.contentContext.onArrowChange(el);
+        return void 0;
+      },
+      style: {
+        position: "absolute",
+        left: this.contentContext.arrowX?.value ? `${this.contentContext.arrowX?.value}px` : void 0,
+        top: this.contentContext.arrowY?.value ? `${this.contentContext.arrowY?.value}px` : void 0,
+        [this.baseSide]: 0,
+        transformOrigin: {
+          top: "",
+          right: "0 0",
+          bottom: "center 0",
+          left: "100% 0"
+        }[this.contentContext.placedSide.value],
+        transform: {
+          top: "translateY(100%)",
+          right: "translateY(50%) rotate(90deg) translateX(-50%)",
+          bottom: `rotate(180deg)`,
+          left: "translateY(50%) rotate(-90deg) translateX(50%)"
+        }[this.contentContext.placedSide.value],
+        visibility: this.contentContext.shouldHideArrow.value ? "hidden" : void 0
+      }
+    }, () => vue.h(arrow.Arrow, vue.mergeProps(this.$attrs, {
+      as: this.$props.as,
+      asChild: this.$props.asChild,
+      width: this.$props.width,
+      height: this.$props.height,
+      style: {
+        display: "block"
+      }
+    }), () => this.$slots.default?.()));
+  }
+});
+
+exports.PopperAnchor = PopperAnchor;
+exports.PopperArrow = PopperArrow;
+exports.PopperContent = PopperContent;
+exports.PopperRoot = PopperRoot;
+exports.popperAnchorProps = popperAnchorProps;
+exports.popperArrowProps = popperArrowProps;
+exports.popperContentEmits = popperContentEmits;
+exports.popperContentProps = popperContentProps;