@carlesandres/house 0.4.12 → 0.4.14

package/src/index.tsx

@@ -2,6 +2,7 @@
 /** house — entry point. Boots the browser TUI or `--serve` preview. */
 
 import { stat } from "node:fs/promises"
+import { homedir } from "node:os"
 import { dirname, isAbsolute, relative, resolve } from "node:path"
 import { createCliRenderer } from "@opentui/core"
 import { createRoot } from "@opentui/react"
@@ -13,6 +14,7 @@ import { Browser, type StartupFocus } from "./Browser.tsx"
 import { parseArgv, usage } from "./cli/argv.ts"
 import { defaultConfigPath, formatConfigError, loadConfig } from "./config/load.ts"
 import { parseShowList, SHOW_CATEGORIES, type ShowCategory } from "./discovery/show.ts"
+import { formatDiscoveryRootLabel } from "./discovery/rootLabel.ts"
 import { walk, type FileEntry } from "./discovery/walk.ts"
 import { openInBrowser } from "./serve/openBrowser.ts"
 import { startServer } from "./serve/server.ts"
@@ -36,8 +38,6 @@ import { useUpdateNotice } from "./update/useUpdateNotice.ts"
  * `Quit` in Browser tears down the renderer and exits, which propagates
  * naturally — the cleanup effect still fires before process.exit completes.
  */
