@effect-tui/react 0.13.0 → 0.14.0

package/src/utils/styles.ts

@@ -2,7 +2,8 @@
  * Style utilities for building palette-compatible style objects.
  */
 
-import { type Color, type ColorValue, type Palette, parseColor, type StyleSpec } from "@effect-tui/core"
+import type { CellBuffer, Color, ColorValue, Palette, StyleSpec } from "@effect-tui/core"
+import { parseColor } from "@effect-tui/core"
 
 export interface StyleOptions {
 	fg?: ColorValue
@@ -64,6 +65,7 @@ export function resolveBgStyle(palette: Palette, bg?: Color): { value?: ColorVal
 
 import { getInheritedBg } from "../hosts/base.js"
 import type { HostInstance } from "../reconciler/types.js"
+import type { Rect } from "../reconciler/types.js"
 
 /**
  * Resolve background style, inheriting from parent if not explicitly set.
@@ -77,3 +79,18 @@ export function resolveInheritedBgStyle(
 	const bg = explicitBg ?? getInheritedBg(parent)
 	return resolveBgStyle(palette, bg)
 }
+
+/**
+ * Fill a rect with background color, inheriting from parent if needed.
+ */
+export function fillRectWithInheritedBg(
+	buffer: CellBuffer,
+	palette: Palette,
+	rect: Rect,
+	explicitBg: Color | undefined,
+	parent: HostInstance | null,
+): void {
+	if (rect.w <= 0 || rect.h <= 0) return
+	const { styleId } = resolveInheritedBgStyle(palette, explicitBg, parent)
+	buffer.fillRect(rect.x, rect.y, rect.w, rect.h, " ".codePointAt(0)!, styleId)
+}

package/src/utils/text-wrap.ts

@@ -0,0 +1,66 @@
+import { displayWidth } from "@effect-tui/core"
+
+type SpanLike = { text: string }
+
+/**
+ * Wrap spans into lines, breaking at word boundaries.
+ * Preserves span styling by cloning span objects with updated text.
+ */
+export function wrapSpans<T extends SpanLike>(spans: T[], maxWidth: number): T[][] {
+	const lines: T[][] = [[]]
+	let lineWidth = 0
+
+	for (const span of spans) {
+		// Split span text into words (keeping whitespace as separate tokens)
+		const tokens = span.text.split(/(\s+)/)
+
+		for (const token of tokens) {
+			if (!token) continue
+			const tokenWidth = displayWidth(token)
+			const isWhitespace = /^\s+$/.test(token)
+
+			if (lineWidth + tokenWidth <= maxWidth) {
+				// Token fits on current line
+				lines[lines.length - 1].push({ ...span, text: token })
+				lineWidth += tokenWidth
+			} else if (isWhitespace) {
+				// Skip whitespace at line break
+				continue
+			} else if (tokenWidth <= maxWidth) {
+				// Start new line with this token
+				lines.push([{ ...span, text: token }])
+				lineWidth = tokenWidth
+			} else {
+				// Token is longer than maxWidth - break by character
+				let charLine = ""
+				let charLineWidth = 0
+				for (const ch of token) {
+					const chWidth = displayWidth(ch)
+					if (lineWidth + charLineWidth + chWidth > maxWidth && (charLine || lineWidth > 0)) {
+						if (charLine) {
+							lines[lines.length - 1].push({ ...span, text: charLine })
+						}
+						lines.push([])
+						lineWidth = 0
+						charLine = ch
+						charLineWidth = chWidth
+					} else {
+						charLine += ch
+						charLineWidth += chWidth
+					}
+				}
+				if (charLine) {
+					lines[lines.length - 1].push({ ...span, text: charLine })
+					lineWidth += charLineWidth
+				}
+			}
+		}
+	}
+
+	// Remove empty lines at the end
+	while (lines.length > 0 && lines[lines.length - 1].length === 0) {
+		lines.pop()
+	}
+
+	return lines.length > 0 ? lines : [[]]
+}