foldkit-primitives 0.15.3 → 0.16.0

package/dist/interaction/move.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","names":["Fact"],"sources":["../../src/interaction/move.ts"],"mappings":";;iBAYiB,gBAAgB,OAAO;WAC7B,cAAc;;WAEd,YAAY,MAAMA,WAAS;;qBAGzB,WACV,OAAK,OAAS,WACd,OAAO,eAAa,SACV,gBAAgB,OAAO,mBAC/B,SAAS,cAAc,OAAO,OAAO"}

package/dist/interaction/move.js

@@ -0,0 +1,17 @@
+import * as Mount from "foldkit/mount";
+import { Move, Move as mount, MoveEnded, MoveStarted, Moved } from "../dom/move.js";
+import { Behavior, Capability } from "foldkit-mixins";
+// src/interaction/move.ts
+/**
+* `Move` as a Behavior: attaches the `foldkit-primitives/dom` Mount to a
+* draggable slot and maps its facts into the view's Messages. No Bundle: a
+* drag's meaning (a threshold, a snap, a reorder) is the parent's `update`,
+* and the deltas are already facts.
+*/
+const behavior = (slots) => (options) => Behavior.forSlots(slots)({ [options.handle]: Behavior.slot({
+	requires: { capability: Capability.Draggable },
+	mount: () => Mount.mapMessage(Move(), options.toMessage)
+}) }, { name: "Move" });
+export { MoveEnded, MoveStarted, Moved, behavior, mount };
+
+//# sourceMappingURL=move.js.map

package/dist/interaction/move.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.js","names":["MoveMount"],"sources":["../../src/interaction/move.ts"],"sourcesContent":["/**\n * `Move` as a Behavior: attaches the `foldkit-primitives/dom` Mount to a\n * draggable slot and maps its facts into the view's Messages. No Bundle: a\n * drag's meaning (a threshold, a snap, a reorder) is the parent's `update`,\n * and the deltas are already facts.\n */\nimport * as Mount from 'foldkit/mount'\nimport { Behavior, Capability } from 'foldkit-mixins'\nimport { Move as MoveMount, type Fact } from '../dom/move.js'\n\nexport { Move as mount, MoveEnded, MoveStarted, Moved, type Fact } from '../dom/move.js'\n\nexport interface BehaviorOptions<Slots, ParentMessage> {\n  readonly handle: keyof Slots & string\n  /** Turns each fact into the view's Message. */\n  readonly toMessage: (fact: Fact) => ParentMessage\n}\n\nexport const behavior =\n  <Slots>(slots: Slots) =>\n  <Input, ParentMessage>(\n    options: BehaviorOptions<Slots, ParentMessage>,\n  ): Behavior.NamedBehavior<Slots, Input, ParentMessage> =>\n    Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.handle]: Behavior.slot({\n          requires: { capability: Capability.Draggable },\n          mount: () => Mount.mapMessage(MoveMount(), options.toMessage),\n        }),\n        // Keyed by a value the caller chose; `forSlots` checks the key exists.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'Move' },\n    )\n"],"mappings":";;;;;;;;;;AAkBA,MAAa,YACH,WAEN,YAEA,SAAS,SAAS,KAAK,CAAC,CACtB,GACG,QAAQ,SAAS,SAAS,KAAK;CAC9B,UAAU,EAAE,YAAY,WAAW,UAAU;CAC7C,aAAa,MAAM,WAAWA,KAAU,GAAG,QAAQ,SAAS;AAC9D,CAAC,EAEH,GACA,EAAE,MAAM,OAAO,CACjB"}

package/dist/interaction/overlay.d.ts

