@raintree-technology/perps 0.1.0

package/dist/cli/ink/app/ascii.js

@@ -0,0 +1,46 @@
+const DEFAULT_SPARK_CHARS = " .:-=+*#%@";
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export function toSparkline(values, width = values.length, chars = DEFAULT_SPARK_CHARS) {
+    const points = values.filter((value) => Number.isFinite(value));
+    if (points.length === 0)
+        return "(no data)";
+    if (width <= 0)
+        return "";
+    if (chars.length < 2) {
+        throw new Error("Sparkline character set must contain at least 2 chars");
+    }
+    const sampled = points.length <= width
+        ? points
+        : width === 1
+            ? [points[points.length - 1]]
+            : Array.from({ length: width }, (_, index) => {
+                const sourceIndex = Math.round((index * (points.length - 1)) / (width - 1));
+                return points[sourceIndex];
+            });
+    const min = Math.min(...sampled);
+    const max = Math.max(...sampled);
+    const span = max - min;
+    if (span === 0) {
+        return chars[Math.floor(chars.length / 2)].repeat(sampled.length);
+    }
+    return sampled
+        .map((point) => {
+        const normalized = (point - min) / span;
+        const charIndex = clamp(Math.round(normalized * (chars.length - 1)), 0, chars.length - 1);
+        return chars[charIndex];
+    })
+        .join("");
+}
+export function toBar(value, max, width = 20, fillChar = "#", emptyChar = ".") {
+    if (width <= 0)
+        return "";
+    if (fillChar.length === 0 || emptyChar.length === 0) {
+        throw new Error("Bar characters must be non-empty");
+    }
+    const safeMax = max <= 0 ? 1 : max;
+    const ratio = clamp(value / safeMax, 0, 1);
+    const filled = Math.round(ratio * width);
+    return fillChar.repeat(filled) + emptyChar.repeat(width - filled);
+}

package/dist/cli/ink/app/index.d.ts

@@ -0,0 +1,5 @@
+export { AppShell, type AppShellProps, getToneTextColor } from "./AppShell.js";
+export { Panel, type PanelProps } from "./Panel.js";
+export { MetricStrip, type MetricStripProps } from "./MetricStrip.js";
+export { toSparkline, toBar } from "./ascii.js";
+export type { Tone, StatusChip, ShortcutHint, Metric } from "./types.js";

package/dist/cli/ink/app/index.js

@@ -0,0 +1,4 @@
+export { AppShell, getToneTextColor } from "./AppShell.js";
+export { Panel } from "./Panel.js";
+export { MetricStrip } from "./MetricStrip.js";
+export { toSparkline, toBar } from "./ascii.js";

package/dist/cli/ink/app/types.d.ts

@@ -0,0 +1,15 @@
+export type Tone = "neutral" | "info" | "success" | "warning" | "danger";
+export interface StatusChip {
+    label: string;
+    tone?: Tone;
+}
+export interface ShortcutHint {
+    key: string;
+    label: string;
+}
+export interface Metric {
+    label: string;
+    value: string;
+    tone?: Tone;
+    delta?: string;
+}

package/dist/cli/ink/app/types.js

@@ -0,0 +1 @@
+export {};

package/dist/cli/ink/components/PnL.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export interface PnLProps {
+    value: number | string;
+    showSign?: boolean;
+    decimals?: number;
+}
+export declare function PnL({ value, showSign, decimals }: PnLProps): React.ReactElement;
+export interface PnLPercentProps {
+    value: number | string;
+    decimals?: number;
+}
+export declare function PnLPercent({ value, decimals }: PnLPercentProps): React.ReactElement;

package/dist/cli/ink/components/PnL.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from "ink";
+import { getPnLColor } from "../theme.js";
+export function PnL({ value, showSign = true, decimals = 2 }) {
+    const numValue = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(numValue)) {
+        return _jsx(Text, { color: "gray", children: "-" });
+    }
+    const color = getPnLColor(numValue);
+    const sign = showSign && numValue > 0 ? "+" : "";
+    const formatted = `${sign}${numValue.toFixed(decimals)}`;
+    return _jsx(Text, { color: color, children: formatted });
+}
+export function PnLPercent({ value, decimals = 2 }) {
+    const numValue = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(numValue)) {
+        return _jsx(Text, { color: "gray", children: "-" });
+    }
+    const color = getPnLColor(numValue);
+    const sign = numValue > 0 ? "+" : "";
+    const formatted = `${sign}${numValue.toFixed(decimals)}%`;
+    return _jsx(Text, { color: color, children: formatted });
+}

