@slowclap/rezi-core 0.1.0-fork.1

package/dist/layout/spacing-scale.js

@@ -0,0 +1,86 @@
+/**
+ * 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 { resolveResponsiveValue } from "./responsive.js";
+/**
+ * Spacing scale values in terminal cell units.
+ * Optimized for terminal UIs where space is limited.
+ */
+export const SPACING_SCALE = Object.freeze({
+    none: 0,
+    xs: 1,
+    sm: 1,
+    md: 2,
+    lg: 3,
+    xl: 4,
+    "2xl": 6,
+});
+/**
+ * Check if a value is a valid spacing key.
+ */
+export function isSpacingKey(value) {
+    return (value === "none" ||
+        value === "xs" ||
+        value === "sm" ||
+        value === "md" ||
+        value === "lg" ||
+        value === "xl" ||
+        value === "2xl");
+}
+/**
+ * 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 function resolveSpacingValue(value) {
+    const resolved = resolveResponsiveValue(value);
+    if (resolved === undefined)
+        return 0;
+    if (typeof resolved === "number")
+        return resolved;
+    if (isSpacingKey(resolved))
+        return SPACING_SCALE[resolved];
+    return 0;
+}
+/**
+ * Resolve spacing with a default fallback.
+ *
+ * @param value - Spacing value or undefined
+ * @param fallback - Default value if undefined
+ * @returns Resolved spacing
+ */
+export function resolveSpacingWithDefault(value, fallback) {
+    const resolved = resolveResponsiveValue(value);
+    if (resolved === undefined)
+        return fallback;
+    if (typeof resolved === "number")
+        return resolved;
+    if (isSpacingKey(resolved))
+        return SPACING_SCALE[resolved];
+    return fallback;
+}
+//# sourceMappingURL=spacing-scale.js.map

package/dist/layout/spacing-scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing-scale.js","sourceRoot":"","sources":["../../src/layout/spacing-scale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAwB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAO/E;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAyC,MAAM,CAAC,MAAM,CAAC;IAC/E,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;CACT,CAAC,CAAC;AAQH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,KAAK,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA+B,EAC/B,QAAgB;IAEhB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/layout/spacing.d.ts

@@ -0,0 +1,46 @@
+/**
+ * packages/core/src/layout/spacing.ts — Directional spacing resolution.
+ *
+ * Why: Normalizes spacing shorthand props into concrete per-side values.
+ * Supports both numeric values and spacing scale keys ("xs", "md", etc.).
+ */
+import type { SpacingProps } from "../widgets/types.js";
+import { type SpacingValue } from "./spacing-scale.js";
+export type ResolvedSpacing = Readonly<{
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}>;
+export type ResolvedMargin = ResolvedSpacing;
+/**
+ * Resolve spacing props to concrete numeric values.
+ * Priority: specific (pt) > axis (py) > all (p) > legacy (pad)
+ *
+ * @param props - Spacing props with values that may be numbers or scale keys
+ * @returns Resolved spacing in cell units
+ *
+ * @example
+ * ```typescript
+ * resolveSpacing({ p: "md" })
+ * // { top: 2, right: 2, bottom: 2, left: 2 }
+ *
+ * resolveSpacing({ px: "lg", py: "sm" })
+ * // { top: 1, right: 3, bottom: 1, left: 3 }
+ *
+ * resolveSpacing({ p: 1, pt: "xl" })
+ * // { top: 4, right: 1, bottom: 1, left: 1 }
+ * ```
+ */
+export declare function resolveSpacing(props: SpacingProps & {
+    pad?: SpacingValue;
+}): ResolvedSpacing;
+/**
+ * Resolve margin props to concrete numeric values.
+ * Priority: specific (mt/mr/mb/ml) > axis (mx/my) > all (m)
+ *
+ * @param props - Spacing props with margin values that may be numbers or scale keys
+ * @returns Resolved margin in cell units
+ */
+export declare function resolveMargin(props: SpacingProps): ResolvedMargin;
+//# sourceMappingURL=spacing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/layout/spacing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,CAe5F;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAWjE"}

package/dist/layout/spacing.js