@@ -0,0 +1,45 @@
+import { Declared } from "foldkit-bundle";
+import { NamedBehavior } from "foldkit-mixins";
+import { bundle } from "./dismiss-layer.js";
+export interface DismissPolicy {
+  /** Dismiss on a press outside. Default `true`. */
+  readonly outside: boolean;
+  /** Dismiss on Escape when topmost. Default `true`. */
+  readonly escape: boolean;
+}
+export 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;
+}
+export 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. */
+export declare const modal: Policy;
+/** A modeless overlay: dismissed by Escape and outside press, focus restored, page usable. */
+export 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.
+ */
+export declare const behaviors: <Slots>(slots: Slots) => <Input, ParentMessage, StackField extends string>(options: {
+  readonly stack: Declared<typeof bundle, StackField>;
+  readonly layer: keyof Slots & string;
+  readonly trigger?: keyof Slots & string;
+  readonly id: (input: Input) => string;
+  readonly policy: Policy;
+}) => ReadonlyArray<NamedBehavior<Slots, Input, ParentMessage>>;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/interaction/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","names":["dismissLayerBundle"],"sources":["../../src/interaction/overlay.ts"],"mappings":";;;iBAwBiB;;WAEN;;WAEA;;iBAGM;;WAEN;;WAEA;;WAEA;;iBAGM;WACN,SAAS;WACT,OAAO;;WAEP;aAAmB;;;WAEnB;;;qBAIE,OAAO;;qBAQP,UAAU;;;;;;;qBAaV,YACV,OAAK,OAAS,WACd,OAAO,eAAe,2BAAyB;WACrC,OAAO,gBAAgBA,QAAoB;WAC3C,aAAa;WACb,gBAAgB;WAChB,KAAK,OAAO;WACZ,QAAQ;MACf,cAAc,cAAc,OAAO,OAAO"}

package/dist/interaction/overlay.js

