@carlesandres/house 0.4.14 → 0.5.1

package/src/theme/themes/vesper.json

@@ -1,171 +0,0 @@
-{
-	"defs": {
-		"vesperBg": "#101010",
-		"vesperFg": "#FFF",
-		"vesperComment": "#8b8b8b",
-		"vesperKeyword": "#A0A0A0",
-		"vesperFunction": "#FFC799",
-		"vesperString": "#99FFE4",
-		"vesperNumber": "#FFC799",
-		"vesperError": "#FF8080",
-		"vesperWarning": "#FFC799",
-		"vesperSuccess": "#99FFE4",
-		"vesperMuted": "#A0A0A0"
-	},
-	"theme": {
-		"primary": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"secondary": {
-			"dark": "#99FFE4",
-			"light": "#99FFE4"
-		},
-		"accent": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"error": {
-			"dark": "vesperError",
-			"light": "vesperError"
-		},
-		"warning": {
-			"dark": "vesperWarning",
-			"light": "vesperWarning"
-		},
-		"success": {
-			"dark": "vesperSuccess",
-			"light": "vesperSuccess"
-		},
-		"info": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"text": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"textMuted": {
-			"dark": "vesperMuted",
-			"light": "vesperMuted"
-		},
-		"background": {
-			"dark": "vesperBg",
-			"light": "#FFF"
-		},
-		"backgroundPanel": {
-			"dark": "#151515",
-			"light": "#F0F0F0"
-		},
-		"backgroundElement": {
-			"dark": "#282828",
-			"light": "#E0E0E0"
-		},
-		"border": {
-			"dark": "#282828",
-			"light": "#D0D0D0"
-		},
-		"borderActive": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"borderSubtle": {
-			"dark": "#1C1C1C",
-			"light": "#E8E8E8"
-		},
-		"markdownText": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownHeading": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"markdownLink": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"markdownLinkText": {
-			"dark": "vesperMuted",
-			"light": "vesperMuted"
-		},
-		"markdownCode": {
-			"dark": "vesperMuted",
-			"light": "vesperMuted"
-		},
-		"markdownBlockQuote": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownEmph": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownStrong": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownHorizontalRule": {
-			"dark": "#65737E",
-			"light": "#65737E"
-		},
-		"markdownListItem": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownListEnumeration": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"markdownImage": {
-			"dark": "#FFC799",
-			"light": "#FFC799"
-		},
-		"markdownImageText": {
-			"dark": "vesperMuted",
-			"light": "vesperMuted"
-		},
-		"markdownCodeBlock": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"syntaxComment": {
-			"dark": "vesperComment",
-			"light": "vesperComment"
-		},
-		"syntaxKeyword": {
-			"dark": "vesperKeyword",
-			"light": "vesperKeyword"
-		},
-		"syntaxFunction": {
-			"dark": "vesperFunction",
-			"light": "vesperFunction"
-		},
-		"syntaxVariable": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		},
-		"syntaxString": {
-			"dark": "vesperString",
-			"light": "vesperString"
-		},
-		"syntaxNumber": {
-			"dark": "vesperNumber",
-			"light": "vesperNumber"
-		},
-		"syntaxType": {
-			"dark": "vesperFunction",
-			"light": "vesperFunction"
-		},
-		"syntaxOperator": {
-			"dark": "vesperKeyword",
-			"light": "vesperKeyword"
-		},
-		"syntaxPunctuation": {
-			"dark": "vesperFg",
-			"light": "vesperBg"
-		}
-	},
-	"name": "Vesper",
-	"$schema": "../../../schema/house-theme.schema.json"
-}

package/src/theme/themes/zenburn.json

