@yagnikpt/tpaper 0.1.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.
package/LICENSE ADDED
@@ -0,0 +1,9 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Yagnik Patel
4
+
5
+ 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:
6
+
7
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ 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.
package/README.md ADDED
@@ -0,0 +1,50 @@
1
+ # tpaper
2
+
3
+ A terminal-based note-taking app built around the idea of **buffers** and **blocks** — think of it as a lightweight, keyboard-driven notebook that lives entirely in your terminal.
4
+
5
+ Yes its a [heynote](https://github.com/heyman/heynote) rip-off for the terminal with less features.
6
+
7
+
8
+ ![Demo GIF](assets/demo.gif)
9
+
10
+ ## Concepts
11
+
12
+ - **Buffer** — a named collection of blocks, stored as a Markdown file on disk. Roughly analogous to a notebook or a tab.
13
+ - **Block** — an individual note within a buffer, written in Markdown and rendered with syntax highlighting in the terminal.
14
+
15
+ ## Data storage
16
+
17
+ Everything is stored locally. The exact paths depend on your OS.
18
+
19
+ | Kind | Path (Linux example) |
20
+ |---|---|
21
+ | Buffers | `~/.local/share/tpaper-cli/` |
22
+ | Config | `~/.config/tpaper-cli/config.yaml` |
23
+
24
+ Buffers are plain Markdown files. Blocks are delimited by HTML comments so the files remain human-readable outside the app.
25
+
26
+ ## Development
27
+
28
+ ```bash
29
+ bun install
30
+ bun dev # run with file watching
31
+ ```
32
+
33
+ ## Building
34
+
35
+ ```bash
36
+ bun run build # produces dist/tpaper (linux-x64 by default)
37
+ ```
38
+
39
+ You can override the target and output path via environment variables:
40
+
41
+ ```bash
42
+ BUN_TARGET=bun-darwin-arm64 OUTFILE=./dist/tpaper-mac bun run build
43
+ ```
44
+
45
+ ## Stack
46
+
47
+ - [OpenTUI](https://opentui.com) — terminal UI framework
48
+ - [Solid.js](https://solidjs.com) — reactive UI layer
49
+ - [Bun](https://bun.sh) — runtime and bundler
50
+ - [js-yaml](https://github.com/nodeca/js-yaml) — config serialization
@@ -0,0 +1,604 @@
1
+ ; Query from: https://raw.githubusercontent.com/nvim-treesitter/nvim-treesitter/refs/heads/master/queries/ecma/highlights.scm
2
+ ; Types
3
+ ; Javascript
4
+ ; Variables
5
+ ;-----------
6
+ (identifier) @variable
7
+
8
+ ; Properties
9
+ ;-----------
10
+ (property_identifier) @variable.member
11
+
12
+ (shorthand_property_identifier) @variable.member
13
+
14
+ (private_property_identifier) @variable.member
15
+
16
+ (object_pattern
17
+ (shorthand_property_identifier_pattern) @variable)
18
+
19
+ (object_pattern
20
+ (object_assignment_pattern
21
+ (shorthand_property_identifier_pattern) @variable))
22
+
23
+ ; Special identifiers
24
+ ;--------------------
25
+ ((identifier) @type
26
+ (#lua-match? @type "^[A-Z]"))
27
+
28
+ ((identifier) @constant
29
+ (#lua-match? @constant "^_*[A-Z][A-Z%d_]*$"))
30
+
31
+ ((shorthand_property_identifier) @constant
32
+ (#lua-match? @constant "^_*[A-Z][A-Z%d_]*$"))
33
+
34
+ ((identifier) @variable.builtin
35
+ (#any-of? @variable.builtin "arguments" "module" "console" "window" "document"))
36
+
37
+ ((identifier) @type.builtin
38
+ (#any-of? @type.builtin
39
+ "Object" "Function" "Boolean" "Symbol" "Number" "Math" "Date" "String" "RegExp" "Map" "Set"
40
+ "WeakMap" "WeakSet" "Promise" "Array" "Int8Array" "Uint8Array" "Uint8ClampedArray" "Int16Array"
41
+ "Uint16Array" "Int32Array" "Uint32Array" "Float32Array" "Float64Array" "ArrayBuffer" "DataView"
42
+ "Error" "EvalError" "InternalError" "RangeError" "ReferenceError" "SyntaxError" "TypeError"
43
+ "URIError"))
44
+
45
+ (statement_identifier) @label
46
+
47
+ ; Function and method definitions
48
+ ;--------------------------------
49
+ (function_expression
50
+ name: (identifier) @function)
51
+
52
+ (function_declaration
53
+ name: (identifier) @function)
54
+
55
+ (generator_function
56
+ name: (identifier) @function)
57
+
58
+ (generator_function_declaration
59
+ name: (identifier) @function)
60
+
61
+ (method_definition
62
+ name: [
63
+ (property_identifier)
64
+ (private_property_identifier)
65
+ ] @function.method)
66
+
67
+ (method_definition
68
+ name: (property_identifier) @constructor
69
+ (#eq? @constructor "constructor"))
70
+
71
+ (pair
72
+ key: (property_identifier) @function.method
73
+ value: (function_expression))
74
+
75
+ (pair
76
+ key: (property_identifier) @function.method
77
+ value: (arrow_function))
78
+
79
+ (assignment_expression
80
+ left: (member_expression
81
+ property: (property_identifier) @function.method)
82
+ right: (arrow_function))
83
+
84
+ (assignment_expression
85
+ left: (member_expression
86
+ property: (property_identifier) @function.method)
87
+ right: (function_expression))
88
+
89
+ (variable_declarator
90
+ name: (identifier) @function
91
+ value: (arrow_function))
92
+
93
+ (variable_declarator
94
+ name: (identifier) @function
95
+ value: (function_expression))
96
+
97
+ (assignment_expression
98
+ left: (identifier) @function
99
+ right: (arrow_function))
100
+
101
+ (assignment_expression
102
+ left: (identifier) @function
103
+ right: (function_expression))
104
+
105
+ ; Function and method calls
106
+ ;--------------------------
107
+ (call_expression
108
+ function: (identifier) @function.call)
109
+
110
+ (call_expression
111
+ function: (member_expression
112
+ property: [
113
+ (property_identifier)
114
+ (private_property_identifier)
115
+ ] @function.method.call))
116
+
117
+ (call_expression
118
+ function: (await_expression
119
+ (identifier) @function.call))
120
+
121
+ (call_expression
122
+ function: (await_expression
123
+ (member_expression
124
+ property: [
125
+ (property_identifier)
126
+ (private_property_identifier)
127
+ ] @function.method.call)))
128
+
129
+ ; Builtins
130
+ ;---------
131
+ ((identifier) @module.builtin
132
+ (#eq? @module.builtin "Intl"))
133
+
134
+ ((identifier) @function.builtin
135
+ (#any-of? @function.builtin
136
+ "eval" "isFinite" "isNaN" "parseFloat" "parseInt" "decodeURI" "decodeURIComponent" "encodeURI"
137
+ "encodeURIComponent" "require"))
138
+
139
+ ; Constructor
140
+ ;------------
141
+ (new_expression
142
+ constructor: (identifier) @constructor)
143
+
144
+ ; Decorators
145
+ ;----------
146
+ (decorator
147
+ "@" @attribute
148
+ (identifier) @attribute)
149
+
150
+ (decorator
151
+ "@" @attribute
152
+ (call_expression
153
+ (identifier) @attribute))
154
+
155
+ (decorator
156
+ "@" @attribute
157
+ (member_expression
158
+ (property_identifier) @attribute))
159
+
160
+ (decorator
161
+ "@" @attribute
162
+ (call_expression
163
+ (member_expression
164
+ (property_identifier) @attribute)))
165
+
166
+ ; Literals
167
+ ;---------
168
+ [
169
+ (this)
170
+ (super)
171
+ ] @variable.builtin
172
+
173
+ ((identifier) @variable.builtin
174
+ (#eq? @variable.builtin "self"))
175
+
176
+ [
177
+ (true)
178
+ (false)
179
+ ] @boolean
180
+
181
+ [
182
+ (null)
183
+ (undefined)
184
+ ] @constant.builtin
185
+
186
+ [
187
+ (comment)
188
+ (html_comment)
189
+ ] @comment @spell
190
+
191
+ ((comment) @comment.documentation
192
+ (#lua-match? @comment.documentation "^/[*][*][^*].*[*]/$"))
193
+
194
+ (hash_bang_line) @keyword.directive
195
+
196
+ ((string_fragment) @keyword.directive
197
+ (#eq? @keyword.directive "use strict"))
198
+
199
+ (string) @string
200
+
201
+ (template_string) @string
202
+
203
+ (escape_sequence) @string.escape
204
+
205
+ (regex_pattern) @string.regexp
206
+
207
+ (regex_flags) @character.special
208
+
209
+ (regex
210
+ "/" @punctuation.bracket) ; Regex delimiters
211
+
212
+ (number) @number
213
+
214
+ ((identifier) @number
215
+ (#any-of? @number "NaN" "Infinity"))
216
+
217
+ ; Punctuation
218
+ ;------------
219
+ [
220
+ ";"
221
+ "."
222
+ ","
223
+ ":"
224
+ ] @punctuation.delimiter
225
+
226
+ [
227
+ "--"
228
+ "-"
229
+ "-="
230
+ "&&"
231
+ "+"
232
+ "++"
233
+ "+="
234
+ "&="
235
+ "/="
236
+ "**="
237
+ "<<="
238
+ "<"
239
+ "<="
240
+ "<<"
241
+ "="
242
+ "=="
243
+ "==="
244
+ "!="
245
+ "!=="
246
+ "=>"
247
+ ">"
248
+ ">="
249
+ ">>"
250
+ "||"
251
+ "%"
252
+ "%="
253
+ "*"
254
+ "**"
255
+ ">>>"
256
+ "&"
257
+ "|"
258
+ "^"
259
+ "??"
260
+ "*="
261
+ ">>="
262
+ ">>>="
263
+ "^="
264
+ "|="
265
+ "&&="
266
+ "||="
267
+ "??="
268
+ "..."
269
+ ] @operator
270
+
271
+ (binary_expression
272
+ "/" @operator)
273
+
274
+ (ternary_expression
275
+ [
276
+ "?"
277
+ ":"
278
+ ] @keyword.conditional.ternary)
279
+
280
+ (unary_expression
281
+ [
282
+ "!"
283
+ "~"
284
+ "-"
285
+ "+"
286
+ ] @operator)
287
+
288
+ (unary_expression
289
+ [
290
+ "delete"
291
+ "void"
292
+ ] @keyword.operator)
293
+
294
+ [
295
+ "("
296
+ ")"
297
+ "["
298
+ "]"
299
+ "{"
300
+ "}"
301
+ ] @punctuation.bracket
302
+
303
+ (template_substitution
304
+ [
305
+ "${"
306
+ "}"
307
+ ] @punctuation.special) @none
308
+
309
+ ; Imports
310
+ ;----------
311
+ (namespace_import
312
+ "*" @character.special
313
+ (identifier) @module)
314
+
315
+ (namespace_export
316
+ "*" @character.special
317
+ (identifier) @module)
318
+
319
+ (export_statement
320
+ "*" @character.special)
321
+
322
+ ; Keywords
323
+ ;----------
324
+ [
325
+ "if"
326
+ "else"
327
+ "switch"
328
+ "case"
329
+ ] @keyword.conditional
330
+
331
+ [
332
+ "import"
333
+ "from"
334
+ "as"
335
+ "export"
336
+ ] @keyword.import
337
+
338
+ [
339
+ "for"
340
+ "of"
341
+ "do"
342
+ "while"
343
+ "continue"
344
+ ] @keyword.repeat
345
+
346
+ [
347
+ "break"
348
+ "const"
349
+ "debugger"
350
+ "extends"
351
+ "get"
352
+ "let"
353
+ "set"
354
+ "static"
355
+ "target"
356
+ "var"
357
+ "with"
358
+ ] @keyword
359
+
360
+ "class" @keyword.type
361
+
362
+ [
363
+ "async"
364
+ "await"
365
+ ] @keyword.coroutine
366
+
367
+ [
368
+ "return"
369
+ "yield"
370
+ ] @keyword.return
371
+
372
+ "function" @keyword.function
373
+
374
+ [
375
+ "new"
376
+ "delete"
377
+ "in"
378
+ "instanceof"
379
+ "typeof"
380
+ ] @keyword.operator
381
+
382
+ [
383
+ "throw"
384
+ "try"
385
+ "catch"
386
+ "finally"
387
+ ] @keyword.exception
388
+
389
+ (export_statement
390
+ "default" @keyword)
391
+
392
+ (switch_default
393
+ "default" @keyword.conditional)
394
+
395
+
396
+ ; Query from: https://raw.githubusercontent.com/nvim-treesitter/nvim-treesitter/refs/heads/master/queries/typescript/highlights.scm
397
+ ; inherits: ecma
398
+
399
+ "require" @keyword.import
400
+
401
+ (import_require_clause
402
+ source: (string) @string.special.url)
403
+
404
+ [
405
+ "declare"
406
+ "implements"
407
+ "type"
408
+ "override"
409
+ "module"
410
+ "asserts"
411
+ "infer"
412
+ "is"
413
+ "using"
414
+ ] @keyword
415
+
416
+ [
417
+ "namespace"
418
+ "interface"
419
+ "enum"
420
+ ] @keyword.type
421
+
422
+ [
423
+ "keyof"
424
+ "satisfies"
425
+ ] @keyword.operator
426
+
427
+ (as_expression
428
+ "as" @keyword.operator)
429
+
430
+ (mapped_type_clause
431
+ "as" @keyword.operator)
432
+
433
+ [
434
+ "abstract"
435
+ "private"
436
+ "protected"
437
+ "public"
438
+ "readonly"
439
+ ] @keyword.modifier
440
+
441
+ ; types
442
+ (type_identifier) @type
443
+
444
+ (predefined_type) @type.builtin
445
+
446
+ (import_statement
447
+ "type"
448
+ (import_clause
449
+ (named_imports
450
+ (import_specifier
451
+ name: (identifier) @type))))
452
+
453
+ (template_literal_type) @string
454
+
455
+ (non_null_expression
456
+ "!" @operator)
457
+
458
+ ; punctuation
459
+ (type_arguments
460
+ [
461
+ "<"
462
+ ">"
463
+ ] @punctuation.bracket)
464
+
465
+ (type_parameters
466
+ [
467
+ "<"
468
+ ">"
469
+ ] @punctuation.bracket)
470
+
471
+ (object_type
472
+ [
473
+ "{|"
474
+ "|}"
475
+ ] @punctuation.bracket)
476
+
477
+ (union_type
478
+ "|" @punctuation.delimiter)
479
+
480
+ (intersection_type
481
+ "&" @punctuation.delimiter)
482
+
483
+ (type_annotation
484
+ ":" @punctuation.delimiter)
485
+
486
+ (type_predicate_annotation
487
+ ":" @punctuation.delimiter)
488
+
489
+ (index_signature
490
+ ":" @punctuation.delimiter)
491
+
492
+ (omitting_type_annotation
493
+ "-?:" @punctuation.delimiter)
494
+
495
+ (adding_type_annotation
496
+ "+?:" @punctuation.delimiter)
497
+
498
+ (opting_type_annotation
499
+ "?:" @punctuation.delimiter)
500
+
501
+ "?." @punctuation.delimiter
502
+
503
+ (abstract_method_signature
504
+ "?" @punctuation.special)
505
+
506
+ (method_signature
507
+ "?" @punctuation.special)
508
+
509
+ (method_definition
510
+ "?" @punctuation.special)
511
+
512
+ (property_signature
513
+ "?" @punctuation.special)
514
+
515
+ (optional_parameter
516
+ "?" @punctuation.special)
517
+
518
+ (optional_type
519
+ "?" @punctuation.special)
520
+
521
+ (public_field_definition
522
+ [
523
+ "?"
524
+ "!"
525
+ ] @punctuation.special)
526
+
527
+ (flow_maybe_type
528
+ "?" @punctuation.special)
529
+
530
+ (template_type
531
+ [
532
+ "${"
533
+ "}"
534
+ ] @punctuation.special)
535
+
536
+ (conditional_type
537
+ [
538
+ "?"
539
+ ":"
540
+ ] @keyword.conditional.ternary)
541
+
542
+ ; Parameters
543
+ (required_parameter
544
+ pattern: (identifier) @variable.parameter)
545
+
546
+ (optional_parameter
547
+ pattern: (identifier) @variable.parameter)
548
+
549
+ (required_parameter
550
+ (rest_pattern
551
+ (identifier) @variable.parameter))
552
+
553
+ ; ({ a }) => null
554
+ (required_parameter
555
+ (object_pattern
556
+ (shorthand_property_identifier_pattern) @variable.parameter))
557
+
558
+ ; ({ a = b }) => null
559
+ (required_parameter
560
+ (object_pattern
561
+ (object_assignment_pattern
562
+ (shorthand_property_identifier_pattern) @variable.parameter)))
563
+
564
+ ; ({ a: b }) => null
565
+ (required_parameter
566
+ (object_pattern
567
+ (pair_pattern
568
+ value: (identifier) @variable.parameter)))
569
+
570
+ ; ([ a ]) => null
571
+ (required_parameter
572
+ (array_pattern
573
+ (identifier) @variable.parameter))
574
+
575
+ ; a => null
576
+ (arrow_function
577
+ parameter: (identifier) @variable.parameter)
578
+
579
+ ; global declaration
580
+ (ambient_declaration
581
+ "global" @module)
582
+
583
+ ; function signatures
584
+ (ambient_declaration
585
+ (function_signature
586
+ name: (identifier) @function))
587
+
588
+ ; method signatures
589
+ (method_signature
590
+ name: (_) @function.method)
591
+
592
+ (abstract_method_signature
593
+ name: (property_identifier) @function.method)
594
+
595
+ ; property signatures
596
+ (property_signature
597
+ name: (property_identifier) @function.method
598
+ type: (type_annotation
599
+ [
600
+ (union_type
601
+ (parenthesized_type
602
+ (function_type)))
603
+ (function_type)
604
+ ]))