@opentui/core 0.1.25 → 0.1.27

package/README.md

@@ -3,7 +3,11 @@
 OpenTUI Core is a TypeScript library for building terminal user interfaces (TUIs). It is currently in
 development and is not ready for production use.
 
-[Getting Started](docs/getting-started.md)
+## Documentation
+
+- [Getting Started](docs/getting-started.md)
+- [Tree-Sitter](docs/tree-sitter.md)
+- [Environment Variables](docs/env-vars.md)
 
 ## Install
 

package/Renderable.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "events";
 import { type Node as YogaNode } from "yoga-layout";
 import { OptimizedBuffer } from "./buffer";
-import type { ParsedKey } from "./lib/parse.keypress";
+import type { KeyEvent, PasteEvent } from "./lib/KeyHandler";
 import type { Selection } from "./lib/selection";
 import { type AlignString, type FlexDirectionString, type JustifyString, type OverflowString, type PositionTypeString, type WrapString } from "./lib/yoga.options";
 import { type VNode } from "./renderables/composition/vnode";
@@ -78,7 +78,7 @@ export interface RenderableOptions<T extends BaseRenderable = BaseRenderable> ex
     onMouseOut?: (this: T, event: MouseEvent) => void;
     onMouseScroll?: (this: T, event: MouseEvent) => void;
     onPaste?: (this: T, text: string) => void;
-    onKeyDown?: (key: ParsedKey) => void;
+    onKeyDown?: (key: KeyEvent) => void;
     onSizeChange?: (this: T) => void;
 }
 export declare function isRenderable(obj: any): obj is Renderable;
