@heyhuynhgiabuu/pi-pretty 0.6.7 → 0.6.9

package/src/tools/multi-grep.ts

@@ -1,12 +1,26 @@
 /* pi-pretty: multi_grep tool -- FFF-backed multi-pattern search with ripgrep/SDK fallback. */
 
-import { type ToolDefinition, type ExtensionAPI, type ExtensionContext, type AgentToolResult } from "@earendil-works/pi-coding-agent";
+import {
+	type ToolDefinition,
+	type ExtensionAPI,
+	type ExtensionContext,
+	type AgentToolResult,
+} from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
-import type { SdkToolDef, GrepDetails, FffServiceWithCursor, TextContent, ComponentLike, ThemeLike, RenderCtxLike } from "../types.js";
+import type {
+	SdkToolDef,
+	GrepDetails,
+	FffServiceWithCursor,
+	TextContent,
+	ComponentLike,
+	ThemeLike,
+	RenderCtxLike,
+} from "../types.js";
 import { resolveBaseBackground, MAX_PREVIEW_LINES, BG_ERROR, FG_DIM, FG_LNUM, FG_RULE, RST } from "../config.js";
 import { shortPath, normalizeLineEndings } from "../helpers.js";
 import { wrapExecuteWithMetrics } from "./metrics.js";
 import { renderToolError, renderToolMetrics, fillToolBackground } from "../render.js";
+import { resolveTextCtor } from "../tui-text.js";
 import { fffFormatGrepText } from "../fff-helpers.js";
 import { parseMultiGrepConstraints } from "../multi-grep-fallback.js";
 import { NOTICE_PARTIAL_FILE_INDEX } from "../notices.js";
@@ -14,7 +28,11 @@ import type { MultiGrepFallback } from "../types.js";
 
 type Result = AgentToolResult<Record<string, unknown>>;
 