@@ -0,0 +1,57 @@
+import "foldkit-mixins";
+import { behavior } from "./dismiss-layer.js";
+import { behavior as behavior$1 } from "./focus-scope.js";
+import { hideOutside, scrollLock } from "./layers.js";
+// src/interaction/overlay.ts
+/** 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(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$1(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 })] : []
+];
+export { behaviors, modal, nonModal };
+
+//# sourceMappingURL=overlay.js.map

package/dist/interaction/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","names":["dismissLayerBehavior","focusScopeBehavior"],"sources":["../../src/interaction/overlay.ts"],"sourcesContent":["/**\n * One overlay policy value instead of nine subtly different overlay\n * implementations. `modal` and `nonModal` cover the two shapes; anything\n * else is an explicit `Policy`. `behaviors` turns a policy into the\n * existing pieces — `DismissLayer` marking, `FocusScope`, `ScrollLock`,\n * `HideOutside` — attached to one layer slot, with nothing reimplemented:\n * the mounts are the shared implementation, and the data attributes are the\n * stack's protocol. Positioning stays per-widget (`Anchor.behavior`\n * directly): it binds a floating element to an external id, a different\n * shape than this layer policy. Presence stays CSS (`data-open`): it needs\n * a per-overlay placement, which is the Drawer's, not the policy's.\n *\n * The `DismissLayer` stack bundle itself is placed once per app, not per\n * overlay; its `Dismiss` outmessage reaches the app through the placement's\n * `onOut`, which closes the dismissed layers. The id `behaviors` writes is\n * the layer attribute (`data-foldkit-plus-layer`), not an element id:\n * `aria-controls` has to name an element that exists.\n */\nimport type { Declared } from 'foldkit-bundle'\nimport { Behavior, type NamedBehavior } from 'foldkit-mixins'\nimport { behavior as dismissLayerBehavior, bundle as dismissLayerBundle } from './dismiss-layer.js'\nimport { behavior as focusScopeBehavior } from './focus-scope.js'\nimport { hideOutside, scrollLock } from './layers.js'\n\nexport interface DismissPolicy {\n  /** Dismiss on a press outside. Default `true`. */\n  readonly outside: boolean\n  /** Dismiss on Escape when topmost. Default `true`. */\n  readonly escape: boolean\n}\n\nexport interface FocusPolicy {\n  /** Keep Tab, Shift+Tab, and stray focus inside. Default `true`. */\n  readonly contain: boolean\n  /** Give focus back to what had it on unmount. Default `true`. */\n  readonly restore: boolean\n  /** A selector inside the layer to focus first. */\n  readonly initialFocus?: string\n}\n\nexport interface Policy {\n  readonly dismiss: DismissPolicy\n  readonly focus: FocusPolicy\n  /** Lock the document's scroll while mounted. */\n  readonly scroll: { readonly lock: boolean }\n  /** Mark everything outside inert while mounted. */\n  readonly inert: boolean\n}\n\n/** A modal overlay: dismissed by Escape and outside press, focused, locked, inert. */\nexport const modal: Policy = {\n  dismiss: { outside: true, escape: true },\n  focus: { contain: true, restore: true },\n  scroll: { lock: true },\n  inert: true,\n}\n\n/** A modeless overlay: dismissed by Escape and outside press, focus restored, page usable. */\nexport const nonModal: Policy = {\n  dismiss: { outside: true, escape: true },\n  focus: { contain: false, restore: true },\n  scroll: { lock: false },\n  inert: false,\n}\n\n/**\n * The policy as behaviors, to spread into the view's pipe alongside the\n * widget's own. Conditional pieces are included or left out when the list\n * is built — a static policy per composition — so no slot carries a mount\n * its policy never uses.\n */\nexport const behaviors =\n  <Slots>(slots: Slots) =>\n  <Input, ParentMessage, StackField extends string>(options: {\n    readonly stack: Declared<typeof dismissLayerBundle, StackField>\n    readonly layer: keyof Slots & string\n    readonly trigger?: keyof Slots & string\n    readonly id: (input: Input) => string\n    readonly policy: Policy\n  }): ReadonlyArray<NamedBehavior<Slots, Input, ParentMessage>> => [\n    dismissLayerBehavior(options.stack)(slots)<Input, ParentMessage>({\n      layer: options.layer,\n      ...(options.trigger === undefined ? {} : { trigger: options.trigger }),\n      id: options.id,\n      outsidePress: options.policy.dismiss.outside,\n      escape: options.policy.dismiss.escape,\n    }),\n    focusScopeBehavior(slots)<Input, ParentMessage>({\n      container: options.layer,\n      contain: options.policy.focus.contain,\n      restore: options.policy.focus.restore,\n      ...(options.policy.focus.initialFocus === undefined\n        ? {}\n        : { initialFocus: options.policy.focus.initialFocus }),\n    }),\n    ...(options.policy.scroll.lock\n      ? [scrollLock(slots)<Input, ParentMessage>({ container: options.layer })]\n      : []),\n    ...(options.policy.inert\n      ? [hideOutside(slots)<Input, ParentMessage>({ container: options.layer })]\n      : []),\n  ]\n"],"mappings":";;;;;;AAkDA,MAAa,QAAgB;CAC3B,SAAS;EAAE,SAAS;EAAM,QAAQ;CAAK;CACvC,OAAO;EAAE,SAAS;EAAM,SAAS;CAAK;CACtC,QAAQ,EAAE,MAAM,KAAK;CACrB,OAAO;AACT;;AAGA,MAAa,WAAmB;CAC9B,SAAS;EAAE,SAAS;EAAM,QAAQ;CAAK;CACvC,OAAO;EAAE,SAAS;EAAO,SAAS;CAAK;CACvC,QAAQ,EAAE,MAAM,MAAM;CACtB,OAAO;AACT;;;;;;;AAQA,MAAa,aACH,WAC0C,YAMe;CAC/DA,SAAqB,QAAQ,KAAK,CAAC,CAAC,KAAK,CAAC,CAAuB;EAC/D,OAAO,QAAQ;EACf,GAAI,QAAQ,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,QAAQ,QAAQ;EACpE,IAAI,QAAQ;EACZ,cAAc,QAAQ,OAAO,QAAQ;EACrC,QAAQ,QAAQ,OAAO,QAAQ;CACjC,CAAC;CACDC,WAAmB,KAAK,CAAC,CAAuB;EAC9C,WAAW,QAAQ;EACnB,SAAS,QAAQ,OAAO,MAAM;EAC9B,SAAS,QAAQ,OAAO,MAAM;EAC9B,GAAI,QAAQ,OAAO,MAAM,iBAAiB,KAAA,IACtC,CAAC,IACD,EAAE,cAAc,QAAQ,OAAO,MAAM,aAAa;CACxD,CAAC;CACD,GAAI,QAAQ,OAAO,OAAO,OACtB,CAAC,WAAW,KAAK,CAAC,CAAuB,EAAE,WAAW,QAAQ,MAAM,CAAC,CAAC,IACtE,CAAC;CACL,GAAI,QAAQ,OAAO,QACf,CAAC,YAAY,KAAK,CAAC,CAAuB,EAAE,WAAW,QAAQ,MAAM,CAAC,CAAC,IACvE,CAAC;AACP"}

package/dist/interaction/placing.d.ts

