@slowclap/rezi-core 0.1.0-fork.1

package/dist/layout/positioning.d.ts

@@ -0,0 +1,124 @@
+/**
+ * packages/core/src/layout/positioning.ts — Anchor-relative positioning for overlays.
+ *
+ * Why: Computes positions for dropdowns, tooltips, and other anchor-relative
+ * elements. Handles edge flipping when content would overflow screen boundaries.
+ *
+ * Positioning concepts:
+ *   - Anchor: The element to position relative to
+ *   - Position: Where to place the overlay (below-start, above-end, etc.)
+ *   - Flip: Automatically switch sides when near screen edge
+ *   - Constraint: Keep overlay within viewport bounds
+ *
+ * @see docs/guide/layout.md (GitHub issue #117)
+ */
+import type { DropdownPosition } from "../widgets/types.js";
+import type { Rect, Size } from "./types.js";
+/**
+ * Viewport constraints for positioning calculations.
+ */
+export type Viewport = Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+/**
+ * Result of position calculation.
+ */
+export type PositionResult = Readonly<{
+    /** Computed position for the overlay. */
+    rect: Rect;
+    /** The actual position used (may differ from requested if flipped). */
+    position: DropdownPosition;
+    /** Whether the position was flipped horizontally. */
+    flippedHorizontal: boolean;
+    /** Whether the position was flipped vertically. */
+    flippedVertical: boolean;
+}>;
+/**
+ * Options for position calculation.
+ */
+export type PositionOptions = Readonly<{
+    /** Anchor element rect. */
+    anchor: Rect;
+    /** Size of the overlay element. */
+    overlaySize: Size;
+    /** Desired position relative to anchor. */
+    position: DropdownPosition;
+    /** Viewport constraints. */
+    viewport: Viewport;
+    /** Gap between anchor and overlay (default: 0). */
+    gap?: number;
+    /** Whether to flip if near edge (default: true). */
+    flip?: boolean;
+}>;
+/**
+ * Calculate anchor-relative position for an overlay element.
+ * Handles automatic flipping when the overlay would overflow the viewport.
+ *
+ * @param options - Position calculation options
+ * @returns Computed position result
+ *
+ * @example
+ * ```ts
+ * const result = calculateAnchorPosition({
+ *   anchor: { x: 10, y: 5, w: 20, h: 1 },
+ *   overlaySize: { w: 30, h: 10 },
+ *   position: "below-start",
+ *   viewport: { x: 0, y: 0, width: 80, height: 24 },
+ * });
+ * // result.rect = { x: 10, y: 6, w: 30, h: 10 }
+ * ```
+ */
+export declare function calculateAnchorPosition(options: PositionOptions): PositionResult;
+/**
+ * Options for modal centering.
+ */
+export type CenterOptions = Readonly<{
+    /** Size of the modal. */
+    modalSize: Size;
+    /** Viewport to center within. */
+    viewport: Viewport;
+}>;
+/**
+ * Calculate centered position for a modal.
+ *
+ * @param options - Centering options
+ * @returns Rect for the centered modal
+ */
+export declare function calculateCenteredPosition(options: CenterOptions): Rect;
+/**
+ * Anchor rect lookup function type.
+ * Used to find the position of an anchor element by ID.
+ */
+export type AnchorLookup = (anchorId: string) => Rect | null;
+/**
+ * Create an anchor lookup from a layout rect map.
+ *
+ * @param layoutRects - Map of widget ID to rect
+ * @returns Anchor lookup function
+ */
+export declare function createAnchorLookup(layoutRects: ReadonlyMap<string, Rect>): AnchorLookup;
+/**
+ * Options for modal size calculation.
+ */
+export type ModalSizeOptions = Readonly<{
+    /** Content size without padding/border. */
+    contentSize: Size;
+    /** Whether modal has a title bar. */
+    hasTitle: boolean;
+    /** Whether modal has action buttons. */
+    hasActions: boolean;
+    /** Explicit width override ("auto" uses content width). */
+    width?: number | "auto";
+    /** Maximum width constraint. */
+    maxWidth?: number;
+    /** Viewport width for percentage-based sizing. */
+    viewportWidth: number;
+}>;
+/**
+ * Calculate modal size including chrome (border, title, actions).
+ */
+export declare function calculateModalSize(options: ModalSizeOptions): Size;
+//# sourceMappingURL=positioning.d.ts.map

