fjall 0.96.0 → 0.99.3

package/bin/assets/src/util/terminalEscapes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared terminal escape sequence constants.
+ *
+ * Used by cli.tsx (process.stdout.write) and ProcessManager.ts (fs.writeSync
+ * for signal-safe teardown). Keeping them in one place prevents drift.
+ */
+export declare const CURSOR_HOME = "\u001B[H";
+export declare const SHOW_CURSOR = "\u001B[?25h";
+export declare const HIDE_CURSOR = "\u001B[?25l";
+export declare const CLEAR_SCREEN = "\u001B[2J";
+export declare const CLEAR_SCROLLBACK = "\u001B[3J";
+export declare const ENTER_ALT_BUFFER = "\u001B[?1049h";
+export declare const EXIT_ALT_BUFFER = "\u001B[?1049l";
+export declare const DISABLE_MOUSE_TRACKING = "\u001B[?1000l\u001B[?1003l";
+export declare const DISABLE_FOCUS_REPORTING = "\u001B[?1004l";
+export declare const DISABLE_BRACKETED_PASTE = "\u001B[?2004l";
+/**
+ * Write text to the system clipboard using the OSC 52 escape sequence.
+ *
+ * Supported by iTerm2, kitty, WezTerm, foot, and most modern terminals.
+ * Silently ignored by terminals that don't support it — safe to call
+ * unconditionally. The text is base64-encoded as required by the spec.
+ *
+ * @param text - The string to copy to the clipboard.
+ * @param stream - The writable stream to emit the escape on. Defaults to process.stdout.
+ */
+export declare function writeToClipboard(text: string, stream?: {
+    write: (data: string) => boolean;
+}): void;

package/bin/assets/src/util/terminalEscapes.js

@@ -0,0 +1 @@
+const E="\x1B[H",e="\x1B[?25h",r="\x1B[?25l",R="\x1B[2J",b="\x1B[3J",c="\x1B[?1049h",n="\x1B[?1049l",s="\x1B[?1000l\x1B[?1003l",_="\x1B[?1004l",p="\x1B[?2004l";function S(o,t=process.stdout){const x=Buffer.from(o,"utf-8").toString("base64");t.write(`\x1B]52;c;${x}\x1B\\`)}export{R as CLEAR_SCREEN,b as CLEAR_SCROLLBACK,E as CURSOR_HOME,p as DISABLE_BRACKETED_PASTE,_ as DISABLE_FOCUS_REPORTING,s as DISABLE_MOUSE_TRACKING,c as ENTER_ALT_BUFFER,n as EXIT_ALT_BUFFER,r as HIDE_CURSOR,e as SHOW_CURSOR,S as writeToClipboard};

