@textui/core 0.1.0

package/dist/render/layout.d.ts

@@ -0,0 +1,72 @@
+import type { Edges, EdgeSpec, Rect, Size } from '../types/geometry.js';
+import type { Overflow, Style } from '../types/style.js';
+/**
+ * Layout is a flexbox subset sized in whole cells.
+ *
+ * The subset is deliberate: grow and shrink along the main axis, stretch or
+ * align on the cross axis, optional wrapping into further lines, and absolute
+ * positioning for layers. Everything a terminal UI actually needs fits in
+ * that, and leaving out the rest keeps a pass over a full screen cheap enough
+ * to run on every frame.
+ *
+ * Wrapping is off by default, and that is a performance decision as much as a
+ * design one: a non-wrapping container measures each child once, and a
+ * wrapping one has to measure them all before it knows where the first line
+ * ends.
+ *
+ * Sizes are integers throughout. A "half cell" does not exist, so fractions
+ * are distributed by largest-remainder rather than rounded independently -
+ * three flex-1 children of a 10-cell row get 4, 3, 3, never 3, 3, 3 with a
+ * gap left over.
+ */
+export interface LayoutBox {
+    style: Style;
+    /** Border thickness actually drawn, per side. Consumes content space. */
+    borderEdges: Edges;
+    children: LayoutBox[];
+    /** Intrinsic size for leaves. Containers derive theirs from children. */
+    measure?(maxWidth: number, maxHeight: number): Size;
+    /** Scroll offset, in cells. Only meaningful with `overflow: 'scroll'`. */
+    scrollTop?: number;
+    scrollLeft?: number;
+    rect: Rect;
+    /** Inside border and padding. Where children and paint go. */
+    content: Rect;
+    /** Content larger than `content`, when overflow is 'scroll'. */
+    scrollSize?: Size;
+    /**
+     * The last answer `measureBox` gave for this box, and what it was asked.
+     *
+     * Sizing a flex container measures its children to find their intrinsic
+     * size, then measures them again against the space they were given - so a
+     * frame asks the same subtree the same question about twice, and the deeper
+     * the tree the more of it is repeated work. Counted on a 400-row list: 866
+     * calls, 407 of them distinct.
+     *
+     * One slot, not a map: the repeats are adjacent, and a map per box is an
+     * allocation per box to avoid an allocation per box. No invalidation either,
+     * because layout boxes are rebuilt from the instance tree every frame - the
+     * cache cannot outlive the thing it describes.
+     */
+    measured?: {
+        w: number;
+        h: number;
+        size: Size;
+    };
+}
+export declare function resolveEdges(spec: EdgeSpec | undefined): Edges;
+/**
+ * `overflow` for one axis. The specific prop wins over the shorthand, so
+ * `overflow: 'hidden', overflowY: 'scroll'` is a pane that scrolls down and
+ * clips sideways - which is what a log viewer is.
+ */
+export declare function overflowOn(style: Style, axis: 'x' | 'y'): Overflow;
+/**
+ * Intrinsic size, ignoring grow. Containers ask their children; leaves are
+ * asked directly. `available` bounds text wrapping, so a paragraph measures
+ * against the width it will actually get.
+ */
+export declare function measureBox(box: LayoutBox, availW: number, availH: number): Size;
+/** Lay a tree out into `viewport`. Mutates `rect` and `content` in place. */
+export declare function layout(root: LayoutBox, viewport: Rect): void;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/render/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAA6B,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGpF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,yEAAyE;IACzE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,IAAI,EAAE,IAAI,CAAC;IACX,8DAA8D;IAC9D,OAAO,EAAE,IAAI,CAAC;IACd,gEAAgE;IAChE,UAAU,CAAC,EAAE,IAAI,CAAC;IAElB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;CACjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,CAuB9D;AA0CD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,QAAQ,CAElE;AAkED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAsJ/E;AA0FD,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE5D"}