package/dist/cli/ink/components/Spinner.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+export interface SpinnerProps {
+    label?: string;
+}
+export declare function Spinner({ label }: SpinnerProps): React.ReactElement;
+export interface ErrorDisplayProps {
+    message: string;
+}
+export declare function ErrorDisplay({ message }: ErrorDisplayProps): React.ReactElement;
+export interface SuccessDisplayProps {
+    message: string;
+}
+export declare function SuccessDisplay({ message }: SuccessDisplayProps): React.ReactElement;

package/dist/cli/ink/components/Spinner.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import InkSpinner from "ink-spinner";
+import { colors } from "../theme.js";
+export function Spinner({ label = "Loading..." }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { color: colors.info, children: _jsx(InkSpinner, { type: "dots" }) }), _jsxs(Text, { children: [" ", label] })] }));
+}
+export function ErrorDisplay({ message }) {
+    return (_jsx(Box, { children: _jsxs(Text, { color: colors.loss, children: ["Error: ", message] }) }));
+}
+export function SuccessDisplay({ message }) {
+    return (_jsx(Box, { children: _jsx(Text, { color: colors.profit, children: message }) }));
+}

package/dist/cli/ink/components/Table.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+export interface Column<T> {
+    key: keyof T;
+    header: string;
+    width?: number;
+    align?: "left" | "right";
+    render?: (value: T[keyof T], row: T) => React.ReactNode;
+}
+export interface TableProps<T> {
+    data: T[];
+    columns: Column<T>[];
+    emptyMessage?: string;
+}
+export declare function Table<T extends object>({ data, columns, emptyMessage, }: TableProps<T>): React.ReactElement;

package/dist/cli/ink/components/Table.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { colors } from "../theme.js";
+function calculateColumnWidths(data, columns) {
+    const widths = new Map();
+    for (const col of columns) {
+        if (col.width) {
+            widths.set(col.key, col.width);
+            continue;
+        }
+        let maxWidth = col.header.length;
+        for (const row of data) {
+            const value = row[col.key];
+            const strValue = value === null || value === undefined ? "" : String(value);
+            maxWidth = Math.max(maxWidth, strValue.length);
+        }
+        widths.set(col.key, maxWidth);
+    }
+    return widths;
+}
+function padValue(value, width, align) {
+    if (align === "right") {
+        return value.padStart(width);
+    }
+    return value.padEnd(width);
+}
+export function Table({ data, columns, emptyMessage = "No data", }) {
+    if (data.length === 0) {
+        return (_jsx(Box, { children: _jsx(Text, { color: colors.muted, children: emptyMessage }) }));
+    }
+    const widths = calculateColumnWidths(data, columns);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: columns.map((col, i) => (_jsx(Box, { marginRight: i < columns.length - 1 ? 2 : 0, children: _jsx(Text, { color: colors.header, bold: true, children: padValue(col.header, widths.get(col.key) || col.header.length, col.align || "left") }) }, String(col.key)))) }), _jsx(Box, { children: columns.map((col, i) => (_jsx(Box, { marginRight: i < columns.length - 1 ? 2 : 0, children: _jsx(Text, { color: colors.muted, children: "-".repeat(widths.get(col.key) || col.header.length) }) }, String(col.key)))) }), data.map((row, rowIndex) => (_jsx(Box, { children: columns.map((col, colIndex) => {
+                    const value = row[col.key];
+                    const width = widths.get(col.key) || col.header.length;
+                    const align = col.align || "left";
+                    if (col.render) {
+                        return (_jsx(Box, { marginRight: colIndex < columns.length - 1 ? 2 : 0, children: _jsx(Box, { width: width, justifyContent: align === "right" ? "flex-end" : "flex-start", children: col.render(value, row) }) }, String(col.key)));
+                    }
+                    const strValue = value === null || value === undefined ? "" : String(value);
+                    return (_jsx(Box, { marginRight: colIndex < columns.length - 1 ? 2 : 0, children: _jsx(Text, { children: padValue(strValue, width, align) }) }, String(col.key)));
+                }) }, rowIndex)))] }));
+}

