@cel-tui/core 0.4.1 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cel-tui/core",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Core framework engine for cel-tui — primitives, layout, rendering, input",
   "type": "module",
   "module": "src/index.ts",
@@ -34,7 +34,7 @@
     "layout"
   ],
   "dependencies": {
-    "@cel-tui/types": "0.4.1",
+    "@cel-tui/types": "0.5.0",
     "get-east-asian-width": "^1.5.0"
   },
   "peerDependencies": {

package/src/index.ts

@@ -2,8 +2,9 @@
  * @module @cel-tui/core
  *
  * Core framework package. Provides the four primitives ({@link VStack},
- * {@link HStack}, {@link Text}, {@link TextInput}) and the framework
- * entrypoint ({@link cel}).
+ * {@link HStack}, {@link Text}, {@link TextInput}), the framework
+ * entrypoint ({@link cel}), and measurement helpers such as
+ * {@link measureContentHeight}.
  *
  * All types are re-exported from `@cel-tui/types`.
  *
@@ -45,6 +46,7 @@ export { VStack, HStack } from "./primitives/stacks.js";
 export { Text } from "./primitives/text.js";
 export { TextInput } from "./primitives/text-input.js";
 export { cel } from "./cel.js";
+export { measureContentHeight } from "./layout.js";
 export { CellBuffer, EMPTY_CELL, type Cell } from "./cell-buffer.js";
 export { emitBuffer, defaultTheme } from "./emitter.js";
 export { visibleWidth, extractAnsiCode } from "./width.js";

package/src/layout.ts

@@ -121,6 +121,15 @@ function intrinsicMainSize(
           resolveSizeValue(cProps?.width, 0) ??
           intrinsicMainSize(child, false, innerCross);
       }
+      if (cProps) {
+        const minMain = isVertical
+          ? (cProps.minHeight ?? 0)
+          : (cProps.minWidth ?? 0);
+        const maxMain = isVertical
+          ? (cProps.maxHeight ?? Infinity)
+          : (cProps.maxWidth ?? Infinity);
+        childMain = clamp(childMain, minMain, maxMain);
+      }
       total += childMain;
       if (i < node.children.length - 1) total += gap;
     }
@@ -150,9 +159,12 @@ function intrinsicMainSize(
         }
       }
       wrapWidths.push(w);
-      const h =
+      let h =
         resolveSizeValue(cProps?.height, 0) ??
         intrinsicMainSize(child, true, innerCross);
+      if (cProps) {
+        h = clamp(h, cProps.minHeight ?? 0, cProps.maxHeight ?? Infinity);
+      }
       wrapHeights.push(h);
     }
     const wrapRows = assignWrapRows(wrapWidths, innerCross, gap);
@@ -259,6 +271,37 @@ function largestRemainder(fractions: number[], total: number): number[] {
 
 // --- Main layout ---
 
+/**
+ * Measure a node tree's intrinsic content height at the provided width.
+ *
+ * This is a content-measurement helper, not a viewport/clipping helper.
+ * The caller-provided `width` is the authoritative wrapping width for the
+ * measured subtree. Measurement starts at the given node, ignores that
+ * node's own main-axis height constraints, and walks downward through its
+ * descendants. Descendant sizing rules still apply normally.
+ *
+ * Use this for intrinsically sized content such as scrollback/message
+ * history chunks. If a wrapper's visible height is controlled by `height`,
+ * `flex`, or percentage sizing, measure the content subtree inside that
+ * wrapper instead.
+ *
+ * @example
+ * ```ts
+ * const addedHeight = measureContentHeight(
+ *   VStack({}, olderMessages.map(renderMessage)),
+ *   { width: historyContentWidth },
+ * );
+ *
+ * scrollOffset += addedHeight;
+ * ```
+ */
+export function measureContentHeight(
+  node: Node,
+  options: { width: number },
+): number {
+  return intrinsicMainSize(node, true, options.width);
+}
+
 /**
  * Compute the layout for a UI tree.
  *