@arun-dev/headless 4.3.0 → 4.5.0

package/dist/anchoring-Btxi0QwC.d.cts

@@ -0,0 +1,12 @@
+/**
+ * CSS anchor positioning for popups placed beside a trigger — Popover and Tooltip
+ * (decision 12). Internal: shared between components, not exported (decision 9).
+ *
+ * The trigger carries a generated `anchor-name`; the popup names it in `position-anchor`
+ * and is placed by `position-area`, flipping across the axis it opens along when there is
+ * no room. All inline, so the browser keeps it attached with nothing measured.
+ */
+type AnchorSide = 'top' | 'bottom' | 'left' | 'right';
+type AnchorAlign = 'start' | 'center' | 'end';
+
+export type { AnchorSide as A, AnchorAlign as a };

package/dist/anchoring-Btxi0QwC.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS anchor positioning for popups placed beside a trigger — Popover and Tooltip
+ * (decision 12). Internal: shared between components, not exported (decision 9).
+ *
+ * The trigger carries a generated `anchor-name`; the popup names it in `position-anchor`
+ * and is placed by `position-area`, flipping across the axis it opens along when there is
+ * no room. All inline, so the browser keeps it attached with nothing measured.
+ */
+type AnchorSide = 'top' | 'bottom' | 'left' | 'right';
+type AnchorAlign = 'start' | 'center' | 'end';
+
+export type { AnchorSide as A, AnchorAlign as a };

package/dist/chunk-HCOCPQXS.js

@@ -0,0 +1,27 @@
+// src/core/anchoring.ts
+function anchorNameFor(id) {
+  return `--hl-anchor-${id.replace(/[^a-zA-Z0-9_-]/g, "")}`;
+}
+var POSITION_AREA = {
+  bottom: { start: "bottom span-right", center: "bottom", end: "bottom span-left" },
+  top: { start: "top span-right", center: "top", end: "top span-left" },
+  right: { start: "right span-bottom", center: "right", end: "right span-top" },
+  left: { start: "left span-bottom", center: "left", end: "left span-top" }
+};
+function anchoredPopupStyle(anchorName, side, align) {
+  return {
+    positionAnchor: anchorName,
+    positionArea: POSITION_AREA[side][align],
+    // Flip across the axis it opens on; the other axis is left alone.
+    positionTryFallbacks: side === "top" || side === "bottom" ? "flip-block" : "flip-inline"
+  };
+}
+function anchoredDataAttributes(side, align) {
+  return { "data-side": side, "data-align": align };
+}
+
+export {
+  anchorNameFor,
+  anchoredPopupStyle,
+  anchoredDataAttributes
+};

package/dist/popover/index.cjs