package/dist/cli/ink/components/WatchHeader.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+export interface WatchHeaderProps {
+    title: string;
+    lastUpdated?: Date;
+}
+export declare function WatchHeader({ title, lastUpdated }: WatchHeaderProps): React.ReactElement;
+export interface WatchFooterProps {
+    message?: string;
+}
+export declare function WatchFooter({ message }: WatchFooterProps): React.ReactElement;

package/dist/cli/ink/components/WatchHeader.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { colors } from "../theme.js";
+import { formatTimestamp } from "../../watch.js";
+export function WatchHeader({ title, lastUpdated }) {
+    const timestamp = lastUpdated
+        ? lastUpdated.toLocaleTimeString("en-US", {
+            hour12: false,
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+        })
+        : formatTimestamp();
+    return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, children: title }), _jsx(Text, { color: colors.muted, children: " (watching)" }), _jsx(Box, { flexGrow: 1 }), _jsxs(Text, { color: colors.muted, children: ["Last updated: ", timestamp] })] }));
+}
+export function WatchFooter({ message = "Press Ctrl+C to exit" }) {
+    return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.muted, children: message }) }));
+}

package/dist/cli/ink/components/index.d.ts

@@ -0,0 +1,4 @@
+export { Table, type Column, type TableProps } from "./Table.js";
+export { PnL, PnLPercent, type PnLProps, type PnLPercentProps } from "./PnL.js";
+export { WatchHeader, WatchFooter, type WatchHeaderProps, type WatchFooterProps } from "./WatchHeader.js";
+export { Spinner, ErrorDisplay, SuccessDisplay, type SpinnerProps, type ErrorDisplayProps, type SuccessDisplayProps } from "./Spinner.js";

package/dist/cli/ink/components/index.js

@@ -0,0 +1,4 @@
+export { Table } from "./Table.js";
+export { PnL, PnLPercent } from "./PnL.js";
+export { WatchHeader, WatchFooter } from "./WatchHeader.js";
+export { Spinner, ErrorDisplay, SuccessDisplay } from "./Spinner.js";

package/dist/cli/ink/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./theme.js";
+export * from "./render.js";
+export * from "./components/index.js";
+export * from "./app/index.js";

package/dist/cli/ink/index.js

@@ -0,0 +1,4 @@
+export * from "./theme.js";
+export * from "./render.js";
+export * from "./components/index.js";
+export * from "./app/index.js";

package/dist/cli/ink/render.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import { type Instance } from "ink";
+/**
+ * Render a React component to the terminal using Ink
+ * Returns the instance for cleanup
+ */
+export declare function render(element: React.ReactElement): Instance;
+/**
+ * Render a component for watch mode (persistent)
+ * Returns cleanup function that restores cursor visibility
+ */
+export declare function renderWatch(element: React.ReactElement): () => void;

package/dist/cli/ink/render.js

@@ -0,0 +1,21 @@
+import { render as inkRender } from "ink";
+import { showCursor } from "../watch.js";
+/**
+ * Render a React component to the terminal using Ink
+ * Returns the instance for cleanup
+ */
+export function render(element) {
+    return inkRender(element);
+}
+/**
+ * Render a component for watch mode (persistent)
+ * Returns cleanup function that restores cursor visibility
+ */
+export function renderWatch(element) {
+    const { unmount, clear } = inkRender(element);
+    return () => {
+        clear();
+        unmount();
+        showCursor();
+    };
+}

