@nuvin/ink 6.6.7 → 7.0.1-alpha

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 (216) hide show
  1. package/build/ansi-tokenizer.d.ts +38 -0
  2. package/build/ansi-tokenizer.d.ts.map +1 -0
  3. package/build/ansi-tokenizer.js +316 -0
  4. package/build/ansi-tokenizer.js.map +1 -0
  5. package/build/colorize.d.ts.map +1 -0
  6. package/build/components/AccessibilityContext.d.ts.map +1 -0
  7. package/build/components/AnimationContext.d.ts +9 -0
  8. package/build/components/AnimationContext.d.ts.map +1 -0
  9. package/build/components/AnimationContext.js +13 -0
  10. package/build/components/AnimationContext.js.map +1 -0
  11. package/build/components/App.d.ts +11 -49
  12. package/build/components/App.d.ts.map +1 -0
  13. package/build/components/App.js +412 -227
  14. package/build/components/App.js.map +1 -1
  15. package/build/components/AppContext.d.ts +33 -3
  16. package/build/components/AppContext.d.ts.map +1 -0
  17. package/build/components/AppContext.js +2 -1
  18. package/build/components/AppContext.js.map +1 -1
  19. package/build/components/BackgroundContext.d.ts.map +1 -0
  20. package/build/components/Box.d.ts +15 -8
  21. package/build/components/Box.d.ts.map +1 -0
  22. package/build/components/Box.js +12 -10
  23. package/build/components/Box.js.map +1 -1
  24. package/build/components/CursorContext.d.ts +11 -0
  25. package/build/components/CursorContext.d.ts.map +1 -0
  26. package/build/components/CursorContext.js +8 -0
  27. package/build/components/CursorContext.js.map +1 -0
  28. package/build/components/ErrorBoundary.d.ts +18 -0
  29. package/build/components/ErrorBoundary.d.ts.map +1 -0
  30. package/build/components/ErrorBoundary.js +23 -0
  31. package/build/components/ErrorBoundary.js.map +1 -0
  32. package/build/components/ErrorOverview.d.ts.map +1 -0
  33. package/build/components/ErrorOverview.js +6 -6
  34. package/build/components/ErrorOverview.js.map +1 -1
  35. package/build/components/FocusContext.d.ts.map +1 -0
  36. package/build/components/Newline.d.ts.map +1 -0
  37. package/build/components/Spacer.d.ts.map +1 -0
  38. package/build/components/Static.d.ts.map +1 -0
  39. package/build/components/Static.js.map +1 -1
  40. package/build/components/StderrContext.d.ts.map +1 -0
  41. package/build/components/StdinContext.d.ts +7 -1
  42. package/build/components/StdinContext.d.ts.map +1 -0
  43. package/build/components/StdinContext.js +1 -0
  44. package/build/components/StdinContext.js.map +1 -1
  45. package/build/components/StdoutContext.d.ts.map +1 -0
  46. package/build/components/Text.d.ts +1 -1
  47. package/build/components/Text.d.ts.map +1 -0
  48. package/build/components/Text.js +1 -1
  49. package/build/components/Text.js.map +1 -1
  50. package/build/components/Transform.d.ts +1 -1
  51. package/build/components/Transform.d.ts.map +1 -0
  52. package/build/cursor-helpers.d.ts +38 -0
  53. package/build/cursor-helpers.d.ts.map +1 -0
  54. package/build/cursor-helpers.js +56 -0
  55. package/build/cursor-helpers.js.map +1 -0
  56. package/build/devtools-window-polyfill.d.ts.map +1 -0
  57. package/build/devtools-window-polyfill.js +7 -4
  58. package/build/devtools-window-polyfill.js.map +1 -1
  59. package/build/devtools.d.ts.map +1 -0
  60. package/build/devtools.js +31 -6
  61. package/build/devtools.js.map +1 -1
  62. package/build/diagnostics.d.ts +5 -0
  63. package/build/diagnostics.d.ts.map +1 -0
  64. package/build/diagnostics.js +7 -0
  65. package/build/diagnostics.js.map +1 -0
  66. package/build/dom.d.ts +5 -1
  67. package/build/dom.d.ts.map +1 -0
  68. package/build/dom.js +20 -1
  69. package/build/dom.js.map +1 -1
  70. package/build/get-max-width.d.ts.map +1 -0
  71. package/build/hooks/use-animation.d.ts +49 -0
  72. package/build/hooks/use-animation.d.ts.map +1 -0
  73. package/build/hooks/use-animation.js +87 -0
  74. package/build/hooks/use-animation.js.map +1 -0
  75. package/build/hooks/use-app.d.ts +5 -2
  76. package/build/hooks/use-app.d.ts.map +1 -0
  77. package/build/hooks/use-app.js +1 -1
  78. package/build/hooks/use-box-metrics.d.ts +59 -0
  79. package/build/hooks/use-box-metrics.d.ts.map +1 -0
  80. package/build/hooks/use-box-metrics.js +88 -0
  81. package/build/hooks/use-box-metrics.js.map +1 -0
  82. package/build/hooks/use-cursor.d.ts +12 -0
  83. package/build/hooks/use-cursor.d.ts.map +1 -0
  84. package/build/hooks/use-cursor.js +29 -0
  85. package/build/hooks/use-cursor.js.map +1 -0
  86. package/build/hooks/use-focus-manager.d.ts +17 -2
  87. package/build/hooks/use-focus-manager.d.ts.map +1 -0
  88. package/build/hooks/use-focus-manager.js +2 -1
  89. package/build/hooks/use-focus-manager.js.map +1 -1
  90. package/build/hooks/use-focus.d.ts +2 -1
  91. package/build/hooks/use-focus.d.ts.map +1 -0
  92. package/build/hooks/use-focus.js +5 -4
  93. package/build/hooks/use-focus.js.map +1 -1
  94. package/build/hooks/use-input.d.ts +40 -1
  95. package/build/hooks/use-input.d.ts.map +1 -0
  96. package/build/hooks/use-input.js +65 -25
  97. package/build/hooks/use-input.js.map +1 -1
  98. package/build/hooks/use-is-screen-reader-enabled.d.ts +2 -1
  99. package/build/hooks/use-is-screen-reader-enabled.d.ts.map +1 -0
  100. package/build/hooks/use-is-screen-reader-enabled.js +2 -1
  101. package/build/hooks/use-is-screen-reader-enabled.js.map +1 -1
  102. package/build/hooks/use-paste.d.ts +35 -0
  103. package/build/hooks/use-paste.d.ts.map +1 -0
  104. package/build/hooks/use-paste.js +66 -0
  105. package/build/hooks/use-paste.js.map +1 -0
  106. package/build/hooks/use-stderr.d.ts +1 -1
  107. package/build/hooks/use-stderr.d.ts.map +1 -0
  108. package/build/hooks/use-stderr.js +1 -1
  109. package/build/hooks/use-stdin.d.ts +4 -2
  110. package/build/hooks/use-stdin.d.ts.map +1 -0
  111. package/build/hooks/use-stdin.js +2 -1
  112. package/build/hooks/use-stdin.js.map +1 -1
  113. package/build/hooks/use-stdout.d.ts +1 -1
  114. package/build/hooks/use-stdout.d.ts.map +1 -0
  115. package/build/hooks/use-stdout.js +1 -1
  116. package/build/hooks/use-window-size.d.ts +18 -0
  117. package/build/hooks/use-window-size.d.ts.map +1 -0
  118. package/build/hooks/use-window-size.js +22 -0
  119. package/build/hooks/use-window-size.js.map +1 -0
  120. package/build/index.d.ts +16 -1
  121. package/build/index.d.ts.map +1 -0
  122. package/build/index.js +8 -0
  123. package/build/index.js.map +1 -1
  124. package/build/ink.d.ts +94 -5
  125. package/build/ink.d.ts.map +1 -0
  126. package/build/ink.js +586 -81
  127. package/build/ink.js.map +1 -1
  128. package/build/input-parser.d.ts +10 -0
  129. package/build/input-parser.d.ts.map +1 -0
  130. package/build/input-parser.js +194 -0
  131. package/build/input-parser.js.map +1 -0
  132. package/build/instances.d.ts.map +1 -0
  133. package/build/kitty-keyboard.d.ts +23 -0
  134. package/build/kitty-keyboard.d.ts.map +1 -0
  135. package/build/kitty-keyboard.js +32 -0
  136. package/build/kitty-keyboard.js.map +1 -0
  137. package/build/log-update.d.ts +7 -1
  138. package/build/log-update.d.ts.map +1 -0
  139. package/build/log-update.js +181 -56
  140. package/build/log-update.js.map +1 -1
  141. package/build/measure-element.d.ts +15 -3
  142. package/build/measure-element.d.ts.map +1 -0
  143. package/build/measure-element.js +31 -5
  144. package/build/measure-element.js.map +1 -1
  145. package/build/measure-text.d.ts +2 -0
  146. package/build/measure-text.d.ts.map +1 -0
  147. package/build/measure-text.js +13 -11
  148. package/build/measure-text.js.map +1 -1
  149. package/build/output.d.ts +2 -1
  150. package/build/output.d.ts.map +1 -0
  151. package/build/output.js +62 -58
  152. package/build/output.js.map +1 -1
  153. package/build/parse-keypress.d.ts +9 -3
  154. package/build/parse-keypress.d.ts.map +1 -0
  155. package/build/parse-keypress.js +283 -13
  156. package/build/parse-keypress.js.map +1 -1
  157. package/build/reconciler.d.ts.map +1 -0
  158. package/build/reconciler.js +57 -37
  159. package/build/reconciler.js.map +1 -1
  160. package/build/render-background.d.ts.map +1 -0
  161. package/build/render-background.js +2 -0
  162. package/build/render-background.js.map +1 -1
  163. package/build/render-border.d.ts +1 -1
  164. package/build/render-border.d.ts.map +1 -0
  165. package/build/render-border.js +35 -24
  166. package/build/render-border.js.map +1 -1
  167. package/build/render-node-to-output.d.ts +1 -1
  168. package/build/render-node-to-output.d.ts.map +1 -0
  169. package/build/render-node-to-output.js +35 -18
  170. package/build/render-node-to-output.js.map +1 -1
  171. package/build/render-to-string.d.ts +38 -0
  172. package/build/render-to-string.d.ts.map +1 -0
  173. package/build/render-to-string.js +116 -0
  174. package/build/render-to-string.js.map +1 -0
  175. package/build/render.d.ts +91 -3
  176. package/build/render.d.ts.map +1 -0
  177. package/build/render.js +17 -5
  178. package/build/render.js.map +1 -1
  179. package/build/renderer.d.ts.map +1 -0
  180. package/build/sanitize-ansi.d.ts +2 -0
  181. package/build/sanitize-ansi.d.ts.map +1 -0
  182. package/build/sanitize-ansi.js +27 -0
  183. package/build/sanitize-ansi.js.map +1 -0
  184. package/build/squash-text-nodes.d.ts.map +1 -0
  185. package/build/squash-text-nodes.js +18 -1
  186. package/build/squash-text-nodes.js.map +1 -1
  187. package/build/styles.d.ts +75 -37
  188. package/build/styles.d.ts.map +1 -0
  189. package/build/styles.js +87 -44
  190. package/build/styles.js.map +1 -1
  191. package/build/utils.d.ts +9 -2
  192. package/build/utils.d.ts.map +1 -0
  193. package/build/utils.js +18 -3
  194. package/build/utils.js.map +1 -1
  195. package/build/wrap-text.d.ts +2 -0
  196. package/build/wrap-text.d.ts.map +1 -0
  197. package/build/wrap-text.js +21 -18
  198. package/build/wrap-text.js.map +1 -1
  199. package/build/write-synchronized.d.ts +4 -0
  200. package/build/write-synchronized.d.ts.map +1 -0
  201. package/build/write-synchronized.js +9 -0
  202. package/build/write-synchronized.js.map +1 -0
  203. package/package.json +46 -106
  204. package/readme.md +850 -64
  205. package/build/components/FixedLayout.d.ts +0 -12
  206. package/build/components/FixedLayout.js +0 -19
  207. package/build/components/FixedLayout.js.map +0 -1
  208. package/build/components/VirtualizedList.d.ts +0 -21
  209. package/build/components/VirtualizedList.js +0 -55
  210. package/build/components/VirtualizedList.js.map +0 -1
  211. package/build/hooks/use-mouse.d.ts +0 -15
  212. package/build/hooks/use-mouse.js +0 -121
  213. package/build/hooks/use-mouse.js.map +0 -1
  214. package/build/hooks/use-virtualization.d.ts +0 -19
  215. package/build/hooks/use-virtualization.js +0 -56
  216. package/build/hooks/use-virtualization.js.map +0 -1
