@ashlr/hub 2.2.0

package/dist/cli/ui.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared CLI presentation helpers — ANSI palette, TTY-gated colorizers, and
+ * fixed-width padding. Extracted from the per-command CLI modules where the
+ * exact same blocks were duplicated verbatim.
+ *
+ * Behavior is identical to the inlined versions:
+ *   - colorize() returns the input unchanged when the relevant stream is not a
+ *     TTY (callers pass the stdout- or stderr-bound flag).
+ *   - stripAnsi() strips SGR escape codes for visible-width measurement.
+ *   - pad() pads to a visible width, left- (default) or right-aligned.
+ */
+/** Canonical ANSI palette (superset of every per-command color set). */
+export declare const C: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly cyan: "\u001B[36m";
+    readonly magenta: "\u001B[35m";
+    readonly gray: "\u001B[90m";
+};
+/** True when stdout is a TTY. */
+export declare function isTty(): boolean;
+/** True when stderr is a TTY. */
+export declare function isStderrTty(): boolean;
+/** Strip ANSI SGR escape codes (for measuring visible display width). */
+export declare function stripAnsi(s: string): string;
+/**
+ * Pad a possibly-ANSI-colored string to a visible width.
+ * Default alignment is 'left' (append spaces); 'right' prepends them.
+ */
+export declare function pad(s: string, width: number, align?: 'left' | 'right'): string;
+/** A bound set of colorizers gated on a single (stdout- or stderr-) TTY flag. */
+export interface Colors {
+    colorize: (code: string, s: string) => string;
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    cyan: (s: string) => string;
+    magenta: (s: string) => string;
+    gray: (s: string) => string;
+}
+/**
+ * Build a colorizer set bound to a TTY flag. When `tty` is false every helper
+ * returns its input unchanged — identical to the inlined per-file behavior.
+ */
+export declare function makeColors(tty: boolean): Colors;

package/dist/cli/ui.js

@@ -0,0 +1,66 @@
+/**
+ * Shared CLI presentation helpers — ANSI palette, TTY-gated colorizers, and
+ * fixed-width padding. Extracted from the per-command CLI modules where the
+ * exact same blocks were duplicated verbatim.
+ *
+ * Behavior is identical to the inlined versions:
+ *   - colorize() returns the input unchanged when the relevant stream is not a
+ *     TTY (callers pass the stdout- or stderr-bound flag).
+ *   - stripAnsi() strips SGR escape codes for visible-width measurement.
+ *   - pad() pads to a visible width, left- (default) or right-aligned.
+ */
+/** Canonical ANSI palette (superset of every per-command color set). */
+export const C = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
+    gray: '\x1b[90m',
+};
+/** True when stdout is a TTY. */
+export function isTty() {
+    return process.stdout.isTTY === true;
+}
+/** True when stderr is a TTY. */
+export function isStderrTty() {
+    return process.stderr.isTTY === true;
+}
+/** Strip ANSI SGR escape codes (for measuring visible display width). */
+export function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Pad a possibly-ANSI-colored string to a visible width.
+ * Default alignment is 'left' (append spaces); 'right' prepends them.
+ */
+export function pad(s, width, align = 'left') {
+    const vis = stripAnsi(s).length;
+    const spaces = Math.max(0, width - vis);
+    return align === 'left' ? s + ' '.repeat(spaces) : ' '.repeat(spaces) + s;
+}
+/**
+ * Build a colorizer set bound to a TTY flag. When `tty` is false every helper
+ * returns its input unchanged — identical to the inlined per-file behavior.
+ */
+export function makeColors(tty) {
+    const colorize = (code, s) => (tty ? `${code}${s}${C.reset}` : s);
+    return {
+        colorize,
+        bold: (s) => colorize(C.bold, s),
+        dim: (s) => colorize(C.dim, s),
+        red: (s) => colorize(C.red, s),
+        green: (s) => colorize(C.green, s),
+        yellow: (s) => colorize(C.yellow, s),
+        blue: (s) => colorize(C.blue, s),
+        cyan: (s) => colorize(C.cyan, s),
+        magenta: (s) => colorize(C.magenta, s),
+        gray: (s) => colorize(C.gray, s),
+    };
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,CAAC,GAAG;IACf,KAAK,EAAI,SAAS;IAClB,IAAI,EAAK,SAAS;IAClB,GAAG,EAAM,SAAS;IAClB,GAAG,EAAM,UAAU;IACnB,KAAK,EAAI,UAAU;IACnB,MAAM,EAAG,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAK,UAAU;CACX,CAAC;AAEX,iCAAiC;AACjC,MAAM,UAAU,KAAK;IACnB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,4CAA4C;IAC5C,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,KAAa,EAAE,QAA0B,MAAM;IAC5E,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC;IACxC,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5E,CAAC;AAgBD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,OAAO;QACL,QAAQ;QACR,IAAI,EAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAK,CAAC,CAAC;QACtC,GAAG,EAAM,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAM,CAAC,CAAC;QACtC,GAAG,EAAM,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAM,CAAC,CAAC;QACtC,KAAK,EAAI,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAI,CAAC,CAAC;QACtC,MAAM,EAAG,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAG,CAAC,CAAC;QACtC,IAAI,EAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAK,CAAC,CAAC;QACtC,IAAI,EAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAK,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,IAAI,EAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAK,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/cli/update.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `ashlr update` — safe self-update for ashlr-hub.
+ *
+ * Usage:
+ *   ashlr update [--check] [--json]
+ *
+ * Flags:
+ *   --check   Report whether an update is available (git fetch + compare) without applying.
+ *   --json    Emit UpdateResult JSON on stdout; human text goes to stderr.
+ *
+ * Behaviour:
+ *   1. Detect the repo root from this file's location (import.meta.url).
+ *   2. If no git remote is configured, report "no remote configured — update is a no-op" (exit 0).
+ *   3. Abort on a dirty working tree — tell the user to commit first (exit 1).
+ *   4. --check: git fetch + compare HEAD..origin/<branch>; exit 0 if up-to-date, exit 0 if
+ *      updates are available (it's informational only; never modifies anything).
+ *   5. Normal update: git pull --ff-only, npm install, npm run build, then verify
+ *      `ashlr --version` / `ashlr help` works and the ~/.local/bin symlink points here.
+ *   6. Print a clear before/after version line.
+ *
+ * Safety guarantees:
+ *   - NEVER force-push, reset, rebase, or do any other destructive git operation.
+ *   - NEVER pushes to the remote.
+ *   - Aborts immediately on dirty working tree.
+ *   - Only uses git pull --ff-only (fails if the remote diverged; user must resolve).
+ *
+ * Exit codes:
+ *   0  success (or up-to-date / no-remote)
+ *   1  update failed, dirty tree, or other error
+ *   2  bad usage
+ */
+/**
+ * 'npm' when the compiled module runs from inside a node_modules install
+ * (global or local `npm install @ashlr/hub`); 'git' for a repo checkout.
+ * Exported for tests.
+ */
+export declare function detectChannel(moduleUrl?: string): 'git' | 'npm';
+export declare function cmdUpdate(args: string[]): Promise<number>;