package/dist/cli/ink/theme.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Color theme for CLI output
+ *
+ * Ink color names — Ink respects NO_COLOR internally.
+ * For non-Ink ANSI output, use highlighter from experience.ts.
+ */
+export declare const colors: {
+    readonly profit: "green";
+    readonly loss: "red";
+    readonly neutral: "white";
+    readonly muted: "gray";
+    readonly header: "cyan";
+    readonly warning: "yellow";
+    readonly info: "blue";
+};
+export type ThemeColor = (typeof colors)[keyof typeof colors];
+/**
+ * Get the appropriate color for a PnL value
+ */
+export declare function getPnLColor(value: number): ThemeColor;
+/**
+ * Get the appropriate color for a percentage change
+ */
+export declare function getChangeColor(value: number): ThemeColor;
+/**
+ * Theme configuration for @inquirer/prompts
+ * Re-exported from lib/ui-tokens.ts (single source of truth).
+ */
+export { inquirerTheme } from "../../lib/ui-tokens.js";

package/dist/cli/ink/theme.js

@@ -0,0 +1,40 @@
+/**
+ * Color theme for CLI output
+ *
+ * Ink color names — Ink respects NO_COLOR internally.
+ * For non-Ink ANSI output, use highlighter from experience.ts.
+ */
+export const colors = {
+    profit: "green",
+    loss: "red",
+    neutral: "white",
+    muted: "gray",
+    header: "cyan",
+    warning: "yellow",
+    info: "blue",
+};
+/**
+ * Get the appropriate color for a PnL value
+ */
+export function getPnLColor(value) {
+    if (value > 0)
+        return colors.profit;
+    if (value < 0)
+        return colors.loss;
+    return colors.neutral;
+}
+/**
+ * Get the appropriate color for a percentage change
+ */
+export function getChangeColor(value) {
+    if (value > 0)
+        return colors.profit;
+    if (value < 0)
+        return colors.loss;
+    return colors.neutral;
+}
+/**
+ * Theme configuration for @inquirer/prompts
+ * Re-exported from lib/ui-tokens.ts (single source of truth).
+ */
+export { inquirerTheme } from "../../lib/ui-tokens.js";

package/dist/cli/network-defaults.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import { type CommandIntent } from "./command-metadata.js";
+export declare function commandPathFromCommand(command: Command): string[];
+export declare function classifyCommandIntentFromPath(path: string[]): CommandIntent;
+export declare function resolveTestnetMode(args: {
+    argv: string[];
+    commandPath: string[];
+    exchangeNetworkOverride?: "testnet" | "mainnet";
+    fallbackTestnet?: boolean;
+}): boolean;

package/dist/cli/network-defaults.js

@@ -0,0 +1,35 @@
+import { resolveNetworkDecision } from "../lib/network-model.js";
+import { classifyCommandIntentFromMetadata, } from "./command-metadata.js";
+function hasCliFlag(argv, flag) {
+    return argv.some((arg) => arg === flag);
+}
+export function commandPathFromCommand(command) {
+    const path = [];
+    let current = command;
+    while (current) {
+        const name = current.name().trim().toLowerCase();
+        if (name && name !== "perps") {
+            path.unshift(name);
+        }
+        current = current.parent;
+    }
+    return path;
+}
+export function classifyCommandIntentFromPath(path) {
+    return classifyCommandIntentFromMetadata(path);
+}
+export function resolveTestnetMode(args) {
+    const hasTestnet = hasCliFlag(args.argv, "--testnet");
+    const hasMainnet = hasCliFlag(args.argv, "--mainnet");
+    if (hasTestnet && hasMainnet) {
+        throw new Error("Cannot use --testnet and --mainnet together");
+    }
+    const intent = classifyCommandIntentFromPath(args.commandPath);
+    const decision = resolveNetworkDecision({
+        intent,
+        cliOverride: hasTestnet ? "testnet" : hasMainnet ? "mainnet" : undefined,
+        exchangeOverride: args.exchangeNetworkOverride,
+        fallbackNetwork: args.fallbackTestnet ? "testnet" : "mainnet",
+    });
+    return decision.network === "testnet";
+}

package/dist/cli/output.d.ts

@@ -0,0 +1,11 @@
+export interface OutputOptions {
+    json: boolean;
+}
+export declare function output(data: unknown, options: OutputOptions): void;
+export declare function outputError(message: string): void;
+export declare function outputSuccess(message: string): void;
+/**
+ * Format an array of objects as a table string (for watch mode display)
+ * Returns the formatted string instead of printing to console
+ */
+export declare function formatArrayAsTable(arr: unknown[]): string;

