@cascadetui/core 0.1.1

package/lib/terminal-palette.d.ts

@@ -0,0 +1,43 @@
+type Hex = string | null;
+export type WriteFunction = (data: string | Buffer) => boolean;
+export interface TerminalColors {
+    palette: Hex[];
+    defaultForeground: Hex;
+    defaultBackground: Hex;
+    cursorColor: Hex;
+    mouseForeground: Hex;
+    mouseBackground: Hex;
+    tekForeground: Hex;
+    tekBackground: Hex;
+    highlightBackground: Hex;
+    highlightForeground: Hex;
+}
+export interface GetPaletteOptions {
+    timeout?: number;
+    size?: number;
+}
+export interface TerminalPaletteDetector {
+    detect(options?: GetPaletteOptions): Promise<TerminalColors>;
+    detectOSCSupport(timeoutMs?: number): Promise<boolean>;
+    cleanup(): void;
+}
+export declare class TerminalPalette implements TerminalPaletteDetector {
+    private stdin;
+    private stdout;
+    private writeFn;
+    private activeListeners;
+    private activeTimers;
+    private inLegacyTmux;
+    constructor(stdin: NodeJS.ReadStream, stdout: NodeJS.WriteStream, writeFn?: WriteFunction, isLegacyTmux?: boolean);
+    /**
+     * Write an OSC sequence, wrapping for tmux if needed
+     */
+    private writeOsc;
+    cleanup(): void;
+    detectOSCSupport(timeoutMs?: number): Promise<boolean>;
+    private queryPalette;
+    private querySpecialColors;
+    detect(options?: GetPaletteOptions): Promise<TerminalColors>;
+}
+export declare function createTerminalPalette(stdin: NodeJS.ReadStream, stdout: NodeJS.WriteStream, writeFn?: WriteFunction, isLegacyTmux?: boolean): TerminalPaletteDetector;
+export {};

package/lib/tree-sitter/assets/update.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env bun
+export interface UpdateOptions {
+    /** Path to parsers-config.json */
+    configPath: string;
+    /** Directory where .wasm and .scm files will be downloaded */
+    assetsDir: string;
+    /** Path where the generated TypeScript file will be written */
+    outputPath: string;
+}
+declare function main(options?: Partial<UpdateOptions>): Promise<void>;
+export { main as updateAssets };

package/lib/tree-sitter/client.d.ts

@@ -0,0 +1,47 @@
+import { EventEmitter } from "events";
+import type { TreeSitterClientOptions, TreeSitterClientEvents, BufferState, FiletypeParserOptions, Edit, PerformanceStats, SimpleHighlight } from "./types";
+declare global {
+    const CASCADE_TREE_SITTER_WORKER_PATH: string;
+}
+export declare function addDefaultParsers(parsers: FiletypeParserOptions[]): void;
+export declare class TreeSitterClient extends EventEmitter<TreeSitterClientEvents> {
+    private initialized;
+    private worker;
+    private buffers;
+    private initializePromise;
+    private initializeResolvers;
+    private messageCallbacks;
+    private messageIdCounter;
+    private editQueues;
+    private debouncer;
+    private options;
+    constructor(options: TreeSitterClientOptions);
+    private emitError;
+    private emitWarning;
+    private startWorker;
+    private stopWorker;
+    private handleReset;
+    initialize(): Promise<void>;
+    private registerDefaultParsers;
+    private resolvePath;
+    addFiletypeParser(filetypeParser: FiletypeParserOptions): void;
+    getPerformance(): Promise<PerformanceStats>;
+    highlightOnce(content: string, filetype: string): Promise<{
+        highlights?: SimpleHighlight[];
+        warning?: string;
+        error?: string;
+    }>;
+    private handleWorkerMessage;
+    preloadParser(filetype: string): Promise<boolean>;
+    createBuffer(id: number, content: string, filetype: string, version?: number, autoInitialize?: boolean): Promise<boolean>;
+    updateBuffer(id: number, edits: Edit[], newContent: string, version: number): Promise<void>;
+    private processEdit;
+    removeBuffer(bufferId: number): Promise<void>;
+    destroy(): Promise<void>;
+    resetBuffer(bufferId: number, version: number, content: string): Promise<void>;
+    getBuffer(bufferId: number): BufferState | undefined;
+    getAllBuffers(): BufferState[];
+    isInitialized(): boolean;
+    setDataPath(dataPath: string): Promise<void>;
+    clearCache(): Promise<void>;
+}

package/lib/tree-sitter/default-parsers.d.ts

@@ -0,0 +1,2 @@
+import type { FiletypeParserOptions } from "./types";
+export declare function getParsers(): FiletypeParserOptions[];

package/lib/tree-sitter/download-utils.d.ts