@@ -1,176 +0,0 @@
-{
-	"defs": {
-		"bg": "#3f3f3f",
-		"bgAlt": "#4f4f4f",
-		"bgPanel": "#5f5f5f",
-		"fg": "#dcdccc",
-		"fgMuted": "#9f9f9f",
-		"red": "#cc9393",
-		"redBright": "#dca3a3",
-		"green": "#7f9f7f",
-		"greenBright": "#8fb28f",
-		"yellow": "#f0dfaf",
-		"yellowDim": "#e0cf9f",
-		"blue": "#8cd0d3",
-		"blueDim": "#7cb8bb",
-		"magenta": "#dc8cc3",
-		"cyan": "#93e0e3",
-		"orange": "#dfaf8f"
-	},
-	"theme": {
-		"primary": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"secondary": {
-			"dark": "magenta",
-			"light": "#8f5f8f"
-		},
-		"accent": {
-			"dark": "cyan",
-			"light": "#5f8f8f"
-		},
-		"error": {
-			"dark": "red",
-			"light": "#8f5f5f"
-		},
-		"warning": {
-			"dark": "yellow",
-			"light": "#8f8f5f"
-		},
-		"success": {
-			"dark": "green",
-			"light": "#5f8f5f"
-		},
-		"info": {
-			"dark": "orange",
-			"light": "#8f7f5f"
-		},
-		"text": {
-			"dark": "fg",
-			"light": "#3f3f3f"
-		},
-		"textMuted": {
-			"dark": "fgMuted",
-			"light": "#6f6f6f"
-		},
-		"background": {
-			"dark": "bg",
-			"light": "#ffffef"
-		},
-		"backgroundPanel": {
-			"dark": "bgAlt",
-			"light": "#f5f5e5"
-		},
-		"backgroundElement": {
-			"dark": "bgPanel",
-			"light": "#ebebdb"
-		},
-		"border": {
-			"dark": "#5f5f5f",
-			"light": "#d0d0c0"
-		},
-		"borderActive": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"borderSubtle": {
-			"dark": "#4f4f4f",
-			"light": "#e0e0d0"
-		},
-		"markdownText": {
-			"dark": "fg",
-			"light": "#3f3f3f"
-		},
-		"markdownHeading": {
-			"dark": "yellow",
-			"light": "#8f8f5f"
-		},
-		"markdownLink": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"markdownLinkText": {
-			"dark": "cyan",
-			"light": "#5f8f8f"
-		},
-		"markdownCode": {
-			"dark": "green",
-			"light": "#5f8f5f"
-		},
-		"markdownBlockQuote": {
-			"dark": "fgMuted",
-			"light": "#6f6f6f"
-		},
-		"markdownEmph": {
-			"dark": "yellowDim",
-			"light": "#8f8f5f"
-		},
-		"markdownStrong": {
-			"dark": "orange",
-			"light": "#8f7f5f"
-		},
-		"markdownHorizontalRule": {
-			"dark": "fgMuted",
-			"light": "#6f6f6f"
-		},
-		"markdownListItem": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"markdownListEnumeration": {
-			"dark": "cyan",
-			"light": "#5f8f8f"
-		},
-		"markdownImage": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"markdownImageText": {
-			"dark": "cyan",
-			"light": "#5f8f8f"
-		},
-		"markdownCodeBlock": {
-			"dark": "fg",
-			"light": "#3f3f3f"
-		},
-		"syntaxComment": {
-			"dark": "#7f9f7f",
-			"light": "#5f7f5f"
-		},
-		"syntaxKeyword": {
-			"dark": "yellow",
-			"light": "#8f8f5f"
-		},
-		"syntaxFunction": {
-			"dark": "blue",
-			"light": "#5f7f8f"
-		},
-		"syntaxVariable": {
-			"dark": "fg",
-			"light": "#3f3f3f"
-		},
-		"syntaxString": {
-			"dark": "red",
-			"light": "#8f5f5f"
-		},
-		"syntaxNumber": {
-			"dark": "greenBright",
-			"light": "#5f8f5f"
-		},
-		"syntaxType": {
-			"dark": "cyan",
-			"light": "#5f8f8f"
-		},
-		"syntaxOperator": {
-			"dark": "yellow",
-			"light": "#8f8f5f"
-		},
-		"syntaxPunctuation": {
-			"dark": "fg",
-			"light": "#3f3f3f"
-		}
-	},
-	"name": "Zenburn",
-	"$schema": "../../../schema/house-theme.schema.json"
-}

