@sixb/app 0.2.3 → 0.2.5

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 (329) hide show
  1. package/assets/connector-icons/README.md +1 -0
  2. package/assets/connector-icons/ctm.png +0 -0
  3. package/dist/agent/activity-label.d.ts.map +1 -1
  4. package/dist/agent/agent-chat.d.ts +3 -1
  5. package/dist/agent/agent-chat.d.ts.map +1 -1
  6. package/dist/agent/agent-panel.d.ts.map +1 -1
  7. package/dist/agent/artifact-panel.d.ts +3 -1
  8. package/dist/agent/artifact-panel.d.ts.map +1 -1
  9. package/dist/agent/background/background-tool-row.d.ts.map +1 -1
  10. package/dist/agent/background/interpret.d.ts +1 -1
  11. package/dist/agent/background/interpret.d.ts.map +1 -1
  12. package/dist/agent/components/composer-settings.d.ts +1 -1
  13. package/dist/agent/components/composer-settings.d.ts.map +1 -1
  14. package/dist/agent/components/composer.d.ts +22 -5
  15. package/dist/agent/components/composer.d.ts.map +1 -1
  16. package/dist/agent/components/context-meter.d.ts +1 -1
  17. package/dist/agent/components/context-meter.d.ts.map +1 -1
  18. package/dist/agent/components/conversation-panel.d.ts +8 -2
  19. package/dist/agent/components/conversation-panel.d.ts.map +1 -1
  20. package/dist/agent/components/message-parts.d.ts +2 -1
  21. package/dist/agent/components/message-parts.d.ts.map +1 -1
  22. package/dist/agent/components/message-view.d.ts.map +1 -1
  23. package/dist/agent/components/pending-messages.d.ts +20 -0
  24. package/dist/agent/components/pending-messages.d.ts.map +1 -0
  25. package/dist/agent/components/sandbox-recovery.d.ts +11 -2
  26. package/dist/agent/components/sandbox-recovery.d.ts.map +1 -1
  27. package/dist/agent/components/threads-button.d.ts +1 -1
  28. package/dist/agent/components/threads-button.d.ts.map +1 -1
  29. package/dist/agent/components/transcript.d.ts +5 -0
  30. package/dist/agent/components/transcript.d.ts.map +1 -1
  31. package/dist/agent/conversation.d.ts +3 -6
  32. package/dist/agent/conversation.d.ts.map +1 -1
  33. package/dist/agent/delegation/agent-exchange.d.ts +16 -0
  34. package/dist/agent/delegation/agent-exchange.d.ts.map +1 -0
  35. package/dist/agent/delegation/child-card.d.ts +3 -3
  36. package/dist/agent/delegation/child-card.d.ts.map +1 -1
  37. package/dist/agent/delegation/child-parts.d.ts +1 -10
  38. package/dist/agent/delegation/child-parts.d.ts.map +1 -1
  39. package/dist/agent/delegation/child-work.d.ts.map +1 -1
  40. package/dist/agent/delegation/interpret.d.ts +9 -10
  41. package/dist/agent/delegation/interpret.d.ts.map +1 -1
  42. package/dist/agent/delegation/use-children.d.ts.map +1 -1
  43. package/dist/agent/file-edits/file-edit-tool-view.d.ts +10 -0
  44. package/dist/agent/file-edits/file-edit-tool-view.d.ts.map +1 -0
  45. package/dist/agent/file-edits/interpret.d.ts +25 -0
  46. package/dist/agent/file-edits/interpret.d.ts.map +1 -0
  47. package/dist/agent/hooks/use-agent-conversation.d.ts +16 -4
  48. package/dist/agent/hooks/use-agent-conversation.d.ts.map +1 -1
  49. package/dist/agent/hooks/use-thread-lists.d.ts.map +1 -1
  50. package/dist/agent/hooks/use-thread-stream.d.ts.map +1 -1
  51. package/dist/agent/i18n/en.d.ts +114 -5
  52. package/dist/agent/i18n/en.d.ts.map +1 -1
  53. package/dist/agent/i18n/fr.d.ts.map +1 -1
  54. package/dist/agent/i18n/index.d.ts +190 -8
  55. package/dist/agent/i18n/index.d.ts.map +1 -1
  56. package/dist/agent/inbox-handoff.d.ts +10 -0
  57. package/dist/agent/inbox-handoff.d.ts.map +1 -0
  58. package/dist/agent/live-run.d.ts +8 -1
  59. package/dist/agent/live-run.d.ts.map +1 -1
  60. package/dist/agent/message-agent/interpret.d.ts +2 -2
  61. package/dist/agent/message-agent/interpret.d.ts.map +1 -1
  62. package/dist/agent/publish-artifact/interpret.d.ts +1 -1
  63. package/dist/agent/publish-artifact/interpret.d.ts.map +1 -1
  64. package/dist/agent/questions/interpret.d.ts +31 -0
  65. package/dist/agent/questions/interpret.d.ts.map +1 -0
  66. package/dist/agent/questions/question-card.d.ts +16 -0
  67. package/dist/agent/questions/question-card.d.ts.map +1 -0
  68. package/dist/agent/questions/question-composer.d.ts +15 -0
  69. package/dist/agent/questions/question-composer.d.ts.map +1 -0
  70. package/dist/agent/read/interpret.d.ts +8 -1
  71. package/dist/agent/read/interpret.d.ts.map +1 -1
  72. package/dist/agent/read/read-tool-view.d.ts.map +1 -1
  73. package/dist/agent/search/interpret.d.ts +101 -0
  74. package/dist/agent/search/interpret.d.ts.map +1 -0
  75. package/dist/agent/search/search-tool-view.d.ts +10 -0
  76. package/dist/agent/search/search-tool-view.d.ts.map +1 -0
  77. package/dist/agent/thread-state.d.ts +26 -0
  78. package/dist/agent/thread-state.d.ts.map +1 -0
  79. package/dist/agent/tool-views/built-in.d.ts.map +1 -1
  80. package/dist/agent/tool-views/registry.d.ts +5 -6
  81. package/dist/agent/tool-views/registry.d.ts.map +1 -1
  82. package/dist/agent/types.d.ts +5 -1
  83. package/dist/agent/types.d.ts.map +1 -1
  84. package/dist/agent/view-file/view-file-tool-view.d.ts +2 -1
  85. package/dist/agent/view-file/view-file-tool-view.d.ts.map +1 -1
  86. package/dist/agent/waits.d.ts +14 -0
  87. package/dist/agent/waits.d.ts.map +1 -0
  88. package/dist/artifacts/card-preview.d.ts.map +1 -1
  89. package/dist/artifacts/edit-session.d.ts +11 -1
  90. package/dist/artifacts/edit-session.d.ts.map +1 -1
  91. package/dist/artifacts/editor/block-handle.d.ts +20 -0
  92. package/dist/artifacts/editor/block-handle.d.ts.map +1 -0
  93. package/dist/artifacts/editor/blocks.d.ts +34 -0
  94. package/dist/artifacts/editor/blocks.d.ts.map +1 -0
  95. package/dist/artifacts/editor/callout-view.d.ts +7 -0
  96. package/dist/artifacts/editor/callout-view.d.ts.map +1 -0
  97. package/dist/artifacts/editor/document-editor.d.ts +30 -0
  98. package/dist/artifacts/editor/document-editor.d.ts.map +1 -0
  99. package/dist/artifacts/editor/figure-view.d.ts +12 -0
  100. package/dist/artifacts/editor/figure-view.d.ts.map +1 -0
  101. package/dist/artifacts/editor/find-blocks.d.ts +6 -0
  102. package/dist/artifacts/editor/find-blocks.d.ts.map +1 -0
  103. package/dist/artifacts/editor/markdown-document.d.ts +12 -0
  104. package/dist/artifacts/editor/markdown-document.d.ts.map +1 -0
  105. package/dist/artifacts/editor/messages.d.ts +4 -0
  106. package/dist/artifacts/editor/messages.d.ts.map +1 -0
  107. package/dist/artifacts/editor/schema.d.ts +21 -0
  108. package/dist/artifacts/editor/schema.d.ts.map +1 -0
  109. package/dist/artifacts/editor/selection-toolbar.d.ts +35 -0
  110. package/dist/artifacts/editor/selection-toolbar.d.ts.map +1 -0
  111. package/dist/artifacts/editor/slash-menu.d.ts +43 -0
  112. package/dist/artifacts/editor/slash-menu.d.ts.map +1 -0
  113. package/dist/artifacts/editor/upload.d.ts +12 -0
  114. package/dist/artifacts/editor/upload.d.ts.map +1 -0
  115. package/dist/artifacts/file-source.d.ts +5 -0
  116. package/dist/artifacts/file-source.d.ts.map +1 -1
  117. package/dist/artifacts/frame-editor/bundle.d.ts +7 -0
  118. package/dist/artifacts/frame-editor/bundle.d.ts.map +1 -0
  119. package/dist/artifacts/frame-editor/commands.d.ts +93 -0
  120. package/dist/artifacts/frame-editor/commands.d.ts.map +1 -0
  121. package/dist/artifacts/frame-editor/entry.d.ts +2 -0
  122. package/dist/artifacts/frame-editor/entry.d.ts.map +1 -0
  123. package/dist/artifacts/frame-editor/frame.d.ts +5 -0
  124. package/dist/artifacts/frame-editor/frame.d.ts.map +1 -0
  125. package/dist/artifacts/frame-editor/keys.d.ts +8 -0
  126. package/dist/artifacts/frame-editor/keys.d.ts.map +1 -0
  127. package/dist/artifacts/frame-editor/protocol.d.ts +186 -0
  128. package/dist/artifacts/frame-editor/protocol.d.ts.map +1 -0
  129. package/dist/artifacts/frame-editor/schema.d.ts +34 -0
  130. package/dist/artifacts/frame-editor/schema.d.ts.map +1 -0
  131. package/dist/artifacts/frame-editor/style.d.ts +2 -0
  132. package/dist/artifacts/frame-editor/style.d.ts.map +1 -0
  133. package/dist/artifacts/frame.d.ts +2 -2
  134. package/dist/artifacts/frame.d.ts.map +1 -1
  135. package/dist/artifacts/live/boards.d.ts +2 -0
  136. package/dist/artifacts/live/boards.d.ts.map +1 -1
  137. package/dist/artifacts/live/document.d.ts +32 -0
  138. package/dist/artifacts/live/document.d.ts.map +1 -0
  139. package/dist/artifacts/live/header.d.ts +4 -4
  140. package/dist/artifacts/live/header.d.ts.map +1 -1
  141. package/dist/artifacts/live/presence.d.ts.map +1 -1
  142. package/dist/artifacts/live/session.d.ts +2 -0
  143. package/dist/artifacts/live/session.d.ts.map +1 -1
  144. package/dist/artifacts/live/view.d.ts +4 -3
  145. package/dist/artifacts/live/view.d.ts.map +1 -1
  146. package/dist/artifacts/messages.d.ts +278 -2
  147. package/dist/artifacts/messages.d.ts.map +1 -1
  148. package/dist/artifacts/pdf.d.ts +8 -0
  149. package/dist/artifacts/pdf.d.ts.map +1 -0
  150. package/dist/artifacts/queries.d.ts +80 -0
  151. package/dist/artifacts/queries.d.ts.map +1 -1
  152. package/dist/artifacts/references/references.d.ts +3 -3
  153. package/dist/artifacts/references/references.d.ts.map +1 -1
  154. package/dist/artifacts/renderers/canvas/board-editor.d.ts +11 -4
  155. package/dist/artifacts/renderers/canvas/board-editor.d.ts.map +1 -1
  156. package/dist/artifacts/renderers/canvas/board.d.ts +14 -2
  157. package/dist/artifacts/renderers/canvas/board.d.ts.map +1 -1
  158. package/dist/artifacts/renderers/canvas/canvas.d.ts +4 -3
  159. package/dist/artifacts/renderers/canvas/canvas.d.ts.map +1 -1
  160. package/dist/artifacts/renderers/canvas/comment-pins.d.ts +4 -2
  161. package/dist/artifacts/renderers/canvas/comment-pins.d.ts.map +1 -1
  162. package/dist/artifacts/renderers/canvas/comments-panel.d.ts.map +1 -1
  163. package/dist/artifacts/renderers/canvas/comments.d.ts +2 -1
  164. package/dist/artifacts/renderers/canvas/comments.d.ts.map +1 -1
  165. package/dist/artifacts/renderers/canvas/controls.d.ts +15 -4
  166. package/dist/artifacts/renderers/canvas/controls.d.ts.map +1 -1
  167. package/dist/artifacts/renderers/canvas/focus.d.ts +19 -5
  168. package/dist/artifacts/renderers/canvas/focus.d.ts.map +1 -1
  169. package/dist/artifacts/renderers/canvas/gestures.d.ts +46 -0
  170. package/dist/artifacts/renderers/canvas/gestures.d.ts.map +1 -0
  171. package/dist/artifacts/renderers/canvas/page-resize.d.ts +21 -0
  172. package/dist/artifacts/renderers/canvas/page-resize.d.ts.map +1 -0
  173. package/dist/artifacts/renderers/canvas/page-size-controls.d.ts +21 -0
  174. package/dist/artifacts/renderers/canvas/page-size-controls.d.ts.map +1 -0
  175. package/dist/artifacts/renderers/canvas/page-size.d.ts +93 -0
  176. package/dist/artifacts/renderers/canvas/page-size.d.ts.map +1 -0
  177. package/dist/artifacts/renderers/canvas/page-zoom.d.ts +64 -0
  178. package/dist/artifacts/renderers/canvas/page-zoom.d.ts.map +1 -0
  179. package/dist/artifacts/renderers/canvas/shown-size.d.ts +26 -0
  180. package/dist/artifacts/renderers/canvas/shown-size.d.ts.map +1 -0
  181. package/dist/artifacts/renderers/designed-document.d.ts +28 -0
  182. package/dist/artifacts/renderers/designed-document.d.ts.map +1 -0
  183. package/dist/artifacts/renderers/document-tree.d.ts +2 -0
  184. package/dist/artifacts/renderers/document-tree.d.ts.map +1 -1
  185. package/dist/artifacts/renderers/document.d.ts +9 -1
  186. package/dist/artifacts/renderers/document.d.ts.map +1 -1
  187. package/dist/artifacts/renderers/live-frame.d.ts +145 -0
  188. package/dist/artifacts/renderers/live-frame.d.ts.map +1 -0
  189. package/dist/artifacts/renderers/page-editor.d.ts +16 -0
  190. package/dist/artifacts/renderers/page-editor.d.ts.map +1 -0
  191. package/dist/artifacts/renderers/page.d.ts +10 -1
  192. package/dist/artifacts/renderers/page.d.ts.map +1 -1
  193. package/dist/artifacts/viewer.d.ts.map +1 -1
  194. package/dist/{chunk-001c4gnk.js → chunk-4fex83k2.js} +19965 -13027
  195. package/dist/chunk-4fex83k2.js.map +239 -0
  196. package/dist/{chunk-5crvhjp2.js → chunk-4wm09prf.js} +1633 -1999
  197. package/dist/chunk-4wm09prf.js.map +27 -0
  198. package/dist/{chunk-fwb9mxwm.js → chunk-5sgac68y.js} +1 -1
  199. package/dist/{chunk-kes4ygmz.js → chunk-69qgh20f.js} +1 -1
  200. package/dist/chunk-y51c4tsz.js +11 -0
  201. package/dist/chunk-y51c4tsz.js.map +10 -0
  202. package/dist/index.d.ts +4 -1
  203. package/dist/index.d.ts.map +1 -1
  204. package/dist/index.js +13 -6
  205. package/dist/index.js.map +5 -5
  206. package/dist/pages/console/data/messages.d.ts +6 -0
  207. package/dist/pages/console/data/messages.d.ts.map +1 -1
  208. package/dist/pages/console/data/shared.d.ts.map +1 -1
  209. package/dist/pages.js +12 -5
  210. package/dist/pages.js.map +6 -6
  211. package/dist/shell/search-command.d.ts.map +1 -1
  212. package/package.json +22 -5
  213. package/src/agent/activity-label.ts +9 -1
  214. package/src/agent/agent-chat.tsx +57 -37
  215. package/src/agent/agent-execution-trace.tsx +2 -2
  216. package/src/agent/agent-panel.tsx +6 -4
  217. package/src/agent/agent.css +254 -0
  218. package/src/agent/artifact-panel.tsx +77 -22
  219. package/src/agent/background/background-tool-row.tsx +24 -10
  220. package/src/agent/background/interpret.ts +60 -51
  221. package/src/agent/components/composer-settings.tsx +20 -10
  222. package/src/agent/components/composer.tsx +342 -104
  223. package/src/agent/components/context-meter.tsx +7 -3
  224. package/src/agent/components/conversation-panel.tsx +96 -37
  225. package/src/agent/components/message-parts.tsx +390 -64
  226. package/src/agent/components/message-view.tsx +12 -2
  227. package/src/agent/components/pending-messages.tsx +338 -0
  228. package/src/agent/components/sandbox-recovery.tsx +36 -17
  229. package/src/agent/components/threads-button.tsx +3 -2
  230. package/src/agent/components/transcript.tsx +92 -45
  231. package/src/agent/conversation.ts +203 -54
  232. package/src/agent/delegation/agent-exchange.tsx +53 -0
  233. package/src/agent/delegation/child-card.tsx +6 -40
  234. package/src/agent/delegation/child-parts.tsx +1 -84
  235. package/src/agent/delegation/child-work.tsx +19 -5
  236. package/src/agent/delegation/interpret.ts +64 -61
  237. package/src/agent/delegation/model.ts +1 -1
  238. package/src/agent/file-edits/file-edit-tool-view.tsx +126 -0
  239. package/src/agent/file-edits/interpret.ts +120 -0
  240. package/src/agent/hooks/use-agent-conversation.ts +360 -92
  241. package/src/agent/hooks/use-thread-stream.ts +10 -0
  242. package/src/agent/i18n/en.ts +134 -16
  243. package/src/agent/i18n/fr.ts +122 -16
  244. package/src/agent/inbox-handoff.ts +47 -0
  245. package/src/agent/live-run.ts +23 -2
  246. package/src/agent/message-agent/interpret.ts +4 -3
  247. package/src/agent/publish-artifact/interpret.ts +14 -5
  248. package/src/agent/publish-artifact/publish-artifact-tool-view.tsx +2 -2
  249. package/src/agent/questions/interpret.ts +90 -0
  250. package/src/agent/questions/question-card.tsx +57 -0
  251. package/src/agent/questions/question-composer.tsx +257 -0
  252. package/src/agent/react-router.tsx +2 -2
  253. package/src/agent/read/interpret.ts +34 -1
  254. package/src/agent/read/read-tool-view.tsx +20 -4
  255. package/src/agent/search/interpret.ts +367 -0
  256. package/src/agent/search/search-tool-view.tsx +235 -0
  257. package/src/agent/thread-state.ts +114 -0
  258. package/src/agent/tool-views/built-in.tsx +33 -6
  259. package/src/agent/tool-views/registry.tsx +28 -2
  260. package/src/agent/types.ts +7 -0
  261. package/src/agent/view-file/view-file-tool-view.tsx +33 -19
  262. package/src/agent/waits.ts +50 -0
  263. package/src/artifacts/artifacts.css +434 -0
  264. package/src/artifacts/card-preview.tsx +6 -1
  265. package/src/artifacts/edit-session.tsx +15 -1
  266. package/src/artifacts/editor/block-handle.tsx +278 -0
  267. package/src/artifacts/editor/blocks.ts +216 -0
  268. package/src/artifacts/editor/callout-view.tsx +31 -0
  269. package/src/artifacts/editor/document-editor.tsx +484 -0
  270. package/src/artifacts/editor/figure-view.tsx +66 -0
  271. package/src/artifacts/editor/find-blocks.ts +19 -0
  272. package/src/artifacts/editor/markdown-document.tsx +72 -0
  273. package/src/artifacts/editor/messages.ts +4 -0
  274. package/src/artifacts/editor/schema.ts +159 -0
  275. package/src/artifacts/editor/selection-toolbar.tsx +364 -0
  276. package/src/artifacts/editor/slash-menu.tsx +251 -0
  277. package/src/artifacts/editor/upload.ts +40 -0
  278. package/src/artifacts/file-source.ts +11 -0
  279. package/src/artifacts/frame-editor/bundle.ts +8 -0
  280. package/src/artifacts/frame-editor/commands.ts +565 -0
  281. package/src/artifacts/frame-editor/entry.ts +6 -0
  282. package/src/artifacts/frame-editor/frame.ts +847 -0
  283. package/src/artifacts/frame-editor/generated/editor.txt +149 -0
  284. package/src/artifacts/frame-editor/generated.d.ts +5 -0
  285. package/src/artifacts/frame-editor/keys.ts +323 -0
  286. package/src/artifacts/frame-editor/protocol.ts +151 -0
  287. package/src/artifacts/frame-editor/schema.ts +293 -0
  288. package/src/artifacts/frame-editor/style.ts +58 -0
  289. package/src/artifacts/frame.tsx +14 -5
  290. package/src/artifacts/live/boards.ts +46 -3
  291. package/src/artifacts/live/document.ts +89 -0
  292. package/src/artifacts/live/header.tsx +9 -14
  293. package/src/artifacts/live/presence.ts +5 -1
  294. package/src/artifacts/live/session.ts +4 -2
  295. package/src/artifacts/live/view.ts +14 -8
  296. package/src/artifacts/messages.ts +192 -2
  297. package/src/artifacts/pdf.ts +50 -0
  298. package/src/artifacts/references/references.tsx +46 -11
  299. package/src/artifacts/renderers/canvas/board-editor.tsx +44 -155
  300. package/src/artifacts/renderers/canvas/board.tsx +70 -8
  301. package/src/artifacts/renderers/canvas/canvas.tsx +66 -15
  302. package/src/artifacts/renderers/canvas/comment-pins.tsx +5 -0
  303. package/src/artifacts/renderers/canvas/comments-panel.tsx +58 -1
  304. package/src/artifacts/renderers/canvas/comments.ts +8 -4
  305. package/src/artifacts/renderers/canvas/controls.tsx +64 -30
  306. package/src/artifacts/renderers/canvas/focus.tsx +200 -56
  307. package/src/artifacts/renderers/canvas/gestures.ts +265 -0
  308. package/src/artifacts/renderers/canvas/page-resize.tsx +542 -0
  309. package/src/artifacts/renderers/canvas/page-size-controls.tsx +193 -0
  310. package/src/artifacts/renderers/canvas/page-size.ts +218 -0
  311. package/src/artifacts/renderers/canvas/page-zoom.ts +280 -0
  312. package/src/artifacts/renderers/canvas/shown-size.ts +105 -0
  313. package/src/artifacts/renderers/designed-document.tsx +277 -0
  314. package/src/artifacts/renderers/document-tree.ts +9 -0
  315. package/src/artifacts/renderers/document.tsx +13 -102
  316. package/src/artifacts/renderers/live-frame.ts +163 -0
  317. package/src/artifacts/renderers/page-editor.tsx +613 -0
  318. package/src/artifacts/renderers/page.tsx +21 -4
  319. package/src/artifacts/viewer.tsx +101 -41
  320. package/src/index.ts +8 -0
  321. package/src/pages/console/data/messages.ts +6 -0
  322. package/src/pages/console/data/projections.tsx +4 -0
  323. package/src/pages/console/data/shared.tsx +1 -0
  324. package/src/pages/console/ontology/lineage/trail.tsx +3 -0
  325. package/src/shell/search-command.tsx +2 -0
  326. package/dist/chunk-001c4gnk.js.map +0 -204
  327. package/dist/chunk-5crvhjp2.js.map +0 -28
  328. /package/dist/{chunk-fwb9mxwm.js.map → chunk-5sgac68y.js.map} +0 -0
  329. /package/dist/{chunk-kes4ygmz.js.map → chunk-69qgh20f.js.map} +0 -0
