@opentui/core 0.5.16 → 0.6.0

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 (91) hide show
  1. package/NativeScene.d.ts +185 -0
  2. package/NativeSession.d.ts +134 -0
  3. package/NativeSpanFeed.d.ts +1 -4
  4. package/README.md +5 -3
  5. package/Renderable.d.ts +162 -67
  6. package/animation/Timeline.d.ts +11 -1
  7. package/assets/typescriptreact/highlights.scm +758 -0
  8. package/assets/typescriptreact/tree-sitter-tsx.wasm +0 -0
  9. package/buffer.d.ts +76 -36
  10. package/chunk-bun-s01c2jyn.js +24914 -0
  11. package/chunk-bun-s01c2jyn.js.map +69 -0
  12. package/chunk-bun-tsc14mt5.js +12515 -0
  13. package/chunk-bun-tsc14mt5.js.map +35 -0
  14. package/chunk-node-df90qrqc.js +12495 -0
  15. package/chunk-node-df90qrqc.js.map +34 -0
  16. package/chunk-node-hjr2tm60.js +24913 -0
  17. package/chunk-node-hjr2tm60.js.map +69 -0
  18. package/edit-buffer.d.ts +18 -20
  19. package/editor-view.d.ts +13 -5
  20. package/image.d.ts +18 -7
  21. package/index.bun.js +2387 -2899
  22. package/index.bun.js.map +20 -22
  23. package/index.d.ts +6 -2
  24. package/index.node.js +2387 -2899
  25. package/index.node.js.map +20 -24
  26. package/lib/buffer-access.d.ts +6 -0
  27. package/lib/clipboard.d.ts +0 -9
  28. package/lib/extmarks.d.ts +4 -1
  29. package/lib/tree-sitter/parsers-config.d.ts +9 -9
  30. package/native-abi.generated.d.ts +5496 -0
  31. package/node-assets.js +6 -2
  32. package/node-assets.js.map +3 -3
  33. package/package.json +10 -10
  34. package/parser.worker.js +14 -2
  35. package/parser.worker.js.map +3 -3
  36. package/renderables/ASCIIFont.d.ts +5 -5
  37. package/renderables/Box.d.ts +8 -8
  38. package/renderables/Code.d.ts +6 -2
  39. package/renderables/Diff.d.ts +4 -2
  40. package/renderables/EditBufferRenderable.d.ts +8 -10
  41. package/renderables/EmbeddedTerminal.d.ts +4 -2
  42. package/renderables/FrameBuffer.d.ts +3 -1
  43. package/renderables/Image.d.ts +3 -1
  44. package/renderables/Input.d.ts +0 -5
  45. package/renderables/LineNumberRenderable.d.ts +3 -1
  46. package/renderables/Markdown.d.ts +5 -2
  47. package/renderables/ScrollBar.d.ts +7 -1
  48. package/renderables/ScrollBox.d.ts +4 -6
  49. package/renderables/Select.d.ts +2 -1
  50. package/renderables/Slider.d.ts +7 -5
  51. package/renderables/TabSelect.d.ts +2 -1
  52. package/renderables/Text.d.ts +5 -4
  53. package/renderables/TextBufferRenderable.d.ts +10 -9
  54. package/renderables/TextNode.d.ts +8 -0
  55. package/renderables/TextTable.d.ts +1 -1
  56. package/renderables/Textarea.d.ts +1 -1
  57. package/renderables/index.d.ts +1 -1
  58. package/renderer.d.ts +90 -67
  59. package/session-buffer.d.ts +4 -0
  60. package/syntax-style.d.ts +9 -7
  61. package/testing/harness.d.ts +33 -0
  62. package/testing/manual-clock.d.ts +2 -0
  63. package/testing/test-renderer.d.ts +3 -0
  64. package/testing/test-streams.d.ts +20 -2
  65. package/testing.bun.js +60 -49
  66. package/testing.bun.js.map +6 -6
  67. package/testing.js +60 -49
  68. package/testing.js.map +6 -6
  69. package/tests/native-log-worker-child.d.ts +1 -0
  70. package/tests/native-symbol-stubs.d.ts +5 -0
  71. package/tests/yoga-callback-boundary-child.d.ts +1 -0
  72. package/tests/yoga-default-config-worker-child.d.ts +1 -0
  73. package/text-buffer-view.d.ts +11 -4
  74. package/text-buffer.d.ts +24 -9
  75. package/types.d.ts +4 -4
  76. package/yoga.bun.js +6 -2
  77. package/yoga.bun.js.map +1 -1
  78. package/yoga.d.ts +91 -56
  79. package/yoga.internal.d.ts +78 -0
  80. package/yoga.js +6 -2
  81. package/yoga.js.map +1 -1
  82. package/zig-structs.d.ts +13 -98
  83. package/zig.d.ts +1304 -583
  84. package/chunk-bun-3qwevekk.js +0 -10531
  85. package/chunk-bun-3qwevekk.js.map +0 -32
  86. package/chunk-bun-6rvkxs1v.js +0 -18862
  87. package/chunk-bun-6rvkxs1v.js.map +0 -64
  88. package/chunk-node-f3yste6w.js +0 -10530
  89. package/chunk-node-f3yste6w.js.map +0 -32
  90. package/chunk-node-tfvyz31s.js +0 -18844
  91. package/chunk-node-tfvyz31s.js.map +0 -63