package/dist/cli/output.js

@@ -0,0 +1,115 @@
+import { formatStatusLine, stripAnsi } from "./experience.js";
+export function output(data, options) {
+    if (options.json) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    else {
+        if (typeof data === "string") {
+            console.log(data);
+        }
+        else if (Array.isArray(data)) {
+            formatArray(data);
+        }
+        else if (typeof data === "object" && data !== null) {
+            formatObject(data);
+        }
+        else {
+            console.log(data);
+        }
+    }
+}
+function visibleLength(text) {
+    return stripAnsi(text).length;
+}
+function formatArray(arr) {
+    if (arr.length === 0) {
+        console.log("(empty)");
+        return;
+    }
+    const first = arr[0];
+    if (typeof first === "object" && first !== null) {
+        // Table format for array of objects
+        const keys = Object.keys(first);
+        const widths = keys.map((k) => Math.max(k.length, ...arr.map((item) => {
+            const val = item[k];
+            return visibleLength(String(val ?? ""));
+        })));
+        // Header
+        console.log(keys.map((k, i) => k.padEnd(widths[i])).join("  "));
+        console.log(widths.map((w) => "-".repeat(w)).join("  "));
+        // Rows
+        for (const item of arr) {
+            const row = keys.map((k, i) => {
+                const val = item[k];
+                const str = String(val ?? "");
+                const padding = widths[i] - visibleLength(str);
+                return str + " ".repeat(Math.max(0, padding));
+            });
+            console.log(row.join("  "));
+        }
+    }
+    else {
+        for (const item of arr) {
+            console.log(item);
+        }
+    }
+}
+function formatObject(obj, indent = 0) {
+    const prefix = "  ".repeat(indent);
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            console.log(`${prefix}${key}:`);
+            formatObject(value, indent + 1);
+        }
+        else if (Array.isArray(value)) {
+            console.log(`${prefix}${key}: [${value.length} items]`);
+        }
+        else {
+            console.log(`${prefix}${key}: ${value}`);
+        }
+    }
+}
+export function outputError(message) {
+    console.error(formatStatusLine("error", `Error: ${message}`, process.stderr));
+}
+export function outputSuccess(message) {
+    if (!process.stdout.isTTY) {
+        console.log(message);
+        return;
+    }
+    console.log(formatStatusLine("success", message));
+}
+/**
+ * Format an array of objects as a table string (for watch mode display)
+ * Returns the formatted string instead of printing to console
+ */
+export function formatArrayAsTable(arr) {
+    if (arr.length === 0) {
+        return "(empty)";
+    }
+    const first = arr[0];
+    if (typeof first !== "object" || first === null) {
+        return arr.map(String).join("\n");
+    }
+    const keys = Object.keys(first);
+    const widths = keys.map((k) => Math.max(k.length, ...arr.map((item) => {
+        const val = item[k];
+        return visibleLength(String(val ?? ""));
+    })));
+    const lines = [];
+    // Header
+    lines.push(keys.map((k, i) => k.padEnd(widths[i])).join("  "));
+    // Separator
+    lines.push(widths.map((w) => "-".repeat(w)).join("  "));
+    // Rows
+    for (const item of arr) {
+        const row = keys.map((k, i) => {
+            const val = item[k];
+            const str = String(val ?? "");
+            const padding = widths[i] - visibleLength(str);
+            return str + " ".repeat(Math.max(0, padding));
+        });
+        lines.push(row.join("  "));
+    }
+    return lines.join("\n");
+}

package/dist/cli/program.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "commander";
+import { type CLIContext } from "./context.js";
+export interface GlobalOptions {
+    json: boolean;
+    testnet: boolean;
+    mainnet: boolean;
+    exchange: string;
+    banner: boolean;
+    human: boolean;
+    verbose: boolean;
+}
+export declare function createProgram(): Command;
+export declare function getContext(command: Command): CLIContext;
+export declare function getOutputOptions(command: Command): {
+    json: boolean;
+};
+export declare function getSelectedExchange(command: Command): string;
+export declare function getVerbose(command: Command): boolean;