@arnilo/prism-tools 0.0.0-stage → 0.13.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 (331) hide show
  1. package/CHANGELOG.md +410 -0
  2. package/LICENSE +21 -0
  3. package/README.md +44 -2
  4. package/browser/README.md +98 -0
  5. package/browser/skills/browser-automation/SKILL.md +14 -0
  6. package/browser/src/actions/cdp.ts +131 -0
  7. package/browser/src/actions/dialog.ts +25 -0
  8. package/browser/src/actions/download_release.ts +22 -0
  9. package/browser/src/actions/index.ts +37 -0
  10. package/browser/src/actions/locator.ts +70 -0
  11. package/browser/src/actions/navigate.ts +23 -0
  12. package/browser/src/actions/screenshot.ts +27 -0
  13. package/browser/src/actions/scroll.ts +24 -0
  14. package/browser/src/actions/select_page.ts +21 -0
  15. package/browser/src/actions/types.ts +114 -0
  16. package/browser/src/actions/upload.ts +44 -0
  17. package/browser/src/actions/wait.ts +45 -0
  18. package/browser/src/browser.ts +197 -0
  19. package/browser/src/cdp.ts +178 -0
  20. package/browser/src/checkpoint.ts +189 -0
  21. package/browser/src/config.ts +72 -0
  22. package/browser/src/downloads.ts +253 -0
  23. package/browser/src/errors.ts +31 -0
  24. package/browser/src/evaluate.ts +101 -0
  25. package/browser/src/index.ts +129 -0
  26. package/browser/src/limits.ts +271 -0
  27. package/browser/src/manager.ts +730 -0
  28. package/browser/src/network.ts +263 -0
  29. package/browser/src/observe.ts +178 -0
  30. package/browser/src/policy.ts +133 -0
  31. package/browser/src/screenshot.ts +107 -0
  32. package/browser/src/shared-sandbox.ts +53 -0
  33. package/browser/src/snapshot.ts +99 -0
  34. package/browser/src/targets.ts +165 -0
  35. package/browser/src/tools.ts +480 -0
  36. package/browser/src/types.ts +316 -0
  37. package/browser/src/uploads.ts +174 -0
  38. package/coding/README.md +337 -0
  39. package/coding/src/agent/acp-operations.ts +146 -0
  40. package/coding/src/agent/artifacts.ts +38 -0
  41. package/coding/src/agent/ask-user-decision.ts +623 -0
  42. package/coding/src/agent/atomic-write.ts +23 -0
  43. package/coding/src/agent/bounded-file.ts +21 -0
  44. package/coding/src/agent/checks.ts +301 -0
  45. package/coding/src/agent/coding-checkpoint.ts +828 -0
  46. package/coding/src/agent/delete.ts +237 -0
  47. package/coding/src/agent/diagnostics-tool.ts +163 -0
  48. package/coding/src/agent/diagnostics.ts +262 -0
  49. package/coding/src/agent/edit-diff.ts +382 -0
  50. package/coding/src/agent/edit.ts +322 -0
  51. package/coding/src/agent/effects.ts +102 -0
  52. package/coding/src/agent/env.ts +28 -0
  53. package/coding/src/agent/execution-policy.ts +89 -0
  54. package/coding/src/agent/file-mutation-queue.ts +72 -0
  55. package/coding/src/agent/forge/github.ts +603 -0
  56. package/coding/src/agent/forge/index.ts +16 -0
  57. package/coding/src/agent/forge/types.ts +185 -0
  58. package/coding/src/agent/git-aware-repository.ts +305 -0
  59. package/coding/src/agent/git-exec.ts +326 -0
  60. package/coding/src/agent/git-status.ts +177 -0
  61. package/coding/src/agent/git-tools.ts +360 -0
  62. package/coding/src/agent/git.ts +1074 -0
  63. package/coding/src/agent/glob-match.ts +146 -0
  64. package/coding/src/agent/glob.ts +182 -0
  65. package/coding/src/agent/goal-verify.ts +385 -0
  66. package/coding/src/agent/grep-worker.ts +74 -0
  67. package/coding/src/agent/grep.ts +459 -0
  68. package/coding/src/agent/identity.ts +48 -0
  69. package/coding/src/agent/index.ts +676 -0
  70. package/coding/src/agent/language/client.ts +429 -0
  71. package/coding/src/agent/language/framing.ts +190 -0
  72. package/coding/src/agent/language/index.ts +23 -0
  73. package/coding/src/agent/language/intelligence.ts +682 -0
  74. package/coding/src/agent/language/types.ts +187 -0
  75. package/coding/src/agent/lifecycle-events.ts +121 -0
  76. package/coding/src/agent/lifecycle.ts +166 -0
  77. package/coding/src/agent/limits.ts +214 -0
  78. package/coding/src/agent/move.ts +178 -0
  79. package/coding/src/agent/mutation-path.ts +52 -0
  80. package/coding/src/agent/output-accumulator.ts +304 -0
  81. package/coding/src/agent/path-utils.ts +120 -0
  82. package/coding/src/agent/process/index.ts +58 -0
  83. package/coding/src/agent/process/recovery.ts +508 -0
  84. package/coding/src/agent/process/sessions-host.ts +222 -0
  85. package/coding/src/agent/process/sessions-monitor.ts +141 -0
  86. package/coding/src/agent/process/sessions-recovery.ts +241 -0
  87. package/coding/src/agent/process/sessions-spawn.ts +613 -0
  88. package/coding/src/agent/process/sessions-teardown.ts +281 -0
  89. package/coding/src/agent/process/sessions.ts +30 -0
  90. package/coding/src/agent/process/types.ts +358 -0
  91. package/coding/src/agent/read-path-set.ts +126 -0
  92. package/coding/src/agent/read.ts +713 -0
  93. package/coding/src/agent/repository/glob.ts +147 -0
  94. package/coding/src/agent/repository/indexed-search.ts +480 -0
  95. package/coding/src/agent/repository/list.ts +131 -0
  96. package/coding/src/agent/repository/operations.ts +22 -0
  97. package/coding/src/agent/repository/path.ts +98 -0
  98. package/coding/src/agent/repository/search.ts +277 -0
  99. package/coding/src/agent/repository/types.ts +243 -0
  100. package/coding/src/agent/repository/walk.ts +126 -0
  101. package/coding/src/agent/repository.ts +12 -0
  102. package/coding/src/agent/shell-background.ts +264 -0
  103. package/coding/src/agent/shell-output.ts +75 -0
  104. package/coding/src/agent/shell.ts +526 -0
  105. package/coding/src/agent/todo.ts +399 -0
  106. package/coding/src/agent/truncate.ts +251 -0
  107. package/coding/src/agent/write.ts +170 -0
  108. package/coding/src/ask-user-host.ts +48 -0
  109. package/coding/src/config.ts +278 -0
  110. package/coding/src/hard-deny.ts +97 -0
  111. package/coding/src/index.ts +318 -0
  112. package/coding/src/principal-guard.ts +84 -0
  113. package/coding/src/sandbox.ts +92 -0
  114. package/coding/src/security/approval.ts +144 -0
  115. package/coding/src/security/command-rules.ts +57 -0
  116. package/coding/src/security/docker-cli.ts +222 -0
  117. package/coding/src/security/docker-sandbox.ts +1205 -0
  118. package/coding/src/security/e2b-sandbox.ts +853 -0
  119. package/coding/src/security/egress/dns-pin.ts +88 -0
  120. package/coding/src/security/egress/index.ts +32 -0
  121. package/coding/src/security/egress/limits.ts +57 -0
  122. package/coding/src/security/egress/policy.ts +137 -0
  123. package/coding/src/security/egress/proxy.ts +599 -0
  124. package/coding/src/security/egress/types.ts +30 -0
  125. package/coding/src/security/index.ts +199 -0
  126. package/coding/src/security/native-sandbox.ts +639 -0
  127. package/coding/src/security/path-containment.ts +55 -0
  128. package/coding/src/security/sandbox-coding-operations.ts +392 -0
  129. package/coding/src/security/sandbox-fs-operations.ts +644 -0
  130. package/coding/src/security/sandbox-limits.ts +147 -0
  131. package/coding/src/security/sandbox-tar.ts +308 -0
  132. package/coding/src/security/sandbox.ts +179 -0
  133. package/coding/src/security/semaphore.ts +55 -0
  134. package/coding/src/targets.ts +110 -0
  135. package/coding/src/workspace/diff.ts +78 -0
  136. package/coding/src/workspace/errors.ts +28 -0
  137. package/coding/src/workspace/index.ts +5 -0
  138. package/coding/src/workspace/merge.ts +151 -0
  139. package/coding/src/workspace/routing.ts +76 -0
  140. package/coding/src/workspace/service.ts +545 -0
  141. package/computer-use/README.md +105 -0
  142. package/computer-use/skills/computer-use-linux/SKILL.md +17 -0
  143. package/computer-use/src/classify.ts +53 -0
  144. package/computer-use/src/command.ts +29 -0
  145. package/computer-use/src/config.ts +69 -0
  146. package/computer-use/src/create.ts +170 -0
  147. package/computer-use/src/devices.ts +247 -0
  148. package/computer-use/src/env.ts +28 -0
  149. package/computer-use/src/index.ts +157 -0
  150. package/computer-use/src/skill.ts +21 -0
  151. package/openapi/README.md +97 -0
  152. package/openapi/src/compile.ts +386 -0
  153. package/openapi/src/config.ts +73 -0
  154. package/openapi/src/errors.ts +16 -0
  155. package/openapi/src/execute.ts +241 -0
  156. package/openapi/src/index.ts +124 -0
  157. package/openapi/src/limits.ts +63 -0
  158. package/openapi/src/specs.ts +86 -0
  159. package/openapi/src/tools.ts +60 -0
  160. package/openapi/src/types.ts +61 -0
  161. package/package.json +171 -4
  162. package/research/README.md +72 -0
  163. package/research/skills/research-report/SKILL.md +12 -0
  164. package/research/skills/research-scoping/SKILL.md +10 -0
  165. package/research/skills/research-synthesis/SKILL.md +10 -0
  166. package/research/skills/source-triage/SKILL.md +10 -0
  167. package/research/src/check.ts +71 -0
  168. package/research/src/config.ts +41 -0
  169. package/research/src/index.ts +147 -0
  170. package/research/src/ledger.ts +157 -0
  171. package/research/src/urls.ts +21 -0
  172. package/web/README.md +287 -0
  173. package/web/skills/web-research/SKILL.md +17 -0
  174. package/web/src/brave.ts +66 -0
  175. package/web/src/cache.ts +151 -0
  176. package/web/src/config.ts +210 -0
  177. package/web/src/controls.ts +128 -0
  178. package/web/src/domains.ts +114 -0
  179. package/web/src/exa.ts +60 -0
  180. package/web/src/firecrawl.ts +160 -0
  181. package/web/src/index.ts +387 -0
  182. package/web/src/kagi.ts +73 -0
  183. package/web/src/limits.ts +55 -0
  184. package/web/src/native/convert.ts +84 -0
  185. package/web/src/native/fetch.ts +226 -0
  186. package/web/src/normalize.ts +131 -0
  187. package/web/src/obscura/cdp.ts +201 -0
  188. package/web/src/obscura/classify.ts +35 -0
  189. package/web/src/obscura/cli.ts +254 -0
  190. package/web/src/obscura/errors.ts +8 -0
  191. package/web/src/obscura/index.ts +59 -0
  192. package/web/src/obscura/limits.ts +92 -0
  193. package/web/src/obscura/mcp.ts +104 -0
  194. package/web/src/obscura/playwright.ts +133 -0
  195. package/web/src/obscura/process.ts +235 -0
  196. package/web/src/obscura/search-profile.ts +73 -0
  197. package/web/src/obscura/types.ts +48 -0
  198. package/web/src/obscura/web.ts +419 -0
  199. package/web/src/prompt-fetch.ts +88 -0
  200. package/web/src/render.ts +75 -0
  201. package/web/src/searxng.ts +78 -0
  202. package/web/src/slice.ts +139 -0
  203. package/web/src/tavily.ts +77 -0
  204. package/web/src/tools.ts +182 -0
  205. package/web/src/transport.ts +310 -0
  206. package/web/src/types.ts +199 -0
  207. package/work/README.md +77 -0
  208. package/work/THIRD_PARTY_NOTICES +24 -0
  209. package/work/docling/ocr.py +150 -0
  210. package/work/sandbox/Dockerfile +36 -0
  211. package/work/sandbox/soffice.sh +12 -0
  212. package/work/src/command.ts +29 -0
  213. package/work/src/config.ts +138 -0
  214. package/work/src/connectors/cli.ts +343 -0
  215. package/work/src/connectors/drafts.ts +647 -0
  216. package/work/src/connectors/errors.ts +8 -0
  217. package/work/src/connectors/file-bytes.ts +149 -0
  218. package/work/src/connectors/google-workspace-http.ts +399 -0
  219. package/work/src/connectors/google-workspace.ts +465 -0
  220. package/work/src/connectors/gws-tools.ts +378 -0
  221. package/work/src/connectors/http.ts +123 -0
  222. package/work/src/connectors/idempotency.ts +235 -0
  223. package/work/src/connectors/identity.ts +34 -0
  224. package/work/src/connectors/index.ts +93 -0
  225. package/work/src/connectors/limits.ts +50 -0
  226. package/work/src/connectors/m365-tools.ts +308 -0
  227. package/work/src/connectors/microsoft365-http.ts +428 -0
  228. package/work/src/connectors/microsoft365.ts +402 -0
  229. package/work/src/connectors/normalize.ts +120 -0
  230. package/work/src/connectors/tool-helpers.ts +398 -0
  231. package/work/src/connectors/tools.ts +42 -0
  232. package/work/src/connectors/types.ts +399 -0
  233. package/work/src/diagrams/canonicalize.ts +166 -0
  234. package/work/src/diagrams/caps.ts +52 -0
  235. package/work/src/diagrams/embed.ts +340 -0
  236. package/work/src/diagrams/errors.ts +76 -0
  237. package/work/src/diagrams/index.ts +81 -0
  238. package/work/src/diagrams/messages.ts +150 -0
  239. package/work/src/diagrams/origin.ts +52 -0
  240. package/work/src/diagrams/telemetry.ts +34 -0
  241. package/work/src/diagrams/xml.ts +267 -0
  242. package/work/src/document-extraction/index.ts +563 -0
  243. package/work/src/document-reader/ambient.d.ts +2 -0
  244. package/work/src/document-reader/errors.ts +7 -0
  245. package/work/src/document-reader/index.ts +181 -0
  246. package/work/src/document-reader/mistral-ocr.ts +318 -0
  247. package/work/src/document-reader/parsers.ts +171 -0
  248. package/work/src/documents/caps.ts +135 -0
  249. package/work/src/documents/diff.ts +269 -0
  250. package/work/src/documents/errors.ts +44 -0
  251. package/work/src/documents/fidelity.ts +98 -0
  252. package/work/src/documents/generate.ts +96 -0
  253. package/work/src/documents/hash.ts +8 -0
  254. package/work/src/documents/index.ts +14 -0
  255. package/work/src/documents/model-schema.ts +639 -0
  256. package/work/src/documents/parse.ts +252 -0
  257. package/work/src/documents/patch-history.ts +81 -0
  258. package/work/src/documents/patch.ts +476 -0
  259. package/work/src/documents/preview-html.ts +245 -0
  260. package/work/src/documents/preview.ts +227 -0
  261. package/work/src/documents/telemetry.ts +36 -0
  262. package/work/src/documents/translate/docx.ts +292 -0
  263. package/work/src/documents/translate/pptx.ts +304 -0
  264. package/work/src/documents/translate/xlsx.ts +137 -0
  265. package/work/src/documents/types.ts +188 -0
  266. package/work/src/index.ts +311 -0
  267. package/work/src/runtime/worker-pool-entry.ts +102 -0
  268. package/work/src/runtime/worker-pool.ts +267 -0
  269. package/work/src/sandbox/composition.ts +212 -0
  270. package/work/src/sandbox/image.ts +6 -0
  271. package/work/src/sandbox/index.ts +14 -0
  272. package/work/src/sheets/caps.ts +68 -0
  273. package/work/src/sheets/csv.ts +351 -0
  274. package/work/src/sheets/decimal.ts +388 -0
  275. package/work/src/sheets/errors.ts +52 -0
  276. package/work/src/sheets/index.ts +62 -0
  277. package/work/src/sheets/inference.ts +378 -0
  278. package/work/src/sheets/telemetry.ts +34 -0
  279. package/work/src/sheets/types.ts +162 -0
  280. package/work/src/sheets/xlsx.ts +388 -0
  281. package/work/src/skills/index.ts +8 -0
  282. package/work/src/skills/load.ts +43 -0
  283. package/work/src/tools/filesystem.ts +21 -0
  284. package/work/src/tools/index.ts +1 -0
  285. package/work/src/tools/local-filesystem.ts +33 -0
  286. package/work/src/tools/office.ts +311 -0
  287. package/work/vendor/hermes-agent/LICENSE +21 -0
  288. package/work/vendor/hermes-agent/skills/productivity/docx/LICENSE +21 -0
  289. package/work/vendor/hermes-agent/skills/productivity/docx/SKILL.md +196 -0
  290. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_comments.py +289 -0
  291. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_common.py +94 -0
  292. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_create.py +177 -0
  293. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_edit.py +250 -0
  294. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_read.py +149 -0
  295. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_revisions.py +147 -0
  296. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_template.py +70 -0
  297. package/work/vendor/hermes-agent/skills/productivity/docx/scripts/docx_validate.py +156 -0
  298. package/work/vendor/hermes-agent/skills/productivity/pdf/LICENSE +21 -0
  299. package/work/vendor/hermes-agent/skills/productivity/pdf/SKILL.md +125 -0
  300. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/_raster.py +76 -0
  301. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/extract_marker.py +88 -0
  302. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/extract_pymupdf.py +101 -0
  303. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_create.py +130 -0
  304. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_fill_form.py +97 -0
  305. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_form_layout.py +168 -0
  306. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_make_form.py +145 -0
  307. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_merge.py +50 -0
  308. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_meta.py +115 -0
  309. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_page_image.py +99 -0
  310. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_read.py +153 -0
  311. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_secure.py +71 -0
  312. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_split.py +84 -0
  313. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_stamp.py +143 -0
  314. package/work/vendor/hermes-agent/skills/productivity/pdf/scripts/pdf_watermark.py +51 -0
  315. package/work/vendor/hermes-agent/skills/productivity/powerpoint/LICENSE +21 -0
  316. package/work/vendor/hermes-agent/skills/productivity/powerpoint/SKILL.md +220 -0
  317. package/work/vendor/hermes-agent/skills/productivity/powerpoint/scripts/pptx_create.py +214 -0
  318. package/work/vendor/hermes-agent/skills/productivity/powerpoint/scripts/pptx_edit.py +436 -0
  319. package/work/vendor/hermes-agent/skills/productivity/powerpoint/scripts/pptx_from_template.py +88 -0
  320. package/work/vendor/hermes-agent/skills/productivity/powerpoint/scripts/pptx_read.py +131 -0
  321. package/work/vendor/hermes-agent/skills/productivity/powerpoint/scripts/pptx_render.py +93 -0
  322. package/work/vendor/hermes-agent/skills/productivity/xlsx/LICENSE +21 -0
  323. package/work/vendor/hermes-agent/skills/productivity/xlsx/SKILL.md +196 -0
  324. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/csv_to_xlsx.py +104 -0
  325. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_create.py +259 -0
  326. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_edit.py +263 -0
  327. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_read.py +160 -0
  328. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_recalc.py +111 -0
  329. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_restructure.py +337 -0
  330. package/work/vendor/hermes-agent/skills/productivity/xlsx/scripts/xlsx_to_csv.py +69 -0
  331. package/work/vendor-lock.json +11 -0
