elements-kit 0.27.6 → 0.27.8

package/dist/ui/overlay/index.d.mts

@@ -78,12 +78,17 @@ type NoInline = {
  * both edges of one axis.
  */
 type Boundary = (BlockEdge & InlineEdge) | (BlockEdge & NoInline) | (NoBlock & InlineEdge);
+/** Where {@link Region.place} puts a box's top-left corner. */
+interface Placement {
+  readonly x: number;
+  readonly y: number;
+}
 /**
  * Somewhere a box may go: a semi-bounded plane, each axis pinned or free.
  * `place` is the only operation: it never writes, so the caller picks which
  * channels to take — `box.x = region.place(box).x` moves one axis and leaves
- * the rest. The box is placed as given: one larger than its room overflows
- * rather than shrinks, as CSS does.
+ * the rest. Size is never returned: the box is placed as given, so one larger
+ * than its room overflows rather than shrinks, as CSS does.
  *
  * The four insets read back as CSS would want them: the pinned edge's
  * coordinate, `null` for the other three (`auto`). A centred axis is not an
@@ -94,13 +99,8 @@ interface Region {
   readonly right: number | null;
   readonly top: number | null;
   readonly bottom: number | null;
-  place(box: ReadonlyBox): Box;
+  place(box: ReadonlyBox): Placement;
 }
-/** One axis of a {@link Region.place}: where a box `n` long, currently at
- * `own`, starts once `pin` is honoured. */
-declare function placeAxis(pin: Pin, own: number, n: number): number;
-/** The inset a pin yields on one edge: its coordinate if it pins that edge. */
-declare function inset(pin: Pin, edge: "start" | "end"): number | null;
 /**
  * A {@link Region} driven by writes — for gestures, where the box grows away
  * from the edge the user is not dragging. Assigning an inset pins that edge
@@ -117,7 +117,7 @@ declare class MutableRegion implements Region {
   set right(v: number | null);
   set top(v: number | null);
   set bottom(v: number | null);
-  place(box: ReadonlyBox): Box;
+  place(box: ReadonlyBox): Placement;
 }
 //#endregion
 //#region src/ui/overlay/anchor.d.ts
@@ -176,7 +176,8 @@ declare class PositionArea implements Region, ReadonlyBox {
   get right(): number | null;
   get top(): number | null;
   get bottom(): number | null;
-  place(box: ReadonlyBox): Box;
+  /** Every axis is pinned, so only the box's size is read. */
+  place(box: Pick<ReadonlyBox, "w" | "h">): Placement;
 }
 //#endregion
 //#region src/ui/overlay/overlay.d.ts
@@ -265,4 +266,4 @@ declare class Motion implements IMotion {
   abort(initial?: number): void;
 }
 //#endregion
-export { type Align, type Axis, type BlockSide, type Boundary, ElementBox, gestures_d_exports as Gestures, type IDirection, type IMotion, type InlineSide, type Inset, Motion, MutableRegion, OverlayBox, type PhysicalInset, type Pin, PositionArea, type ReadonlyBox, type Region, WINDOW_BOX, WindowBox, anchor_length, inset, placeAxis };
+export { type Align, type Axis, type BlockSide, type Boundary, ElementBox, gestures_d_exports as Gestures, type IDirection, type IMotion, type InlineSide, type Inset, Motion, MutableRegion, OverlayBox, type PhysicalInset, type Pin, type Placement, PositionArea, type ReadonlyBox, type Region, WINDOW_BOX, WindowBox, anchor_length };

package/dist/ui/overlay/index.mjs

@@ -6,14 +6,16 @@ import { direction } from "../../utilities/direction.mjs";
 import { createElementRect } from "../../utilities/element-rect.mjs";
 import { windowSize } from "../../utilities/window-size.mjs";
 //#region src/ui/overlay/area.ts
-/** One axis of a {@link Region.place}: where a box `n` long, currently at
-* `own`, starts once `pin` is honoured. */
-function placeAxis(pin, own, n) {
-	if (!pin) return own;
+/** Where a box `n` long starts on a pinned axis. */
+function placePinned(pin, n) {
 	if (pin.align === "start") return pin.at;
 	if (pin.align === "end") return pin.at - n;
 	return pin.at - n / 2;
 }
+/** One axis of a {@link Region.place}: pinned, or `own` if the axis is free. */
+function placeAxis(pin, own, n) {
+	return pin ? placePinned(pin, n) : own;
+}
 /** The inset a pin yields on one edge: its coordinate if it pins that edge. */
 function inset(pin, edge) {
 	return pin?.align === edge ? pin.at : null;
@@ -72,9 +74,7 @@ var MutableRegion = class {
 	place(box) {
 		return {
 			x: placeAxis(this.#x(), box.x, box.w),
-			y: placeAxis(this.#y(), box.y, box.h),
-			w: box.w,
-			h: box.h
+			y: placeAxis(this.#y(), box.y, box.h)
 		};
 	}
 };
@@ -364,12 +364,11 @@ var PositionArea = class {
 	get bottom() {
 		return inset(this.#py, "end");
 	}
+	/** Every axis is pinned, so only the box's size is read. */
 	place(box) {
 		return {
-			x: placeAxis(this.#px, box.x, box.w),
-			y: placeAxis(this.#py, box.y, box.h),
-			w: box.w,
-			h: box.h
+			x: placePinned(this.#px, box.w),
+			y: placePinned(this.#py, box.h)
 		};
 	}
 };
@@ -721,4 +720,4 @@ var Motion = class {
 	}
 };
 //#endregion
-export { ElementBox, gestures_exports as Gestures, Motion, MutableRegion, OverlayBox, PositionArea, WINDOW_BOX, WindowBox, anchor_length, inset, placeAxis };
+export { ElementBox, gestures_exports as Gestures, Motion, MutableRegion, OverlayBox, PositionArea, WINDOW_BOX, WindowBox, anchor_length };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elements-kit",
   "type": "module",
-  "version": "0.27.6",
+  "version": "0.27.8",
   "description": "A lightweight reactive UI library that transforms native HTMLElements into reactive components with signals. Ideal for framework-agnostic applications and web components.",
   "keywords": [
     "webcomponents",