tuiuiu.js 0.1.1

package/dist/core/graphics.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Graphics Protocol Support
+ *
+ * Features:
+ * - Kitty Graphics Protocol (modern, efficient)
+ * - iTerm2 Inline Images
+ * - Sixel (legacy, wide support)
+ * - Braille fallback (universal)
+ * - Auto-detection with manual override
+ *
+ *
+ */
+export type GraphicsProtocol = 'kitty' | 'iterm2' | 'sixel' | 'braille' | 'none';
+export interface ImageOptions {
+    /** Width in cells (auto if not specified) */
+    width?: number;
+    /** Height in cells (auto if not specified) */
+    height?: number;
+    /** How to fit image in dimensions */
+    fit?: 'contain' | 'cover' | 'fill' | 'none';
+    /** Preserve aspect ratio */
+    preserveAspectRatio?: boolean;
+    /** Threshold for braille conversion (0-255) */
+    threshold?: number;
+    /** Enable dithering for braille */
+    dither?: boolean;
+}
+export interface ImageData {
+    /** Raw pixel data (RGBA) */
+    pixels: Uint8Array;
+    /** Image width in pixels */
+    width: number;
+    /** Image height in pixels */
+    height: number;
+}
+export interface ProtocolCapabilities {
+    protocol: GraphicsProtocol;
+    supportsTransparency: boolean;
+    supportsAnimation: boolean;
+    maxWidth?: number;
+    maxHeight?: number;
+}
+/**
+ * Detect the best available graphics protocol
+ */
+export declare function detectGraphicsProtocol(): GraphicsProtocol;
+/**
+ * Set graphics protocol manually (overrides auto-detection)
+ */
+export declare function setGraphicsProtocol(protocol: GraphicsProtocol | null): void;
+/**
+ * Get current graphics protocol
+ */
+export declare function getGraphicsProtocol(): GraphicsProtocol;
+/**
+ * Get protocol capabilities
+ */
+export declare function getProtocolCapabilities(): ProtocolCapabilities;
+/**
+ * Reset cached detection (for testing)
+ */
+export declare function resetGraphicsDetection(): void;
+/**
+ * Kitty Graphics Protocol implementation
+ * https://sw.kovidgoyal.net/kitty/graphics-protocol/
+ */
+export declare const kittyGraphics: {
+    /**
+     * Transmit image data to terminal
+     */
+    transmit(imageData: ImageData, options?: ImageOptions): string;
+    /**
+     * Display a previously transmitted image
+     */
+    display(imageId: number, x: number, y: number): string;
+    /**
+     * Delete an image from memory
+     */
+    delete(imageId?: number): string;
+    /**
+     * Clear all images from screen
+     */
+    clear(): string;
+};
+/**
+ * iTerm2 Inline Images Protocol
+ * https://iterm2.com/documentation-images.html
+ */
+export declare const iterm2Graphics: {
+    /**
+     * Display an image
+     */
+    display(imageData: ImageData, options?: ImageOptions): string;
+    /**
+     * Display image from file path (if accessible to terminal)
+     */
+    displayFile(path: string, options?: ImageOptions): string;
+};
+/**
+ * Sixel Graphics implementation
+ * https://en.wikipedia.org/wiki/Sixel
+ */
+export declare const sixelGraphics: {
+    /**
+     * Encode image as Sixel
+     */
+    encode(imageData: ImageData, options?: ImageOptions): string;
+};
+/**
+ * Braille Graphics implementation
+ */
+export declare const brailleGraphics: {
+    /**
+     * Convert image to braille characters
+     */
+    render(imageData: ImageData, options?: ImageOptions): string;
+    /**
+     * Invert braille output (light on dark vs dark on light)
+     */
+    invert(brailleText: string): string;
+};
+/**
+ * Render an image using the best available protocol
+ */
+export declare function renderImage(imageData: ImageData, options?: ImageOptions): string;
+/**
+ * Clear all displayed images
+ */
+export declare function clearImages(): string;
+/**
+ * Create image data from RGBA pixel array
+ */
+export declare function createImageData(pixels: Uint8Array | number[], width: number, height: number): ImageData;
+/**
+ * Create a solid color image
+ */
+export declare function createSolidImage(width: number, height: number, r: number, g: number, b: number, a?: number): ImageData;
+/**
+ * Create a gradient image (for testing)
+ */
+export declare function createGradientImage(width: number, height: number): ImageData;
+/**
+ * Scale image data (nearest neighbor)
+ */
+export declare function scaleImage(imageData: ImageData, newWidth: number, newHeight: number): ImageData;
+//# sourceMappingURL=graphics.d.ts.map

package/dist/core/graphics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../src/core/graphics.ts"],"names":[],"mappings":"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"}