@@ -0,0 +1,21 @@
+export interface DownloadResult {
+    content?: ArrayBuffer;
+    filePath?: string;
+    error?: string;
+}
+export declare class DownloadUtils {
+    private static hashUrl;
+    /**
+     * Download a file from URL or load from local path, with caching support
+     */
+    static downloadOrLoad(source: string, cacheDir: string, cacheSubdir: string, fileExtension: string, useHashForCache?: boolean, filetype?: string): Promise<DownloadResult>;
+    /**
+     * Download and save a file to a specific target path
+     */
+    static downloadToPath(source: string, targetPath: string): Promise<DownloadResult>;
+    /**
+     * Fetch multiple highlight queries and concatenate them
+     */
+    static fetchHighlightQueries(sources: string[], cacheDir: string, filetype: string): Promise<string>;
+    private static fetchHighlightQuery;
+}

package/lib/tree-sitter/index.d.ts

@@ -0,0 +1,8 @@
+import { TreeSitterClient } from "./client";
+export * from "./client";
+export * from "../tree-sitter-styled-text";
+export * from "./types";
+export * from "./resolve-ft";
+export type { UpdateOptions } from "./assets/update";
+export { updateAssets } from "./assets/update";
+export declare function getTreeSitterClient(): TreeSitterClient;

package/lib/tree-sitter/parser.worker.d.ts

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

package/lib/tree-sitter/parsers-config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * This file contains the configuration for the defaulttree-sitter parsers.
+ * It is used by ./assets/update.ts to generate the default-parsers.ts file.
+ * For changes here to be reflected in the default-parsers.ts file, you need to run `bun run ./assets/update.ts`
+ */
+declare const _default: {
+    parsers: ({
+        filetype: string;
+        wasm: string;
+        queries: {
+            highlights: string[];
+            injections?: undefined;
+        };
+        injectionMapping?: undefined;
+    } | {
+        filetype: string;
+        wasm: string;
+        queries: {
+            highlights: string[];
+            injections: string[];
+        };
+        injectionMapping: {
+            nodeTypes: {
+                inline: string;
+                pipe_table_cell: string;
+            };
+            infoStringMap: {
+                javascript: string;
+                js: string;
+                typescript: string;
+                ts: string;
+                markdown: string;
+                md: string;
+            };
+        };
+    })[];
+};
+export default _default;

package/lib/tree-sitter/resolve-ft.d.ts

@@ -0,0 +1,2 @@
+export declare function extToFiletype(extension: string): string | undefined;
+export declare function pathToFiletype(path: string): string | undefined;

package/lib/tree-sitter/types.d.ts

@@ -0,0 +1,81 @@
+export interface HighlightRange {
+    startCol: number;
+    endCol: number;
+    group: string;
+}
+export interface HighlightResponse {
+    line: number;
+    highlights: HighlightRange[];
+    droppedHighlights: HighlightRange[];
+}
+export interface HighlightMeta {
+    isInjection?: boolean;
+    injectionLang?: string;
+    containsInjection?: boolean;
+    conceal?: string | null;
+    concealLines?: string | null;
+}
+export type SimpleHighlight = [number, number, string, HighlightMeta?];
+export interface InjectionMapping {
+    nodeTypes?: {
+        [nodeType: string]: string;
+    };
+    infoStringMap?: {
+        [infoString: string]: string;
+    };
+}
+export interface FiletypeParserOptions {
+    filetype: string;
+    queries: {
+        highlights: string[];
+        injections?: string[];
+    };
+    wasm: string;
+    injectionMapping?: InjectionMapping;
+}
+export interface BufferState {
+    id: number;
+    version: number;
+    content: string;
+    filetype: string;
+    hasParser: boolean;
+}
+export interface ParsedBuffer extends BufferState {
+    hasParser: true;
+}
+export interface TreeSitterClientEvents {
+    "highlights:response": [bufferId: number, version: number, highlights: HighlightResponse[]];
+    "buffer:initialized": [bufferId: number, hasParser: boolean];
+    "buffer:disposed": [bufferId: number];
+    "worker:log": [logType: "log" | "error", message: string];
+    error: [error: string, bufferId?: number];
+    warning: [warning: string, bufferId?: number];
+}
+export interface TreeSitterClientOptions {
+    dataPath: string;
+    workerPath?: string | URL;
+    initTimeout?: number;
+}
+export interface Edit {
+    startIndex: number;
+    oldEndIndex: number;
+    newEndIndex: number;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    oldEndPosition: {
+        row: number;
+        column: number;
+    };
+    newEndPosition: {
+        row: number;
+        column: number;
+    };
+}
+export interface PerformanceStats {
+    averageParseTime: number;
+    parseTimes: number[];
+    averageQueryTime: number;
+    queryTimes: number[];
+}

package/lib/tree-sitter-styled-text.d.ts

@@ -0,0 +1,14 @@
+import type { TextChunk } from "../text-buffer";
+import { StyledText } from "./styled-text";
+import { SyntaxStyle } from "../syntax-style";
+import { TreeSitterClient } from "./tree-sitter/client";
+import type { SimpleHighlight } from "./tree-sitter/types";
+interface ConcealOptions {
+    enabled: boolean;
+}
+export declare function treeSitterToTextChunks(content: string, highlights: SimpleHighlight[], syntaxStyle: SyntaxStyle, options?: ConcealOptions): TextChunk[];
+export interface TreeSitterToStyledTextOptions {
+    conceal?: ConcealOptions;
+}
+export declare function treeSitterToStyledText(content: string, filetype: string, syntaxStyle: SyntaxStyle, client: TreeSitterClient, options?: TreeSitterToStyledTextOptions): Promise<StyledText>;
+export {};

