@foldkit/ui 0.112.0

package/dist/menu/public.d.ts

@@ -0,0 +1,4 @@
+export { init, create, Model, Message, OutMessage, Selected, SelectedItem, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedFocusItems, CompletedFocusButton, CompletedScrollIntoView, CompletedClickItem, CompletedAnchorMenu, CompletedPortalMenuBackdrop, AnchorMenu, PortalMenuBackdrop, ClearedSearch, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusItems, FocusButton, ScrollIntoView, ClickItem, DelayClearSearch, DetectMovementOrAnimationEnd, } from './index.js';
+export type { ActivationTrigger, Opened, Closed, BlurredItems, ActivatedItem, DeactivatedItem, MovedPointerOverItem, RequestedItemClick, Searched, PressedPointerOnButton, ReleasedPointerOnItems, IgnoredMouseClick, SuppressedSpaceScroll, InitConfig, ViewInputs, ItemConfig, GroupHeading, } from './index.js';
+export type { AnchorConfig } from '../anchor.js';
+//# sourceMappingURL=public.d.ts.map

package/dist/menu/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/menu/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,OAAO,EACP,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/menu/public.js

@@ -0,0 +1 @@
+export { init, create, Model, Message, OutMessage, Selected, SelectedItem, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedFocusItems, CompletedFocusButton, CompletedScrollIntoView, CompletedClickItem, CompletedAnchorMenu, CompletedPortalMenuBackdrop, AnchorMenu, PortalMenuBackdrop, ClearedSearch, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusItems, FocusButton, ScrollIntoView, ClickItem, DelayClearSearch, DetectMovementOrAnimationEnd, } from './index.js';

package/dist/popover/index.d.ts