package/dist/layout/positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning.d.ts","sourceRoot":"","sources":["../../src/layout/positioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAI7C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,yCAAyC;IACzC,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,qDAAqD;IACrD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,2BAA2B;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,IAAI,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAuGH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAsEhF;AAID;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAatE;AAID;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,YAAY,CAIvF;AAID;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,2CAA2C;IAC3C,WAAW,EAAE,IAAI,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAqClE"}

package/dist/layout/positioning.js

@@ -0,0 +1,234 @@
+/**
+ * packages/core/src/layout/positioning.ts — Anchor-relative positioning for overlays.
+ *
+ * Why: Computes positions for dropdowns, tooltips, and other anchor-relative
+ * elements. Handles edge flipping when content would overflow screen boundaries.
+ *
+ * Positioning concepts:
+ *   - Anchor: The element to position relative to
+ *   - Position: Where to place the overlay (below-start, above-end, etc.)
+ *   - Flip: Automatically switch sides when near screen edge
+ *   - Constraint: Keep overlay within viewport bounds
+ *
+ * @see docs/guide/layout.md (GitHub issue #117)
+ */
+/**
+ * Parse position into vertical and horizontal components.
+ */
+function parsePosition(position) {
+    const parts = position.split("-");
+    return {
+        vertical: parts[0] === "above" ? "above" : "below",
+        horizontal: parts[1] ?? "start",
+    };
+}
+/**
+ * Build position string from components.
+ */
+function buildPosition(vertical, horizontal) {
+    return `${vertical}-${horizontal}`;
+}
+/**
+ * Calculate X position for horizontal alignment.
+ */
+function calculateX(anchor, overlayWidth, horizontal) {
+    switch (horizontal) {
+        case "start":
+            return anchor.x;
+        case "center":
+            return anchor.x + Math.floor((anchor.w - overlayWidth) / 2);
+        case "end":
+            return anchor.x + anchor.w - overlayWidth;
+    }
+}
+/**
+ * Calculate Y position for vertical alignment.
+ */
+function calculateY(anchor, overlayHeight, vertical, gap) {
+    switch (vertical) {
+        case "above":
+            return anchor.y - overlayHeight - gap;
+        case "below":
+            return anchor.y + anchor.h + gap;
+    }
+}
+/**
+ * Check if overlay would overflow viewport on the right.
+ */
+function overflowsRight(x, width, viewport) {
+    return x + width > viewport.x + viewport.width;
+}
+/**
+ * Check if overlay would overflow viewport on the left.
+ */
+function overflowsLeft(x, viewport) {
+    return x < viewport.x;
+}
+/**
+ * Check if overlay would overflow viewport on the bottom.
+ */
+function overflowsBottom(y, height, viewport) {
+    return y + height > viewport.y + viewport.height;
+}
+/**
+ * Check if overlay would overflow viewport on the top.
+ */
+function overflowsTop(y, viewport) {
+    return y < viewport.y;
+}
+/**
+ * Clamp a value to be within viewport bounds.
+ */
+function clampToViewport(value, size, viewportStart, viewportSize) {
+    const max = viewportStart + viewportSize - size;
+    const min = viewportStart;
+    return Math.max(min, Math.min(max, value));
+}
+/**
+ * Calculate anchor-relative position for an overlay element.
+ * Handles automatic flipping when the overlay would overflow the viewport.
+ *
+ * @param options - Position calculation options
+ * @returns Computed position result
+ *
+ * @example
+ * ```ts
+ * const result = calculateAnchorPosition({
+ *   anchor: { x: 10, y: 5, w: 20, h: 1 },
+ *   overlaySize: { w: 30, h: 10 },
+ *   position: "below-start",
+ *   viewport: { x: 0, y: 0, width: 80, height: 24 },
+ * });
+ * // result.rect = { x: 10, y: 6, w: 30, h: 10 }
+ * ```
+ */
+export function calculateAnchorPosition(options) {
+    const { anchor, overlaySize, position, viewport, gap = 0, flip = true } = options;
+    let { vertical, horizontal } = parsePosition(position);
+    let flippedHorizontal = false;
+    let flippedVertical = false;
+    // Calculate initial position
+    let x = calculateX(anchor, overlaySize.w, horizontal);
+    let y = calculateY(anchor, overlaySize.h, vertical, gap);
+    // Check for vertical overflow and flip if needed
+    if (flip) {
+        if (vertical === "below" && overflowsBottom(y, overlaySize.h, viewport)) {
+            // Try flipping to above
+            const aboveY = calculateY(anchor, overlaySize.h, "above", gap);
+            if (!overflowsTop(aboveY, viewport)) {
+                y = aboveY;
+                vertical = "above";
+                flippedVertical = true;
+            }
+        }
+        else if (vertical === "above" && overflowsTop(y, viewport)) {
+            // Try flipping to below
+            const belowY = calculateY(anchor, overlaySize.h, "below", gap);
+            if (!overflowsBottom(belowY, overlaySize.h, viewport)) {
+                y = belowY;
+                vertical = "below";
+                flippedVertical = true;
+            }
+        }
+        // Check for horizontal overflow and flip if needed
+        if (horizontal === "start" && overflowsRight(x, overlaySize.w, viewport)) {
+            // Try flipping to end
+            const endX = calculateX(anchor, overlaySize.w, "end");
+            if (!overflowsLeft(endX, viewport)) {
+                x = endX;
+                horizontal = "end";
+                flippedHorizontal = true;
+            }
+        }
+        else if (horizontal === "end" && overflowsLeft(x, viewport)) {
+            // Try flipping to start
+            const startX = calculateX(anchor, overlaySize.w, "start");
+            if (!overflowsRight(startX, overlaySize.w, viewport)) {
+                x = startX;
+                horizontal = "start";
+                flippedHorizontal = true;
+            }
+        }
+    }
+    // Clamp size to viewport bounds if overlay is larger than viewport
+    const clampedW = Math.min(overlaySize.w, viewport.width);
+    const clampedH = Math.min(overlaySize.h, viewport.height);
+    // Clamp position to viewport bounds as final fallback
+    x = clampToViewport(x, clampedW, viewport.x, viewport.width);
+    y = clampToViewport(y, clampedH, viewport.y, viewport.height);
+    return Object.freeze({
+        rect: Object.freeze({
+            x,
+            y,
+            w: clampedW,
+            h: clampedH,
+        }),
+        position: buildPosition(vertical, horizontal),
+        flippedHorizontal,
+        flippedVertical,
+    });
+}
+/**
+ * Calculate centered position for a modal.
+ *
+ * @param options - Centering options
+ * @returns Rect for the centered modal
+ */
+export function calculateCenteredPosition(options) {
+    const { modalSize, viewport } = options;
+    const x = viewport.x + Math.floor((viewport.width - modalSize.w) / 2);
+    const y = viewport.y + Math.floor((viewport.height - modalSize.h) / 2);
+    // Ensure modal doesn't go negative
+    return Object.freeze({
+        x: Math.max(viewport.x, x),
+        y: Math.max(viewport.y, y),
+        w: Math.min(modalSize.w, viewport.width),
+        h: Math.min(modalSize.h, viewport.height),
+    });
+}
+/**
+ * Create an anchor lookup from a layout rect map.
+ *
+ * @param layoutRects - Map of widget ID to rect
+ * @returns Anchor lookup function
+ */
+export function createAnchorLookup(layoutRects) {
+    return (anchorId) => {
+        return layoutRects.get(anchorId) ?? null;
+    };
+}
+/**
+ * Calculate modal size including chrome (border, title, actions).
+ */
+export function calculateModalSize(options) {
+    const { contentSize, hasTitle, hasActions, width, maxWidth, viewportWidth } = options;
+    // Modal chrome: 1 cell border on each side
+    const borderWidth = 2;
+    const borderHeight = 2;
+    // Title bar: 1 cell if present
+    const titleHeight = hasTitle ? 1 : 0;
+    // Action bar: 1 cell if present (plus 1 for separator)
+    const actionsHeight = hasActions ? 2 : 0;
+    // Calculate content area
+    let modalWidth;
+    if (typeof width === "number") {
+        modalWidth = width;
+    }
+    else {
+        // Auto width: use content width + padding
+        modalWidth = contentSize.w + borderWidth + 2; // +2 for internal padding
+    }
+    // Apply max width constraint
+    if (maxWidth !== undefined) {
+        modalWidth = Math.min(modalWidth, maxWidth);
+    }
+    // Ensure fits in viewport (with some margin)
+    modalWidth = Math.min(modalWidth, viewportWidth - 4);
+    // Calculate total height
+    const modalHeight = contentSize.h + borderHeight + titleHeight + actionsHeight;
+    return Object.freeze({
+        w: Math.max(modalWidth, 10), // Minimum width
+        h: Math.max(modalHeight, 5), // Minimum height
+    });
+}
+//# sourceMappingURL=positioning.js.map

