@opentui/core 0.8.4 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/NativeScene.d.ts +11 -3
  2. package/Renderable.d.ts +22 -6
  3. package/ansi.d.ts +1 -1
  4. package/{chunk-bun-dsfc571f.js → chunk-bun-v1wzs0bj.js} +679 -112
  5. package/chunk-bun-v1wzs0bj.js.map +35 -0
  6. package/{chunk-bun-83k2gdpc.js → chunk-bun-xartp4ps.js} +8718 -9733
  7. package/chunk-bun-xartp4ps.js.map +68 -0
  8. package/{chunk-node-3ssb37vb.js → chunk-node-5cqzgmq3.js} +8718 -9733
  9. package/chunk-node-5cqzgmq3.js.map +68 -0
  10. package/{chunk-node-5nvhjp1a.js → chunk-node-mcdre3zn.js} +679 -112
  11. package/chunk-node-mcdre3zn.js.map +34 -0
  12. package/edit-buffer.d.ts +47 -6
  13. package/editor-view.d.ts +28 -0
  14. package/index.bun.js +1355 -4789
  15. package/index.bun.js.map +18 -24
  16. package/index.node.js +1355 -4789
  17. package/index.node.js.map +19 -31
  18. package/lib/KeyHandler.d.ts +1 -1
  19. package/lib/extmarks.d.ts +15 -51
  20. package/lib/index.d.ts +1 -2
  21. package/lib/kitty-keys.d.ts +2 -0
  22. package/lib/parse.keypress.d.ts +8 -3
  23. package/lib/parse.mouse.d.ts +0 -13
  24. package/lib/stdin-parser-native.d.ts +36 -24
  25. package/lib/terminal-capability-detection.d.ts +3 -3
  26. package/lib/terminal-palette.d.ts +3 -0
  27. package/lib/tree-sitter/client.d.ts +14 -3
  28. package/lib/tree-sitter/types.d.ts +10 -0
  29. package/lib/tree-sitter-styled-text.d.ts +2 -0
  30. package/lib/yoga.options.d.ts +3 -0
  31. package/native-abi.generated.d.ts +1400 -1
  32. package/package.json +9 -10
  33. package/parser.worker.js +112 -29
  34. package/parser.worker.js.map +3 -3
  35. package/plugins/core-slot.d.ts +1 -1
  36. package/renderables/ASCIIFont.d.ts +5 -0
  37. package/renderables/Code.d.ts +25 -2
  38. package/renderables/Diff.d.ts +3 -1
  39. package/renderables/EditBufferRenderable.d.ts +30 -1
  40. package/renderables/EmbeddedTerminal.d.ts +1 -1
  41. package/renderables/Input.d.ts +6 -3
  42. package/renderables/LineNumberRenderable.d.ts +4 -0
  43. package/renderables/Markdown.d.ts +208 -124
  44. package/renderables/ScrollBox.d.ts +7 -2
  45. package/renderables/ScrollBoxParts.d.ts +4 -5
  46. package/renderables/Select.d.ts +2 -2
  47. package/renderables/TabSelect.d.ts +2 -2
  48. package/renderables/Text.d.ts +3 -1
  49. package/renderables/TextBufferRenderable.d.ts +4 -0
  50. package/renderables/TextTable.d.ts +22 -0
  51. package/renderables/Textarea.d.ts +2 -1
  52. package/renderables/__tests__/code-model-harness.d.ts +40 -0
  53. package/renderables/index.d.ts +1 -3
  54. package/renderables/markdown-document.d.ts +37 -0
  55. package/renderables/props.d.ts +10 -0
  56. package/renderer-theme-mode.d.ts +5 -1
  57. package/renderer.d.ts +23 -9
  58. package/runtime-plugin.js +32 -57
  59. package/runtime-plugin.js.map +1 -1
  60. package/syntax-style.d.ts +5 -0
  61. package/testing/mock-tree-sitter-client.d.ts +5 -0
  62. package/testing/model.d.ts +15 -0
  63. package/testing.bun.js +8 -31
  64. package/testing.bun.js.map +4 -4
  65. package/testing.js +8 -31
  66. package/testing.js.map +4 -4
  67. package/tests/shrink-same-check.d.ts +4 -0
  68. package/tests/yoga-upstream/tools/utils.d.ts +9 -2
  69. package/text-buffer-view.d.ts +4 -0
  70. package/text-buffer.d.ts +16 -1
  71. package/types.d.ts +2 -2
  72. package/yoga.bun.js +1 -1
  73. package/yoga.internal.d.ts +1 -0
  74. package/yoga.js +1 -1
  75. package/zig.d.ts +107 -6
  76. package/chunk-bun-83k2gdpc.js.map +0 -70
  77. package/chunk-bun-dsfc571f.js.map +0 -35
  78. package/chunk-node-3ssb37vb.js.map +0 -70
  79. package/chunk-node-5nvhjp1a.js.map +0 -34
  80. package/lib/debounce.d.ts +0 -42
  81. package/lib/extmarks-history.d.ts +0 -17
  82. package/lib/parse.keypress-kitty.d.ts +0 -5
  83. package/lib/queue.d.ts +0 -15
  84. package/lib/stdin-parser.d.ts +0 -97
  85. package/renderables/composition/VRenderable.d.ts +0 -16
  86. package/renderables/composition/constructs.d.ts +0 -35
  87. package/renderables/composition/vnode.d.ts +0 -46
  88. package/renderables/markdown-parser.d.ts +0 -12
