@hyperscale0/hsx 1.0.0 → 1.0.124

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 (316) hide show
  1. package/CHANGELOG.md +5 -256
  2. package/LICENSE.md +356 -0
  3. package/NOTICE.md +8 -0
  4. package/README.md +44 -44
  5. package/bin/hsx.ts +0 -7
  6. package/dist/bin/hsx.d.ts +0 -4
  7. package/dist/bin/hsx.d.ts.map +1 -1
  8. package/dist/bin/hsx.js +0 -6
  9. package/dist/bin/hsx.js.map +1 -1
  10. package/dist/src/ast.d.ts +113 -308
  11. package/dist/src/ast.d.ts.map +1 -1
  12. package/dist/src/ast.js +7 -71
  13. package/dist/src/ast.js.map +1 -1
  14. package/dist/src/attachment-economics.d.ts +5 -0
  15. package/dist/src/attachment-economics.d.ts.map +1 -0
  16. package/dist/src/attachment-economics.js +55 -0
  17. package/dist/src/attachment-economics.js.map +1 -0
  18. package/dist/src/binding-contract.d.ts +22 -0
  19. package/dist/src/binding-contract.d.ts.map +1 -0
  20. package/dist/src/binding-contract.js +74 -0
  21. package/dist/src/binding-contract.js.map +1 -0
  22. package/dist/src/cli.d.ts +4 -19
  23. package/dist/src/cli.d.ts.map +1 -1
  24. package/dist/src/cli.js +89 -276
  25. package/dist/src/cli.js.map +1 -1
  26. package/dist/src/compile.d.ts +34 -66
  27. package/dist/src/compile.d.ts.map +1 -1
  28. package/dist/src/compile.js +2949 -117
  29. package/dist/src/compile.js.map +1 -1
  30. package/dist/src/cost.d.ts +8 -75
  31. package/dist/src/cost.d.ts.map +1 -1
  32. package/dist/src/cost.js +54 -364
  33. package/dist/src/cost.js.map +1 -1
  34. package/dist/src/diagnostics.d.ts +14 -9
  35. package/dist/src/diagnostics.d.ts.map +1 -1
  36. package/dist/src/diagnostics.js +39 -416
  37. package/dist/src/diagnostics.js.map +1 -1
  38. package/dist/src/examples-bundle.d.ts +3 -0
  39. package/dist/src/examples-bundle.d.ts.map +1 -0
  40. package/dist/src/examples-bundle.js +18 -0
  41. package/dist/src/examples-bundle.js.map +1 -0
  42. package/dist/src/examples.d.ts +10 -0
  43. package/dist/src/examples.d.ts.map +1 -0
  44. package/dist/src/examples.js +2 -0
  45. package/dist/src/examples.js.map +1 -0
  46. package/dist/src/format.d.ts +8 -7
  47. package/dist/src/format.d.ts.map +1 -1
  48. package/dist/src/format.js +9 -175
  49. package/dist/src/format.js.map +1 -1
  50. package/dist/src/header-source.d.ts +3 -0
  51. package/dist/src/header-source.d.ts.map +1 -0
  52. package/dist/src/header-source.js +41 -0
  53. package/dist/src/header-source.js.map +1 -0
  54. package/dist/src/headers.d.ts +64 -0
  55. package/dist/src/headers.d.ts.map +1 -0
  56. package/dist/src/headers.js +167 -0
  57. package/dist/src/headers.js.map +1 -0
  58. package/dist/src/index.d.ts +7 -11
  59. package/dist/src/index.d.ts.map +1 -1
  60. package/dist/src/index.js +4 -9
  61. package/dist/src/index.js.map +1 -1
  62. package/dist/src/keywords.d.ts +56 -0
  63. package/dist/src/keywords.d.ts.map +1 -0
  64. package/dist/src/keywords.js +133 -0
  65. package/dist/src/keywords.js.map +1 -0
  66. package/dist/src/language.d.ts +26 -0
  67. package/dist/src/language.d.ts.map +1 -0
  68. package/dist/src/language.js +440 -0
  69. package/dist/src/language.js.map +1 -0
  70. package/dist/src/lex.d.ts +13 -28
  71. package/dist/src/lex.d.ts.map +1 -1
  72. package/dist/src/lex.js +119 -145
  73. package/dist/src/lex.js.map +1 -1
  74. package/dist/src/parse.d.ts +4 -17
  75. package/dist/src/parse.d.ts.map +1 -1
  76. package/dist/src/parse.js +484 -1036
  77. package/dist/src/parse.js.map +1 -1
  78. package/dist/src/std-bundle.d.ts.map +1 -1
  79. package/dist/src/std-bundle.js +11 -84
  80. package/dist/src/std-bundle.js.map +1 -1
  81. package/dist/src/std-library.d.ts +1 -1
  82. package/dist/src/std-library.d.ts.map +1 -1
  83. package/dist/src/std-library.js +1 -5
  84. package/dist/src/std-library.js.map +1 -1
  85. package/dist/src/tunables.d.ts +7 -0
  86. package/dist/src/tunables.d.ts.map +1 -0
  87. package/dist/src/tunables.js +27 -0
  88. package/dist/src/tunables.js.map +1 -0
  89. package/docs/README.md +528 -26
  90. package/docs/assets/brand/hsx-horizontal-white.svg +1 -0
  91. package/docs/assets/brand/hsx-horizontal.svg +1 -0
  92. package/docs/assets/brand/hsx-stacked-white.svg +1 -0
  93. package/docs/assets/brand/hsx-stacked.svg +1 -0
  94. package/docs/assets/brand/manifest.json +30 -0
  95. package/docs/assets/hsx.svg +11 -0
  96. package/examples/cards.hsx +34 -0
  97. package/examples/collections.hsx +37 -0
  98. package/examples/cost-table.json +633 -385
  99. package/examples/escrow.hsx +24 -0
  100. package/examples/financing.hsx +32 -0
  101. package/examples/insurance.hsx +30 -0
  102. package/examples/lending.hsx +57 -0
  103. package/examples/library.hsx +15 -0
  104. package/examples/marketplace.hsx +32 -0
  105. package/examples/money.hsx +19 -0
  106. package/examples/rental-deposit.hsx +60 -0
  107. package/examples/repair-approval.hsx +44 -0
  108. package/examples/reporting.hsx +28 -0
  109. package/examples/savings.hsx +21 -0
  110. package/examples/serviced.hsx +25 -0
  111. package/examples/wallet.hsx +24 -0
  112. package/package.json +25 -23
  113. package/src/ast.ts +83 -440
  114. package/src/attachment-economics.ts +103 -0
  115. package/src/binding-contract.ts +104 -0
  116. package/src/cli.ts +95 -325
  117. package/src/compile.ts +4063 -209
  118. package/src/cost.ts +71 -574
  119. package/src/diagnostics.ts +57 -437
  120. package/src/examples-bundle.ts +19 -0
  121. package/src/examples.ts +9 -0
  122. package/src/format.ts +12 -256
  123. package/src/header-source.ts +54 -0
  124. package/src/headers.ts +195 -0
  125. package/src/index.ts +18 -33
  126. package/src/keywords.ts +134 -0
  127. package/src/language.ts +629 -0
  128. package/src/lex.ts +131 -192
  129. package/src/parse.ts +489 -1195
  130. package/src/std-bundle.ts +12 -88
  131. package/src/std-library.ts +2 -7
  132. package/src/tunables.ts +36 -0
  133. package/std/cards.hsx +85 -0
  134. package/std/collections.hsx +90 -0
  135. package/std/escrow.hsx +73 -0
  136. package/std/financing.hsx +683 -0
  137. package/std/insurance.hsx +89 -0
  138. package/std/lending.hsx +138 -0
  139. package/std/marketplace.hsx +123 -0
  140. package/std/money.hsx +173 -0
  141. package/std/reporting.hsx +753 -0
  142. package/std/savings.hsx +68 -0
  143. package/std/wallet.hsx +57 -0
  144. package/LICENSE +0 -661
  145. package/LICENSING.md +0 -52
  146. package/TRADEMARKS.md +0 -35
  147. package/dist/src/emit.d.ts +0 -34
  148. package/dist/src/emit.d.ts.map +0 -1
  149. package/dist/src/emit.js +0 -137
  150. package/dist/src/emit.js.map +0 -1
  151. package/dist/src/entry-overrides.d.ts +0 -58
  152. package/dist/src/entry-overrides.d.ts.map +0 -1
  153. package/dist/src/entry-overrides.js +0 -284
  154. package/dist/src/entry-overrides.js.map +0 -1
  155. package/dist/src/ir.d.ts +0 -66
  156. package/dist/src/ir.d.ts.map +0 -1
  157. package/dist/src/ir.js +0 -15
  158. package/dist/src/ir.js.map +0 -1
  159. package/dist/src/limits.d.ts +0 -21
  160. package/dist/src/limits.d.ts.map +0 -1
  161. package/dist/src/limits.js +0 -21
  162. package/dist/src/limits.js.map +0 -1
  163. package/dist/src/lsp/server.d.ts +0 -32
  164. package/dist/src/lsp/server.d.ts.map +0 -1
  165. package/dist/src/lsp/server.js +0 -391
  166. package/dist/src/lsp/server.js.map +0 -1
  167. package/dist/src/modules.d.ts +0 -38
  168. package/dist/src/modules.d.ts.map +0 -1
  169. package/dist/src/modules.js +0 -368
  170. package/dist/src/modules.js.map +0 -1
  171. package/dist/src/typecheck.d.ts +0 -8
  172. package/dist/src/typecheck.d.ts.map +0 -1
  173. package/dist/src/typecheck.js +0 -2958
  174. package/dist/src/typecheck.js.map +0 -1
  175. package/dist/src/version.d.ts +0 -5
  176. package/dist/src/version.d.ts.map +0 -1
  177. package/dist/src/version.js +0 -5
  178. package/dist/src/version.js.map +0 -1
  179. package/docs/guide/01-first-program.md +0 -24
  180. package/docs/guide/02-money.md +0 -25
  181. package/docs/guide/03-instruments.md +0 -22
  182. package/docs/guide/04-lifecycles.md +0 -25
  183. package/docs/guide/05-fees-and-splits.md +0 -45
  184. package/docs/guide/06-schedules.md +0 -22
  185. package/docs/guide/07-composition.md +0 -46
  186. package/docs/guide/08-writing-a-module.md +0 -26
  187. package/docs/guide/09-cost.md +0 -24
  188. package/docs/guide/10-diagnostics.md +0 -27
  189. package/docs/llms-full.txt +0 -1739
  190. package/docs/llms.txt +0 -45
  191. package/docs/playground.md +0 -54
  192. package/docs/reference/cli.md +0 -35
  193. package/docs/reference/diagnostics.md +0 -619
  194. package/docs/reference/grammar.md +0 -39
  195. package/docs/reference/std/advance.md +0 -35
  196. package/docs/reference/std/cancellable_booking.md +0 -35
  197. package/docs/reference/std/captured_payment.md +0 -43
  198. package/docs/reference/std/conditional_disbursement.md +0 -33
  199. package/docs/reference/std/credit_facility.md +0 -35
  200. package/docs/reference/std/held_payment.md +0 -64
  201. package/docs/reference/std/instant_transfer.md +0 -30
  202. package/docs/reference/std/metered.md +0 -27
  203. package/docs/reference/std/pooled_split.md +0 -26
  204. package/docs/reference/std/premium_forward.md +0 -39
  205. package/docs/reference/std/reconciled_payout.md +0 -33
  206. package/docs/reference/std/recurring_collection.md +0 -25
  207. package/docs/reference/std/rotating_pool.md +0 -42
  208. package/docs/reference/std/scheduled.md +0 -51
  209. package/docs/reference/std/security_deposit.md +0 -46
  210. package/docs/reference/std/settlement_batch.md +0 -42
  211. package/docs/reference/std/swap.md +0 -46
  212. package/docs/reference/std/threshold_pool.md +0 -47
  213. package/docs/reference/std/weighted_distribution.md +0 -39
  214. package/docs/reference/types.md +0 -20
  215. package/docs/reference/udl-output.md +0 -13
  216. package/docs/sessions/2026-09-02-two-instruments.hsx +0 -21
  217. package/docs/sessions/2026-09-02-two-instruments.md +0 -41
  218. package/examples/01-first-program/README.md +0 -45
  219. package/examples/01-first-program/tip-jar.hsx +0 -17
  220. package/examples/02-imports-and-archetypes/README.md +0 -96
  221. package/examples/02-imports-and-archetypes/photo-booth.hsx +0 -37
  222. package/examples/03-diagnostics/README.md +0 -68
  223. package/examples/03-diagnostics/corner-shop-fixed.hsx +0 -22
  224. package/examples/03-diagnostics/corner-shop.hsx +0 -19
  225. package/examples/04-complete-product/README.md +0 -84
  226. package/examples/04-complete-product/study-hall.hsx +0 -67
  227. package/examples/05-watch-club/README.md +0 -9
  228. package/examples/05-watch-club/watch-club.hsx +0 -124
  229. package/examples/README.md +0 -18
  230. package/examples/advance/README.md +0 -3
  231. package/examples/advance/advance.hsx +0 -13
  232. package/examples/advance/advance.udl +0 -339
  233. package/examples/cancellable_booking/README.md +0 -3
  234. package/examples/cancellable_booking/cancellable_booking.hsx +0 -14
  235. package/examples/cancellable_booking/cancellable_booking.udl +0 -391
  236. package/examples/captured_payment/README.md +0 -3
  237. package/examples/captured_payment/captured_payment.hsx +0 -21
  238. package/examples/captured_payment/captured_payment.udl +0 -677
  239. package/examples/conditional_disbursement/README.md +0 -3
  240. package/examples/conditional_disbursement/conditional_disbursement.hsx +0 -17
  241. package/examples/conditional_disbursement/conditional_disbursement.udl +0 -412
  242. package/examples/credit_facility/README.md +0 -3
  243. package/examples/credit_facility/credit_facility.hsx +0 -27
  244. package/examples/credit_facility/credit_facility.udl +0 -1373
  245. package/examples/held_payment/README.md +0 -3
  246. package/examples/held_payment/held_payment.hsx +0 -13
  247. package/examples/held_payment/held_payment.udl +0 -507
  248. package/examples/instant_transfer/README.md +0 -3
  249. package/examples/instant_transfer/instant_transfer.hsx +0 -16
  250. package/examples/instant_transfer/instant_transfer.udl +0 -364
  251. package/examples/metered/README.md +0 -3
  252. package/examples/metered/metered.hsx +0 -13
  253. package/examples/metered/metered.udl +0 -247
  254. package/examples/pooled_split/README.md +0 -3
  255. package/examples/pooled_split/pooled_split.hsx +0 -15
  256. package/examples/pooled_split/pooled_split.udl +0 -425
  257. package/examples/premium_forward/README.md +0 -3
  258. package/examples/premium_forward/premium_forward.hsx +0 -19
  259. package/examples/premium_forward/premium_forward.udl +0 -594
  260. package/examples/reconciled_payout/README.md +0 -3
  261. package/examples/reconciled_payout/reconciled_payout.hsx +0 -13
  262. package/examples/reconciled_payout/reconciled_payout.udl +0 -303
  263. package/examples/recurring_collection/README.md +0 -3
  264. package/examples/recurring_collection/recurring_collection.hsx +0 -21
  265. package/examples/recurring_collection/recurring_collection.udl +0 -1130
  266. package/examples/rotating_pool/README.md +0 -3
  267. package/examples/rotating_pool/rotating_pool.hsx +0 -18
  268. package/examples/rotating_pool/rotating_pool.udl +0 -4352
  269. package/examples/scheduled/README.md +0 -3
  270. package/examples/scheduled/scheduled.hsx +0 -12
  271. package/examples/scheduled/scheduled.udl +0 -335
  272. package/examples/security_deposit/README.md +0 -3
  273. package/examples/security_deposit/security_deposit.hsx +0 -21
  274. package/examples/security_deposit/security_deposit.udl +0 -293
  275. package/examples/settlement_batch/README.md +0 -3
  276. package/examples/settlement_batch/settlement_batch.hsx +0 -19
  277. package/examples/settlement_batch/settlement_batch.udl +0 -753
  278. package/examples/swap/README.md +0 -3
  279. package/examples/swap/swap.hsx +0 -19
  280. package/examples/swap/swap.udl +0 -876
  281. package/examples/threshold_pool/README.md +0 -3
  282. package/examples/threshold_pool/threshold_pool.hsx +0 -16
  283. package/examples/threshold_pool/threshold_pool.udl +0 -667
  284. package/examples/weighted_distribution/README.md +0 -3
  285. package/examples/weighted_distribution/weighted_distribution.hsx +0 -20
  286. package/examples/weighted_distribution/weighted_distribution.udl +0 -337
  287. package/skills/hsx/SKILL.md +0 -483
  288. package/src/emit.ts +0 -201
  289. package/src/entry-overrides.ts +0 -428
  290. package/src/ir.ts +0 -99
  291. package/src/limits.ts +0 -20
  292. package/src/lsp/server.ts +0 -460
  293. package/src/modules.ts +0 -446
  294. package/src/typecheck.ts +0 -3876
  295. package/src/version.ts +0 -5
  296. package/std/SEMANTICS.md +0 -130
  297. package/std/settlements/advance.hsx +0 -177
  298. package/std/settlements/cancellable_booking.hsx +0 -87
  299. package/std/settlements/captured_payment.hsx +0 -144
  300. package/std/settlements/conditional_disbursement.hsx +0 -185
  301. package/std/settlements/credit_facility.hsx +0 -167
  302. package/std/settlements/held_payment.hsx +0 -578
  303. package/std/settlements/index.hsx +0 -3
  304. package/std/settlements/instant_transfer.hsx +0 -190
  305. package/std/settlements/metered.hsx +0 -67
  306. package/std/settlements/pooled_split.hsx +0 -68
  307. package/std/settlements/premium_forward.hsx +0 -257
  308. package/std/settlements/reconciled_payout.hsx +0 -77
  309. package/std/settlements/recurring_collection.hsx +0 -27
  310. package/std/settlements/rotating_pool.hsx +0 -252
  311. package/std/settlements/scheduled.hsx +0 -641
  312. package/std/settlements/security_deposit.hsx +0 -166
  313. package/std/settlements/settlement_batch.hsx +0 -122
  314. package/std/settlements/swap.hsx +0 -1114
  315. package/std/settlements/threshold_pool.hsx +0 -221
  316. package/std/settlements/weighted_distribution.hsx +0 -141