@@ -98,6 +98,7 @@ export declare abstract class BaseRenderable extends EventEmitter {
     abstract getChildrenCount(): number;
     abstract getRenderable(id: string): BaseRenderable | undefined;
     abstract requestRender(): void;
+    abstract findDescendantById(id: string): BaseRenderable | undefined;
     get id(): string;
     set id(value: string);
     get isDirty(): boolean;
@@ -126,8 +127,8 @@ export declare abstract class Renderable extends BaseRenderable {
     protected frameBuffer: OptimizedBuffer | null;
     protected _focusable: boolean;
     protected _focused: boolean;
-    protected keypressHandler: ((key: ParsedKey) => void) | null;
-    protected pasteHandler: ((text: string) => void) | null;
+    protected keypressHandler: ((key: KeyEvent) => void) | null;
+    protected pasteHandler: ((event: PasteEvent) => void) | null;
     private _live;
     protected _liveCount: number;
     private _sizeChangeListener;
@@ -169,7 +170,7 @@ export declare abstract class Renderable extends BaseRenderable {
     get liveCount(): number;
     set live(value: boolean);
     protected propagateLiveCount(delta: number): void;
-    handleKeyPress?(key: ParsedKey | string): boolean;
+    handleKeyPress?(key: KeyEvent | string): boolean;
     handlePaste?(text: string): void;
     findDescendantById(id: string): Renderable | undefined;
     requestRender(): void;
@@ -276,8 +277,8 @@ export declare abstract class Renderable extends BaseRenderable {
     set onMouseScroll(handler: ((event: MouseEvent) => void) | undefined);
     set onPaste(handler: ((text: string) => void) | undefined);
     get onPaste(): ((text: string) => void) | undefined;
-    set onKeyDown(handler: ((key: ParsedKey) => void) | undefined);
-    get onKeyDown(): ((key: ParsedKey) => void) | undefined;
+    set onKeyDown(handler: ((key: KeyEvent) => void) | undefined);
+    get onKeyDown(): ((key: KeyEvent) => void) | undefined;
     set onSizeChange(handler: (() => void) | undefined);
     get onSizeChange(): (() => void) | undefined;
     private applyEventOptions;

package/animation/Timeline.d.ts

@@ -1,3 +1,4 @@
+import type { CliRenderer } from "../renderer";
 export interface TimelineOptions {
     duration?: number;
     loop?: boolean;
@@ -111,7 +112,7 @@ declare class TimelineEngine {
     defaults: {
         frameRate: number;
     };
-    attach(renderer: any): void;
+    attach(renderer: CliRenderer): void;
     detach(): void;
     private updateLiveState;
     private onTimelineStateChange;

package/assets/javascript/highlights.scm

@@ -0,0 +1,205 @@
+; Query from: https://raw.githubusercontent.com/tree-sitter/tree-sitter-javascript/refs/heads/master/queries/highlights.scm
+; Variables
+;----------
+
+(identifier) @variable
+
+; Properties
+;-----------
+
+(property_identifier) @property
+
+; Function and method definitions
+;--------------------------------
+
+(function_expression
+  name: (identifier) @function)
+(function_declaration
+  name: (identifier) @function)
+(method_definition
+  name: (property_identifier) @function.method)
+
+(pair
+  key: (property_identifier) @function.method
+  value: [(function_expression) (arrow_function)])
+
+(assignment_expression
+  left: (member_expression
+    property: (property_identifier) @function.method)
+  right: [(function_expression) (arrow_function)])
+
+(variable_declarator
+  name: (identifier) @function
+  value: [(function_expression) (arrow_function)])
+
+(assignment_expression
+  left: (identifier) @function
+  right: [(function_expression) (arrow_function)])
+
+; Function and method calls
+;--------------------------
+
+(call_expression
+  function: (identifier) @function)
+
+(call_expression
+  function: (member_expression
+    property: (property_identifier) @function.method))
+
+; Special identifiers
+;--------------------
+
+((identifier) @constructor
+ (#match? @constructor "^[A-Z]"))
+
+([
+    (identifier)
+    (shorthand_property_identifier)
+    (shorthand_property_identifier_pattern)
+ ] @constant
+ (#match? @constant "^[A-Z_][A-Z\\d_]+$"))
+
+((identifier) @variable.builtin
+ (#match? @variable.builtin "^(arguments|module|console|window|document)$")
+ (#is-not? local))
+
+((identifier) @function.builtin
+ (#eq? @function.builtin "require")
+ (#is-not? local))
+
+; Literals
+;---------
+
+(this) @variable.builtin
+(super) @variable.builtin
+
+[
+  (true)
+  (false)
+  (null)
+  (undefined)
+] @constant.builtin
+
+(comment) @comment
+
+[
+  (string)
+  (template_string)
+] @string
+
+(regex) @string.special
+(number) @number
+
+; Tokens
+;-------
+
+[
+  ";"
+  (optional_chain)
+  "."
+  ","
+] @punctuation.delimiter
+
+[
+  "-"
+  "--"
+  "-="
+  "+"
+  "++"
+  "+="
+  "*"
+  "*="
+  "**"
+  "**="
+  "/"
+  "/="
+  "%"
+  "%="
+  "<"
+  "<="
+  "<<"
+  "<<="
+  "="
+  "=="
+  "==="
+  "!"
+  "!="
+  "!=="
+  "=>"
+  ">"
+  ">="
+  ">>"
+  ">>="
+  ">>>"
+  ">>>="
+  "~"
+  "^"
+  "&"
+  "|"
+  "^="
+  "&="
+  "|="
+  "&&"
+  "||"
+  "??"
+  "&&="
+  "||="
+  "??="
+] @operator
+
+[
+  "("
+  ")"
+  "["
+  "]"
+  "{"
+  "}"
+]  @punctuation.bracket
+
+(template_substitution
+  "${" @punctuation.special
+  "}" @punctuation.special) @embedded
+
+[
+  "as"
+  "async"
+  "await"
+  "break"
+  "case"
+  "catch"
+  "class"
+  "const"
+  "continue"
+  "debugger"
+  "default"
+  "delete"
+  "do"
+  "else"
+  "export"
+  "extends"
+  "finally"
+  "for"
+  "from"
+  "function"
+  "get"
+  "if"
+  "import"
+  "in"
+  "instanceof"
+  "let"
+  "new"
+  "of"
+  "return"
+  "set"
+  "static"
+  "switch"
+  "target"
+  "throw"
+  "try"
+  "typeof"
+  "var"
+  "void"
+  "while"
+  "with"
+  "yield"
+] @keyword