package/bin/assets/src/util/terminalFocus.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Terminal focus detection.
+ *
+ * Detects whether the CLI process is foregrounded or backgrounded using
+ * POSIX signals (SIGTSTP/SIGCONT) instead of DEC private mode 1004 focus
+ * reporting. DECSET 1004 injects escape sequences (\x1b[I / \x1b[O) into
+ * stdin which leak into Ink's input parser as visible `[O[I` characters —
+ * signals avoid this entirely.
+ *
+ * Used to throttle animations when the process is suspended, reducing CPU
+ * usage during long-running operations like deployments.
+ */
+type FocusChangeHandler = (focused: boolean) => void;
+/**
+ * Enable process focus detection via POSIX signals.
+ * Call once at UI startup; pair with disableFocusReporting() on cleanup.
+ */
+export declare function enableFocusReporting(): void;
+/**
+ * Disable focus detection.
+ * Safe to call even if not enabled.
+ */
+export declare function disableFocusReporting(): void;
+/**
+ * Subscribe to focus change events.
+ * @returns Unsubscribe function.
+ */
+export declare function onFocusChange(handler: FocusChangeHandler): () => void;
+/** Whether the terminal currently has focus */
+export declare function isTerminalFocused(): boolean;
+/** Reset state for test isolation */
+export declare function _resetFocusReporting(): void;
+export {};

package/bin/assets/src/util/terminalFocus.js

@@ -0,0 +1 @@
+import{logger as u}from"./logger/index.js";let s=!1,e=!0,o=[],t,n;function l(){s||(s=!0,e=!0,t=()=>{if(!e){e=!0;for(const r of o)r(!0)}},n=()=>{if(e){e=!1;for(const r of o)r(!1)}process.once("SIGTSTP",()=>{process.kill(process.pid,"SIGTSTP")})},process.on("SIGTSTP",n),process.on("SIGCONT",t),u.debug("Terminal","Focus detection enabled (POSIX signals)"))}function c(){s&&(s=!1,e=!0,t&&(process.removeListener("SIGCONT",t),t=void 0),n&&(process.removeListener("SIGTSTP",n),n=void 0),o=[])}function p(r){return o.push(r),()=>{o=o.filter(i=>i!==r)}}function a(){return e}function d(){c(),e=!0}export{d as _resetFocusReporting,c as disableFocusReporting,l as enableFocusReporting,a as isTerminalFocused,p as onFocusChange};

package/bin/assets/src/util/theme.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Fjall CLI Theme Configuration
+ * Minimal, professional design
+ *
+ * Shared by commands and UI layers. Placed in util/ to avoid
+ * commands → ui layer dependency.
+ *
+ * Supports standard and daltonised colour palettes for accessibility.
+ * Active palette is selected via FJALL_PALETTE env var or --daltonised flag.
+ */
+/** Hex colour string — compile-time validated format */
+type HexColour = `#${string}`;
+/** RGB colour string */
+type RGBColour = `rgb(${number},${number},${number})`;
+/** ANSI 256-colour reference */
+type Ansi256Colour = `ansi256(${number})`;
+/** Named ANSI colour */
+type AnsiColour = "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright";
+/** Union of all supported colour formats */
+export type Colour = HexColour | RGBColour | Ansi256Colour | AnsiColour;
+/** Palette name type */
+export type PaletteName = "standard" | "daltonised";
+interface ColourPalette {
+    primary: Colour;
+    fjallPink: Colour;
+    iconBrown: Colour;
+    summitBlush: Colour;
+    secondary: Colour;
+    completed: Colour;
+    success: Colour;
+    warning: Colour;
+    error: Colour;
+    info: Colour;
+    muted: Colour;
+    white: Colour;
+    black: Colour;
+    dim: Colour;
+    border: Colour;
+    deployYellow: Colour;
+    deployGreen: Colour;
+    deployText: Colour;
+}
+/** Get the currently active palette name */
+export declare function getActivePalette(): PaletteName;
+/**
+ * Set the active colour palette at runtime.
+ * Called when --daltonised flag is provided.
+ */
+export declare function setActivePalette(palette: PaletteName): void;
+/**
+ * The theme object.
+ *
+ * `colours` is a Proxy that resolves to the active palette at access time,
+ * so all 50+ files that read `theme.colours.error` automatically get the
+ * correct colour for the active palette without any code changes.
+ */
+export declare const theme: Readonly<{
+    readonly colours: Readonly<ColourPalette>;
+    readonly text: {
+        readonly prompt: (text: string) => string;
+        readonly hint: (text: string) => string;
+        readonly error: (text: string) => string;
+        readonly success: (text: string) => string;
+        readonly warning: (text: string) => string;
+    };
+    readonly icons: {
+        readonly selected: "→";
+        readonly unselected: " ";
+        readonly spinner: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    };
+    readonly spacing: {
+        readonly small: 1;
+        readonly medium: 2;
+        readonly large: 3;
+    };
+}>;
+export type Theme = typeof theme;
+/** Reset palette to standard for test isolation */
+export declare function _resetPalette(): void;
+export {};

package/bin/assets/src/util/theme.js

@@ -0,0 +1 @@
+const n={primary:"#0A9396",fjallPink:"#FF7BFF",iconBrown:"#78290F",summitBlush:"#FFECD1",secondary:"#47817E",completed:"#90a955",success:"#A4C2A5",warning:"#FFA500",error:"#AE2012",info:"#0A9396",muted:"#808080",white:"#E8E8EA",black:"#000000",dim:"#666666",border:"#FF7D00",deployYellow:"#F2CC8F",deployGreen:"#81B29A",deployText:"#F4F1DE"},o={primary:"#0A9396",fjallPink:"#CC79A7",iconBrown:"#78290F",summitBlush:"#FFECD1",secondary:"#47817E",completed:"#0072B2",success:"#56B4E9",warning:"#E69F00",error:"#D55E00",info:"#0A9396",muted:"#808080",white:"#E8E8EA",black:"#000000",dim:"#666666",border:"#E69F00",deployYellow:"#E69F00",deployGreen:"#56B4E9",deployText:"#F4F1DE"},a={standard:n,daltonised:o};let t="standard";function l(){return process.env.FJALL_PALETTE==="daltonised"?"daltonised":"standard"}t=l();function d(){return t}function c(e){t=e}const i=Object.freeze({colours:new Proxy(n,{get(e,r){return a[t][r]}}),text:{prompt:e=>e,hint:e=>e,error:e=>`Error: ${e}`,success:e=>e,warning:e=>`Warning: ${e}`},icons:{selected:"\u2192",unselected:" ",spinner:["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"]},spacing:{small:1,medium:2,large:3}});function F(){t="standard"}export{F as _resetPalette,d as getActivePalette,c as setActivePalette,i as theme};

package/bin/assets/src/util/truncateMiddle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Truncate text in the middle, preserving the prefix and suffix with an
+ * ellipsis in between. Useful for long resource names like
+ * `my-app-prod-DatabaseInstance-ABCD1234EFGH` → `my-app-prod...D1234EFGH`.
+ *
+ * ANSI escape codes are stripped before measuring width but the raw input
+ * is sliced, so colours are preserved in the non-truncated portions.
+ */
+export declare function truncateMiddle(text: string, maxWidth: number, ellipsis?: string): string;

package/bin/assets/src/util/truncateMiddle.js

@@ -0,0 +1 @@
+import{stripAnsi as i}from"./stripAnsi.js";function u(n,r,e="\u2026"){const c=i(n);if(c.length<=r)return n;if(r<=e.length)return e.slice(0,r);const t=r-e.length,o=Math.ceil(t/2),f=Math.floor(t/2);return c.length!==n.length?c.slice(0,o)+e+c.slice(-f||void 0):n.slice(0,o)+e+n.slice(-f||void 0)}export{u as truncateMiddle};

package/bin/assets/src/util/typeGuards.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared type guard utilities.
+ */
+/** Check if value is a plain object with string values */
+export declare function isStringRecord(value: unknown): value is Record<string, string>;

package/bin/assets/src/util/typeGuards.js

@@ -0,0 +1 @@
+function e(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)&&Object.values(r).every(t=>typeof t=="string")}export{e as isStringRecord};

package/bin/assets/src/util/uiRouter.d.ts

@@ -0,0 +1,13 @@
+import { type NonInteractiveOptions } from "./executionMode.js";
+import type { Screen } from "../ui/App.js";
+export interface UIRouteResult {
+    handled: boolean;
+}
+/**
+ * Routes to interactive UI if conditions allow, otherwise returns control to CLI handler.
+ */
+export declare function routeToUIIfInteractive(options: NonInteractiveOptions, screenName: Screen, screenOptions: Record<string, unknown>): Promise<UIRouteResult>;
+/**
+ * Simplified version that checks extended non-interactive conditions.
+ */
+export declare function routeToUIIfInteractiveExtended(options: NonInteractiveOptions, additionalConditions: boolean[], screenName: Screen, screenOptions: Record<string, unknown>): Promise<UIRouteResult>;

package/bin/assets/src/util/uiRouter.js

@@ -0,0 +1 @@
+import{isNonInteractiveMode as i}from"./executionMode.js";import{getErrorMessage as f}from"./errorUtils.js";import{handleUIResult as m,handleCommandError as a,SilentExitError as u}from"./commandResult.js";import{logger as d}from"./logger/index.js";import{maskSensitiveOutput as l}from"@fjall/util";async function s(e,t){const{startUI:o}=await import("../ui/cli.js");try{const r=await o({screen:e,options:t});return m(r),{handled:!0}}catch(r){r instanceof u&&a(r);const n=l(f(r));n&&n!=="User force closed the prompt"&&d.error("UI",n),a(r)}}async function g(e,t,o){return i(e)?{handled:!1}:s(t,o)}async function E(e,t,o,r){return i(e)||t.some(c=>c)?{handled:!1}:s(o,r)}export{g as routeToUIIfInteractive,E as routeToUIIfInteractiveExtended};

package/bin/assets/src/util/urlHelpers.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Strips the protocol (http:// or https://) from a URL, returning just the host and path.
+ */
+export declare function removeProtocol(url: string): string;

package/bin/assets/src/util/urlHelpers.js

@@ -0,0 +1 @@
+function o(e){return e.replace(/^https?:\/\//,"")}export{o as removeProtocol};

package/bin/assets/src/util/versionDisplay.d.ts

@@ -0,0 +1,5 @@
+import type { InstallSource } from "../services/deployment/ReportVersionService.js";
+/**
+ * Returns the appropriate upgrade command hint based on how the CLI was installed.
+ */
+export declare function upgradeHint(installSource?: InstallSource): string;

package/bin/assets/src/util/versionDisplay.js

@@ -0,0 +1 @@
+function t(e){return e==="homebrew"?"Run `brew upgrade fjall` to update":"Run `npm update -g @fjall/cli` to update"}export{t as upgradeHint};