elements-kit 0.27.8 → 0.27.9

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

@@ -144,6 +144,23 @@ type Inset = PhysicalInset | "inset-block-start" | "inset-block-end" | "inset-in
  * box's reactive geometry, so calling it inside an `effect` tracks the anchor.
  */
 declare function anchor_length(box: Box & Partial<IDirection>, inset: Inset, side: BlockSide | InlineSide | number): number;
+/** Keywords naming the block axis. */
+type BlockKeyword = "top" | "bottom" | "span-top" | "span-bottom" | "block-start" | "block-end" | "span-block-start" | "span-block-end" | "y-start" | "y-end" | "span-y-start" | "span-y-end";
+/** Keywords naming the inline axis. */
+type InlineKeyword = "left" | "right" | "span-left" | "span-right" | "inline-start" | "inline-end" | "span-inline-start" | "span-inline-end" | "x-start" | "x-end" | "span-x-start" | "span-x-end";
+/** Keywords naming no axis — each takes whichever one is still free. */
+type AmbiguousKeyword = "center" | "span-all" | "start" | "end" | "span-start" | "span-end" | "self-start" | "self-end" | "span-self-start" | "span-self-end";
+type AreaKeyword = BlockKeyword | InlineKeyword | AmbiguousKeyword;
+/** Two keywords, in either order — `position-area` is unordered. */
+type Unordered<A extends string, B extends string> = `${A} ${B}` | `${B} ${A}`;
+/**
+ * A valid `position-area` value: one keyword, or two naming different axes.
+ * Two of the same explicit axis (`top bottom`, `left right`) is not a value —
+ * {@link resolveArea} resolves anything invalid to the `block-end` fallback,
+ * so catching it here is the difference between a compile error and a menu
+ * that quietly opens on the wrong side.
+ */
+type PositionAreaValue = AreaKeyword | Unordered<BlockKeyword, InlineKeyword> | Unordered<BlockKeyword, AmbiguousKeyword> | Unordered<InlineKeyword, AmbiguousKeyword> | `${AmbiguousKeyword} ${AmbiguousKeyword}`;
 /**
  * The reactive `position-area` property: the region of the viewport an
  * overlay anchored to `anchor` may occupy, with the region's default
@@ -167,7 +184,7 @@ declare function anchor_length(box: Box & Partial<IDirection>, inset: Inset, sid
 declare class PositionArea implements Region, ReadonlyBox {
   #private;
   readonly anchor: ReadonlyBox;
-  constructor(anchor: ReadonlyBox, area: string);
+  constructor(anchor: ReadonlyBox, area: PositionAreaValue);
   get x(): number;
   get y(): number;
   get w(): number;
@@ -266,4 +283,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, type Placement, PositionArea, type ReadonlyBox, type Region, WINDOW_BOX, WindowBox, anchor_length };
+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 PositionAreaValue, type ReadonlyBox, type Region, WINDOW_BOX, WindowBox, anchor_length };

package/dist/ui/overlay/index.mjs

@@ -181,7 +181,8 @@ const A = (region, self = false) => ({
 	physical: false,
 	self
 });
-/** The full `position-area` keyword grammar → axis + physical region. */
+/** The full `position-area` keyword grammar → axis + physical region. The
+* key type forces this table and {@link PositionAreaValue} to stay in step. */
 const KEYWORDS = {
 	top: B("start", true),
 	bottom: B("end", true),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elements-kit",
   "type": "module",
-  "version": "0.27.8",
+  "version": "0.27.9",
   "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",