@@ -0,0 +1,322 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/popover/index.ts
+var popover_exports = {};
+__export(popover_exports, {
+  Popover: () => index_parts_exports
+});
+module.exports = __toCommonJS(popover_exports);
+
+// src/popover/index.parts.ts
+var index_parts_exports = {};
+__export(index_parts_exports, {
+  Close: () => PopoverClose,
+  Popup: () => PopoverPopup,
+  Root: () => PopoverRoot,
+  Trigger: () => PopoverTrigger
+});
+
+// src/popover/PopoverRoot.tsx
+var import_react3 = require("react");
+
+// src/core/anchoring.ts
+function anchorNameFor(id) {
+  return `--hl-anchor-${id.replace(/[^a-zA-Z0-9_-]/g, "")}`;
+}
+var POSITION_AREA = {
+  bottom: { start: "bottom span-right", center: "bottom", end: "bottom span-left" },
+  top: { start: "top span-right", center: "top", end: "top span-left" },
+  right: { start: "right span-bottom", center: "right", end: "right span-top" },
+  left: { start: "left span-bottom", center: "left", end: "left span-top" }
+};
+function anchoredPopupStyle(anchorName, side, align) {
+  return {
+    positionAnchor: anchorName,
+    positionArea: POSITION_AREA[side][align],
+    // Flip across the axis it opens on; the other axis is left alone.
+    positionTryFallbacks: side === "top" || side === "bottom" ? "flip-block" : "flip-inline"
+  };
+}
+function anchoredDataAttributes(side, align) {
+  return { "data-side": side, "data-align": align };
+}
+
+// src/core/useControlled.ts
+var import_react = require("react");
+function useControlled({
+  controlled,
+  default: defaultValue,
+  name = "Component",
+  state = "value"
+}) {
+  const { current: isControlled } = (0, import_react.useRef)(controlled !== void 0);
+  const [uncontrolled, setUncontrolled] = (0, import_react.useState)(defaultValue);
+  const defaultRef = (0, import_react.useRef)(defaultValue);
+  const value = isControlled ? controlled : uncontrolled;
+  if (process.env.NODE_ENV !== "production") {
+    if (isControlled !== (controlled !== void 0)) {
+      console.error(
+        `${name}: cannot switch between controlled and uncontrolled \`${state}\`. Decide which one this component is for the whole of its life.`
+      );
+    }
+    if (!isControlled && defaultRef.current !== defaultValue) {
+      console.error(
+        `${name}: cannot change the default \`${state}\` after mount. It is only read once, so later changes are silently ignored.`
+      );
+    }
+  }
+  const setValue = (0, import_react.useCallback)(
+    (next) => {
+      if (!isControlled) setUncontrolled(next);
+    },
+    [isControlled]
+  );
+  return [value, setValue];
+}
+
+// src/popover/PopoverRootContext.ts
+var import_react2 = require("react");
+var PopoverRootContext = (0, import_react2.createContext)(null);
+function usePopoverRootContext(part) {
+  const context = (0, import_react2.useContext)(PopoverRootContext);
+  if (context === null) {
+    throw new Error(`<Popover.${part}> must be rendered inside <Popover.Root>.`);
+  }
+  return context;
+}
+
+// src/popover/PopoverRoot.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function PopoverRoot({
+  open: openProp,
+  defaultOpen,
+  onOpenChange,
+  children
+}) {
+  const [open, setOpenState] = useControlled({
+    controlled: openProp,
+    default: defaultOpen ?? false,
+    name: "Popover.Root",
+    state: "open"
+  });
+  const setOpen = (0, import_react3.useCallback)(
+    (next) => {
+      if (next === open) return;
+      setOpenState(next);
+      onOpenChange?.(next);
+    },
+    [open, setOpenState, onOpenChange]
+  );
+  const id = (0, import_react3.useId)();
+  const triggerRef = (0, import_react3.useRef)(null);
+  const context = (0, import_react3.useMemo)(
+    () => ({ open, setOpen, popupId: id, anchorName: anchorNameFor(id), triggerRef }),
+    [open, setOpen, id]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(PopoverRootContext.Provider, { value: context, children });
+}
+
+// src/core/useRender.ts
+var import_react4 = require("react");
+
+// src/core/mergeProps.ts
+function isEventHandler(key) {
+  return key.length > 2 && key.startsWith("on") && key[2] === key[2]?.toUpperCase();
+}
+function mergeRefs(...refs) {
+  return (node) => {
+    const cleanups = refs.map((ref) => {
+      if (typeof ref === "function") {
+        const result = ref(node);
+        return typeof result === "function" ? result : () => ref(null);
+      }
+      if (ref && typeof ref === "object") {
+        ref.current = node;
+        return () => {
+          ref.current = null;
+        };
+      }
+      return void 0;
+    });
+    return () => {
+      cleanups.forEach((cleanup) => {
+        if (typeof cleanup === "function") cleanup();
+      });
+    };
+  };
+}
+function isSyntheticEvent(event) {
+  return typeof event === "object" && event !== null && "nativeEvent" in event;
+}
+function makeEventPreventable(event) {
+  if (Object.prototype.hasOwnProperty.call(event, "preventComponentHandler")) return;
+  const target = event;
+  target.preventComponentHandler = () => {
+    target.componentHandlerPrevented = true;
+  };
+}
+function isComponentHandlerPrevented(event) {
+  return typeof event === "object" && event !== null && event.componentHandlerPrevented === true;
+}
+function chainHandlers(earlier, value) {
+  return (...args) => {
+    const event = args[0];
+    if (isSyntheticEvent(event)) makeEventPreventable(event);
+    value(...args);
+    if (isComponentHandlerPrevented(event)) return;
+    earlier(...args);
+  };
+}
+function mergeProps(...objects) {
+  const merged = {};
+  for (const props of objects) {
+    if (!props) continue;
+    for (const key of Object.keys(props)) {
+      const value = props[key];
+      if (value === void 0) continue;
+      if (isEventHandler(key) && typeof value === "function") {
+        const earlier = merged[key];
+        merged[key] = typeof earlier === "function" ? chainHandlers(earlier, value) : value;
+      } else if (key === "className") {
+        merged.className = merged.className ? `${String(merged.className)} ${String(value)}` : value;
+      } else if (key === "style") {
+        merged.style = { ...merged.style, ...value };
+      } else if (key === "ref") {
+        merged.ref = merged.ref ? mergeRefs(merged.ref, value) : value;
+      } else {
+        merged[key] = value;
+      }
+    }
+  }
+  return merged;
+}
+
+// src/core/useRender.ts
+function useRender({
+  render,
+  defaultTagName,
+  props,
+  consumerProps
+}) {
+  const merged = mergeProps(props, consumerProps);
+  if ((0, import_react4.isValidElement)(render)) {
+    return (0, import_react4.cloneElement)(render, mergeProps(merged, render.props));
+  }
+  return (0, import_react4.createElement)(defaultTagName, merged);
+}
+
+// src/popover/popoverDataAttributes.ts
+function popoverDataAttributes({ open }) {
+  return {
+    "data-open": open ? "" : void 0,
+    "data-closed": open ? void 0 : ""
+  };
+}
+
+// src/popover/PopoverTrigger.tsx
+function PopoverTrigger({ className, children, render, ...rest }) {
+  const { open, setOpen, popupId, anchorName, triggerRef } = usePopoverRootContext("Trigger");
+  return useRender({
+    render,
+    defaultTagName: "button",
+    props: {
+      type: "button",
+      "aria-haspopup": "dialog",
+      "aria-expanded": open,
+      "aria-controls": popupId,
+      ...popoverDataAttributes({ open }),
+      style: { anchorName },
+      className,
+      children,
+      ref: triggerRef,
+      onClick() {
+        setOpen(!open);
+      }
+    },
+    consumerProps: rest
+  });
+}
+
+// src/popover/PopoverPopup.tsx
+var import_react5 = require("react");
+function PopoverPopup({
+  side = "bottom",
+  align = "center",
+  className,
+  children,
+  render,
+  ...rest
+}) {
+  const { open, setOpen, popupId, anchorName, triggerRef } = usePopoverRootContext("Popup");
+  const elementRef = (0, import_react5.useRef)(null);
+  const [, resync] = (0, import_react5.useReducer)((n) => n + 1, 0);
+  (0, import_react5.useEffect)(() => {
+    const popup = elementRef.current;
+    if (!popup || typeof popup.showPopover !== "function") return;
+    const shown = popup.matches(":popover-open");
+    if (open && !shown) {
+      popup.showPopover({ source: triggerRef.current ?? void 0 });
+    } else if (!open && shown) popup.hidePopover();
+  });
+  return useRender({
+    render,
+    defaultTagName: "div",
+    props: {
+      id: popupId,
+      popover: "auto",
+      role: "dialog",
+      ...anchoredDataAttributes(side, align),
+      ...popoverDataAttributes({ open }),
+      style: anchoredPopupStyle(anchorName, side, align),
+      className,
+      children,
+      ref: elementRef,
+      onToggle(event) {
+        if (event.target !== event.currentTarget) return;
+        if (event.nativeEvent.newState !== "closed") return;
+        setOpen(false);
+        resync();
+      }
+    },
+    consumerProps: rest
+  });
+}
+
+// src/popover/PopoverClose.tsx
+function PopoverClose({ className, children, render, ...rest }) {
+  const { setOpen } = usePopoverRootContext("Close");
+  return useRender({
+    render,
+    defaultTagName: "button",
+    props: {
+      type: "button",
+      className,
+      children,
+      onClick() {
+        setOpen(false);
+      }
+    },
+    consumerProps: rest
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Popover
+});

package/dist/popover/index.d.cts

@@ -0,0 +1,99 @@
+import * as react from 'react';
+import { ReactNode, ReactElement, Ref, ComponentPropsWithRef } from 'react';
+import { A as AnchorSide, a as AnchorAlign } from '../anchoring-Btxi0QwC.cjs';
+
+type PopoverRootProps = {
+    /**
+     * Controlled state. Provide `onOpenChange` alongside it.
+     *
+     * Never `undefined` once mounted: the mode is latched at mount, as for Switch.
+     */
+    open?: boolean;
+    /** Initial state when uncontrolled. Read once, at mount. */
+    defaultOpen?: boolean;
+    /**
+     * Called on every request to open or close — Trigger, Close, Esc, or a click outside.
+     * A controlled popover moves only if the parent accepts it.
+     */
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+};
+/**
+ * Holds a popover's state and shares it with its parts. Renders no element of its own.
+ *
+ * The popup is a native `popover`, placed by CSS anchor positioning (decision 12): the
+ * platform supplies the top layer, light dismiss, Esc, the Tab order from the trigger and
+ * focus return; the browser keeps it attached. This component adds state, one setter every
+ * close goes through, and the anchor wiring.
+ */
+declare function PopoverRoot({ open: openProp, defaultOpen, onOpenChange, children, }: PopoverRootProps): react.JSX.Element;
+
+type PopoverTriggerOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverTriggerProps = PopoverTriggerOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof PopoverTriggerOwnProps>;
+/**
+ * Opens and closes the popover, and is what it is anchored to: it carries the
+ * `anchor-name` the popup positions against. A native `<button>`, so focus and activation
+ * are the platform's.
+ *
+ * It becomes the popup's invoker when it opens, so a click on it while open is not a
+ * click outside — it toggles the popover closed rather than light-dismissing and reopening.
+ */
+declare function PopoverTrigger({ className, children, render, ...rest }: PopoverTriggerProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type PopoverSide = AnchorSide;
+type PopoverAlign = AnchorAlign;
+type PopoverPopupOwnProps = {
+    /** Which side of the trigger to open on. Flips to the opposite side when there is no room. */
+    side?: PopoverSide;
+    /** Where along that side: flush with the trigger's start or end edge, or centred on it. */
+    align?: PopoverAlign;
+    /** Element to render instead of the default `<div>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverPopupProps = PopoverPopupOwnProps & Omit<ComponentPropsWithRef<'div'>, keyof PopoverPopupOwnProps | 'popover'>;
+/**
+ * The popup: a native `popover="auto"`, shown with `showPopover({ source })` whenever the
+ * Root is open and hidden when it is not. State drives the element, never the reverse.
+ *
+ * Placement is CSS anchor positioning, set inline: `position-anchor` names the trigger,
+ * `position-area` comes from `side` and `align`, and `position-try-fallbacks` flips it
+ * when there is no room (decision 12). `data-side` and `data-align` repeat the request —
+ * not where a fallback moved it, which script cannot observe.
+ *
+ * Light dismiss and Esc close the element before anyone is asked; the `toggle` event
+ * reports it through the Root, and the element reopens if the state stays open.
+ *
+ * `role="dialog"`, non-modal. Name it with `aria-label` or `aria-labelledby`.
+ */
+declare function PopoverPopup({ side, align, className, children, render, ...rest }: PopoverPopupProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type PopoverCloseOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverCloseProps = PopoverCloseOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof PopoverCloseOwnProps>;
+/**
+ * Closes the popover. Esc and a click outside already do; this is the visible way, for
+ * pointer users and for screen reader users who would not guess either.
+ */
+declare function PopoverClose({ className, children, render, ...rest }: PopoverCloseProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+declare namespace index_parts {
+  export { PopoverClose as Close, PopoverPopup as Popup, PopoverRoot as Root, PopoverTrigger as Trigger };
+}
+
+/** The state Popover.Root shares with its parts, and projects as `data-*` attributes. */
+type PopoverState = {
+    open: boolean;
+};
+
+export { index_parts as Popover, type PopoverAlign, type PopoverCloseProps, type PopoverPopupProps, type PopoverRootProps, type PopoverSide, type PopoverState, type PopoverTriggerProps };

package/dist/popover/index.d.ts

@@ -0,0 +1,99 @@
+import * as react from 'react';
+import { ReactNode, ReactElement, Ref, ComponentPropsWithRef } from 'react';
+import { A as AnchorSide, a as AnchorAlign } from '../anchoring-Btxi0QwC.js';
+
+type PopoverRootProps = {
+    /**
+     * Controlled state. Provide `onOpenChange` alongside it.
+     *
+     * Never `undefined` once mounted: the mode is latched at mount, as for Switch.
+     */
+    open?: boolean;
+    /** Initial state when uncontrolled. Read once, at mount. */
+    defaultOpen?: boolean;
+    /**
+     * Called on every request to open or close — Trigger, Close, Esc, or a click outside.
+     * A controlled popover moves only if the parent accepts it.
+     */
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+};
+/**
+ * Holds a popover's state and shares it with its parts. Renders no element of its own.
+ *
+ * The popup is a native `popover`, placed by CSS anchor positioning (decision 12): the
+ * platform supplies the top layer, light dismiss, Esc, the Tab order from the trigger and
+ * focus return; the browser keeps it attached. This component adds state, one setter every
+ * close goes through, and the anchor wiring.
+ */
+declare function PopoverRoot({ open: openProp, defaultOpen, onOpenChange, children, }: PopoverRootProps): react.JSX.Element;
+
+type PopoverTriggerOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverTriggerProps = PopoverTriggerOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof PopoverTriggerOwnProps>;
+/**
+ * Opens and closes the popover, and is what it is anchored to: it carries the
+ * `anchor-name` the popup positions against. A native `<button>`, so focus and activation
+ * are the platform's.
+ *
+ * It becomes the popup's invoker when it opens, so a click on it while open is not a
+ * click outside — it toggles the popover closed rather than light-dismissing and reopening.
+ */
+declare function PopoverTrigger({ className, children, render, ...rest }: PopoverTriggerProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type PopoverSide = AnchorSide;
+type PopoverAlign = AnchorAlign;
+type PopoverPopupOwnProps = {
+    /** Which side of the trigger to open on. Flips to the opposite side when there is no room. */
+    side?: PopoverSide;
+    /** Where along that side: flush with the trigger's start or end edge, or centred on it. */
+    align?: PopoverAlign;
+    /** Element to render instead of the default `<div>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverPopupProps = PopoverPopupOwnProps & Omit<ComponentPropsWithRef<'div'>, keyof PopoverPopupOwnProps | 'popover'>;
+/**
+ * The popup: a native `popover="auto"`, shown with `showPopover({ source })` whenever the
+ * Root is open and hidden when it is not. State drives the element, never the reverse.
+ *
+ * Placement is CSS anchor positioning, set inline: `position-anchor` names the trigger,
+ * `position-area` comes from `side` and `align`, and `position-try-fallbacks` flips it
+ * when there is no room (decision 12). `data-side` and `data-align` repeat the request —
+ * not where a fallback moved it, which script cannot observe.
+ *
+ * Light dismiss and Esc close the element before anyone is asked; the `toggle` event
+ * reports it through the Root, and the element reopens if the state stays open.
+ *
+ * `role="dialog"`, non-modal. Name it with `aria-label` or `aria-labelledby`.
+ */
+declare function PopoverPopup({ side, align, className, children, render, ...rest }: PopoverPopupProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+type PopoverCloseOwnProps = {
+    /** Element to render instead of the default `<button>`. Props and ref are merged onto it. */
+    render?: ReactElement;
+    /** Ref to the rendered element. Merged with any ref on the `render` element. */
+    ref?: Ref<HTMLElement>;
+};
+type PopoverCloseProps = PopoverCloseOwnProps & Omit<ComponentPropsWithRef<'button'>, keyof PopoverCloseOwnProps>;
+/**
+ * Closes the popover. Esc and a click outside already do; this is the visible way, for
+ * pointer users and for screen reader users who would not guess either.
+ */
+declare function PopoverClose({ className, children, render, ...rest }: PopoverCloseProps): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+
+declare namespace index_parts {
+  export { PopoverClose as Close, PopoverPopup as Popup, PopoverRoot as Root, PopoverTrigger as Trigger };
+}
+
+/** The state Popover.Root shares with its parts, and projects as `data-*` attributes. */
+type PopoverState = {
+    open: boolean;
+};
+
+export { index_parts as Popover, type PopoverAlign, type PopoverCloseProps, type PopoverPopupProps, type PopoverRootProps, type PopoverSide, type PopoverState, type PopoverTriggerProps };