package/buffer.d.ts CHANGED
@@ -1,47 +1,106 @@
1
1
  import { RGBA } from "./lib/index.js";
2
- import { type OptimizedBufferHandle, type RenderLib } from "./zig.js";
3
- import { type Pointer, type PointerInput } from "./platform/ffi.js";
2
+ import { type RenderLib, type NativeContextHandle, type NativeContextOptions, type NativeSceneFrameRequest, type SessionHandle, type SessionBuffer, type ContextBufferHandle, type NativeDrawingTarget, type NativeBufferGrid, type NativePaintRecorder, type SceneNodeHandle } from "./zig.js";
3
+ import type { PointerInput } from "./platform/ffi.js";
4
4
  import type { NativeImage } from "./image.js";
5
5
  import type { ImageRenderProtocol } from "./types.js";
6
+ import type { NativeScene } from "./NativeScene.js";
6
7
  import { type BorderStyle, type BorderSides } from "./lib/index.js";
7
8
  import { TargetChannel, type WidthMethod, type CapturedLine } from "./types.js";
8
9
  import type { TextBufferView } from "./text-buffer-view.js";
9
10
  import type { EditorView } from "./editor-view.js";
11
+ export interface BufferAccess {
12
+ readonly width: number;
13
+ readonly height: number;
14
+ readonly generation: bigint;
15
+ readonly char: Uint32Array;
16
+ readonly fg: Uint16Array;
17
+ readonly bg: Uint16Array;
18
+ readonly attributes: Uint32Array;
19
+ }
20
+ export interface NativeResourceOwner {
21
+ readonly resourceContext: ResourceContext;
22
+ }
23
+ /** Owns checked resources independently of the Sessions and scenes that use them. */
24
+ export declare class ResourceContext implements NativeResourceOwner {
25
+ readonly renderLib: RenderLib;
26
+ readonly context: NativeContextHandle;
27
+ private _disposed;
28
+ constructor(options: NativeContextOptions);
29
+ get disposed(): boolean;
30
+ get resourceContext(): ResourceContext;
31
+ assertAlive(): void;
32
+ destroy(): void;
33
+ }
34
+ export interface EncodedUnicode {
35
+ data: Array<{
36
+ width: number;
37
+ char: number;
38
+ }>;
39
+ }
10
40
  export declare class OptimizedBuffer {
11
41
  private static fbIdCounter;
12
42
  id: string;
13
43
  lib: RenderLib;
14
- private bufferPtr;
44
+ private source;
15
45
  private _width;
16
46
  private _height;
17
47
  private _widthMethod;
18
48
  respectAlpha: boolean;
19
- private _rawBuffers;
20
49
  private _destroyed;
21
- get ptr(): OptimizedBufferHandle;
50
+ private _nativePaintAccess;
51
+ private _bufferTarget;
22
52
  private guard;
23
- private ensureRawBufferViews;
53
+ /** Recording buffers queue drawing for native paint; they have no drawing target. */
54
+ private get recorder();
55
+ private checkedTarget;
56
+ /** @internal Native built-ins may retain only buffers belonging to their Context. */
57
+ _getSceneHandle(scene: NativeResourceOwner): ContextBufferHandle;
58
+ /** @internal Resource controllers draw only within their owning Context. */
59
+ _getSceneDrawTarget(scene: NativeScene): NativeDrawingTarget;
60
+ private drawChecked;
61
+ /** @internal Scene text draws its native node without exposing its buffer. */
62
+ _drawSceneText(scene: NativeScene, node: SceneNodeHandle, x: number, y: number): void;
63
+ /** Raw planes are available only during a synchronous post-process scope. Prefer withBuffers(). */
24
64
  get buffers(): {
25
65
  char: Uint32Array;
26
66
  fg: Uint16Array;
27
67
  bg: Uint16Array;
28
68
  attributes: Uint32Array;
29
69
  };
30
- constructor(lib: RenderLib, ptr: OptimizedBufferHandle, width: number, height: number, options: {
31
- respectAlpha?: boolean;
32
- id?: string;
33
- widthMethod?: WidthMethod;
34
- });
35
- static create(width: number, height: number, widthMethod: WidthMethod, options?: {
70
+ /**
71
+ * Borrows one live storage generation for a synchronous callback. Copy data
72
+ * that must outlive the callback; saved arrays cannot be revoked after release.
73
+ * Resize/destruction retains the old storage to scope exit, then reports stale
74
+ * access. This is not a frozen frame or an atomic cell-edit transaction.
75
+ * Do not use saved arrays after exit or change pooled grapheme/link IDs through
76
+ * these planes. Use OptimizedBuffer drawing methods or contextDrawBuffer instead.
77
+ * Styled-text/editor resources, hyperlinks, and images need their checked APIs.
78
+ *
79
+ * Session access without a scene ticket is storage-only. Rendering can change cells
80
+ * without changing generation. `current` is the encoder's comparison buffer, not a
81
+ * guaranteed last-presented frame; `next` is drawing storage cleared after encoding.
82
+ * Finish drawing before submitting a frame. Acquisition rejects pending presentation
83
+ * and non-rendering phases. Checked Session drawing requires an active scene ticket;
84
+ * ticketless storage access does not grant drawing access.
85
+ */
86
+ withBuffers<T>(callback: (cells: BufferAccess) => T): T;
87
+ /** Internal post-process scope. Ignores the callback's result; native views never escape the synchronous part. */
88
+ _withNativePaint(callback: () => void): void;
89
+ private constructor();
90
+ /** @internal A frame buffer whose drawing records into a paint recording. */
91
+ static fromRecorder(lib: RenderLib, context: NativeContextHandle, session: SessionHandle, recorder: NativePaintRecorder): OptimizedBuffer;
92
+ static fromSession(lib: RenderLib, context: NativeContextHandle, session: SessionHandle, which: SessionBuffer, getFrame?: () => NativeSceneFrameRequest | null): OptimizedBuffer;
93
+ static create(width: number, height: number, widthMethod: WidthMethod, options: {
36
94
  respectAlpha?: boolean;
37
95
  id?: string;
96
+ owner: NativeResourceOwner;
38
97
  }): OptimizedBuffer;
39
98
  get widthMethod(): WidthMethod;
40
99
  get width(): number;
41
100
  get height(): number;
42
101
  setRespectAlpha(respectAlpha: boolean): void;
43
- getNativeId(): string;
44
102
  getRealCharBytes(addLineBreaks?: boolean): Uint8Array;
103
+ private withResolvedChars;
45
104
  getSpanLines(): CapturedLine[];
46
105
  clear(bg?: RGBA): void;
47
106
  setCell(x: number, y: number, char: string, fg: RGBA, bg: RGBA, attributes?: number): void;
@@ -89,28 +148,9 @@ export declare class OptimizedBuffer {
89
148
  popOpacity(): void;
90
149
  getCurrentOpacity(): number;
91
150
  clearOpacity(): void;
92
- encodeUnicode(text: string): {
93
- ptr: Pointer;
94
- data: Array<{
95
- width: number;
96
- char: number;
97
- }>;
98
- } | null;
99
- freeUnicode(encoded: {
100
- ptr: Pointer;
101
- data: Array<{
102
- width: number;
103
- char: number;
104
- }>;
105
- }): void;
106
- drawGrid(options: {
107
- borderChars: Uint32Array;
108
- borderFg: RGBA;
109
- borderBg: RGBA;
110
- columnOffsets: Int32Array;
111
- rowOffsets: Int32Array;
112
- drawInner: boolean;
113
- drawOuter: boolean;
114
- }): void;
151
+ private stackChecked;
152
+ encodeUnicode(text: string): EncodedUnicode;
153
+ freeUnicode(encoded: EncodedUnicode): void;
154
+ drawGrid(options: NativeBufferGrid): void;
115
155
  drawChar(char: number, x: number, y: number, fg: RGBA, bg: RGBA, attributes?: number): void;
116
156
  }