package/src/theme/types.ts

@@ -1,115 +0,0 @@
-import type { StyleDefinitionInput } from "@opentui/core"
-
-export type HexColor = `#${string}`
-export type RefName = string
-
-/**
- * A token's value. Either a literal hex (`"#abcdef"`), a reference to an
- * entry in the theme's `defs` block (`"nord8"`), or a `{dark, light}`
- * variant where each side is itself a hex or a defs ref.
- */
-export type ColorValue = HexColor | RefName | { readonly dark: string; readonly light: string }
-
-/** Light or dark mode selector. Each theme JSON pairs both. */
-export type Tone = "dark" | "light"
-
-/**
- * The complete house token surface. Adapted from opencode's TUI theme
- * (see reference/opencode/.../tui/context/theme/) by dropping the `diff*`
- * cluster, `backgroundMenu`, and `thinkingOpacity` (none of which are
- * reachable in a markdown reader).
- */
-export interface ThemeTokens {
-	// UI semantics
-	readonly primary: ColorValue
-	readonly secondary: ColorValue
-	readonly accent: ColorValue
-	readonly error: ColorValue
-	readonly warning: ColorValue
-	readonly success: ColorValue
-	readonly info: ColorValue
-	readonly text: ColorValue
-	readonly textMuted: ColorValue
-	readonly selectedListItemText?: ColorValue
-	readonly background: ColorValue
-	readonly backgroundPanel: ColorValue
-	readonly backgroundElement: ColorValue
-	readonly border: ColorValue
-	readonly borderActive: ColorValue
-	readonly borderSubtle: ColorValue
-	// Markdown rendering
-	readonly markdownText: ColorValue
-	readonly markdownHeading: ColorValue
-	readonly markdownLink: ColorValue
-	readonly markdownLinkText: ColorValue
-	readonly markdownCode: ColorValue
-	readonly markdownBlockQuote: ColorValue
-	readonly markdownEmph: ColorValue
-	readonly markdownStrong: ColorValue
-	readonly markdownHorizontalRule: ColorValue
-	readonly markdownListItem: ColorValue
-	readonly markdownListEnumeration: ColorValue
-	readonly markdownImage: ColorValue
-	readonly markdownImageText: ColorValue
-	readonly markdownCodeBlock: ColorValue
-	// Fenced-code syntax
-	readonly syntaxComment: ColorValue
-	readonly syntaxKeyword: ColorValue
-	readonly syntaxFunction: ColorValue
-	readonly syntaxVariable: ColorValue
-	readonly syntaxString: ColorValue
-	readonly syntaxNumber: ColorValue
-	readonly syntaxType: ColorValue
-	readonly syntaxOperator: ColorValue
-	readonly syntaxPunctuation: ColorValue
-}
-
-/** Raw on-disk shape for a theme JSON file. */
-export interface ThemeJson {
-	readonly $schema?: string
-	readonly name?: string
-	readonly defs?: Record<string, string>
-	readonly theme: Partial<ThemeTokens>
-}
-
-/** Token names that consumers may reference. */
-export type TokenName = keyof ThemeTokens
-
-/**
- * Flat record after `resolveTheme`: every token has a concrete `#rrggbb`
- * value with the requested tone applied and defs refs resolved.
- */
-export type ResolvedTheme = Readonly<Record<TokenName, HexColor>>
-
-/**
- * The flat color object consumed by Browser/HelpOverlay/index. Uses the
- * OpenCode-aligned UI token names directly (`background`, `backgroundPanel`,
- * `backgroundElement`, `borderSubtle`, `primary`, `secondary`, …). Values
- * come from `colors.ts`'s adapter, which maps `ResolvedTheme` → this shape.
- */
-export interface ColorPalette {
-	readonly background: string
-	readonly backgroundPanel: string
-	readonly backgroundElement: string
-	readonly text: string
-	readonly textMuted: string
-	readonly border: string
-	readonly borderActive: string
-	readonly borderSubtle: string
-	readonly selectedListItemText: string
-	readonly primary: string
-	readonly secondary: string
-	readonly accent: string
-	readonly error: string
-	readonly warning: string
-	readonly success: string
-	readonly info: string
-	readonly syntax: Record<string, StyleDefinitionInput>
-}
-
-/** Registry entry for a theme; what the loader returns. */
-export interface ThemeDefinition {
-	readonly id: string
-	readonly name: string
-	readonly source: ThemeJson
-}

