@visulima/ansi 4.0.0-alpha.9 → 4.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 (85) hide show
  1. package/CHANGELOG.md +290 -0
  2. package/LICENSE.md +0 -20
  3. package/README.md +41 -10
  4. package/dist/alternative-screen.d.ts +71 -70
  5. package/dist/alternative-screen.js +1 -8
  6. package/dist/background.d.ts +72 -0
  7. package/dist/background.js +1 -0
  8. package/dist/charset.d.ts +52 -0
  9. package/dist/charset.js +1 -0
  10. package/dist/clear.d.ts +74 -73
  11. package/dist/clear.js +1 -10
  12. package/dist/clipboard.d.ts +76 -0
  13. package/dist/clipboard.js +1 -0
  14. package/dist/constants.d.ts +18 -10
  15. package/dist/constants.js +1 -0
  16. package/dist/cursor.d.ts +421 -406
  17. package/dist/cursor.js +1 -3
  18. package/dist/cwd.d.ts +26 -0
  19. package/dist/cwd.js +1 -0
  20. package/dist/erase.d.ts +193 -192
  21. package/dist/erase.js +1 -47
  22. package/dist/finalterm.d.ts +47 -0
  23. package/dist/finalterm.js +1 -0
  24. package/dist/focus.d.ts +20 -0
  25. package/dist/focus.js +1 -0
  26. package/dist/hyperlink.d.ts +25 -25
  27. package/dist/hyperlink.js +1 -5
  28. package/dist/image.d.ts +70 -70
  29. package/dist/image.js +1 -40
  30. package/dist/index.d.ts +38 -35
  31. package/dist/index.js +1 -26
  32. package/dist/iterm2.d.ts +285 -58
  33. package/dist/iterm2.js +1 -12
  34. package/dist/keypad.d.ts +27 -0
  35. package/dist/keypad.js +1 -0
  36. package/dist/kitty-graphics.d.ts +17 -0
  37. package/dist/kitty-graphics.js +1 -0
  38. package/dist/mode.d.ts +585 -584
  39. package/dist/mode.js +1 -245
  40. package/dist/mouse.d.ts +227 -226
  41. package/dist/mouse.js +1 -106
  42. package/dist/notification.d.ts +30 -0
  43. package/dist/notification.js +1 -0
  44. package/dist/packem_shared/IT2_AUTO-K3GubKy7.js +1 -0
  45. package/dist/packem_shared/ITerm2File-BkLc5ipB.js +1 -0
  46. package/dist/packem_shared/cursor-BXG1O_IE.js +1 -0
  47. package/dist/packem_shared/restoreCursor-CyaXIMQf.js +2 -0
  48. package/dist/passthrough.d.ts +74 -73
  49. package/dist/passthrough.js +1 -29
  50. package/dist/paste.d.ts +23 -0
  51. package/dist/paste.js +1 -0
  52. package/dist/progress.d.ts +37 -36
  53. package/dist/progress.js +1 -0
  54. package/dist/reset.d.ts +25 -24
  55. package/dist/reset.js +1 -4
  56. package/dist/screen.d.ts +226 -225
  57. package/dist/screen.js +1 -27
  58. package/dist/scroll.d.ts +64 -63
  59. package/dist/scroll.js +1 -18
  60. package/dist/sixel.d.ts +19 -0
  61. package/dist/sixel.js +1 -0
  62. package/dist/status.d.ts +521 -520
  63. package/dist/status.js +1 -95
  64. package/dist/strip.d.ts +26 -1
  65. package/dist/strip.js +1 -13
  66. package/dist/termcap.d.ts +36 -35
  67. package/dist/termcap.js +1 -25
  68. package/dist/title.d.ts +176 -175
  69. package/dist/title.js +1 -19
  70. package/dist/urxvt.d.ts +15 -0
  71. package/dist/urxvt.js +1 -0
  72. package/dist/window-ops.d.ts +399 -398
  73. package/dist/window-ops.js +1 -61
  74. package/dist/xterm.d.ts +167 -84
  75. package/dist/xterm.js +1 -33
  76. package/package.json +60 -9
  77. package/dist/helpers.d.ts +0 -14
  78. package/dist/iterm2/iterm2-properties.d.ts +0 -135
  79. package/dist/iterm2/iterm2-sequences.d.ts +0 -96
  80. package/dist/packem_shared/IT2_AUTO-DyYWsxno.js +0 -6
  81. package/dist/packem_shared/ITerm2File-CUZDBk99.js +0 -137
  82. package/dist/packem_shared/constants-CE7WkXh_.js +0 -9
  83. package/dist/packem_shared/cursor-ChpV7cgs.js +0 -72
  84. package/dist/packem_shared/resetProgressBar-D9r2s7eV.js +0 -18
  85. package/dist/packem_shared/restoreCursor-GfYEeJqN.js +0 -323
