foldkit-primitives 0.7.0 → 0.8.0

package/dist/device/index.d.mts

@@ -59,7 +59,7 @@ export declare const GeolocationMessage: import("foldkit/message").MessageUnion<
 }>;
 export type GeolocationMessage = typeof GeolocationMessage.Type;
 export declare const Geolocation: Bundle.Bundle<"Geolocation", void, {
-  readonly status: "unknown" | "ready" | "denied";
+  readonly status: "unknown" | "denied" | "ready";
   readonly coords: {
     readonly latitude: number;
     readonly longitude: number;
@@ -130,7 +130,7 @@ export declare const mediaDevices: <const Name extends string>(config: {
   /** Read lazily so tests can substitute a double, like the SSE bundle. */
   readonly create?: ((navigator: Navigator) => MediaDevicesHandle | null) | undefined;
 }) => Bundle.Bundle<Name, void, {
-  readonly status: "unknown" | "ready" | "denied";
+  readonly status: "unknown" | "denied" | "ready";
   readonly devices: readonly {
     readonly deviceId: string;
     readonly groupId: string;
@@ -288,7 +288,7 @@ export declare const permissions: <const Name extends string>(config: {
   readonly names: ReadonlyArray<string>;
 }, {
   readonly states: {
-    readonly [x: string]: "denied" | "granted" | "prompt";
+    readonly [x: string]: "granted" | "denied" | "prompt";
   };
   readonly lastError: string | null;
 }, {
@@ -296,15 +296,15 @@ export declare const permissions: <const Name extends string>(config: {
 } | {
   readonly _tag: "Changed";
   readonly name: string;
-  readonly state: "denied" | "granted" | "prompt";
-} | {
-  readonly _tag: "Failed";
-  readonly message: string;
+  readonly state: "granted" | "denied" | "prompt";
 } | {
   readonly _tag: "Snapshot";
   readonly states: {
-    readonly [x: string]: "denied" | "granted" | "prompt";
+    readonly [x: string]: "granted" | "denied" | "prompt";
   };
+} | {
+  readonly _tag: "Failed";
+  readonly message: string;
 }, never, never, ManagedResource.ManagedResourceService<"permissions">, void, Readonly<{
   watch: ManagedResource.Entry<PermissionsModel, PermissionsMessage, Option.Option<ReadonlyArray<string>>, Acquired, WatchService, (acquired: Acquired) => PermissionsMessage>;
 }>, {}>;

package/dist/interaction/index.d.mts

@@ -1,9 +1,9 @@
 import { A as ScrollLock, C as targetOf, D as MoveStarted, E as MoveEnded, M as tabbableWithin, O as Moved, S as Targets, T as Move, _ as boxOf, a as TextEdited, b as TargetHovered, c as DRAG_THRESHOLD, d as DragFact, f as DragPlace, g as PointerDrag, h as DraggedOver, i as TextCommitted, j as FocusScope, k as HideOutside, l as DragCancelled, m as DragZone, n as EditableText, o as TextFact, p as DragStarted, r as TextCancelled, s as textOf, t as EditAsked, u as DragDropped, v as zoneOf, w as Fact$1, x as TargetPressed, y as TargetFact } from "../editable-text-BbsPOATY.mjs";
 import { a as modalityOfKey, i as Modality, r as InputModalityModel, t as InputModality } from "../input-modality-DGOhAknO.mjs";
-import { Schema } from "effect";
+import { Option, Schema } from "effect";
 import * as Mount from "foldkit/mount";
 import { Bundle, Declared } from "foldkit-bundle";
-import { Behavior, Behaviors, SlotItem } from "foldkit-mixins";
+import { Behavior, Behaviors, NamedBehavior, SlotItem } from "foldkit-mixins";
 import { Attribute, Html, HtmlBuilder, KeyboardModifiers } from "foldkit/html";
 declare namespace dismiss_layer_d_exports {
   export { BehaviorOptions$14 as BehaviorOptions, Dismiss, LAYER_ATTRIBUTE, Layer$1 as Layer, Message$9 as Message, Model$9 as Model, TRIGGER_ATTRIBUTE, behavior$14 as behavior, bundle$9 as bundle, layersOnPath, toDismiss };
@@ -434,7 +434,7 @@ declare const bundle$5: Bundle.Bundle<"ListNavigation", {
   readonly _tag: "Focused";
   readonly id: string;
 }, never, never, never, void, {}, {}>;
-interface BehaviorOptions$8<Input, Slots> {
+interface BehaviorOptions$8<Input, Slots, ParentMessage> {
   readonly container: keyof Slots & string;
   /** The slot rendered once per item; must carry the item's id (see `Behaviors.Collection`). */
   readonly item: keyof Slots & string;
@@ -442,6 +442,17 @@ interface BehaviorOptions$8<Input, Slots> {
   /** The text an item is matched by when typing. */
   readonly text: (input: Input, index: number) => string;
   readonly direction?: (input: Input) => Direction;
+  /**
+   * Whether a printable key moves the pointer. Off when the container is a
+   * text field: letters belong to the field, and arrows still navigate.
+   * Defaults to on.
+   */
+  readonly typeahead?: boolean;
+  /**
+   * Enter on the current enabled item. One handler with the arrows: a second
+   * key handler on the same slot would be a second owner of `keydown`.
+   */
+  readonly commit?: (input: Input, id: string) => ParentMessage;
 }
 /**
  * The key's outcome, before it is turned into an attribute: navigation to an
@@ -466,7 +477,7 @@ declare const keyOutcome: (items: Behaviors.Collection.Items<unknown>, texts: Re
  * `OnFocus` as under `RovingTabindex`. Under `virtual` nothing takes DOM focus
  * and the container carries `aria-activedescendant`.
  */
-declare const behavior$8: <Field extends string>(declared: Declared<typeof bundle$5, Field>, args: Args$5) => <Slots>(slots: Slots) => <Input extends { readonly [K in Field]: Model$5; }, ParentMessage>(options: BehaviorOptions$8<Input, Slots>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+declare const behavior$8: <Field extends string>(declared: Declared<typeof bundle$5, Field>, args: Args$5) => <Slots>(slots: Slots) => <Input extends { readonly [K in Field]: Model$5; }, ParentMessage>(options: BehaviorOptions$8<Input, Slots, ParentMessage>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
 declare namespace long_press_d_exports {
   export { Args$4 as Args, BehaviorOptions$7 as BehaviorOptions, LongPressed, Message$4 as Message, Model$4 as Model, behavior$7 as behavior, bundle$4 as bundle };
 }
@@ -577,6 +588,50 @@ interface BehaviorOptions$6<Slots, ParentMessage> {
   readonly toMessage: (fact: Fact$1) => ParentMessage;
 }
 declare const behavior$6: <Slots>(slots: Slots) => <Input, ParentMessage>(options: BehaviorOptions$6<Slots, ParentMessage>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+declare namespace overlay_d_exports {
+  export { DismissPolicy, FocusPolicy, Policy, behaviors, modal, nonModal };
+}
+interface DismissPolicy {
+  /** Dismiss on a press outside. Default `true`. */
+  readonly outside: boolean;
+  /** Dismiss on Escape when topmost. Default `true`. */
+  readonly escape: boolean;
+}
+interface FocusPolicy {
+  /** Keep Tab, Shift+Tab, and stray focus inside. Default `true`. */
+  readonly contain: boolean;
+  /** Give focus back to what had it on unmount. Default `true`. */
+  readonly restore: boolean;
+  /** A selector inside the layer to focus first. */
+  readonly initialFocus?: string;
+}
+interface Policy {
+  readonly dismiss: DismissPolicy;
+  readonly focus: FocusPolicy;
+  /** Lock the document's scroll while mounted. */
+  readonly scroll: {
+    readonly lock: boolean;
+  };
+  /** Mark everything outside inert while mounted. */
+  readonly inert: boolean;
+}
+/** A modal overlay: dismissed by Escape and outside press, focused, locked, inert. */
+declare const modal: Policy;
+/** A modeless overlay: dismissed by Escape and outside press, focus restored, page usable. */
+declare const nonModal: Policy;
+/**
+ * The policy as behaviors, to spread into the view's pipe alongside the
+ * widget's own. Conditional pieces are included or left out when the list
+ * is built — a static policy per composition — so no slot carries a mount
+ * its policy never uses.
+ */
+declare const behaviors: <Slots>(slots: Slots) => <Input, ParentMessage, StackField extends string>(options: {
+  readonly stack: Declared<typeof bundle$9, StackField>;
+  readonly layer: keyof Slots & string;
+  readonly trigger?: keyof Slots & string;
+  readonly id: (input: Input) => string;
+  readonly policy: Policy;
+}) => ReadonlyArray<NamedBehavior<Slots, Input, ParentMessage>>;
 declare namespace press_d_exports {
   export { Args$3 as Args, BehaviorOptions$5 as BehaviorOptions, Fact, Message$3 as Message, Model$3 as Model, PointerType, Pressed, behavior$5 as behavior, bundle$3 as bundle, events };
 }
@@ -834,6 +889,91 @@ interface BehaviorOptions$2<Slots, ParentMessage> {
   readonly toMessage: (fact: DragFact) => ParentMessage;
 }
 declare const behavior$2: <Slots>(slots: Slots) => <Input, ParentMessage>(options: BehaviorOptions$2<Slots, ParentMessage>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+declare namespace placing_d_exports {
+  export { AnchorRect, KeepWithin, OriginRect, PanelRect, PlaceAt, PlaceAtPoint, Placed, PlacedAt, Viewport, ViewportPoint, keepWithin, placeAt, placeAtPoint, placeAtTrigger, placeFor, placedAbove, placedSide, placedTop, shiftIntoViewport };
+}
+interface PanelRect {
+  readonly top: number;
+  readonly right: number;
+  readonly bottom: number;
+  readonly height: number;
+}
+interface Viewport {
+  readonly width: number;
+  readonly height: number;
+}
+interface Placed {
+  /** Pixels to move left; `0` when the panel fits. */
+  readonly dx: number;
+  /** Whether the panel stands above its trigger instead of below. */
+  readonly flip: boolean;
+}
+/** Where the panel goes so it fits: left by the overflow, above when the
+ *  bottom clears the window and the room overhead fits the panel. */
+declare const placeFor: (rect: PanelRect, viewport: Viewport, margin?: number) => Placed;
+/** Pixels to move a box up so its bottom sits `margin` inside the viewport.
+ *  `0` when it already fits, or when its top is already at the margin. */
+declare const shiftIntoViewport: (rect: {
+  readonly top: number;
+  readonly bottom: number;
+}, viewportHeight: number, margin?: number) => number;
+/** Attribute `keepWithin` sets to `placedAbove` when the panel flips. */
+declare const placedSide = "data-fk-placed";
+/** Value of `placedSide` while the panel stands above its anchor. */
+declare const placedAbove = "above";
+interface AnchorRect {
+  readonly left: number;
+  readonly top: number;
+  readonly bottom: number;
+  readonly width: number;
+  readonly height: number;
+}
+interface OriginRect {
+  readonly left: number;
+  readonly top: number;
+}
+interface PlacedAt {
+  readonly left: number;
+  readonly top: number;
+}
+/** Custom property `PlaceAt` writes. A panel reads it as `top` so a viewport
+ *  flip, which sets the `top` property, still wins. */
+declare const placedTop = "--fk-placed-top";
+/** Where a popup sits under its trigger's left edge, in the offset parent's
+ *  coordinates. A zero-size trigger (an inert document) stays at the origin. */
+declare const placeAt: (trigger: AnchorRect, origin: OriginRect, gap?: number) => PlacedAt;
+interface ViewportPoint {
+  readonly x: number;
+  readonly y: number;
+}
+/** Where a popup's top-left sits on a viewport point, in the offset parent's
+ *  coordinates. A context menu uses it: the right-click event carries the
+ *  point, and `OnContextMenu` does not. */
+declare const placeAtPoint: (point: ViewportPoint, origin: OriginRect) => PlacedAt;
+declare const KeepWithin: Mount.MountDefinitionNoArgs<"KeepWithin", never>;
+declare const PlaceAt: Mount.MountDefinitionWithArgs<"PlaceAt", {
+  /** Element id of the trigger the popup opens under. */
+  triggerId: Schema.String;
+  /** Pixels between the trigger's bottom and the popup. */
+  gap: Schema.Number;
+}, never>;
+declare const PlaceAtPoint: Mount.MountDefinitionWithArgs<"PlaceAtPoint", {
+  /** Viewport x of the popup's top-left. */
+  x: Schema.Number;
+  /** Viewport y of the popup's top-left. */
+  y: Schema.Number;
+}, never>;
+declare const placeAtTrigger: <Slots>(slots: Slots) => <Input, ParentMessage>(options: {
+  readonly panel: keyof Slots & string;
+  /** The trigger this open belongs to. Read at insert, so key the panel by it. */
+  readonly triggerId: (input: Input) => string;
+  readonly gap?: number;
+  /** A viewport point wins over the trigger. None places under `triggerId`. */
+  readonly at?: (input: Input) => Option.Option<ViewportPoint>;
+}) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+declare const keepWithin: <Slots>(slots: Slots) => <Input, ParentMessage>(options: {
+  readonly panel: keyof Slots & string;
+}) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
 declare namespace tree_navigation_d_exports {
   export { Action, Args$1 as Args, BehaviorOptions$1 as BehaviorOptions, Message$1 as Message, Model$1 as Model, Row, Shown, behavior$1 as behavior, bundle$1 as bundle, isOpen, move, shown, tabStop };
 }
@@ -1015,5 +1155,5 @@ interface BehaviorOptions<Input, Slots> {
  */
 declare const behavior: <Field extends string>(declared: Declared<typeof bundle, Field>) => <Slots>(slots: Slots) => <Input extends { readonly [K in Field]: Model; }, ParentMessage>(options: BehaviorOptions<Input, Slots>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
 //#endregion
-export { dismiss_layer_d_exports as DismissLayer, editable_text_d_exports as EditableText, focus_scope_d_exports as FocusScope, focus_visible_d_exports as FocusVisible, grid_navigation_d_exports as GridNavigation, layers_d_exports as Layers, list_navigation_d_exports as ListNavigation, live_announce_d_exports as LiveAnnounce, long_press_d_exports as LongPress, move_d_exports as Move, pointer_drag_d_exports as PointerDrag, press_d_exports as Press, roving_tabindex_d_exports as RovingTabindex, selection_d_exports as Selection, targets_d_exports as Targets, tree_navigation_d_exports as TreeNavigation, typeahead_d_exports as Typeahead };
+export { dismiss_layer_d_exports as DismissLayer, editable_text_d_exports as EditableText, focus_scope_d_exports as FocusScope, focus_visible_d_exports as FocusVisible, grid_navigation_d_exports as GridNavigation, layers_d_exports as Layers, list_navigation_d_exports as ListNavigation, live_announce_d_exports as LiveAnnounce, long_press_d_exports as LongPress, move_d_exports as Move, overlay_d_exports as Overlay, placing_d_exports as Placing, pointer_drag_d_exports as PointerDrag, press_d_exports as Press, roving_tabindex_d_exports as RovingTabindex, selection_d_exports as Selection, targets_d_exports as Targets, tree_navigation_d_exports as TreeNavigation, typeahead_d_exports as Typeahead };
 //# sourceMappingURL=index.d.mts.map

package/dist/interaction/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/interaction/dismiss-layer.ts","../../src/interaction/editable-text.ts","../../src/interaction/focus-scope.ts","../../src/interaction/focus-visible.ts","../../src/interaction/roving-tabindex.ts","../../src/interaction/grid-navigation.ts","../../src/interaction/layers.ts","../../src/interaction/live-announce.ts","../../src/interaction/list-navigation.ts","../../src/interaction/long-press.ts","../../src/interaction/move.ts","../../src/interaction/press.ts","../../src/interaction/selection.ts","../../src/interaction/targets.ts","../../src/interaction/pointer-drag.ts","../../src/interaction/tree-navigation.ts","../../src/interaction/typeahead.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/interaction/dismiss-layer.ts","../../src/interaction/editable-text.ts","../../src/interaction/focus-scope.ts","../../src/interaction/focus-visible.ts","../../src/interaction/roving-tabindex.ts","../../src/interaction/grid-navigation.ts","../../src/interaction/layers.ts","../../src/interaction/live-announce.ts","../../src/interaction/list-navigation.ts","../../src/interaction/long-press.ts","../../src/interaction/move.ts","../../src/interaction/overlay.ts","../../src/interaction/press.ts","../../src/interaction/selection.ts","../../src/interaction/targets.ts","../../src/interaction/pointer-drag.ts","../../src/interaction/placing.ts","../../src/interaction/tree-navigation.ts","../../src/interaction/typeahead.ts"],"mappings":"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"}

package/dist/interaction/index.mjs

@@ -867,11 +867,38 @@ const behavior$7 = (declared, args) => (slots) => (options) => {
 					direction: options.direction?.(input) ?? "ltr",
 					page: args.page
 				};
-				const outcome = (key, modifiers) => Option.fromNullishOr(keyOutcome(items, items.ids.map((_, index) => options.text(input, index)), state, key, modifiers, moveOptions));
+				const typeahead = options.typeahead !== false;
+				const decide = (key, modifiers) => {
+					const current = state.current;
+					if (key === "Enter" && options.commit !== void 0 && !modifiers.shiftKey && !modifiers.ctrlKey && !modifiers.altKey && !modifiers.metaKey && current !== null) {
+						const currentIndex = items.indexOf(current);
+						if (currentIndex !== -1 && !items.isDisabled(currentIndex)) return Option.some({
+							_tag: "Commit",
+							id: current,
+							message: options.commit(input, current)
+						});
+					}
+					const result = keyOutcome(items, items.ids.map((_, index) => options.text(input, index)), state, key, modifiers, moveOptions);
+					if (!typeahead && result !== void 0 && result._tag === "Type") return Option.none();
+					if (result === void 0) return Option.none();
+					return Option.some({
+						_tag: "Key",
+						outcome: result
+					});
+				};
+				const messageOf = (decision) => {
+					if (decision._tag === "Commit") return decision.message;
+					return outcomeMessage(decision.outcome);
+				};
 				const stop = tabStop$1(items, state.current);
 				const stopId = stop === -1 ? void 0 : items.ids[stop];
-				if (args.virtual) return [h.OnKeyDownPreventDefault((key, modifiers) => Option.map(outcome(key, modifiers), outcomeMessage)), ...stopId === void 0 ? [] : [h.AriaActiveDescendant(stopId)]];
-				return [h.OnKeyDownFocus((key, modifiers) => Option.map(outcome(key, modifiers), (result) => {
+				if (args.virtual) return [h.OnKeyDownPreventDefault((key, modifiers) => Option.map(decide(key, modifiers), messageOf)), ...stopId === void 0 ? [] : [h.AriaActiveDescendant(stopId)]];
+				return [h.OnKeyDownFocus((key, modifiers) => Option.map(decide(key, modifiers), (decision) => {
+					if (decision._tag === "Commit") return {
+						focusSelector: idSelector(decision.id),
+						message: decision.message
+					};
+					const result = decision.outcome;
 					const target = result._tag === "Navigate" ? result.id : result.match ?? state.current;
 					return {
 						focusSelector: target === null ? ":not(*)" : idSelector(target),
@@ -1252,6 +1279,62 @@ const behavior$4 = (slots) => (options) => Behavior.forSlots(slots)({ [options.h
 	mount: () => Mount.mapMessage(Move(), options.toMessage)
 }) }, { name: "Move" });
 //#endregion
+//#region src/interaction/overlay.ts
+var overlay_exports = /* @__PURE__ */ __exportAll({
+	behaviors: () => behaviors,
+	modal: () => modal,
+	nonModal: () => nonModal
+});
+/** A modal overlay: dismissed by Escape and outside press, focused, locked, inert. */
+const modal = {
+	dismiss: {
+		outside: true,
+		escape: true
+	},
+	focus: {
+		contain: true,
+		restore: true
+	},
+	scroll: { lock: true },
+	inert: true
+};
+/** A modeless overlay: dismissed by Escape and outside press, focus restored, page usable. */
+const nonModal = {
+	dismiss: {
+		outside: true,
+		escape: true
+	},
+	focus: {
+		contain: false,
+		restore: true
+	},
+	scroll: { lock: false },
+	inert: false
+};
+/**
+* The policy as behaviors, to spread into the view's pipe alongside the
+* widget's own. Conditional pieces are included or left out when the list
+* is built — a static policy per composition — so no slot carries a mount
+* its policy never uses.
+*/
+const behaviors = (slots) => (options) => [
+	behavior$14(options.stack)(slots)({
+		layer: options.layer,
+		...options.trigger === void 0 ? {} : { trigger: options.trigger },
+		id: options.id,
+		outsidePress: options.policy.dismiss.outside,
+		escape: options.policy.dismiss.escape
+	}),
+	behavior$12(slots)({
+		container: options.layer,
+		contain: options.policy.focus.contain,
+		restore: options.policy.focus.restore,
+		...options.policy.focus.initialFocus === void 0 ? {} : { initialFocus: options.policy.focus.initialFocus }
+	}),
+	...options.policy.scroll.lock ? [scrollLock(slots)({ container: options.layer })] : [],
+	...options.policy.inert ? [hideOutside(slots)({ container: options.layer })] : []
+];
+//#endregion
 //#region src/interaction/selection.ts
 /**
 * Selection over a set of items: which ids are selected, and the anchor a
@@ -1434,6 +1517,254 @@ const behavior$1 = (slots) => (options) => Behavior.forSlots(slots)({ [options.c
 	}), options.toMessage)
 }) }, { name: "PointerDrag" });
 //#endregion
+//#region src/interaction/placing.ts
+/**
+* Keeps a floating panel inside the viewport: on insert it shifts left past
+* the right edge and flips above its trigger when the bottom overflows and
+* the room overhead fits; on release every inline prop goes. `placeFor` is
+* pure geometry over rects, so the rule is unit-tested and the Mount only
+* reads and writes. Inert without layout (zero rects never overflow), with
+* no timers, observers, or reposition loops.
+*
+* `placeAt` is the other half, for a popup that must open under the trigger
+* that opened it. It writes `left` and `--fk-placed-top` once, relative to
+* the popup's offset parent; the panel's stylesheet reads the variable as
+* `top`, so `keepWithin` can still replace `top` when it flips. Key the
+* popup by the trigger: a Mount reads its args at insert and never again.
+* `placeAtPoint` is the same write for a viewport point, when the open
+* event carried coordinates the message builder dropped. The two mounts
+* start together, so the fit may run before that write; the write measures
+* again. A point that would hang past the bottom shifts up. A trigger still
+* flips, and the panel is marked `data-fk-placed="above"` so a hover bridge
+* can follow the side that opened.
+* Zero-size rects stay at the origin, so an inert document writes nothing
+* a layout pass would have to undo.
+*
+* Three related pieces this is not:
+*
+* - `Anchor.behavior` (`foldkit-mixins-ui`) binds a floating element to
+*   another element's id through floating-ui, with portals and continuous
+*   repositioning. It relocates nodes out from under the runtime (portal by
+*   default) and burns under zero geometry; reach for it when the panel must
+*   track a moving anchor, not for a popup placed once.
+* - `KeepInView` (`foldkit-primitives/dom`) scrolls newly marked content
+*   into view. Same verb, opposite direction: that one moves the page to
+*   the panel, this one moves the panel into the page.
+* - `Overlay.behaviors` owns dismissal, focus, scroll lock, and inertness,
+*   but no positioning; spread this alongside it for the full overlay.
+*/
+var placing_exports = /* @__PURE__ */ __exportAll({
+	KeepWithin: () => KeepWithin,
+	PlaceAt: () => PlaceAt,
+	PlaceAtPoint: () => PlaceAtPoint,
+	keepWithin: () => keepWithin,
+	placeAt: () => placeAt,
+	placeAtPoint: () => placeAtPoint,
+	placeAtTrigger: () => placeAtTrigger,
+	placeFor: () => placeFor,
+	placedAbove: () => placedAbove,
+	placedSide: () => placedSide,
+	placedTop: () => placedTop,
+	shiftIntoViewport: () => shiftIntoViewport
+});
+/** Where the panel goes so it fits: left by the overflow, above when the
+*  bottom clears the window and the room overhead fits the panel. */
+const placeFor = (rect, viewport, margin = 8) => {
+	const over = rect.right - viewport.width + margin;
+	return {
+		dx: over > 0 ? -over : 0,
+		flip: rect.bottom > viewport.height && rect.top - margin >= rect.height
+	};
+};
+/** Pixels to move a box up so its bottom sits `margin` inside the viewport.
+*  `0` when it already fits, or when its top is already at the margin. */
+const shiftIntoViewport = (rect, viewportHeight, margin = 8) => {
+	const overflow = rect.bottom - (viewportHeight - margin);
+	if (overflow <= 0) return 0;
+	const room = rect.top - margin;
+	if (room <= 0) return 0;
+	return Math.min(overflow, room);
+};
+/** Attribute `keepWithin` sets to `placedAbove` when the panel flips. */
+const placedSide = "data-fk-placed";
+/** Value of `placedSide` while the panel stands above its anchor. */
+const placedAbove = "above";
+/** Custom property `PlaceAt` writes. A panel reads it as `top` so a viewport
+*  flip, which sets the `top` property, still wins. */
+const placedTop = "--fk-placed-top";
+/** Where a popup sits under its trigger's left edge, in the offset parent's
+*  coordinates. A zero-size trigger (an inert document) stays at the origin. */
+const placeAt = (trigger, origin, gap = 4) => {
+	if (trigger.width === 0 && trigger.height === 0) return {
+		left: 0,
+		top: 0
+	};
+	return {
+		left: trigger.left - origin.left,
+		top: trigger.bottom - origin.top + gap
+	};
+};
+/** Where a popup's top-left sits on a viewport point, in the offset parent's
+*  coordinates. A context menu uses it: the right-click event carries the
+*  point, and `OnContextMenu` does not. */
+const placeAtPoint = (point, origin) => ({
+	left: point.x - origin.left,
+	top: point.y - origin.top
+});
+const clearFit = (element) => {
+	element.style.translate = "";
+	element.style.top = "";
+	element.style.bottom = "";
+	element.removeAttribute(placedSide);
+};
+const fitWithin = (element) => {
+	clearFit(element);
+	const rect = element.getBoundingClientRect();
+	const placed = placeFor({
+		top: rect.top,
+		right: rect.right,
+		bottom: rect.bottom,
+		height: rect.height
+	}, {
+		width: document.documentElement.clientWidth,
+		height: window.innerHeight
+	});
+	if (placed.dx !== 0) element.style.translate = `${placed.dx}px 0`;
+	if (placed.flip) {
+		element.style.top = "auto";
+		element.style.bottom = "calc(100% + 4px)";
+		element.setAttribute(placedSide, placedAbove);
+	}
+};
+const refits = /* @__PURE__ */ new WeakMap();
+const onPlaced = (element, refit) => {
+	const waiting = refits.get(element) ?? /* @__PURE__ */ new Set();
+	waiting.add(refit);
+	refits.set(element, waiting);
+};
+const offPlaced = (element, refit) => {
+	const waiting = refits.get(element);
+	if (waiting === void 0) return;
+	waiting.delete(refit);
+	if (waiting.size === 0) refits.delete(element);
+};
+const notifyPlaced = (element) => {
+	const waiting = refits.get(element);
+	if (waiting === void 0) return;
+	for (const refit of waiting) refit();
+};
+const applyPlaced = (element, placed) => {
+	element.style.left = `${placed.left}px`;
+	element.style.setProperty(placedTop, `${placed.top}px`);
+};
+const clearPlaced = (element) => {
+	element.style.left = "";
+	element.style.removeProperty(placedTop);
+};
+const writePlaced = (element, placed, shift) => {
+	clearFit(element);
+	applyPlaced(element, placed);
+	if (shift) {
+		const rect = element.getBoundingClientRect();
+		const dy = shiftIntoViewport({
+			top: rect.top,
+			bottom: rect.bottom
+		}, window.innerHeight);
+		if (dy !== 0) element.style.setProperty(placedTop, `${placed.top - dy}px`);
+	}
+	notifyPlaced(element);
+};
+const KeepWithin = Mount.defineStream("KeepWithin", {
+	messages: [Schema.Never],
+	execute: ({ element }) => Stream.callback(() => {
+		if (!(element instanceof HTMLElement)) return Effect.acquireRelease(Effect.void, () => Effect.void);
+		const node = element;
+		const refit = () => fitWithin(node);
+		return Effect.acquireRelease(Effect.sync(() => {
+			onPlaced(node, refit);
+			refit();
+		}), () => Effect.sync(() => {
+			offPlaced(node, refit);
+			clearFit(node);
+		}));
+	})
+});
+const paddingEdge = (node) => {
+	const rect = node.getBoundingClientRect();
+	return {
+		left: rect.left + node.clientLeft,
+		top: rect.top + node.clientTop
+	};
+};
+const originOf = (element) => {
+	const originNode = element.offsetParent;
+	return originNode instanceof HTMLElement ? paddingEdge(originNode) : {
+		left: 0,
+		top: 0
+	};
+};
+const PlaceAt = Mount.defineStream("PlaceAt", {
+	messages: [Schema.Never],
+	args: {
+		/** Element id of the trigger the popup opens under. */
+		triggerId: Schema.String,
+		/** Pixels between the trigger's bottom and the popup. */
+		gap: Schema.Number
+	},
+	execute: ({ element, triggerId, gap }) => Stream.callback(() => Effect.acquireRelease(Effect.sync(() => {
+		if (!(element instanceof HTMLElement)) return;
+		const trigger = document.getElementById(triggerId);
+		if (!(trigger instanceof HTMLElement)) return;
+		const rect = trigger.getBoundingClientRect();
+		writePlaced(element, placeAt({
+			left: rect.left,
+			top: rect.top,
+			bottom: rect.bottom,
+			width: rect.width,
+			height: rect.height
+		}, originOf(element), gap), false);
+	}), () => Effect.sync(() => {
+		if (!(element instanceof HTMLElement)) return;
+		clearPlaced(element);
+	})))
+});
+const PlaceAtPoint = Mount.defineStream("PlaceAtPoint", {
+	messages: [Schema.Never],
+	args: {
+		/** Viewport x of the popup's top-left. */
+		x: Schema.Number,
+		/** Viewport y of the popup's top-left. */
+		y: Schema.Number
+	},
+	execute: ({ element, x, y }) => Stream.callback(() => Effect.acquireRelease(Effect.sync(() => {
+		if (!(element instanceof HTMLElement)) return;
+		writePlaced(element, placeAtPoint({
+			x,
+			y
+		}, originOf(element)), true);
+	}), () => Effect.sync(() => {
+		if (!(element instanceof HTMLElement)) return;
+		clearPlaced(element);
+	})))
+});
+const placeAtTrigger = (slots) => (options) => Behavior.forSlots(slots)({ [options.panel]: Behavior.slot({
+	requires: { capability: Capability.Container },
+	mount: (input) => {
+		const at = options.at?.(input) ?? Option.none();
+		return Option.isSome(at) ? PlaceAtPoint({
+			x: at.value.x,
+			y: at.value.y
+		}) : PlaceAt({
+			triggerId: options.triggerId(input),
+			gap: options.gap ?? 4
+		});
+	}
+}) }, { name: "PlaceAt" });
+const keepWithin = (slots) => (options) => Behavior.forSlots(slots)({ [options.panel]: Behavior.slot({
+	requires: { capability: Capability.Container },
+	mount: () => KeepWithin()
+}) }, { name: "KeepWithin" });
+//#endregion
 //#region src/interaction/tree-navigation.ts
 /**
 * Keyboard navigation of a tree (a file explorer, a page's layers, a nested
@@ -1643,6 +1974,6 @@ const behavior = (declared, args) => (slots) => (options) => {
 	}, { name: "TreeNavigation" });
 };
 //#endregion
-export { dismiss_layer_exports as DismissLayer, editable_text_exports as EditableText, focus_scope_exports as FocusScope, focus_visible_exports as FocusVisible, grid_navigation_exports as GridNavigation, layers_exports as Layers, list_navigation_exports as ListNavigation, live_announce_exports as LiveAnnounce, long_press_exports as LongPress, move_exports as Move, pointer_drag_exports as PointerDrag, press_exports as Press, roving_tabindex_exports as RovingTabindex, selection_exports as Selection, targets_exports as Targets, tree_navigation_exports as TreeNavigation, typeahead_exports as Typeahead };
+export { dismiss_layer_exports as DismissLayer, editable_text_exports as EditableText, focus_scope_exports as FocusScope, focus_visible_exports as FocusVisible, grid_navigation_exports as GridNavigation, layers_exports as Layers, list_navigation_exports as ListNavigation, live_announce_exports as LiveAnnounce, long_press_exports as LongPress, move_exports as Move, overlay_exports as Overlay, placing_exports as Placing, pointer_drag_exports as PointerDrag, press_exports as Press, roving_tabindex_exports as RovingTabindex, selection_exports as Selection, targets_exports as Targets, tree_navigation_exports as TreeNavigation, typeahead_exports as Typeahead };
 
 //# sourceMappingURL=index.mjs.map