ink 6.7.0 → 7.0.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 (132) hide show
  1. package/build/ansi-tokenizer.d.ts +38 -0
  2. package/build/ansi-tokenizer.js +316 -0
  3. package/build/ansi-tokenizer.js.map +1 -0
  4. package/build/components/AnimationContext.d.ts +9 -0
  5. package/build/components/AnimationContext.js +13 -0
  6. package/build/components/AnimationContext.js.map +1 -0
  7. package/build/components/App.d.ts +5 -2
  8. package/build/components/App.js +192 -41
  9. package/build/components/App.js.map +1 -1
  10. package/build/components/AppContext.d.ts +33 -3
  11. package/build/components/AppContext.js +2 -1
  12. package/build/components/AppContext.js.map +1 -1
  13. package/build/components/Box.d.ts +16 -3
  14. package/build/components/ErrorBoundary.d.ts +2 -2
  15. package/build/components/ErrorOverview.js +6 -6
  16. package/build/components/ErrorOverview.js.map +1 -1
  17. package/build/components/Static.js.map +1 -1
  18. package/build/components/StdinContext.d.ts +7 -1
  19. package/build/components/StdinContext.js +1 -0
  20. package/build/components/StdinContext.js.map +1 -1
  21. package/build/components/Text.d.ts +1 -1
  22. package/build/components/Text.js +1 -1
  23. package/build/components/Text.js.map +1 -1
  24. package/build/components/Transform.d.ts +1 -1
  25. package/build/devtools-window-polyfill.js +7 -4
  26. package/build/devtools-window-polyfill.js.map +1 -1
  27. package/build/devtools.js +31 -6
  28. package/build/devtools.js.map +1 -1
  29. package/build/dom.d.ts +5 -1
  30. package/build/dom.js +25 -5
  31. package/build/dom.js.map +1 -1
  32. package/build/hooks/use-animation.d.ts +49 -0
  33. package/build/hooks/use-animation.js +87 -0
  34. package/build/hooks/use-animation.js.map +1 -0
  35. package/build/hooks/use-app.d.ts +5 -2
  36. package/build/hooks/use-app.js +1 -1
  37. package/build/hooks/use-box-metrics.d.ts +59 -0
  38. package/build/hooks/use-box-metrics.js +88 -0
  39. package/build/hooks/use-box-metrics.js.map +1 -0
  40. package/build/hooks/use-cursor.d.ts +1 -1
  41. package/build/hooks/use-cursor.js +1 -1
  42. package/build/hooks/use-focus-manager.d.ts +17 -2
  43. package/build/hooks/use-focus-manager.js +2 -1
  44. package/build/hooks/use-focus-manager.js.map +1 -1
  45. package/build/hooks/use-focus.d.ts +2 -1
  46. package/build/hooks/use-focus.js +5 -4
  47. package/build/hooks/use-focus.js.map +1 -1
  48. package/build/hooks/use-input.d.ts +2 -1
  49. package/build/hooks/use-input.js +82 -80
  50. package/build/hooks/use-input.js.map +1 -1
  51. package/build/hooks/use-is-screen-reader-enabled.d.ts +2 -1
  52. package/build/hooks/use-is-screen-reader-enabled.js +2 -1
  53. package/build/hooks/use-is-screen-reader-enabled.js.map +1 -1
  54. package/build/hooks/use-paste.d.ts +35 -0
  55. package/build/hooks/use-paste.js +62 -0
  56. package/build/hooks/use-paste.js.map +1 -0
  57. package/build/hooks/use-stderr.d.ts +1 -1
  58. package/build/hooks/use-stderr.js +1 -1
  59. package/build/hooks/use-stdin.d.ts +4 -2
  60. package/build/hooks/use-stdin.js +2 -1
  61. package/build/hooks/use-stdin.js.map +1 -1
  62. package/build/hooks/use-stdout.d.ts +1 -1
  63. package/build/hooks/use-stdout.js +1 -1
  64. package/build/hooks/use-window-size.d.ts +18 -0
  65. package/build/hooks/use-window-size.js +22 -0
  66. package/build/hooks/use-window-size.js.map +1 -0
  67. package/build/index.d.ts +10 -1
  68. package/build/index.js +5 -0
  69. package/build/index.js.map +1 -1
  70. package/build/ink.d.ts +55 -6
  71. package/build/ink.js +433 -162
  72. package/build/ink.js.map +1 -1
  73. package/build/input-parser.d.ts +10 -0
  74. package/build/input-parser.js +194 -0
  75. package/build/input-parser.js.map +1 -0
  76. package/build/log-update.d.ts +1 -0
  77. package/build/log-update.js +13 -1
  78. package/build/log-update.js.map +1 -1
  79. package/build/measure-element.d.ts +4 -0
  80. package/build/measure-element.js +4 -0
  81. package/build/measure-element.js.map +1 -1
  82. package/build/output.d.ts +1 -0
  83. package/build/output.js +63 -5
  84. package/build/output.js.map +1 -1
  85. package/build/parse-keypress.d.ts +1 -3
  86. package/build/parse-keypress.js +19 -17
  87. package/build/parse-keypress.js.map +1 -1
  88. package/build/reconciler.js +48 -19
  89. package/build/reconciler.js.map +1 -1
  90. package/build/render-border.js +29 -18
  91. package/build/render-border.js.map +1 -1
  92. package/build/render-to-string.d.ts +38 -0
  93. package/build/render-to-string.js +116 -0
  94. package/build/render-to-string.js.map +1 -0
  95. package/build/render.d.ts +69 -3
  96. package/build/render.js +18 -11
  97. package/build/render.js.map +1 -1
  98. package/build/sanitize-ansi.d.ts +2 -0
  99. package/build/sanitize-ansi.js +27 -0
  100. package/build/sanitize-ansi.js.map +1 -0
  101. package/build/squash-text-nodes.js +2 -1
  102. package/build/squash-text-nodes.js.map +1 -1
  103. package/build/styles.d.ts +78 -16
  104. package/build/styles.js +102 -31
  105. package/build/styles.js.map +1 -1
  106. package/build/utils.d.ts +9 -0
  107. package/build/utils.js +19 -0
  108. package/build/utils.js.map +1 -0
  109. package/build/wrap-text.js +7 -0
  110. package/build/wrap-text.js.map +1 -1
  111. package/build/write-synchronized.d.ts +1 -1
  112. package/build/write-synchronized.js +4 -2
  113. package/build/write-synchronized.js.map +1 -1
  114. package/package.json +40 -101
  115. package/readme.md +674 -56
  116. package/build/apply-styles.js +0 -175
  117. package/build/build-layout.js +0 -77
  118. package/build/calculate-wrapped-text.js +0 -53
  119. package/build/components/Color.js +0 -62
  120. package/build/experimental/apply-style.js +0 -140
  121. package/build/experimental/dom.js +0 -123
  122. package/build/experimental/output.js +0 -91
  123. package/build/experimental/reconciler.js +0 -141
  124. package/build/experimental/renderer.js +0 -81
  125. package/build/hooks/useInput.js +0 -38
  126. package/build/instance.js +0 -205
  127. package/build/options.d.ts +0 -52
  128. package/build/options.js +0 -2
  129. package/build/options.js.map +0 -1
  130. package/build/screen-reader-update.d.ts +0 -13
  131. package/build/screen-reader-update.js +0 -38
  132. package/build/screen-reader-update.js.map +0 -1