package/src/tips.ts

@@ -1,88 +0,0 @@
-import type { BrowserCtx } from "./keymap/browser.ts"
-import type { KeyBinding } from "./keymap/keymap.ts"
-import { displayKey } from "./keymap/displayKey.ts"
-
-export interface TipLine {
-	readonly id: string
-	readonly text: string
-}
-
-interface TipDefinition {
-	readonly id: string
-	readonly bindingId?: string
-	readonly render: (parts: { readonly key: string | null }) => string
-	readonly when?: (ctx: BrowserCtx) => boolean
-}
-
-const tipDefinitions: readonly TipDefinition[] = [
-	{
-		id: "filter.start",
-		bindingId: "filter.open",
-		render: ({ key }) => `Press ${key ?? "/"} to start filtering files by path.`,
-		when: (ctx) => ctx.filterQuery.length === 0 && !ctx.filterOpen,
-	},
-	{
-		id: "filter.resume",
-		bindingId: "filter.open",
-		render: ({ key }) => `Press ${key ?? "/"} to reopen the current filter and keep refining it.`,
-		when: (ctx) => ctx.filterQuery.length > 0 && !ctx.filterOpen,
-	},
-	{
-		id: "filter.commit",
-		bindingId: "filter.open",
-		render: () => "Press Enter in the filter to open the selected match in the reader.",
-		when: (ctx) => ctx.filterQuery.length === 0,
-	},
-	{
-		id: "filter.clear",
-		bindingId: "filter.clearOrOpen",
-		render: ({ key }) => `Press ${key ?? "ctrl+\\"} to clear the current filter and start over.`,
-		when: (ctx) => ctx.filterQuery.length > 0,
-	},
-	{
-		id: "filtered-navigation",
-		render: () => "Use [ and ] to move through files while the current filter stays applied.",
-		when: (ctx) => ctx.filterQuery.length > 0,
-	},
-	{
-		id: "focus.toggle",
-		bindingId: "focus.toggle",
-		render: ({ key }) => `Press ${key ?? "tab"} to switch between the sidebar and reader.`,
-	},
-	{
-		id: "sidebar.toggle",
-		bindingId: "sidebar.toggle",
-		render: ({ key }) =>
-			`Press ${key ?? "s"} to hide or show the sidebar without losing your place.`,
-	},
-]
-
-const firstKeyByBindingId = <C>(bindings: readonly KeyBinding<C>[]): ReadonlyMap<string, string> =>
-	new Map(
-		bindings.flatMap((binding) => {
-			const firstKey = binding.keys[0]
-			return firstKey ? [[binding.id, displayKey(firstKey)] as const] : []
-		}),
-	)
-
-export const buildReaderEmptyStateTips = (
-	bindings: readonly KeyBinding<BrowserCtx>[],
-	ctx: BrowserCtx,
-): readonly TipLine[] => {
-	const keyByBindingId = firstKeyByBindingId(bindings)
-
-	return tipDefinitions
-		.filter((tip) => !tip.when || tip.when(ctx))
-		.map((tip) => ({
-			id: tip.id,
-			text: `Tip: ${tip.render({ key: tip.bindingId ? (keyByBindingId.get(tip.bindingId) ?? null) : null })}`,
-		}))
-}
-
-export const pickTipByRotation = (
-	tips: readonly TipLine[],
-	rotationIndex: number,
-): TipLine | null => {
-	if (tips.length === 0) return null
-	return tips[((rotationIndex % tips.length) + tips.length) % tips.length] ?? null
-}