@@ -0,0 +1,56 @@
1
+ import ansiEscapes from 'ansi-escapes';
2
+ const showCursorEscape = '\u001B[?25h';
3
+ const hideCursorEscape = '\u001B[?25l';
4
+ export { showCursorEscape, hideCursorEscape };
5
+ /**
6
+ Compare two cursor positions. Returns true if they differ.
7
+ */
8
+ export const cursorPositionChanged = (a, b) => a?.x !== b?.x || a?.y !== b?.y;
9
+ /**
10
+ Build escape sequence to move cursor from bottom of output to the target position and show it.
11
+ Assumes cursor is at (col 0, line visibleLineCount) — i.e. just after the last output line.
12
+ */
13
+ export const buildCursorSuffix = (visibleLineCount, cursorPosition) => {
14
+ if (!cursorPosition) {
15
+ return '';
16
+ }
17
+ const moveUp = visibleLineCount - cursorPosition.y;
18
+ return ((moveUp > 0 ? ansiEscapes.cursorUp(moveUp) : '') +
19
+ ansiEscapes.cursorTo(cursorPosition.x) +
20
+ showCursorEscape);
21
+ };
22
+ /**
23
+ Build escape sequence to move cursor from previousCursorPosition back to the bottom of output.
24
+ This must be done before eraseLines or any operation that assumes cursor is at the bottom.
25
+ */
26
+ export const buildReturnToBottom = (previousLineCount, previousCursorPosition) => {
27
+ if (!previousCursorPosition) {
28
+ return '';
29
+ }
30
+ // PreviousLineCount includes trailing newline, so visible lines = previousLineCount - 1
31
+ // cursor is at previousCursorPosition.y, need to go to line (previousLineCount - 1)
32
+ const down = previousLineCount - 1 - previousCursorPosition.y;
33
+ return ((down > 0 ? ansiEscapes.cursorDown(down) : '') + ansiEscapes.cursorTo(0));
34
+ };
35
+ /**
36
+ Build the escape sequence for cursor-only updates (output unchanged, cursor moved).
37
+ Hides cursor if it was previously shown, returns to bottom, then repositions.
38
+ */
39
+ export const buildCursorOnlySequence = (input) => {
40
+ const hidePrefix = input.cursorWasShown ? hideCursorEscape : '';
41
+ const returnToBottom = buildReturnToBottom(input.previousLineCount, input.previousCursorPosition);
42
+ const cursorSuffix = buildCursorSuffix(input.visibleLineCount, input.cursorPosition);
43
+ return hidePrefix + returnToBottom + cursorSuffix;
44
+ };
45
+ /**
46
+ Build the prefix that hides cursor and returns to bottom before erasing or rewriting.
47
+ Returns empty string if cursor was not shown.
48
+ */
49
+ export const buildReturnToBottomPrefix = (cursorWasShown, previousLineCount, previousCursorPosition) => {
50
+ if (!cursorWasShown) {
51
+ return '';
52
+ }
53
+ return (hideCursorEscape +
54
+ buildReturnToBottom(previousLineCount, previousCursorPosition));
55
+ };
56
+ //# sourceMappingURL=cursor-helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cursor-helpers.js","sourceRoot":"","sources":["../src/cursor-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAOvC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC,OAAO,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,CAAC;AAE5C;;EAEE;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,CAA6B,EAC7B,CAA6B,EACnB,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE7C;;;EAGE;AACF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,gBAAwB,EACxB,cAA0C,EACjC,EAAE;IACX,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,GAAG,cAAc,CAAC,CAAC,CAAC;IACnD,OAAO,CACN,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QACtC,gBAAgB,CAChB,CAAC;AACH,CAAC,CAAC;AAEF;;;EAGE;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAClC,iBAAyB,EACzB,sBAAkD,EACzC,EAAE;IACX,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,wFAAwF;IACxF,oFAAoF;IACpF,MAAM,IAAI,GAAG,iBAAiB,GAAG,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;IAC9D,OAAO,CACN,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CACxE,CAAC;AACH,CAAC,CAAC;AAUF;;;EAGE;AACF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAsB,EAAU,EAAE;IACzE,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,cAAc,GAAG,mBAAmB,CACzC,KAAK,CAAC,iBAAiB,EACvB,KAAK,CAAC,sBAAsB,CAC5B,CAAC;IACF,MAAM,YAAY,GAAG,iBAAiB,CACrC,KAAK,CAAC,gBAAgB,EACtB,KAAK,CAAC,cAAc,CACpB,CAAC;IACF,OAAO,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;AACnD,CAAC,CAAC;AAEF;;;EAGE;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACxC,cAAuB,EACvB,iBAAyB,EACzB,sBAAkD,EACzC,EAAE;IACX,IAAI,CAAC,cAAc,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,CACN,gBAAgB;QAChB,mBAAmB,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAC9D,CAAC;AACH,CAAC,CAAC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devtools-window-polyfill.d.ts","sourceRoot":"","sources":["../src/devtools-window-polyfill.ts"],"names":[],"mappings":""}
@@ -1,12 +1,15 @@
1
1
  // Ignoring missing types error to avoid adding another dependency for this hack to work