package/dist/layout/positioning.js.map

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

package/dist/layout/responsive.d.ts

@@ -0,0 +1,33 @@
+/**
+ * packages/core/src/layout/responsive.ts — Viewport breakpoint helpers.
+ */
+export type ViewportBreakpoint = "sm" | "md" | "lg" | "xl";
+export type FluidValue = Readonly<{
+    kind: "fluid";
+    min: number;
+    max: number;
+    from: ViewportBreakpoint;
+    to: ViewportBreakpoint;
+}>;
+export type FluidValueOptions = Readonly<{
+    from?: ViewportBreakpoint;
+    to?: ViewportBreakpoint;
+}>;
+export type ResponsiveValue<T> = T | Readonly<Partial<Record<ViewportBreakpoint, T>>> | FluidValue;
+export type ResponsiveBreakpointThresholds = Readonly<{
+    smMax: number;
+    mdMax: number;
+    lgMax: number;
+}>;
+export type ResponsiveViewportSnapshot = Readonly<{
+    width: number;
+    height: number;
+    breakpoint: ViewportBreakpoint;
+}>;
+export declare function fluid(min: number, max: number, options?: FluidValueOptions): FluidValue;
+export declare function normalizeBreakpointThresholds(value: Partial<ResponsiveBreakpointThresholds> | undefined): ResponsiveBreakpointThresholds;
+export declare function resolveViewportBreakpoint(width: number, thresholds: ResponsiveBreakpointThresholds): ViewportBreakpoint;
+export declare function setResponsiveViewport(width: number, height: number, thresholds?: ResponsiveBreakpointThresholds): void;
+export declare function getResponsiveViewport(): ResponsiveViewportSnapshot;
+export declare function resolveResponsiveValue(value: unknown): unknown;
+//# sourceMappingURL=responsive.d.ts.map