@@ -2,7 +2,8 @@ import { useEffect, useContext, useMemo } from 'react';
2
2
  import FocusContext from '../components/FocusContext.js';
3
3
  import useStdin from './use-stdin.js';
4
4
  /**
5
- A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered. This hook returns an object with an `isFocused` boolean property, which determines whether this component is focused.
5
+ A React hook that returns focus state and focus controls for the current component.
6
+ A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered.
6
7
  */
7
8
  const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) => {
8
9
  const { isRawModeSupported, setRawMode } = useStdin();
@@ -15,7 +16,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
15
16
  return () => {
16
17
  remove(id);
17
18
  };
18
- }, [id, autoFocus]);
19
+ }, [id, autoFocus, add, remove]);
19
20
  useEffect(() => {
20
21
  if (isActive) {
21
22
  activate(id);
@@ -23,7 +24,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
23
24
  else {
24
25
  deactivate(id);
25
26
  }
26
- }, [isActive, id]);
27
+ }, [isActive, id, activate, deactivate]);
27
28
  useEffect(() => {
28
29
  if (!isRawModeSupported || !isActive) {
29
30
  return;
@@ -32,7 +33,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
32
33
  return () => {
33
34
  setRawMode(false);
34
35
  };
35
- }, [isActive]);
36
+ }, [isActive, isRawModeSupported, setRawMode]);
36
37
  return {
37
38
  isFocused: Boolean(id) && activeId === id,
38
39
  focus,
@@ -1 +1 @@
1
- {"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,OAAO,CAAC;AACrD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+BtC;;EAEE;AACF,MAAM,QAAQ,GAAG,CAAC,EACjB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,KAAK,EACjB,EAAE,EAAE,QAAQ,MACF,EAAE,EAAU,EAAE;IACxB,MAAM,EAAC,kBAAkB,EAAE,UAAU,EAAC,GAAG,QAAQ,EAAE,CAAC;IACpD,MAAM,EAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAC,GACzD,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAEpB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,EAAE;QACzC,KAAK;KACL,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
1
+ {"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,OAAO,CAAC;AACrD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+BtC;;;EAGE;AACF,MAAM,QAAQ,GAAG,CAAC,EACjB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,KAAK,EACjB,EAAE,EAAE,QAAQ,MACF,EAAE,EAAU,EAAE;IACxB,MAAM,EAAC,kBAAkB,EAAE,UAAU,EAAC,GAAG,QAAQ,EAAE,CAAC;IACpD,MAAM,EAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAC,GACzD,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/C,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,EAAE;QACzC,KAAK;KACL,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
@@ -107,7 +107,8 @@ type Options = {
107
107
  isActive?: boolean;
108
108
  };
109
109
  /**
110
- This hook is used for handling user input. It's a more convenient alternative to using `StdinContext` and listening for `data` events. The callback you pass to `useInput` is called for each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
110
+ A React hook that returns `void` and handles user input.
111
+ It's a more convenient alternative to using `StdinContext` and listening for `data` events. The callback you pass to `useInput` is called for each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
111
112
 
112
113
  ```
113
114
  import {useInput} from 'ink';
@@ -1,9 +1,10 @@
1
- import { useEffect } from 'react';
1
+ import { useEffect, useEffectEvent } from 'react';
2
2
  import parseKeypress, { nonAlphanumericKeys } from '../parse-keypress.js';
3
3
  import reconciler from '../reconciler.js';
4
- import useStdin from './use-stdin.js';
4
+ import { useStdinContext } from './use-stdin.js';
5
5
  /**
6
- This hook is used for handling user input. It's a more convenient alternative to using `StdinContext` and listening for `data` events. The callback you pass to `useInput` is called for each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
6
+ A React hook that returns `void` and handles user input.
7
+ It's a more convenient alternative to using `StdinContext` and listening for `data` events. The callback you pass to `useInput` is called for each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
7
8
 
8
9
  ```
9
10
  import {useInput} from 'ink';
@@ -25,7 +26,7 @@ const UserInput = () => {
25
26
  */
26
27
  const useInput = (inputHandler, options = {}) => {
27
28
  // eslint-disable-next-line @typescript-eslint/naming-convention
28
- const { stdin, setRawMode, internal_exitOnCtrlC, internal_eventEmitter } = useStdin();
29
+ const { setRawMode, internal_exitOnCtrlC, internal_eventEmitter } = useStdinContext();
29
30
  useEffect(() => {
30
31
  if (options.isActive === false) {
31
32
  return;
@@ -35,90 +36,91 @@ const useInput = (inputHandler, options = {}) => {
35
36
  setRawMode(false);
36
37
  };
37
38
  }, [options.isActive, setRawMode]);
38
- useEffect(() => {
39
- if (options.isActive === false) {
40
- return;
41
- }
42
- const handleData = (data) => {
43
- const keypress = parseKeypress(data);
44
- const key = {
45
- upArrow: keypress.name === 'up',
46
- downArrow: keypress.name === 'down',
47
- leftArrow: keypress.name === 'left',
48
- rightArrow: keypress.name === 'right',
49
- pageDown: keypress.name === 'pagedown',
50
- pageUp: keypress.name === 'pageup',
51
- home: keypress.name === 'home',
52
- end: keypress.name === 'end',
53
- return: keypress.name === 'return',
54
- escape: keypress.name === 'escape',
55
- ctrl: keypress.ctrl,
56
- shift: keypress.shift,
57
- tab: keypress.name === 'tab',
58
- backspace: keypress.name === 'backspace',
59
- delete: keypress.name === 'delete',
60
- // `parseKeypress` parses \u001B\u001B[A (meta + up arrow) as meta = false
61
- // but with option = true, so we need to take this into account here
62
- // to avoid breaking changes in Ink.
63
- // TODO(vadimdemedes): consider removing this in the next major version.
64
- meta: keypress.meta || keypress.name === 'escape' || keypress.option,
65
- // Kitty keyboard protocol modifiers
66
- super: keypress.super ?? false,
67
- hyper: keypress.hyper ?? false,
68
- capsLock: keypress.capsLock ?? false,
69
- numLock: keypress.numLock ?? false,
70
- eventType: keypress.eventType,
71
- };
72
- let input;
73
- if (keypress.isKittyProtocol) {
74
- // Use text-as-codepoints field for printable keys (needed when
75
- // reportAllKeysAsEscapeCodes flag is enabled), suppress non-printable
76
- if (keypress.isPrintable) {
77
- input = keypress.text ?? keypress.name;
78
- }
79
- else if (keypress.ctrl && keypress.name.length === 1) {
80
- // Ctrl+letter via codepoint 1-26 form: not printable text, but
81
- // the letter name must flow through so handlers (e.g. exitOnCtrlC
82
- // checking `input === 'c' && key.ctrl`) still work.
83
- input = keypress.name;
84
- }
85
- else {
86
- input = '';
87
- }
39
+ const handleData = useEffectEvent((data) => {
40
+ const keypress = parseKeypress(data);
41
+ const key = {
42
+ upArrow: keypress.name === 'up',
43
+ downArrow: keypress.name === 'down',
44
+ leftArrow: keypress.name === 'left',
45
+ rightArrow: keypress.name === 'right',
46
+ pageDown: keypress.name === 'pagedown',
47
+ pageUp: keypress.name === 'pageup',
48
+ home: keypress.name === 'home',
49
+ end: keypress.name === 'end',
50
+ return: keypress.name === 'return',
51
+ escape: keypress.name === 'escape',
52
+ ctrl: keypress.ctrl,
53
+ shift: keypress.shift,
54
+ tab: keypress.name === 'tab',
55
+ backspace: keypress.name === 'backspace',
56
+ delete: keypress.name === 'delete',
57
+ meta: keypress.meta,
58
+ // Kitty keyboard protocol modifiers
59
+ super: keypress.super ?? false,
60
+ hyper: keypress.hyper ?? false,
61
+ capsLock: keypress.capsLock ?? false,
62
+ numLock: keypress.numLock ?? false,
63
+ eventType: keypress.eventType,
64
+ };
65
+ let input;
66
+ if (keypress.isKittyProtocol) {
67
+ // Use text-as-codepoints field for printable keys (needed when
68
+ // reportAllKeysAsEscapeCodes flag is enabled), suppress non-printable
69
+ if (keypress.isPrintable) {
70
+ input = keypress.text ?? keypress.name;
88
71
  }
89
- else if (keypress.ctrl) {
72
+ else if (keypress.ctrl && keypress.name.length === 1) {
73
+ // Ctrl+letter via codepoint 1-26 form: not printable text, but
74
+ // the letter name must flow through so handlers (e.g. exitOnCtrlC
75
+ // checking `input === 'c' && key.ctrl`) still work.
90
76
  input = keypress.name;
91
77
  }
92
78
  else {
93
- input = keypress.sequence;
94
- }
95
- if (!keypress.isKittyProtocol &&
96
- nonAlphanumericKeys.includes(keypress.name)) {
97
79
  input = '';
98
80
  }
99
- // Strip meta if it's still remaining after `parseKeypress`
100
- // TODO(vadimdemedes): remove this in the next major version.
101
- if (input.startsWith('\u001B')) {
102
- input = input.slice(1);
103
- }
104
- if (input.length === 1 &&
105
- typeof input[0] === 'string' &&
106
- /[A-Z]/.test(input[0])) {
107
- key.shift = true;
108
- }
109
- // If app is not supposed to exit on Ctrl+C, then let input listener handle it
110
- if (!(input === 'c' && key.ctrl) || !internal_exitOnCtrlC) {
111
- // @ts-expect-error TypeScript types for `batchedUpdates` require an argument, but React's codebase doesn't provide it and it works without it as expected.
112
- reconciler.batchedUpdates(() => {
113
- inputHandler(input, key);
114
- });
115
- }
116
- };
117
- internal_eventEmitter?.on('input', handleData);
81
+ }
82
+ else if (keypress.ctrl) {
83
+ // Keypress.name is guaranteed non-undefined by parseKeypress,
84
+ // but guard defensively since a TypeError here would crash the
85
+ // entire Ink app (see https://github.com/vadimdemedes/ink/issues/901).
86
+ input = keypress.name ?? '';
87
+ }
88
+ else {
89
+ input = keypress.sequence;
90
+ }
91
+ if (!keypress.isKittyProtocol &&
92
+ nonAlphanumericKeys.includes(keypress.name)) {
93
+ input = '';
94
+ }
95
+ // Strip escape prefix from broken/incomplete sequences that
96
+ // parseKeypress did not fully resolve (e.g. a flushed "\u001B[").
97
+ if (input.startsWith('\u001B')) {
98
+ input = input.slice(1);
99
+ }
100
+ if (input.length === 1 && /[A-Z]/.test(input)) {
101
+ key.shift = true;
102
+ }
103
+ // If app is supposed to exit on Ctrl+C, skip input listeners.
104
+ if (input === 'c' && key.ctrl && internal_exitOnCtrlC) {
105
+ return;
106
+ }
107
+ // Use discreteUpdates to assign DiscreteEventPriority to state
108
+ // updates from keyboard input, ensuring they are processed at the
109
+ // highest priority in concurrent mode.
110
+ // @ts-expect-error Types require 5 arguments (fn, a, b, c, d) but only fn is needed at runtime.
111
+ reconciler.discreteUpdates(() => {
112
+ inputHandler(input, key);
113
+ });
114
+ });
115
+ useEffect(() => {
116
+ if (options.isActive === false) {
117
+ return;
118
+ }
119
+ internal_eventEmitter.on('input', handleData);
118
120
  return () => {
119
- internal_eventEmitter?.removeListener('input', handleData);
121
+ internal_eventEmitter.removeListener('input', handleData);
120
122
  };
121
- }, [options.isActive, stdin, internal_exitOnCtrlC, inputHandler]);
123
+ }, [options.isActive, internal_eventEmitter]);
122
124
  };
123
125
  export default useInput;
124
126
  //# sourceMappingURL=use-input.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"use-input.js","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"use-input.js","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  /**
2
- Returns whether a screen reader is enabled. This is useful when you want to render different output for screen readers.
2
+ A React hook that returns whether a screen reader is enabled.
3
+ This is useful when you want to render different output for screen readers.
3
4
  */
4
5
  declare const useIsScreenReaderEnabled: () => boolean;
5
6
  export default useIsScreenReaderEnabled;
@@ -1,7 +1,8 @@
1
1
  import { useContext } from 'react';
2
2
  import { accessibilityContext } from '../components/AccessibilityContext.js';
3
3
  /**
4
- Returns whether a screen reader is enabled. This is useful when you want to render different output for screen readers.
4
+ A React hook that returns whether a screen reader is enabled.
5
+ This is useful when you want to render different output for screen readers.
5
6
  */
6
7
  const useIsScreenReaderEnabled = () => {
7
8
  const { isScreenReaderEnabled } = useContext(accessibilityContext);
@@ -1 +1 @@
1
- {"version":3,"file":"use-is-screen-reader-enabled.js","sourceRoot":"","sources":["../../src/hooks/use-is-screen-reader-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAC;AAE3E;;EAEE;AACF,MAAM,wBAAwB,GAAG,GAAY,EAAE;IAC9C,MAAM,EAAC,qBAAqB,EAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjE,OAAO,qBAAqB,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}
1
+ {"version":3,"file":"use-is-screen-reader-enabled.js","sourceRoot":"","sources":["../../src/hooks/use-is-screen-reader-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAC;AAE3E;;;EAGE;AACF,MAAM,wBAAwB,GAAG,GAAY,EAAE;IAC9C,MAAM,EAAC,qBAAqB,EAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjE,OAAO,qBAAqB,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}
@@ -0,0 +1,35 @@
1
+ type Options = {
2
+ /**
3
+ Enable or disable the paste handler. Useful when multiple components use `usePaste` and only one should be active at a time.
4
+
5
+ @default true
6
+ */
7
+ isActive?: boolean;
8
+ };
9
+ /**
10
+ A React hook that calls `handler` whenever the user pastes text in the terminal. Bracketed paste mode (`\x1b[?2004h`) is automatically enabled while the hook is active, so pasted text arrives as a single string rather than being misinterpreted as individual key presses.
11
+
12
+ `usePaste` and `useInput` can be used together in the same component. They operate on separate event channels, so paste content is never forwarded to `useInput` handlers when `usePaste` is active.
13
+
14
+ ```
15
+ import {useInput, usePaste} from 'ink';
16
+
17
+ const MyInput = () => {
18
+ useInput((input, key) => {
19
+ // Only receives typed characters and key events, not pasted text.
20
+ if (key.return) {
21
+ // Submit
22
+ }
23
+ });
24
+
25
+ usePaste((text) => {
26
+ // Receives the full pasted string, including newlines.
27
+ console.log('Pasted:', text);
28
+ });
29
+
30
+ return …
31
+ };
32
+ ```
33
+ */
34
+ declare const usePaste: (handler: (text: string) => void, options?: Options) => void;
35
+ export default usePaste;
@@ -0,0 +1,62 @@
1
+ import { useEffect, useEffectEvent } from 'react';
2
+ import reconciler from '../reconciler.js';
3
+ import { useStdinContext } from './use-stdin.js';
4
+ /**
5
+ A React hook that calls `handler` whenever the user pastes text in the terminal. Bracketed paste mode (`\x1b[?2004h`) is automatically enabled while the hook is active, so pasted text arrives as a single string rather than being misinterpreted as individual key presses.
6
+
7
+ `usePaste` and `useInput` can be used together in the same component. They operate on separate event channels, so paste content is never forwarded to `useInput` handlers when `usePaste` is active.
8
+
9
+ ```
10
+ import {useInput, usePaste} from 'ink';
11
+
12
+ const MyInput = () => {
13
+ useInput((input, key) => {
14
+ // Only receives typed characters and key events, not pasted text.
15
+ if (key.return) {
16
+ // Submit
17
+ }
18
+ });
19
+
20
+ usePaste((text) => {
21
+ // Receives the full pasted string, including newlines.
22
+ console.log('Pasted:', text);
23
+ });
24
+
25
+ return …
26
+ };
27
+ ```
28
+ */
29
+ const usePaste = (handler, options = {}) => {
30
+ // eslint-disable-next-line @typescript-eslint/naming-convention
31
+ const { setRawMode, setBracketedPasteMode, internal_eventEmitter } = useStdinContext();
32
+ useEffect(() => {
33
+ if (options.isActive === false) {
34
+ return;
35
+ }
36
+ setRawMode(true);
37
+ setBracketedPasteMode(true);
38
+ return () => {
39
+ setRawMode(false);
40
+ setBracketedPasteMode(false);
41
+ };
42
+ }, [options.isActive, setRawMode, setBracketedPasteMode]);
43
+ const handlePaste = useEffectEvent((text) => {
44
+ // Use discreteUpdates to assign DiscreteEventPriority to state
45
+ // updates triggered by paste, matching the priority of useInput.
46
+ // @ts-expect-error Types require 5 arguments (fn, a, b, c, d) but only fn is needed at runtime.
47
+ reconciler.discreteUpdates(() => {
48
+ handler(text);
49
+ });
50
+ });
51
+ useEffect(() => {
52
+ if (options.isActive === false) {
53
+ return;
54
+ }
55
+ internal_eventEmitter.on('paste', handlePaste);
56
+ return () => {
57
+ internal_eventEmitter.removeListener('paste', handlePaste);
58
+ };
59
+ }, [options.isActive, internal_eventEmitter]);
60
+ };
61
+ export default usePaste;
62
+ //# sourceMappingURL=use-paste.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-paste.js","sourceRoot":"","sources":["../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,OAAO,CAAC;AAChD,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAW/C;;;;;;;;;;;;;;;;;;;;;;;;EAwBE;AACF,MAAM,QAAQ,GAAG,CAChB,OAA+B,EAC/B,UAAmB,EAAE,EACd,EAAE;IACT,gEAAgE;IAChE,MAAM,EAAC,UAAU,EAAE,qBAAqB,EAAE,qBAAqB,EAAC,GAC/D,eAAe,EAAE,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAE5B,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,IAAY,EAAE,EAAE;QACnD,+DAA+D;QAC/D,iEAAiE;QACjE,gGAAgG;QAChG,UAAU,CAAC,eAAe,CAAC,GAAG,EAAE;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO;QACR,CAAC;QAED,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE/C,OAAO,GAAG,EAAE;YACX,qBAAqB,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- `useStderr` is a React hook that exposes the stderr stream.
2
+ A React hook that returns the stderr stream.
3
3
  */
4
4
  declare const useStderr: () => import("../components/StderrContext.js").Props;
5
5
  export default useStderr;
@@ -1,7 +1,7 @@
1
1
  import { useContext } from 'react';
2
2
  import StderrContext from '../components/StderrContext.js';
3
3
  /**
4
- `useStderr` is a React hook that exposes the stderr stream.
4
+ A React hook that returns the stderr stream.
5
5
  */
6
6
  const useStderr = () => useContext(StderrContext);
7
7
  export default useStderr;
@@ -1,5 +1,7 @@
1
+ import { type PublicProps, type Props } from '../components/StdinContext.js';
1
2
  /**
2
- `useStdin` is a React hook that exposes the stdin stream.
3
+ A React hook that returns the stdin stream and stdin-related utilities.
3
4
  */
4
- declare const useStdin: () => import("../components/StdinContext.js").Props;
5
+ declare const useStdin: () => PublicProps;
6
+ export declare const useStdinContext: () => Props;
5
7
  export default useStdin;
@@ -1,8 +1,9 @@
1
1
  import { useContext } from 'react';
2
2
  import StdinContext from '../components/StdinContext.js';
3
3
  /**
4
- `useStdin` is a React hook that exposes the stdin stream.
4
+ A React hook that returns the stdin stream and stdin-related utilities.
5
5
  */
6
6
  const useStdin = () => useContext(StdinContext);
7
+ export const useStdinContext = () => useContext(StdinContext);
7
8
  export default useStdin;
8
9
  //# sourceMappingURL=use-stdin.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"use-stdin.js","sourceRoot":"","sources":["../../src/hooks/use-stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAAY,MAAM,+BAA+B,CAAC;AAEzD;;EAEE;AACF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAChD,eAAe,QAAQ,CAAC"}
1
+ {"version":3,"file":"use-stdin.js","sourceRoot":"","sources":["../../src/hooks/use-stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAGN,MAAM,+BAA+B,CAAC;AAEvC;;EAEE;AACF,MAAM,QAAQ,GAAG,GAAgB,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAU,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAErE,eAAe,QAAQ,CAAC"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- `useStdout` is a React hook that exposes the stdout stream where Ink renders your app.
2
+ A React hook that returns the stdout stream where Ink renders your app.
3
3
  */
4
4
  declare const useStdout: () => import("../components/StdoutContext.js").Props;
5
5
  export default useStdout;
@@ -1,7 +1,7 @@
1
1
  import { useContext } from 'react';
2
2
  import StdoutContext from '../components/StdoutContext.js';
3
3
  /**
4
- `useStdout` is a React hook that exposes the stdout stream where Ink renders your app.
4
+ A React hook that returns the stdout stream where Ink renders your app.
5
5
  */
6
6
  const useStdout = () => useContext(StdoutContext);
7
7
  export default useStdout;
@@ -0,0 +1,18 @@
1
+ /**
2
+ Dimensions of the terminal window.
3
+ */
4
+ export type WindowSize = {
5
+ /**
6
+ Number of columns (horizontal character cells).
7
+ */
8
+ readonly columns: number;
9
+ /**
10
+ Number of rows (vertical character cells).
11
+ */
12
+ readonly rows: number;
13
+ };
14
+ /**
15
+ A React hook that returns the current terminal window dimensions and re-renders the component whenever the terminal is resized.
16
+ */
17
+ declare const useWindowSize: () => WindowSize;
18
+ export default useWindowSize;
@@ -0,0 +1,22 @@
1
+ import { useState, useEffect } from 'react';
2
+ import { getWindowSize } from '../utils.js';
3
+ import useStdout from './use-stdout.js';
4
+ /**
5
+ A React hook that returns the current terminal window dimensions and re-renders the component whenever the terminal is resized.
6
+ */
7
+ const useWindowSize = () => {
8
+ const { stdout } = useStdout();
9
+ const [size, setSize] = useState(() => getWindowSize(stdout));
10
+ useEffect(() => {
11
+ const onResize = () => {
12
+ setSize(getWindowSize(stdout));
13
+ };
14
+ stdout.on('resize', onResize);
15
+ return () => {
16
+ stdout.off('resize', onResize);
17
+ };
18
+ }, [stdout]);
19
+ return size;
20
+ };
21
+ export default useWindowSize;
22
+ //# sourceMappingURL=use-window-size.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-window-size.js","sourceRoot":"","sources":["../../src/hooks/use-window-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAC1C,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAiBxC;;EAEE;AACF,MAAM,aAAa,GAAG,GAAe,EAAE;IACtC,MAAM,EAAC,MAAM,EAAC,GAAG,SAAS,EAAE,CAAC;IAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAa,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,QAAQ,GAAG,GAAG,EAAE;YACrB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE9B,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}
package/build/index.d.ts CHANGED
@@ -1,11 +1,13 @@
1
1
  export type { RenderOptions, Instance } from './render.js';
2
2
  export { default as render } from './render.js';
3
+ export type { RenderToStringOptions } from './render-to-string.js';
4
+ export { default as renderToString } from './render-to-string.js';
3
5
  export type { Props as BoxProps } from './components/Box.js';
4
6
  export { default as Box } from './components/Box.js';
5
7
  export type { Props as TextProps } from './components/Text.js';
6
8
  export { default as Text } from './components/Text.js';
7
9
  export type { Props as AppProps } from './components/AppContext.js';
8
- export type { Props as StdinProps } from './components/StdinContext.js';
10
+ export type { PublicProps as StdinProps } from './components/StdinContext.js';
9
11
  export type { Props as StdoutProps } from './components/StdoutContext.js';
10
12
  export type { Props as StderrProps } from './components/StderrContext.js';
11
13
  export type { Props as StaticProps } from './components/Static.js';
@@ -17,6 +19,7 @@ export { default as Newline } from './components/Newline.js';
17
19
  export { default as Spacer } from './components/Spacer.js';
18
20
  export type { Key } from './hooks/use-input.js';
19
21
  export { default as useInput } from './hooks/use-input.js';
22
+ export { default as usePaste } from './hooks/use-paste.js';
20
23
  export { default as useApp } from './hooks/use-app.js';
21
24
  export { default as useStdin } from './hooks/use-stdin.js';
22
25
  export { default as useStdout } from './hooks/use-stdout.js';
@@ -25,6 +28,12 @@ export { default as useFocus } from './hooks/use-focus.js';
25
28
  export { default as useFocusManager } from './hooks/use-focus-manager.js';
26
29
  export { default as useIsScreenReaderEnabled } from './hooks/use-is-screen-reader-enabled.js';
27
30
  export { default as useCursor } from './hooks/use-cursor.js';
31
+ export type { AnimationResult } from './hooks/use-animation.js';
32
+ export { default as useAnimation } from './hooks/use-animation.js';
33
+ export type { WindowSize } from './hooks/use-window-size.js';
34
+ export { default as useWindowSize } from './hooks/use-window-size.js';
35
+ export type { BoxMetrics, UseBoxMetricsResult } from './hooks/use-box-metrics.js';
36
+ export { default as useBoxMetrics } from './hooks/use-box-metrics.js';
28
37
  export type { CursorPosition } from './log-update.js';
29
38
  export { default as measureElement } from './measure-element.js';
30
39
  export type { DOMElement } from './dom.js';
package/build/index.js CHANGED
@@ -1,4 +1,5 @@
1
1
  export { default as render } from './render.js';
2
+ export { default as renderToString } from './render-to-string.js';
2
3
  export { default as Box } from './components/Box.js';
3
4
  export { default as Text } from './components/Text.js';
4
5
  export { default as Static } from './components/Static.js';
@@ -6,6 +7,7 @@ export { default as Transform } from './components/Transform.js';
6
7
  export { default as Newline } from './components/Newline.js';
7
8
  export { default as Spacer } from './components/Spacer.js';
8
9
  export { default as useInput } from './hooks/use-input.js';
10
+ export { default as usePaste } from './hooks/use-paste.js';
9
11
  export { default as useApp } from './hooks/use-app.js';
10
12
  export { default as useStdin } from './hooks/use-stdin.js';
11
13
  export { default as useStdout } from './hooks/use-stdout.js';
@@ -14,6 +16,9 @@ export { default as useFocus } from './hooks/use-focus.js';
14
16
  export { default as useFocusManager } from './hooks/use-focus-manager.js';
15
17
  export { default as useIsScreenReaderEnabled } from './hooks/use-is-screen-reader-enabled.js';
16
18
  export { default as useCursor } from './hooks/use-cursor.js';
19
+ export { default as useAnimation } from './hooks/use-animation.js';
20
+ export { default as useWindowSize } from './hooks/use-window-size.js';
21
+ export { default as useBoxMetrics } from './hooks/use-box-metrics.js';
17
22
  export { default as measureElement } from './measure-element.js';
18
23
  export { kittyFlags, kittyModifiers } from './kitty-keyboard.js';
19
24
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAC,OAAO,IAAI,GAAG,EAAC,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAC,OAAO,IAAI,wBAAwB,EAAC,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAC,OAAO,IAAI,GAAG,EAAC,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAC,OAAO,IAAI,wBAAwB,EAAC,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAC,OAAO,IAAI,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAEpE,OAAO,EAAC,OAAO,IAAI,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAEpE,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC"}