@zag-js/popover 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/popover.anatomy.ts","../src/popover.connect.ts","../src/popover.dom.ts","../src/popover.machine.ts","../src/popover.props.ts"],"sourcesContent":["import { createAnatomy } from \"@zag-js/anatomy\"\n\nexport const anatomy = createAnatomy(\"popover\").parts(\n \"arrow\",\n \"arrowTip\",\n \"anchor\",\n \"trigger\",\n \"indicator\",\n \"positioner\",\n \"content\",\n \"title\",\n \"description\",\n \"closeTrigger\",\n)\n\nexport const parts = anatomy.build()\n","import { dataAttr } from \"@zag-js/dom-query\"\nimport { getPlacementStyles } from \"@zag-js/popper\"\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\"\nimport { parts } from \"./popover.anatomy\"\nimport { dom } from \"./popover.dom\"\nimport type { MachineApi, Send, State } from \"./popover.types\"\n\nexport function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T> {\n const open = state.matches(\"open\")\n\n const currentPlacement = state.context.currentPlacement\n const portalled = state.context.currentPortalled\n const rendered = state.context.renderedElements\n\n const popperStyles = getPlacementStyles({\n ...state.context.positioning,\n placement: currentPlacement,\n })\n\n return {\n portalled,\n open: open,\n setOpen(_open) {\n if (_open === open) return\n send(_open ? \"OPEN\" : \"CLOSE\")\n },\n reposition(options = {}) {\n send({ type: \"POSITIONING.SET\", options })\n },\n\n arrowProps: normalize.element({\n id: dom.getArrowId(state.context),\n ...parts.arrow.attrs,\n dir: state.context.dir,\n style: popperStyles.arrow,\n }),\n\n arrowTipProps: normalize.element({\n ...parts.arrowTip.attrs,\n dir: state.context.dir,\n style: popperStyles.arrowTip,\n }),\n\n anchorProps: normalize.element({\n ...parts.anchor.attrs,\n dir: state.context.dir,\n id: dom.getAnchorId(state.context),\n }),\n\n triggerProps: normalize.button({\n ...parts.trigger.attrs,\n dir: state.context.dir,\n type: \"button\",\n \"data-placement\": currentPlacement,\n id: dom.getTriggerId(state.context),\n \"aria-haspopup\": \"dialog\",\n \"aria-expanded\": open,\n \"data-state\": open ? \"open\" : \"closed\",\n \"aria-controls\": dom.getContentId(state.context),\n onClick(event) {\n if (event.defaultPrevented) return\n send(\"TOGGLE\")\n },\n onBlur(event) {\n send({ type: \"TRIGGER_BLUR\", target: event.relatedTarget })\n },\n }),\n\n indicatorProps: normalize.element({\n ...parts.indicator.attrs,\n dir: state.context.dir,\n \"data-state\": open ? \"open\" : \"closed\",\n }),\n\n positionerProps: normalize.element({\n id: dom.getPositionerId(state.context),\n ...parts.positioner.attrs,\n dir: state.context.dir,\n style: popperStyles.floating,\n }),\n\n contentProps: normalize.element({\n ...parts.content.attrs,\n dir: state.context.dir,\n id: dom.getContentId(state.context),\n tabIndex: -1,\n role: \"dialog\",\n hidden: !open,\n \"data-state\": open ? \"open\" : \"closed\",\n \"data-expanded\": dataAttr(open),\n \"aria-labelledby\": rendered.title ? dom.getTitleId(state.context) : undefined,\n \"aria-describedby\": rendered.description ? dom.getDescriptionId(state.context) : undefined,\n \"data-placement\": currentPlacement,\n }),\n\n titleProps: normalize.element({\n ...parts.title.attrs,\n id: dom.getTitleId(state.context),\n dir: state.context.dir,\n }),\n\n descriptionProps: normalize.element({\n ...parts.description.attrs,\n id: dom.getDescriptionId(state.context),\n dir: state.context.dir,\n }),\n\n closeTriggerProps: normalize.button({\n ...parts.closeTrigger.attrs,\n dir: state.context.dir,\n id: dom.getCloseTriggerId(state.context),\n type: \"button\",\n \"aria-label\": \"close\",\n onClick(event) {\n if (event.defaultPrevented) return\n send(\"CLOSE\")\n },\n }),\n }\n}\n","import { createScope } from \"@zag-js/dom-query\"\nimport { getFocusables } from \"@zag-js/tabbable\"\nimport { runIfFn } from \"@zag-js/utils\"\nimport type { MachineContext as Ctx } from \"./popover.types\"\n\nexport const dom = createScope({\n getAnchorId: (ctx: Ctx) => ctx.ids?.anchor ?? `popover:${ctx.id}:anchor`,\n getTriggerId: (ctx: Ctx) => ctx.ids?.trigger ?? `popover:${ctx.id}:trigger`,\n getContentId: (ctx: Ctx) => ctx.ids?.content ?? `popover:${ctx.id}:content`,\n getPositionerId: (ctx: Ctx) => ctx.ids?.positioner ?? `popover:${ctx.id}:popper`,\n getArrowId: (ctx: Ctx) => ctx.ids?.arrow ?? `popover:${ctx.id}:arrow`,\n getTitleId: (ctx: Ctx) => ctx.ids?.title ?? `popover:${ctx.id}:title`,\n getDescriptionId: (ctx: Ctx) => ctx.ids?.description ?? `popover:${ctx.id}:desc`,\n getCloseTriggerId: (ctx: Ctx) => ctx.ids?.closeTrigger ?? `popover:${ctx.id}:close`,\n\n getAnchorEl: (ctx: Ctx) => dom.getById(ctx, dom.getAnchorId(ctx)),\n getTriggerEl: (ctx: Ctx) => dom.getById(ctx, dom.getTriggerId(ctx)),\n getContentEl: (ctx: Ctx) => dom.getById(ctx, dom.getContentId(ctx)),\n getPositionerEl: (ctx: Ctx) => dom.getById(ctx, dom.getPositionerId(ctx)),\n getTitleEl: (ctx: Ctx) => dom.getById(ctx, dom.getTitleId(ctx)),\n getDescriptionEl: (ctx: Ctx) => dom.getById(ctx, dom.getDescriptionId(ctx)),\n\n getFocusableEls: (ctx: Ctx) => getFocusables(dom.getContentEl(ctx)),\n getFirstFocusableEl: (ctx: Ctx) => dom.getFocusableEls(ctx)[0],\n\n getInitialFocusEl: (ctx: Ctx) => {\n let el: HTMLElement | null = runIfFn(ctx.initialFocusEl)\n if (!el && ctx.autoFocus) el = dom.getFirstFocusableEl(ctx)\n if (!el) el = dom.getContentEl(ctx)\n return el\n },\n})\n","import { ariaHidden } from \"@zag-js/aria-hidden\"\nimport { createMachine } from \"@zag-js/core\"\nimport { trackDismissableElement } from \"@zag-js/dismissable\"\nimport { nextTick, raf } from \"@zag-js/dom-query\"\nimport { getPlacement } from \"@zag-js/popper\"\nimport { preventBodyScroll } from \"@zag-js/remove-scroll\"\nimport { proxyTabFocus } from \"@zag-js/tabbable\"\nimport { compact, runIfFn } from \"@zag-js/utils\"\nimport { createFocusTrap, type FocusTrap } from \"focus-trap\"\nimport { dom } from \"./popover.dom\"\nimport type { MachineContext, MachineState, UserDefinedContext } from \"./popover.types\"\n\nexport function machine(userContext: UserDefinedContext) {\n const ctx = compact(userContext)\n return createMachine<MachineContext, MachineState>(\n {\n id: \"popover\",\n initial: ctx.open ? \"open\" : \"closed\",\n context: {\n closeOnInteractOutside: true,\n closeOnEsc: true,\n autoFocus: true,\n modal: false,\n portalled: true,\n positioning: {\n placement: \"bottom\",\n ...ctx.positioning,\n },\n currentPlacement: undefined,\n ...ctx,\n renderedElements: {\n title: true,\n description: true,\n },\n },\n\n computed: {\n currentPortalled: (ctx) => !!ctx.modal || !!ctx.portalled,\n },\n\n watch: {\n open: [\"toggleVisibility\"],\n },\n\n entry: [\"checkRenderedElements\"],\n\n states: {\n closed: {\n on: {\n \"CONTROLLED.OPEN\": {\n target: \"open\",\n actions: [\"setInitialFocus\"],\n },\n TOGGLE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnOpen\"],\n },\n {\n target: \"open\",\n actions: [\"invokeOnOpen\", \"setInitialFocus\"],\n },\n ],\n OPEN: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnOpen\"],\n },\n {\n target: \"open\",\n actions: [\"invokeOnOpen\", \"setInitialFocus\"],\n },\n ],\n },\n },\n\n open: {\n activities: [\n \"trapFocus\",\n \"preventScroll\",\n \"hideContentBelow\",\n \"trackPositioning\",\n \"trackDismissableElement\",\n \"proxyTabFocus\",\n ],\n on: {\n \"CONTROLLED.CLOSE\": {\n target: \"closed\",\n actions: [\"restoreFocus\"],\n },\n CLOSE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnClose\"],\n },\n {\n target: \"closed\",\n actions: [\"invokeOnClose\", \"restoreFocus\"],\n },\n ],\n TOGGLE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnClose\"],\n },\n {\n target: \"closed\",\n actions: [\"invokeOnClose\"],\n },\n ],\n \"POSITIONING.SET\": {\n actions: \"reposition\",\n },\n },\n },\n },\n },\n {\n guards: {\n isOpenControlled: (ctx) => !!ctx[\"open.controlled\"],\n },\n activities: {\n trackPositioning(ctx) {\n ctx.currentPlacement = ctx.positioning.placement\n const anchorEl = dom.getAnchorEl(ctx) ?? dom.getTriggerEl(ctx)\n const getPositionerEl = () => dom.getPositionerEl(ctx)\n return getPlacement(anchorEl, getPositionerEl, {\n ...ctx.positioning,\n defer: true,\n onComplete(data) {\n ctx.currentPlacement = data.placement\n },\n })\n },\n trackDismissableElement(ctx, _evt, { send }) {\n const getContentEl = () => dom.getContentEl(ctx)\n let restoreFocus = true\n return trackDismissableElement(getContentEl, {\n pointerBlocking: ctx.modal,\n exclude: dom.getTriggerEl(ctx),\n defer: true,\n onEscapeKeyDown(event) {\n ctx.onEscapeKeyDown?.(event)\n if (ctx.closeOnEsc) return\n event.preventDefault()\n },\n onInteractOutside(event) {\n ctx.onInteractOutside?.(event)\n if (event.defaultPrevented) return\n restoreFocus = !(event.detail.focusable || event.detail.contextmenu)\n if (!ctx.closeOnInteractOutside) {\n event.preventDefault()\n }\n },\n onPointerDownOutside: ctx.onPointerDownOutside,\n onFocusOutside: ctx.onFocusOutside,\n onDismiss() {\n send({ type: \"CLOSE\", src: \"interact-outside\", restoreFocus })\n },\n })\n },\n proxyTabFocus(ctx) {\n if (ctx.modal || !ctx.portalled) return\n const getContentEl = () => dom.getContentEl(ctx)\n return proxyTabFocus(getContentEl, {\n triggerElement: dom.getTriggerEl(ctx),\n defer: true,\n onFocus(el) {\n el.focus({ preventScroll: true })\n },\n })\n },\n hideContentBelow(ctx) {\n if (!ctx.modal) return\n const getElements = () => [dom.getContentEl(ctx), dom.getTriggerEl(ctx)]\n return ariaHidden(getElements, { defer: true })\n },\n preventScroll(ctx) {\n if (!ctx.modal) return\n return preventBodyScroll(dom.getDoc(ctx))\n },\n trapFocus(ctx) {\n if (!ctx.modal) return\n let trap: FocusTrap | undefined\n nextTick(() => {\n const el = dom.getContentEl(ctx)\n if (!el) return\n trap = createFocusTrap(el, {\n escapeDeactivates: false,\n allowOutsideClick: true,\n preventScroll: true,\n returnFocusOnDeactivate: true,\n document: dom.getDoc(ctx),\n fallbackFocus: el,\n initialFocus: runIfFn(ctx.initialFocusEl),\n })\n try {\n trap.activate()\n } catch {}\n })\n return () => trap?.deactivate()\n },\n },\n actions: {\n reposition(ctx, evt) {\n const anchorEl = dom.getAnchorEl(ctx) ?? dom.getTriggerEl(ctx)\n const getPositionerEl = () => dom.getPositionerEl(ctx)\n getPlacement(anchorEl, getPositionerEl, {\n ...ctx.positioning,\n ...evt.options,\n defer: true,\n listeners: false,\n onComplete(data) {\n ctx.currentPlacement = data.placement\n },\n })\n },\n checkRenderedElements(ctx) {\n raf(() => {\n Object.assign(ctx.renderedElements, {\n title: !!dom.getTitleEl(ctx),\n description: !!dom.getDescriptionEl(ctx),\n })\n })\n },\n setInitialFocus(ctx) {\n raf(() => {\n dom.getInitialFocusEl(ctx)?.focus({ preventScroll: true })\n })\n },\n restoreFocus(ctx, evt) {\n if (!evt.restoreFocus) return\n raf(() => {\n dom.getTriggerEl(ctx)?.focus({ preventScroll: true })\n })\n },\n invokeOnOpen(ctx) {\n ctx.onOpenChange?.({ open: true })\n },\n invokeOnClose(ctx) {\n ctx.onOpenChange?.({ open: false })\n },\n toggleVisibility(ctx, evt, { send }) {\n send({ type: ctx.open ? \"CONTROLLED.OPEN\" : \"CONTROLLED.CLOSE\", previousEvent: evt })\n },\n },\n },\n )\n}\n","import { createProps } from \"@zag-js/types\"\nimport { createSplitProps } from \"@zag-js/utils\"\nimport type { UserDefinedContext } from \"./popover.types\"\n\nexport const props = createProps<UserDefinedContext>()([\n \"autoFocus\",\n \"closeOnEsc\",\n \"closeOnInteractOutside\",\n \"dir\",\n \"getRootNode\",\n \"id\",\n \"ids\",\n \"initialFocusEl\",\n \"modal\",\n \"onEscapeKeyDown\",\n \"onFocusOutside\",\n \"onInteractOutside\",\n \"onOpenChange\",\n \"onPointerDownOutside\",\n \"open.controlled\",\n \"open\",\n \"portalled\",\n \"positioning\",\n])\n\nexport const splitProps = createSplitProps<Partial<UserDefinedContext>>(props)\n"],"mappings":"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","names":["runIfFn","ctx","runIfFn"]}
1
+ {"version":3,"sources":["../src/popover.anatomy.ts","../src/popover.connect.ts","../src/popover.dom.ts","../src/popover.machine.ts","../src/popover.props.ts"],"sourcesContent":["import { createAnatomy } from \"@zag-js/anatomy\"\n\nexport const anatomy = createAnatomy(\"popover\").parts(\n \"arrow\",\n \"arrowTip\",\n \"anchor\",\n \"trigger\",\n \"indicator\",\n \"positioner\",\n \"content\",\n \"title\",\n \"description\",\n \"closeTrigger\",\n)\n\nexport const parts = anatomy.build()\n","import { dataAttr } from \"@zag-js/dom-query\"\nimport { getPlacementStyles } from \"@zag-js/popper\"\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\"\nimport { parts } from \"./popover.anatomy\"\nimport { dom } from \"./popover.dom\"\nimport type { MachineApi, Send, State } from \"./popover.types\"\n\nexport function connect<T extends PropTypes>(state: State, send: Send, normalize: NormalizeProps<T>): MachineApi<T> {\n const open = state.matches(\"open\")\n\n const currentPlacement = state.context.currentPlacement\n const portalled = state.context.currentPortalled\n const rendered = state.context.renderedElements\n\n const popperStyles = getPlacementStyles({\n ...state.context.positioning,\n placement: currentPlacement,\n })\n\n return {\n portalled,\n open: open,\n setOpen(nextOpen) {\n if (nextOpen === open) return\n send(nextOpen ? \"OPEN\" : \"CLOSE\")\n },\n reposition(options = {}) {\n send({ type: \"POSITIONING.SET\", options })\n },\n\n arrowProps: normalize.element({\n id: dom.getArrowId(state.context),\n ...parts.arrow.attrs,\n dir: state.context.dir,\n style: popperStyles.arrow,\n }),\n\n arrowTipProps: normalize.element({\n ...parts.arrowTip.attrs,\n dir: state.context.dir,\n style: popperStyles.arrowTip,\n }),\n\n anchorProps: normalize.element({\n ...parts.anchor.attrs,\n dir: state.context.dir,\n id: dom.getAnchorId(state.context),\n }),\n\n triggerProps: normalize.button({\n ...parts.trigger.attrs,\n dir: state.context.dir,\n type: \"button\",\n \"data-placement\": currentPlacement,\n id: dom.getTriggerId(state.context),\n \"aria-haspopup\": \"dialog\",\n \"aria-expanded\": open,\n \"data-state\": open ? \"open\" : \"closed\",\n \"aria-controls\": dom.getContentId(state.context),\n onClick(event) {\n if (event.defaultPrevented) return\n send(\"TOGGLE\")\n },\n onBlur(event) {\n send({ type: \"TRIGGER_BLUR\", target: event.relatedTarget })\n },\n }),\n\n indicatorProps: normalize.element({\n ...parts.indicator.attrs,\n dir: state.context.dir,\n \"data-state\": open ? \"open\" : \"closed\",\n }),\n\n positionerProps: normalize.element({\n id: dom.getPositionerId(state.context),\n ...parts.positioner.attrs,\n dir: state.context.dir,\n style: popperStyles.floating,\n }),\n\n contentProps: normalize.element({\n ...parts.content.attrs,\n dir: state.context.dir,\n id: dom.getContentId(state.context),\n tabIndex: -1,\n role: \"dialog\",\n hidden: !open,\n \"data-state\": open ? \"open\" : \"closed\",\n \"data-expanded\": dataAttr(open),\n \"aria-labelledby\": rendered.title ? dom.getTitleId(state.context) : undefined,\n \"aria-describedby\": rendered.description ? dom.getDescriptionId(state.context) : undefined,\n \"data-placement\": currentPlacement,\n }),\n\n titleProps: normalize.element({\n ...parts.title.attrs,\n id: dom.getTitleId(state.context),\n dir: state.context.dir,\n }),\n\n descriptionProps: normalize.element({\n ...parts.description.attrs,\n id: dom.getDescriptionId(state.context),\n dir: state.context.dir,\n }),\n\n closeTriggerProps: normalize.button({\n ...parts.closeTrigger.attrs,\n dir: state.context.dir,\n id: dom.getCloseTriggerId(state.context),\n type: \"button\",\n \"aria-label\": \"close\",\n onClick(event) {\n if (event.defaultPrevented) return\n send(\"CLOSE\")\n },\n }),\n }\n}\n","import { createScope, getFocusables } from \"@zag-js/dom-query\"\nimport type { MachineContext as Ctx } from \"./popover.types\"\n\nexport const dom = createScope({\n getAnchorId: (ctx: Ctx) => ctx.ids?.anchor ?? `popover:${ctx.id}:anchor`,\n getTriggerId: (ctx: Ctx) => ctx.ids?.trigger ?? `popover:${ctx.id}:trigger`,\n getContentId: (ctx: Ctx) => ctx.ids?.content ?? `popover:${ctx.id}:content`,\n getPositionerId: (ctx: Ctx) => ctx.ids?.positioner ?? `popover:${ctx.id}:popper`,\n getArrowId: (ctx: Ctx) => ctx.ids?.arrow ?? `popover:${ctx.id}:arrow`,\n getTitleId: (ctx: Ctx) => ctx.ids?.title ?? `popover:${ctx.id}:title`,\n getDescriptionId: (ctx: Ctx) => ctx.ids?.description ?? `popover:${ctx.id}:desc`,\n getCloseTriggerId: (ctx: Ctx) => ctx.ids?.closeTrigger ?? `popover:${ctx.id}:close`,\n\n getAnchorEl: (ctx: Ctx) => dom.getById(ctx, dom.getAnchorId(ctx)),\n getTriggerEl: (ctx: Ctx) => dom.getById(ctx, dom.getTriggerId(ctx)),\n getContentEl: (ctx: Ctx) => dom.getById(ctx, dom.getContentId(ctx)),\n getPositionerEl: (ctx: Ctx) => dom.getById(ctx, dom.getPositionerId(ctx)),\n getTitleEl: (ctx: Ctx) => dom.getById(ctx, dom.getTitleId(ctx)),\n getDescriptionEl: (ctx: Ctx) => dom.getById(ctx, dom.getDescriptionId(ctx)),\n\n getFocusableEls: (ctx: Ctx) => getFocusables(dom.getContentEl(ctx)),\n getFirstFocusableEl: (ctx: Ctx) => dom.getFocusableEls(ctx)[0],\n})\n","import { ariaHidden } from \"@zag-js/aria-hidden\"\nimport { createMachine } from \"@zag-js/core\"\nimport { trackDismissableElement } from \"@zag-js/dismissable\"\nimport { getInitialFocus, nextTick, proxyTabFocus, raf } from \"@zag-js/dom-query\"\nimport { getPlacement } from \"@zag-js/popper\"\nimport { preventBodyScroll } from \"@zag-js/remove-scroll\"\nimport { compact } from \"@zag-js/utils\"\nimport { createFocusTrap, type FocusTrap } from \"focus-trap\"\nimport { dom } from \"./popover.dom\"\nimport type { MachineContext, MachineState, UserDefinedContext } from \"./popover.types\"\n\nexport function machine(userContext: UserDefinedContext) {\n const ctx = compact(userContext)\n return createMachine<MachineContext, MachineState>(\n {\n id: \"popover\",\n initial: ctx.open ? \"open\" : \"closed\",\n context: {\n closeOnInteractOutside: true,\n closeOnEscape: true,\n autoFocus: true,\n modal: false,\n portalled: true,\n positioning: {\n placement: \"bottom\",\n ...ctx.positioning,\n },\n currentPlacement: undefined,\n ...ctx,\n renderedElements: {\n title: true,\n description: true,\n },\n },\n\n computed: {\n currentPortalled: (ctx) => !!ctx.modal || !!ctx.portalled,\n },\n\n watch: {\n open: [\"toggleVisibility\"],\n },\n\n entry: [\"checkRenderedElements\"],\n\n states: {\n closed: {\n on: {\n \"CONTROLLED.OPEN\": {\n target: \"open\",\n actions: [\"setInitialFocus\"],\n },\n TOGGLE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnOpen\"],\n },\n {\n target: \"open\",\n actions: [\"invokeOnOpen\", \"setInitialFocus\"],\n },\n ],\n OPEN: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnOpen\"],\n },\n {\n target: \"open\",\n actions: [\"invokeOnOpen\", \"setInitialFocus\"],\n },\n ],\n },\n },\n\n open: {\n activities: [\n \"trapFocus\",\n \"preventScroll\",\n \"hideContentBelow\",\n \"trackPositioning\",\n \"trackDismissableElement\",\n \"proxyTabFocus\",\n ],\n on: {\n \"CONTROLLED.CLOSE\": {\n target: \"closed\",\n actions: [\"setFinalFocus\"],\n },\n CLOSE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnClose\"],\n },\n {\n target: \"closed\",\n actions: [\"invokeOnClose\", \"setFinalFocus\"],\n },\n ],\n TOGGLE: [\n {\n guard: \"isOpenControlled\",\n actions: [\"invokeOnClose\"],\n },\n {\n target: \"closed\",\n actions: [\"invokeOnClose\"],\n },\n ],\n \"POSITIONING.SET\": {\n actions: \"reposition\",\n },\n },\n },\n },\n },\n {\n guards: {\n isOpenControlled: (ctx) => !!ctx[\"open.controlled\"],\n },\n activities: {\n trackPositioning(ctx) {\n ctx.currentPlacement = ctx.positioning.placement\n const anchorEl = dom.getAnchorEl(ctx) ?? dom.getTriggerEl(ctx)\n const getPositionerEl = () => dom.getPositionerEl(ctx)\n return getPlacement(anchorEl, getPositionerEl, {\n ...ctx.positioning,\n defer: true,\n onComplete(data) {\n ctx.currentPlacement = data.placement\n },\n })\n },\n trackDismissableElement(ctx, _evt, { send }) {\n const getContentEl = () => dom.getContentEl(ctx)\n let restoreFocus = true\n return trackDismissableElement(getContentEl, {\n pointerBlocking: ctx.modal,\n exclude: dom.getTriggerEl(ctx),\n defer: true,\n onEscapeKeyDown(event) {\n ctx.onEscapeKeyDown?.(event)\n if (ctx.closeOnEscape) return\n event.preventDefault()\n },\n onInteractOutside(event) {\n ctx.onInteractOutside?.(event)\n if (event.defaultPrevented) return\n restoreFocus = !(event.detail.focusable || event.detail.contextmenu)\n if (!ctx.closeOnInteractOutside) {\n event.preventDefault()\n }\n },\n onPointerDownOutside: ctx.onPointerDownOutside,\n onFocusOutside: ctx.onFocusOutside,\n persistentElements: ctx.persistentElements,\n onDismiss() {\n send({ type: \"CLOSE\", src: \"interact-outside\", restoreFocus })\n },\n })\n },\n proxyTabFocus(ctx) {\n if (ctx.modal || !ctx.portalled) return\n const getContentEl = () => dom.getContentEl(ctx)\n return proxyTabFocus(getContentEl, {\n triggerElement: dom.getTriggerEl(ctx),\n defer: true,\n onFocus(el) {\n el.focus({ preventScroll: true })\n },\n })\n },\n hideContentBelow(ctx) {\n if (!ctx.modal) return\n const getElements = () => [dom.getContentEl(ctx), dom.getTriggerEl(ctx)]\n return ariaHidden(getElements, { defer: true })\n },\n preventScroll(ctx) {\n if (!ctx.modal) return\n return preventBodyScroll(dom.getDoc(ctx))\n },\n trapFocus(ctx) {\n if (!ctx.modal) return\n let trap: FocusTrap | undefined\n nextTick(() => {\n const contentEl = dom.getContentEl(ctx)\n if (!contentEl) return\n trap = createFocusTrap(contentEl, {\n escapeDeactivates: false,\n allowOutsideClick: true,\n preventScroll: true,\n returnFocusOnDeactivate: true,\n document: dom.getDoc(ctx),\n fallbackFocus: contentEl,\n initialFocus: getInitialFocus(dom.getContentEl(ctx), ctx.initialFocusEl),\n })\n\n try {\n trap.activate()\n } catch {}\n })\n return () => trap?.deactivate()\n },\n },\n actions: {\n reposition(ctx, evt) {\n const anchorEl = dom.getAnchorEl(ctx) ?? dom.getTriggerEl(ctx)\n const getPositionerEl = () => dom.getPositionerEl(ctx)\n getPlacement(anchorEl, getPositionerEl, {\n ...ctx.positioning,\n ...evt.options,\n defer: true,\n listeners: false,\n onComplete(data) {\n ctx.currentPlacement = data.placement\n },\n })\n },\n checkRenderedElements(ctx) {\n raf(() => {\n Object.assign(ctx.renderedElements, {\n title: !!dom.getTitleEl(ctx),\n description: !!dom.getDescriptionEl(ctx),\n })\n })\n },\n setInitialFocus(ctx) {\n raf(() => {\n const element = getInitialFocus(dom.getContentEl(ctx), ctx.initialFocusEl)\n element?.focus()\n })\n },\n setFinalFocus(ctx, evt) {\n if (!evt.restoreFocus) return\n raf(() => {\n const element = dom.getTriggerEl(ctx)\n element?.focus({ preventScroll: true })\n })\n },\n invokeOnOpen(ctx) {\n ctx.onOpenChange?.({ open: true })\n },\n invokeOnClose(ctx) {\n ctx.onOpenChange?.({ open: false })\n },\n toggleVisibility(ctx, evt, { send }) {\n send({ type: ctx.open ? \"CONTROLLED.OPEN\" : \"CONTROLLED.CLOSE\", previousEvent: evt })\n },\n },\n },\n )\n}\n","import { createProps } from \"@zag-js/types\"\nimport { createSplitProps } from \"@zag-js/utils\"\nimport type { UserDefinedContext } from \"./popover.types\"\n\nexport const props = createProps<UserDefinedContext>()([\n \"autoFocus\",\n \"closeOnEscape\",\n \"closeOnInteractOutside\",\n \"dir\",\n \"getRootNode\",\n \"id\",\n \"ids\",\n \"initialFocusEl\",\n \"modal\",\n \"onEscapeKeyDown\",\n \"onFocusOutside\",\n \"onInteractOutside\",\n \"onOpenChange\",\n \"onPointerDownOutside\",\n \"open.controlled\",\n \"open\",\n \"persistentElements\",\n \"portalled\",\n \"positioning\",\n])\n\nexport const splitProps = createSplitProps<Partial<UserDefinedContext>>(props)\n"],"mappings":"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","names":["ctx"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zag-js/popover",
3
- "version": "0.49.0",
3
+ "version": "0.51.0",
4
4
  "description": "Core logic for the popover widget implemented as a state machine",
5
5
  "keywords": [
6
6
  "js",
@@ -28,16 +28,15 @@
28
28
  },
29
29
  "dependencies": {
30
30
  "focus-trap": "7.5.4",
31
- "@zag-js/anatomy": "0.49.0",
32
- "@zag-js/aria-hidden": "0.49.0",
33
- "@zag-js/core": "0.49.0",
34
- "@zag-js/dom-query": "0.49.0",
35
- "@zag-js/utils": "0.49.0",
36
- "@zag-js/dismissable": "0.49.0",
37
- "@zag-js/tabbable": "0.49.0",
38
- "@zag-js/popper": "0.49.0",
39
- "@zag-js/remove-scroll": "0.49.0",
40
- "@zag-js/types": "0.49.0"
31
+ "@zag-js/anatomy": "0.51.0",
32
+ "@zag-js/aria-hidden": "0.51.0",
33
+ "@zag-js/core": "0.51.0",
34
+ "@zag-js/dom-query": "0.51.0",
35
+ "@zag-js/utils": "0.51.0",
36
+ "@zag-js/dismissable": "0.51.0",
37
+ "@zag-js/popper": "0.51.0",
38
+ "@zag-js/remove-scroll": "0.51.0",
39
+ "@zag-js/types": "0.51.0"
41
40
  },
42
41
  "devDependencies": {
43
42
  "clean-package": "2.2.0"
@@ -20,9 +20,9 @@ export function connect<T extends PropTypes>(state: State, send: Send, normalize
20
20
  return {
21
21
  portalled,
22
22
  open: open,
23
- setOpen(_open) {
24
- if (_open === open) return
25
- send(_open ? "OPEN" : "CLOSE")
23
+ setOpen(nextOpen) {
24
+ if (nextOpen === open) return
25
+ send(nextOpen ? "OPEN" : "CLOSE")
26
26
  },
27
27
  reposition(options = {}) {
28
28
  send({ type: "POSITIONING.SET", options })
@@ -1,6 +1,4 @@
1
- import { createScope } from "@zag-js/dom-query"
2
- import { getFocusables } from "@zag-js/tabbable"
3
- import { runIfFn } from "@zag-js/utils"
1
+ import { createScope, getFocusables } from "@zag-js/dom-query"
4
2
  import type { MachineContext as Ctx } from "./popover.types"
5
3
 
6
4
  export const dom = createScope({
@@ -22,11 +20,4 @@ export const dom = createScope({
22
20
 
23
21
  getFocusableEls: (ctx: Ctx) => getFocusables(dom.getContentEl(ctx)),
24
22
  getFirstFocusableEl: (ctx: Ctx) => dom.getFocusableEls(ctx)[0],
25
-
26
- getInitialFocusEl: (ctx: Ctx) => {
27
- let el: HTMLElement | null = runIfFn(ctx.initialFocusEl)
28
- if (!el && ctx.autoFocus) el = dom.getFirstFocusableEl(ctx)
29
- if (!el) el = dom.getContentEl(ctx)
30
- return el
31
- },
32
23
  })
@@ -1,11 +1,10 @@
1
1
  import { ariaHidden } from "@zag-js/aria-hidden"
2
2
  import { createMachine } from "@zag-js/core"
3
3
  import { trackDismissableElement } from "@zag-js/dismissable"
4
- import { nextTick, raf } from "@zag-js/dom-query"
4
+ import { getInitialFocus, nextTick, proxyTabFocus, raf } from "@zag-js/dom-query"
5
5
  import { getPlacement } from "@zag-js/popper"
6
6
  import { preventBodyScroll } from "@zag-js/remove-scroll"
7
- import { proxyTabFocus } from "@zag-js/tabbable"
8
- import { compact, runIfFn } from "@zag-js/utils"
7
+ import { compact } from "@zag-js/utils"
9
8
  import { createFocusTrap, type FocusTrap } from "focus-trap"
10
9
  import { dom } from "./popover.dom"
11
10
  import type { MachineContext, MachineState, UserDefinedContext } from "./popover.types"
@@ -18,7 +17,7 @@ export function machine(userContext: UserDefinedContext) {
18
17
  initial: ctx.open ? "open" : "closed",
19
18
  context: {
20
19
  closeOnInteractOutside: true,
21
- closeOnEsc: true,
20
+ closeOnEscape: true,
22
21
  autoFocus: true,
23
22
  modal: false,
24
23
  portalled: true,
@@ -86,7 +85,7 @@ export function machine(userContext: UserDefinedContext) {
86
85
  on: {
87
86
  "CONTROLLED.CLOSE": {
88
87
  target: "closed",
89
- actions: ["restoreFocus"],
88
+ actions: ["setFinalFocus"],
90
89
  },
91
90
  CLOSE: [
92
91
  {
@@ -95,7 +94,7 @@ export function machine(userContext: UserDefinedContext) {
95
94
  },
96
95
  {
97
96
  target: "closed",
98
- actions: ["invokeOnClose", "restoreFocus"],
97
+ actions: ["invokeOnClose", "setFinalFocus"],
99
98
  },
100
99
  ],
101
100
  TOGGLE: [
@@ -141,7 +140,7 @@ export function machine(userContext: UserDefinedContext) {
141
140
  defer: true,
142
141
  onEscapeKeyDown(event) {
143
142
  ctx.onEscapeKeyDown?.(event)
144
- if (ctx.closeOnEsc) return
143
+ if (ctx.closeOnEscape) return
145
144
  event.preventDefault()
146
145
  },
147
146
  onInteractOutside(event) {
@@ -154,6 +153,7 @@ export function machine(userContext: UserDefinedContext) {
154
153
  },
155
154
  onPointerDownOutside: ctx.onPointerDownOutside,
156
155
  onFocusOutside: ctx.onFocusOutside,
156
+ persistentElements: ctx.persistentElements,
157
157
  onDismiss() {
158
158
  send({ type: "CLOSE", src: "interact-outside", restoreFocus })
159
159
  },
@@ -183,17 +183,18 @@ export function machine(userContext: UserDefinedContext) {
183
183
  if (!ctx.modal) return
184
184
  let trap: FocusTrap | undefined
185
185
  nextTick(() => {
186
- const el = dom.getContentEl(ctx)
187
- if (!el) return
188
- trap = createFocusTrap(el, {
186
+ const contentEl = dom.getContentEl(ctx)
187
+ if (!contentEl) return
188
+ trap = createFocusTrap(contentEl, {
189
189
  escapeDeactivates: false,
190
190
  allowOutsideClick: true,
191
191
  preventScroll: true,
192
192
  returnFocusOnDeactivate: true,
193
193
  document: dom.getDoc(ctx),
194
- fallbackFocus: el,
195
- initialFocus: runIfFn(ctx.initialFocusEl),
194
+ fallbackFocus: contentEl,
195
+ initialFocus: getInitialFocus(dom.getContentEl(ctx), ctx.initialFocusEl),
196
196
  })
197
+
197
198
  try {
198
199
  trap.activate()
199
200
  } catch {}
@@ -225,13 +226,15 @@ export function machine(userContext: UserDefinedContext) {
225
226
  },
226
227
  setInitialFocus(ctx) {
227
228
  raf(() => {
228
- dom.getInitialFocusEl(ctx)?.focus({ preventScroll: true })
229
+ const element = getInitialFocus(dom.getContentEl(ctx), ctx.initialFocusEl)
230
+ element?.focus()
229
231
  })
230
232
  },
231
- restoreFocus(ctx, evt) {
233
+ setFinalFocus(ctx, evt) {
232
234
  if (!evt.restoreFocus) return
233
235
  raf(() => {
234
- dom.getTriggerEl(ctx)?.focus({ preventScroll: true })
236
+ const element = dom.getTriggerEl(ctx)
237
+ element?.focus({ preventScroll: true })
235
238
  })
236
239
  },
237
240
  invokeOnOpen(ctx) {
@@ -4,7 +4,7 @@ import type { UserDefinedContext } from "./popover.types"
4
4
 
5
5
  export const props = createProps<UserDefinedContext>()([
6
6
  "autoFocus",
7
- "closeOnEsc",
7
+ "closeOnEscape",
8
8
  "closeOnInteractOutside",
9
9
  "dir",
10
10
  "getRootNode",
@@ -19,6 +19,7 @@ export const props = createProps<UserDefinedContext>()([
19
19
  "onPointerDownOutside",
20
20
  "open.controlled",
21
21
  "open",
22
+ "persistentElements",
22
23
  "portalled",
23
24
  "positioning",
24
25
  ])
@@ -1,7 +1,7 @@
1
1
  import type { StateMachine as S } from "@zag-js/core"
2
- import type { DismissableElementHandlers } from "@zag-js/dismissable"
2
+ import type { DismissableElementHandlers, PersistentElementOptions } from "@zag-js/dismissable"
3
3
  import type { Placement, PositioningOptions } from "@zag-js/popper"
4
- import type { CommonProperties, DirectionProperty, MaybeElement, PropTypes, RequiredBy } from "@zag-js/types"
4
+ import type { CommonProperties, DirectionProperty, PropTypes, RequiredBy } from "@zag-js/types"
5
5
 
6
6
  /* -----------------------------------------------------------------------------
7
7
  * Callback details
@@ -26,7 +26,11 @@ export type ElementIds = Partial<{
26
26
  arrow: string
27
27
  }>
28
28
 
29
- interface PublicContext extends DismissableElementHandlers, CommonProperties, DirectionProperty {
29
+ interface PublicContext
30
+ extends CommonProperties,
31
+ DirectionProperty,
32
+ DismissableElementHandlers,
33
+ PersistentElementOptions {
30
34
  /**
31
35
  * The ids of the elements in the popover. Useful for composition.
32
36
  */
@@ -42,7 +46,8 @@ interface PublicContext extends DismissableElementHandlers, CommonProperties, Di
42
46
  */
43
47
  modal?: boolean
44
48
  /**
45
- * Whether the popover is rendered in a portal
49
+ * Whether the popover is portalled. This will proxy the tabbing behavior regardless of the DOM position
50
+ * of the popover content.
46
51
  *
47
52
  * @default true
48
53
  */
@@ -50,20 +55,24 @@ interface PublicContext extends DismissableElementHandlers, CommonProperties, Di
50
55
  /**
51
56
  * Whether to automatically set focus on the first focusable
52
57
  * content within the popover when opened.
58
+ *
59
+ * @default true
53
60
  */
54
61
  autoFocus?: boolean
55
62
  /**
56
63
  * The element to focus on when the popover is opened.
57
64
  */
58
- initialFocusEl?: MaybeElement | (() => MaybeElement)
65
+ initialFocusEl?: () => HTMLElement | null
59
66
  /**
60
67
  * Whether to close the popover when the user clicks outside of the popover.
68
+ * @default true
61
69
  */
62
70
  closeOnInteractOutside?: boolean
63
71
  /**
64
72
  * Whether to close the popover when the escape key is pressed.
73
+ * @default true
65
74
  */
66
- closeOnEsc?: boolean
75
+ closeOnEscape?: boolean
67
76
  /**
68
77
  * Function invoked when the popover opens or closes
69
78
  */
@@ -124,7 +133,7 @@ export type Send = S.Send<S.AnyEventObject>
124
133
 
125
134
  export interface MachineApi<T extends PropTypes = PropTypes> {
126
135
  /**
127
- * Whether the popover is portalled
136
+ * Whether the popover is portalled.
128
137
  */
129
138
  portalled: boolean
130
139
  /**