package/dist/layout/responsive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../../src/layout/responsive.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,EAAE,EAAE,kBAAkB,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,EAAE,CAAC,EAAE,kBAAkB,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;AAEnG,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,kBAAkB,CAAC;CAChC,CAAC,CAAC;AAuBH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAQ3F;AAQD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAAG,SAAS,GACzD,8BAA8B,CAUhC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,8BAA8B,GACzC,kBAAkB,CAMpB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,8BAAiD,GAC5D,IAAI,CAON;AAED,wBAAgB,qBAAqB,IAAI,0BAA0B,CAElE;AAmED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa9D"}

package/dist/layout/responsive.js

@@ -0,0 +1,145 @@
+/**
+ * packages/core/src/layout/responsive.ts — Viewport breakpoint helpers.
+ */
+const DEFAULT_THRESHOLDS = Object.freeze({
+    smMax: 79,
+    mdMax: 119,
+    lgMax: 159,
+});
+let activeThresholds = DEFAULT_THRESHOLDS;
+let activeViewport = Object.freeze({
+    width: 0,
+    height: 0,
+    breakpoint: "sm",
+});
+function isViewportBreakpoint(value) {
+    return value === "sm" || value === "md" || value === "lg" || value === "xl";
+}
+function normalizeFluidAnchor(value, fallback) {
+    return isViewportBreakpoint(value) ? value : fallback;
+}
+export function fluid(min, max, options = {}) {
+    return Object.freeze({
+        kind: "fluid",
+        min: Number.isFinite(min) ? min : 0,
+        max: Number.isFinite(max) ? max : 0,
+        from: normalizeFluidAnchor(options.from, "sm"),
+        to: normalizeFluidAnchor(options.to, "lg"),
+    });
+}
+function normalizeThreshold(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const n = Math.trunc(value);
+    return n <= 0 ? fallback : n;
+}
+export function normalizeBreakpointThresholds(value) {
+    const smMax = normalizeThreshold(value?.smMax, DEFAULT_THRESHOLDS.smMax);
+    const mdMax = normalizeThreshold(value?.mdMax, DEFAULT_THRESHOLDS.mdMax);
+    const lgMax = normalizeThreshold(value?.lgMax, DEFAULT_THRESHOLDS.lgMax);
+    const sorted = [smMax, mdMax, lgMax].sort((a, b) => a - b);
+    return Object.freeze({
+        smMax: sorted[0] ?? DEFAULT_THRESHOLDS.smMax,
+        mdMax: sorted[1] ?? DEFAULT_THRESHOLDS.mdMax,
+        lgMax: sorted[2] ?? DEFAULT_THRESHOLDS.lgMax,
+    });
+}
+export function resolveViewportBreakpoint(width, thresholds) {
+    const w = Number.isFinite(width) ? Math.max(0, Math.trunc(width)) : 0;
+    if (w <= thresholds.smMax)
+        return "sm";
+    if (w <= thresholds.mdMax)
+        return "md";
+    if (w <= thresholds.lgMax)
+        return "lg";
+    return "xl";
+}
+export function setResponsiveViewport(width, height, thresholds = activeThresholds) {
+    activeThresholds = thresholds;
+    activeViewport = Object.freeze({
+        width: Math.max(0, Math.trunc(width)),
+        height: Math.max(0, Math.trunc(height)),
+        breakpoint: resolveViewportBreakpoint(width, thresholds),
+    });
+}
+export function getResponsiveViewport() {
+    return activeViewport;
+}
+function isResponsiveMap(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const obj = value;
+    return "sm" in obj || "md" in obj || "lg" in obj || "xl" in obj;
+}
+function isFluidValue(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const obj = value;
+    return obj.kind === "fluid";
+}
+function breakpointAnchorWidth(breakpoint, thresholds) {
+    switch (breakpoint) {
+        case "sm":
+            return thresholds.smMax;
+        case "md":
+            return thresholds.mdMax;
+        case "lg":
+            return thresholds.lgMax;
+        case "xl":
+            return thresholds.lgMax + 1;
+        default:
+            return thresholds.lgMax;
+    }
+}
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    if (value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+}
+function resolveFluidValue(value) {
+    const min = Number.isFinite(value.min) ? value.min : 0;
+    const max = Number.isFinite(value.max) ? value.max : min;
+    const from = normalizeFluidAnchor(value.from, "sm");
+    const to = normalizeFluidAnchor(value.to, "lg");
+    const start = breakpointAnchorWidth(from, activeThresholds);
+    const end = breakpointAnchorWidth(to, activeThresholds);
+    if (start === end)
+        return Math.floor(max);
+    const t = clamp01((activeViewport.width - start) / (end - start));
+    return Math.floor(min + (max - min) * t);
+}
+function breakpointPriority(breakpoint) {
+    switch (breakpoint) {
+        case "sm":
+            return ["sm", "md", "lg", "xl"];
+        case "md":
+            return ["md", "sm", "lg", "xl"];
+        case "lg":
+            return ["lg", "md", "xl", "sm"];
+        case "xl":
+            return ["xl", "lg", "md", "sm"];
+        default:
+            return ["md", "sm", "lg", "xl"];
+    }
+}
+export function resolveResponsiveValue(value) {
+    if (isFluidValue(value)) {
+        return resolveFluidValue(value);
+    }
+    if (!isResponsiveMap(value))
+        return value;
+    const order = breakpointPriority(activeViewport.breakpoint);
+    for (const key of order) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            const selected = value[key];
+            if (selected !== undefined)
+                return resolveResponsiveValue(selected);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=responsive.js.map

package/dist/layout/responsive.js.map

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

package/dist/layout/spacing-scale.d.ts

@@ -0,0 +1,62 @@
+/**
+ * packages/core/src/layout/spacing-scale.ts — Named spacing scale.
+ *
+ * Why: Provides semantic spacing tokens for consistent layouts.
+ * Values are in terminal cell units (1 cell = 1 character width/height).
+ *
+ * Scale rationale:
+ *   - none: 0 - No spacing
+ *   - xs: 1 - Minimal spacing (tight)
+ *   - sm: 1 - Small spacing (compact elements)
+ *   - md: 2 - Medium spacing (default)
+ *   - lg: 3 - Large spacing (sections)
+ *   - xl: 4 - Extra large spacing (major sections)
+ *   - 2xl: 6 - Double extra large (page margins)
+ *
+ * @see docs/guide/layout.md
+ */
+import { type ResponsiveValue } from "./responsive.js";
+/**
+ * Named spacing scale keys.
+ */
+export type SpacingKey = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+/**
+ * Spacing scale values in terminal cell units.
+ * Optimized for terminal UIs where space is limited.
+ */
+export declare const SPACING_SCALE: Readonly<Record<SpacingKey, number>>;
+/**
+ * Type for spacing values - either a number or a scale key.
+ */
+type BaseSpacingValue = number | SpacingKey;
+export type SpacingValue = ResponsiveValue<BaseSpacingValue>;
+/**
+ * Check if a value is a valid spacing key.
+ */
+export declare function isSpacingKey(value: unknown): value is SpacingKey;
+/**
+ * Resolve a spacing value to a number.
+ * Accepts either a direct number or a scale key.
+ *
+ * @param value - Number or spacing key
+ * @returns Resolved spacing in cell units
+ *
+ * @example
+ * ```typescript
+ * resolveSpacingValue("md")  // 2
+ * resolveSpacingValue("lg")  // 3
+ * resolveSpacingValue(5)     // 5
+ * resolveSpacingValue("xs")  // 1
+ * ```
+ */
+export declare function resolveSpacingValue(value: SpacingValue | undefined): number;
+/**
+ * Resolve spacing with a default fallback.
+ *
+ * @param value - Spacing value or undefined
+ * @param fallback - Default value if undefined
+ * @returns Resolved spacing
+ */
+export declare function resolveSpacingWithDefault(value: SpacingValue | undefined, fallback: number): number;
+export {};
+//# sourceMappingURL=spacing-scale.d.ts.map

package/dist/layout/spacing-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing-scale.d.ts","sourceRoot":"","sources":["../../src/layout/spacing-scale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,eAAe,EAA0B,MAAM,iBAAiB,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAQ7D,CAAC;AAEH;;GAEG;AACH,KAAK,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAC5C,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAE7D;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAUhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAM3E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR"}