package/src/lsp/server.ts DELETED
@@ -1,460 +0,0 @@
1
- import { existsSync, readFileSync, statSync } from "node:fs";
2
- import { dirname, isAbsolute, resolve } from "node:path";
3
- import { fileURLToPath } from "node:url";
4
- import { lineIndex, type LineIndex } from "../ast.ts";
5
- import { format } from "../format.ts";
6
- import type { HsxCompilerHost, ModuleSource } from "../modules.ts";
7
- import { resolveProgramModules } from "../modules.ts";
8
- import { parseProgram } from "../parse.ts";
9
- import { checkGeneralProgram } from "../typecheck.ts";
10
-
11
- export interface LspPosition {
12
- readonly character: number;
13
- readonly line: number;
14
- }
15
-
16
- export interface LspRange {
17
- readonly end: LspPosition;
18
- readonly start: LspPosition;
19
- }
20
-
21
- export interface LspDiagnostic {
22
- readonly code?: string;
23
- readonly message: string;
24
- readonly range: LspRange;
25
- readonly severity: 1 | 2;
26
- readonly source: "hsx";
27
- }
28
-
29
- export interface LspServerOptions {
30
- readonly host?: HsxCompilerHost;
31
- readonly onExit?: (code: number) => void;
32
- }
33
-
34
- export interface LspServer {
35
- readonly stop: () => void;
36
- }
37
-
38
- export function offsetToPosition(
39
- index: LineIndex,
40
- offset: number,
41
- ): LspPosition {
42
- const clamped = Math.max(0, Math.min(offset, index.length));
43
- let low = 0;
44
- let high = index.starts.length - 1;
45
- while (low < high) {
46
- const middle = Math.floor((low + high + 1) / 2);
47
- if ((index.starts[middle] as number) <= clamped) low = middle;
48
- else high = middle - 1;
49
- }
50
- const lineStart = index.starts[low] as number;
51
- return {
52
- character: clamped - lineStart,
53
- line: low,
54
- };
55
- }
56
-
57
- export function spanToRange(
58
- index: LineIndex,
59
- span: { readonly end: number; readonly start: number },
60
- ): LspRange {
61
- return {
62
- end: offsetToPosition(index, Math.max(span.start, span.end)),
63
- start: offsetToPosition(index, span.start),
64
- };
65
- }
66
-
67
- export function createHostForUri(
68
- uri: string,
69
- fallbackHost?: HsxCompilerHost,
70
- ): HsxCompilerHost {
71
- let docDir: string | undefined;
72
- try {
73
- if (uri.startsWith("file://")) {
74
- docDir = dirname(fileURLToPath(uri));
75
- }
76
- } catch {
77
- docDir = undefined;
78
- }
79
-
80
- return {
81
- resolveModule(specifier: string, from: string): ModuleSource | undefined {
82
- if (fallbackHost?.resolveModule) {
83
- const custom = fallbackHost.resolveModule(specifier, from);
84
- if (custom) return custom;
85
- }
86
- if (!docDir) return undefined;
87
- const baseDir = from
88
- ? isAbsolute(from)
89
- ? dirname(from)
90
- : resolve(docDir, dirname(from))
91
- : docDir;
92
- const candidates = [
93
- resolve(baseDir, specifier),
94
- resolve(baseDir, `${specifier}.hsx`),
95
- resolve(docDir, specifier),
96
- resolve(docDir, `${specifier}.hsx`),
97
- ];
98
- for (const candidate of candidates) {
99
- if (existsSync(candidate)) {
100
- try {
101
- const stat = statSync(candidate);
102
- if (stat.isFile()) {
103
- return {
104
- name: candidate,
105
- source: readFileSync(candidate, "utf8"),
106
- };
107
- }
108
- } catch {
109
- // Ignore filesystem errors and check subsequent candidates.
110
- }
111
- }
112
- }
113
- return undefined;
114
- },
115
- };
116
- }
117
-
118
- interface JsonRpcMessage {
119
- readonly id?: number | string;
120
- readonly jsonrpc: "2.0";
121
- readonly method?: string;
122
- readonly params?: any;
123
- }
124
-
125
- export function startLspServer(
126
- input: NodeJS.ReadableStream,
127
- output: NodeJS.WritableStream,
128
- options: LspServerOptions = {},
129
- ): LspServer {
130
- const documents = new Map<string, string>();
131
- let isInitialized = false;
132
- let isShutdown = false;
133
- let buffer = Buffer.alloc(0);
134
-
135
- const send = (message: unknown): void => {
136
- const json = JSON.stringify(message);
137
- const bytes = Buffer.from(json, "utf8");
138
- output.write(`Content-Length: ${bytes.length}\r\n\r\n${json}`);
139
- };
140
-
141
- const validateAndPublish = (uri: string, source: string): void => {
142
- const lineIdx = lineIndex(source);
143
- const diagnostics: LspDiagnostic[] = [];
144
-
145
- const parsed = parseProgram(source);
146
- for (const diag of parsed.diagnostics) {
147
- diagnostics.push({
148
- ...(diag.code ? { code: diag.code } : {}),
149
- message: diag.message,
150
- range: spanToRange(lineIdx, diag.span),
151
- severity: 1,
152
- source: "hsx",
153
- });
154
- }
155
-
156
- if (parsed.diagnostics.length === 0) {
157
- const host = createHostForUri(uri, options.host);
158
- const resolved = resolveProgramModules(parsed.program, host);
159
- if (!resolved.ok) {
160
- for (const issue of resolved.issues) {
161
- diagnostics.push({
162
- code: issue.code,
163
- message: issue.message,
164
- range: spanToRange(lineIdx, issue.span),
165
- severity: 1,
166
- source: "hsx",
167
- });
168
- }
169
- } else {
170
- const checked = checkGeneralProgram(resolved.program);
171
- for (const diag of checked.diagnostics) {
172
- if (!resolved.origins.has(diag.span)) {
173
- diagnostics.push({
174
- code: diag.code,
175
- message: diag.message,
176
- range: spanToRange(lineIdx, diag.span),
177
- severity: diag.severity === "warning" ? 2 : 1,
178
- source: "hsx",
179
- });
180
- }
181
- }
182
- }
183
- }
184
-
185
- send({
186
- jsonrpc: "2.0",
187
- method: "textDocument/publishDiagnostics",
188
- params: {
189
- diagnostics,
190
- uri,
191
- },
192
- });
193
- };
194
-
195
- const handleMessage = (msg: JsonRpcMessage): void => {
196
- const { id, method, params } = msg;
197
-
198
- // Requests (id is present)
199
- if (id !== undefined) {
200
- if (isShutdown) {
201
- send({
202
- error: {
203
- code: -32600,
204
- message: "Invalid request: server is shutting down",
205
- },
206
- id,
207
- jsonrpc: "2.0",
208
- });
209
- return;
210
- }
211
-
212
- if (!isInitialized) {
213
- if (method !== "initialize") {
214
- send({
215
- error: {
216
- code: -32002,
217
- message: "Server not initialized",
218
- },
219
- id,
220
- jsonrpc: "2.0",
221
- });
222
- return;
223
- }
224
-
225
- isInitialized = true;
226
- send({
227
- id,
228
- jsonrpc: "2.0",
229
- result: {
230
- capabilities: {
231
- documentFormattingProvider: true,
232
- textDocumentSync: 1,
233
- },
234
- serverInfo: {
235
- name: "hsx-lsp",
236
- version: "1.0.0",
237
- },
238
- },
239
- });
240
- return;
241
- }
242
-
243
- if (method === "initialize") {
244
- send({
245
- id,
246
- jsonrpc: "2.0",
247
- result: {
248
- capabilities: {
249
- documentFormattingProvider: true,
250
- textDocumentSync: 1,
251
- },
252
- serverInfo: {
253
- name: "hsx-lsp",
254
- version: "1.0.0",
255
- },
256
- },
257
- });
258
- return;
259
- }
260
-
261
- if (method === "shutdown") {
262
- isShutdown = true;
263
- send({
264
- id,
265
- jsonrpc: "2.0",
266
- result: null,
267
- });
268
- return;
269
- }
270
-
271
- if (method === "textDocument/formatting") {
272
- const uri = params?.textDocument?.uri;
273
- const source = uri ? documents.get(uri) : undefined;
274
- if (!source) {
275
- send({ id, jsonrpc: "2.0", result: null });
276
- return;
277
- }
278
- const formatted = format(source);
279
- if (!formatted.ok) {
280
- send({ id, jsonrpc: "2.0", result: null });
281
- return;
282
- }
283
- if (formatted.formatted === source) {
284
- send({ id, jsonrpc: "2.0", result: [] });
285
- return;
286
- }
287
- const lines = lineIndex(source);
288
- send({
289
- id,
290
- jsonrpc: "2.0",
291
- result: [
292
- {
293
- newText: formatted.formatted,
294
- range: {
295
- end: offsetToPosition(lines, source.length),
296
- start: { character: 0, line: 0 },
297
- },
298
- },
299
- ],
300
- });
301
- return;
302
- }
303
-
304
- send({
305
- error: {
306
- code: -32601,
307
- message: `Method not found: ${method ?? "unknown"}`,
308
- },
309
- id,
310
- jsonrpc: "2.0",
311
- });
312
- return;
313
- }
314
-
315
- // Notifications (id is undefined)
316
- if (method === "exit") {
317
- const code = isShutdown ? 0 : 1;
318
- if (options.onExit) {
319
- options.onExit(code);
320
- } else {
321
- process.exit(code);
322
- }
323
- return;
324
- }
325
-
326
- if (isShutdown || !isInitialized) {
327
- return;
328
- }
329
-
330
- if (method === "initialized") {
331
- return;
332
- }
333
-
334
- if (method === "textDocument/didOpen") {
335
- const doc = params?.textDocument;
336
- if (doc?.uri && typeof doc.text === "string") {
337
- documents.set(doc.uri, doc.text);
338
- validateAndPublish(doc.uri, doc.text);
339
- }
340
- return;
341
- }
342
-
343
- if (method === "textDocument/didChange") {
344
- const uri = params?.textDocument?.uri;
345
- const changes = params?.contentChanges;
346
- if (!uri || !Array.isArray(changes) || changes.length === 0) {
347
- // Empty contentChanges keeps the document and republishes nothing.
348
- return;
349
- }
350
- // Full sync only; an incremental entry would replace the document with a fragment.
351
- const hasIncremental = changes.some(
352
- (change: any) =>
353
- change && typeof change === "object" && "range" in change,
354
- );
355
- if (hasIncremental) {
356
- return;
357
- }
358
- const lastChange = changes[changes.length - 1];
359
- if (lastChange && typeof lastChange.text === "string") {
360
- documents.set(uri, lastChange.text);
361
- validateAndPublish(uri, lastChange.text);
362
- }
363
- return;
364
- }
365
-
366
- if (method === "textDocument/didClose") {
367
- const uri = params?.textDocument?.uri;
368
- if (uri) {
369
- documents.delete(uri);
370
- send({
371
- jsonrpc: "2.0",
372
- method: "textDocument/publishDiagnostics",
373
- params: {
374
- diagnostics: [],
375
- uri,
376
- },
377
- });
378
- }
379
- return;
380
- }
381
- };
382
-
383
- const processBuffer = (): void => {
384
- while (true) {
385
- const headerEnd = buffer.indexOf("\r\n\r\n");
386
- if (headerEnd === -1) break;
387
- const headerText = buffer.subarray(0, headerEnd).toString("ascii");
388
- const match = /content-length:\s*(\d+)/i.exec(headerText);
389
- if (!match) {
390
- buffer = buffer.subarray(headerEnd + 4);
391
- continue;
392
- }
393
- const contentLength = parseInt(match[1] as string, 10);
394
- if (Number.isNaN(contentLength) || contentLength < 0) {
395
- buffer = buffer.subarray(headerEnd + 4);
396
- continue;
397
- }
398
- const totalLength = headerEnd + 4 + contentLength;
399
- if (buffer.length < totalLength) {
400
- break;
401
- }
402
- const bodyBytes = buffer.subarray(headerEnd + 4, totalLength);
403
- buffer = buffer.subarray(totalLength);
404
- const bodyStr = bodyBytes.toString("utf8");
405
- try {
406
- const msg = JSON.parse(bodyStr) as JsonRpcMessage;
407
- handleMessage(msg);
408
- } catch {
409
- // Ignore unparseable JSON payload.
410
- }
411
- }
412
- };
413
-
414
- const flushPending = (): void => {
415
- const headerEnd = buffer.indexOf("\r\n\r\n");
416
- if (headerEnd !== -1) {
417
- const bodyStr = buffer
418
- .subarray(headerEnd + 4)
419
- .toString("utf8")
420
- .trim();
421
- if (bodyStr.length > 0) {
422
- try {
423
- const msg = JSON.parse(bodyStr) as JsonRpcMessage;
424
- handleMessage(msg);
425
- } catch {
426
- // Ignore unparseable body.
427
- }
428
- }
429
- }
430
- };
431
-
432
- const onData = (chunk: Buffer | string): void => {
433
- const incoming =
434
- typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk;
435
- buffer = Buffer.concat([buffer, incoming]);
436
- processBuffer();
437
- };
438
-
439
- const onEnd = (): void => {
440
- processBuffer();
441
- if (buffer.length > 0) {
442
- flushPending();
443
- }
444
- if (options.onExit) {
445
- options.onExit(0);
446
- } else {
447
- process.exit(0);
448
- }
449
- };
450
-
451
- input.on("data", onData);
452
- input.on("end", onEnd);
453
-
454
- return {
455
- stop(): void {
456
- input.removeListener("data", onData);
457
- input.removeListener("end", onEnd);
458
- },
459
- };
460
- }