@@ -0,0 +1,86 @@
+import { Option, Schema } from "effect";
+import * as Mount from "foldkit/mount";
+import { Behavior } from "foldkit-mixins";
+export interface PanelRect {
+  readonly top: number;
+  readonly right: number;
+  readonly bottom: number;
+  readonly height: number;
+}
+export interface Viewport {
+  readonly width: number;
+  readonly height: number;
+}
+export 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. */
+export 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. */
+export declare const shiftIntoViewport: (rect: {
+  readonly top: number;
+  readonly bottom: number;
+}, viewportHeight: number, margin?: number) => number;
+/** Attribute `keepWithin` sets to `placedAbove` when the panel flips. */
+export declare const placedSide = "data-fk-placed";
+/** Value of `placedSide` while the panel stands above its anchor. */
+export declare const placedAbove = "above";
+export interface AnchorRect {
+  readonly left: number;
+  readonly top: number;
+  readonly bottom: number;
+  readonly width: number;
+  readonly height: number;
+}
+export interface OriginRect {
+  readonly left: number;
+  readonly top: number;
+}
+export 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. */
+export 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. */
+export declare const placeAt: (trigger: AnchorRect, origin: OriginRect, gap?: number) => PlacedAt;
+export 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. */
+export declare const placeAtPoint: (point: ViewportPoint, origin: OriginRect) => PlacedAt;
+export declare const KeepWithin: Mount.MountDefinitionNoArgs<"KeepWithin", never>;
+export 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>;
+export 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>;
+export 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>;
+export declare const keepWithin: <Slots>(slots: Slots) => <Input, ParentMessage>(options: {
+  readonly panel: keyof Slots & string;
+}) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+//# sourceMappingURL=placing.d.ts.map

package/dist/interaction/placing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placing.d.ts","names":[],"sources":["../../src/interaction/placing.ts"],"mappings":";;;iBAuCiB;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM;;WAEN;;WAEA;;;;qBAKE,WAAQ,MAAU,WAAS,UAAY,UAAQ,oBAAe;;;qBAU9D,oBAAiB;WACX;WAAsB;GAAgB,wBACjC;;qBAWX;;qBAGA;iBAEI;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;;;;qBAKE;;;qBAIA,UAAO,SAAa,YAAU,QAAU,YAAU,iBAAY;iBAQ1D;WACN;WACA;;;;;qBAME,eAAY,OAAW,eAAa,QAAU,eAAa;qBAyE3D,YAAU,MAAA;qBAkCV,SAAO,MAAA;;;;;;qBAyCP,cAAY,MAAA;;;;;;qBA0BZ,iBACV,OAAK,OAAS,WACd,OAAO,eAAa;WACV,aAAa;;WAEb,YAAY,OAAO;WACnB;;WAEA,MAAM,OAAO,UAAU,OAAO,OAAO;MAC5C,SAAS,cAAc,OAAO,OAAO;qBAiB9B,aACV,OAAK,OAAS,WACd,OAAO,eAAa;WACV,aAAa;MACpB,SAAS,cAAc,OAAO,OAAO"}

package/dist/interaction/placing.js