@@ -0,0 +1,105 @@
1
+ import { useCallback, useEffect, useMemo, useRef, useState } from "react"
2
+ import {
3
+ clampSize,
4
+ isScreen,
5
+ type PageSize,
6
+ type SizeName,
7
+ type SnappedSize,
8
+ sameSize,
9
+ sizeSuggestions,
10
+ } from "./page-size"
11
+
12
+ /** A common screen's width the reader chose, and whether each board shows its full page at it. */
13
+ interface Screen {
14
+ readonly w: number
15
+ readonly full: boolean
16
+ }
17
+
18
+ /**
19
+ * The size an opened board's page is shown at, for the reader alone, while the boards are open.
20
+ *
21
+ * A size set on a board stays on it as the reader steps through the others. A common screen's
22
+ * width, picked or snapped to, carries to them: each is shown at it, at its own board's height, or
23
+ * its full page once the reader chose that, so a flow is walked at a phone's width. Back to board
24
+ * size puts every board back.
25
+ */
26
+ export function useShownSize(id: string, own: PageSize) {
27
+ const [sizes, setSizes] = useState<Readonly<Record<string, PageSize>>>({})
28
+ const [screen, setScreen] = useState<Screen | null>(null)
29
+ // Each board's page height, as its frame reports it at the width shown.
30
+ const [heights, setHeights] = useState<Readonly<Record<string, number>>>({})
31
+
32
+ const height = heights[id] ?? null
33
+ const suggestions = useMemo(() => sizeSuggestions(own, height), [own, height])
34
+ const chosen =
35
+ sizes[id] ??
36
+ (screen
37
+ ? clampSize(
38
+ { w: screen.w, h: screen.full && height !== null ? height : own.h },
39
+ suggestions.least
40
+ )
41
+ : null)
42
+ const shown = chosen && !sameSize(chosen, own) ? chosen : own
43
+
44
+ const onContentHeight = useCallback(
45
+ (next: number) => setHeights((last) => (last[id] === next ? last : { ...last, [id]: next })),
46
+ [id]
47
+ )
48
+
49
+ /** A size laid out on this board, as a resize goes. */
50
+ const resize = useCallback(
51
+ (size: PageSize) => setSizes((last) => ({ ...last, [id]: size })),
52
+ [id]
53
+ )
54
+
55
+ /**
56
+ * A size set on this board: a common screen's width carries to the others, and `full`, when
57
+ * given, says whether they show their full page at it.
58
+ */
59
+ const set = (size: PageSize, name: SizeName | null, full: boolean | null) => {
60
+ if (name !== null && isScreen(name)) {
61
+ setSizes({ [id]: size })
62
+ setScreen({ w: size.w, full: full ?? screen?.full ?? false })
63
+ return
64
+ }
65
+ resize(size)
66
+ if (screen && full !== null) setScreen({ ...screen, full })
67
+ }
68
+
69
+ // A size kept as the board's is no longer one of the reader's once the board has it: should
70
+ // the board change again, as with Undo, it shows as it is.
71
+ const keeping = useRef<{ readonly id: string; readonly size: PageSize } | null>(null)
72
+ useEffect(() => {
73
+ const kept = keeping.current
74
+ if (!kept || kept.id !== id || !sameSize(kept.size, own)) return
75
+
76
+ keeping.current = null
77
+ setSizes(({ [id]: _, ...others }) => others)
78
+ }, [id, own])
79
+
80
+ return {
81
+ shown,
82
+ resized: shown !== own,
83
+ suggestions,
84
+ /** The page's height as its frame reports it. */
85
+ onContentHeight,
86
+ resize,
87
+ /** A size picked from the menu. */
88
+ pick: (size: PageSize, name: SizeName) =>
89
+ set(size, name, name === "full" ? true : isScreen(name) ? false : null),
90
+ /** A resize ended, at what it snapped to: a free one stays on this board. */
91
+ settle: (snapped: SnappedSize) => {
92
+ const width = snapped.w && isScreen(snapped.w.name) ? snapped.w.name : null
93
+ set(snapped.size, width, snapped.h ? snapped.h.name === "full" : null)
94
+ },
95
+ /** Back to the board's size: every board's, and no screen's width carried any more. */
96
+ reset: () => {
97
+ setSizes({})
98
+ setScreen(null)
99
+ },
100
+ /** The size shown was kept as the board's. */
101
+ keep: () => {
102
+ keeping.current = { id, size: shown }
103
+ },
104
+ }
105
+ }
@@ -0,0 +1,277 @@
1
+ import type { FrameEditTarget, FrameEmbed, FrameEvent } from "@sixb/core/artifacts"
2
+ import { mergeBoardText } from "@sixb/core/artifacts/live"
3
+ import { isMobileViewport, useIsMobile } from "@sixb/ui/hooks"
4
+ import { cn } from "@sixb/ui/lib/utils"
5
+ import { type ReactNode, useCallback, useEffect, useRef, useState } from "react"
6
+ import { useArtifactEditing } from "../edit-session"
7
+ import { ArtifactFrame, type ArtifactFrameHandle } from "../frame"
8
+ import { FrameEmbeds } from "../frame-embeds"
9
+ import { useLiveBoardSource, useLivePageHeld } from "../live/boards"
10
+ import { liveDocumentOf } from "../live/document"
11
+ import { useLiveArtifactState, useViewerLiveArtifact } from "../live/hooks"
12
+ import type { LiveArtifact } from "../live/session"
13
+ import { useArtifactMessages } from "../messages"
14
+ import { type ArtifactVersion, useFileText, versionFileSource } from "../queries"
15
+ import { useArtifactThemeAttributes } from "../theme"
16
+ import { useFrameEditing, useLiveFrame } from "./live-frame"
17
+ import { ViewerLoading, ViewerNotice } from "./notice"
18
+ import { FrameScreen, usePageEvents } from "./page"
19
+ import { PageEditor } from "./page-editor"
20
+
21
+ /** How wide a designed document draws without paper: a Letter sheet's width. */
22
+ const SHEET_WIDTH = 816
23
+
24
+ /** Whether a version is a designed document, `document.html` with its own stylesheets. */
25
+ export function isDesignedDocument(version: Pick<ArtifactVersion, "outline">): boolean {
26
+ return version.outline.kind === "document" && version.outline.format === "html"
27
+ }
28
+
29
+ /**
30
+ * A designed document: its `document.html` in a sandboxed frame, styled by its own stylesheets.
31
+ * With paper, it shows as the pages it prints on. A phone shows those too small to read, so there
32
+ * it is one sheet whose text wraps to the screen, with a gap where each page breaks. The view
33
+ * follows the window across that width; there is nothing to choose. The artifacts it embeds are
34
+ * drawn over it where it puts them.
35
+ *
36
+ * Held live and edited, it is one sheet the reader edits in place, for everyone at once: as a page
37
+ * of notes, block by block, when the live document holds it as blocks (./page-editor.tsx); else
38
+ * its words, element by element. Once they are done, it stays that sheet until the stored version
39
+ * holds their changes, then shows its pages again.
40
+ */
41
+ export function DesignedDocumentRenderer({
42
+ version,
43
+ part,
44
+ }: {
45
+ readonly version: ArtifactVersion
46
+ /** The section to open at, by its slug. */
47
+ readonly part?: string
48
+ }) {
49
+ const live = useViewerLiveArtifact()
50
+ const state = useLiveArtifactState(live)
51
+ const editing = useArtifactEditing()
52
+ const held = live && state.synced && !state.left ? live : null
53
+ const typing = editing && state.access === "edit" ? held : null
54
+ const settling = useSettling(version, held, typing !== null)
55
+ // A page held as blocks is edited with the editor in its frame; one held as text, as a board is.
56
+ const blocks = useLivePageHeld(held, version.entry)
57
+ const shown = typing ?? settling
58
+
59
+ return (
60
+ <DocumentStage version={version}>
61
+ {shown && blocks ? (
62
+ <PageEditor version={version} live={shown} editable={typing !== null} />
63
+ ) : typing ? (
64
+ <DocumentEditor version={version} live={typing} typing />
65
+ ) : settling ? (
66
+ <DocumentEditor version={version} live={settling} typing={false} />
67
+ ) : (
68
+ <DocumentReader version={version} {...(part ? { part } : {})} />
69
+ )}
70
+ </DocumentStage>
71
+ )
72
+ }
73
+
74
+ /** The artifact's theme around whichever frame shows the document. */
75
+ function DocumentStage({
76
+ version,
77
+ children,
78
+ }: {
79
+ readonly version: ArtifactVersion
80
+ readonly children: ReactNode
81
+ }) {
82
+ const theme = useArtifactThemeAttributes(version)
83
+ return (
84
+ <div
85
+ data-sixb-artifact=""
86
+ className={cn("flex min-h-0 flex-1 flex-col bg-background", theme.className)}
87
+ style={theme.style}
88
+ >
89
+ {children}
90
+ </div>
91
+ )
92
+ }
93
+
94
+ /**
95
+ * The live artifact while the stored version does not yet hold what the reader typed, from the
96
+ * moment they stop editing; null otherwise. Their words are written back a moment after they
97
+ * stop, and the version that holds them arrives after that.
98
+ */
99
+ function useSettling(
100
+ version: ArtifactVersion,
101
+ live: LiveArtifact | null,
102
+ typing: boolean
103
+ ): LiveArtifact | null {
104
+ const [settling, setSettling] = useState(false)
105
+ // Set as the render that ends typing is made, so the pages never show in between.
106
+ const [typed, setTyped] = useState(typing)
107
+ if (typed !== typing) {
108
+ setTyped(typing)
109
+ setSettling(!typing)
110
+ }
111
+
112
+ const following = settling ? live : null
113
+ const source = useLiveBoardSource(following, version.entry)
114
+ const stored = useFileText(following ? versionFileSource(version, version.entry) : null).text
115
+ const caughtUp = source === null || (stored !== undefined && stored === source)
116
+ useEffect(() => {
117
+ if (settling && caughtUp) setSettling(false)
118
+ }, [settling, caughtUp])
119
+
120
+ return following && !caughtUp ? following : null
121
+ }
122
+
123
+ /** The document as a reader opens it: its pages, or one sheet on a phone. */
124
+ function DocumentReader({
125
+ version,
126
+ part,
127
+ }: {
128
+ readonly version: ArtifactVersion
129
+ readonly part?: string
130
+ }) {
131
+ const messages = useArtifactMessages()
132
+ const frame = useRef<ArtifactFrameHandle | null>(null)
133
+ // The hook answers false until its effect runs, so the first render reads the width itself.
134
+ const phone = useIsMobile() || isMobileViewport()
135
+ const pages = version.outline.kind === "document" && !!version.outline.paper && !phone
136
+ const [embeds, setEmbeds] = useState<readonly FrameEmbed[]>([])
137
+ // The embeds a view reported are placed for its layout, not the next one's.
138
+ const [laidOut, setLaidOut] = useState(pages)
139
+ if (laidOut !== pages) {
140
+ setLaidOut(pages)
141
+ setEmbeds([])
142
+ }
143
+ const onEvent = usePageEvents(version, { onEmbeds: setEmbeds })
144
+ const scroll = useCallback((delta: { readonly x: number; readonly y: number }) => {
145
+ frame.current?.send("scroll", delta).catch(() => {})
146
+ }, [])
147
+
148
+ return (
149
+ <ArtifactFrame
150
+ handle={frame}
151
+ version={version}
152
+ title={messages.document.frame(version.title)}
153
+ start={{ pages, ...(part ? { section: part } : {}) }}
154
+ onEvent={onEvent}
155
+ className="flex-1"
156
+ fallback={<ViewerLoading label={messages.viewer.loading} />}
157
+ failure={<ViewerNotice title={messages.document.loadFailed} />}
158
+ overlay={<FrameEmbeds version={version} embeds={embeds} onScroll={scroll} />}
159
+ />
160
+ )
161
+ }
162
+
163
+ /**
164
+ * The document as one sheet that follows its live document, element by element, as
165
+ * ../live-frame.ts describes. Typing, a click on a text element puts the caret in it, and what
166
+ * the reader types is written into `document.html` for everyone, under their own undo.
167
+ */
168
+ function DocumentEditor({
169
+ version,
170
+ live,
171
+ typing,
172
+ }: {
173
+ readonly version: ArtifactVersion
174
+ readonly live: LiveArtifact
175
+ readonly typing: boolean
176
+ }) {
177
+ const messages = useArtifactMessages()
178
+ const file = version.entry
179
+ const editor = liveDocumentOf(live)
180
+ const frame = useLiveFrame({ version, file, live })
181
+ const [embeds, setEmbeds] = useState<readonly FrameEmbed[]>([])
182
+ const pageEvents = usePageEvents(frame.shows, { onEmbeds: setEmbeds })
183
+ const [selected, setSelected] = useState<FrameEditTarget | null>(null)
184
+ // The element picked, as the event handler reads it: what the frame says the reader typed is
185
+ // taken only for it, and nothing while the frame's elements are not the document's.
186
+ const picked = useRef<FrameEditTarget | null>(null)
187
+ picked.current = typing ? selected : null
188
+ const moved = useRef(frame.moved)
189
+ moved.current = frame.moved
190
+
191
+ // While the reader types in it, the frame keeps the version it loaded.
192
+ const { hold } = frame
193
+ useEffect(() => {
194
+ hold(typing && selected?.kind === "text")
195
+ }, [hold, typing, selected])
196
+
197
+ // Once the frame's elements no longer match the document's, nothing stays picked: its address
198
+ // may name another element now.
199
+ useEffect(() => {
200
+ if (!typing || frame.moved) {
201
+ picked.current = null
202
+ setSelected(null)
203
+ }
204
+ }, [typing, frame.moved])
205
+
206
+ const onEdit = (event: FrameEvent) => {
207
+ if (moved.current || !typing) return
208
+ if (event.event === "edit.select") {
209
+ // Typing in another element is a step of its own for undo.
210
+ editor.stopCapturing()
211
+ picked.current = event.params.target
212
+ setSelected(event.params.target)
213
+ return
214
+ }
215
+ if (event.event !== "edit.text") return
216
+
217
+ // Only the words of the element the reader picked, a text, are taken.
218
+ const chosen = picked.current
219
+ const { address, base, text } = event.params
220
+ if (chosen?.kind !== "text" || chosen.address !== address) return
221
+ try {
222
+ editor.editFile(file, (source) => mergeBoardText(source, address, base, text))
223
+ } catch {
224
+ // The element is no longer text there: the document changed under the reader.
225
+ picked.current = null
226
+ setSelected(null)
227
+ frame.resync()
228
+ }
229
+ }
230
+ useFrameEditing({ frame, on: typing, typing, onEdit })
231
+
232
+ const onEvent = useCallback(
233
+ (event: FrameEvent) => {
234
+ if (event.event === "ready") {
235
+ picked.current = null
236
+ setSelected(null)
237
+ frame.ready()
238
+ }
239
+ pageEvents(event)
240
+ },
241
+ [frame, pageEvents]
242
+ )
243
+ const scroll = useCallback(
244
+ (delta: { readonly x: number; readonly y: number }) => {
245
+ frame.handle.current?.send("scroll", delta).catch(() => {})
246
+ },
247
+ [frame.handle]
248
+ )
249
+
250
+ return (
251
+ <ArtifactFrame
252
+ handle={frame.handle}
253
+ version={frame.shows}
254
+ title={messages.document.frame(version.title)}
255
+ editable
256
+ onEvent={onEvent}
257
+ className="flex-1"
258
+ fallback={<ViewerLoading label={messages.viewer.loading} />}
259
+ failure={<ViewerNotice title={messages.document.loadFailed} />}
260
+ overlay={<FrameEmbeds version={frame.shows} embeds={embeds} onScroll={scroll} />}
261
+ />
262
+ )
263
+ }
264
+
265
+ /**
266
+ * A designed document's first page, live and scaled down to its card: as a sheet of its paper
267
+ * when it has one, else the top of its one sheet.
268
+ */
269
+ export function DesignedDocumentScreen({ version }: { readonly version: ArtifactVersion }) {
270
+ const paper = version.outline.kind === "document" ? version.outline.paper : undefined
271
+ // The stage's padding on either side of the sheet, as the kit lays pages out.
272
+ return paper ? (
273
+ <FrameScreen version={version} width={paper.width + 32} start={{ pages: true }} />
274
+ ) : (
275
+ <FrameScreen version={version} width={SHEET_WIDTH + 64} />
276
+ )
277
+ }
@@ -34,6 +34,15 @@ export function rehypeArtifactDocument() {
34
34
  }