@@ -0,0 +1,267 @@
+import { Effect, Option, Schema as S } from 'effect';
+import * as Command from 'foldkit/command';
+import { type ChildAttribute, type Html } from 'foldkit/html';
+import * as Mount from 'foldkit/mount';
+import { AnchorConfig } from '../anchor.js';
+/** Schema for the popover component's state, tracking open/closed status and animation lifecycle. */
+export declare const Model: S.Struct<{
+    readonly id: S.String;
+    readonly isOpen: S.Boolean;
+    readonly isAnimated: S.Boolean;
+    readonly isModal: S.Boolean;
+    readonly contentFocus: S.Boolean;
+    readonly animation: S.Struct<{
+        readonly id: S.String;
+        readonly isShowing: S.Boolean;
+        readonly transitionState: S.Literals<readonly ["Idle", "EnterStart", "EnterAnimating", "LeaveStart", "LeaveAnimating"]>;
+    }>;
+    readonly maybeLastButtonPointerType: S.Option<S.String>;
+}>;
+export type Model = typeof Model.Type;
+/** Sent when the popover should open via button click or keyboard activation. */
+export declare const RequestedOpen: import("foldkit/schema").CallableTaggedStruct<"RequestedOpen", {}>;
+/** Sent when the popover should close via Escape key or backdrop click. Returns focus to the button. */
+export declare const RequestedClose: import("foldkit/schema").CallableTaggedStruct<"RequestedClose", {}>;
+/** Sent when the popover panel loses focus. Does NOT return focus to the button. */
+export declare const BlurredPanel: import("foldkit/schema").CallableTaggedStruct<"BlurredPanel", {}>;
+/** Sent when the user presses a pointer device on the popover button. Records pointer type and toggles for mouse. */
+export declare const PressedPointerOnButton: import("foldkit/schema").CallableTaggedStruct<"PressedPointerOnButton", {
+    pointerType: S.String;
+    button: S.Number;
+}>;
+/** Sent when the focus-panel command completes after opening the popover. */
+export declare const CompletedFocusPanel: import("foldkit/schema").CallableTaggedStruct<"CompletedFocusPanel", {}>;
+/** Sent when the focus-button command completes after closing. */
+export declare const CompletedFocusButton: import("foldkit/schema").CallableTaggedStruct<"CompletedFocusButton", {}>;
+/** Sent when the scroll lock command completes. */
+export declare const CompletedLockScroll: import("foldkit/schema").CallableTaggedStruct<"CompletedLockScroll", {}>;
+/** Sent when the scroll unlock command completes. */
+export declare const CompletedUnlockScroll: import("foldkit/schema").CallableTaggedStruct<"CompletedUnlockScroll", {}>;
+/** Sent when the inert-others command completes. */
+export declare const CompletedInertOthers: import("foldkit/schema").CallableTaggedStruct<"CompletedInertOthers", {}>;
+/** Sent when the restore-inert command completes. */
+export declare const CompletedRestoreInert: import("foldkit/schema").CallableTaggedStruct<"CompletedRestoreInert", {}>;
+/** Sent when a mouse click on the button is ignored because pointer-down already handled the toggle. */
+export declare const IgnoredMouseClick: import("foldkit/schema").CallableTaggedStruct<"IgnoredMouseClick", {}>;
+/** Sent when a Space key-up is captured to prevent page scrolling. */
+export declare const SuppressedSpaceScroll: import("foldkit/schema").CallableTaggedStruct<"SuppressedSpaceScroll", {}>;
+/** Sent when the popover panel mounts and Floating UI has positioned it. Update no-ops; the side effect is the act of positioning, surfaced for DevTools observability. */
+export declare const CompletedAnchorPopover: import("foldkit/schema").CallableTaggedStruct<"CompletedAnchorPopover", {}>;
+/** Sent when the popover backdrop mounts and is portaled to the document body. Update no-ops; surfaces the portal side effect for DevTools. */
+export declare const CompletedPortalPopoverBackdrop: import("foldkit/schema").CallableTaggedStruct<"CompletedPortalPopoverBackdrop", {}>;
+/** Wraps an Animation submodel message for delegation. */
+export declare const GotAnimationMessage: import("foldkit/schema").CallableTaggedStruct<"GotAnimationMessage", {
+    message: S.Union<[import("foldkit/schema").CallableTaggedStruct<"Showed", {}>, import("foldkit/schema").CallableTaggedStruct<"Hid", {}>, import("foldkit/schema").CallableTaggedStruct<"AdvancedAnimationFrame", {}>, import("foldkit/schema").CallableTaggedStruct<"EndedAnimation", {}>]>;
+}>;
+/** Union of all messages the popover component can produce. */
+export declare const Message: S.Union<[
+    typeof RequestedOpen,
+    typeof RequestedClose,
+    typeof BlurredPanel,
+    typeof PressedPointerOnButton,
+    typeof CompletedFocusPanel,
+    typeof CompletedFocusButton,
+    typeof CompletedLockScroll,
+    typeof CompletedUnlockScroll,
+    typeof CompletedInertOthers,
+    typeof CompletedRestoreInert,
+    typeof IgnoredMouseClick,
+    typeof SuppressedSpaceScroll,
+    typeof CompletedAnchorPopover,
+    typeof CompletedPortalPopoverBackdrop,
+    typeof GotAnimationMessage
+]>;
+export type RequestedOpen = typeof RequestedOpen.Type;
+export type RequestedClose = typeof RequestedClose.Type;
+export type BlurredPanel = typeof BlurredPanel.Type;
+export type PressedPointerOnButton = typeof PressedPointerOnButton.Type;
+export type IgnoredMouseClick = typeof IgnoredMouseClick.Type;
+export type SuppressedSpaceScroll = typeof SuppressedSpaceScroll.Type;
+export type Message = typeof Message.Type;
+/** Sent to the parent after the popover transitions to its open state. Fires once `update` has processed `RequestedOpen` and `isOpen` reflects the new state. */
+export declare const Opened: import("foldkit/schema").CallableTaggedStruct<"Opened", {}>;
+/** Sent to the parent after the popover transitions to its closed state. */
+export declare const Closed: import("foldkit/schema").CallableTaggedStruct<"Closed", {}>;
+/** Union of out-messages the popover component can produce. Parents reacting to open/close transitions (e.g. to reset related state, fire analytics) read this from the third element of `update`'s return tuple. */
+export declare const OutMessage: S.Union<readonly [import("foldkit/schema").CallableTaggedStruct<"Opened", {}>, import("foldkit/schema").CallableTaggedStruct<"Closed", {}>]>;
+export type OutMessage = typeof OutMessage.Type;
+export type Opened = typeof Opened.Type;
+export type Closed = typeof Closed.Type;
+/** Configuration for creating a popover model with `init`. `isAnimated` enables animation coordination (default `false`). `isModal` locks page scroll and inerts other elements when open (default `false`). `contentFocus` hands focus ownership to the consumer. The panel is not focusable and does not close on blur, so the consumer must focus a descendant on open and close the popover on its own blur rules (default `false`). */
+export type InitConfig = Readonly<{
+    id: string;
+    isAnimated?: boolean;
+    isModal?: boolean;
+    contentFocus?: boolean;
+}>;
+/** Creates an initial popover model from a config. Defaults to closed. */
+export declare const init: (config: InitConfig) => Model;
+type UpdateReturn = readonly [
+    Model,
+    ReadonlyArray<Command.Command<Message>>,
+    Option.Option<OutMessage>
+];
+/** Prevents page scrolling while the popover is open in modal mode. */
+export declare const LockScroll: Command.CommandDefinitionNoArgs<"LockScroll", Effect.Effect<{
+    readonly _tag: "CompletedLockScroll";
+}, never, never>>;
+/** Re-enables page scrolling after the popover closes. */
+export declare const UnlockScroll: Command.CommandDefinitionNoArgs<"UnlockScroll", Effect.Effect<{
+    readonly _tag: "CompletedUnlockScroll";
+}, never, never>>;
+/** Marks all elements outside the popover as inert for modal behavior. */
+export declare const InertOthers: Command.CommandDefinitionWithArgs<"InertOthers", {
+    id: S.String;
+}, Effect.Effect<{
+    readonly _tag: "CompletedInertOthers";
+}, never, never>>;
+/** Removes the inert attribute from elements outside the popover. */
+export declare const RestoreInert: Command.CommandDefinitionWithArgs<"RestoreInert", {
+    id: S.String;
+}, Effect.Effect<{
+    readonly _tag: "CompletedRestoreInert";
+}, never, never>>;
+/** Moves focus to the popover panel after opening. */
+export declare const FocusPanel: Command.CommandDefinitionWithArgs<"FocusPanel", {
+    id: S.String;
+}, Effect.Effect<{
+    readonly _tag: "CompletedFocusPanel";
+}, never, never>>;
+/** Moves focus back to the popover button after closing. */
+export declare const FocusButton: Command.CommandDefinitionWithArgs<"FocusButton", {
+    id: S.String;
+}, Effect.Effect<{
+    readonly _tag: "CompletedFocusButton";
+}, never, never>>;
+/** Detects whether the popover button moved or the leave animation ended. Whichever comes first; both outcomes signal the Animation submodel that leave is complete. */
+export declare const DetectMovementOrAnimationEnd: Command.CommandDefinitionWithArgs<"DetectMovementOrAnimationEnd", {
+    id: S.String;
+}, Effect.Effect<{
+    readonly _tag: "GotAnimationMessage";
+    readonly message: {
+        readonly _tag: "Showed";
+    } | {
+        readonly _tag: "Hid";
+    } | {
+        readonly _tag: "AdvancedAnimationFrame";
+    } | {
+        readonly _tag: "EndedAnimation";
+    };
+}, never, never>>;
+/** Processes a popover message and returns the next model, commands, and optional OutMessage. */
+export declare const update: (model: Model, message: Message) => UpdateReturn;
+/** The anchor-positioning Mount this Popover renders on its panel. Exposed so
+ *  Scene tests can call `Scene.Mount.resolve(AnchorPopover, CompletedAnchorPopover())`
+ *  to acknowledge the mount produced by the rendered panel. */
+export declare const AnchorPopover: Mount.MountDefinitionWithArgs<"AnchorPopover", {
+    buttonId: S.String;
+    anchor: S.Struct<{
+        readonly placement: S.optional<S.Literals<readonly ["top", "right", "bottom", "left", "top-start", "top-end", "right-start", "right-end", "bottom-start", "bottom-end", "left-start", "left-end"]>>;
+        readonly gap: S.optional<S.Number>;
+        readonly offset: S.optional<S.Number>;
+        readonly padding: S.optional<S.Number>;
+        readonly portal: S.optional<S.Boolean>;
+    }>;
+    focusSelector: S.optional<S.String>;
+}, {
+    readonly _tag: "CompletedAnchorPopover";
+}>;
+/** The backdrop-portaling Mount this Popover renders. Exposed so Scene tests can
+ *  call `Scene.Mount.resolve(PortalPopoverBackdrop, CompletedPortalPopoverBackdrop())` to
+ *  acknowledge the mount produced by the rendered backdrop. */
+export declare const PortalPopoverBackdrop: Mount.MountDefinitionNoArgs<"PortalPopoverBackdrop", {
+    readonly _tag: "CompletedPortalPopoverBackdrop";
+}>;
+/** Programmatically opens the popover, updating the model and returning
+ *  focus and modal commands plus an `Opened` OutMessage. */
+export declare const open: (model: Model) => UpdateReturn;
+/** Programmatically closes the popover, updating the model and returning
+ *  focus and modal commands plus a `Closed` OutMessage when it was open. */
+export declare const close: (model: Model) => UpdateReturn;
+/** Render-time payload published to the consumer's `toView`.
+ *
+ *  - `button`: attribute bundle for the trigger button.
+ *  - `panel`: attribute bundle for the floating panel. Includes the
+ *    anchor Mount that positions the panel via Floating UI, ARIA
+ *    linkage to the button, and panel keydown/blur handlers.
+ *  - `backdrop`: attribute bundle for the modal backdrop. Includes the
+ *    portal Mount that moves the backdrop to document.body. The
+ *    backdrop's OnClick closes the popover.
+ *  - `isVisible`: derived from `isOpen` and the Animation
+ *    `transitionState`. The consumer renders the panel + backdrop only
+ *    while this is true. */
+export type RenderInfo = Readonly<{
+    button: ReadonlyArray<ChildAttribute>;
+    panel: ReadonlyArray<ChildAttribute>;
+    backdrop: ReadonlyArray<ChildAttribute>;
+    isVisible: boolean;
+}>;
+/** Per-render view inputs passed to `view` via `h.submodel`'s `viewInputs` field. */
+export type ViewInputs = Readonly<{
+    anchor: AnchorConfig;
+    toView: (render: RenderInfo) => Html;
+    isDisabled?: boolean;
+    focusSelector?: string;
+}>;
+/** Renders a headless popover with a trigger button and a floating panel. */
+export declare const view: import("foldkit/submodel").View<{
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly contentFocus: boolean;
+    readonly animation: {
+        readonly id: string;
+        readonly isShowing: boolean;
+        readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    };
+    readonly maybeLastButtonPointerType: Option.Option<string>;
+}, {
+    readonly _tag: "RequestedOpen";
+} | {
+    readonly _tag: "RequestedClose";
+} | {
+    readonly _tag: "BlurredPanel";
+} | {
+    readonly _tag: "PressedPointerOnButton";
+    readonly pointerType: string;
+    readonly button: number;
+} | {
+    readonly _tag: "CompletedFocusPanel";
+} | {
+    readonly _tag: "CompletedFocusButton";
+} | {
+    readonly _tag: "CompletedLockScroll";
+} | {
+    readonly _tag: "CompletedUnlockScroll";
+} | {
+    readonly _tag: "CompletedInertOthers";
+} | {
+    readonly _tag: "CompletedRestoreInert";
+} | {
+    readonly _tag: "IgnoredMouseClick";
+} | {
+    readonly _tag: "SuppressedSpaceScroll";
+} | {
+    readonly _tag: "CompletedAnchorPopover";
+} | {
+    readonly _tag: "CompletedPortalPopoverBackdrop";
+} | {
+    readonly _tag: "GotAnimationMessage";
+    readonly message: {
+        readonly _tag: "Showed";
+    } | {
+        readonly _tag: "Hid";
+    } | {
+        readonly _tag: "AdvancedAnimationFrame";
+    } | {
+        readonly _tag: "EndedAnimation";
+    };
+}, Readonly<{
+    anchor: AnchorConfig;
+    toView: (render: RenderInfo) => Html;
+    isDisabled?: boolean;
+    focusSelector?: string;
+}>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/popover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/popover/index.ts"],"names":[],"mappings":"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"}