-const noopFallback: MultiGrepFallback = async () => ({ text: "", matchCount: 0, limitReached: false });
+const noopFallback: MultiGrepFallback = async () => ({
+	text: "",
+	matchCount: 0,
+	limitReached: false,
+});
 
 export function registerMultiGrepTool(
 	pi: ExtensionAPI,
@@ -24,17 +42,14 @@ export function registerMultiGrepTool(
 	ripgrepFallback: MultiGrepFallback = noopFallback,
 	TextComp?: new (t?: string, x?: number, y?: number) => { setText(v: string): void },
 ): void {
-	const TC = TextComp ?? (() => {
-		const { Text } = require("@earendil-works/pi-tui") as { Text: new (t?: string, x?: number, y?: number) => { setText(v: string): void } };
-		return Text;
-	})();
+	const TC = resolveTextCtor(TextComp);
 	const home = process.env.HOME ?? "";
 
 	pi.registerTool({
 		name: "multi_grep",
 		label: "Multi Grep",
 		description: "Search file contents using multiple patterns (OR logic)",
-	parameters: Type.Object({
+		parameters: Type.Object({
 			patterns: Type.Array(Type.String()),
 			path: Type.Optional(Type.String()),
 			constraints: Type.Optional(Type.String()),
@@ -49,12 +64,18 @@ export function registerMultiGrepTool(
 
 			// Guard: empty patterns
 			if (!patterns.length || (patterns.length === 1 && !patterns[0])) {
-				return { content: [{ text: "patterns array must have at least 1 element", type: "text" as const }], details: { _type: "grepResult" } as GrepDetails };
+				return {
+					content: [{ text: "patterns array must have at least 1 element", type: "text" as const }],
+					details: { _type: "grepResult" } as GrepDetails,
+				};
 			}
 
 			// Guard: aborted signal
 			if (sig?.aborted) {
-				return { content: [{ text: "Aborted", type: "text" as const }], details: { _type: "grepResult" } as GrepDetails };
+				return {
+					content: [{ text: "Aborted", type: "text" as const }],
+					details: { _type: "grepResult" } as GrepDetails,
+				};
 			}
 			const constraintsStr = p.constraints ? String(p.constraints) : undefined;
 			const context = typeof p.context === "number" ? p.context : undefined;
@@ -92,32 +113,83 @@ export function registerMultiGrepTool(
 							notices.push(`More results available: cursor="${cursorId}"`);
 						}
 						const text = appendNotices(fffFormatGrepText(items, effectiveLimit), notices);
-						return { content: [{ type: "text" as const, text }], details: { _type: "grepResult", text, pattern: alternationPattern, matchCount: items.length } as GrepDetails };
+						return {
+							content: [{ type: "text" as const, text }],
+							details: {
+								_type: "grepResult",
+								text,
+								pattern: alternationPattern,
+								matchCount: items.length,
+							} as GrepDetails,
+						};
 					}
 					// FFF failure -> return error directly
-					return { content: [{ type: "text" as const, text: grepResult.error || "multi_grep failed" }], details: { _type: "grepResult", text: "", pattern: alternationPattern, matchCount: 0 } as GrepDetails };
-				} catch { /* fall through */ }
+					return {
+						content: [{ type: "text" as const, text: grepResult.error || "multi_grep failed" }],
+						details: {
+							_type: "grepResult",
+							text: "",
+							pattern: alternationPattern,
+							matchCount: 0,
+						} as GrepDetails,
+					};
+				} catch {
+					/* fall through */
+				}
 			}
 
 			// 2. Ripgrep fallback
 			if (requestedConstraints || !sdkGrepTool) {
 				try {
-					const pathBacked = Boolean(requestedConstraints && requestedPath && !Boolean(p.path) && !requestedConstraints.includes("*") && !requestedConstraints.includes("?"));
-			const constraintsForRg = pathBacked ? undefined : requestedConstraints;
+					const pathBacked = Boolean(
+						requestedConstraints &&
+							requestedPath &&
+							!Boolean(p.path) &&
+							!requestedConstraints.includes("*") &&
+							!requestedConstraints.includes("?"),
+					);
+					const constraintsForRg = pathBacked ? undefined : requestedConstraints;
 					const notices: string[] = [];
 					if (!fffService?.isAvailable) notices.push("FFF unavailable, used ripgrep fallback");
 					else if (hasNativeConstraints) notices.push("Used ripgrep fallback for constrained search");
 					else notices.push("Used ripgrep fallback");
 
 					const rgResult = await ripgrepFallback({
-						cwd, patterns, path: effectivePath, constraints: constraintsForRg,
-						ignoreCase: shouldIgnoreCase(patterns), context, limit: effectiveLimit, signal: sig,
+						cwd,
+						patterns,
+						path: effectivePath,
+						constraints: constraintsForRg,
+						ignoreCase: shouldIgnoreCase(patterns),
+						context,
+						limit: effectiveLimit,
+						signal: sig,
 					});
 					const text = normalizeLineEndings(rgResult.text) || "No matches found";
 					if (rgResult.limitReached) notices.push(`${effectiveLimit} limit reached`);
-					return { content: [{ type: "text" as const, text: appendNotices(text, notices) }], details: { _type: "grepResult", text, pattern: alternationPattern, matchCount: rgResult.matchCount } as GrepDetails };
+					return {
+						content: [{ type: "text" as const, text: appendNotices(text, notices) }],
+						details: {
+							_type: "grepResult",
+							text,
+							pattern: alternationPattern,
+							matchCount: rgResult.matchCount,
+						} as GrepDetails,
+					};
 				} catch (error: unknown) {
-					return { content: [{ type: "text" as const, text: `multi_grep error: ${error instanceof Error ? error.message : String(error)}` }], details: { _type: "grepResult", text: "", pattern: alternationPattern, matchCount: 0 } as GrepDetails };
+					return {
+						content: [
+							{
+								type: "text" as const,
+								text: `multi_grep error: ${error instanceof Error ? error.message : String(error)}`,
+							},
+						],
+						details: {
+							_type: "grepResult",
+							text: "",
+							pattern: alternationPattern,
+							matchCount: 0,
+						} as GrepDetails,
+					};
 				}
 			}
 
@@ -125,13 +197,43 @@ export function registerMultiGrepTool(
 			try {
 				const notices: string[] = [];
 				if (!fffService?.isAvailable) notices.push("FFF unavailable, used SDK grep fallback");
-				const result = await sdkGrepTool.execute(tid, { pattern: alternationPattern, path: effectivePath, ignoreCase: shouldIgnoreCase(patterns), context, limit: effectiveLimit }, sig, null, ctx) as Result;
+				const result = (await sdkGrepTool.execute(
+					tid,
+					{
+						pattern: alternationPattern,
+						path: effectivePath,
+						ignoreCase: shouldIgnoreCase(patterns),
+						context,
+						limit: effectiveLimit,
+					},
+					sig,
+					null,
+					ctx,
+				)) as Result;
 				const tc = getText(result);
 				result.content = [{ type: "text" as const, text: appendNotices(tc, notices) }];
-				result.details = { _type: "grepResult", text: tc, pattern: alternationPattern, matchCount: tc ? tc.trim().split("\n").filter(Boolean).length : 0 } as GrepDetails;
+				result.details = {
+					_type: "grepResult",
+					text: tc,
+					pattern: alternationPattern,
+					matchCount: tc ? tc.trim().split("\n").filter(Boolean).length : 0,
+				} as GrepDetails;
 				return result;
 			} catch (error: unknown) {
-				return { content: [{ type: "text" as const, text: `multi_grep error: ${error instanceof Error ? error.message : String(error)}` }], details: { _type: "grepResult", text: "", pattern: alternationPattern, matchCount: 0 } as GrepDetails };
+				return {
+					content: [
+						{
+							type: "text" as const,
+							text: `multi_grep error: ${error instanceof Error ? error.message : String(error)}`,
+						},
+					],
+					details: {
+						_type: "grepResult",
+						text: "",
+						pattern: alternationPattern,
+						matchCount: 0,
+					} as GrepDetails,
+				};
 			}
 		}),
 
@@ -140,9 +242,17 @@ export function registerMultiGrepTool(
 			const text = ctx.lastComponent ?? new TC("", 0, 0);
 			const patterns: string[] = Array.isArray(args.patterns) ? args.patterns.map((p: unknown) => String(p)) : [];
 			const limit = typeof args.limit === "number" ? args.limit : undefined;
-			const path = args.path === null || args.path === undefined ? "<missing>" : shortPath(cwd, home, String(args.path));
+			const path =
+				args.path === null || args.path === undefined ? "<missing>" : shortPath(cwd, home, String(args.path));
 			const literal = args.literal === true;
-			const patternStr = patterns.length === 0 ? "" : patterns.length === 1 ? patterns[0]! : patterns.length === 2 ? `${patterns[0]}|${patterns[1]}` : `${patterns[0]}|${patterns[1]}|+${patterns.length - 2}`;
+			const patternStr =
+				patterns.length === 0
+					? ""
+					: patterns.length === 1
+						? patterns[0]!
+						: patterns.length === 2
+							? `${patterns[0]}|${patterns[1]}`
+							: `${patterns[0]}|${patterns[1]}|+${patterns.length - 2}`;
 			let out = `${theme.fg("toolTitle", theme.bold("mgrep"))} ${theme.fg("accent", `/${patternStr || ""}/`)}${theme.fg("toolOutput", ` in ${path}`)}`;
 			if (literal) out += theme.fg("dim", ` (literal)`);
 			if (limit !== undefined) out += theme.fg("dim", ` limit ${limit}`);
@@ -152,9 +262,12 @@ export function registerMultiGrepTool(
 
 		renderResult(result: Result, _opt: unknown, theme: ThemeLike, ctx: RenderCtxLike) {
 			resolveBaseBackground(theme);
-			
+
 			const text = ctx.lastComponent ?? new TC("", 0, 0);
-			if (ctx.isError) { text.setText(renderToolError(getText(result) || "Error", theme)); return text; }
+			if (ctx.isError) {
+				text.setText(renderToolError(getText(result) || "Error", theme));
+				return text;
+			}
 			const d = result.details as GrepDetails | undefined;
 			if (d?._type === "grepResult" && d.text) {
 				const lines = d.text.split("\n");
@@ -163,7 +276,9 @@ export function registerMultiGrepTool(
 				const nw = Math.max(3, 5);
 
 				let hlRe: RegExp | null = null;
-				try { hlRe = new RegExp(`(${d.pattern})`, "gi"); } catch {}
+				try {
+					hlRe = new RegExp(`(${d.pattern})`, "gi");
+				} catch {}
 
 				const out: string[] = [];
 				let currentFile = "";
@@ -186,16 +301,31 @@ export function registerMultiGrepTool(
 				}
 				const preview = out.join("\n");
 				const more = lines.length > maxShow ? `\n${FG_DIM}  ... ${lines.length - maxShow} more lines${RST}` : "";
-				text.setText(fillToolBackground(`  ${FG_DIM}${d.matchCount} matches${RST}${renderToolMetrics(result)}\n${preview}${more}`));
+				text.setText(
+					fillToolBackground(`  ${FG_DIM}${d.matchCount} matches${RST}${renderToolMetrics(result)}\n${preview}${more}`),
+				);
 				return text;
 			}
 			const fc = result.content?.[0];
-			text.setText(fillToolBackground(`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 120) : "no matches")}`));
+			text.setText(
+				fillToolBackground(`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 120) : "no matches")}`),
+			);
 			return text;
 		},
 	} as unknown as ToolDefinition<any, any, any>);
 }
 
-function shouldIgnoreCase(patterns: string[]): boolean { return !patterns.some((p) => /[A-Z]/.test(p)); }
-function appendNotices(text: string, notices: string[]): string { return notices.length ? `${text}\n\n[${notices.join(". ")}]` : text; }
-function getText(result: Result): string { return ((result.content ?? []) as TextContent[]).filter((c) => c.type === "text").map((c) => c.text).join("\n") ?? ""; }
+function shouldIgnoreCase(patterns: string[]): boolean {
+	return !patterns.some((p) => /[A-Z]/.test(p));
+}
+function appendNotices(text: string, notices: string[]): string {
+	return notices.length ? `${text}\n\n[${notices.join(". ")}]` : text;
+}
+function getText(result: Result): string {
+	return (
+		((result.content ?? []) as TextContent[])
+			.filter((c) => c.type === "text")
+			.map((c) => c.text)
+			.join("\n") ?? ""
+	);
+}

package/src/tools/read.ts

@@ -1,11 +1,27 @@
 /* pi-pretty: read tool -- file reading with syntax highlighting and inline image support. */
 
-import { type ToolDefinition, type ExtensionAPI, type ExtensionContext, type AgentToolResult } from "@earendil-works/pi-coding-agent";
+import {
+	type ToolDefinition,
+	type ExtensionAPI,
+	type ExtensionContext,
+	type AgentToolResult,
+} from "@earendil-works/pi-coding-agent";
 import type { SdkToolDef, ReadDetails, TextContent, ComponentLike, ThemeLike, RenderCtxLike } from "../types.js";
-import { resolveBaseBackground, termWidth, MAX_PREVIEW_LINES, BG_BASE, BG_ERROR, FG_DIM, FG_LNUM, FG_RULE, RST } from "../config.js";
+import {
+	resolveBaseBackground,
+	termWidth,
+	MAX_PREVIEW_LINES,
+	BG_BASE,
+	BG_ERROR,
+	FG_DIM,
+	FG_LNUM,
+	FG_RULE,
+	RST,
+} from "../config.js";
 import { shortPath, normalizeLineEndings } from "../helpers.js";
 import { wrapExecuteWithMetrics } from "./metrics.js";
 import { renderToolError, renderToolMetrics, fillToolBackground, renderFileContent } from "../render.js";
+import { resolveTextCtor } from "../tui-text.js";
 
 // Simple terminal image support check
 function isImageTerminal(): boolean {
@@ -13,7 +29,10 @@ function isImageTerminal(): boolean {
 	const proto = (process.env.PRETTY_IMAGE_PROTOCOL ?? "").toLowerCase();
 	if (proto === "kitty" || proto === "iterm2") return true;
 	if (proto === "none") return false;
-	return ["ghostty", "kitty", "iterm.app", "wezterm", "mintty"].some((t) => term.includes(t)) || process.env.LC_TERMINAL === "iTerm2";
+	return (
+		["ghostty", "kitty", "iterm.app", "wezterm", "mintty"].some((t) => term.includes(t)) ||
+		process.env.LC_TERMINAL === "iTerm2"
+	);
 }
 
 type Result = AgentToolResult<Record<string, unknown>>;
@@ -25,10 +44,7 @@ export function registerReadTool(
 	sdkTool: SdkToolDef,
 	TextComp?: new (t?: string, x?: number, y?: number) => { setText(v: string): void },
 ): void {
-	const TC = TextComp ?? (() => {
-		const { Text } = require("@earendil-works/pi-tui") as { Text: new (t?: string, x?: number, y?: number) => { setText(v: string): void } };
-		return Text;
-	})();
+	const TC = resolveTextCtor(TextComp);
 	const home = process.env.HOME ?? "";
 
 	pi.registerTool({
@@ -40,22 +56,33 @@ export function registerReadTool(
 
 		execute: wrapExecuteWithMetrics(async (tid, params, sig, _upd, ctx: ExtensionContext) => {
 			const p = params as any;
-			const result = await sdkTool.execute(tid, p, sig, undefined, ctx) as Result;
+			const result = (await sdkTool.execute(tid, p, sig, undefined, ctx)) as Result;
 
 			const imageBlock = (result.content as any[])?.find((c: any) => c.type === "image");
 			if (imageBlock) {
-				result.details = { _type: "readImage", filePath: String(p.path ?? ""), data: imageBlock.data, mimeType: imageBlock.mimeType ?? "image/png" } as ReadDetails;
+				result.details = {
+					_type: "readImage",
+					filePath: String(p.path ?? ""),
+					data: imageBlock.data,
+					mimeType: imageBlock.mimeType ?? "image/png",
+				} as ReadDetails;
 				return result;
 			}
 
 			const tc = normalizeLineEndings(getText(result));
-			result.details = { _type: "readFile", filePath: String(p.path ?? ""), content: tc, offset: typeof p.offset === "number" ? p.offset : 0, lineCount: tc ? tc.split("\n").length : 0 } as ReadDetails;
+			result.details = {
+				_type: "readFile",
+				filePath: String(p.path ?? ""),
+				content: tc,
+				offset: typeof p.offset === "number" ? p.offset : 0,
+				lineCount: tc ? tc.split("\n").length : 0,
+			} as ReadDetails;
 			return result;
 		}),
 
 		renderCall(args: any, theme: ThemeLike, ctx: RenderCtxLike) {
 			resolveBaseBackground(theme);
-			
+
 			const text = ctx.lastComponent ?? new TC("", 0, 0);
 			text.setText("");
 			return text;
@@ -63,10 +90,13 @@ export function registerReadTool(
 
 		renderResult(result: Result, _opt: unknown, theme: ThemeLike, ctx: RenderCtxLike) {
 			resolveBaseBackground(theme);
-			
+
 			const text = ctx.lastComponent ?? new TC("", 0, 0);
 
-			if (ctx.isError) { text.setText(renderToolError(getText(result) || "Error", theme)); return text; }
+			if (ctx.isError) {
+				text.setText(renderToolError(getText(result) || "Error", theme));
+				return text;
+			}
 
 			const d = result.details as ReadDetails | undefined;
 
@@ -74,7 +104,11 @@ export function registerReadTool(
 			if (d?._type === "readImage") {
 				if ((ctx as any).showImages && isImageTerminal()) {
 					try {
-						const T = require("@earendil-works/pi-tui").Text as new (t?: string, x?: number, y?: number) => ComponentLike;
+						const T = require("@earendil-works/pi-tui").Text as new (
+							t?: string,
+							x?: number,
+							y?: number,
+						) => ComponentLike;
 						const img = new T("", 0, 0);
 						if (d.mimeType.startsWith("image/svg")) {
 							img.setText(d.data);
@@ -83,10 +117,16 @@ export function registerReadTool(
 							img.setText(`\x1b_Ga=T,f=100,m=${d.mimeType === "image/png" ? "1" : "0"};${pngData}\x1b\\\\`);
 						}
 						return img;
-					} catch { /* fall through */ }
+					} catch {
+						/* fall through */
+					}
 				}
 				const fc = result.content?.[0];
-				text.setText(fillToolBackground(`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 80) : `[image: ${d.filePath}]`)}`));
+				text.setText(
+					fillToolBackground(
+						`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 80) : `[image: ${d.filePath}]`)}`,
+					),
+				);
 				return text;
 			}
 
@@ -111,7 +151,9 @@ export function registerReadTool(
 					const code = show[i] ?? "";
 					const display = code.length > cw ? code.slice(0, cw) + `${FG_DIM}›${RST}` : code;
 					const lineNo = String(ln);
-					out.push(`  ${FG_LNUM}${" ".repeat(Math.max(0, nw - lineNo.length))}${lineNo}${RST} ${FG_RULE}│${RST} ${display}${RST}`);
+					out.push(
+						`  ${FG_LNUM}${" ".repeat(Math.max(0, nw - lineNo.length))}${lineNo}${RST} ${FG_RULE}│${RST} ${display}${RST}`,
+					);
 				}
 				if (total > maxShow) {
 					out.push(`  ${FG_DIM}  … ${total - maxShow} more lines (${total} total)${RST}`);
@@ -122,23 +164,35 @@ export function registerReadTool(
 				(ctx as any).state._rt = rendered;
 
 				// Async syntax highlighting via Shiki
-				renderFileContent(d.content, d.filePath, d.offset || 0, maxShow, tw).then(hl => {
-					const padded = hl.split("\n").map(l => `  ${l}`).join("\n");
-					const rendered = `\n  ${header}\n${padded}\n`;
-					text.setText(fillToolBackground(rendered));
-					(ctx as any).state._rt = rendered;
-				}).catch(() => {});
+				renderFileContent(d.content, d.filePath, d.offset || 0, maxShow, tw)
+					.then((hl) => {
+						const padded = hl
+							.split("\n")
+							.map((l) => `  ${l}`)
+							.join("\n");
+						const rendered = `\n  ${header}\n${padded}\n`;
+						text.setText(fillToolBackground(rendered));
+						(ctx as any).state._rt = rendered;
+					})
+					.catch(() => {});
 
 				return text;
 			}
 
 			const fc = result.content?.[0];
-			text.setText(fillToolBackground(`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 120) : "done")}`));
+			text.setText(
+				fillToolBackground(`  ${theme.fg("dim", fc && "text" in fc ? String(fc.text).slice(0, 120) : "done")}`),
+			);
 			return text;
 		},
 	} as unknown as ToolDefinition<any, any, any>);
 }
 
 function getText(result: Result): string {
-	return ((result.content ?? []) as TextContent[]).filter((c) => c.type === "text").map((c) => c.text).join("\n") ?? "";
+	return (
+		((result.content ?? []) as TextContent[])
+			.filter((c) => c.type === "text")
+			.map((c) => c.text)
+			.join("\n") ?? ""
+	);
 }

package/src/tui-text.ts

@@ -0,0 +1,56 @@
+/**
+ * Lazy resolver for pi-tui Text constructor.
+ *
+ * Returns the real Text class from @earendil-works/pi-tui, or a stub when
+ * pi-tui is unavailable (e.g. not in jiti's alias map). This avoids crashing
+ * during tool registration when pi-tui isn't aliased.
+ *
+ * The resolution is cached — the require() call happens at most once.
+ */
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type TextCtor = new (t?: string, x?: number, y?: number) => { setText(v: string): void; [k: string]: any };
+
+/** No-op stub that satisfies the Text interface so rendering doesn't crash. */
+class StubText {
+	// eslint-disable-next-line @typescript-eslint/no-unused-vars
+	constructor(_t?: string, _x?: number, _y?: number) {
+		// no-op
+	}
+	setText(_v: string): void {
+		// no-op — pi-tui not available
+	}
+}
+
+let _ctor: TextCtor | null = null;
+let _resolved = false;
+
+function resolve(): TextCtor {
+	if (_resolved) return _ctor!;
+	_resolved = true;
+	try {
+		// eslint-disable-next-line @typescript-eslint/no-var-requires
+		const { Text } = require("@earendil-works/pi-tui") as { Text: TextCtor };
+		_ctor = Text;
+		return _ctor;
+	} catch {
+		_ctor = StubText;
+		return _ctor;
+	}
+}
+
+/**
+ * Returns a Text constructor, always valid. Falls back to StubText if
+ * @earendil-works/pi-tui is unavailable (caught and cached).
+ */
+export function getTextCtor(): TextCtor {
+	return resolve();
+}
+
+/**
+ * Returns TextComp if provided, otherwise the lazy-resolved Text constructor.
+ * Always returns a valid constructor (never undefined/null).
+ */
+export function resolveTextCtor(TextComp?: TextCtor): TextCtor {
+	return TextComp ?? resolve();
+}