@seedcli/ui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seed CLI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/countdown.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Display a countdown timer, updating in-place.
+ * Returns a promise that resolves when the countdown reaches zero.
+ */
+export declare function countdown(seconds: number, label?: string): Promise<void>;
+//# sourceMappingURL=countdown.d.ts.map

package/dist/countdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.d.ts","sourceRoot":"","sources":["../src/countdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxE"}

package/dist/countdown.js

@@ -0,0 +1,24 @@
+/**
+ * Display a countdown timer, updating in-place.
+ * Returns a promise that resolves when the countdown reaches zero.
+ */
+export function countdown(seconds, label) {
+    return new Promise((resolve) => {
+        let remaining = seconds;
+        const render = () => {
+            const text = label ? `${label} ${remaining}s` : `${remaining}s`;
+            process.stdout.write(`\r${text}  `);
+        };
+        render();
+        const interval = setInterval(() => {
+            remaining--;
+            render();
+            if (remaining <= 0) {
+                clearInterval(interval);
+                process.stdout.write(`\r${" ".repeat((label?.length ?? 0) + 10)}\r`);
+                resolve();
+            }
+        }, 1000);
+    });
+}
+//# sourceMappingURL=countdown.js.map

package/dist/countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.js","sourceRoot":"","sources":["../src/countdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAc;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,SAAS,GAAG,OAAO,CAAC;QAExB,MAAM,MAAM,GAAG,GAAG,EAAE;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC;YAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QAET,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YAET,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACpB,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrE,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC,EAAE,IAAI,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/header.d.ts

@@ -0,0 +1,8 @@
+import type { HeaderOptions } from "./types.js";
+/**
+ * Render an ASCII art header inside a bordered box.
+ *
+ * Composes `figlet()` + `box()` from `@seedcli/print`.
+ */
+export declare function header(title: string, options?: HeaderOptions): string;
+//# sourceMappingURL=header.d.ts.map

package/dist/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../src/header.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAoBrE"}

package/dist/header.js

@@ -0,0 +1,24 @@
+import { ascii, box, colors } from "@seedcli/print";
+/**
+ * Render an ASCII art header inside a bordered box.
+ *
+ * Composes `figlet()` + `box()` from `@seedcli/print`.
+ */
+export function header(title, options) {
+    const color = options?.color
+        ? colors[options.color]
+        : undefined;
+    let content = ascii(title);
+    if (options?.subtitle) {
+        content += `\n${options.subtitle}`;
+    }
+    if (color) {
+        content = color(content);
+    }
+    return box(content, {
+        padding: 1,
+        borderStyle: "round",
+        borderColor: options?.color,
+    });
+}
+//# sourceMappingURL=header.js.map

package/dist/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../src/header.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,OAAuB;IAC5D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK;QAC3B,CAAC,CAAE,MAA2D,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7E,CAAC,CAAC,SAAS,CAAC;IAEb,IAAI,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3B,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACvB,OAAO,IAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,EAAE;QACnB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,OAAO,EAAE,KAAK;KAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { DividerOptions, KeyValueOptions, KeyValuePair, ProgressBar, ProgressBarOptions, TreeNode, TreeOptions, } from "@seedcli/print";
+export { divider, keyValue, progressBar as progress, tree } from "@seedcli/print";
+export { countdown } from "./countdown.js";
+export { header } from "./header.js";
+export { list } from "./list.js";
+export { status } from "./status.js";
+export type { HeaderOptions, ListOptions, StatusState } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,WAAW,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,IAAI,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Higher-level UI components
+// Re-exports from @seedcli/print
+export { divider, keyValue, progressBar as progress, tree } from "@seedcli/print";
+export { countdown } from "./countdown.js";
+export { header } from "./header.js";
+export { list } from "./list.js";
+export { status } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAW7B,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,IAAI,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/list.d.ts

@@ -0,0 +1,6 @@
+import type { ListOptions } from "./types.js";
+/**
+ * Render a formatted list with configurable markers.
+ */
+export declare function list(items: string[], options?: ListOptions): string;
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C;;GAEG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CASnE"}

package/dist/list.js

@@ -0,0 +1,19 @@
+const MARKERS = {
+    bullet: "•",
+    arrow: "→",
+    dash: "–",
+    number: "",
+};
+/**
+ * Render a formatted list with configurable markers.
+ */
+export function list(items, options) {
+    const marker = options?.marker ?? (options?.ordered ? "number" : "bullet");
+    return items
+        .map((item, i) => {
+        const prefix = marker === "number" ? `${i + 1}.` : MARKERS[marker];
+        return `  ${prefix} ${item}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG;IACf,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,EAAE;CACD,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,KAAe,EAAE,OAAqB;IAC1D,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE3E,OAAO,KAAK;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC;IAC9B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/status.d.ts

@@ -0,0 +1,6 @@
+import type { StatusState } from "./types.js";
+/**
+ * Render a status line with an icon and color based on state.
+ */
+export declare function status(label: string, state: StatusState): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAGhE"}

package/dist/status.js

@@ -0,0 +1,15 @@
+import { colors } from "@seedcli/print";
+const STATUS_CONFIG = {
+    success: { icon: "✔", color: colors.green },
+    fail: { icon: "✖", color: colors.red },
+    skip: { icon: "◌", color: colors.gray },
+    pending: { icon: "…", color: colors.yellow },
+};
+/**
+ * Render a status line with an icon and color based on state.
+ */
+export function status(label, state) {
+    const { icon, color } = STATUS_CONFIG[state];
+    return color(`${icon} ${label}`);
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,aAAa,GAAwE;IAC1F,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;IAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE;IACtC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,KAAkB;IACvD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AAClC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export interface HeaderOptions {
+    subtitle?: string;
+    color?: string;
+}
+export interface ListOptions {
+    ordered?: boolean;
+    marker?: "bullet" | "arrow" | "dash" | "number";
+}
+export type StatusState = "success" | "fail" | "skip" | "pending";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;CAChD;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "@seedcli/ui",
+	"version": "0.1.0",
+	"description": "Terminal UI components: header, status indicators, list formatting",
+	"type": "module",
+	"license": "MIT",
+	"author": "Rully Ardiansyah <rully@dreamshive.io>",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/SeedCLI/seed",
+		"directory": "packages/ui"
+	},
+	"homepage": "https://seedcli.dev",
+	"keywords": [
+		"cli",
+		"ui",
+		"terminal",
+		"header",
+		"status",
+		"list"
+	],
+	"engines": {
+		"bun": ">=1.3.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"LICENSE"
+	],
+	"dependencies": {
+		"@seedcli/print": "^0.1.0"
+	}
+}