package/dist/popover/index.js

@@ -0,0 +1,346 @@
+import { Array, Effect, Equal, Match as M, Option, Schema as S } from 'effect';
+import * as Command from 'foldkit/command';
+import * as Dom from 'foldkit/dom';
+import { childAttributes, html, } from 'foldkit/html';
+import { m } from 'foldkit/message';
+import * as Mount from 'foldkit/mount';
+import { evo } from 'foldkit/struct';
+import { defineView } from 'foldkit/submodel';
+import { AnchorConfig, anchorSetup, portalToBody } from '../anchor.js';
+// NOTE: Animation imports are split across schema + update to avoid a circular
+// dependency: animation → html → runtime → devtools → popover → animation.
+// The barrel (../animation) imports from html, which starts the cycle.
+import { EndedAnimation as AnimationEndedAnimation, Hid as AnimationHid, Message as AnimationMessage, Model as AnimationModel, Showed as AnimationShowed, init as animationInit, } from '../animation/schema.js';
+import { update as animationUpdate } from '../animation/update.js';
+import * as OptionExt from '../internal/optionExtensions.js';
+// MODEL
+/** Schema for the popover component's state, tracking open/closed status and animation lifecycle. */
+export const Model = S.Struct({
+    id: S.String,
+    isOpen: S.Boolean,
+    isAnimated: S.Boolean,
+    isModal: S.Boolean,
+    contentFocus: S.Boolean,
+    animation: AnimationModel,
+    maybeLastButtonPointerType: S.Option(S.String),
+});
+// MESSAGE
+/** Sent when the popover should open via button click or keyboard activation. */
+export const RequestedOpen = m('RequestedOpen');
+/** Sent when the popover should close via Escape key or backdrop click. Returns focus to the button. */
+export const RequestedClose = m('RequestedClose');
+/** Sent when the popover panel loses focus. Does NOT return focus to the button. */
+export const BlurredPanel = m('BlurredPanel');
+/** Sent when the user presses a pointer device on the popover button. Records pointer type and toggles for mouse. */
+export const PressedPointerOnButton = m('PressedPointerOnButton', {
+    pointerType: S.String,
+    button: S.Number,
+});
+/** Sent when the focus-panel command completes after opening the popover. */
+export const CompletedFocusPanel = m('CompletedFocusPanel');
+/** Sent when the focus-button command completes after closing. */
+export const CompletedFocusButton = m('CompletedFocusButton');
+/** Sent when the scroll lock command completes. */
+export const CompletedLockScroll = m('CompletedLockScroll');
+/** Sent when the scroll unlock command completes. */
+export const CompletedUnlockScroll = m('CompletedUnlockScroll');
+/** Sent when the inert-others command completes. */
+export const CompletedInertOthers = m('CompletedInertOthers');
+/** Sent when the restore-inert command completes. */
+export const CompletedRestoreInert = m('CompletedRestoreInert');
+/** Sent when a mouse click on the button is ignored because pointer-down already handled the toggle. */
+export const IgnoredMouseClick = m('IgnoredMouseClick');
+/** Sent when a Space key-up is captured to prevent page scrolling. */
+export const SuppressedSpaceScroll = m('SuppressedSpaceScroll');
+/** Sent when the popover panel mounts and Floating UI has positioned it. Update no-ops; the side effect is the act of positioning, surfaced for DevTools observability. */
+export const CompletedAnchorPopover = m('CompletedAnchorPopover');
+/** Sent when the popover backdrop mounts and is portaled to the document body. Update no-ops; surfaces the portal side effect for DevTools. */
+export const CompletedPortalPopoverBackdrop = m('CompletedPortalPopoverBackdrop');
+/** Wraps an Animation submodel message for delegation. */
+export const GotAnimationMessage = m('GotAnimationMessage', {
+    message: AnimationMessage,
+});
+/** Union of all messages the popover component can produce. */
+export const Message = S.Union([
+    RequestedOpen,
+    RequestedClose,
+    BlurredPanel,
+    PressedPointerOnButton,
+    CompletedFocusPanel,
+    CompletedFocusButton,
+    CompletedLockScroll,
+    CompletedUnlockScroll,
+    CompletedInertOthers,
+    CompletedRestoreInert,
+    IgnoredMouseClick,
+    SuppressedSpaceScroll,
+    CompletedAnchorPopover,
+    CompletedPortalPopoverBackdrop,
+    GotAnimationMessage,
+]);
+// OUT MESSAGE
+/** Sent to the parent after the popover transitions to its open state. Fires once `update` has processed `RequestedOpen` and `isOpen` reflects the new state. */
+export const Opened = m('Opened');
+/** Sent to the parent after the popover transitions to its closed state. */
+export const Closed = m('Closed');
+/** Union of out-messages the popover component can produce. Parents reacting to open/close transitions (e.g. to reset related state, fire analytics) read this from the third element of `update`'s return tuple. */
+export const OutMessage = S.Union([Opened, Closed]);
+// INIT
+const LEFT_MOUSE_BUTTON = 0;
+/** Creates an initial popover model from a config. Defaults to closed. */
+export const init = (config) => ({
+    id: config.id,
+    isOpen: false,
+    isAnimated: config.isAnimated ?? false,
+    isModal: config.isModal ?? false,
+    contentFocus: config.contentFocus ?? false,
+    animation: animationInit({ id: `${config.id}-panel` }),
+    maybeLastButtonPointerType: Option.none(),
+});
+// UPDATE
+const closedModel = (model) => evo(model, {
+    isOpen: () => false,
+    maybeLastButtonPointerType: () => Option.none(),
+});
+const buttonSelector = (id) => `#${id}-button`;
+const panelSelector = (id) => `#${id}-panel`;
+const withUpdateReturn = M.withReturnType();
+/** Prevents page scrolling while the popover is open in modal mode. */
+export const LockScroll = Command.define('LockScroll', CompletedLockScroll)(Dom.lockScroll.pipe(Effect.as(CompletedLockScroll())));
+/** Re-enables page scrolling after the popover closes. */
+export const UnlockScroll = Command.define('UnlockScroll', CompletedUnlockScroll)(Dom.unlockScroll.pipe(Effect.as(CompletedUnlockScroll())));
+/** Marks all elements outside the popover as inert for modal behavior. */
+export const InertOthers = Command.define('InertOthers', { id: S.String }, CompletedInertOthers)(({ id }) => Dom.inertOthers(id, [buttonSelector(id), panelSelector(id)]).pipe(Effect.as(CompletedInertOthers())));
+/** Removes the inert attribute from elements outside the popover. */
+export const RestoreInert = Command.define('RestoreInert', { id: S.String }, CompletedRestoreInert)(({ id }) => Dom.restoreInert(id).pipe(Effect.as(CompletedRestoreInert())));
+/** Moves focus to the popover panel after opening. */
+export const FocusPanel = Command.define('FocusPanel', { id: S.String }, CompletedFocusPanel)(({ id }) => Dom.focus(panelSelector(id)).pipe(Effect.ignore, Effect.as(CompletedFocusPanel())));
+/** Moves focus back to the popover button after closing. */
+export const FocusButton = Command.define('FocusButton', { id: S.String }, CompletedFocusButton)(({ id }) => Dom.focus(buttonSelector(id)).pipe(Effect.ignore, Effect.as(CompletedFocusButton())));
+/** Detects whether the popover button moved or the leave animation ended. Whichever comes first; both outcomes signal the Animation submodel that leave is complete. */
+export const DetectMovementOrAnimationEnd = Command.define('DetectMovementOrAnimationEnd', { id: S.String }, GotAnimationMessage)(({ id }) => Effect.raceFirst(Dom.detectElementMovement(buttonSelector(id)).pipe(Effect.as(GotAnimationMessage({ message: AnimationEndedAnimation() }))), Dom.waitForAnimationSettled(panelSelector(id)).pipe(Effect.as(GotAnimationMessage({ message: AnimationEndedAnimation() })))));
+const delegateToAnimation = (model, animationMessage) => {
+    const [nextAnimation, animationCommands, maybeOutMessage] = animationUpdate(model.animation, animationMessage);
+    const mappedCommands = Command.mapMessages(animationCommands, message => GotAnimationMessage({ message }));
+    const additionalCommands = Option.match(maybeOutMessage, {
+        onNone: () => [],
+        onSome: M.type().pipe(M.tagsExhaustive({
+            StartedLeaveAnimating: () => [
+                DetectMovementOrAnimationEnd({ id: model.id }),
+            ],
+            TransitionedOut: () => [],
+        })),
+    });
+    return [
+        evo(model, { animation: () => nextAnimation }),
+        [...mappedCommands, ...additionalCommands],
+        Option.none(),
+    ];
+};
+/** Processes a popover message and returns the next model, commands, and optional OutMessage. */
+export const update = (model, message) => {
+    const maybeLockScroll = OptionExt.when(model.isModal, LockScroll());
+    const maybeUnlockScroll = OptionExt.when(model.isModal, UnlockScroll());
+    const maybeInertOthers = OptionExt.when(model.isModal, InertOthers({ id: model.id }));
+    const maybeRestoreInert = OptionExt.when(model.isModal, RestoreInert({ id: model.id }));
+    const focusButton = FocusButton({ id: model.id });
+    const openCommands = Array.getSomes([maybeLockScroll, maybeInertOthers]);
+    const closeWithFocusCommands = [
+        focusButton,
+        ...Array.getSomes([maybeUnlockScroll, maybeRestoreInert]),
+    ];
+    const closeWithoutFocusCommands = Array.getSomes([
+        maybeUnlockScroll,
+        maybeRestoreInert,
+    ]);
+    const openPopover = (baseModel) => {
+        if (model.isAnimated) {
+            const [nextModel, animationCommands] = delegateToAnimation(baseModel, AnimationShowed());
+            return [
+                evo(nextModel, { isOpen: () => true }),
+                [...openCommands, ...animationCommands],
+                Option.some(Opened()),
+            ];
+        }
+        return [
+            evo(baseModel, { isOpen: () => true }),
+            openCommands,
+            Option.some(Opened()),
+        ];
+    };
+    const closePopover = (baseModel, commands) => {
+        if (!baseModel.isOpen) {
+            return [baseModel, commands, Option.none()];
+        }
+        const closed = closedModel(baseModel);
+        if (model.isAnimated) {
+            const [nextModel, animationCommands] = delegateToAnimation(closed, AnimationHid());
+            return [
+                nextModel,
+                [...commands, ...animationCommands],
+                Option.some(Closed()),
+            ];
+        }
+        return [closed, commands, Option.some(Closed())];
+    };
+    return M.value(message).pipe(withUpdateReturn, M.tagsExhaustive({
+        RequestedOpen: () => openPopover(model),
+        RequestedClose: () => closePopover(model, closeWithFocusCommands),
+        BlurredPanel: () => {
+            if (Option.exists(model.maybeLastButtonPointerType, Equal.equals('mouse'))) {
+                return [model, [], Option.none()];
+            }
+            return closePopover(model, closeWithoutFocusCommands);
+        },
+        PressedPointerOnButton: ({ pointerType, button }) => {
+            const withPointerType = evo(model, {
+                maybeLastButtonPointerType: () => Option.some(pointerType),
+            });
+            if (pointerType !== 'mouse' || button !== LEFT_MOUSE_BUTTON) {
+                return [withPointerType, [], Option.none()];
+            }
+            if (model.isOpen) {
+                const [closed, commands, maybeOutMessage] = closePopover(withPointerType, closeWithFocusCommands);
+                return [
+                    evo(closed, {
+                        maybeLastButtonPointerType: () => Option.some(pointerType),
+                    }),
+                    commands,
+                    maybeOutMessage,
+                ];
+            }
+            return openPopover(withPointerType);
+        },
+        GotAnimationMessage: ({ message: animationMessage }) => delegateToAnimation(model, animationMessage),
+        CompletedFocusPanel: () => [model, [], Option.none()],
+        CompletedFocusButton: () => [model, [], Option.none()],
+        CompletedLockScroll: () => [model, [], Option.none()],
+        CompletedUnlockScroll: () => [model, [], Option.none()],
+        CompletedInertOthers: () => [model, [], Option.none()],
+        CompletedRestoreInert: () => [model, [], Option.none()],
+        IgnoredMouseClick: () => [
+            evo(model, { maybeLastButtonPointerType: () => Option.none() }),
+            [],
+            Option.none(),
+        ],
+        SuppressedSpaceScroll: () => [model, [], Option.none()],
+        CompletedAnchorPopover: () => [model, [], Option.none()],
+        CompletedPortalPopoverBackdrop: () => [model, [], Option.none()],
+    }));
+};
+/** The anchor-positioning Mount this Popover renders on its panel. Exposed so
+ *  Scene tests can call `Scene.Mount.resolve(AnchorPopover, CompletedAnchorPopover())`
+ *  to acknowledge the mount produced by the rendered panel. */
+export const AnchorPopover = Mount.define('AnchorPopover', {
+    buttonId: S.String,
+    anchor: AnchorConfig,
+    focusSelector: S.optional(S.String),
+}, CompletedAnchorPopover)(({ buttonId, anchor, focusSelector }) => element => Effect.gen(function* () {
+    yield* Effect.acquireRelease(Effect.sync(() => anchorSetup({
+        buttonId,
+        anchor,
+        interceptTab: false,
+        focusAfterPosition: true,
+        ...(focusSelector !== undefined && { focusSelector }),
+    })(element)), cleanup => Effect.sync(cleanup));
+    return CompletedAnchorPopover();
+}));
+/** The backdrop-portaling Mount this Popover renders. Exposed so Scene tests can
+ *  call `Scene.Mount.resolve(PortalPopoverBackdrop, CompletedPortalPopoverBackdrop())` to
+ *  acknowledge the mount produced by the rendered backdrop. */
+export const PortalPopoverBackdrop = Mount.define('PortalPopoverBackdrop', CompletedPortalPopoverBackdrop)(element => Effect.gen(function* () {
+    yield* Effect.acquireRelease(Effect.sync(() => portalToBody(element)), cleanup => Effect.sync(cleanup));
+    return CompletedPortalPopoverBackdrop();
+}));
+/** Programmatically opens the popover, updating the model and returning
+ *  focus and modal commands plus an `Opened` OutMessage. */
+export const open = (model) => update(model, RequestedOpen());
+/** Programmatically closes the popover, updating the model and returning
+ *  focus and modal commands plus a `Closed` OutMessage when it was open. */
+export const close = (model) => update(model, RequestedClose());
+/** Renders a headless popover with a trigger button and a floating panel. */
+export const view = defineView((model, viewInputs) => {
+    const h = html();
+    const { id, isOpen, contentFocus, animation: { transitionState }, maybeLastButtonPointerType, } = model;
+    const { anchor, toView, isDisabled, focusSelector } = viewInputs;
+    const isLeaving = transitionState === 'LeaveStart' || transitionState === 'LeaveAnimating';
+    const isVisible = isOpen || isLeaving;
+    const animationAttributes = M.value(transitionState).pipe(M.when('EnterStart', () => [
+        h.DataAttribute('closed', ''),
+        h.DataAttribute('enter', ''),
+        h.DataAttribute('transition', ''),
+    ]), M.when('EnterAnimating', () => [
+        h.DataAttribute('enter', ''),
+        h.DataAttribute('transition', ''),
+    ]), M.when('LeaveStart', () => [
+        h.DataAttribute('leave', ''),
+        h.DataAttribute('transition', ''),
+    ]), M.when('LeaveAnimating', () => [
+        h.DataAttribute('closed', ''),
+        h.DataAttribute('leave', ''),
+        h.DataAttribute('transition', ''),
+    ]), M.orElse(() => []));
+    const handleButtonKeyDown = (key) => M.value(key).pipe(M.whenOr('Enter', ' ', 'ArrowDown', () => Option.some(isOpen ? RequestedClose() : RequestedOpen())), M.when('Escape', () => OptionExt.when(isOpen, RequestedClose())), M.orElse(() => Option.none()));
+    const handleButtonPointerDown = (pointerType, button) => Option.some(PressedPointerOnButton({ pointerType, button }));
+    const handleButtonClick = () => {
+        const isMouse = Option.exists(maybeLastButtonPointerType, type => type === 'mouse');
+        if (isMouse) {
+            return IgnoredMouseClick();
+        }
+        else if (isOpen) {
+            return RequestedClose();
+        }
+        else {
+            return RequestedOpen();
+        }
+    };
+    const handleSpaceKeyUp = (key) => OptionExt.when(key === ' ', SuppressedSpaceScroll());
+    const handlePanelKeyDown = (key) => M.value(key).pipe(M.when('Escape', () => Option.some(RequestedClose())), M.orElse(() => Option.none()));
+    const buttonAttributes = [
+        h.Id(`${id}-button`),
+        h.Type('button'),
+        h.AriaExpanded(isVisible),
+        h.AriaControls(`${id}-panel`),
+        ...(isDisabled
+            ? [h.AriaDisabled(true), h.DataAttribute('disabled', '')]
+            : [
+                h.OnPointerDown(handleButtonPointerDown),
+                h.OnKeyDownPreventDefault(handleButtonKeyDown),
+                h.OnKeyUpPreventDefault(handleSpaceKeyUp),
+                h.OnClick(handleButtonClick()),
+            ]),
+        ...(isVisible
+            ? [
+                h.DataAttribute('open', ''),
+                h.Style({ position: 'relative', zIndex: '1' }),
+            ]
+            : []),
+    ];
+    const panelAttributes = [
+        h.Id(`${id}-panel`),
+        ...(contentFocus ? [] : [h.Tabindex(0)]),
+        h.Style({ position: 'absolute', margin: '0', visibility: 'hidden' }),
+        h.OnMount(AnchorPopover({
+            buttonId: `${id}-button`,
+            anchor,
+            ...(focusSelector !== undefined && { focusSelector }),
+        })),
+        ...animationAttributes,
+        ...(isLeaving
+            ? []
+            : [
+                h.OnKeyDownPreventDefault(handlePanelKeyDown),
+                ...(contentFocus ? [] : [h.OnBlur(BlurredPanel())]),
+            ]),
+    ];
+    const backdropAttributes = [
+        h.OnMount(PortalPopoverBackdrop()),
+        ...(isLeaving ? [] : [h.OnClick(RequestedClose())]),
+    ];
+    return toView({
+        button: childAttributes(buttonAttributes),
+        panel: childAttributes(panelAttributes),
+        backdrop: childAttributes(backdropAttributes),
+        isVisible,
+    });
+});

package/dist/popover/public.d.ts

@@ -0,0 +1,4 @@
+export { init, update, open, close, view, Model, Message, OutMessage, Opened, Closed, RequestedOpen, RequestedClose, CompletedFocusPanel, CompletedFocusButton, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedAnchorPopover, CompletedPortalPopoverBackdrop, AnchorPopover, PortalPopoverBackdrop, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusPanel, FocusButton, DetectMovementOrAnimationEnd, } from './index.js';
+export type { BlurredPanel, PressedPointerOnButton, IgnoredMouseClick, SuppressedSpaceScroll, InitConfig, ViewInputs, RenderInfo, } from './index.js';
+export type { AnchorConfig } from '../anchor.js';
+//# sourceMappingURL=public.d.ts.map

package/dist/popover/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/popover/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,EACN,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,4BAA4B,GAC7B,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/popover/public.js

@@ -0,0 +1 @@
+export { init, update, open, close, view, Model, Message, OutMessage, Opened, Closed, RequestedOpen, RequestedClose, CompletedFocusPanel, CompletedFocusButton, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedAnchorPopover, CompletedPortalPopoverBackdrop, AnchorPopover, PortalPopoverBackdrop, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusPanel, FocusButton, DetectMovementOrAnimationEnd, } from './index.js';