package/src/ui/middleTruncate.ts

@@ -1,27 +0,0 @@
-/**
- * Middle truncation for technical strings.
- *
- * Keeps the start and end of a string visible while compressing the middle
- * to a single ellipsis glyph (`…`). Use for paths, IDs, branch names, and
- * other values whose head and tail both matter.
- */
-
-export interface MiddleTruncateOptions {
-	readonly ellipsis?: string
-}
-
-export const middleTruncate = (
-	value: string,
-	width: number,
-	options: MiddleTruncateOptions = {},
-): string => {
-	const ellipsis = options.ellipsis ?? "…"
-	if (width <= 0) return ""
-	if (value.length <= width) return value
-	if (width <= ellipsis.length) return value.slice(0, width)
-
-	const available = width - ellipsis.length
-	const left = Math.ceil(available / 2)
-	const right = Math.floor(available / 2)
-	return value.slice(0, left) + ellipsis + value.slice(value.length - right)
-}

package/src/update/cache.ts

@@ -1,77 +0,0 @@
-/**
- * Update-check cache. Stores the last npm-registry probe result on disk so
- * we hit the registry at most once per TTL window.
- *
- * Layout: `$XDG_CACHE_HOME/house/update-check.json` (fallback
- * `~/.cache/house/update-check.json`). All IO failures are non-fatal — a
- * missing or unparseable cache simply forces a fresh probe.
- *
- * Schema is intentionally minimal. `tarballOk` distinguishes "we saw the
- * version and confirmed the tarball is downloadable" from "we saw the
- * version but the CDN HEAD failed" — only the former gates the notice. A
- * `false` entry forces a retry on the next launch rather than waiting out
- * the TTL.
- */
-
-import { dirname, join } from "node:path"
-import { homedir } from "node:os"
-import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises"
-
-export interface UpdateCacheRecord {
-	readonly checkedAt: number
-	readonly latestVersion: string
-	readonly tarballOk: boolean
-}
-
-export const cacheDir = (): string => {
-	const xdg = process.env.XDG_CACHE_HOME
-	if (xdg && xdg.length > 0) return join(xdg, "house")
-	return join(homedir(), ".cache", "house")
-}
-
-export const cachePath = (): string => join(cacheDir(), "update-check.json")
-
-export const readCache = async (path = cachePath()): Promise<UpdateCacheRecord | null> => {
-	try {
-		const raw = await readFile(path, "utf8")
-		const parsed = JSON.parse(raw) as unknown
-		if (typeof parsed !== "object" || parsed === null) return null
-		const r = parsed as Record<string, unknown>
-		if (
-			typeof r.checkedAt !== "number" ||
-			typeof r.latestVersion !== "string" ||
-			typeof r.tarballOk !== "boolean"
-		) {
-			return null
-		}
-		return {
-			checkedAt: r.checkedAt,
-			latestVersion: r.latestVersion,
-			tarballOk: r.tarballOk,
-		}
-	} catch {
-		return null
-	}
-}
-
-export const writeCache = async (record: UpdateCacheRecord, path = cachePath()): Promise<void> => {
-	// Atomic write: writeFile to a sibling tmp path, then rename. Rename is
-	// atomic on POSIX, so a process.exit() racing the writer either leaves
-	// the prior file intact or installs the new one fully — never a partial
-	// JSON blob that readCache would have to ignore.
-	const tmp = `${path}.${process.pid}.${Date.now()}.tmp`
-	try {
-		await mkdir(dirname(path), { recursive: true })
-		await writeFile(tmp, JSON.stringify(record), "utf8")
-		await rename(tmp, path)
-	} catch {
-		// Cache writes are best-effort. A read-only HOME or full disk should
-		// not break the app; we'll just re-probe on the next launch. Clean up
-		// the tmp file if writeFile partially succeeded but rename did not.
-		try {
-			await unlink(tmp)
-		} catch {
-			// best-effort
-		}
-	}
-}