@@ -0,0 +1,239 @@
+import { Effect, Option, Schema, Stream } from "effect";
+import * as Mount from "foldkit/mount";
+import { Behavior, Capability } from "foldkit-mixins";
+// 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.
+*/
+/** 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" });
+export { KeepWithin, PlaceAt, PlaceAtPoint, keepWithin, placeAt, placeAtPoint, placeAtTrigger, placeFor, placedAbove, placedSide, placedTop, shiftIntoViewport };
+
+//# sourceMappingURL=placing.js.map

package/dist/interaction/placing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placing.js","names":[],"sources":["../../src/interaction/placing.ts"],"sourcesContent":["/**\n * Keeps a floating panel inside the viewport: on insert it shifts left past\n * the right edge and flips above its trigger when the bottom overflows and\n * the room overhead fits; on release every inline prop goes. `placeFor` is\n * pure geometry over rects, so the rule is unit-tested and the Mount only\n * reads and writes. Inert without layout (zero rects never overflow), with\n * no timers, observers, or reposition loops.\n *\n * `placeAt` is the other half, for a popup that must open under the trigger\n * that opened it. It writes `left` and `--fk-placed-top` once, relative to\n * the popup's offset parent; the panel's stylesheet reads the variable as\n * `top`, so `keepWithin` can still replace `top` when it flips. Key the\n * popup by the trigger: a Mount reads its args at insert and never again.\n * `placeAtPoint` is the same write for a viewport point, when the open\n * event carried coordinates the message builder dropped. The two mounts\n * start together, so the fit may run before that write; the write measures\n * again. A point that would hang past the bottom shifts up. A trigger still\n * flips, and the panel is marked `data-fk-placed=\"above\"` so a hover bridge\n * can follow the side that opened.\n * Zero-size rects stay at the origin, so an inert document writes nothing\n * a layout pass would have to undo.\n *\n * Three related pieces this is not:\n *\n * - `Anchor.behavior` (`foldkit-mixins-ui`) binds a floating element to\n *   another element's id through floating-ui, with portals and continuous\n *   repositioning. It relocates nodes out from under the runtime (portal by\n *   default) and burns under zero geometry; reach for it when the panel must\n *   track a moving anchor, not for a popup placed once.\n * - `KeepInView` (`foldkit-primitives/dom`) scrolls newly marked content\n *   into view. Same verb, opposite direction: that one moves the page to\n *   the panel, this one moves the panel into the page.\n * - `Overlay.behaviors` owns dismissal, focus, scroll lock, and inertness,\n *   but no positioning; spread this alongside it for the full overlay.\n */\nimport { Effect, Option, Schema, Stream } from 'effect'\nimport * as Mount from 'foldkit/mount'\nimport { Behavior, Capability } from 'foldkit-mixins'\n\nexport interface PanelRect {\n  readonly top: number\n  readonly right: number\n  readonly bottom: number\n  readonly height: number\n}\n\nexport interface Viewport {\n  readonly width: number\n  readonly height: number\n}\n\nexport interface Placed {\n  /** Pixels to move left; `0` when the panel fits. */\n  readonly dx: number\n  /** Whether the panel stands above its trigger instead of below. */\n  readonly flip: boolean\n}\n\n/** Where the panel goes so it fits: left by the overflow, above when the\n *  bottom clears the window and the room overhead fits the panel. */\nexport const placeFor = (rect: PanelRect, viewport: Viewport, margin = 8): Placed => {\n  const over = rect.right - viewport.width + margin\n  return {\n    dx: over > 0 ? -over : 0,\n    flip: rect.bottom > viewport.height && rect.top - margin >= rect.height,\n  }\n}\n\n/** Pixels to move a box up so its bottom sits `margin` inside the viewport.\n *  `0` when it already fits, or when its top is already at the margin. */\nexport const shiftIntoViewport = (\n  rect: { readonly top: number; readonly bottom: number },\n  viewportHeight: number,\n  margin = 8,\n): number => {\n  const overflow = rect.bottom - (viewportHeight - margin)\n  if (overflow <= 0) return 0\n  const room = rect.top - margin\n  if (room <= 0) return 0\n  return Math.min(overflow, room)\n}\n\n/** Attribute `keepWithin` sets to `placedAbove` when the panel flips. */\nexport const placedSide = 'data-fk-placed'\n\n/** Value of `placedSide` while the panel stands above its anchor. */\nexport const placedAbove = 'above'\n\nexport interface AnchorRect {\n  readonly left: number\n  readonly top: number\n  readonly bottom: number\n  readonly width: number\n  readonly height: number\n}\n\nexport interface OriginRect {\n  readonly left: number\n  readonly top: number\n}\n\nexport interface PlacedAt {\n  readonly left: number\n  readonly top: number\n}\n\n/** Custom property `PlaceAt` writes. A panel reads it as `top` so a viewport\n *  flip, which sets the `top` property, still wins. */\nexport const placedTop = '--fk-placed-top'\n\n/** Where a popup sits under its trigger's left edge, in the offset parent's\n *  coordinates. A zero-size trigger (an inert document) stays at the origin. */\nexport const placeAt = (trigger: AnchorRect, origin: OriginRect, gap = 4): PlacedAt => {\n  if (trigger.width === 0 && trigger.height === 0) return { left: 0, top: 0 }\n  return {\n    left: trigger.left - origin.left,\n    top: trigger.bottom - origin.top + gap,\n  }\n}\n\nexport interface ViewportPoint {\n  readonly x: number\n  readonly y: number\n}\n\n/** Where a popup's top-left sits on a viewport point, in the offset parent's\n *  coordinates. A context menu uses it: the right-click event carries the\n *  point, and `OnContextMenu` does not. */\nexport const placeAtPoint = (point: ViewportPoint, origin: OriginRect): PlacedAt => ({\n  left: point.x - origin.left,\n  top: point.y - origin.top,\n})\n\nconst clearFit = (element: HTMLElement): void => {\n  element.style.translate = ''\n  element.style.top = ''\n  element.style.bottom = ''\n  element.removeAttribute(placedSide)\n}\n\nconst fitWithin = (element: HTMLElement): void => {\n  // A previous fit may have flipped. Clear it before reading, or the next\n  // decision would describe the flipped box.\n  clearFit(element)\n  const rect = element.getBoundingClientRect()\n  const placed = placeFor(\n    { top: rect.top, right: rect.right, bottom: rect.bottom, height: rect.height },\n    { width: document.documentElement.clientWidth, height: window.innerHeight },\n  )\n  if (placed.dx !== 0) element.style.translate = `${placed.dx}px 0`\n  if (placed.flip) {\n    element.style.top = 'auto'\n    element.style.bottom = 'calc(100% + 4px)'\n    element.setAttribute(placedSide, placedAbove)\n  }\n}\n\n// PlaceAt and KeepWithin start together (`Stream.mergeAll`), so the fit can\n// run before the placement write. The write calls whoever is waiting.\nconst refits = new WeakMap<HTMLElement, Set<() => void>>()\n\nconst onPlaced = (element: HTMLElement, refit: () => void): void => {\n  const waiting = refits.get(element) ?? new Set()\n  waiting.add(refit)\n  refits.set(element, waiting)\n}\n\nconst offPlaced = (element: HTMLElement, refit: () => void): void => {\n  const waiting = refits.get(element)\n  if (waiting === undefined) return\n  waiting.delete(refit)\n  if (waiting.size === 0) refits.delete(element)\n}\n\nconst notifyPlaced = (element: HTMLElement): void => {\n  const waiting = refits.get(element)\n  if (waiting === undefined) return\n  for (const refit of waiting) refit()\n}\n\nconst applyPlaced = (element: HTMLElement, placed: PlacedAt): void => {\n  element.style.left = `${placed.left}px`\n  element.style.setProperty(placedTop, `${placed.top}px`)\n}\n\nconst clearPlaced = (element: HTMLElement): void => {\n  element.style.left = ''\n  element.style.removeProperty(placedTop)\n}\n\nconst writePlaced = (element: HTMLElement, placed: PlacedAt, shift: boolean): void => {\n  clearFit(element)\n  applyPlaced(element, placed)\n  if (shift) {\n    const rect = element.getBoundingClientRect()\n    const dy = shiftIntoViewport({ top: rect.top, bottom: rect.bottom }, window.innerHeight)\n    if (dy !== 0) element.style.setProperty(placedTop, `${placed.top - dy}px`)\n  }\n  notifyPlaced(element)\n}\n\nexport const KeepWithin = Mount.defineStream('KeepWithin', {\n  messages: [Schema.Never],\n  execute: ({ element }) =>\n    Stream.callback<never>(() => {\n      if (!(element instanceof HTMLElement)) {\n        return Effect.acquireRelease(Effect.void, () => Effect.void)\n      }\n      const node = element\n      const refit = (): void => fitWithin(node)\n      return Effect.acquireRelease(\n        Effect.sync(() => {\n          onPlaced(node, refit)\n          refit()\n        }),\n        () =>\n          Effect.sync(() => {\n            offPlaced(node, refit)\n            clearFit(node)\n          }),\n      )\n    }),\n})\n\nconst paddingEdge = (node: HTMLElement): OriginRect => {\n  const rect = node.getBoundingClientRect()\n  // Absolute `left`/`top` start at the padding edge; the rect is the border box.\n  return { left: rect.left + node.clientLeft, top: rect.top + node.clientTop }\n}\n\nconst originOf = (element: HTMLElement): OriginRect => {\n  const originNode = element.offsetParent\n  return originNode instanceof HTMLElement ? paddingEdge(originNode) : { left: 0, top: 0 }\n}\n\nexport const PlaceAt = Mount.defineStream('PlaceAt', {\n  messages: [Schema.Never],\n  args: {\n    /** Element id of the trigger the popup opens under. */\n    triggerId: Schema.String,\n    /** Pixels between the trigger's bottom and the popup. */\n    gap: Schema.Number,\n  },\n  execute: ({ element, triggerId, gap }) =>\n    Stream.callback<never>(() =>\n      Effect.acquireRelease(\n        Effect.sync(() => {\n          if (!(element instanceof HTMLElement)) return\n          const trigger = document.getElementById(triggerId)\n          if (!(trigger instanceof HTMLElement)) return\n          const rect = trigger.getBoundingClientRect()\n          writePlaced(\n            element,\n            placeAt(\n              {\n                left: rect.left,\n                top: rect.top,\n                bottom: rect.bottom,\n                width: rect.width,\n                height: rect.height,\n              },\n              originOf(element),\n              gap,\n            ),\n            false,\n          )\n        }),\n        () =>\n          Effect.sync(() => {\n            if (!(element instanceof HTMLElement)) return\n            clearPlaced(element)\n          }),\n      ),\n    ),\n})\n\nexport const PlaceAtPoint = Mount.defineStream('PlaceAtPoint', {\n  messages: [Schema.Never],\n  args: {\n    /** Viewport x of the popup's top-left. */\n    x: Schema.Number,\n    /** Viewport y of the popup's top-left. */\n    y: Schema.Number,\n  },\n  execute: ({ element, x, y }) =>\n    Stream.callback<never>(() =>\n      Effect.acquireRelease(\n        Effect.sync(() => {\n          if (!(element instanceof HTMLElement)) return\n          // The offset parent is not the point. Shifting keeps the menu beside\n          // it; flipping would send the menu above that parent.\n          writePlaced(element, placeAtPoint({ x, y }, originOf(element)), true)\n        }),\n        () =>\n          Effect.sync(() => {\n            if (!(element instanceof HTMLElement)) return\n            clearPlaced(element)\n          }),\n      ),\n    ),\n})\n\nexport const placeAtTrigger =\n  <Slots>(slots: Slots) =>\n  <Input, ParentMessage>(options: {\n    readonly panel: keyof Slots & string\n    /** The trigger this open belongs to. Read at insert, so key the panel by it. */\n    readonly triggerId: (input: Input) => string\n    readonly gap?: number\n    /** A viewport point wins over the trigger. None places under `triggerId`. */\n    readonly at?: (input: Input) => Option.Option<ViewportPoint>\n  }): Behavior.NamedBehavior<Slots, Input, ParentMessage> =>\n    Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.panel]: Behavior.slot({\n          requires: { capability: Capability.Container },\n          mount: input => {\n            const at = options.at?.(input) ?? Option.none()\n            return Option.isSome(at)\n              ? PlaceAtPoint({ x: at.value.x, y: at.value.y })\n              : PlaceAt({ triggerId: options.triggerId(input), gap: options.gap ?? 4 })\n          },\n        }),\n        // Keyed by a value the caller chose; `forSlots` checks the key exists.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'PlaceAt' },\n    )\n\nexport const keepWithin =\n  <Slots>(slots: Slots) =>\n  <Input, ParentMessage>(options: {\n    readonly panel: keyof Slots & string\n  }): Behavior.NamedBehavior<Slots, Input, ParentMessage> =>\n    Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.panel]: Behavior.slot({\n          requires: { capability: Capability.Container },\n          mount: () => KeepWithin(),\n        }),\n        // Keyed by a value the caller chose; `forSlots` checks the key exists.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'KeepWithin' },\n    )\n"],"mappings":"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"}

package/dist/interaction/pointer-drag.d.ts

@@ -0,0 +1,23 @@
+import { DRAG_THRESHOLD, DragCancelled, DragDropped, DragFact, DragFact as DragFact$1, DragPlace, DragStarted, DragZone, DraggedOver, PointerDrag as mount, boxOf, zoneOf } from "../dom/pointer-drag.js";
+import { Behavior } from "foldkit-mixins";
+export interface BehaviorOptions<Slots, ParentMessage> {
+  /** The slot holding the marked descendants. */
+  readonly container: keyof Slots & string;
+  /** The attribute that marks a descendant, holding its id. */
+  readonly attribute: string;
+  /**
+   * Where a drag may land when not among the container's own: elements marked
+   * by `attribute` inside the one `within` selects, such as a page for a palette.
+   */
+  readonly targets?: {
+    readonly attribute: string;
+    readonly within: string;
+  };
+  /** An attribute naming a part of what a drop lands on, which the place then carries. */
+  readonly part?: string;
+  /** Turns each fact into the view's Message. */
+  readonly toMessage: (fact: DragFact$1) => ParentMessage;
+}
+export declare const behavior: <Slots>(slots: Slots) => <Input, ParentMessage>(options: BehaviorOptions<Slots, ParentMessage>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+export { DRAG_THRESHOLD, DragCancelled, DragDropped, type DragFact, DragPlace, DragStarted, DragZone, DraggedOver, boxOf, mount, zoneOf };
+//# sourceMappingURL=pointer-drag.d.ts.map

package/dist/interaction/pointer-drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-drag.d.ts","names":["DragFact"],"sources":["../../src/interaction/pointer-drag.ts"],"mappings":";;iBAwBiB,gBAAgB,OAAO;;WAE7B,iBAAiB;;WAEjB;;;;;WAKA;aAAqB;aAA4B;;;WAEjD;;WAEA,YAAY,MAAMA,eAAa;;qBAG7B,WACV,OAAK,OAAS,WACd,OAAO,eAAa,SACV,gBAAgB,OAAO,mBAC/B,SAAS,cAAc,OAAO,OAAO"}

package/dist/interaction/pointer-drag.js

@@ -0,0 +1,21 @@
+import * as Mount from "foldkit/mount";
+import { DRAG_THRESHOLD, DragCancelled, DragDropped, DragPlace, DragStarted, DragZone, DraggedOver, PointerDrag, PointerDrag as mount, boxOf, zoneOf } from "../dom/pointer-drag.js";
+import { Behavior, Capability } from "foldkit-mixins";
+// src/interaction/pointer-drag.ts
+/**
+* `PointerDrag` as a Behavior: attaches the `foldkit-primitives/dom` Mount to
+* a container slot and maps what it reports into the view's Messages. No
+* Bundle: what is dragged and where the pointer is are facts, and what a drop
+* means, and whether it is allowed, is the parent's `update`.
+*/
+const behavior = (slots) => (options) => Behavior.forSlots(slots)({ [options.container]: Behavior.slot({
+	requires: { capability: Capability.Container },
+	mount: () => Mount.mapMessage(PointerDrag({
+		attribute: options.attribute,
+		...options.targets === void 0 ? {} : { targets: options.targets },
+		...options.part === void 0 ? {} : { part: options.part }
+	}), options.toMessage)
+}) }, { name: "PointerDrag" });
+export { DRAG_THRESHOLD, DragCancelled, DragDropped, DragPlace, DragStarted, DragZone, DraggedOver, behavior, boxOf, mount, zoneOf };
+
+//# sourceMappingURL=pointer-drag.js.map

package/dist/interaction/pointer-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-drag.js","names":["PointerDragMount"],"sources":["../../src/interaction/pointer-drag.ts"],"sourcesContent":["/**\n * `PointerDrag` as a Behavior: attaches the `foldkit-primitives/dom` Mount to\n * a container slot and maps what it reports into the view's Messages. No\n * Bundle: what is dragged and where the pointer is are facts, and what a drop\n * means, and whether it is allowed, is the parent's `update`.\n */\nimport * as Mount from 'foldkit/mount'\nimport { Behavior, Capability } from 'foldkit-mixins'\nimport { PointerDrag as PointerDragMount, type DragFact } from '../dom/pointer-drag.js'\n\nexport {\n  DRAG_THRESHOLD,\n  DragCancelled,\n  DragDropped,\n  DragPlace,\n  DragStarted,\n  DragZone,\n  DraggedOver,\n  PointerDrag as mount,\n  boxOf,\n  zoneOf,\n  type DragFact,\n} from '../dom/pointer-drag.js'\n\nexport interface BehaviorOptions<Slots, ParentMessage> {\n  /** The slot holding the marked descendants. */\n  readonly container: keyof Slots & string\n  /** The attribute that marks a descendant, holding its id. */\n  readonly attribute: string\n  /**\n   * Where a drag may land when not among the container's own: elements marked\n   * by `attribute` inside the one `within` selects, such as a page for a palette.\n   */\n  readonly targets?: { readonly attribute: string; readonly within: string }\n  /** An attribute naming a part of what a drop lands on, which the place then carries. */\n  readonly part?: string\n  /** Turns each fact into the view's Message. */\n  readonly toMessage: (fact: DragFact) => ParentMessage\n}\n\nexport const behavior =\n  <Slots>(slots: Slots) =>\n  <Input, ParentMessage>(\n    options: BehaviorOptions<Slots, ParentMessage>,\n  ): Behavior.NamedBehavior<Slots, Input, ParentMessage> =>\n    Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.container]: Behavior.slot({\n          requires: { capability: Capability.Container },\n          mount: () =>\n            Mount.mapMessage(\n              PointerDragMount({\n                attribute: options.attribute,\n                ...(options.targets === undefined ? {} : { targets: options.targets }),\n                ...(options.part === undefined ? {} : { part: options.part }),\n              }),\n              options.toMessage,\n            ),\n        }),\n        // Keyed by a value the caller chose; `forSlots` checks the key exists.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'PointerDrag' },\n    )\n"],"mappings":";;;;;;;;;;AAwCA,MAAa,YACH,WAEN,YAEA,SAAS,SAAS,KAAK,CAAC,CACtB,GACG,QAAQ,YAAY,SAAS,KAAK;CACjC,UAAU,EAAE,YAAY,WAAW,UAAU;CAC7C,aACE,MAAM,WACJA,YAAiB;EACf,WAAW,QAAQ;EACnB,GAAI,QAAQ,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,QAAQ,QAAQ;EACpE,GAAI,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;CAC7D,CAAC,GACD,QAAQ,SACV;AACJ,CAAC,EAEH,GACA,EAAE,MAAM,cAAc,CACxB"}