@@ -0,0 +1,57 @@
+/**
+ * packages/core/src/layout/spacing.ts — Directional spacing resolution.
+ *
+ * Why: Normalizes spacing shorthand props into concrete per-side values.
+ * Supports both numeric values and spacing scale keys ("xs", "md", etc.).
+ */
+import { resolveSpacingValue } from "./spacing-scale.js";
+/**
+ * Resolve spacing props to concrete numeric values.
+ * Priority: specific (pt) > axis (py) > all (p) > legacy (pad)
+ *
+ * @param props - Spacing props with values that may be numbers or scale keys
+ * @returns Resolved spacing in cell units
+ *
+ * @example
+ * ```typescript
+ * resolveSpacing({ p: "md" })
+ * // { top: 2, right: 2, bottom: 2, left: 2 }
+ *
+ * resolveSpacing({ px: "lg", py: "sm" })
+ * // { top: 1, right: 3, bottom: 1, left: 3 }
+ *
+ * resolveSpacing({ p: 1, pt: "xl" })
+ * // { top: 4, right: 1, bottom: 1, left: 1 }
+ * ```
+ */
+export function resolveSpacing(props) {
+    // Resolve base padding (p or deprecated pad)
+    const p = resolveSpacingValue(props.p ?? props.pad);
+    // Resolve axis-specific padding, falling back to base
+    const px = props.px !== undefined ? resolveSpacingValue(props.px) : p;
+    const py = props.py !== undefined ? resolveSpacingValue(props.py) : p;
+    // Resolve side-specific padding, falling back to axis
+    const top = props.pt !== undefined ? resolveSpacingValue(props.pt) : py;
+    const right = props.pr !== undefined ? resolveSpacingValue(props.pr) : px;
+    const bottom = props.pb !== undefined ? resolveSpacingValue(props.pb) : py;
+    const left = props.pl !== undefined ? resolveSpacingValue(props.pl) : px;
+    return Object.freeze({ top, right, bottom, left });
+}
+/**
+ * Resolve margin props to concrete numeric values.
+ * Priority: specific (mt/mr/mb/ml) > axis (mx/my) > all (m)
+ *
+ * @param props - Spacing props with margin values that may be numbers or scale keys
+ * @returns Resolved margin in cell units
+ */
+export function resolveMargin(props) {
+    const m = resolveSpacingValue(props.m);
+    const mx = props.mx !== undefined ? resolveSpacingValue(props.mx) : m;
+    const my = props.my !== undefined ? resolveSpacingValue(props.my) : m;
+    const top = props.mt !== undefined ? resolveSpacingValue(props.mt) : my;
+    const right = props.mr !== undefined ? resolveSpacingValue(props.mr) : mx;
+    const bottom = props.mb !== undefined ? resolveSpacingValue(props.mb) : my;
+    const left = props.ml !== undefined ? resolveSpacingValue(props.ml) : mx;
+    return Object.freeze({ top, right, bottom, left });
+}
+//# sourceMappingURL=spacing.js.map

package/dist/layout/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../src/layout/spacing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAqB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAW5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,KAA4C;IACzE,6CAA6C;IAC7C,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IAEpD,sDAAsD;IACtD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE,sDAAsD;IACtD,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/layout/textMeasure.d.ts