2
2
  import ws from 'ws';
3
3
  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
4
- const customGlobal = global;
4
+ const customGlobal = globalThis;
5
5
  // These things must exist before importing `react-devtools-core`
6
- // eslint-disable-next-line n/no-unsupported-features/node-builtins
6
+ // Using ||= intentionally to set falsy values, not just null/undefined
7
+ // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
7
8
  customGlobal.WebSocket ||= ws;
8
- customGlobal.window ||= global;
9
- customGlobal.self ||= global;
9
+ // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
10
+ customGlobal.window ||= globalThis;
11
+ // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
12
+ customGlobal.self ||= globalThis;
10
13
  // Filter out Ink's internal components from devtools for a cleaner view.
11
14
  // Also, ince `react-devtools-shared` package isn't published on npm, we can't
12
15
  // use its types, that's why there are hard-coded values in `type` fields below.
@@ -1 +1 @@
1
- {"version":3,"file":"devtools-window-polyfill.js","sourceRoot":"","sources":["../src/devtools-window-polyfill.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,mEAAmE;AACnE,MAAM,YAAY,GAAG,MAAa,CAAC;AAEnC,iEAAiE;AAEjE,mEAAmE;AACnE,YAAY,CAAC,SAAS,KAAK,EAAE,CAAC;AAE9B,YAAY,CAAC,MAAM,KAAK,MAAM,CAAC;AAE/B,YAAY,CAAC,IAAI,KAAK,MAAM,CAAC;AAE7B,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,sIAAsI;AACtI,YAAY,CAAC,MAAM,CAAC,oCAAoC,GAAG;IAC1D;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,2BAA2B;QAC3B,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,IAAI;KACf;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;CACD,CAAC"}
1
+ {"version":3,"file":"devtools-window-polyfill.js","sourceRoot":"","sources":["../src/devtools-window-polyfill.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,mEAAmE;AACnE,MAAM,YAAY,GAAG,UAAiB,CAAC;AAEvC,iEAAiE;AACjE,uEAAuE;AAEvE,wEAAwE;AACxE,YAAY,CAAC,SAAS,KAAK,EAAE,CAAC;AAE9B,wEAAwE;AACxE,YAAY,CAAC,MAAM,KAAK,UAAU,CAAC;AAEnC,wEAAwE;AACxE,YAAY,CAAC,IAAI,KAAK,UAAU,CAAC;AAEjC,yEAAyE;AACzE,8EAA8E;AAC9E,gFAAgF;AAChF,sIAAsI;AACtI,YAAY,CAAC,MAAM,CAAC,oCAAoC,GAAG;IAC1D;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,2BAA2B;QAC3B,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,IAAI;KACf;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,uBAAuB;QAC9B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;IACD;QACC,6BAA6B;QAC7B,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;KACb;CACD,CAAC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAGA,OAAO,+BAA+B,CAAC"}
package/build/devtools.js CHANGED
@@ -1,11 +1,36 @@
1
- /* eslint-disable import/order */
2
- // eslint-disable-next-line import/no-unassigned-import
1
+ /* eslint-disable import-x/order */
2
+ // eslint-disable-next-line import-x/no-unassigned-import
3
3
  import './devtools-window-polyfill.js';
4
+ import WebSocket from 'ws';
4
5
  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
5
6
  // @ts-expect-error
6
7
  import devtools from 'react-devtools-core';
7
- // eslint-disable-next-line @typescript-eslint/no-unsafe-call
8
- devtools.initialize();
9
- // eslint-disable-next-line @typescript-eslint/no-unsafe-call
10
- devtools.connectToDevTools();
8
+ const isDevToolsReachable = async () => new Promise(resolve => {
9
+ const socket = new WebSocket('ws://localhost:8097');
10
+ const timeout = setTimeout(() => {
11
+ socket.terminate();
12
+ resolve(false);
13
+ }, 2000);
14
+ // Don't let the timeout keep the process alive on its own
15
+ timeout.unref();
16
+ socket.on('open', () => {
17
+ clearTimeout(timeout);
18
+ socket.terminate();
19
+ resolve(true);
20
+ });
21
+ socket.on('error', () => {
22
+ clearTimeout(timeout);
23
+ socket.terminate();
24
+ resolve(false);
25
+ });
26
+ });
27
+ if (await isDevToolsReachable()) {
28
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-call
29
+ devtools.initialize();
30
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-call
31
+ devtools.connectToDevTools();
32
+ }
33
+ else {
34
+ console.warn('DEV is set to true, but the React DevTools server is not running. Start it with:\n\n$ npx react-devtools\n');
35
+ }
11
36
  //# sourceMappingURL=devtools.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,uDAAuD;AACvD,OAAO,+BAA+B,CAAC;AAEvC,6DAA6D;AAC7D,mBAAmB;AACnB,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAE3C,6DAA6D;AAC5D,QAAgB,CAAC,UAAU,EAAE,CAAC;AAC/B,6DAA6D;AAC5D,QAAgB,CAAC,iBAAiB,EAAE,CAAC"}
1
+ {"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,yDAAyD;AACzD,OAAO,+BAA+B,CAAC;AAEvC,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,6DAA6D;AAC7D,mBAAmB;AACnB,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAE3C,MAAM,mBAAmB,GAAG,KAAK,IAAsB,EAAE,CACxD,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;QAC/B,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,EAAE,IAAI,CAAC,CAAC;IACT,0DAA0D;IAC1D,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACvB,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEJ,IAAI,MAAM,mBAAmB,EAAE,EAAE,CAAC;IACjC,6DAA6D;IAC5D,QAAgB,CAAC,UAAU,EAAE,CAAC;IAC/B,6DAA6D;IAC5D,QAAgB,CAAC,iBAAiB,EAAE,CAAC;AACvC,CAAC;KAAM,CAAC;IACP,OAAO,CAAC,IAAI,CACX,4GAA4G,CAC5G,CAAC;AACH,CAAC"}
@@ -0,0 +1,5 @@
1
+ export type InkCacheSizes = {
2
+ measureText: number;
3
+ wrapText: number;
4
+ };
5
+ export declare const getInkCacheSizes: () => InkCacheSizes;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,aAGlC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { getMeasureTextCacheSize } from './measure-text.js';
2
+ import { getWrapTextCacheSize } from './wrap-text.js';
3
+ export const getInkCacheSizes = () => ({
4
+ measureText: getMeasureTextCacheSize(),
5
+ wrapText: getWrapTextCacheSize(),
6
+ });
7
+ //# sourceMappingURL=diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAC,oBAAoB,EAAC,MAAM,gBAAgB,CAAC;AAOpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACrD,WAAW,EAAE,uBAAuB,EAAE;IACtC,QAAQ,EAAE,oBAAoB,EAAE;CAChC,CAAC,CAAC"}
package/build/dom.d.ts CHANGED
@@ -7,6 +7,7 @@ type InkNode = {
7
7
  internal_static?: boolean;
8
8
  style: Styles;
9
9
  };
10
+ type LayoutListener = () => void;
10
11
  export type TextName = '#text';
11
12
  export type ElementNames = 'ink-root' | 'ink-box' | 'ink-text' | 'ink-virtual-text';
12
13
  export type NodeNames = ElementNames | TextName;
@@ -34,6 +35,7 @@ export type DOMElement = {
34
35
  onComputeLayout?: () => void;
35
36
  onRender?: () => void;
36
37
  onImmediateRender?: () => void;
38
+ internal_layoutListeners?: Set<LayoutListener>;
37
39
  internal_scrollOffset?: {
38
40
  x: number;
39
41
  y: number;
@@ -55,7 +57,9 @@ export declare const appendChildNode: (node: DOMElement, childNode: DOMElement)
55
57
  export declare const insertBeforeNode: (node: DOMElement, newChildNode: DOMNode, beforeChildNode: DOMNode) => void;
56
58
  export declare const removeChildNode: (node: DOMElement, removeNode: DOMNode) => void;
57
59
  export declare const setAttribute: (node: DOMElement, key: string, value: DOMNodeAttribute) => void;
58
- export declare const setStyle: (node: DOMNode, style: Styles) => void;
60
+ export declare const setStyle: (node: DOMNode, style?: Styles) => void;
59
61
  export declare const createTextNode: (text: string) => TextNode;
60
62
  export declare const setTextNodeValue: (node: TextNode, text: string) => void;
63
+ export declare const addLayoutListener: (rootNode: DOMElement, listener: LayoutListener) => (() => void);
64
+ export declare const emitLayoutListeners: (rootNode: DOMElement) => void;
61
65
  export {};
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}
package/build/dom.js CHANGED
@@ -74,7 +74,8 @@ export const setAttribute = (node, key, value) => {
74
74
  node.attributes[key] = value;
75
75
  };
76
76
  export const setStyle = (node, style) => {
77
- node.style = style;
77
+ // Rendering code assumes style is always an object.
78
+ node.style = style ?? {};
78
79
  };
79
80
  export const createTextNode = (text) => {
80
81
  const node = {
@@ -121,4 +122,22 @@ export const setTextNodeValue = (node, text) => {
121
122
  node.nodeValue = text;
122
123
  markNodeAsDirty(node);
123
124
  };
125
+ export const addLayoutListener = (rootNode, listener) => {
126
+ if (rootNode.nodeName !== 'ink-root') {
127
+ return () => { };
128
+ }
129
+ rootNode.internal_layoutListeners ??= new Set();
130
+ rootNode.internal_layoutListeners.add(listener);
131
+ return () => {
132
+ rootNode.internal_layoutListeners?.delete(listener);
133
+ };
134
+ };
135
+ export const emitLayoutListeners = (rootNode) => {
136
+ if (rootNode.nodeName !== 'ink-root' || !rootNode.internal_layoutListeners) {
137
+ return;
138
+ }
139
+ for (const listener of rootNode.internal_layoutListeners) {
140
+ listener();
141
+ }
142
+ };
124
143
  //# sourceMappingURL=dom.js.map
package/build/dom.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-max-width.d.ts","sourceRoot":"","sources":["../src/get-max-width.ts"],"names":[],"mappings":"AAAA,OAAa,EAAC,KAAK,IAAI,IAAI,QAAQ,EAAC,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,WAAW,GAAI,UAAU,QAAQ,WAQtC,CAAC;AAEF,eAAe,WAAW,CAAC"}
@@ -0,0 +1,49 @@
1
+ type Options = {
2
+ /**
3
+ Time between ticks in milliseconds.
4
+
5
+ @default 100
6
+ */
7
+ readonly interval?: number;
8
+ /**
9
+ Whether the animation is running. When set to `false`, the animation stops. When toggled back to `true`, all values reset to `0`.
10
+
11
+ @default true
12
+ */
13
+ readonly isActive?: boolean;
14
+ };
15
+ export type AnimationResult = {
16
+ /**
17
+ Discrete counter that increments by 1 each interval. Useful for indexed sequences like spinner frames.
18
+ */
19
+ readonly frame: number;
20
+ /**
21
+ Total elapsed time in milliseconds since the animation started or was last reset. Useful for continuous math-based animations like sine waves: `Math.sin(time / 1000 * Math.PI * 2)`.
22
+ */
23
+ readonly time: number;
24
+ /**
25
+ Time in milliseconds since the previous rendered tick. Accounts for throttled renders. Useful for physics-based or velocity-driven motion: `position += speed * delta`.
26
+ */
27
+ readonly delta: number;
28
+ /**
29
+ Resets `frame`, `time`, and `delta` to `0` and restarts timing from the current moment. Useful for one-shot animations triggered by events.
30
+ */
31
+ readonly reset: () => void;
32
+ };
33
+ /**
34
+ A React hook that drives animations. Returns a frame counter, elapsed time, frame delta, and a reset function. All animations share a single timer internally, so multiple animated components consolidate into one render cycle.
35
+
36
+ @example
37
+ ```
38
+ import {Text, useAnimation} from 'ink';
39
+
40
+ const Spinner = () => {
41
+ const {frame} = useAnimation({interval: 80});
42
+ const characters = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
43
+
44
+ return <Text>{characters[frame % characters.length]}</Text>;
45
+ };
46
+ ```
47
+ */
48
+ export default function useAnimation(options?: Options): AnimationResult;
49
+ export {};
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-animation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-animation.ts"],"names":[],"mappings":"AAaA,KAAK,OAAO,GAAG;IACd;;;;MAIE;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;MAIE;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B;;MAEE;IACF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;MAEE;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;MAEE;IACF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;MAEE;IACF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;EAcE;AACF,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,eAAe,CA4EvE"}
@@ -0,0 +1,87 @@
1
+ import { useState, useLayoutEffect, useRef, useCallback, useContext, } from 'react';
2
+ import AnimationContext from '../components/AnimationContext.js';
3
+ const defaultAnimationInterval = 100;
4
+ const maximumTimerInterval = 2_147_483_647;
5
+ const zeroAnimState = { frame: 0, time: 0, delta: 0 };
6
+ /**
7
+ A React hook that drives animations. Returns a frame counter, elapsed time, frame delta, and a reset function. All animations share a single timer internally, so multiple animated components consolidate into one render cycle.
8
+
9
+ @example
10
+ ```
11
+ import {Text, useAnimation} from 'ink';
12
+
13
+ const Spinner = () => {
14
+ const {frame} = useAnimation({interval: 80});
15
+ const characters = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
16
+
17
+ return <Text>{characters[frame % characters.length]}</Text>;
18
+ };
19
+ ```
20
+ */
21
+ export default function useAnimation(options) {
22
+ const { interval = defaultAnimationInterval, isActive = true } = options ?? {};
23
+ const safeInterval = normalizeAnimationInterval(interval);
24
+ const { subscribe, renderThrottleMs } = useContext(AnimationContext);
25
+ const [resetKey, setResetKey] = useState(0);
26
+ const [animState, setAnimState] = useState(zeroAnimState);
27
+ const nextRenderTimeRef = useRef(0);
28
+ const lastRenderTimeRef = useRef(0);
29
+ const previousOptionsRef = useRef({ isActive, safeInterval, resetKey });
30
+ const previousOptions = previousOptionsRef.current;
31
+ const shouldReset = isActive &&
32
+ (safeInterval !== previousOptions.safeInterval ||
33
+ !previousOptions.isActive ||
34
+ resetKey !== previousOptions.resetKey);
35
+ const reset = useCallback(() => {
36
+ setResetKey(k => k + 1);
37
+ }, []);
38
+ useLayoutEffect(() => {
39
+ if (!isActive) {
40
+ return;
41
+ }
42
+ // Reset to zero immediately so any render that occurs between this
43
+ // effect commit and the first tick shows zeros, not stale values.
44
+ // On initial mount this is a no-op: Object.is bails out because the
45
+ // state was initialized with the same zeroAnimState reference.
46
+ setAnimState(zeroAnimState);
47
+ let startTime = 0;
48
+ const { startTime: subscriberStartTime, unsubscribe } = subscribe(currentTime => {
49
+ const isThrottled = renderThrottleMs > 0 && currentTime < nextRenderTimeRef.current;
50
+ if (isThrottled) {
51
+ // Coalesce intermediate ticks while Ink is inside the current
52
+ // render-throttle window; the next allowed render will jump
53
+ // straight to the latest elapsed values.
54
+ return;
55
+ }
56
+ const elapsed = currentTime - startTime;
57
+ const nextDelta = currentTime - lastRenderTimeRef.current;
58
+ lastRenderTimeRef.current = currentTime;
59
+ nextRenderTimeRef.current = currentTime + renderThrottleMs;
60
+ setAnimState({
61
+ frame: Math.floor(elapsed / safeInterval),
62
+ time: elapsed,
63
+ delta: nextDelta,
64
+ });
65
+ }, safeInterval);
66
+ // Use the scheduler's start time instead of sampling our own clock so the
67
+ // first delivered tick cannot start one frame late.
68
+ startTime = subscriberStartTime;
69
+ lastRenderTimeRef.current = subscriberStartTime;
70
+ nextRenderTimeRef.current = startTime + renderThrottleMs;
71
+ return unsubscribe;
72
+ }, [safeInterval, isActive, subscribe, renderThrottleMs, resetKey]);
73
+ useLayoutEffect(() => {
74
+ previousOptionsRef.current = { isActive, safeInterval, resetKey };
75
+ }, [isActive, safeInterval, resetKey]);
76
+ if (shouldReset) {
77
+ return { ...zeroAnimState, reset };
78
+ }
79
+ return { ...animState, reset };
80
+ }
81
+ function normalizeAnimationInterval(interval) {
82
+ if (!Number.isFinite(interval)) {
83
+ return defaultAnimationInterval;
84
+ }
85
+ return Math.min(maximumTimerInterval, Math.max(1, interval));
86
+ }
87
+ //# sourceMappingURL=use-animation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-animation.js","sourceRoot":"","sources":["../../src/hooks/use-animation.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,8 @@
1
1
  /**
2
- `useApp` is a React hook that exposes a method to manually exit the app (unmount).
2
+ A React hook that returns app lifecycle methods like `exit()` and `waitUntilRenderFlush()`.
3
3
  */
4
- declare const useApp: () => import("../components/AppContext.js").Props;
4
+ declare const useApp: () => {
5
+ exit(): void;
6
+ waitUntilRenderFlush(): Promise<void>;
7
+ };
5
8
  export default useApp;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-app.d.ts","sourceRoot":"","sources":["../../src/hooks/use-app.ts"],"names":[],"mappings":"AAGA;;EAEE;AACF,QAAA,MAAM,MAAM;;;CAA+B,CAAC;AAC5C,eAAe,MAAM,CAAC"}
@@ -1,7 +1,7 @@
1
1
  import { useContext } from 'react';
2
2
  import AppContext from '../components/AppContext.js';
3
3
  /**
4
- `useApp` is a React hook that exposes a method to manually exit the app (unmount).
4
+ A React hook that returns app lifecycle methods like `exit()` and `waitUntilRenderFlush()`.
5
5
  */
6
6
  const useApp = () => useContext(AppContext);
7
7
  export default useApp;
@@ -0,0 +1,59 @@
1
+ import { type RefObject } from 'react';
2
+ import { type DOMElement } from '../dom.js';
3
+ /**
4
+ Metrics of a box element.
5
+
6
+ All positions are relative to the element's parent.
7
+ */
8
+ export type BoxMetrics = {
9
+ /**
10
+ Element width.
11
+ */
12
+ readonly width: number;
13
+ /**
14
+ Element height.
15
+ */
16
+ readonly height: number;
17
+ /**
18
+ Distance from the left edge of the parent.
19
+ */
20
+ readonly left: number;
21
+ /**
22
+ Distance from the top edge of the parent.
23
+ */
24
+ readonly top: number;
25
+ };
26
+ export type UseBoxMetricsResult = BoxMetrics & {
27
+ /**
28
+ Whether the currently tracked element has been measured in the latest layout pass.
29
+ */
30
+ readonly hasMeasured: boolean;
31
+ };
32
+ /**
33
+ A React hook that returns the current layout metrics for a tracked box element.
34
+ It updates when layout changes (for example terminal resize, sibling/content changes, or position changes).
35
+
36
+ The hook returns `{width: 0, height: 0, left: 0, top: 0}` until the first layout pass completes. It also returns zeros when the tracked ref is detached.
37
+
38
+ Use `hasMeasured` to detect when the currently tracked element has been measured.
39
+
40
+ @example
41
+ ```tsx
42
+ import {useRef} from 'react';
43
+ import {Box, Text, useBoxMetrics} from 'ink';
44
+
45
+ const Example = () => {
46
+ const ref = useRef(null);
47
+ const {width, height, left, top, hasMeasured} = useBoxMetrics(ref);
48
+ return (
49
+ <Box ref={ref}>
50
+ <Text>
51
+ {hasMeasured ? `${width}x${height} at ${left},${top}` : 'Measuring...'}
52
+ </Text>
53
+ </Box>
54
+ );
55
+ };
56
+ ```
57
+ */
58
+ declare const useBoxMetrics: (ref: RefObject<DOMElement>) => UseBoxMetricsResult;
59
+ export default useBoxMetrics;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-box-metrics.d.ts","sourceRoot":"","sources":["../../src/hooks/use-box-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAC;AAChF,OAAO,EAAC,KAAK,UAAU,EAAoB,MAAM,WAAW,CAAC;AAI7D;;;;EAIE;AACF,MAAM,MAAM,UAAU,GAAG;IACxB;;MAEE;IACF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;MAEE;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;MAEE;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;MAEE;IACF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG;IAC9C;;MAEE;IACF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC9B,CAAC;AAqBF;;;;;;;;;;;;;;;;;;;;;;;;;EAyBE;AACF,QAAA,MAAM,aAAa,GAAI,KAAK,SAAS,CAAC,UAAU,CAAC,KAAG,mBAwDnD,CAAC;AAEF,eAAe,aAAa,CAAC"}
@@ -0,0 +1,88 @@
1
+ import { useState, useEffect, useCallback, useMemo } from 'react';
2
+ import { addLayoutListener } from '../dom.js';
3
+ import useStdout from './use-stdout.js';
4
+ const emptyMetrics = {
5
+ width: 0,
6
+ height: 0,
7
+ left: 0,
8
+ top: 0,
9
+ };
10
+ const findRootNode = (node) => {
11
+ if (!node) {
12
+ return undefined;
13
+ }
14
+ if (!node.parentNode) {
15
+ return node.nodeName === 'ink-root' ? node : undefined;
16
+ }
17
+ return findRootNode(node.parentNode);
18
+ };
19
+ /**
20
+ A React hook that returns the current layout metrics for a tracked box element.
21
+ It updates when layout changes (for example terminal resize, sibling/content changes, or position changes).
22
+
23
+ The hook returns `{width: 0, height: 0, left: 0, top: 0}` until the first layout pass completes. It also returns zeros when the tracked ref is detached.
24
+
25
+ Use `hasMeasured` to detect when the currently tracked element has been measured.
26
+
27
+ @example
28
+ ```tsx
29
+ import {useRef} from 'react';
30
+ import {Box, Text, useBoxMetrics} from 'ink';
31
+
32
+ const Example = () => {
33
+ const ref = useRef(null);
34
+ const {width, height, left, top, hasMeasured} = useBoxMetrics(ref);
35
+ return (
36
+ <Box ref={ref}>
37
+ <Text>
38
+ {hasMeasured ? `${width}x${height} at ${left},${top}` : 'Measuring...'}
39
+ </Text>
40
+ </Box>
41
+ );
42
+ };
43
+ ```
44
+ */
45
+ const useBoxMetrics = (ref) => {
46
+ const [metrics, setMetrics] = useState(emptyMetrics);
47
+ const [hasMeasured, setHasMeasured] = useState(false);
48
+ const { stdout } = useStdout();
49
+ const updateMetrics = useCallback(() => {
50
+ const layout = ref.current?.yogaNode?.getComputedLayout() ?? emptyMetrics;
51
+ setMetrics(previousMetrics => {
52
+ const hasChanged = previousMetrics.width !== layout.width ||
53
+ previousMetrics.height !== layout.height ||
54
+ previousMetrics.left !== layout.left ||
55
+ previousMetrics.top !== layout.top;
56
+ return hasChanged ? layout : previousMetrics;
57
+ });
58
+ setHasMeasured(Boolean(ref.current));
59
+ }, [ref]);
60
+ // Runs after every render of this component.
61
+ // This keeps metrics fresh when local state/props in this subtree change.
62
+ useEffect(updateMetrics);
63
+ // Subscribe to root layout commits so memoized components still receive
64
+ // sibling-driven position/size updates, even when they skip re-rendering.
65
+ useEffect(() => {
66
+ const rootNode = findRootNode(ref.current);
67
+ if (!rootNode) {
68
+ return;
69
+ }
70
+ return addLayoutListener(rootNode, updateMetrics);
71
+ });
72
+ // Terminal resize events do not go through React's render cycle. Ink
73
+ // recalculates Yoga layout in its own resize handler — registered in the
74
+ // Ink constructor, before this hook mounts — so by the time the resize
75
+ // callback runs, Yoga has already computed the post-resize metrics.
76
+ useEffect(() => {
77
+ stdout.on('resize', updateMetrics);
78
+ return () => {
79
+ stdout.off('resize', updateMetrics);
80
+ };
81
+ }, [stdout, updateMetrics]);
82
+ return useMemo(() => ({
83
+ ...metrics,
84
+ hasMeasured,
85
+ }), [metrics, hasMeasured]);
86
+ };
87
+ export default useBoxMetrics;
88
+ //# sourceMappingURL=use-box-metrics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-box-metrics.js","sourceRoot":"","sources":["../../src/hooks/use-box-metrics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import { type CursorPosition } from '../log-update.js';
2
+ /**
3
+ A React hook that returns methods to control the terminal cursor position.
4
+
5
+ Setting a cursor position makes the cursor visible at the specified coordinates (relative to the Ink output origin). This is useful for IME (Input Method Editor) support, where the composing character is displayed at the cursor location.
6
+
7
+ Pass `undefined` to hide the cursor.
8
+ */
9
+ declare const useCursor: () => {
10
+ setCursorPosition: (position: CursorPosition | undefined) => void;
11
+ };
12
+ export default useCursor;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-cursor.d.ts","sourceRoot":"","sources":["../../src/hooks/use-cursor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAErD;;;;;;EAME;AACF,QAAA,MAAM,SAAS;kCAKF,cAAc,GAAG,SAAS;CAkBtC,CAAC;AAEF,eAAe,SAAS,CAAC"}