@theme-registry/refract 0.1.4 → 0.1.5

package/dist/build/prompt.d.ts

@@ -9,7 +9,22 @@ export interface Choice<T> {
     readonly label: string;
     /** Trailing grey note — what this option means. */
     readonly hint?: string;
+    /**
+     * Hex colours to draw as blocks beside the label.
+     *
+     * This is a theme scaffolder: "triadic" and "split-complement" mean nothing as words, and the
+     * terminal can simply show the hues. Ignored when the terminal can't do 24-bit colour.
+     */
+    readonly swatches?: readonly string[];
 }
+/**
+ * `#rrggbb` → a coloured block: exact in 24-bit terminals, approximated in 256-colour ones, and
+ * empty when there's no colour at all (a pipe, `NO_COLOR`) so redirected output stays clean.
+ *
+ * Approximating is right here — the swatch is a preview, and the exact value is written to the theme
+ * file regardless. An approximately-right hue beats a blank space.
+ */
+export declare function swatch(hex: string, width?: number): string;
 /** The keys a list prompt understands, after decoding an stdin chunk. */
 export type ListKey = "up" | "down" | "space" | "submit" | "all" | "cancel" | "none";
 /** Decode a raw stdin chunk into a {@link ListKey}. Arrows arrive as escape sequences; j/k mirror vim. */