package/CHANGELOG.md CHANGED
@@ -1,3 +1,293 @@
1
+ ## @visulima/ansi [4.0.0](https://github.com/visulima/visulima/compare/@visulima/ansi@3.0.5...@visulima/ansi@4.0.0) (2026-07-03)
2
+
3
+ ### ⚠ BREAKING CHANGES
4
+
5
+ * change min node version to 22.13
6
+
7
+ ### Features
8
+
9
+ * **ansi:** add bracketed paste markers ([5dc3d57](https://github.com/visulima/visulima/commit/5dc3d579cd1887c3b949ffee875d7259d8a5879e))
10
+ * **ansi:** add character set selection (SCS) ([60852bd](https://github.com/visulima/visulima/commit/60852bd00920dc90c582adc298584a13e4f361a8))
11
+ * **ansi:** add desktop notification sequences ([36f0a69](https://github.com/visulima/visulima/commit/36f0a69191e502750c7e104838688edd249e837e))
12
+ * **ansi:** add FinalTerm shell integration marks (OSC 133) ([e087278](https://github.com/visulima/visulima/commit/e087278a25f5665172cbaa3f4dacd628ebd344ba))
13
+ * **ansi:** add focus event reporting sequences ([83718f7](https://github.com/visulima/visulima/commit/83718f770c6e5297a69675f3adea2ba9004b95aa))
14
+ * **ansi:** add foreground/background/cursor color sequences ([2c562bd](https://github.com/visulima/visulima/commit/2c562bdfb3a67168fd106b78159b4e98d6131f47))
15
+ * **ansi:** add keypad application/numeric mode sequences ([cc62e9d](https://github.com/visulima/visulima/commit/cc62e9d21c7043df0b101c967133ae0b335e2d83))
16
+ * **ansi:** add kitty graphics protocol sequence wrapper ([6e83b5c](https://github.com/visulima/visulima/commit/6e83b5cff7938ae38df8d9aa6e019453c89ae1ea))
17
+ * **ansi:** add osc52 clipboard + kitty keyboard, harden strip ([793cc9e](https://github.com/visulima/visulima/commit/793cc9e848aabe4b7b637a855941eb1f40649c94))
18
+ * **ansi:** add sixel graphics sequence wrapper ([fb2a225](https://github.com/visulima/visulima/commit/fb2a225d10ad6008e0cdc6959128d30502536c2f))
19
+ * **ansi:** add urxvt OSC 777 extension ([8b96c1a](https://github.com/visulima/visulima/commit/8b96c1ac11c19c56fa3a55adff21309ad2287b43))
20
+ * **ansi:** add working directory reporting (OSC 7) ([95059d5](https://github.com/visulima/visulima/commit/95059d5462a416393937d5bbab6ca425397a22b4))
21
+ * **web:** auto-generate packages page from workspace metadata ([623e520](https://github.com/visulima/visulima/commit/623e5207693a7fe720f5f2f179593a3654c880e3))
22
+
23
+ ### Bug Fixes
24
+
25
+ * add new package image, fixed readme rendering on npm, fixed building of packages ([b790ba2](https://github.com/visulima/visulima/commit/b790ba253ea07fef83528fd822a678facf021b5f))
26
+ * **ansi:** 3 bug fixes ([5b6977c](https://github.com/visulima/visulima/commit/5b6977caa2479f094ec4e04125127e06275c3aae))
27
+ * **ansi:** correct DECSWT and DECSIN escape sequences ([#592](https://github.com/visulima/visulima/issues/592)) ([ca6b028](https://github.com/visulima/visulima/commit/ca6b0289d9ef3e453ad0e424172c6f7aee58b711))
28
+ * **ansi:** properly fix eslint errors in code ([6da2c5f](https://github.com/visulima/visulima/commit/6da2c5fbac6669163ba55e5b7b4062a10940de90))
29
+ * **ansi:** remove remaining eslint suppressions with proper code fixes ([27715b6](https://github.com/visulima/visulima/commit/27715b64843f0cd211f53b32bc752ef743bb52ef))
30
+ * **ansi:** remove unused [@ts-expect-error](https://github.com/ts-expect-error) directives ([078d12b](https://github.com/visulima/visulima/commit/078d12b6429160dafc9ffaf6c0cee55fe871c509))
31
+ * **ansi:** resolve eslint and formatting issues ([da359e8](https://github.com/visulima/visulima/commit/da359e8248c5c06ae1aed97609520f6699ce77aa))
32
+ * **ansi:** resolve eslint and formatting issues ([3fc3401](https://github.com/visulima/visulima/commit/3fc340173818b239ccf5d8f0f574ebe0c0d3465e))
33
+ * **ansi:** resolve eslint errors ([c1ed26b](https://github.com/visulima/visulima/commit/c1ed26b7b528f388446e830a93ae6cc4abee636c))
34
+ * **ansi:** sanitize title in every OSC-write helper ([75c579e](https://github.com/visulima/visulima/commit/75c579e9b009d25c4d90f959d06f0bd524c1d07a))
35
+ * **ansi:** strip 8-bit C1 control sequences (0x9b CSI, 0x9d OSC, …) ([ecd702d](https://github.com/visulima/visulima/commit/ecd702ded915ae4affd2a0a65583d73819d9e8b3))
36
+ * **ansi:** strip OSC terminators from color/cwd/finalterm payloads ([6c4ab8c](https://github.com/visulima/visulima/commit/6c4ab8c4cae3f8bafd7483f161887883bb315a6b))
37
+ * **ansi:** update package files ([13d5a39](https://github.com/visulima/visulima/commit/13d5a390e4286bbaa887dbbb989d29f1ee4090db))
38
+ * **ansi:** update packem to 2.0.0-alpha.54 ([8dad6cb](https://github.com/visulima/visulima/commit/8dad6cb820ef0b5748755fe907959fd2830d9f2b))
39
+ * **ansi:** use workspace:* for internal [@visulima](https://github.com/visulima) deps ([9778bbb](https://github.com/visulima/visulima/commit/9778bbb1d8786feba0d467f846930838297d9ca4))
40
+ * **lint:** clear pre-existing eslint rot across packages ([#674](https://github.com/visulima/visulima/issues/674)) ([5354253](https://github.com/visulima/visulima/commit/5354253b163bd50bcefaf8a3fddf831bdb5df32b))
41
+ * Remove JSR configuration generation script and generated jsr.json files ([#616](https://github.com/visulima/visulima/issues/616)) ([533744b](https://github.com/visulima/visulima/commit/533744b103b74896941db5b727173e617a27a63b))
42
+ * **storage-client:** percent-encode user fields in defaultFingerprint ([7c78a0f](https://github.com/visulima/visulima/commit/7c78a0f9512e2a673b941d80839e9f1e86b7b5d0))
43
+ * **terminal:** resolve eslint and formatting issues ([12ef283](https://github.com/visulima/visulima/commit/12ef283684d1808fbcfe44077a0cfe8324801485))
44
+ * **terminal:** resolve eslint and formatting issues ([8f30389](https://github.com/visulima/visulima/commit/8f30389deb9ff81e7afce0aa064ef11fcb179f23))
45
+ * update Node.js engine version requirement to >=22.13 in multiple package.json files for improved compatibility ([b828e9a](https://github.com/visulima/visulima/commit/b828e9aeaebfc798eecddccd90e6ec7560c6d36a))
46
+ * update package OG images across multiple packages ([f08e4dd](https://github.com/visulima/visulima/commit/f08e4dd2b105ccb29c8412020a9c2be36d6c1e9e))
47
+ * **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
48
+
49
+ ### Documentation
50
+
51
+ * **ansi:** document new escape sequence modules ([0bbc476](https://github.com/visulima/visulima/commit/0bbc4766259d9bde491186cadeb167d9e353f4dc))
52
+ * **bytes,deep-clone,ansi,fmt,find-cache-dir:** add comprehensive Fumadocs documentation ([dfe0116](https://github.com/visulima/visulima/commit/dfe0116ebd26fe38f94f77b8ed4dadc3ff45ba91))
53
+
54
+ ### Styles
55
+
56
+ * cs fixes ([2a960bb](https://github.com/visulima/visulima/commit/2a960bb1772c9dc70080e2d75d3a0d827034e294))
57
+
58
+ ### Miscellaneous Chores
59
+
60
+ * add fallow code-intelligence across all packages ([a3b4821](https://github.com/visulima/visulima/commit/a3b48215002e86fed20f2973038b5d4a0aa1ce04))
61
+ * **ansi:** add tsconfig.eslint.json for type-aware linting ([779ade8](https://github.com/visulima/visulima/commit/779ade858be2ec544486c354eed1dc8fc3f377f9))
62
+ * **ansi:** apply pending changes ([cd52fc6](https://github.com/visulima/visulima/commit/cd52fc6bed679efc5203d1f67f0b125d86d44aca))
63
+ * **ansi:** apply prettier and eslint quote-style auto-fix ([b564048](https://github.com/visulima/visulima/commit/b564048f5fe7c116633358874ca3b5a5a20806a3))
64
+ * **ansi:** apply prettier formatting ([8ad7895](https://github.com/visulima/visulima/commit/8ad7895e4ad2fcaa78b542ce69e63f903208ee03))
65
+ * **ansi:** enforce curly braces and apply lint fixes ([bdf29eb](https://github.com/visulima/visulima/commit/bdf29ebe46f6a2506171d5bffe30cf431be61308))
66
+ * **ansi:** housekeeping cleanup ([da5f5d1](https://github.com/visulima/visulima/commit/da5f5d124563ba8809a374f0f6eb9dcb022f330c))
67
+ * **ansi:** migrate .prettierrc.cjs to prettier.config.js ([1507e7a](https://github.com/visulima/visulima/commit/1507e7a245ff053929eedce92d2caf58b83ede40))
68
+ * **ansi:** migrate deps to pnpm catalogs ([2bdd466](https://github.com/visulima/visulima/commit/2bdd466ce1aa69d28bc88d952dfae65b6fc73c17))
69
+ * **ansi:** update dependencies ([0959eea](https://github.com/visulima/visulima/commit/0959eea366d3908c13196575a1d3bda17a1bf0aa))
70
+ * **ansi:** update dependencies ([f5cd15a](https://github.com/visulima/visulima/commit/f5cd15ac4f5ca57a614208eb9fc5a9e4e336e2b4))
71
+ * **ansi:** update dependencies ([0af3c28](https://github.com/visulima/visulima/commit/0af3c28ef5bf36f6c3672da94c39ff228ba886b0))
72
+ * **ansi:** upgrade packem to 2.0.0-alpha.76 ([f970913](https://github.com/visulima/visulima/commit/f970913dadd41f5d89ecbc52b481cb5099502c3d))
73
+ * apply eslint + prettier autofixes across packages ([c1bb784](https://github.com/visulima/visulima/commit/c1bb7848a0d93d0dfe2960c77e3cda22239c79a0))
74
+ * bump engines.node to ^22.14.0 || >=24.10.0 ([c3d0931](https://github.com/visulima/visulima/commit/c3d0931d1504e4f21ebf50ea680cfa7ce4ba15ce))
75
+ * **ci-stability:** green CI across vis, native, lint, tests, attw ([#651](https://github.com/visulima/visulima/issues/651)) ([d4eb684](https://github.com/visulima/visulima/commit/d4eb684b5f75c818c9251048c605a0ed54a268e3))
76
+ * **fallow:** resolve dead-code findings ([c4125d5](https://github.com/visulima/visulima/commit/c4125d53e03ac9d90115399634535991927a96cc))
77
+ * fixed jsr.json ([5d85e51](https://github.com/visulima/visulima/commit/5d85e5179de38e284ec433b14d77c71a1619c8d6))
78
+ * fixed project.json names and schema path ([964722f](https://github.com/visulima/visulima/commit/964722f691db205c7edb9aa6db29e849a647500b))
79
+ * jsr.json update and lock file ([73fce38](https://github.com/visulima/visulima/commit/73fce38c7cb4603f3fffb88609b1b18e2feb4937))
80
+ * moved all packages into groups ([0615e9d](https://github.com/visulima/visulima/commit/0615e9d14a8a886e11da529ce150cf31ca973c10))
81
+ * re-sort workspace package.json files via vis sort-package-json ([f625696](https://github.com/visulima/visulima/commit/f625696cfac974325774b3243e1a83c3d23acbd7))
82
+ * **release:** @visulima/ansi@4.0.0-alpha.1 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.1](https://github.com/visulima/visulima/compare/@visulima/ansi@3.0.5...@visulima/ansi@4.0.0-alpha.1) (2025-12-05) ([e8da050](https://github.com/visulima/visulima/commit/e8da05027a1fc7988993802a9f02047e4719de03))
83
+ * **release:** @visulima/ansi@4.0.0-alpha.10 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.10](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.9...@visulima/ansi@4.0.0-alpha.10) (2026-04-21) ([bbbe0c7](https://github.com/visulima/visulima/commit/bbbe0c7f3e838bef7f394614dfbead24c05335d9))
84
+ * **release:** @visulima/ansi@4.0.0-alpha.11 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.11](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.10...@visulima/ansi@4.0.0-alpha.11) (2026-04-21) ([e814577](https://github.com/visulima/visulima/commit/e81457711b4b344002ff1f981248769eaa94f709))
85
+ * **release:** @visulima/ansi@4.0.0-alpha.12 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.12](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.11...@visulima/ansi@4.0.0-alpha.12) (2026-04-21) ([4863884](https://github.com/visulima/visulima/commit/4863884effa695d570fd66b44e5404381dcb8eb1))
86
+ * **release:** @visulima/ansi@4.0.0-alpha.13 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.12...@visulima/ansi@4.0.0-alpha.13) (2026-04-22) ([4c1f2e0](https://github.com/visulima/visulima/commit/4c1f2e00575fff6a44f9ed957e075bd89854c67b))
87
+ * **release:** @visulima/ansi@4.0.0-alpha.14 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.13...@visulima/ansi@4.0.0-alpha.14) (2026-05-20) ([12647bb](https://github.com/visulima/visulima/commit/12647bbd4af2ef7e08bb23f2a8aa52a89d427052))
88
+ * **release:** @visulima/ansi@4.0.0-alpha.15 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.15](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.14...@visulima/ansi@4.0.0-alpha.15) (2026-05-27) ([05e7922](https://github.com/visulima/visulima/commit/05e7922d63b145245139f82efa93fcb0ee72d8a0))
89
+ * **release:** @visulima/ansi@4.0.0-alpha.16 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.16](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.15...@visulima/ansi@4.0.0-alpha.16) (2026-06-04) ([23cca8e](https://github.com/visulima/visulima/commit/23cca8eafe81c865e5167b36edca03b015040b23))
90
+ * **release:** @visulima/ansi@4.0.0-alpha.17 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.17](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.16...@visulima/ansi@4.0.0-alpha.17) (2026-06-13) ([2d30e09](https://github.com/visulima/visulima/commit/2d30e099c04040089efc6b41c966fe3d74aa3b9e))
91
+ * **release:** @visulima/ansi@4.0.0-alpha.18 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.18](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.17...@visulima/ansi@4.0.0-alpha.18) (2026-06-30) ([32d5156](https://github.com/visulima/visulima/commit/32d51569a23125b8feca89de16a3bd54b4214684))
92
+ * **release:** @visulima/ansi@4.0.0-alpha.2 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.2](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.1...@visulima/ansi@4.0.0-alpha.2) (2025-12-06) ([755097a](https://github.com/visulima/visulima/commit/755097a4db305feb7ec2f86b2405eeeb89df7d3b))
93
+ * **release:** @visulima/ansi@4.0.0-alpha.3 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.3](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.2...@visulima/ansi@4.0.0-alpha.3) (2025-12-11) ([0e1ca41](https://github.com/visulima/visulima/commit/0e1ca41bb1d8fcbb05bfdaac64654f5142e5327f))
94
+ * **release:** @visulima/ansi@4.0.0-alpha.4 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.4](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.3...@visulima/ansi@4.0.0-alpha.4) (2025-12-27) ([b9bc435](https://github.com/visulima/visulima/commit/b9bc435d8b41893481ecbccc89b99424d8048803))
95
+ * **release:** @visulima/ansi@4.0.0-alpha.5 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.5](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.4...@visulima/ansi@4.0.0-alpha.5) (2026-03-06) ([fcc03dc](https://github.com/visulima/visulima/commit/fcc03dc7548c27e3b46f4410799a6487738a7816))
96
+ * **release:** @visulima/ansi@4.0.0-alpha.6 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.6](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.5...@visulima/ansi@4.0.0-alpha.6) (2026-03-26) ([9d9de7a](https://github.com/visulima/visulima/commit/9d9de7a7d246c40df67262f5818ddfdfe9f285e3))
97
+ * **release:** @visulima/ansi@4.0.0-alpha.7 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.6...@visulima/ansi@4.0.0-alpha.7) (2026-03-26) ([b36061c](https://github.com/visulima/visulima/commit/b36061c5cf29b3c2244fcd5af20fed3c000cb7ce))
98
+ * **release:** @visulima/ansi@4.0.0-alpha.8 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.7...@visulima/ansi@4.0.0-alpha.8) (2026-04-08) ([4ae4102](https://github.com/visulima/visulima/commit/4ae4102ad0e501758cc2bed11794f747ae3513cf))
99
+ * **release:** @visulima/ansi@4.0.0-alpha.9 [skip ci]\n\n## @visulima/ansi [4.0.0-alpha.9](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.8...@visulima/ansi@4.0.0-alpha.9) (2026-04-15) ([955e42e](https://github.com/visulima/visulima/commit/955e42e9daecb8ce36b5d6d82ba5cc9a28466829))
100
+ * simplify pnpm-workspace packages list ([7cab221](https://github.com/visulima/visulima/commit/7cab221163632d9b7aa044a6f88c49083103a869))
101
+ * sorted package.json ([b47c545](https://github.com/visulima/visulima/commit/b47c545591600fdab17d5cd3a3fbc68b61e199da))
102
+ * **terminal:** apply prettier and eslint formatting sweep ([15fd89c](https://github.com/visulima/visulima/commit/15fd89c677eea60866e08e4fd5f5a6bc8f3bd2e5))
103
+ * **terminal:** remove empty dependency objects from package.json ([562c704](https://github.com/visulima/visulima/commit/562c704e5d90aa2d13eae942ebbdcfeb787c2b46))
104
+ * **terminal:** update dependencies ([a5bb91a](https://github.com/visulima/visulima/commit/a5bb91a66f2be2ade485d586156a54c347a23cc9))
105
+ * update @anolilab/semantic-release-pnpm and @anolilab/semantic-release-preset to versions 3.2.2 and 12.1.2 across multiple package.json files for improved compatibility ([3921626](https://github.com/visulima/visulima/commit/3921626141fe5da398749bf0ba675f1596f18afb))
106
+ * update dependencies across multiple packages to improve compatibility and performance, including upgrading `@anolilab/semantic-release-pnpm` and `@anolilab/semantic-release-preset` to versions 3.2.0 and 12.1.0 respectively, and updating `react`, `react-dom`, and `next` versions to 19.2.1 and 16.0.7 in various package.json files ([aee8fcd](https://github.com/visulima/visulima/commit/aee8fcd796ae9b8d055903260e7150996ea9f53d))
107
+ * update lock file maintenance ([d83e716](https://github.com/visulima/visulima/commit/d83e71697b75d24704185b66bb521a934d2db02d))
108
+ * update the jsr.json ([864ab7e](https://github.com/visulima/visulima/commit/864ab7e71c4b5ae82f64792d1ae8debfea2c539b))
109
+ * visulima website ([#591](https://github.com/visulima/visulima/issues/591)) ([59ab2e2](https://github.com/visulima/visulima/commit/59ab2e2befb03e51cd2088956f83d9b87de6d033))
110
+ * year update ([47f4105](https://github.com/visulima/visulima/commit/47f410596ce7190cfea36a073db32e0cec50bbcd))
111
+
112
+ ### Code Refactoring
113
+
114
+ * **ansi:** share OSC terminator sanitizer; address review findings ([ed2215d](https://github.com/visulima/visulima/commit/ed2215d8a61e2896dae278c7a07eae393ed415ea))
115
+ * **ansi:** use replaceAll and reflow single-line arrow ([2f1525c](https://github.com/visulima/visulima/commit/2f1525c9176f0e7c65148fd2ac89b8cdb68a7b7e))
116
+ * **docs:** migrate Nextra components to fumadocs-ui, remove Nextra stripping ([484878f](https://github.com/visulima/visulima/commit/484878f01879363ef5e9a0282904dc4627d6060c))
117
+
118
+ ### Tests
119
+
120
+ * **ansi:** cover cursor moves, iterm2 file data, xterm/title guards, device-attribute reports and barrel ([13cd284](https://github.com/visulima/visulima/commit/13cd2848b0927d8150b5c8e8a2c24526ff3bdc57))
121
+ * **repo:** add dist runtime + types integration tests ([32ee300](https://github.com/visulima/visulima/commit/32ee300b7184117a0ddf9f9d390f75f8932d5ed9))
122
+
123
+ ### Build System
124
+
125
+ * regenerate bundled-license manifests and types ordering ([af26588](https://github.com/visulima/visulima/commit/af26588d75aaa937fd4862800560bd4070a4878c))
126
+
127
+ ### Continuous Integration
128
+
129
+ * **fallow:** make fallow:health advisory (--report-only) ([d57148e](https://github.com/visulima/visulima/commit/d57148ea0e3556b4c24d8d336b9fa14987f5dc7d))
130
+
131
+
132
+ ### Dependencies
133
+
134
+ * **@visulima/path:** upgraded to 3.0.0
135
+
136
+ ## @visulima/ansi [4.0.0-alpha.18](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.17...@visulima/ansi@4.0.0-alpha.18) (2026-06-30)
137
+
138
+ ### Features
139
+
140
+ * **ansi:** add bracketed paste markers ([5dc3d57](https://github.com/visulima/visulima/commit/5dc3d579cd1887c3b949ffee875d7259d8a5879e))
141
+ * **ansi:** add character set selection (SCS) ([60852bd](https://github.com/visulima/visulima/commit/60852bd00920dc90c582adc298584a13e4f361a8))
142
+ * **ansi:** add desktop notification sequences ([36f0a69](https://github.com/visulima/visulima/commit/36f0a69191e502750c7e104838688edd249e837e))
143
+ * **ansi:** add FinalTerm shell integration marks (OSC 133) ([e087278](https://github.com/visulima/visulima/commit/e087278a25f5665172cbaa3f4dacd628ebd344ba))
144
+ * **ansi:** add focus event reporting sequences ([83718f7](https://github.com/visulima/visulima/commit/83718f770c6e5297a69675f3adea2ba9004b95aa))
145
+ * **ansi:** add foreground/background/cursor color sequences ([2c562bd](https://github.com/visulima/visulima/commit/2c562bdfb3a67168fd106b78159b4e98d6131f47))
146
+ * **ansi:** add keypad application/numeric mode sequences ([cc62e9d](https://github.com/visulima/visulima/commit/cc62e9d21c7043df0b101c967133ae0b335e2d83))
147
+ * **ansi:** add kitty graphics protocol sequence wrapper ([6e83b5c](https://github.com/visulima/visulima/commit/6e83b5cff7938ae38df8d9aa6e019453c89ae1ea))
148
+ * **ansi:** add sixel graphics sequence wrapper ([fb2a225](https://github.com/visulima/visulima/commit/fb2a225d10ad6008e0cdc6959128d30502536c2f))
149
+ * **ansi:** add urxvt OSC 777 extension ([8b96c1a](https://github.com/visulima/visulima/commit/8b96c1ac11c19c56fa3a55adff21309ad2287b43))
150
+ * **ansi:** add working directory reporting (OSC 7) ([95059d5](https://github.com/visulima/visulima/commit/95059d5462a416393937d5bbab6ca425397a22b4))
151
+
152
+ ### Bug Fixes
153
+
154
+ * **ansi:** strip OSC terminators from color/cwd/finalterm payloads ([6c4ab8c](https://github.com/visulima/visulima/commit/6c4ab8c4cae3f8bafd7483f161887883bb315a6b))
155
+
156
+ ### Documentation
157
+
158
+ * **ansi:** document new escape sequence modules ([0bbc476](https://github.com/visulima/visulima/commit/0bbc4766259d9bde491186cadeb167d9e353f4dc))
159
+
160
+ ### Styles
161
+
162
+ * cs fixes ([2a960bb](https://github.com/visulima/visulima/commit/2a960bb1772c9dc70080e2d75d3a0d827034e294))
163
+
164
+ ### Miscellaneous Chores
165
+
166
+ * add fallow code-intelligence across all packages ([a3b4821](https://github.com/visulima/visulima/commit/a3b48215002e86fed20f2973038b5d4a0aa1ce04))
167
+ * **fallow:** resolve dead-code findings ([c4125d5](https://github.com/visulima/visulima/commit/c4125d53e03ac9d90115399634535991927a96cc))
168
+
169
+ ### Code Refactoring
170
+
171
+ * **ansi:** share OSC terminator sanitizer; address review findings ([ed2215d](https://github.com/visulima/visulima/commit/ed2215d8a61e2896dae278c7a07eae393ed415ea))
172
+
173
+ ### Continuous Integration
174
+
175
+ * **fallow:** make fallow:health advisory (--report-only) ([d57148e](https://github.com/visulima/visulima/commit/d57148ea0e3556b4c24d8d336b9fa14987f5dc7d))
176
+
177
+ ## @visulima/ansi [4.0.0-alpha.17](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.16...@visulima/ansi@4.0.0-alpha.17) (2026-06-13)
178
+
179
+ ### Features
180
+
181
+ * **ansi:** add osc52 clipboard + kitty keyboard, harden strip ([793cc9e](https://github.com/visulima/visulima/commit/793cc9e848aabe4b7b637a855941eb1f40649c94))
182
+
183
+ ### Bug Fixes
184
+
185
+ * **ansi:** strip 8-bit C1 control sequences (0x9b CSI, 0x9d OSC, …) ([ecd702d](https://github.com/visulima/visulima/commit/ecd702ded915ae4affd2a0a65583d73819d9e8b3))
186
+
187
+ ### Code Refactoring
188
+
189
+ * **ansi:** use replaceAll and reflow single-line arrow ([2f1525c](https://github.com/visulima/visulima/commit/2f1525c9176f0e7c65148fd2ac89b8cdb68a7b7e))
190
+
191
+ ### Build System
192
+
193
+ * regenerate bundled-license manifests and types ordering ([af26588](https://github.com/visulima/visulima/commit/af26588d75aaa937fd4862800560bd4070a4878c))
194
+
195
+
196
+ ### Dependencies
197
+
198
+ * **@visulima/colorize:** upgraded to 2.0.0-alpha.14
199
+ * **@visulima/path:** upgraded to 3.0.0-alpha.13
200
+
201
+ ## @visulima/ansi [4.0.0-alpha.16](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.15...@visulima/ansi@4.0.0-alpha.16) (2026-06-04)
202
+
203
+ ### Bug Fixes
204
+
205
+ * **ansi:** 3 bug fixes ([5b6977c](https://github.com/visulima/visulima/commit/5b6977caa2479f094ec4e04125127e06275c3aae))
206
+ * **lint:** clear pre-existing eslint rot across packages ([#674](https://github.com/visulima/visulima/issues/674)) ([5354253](https://github.com/visulima/visulima/commit/5354253b163bd50bcefaf8a3fddf831bdb5df32b))
207
+
208
+ ### Miscellaneous Chores
209
+
210
+ * apply eslint + prettier autofixes across packages ([c1bb784](https://github.com/visulima/visulima/commit/c1bb7848a0d93d0dfe2960c77e3cda22239c79a0))
211
+
212
+ ### Tests
213
+
214
+ * **ansi:** cover cursor moves, iterm2 file data, xterm/title guards, device-attribute reports and barrel ([13cd284](https://github.com/visulima/visulima/commit/13cd2848b0927d8150b5c8e8a2c24526ff3bdc57))
215
+
216
+
217
+ ### Dependencies
218
+
219
+ * **@visulima/colorize:** upgraded to 2.0.0-alpha.13
220
+ * **@visulima/path:** upgraded to 3.0.0-alpha.12
221
+
222
+ ## @visulima/ansi [4.0.0-alpha.15](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.14...@visulima/ansi@4.0.0-alpha.15) (2026-05-27)
223
+
224
+ ### Bug Fixes
225
+
226
+ * **storage-client:** percent-encode user fields in defaultFingerprint ([7c78a0f](https://github.com/visulima/visulima/commit/7c78a0f9512e2a673b941d80839e9f1e86b7b5d0))
227
+
228
+ ### Miscellaneous Chores
229
+
230
+ * **ci-stability:** green CI across vis, native, lint, tests, attw ([#651](https://github.com/visulima/visulima/issues/651)) ([d4eb684](https://github.com/visulima/visulima/commit/d4eb684b5f75c818c9251048c605a0ed54a268e3))
231
+ * sorted package.json ([b47c545](https://github.com/visulima/visulima/commit/b47c545591600fdab17d5cd3a3fbc68b61e199da))
232
+
233
+ ### Tests
234
+
235
+ * **repo:** add dist runtime + types integration tests ([32ee300](https://github.com/visulima/visulima/commit/32ee300b7184117a0ddf9f9d390f75f8932d5ed9))
236
+
237
+
238
+ ### Dependencies
239
+
240
+ * **@visulima/colorize:** upgraded to 2.0.0-alpha.12
241
+ * **@visulima/path:** upgraded to 3.0.0-alpha.11
242
+
243
+ ## @visulima/ansi [4.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.13...@visulima/ansi@4.0.0-alpha.14) (2026-05-20)
244
+
245
+ ### Bug Fixes
246
+
247
+ * **ansi:** sanitize title in every OSC-write helper ([75c579e](https://github.com/visulima/visulima/commit/75c579e9b009d25c4d90f959d06f0bd524c1d07a))
248
+
249
+ ### Miscellaneous Chores
250
+
251
+ * **ansi:** apply prettier and eslint quote-style auto-fix ([b564048](https://github.com/visulima/visulima/commit/b564048f5fe7c116633358874ca3b5a5a20806a3))
252
+ * **ansi:** housekeeping cleanup ([da5f5d1](https://github.com/visulima/visulima/commit/da5f5d124563ba8809a374f0f6eb9dcb022f330c))
253
+ * **ansi:** upgrade packem to 2.0.0-alpha.76 ([f970913](https://github.com/visulima/visulima/commit/f970913dadd41f5d89ecbc52b481cb5099502c3d))
254
+ * re-sort workspace package.json files via vis sort-package-json ([f625696](https://github.com/visulima/visulima/commit/f625696cfac974325774b3243e1a83c3d23acbd7))
255
+ * simplify pnpm-workspace packages list ([7cab221](https://github.com/visulima/visulima/commit/7cab221163632d9b7aa044a6f88c49083103a869))
256
+ * **terminal:** apply prettier and eslint formatting sweep ([15fd89c](https://github.com/visulima/visulima/commit/15fd89c677eea60866e08e4fd5f5a6bc8f3bd2e5))
257
+
258
+ ## @visulima/ansi [4.0.0-alpha.13](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.12...@visulima/ansi@4.0.0-alpha.13) (2026-04-22)
259
+
260
+ ### Bug Fixes
261
+
262
+ * Remove JSR configuration generation script and generated jsr.json files ([#616](https://github.com/visulima/visulima/issues/616)) ([533744b](https://github.com/visulima/visulima/commit/533744b103b74896941db5b727173e617a27a63b))
263
+
264
+
265
+ ### Dependencies
266
+
267
+ * **@visulima/colorize:** upgraded to 2.0.0-alpha.10
268
+ * **@visulima/path:** upgraded to 3.0.0-alpha.10
269
+
270
+ ## @visulima/ansi [4.0.0-alpha.12](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.11...@visulima/ansi@4.0.0-alpha.12) (2026-04-21)
271
+
272
+ ### Miscellaneous Chores
273
+
274
+ * jsr.json update and lock file ([73fce38](https://github.com/visulima/visulima/commit/73fce38c7cb4603f3fffb88609b1b18e2feb4937))
275
+
276
+ ## @visulima/ansi [4.0.0-alpha.11](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.10...@visulima/ansi@4.0.0-alpha.11) (2026-04-21)
277
+
278
+ ### Miscellaneous Chores
279
+
280
+ * update the jsr.json ([864ab7e](https://github.com/visulima/visulima/commit/864ab7e71c4b5ae82f64792d1ae8debfea2c539b))
281
+
282
+ ## @visulima/ansi [4.0.0-alpha.10](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.9...@visulima/ansi@4.0.0-alpha.10) (2026-04-21)
283
+
284
+ ### Miscellaneous Chores
285
+
286
+ * **ansi:** apply pending changes ([cd52fc6](https://github.com/visulima/visulima/commit/cd52fc6bed679efc5203d1f67f0b125d86d44aca))
287
+ * **ansi:** enforce curly braces and apply lint fixes ([bdf29eb](https://github.com/visulima/visulima/commit/bdf29ebe46f6a2506171d5bffe30cf431be61308))
288
+ * bump engines.node to ^22.14.0 || >=24.10.0 ([c3d0931](https://github.com/visulima/visulima/commit/c3d0931d1504e4f21ebf50ea680cfa7ce4ba15ce))
289
+ * fixed jsr.json ([5d85e51](https://github.com/visulima/visulima/commit/5d85e5179de38e284ec433b14d77c71a1619c8d6))
290
+
1
291
  ## @visulima/ansi [4.0.0-alpha.9](https://github.com/visulima/visulima/compare/@visulima/ansi@4.0.0-alpha.8...@visulima/ansi@4.0.0-alpha.9) (2026-04-15)
2
292
 
3
293
  ### Bug Fixes
package/LICENSE.md CHANGED
@@ -27,23 +27,6 @@ The published @visulima/ansi artifact additionally contains code with the follow
27
27
  ISC, MIT
28
28
 
29
29
  # Bundled dependencies:
30
- ## ansi-regex
31
- License: MIT
32
- By: Sindre Sorhus
33
- Repository: chalk/ansi-regex
34
-
35
- > MIT License
36
- >
37
- > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
38
- >
39
- > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
40
- >
41
- > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
42
- >
43
- > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
44
-
45
- ---------------------------------------
46
-
47
30
  ## mimic-function
48
31
  License: MIT
49
32
  By: Sindre Sorhus
@@ -122,14 +105,11 @@ Repository: https://github.com/tapjs/signal-exit.git
122
105
  <!-- TYPE_DEPENDENCIES -->
123
106
 
124
107
  # Licenses of bundled types
125
-
126
108
  The published @visulima/ansi artifact additionally contains code with the following licenses:
127
109
  MIT
128
110
 
129
111
  # Bundled types:
130
-
131
112
  ## restore-cursor
132
-
133
113
  License: MIT
134
114
  By: Sindre Sorhus
135
115
  Repository: sindresorhus/restore-cursor
package/README.md CHANGED
@@ -30,6 +30,9 @@
30
30
  Daniel Bannert's open source work is supported by the community on <a href="https://github.com/sponsors/prisis">GitHub Sponsors</a>
31
31
  </sup>
32
32
  </p>
33
+ <a href="https://anolilab.com">
34
+ <img src="../../../.github/assets/anolilab.svg" alt="Sponsored by Anolilab" width="200" />
35
+ </a>
33
36
  </div>
34
37
 
35
38
  ---
@@ -79,10 +82,10 @@ import { cursorUp, cursorLeft } from "@visulima/ansi/cursor";
79
82
  // etc, as above...
80
83
  ```
81
84
 
82
- And for commonjs:
85
+ `@visulima/ansi` is ESM-only. In a CommonJS module, load it with a dynamic `import()`:
83
86
 
84
87
  ```js
85
- const { cursorUp, cursorLeft } = require("@visulima/ansi");
88
+ const { cursorUp, cursorLeft } = await import("@visulima/ansi");
86
89
 
87
90
  // etc, as above...
88
91
  ```
@@ -107,10 +110,10 @@ process.stdout.write(eraseLine);
107
110
  **Screen Clearing**
108
111
 
109
112
  ```javascript
110
- import { clearScreen, eraseDown } from "@visulima/ansi";
113
+ import { clearScreenAndHomeCursor, eraseDown } from "@visulima/ansi";
111
114
 
112
- // Clear the entire screen
113
- process.stdout.write(clearScreen);
115
+ // Clear the entire screen and move the cursor to the top-left
116
+ process.stdout.write(clearScreenAndHomeCursor);
114
117
 
115
118
  // Clear from cursor to end of screen
116
119
  process.stdout.write(eraseDown);
@@ -150,6 +153,17 @@ This package exports the following functions and constants. For a detailed list
150
153
  - `clearScreenFromTopLeft`
151
154
  - `resetTerminal`
152
155
 
156
+ **Clipboard** (from `clipboard.ts`)
157
+
158
+ - `setClipboard` — write text to the terminal clipboard via OSC 52 (works over SSH/tmux)
159
+ - `requestClipboard` — request the clipboard contents
160
+ - `clearClipboard` — clear a clipboard selection
161
+ - `ClipboardSelection` (type)
162
+
163
+ **Constants** (from `constants.ts`)
164
+
165
+ - `ESC`, `CSI`, `OSC`, `BEL`, `SEP`, `DCS`, `ST`, `APC`, `SOS`, `PM` — low-level sequence primitives for composing custom escape sequences
166
+
153
167
  **Cursor** (from `cursor.ts`)
154
168
 
155
169
  - `CURSOR_BACKWARD_1`
@@ -288,6 +302,14 @@ This package exports the following functions and constants. For a detailed list
288
302
  - `screenPassthrough`
289
303
  - `tmuxPassthrough`
290
304
 
305
+ **Progress** (from `progress.ts`)
306
+
307
+ - `resetProgressBar`
308
+ - `setProgressBar`
309
+ - `setErrorProgressBar`
310
+ - `setIndeterminateProgressBar`
311
+ - `setWarningProgressBar`
312
+
291
313
  **Reset** (from `reset.ts`)
292
314
 
293
315
  - `RESET_INITIAL_STATE`
@@ -401,11 +423,20 @@ This package exports the following functions and constants. For a detailed list
401
423
 
402
424
  **XTerm** (from `xterm.ts`)
403
425
 
404
- - `xtermBell`
405
- - `xtermManipulateWindow`
406
- - `xtermReport`
407
- - `xtermRequest`
408
- - `xtermSet`
426
+ - `keyModifierOptions` / `XTMODKEYS`
427
+ - `queryKeyModifierOptions` / `XTQMODKEYS`
428
+ - `setKeyModifierOptions`
429
+ - `resetKeyModifierOptions`
430
+ - `setModifyOtherKeys1`
431
+ - `setModifyOtherKeys2`
432
+ - `resetModifyOtherKeys`
433
+ - `queryModifyOtherKeys`
434
+ - `pushKittyKeyboard` — push Kitty keyboard protocol flags (`CSI > flags u`)
435
+ - `popKittyKeyboard` — pop flags off the stack (`CSI < n u`)
436
+ - `setKittyKeyboard` — set flags in place (`CSI = flags ; 1 u`)
437
+ - `queryKittyKeyboard` — query current flags (`CSI ? u`)
438
+ - `KittyKeyboardFlag` — bit-flag constants
439
+ - `KittyKeyboardFlags` (type)
409
440
 
410
441
  ## Related
411
442
 
@@ -1,74 +1,75 @@
1
1
  /**
2
- * ANSI escape sequence to enable the alternative screen buffer.
3
- *
4
- * This sequence (`CSI ?1049h`) instructs the terminal to switch to the alternative screen buffer.
5
- * This is a common practice for full-screen terminal applications (e.g., vim, less, htop)
6
- * to provide a separate screen area for their interface, leaving the original shell content
7
- * undisturbed and restoring it upon exit.
8
- * When this mode is activated, the original screen content is typically saved by the terminal,
9
- * and a blank screen is presented. Operations then occur on this alternative buffer.
10
- *
11
- * The specific behavior (like whether the screen is cleared on switch) can sometimes vary
12
- * slightly between terminal emulators. `?1049h` generally includes saving the cursor position
13
- * along with the screen content and clearing the alternative screen.
14
- * It is closely related to mode `?47h`, which also switches to an alternative buffer but might
15
- * have different semantics regarding screen clearing and cursor saving.
16
- * Mode `?1049h` is generally preferred for a more robust alternative screen experience.
17
- * @see {@link ALT_SCREEN_OFF} for the sequence to disable the alternative screen buffer.
18
- * @see {@link alternativeScreenOn} for a function that returns this sequence.
19
- * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-The-Alternate-Screen-Buffer} Xterm Control Sequences documentation.
20
- * @see {@link https://vt100.net/docs/vt510-rm/DECSLPP.html} (related DEC modes, though 1049 is more common for this behavior).
21
- */
22
- export declare const ALT_SCREEN_ON: string;
2
+ * ANSI escape sequence to enable the alternative screen buffer.
3
+ *
4
+ * This sequence (`CSI ?1049h`) instructs the terminal to switch to the alternative screen buffer.
5
+ * This is a common practice for full-screen terminal applications (e.g., vim, less, htop)
6
+ * to provide a separate screen area for their interface, leaving the original shell content
7
+ * undisturbed and restoring it upon exit.
8
+ * When this mode is activated, the original screen content is typically saved by the terminal,
9
+ * and a blank screen is presented. Operations then occur on this alternative buffer.
10
+ *
11
+ * The specific behavior (like whether the screen is cleared on switch) can sometimes vary
12
+ * slightly between terminal emulators. `?1049h` generally includes saving the cursor position
13
+ * along with the screen content and clearing the alternative screen.
14
+ * It is closely related to mode `?47h`, which also switches to an alternative buffer but might
15
+ * have different semantics regarding screen clearing and cursor saving.
16
+ * Mode `?1049h` is generally preferred for a more robust alternative screen experience.
17
+ * @see {@link ALT_SCREEN_OFF} for the sequence to disable the alternative screen buffer.
18
+ * @see {@link alternativeScreenOn} for a function that returns this sequence.
19
+ * @see {@link https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h2-The-Alternate-Screen-Buffer} Xterm Control Sequences documentation.
20
+ * @see {@link https://vt100.net/docs/vt510-rm/DECSLPP.html} (related DEC modes, though 1049 is more common for this behavior).
21
+ */
22
+ declare const ALT_SCREEN_ON: string;
23
23
  /**
24
- * ANSI escape sequence to disable the alternative screen buffer.
25
- *
26
- * This sequence (`CSI ?1049l`) instructs the terminal to switch back from the alternative
27
- * screen buffer to the main screen buffer. When this occurs, the terminal typically
28
- * restores the screen content and cursor position that were saved when the alternative
29
- * buffer was activated by {@link ALT_SCREEN_ON}.
30
- *
31
- * This is used when a full-screen application exits, allowing the user to return to their
32
- * previous shell session seamlessly.
33
- * @see {@link ALT_SCREEN_ON} for the sequence to enable the alternative screen buffer.
34
- * @see {@link alternativeScreenOff} for a function that returns this sequence.
35
- */
36
- export declare const ALT_SCREEN_OFF: string;
24
+ * ANSI escape sequence to disable the alternative screen buffer.
25
+ *
26
+ * This sequence (`CSI ?1049l`) instructs the terminal to switch back from the alternative
27
+ * screen buffer to the main screen buffer. When this occurs, the terminal typically
28
+ * restores the screen content and cursor position that were saved when the alternative
29
+ * buffer was activated by {@link ALT_SCREEN_ON}.
30
+ *
31
+ * This is used when a full-screen application exits, allowing the user to return to their
32
+ * previous shell session seamlessly.
33
+ * @see {@link ALT_SCREEN_ON} for the sequence to enable the alternative screen buffer.
34
+ * @see {@link alternativeScreenOff} for a function that returns this sequence.
35
+ */
36
+ declare const ALT_SCREEN_OFF: string;
37
37
  /**
38
- * Returns the ANSI escape sequence to enable the alternative screen buffer.
39
- *
40
- * This function is a convenience wrapper around the {@link ALT_SCREEN_ON} constant.
41
- * It provides a more descriptive way to obtain the sequence for enabling the
42
- * alternative screen, often used at the initialization phase of a full-screen
43
- * terminal application.
44
- * @returns The ANSI escape sequence (`CSI ?1049h`) for enabling the alternative screen buffer.
45
- * @example
46
- * ```typescript
47
- * import { alternativeScreenOn } from '@visulima/ansi/alternative-screen';
48
- *
49
- * process.stdout.write(alternativeScreenOn());
50
- * // Terminal switches to the alternative screen buffer.
51
- * ```
52
- * @see {@link ALT_SCREEN_ON}
53
- * @see {@link alternativeScreenOff}
54
- */
55
- export declare const alternativeScreenOn: () => string;
38
+ * Returns the ANSI escape sequence to enable the alternative screen buffer.
39
+ *
40
+ * This function is a convenience wrapper around the {@link ALT_SCREEN_ON} constant.
41
+ * It provides a more descriptive way to obtain the sequence for enabling the
42
+ * alternative screen, often used at the initialization phase of a full-screen
43
+ * terminal application.
44
+ * @returns The ANSI escape sequence (`CSI ?1049h`) for enabling the alternative screen buffer.
45
+ * @example
46
+ * ```typescript
47
+ * import { alternativeScreenOn } from '@visulima/ansi/alternative-screen';
48
+ *
49
+ * process.stdout.write(alternativeScreenOn());
50
+ * // Terminal switches to the alternative screen buffer.
51
+ * ```
52
+ * @see {@link ALT_SCREEN_ON}
53
+ * @see {@link alternativeScreenOff}
54
+ */
55
+ declare const alternativeScreenOn: () => string;
56
56
  /**
57
- * Returns the ANSI escape sequence to disable the alternative screen buffer.
58
- *
59
- * This function is a convenience wrapper around the {@link ALT_SCREEN_OFF} constant.
60
- * It provides a more descriptive way to obtain the sequence for disabling the
61
- * alternative screen, typically used when a full-screen terminal application is exiting
62
- * to restore the user's original terminal state.
63
- * @returns The ANSI escape sequence (`CSI ?1049l`) for disabling the alternative screen buffer.
64
- * @example
65
- * ```typescript
66
- * import { alternativeScreenOff } from '@visulima/ansi/alternative-screen';
67
- *
68
- * process.stdout.write(alternativeScreenOff());
69
- * // Terminal switches back to the main screen buffer, restoring previous content.
70
- * ```
71
- * @see {@link ALT_SCREEN_OFF}
72
- * @see {@link alternativeScreenOn}
73
- */
74
- export declare const alternativeScreenOff: () => string;
57
+ * Returns the ANSI escape sequence to disable the alternative screen buffer.
58
+ *
59
+ * This function is a convenience wrapper around the {@link ALT_SCREEN_OFF} constant.
60
+ * It provides a more descriptive way to obtain the sequence for disabling the
61
+ * alternative screen, typically used when a full-screen terminal application is exiting
62
+ * to restore the user's original terminal state.
63
+ * @returns The ANSI escape sequence (`CSI ?1049l`) for disabling the alternative screen buffer.
64
+ * @example
65
+ * ```typescript
66
+ * import { alternativeScreenOff } from '@visulima/ansi/alternative-screen';
67
+ *
68
+ * process.stdout.write(alternativeScreenOff());
69
+ * // Terminal switches back to the main screen buffer, restoring previous content.
70
+ * ```
71
+ * @see {@link ALT_SCREEN_OFF}
72
+ * @see {@link alternativeScreenOn}
73
+ */
74
+ declare const alternativeScreenOff: () => string;
75
+ export { ALT_SCREEN_OFF, ALT_SCREEN_ON, alternativeScreenOff, alternativeScreenOn };
@@ -1,8 +1 @@
1
- import { C as CSI } from './packem_shared/constants-CE7WkXh_.js';
2
-
3
- const ALT_SCREEN_ON = `${CSI}?1049h`;
4
- const ALT_SCREEN_OFF = `${CSI}?1049l`;
5
- const alternativeScreenOn = () => ALT_SCREEN_ON;
6
- const alternativeScreenOff = () => ALT_SCREEN_OFF;
7
-
8
- export { ALT_SCREEN_OFF, ALT_SCREEN_ON, alternativeScreenOff, alternativeScreenOn };
1
+ import{CSI as e}from"./constants.js";const r=`${e}?1049h`,t=`${e}?1049l`,S=()=>r,a=()=>t;export{t as ALT_SCREEN_OFF,r as ALT_SCREEN_ON,a as alternativeScreenOff,S as alternativeScreenOn};