termcut 0.2.2 → 0.4.0

package/src/themes.ts

@@ -1,6 +1,11 @@
+import generatedJson from "./themes.generated.json";
 import type { Theme, ThemeName } from "./types";
 
-export const themes: Record<ThemeName, Theme> = {
+/**
+ * Hand-maintained themes. These stay byte-stable across releases (demos rendered with them must not drift),
+ * and take precedence over the generated bundle when names collide.
+ */
+export const builtinThemes = {
   "catppuccin-mocha": {
     name: "catppuccin-mocha",
     background: "#1e1e2e",
@@ -121,16 +126,40 @@ export const themes: Record<ThemeName, Theme> = {
     brightCyan: "#56b6c2",
     brightWhite: "#ffffff",
   },
-};
+} satisfies Record<string, Theme>;
 
-export const themeNames = Object.keys(themes) as ThemeName[];
+export type BuiltinThemeName = keyof typeof builtinThemes;
+
+/** The Ghostty theme collection (mbadolato/iTerm2-Color-Schemes, MIT), generated by scripts/build-themes.ts. */
+const generated = generatedJson as Record<string, Theme>;
+
+/** All themes by slug: the generated bundle, with the built-ins overriding colliding names. */
+export const themes: Record<string, Theme> = { ...generated, ...builtinThemes };
+
+export const themeNames: string[] = Object.keys(themes).sort();
+
+/** "Catppuccin Mocha" → "catppuccin-mocha" (also accepts slugs, spaces, underscores, any case). */
+export function themeSlug(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+export function findThemes(query: string): string[] {
+  const q = themeSlug(query);
+  return themeNames.filter((n) => n.includes(q));
+}
 
 export function resolveTheme(theme: ThemeName | Theme | undefined): Theme {
-  if (!theme) return themes["catppuccin-mocha"];
+  if (!theme) return builtinThemes["catppuccin-mocha"];
   if (typeof theme === "string") {
-    const found = themes[theme];
+    const found = themes[themeSlug(theme)];
     if (!found) {
-      throw new Error(`Unknown theme "${theme}". Available: ${themeNames.join(", ")}`);
+      const near = findThemes(theme.split(/[\s-]+/)[0] ?? theme).slice(0, 5);
+      throw new Error(
+        `Unknown theme "${theme}". ${near.length ? `Did you mean: ${near.join(", ")}?` : ""} Run \`tcut themes [query]\` to list all ${themeNames.length}.`.trim(),
+      );
     }
     return found;
   }

package/src/types.ts

@@ -23,12 +23,11 @@ export interface Theme {
   brightWhite: string;
 }
 
-export type ThemeName =
-  | "catppuccin-mocha"
-  | "dracula"
-  | "github-dark"
-  | "tokyo-night"
-  | "one-dark";
+/**
+ * A theme name: one of the built-ins (autocompleted) or any of the ~600 Ghostty themes, matched case- and
+ * punctuation-insensitively ("Catppuccin Mocha", "catppuccin-mocha", "GitHub Dark" …). `tcut themes` lists them.
+ */
+export type ThemeName = "catppuccin-mocha" | "dracula" | "github-dark" | "tokyo-night" | "one-dark" | (string & {});
 
 export type ShellName = "bash" | "zsh" | "fish" | "sh";
 /** Terminal emulator core: libghostty (full VT, answers queries) or wterm's lite Zig core (faster, fewer features). */
@@ -74,9 +73,17 @@ export interface VideoConfig {
   cwd?: string;
   env?: Record<string, string>;
 
-  /** Terminal grid. Default 80 × 24. */
+  /** Terminal grid. Default 80 × 24 — or derived from `width`/`height` when those are given. */
   cols?: number;
   rows?: number;
+  /**
+   * Video size in pixels (including margin). When set, the output is exactly this size and the terminal is
+   * centred inside; `cols`/`rows` default to what fits.
+   */
+  width?: number;
+  height?: number;
+  /** Where looping outputs (GIF, WebP) start: a frame number or a percentage like "50%". */
+  loopOffset?: number | string;
 
   /** Frames per second of the output. Default 60. */
   fps?: number;
@@ -126,6 +133,9 @@ export interface ResolvedConfig {
   env: Record<string, string>;
   cols: number;
   rows: number;
+  width?: number;
+  height?: number;
+  loopOffset?: number | string;
   fps: number;
   typingSpeed: number;
   typingJitter: number;
@@ -210,6 +220,11 @@ export interface TerminalSession {
   ctrl(letter: string, times?: number): Promise<void>;
   /** Alt/Meta+<key>. */
   alt(key: string, times?: number): Promise<void>;
+  /** Shift+<key>: "tab" (back-tab), arrows/home/end/pageUp/pageDown/delete, or a letter (sent uppercase). */
+  shift(key: KeyName | string, times?: number): Promise<void>;
+  /** Mouse-wheel up/down at the cursor. Only programs with mouse tracking (vim, less --mouse, TUIs) react. */
+  scrollUp(times?: number): Promise<void>;
+  scrollDown(times?: number): Promise<void>;
   /** Send raw bytes to the PTY. */
   raw(data: string | Uint8Array): Promise<void>;