-export type SidebarMode = "auto" | "on" | "off"
-
 const pathIsDirectory = async (path: string): Promise<boolean> => {
 	try {
 		return (await stat(path)).isDirectory()
@@ -66,7 +66,7 @@ export const resolveDiscoveryRoot = async ({
 	readonly defaultRoot: "cwd" | "git"
 	readonly cwd: string
 }): Promise<string> => {
-	if (cliRoot !== null) return cliRoot
+	if (cliRoot !== null) return resolve(cwd, cliRoot)
 	if (defaultRoot === "git") return findGitRoot(cwd)
 	return cwd
 }
@@ -106,9 +106,10 @@ interface DiscoverShellProps {
 	 *  and the full vocabulary; the underlying categories remain
 	 *  independent everywhere else. */
 	readonly initialShow: readonly ShowCategory[]
+	readonly rootLabel?: string
 	readonly extensions: readonly string[]
-	readonly maxWidth: number | null
-	readonly sidebarMode: SidebarMode
+	readonly wrapWidth: number
+	readonly initialWrap: boolean
 	readonly startupFocus: StartupFocus
 }
 
@@ -116,9 +117,10 @@ export const DiscoverShell = ({
 	target,
 	initialQuery,
 	initialShow,
+	rootLabel = target,
 	extensions,
-	maxWidth,
-	sidebarMode,
+	wrapWidth,
+	initialWrap,
 	startupFocus,
 }: DiscoverShellProps) => {
 	const updateNotice = useUpdateNotice()
@@ -194,10 +196,10 @@ export const DiscoverShell = ({
 		<Browser
 			files={files}
 			initialQuery={initialQuery}
-			maxWidth={maxWidth}
-			emptyRootLabel={target}
+			wrapWidth={wrapWidth}
+			initialWrap={initialWrap}
+			rootLabel={rootLabel}
 			discoveryStatus={discoveryStatus}
-			sidebarMode={sidebarMode}
 			startupFocus={startupFocus}
 			updateNotice={updateNotice}
 			onToggleAll={() => {
@@ -240,6 +242,14 @@ if (import.meta.main) {
 		console.log(usage)
 		process.exit(0)
 	}
+	if (args.wrapConflict) {
+		console.error("house: --wrap and --no-wrap cannot be used together")
+		process.exit(2)
+	}
+	if (Bun.argv.slice(2).includes("--width") && args.width === null) {
+		console.error("house: --width requires a positive integer")
+		process.exit(2)
+	}
 	if (args.version) {
 		console.log(pkg.version)
 		process.exit(0)
@@ -282,13 +292,34 @@ if (import.meta.main) {
 					args.focus === "sidebar" || args.focus === "reader" || args.focus === "filter"
 						? args.focus
 						: null,
+				width:
+					args.width === null
+						? null
+						: (() => {
+								const n = Number.parseInt(args.width, 10)
+								if (!/^\d+$/.test(args.width) || !Number.isSafeInteger(n) || n <= 0) {
+									console.error(`house: --width must be a positive integer, got "${args.width}"`)
+									process.exit(2)
+								}
+								return n
+							})(),
+				wrap: args.wrap,
 			},
 		}),
 	).catch((err: unknown) => {
 		console.error(`house: ${formatConfigError(err)}`)
 		process.exit(2)
 	})
-	const { theme: themeId, tone, extensions, show, focus: startupFocus, defaultRoot } = config
+	const {
+		theme: themeId,
+		tone,
+		extensions,
+		show,
+		focus: startupFocus,
+		defaultRoot,
+		width: wrapWidth,
+		wrap: initialWrap,
+	} = config
 	const themeDef = getThemeDefinition(themeId)
 	if (themeDef === undefined) {
 		// Unreachable: Config.schema validated themeId against themeDefinitions.
@@ -297,16 +328,6 @@ if (import.meta.main) {
 	}
 	setActiveTheme(themeDef, tone)
 
-	let maxWidth: number | null = null
-	if (args.width !== null) {
-		const n = Number.parseInt(args.width, 10)
-		if (!Number.isFinite(n) || n <= 0) {
-			console.error(`house: --width must be a positive integer, got "${args.width}"`)
-			process.exit(2)
-		}
-		maxWidth = n
-	}
-
 	const cwd = process.cwd()
 	const discoveryRoot = await resolveDiscoveryRoot({ cliRoot: args.root, defaultRoot, cwd })
 	const initialQuery = resolveInitialQuery({ pathArg: args.path, discoveryRoot, cwd })
@@ -349,14 +370,6 @@ if (import.meta.main) {
 		process.on("SIGTERM", shutdown)
 		// Bun.serve keeps the event loop alive until stop().
 	} else {
-		let sidebarMode: SidebarMode = "auto"
-		if (args.sidebar !== null) {
-			if (args.sidebar !== "auto" && args.sidebar !== "on" && args.sidebar !== "off") {
-				console.error(`house: --sidebar must be "auto", "on", or "off", got "${args.sidebar}"`)
-				process.exit(2)
-			}
-			sidebarMode = args.sidebar
-		}
 		if (args.focus !== null) {
 			if (args.focus !== "sidebar" && args.focus !== "reader" && args.focus !== "filter") {
 				console.error(
@@ -370,10 +383,10 @@ if (import.meta.main) {
 			initialQuery,
 			themeId,
 			tone,
-			maxWidth,
+			wrapWidth,
+			initialWrap,
 			show,
 			extensions,
-			sidebarMode,
 			startupFocus,
 			updateCheck: !args.noUpdateCheck,
 		})
@@ -385,10 +398,10 @@ interface TuiBootOptions {
 	readonly initialQuery: string
 	readonly themeId: string
 	readonly tone: "dark" | "light"
-	readonly maxWidth: number | null
+	readonly wrapWidth: number
+	readonly initialWrap: boolean
 	readonly show: readonly ShowCategory[]
 	readonly extensions: readonly string[]
-	readonly sidebarMode: SidebarMode
 	readonly startupFocus: StartupFocus
 	/** Run the npm-registry probe and surface the "update available" notice.
 	 *  False suppresses both the toast and the quit-time print. */
@@ -400,10 +413,10 @@ async function runTui({
 	initialQuery,
 	themeId,
 	tone,
-	maxWidth,
+	wrapWidth,
+	initialWrap,
 	show,
 	extensions,
-	sidebarMode,
 	startupFocus,
 	updateCheck,
 }: TuiBootOptions): Promise<void> {
@@ -445,9 +458,10 @@ async function runTui({
 				target={discoveryRoot}
 				initialQuery={initialQuery}
 				initialShow={show}
+				rootLabel={formatDiscoveryRootLabel({ discoveryRoot, home: homedir() })}
 				extensions={extensions}
-				maxWidth={maxWidth}
-				sidebarMode={sidebarMode}
+				wrapWidth={wrapWidth}
+				initialWrap={initialWrap}
 				startupFocus={startupFocus}
 			/>
 		</RegistryProvider>,

package/src/io/clipboard.ts

@@ -0,0 +1,53 @@
+/**
+ * Best-effort clipboard write for macOS/Linux.
+ *
+ * The selected tool is fed through stdin so large or multiline markdown can be
+ * copied without shell quoting issues.
+ */
+
+export interface ClipboardCommand {
+	readonly cmd: string
+	readonly args: readonly string[]
+}
+
+type WhichFn = (command: string) => string | null | undefined
+
+interface CopyToClipboardDeps {
+	readonly platform?: NodeJS.Platform
+	readonly which?: WhichFn
+	readonly spawn?: (command: ClipboardCommand, text: string) => Promise<number>
+}
+
+export const resolveClipboardCommand = (
+	platform: NodeJS.Platform,
+	which: WhichFn,
+): ClipboardCommand | null => {
+	if (platform === "darwin") return { cmd: "pbcopy", args: [] }
+	if (platform !== "linux") return null
+	if (which("wl-copy")) return { cmd: "wl-copy", args: [] }
+	if (which("xclip")) return { cmd: "xclip", args: ["-selection", "clipboard"] }
+	return null
+}
+
+const spawnClipboardCommand = async (command: ClipboardCommand, text: string): Promise<number> => {
+	const proc = Bun.spawn([command.cmd, ...command.args], {
+		stdin: new Response(text),
+		stdout: "ignore",
+		stderr: "ignore",
+	})
+	return await proc.exited
+}
+
+export const copyTextToClipboard = async (
+	text: string,
+	{
+		platform = process.platform,
+		which = Bun.which.bind(Bun),
+		spawn = spawnClipboardCommand,
+	}: CopyToClipboardDeps = {},
+): Promise<void> => {
+	const command = resolveClipboardCommand(platform, which)
+	if (!command) throw new Error("no clipboard tool found")
+	const exitCode = await spawn(command, text)
+	if (exitCode !== 0) throw new Error("clipboard command failed")
+}

package/src/keymap/browser.ts

@@ -23,6 +23,7 @@ export interface BrowserCtx {
 	 *  hint gate so the hint only appears when there is something to clear. */
 	readonly filterQuery: string
 	readonly paletteOpen: boolean
+	readonly wrapEnabled: boolean
 	readonly setFocus: (next: BrowserFocus | ((prev: BrowserFocus) => BrowserFocus)) => void
 	readonly setSelectedIndex: (updater: (prev: number) => number) => void
 	/** Toggle `shown` and adjust focus per DESIGN.md §7.1 (see s-behavior table). */
@@ -33,6 +34,7 @@ export interface BrowserCtx {
 	 *  without first reopening with `/` and backspacing. */
 	readonly clearAndOpenFilter: () => void
 	readonly openPalette: () => void
+	readonly toggleWrap: () => void
 	readonly cycleTheme: (delta: 1 | -1) => void
 	readonly toggleTone: () => void
 	readonly quit: () => void
@@ -41,6 +43,10 @@ export interface BrowserCtx {
 	/** Suspend the TUI, hand the TTY to `$EDITOR`, resume and re-read on
 	 *  exit. No-op when nothing is selected; gating is the binding's job. */
 	readonly editCurrent: () => void
+	/** Copy the currently-selected file's raw contents to the system
+	 *  clipboard. No-op when nothing is selected; palette gating is the
+	 *  primary availability control. */
+	readonly copyCurrentContents: () => void
 	/** Toggle hidden + gitignored discovery axes together (#145 — UI sugar
 	 *  for `shift+a`; the underlying flags stay independent everywhere
 	 *  else). Snapshots the current selected path so it can be restored
@@ -162,6 +168,15 @@ export const browserBindings: readonly KeyBinding<BrowserCtx>[] = [
 		// does not write back to the TOML config.
 		run: (c) => c.toggleAll(),
 	},
+	{
+		id: "reader.wrap.toggle",
+		group: "Global",
+		description: "Toggle reader wrap",
+		hint: "wrap",
+		keys: ["w"],
+		hintWhen: inputClosed,
+		run: (c) => c.toggleWrap(),
+	},
 	{
 		id: "theme.next",
 		group: "Global",

package/src/layout/resolve.ts

@@ -50,11 +50,3 @@ export const defaultPreferredWidth = (viewport: number): number =>
  */
 export const canFitInline = (viewport: number): boolean =>
 	viewport >= SIDEBAR_MIN_WIDTH + DIVIDER_WIDTH + READER_MIN_WIDTH
-
-/**
- * Initial sidebar visibility for `--sidebar=auto`. Always true — every
- * viewport now boots on the sidebar (narrow: as the single visible screen;
- * wide: as the focused inline pane). `--sidebar=off` is the only way to
- * boot directly into the reader.
- */
-export const initialShownForAuto = (_viewport: number): boolean => true