35
35
  }
36
36
 
37
+ /** Turns `> [!NOTE]` (and TIP, IMPORTANT, WARNING, CAUTION) quotes into callout asides. */
38
+ export function rehypeCallouts() {
39
+ return (tree: TreeRoot) => {
40
+ visitElements(tree, (element) => {
41
+ if (element.tagName === "blockquote") shapeCallout(element)
42
+ })
43
+ }
44
+ }
45
+
37
46
  function markTitleAndLede(tree: TreeRoot): void {
38
47
  const elements = tree.children.filter(isElement)
39
48
  const [first, second] = elements
@@ -8,15 +8,7 @@ import {
8
8
  MessageSquareWarning,
9
9
  OctagonAlert,
10
10
  } from "lucide-react"
11
- import {
12
- type ComponentProps,
13
- type ReactNode,
14
- useCallback,
15
- useEffect,
16
- useMemo,
17
- useRef,
18
- useState,
19
- } from "react"
11
+ import { type ComponentProps, type ReactNode, useCallback, useEffect, useMemo, useRef } from "react"
20
12
  import { useCopyFeedback } from "../copy-feedback"
21
13
  import { type ArtifactMessages, useArtifactMessages } from "../messages"
22
14
  import {
@@ -40,7 +32,7 @@ const REHYPE_PLUGINS: MarkdownProps["rehypePlugins"] = [
40
32
 
41
33
  /**
42
34
  * A document as a page to read: its title and lede, a measured column, figures with captions,
43
- * callouts, and an outline that follows the reader. It draws only on theme tokens, so the app's
35
+ * and callouts. It draws only on theme tokens, so the app's
44
36
  * theme, dark mode, and the artifact's own `theme.json` all apply.
45
37
  */
46
38
  export function DocumentRenderer({
@@ -59,14 +51,6 @@ export function DocumentRenderer({
59
51
  const file = useFileText(source)
60
52
  const theme = useArtifactThemeAttributes(version)
61
53
  const scrollRef = useRef<HTMLDivElement | null>(null)
62
- const headings = useMemo(
63
- () =>
64
- version.outline.kind === "document"
65
- ? version.outline.headings.filter((heading) => heading.depth === 2 || heading.depth === 3)
66
- : [],
67
- [version.outline]
68
- )
69
- const activeSlug = useActiveHeading(scrollRef, headings, file.text)
70
54
 
71
55
  const scrollToSection = useCallback((slug: string) => {
72
56
  const heading = scrollRef.current?.querySelector(`[id="${CSS.escape(slug)}"]`)
@@ -104,93 +88,20 @@ export function DocumentRenderer({
104
88
  )}
105
89
  style={theme.style}
106
90
  >
107
- <div className="mx-auto flex w-full max-w-[66rem] gap-14 px-6 py-10 @lg:px-12 @lg:py-14">
108
- <article className="min-w-0 flex-1">
109
- <Markdown
110
- className="sixb-document"
111
- components={components}
112
- rehypePlugins={REHYPE_PLUGINS}
113
- urlTransform={artifactUrlTransform}
114
- >
115
- {file.text}
116
- </Markdown>
117
- </article>
118
- {headings.length > 1 ? (
119
- <nav
120
- aria-label={messages.document.outline}
121
- className="sticky top-14 hidden w-48 shrink-0 self-start @4xl:block"
122
- >
123
- <p className="mb-3 text-xs font-semibold text-muted-foreground">
124
- {messages.document.outline}
125
- </p>
126
- <ol className="flex flex-col gap-2 text-[13px] leading-snug">
127
- {headings.map((heading) => (
128
- <li key={heading.slug} className={heading.depth === 3 ? "pl-3" : undefined}>
129
- <a
130
- href={`#${heading.slug}`}
131
- onClick={(event) => {
132
- event.preventDefault()
133
- scrollToSection(heading.slug)
134
- }}
135
- aria-current={activeSlug === heading.slug ? "location" : undefined}
136
- className={cn(
137
- "block transition-colors hover:text-foreground",
138
- activeSlug === heading.slug
139
- ? "font-medium text-foreground"
140
- : "text-muted-foreground"
141
- )}
142
- >
143
- {heading.text}
144
- </a>
145
- </li>
146
- ))}
147
- </ol>
148
- </nav>
149
- ) : null}
91
+ <div className="sixb-document-page">
92
+ <Markdown
93
+ className="sixb-document"
94
+ components={components}
95
+ rehypePlugins={REHYPE_PLUGINS}
96
+ urlTransform={artifactUrlTransform}
97
+ >
98
+ {file.text}
99
+ </Markdown>
150
100
  </div>
151
101
  </div>
152
102
  )
153
103
  }
154
104
 
155
- /**
156
- * The section the reader is in: the last heading that has scrolled past the reading line. The
157
- * document scrolls itself when its host gives it a height, and scrolls with the page when the host
158
- * lets it grow, so this follows whichever element scrolls.
159
- */
160
- function useActiveHeading(
161
- scrollRef: { readonly current: HTMLDivElement | null },
162
- headings: readonly { readonly slug: string }[],
163
- content: string | undefined
164
- ): string | null {
165
- const [active, setActive] = useState<string | null>(null)
166
- useEffect(() => {
167
- const container = scrollRef.current
168
- if (!container || content === undefined || headings.length === 0) return
169
- let frame = 0
170
- const update = () => {
171
- frame = 0
172
- const top = Math.max(container.getBoundingClientRect().top, 0) + 96
173
- let current: string | null = headings[0]?.slug ?? null
174
- for (const heading of headings) {
175
- const element = container.querySelector(`[id="${CSS.escape(heading.slug)}"]`)
176
- if (element && element.getBoundingClientRect().top <= top) current = heading.slug
177
- }
178
- setActive(current)
179
- }
180
- const schedule = () => {
181
- if (!frame) frame = requestAnimationFrame(update)
182
- }
183
- update()
184
- // Scroll events do not bubble; capturing at the document sees every scrolling element.
185
- document.addEventListener("scroll", schedule, { capture: true, passive: true })
186
- return () => {
187
- document.removeEventListener("scroll", schedule, { capture: true })
188
- if (frame) cancelAnimationFrame(frame)
189
- }
190
- }, [scrollRef, headings, content])
191
- return active
192
- }
193
-
194
105
  export function documentComponents(
195
106
  version: ArtifactVersion,
196
107
  latestVersion: number,
@@ -302,7 +213,7 @@ const CALLOUT_ICONS: Record<CalloutKind, typeof Info> = {
302
213
  caution: OctagonAlert,
303
214
  }
304
215
 
305
- function Callout({
216
+ export function Callout({
306
217
  kind,
307
218
  label,
308
219
  children,
@@ -329,6 +240,6 @@ function headingText(version: ArtifactVersion, slug: string): string {
329
240
  return headings.find((heading) => heading.slug === slug)?.text ?? slug
330
241
  }
331
242
 
332
- function isCalloutKind(value: unknown): value is CalloutKind {
243
+ export function isCalloutKind(value: unknown): value is CalloutKind {
333
244
  return typeof value === "string" && (CALLOUT_KINDS as readonly string[]).includes(value)
334
245
  }