package/lib/validate-dir-name.d.ts

@@ -0,0 +1 @@
+export declare function isValidDirectoryName(name: string): boolean;

package/lib/yoga.options.d.ts

@@ -0,0 +1,32 @@
+import { BoxSizing, Align, Dimension, Direction, Display, Edge, FlexDirection, Gutter, Justify, LogLevel, MeasureMode, Overflow, PositionType, Unit, Wrap } from "yoga-layout";
+export type AlignString = "auto" | "flex-start" | "center" | "flex-end" | "stretch" | "baseline" | "space-between" | "space-around" | "space-evenly";
+export type BoxSizingString = "border-box" | "content-box";
+export type DimensionString = "width" | "height";
+export type DirectionString = "inherit" | "ltr" | "rtl";
+export type DisplayString = "flex" | "none" | "contents";
+export type EdgeString = "left" | "top" | "right" | "bottom" | "start" | "end" | "horizontal" | "vertical" | "all";
+export type FlexDirectionString = "column" | "column-reverse" | "row" | "row-reverse";
+export type GutterString = "column" | "row" | "all";
+export type JustifyString = "flex-start" | "center" | "flex-end" | "space-between" | "space-around" | "space-evenly";
+export type LogLevelString = "error" | "warn" | "info" | "debug" | "verbose" | "fatal";
+export type MeasureModeString = "undefined" | "exactly" | "at-most";
+export type OverflowString = "visible" | "hidden" | "scroll";
+export type PositionTypeString = "static" | "relative" | "absolute";
+export type UnitString = "undefined" | "point" | "percent" | "auto";
+export type WrapString = "no-wrap" | "wrap" | "wrap-reverse";
+export declare function parseAlign(value: string | null | undefined): Align;
+export declare function parseAlignItems(value: string | null | undefined): Align;
+export declare function parseBoxSizing(value: string): BoxSizing;
+export declare function parseDimension(value: string): Dimension;
+export declare function parseDirection(value: string): Direction;
+export declare function parseDisplay(value: string): Display;
+export declare function parseEdge(value: string): Edge;
+export declare function parseFlexDirection(value: string | null | undefined): FlexDirection;
+export declare function parseGutter(value: string): Gutter;
+export declare function parseJustify(value: string | null | undefined): Justify;
+export declare function parseLogLevel(value: string): LogLevel;
+export declare function parseMeasureMode(value: string): MeasureMode;
+export declare function parseOverflow(value: string | null | undefined): Overflow;
+export declare function parsePositionType(value: string | null | undefined): PositionType;
+export declare function parseUnit(value: string): Unit;
+export declare function parseWrap(value: string | null | undefined): Wrap;

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@cascadetui/core",
+  "module": "index.js",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "module",
+  "version": "0.1.1",
+  "description": "Cascade is a TypeScript library on a native Zig core for building terminal user interfaces (TUIs)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kirosnn/cascade",
+    "directory": "packages/core"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    },
+    "./3d": {
+      "import": "./3d.js",
+      "require": "./3d.js",
+      "types": "./3d.d.ts"
+    },
+    "./testing": {
+      "import": "./testing.js",
+      "require": "./testing.js",
+      "types": "./testing.d.ts"
+    },
+    "./parser.worker": {
+      "import": "./lib/tree-sitter/parser.worker.js",
+      "require": "./lib/tree-sitter/parser.worker.js",
+      "types": "./lib/tree-sitter/parser.worker.d.ts"
+    }
+  },
+  "dependencies": {
+    "bun-ffi-structs": "0.1.2",
+    "diff": "8.0.2",
+    "jimp": "1.6.0",
+    "marked": "17.0.1",
+    "yoga-layout": "3.2.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^24.0.0",
+    "@types/three": "0.177.0",
+    "commander": "^13.1.0",
+    "typescript": "^5",
+    "web-tree-sitter": "0.25.10"
+  },
+  "peerDependencies": {
+    "web-tree-sitter": "0.25.10"
+  },
+  "optionalDependencies": {
+    "@dimforge/rapier2d-simd-compat": "^0.17.3",
+    "bun-webgpu": "0.1.5",
+    "planck": "^1.4.2",
+    "three": "0.177.0",
+    "@cascadetui/core-win32-x64": "0.1.1",
+    "@cascadetui/core-win32-arm64": "0.1.1",
+    "@cascadetui/core-darwin-x64": "0.1.1",
+    "@cascadetui/core-darwin-arm64": "0.1.1",
+    "@cascadetui/core-linux-x64": "0.1.1",
+    "@cascadetui/core-linux-arm64": "0.1.1"
+  }
+}