htpx-cli 0.1.2 → 0.2.0

package/dist/cli/tui/hooks/useRequests.js

@@ -2,43 +2,55 @@
  * Hook for fetching and polling captured requests from the daemon.
  */
 import { useState, useEffect, useCallback, useRef } from "react";
-import { ControlClient } from "../../../daemon/control.js";
+import { ControlClient } from "../../../shared/control-client.js";
 import { findProjectRoot, getHtpxPaths } from "../../../shared/project.js";
+const DEFAULT_QUERY_LIMIT = 1000;
+const DEFAULT_POLL_INTERVAL_MS = 2000;
 /**
  * Hook to fetch and poll for captured requests.
  */
 export function useRequests(options = {}) {
-    const { label, pollInterval = 2000 } = options;
+    const { pollInterval = DEFAULT_POLL_INTERVAL_MS, filter, projectRoot } = options;
     const [requests, setRequests] = useState([]);
     const [isLoading, setIsLoading] = useState(true);
     const [error, setError] = useState(null);
     const clientRef = useRef(null);
     const lastCountRef = useRef(0);
+    const requestsLengthRef = useRef(0);
+    const filterRef = useRef(filter);
     // Initialise control client
     useEffect(() => {
-        const projectRoot = findProjectRoot();
-        if (!projectRoot) {
+        const resolvedRoot = projectRoot ?? findProjectRoot();
+        if (!resolvedRoot) {
             setError("Not in an htpx project. Run 'htpx init' first.");
             setIsLoading(false);
             return;
         }
-        const paths = getHtpxPaths(projectRoot);
+        const paths = getHtpxPaths(resolvedRoot);
         clientRef.current = new ControlClient(paths.controlSocketFile);
-    }, []);
-    // Fetch requests from daemon
+        return () => {
+            clientRef.current?.close();
+        };
+    }, [projectRoot]);
+    // Keep ref in sync with requests length
+    useEffect(() => {
+        requestsLengthRef.current = requests.length;
+    }, [requests.length]);
+    // Fetch request summaries from daemon
     const fetchRequests = useCallback(async () => {
         const client = clientRef.current;
         if (!client) {
             return;
         }
+        const currentFilter = filterRef.current;
         try {
             // First check the count to avoid unnecessary data transfer
-            const count = await client.countRequests({ label });
-            // Only fetch full list if count changed
-            if (count !== lastCountRef.current || requests.length === 0) {
-                const newRequests = await client.listRequests({
-                    label,
-                    limit: 1000,
+            const count = await client.countRequests({ filter: currentFilter });
+            // Only fetch list if count changed or we have no requests yet
+            if (count !== lastCountRef.current || requestsLengthRef.current === 0) {
+                const newRequests = await client.listRequestsSummary({
+                    limit: DEFAULT_QUERY_LIMIT,
+                    filter: currentFilter,
                 });
                 setRequests(newRequests);
                 lastCountRef.current = count;
@@ -48,7 +60,7 @@ export function useRequests(options = {}) {
         catch (err) {
             const message = err instanceof Error ? err.message : "Failed to connect to daemon";
             if (message.includes("ENOENT") || message.includes("ECONNREFUSED")) {
-                setError("Daemon not running. Start with 'htpx intercept'.");
+                setError("Daemon not running. Start with 'eval $(htpx on)'.");
             }
             else {
                 setError(message);
@@ -57,13 +69,45 @@ export function useRequests(options = {}) {
         finally {
             setIsLoading(false);
         }
-    }, [label, requests.length]);
+    }, []);
+    // Keep filter ref in sync and fetch immediately when filter changes
+    useEffect(() => {
+        filterRef.current = filter;
+        lastCountRef.current = 0;
+        void fetchRequests();
+    }, [filter, fetchRequests]);
     // Manual refresh function
     const refresh = useCallback(async () => {
         setIsLoading(true);
         lastCountRef.current = 0; // Force full refresh
         await fetchRequests();
     }, [fetchRequests]);
+    // Fetch full request data by ID
+    const getFullRequest = useCallback(async (id) => {
+        const client = clientRef.current;
+        if (!client) {
+            return null;
+        }
+        try {
+            return await client.getRequest(id);
+        }
+        catch {
+            return null;
+        }
+    }, []);
+    // Fetch all requests with full data (for exports like HAR)
+    const getAllFullRequests = useCallback(async () => {
+        const client = clientRef.current;
+        if (!client) {
+            return [];
+        }
+        try {
+            return await client.listRequests({ limit: DEFAULT_QUERY_LIMIT });
+        }
+        catch {
+            return [];
+        }
+    }, []);
     // Initial fetch
     useEffect(() => {
         void fetchRequests();
@@ -80,6 +124,8 @@ export function useRequests(options = {}) {
         isLoading,
         error,
         refresh,
+        getFullRequest,
+        getAllFullRequests,
     };
 }
 //# sourceMappingURL=useRequests.js.map

package/dist/cli/tui/hooks/useRequests.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRequests.js","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useRequests.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useRequests.js","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useRequests.ts"],"names":[],"mappings":"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"}

package/dist/cli/tui/hooks/useSaveBinary.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hook for saving binary content to disk.
+ */
+import type { SaveLocation } from "../components/SaveModal.js";
+export interface SaveResult {
+    success: boolean;
+    message: string;
+    filePath?: string;
+}
+/**
+ * Generate a filename for binary content based on request metadata.
+ */
+export declare function generateFilename(requestId: string, contentType: string | undefined, url: string): string;
+/**
+ * Save binary content to disk.
+ */
+export declare function saveBinaryContent(body: Buffer, filename: string, location: SaveLocation, customPath?: string): Promise<SaveResult>;
+interface UseSaveBinaryResult {
+    saveBinary: (body: Buffer, requestId: string, contentType: string | undefined, url: string, location: SaveLocation, customPath?: string) => Promise<SaveResult>;
+}
+/**
+ * Hook providing binary save functionality.
+ */
+export declare function useSaveBinary(): UseSaveBinaryResult;
+export {};
+//# sourceMappingURL=useSaveBinary.d.ts.map

package/dist/cli/tui/hooks/useSaveBinary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSaveBinary.d.ts","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useSaveBinary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CAwBR;AAkGD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED,UAAU,mBAAmB;IAC3B,UAAU,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAiBnD"}

package/dist/cli/tui/hooks/useSaveBinary.js

@@ -0,0 +1,165 @@
+/**
+ * Hook for saving binary content to disk.
+ */
+import { useCallback } from "react";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { copyToClipboard } from "../utils/clipboard.js";
+import { findOrCreateProjectRoot, ensureHtpxDir } from "../../../shared/project.js";
+/**
+ * Generate a filename for binary content based on request metadata.
+ */
+export function generateFilename(requestId, contentType, url) {
+    // Try to extract extension from URL first
+    let extension = "";
+    try {
+        const urlPath = new URL(url).pathname;
+        const urlExtMatch = urlPath.match(/\.([a-zA-Z0-9]+)$/);
+        if (urlExtMatch?.[1]) {
+            extension = urlExtMatch[1].toLowerCase();
+        }
+    }
+    catch {
+        // Invalid URL, fall through to content-type detection
+    }
+    if (!extension && contentType) {
+        // Derive extension from content type
+        extension = getExtensionFromContentType(contentType);
+    }
+    // Generate timestamp for uniqueness
+    const timestamp = Date.now();
+    const shortId = requestId.slice(0, 8);
+    return extension ? `${shortId}-${timestamp}.${extension}` : `${shortId}-${timestamp}.bin`;
+}
+/**
+ * Map common content types to file extensions.
+ */
+function getExtensionFromContentType(contentType) {
+    const type = contentType.split(";")[0]?.trim().toLowerCase() ?? "";
+    const mappings = {
+        // Images
+        "image/jpeg": "jpg",
+        "image/png": "png",
+        "image/gif": "gif",
+        "image/webp": "webp",
+        "image/svg+xml": "svg",
+        "image/x-icon": "ico",
+        "image/bmp": "bmp",
+        "image/tiff": "tiff",
+        // Audio
+        "audio/mpeg": "mp3",
+        "audio/wav": "wav",
+        "audio/ogg": "ogg",
+        "audio/webm": "weba",
+        "audio/aac": "aac",
+        "audio/flac": "flac",
+        // Video
+        "video/mp4": "mp4",
+        "video/webm": "webm",
+        "video/ogg": "ogv",
+        "video/quicktime": "mov",
+        "video/x-msvideo": "avi",
+        "video/x-matroska": "mkv",
+        // Documents
+        "application/pdf": "pdf",
+        "application/msword": "doc",
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+        "application/vnd.ms-excel": "xls",
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+        "application/vnd.ms-powerpoint": "ppt",
+        "application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
+        // Archives
+        "application/zip": "zip",
+        "application/gzip": "gz",
+        "application/x-tar": "tar",
+        "application/x-rar-compressed": "rar",
+        "application/x-7z-compressed": "7z",
+        // Other
+        "application/octet-stream": "bin",
+        "application/wasm": "wasm",
+    };
+    return mappings[type] ?? "bin";
+}
+/**
+ * Resolve the target directory based on save location.
+ */
+function resolveTargetDir(location, customPath) {
+    switch (location) {
+        case "exports": {
+            const projectRoot = findOrCreateProjectRoot();
+            const htpxDir = ensureHtpxDir(projectRoot);
+            const exportsDir = path.join(htpxDir, "exports");
+            if (!fs.existsSync(exportsDir)) {
+                fs.mkdirSync(exportsDir, { recursive: true });
+            }
+            return exportsDir;
+        }
+        case "downloads": {
+            const downloadsDir = path.join(os.homedir(), "Downloads");
+            if (!fs.existsSync(downloadsDir)) {
+                fs.mkdirSync(downloadsDir, { recursive: true });
+            }
+            return downloadsDir;
+        }
+        case "custom": {
+            if (!customPath) {
+                throw new Error("Custom path required");
+            }
+            // Expand ~ to home directory
+            const expandedPath = customPath.startsWith("~")
+                ? path.join(os.homedir(), customPath.slice(1))
+                : customPath;
+            const resolvedPath = path.resolve(expandedPath);
+            // Ensure directory exists
+            if (!fs.existsSync(resolvedPath)) {
+                fs.mkdirSync(resolvedPath, { recursive: true });
+            }
+            return resolvedPath;
+        }
+    }
+}
+/**
+ * Save binary content to disk.
+ */
+export async function saveBinaryContent(body, filename, location, customPath) {
+    try {
+        const targetDir = resolveTargetDir(location, customPath);
+        const filePath = path.join(targetDir, filename);
+        fs.writeFileSync(filePath, body);
+        // Copy path to clipboard
+        try {
+            await copyToClipboard(filePath);
+            return {
+                success: true,
+                message: `Saved to ${filePath} (path copied)`,
+                filePath,
+            };
+        }
+        catch {
+            // Clipboard failed but file was saved
+            return {
+                success: true,
+                message: `Saved to ${filePath}`,
+                filePath,
+            };
+        }
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: err instanceof Error ? err.message : "Failed to save file",
+        };
+    }
+}
+/**
+ * Hook providing binary save functionality.
+ */
+export function useSaveBinary() {
+    const saveBinary = useCallback(async (body, requestId, contentType, url, location, customPath) => {
+        const filename = generateFilename(requestId, contentType, url);
+        return saveBinaryContent(body, filename, location, customPath);
+    }, []);
+    return { saveBinary };
+}
+//# sourceMappingURL=useSaveBinary.js.map

package/dist/cli/tui/hooks/useSaveBinary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSaveBinary.js","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useSaveBinary.ts"],"names":[],"mappings":"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"}

package/dist/cli/tui/hooks/useSpinner.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hook that cycles through braille spinner frames for loading indicators.
+ */
+export declare function useSpinner(active?: boolean): string;
+//# sourceMappingURL=useSpinner.d.ts.map

package/dist/cli/tui/hooks/useSpinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSpinner.d.ts","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useSpinner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,UAAU,CAAC,MAAM,UAAO,GAAG,MAAM,CAqBhD"}

package/dist/cli/tui/hooks/useSpinner.js

@@ -0,0 +1,25 @@
+/**
+ * Hook that cycles through braille spinner frames for loading indicators.
+ */
+import { useState, useEffect, useRef } from "react";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const SPINNER_INTERVAL_MS = 80;
+export function useSpinner(active = true) {
+    const [frameIndex, setFrameIndex] = useState(0);
+    const intervalRef = useRef(null);
+    useEffect(() => {
+        if (!active) {
+            return;
+        }
+        intervalRef.current = setInterval(() => {
+            setFrameIndex((prev) => (prev + 1) % SPINNER_FRAMES.length);
+        }, SPINNER_INTERVAL_MS);
+        return () => {
+            if (intervalRef.current) {
+                clearInterval(intervalRef.current);
+            }
+        };
+    }, [active]);
+    return SPINNER_FRAMES[frameIndex] ?? SPINNER_FRAMES[0];
+}
+//# sourceMappingURL=useSpinner.js.map

package/dist/cli/tui/hooks/useSpinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSpinner.js","sourceRoot":"","sources":["../../../../src/cli/tui/hooks/useSpinner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AACnF,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,UAAU,UAAU,CAAC,MAAM,GAAG,IAAI;IACtC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAExB,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/cli/tui/utils/binary.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Binary content detection utilities.
+ *
+ * Determines whether a buffer contains binary or text content based on
+ * Content-Type headers and byte scanning.
+ */
+export interface BinaryCheckResult {
+    isBinary: boolean;
+    reason: "content-type" | "content-scan" | "text-content-type";
+}
+/**
+ * Check if content is binary based on Content-Type and/or byte scanning.
+ *
+ * Detection logic:
+ * 1. Check Content-Type against text whitelist - if match, return not binary
+ * 2. Check Content-Type against binary patterns - if match, return binary
+ * 3. Fall back to scanning first 8KB for >10% non-printable characters
+ */
+export declare function isBinaryContent(body: Buffer | undefined, contentType: string | undefined): BinaryCheckResult;
+/**
+ * Get a human-readable description for a binary content type.
+ */
+export declare function getBinaryTypeDescription(contentType: string | undefined): string;
+//# sourceMappingURL=binary.d.ts.map

package/dist/cli/tui/utils/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../src/cli/tui/utils/binary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,mBAAmB,CAAC;CAC/D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,iBAAiB,CAiDnB;AAoCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA2BhF"}

package/dist/cli/tui/utils/binary.js

@@ -0,0 +1,152 @@
+/**
+ * Binary content detection utilities.
+ *
+ * Determines whether a buffer contains binary or text content based on
+ * Content-Type headers and byte scanning.
+ */
+import { TEXT_CONTENT_TYPES, TEXT_SUFFIXES } from "../../../shared/content-type.js";
+/**
+ * Content types that are definitively binary.
+ */
+const BINARY_CONTENT_TYPES = [
+    "image/",
+    "audio/",
+    "video/",
+    "application/octet-stream",
+    "application/pdf",
+    "application/zip",
+    "application/gzip",
+    "application/x-tar",
+    "application/x-rar-compressed",
+    "application/x-7z-compressed",
+    "application/vnd.ms-excel",
+    "application/vnd.ms-powerpoint",
+    "application/vnd.ms-word",
+    "application/vnd.openxmlformats-officedocument",
+    "application/x-shockwave-flash",
+    "application/wasm",
+    "font/",
+];
+/**
+ * Human-readable descriptions for binary content types.
+ */
+const BINARY_DESCRIPTIONS = {
+    "image/": "Image",
+    "audio/": "Audio",
+    "video/": "Video",
+    "font/": "Font",
+    "application/pdf": "PDF",
+    "application/zip": "Archive",
+    "application/gzip": "Archive",
+    "application/x-tar": "Archive",
+    "application/x-rar-compressed": "Archive",
+    "application/x-7z-compressed": "Archive",
+    "application/wasm": "WebAssembly",
+};
+/**
+ * Check if content is binary based on Content-Type and/or byte scanning.
+ *
+ * Detection logic:
+ * 1. Check Content-Type against text whitelist - if match, return not binary
+ * 2. Check Content-Type against binary patterns - if match, return binary
+ * 3. Fall back to scanning first 8KB for >10% non-printable characters
+ */
+export function isBinaryContent(body, contentType) {
+    // No body means not binary (nothing to display)
+    if (!body || body.length === 0) {
+        return { isBinary: false, reason: "text-content-type" };
+    }
+    // Normalise content type (remove charset and other parameters)
+    const normalisedType = contentType?.split(";")[0]?.trim().toLowerCase();
+    // Check text content types first
+    if (normalisedType) {
+        // Check prefixes
+        let isTextContentType = false;
+        for (const prefix of TEXT_CONTENT_TYPES) {
+            if (normalisedType.startsWith(prefix)) {
+                isTextContentType = true;
+                break;
+            }
+        }
+        // Check suffixes (e.g., application/hal+json)
+        if (!isTextContentType) {
+            for (const suffix of TEXT_SUFFIXES) {
+                if (normalisedType.endsWith(suffix)) {
+                    isTextContentType = true;
+                    break;
+                }
+            }
+        }
+        if (isTextContentType) {
+            // Content-type says text, but verify with byte scan as safety net.
+            // Handles compressed bodies still in the DB, mislabelled content types, etc.
+            const scanResult = scanForBinaryContent(body);
+            return scanResult.isBinary
+                ? { isBinary: true, reason: "content-scan" }
+                : { isBinary: false, reason: "text-content-type" };
+        }
+        // Check binary content types
+        for (const prefix of BINARY_CONTENT_TYPES) {
+            if (normalisedType.startsWith(prefix)) {
+                return { isBinary: true, reason: "content-type" };
+            }
+        }
+    }
+    // Fall back to byte scanning
+    return scanForBinaryContent(body);
+}
+/**
+ * Scan buffer for binary content by checking for non-printable characters.
+ * Scans first 8KB and considers binary if >10% are non-printable.
+ */
+function scanForBinaryContent(body) {
+    const SCAN_SIZE = 8 * 1024; // 8KB
+    const BINARY_THRESHOLD = 0.1; // 10%
+    const bytesToScan = Math.min(body.length, SCAN_SIZE);
+    let nonPrintableCount = 0;
+    for (let i = 0; i < bytesToScan; i++) {
+        const byte = body[i];
+        if (byte === undefined)
+            continue;
+        // Allow common text characters:
+        // - Tab (9), LF (10), CR (13)
+        // - Printable ASCII (32-126)
+        // - Extended ASCII (128-255) for UTF-8
+        const isPrintable = byte === 9 || byte === 10 || byte === 13 || (byte >= 32 && byte <= 126) || byte >= 128;
+        if (!isPrintable) {
+            nonPrintableCount++;
+        }
+    }
+    const ratio = nonPrintableCount / bytesToScan;
+    return {
+        isBinary: ratio > BINARY_THRESHOLD,
+        reason: "content-scan",
+    };
+}
+/**
+ * Get a human-readable description for a binary content type.
+ */
+export function getBinaryTypeDescription(contentType) {
+    if (!contentType) {
+        return "Binary";
+    }
+    const normalisedType = contentType.split(";")[0]?.trim().toLowerCase() ?? "";
+    // Check exact matches first
+    if (BINARY_DESCRIPTIONS[normalisedType]) {
+        return BINARY_DESCRIPTIONS[normalisedType];
+    }
+    // Check prefix matches
+    for (const [prefix, description] of Object.entries(BINARY_DESCRIPTIONS)) {
+        if (prefix.endsWith("/") && normalisedType.startsWith(prefix)) {
+            return description;
+        }
+    }
+    // Extract subtype for better description
+    if (normalisedType.startsWith("application/")) {
+        const subtype = normalisedType.replace("application/", "");
+        // Capitalise first letter
+        return subtype.charAt(0).toUpperCase() + subtype.slice(1);
+    }
+    return "Binary";
+}
+//# sourceMappingURL=binary.js.map

package/dist/cli/tui/utils/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../../src/cli/tui/utils/binary.ts"],"names":[],"mappings":"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"}

package/dist/cli/tui/utils/clipboard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cross-platform clipboard utilities using native commands.
+ */
+/**
+ * Copy text to the system clipboard.
+ * Uses pbcopy on macOS, xclip on Linux, clip on Windows.
+ */
+export declare function copyToClipboard(text: string): Promise<void>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/cli/tui/utils/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../../src/cli/tui/utils/clipboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDjE"}