@@ -0,0 +1,292 @@
1
+ import {
2
+ type DocumentOptions,
3
+ generateDocumentSync,
4
+ parseDocumentSync as ooParseDocument,
5
+ type ParagraphOptions,
6
+ type SectionChild,
7
+ type TableOptions,
8
+ } from "@office-open/docx";
9
+ import type { CellValue, DocBlock, DocModel, DocRun, ListItem, TableBlock } from "../types.js";
10
+
11
+ function docRunToRunOptions(run: DocRun) {
12
+ return {
13
+ text: run.text,
14
+ bold: run.bold,
15
+ italic: run.italic,
16
+ underline: run.underline ? ({ type: "single" } as const) : undefined,
17
+ strike: run.strikethrough,
18
+ font: run.code ? { name: "Courier New" } : undefined,
19
+ };
20
+ }
21
+
22
+ function listItemChildren(item: string | ListItem) {
23
+ if (typeof item === "string") return [{ text: item }];
24
+ if (item.runs && item.runs.length > 0) return item.runs.map(docRunToRunOptions);
25
+ return [{ text: item.text ?? "" }];
26
+ }
27
+
28
+ function cellValueToString(value: CellValue): string {
29
+ if (value === null || value === undefined) return "";
30
+ if (typeof value === "string") return value;
31
+ if (typeof value === "number" || typeof value === "boolean") return String(value);
32
+ if ("type" in value) {
33
+ return value.value;
34
+ }
35
+ if ("formula" in value) {
36
+ return value.cachedValue !== undefined && value.cachedValue !== null ? String(value.cachedValue) : value.formula;
37
+ }
38
+ return "";
39
+ }
40
+
41
+ function blockToSectionChildren(block: DocBlock): SectionChild[] {
42
+ switch (block.type) {
43
+ case "heading": {
44
+ const headingKey = `Heading${block.level}` as const;
45
+ return [
46
+ {
47
+ paragraph: {
48
+ heading: headingKey,
49
+ children: [{ text: block.text }],
50
+ },
51
+ },
52
+ ];
53
+ }
54
+ case "paragraph": {
55
+ const children =
56
+ block.runs && block.runs.length > 0 ? block.runs.map(docRunToRunOptions) : block.text !== undefined ? [{ text: block.text }] : [];
57
+ return [
58
+ {
59
+ paragraph: {
60
+ children,
61
+ },
62
+ },
63
+ ];
64
+ }
65
+ case "list": {
66
+ const numbering = { reference: block.ordered ? "ordered" : "bullet", level: 0 };
67
+ return block.items.map((item) => ({
68
+ paragraph: {
69
+ numbering,
70
+ children: listItemChildren(item),
71
+ },
72
+ }));
73
+ }
74
+ case "table": {
75
+ const tableRows = [];
76
+ if (block.headers && block.headers.length > 0) {
77
+ tableRows.push({
78
+ cells: block.headers.map((h) => ({
79
+ children: [
80
+ {
81
+ paragraph: {
82
+ children: [{ text: h, bold: true }],
83
+ },
84
+ },
85
+ ],
86
+ })),
87
+ });
88
+ }
89
+ for (const row of block.cells) {
90
+ tableRows.push({
91
+ cells: row.map((cell) => ({
92
+ children: [
93
+ {
94
+ paragraph: {
95
+ children: [{ text: cellValueToString(cell) }],
96
+ },
97
+ },
98
+ ],
99
+ })),
100
+ });
101
+ }
102
+ return [
103
+ {
104
+ table: {
105
+ rows: tableRows,
106
+ } as TableOptions,
107
+ },
108
+ ];
109
+ }
110
+ case "page-break": {
111
+ return [
112
+ {
113
+ paragraph: {
114
+ children: [{ break: 1 }],
115
+ },
116
+ },
117
+ ];
118
+ }
119
+ case "image": {
120
+ const label = block.alt ? `[Image: ${block.alt}]` : "[Image]";
121
+ return [
122
+ {
123
+ paragraph: {
124
+ children: [{ text: label, italic: true }],
125
+ },
126
+ },
127
+ ];
128
+ }
129
+ case "chart": {
130
+ const title = block.title ? ` - ${block.title}` : "";
131
+ const label = `[Chart: ${block.chartType}${title}]`;
132
+ return [
133
+ {
134
+ paragraph: {
135
+ children: [{ text: label, bold: true }],
136
+ },
137
+ },
138
+ ];
139
+ }
140
+ default:
141
+ return [];
142
+ }
143
+ }
144
+
145
+ export function docModelToDocxOptions(model: DocModel): DocumentOptions {
146
+ const children: SectionChild[] = [];
147
+ if (model.title) {
148
+ children.push({
149
+ paragraph: {
150
+ heading: "Title",
151
+ children: [{ text: model.title }],
152
+ },
153
+ });
154
+ }
155
+
156
+ for (const block of model.blocks) {
157
+ children.push(...blockToSectionChildren(block));
158
+ }
159
+
160
+ return {
161
+ ...(model.blocks.some((block) => block.type === "list")
162
+ ? {
163
+ numbering: {
164
+ abstractNumberings: [
165
+ { reference: "bullet", instanceCount: 1, levels: [{ level: 0, format: "bullet" as const, text: "●" }] },
166
+ { reference: "ordered", instanceCount: 1, levels: [{ level: 0, format: "decimal" as const, text: "%1." }] },
167
+ ],
168
+ },
169
+ }
170
+ : {}),
171
+ sections: [
172
+ {
173
+ children,
174
+ },
175
+ ],
176
+ };
177
+ }
178
+
179
+ export function generateDocxBytes(model: DocModel): Uint8Array {
180
+ const options = docModelToDocxOptions(model);
181
+ const result = generateDocumentSync(options);
182
+ return new Uint8Array(result);
183
+ }
184
+
185
+ function extractParagraphText(p: ParagraphOptions | undefined): string {
186
+ if (!p) return "";
187
+ if (p.text) return p.text;
188
+ if (!p.children) return "";
189
+ const parts: string[] = [];
190
+ for (const child of p.children) {
191
+ if (typeof child === "string") {
192
+ parts.push(child);
193
+ } else if (child && typeof child === "object" && "text" in child && typeof child.text === "string") {
194
+ parts.push(child.text);
195
+ }
196
+ }
197
+ return parts.join("");
198
+ }
199
+
200
+ function extractParagraphRuns(p: ParagraphOptions | undefined): DocRun[] | undefined {
201
+ if (!p?.children || p.children.length === 0) return undefined;
202
+ const runs: DocRun[] = [];
203
+ for (const child of p.children) {
204
+ if (typeof child === "string") {
205
+ runs.push({ text: child });
206
+ } else if (child && typeof child === "object" && "text" in child && typeof child.text === "string") {
207
+ runs.push({
208
+ text: child.text,
209
+ bold: (child as { bold?: boolean }).bold,
210
+ italic: (child as { italic?: boolean }).italic,
211
+ underline: (child as { underline?: unknown }).underline ? true : undefined,
212
+ strikethrough: (child as { strike?: boolean }).strike,
213
+ code: (child as { font?: { name?: string } }).font?.name === "Courier New" ? true : undefined,
214
+ });
215
+ }
216
+ }
217
+ return runs.length > 0 ? runs : undefined;
218
+ }
219
+
220
+ export function parseDocxBytes(bytes: Uint8Array): DocModel {
221
+ const parsed = ooParseDocument(bytes);
222
+ let title: string | undefined;
223
+ const blocks: DocBlock[] = [];
224
+
225
+ const sections = parsed.sections ?? [];
226
+ for (const section of sections) {
227
+ const children = (section.children ?? []) as Array<Record<string, unknown>>;
228
+ for (const child of children) {
229
+ if ("paragraph" in child) {
230
+ const p = child.paragraph as ParagraphOptions & { heading?: string };
231
+ const heading = p.heading;
232
+ const text = extractParagraphText(p);
233
+
234
+ if (heading === "Title" && !title) {
235
+ title = text;
236
+ continue;
237
+ }
238
+
239
+ if (heading && /^Heading[1-6]$/.test(heading)) {
240
+ const level = Number(heading.replace("Heading", "")) as 1 | 2 | 3 | 4 | 5 | 6;
241
+ blocks.push({
242
+ type: "heading",
243
+ level,
244
+ text,
245
+ });
246
+ continue;
247
+ }
248
+
249
+ if (p.children?.some((c) => typeof c === "object" && c !== null && "break" in c)) {
250
+ blocks.push({ type: "page-break" });
251
+ continue;
252
+ }
253
+
254
+ const runs = extractParagraphRuns(p);
255
+ blocks.push({
256
+ type: "paragraph",
257
+ text,
258
+ runs,
259
+ });
260
+ } else if ("table" in child) {
261
+ const t = child.table as { rows?: Array<{ cells?: Array<{ children?: Array<{ paragraph?: ParagraphOptions }> }> }> };
262
+ const rows = t.rows ?? [];
263
+ const tableCells: CellValue[][] = [];
264
+
265
+ for (const row of rows) {
266
+ const rowCells: CellValue[] = [];
267
+ for (const cell of row.cells ?? []) {
268
+ const cellText = (cell.children ?? []).map((c) => extractParagraphText(c.paragraph)).join("\n");
269
+ rowCells.push(cellText);
270
+ }
271
+ tableCells.push(rowCells);
272
+ }
273
+
274
+ const rowCount = tableCells.length;
275
+ const colCount = rowCount > 0 ? tableCells[0].length : 0;
276
+ blocks.push({
277
+ type: "table",
278
+ rows: rowCount,
279
+ columns: colCount,
280
+ cells: tableCells,
281
+ } as TableBlock);
282
+ }
283
+ }
284
+ }
285
+
286
+ return {
287
+ kind: "doc",
288
+ modelVersion: 1,
289
+ title,
290
+ blocks,
291
+ };
292
+ }
@@ -0,0 +1,304 @@
1
+ import {
2
+ generatePresentationSync,
3
+ parsePresentationSync as ooParsePresentation,
4
+ type PresentationOptions,
5
+ type SlideChild,
6
+ type SlideOptions,
7
+ } from "@office-open/pptx";
8
+ import type { DeckModel, ListItem, SlideData, SlideLayout } from "../types.js";
9
+
10
+ function bulletItemToString(item: string | ListItem): string {
11
+ if (typeof item === "string") return item;
12
+ if (item.runs && item.runs.length > 0) {
13
+ return item.runs.map((r) => r.text).join("");
14
+ }
15
+ return item.text ?? "";
16
+ }
17
+
18
+ function slideDataToSlideOptions(slide: SlideData): SlideOptions {
19
+ const children: SlideChild[] = [];
20
+ const titleText = slide.title ?? "";
21
+
22
+ switch (slide.layout) {
23
+ case "title": {
24
+ if (titleText) {
25
+ children.push({
26
+ shape: {
27
+ x: 100,
28
+ y: 150,
29
+ width: 800,
30
+ height: 100,
31
+ textBody: {
32
+ paragraphs: [{ text: titleText }],
33
+ },
34
+ },
35
+ });
36
+ }
37
+ if (slide.subtitle) {
38
+ children.push({
39
+ shape: {
40
+ x: 100,
41
+ y: 270,
42
+ width: 800,
43
+ height: 80,
44
+ textBody: {
45
+ paragraphs: [{ text: slide.subtitle }],
46
+ },
47
+ },
48
+ });
49
+ }
50
+ break;
51
+ }
52
+ case "section-header": {
53
+ if (titleText) {
54
+ children.push({
55
+ shape: {
56
+ x: 100,
57
+ y: 200,
58
+ width: 800,
59
+ height: 120,
60
+ textBody: {
61
+ paragraphs: [{ text: titleText }],
62
+ },
63
+ },
64
+ });
65
+ }
66
+ break;
67
+ }
68
+ case "two-column": {
69
+ if (titleText) {
70
+ children.push({
71
+ shape: {
72
+ x: 50,
73
+ y: 50,
74
+ width: 800,
75
+ height: 60,
76
+ textBody: {
77
+ paragraphs: [{ text: titleText }],
78
+ },
79
+ },
80
+ });
81
+ }
82
+ if (slide.bullets && slide.bullets.length > 0) {
83
+ const mid = Math.ceil(slide.bullets.length / 2);
84
+ const col1Paragraphs = slide.bullets.slice(0, mid).map((b) => ({ text: `• ${bulletItemToString(b)}` }));
85
+ const col2Paragraphs = slide.bullets.slice(mid).map((b) => ({ text: `• ${bulletItemToString(b)}` }));
86
+
87
+ children.push({
88
+ shape: {
89
+ x: 50,
90
+ y: 130,
91
+ width: 400,
92
+ height: 400,
93
+ textBody: {
94
+ paragraphs: col1Paragraphs,
95
+ },
96
+ },
97
+ });
98
+ if (col2Paragraphs.length > 0) {
99
+ children.push({
100
+ shape: {
101
+ x: 480,
102
+ y: 130,
103
+ width: 400,
104
+ height: 400,
105
+ textBody: {
106
+ paragraphs: col2Paragraphs,
107
+ },
108
+ },
109
+ });
110
+ }
111
+ }
112
+ break;
113
+ }
114
+ case "blank": {
115
+ if (titleText) {
116
+ children.push({
117
+ shape: {
118
+ x: 50,
119
+ y: 50,
120
+ width: 800,
121
+ height: 60,
122
+ textBody: {
123
+ paragraphs: [{ text: titleText }],
124
+ },
125
+ },
126
+ });
127
+ }
128
+ break;
129
+ }
130
+ default: {
131
+ if (titleText) {
132
+ children.push({
133
+ shape: {
134
+ x: 50,
135
+ y: 50,
136
+ width: 800,
137
+ height: 60,
138
+ textBody: {
139
+ paragraphs: [{ text: titleText }],
140
+ },
141
+ },
142
+ });
143
+ }
144
+ if (slide.bullets && slide.bullets.length > 0) {
145
+ const bulletParagraphs = slide.bullets.map((b) => ({ text: `• ${bulletItemToString(b)}` }));
146
+ children.push({
147
+ shape: {
148
+ x: 50,
149
+ y: 130,
150
+ width: 800,
151
+ height: 400,
152
+ textBody: {
153
+ paragraphs: bulletParagraphs,
154
+ },
155
+ },
156
+ });
157
+ }
158
+ break;
159
+ }
160
+ }
161
+
162
+ if (slide.image) {
163
+ const label = slide.image.alt ? `[Image: ${slide.image.alt}]` : "[Image]";
164
+ children.push({
165
+ shape: {
166
+ x: 500,
167
+ y: 150,
168
+ width: 300,
169
+ height: 200,
170
+ textBody: {
171
+ paragraphs: [{ text: label }],
172
+ },
173
+ },
174
+ });
175
+ }
176
+
177
+ if (slide.chart) {
178
+ const title = slide.chart.title ? ` - ${slide.chart.title}` : "";
179
+ const label = `[Chart: ${slide.chart.chartType}${title}]`;
180
+ children.push({
181
+ shape: {
182
+ x: 500,
183
+ y: 150,
184
+ width: 300,
185
+ height: 200,
186
+ textBody: {
187
+ paragraphs: [{ text: label }],
188
+ },
189
+ },
190
+ });
191
+ }
192
+
193
+ return {
194
+ children,
195
+ notes: slide.notes,
196
+ };
197
+ }
198
+
199
+ export function deckModelToPptxOptions(model: DeckModel): PresentationOptions {
200
+ return {
201
+ slides: model.slides.map(slideDataToSlideOptions),
202
+ };
203
+ }
204
+
205
+ export function generatePptxBytes(model: DeckModel): Uint8Array {
206
+ const options = deckModelToPptxOptions(model);
207
+ const result = generatePresentationSync(options);
208
+ return new Uint8Array(result);
209
+ }
210
+
211
+ function extractNotesText(notes: unknown): string | undefined {
212
+ if (!notes) return undefined;
213
+ if (typeof notes === "string") return notes;
214
+ if (typeof notes !== "object") return undefined;
215
+
216
+ const notesObj = notes as {
217
+ children?: Array<{
218
+ shape?: {
219
+ textBody?: {
220
+ paragraphs?: Array<{
221
+ text?: string;
222
+ children?: Array<{ text?: string }>;
223
+ }>;
224
+ };
225
+ };
226
+ }>;
227
+ };
228
+
229
+ if (!notesObj.children) return undefined;
230
+ const texts: string[] = [];
231
+ for (const child of notesObj.children) {
232
+ const paragraphs = child.shape?.textBody?.paragraphs ?? [];
233
+ for (const p of paragraphs) {
234
+ if (p.text) {
235
+ texts.push(p.text);
236
+ }
237
+ if (p.children) {
238
+ for (const c of p.children) {
239
+ if (c.text) texts.push(c.text);
240
+ }
241
+ }
242
+ }
243
+ }
244
+ return texts.length > 0 ? texts.join("\n") : undefined;
245
+ }
246
+
247
+ export function parsePptxBytes(bytes: Uint8Array): DeckModel {
248
+ const parsed = ooParsePresentation(bytes);
249
+ const slides: SlideData[] = [];
250
+
251
+ for (const slide of parsed.slides ?? []) {
252
+ let title: string | undefined;
253
+ let subtitle: string | undefined;
254
+ const bullets: string[] = [];
255
+
256
+ const children = slide.children ?? [];
257
+ for (const child of children) {
258
+ if ("shape" in child && child.shape) {
259
+ const paragraphs = child.shape.textBody?.paragraphs ?? [];
260
+ for (const p of paragraphs) {
261
+ let text = "";
262
+ if (typeof p === "string") {
263
+ text = p;
264
+ } else if (p && typeof p === "object") {
265
+ if ("text" in p && typeof (p as { text?: unknown }).text === "string") {
266
+ text = (p as { text: string }).text;
267
+ } else if ("children" in p && Array.isArray((p as { children?: unknown }).children)) {
268
+ const pChildren = (p as { children: Array<{ text?: string } | string> }).children;
269
+ text = pChildren.map((c) => (typeof c === "string" ? c : (c?.text ?? ""))).join("");
270
+ }
271
+ }
272
+ if (!text) continue;
273
+
274
+ if (!title) {
275
+ title = text;
276
+ } else if (text.startsWith("• ")) {
277
+ bullets.push(text.slice(2));
278
+ } else if (!subtitle && bullets.length === 0) {
279
+ subtitle = text;
280
+ } else {
281
+ bullets.push(text);
282
+ }
283
+ }
284
+ }
285
+ }
286
+
287
+ const notes = extractNotesText(slide.notes);
288
+ const layout: SlideLayout = title && subtitle && bullets.length === 0 ? "title" : "title-and-content";
289
+
290
+ slides.push({
291
+ layout,
292
+ title,
293
+ subtitle,
294
+ bullets: bullets.length > 0 ? bullets : undefined,
295
+ notes,
296
+ });
297
+ }
298
+
299
+ return {
300
+ kind: "deck",
301
+ modelVersion: 1,
302
+ slides,
303
+ };
304
+ }