@niscorp/moss 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.
Files changed (96) hide show
  1. package/DESIGN.md +592 -0
  2. package/DOCS.md +943 -0
  3. package/LICENSE +202 -0
  4. package/README.md +155 -0
  5. package/dist/chunk-2AHJ6VDR.js +3314 -0
  6. package/dist/chunk-2AHJ6VDR.js.map +1 -0
  7. package/dist/chunk-EMRDIZLY.js +99 -0
  8. package/dist/chunk-EMRDIZLY.js.map +1 -0
  9. package/dist/chunk-HF6IGQ74.js +3342 -0
  10. package/dist/chunk-HF6IGQ74.js.map +1 -0
  11. package/dist/chunk-J72N3EMJ.js +238 -0
  12. package/dist/chunk-J72N3EMJ.js.map +1 -0
  13. package/dist/chunk-SK4PDGEE.js +55 -0
  14. package/dist/chunk-SK4PDGEE.js.map +1 -0
  15. package/dist/chunk-ZOEUEMDX.js +251 -0
  16. package/dist/chunk-ZOEUEMDX.js.map +1 -0
  17. package/dist/client/node.cjs +42 -0
  18. package/dist/client/node.cjs.map +1 -0
  19. package/dist/client/node.d.cts +9 -0
  20. package/dist/client/node.d.ts +9 -0
  21. package/dist/client/node.js +40 -0
  22. package/dist/client/node.js.map +1 -0
  23. package/dist/client.cjs +275 -0
  24. package/dist/client.cjs.map +1 -0
  25. package/dist/client.d.cts +52 -0
  26. package/dist/client.d.ts +52 -0
  27. package/dist/client.js +4 -0
  28. package/dist/client.js.map +1 -0
  29. package/dist/document-BEn2zXah.d.cts +993 -0
  30. package/dist/document-BEn2zXah.d.ts +993 -0
  31. package/dist/index.cjs +3716 -0
  32. package/dist/index.cjs.map +1 -0
  33. package/dist/index.d.cts +104 -0
  34. package/dist/index.d.ts +104 -0
  35. package/dist/index.js +96 -0
  36. package/dist/index.js.map +1 -0
  37. package/dist/node.cjs +3309 -0
  38. package/dist/node.cjs.map +1 -0
  39. package/dist/node.d.cts +28 -0
  40. package/dist/node.d.ts +28 -0
  41. package/dist/node.js +64 -0
  42. package/dist/node.js.map +1 -0
  43. package/dist/slots-Do9ScG7v.d.cts +37 -0
  44. package/dist/slots-Do9ScG7v.d.ts +37 -0
  45. package/dist/terminal/dom/index.cjs +34 -0
  46. package/dist/terminal/dom/index.cjs.map +1 -0
  47. package/dist/terminal/dom/index.d.cts +11 -0
  48. package/dist/terminal/dom/index.d.ts +11 -0
  49. package/dist/terminal/dom/index.js +32 -0
  50. package/dist/terminal/dom/index.js.map +1 -0
  51. package/dist/terminal/dom/server.cjs +16 -0
  52. package/dist/terminal/dom/server.cjs.map +1 -0
  53. package/dist/terminal/dom/server.d.cts +14 -0
  54. package/dist/terminal/dom/server.d.ts +14 -0
  55. package/dist/terminal/dom/server.js +14 -0
  56. package/dist/terminal/dom/server.js.map +1 -0
  57. package/dist/terminal/index.cjs +346 -0
  58. package/dist/terminal/index.cjs.map +1 -0
  59. package/dist/terminal/index.d.cts +32 -0
  60. package/dist/terminal/index.d.ts +32 -0
  61. package/dist/terminal/index.js +100 -0
  62. package/dist/terminal/index.js.map +1 -0
  63. package/dist/terminal/ink/index.d.ts +33 -0
  64. package/dist/terminal/ink/index.js +189 -0
  65. package/dist/terminal/ink/index.js.map +1 -0
  66. package/dist/terminal/react/index.cjs +87 -0
  67. package/dist/terminal/react/index.cjs.map +1 -0
  68. package/dist/terminal/react/index.d.cts +15 -0
  69. package/dist/terminal/react/index.d.ts +15 -0
  70. package/dist/terminal/react/index.js +35 -0
  71. package/dist/terminal/react/index.js.map +1 -0
  72. package/dist/terminal/react/server.cjs +79 -0
  73. package/dist/terminal/react/server.cjs.map +1 -0
  74. package/dist/terminal/react/server.d.cts +16 -0
  75. package/dist/terminal/react/server.d.ts +16 -0
  76. package/dist/terminal/react/server.js +28 -0
  77. package/dist/terminal/react/server.js.map +1 -0
  78. package/dist/terminal/tty/index.cjs +201 -0
  79. package/dist/terminal/tty/index.cjs.map +1 -0
  80. package/dist/terminal/tty/index.d.cts +18 -0
  81. package/dist/terminal/tty/index.d.ts +18 -0
  82. package/dist/terminal/tty/index.js +199 -0
  83. package/dist/terminal/tty/index.js.map +1 -0
  84. package/dist/terminal/vue/index.cjs +104 -0
  85. package/dist/terminal/vue/index.cjs.map +1 -0
  86. package/dist/terminal/vue/index.d.cts +23 -0
  87. package/dist/terminal/vue/index.d.ts +23 -0
  88. package/dist/terminal/vue/index.js +3 -0
  89. package/dist/terminal/vue/index.js.map +1 -0
  90. package/dist/terminal/vue/server.cjs +88 -0
  91. package/dist/terminal/vue/server.cjs.map +1 -0
  92. package/dist/terminal/vue/server.d.cts +18 -0
  93. package/dist/terminal/vue/server.d.ts +18 -0
  94. package/dist/terminal/vue/server.js +21 -0
  95. package/dist/terminal/vue/server.js.map +1 -0
  96. package/package.json +213 -0