@@ -1,4 +1,4 @@
1
- import { BaseRenderable, Renderable, type RenderableOptions } from "../Renderable.js";
1
+ import { type BaseRenderable, Renderable, type RenderableOptions } from "../Renderable.js";
2
2
  import type { CliRenderer } from "../renderer.js";
3
3
  import type { RenderContext } from "../types.js";
4
4
  import { SlotRegistry, type SlotRegistryOptions } from "./registry.js";
@@ -41,6 +41,11 @@ export declare class ASCIIFontRenderable extends FrameBufferRenderable {
41
41
  set color(value: ColorInput | ColorInput[]);
42
42
  get backgroundColor(): ColorInput;
43
43
  set backgroundColor(value: ColorInput);
44
+ get selectionBg(): RGBA | undefined;
45
+ set selectionBg(value: ColorInput | undefined);
46
+ get selectionFg(): RGBA | undefined;
47
+ set selectionFg(value: ColorInput | undefined);
48
+ private repaintSelection;
44
49
  protected defaultDimension(kind: "width" | "height"): number;
45
50
  private updateDimensions;
46
51
  shouldStartSelection(x: number, y: number): boolean;
@@ -42,7 +42,8 @@ export declare class CodeRenderable extends TextBufferRenderable {
42
42
  private _isHighlighting;
43
43
  private _treeSitterClient;
44
44
  private _highlightsDirty;
45
- private _highlightSnapshotId;
45
+ private _version;
46
+ private _shownVersion;
46
47
  private _highlightLoopActive;
47
48
  private _highlightPromise?;
48
49
  private _highlightRerun;
@@ -51,13 +52,17 @@ export declare class CodeRenderable extends TextBufferRenderable {
51
52
  private _shouldRenderTextBuffer;
52
53
  private _streaming;
53
54
  private _initialStyledText?;
54
- private _hadInitialContent;
55
+ private _checkPainted;
55
56
  private _baseHighlight?;
56
57
  private _onHighlight?;
57
58
  private _onChunks?;
58
59
  private _highlightingPromise;
59
60
  private _renderedLineSources?;
60
61
  private _mappedLineInfo?;
62
+ private _deltas?;
63
+ private _groupSets;
64
+ private static nextCopy;
65
+ private _streamsDeltas;
61
66
  protected _contentDefaultOptions: {
62
67
  content: string;
63
68
  conceal: true;
@@ -67,9 +72,23 @@ export declare class CodeRenderable extends TextBufferRenderable {
67
72
  constructor(ctx: RenderContext, options: CodeOptions);
68
73
  get content(): string;
69
74
  private invalidateHighlights;
75
+ private showPlainText;
76
+ private readonly checkPainted;
77
+ private belowView;
78
+ _needsLifecyclePass(): boolean;
79
+ private changeStyle;
70
80
  private setHighlightsDirty;
71
81
  private setShouldRenderTextBuffer;
72
82
  set content(value: string);
83
+ private writeContent;
84
+ private deltasAllowed;
85
+ /**
86
+ * @internal Markdown marks a fence while its block is open: while it streams, its appends go to the highlighter as
87
+ * deltas. A closed block's text is final, so its worker copy goes (C4 question 4): now if the last reply covers the
88
+ * text, else once the reply for the rest lands.
89
+ */
90
+ _setStreamsDeltas(open: boolean): void;
91
+ private stopDeltas;
73
92
  updateStreamingPreview(content: string, initialStyledText: StyledText): void;
74
93
  get lineInfo(): LineInfo;
75
94
  getLineSources(startLine: number, lineCount: number): number[];
@@ -100,7 +119,11 @@ export declare class CodeRenderable extends TextBufferRenderable {
100
119
  get highlightingDone(): Promise<void>;
101
120
  protected transformChunks(chunks: TextChunk[], context: ChunkRenderContext): Promise<TextChunk[]>;
102
121
  private ensureVisibleTextBeforeHighlight;
122
+ private paintHighlightsOnly;
123
+ private currentDeltas;
103
124
  private startHighlight;
125
+ private highlightDelta;
126
+ private settle;
104
127
  private runHighlights;
105
128
  private clearPendingHighlight;
106
129
  private setRenderedLineSources;
@@ -3,7 +3,7 @@ import type { RenderContext } from "../types.js";
3
3
  import { type LineColorConfig } from "./LineNumberRenderable.js";
4
4
  import { RGBA } from "../lib/RGBA.js";
5
5
  import { SyntaxStyle } from "../syntax-style.js";
6
- import type { TreeSitterClient } from "../lib/tree-sitter/index.js";
6
+ import { type TreeSitterClient } from "../lib/tree-sitter/index.js";
7
7
  import type { MouseEvent } from "../renderer.js";
8
8
  export interface DiffGutterOptions {
9
9
  /** Columns before the line numbers, painted in each row's gutter color. Defaults to 1. */
@@ -115,6 +115,8 @@ export declare class DiffRenderable extends Renderable {
115
115
  set view(value: "unified" | "split");
116
116
  get filetype(): string | undefined;
117
117
  set filetype(value: string | undefined);
118
+ get treeSitterClient(): TreeSitterClient | undefined;
119
+ set treeSitterClient(value: TreeSitterClient | undefined);
118
120
  get syntaxStyle(): SyntaxStyle | undefined;
119
121
  set syntaxStyle(value: SyntaxStyle | undefined);
120
122
  get wrapMode(): "word" | "char" | "none" | undefined;
@@ -18,7 +18,9 @@ export declare enum EditBufferRenderableEvents {
18
18
  }
19
19
  export declare function isEditBufferRenderable(obj: unknown): obj is EditBufferRenderable;
20
20
  export interface CursorChangeEvent {
21
+ /** Zero-based logical line. */
21
22
  line: number;
23
+ /** Display-cell column on that logical line, not a UTF-16 index. */
22
24
  visualColumn: number;
23
25
  }
24
26
  export interface ContentChangeEvent {
@@ -94,11 +96,20 @@ export declare abstract class EditBufferRenderable extends Renderable implements
94
96
  get lineCount(): number;
95
97
  get virtualLineCount(): number;
96
98
  get scrollY(): number;
99
+ get scrollMargin(): number;
100
+ set scrollMargin(value: number | undefined);
101
+ /** Buffer text with LF line breaks. Index or slice it in UTF-16 units, not cursor offsets. */
97
102
  get plainText(): string;
103
+ /** Logical row, display-cell column, and document cell offset (one per newline). */
98
104
  get logicalCursor(): LogicalCursor;
105
+ /** Viewport-relative wrapped row and cell column, plus the logical position and document cell offset. */
99
106
  get visualCursor(): VisualCursor;
107
+ /** Display cells from the document start, one per newline. Use editBuffer.cellOffsetToStringIndex for plainText. */
100
108
  get cursorOffset(): number;
109
+ /** Sets the cursor in document display cells, counting each newline as one. */
101
110
  set cursorOffset(offset: number);
111
+ private selectionSide;
112
+ /** Legacy under-cursor lookup with line-end adjustments; not a conversion from cells to a UTF-16 caret index. */
102
113
  get cursorCharacterOffset(): number | undefined;
103
114
  get textColor(): RGBA;
104
115
  set textColor(value: RGBA | string | undefined);
@@ -119,7 +130,7 @@ export declare abstract class EditBufferRenderable extends Renderable implements
119
130
  get cursorColor(): RGBA;
120
131
  set cursorColor(value: RGBA | string);
121
132
  get cursorStyle(): CursorStyleOptions;
122
- set cursorStyle(style: CursorStyleOptions);
133
+ set cursorStyle(value: CursorStyleOptions | null | undefined);
123
134
  get selectionOccupancy(): SelectionOccupancy;
124
135
  set selectionOccupancy(value: SelectionOccupancy | null | undefined);
125
136
  get tabIndicator(): string | number | undefined;
@@ -138,17 +149,23 @@ export declare abstract class EditBufferRenderable extends Renderable implements
138
149
  /** @internal */
139
150
  get _needsAutoScrollUpdate(): boolean;
140
151
  protected onUpdate(deltaTime: number): void;
152
+ /** Returns the selected text as a UTF-16-indexed JavaScript string. */
141
153
  getSelectedText(): string;
142
154
  hasSelection(): boolean;
155
+ /** Returns half-open document cell bounds, counting one cell per newline. */
143
156
  getSelection(): {
144
157
  start: number;
145
158
  end: number;
146
159
  } | null;
147
160
  private deleteSelectedText;
161
+ private resetSelection;
162
+ /** Selects [start, end) in document display cells, counting one cell per newline. */
148
163
  setSelection(start: number, end: number): void;
164
+ /** Takes document cell offsets (one per newline); cell occupancy includes the grapheme at the larger endpoint. */
149
165
  setSelectionInclusive(start: number, end: number): void;
150
166
  clearSelection(): boolean;
151
167
  deleteSelection(): boolean;
168
+ /** Sets the cursor by zero-based logical row and display-cell column. */
152
169
  setCursor(row: number, col: number): void;
153
170
  insertChar(char: string): void;
154
171
  insertText(text: string): void;
@@ -158,18 +175,23 @@ export declare abstract class EditBufferRenderable extends Renderable implements
158
175
  newLine(): boolean;
159
176
  deleteLine(): boolean;
160
177
  private collapseSelectionToEdge;
178
+ /** Moves left by a cursor stop, not one UTF-16 unit; select extends the cell range. */
161
179
  moveCursorLeft(options?: {
162
180
  select?: boolean;
163
181
  }): boolean;
182
+ /** Moves right by a cursor stop, not one UTF-16 unit; select extends the cell range. */
164
183
  moveCursorRight(options?: {
165
184
  select?: boolean;
166
185
  }): boolean;
186
+ /** Moves up one wrapped row; select extends the document cell range. */
167
187
  moveCursorUp(options?: {
168
188
  select?: boolean;
169
189
  }): boolean;
190
+ /** Moves down one wrapped row; select extends the document cell range. */
170
191
  moveCursorDown(options?: {
171
192
  select?: boolean;
172
193
  }): boolean;
194
+ /** Moves to a zero-based logical line. */
173
195
  gotoLine(line: number): void;
174
196
  gotoLineStart(): void;
175
197
  gotoLineTextEnd(): void;
@@ -196,9 +218,11 @@ export declare abstract class EditBufferRenderable extends Renderable implements
196
218
  deleteToLineStart(): boolean;
197
219
  undo(): boolean;
198
220
  redo(): boolean;
221
+ /** Moves to the next word boundary; select extends the document cell range. */
199
222
  moveWordForward(options?: {
200
223
  select?: boolean;
201
224
  }): boolean;
225
+ /** Moves to the previous word boundary; select extends the document cell range. */
202
226
  moveWordBackward(options?: {
203
227
  select?: boolean;
204
228
  }): boolean;
@@ -214,7 +238,9 @@ export declare abstract class EditBufferRenderable extends Renderable implements
214
238
  get onContentChange(): ((event: ContentChangeEvent) => void) | undefined;
215
239
  get syntaxStyle(): SyntaxStyle | null;
216
240
  set syntaxStyle(style: SyntaxStyle | null);
241
+ /** Highlights a range in display cells relative to the logical line. */
217
242
  addHighlight(lineIdx: number, highlight: Highlight): void;
243
+ /** Highlights a range in document display cells excluding newlines, not UTF-16 indices. */
218
244
  addHighlightByCharRange(highlight: Highlight): void;
219
245
  removeHighlightsByRef(hlRef: number): void;
220
246
  clearLineHighlights(lineIdx: number): void;
@@ -231,8 +257,11 @@ export declare abstract class EditBufferRenderable extends Renderable implements
231
257
  */
232
258
  replaceText(text: string): void;
233
259
  clear(): void;
260
+ /** Deletes a half-open range between (zero-based logical line, display-cell column) pairs. */
234
261
  deleteRange(startLine: number, startCol: number, endLine: number, endCol: number): void;
262
+ /** Reads [startOffset, endOffset) in document display cells, counting one cell per newline. */
235
263
  getTextRange(startOffset: number, endOffset: number): string;
264
+ /** Reads a half-open range between (zero-based logical row, display-cell column) pairs. */
236
265
  getTextRangeByCoords(startRow: number, startCol: number, endRow: number, endCol: number): string;
237
266
  private setNativeEditorOptions;
238
267
  protected updateSelectionForMovement(shiftPressed: boolean, isBeforeMovement: boolean): void;
@@ -1,5 +1,5 @@
1
1
  import { type RenderableOptions, Renderable, type NativeRenderableIntegration } from "../Renderable.js";
2
- import type { KeyEvent, PasteEvent } from "../lib/KeyHandler.js";
2
+ import { KeyEvent, type PasteEvent } from "../lib/KeyHandler.js";
3
3
  import type { RenderContext } from "../types.js";
4
4
  import type { OptimizedBuffer } from "../buffer.js";
5
5
  import { type Selection } from "../lib/selection.js";
@@ -2,12 +2,12 @@ import type { RenderContext } from "../types.js";
2
2
  import { TextareaRenderable, type TextareaOptions, type TextareaAction, type KeyBinding as TextareaKeyBinding } from "./Textarea.js";
3
3
  export type InputAction = TextareaAction;
4
4
  export type InputKeyBinding = TextareaKeyBinding;
5
- export interface InputRenderableOptions extends Omit<TextareaOptions, "height" | "minHeight" | "maxHeight" | "initialValue"> {
5
+ export interface InputRenderableOptions extends Omit<TextareaOptions, "height" | "minHeight" | "maxHeight" | "initialValue" | "onSubmit"> {
6
6
  /** Initial text value (newlines are stripped) */
7
7
  value?: string;
8
- /** Minimum number of characters allowed */
8
+ /** Minimum length in UTF-16 code units required for submit */
9
9
  minLength?: number;
10
- /** Maximum number of characters allowed */
10
+ /** Maximum length in UTF-16 code units */
11
11
  maxLength?: number;
12
12
  /** Placeholder text (Input only supports string, not StyledText) */
13
13
  placeholder?: string;
@@ -43,6 +43,7 @@ export declare class InputRenderable extends TextareaRenderable {
43
43
  */
44
44
  insertText(text: string): void;
45
45
  protected defaultDimension(kind: "width" | "height"): number | "auto" | `${number}%`;
46
+ /** The single-line text, indexed in UTF-16 code units, not cursor cells. */
46
47
  get value(): string;
47
48
  set value(value: string);
48
49
  focus(): void;
@@ -59,8 +60,10 @@ export declare class InputRenderable extends TextareaRenderable {
59
60
  redo(): boolean;
60
61
  deleteCharacter(direction: "backward" | "forward"): void;
61
62
  set maxLength(maxLength: number);
63
+ /** Maximum input length in UTF-16 code units. */
62
64
  get maxLength(): number;
63
65
  set minLength(minLength: number);
66
+ /** Minimum length for submission in UTF-16 code units. */
64
67
  get minLength(): number;
65
68
  set placeholder(placeholder: string);
66
69
  get placeholder(): string;
@@ -68,6 +68,7 @@ export declare class LineNumberRenderable extends Renderable {
68
68
  setLineColor(line: number, color: string | RGBA | LineColorConfig): void;
69
69
  clearLineColor(line: number): void;
70
70
  clearAllLineColors(): void;
71
+ set lineColors(value: LineNumberOptions["lineColors"]);
71
72
  setLineColors(lineColors: Map<number, string | RGBA | LineColorConfig>): void;
72
73
  getLineColors(): {
73
74
  gutter: Map<number, RGBA>;
@@ -77,6 +78,7 @@ export declare class LineNumberRenderable extends Renderable {
77
78
  clearLineSign(line: number): void;
78
79
  clearAllLineSigns(): void;
79
80
  setLineSigns(lineSigns: Map<number, LineSign>): void;
81
+ set lineSigns(value: LineNumberOptions["lineSigns"]);
80
82
  getLineSigns(): Map<number, LineSign>;
81
83
  getGutterLayout(): GutterLayout;
82
84
  setGutterLayout(layout: GutterLayout): void;
@@ -84,8 +86,10 @@ export declare class LineNumberRenderable extends Renderable {
84
86
  get lineNumberOffset(): number;
85
87
  setHideLineNumbers(hideLineNumbers: Set<number>): void;
86
88
  getHideLineNumbers(): Set<number>;
89
+ set hideLineNumbers(value: LineNumberOptions["hideLineNumbers"]);
87
90
  setLineNumbers(lineNumbers: Map<number, number>): void;
88
91
  getLineNumbers(): Map<number, number>;
92
+ set lineNumbers(value: LineNumberOptions["lineNumbers"]);
89
93
  highlightLines(startLine: number, endLine: number, color: string | RGBA | LineColorConfig): void;
90
94
  clearHighlightLines(startLine: number, endLine: number): void;
91
95
  }