termcut 0.2.2 → 0.3.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). */