@@ -0,0 +1,118 @@
+/**
+ * packages/core/src/layout/textMeasure.ts — Deterministic text measurement.
+ *
+ * Why: Computes the display width of text strings in terminal cell units.
+ * Uses pinned Unicode data tables to ensure measurements are deterministic
+ * across all environments and match the C engine's width calculations.
+ *
+ * Unicode pins:
+ *   - Unicode version: 15.1.0
+ *   - Grapheme segmentation: UAX #29 (core rules)
+ *   - East Asian Width: based on EAW property
+ *   - Emoji width: policy-controlled for emoji-presented graphemes
+ *
+ * Width rules:
+ *   - ASCII printable: 1 cell
+ *   - ASCII control: 0 cells
+ *   - CJK and wide characters: 2 cells
+ *   - Combining marks: 0 cells (merge with base)
+ *   - Emoji sequences: 2 cells total
+ *   - Invalid UTF-16 surrogates: replaced with U+FFFD (1 cell)
+ *
+ * @see docs/guide/layout.md
+ */
+/** Version pin for text measurement algorithm. Increment on any change. */
+export declare const ZRUI_TEXT_MEASURE_VERSION: 2;
+/**
+ * Emoji width policy used by text measurement.
+ *
+ * - "wide": emoji grapheme clusters occupy at least 2 cells.
+ * - "narrow": emoji grapheme clusters occupy at least 1 cell.
+ */
+export type TextMeasureEmojiPolicy = "wide" | "narrow";
+/**
+ * Set emoji width policy used by measureTextCells().
+ *
+ * Clearing the cache is required because previous widths may have been computed
+ * under a different policy.
+ */
+export declare function setTextMeasureEmojiPolicy(policy: TextMeasureEmojiPolicy): void;
+/** Get current emoji width policy used by measureTextCells(). */
+export declare function getTextMeasureEmojiPolicy(): TextMeasureEmojiPolicy;
+/**
+ * Clear the text measurement cache.
+ * Useful for testing or when memory pressure is detected.
+ */
+export declare function clearTextMeasureCache(): void;
+/**
+ * Get current cache size (for debugging/monitoring).
+ */
+export declare function getTextMeasureCacheSize(): number;
+/**
+ * Pinned, deterministic text measurement in terminal cell units.
+ *
+ * - Unicode pins: 15.1.0
+ * - Grapheme segmentation: UAX #29 core set
+ * - Emoji width policy: wide (2 cells)
+ * - Invalid UTF-16 surrogate sequences: replaced with U+FFFD
+ * - Tabs are not treated specially (no expansion)
+ *
+ * This function is cached for performance. Repeated measurements of the
+ * same text string return immediately from cache (O(1) vs O(n)).
+ */
+export declare function measureTextCells(text: string): number;
+/**
+ * Wrap text to lines at `maxWidth` cells using greedy token wrapping.
+ *
+ * - Splits paragraphs on `\n`
+ * - Preserves whitespace runs within each paragraph
+ * - Hard-breaks overlong tokens at grapheme boundaries
+ */
+export declare function wrapTextToLines(text: string, maxWidth: number): readonly string[];
+/**
+ * Measure wrapped text in terminal cells.
+ */
+export declare function measureTextWrapped(text: string, maxWidth: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Truncate text to fit within maxWidth cells, appending ellipsis if needed.
+ * Returns original text if it fits.
+ *
+ * @param text - The text to truncate
+ * @param maxWidth - Maximum width in terminal cells
+ * @returns Truncated text with ellipsis, or original if it fits
+ */
+export declare function truncateWithEllipsis(text: string, maxWidth: number): string;
+/**
+ * Truncate text in the middle, preserving start and end.
+ * Useful for file paths: /home/user/.../config.json
+ *
+ * @param text - The text to truncate
+ * @param maxWidth - Maximum width in terminal cells
+ * @returns Truncated text with ellipsis in middle, or original if it fits
+ *
+ * @example
+ * ```typescript
+ * truncateMiddle("/home/user/documents/project/src/index.ts", 25)
+ * // "/home/user/…/src/index.ts"
+ * ```
+ */
+/**
+ * Truncate text from the start, preserving the end.
+ * Useful for file paths and URLs where the tail is most important.
+ *
+ * @param text - The text to truncate
+ * @param maxWidth - Maximum width in terminal cells
+ * @returns Truncated text with ellipsis at start, or original if it fits
+ *
+ * @example
+ * ```typescript
+ * truncateStart("/home/user/documents/project/src/index.ts", 20)
+ * // "…ject/src/index.ts"
+ * ```
+ */
+export declare function truncateStart(text: string, maxWidth: number): string;
+export declare function truncateMiddle(text: string, maxWidth: number): string;
+//# sourceMappingURL=textMeasure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textMeasure.d.ts","sourceRoot":"","sources":["../../src/layout/textMeasure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAUH,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,EAAG,CAAU,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAIvD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAI9E;AAED,iEAAiE;AACjE,wBAAgB,yBAAyB,IAAI,sBAAsB,CAElE;AAuBD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AA+ID;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBrD;AAwND;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAiEjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAYnC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe3E;AAED;;;;;;;;;;;;;GAaG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyBrE"}