@@ -0,0 +1,100 @@
1
+ import { createWire } from '../chunk-J72N3EMJ.js';
2
+ import '../chunk-ZOEUEMDX.js';
3
+
4
+ // src/terminal/hotkey.ts
5
+ var onHotkey = (spec, handler) => {
6
+ const parts = spec.toLowerCase().split("+");
7
+ const key = parts[parts.length - 1] ?? "";
8
+ const mods = new Set(parts.slice(0, -1));
9
+ const listener = (event) => {
10
+ if (event.key.toLowerCase() === key && event.ctrlKey === mods.has("ctrl") && event.shiftKey === mods.has("shift") && event.altKey === mods.has("alt") && event.metaKey === (mods.has("meta") || mods.has("cmd"))) {
11
+ event.preventDefault();
12
+ handler();
13
+ }
14
+ };
15
+ window.addEventListener("keydown", listener);
16
+ return () => window.removeEventListener("keydown", listener);
17
+ };
18
+
19
+ // src/terminal/history.ts
20
+ var SENTINEL = { nisc: "terminal-back" };
21
+ var trapBack = (handler) => {
22
+ if (typeof window === "undefined") return () => void 0;
23
+ const history = window.history;
24
+ if (history === void 0 || typeof history.pushState !== "function") return () => void 0;
25
+ const spare = () => {
26
+ try {
27
+ history.pushState(SENTINEL, "");
28
+ } catch {
29
+ }
30
+ };
31
+ const onPopState = () => {
32
+ spare();
33
+ handler();
34
+ };
35
+ spare();
36
+ window.addEventListener("popstate", onPopState);
37
+ return () => {
38
+ window.removeEventListener("popstate", onPopState);
39
+ };
40
+ };
41
+
42
+ // src/terminal/index.ts
43
+ var createTerminal = (config) => {
44
+ const { target, wire } = config;
45
+ const api = {
46
+ frame: () => wire.snapshot().frame,
47
+ canvasTree: (id) => wire.snapshot().trees.get(id) ?? [],
48
+ dispatch: (id, event) => wire.dispatch(id, event),
49
+ publish: (channel, payload) => wire.publish(channel, payload)
50
+ };
51
+ const mount = target(api);
52
+ const unsubscribe = wire.subscribe(mount.update);
53
+ return {
54
+ destroy: () => {
55
+ unsubscribe();
56
+ mount.destroy();
57
+ }
58
+ };
59
+ };
60
+ var mountTerminal = (config) => {
61
+ const keys = Object.keys(config.targets);
62
+ if (keys.length === 0) throw new Error("mountTerminal: at least one target is required");
63
+ const ownsWire = config.wire === void 0;
64
+ const wire = config.wire ?? createWire(config.url !== void 0 ? { url: config.url } : {});
65
+ const targetAt = (i) => {
66
+ const key = keys[i];
67
+ const target = key === void 0 ? void 0 : config.targets[key];
68
+ if (target === void 0) throw new Error(`mountTerminal: no target at index ${i}`);
69
+ return target;
70
+ };
71
+ const start = config.initial === void 0 ? 0 : keys.indexOf(config.initial);
72
+ let index = start < 0 ? 0 : start;
73
+ let active = createTerminal({ target: targetAt(index), wire });
74
+ const swap = () => {
75
+ active.destroy();
76
+ index = (index + 1) % keys.length;
77
+ active = createTerminal({ target: targetAt(index), wire });
78
+ };
79
+ const reset = () => wire.reset();
80
+ const back = () => wire.back();
81
+ const disposeSwapKey = config.swapKey === void 0 ? void 0 : onHotkey(config.swapKey, swap);
82
+ const disposeResetKey = config.resetKey === void 0 ? void 0 : onHotkey(config.resetKey, reset);
83
+ const disposeBackTrap = config.trapBack === false ? void 0 : trapBack(back);
84
+ return {
85
+ swap,
86
+ reset,
87
+ back,
88
+ destroy: () => {
89
+ disposeSwapKey?.();
90
+ disposeResetKey?.();
91
+ disposeBackTrap?.();
92
+ active.destroy();
93
+ if (ownsWire) wire.dispose();
94
+ }
95
+ };
96
+ };
97
+
98
+ export { createTerminal, mountTerminal };
99
+ //# sourceMappingURL=index.js.map
100
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/terminal/hotkey.ts","../../src/terminal/history.ts","../../src/terminal/index.ts"],"names":[],"mappings":";;;;AAeO,IAAM,QAAA,GAAW,CAAC,IAAA,EAAc,OAAA,KAAwC;AAC7E,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,WAAA,EAAY,CAAE,MAAM,GAAG,CAAA;AAC1C,EAAA,MAAM,GAAA,GAAM,KAAA,CAAM,KAAA,CAAM,MAAA,GAAS,CAAC,CAAA,IAAK,EAAA;AACvC,EAAA,MAAM,OAAO,IAAI,GAAA,CAAI,MAAM,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA;AACvC,EAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAA+B;AAC/C,IAAA,IACE,KAAA,CAAM,GAAA,CAAI,WAAA,EAAY,KAAM,OAC5B,KAAA,CAAM,OAAA,KAAY,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,IACjC,KAAA,CAAM,QAAA,KAAa,KAAK,GAAA,CAAI,OAAO,CAAA,IACnC,KAAA,CAAM,MAAA,KAAW,IAAA,CAAK,GAAA,CAAI,KAAK,KAC/B,KAAA,CAAM,OAAA,MAAa,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,IAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,CAAA,EACrD;AACA,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,OAAA,EAAQ;AAAA,IACV;AAAA,EACF,CAAA;AACA,EAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,QAAQ,CAAA;AAC3C,EAAA,OAAO,MAAM,MAAA,CAAO,mBAAA,CAAoB,SAAA,EAAW,QAAQ,CAAA;AAC7D,CAAA;;;ACNA,IAAM,QAAA,GAAW,EAAE,IAAA,EAAM,eAAA,EAAgB;AAMlC,IAAM,QAAA,GAAW,CAAC,OAAA,KAA0C;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,MAAM,MAAA;AAChD,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA;AACvB,EAAA,IAAI,YAAY,MAAA,IAAa,OAAO,QAAQ,SAAA,KAAc,UAAA,SAAmB,MAAM,MAAA;AAKnF,EAAA,MAAM,QAAQ,MAAY;AACxB,IAAA,IAAI;AACF,MAAA,OAAA,CAAQ,SAAA,CAAU,UAAU,EAAE,CAAA;AAAA,IAChC,CAAA,CAAA,MAAQ;AAAA,IAGR;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,aAAa,MAAY;AAI7B,IAAA,KAAA,EAAM;AACN,IAAA,OAAA,EAAQ;AAAA,EACV,CAAA;AAEA,EAAA,KAAA,EAAM;AACN,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,UAAU,CAAA;AAC9C,EAAA,OAAO,MAAM;AACX,IAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,UAAU,CAAA;AAAA,EAGnD,CAAA;AACF,CAAA;;;AC5BO,IAAM,cAAA,GAAiB,CAAC,MAAA,KAAoE;AACjG,EAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAK,GAAI,MAAA;AACzB,EAAA,MAAM,GAAA,GAAmB;AAAA,IACvB,KAAA,EAAO,MAAM,IAAA,CAAK,QAAA,EAAS,CAAE,KAAA;AAAA,IAC7B,UAAA,EAAY,CAAC,EAAA,KAAO,IAAA,CAAK,QAAA,GAAW,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA,IAAK,EAAC;AAAA,IACtD,UAAU,CAAC,EAAA,EAAI,UAAU,IAAA,CAAK,QAAA,CAAS,IAAI,KAAK,CAAA;AAAA,IAChD,SAAS,CAAC,OAAA,EAAS,YAAY,IAAA,CAAK,OAAA,CAAQ,SAAS,OAAO;AAAA,GAC9D;AACA,EAAA,MAAM,KAAA,GAAQ,OAAO,GAAG,CAAA;AACxB,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,MAAM,CAAA;AAC/C,EAAA,OAAO;AAAA,IACL,SAAS,MAAM;AACb,MAAA,WAAA,EAAY;AACZ,MAAA,KAAA,CAAM,OAAA,EAAQ;AAAA,IAChB;AAAA,GACF;AACF;AAwCO,IAAM,aAAA,GAAgB,CAAC,MAAA,KAAgH;AAC5I,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA;AACvC,EAAA,IAAI,KAAK,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAEvF,EAAA,MAAM,QAAA,GAAW,OAAO,IAAA,KAAS,MAAA;AACjC,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,IAAQ,UAAA,CAAW,MAAA,CAAO,GAAA,KAAQ,MAAA,GAAY,EAAE,GAAA,EAAK,MAAA,CAAO,GAAA,EAAI,GAAI,EAAE,CAAA;AAE1F,EAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAAsB;AACtC,IAAA,MAAM,GAAA,GAAM,KAAK,CAAC,CAAA;AAClB,IAAA,MAAM,SAAS,GAAA,KAAQ,MAAA,GAAY,MAAA,GAAY,MAAA,CAAO,QAAQ,GAAG,CAAA;AACjE,IAAA,IAAI,WAAW,MAAA,EAAW,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,CAAC,CAAA,CAAE,CAAA;AAClF,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,KAAA,GAAQ,OAAO,OAAA,KAAY,MAAA,GAAY,IAAI,IAAA,CAAK,OAAA,CAAQ,OAAO,OAAO,CAAA;AAC5E,EAAA,IAAI,KAAA,GAAQ,KAAA,GAAQ,CAAA,GAAI,CAAA,GAAI,KAAA;AAC5B,EAAA,IAAI,MAAA,GAAS,eAAe,EAAE,MAAA,EAAQ,SAAS,KAAK,CAAA,EAAG,MAAM,CAAA;AAE7D,EAAA,MAAM,OAAO,MAAY;AACvB,IAAA,MAAA,CAAO,OAAA,EAAQ;AACf,IAAA,KAAA,GAAA,CAAS,KAAA,GAAQ,KAAK,IAAA,CAAK,MAAA;AAC3B,IAAA,MAAA,GAAS,eAAe,EAAE,MAAA,EAAQ,SAAS,KAAK,CAAA,EAAG,MAAM,CAAA;AAAA,EAC3D,CAAA;AAEA,EAAA,MAAM,KAAA,GAAQ,MAAY,IAAA,CAAK,KAAA,EAAM;AACrC,EAAA,MAAM,IAAA,GAAO,MAAY,IAAA,CAAK,IAAA,EAAK;AAEnC,EAAA,MAAM,cAAA,GAAiB,OAAO,OAAA,KAAY,MAAA,GAAY,SAAY,QAAA,CAAS,MAAA,CAAO,SAAS,IAAI,CAAA;AAC/F,EAAA,MAAM,eAAA,GAAkB,OAAO,QAAA,KAAa,MAAA,GAAY,SAAY,QAAA,CAAS,MAAA,CAAO,UAAU,KAAK,CAAA;AACnG,EAAA,MAAM,kBAAkB,MAAA,CAAO,QAAA,KAAa,KAAA,GAAQ,MAAA,GAAY,SAAS,IAAI,CAAA;AAI7E,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,KAAA;AAAA,IACA,IAAA;AAAA,IACA,SAAS,MAAM;AACb,MAAA,cAAA,IAAiB;AACjB,MAAA,eAAA,IAAkB;AAClB,MAAA,eAAA,IAAkB;AAClB,MAAA,MAAA,CAAO,OAAA,EAAQ;AACf,MAAA,IAAI,QAAA,OAAe,OAAA,EAAQ;AAAA,IAC7B;AAAA,GACF;AACF","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// The live-swap hotkey — isolated here because it is the one imperative,\n// gimmicky corner of the terminal (a render target is not app state, so it\n// can't be a nova action; it's client chrome). Keyed on `event.key`, the\n// CHARACTER the key produces, so a combo matches the key the user actually\n// presses on any layout — `event.code` would bind a physical QWERTY position\n// (the key labelled Y sits elsewhere on QWERTZ/AZERTY). Use letter keys, not\n// punctuation, so Shift never remaps the character.\n// ═══════════════════════════════════════════════════════════════\n\nexport type HotkeyDisposer = () => void;\n\n// Attach `handler` to a keydown matching `spec` (e.g. \"ctrl+shift+y\"); returns\n// a disposer. Matches modifiers exactly, so \"ctrl+shift+y\" never fires on\n// \"ctrl+shift+alt+y\".\nexport const onHotkey = (spec: string, handler: () => void): HotkeyDisposer => {\n const parts = spec.toLowerCase().split('+');\n const key = parts[parts.length - 1] ?? '';\n const mods = new Set(parts.slice(0, -1));\n const listener = (event: KeyboardEvent): void => {\n if (\n event.key.toLowerCase() === key &&\n event.ctrlKey === mods.has('ctrl') &&\n event.shiftKey === mods.has('shift') &&\n event.altKey === mods.has('alt') &&\n event.metaKey === (mods.has('meta') || mods.has('cmd'))\n ) {\n event.preventDefault();\n handler();\n }\n };\n window.addEventListener('keydown', listener);\n return () => window.removeEventListener('keydown', listener);\n};\n","// ═══════════════════════════════════════════════════════════════\n// The browser's back button, caught.\n//\n// ⟲ IT USED TO UNLOAD THE APPLICATION. A moss terminal never touched the URL,\n// so a tab held exactly one history entry and back meant \"leave the page\" —\n// the socket dropped, the shell went unattended, and somebody who wanted to\n// close a screen got a blank tab instead. Nothing was lost (the shell is\n// durable, keyed by principal, and a reload reattaches to it) but nobody\n// pressing back is thinking about that.\n//\n// What it does instead: keep ONE spare history entry ahead of the page and\n// spend it on every press. Back consumes the spare, this puts another one\n// straight back, and the gesture is handed to the terminal — which sends it up\n// the wire, where the shell that owns the navigation decides what back means.\n//\n// The URL never changes. That is the honest position while location lives on\n// the SERVER: the shell is keyed by principal, not by tab, so an address bar\n// would be a per-tab claim on state two tabs share. When deep links arrive they\n// arrive as a projection of the shell's own location, and this file is where\n// the gesture will already be.\n// ═══════════════════════════════════════════════════════════════\n\nexport type BackTrapDisposer = () => void;\n\n// Marks the entry as ours, so a host that keeps its own history state can tell\n// this one apart. Nothing reads it yet; a debugger looking at `history.state`\n// deserves to find a name rather than an empty object.\nconst SENTINEL = { nisc: 'terminal-back' } as const;\n\n// Catch the host's back gesture and call `handler` instead of letting the page\n// unload. A no-op (and a disposer that does nothing) wherever there is no\n// history to trap — a TTY, a TUI, a plain process — so the conductor can ask\n// for it unconditionally.\nexport const trapBack = (handler: () => void): BackTrapDisposer => {\n if (typeof window === 'undefined') return () => undefined;\n const history = window.history as History | undefined;\n if (history === undefined || typeof history.pushState !== 'function') return () => undefined;\n\n // The spare. `pushState` with no url keeps the current address, so this adds\n // an entry without changing what the address bar says or asking the server\n // for anything.\n const spare = (): void => {\n try {\n history.pushState(SENTINEL, '');\n } catch {\n // A sandboxed document can refuse this. Back then behaves as it always\n // did rather than throwing on the way out of a keypress.\n }\n };\n\n const onPopState = (): void => {\n // One entry was just spent — replace it, then act. In that order: the\n // handler sends a message up the wire and the answer arrives on another\n // tick, and the history has to be whole before the next press, not after.\n spare();\n handler();\n };\n\n spare();\n window.addEventListener('popstate', onPopState);\n return () => {\n window.removeEventListener('popstate', onPopState);\n // The spare entry stays. It cannot be removed without navigating, and one\n // dead entry is a far smaller surprise than a navigation nobody asked for.\n };\n};\n","import type { RenderApi } from '@niscorp/nova';\nimport { createWire } from '../client';\nimport type { Wire } from '../client';\nimport { onHotkey } from './hotkey';\nimport { trapBack } from './history';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/moss/terminal — the terminal, owned by the protocol that defines\n// it. A terminal is the wire (../client) plus a RENDER TARGET (react, dom,\n// console, …) painting the wire's snapshot and sending events back. This\n// module is framework-blind: the conductor drives one target against the\n// wire; the switcher cycles targets on a hotkey, sharing one wire so the\n// session survives the swap. Targets live in the subpaths (./react, ./dom);\n// the framework-shaped code stays there, never here.\n// ═══════════════════════════════════════════════════════════════\n\n// What a target renders against — nova core's `RenderApi`: the wire's snapshot\n// as pull functions (frame + per-canvas trees) plus the event sinks (dispatch\n// tagged by canvas, publish). Aliased, not redeclared — the dom adapter, the\n// react adapter, and this conductor share ONE contract, so a target written\n// for nova's dom view drops straight onto the wire. A target never touches the\n// wire directly.\nexport type TerminalApi = RenderApi;\n\n// A mounted target: re-render on demand, tear down on swap.\nexport type TerminalMount = { update: () => void; destroy: () => void };\n\n// A render target: paint the api onto the target's own surface, return the\n// mount handle. The surface — a DOM root, a stdio pair — is construction\n// config on the concrete target (`reactTarget({ root, … })`, `domTarget({\n// root })`), never part of this contract: the conductor stays surface-blind\n// and runs anywhere the wire does. A target renders once on mount; the\n// conductor calls `update` on every wire change.\nexport type Target = (api: TerminalApi) => TerminalMount;\n\n// The conductor: one target, one wire. Subscribes the target's `update` to\n// the wire and routes events back. Nothing framework-shaped.\nexport const createTerminal = (config: { target: Target; wire: Wire }): { destroy: () => void } => {\n const { target, wire } = config;\n const api: TerminalApi = {\n frame: () => wire.snapshot().frame,\n canvasTree: (id) => wire.snapshot().trees.get(id) ?? [],\n dispatch: (id, event) => wire.dispatch(id, event),\n publish: (channel, payload) => wire.publish(channel, payload),\n };\n const mount = target(api);\n const unsubscribe = wire.subscribe(mount.update);\n return {\n destroy: () => {\n unsubscribe();\n mount.destroy();\n },\n };\n};\n\nexport type MountTerminalConfig = {\n // render targets by name; the hotkey cycles them in insertion order\n targets: Record<string, Target>;\n // e.g. \"ctrl+shift+t\" — the live render-target swap. Omit for no swapping.\n swapKey?: string;\n // e.g. \"ctrl+shift+r\" — ask the server for a fresh shell. Omit for no key.\n //\n // The one control that must work when nothing else does. It sits on a\n // keystroke for the same reason the swap does — it acts on the terminal's\n // relationship to the server, not on anything the app models — but the\n // reason it exists at all is stronger: a shell lives on the SERVER, keyed by\n // principal, so a broken one survives every gesture a client can make alone.\n // Reloading reattaches to it. Clearing the token and signing back in\n // reattaches to it. Without a key that says \"throw it away\", somebody\n // watching a dead screen has no move left.\n resetKey?: string;\n // Catch the host's BACK gesture — the browser's back button — and send it up\n // the wire instead of letting it unload the page. Default: on, wherever a\n // history exists to catch (see ./history); nothing at all in a TTY or a TUI.\n //\n // Terminal chrome for the same reason the swap and reset keys are: back is\n // the terminal's relationship to the surface it is painted on, and the app\n // authors nothing to receive it. What back MEANS is decided a layer up, by\n // the shell that owns the navigation.\n trapBack?: boolean;\n // which target to mount first (default: the first key)\n initial?: string;\n // inject an existing wire (shared across swaps), or let the terminal make\n // one — `url` seeds a self-made wire (default: /socket on the host).\n wire?: Wire;\n url?: string;\n};\n\n// The switcher: mount a terminal that can hot-swap its render target on a\n// keystroke, over ONE wire (created here unless injected) so the socket,\n// session, and current trees survive the swap. The hotkey is the one legit\n// piece of imperative client chrome — a render target is not app state, so\n// it is not a nova action; it lives here, in the terminal.\nexport const mountTerminal = (config: MountTerminalConfig): { swap: () => void; reset: () => void; back: () => void; destroy: () => void } => {\n const keys = Object.keys(config.targets);\n if (keys.length === 0) throw new Error('mountTerminal: at least one target is required');\n\n const ownsWire = config.wire === undefined;\n const wire = config.wire ?? createWire(config.url !== undefined ? { url: config.url } : {});\n\n const targetAt = (i: number): Target => {\n const key = keys[i];\n const target = key === undefined ? undefined : config.targets[key];\n if (target === undefined) throw new Error(`mountTerminal: no target at index ${i}`);\n return target;\n };\n\n const start = config.initial === undefined ? 0 : keys.indexOf(config.initial);\n let index = start < 0 ? 0 : start;\n let active = createTerminal({ target: targetAt(index), wire });\n\n const swap = (): void => {\n active.destroy();\n index = (index + 1) % keys.length;\n active = createTerminal({ target: targetAt(index), wire });\n };\n\n const reset = (): void => wire.reset();\n const back = (): void => wire.back();\n\n const disposeSwapKey = config.swapKey === undefined ? undefined : onHotkey(config.swapKey, swap);\n const disposeResetKey = config.resetKey === undefined ? undefined : onHotkey(config.resetKey, reset);\n const disposeBackTrap = config.trapBack === false ? undefined : trapBack(back);\n\n // All three are returned so a host can bind its own control (a button, a\n // console call) — the keys and the trap are a convenience, not the only way in.\n return {\n swap,\n reset,\n back,\n destroy: () => {\n disposeSwapKey?.();\n disposeResetKey?.();\n disposeBackTrap?.();\n active.destroy();\n if (ownsWire) wire.dispose();\n },\n };\n};\n"]}
@@ -0,0 +1,33 @@
1
+ import { NovaComponent } from '@niscorp/nova/adapters/react';
2
+ import { RenderApi, ComponentRegistry } from '@niscorp/nova';
3
+ import { FC, ReactNode } from 'react';
4
+
5
+ type WireStatus = 'connecting' | 'open' | 'closed' | 'incompatible' | 'static';
6
+
7
+ type TerminalApi = RenderApi;
8
+ type TerminalMount = {
9
+ update: () => void;
10
+ destroy: () => void;
11
+ };
12
+ type Target = (api: TerminalApi) => TerminalMount;
13
+
14
+ type TerminalSlotWrapperProps = {
15
+ canvasId?: string;
16
+ instanceId?: string;
17
+ definitionId?: string;
18
+ children?: ReactNode;
19
+ };
20
+ type TerminalSlotWrapper = FC<TerminalSlotWrapperProps>;
21
+
22
+ type InkTargetConfig = {
23
+ registry?: ComponentRegistry<NovaComponent>;
24
+ slotWrapper?: TerminalSlotWrapper;
25
+ stdin?: NodeJS.ReadStream;
26
+ stdout?: NodeJS.WriteStream;
27
+ status?: () => WireStatus;
28
+ onQuit?: () => void;
29
+ patchConsole?: boolean;
30
+ };
31
+ declare const inkTarget: (config?: InkTargetConfig) => Target;
32
+
33
+ export { type InkTargetConfig, inkTarget };
@@ -0,0 +1,189 @@
1
+ import { createContext, createElement, useRef, useContext, Fragment } from 'react';
2
+ import { render, useFocusManager, useInput, Text } from 'ink';
3
+ import { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';
4
+ import { defaultRegistry, FrameControlsContext, ErrorMarker, TextWrap, fallback as fallback$1, markerFocusId, CanvasMarkersContext } from '@niscorp/nova/adapters/ink';
5
+ import { createTtyView } from '@niscorp/nova/adapters/tty';
6
+ import { defaultRegistry as defaultRegistry$1, fallback } from '@niscorp/nova/adapters/tty/components';
7
+
8
+ // src/terminal/ink/index.ts
9
+ var TerminalApiContext = createContext(void 0);
10
+ var registerWireSlots = (registry, options = {}) => {
11
+ const { slotWrapper, fallback, textWrapper, errorMarker, canvasProvider, instanceProvider } = options;
12
+ const CanvasSlot = ({ canvasId }) => {
13
+ const api = useContext(TerminalApiContext);
14
+ if (api === void 0 || canvasId === void 0 || canvasId === "") return null;
15
+ const tree = api.canvasTree(canvasId);
16
+ if (tree.length === 0) return null;
17
+ const body = createElement(RenderTree, { nodes: tree });
18
+ return createElement(
19
+ NovaRenderProvider,
20
+ {
21
+ registry,
22
+ dispatch: (event) => api.dispatch(canvasId, event),
23
+ publish: (channel, payload) => api.publish(channel, payload),
24
+ fallback,
25
+ textWrapper,
26
+ errorMarker
27
+ },
28
+ canvasProvider === void 0 ? body : createElement(canvasProvider, { canvasId }, body)
29
+ );
30
+ };
31
+ registry.register("CanvasSlot", CanvasSlot, { description: "A canvas, live from the server." });
32
+ const ActionSlot = ({
33
+ instanceId,
34
+ canvasId,
35
+ definitionId,
36
+ children
37
+ }) => {
38
+ const api = useContext(TerminalApiContext);
39
+ const wrapped = slotWrapper === void 0 ? createElement(Fragment, { key: instanceId }, children) : createElement(slotWrapper, { key: instanceId, instanceId, canvasId, definitionId }, children);
40
+ if (api === void 0 || instanceId === void 0 || canvasId === void 0) return wrapped;
41
+ return createElement(
42
+ NovaRenderProvider,
43
+ {
44
+ registry,
45
+ dispatch: (event) => api.dispatch(canvasId, event.origin === void 0 ? { ...event, origin: instanceId } : event),
46
+ publish: (channel, payload) => api.publish(channel, payload),
47
+ fallback,
48
+ textWrapper,
49
+ errorMarker
50
+ },
51
+ instanceProvider === void 0 ? wrapped : createElement(instanceProvider, { canvasId, instanceId }, wrapped)
52
+ );
53
+ };
54
+ registry.register("ActionSlot", ActionSlot, { description: "An action instance boundary from the server; the app slotWrapper wraps it." });
55
+ };
56
+
57
+ // src/terminal/ink/index.ts
58
+ var DIGIT_COMMIT_MS = 600;
59
+ var inkTarget = (config = {}) => (api) => {
60
+ const registry = config.registry ?? defaultRegistry();
61
+ const indexView = createTtyView(defaultRegistry$1(), api, { fallback: fallback });
62
+ const marks = { list: [], byKey: /* @__PURE__ */ new Map() };
63
+ const reindex = () => {
64
+ marks.list = indexView.render().interactives;
65
+ marks.byKey.clear();
66
+ const seen = /* @__PURE__ */ new Map();
67
+ for (const item of marks.list) {
68
+ const base = `${item.canvas}:${item.origin ?? ""}:${item.ref}`;
69
+ const occurrence = seen.get(base) ?? 0;
70
+ seen.set(base, occurrence + 1);
71
+ marks.byKey.set(`${base}#${occurrence}`, item);
72
+ if ((item.kind === "click" || item.kind === "row") && item.value !== void 0) {
73
+ marks.byKey.set(`${base}@${JSON.stringify(item.value)}`, item);
74
+ }
75
+ }
76
+ };
77
+ const resolverFor = (canvasId, instanceId) => (ref, identity = {}) => {
78
+ const base = `${canvasId}:${instanceId}:${ref}`;
79
+ if (identity.value !== void 0) {
80
+ const byValue = marks.byKey.get(`${base}@${JSON.stringify(identity.value)}`);
81
+ if (byValue !== void 0) return byValue.index;
82
+ }
83
+ return marks.byKey.get(`${base}#${identity.occurrence ?? 0}`)?.index;
84
+ };
85
+ const CanvasMarkers = ({ canvasId, children }) => createElement(CanvasMarkersContext.Provider, { value: resolverFor(canvasId, "") }, children);
86
+ const InstanceMarkers = ({ canvasId, instanceId, children }) => createElement(CanvasMarkersContext.Provider, { value: resolverFor(canvasId, instanceId) }, children);
87
+ registerWireSlots(registry, {
88
+ slotWrapper: config.slotWrapper,
89
+ fallback: fallback$1,
90
+ textWrapper: TextWrap,
91
+ errorMarker: ErrorMarker,
92
+ canvasProvider: CanvasMarkers,
93
+ instanceProvider: InstanceMarkers
94
+ });
95
+ const typingRef = { current: false };
96
+ const frameControls = { setTyping: (typing) => void (typingRef.current = typing) };
97
+ const Nav = () => {
98
+ const { focus, focusNext, focusPrevious } = useFocusManager();
99
+ const buffer = useRef("");
100
+ const timer = useRef(void 0);
101
+ const clearBuffer = () => {
102
+ buffer.current = "";
103
+ if (timer.current !== void 0) {
104
+ clearTimeout(timer.current);
105
+ timer.current = void 0;
106
+ }
107
+ };
108
+ const commit = () => {
109
+ const index = Number(buffer.current);
110
+ clearBuffer();
111
+ const item = marks.list.find((entry) => entry.index === index);
112
+ if (item === void 0 || item.canvas === "") return;
113
+ focus(markerFocusId(index));
114
+ const origin = item.origin === void 0 ? {} : { origin: item.origin };
115
+ if (item.kind === "toggle") api.dispatch(item.canvas, { type: "ui:model", ref: item.ref, payload: item.value !== true, ...origin });
116
+ else if (item.kind !== "model")
117
+ api.dispatch(item.canvas, item.value === void 0 ? { type: "ui:click", ref: item.ref, ...origin } : { type: "ui:click", ref: item.ref, payload: item.value, ...origin });
118
+ };
119
+ useInput((input, key) => {
120
+ if (key.downArrow) {
121
+ if (!typingRef.current) focusNext();
122
+ return;
123
+ }
124
+ if (key.upArrow) {
125
+ if (!typingRef.current) focusPrevious();
126
+ return;
127
+ }
128
+ if (typingRef.current) return;
129
+ if (/^[0-9]$/.test(input) && !key.ctrl && !key.meta) {
130
+ buffer.current += input;
131
+ if (timer.current !== void 0) clearTimeout(timer.current);
132
+ if (Number(buffer.current) * 10 > marks.list.length) commit();
133
+ else timer.current = setTimeout(commit, DIGIT_COMMIT_MS);
134
+ return;
135
+ }
136
+ if (buffer.current !== "") clearBuffer();
137
+ });
138
+ return null;
139
+ };
140
+ const StatusLine = () => {
141
+ const status = config.status?.();
142
+ if (status === void 0 || status === "open") return null;
143
+ if (status === "incompatible") {
144
+ return createElement(Text, { color: "red" }, "\xD7 this terminal and the server speak different protocol versions \u2014 update one of them");
145
+ }
146
+ return status === "connecting" ? createElement(Text, { color: "yellow" }, "\u2026 connecting") : createElement(Text, { color: "red" }, "\xD7 connection lost \u2014 retrying");
147
+ };
148
+ const Frame = () => {
149
+ reindex();
150
+ return createElement(
151
+ FrameControlsContext.Provider,
152
+ { value: frameControls },
153
+ createElement(
154
+ TerminalApiContext.Provider,
155
+ { value: api },
156
+ createElement(
157
+ NovaRenderProvider,
158
+ {
159
+ registry,
160
+ // the frame is chrome — app events flow only from inside a canvas
161
+ dispatch: () => void 0,
162
+ publish: (channel, payload) => api.publish(channel, payload),
163
+ fallback: fallback$1,
164
+ textWrapper: TextWrap,
165
+ errorMarker: ErrorMarker
166
+ },
167
+ createElement(Nav),
168
+ createElement(StatusLine),
169
+ createElement(RenderTree, { nodes: api.frame() })
170
+ )
171
+ )
172
+ );
173
+ };
174
+ const instance = render(createElement(Frame), {
175
+ ...config.stdout !== void 0 ? { stdout: config.stdout } : {},
176
+ ...config.stdin !== void 0 ? { stdin: config.stdin } : {},
177
+ exitOnCtrlC: true,
178
+ patchConsole: config.patchConsole ?? true
179
+ });
180
+ void instance.waitUntilExit().then(() => config.onQuit?.());
181
+ return {
182
+ update: () => instance.rerender(createElement(Frame)),
183
+ destroy: () => instance.unmount()
184
+ };
185
+ };
186
+
187
+ export { inkTarget };
188
+ //# sourceMappingURL=index.js.map
189
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/terminal/react/slots.ts","../../../src/terminal/ink/index.ts"],"names":["ttyRegistry","ttyFallback","createElement","inkFallback","InkText","NovaRenderProvider","RenderTree"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, createElement, Fragment, useContext, type ComponentType, type FC, type ReactNode } from 'react';\nimport { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';\nimport type { NovaComponent } from '@niscorp/nova/adapters/react';\nimport type { ComponentRegistry, NovaEvent } from '@niscorp/nova';\nimport type { TerminalApi } from '../index';\n\n// ═══════════════════════════════════════════════════════════\n// The wire-backed structural slots, shared by every react-shaped render\n// target (terminal/react in the browser, terminal/ink in a TTY) — same seam,\n// different renderer. Split from the react target so the ink bundle never\n// drags react-dom.\n// ═══════════════════════════════════════════════════════════\n\nexport const TerminalApiContext = createContext<TerminalApi | undefined>(undefined);\n\n// An app-supplied component wrapping each action instance at the ActionSlot\n// boundary — the terminal twin of nova's client-shell SlotWrapper (same seam,\n// same job: animation, gating, logging, chips). Served trees carry IDENTITY\n// only (ids, not the definition — wire weight), so the props diverge from the\n// client-shell wrapper in exactly that one way: `definitionId`, not `action`.\nexport type TerminalSlotWrapperProps = {\n canvasId?: string;\n instanceId?: string;\n definitionId?: string;\n children?: ReactNode;\n};\nexport type TerminalSlotWrapper = FC<TerminalSlotWrapperProps>;\n\n// The host-specific leaf renderers a react-shaped target may thread through\n// to nova's provider (ink needs all three; the browser needs none).\nexport type WireSlotOptions = {\n slotWrapper?: TerminalSlotWrapper;\n fallback?: NovaComponent;\n textWrapper?: ComponentType<{ children?: ReactNode }>;\n errorMarker?: ComponentType<{ code: string; message: string }>;\n // wraps each canvas's rendered tree with a host context (ink provides the\n // per-canvas marker resolver here); the browser omits it\n canvasProvider?: ComponentType<{ canvasId: string; children?: ReactNode }>;\n // the same, per action instance — inside a list canvas several instances\n // share refs, so ink resolves markers per instance here\n instanceProvider?: ComponentType<{ canvasId: string; instanceId: string; children?: ReactNode }>;\n};\n\n// Register the wire-backed structural slots on a registry:\n//\n// - CanvasSlot: a served CanvasSlot marker in the frame resolves to that\n// canvas's live tree, dispatching events tagged with the canvas (the\n// server stamps origin). It overrides nova's shell-backed CanvasSlot,\n// which the terminal has no shell for.\n// - ActionSlot: the per-instance boundary a served tree carries (identity in\n// props, rendered content as children). With no wrapper it's transparent;\n// with one, the wrapper decides everything. Keyed by instanceId so an\n// instance swap REMOUNTS: no stale view state crossing instances.\nexport const registerWireSlots = (registry: ComponentRegistry<NovaComponent>, options: WireSlotOptions = {}): void => {\n const { slotWrapper, fallback, textWrapper, errorMarker, canvasProvider, instanceProvider } = options;\n\n const CanvasSlot: NovaComponent<{ canvasId?: string }> = ({ canvasId }: { canvasId?: string }) => {\n const api = useContext(TerminalApiContext);\n if (api === undefined || canvasId === undefined || canvasId === '') return null;\n const tree = api.canvasTree(canvasId);\n if (tree.length === 0) return null;\n const body = createElement(RenderTree, { nodes: tree });\n return createElement(\n NovaRenderProvider,\n {\n registry,\n dispatch: (event: NovaEvent) => api.dispatch(canvasId, event),\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n fallback,\n textWrapper,\n errorMarker,\n },\n canvasProvider === undefined ? body : createElement(canvasProvider, { canvasId }, body),\n );\n };\n registry.register('CanvasSlot', CanvasSlot, { description: 'A canvas, live from the server.' });\n\n const ActionSlot: NovaComponent<{ instanceId?: string; canvasId?: string; definitionId?: string }> = ({\n instanceId,\n canvasId,\n definitionId,\n children,\n }: TerminalSlotWrapperProps) => {\n const api = useContext(TerminalApiContext);\n const wrapped = slotWrapper === undefined ? createElement(Fragment, { key: instanceId }, children) : createElement(slotWrapper, { key: instanceId, instanceId, canvasId, definitionId }, children);\n // Origin is decided HERE, where instance identity lives: a list canvas\n // renders several live cards at once, and a click inside THIS boundary\n // must reach THIS instance's triggers — the server's active-instance\n // fallback only holds for card-deck canvases. Events that already carry\n // an origin keep it.\n if (api === undefined || instanceId === undefined || canvasId === undefined) return wrapped;\n return createElement(\n NovaRenderProvider,\n {\n registry,\n dispatch: (event: NovaEvent) => api.dispatch(canvasId, event.origin === undefined ? { ...event, origin: instanceId } : event),\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n fallback,\n textWrapper,\n errorMarker,\n },\n instanceProvider === undefined ? wrapped : createElement(instanceProvider, { canvasId, instanceId }, wrapped),\n );\n };\n registry.register('ActionSlot', ActionSlot, { description: 'An action instance boundary from the server; the app slotWrapper wraps it.' });\n};\n","import { createElement, useRef, type FC, type ReactNode } from 'react';\nimport { render, Text as InkText, useFocusManager, useInput } from 'ink';\nimport { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';\nimport type { NovaComponent } from '@niscorp/nova/adapters/react';\nimport {\n defaultRegistry,\n fallback as inkFallback,\n TextWrap,\n ErrorMarker,\n CanvasMarkersContext,\n FrameControlsContext,\n markerFocusId,\n} from '@niscorp/nova/adapters/ink';\nimport { createTtyView } from '@niscorp/nova/adapters/tty';\nimport type { TtyInteractive } from '@niscorp/nova/adapters/tty';\nimport { defaultRegistry as ttyRegistry, fallback as ttyFallback } from '@niscorp/nova/adapters/tty/components';\nimport type { ComponentRegistry } from '@niscorp/nova';\nimport type { WireStatus } from '../../client';\nimport type { Target } from '../index';\nimport { TerminalApiContext, registerWireSlots } from '../react/slots';\nimport type { TerminalSlotWrapper } from '../react/slots';\n\n// ═══════════════════════════════════════════════════════════\n// @niscorp/moss/terminal/ink — the full-screen terminal render target: nova's\n// Ink kit on the React adapter's walker, mounted with ink's renderer.\n//\n// Interaction is the TTY REPL's numbered addressing plus live focus: every\n// interactive shows a `[n]` marker, and TYPED DIGITS act on it — a button or\n// row clicks, a toggle flips, an input takes focus (then typing types; a\n// focused input claims digits as text, so number navigation stands down).\n// The numbering comes from the TTY adapter's walker run over the SAME served\n// trees — one source of truth, so `[7]` is the same thing in the REPL and\n// the TUI. Tab/Shift+Tab and ↑/↓ still walk the focus ring; Enter activates;\n// Ctrl+C leaves. ESM only, like ink. Node-shaped and react-shaped code lives\n// here, never in moss core.\n// ═══════════════════════════════════════════════════════════\n\nexport type InkTargetConfig = {\n // the app's Ink kit; omit for nova's default (floor kit + fallback)\n registry?: ComponentRegistry<NovaComponent>;\n slotWrapper?: TerminalSlotWrapper;\n stdin?: NodeJS.ReadStream;\n stdout?: NodeJS.WriteStream;\n // the wire's connection state, when the host can supply it — rendered as a\n // dim line while not open (a blank full-screen app on a dead socket is\n // indistinguishable from a working empty one)\n status?: () => WireStatus;\n // called when the ink app exits (Ctrl+C) — the host owns the wire/process\n onQuit?: () => void;\n // Route the process's console output above the frame (ink's patchConsole).\n // Default on — right for one terminal owning its process. A host rendering\n // SEVERAL ink targets in one process (an SSH server, one per connection)\n // turns it off: the console is the process's, and patching it would hand\n // the server's own logs to whoever is connected.\n patchConsole?: boolean;\n};\n\n// How long a typed digit waits for another before acting — only when a\n// longer number is still possible ('1' with 14 interactives on screen).\nconst DIGIT_COMMIT_MS = 600;\n\nexport const inkTarget = (config: InkTargetConfig = {}): Target => (api) => {\n const registry = config.registry ?? defaultRegistry();\n\n // ── the marker table: the TTY walker over the same trees ──\n // Pure and cheap; rebuilt at the top of every frame render. Identity for\n // lookup is (canvas, instance, ref, occurrence) — the instance keeps apart\n // the live instances of a list canvas, which share refs (a tab bar: every\n // tab's button is `open`); occurrence disambiguates a table's rows, which\n // share one rowRef in row order.\n const indexView = createTtyView(ttyRegistry(), api, { fallback: ttyFallback });\n const marks = { list: [] as TtyInteractive[], byKey: new Map<string, TtyInteractive>() };\n const reindex = (): void => {\n marks.list = indexView.render().interactives;\n marks.byKey.clear();\n const seen = new Map<string, number>();\n for (const item of marks.list) {\n const base = `${item.canvas}:${item.origin ?? ''}:${item.ref}`;\n const occurrence = seen.get(base) ?? 0;\n seen.set(base, occurrence + 1);\n marks.byKey.set(`${base}#${occurrence}`, item);\n // click-kinds carry a stable payload — a list's rows share one ref and\n // differ only by value, so value IS the identity there. Model-kinds'\n // value changes as you type; they stay occurrence-keyed.\n if ((item.kind === 'click' || item.kind === 'row') && item.value !== undefined) {\n marks.byKey.set(`${base}@${JSON.stringify(item.value)}`, item);\n }\n }\n };\n\n // ink resolves markers per canvas and, inside an action instance, per\n // instance — the slots' canvasProvider and instanceProvider curry them.\n const resolverFor = (canvasId: string, instanceId: string) => (ref: string, identity: { value?: unknown; occurrence?: number } = {}) => {\n const base = `${canvasId}:${instanceId}:${ref}`;\n if (identity.value !== undefined) {\n const byValue = marks.byKey.get(`${base}@${JSON.stringify(identity.value)}`);\n if (byValue !== undefined) return byValue.index;\n }\n return marks.byKey.get(`${base}#${identity.occurrence ?? 0}`)?.index;\n };\n const CanvasMarkers: FC<{ canvasId: string; children?: ReactNode }> = ({ canvasId, children }) =>\n createElement(CanvasMarkersContext.Provider, { value: resolverFor(canvasId, '') }, children);\n const InstanceMarkers: FC<{ canvasId: string; instanceId: string; children?: ReactNode }> = ({ canvasId, instanceId, children }) =>\n createElement(CanvasMarkersContext.Provider, { value: resolverFor(canvasId, instanceId) }, children);\n\n registerWireSlots(registry, {\n slotWrapper: config.slotWrapper,\n fallback: inkFallback,\n textWrapper: TextWrap,\n errorMarker: ErrorMarker,\n canvasProvider: CanvasMarkers,\n instanceProvider: InstanceMarkers,\n });\n\n // A focused input claims typed digits as text — the kit's Input reports\n // its focus through FrameControls and Nav stands down.\n const typingRef = { current: false };\n const frameControls = { setTyping: (typing: boolean): void => void (typingRef.current = typing) };\n\n // ↑/↓ walk the focus ring; typed digits address `[n]` directly — click a\n // button or row, flip a toggle, focus an input. Multi-digit numbers\n // accumulate; an unambiguous one acts immediately.\n const Nav: FC = () => {\n const { focus, focusNext, focusPrevious } = useFocusManager();\n const buffer = useRef('');\n const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n const clearBuffer = (): void => {\n buffer.current = '';\n if (timer.current !== undefined) {\n clearTimeout(timer.current);\n timer.current = undefined;\n }\n };\n const commit = (): void => {\n const index = Number(buffer.current);\n clearBuffer();\n const item = marks.list.find((entry) => entry.index === index);\n if (item === undefined || item.canvas === '') return;\n // focus follows the number for every kind — visible feedback, and for\n // an input the focus IS the action (typing types from here on)\n focus(markerFocusId(index));\n // the instance it sits in is the origin (a list canvas has several live)\n const origin = item.origin === undefined ? {} : { origin: item.origin };\n if (item.kind === 'toggle') api.dispatch(item.canvas, { type: 'ui:model', ref: item.ref, payload: item.value !== true, ...origin });\n else if (item.kind !== 'model')\n api.dispatch(item.canvas, item.value === undefined ? { type: 'ui:click', ref: item.ref, ...origin } : { type: 'ui:click', ref: item.ref, payload: item.value, ...origin });\n };\n useInput((input, key) => {\n // While an input is focused, vertical arrows belong to it (it forwards\n // them to the server as ui:key — a palette moves its highlight).\n if (key.downArrow) {\n if (!typingRef.current) focusNext();\n return;\n }\n if (key.upArrow) {\n if (!typingRef.current) focusPrevious();\n return;\n }\n if (typingRef.current) return;\n if (/^[0-9]$/.test(input) && !key.ctrl && !key.meta) {\n buffer.current += input;\n if (timer.current !== undefined) clearTimeout(timer.current);\n // no longer number is possible → act now; otherwise wait a beat\n if (Number(buffer.current) * 10 > marks.list.length) commit();\n else timer.current = setTimeout(commit, DIGIT_COMMIT_MS);\n return;\n }\n if (buffer.current !== '') clearBuffer();\n });\n return null;\n };\n\n const StatusLine: FC = () => {\n const status = config.status?.();\n if (status === undefined || status === 'open') return null;\n if (status === 'incompatible') {\n return createElement(InkText, { color: 'red' }, '× this terminal and the server speak different protocol versions — update one of them');\n }\n return status === 'connecting'\n ? createElement(InkText, { color: 'yellow' }, '… connecting')\n : createElement(InkText, { color: 'red' }, '× connection lost — retrying');\n };\n\n const Frame: FC = () => {\n reindex();\n return createElement(\n FrameControlsContext.Provider,\n { value: frameControls },\n createElement(\n TerminalApiContext.Provider,\n { value: api },\n createElement(\n NovaRenderProvider,\n {\n registry,\n // the frame is chrome — app events flow only from inside a canvas\n dispatch: () => undefined,\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n fallback: inkFallback,\n textWrapper: TextWrap,\n errorMarker: ErrorMarker,\n },\n createElement(Nav),\n createElement(StatusLine),\n createElement(RenderTree, { nodes: api.frame() }),\n ),\n ),\n );\n };\n\n const instance = render(createElement(Frame), {\n ...(config.stdout !== undefined ? { stdout: config.stdout } : {}),\n ...(config.stdin !== undefined ? { stdin: config.stdin } : {}),\n exitOnCtrlC: true,\n patchConsole: config.patchConsole ?? true,\n });\n void instance.waitUntilExit().then(() => config.onQuit?.());\n\n // The conductor drives re-render: each `update` re-reads api.frame() and\n // the canvas trees, and React reconciles (focus survives by node key).\n return {\n update: () => instance.rerender(createElement(Frame)),\n destroy: () => instance.unmount(),\n };\n};\n"]}
@@ -0,0 +1,87 @@
1
+ 'use strict';
2
+
3
+ var react = require('react');
4
+ var client = require('react-dom/client');
5
+ var react$1 = require('@niscorp/nova/adapters/react');
6
+
7
+ // src/terminal/react/index.ts
8
+ var TerminalApiContext = react.createContext(void 0);
9
+ var registerWireSlots = (registry, options = {}) => {
10
+ const { slotWrapper, fallback, textWrapper, errorMarker, canvasProvider, instanceProvider } = options;
11
+ const CanvasSlot = ({ canvasId }) => {
12
+ const api = react.useContext(TerminalApiContext);
13
+ if (api === void 0 || canvasId === void 0 || canvasId === "") return null;
14
+ const tree = api.canvasTree(canvasId);
15
+ if (tree.length === 0) return null;
16
+ const body = react.createElement(react$1.RenderTree, { nodes: tree });
17
+ return react.createElement(
18
+ react$1.NovaRenderProvider,
19
+ {
20
+ registry,
21
+ dispatch: (event) => api.dispatch(canvasId, event),
22
+ publish: (channel, payload) => api.publish(channel, payload),
23
+ fallback,
24
+ textWrapper,
25
+ errorMarker
26
+ },
27
+ canvasProvider === void 0 ? body : react.createElement(canvasProvider, { canvasId }, body)
28
+ );
29
+ };
30
+ registry.register("CanvasSlot", CanvasSlot, { description: "A canvas, live from the server." });
31
+ const ActionSlot = ({
32
+ instanceId,
33
+ canvasId,
34
+ definitionId,
35
+ children
36
+ }) => {
37
+ const api = react.useContext(TerminalApiContext);
38
+ const wrapped = slotWrapper === void 0 ? react.createElement(react.Fragment, { key: instanceId }, children) : react.createElement(slotWrapper, { key: instanceId, instanceId, canvasId, definitionId }, children);
39
+ if (api === void 0 || instanceId === void 0 || canvasId === void 0) return wrapped;
40
+ return react.createElement(
41
+ react$1.NovaRenderProvider,
42
+ {
43
+ registry,
44
+ dispatch: (event) => api.dispatch(canvasId, event.origin === void 0 ? { ...event, origin: instanceId } : event),
45
+ publish: (channel, payload) => api.publish(channel, payload),
46
+ fallback,
47
+ textWrapper,
48
+ errorMarker
49
+ },
50
+ instanceProvider === void 0 ? wrapped : react.createElement(instanceProvider, { canvasId, instanceId }, wrapped)
51
+ );
52
+ };
53
+ registry.register("ActionSlot", ActionSlot, { description: "An action instance boundary from the server; the app slotWrapper wraps it." });
54
+ };
55
+
56
+ // src/terminal/react/index.ts
57
+ var reactTarget = (config) => {
58
+ const { root, registry, slotWrapper } = config;
59
+ registerWireSlots(registry, { slotWrapper });
60
+ return (api) => {
61
+ const Frame = () => react.createElement(
62
+ TerminalApiContext.Provider,
63
+ { value: api },
64
+ react.createElement(
65
+ react$1.NovaRenderProvider,
66
+ {
67
+ registry,
68
+ // the frame is chrome — app events flow only from inside a canvas
69
+ dispatch: () => void 0,
70
+ publish: (channel, payload) => api.publish(channel, payload)
71
+ },
72
+ react.createElement(react$1.RenderTree, { nodes: api.frame() })
73
+ )
74
+ );
75
+ const adopts = root.firstElementChild !== null && api.frame().length > 0;
76
+ const reactRoot = adopts ? client.hydrateRoot(root, react.createElement(Frame)) : client.createRoot(root);
77
+ const render = () => reactRoot.render(react.createElement(Frame));
78
+ if (!adopts) render();
79
+ return { update: render, destroy: () => reactRoot.unmount() };
80
+ };
81
+ };
82
+
83
+ exports.TerminalApiContext = TerminalApiContext;
84
+ exports.reactTarget = reactTarget;
85
+ exports.registerWireSlots = registerWireSlots;
86
+ //# sourceMappingURL=index.cjs.map
87
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/terminal/react/slots.ts","../../../src/terminal/react/index.ts"],"names":["createContext","useContext","createElement","RenderTree","NovaRenderProvider","Fragment","hydrateRoot","createRoot"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, createElement, Fragment, useContext, type ComponentType, type FC, type ReactNode } from 'react';\nimport { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';\nimport type { NovaComponent } from '@niscorp/nova/adapters/react';\nimport type { ComponentRegistry, NovaEvent } from '@niscorp/nova';\nimport type { TerminalApi } from '../index';\n\n// ═══════════════════════════════════════════════════════════\n// The wire-backed structural slots, shared by every react-shaped render\n// target (terminal/react in the browser, terminal/ink in a TTY) — same seam,\n// different renderer. Split from the react target so the ink bundle never\n// drags react-dom.\n// ═══════════════════════════════════════════════════════════\n\nexport const TerminalApiContext = createContext<TerminalApi | undefined>(undefined);\n\n// An app-supplied component wrapping each action instance at the ActionSlot\n// boundary — the terminal twin of nova's client-shell SlotWrapper (same seam,\n// same job: animation, gating, logging, chips). Served trees carry IDENTITY\n// only (ids, not the definition — wire weight), so the props diverge from the\n// client-shell wrapper in exactly that one way: `definitionId`, not `action`.\nexport type TerminalSlotWrapperProps = {\n canvasId?: string;\n instanceId?: string;\n definitionId?: string;\n children?: ReactNode;\n};\nexport type TerminalSlotWrapper = FC<TerminalSlotWrapperProps>;\n\n// The host-specific leaf renderers a react-shaped target may thread through\n// to nova's provider (ink needs all three; the browser needs none).\nexport type WireSlotOptions = {\n slotWrapper?: TerminalSlotWrapper;\n fallback?: NovaComponent;\n textWrapper?: ComponentType<{ children?: ReactNode }>;\n errorMarker?: ComponentType<{ code: string; message: string }>;\n // wraps each canvas's rendered tree with a host context (ink provides the\n // per-canvas marker resolver here); the browser omits it\n canvasProvider?: ComponentType<{ canvasId: string; children?: ReactNode }>;\n // the same, per action instance — inside a list canvas several instances\n // share refs, so ink resolves markers per instance here\n instanceProvider?: ComponentType<{ canvasId: string; instanceId: string; children?: ReactNode }>;\n};\n\n// Register the wire-backed structural slots on a registry:\n//\n// - CanvasSlot: a served CanvasSlot marker in the frame resolves to that\n// canvas's live tree, dispatching events tagged with the canvas (the\n// server stamps origin). It overrides nova's shell-backed CanvasSlot,\n// which the terminal has no shell for.\n// - ActionSlot: the per-instance boundary a served tree carries (identity in\n// props, rendered content as children). With no wrapper it's transparent;\n// with one, the wrapper decides everything. Keyed by instanceId so an\n// instance swap REMOUNTS: no stale view state crossing instances.\nexport const registerWireSlots = (registry: ComponentRegistry<NovaComponent>, options: WireSlotOptions = {}): void => {\n const { slotWrapper, fallback, textWrapper, errorMarker, canvasProvider, instanceProvider } = options;\n\n const CanvasSlot: NovaComponent<{ canvasId?: string }> = ({ canvasId }: { canvasId?: string }) => {\n const api = useContext(TerminalApiContext);\n if (api === undefined || canvasId === undefined || canvasId === '') return null;\n const tree = api.canvasTree(canvasId);\n if (tree.length === 0) return null;\n const body = createElement(RenderTree, { nodes: tree });\n return createElement(\n NovaRenderProvider,\n {\n registry,\n dispatch: (event: NovaEvent) => api.dispatch(canvasId, event),\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n fallback,\n textWrapper,\n errorMarker,\n },\n canvasProvider === undefined ? body : createElement(canvasProvider, { canvasId }, body),\n );\n };\n registry.register('CanvasSlot', CanvasSlot, { description: 'A canvas, live from the server.' });\n\n const ActionSlot: NovaComponent<{ instanceId?: string; canvasId?: string; definitionId?: string }> = ({\n instanceId,\n canvasId,\n definitionId,\n children,\n }: TerminalSlotWrapperProps) => {\n const api = useContext(TerminalApiContext);\n const wrapped = slotWrapper === undefined ? createElement(Fragment, { key: instanceId }, children) : createElement(slotWrapper, { key: instanceId, instanceId, canvasId, definitionId }, children);\n // Origin is decided HERE, where instance identity lives: a list canvas\n // renders several live cards at once, and a click inside THIS boundary\n // must reach THIS instance's triggers — the server's active-instance\n // fallback only holds for card-deck canvases. Events that already carry\n // an origin keep it.\n if (api === undefined || instanceId === undefined || canvasId === undefined) return wrapped;\n return createElement(\n NovaRenderProvider,\n {\n registry,\n dispatch: (event: NovaEvent) => api.dispatch(canvasId, event.origin === undefined ? { ...event, origin: instanceId } : event),\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n fallback,\n textWrapper,\n errorMarker,\n },\n instanceProvider === undefined ? wrapped : createElement(instanceProvider, { canvasId, instanceId }, wrapped),\n );\n };\n registry.register('ActionSlot', ActionSlot, { description: 'An action instance boundary from the server; the app slotWrapper wraps it.' });\n};\n","import { createElement, type FC } from 'react';\nimport { createRoot, hydrateRoot } from 'react-dom/client';\nimport { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';\nimport type { NovaComponent } from '@niscorp/nova/adapters/react';\nimport type { ComponentRegistry } from '@niscorp/nova';\nimport type { Target } from '../index';\nimport { TerminalApiContext, registerWireSlots } from './slots';\nimport type { TerminalSlotWrapper } from './slots';\n\n// ═══════════════════════════════════════════════════════════\n// @niscorp/moss/terminal/react — the React render target. The app brings its\n// component registry (its design system); this binds it to the wire via\n// nova's React adapter. The framework-shaped code lives here, in the subpath,\n// never in moss core. The wire-backed slots live in ./slots, shared with the\n// other react-shaped target (terminal/ink).\n// ═══════════════════════════════════════════════════════════\n\nexport { TerminalApiContext, registerWireSlots } from './slots';\nexport type { TerminalSlotWrapper, TerminalSlotWrapperProps, WireSlotOptions } from './slots';\n\nexport const reactTarget = (config: { root: HTMLElement; registry: ComponentRegistry<NovaComponent>; slotWrapper?: TerminalSlotWrapper }): Target => {\n const { root, registry, slotWrapper } = config;\n registerWireSlots(registry, { slotWrapper });\n\n return (api) => {\n const Frame: FC = () =>\n createElement(\n TerminalApiContext.Provider,\n { value: api },\n createElement(\n NovaRenderProvider,\n {\n registry,\n // the frame is chrome — app events flow only from inside a canvas\n dispatch: () => undefined,\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n },\n createElement(RenderTree, { nodes: api.frame() }),\n ),\n );\n // The conductor drives re-render: each `update` re-reads api.frame() and\n // the canvas trees, and React reconciles (preserving focus by node key).\n // A root that already holds elements was rendered on the server from the\n // snapshot the wire starts from: adopt those elements instead of replacing\n // them. An empty root is the client-rendered page it always was.\n // Only when there is a frame to adopt them WITH: a wire that did not start\n // from the page's snapshot (it was rendered for somebody else) has nothing\n // that matches, and the elements are replaced as on any other page.\n const adopts = root.firstElementChild !== null && api.frame().length > 0;\n const reactRoot = adopts ? hydrateRoot(root, createElement(Frame)) : createRoot(root);\n const render = (): void => reactRoot.render(createElement(Frame));\n if (!adopts) render();\n return { update: render, destroy: () => reactRoot.unmount() };\n };\n};\n"]}
@@ -0,0 +1,15 @@
1
+ import { NovaComponent } from '@niscorp/nova/adapters/react';
2
+ import { ComponentRegistry } from '@niscorp/nova';
3
+ import { Target } from '../index.cjs';
4
+ import { T as TerminalSlotWrapper } from '../../slots-Do9ScG7v.cjs';
5
+ export { a as TerminalApiContext, b as TerminalSlotWrapperProps, W as WireSlotOptions, r as registerWireSlots } from '../../slots-Do9ScG7v.cjs';
6
+ import '../../client.cjs';
7
+ import 'react';
8
+
9
+ declare const reactTarget: (config: {
10
+ root: HTMLElement;
11
+ registry: ComponentRegistry<NovaComponent>;
12
+ slotWrapper?: TerminalSlotWrapper;
13
+ }) => Target;
14
+
15
+ export { TerminalSlotWrapper, reactTarget };
@@ -0,0 +1,15 @@
1
+ import { NovaComponent } from '@niscorp/nova/adapters/react';
2
+ import { ComponentRegistry } from '@niscorp/nova';
3
+ import { Target } from '../index.js';
4
+ import { T as TerminalSlotWrapper } from '../../slots-Do9ScG7v.js';
5
+ export { a as TerminalApiContext, b as TerminalSlotWrapperProps, W as WireSlotOptions, r as registerWireSlots } from '../../slots-Do9ScG7v.js';
6
+ import '../../client.js';
7
+ import 'react';
8
+
9
+ declare const reactTarget: (config: {
10
+ root: HTMLElement;
11
+ registry: ComponentRegistry<NovaComponent>;
12
+ slotWrapper?: TerminalSlotWrapper;
13
+ }) => Target;
14
+
15
+ export { TerminalSlotWrapper, reactTarget };
@@ -0,0 +1,35 @@
1
+ import { registerWireSlots, TerminalApiContext } from '../../chunk-SK4PDGEE.js';
2
+ export { TerminalApiContext, registerWireSlots } from '../../chunk-SK4PDGEE.js';
3
+ import { createElement } from 'react';
4
+ import { hydrateRoot, createRoot } from 'react-dom/client';
5
+ import { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';
6
+
7
+ var reactTarget = (config) => {
8
+ const { root, registry, slotWrapper } = config;
9
+ registerWireSlots(registry, { slotWrapper });
10
+ return (api) => {
11
+ const Frame = () => createElement(
12
+ TerminalApiContext.Provider,
13
+ { value: api },
14
+ createElement(
15
+ NovaRenderProvider,
16
+ {
17
+ registry,
18
+ // the frame is chrome — app events flow only from inside a canvas
19
+ dispatch: () => void 0,
20
+ publish: (channel, payload) => api.publish(channel, payload)
21
+ },
22
+ createElement(RenderTree, { nodes: api.frame() })
23
+ )
24
+ );
25
+ const adopts = root.firstElementChild !== null && api.frame().length > 0;
26
+ const reactRoot = adopts ? hydrateRoot(root, createElement(Frame)) : createRoot(root);
27
+ const render = () => reactRoot.render(createElement(Frame));
28
+ if (!adopts) render();
29
+ return { update: render, destroy: () => reactRoot.unmount() };
30
+ };
31
+ };
32
+
33
+ export { reactTarget };
34
+ //# sourceMappingURL=index.js.map
35
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/terminal/react/index.ts"],"names":[],"mappings":";;;;;;AAoBO,IAAM,WAAA,GAAc,CAAC,MAAA,KAAyH;AACnJ,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,WAAA,EAAY,GAAI,MAAA;AACxC,EAAA,iBAAA,CAAkB,QAAA,EAAU,EAAE,WAAA,EAAa,CAAA;AAE3C,EAAA,OAAO,CAAC,GAAA,KAAQ;AACd,IAAA,MAAM,QAAY,MAChB,aAAA;AAAA,MACE,kBAAA,CAAmB,QAAA;AAAA,MACnB,EAAE,OAAO,GAAA,EAAI;AAAA,MACb,aAAA;AAAA,QACE,kBAAA;AAAA,QACA;AAAA,UACE,QAAA;AAAA;AAAA,UAEA,UAAU,MAAM,MAAA;AAAA,UAChB,SAAS,CAAC,OAAA,EAAiB,YAAsB,GAAA,CAAI,OAAA,CAAQ,SAAS,OAAO;AAAA,SAC/E;AAAA,QACA,cAAc,UAAA,EAAY,EAAE,OAAO,GAAA,CAAI,KAAA,IAAS;AAAA;AAClD,KACF;AASF,IAAA,MAAM,SAAS,IAAA,CAAK,iBAAA,KAAsB,QAAQ,GAAA,CAAI,KAAA,GAAQ,MAAA,GAAS,CAAA;AACvE,IAAA,MAAM,SAAA,GAAY,SAAS,WAAA,CAAY,IAAA,EAAM,cAAc,KAAK,CAAC,CAAA,GAAI,UAAA,CAAW,IAAI,CAAA;AACpF,IAAA,MAAM,SAAS,MAAY,SAAA,CAAU,MAAA,CAAO,aAAA,CAAc,KAAK,CAAC,CAAA;AAChE,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAO;AACpB,IAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,SAAS,MAAM,SAAA,CAAU,SAAQ,EAAE;AAAA,EAC9D,CAAA;AACF","file":"index.js","sourcesContent":["import { createElement, type FC } from 'react';\nimport { createRoot, hydrateRoot } from 'react-dom/client';\nimport { NovaRenderProvider, RenderTree } from '@niscorp/nova/adapters/react';\nimport type { NovaComponent } from '@niscorp/nova/adapters/react';\nimport type { ComponentRegistry } from '@niscorp/nova';\nimport type { Target } from '../index';\nimport { TerminalApiContext, registerWireSlots } from './slots';\nimport type { TerminalSlotWrapper } from './slots';\n\n// ═══════════════════════════════════════════════════════════\n// @niscorp/moss/terminal/react — the React render target. The app brings its\n// component registry (its design system); this binds it to the wire via\n// nova's React adapter. The framework-shaped code lives here, in the subpath,\n// never in moss core. The wire-backed slots live in ./slots, shared with the\n// other react-shaped target (terminal/ink).\n// ═══════════════════════════════════════════════════════════\n\nexport { TerminalApiContext, registerWireSlots } from './slots';\nexport type { TerminalSlotWrapper, TerminalSlotWrapperProps, WireSlotOptions } from './slots';\n\nexport const reactTarget = (config: { root: HTMLElement; registry: ComponentRegistry<NovaComponent>; slotWrapper?: TerminalSlotWrapper }): Target => {\n const { root, registry, slotWrapper } = config;\n registerWireSlots(registry, { slotWrapper });\n\n return (api) => {\n const Frame: FC = () =>\n createElement(\n TerminalApiContext.Provider,\n { value: api },\n createElement(\n NovaRenderProvider,\n {\n registry,\n // the frame is chrome — app events flow only from inside a canvas\n dispatch: () => undefined,\n publish: (channel: string, payload?: unknown) => api.publish(channel, payload),\n },\n createElement(RenderTree, { nodes: api.frame() }),\n ),\n );\n // The conductor drives re-render: each `update` re-reads api.frame() and\n // the canvas trees, and React reconciles (preserving focus by node key).\n // A root that already holds elements was rendered on the server from the\n // snapshot the wire starts from: adopt those elements instead of replacing\n // them. An empty root is the client-rendered page it always was.\n // Only when there is a frame to adopt them WITH: a wire that did not start\n // from the page's snapshot (it was rendered for somebody else) has nothing\n // that matches, and the elements are replaced as on any other page.\n const adopts = root.firstElementChild !== null && api.frame().length > 0;\n const reactRoot = adopts ? hydrateRoot(root, createElement(Frame)) : createRoot(root);\n const render = (): void => reactRoot.render(createElement(Frame));\n if (!adopts) render();\n return { update: render, destroy: () => reactRoot.unmount() };\n };\n};\n"]}