alran 0.0.0-stage → 0.9.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 (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,322 @@
1
+ using System.CommandLine;
2
+ using DocumentFormat.OpenXml;
3
+ using DocumentFormat.OpenXml.Packaging;
4
+ using DocumentFormat.OpenXml.Wordprocessing;
5
+
6
+ namespace AlranAIDocx.Core.Commands;
7
+
8
+ /// <summary>
9
+ /// Scenario C: Apply formatting from a template DOCX to a source DOCX.
10
+ /// Copies styles, theme, numbering, headers/footers, and section properties
11
+ /// from the template while preserving all content from the source.
12
+ /// </summary>
13
+ public static class ApplyTemplateCommand
14
+ {
15
+ public static Command Create()
16
+ {
17
+ var inputOpt = new Option<string>("--input") { Description = "Source DOCX (content to keep)", Required = true };
18
+ var templateOpt = new Option<string>("--template") { Description = "Template DOCX (formatting to apply)", Required = true };
19
+ var outputOpt = new Option<string>("--output") { Description = "Output DOCX file path", Required = true };
20
+ var applyStylesOpt = new Option<bool>("--apply-styles") { Description = "Copy styles.xml from template" };
21
+ applyStylesOpt.DefaultValueFactory = _ => true;
22
+ var applyThemeOpt = new Option<bool>("--apply-theme") { Description = "Copy theme from template" };
23
+ applyThemeOpt.DefaultValueFactory = _ => true;
24
+ var applyNumberingOpt = new Option<bool>("--apply-numbering") { Description = "Copy numbering.xml from template" };
25
+ applyNumberingOpt.DefaultValueFactory = _ => true;
26
+ var applyHeadersFootersOpt = new Option<bool>("--apply-headers-footers") { Description = "Copy headers/footers from template" };
27
+ var applySectionsOpt = new Option<bool>("--apply-sections") { Description = "Apply section properties from template" };
28
+ applySectionsOpt.DefaultValueFactory = _ => true;
29
+
30
+ var cmd = new Command("apply-template", "Apply template formatting to a DOCX")
31
+ {
32
+ inputOpt, templateOpt, outputOpt, applyStylesOpt, applyThemeOpt,
33
+ applyNumberingOpt, applyHeadersFootersOpt, applySectionsOpt
34
+ };
35
+
36
+ cmd.SetAction((parseResult) =>
37
+ {
38
+ var inputPath = parseResult.GetValue(inputOpt)!;
39
+ var templatePath = parseResult.GetValue(templateOpt)!;
40
+ var outputPath = parseResult.GetValue(outputOpt)!;
41
+ var applyStyles = parseResult.GetValue(applyStylesOpt);
42
+ var applyTheme = parseResult.GetValue(applyThemeOpt);
43
+ var applyNumbering = parseResult.GetValue(applyNumberingOpt);
44
+ var applyHeadersFooters = parseResult.GetValue(applyHeadersFootersOpt);
45
+ var applySections = parseResult.GetValue(applySectionsOpt);
46
+
47
+ if (!File.Exists(inputPath)) { Console.Error.WriteLine($"Input file not found: {inputPath}"); return; }
48
+ if (!File.Exists(templatePath)) { Console.Error.WriteLine($"Template file not found: {templatePath}"); return; }
49
+
50
+ // Create output as a copy of the source
51
+ File.Copy(inputPath, outputPath, overwrite: true);
52
+
53
+ using var output = WordprocessingDocument.Open(outputPath, true);
54
+ using var template = WordprocessingDocument.Open(templatePath, false);
55
+
56
+ var outputMain = output.MainDocumentPart;
57
+ var templateMain = template.MainDocumentPart;
58
+ if (outputMain == null || templateMain == null)
59
+ {
60
+ Console.Error.WriteLine("Invalid document: missing main document part.");
61
+ return;
62
+ }
63
+
64
+ int appliedCount = 0;
65
+
66
+ if (applyStyles)
67
+ {
68
+ CopyStyles(templateMain, outputMain);
69
+ appliedCount++;
70
+ Console.WriteLine(" Applied: styles");
71
+ }
72
+
73
+ if (applyTheme)
74
+ {
75
+ CopyTheme(templateMain, outputMain);
76
+ appliedCount++;
77
+ Console.WriteLine(" Applied: theme");
78
+ }
79
+
80
+ if (applyNumbering)
81
+ {
82
+ CopyNumbering(templateMain, outputMain);
83
+ appliedCount++;
84
+ Console.WriteLine(" Applied: numbering");
85
+ }
86
+
87
+ if (applyHeadersFooters)
88
+ {
89
+ CopyHeadersAndFooters(templateMain, outputMain);
90
+ appliedCount++;
91
+ Console.WriteLine(" Applied: headers/footers");
92
+ }
93
+
94
+ if (applySections)
95
+ {
96
+ CopySectionProperties(templateMain, outputMain);
97
+ appliedCount++;
98
+ Console.WriteLine(" Applied: section properties");
99
+ }
100
+
101
+ outputMain.Document.Save();
102
+ Console.WriteLine($"Applied {appliedCount} formatting component(s) from template to {outputPath}");
103
+ });
104
+
105
+ return cmd;
106
+ }
107
+
108
+ /// <summary>
109
+ /// Replaces the output's StyleDefinitionsPart with the template's version.
110
+ /// </summary>
111
+ private static void CopyStyles(MainDocumentPart template, MainDocumentPart output)
112
+ {
113
+ var templateStyles = template.StyleDefinitionsPart;
114
+ if (templateStyles == null) return;
115
+
116
+ if (output.StyleDefinitionsPart != null)
117
+ output.DeletePart(output.StyleDefinitionsPart);
118
+
119
+ var newStylesPart = output.AddNewPart<StyleDefinitionsPart>();
120
+
121
+ using var stream = templateStyles.GetStream(FileMode.Open, FileAccess.Read);
122
+ newStylesPart.FeedData(stream);
123
+ }
124
+
125
+ /// <summary>
126
+ /// Replaces the output's ThemePart with the template's version.
127
+ /// </summary>
128
+ private static void CopyTheme(MainDocumentPart template, MainDocumentPart output)
129
+ {
130
+ var templateTheme = template.ThemePart;
131
+ if (templateTheme == null) return;
132
+
133
+ if (output.ThemePart != null)
134
+ output.DeletePart(output.ThemePart);
135
+
136
+ var newThemePart = output.AddNewPart<ThemePart>();
137
+
138
+ using var stream = templateTheme.GetStream(FileMode.Open, FileAccess.Read);
139
+ newThemePart.FeedData(stream);
140
+ }
141
+
142
+ /// <summary>
143
+ /// Copies numbering definitions from template, remapping numbering IDs
144
+ /// referenced in the output document's paragraphs.
145
+ /// </summary>
146
+ private static void CopyNumbering(MainDocumentPart template, MainDocumentPart output)
147
+ {
148
+ var templateNumbering = template.NumberingDefinitionsPart;
149
+ if (templateNumbering == null) return;
150
+
151
+ var referencedNumIds = new HashSet<string>();
152
+ var body = output.Document.Body;
153
+ if (body != null)
154
+ {
155
+ foreach (var numId in body.Descendants<NumberingId>())
156
+ {
157
+ if (numId.Val?.Value != null)
158
+ referencedNumIds.Add(numId.Val.Value.ToString());
159
+ }
160
+ }
161
+
162
+ if (output.NumberingDefinitionsPart != null)
163
+ output.DeletePart(output.NumberingDefinitionsPart);
164
+
165
+ var newNumberingPart = output.AddNewPart<NumberingDefinitionsPart>();
166
+
167
+ using var stream = templateNumbering.GetStream(FileMode.Open, FileAccess.Read);
168
+ newNumberingPart.FeedData(stream);
169
+
170
+ if (referencedNumIds.Count > 0)
171
+ {
172
+ Console.WriteLine($" Note: {referencedNumIds.Count} numbering reference(s) in document content mapped to template definitions.");
173
+ }
174
+ }
175
+
176
+ /// <summary>
177
+ /// Copies headers and footers from the template, remapping relationship IDs.
178
+ /// </summary>
179
+ private static void CopyHeadersAndFooters(MainDocumentPart template, MainDocumentPart output)
180
+ {
181
+ var outputBody = output.Document.Body;
182
+ if (outputBody == null) return;
183
+
184
+ // Remove existing header/footer parts from output
185
+ foreach (var hp in output.HeaderParts.ToList())
186
+ output.DeletePart(hp);
187
+ foreach (var fp in output.FooterParts.ToList())
188
+ output.DeletePart(fp);
189
+
190
+ // Remove existing header/footer references from all section properties
191
+ foreach (var sectPr in outputBody.Descendants<SectionProperties>())
192
+ {
193
+ foreach (var hr in sectPr.Elements<HeaderReference>().ToList())
194
+ hr.Remove();
195
+ foreach (var fr in sectPr.Elements<FooterReference>().ToList())
196
+ fr.Remove();
197
+ }
198
+
199
+ var templateBody = template.Document?.Body;
200
+ if (templateBody == null) return;
201
+
202
+ var templateFinalSectPr = templateBody.Descendants<SectionProperties>().LastOrDefault();
203
+ if (templateFinalSectPr == null) return;
204
+
205
+ var outputFinalSectPr = outputBody.Descendants<SectionProperties>().LastOrDefault();
206
+ if (outputFinalSectPr == null)
207
+ {
208
+ outputFinalSectPr = new SectionProperties();
209
+ outputBody.Append(outputFinalSectPr);
210
+ }
211
+
212
+ // Copy headers
213
+ foreach (var headerRef in templateFinalSectPr.Elements<HeaderReference>())
214
+ {
215
+ var templateHeaderPart = template.GetPartById(headerRef.Id!) as HeaderPart;
216
+ if (templateHeaderPart == null) continue;
217
+
218
+ var newHeaderPart = output.AddNewPart<HeaderPart>();
219
+ using (var stream = templateHeaderPart.GetStream(FileMode.Open, FileAccess.Read))
220
+ {
221
+ newHeaderPart.FeedData(stream);
222
+ }
223
+
224
+ CopyPartRelationships(templateHeaderPart, newHeaderPart);
225
+
226
+ var newRefId = output.GetIdOfPart(newHeaderPart);
227
+ outputFinalSectPr.InsertAt(new HeaderReference
228
+ {
229
+ Type = headerRef.Type,
230
+ Id = newRefId
231
+ }, 0);
232
+ }
233
+
234
+ // Copy footers
235
+ foreach (var footerRef in templateFinalSectPr.Elements<FooterReference>())
236
+ {
237
+ var templateFooterPart = template.GetPartById(footerRef.Id!) as FooterPart;
238
+ if (templateFooterPart == null) continue;
239
+
240
+ var newFooterPart = output.AddNewPart<FooterPart>();
241
+ using (var stream = templateFooterPart.GetStream(FileMode.Open, FileAccess.Read))
242
+ {
243
+ newFooterPart.FeedData(stream);
244
+ }
245
+
246
+ CopyPartRelationships(templateFooterPart, newFooterPart);
247
+
248
+ var newRefId = output.GetIdOfPart(newFooterPart);
249
+ var lastHeaderRef = outputFinalSectPr.Elements<HeaderReference>().LastOrDefault();
250
+ if (lastHeaderRef != null)
251
+ lastHeaderRef.InsertAfterSelf(new FooterReference { Type = footerRef.Type, Id = newRefId });
252
+ else
253
+ outputFinalSectPr.InsertAt(new FooterReference { Type = footerRef.Type, Id = newRefId }, 0);
254
+ }
255
+ }
256
+
257
+ /// <summary>
258
+ /// Copies sub-relationships (images, etc.) from a source part to a target part.
259
+ /// </summary>
260
+ private static void CopyPartRelationships(OpenXmlPart source, OpenXmlPart target)
261
+ {
262
+ foreach (var rel in source.ExternalRelationships)
263
+ {
264
+ target.AddExternalRelationship(rel.RelationshipType, rel.Uri, rel.Id);
265
+ }
266
+
267
+ foreach (var childPart in source.Parts)
268
+ {
269
+ try
270
+ {
271
+ var contentType = childPart.OpenXmlPart.ContentType;
272
+ if (contentType.StartsWith("image/"))
273
+ {
274
+ var newChild = target.AddNewPart<ImagePart>(contentType, childPart.RelationshipId);
275
+ using var stream = childPart.OpenXmlPart.GetStream(FileMode.Open, FileAccess.Read);
276
+ newChild.FeedData(stream);
277
+ }
278
+ }
279
+ catch (Exception ex)
280
+ {
281
+ Console.Error.WriteLine($"[WARN] Skipped non-image embedded part: {ex.Message}");
282
+ }
283
+ }
284
+ }
285
+
286
+ /// <summary>
287
+ /// Copies page size, margins, columns, and document grid from template section properties.
288
+ /// </summary>
289
+ private static void CopySectionProperties(MainDocumentPart template, MainDocumentPart output)
290
+ {
291
+ var templateBody = template.Document?.Body;
292
+ var outputBody = output.Document?.Body;
293
+ if (templateBody == null || outputBody == null) return;
294
+
295
+ var templateSectPr = templateBody.Descendants<SectionProperties>().LastOrDefault();
296
+ if (templateSectPr == null) return;
297
+
298
+ var outputSectPr = outputBody.Descendants<SectionProperties>().LastOrDefault();
299
+ if (outputSectPr == null)
300
+ {
301
+ outputSectPr = new SectionProperties();
302
+ outputBody.Append(outputSectPr);
303
+ }
304
+
305
+ CopyChildElement<PageSize>(templateSectPr, outputSectPr);
306
+ CopyChildElement<PageMargin>(templateSectPr, outputSectPr);
307
+ CopyChildElement<Columns>(templateSectPr, outputSectPr);
308
+ CopyChildElement<DocGrid>(templateSectPr, outputSectPr);
309
+ CopyChildElement<PageBorders>(templateSectPr, outputSectPr);
310
+ }
311
+
312
+ private static void CopyChildElement<T>(SectionProperties source, SectionProperties target) where T : OpenXmlElement
313
+ {
314
+ var sourceElement = source.GetFirstChild<T>();
315
+ if (sourceElement == null) return;
316
+
317
+ var existing = target.GetFirstChild<T>();
318
+ existing?.Remove();
319
+
320
+ target.Append((T)sourceElement.CloneNode(true));
321
+ }
322
+ }
@@ -0,0 +1,324 @@
1
+ using System.CommandLine;
2
+ using DocumentFormat.OpenXml;
3
+ using DocumentFormat.OpenXml.Packaging;
4
+ using DocumentFormat.OpenXml.Wordprocessing;
5
+ using AlranAIDocx.Core.OpenXml;
6
+ using AlranAIDocx.Core.Typography;
7
+
8
+ namespace AlranAIDocx.Core.Commands;
9
+
10
+ /// <summary>
11
+ /// Scenario A: Create a new DOCX document from scratch with proper styles, sections,
12
+ /// headers/footers, and typography defaults.
13
+ /// </summary>
14
+ public static class CreateCommand
15
+ {
16
+ public static Command Create()
17
+ {
18
+ var outputOption = new Option<string>("--output") { Description = "Output DOCX file path", Required = true };
19
+ var typeOption = new Option<string>("--type") { Description = "Document type: report, letter, memo, academic" };
20
+ typeOption.DefaultValueFactory = _ => "report";
21
+ var titleOption = new Option<string>("--title") { Description = "Document title" };
22
+ var authorOption = new Option<string>("--author") { Description = "Document author" };
23
+ var pageSizeOption = new Option<string>("--page-size") { Description = "Page size: letter, a4, legal, a3" };
24
+ pageSizeOption.DefaultValueFactory = _ => "letter";
25
+ var marginsOption = new Option<string>("--margins") { Description = "Margin preset: standard, narrow, wide" };
26
+ marginsOption.DefaultValueFactory = _ => "standard";
27
+ var headerTextOption = new Option<string>("--header") { Description = "Header text" };
28
+ var footerTextOption = new Option<string>("--footer") { Description = "Footer text" };
29
+ var pageNumbersOption = new Option<bool>("--page-numbers") { Description = "Add page numbers in footer" };
30
+ var tocOption = new Option<bool>("--toc") { Description = "Insert table of contents placeholder" };
31
+ var contentJsonOption = new Option<string>("--content-json") { Description = "Path to JSON file describing document content" };
32
+
33
+ var cmd = new Command("create", "Create a new DOCX document from scratch")
34
+ {
35
+ outputOption, typeOption, titleOption, authorOption, pageSizeOption,
36
+ marginsOption, headerTextOption, footerTextOption, pageNumbersOption,
37
+ tocOption, contentJsonOption
38
+ };
39
+
40
+ cmd.SetAction((parseResult) =>
41
+ {
42
+ var output = parseResult.GetValue(outputOption)!;
43
+ var docType = parseResult.GetValue(typeOption) ?? "report";
44
+ var title = parseResult.GetValue(titleOption);
45
+ var author = parseResult.GetValue(authorOption);
46
+ var pageSizeName = parseResult.GetValue(pageSizeOption) ?? "letter";
47
+ var marginsName = parseResult.GetValue(marginsOption) ?? "standard";
48
+ var headerText = parseResult.GetValue(headerTextOption);
49
+ var footerText = parseResult.GetValue(footerTextOption);
50
+ var pageNumbers = parseResult.GetValue(pageNumbersOption);
51
+ var tocPlaceholder = parseResult.GetValue(tocOption);
52
+ var contentJson = parseResult.GetValue(contentJsonOption);
53
+
54
+ var fontConfig = GetFontConfig(docType);
55
+ var pageSize = GetPageSizeConfig(pageSizeName);
56
+ var margins = GetMargins(marginsName);
57
+
58
+ using var doc = WordprocessingDocument.Create(output, WordprocessingDocumentType.Document);
59
+ var mainPart = doc.AddMainDocumentPart();
60
+ mainPart.Document = new Document(new Body());
61
+ var body = mainPart.Document.Body!;
62
+
63
+ // Add styles part with defaults
64
+ AddDefaultStyles(mainPart, fontConfig);
65
+
66
+ // Add section properties (page size, margins)
67
+ var sectPr = new SectionProperties();
68
+ sectPr.Append(new DocumentFormat.OpenXml.Wordprocessing.PageSize
69
+ {
70
+ Width = (UInt32Value)(uint)pageSize.WidthDxa,
71
+ Height = (UInt32Value)(uint)pageSize.HeightDxa
72
+ });
73
+ sectPr.Append(new PageMargin
74
+ {
75
+ Top = margins.TopDxa,
76
+ Bottom = margins.BottomDxa,
77
+ Left = (UInt32Value)(uint)margins.LeftDxa,
78
+ Right = (UInt32Value)(uint)margins.RightDxa
79
+ });
80
+
81
+ // Add header if requested
82
+ if (!string.IsNullOrEmpty(headerText))
83
+ {
84
+ var headerPart = mainPart.AddNewPart<HeaderPart>();
85
+ headerPart.Header = new Header(
86
+ new Paragraph(new Run(new Text(headerText))));
87
+ var headerRefId = mainPart.GetIdOfPart(headerPart);
88
+ sectPr.Append(new HeaderReference
89
+ {
90
+ Type = HeaderFooterValues.Default,
91
+ Id = headerRefId
92
+ });
93
+ }
94
+
95
+ // Add footer if requested
96
+ if (!string.IsNullOrEmpty(footerText) || pageNumbers)
97
+ {
98
+ var footerPart = mainPart.AddNewPart<FooterPart>();
99
+ var footerParagraph = new Paragraph();
100
+
101
+ if (!string.IsNullOrEmpty(footerText))
102
+ {
103
+ footerParagraph.Append(new Run(new Text(footerText)));
104
+ }
105
+
106
+ if (pageNumbers)
107
+ {
108
+ if (!string.IsNullOrEmpty(footerText))
109
+ footerParagraph.Append(new Run(new Text(" — ") { Space = SpaceProcessingModeValues.Preserve }));
110
+
111
+ footerParagraph.Append(new Run(
112
+ new FieldChar { FieldCharType = FieldCharValues.Begin }));
113
+ footerParagraph.Append(new Run(
114
+ new FieldCode(" PAGE ") { Space = SpaceProcessingModeValues.Preserve }));
115
+ footerParagraph.Append(new Run(
116
+ new FieldChar { FieldCharType = FieldCharValues.End }));
117
+ }
118
+
119
+ footerPart.Footer = new Footer(footerParagraph);
120
+ var footerRefId = mainPart.GetIdOfPart(footerPart);
121
+ sectPr.Append(new FooterReference
122
+ {
123
+ Type = HeaderFooterValues.Default,
124
+ Id = footerRefId
125
+ });
126
+ }
127
+
128
+ // Title
129
+ if (!string.IsNullOrEmpty(title))
130
+ {
131
+ var titlePara = new Paragraph(
132
+ new ParagraphProperties(new ParagraphStyleId { Val = "Title" }),
133
+ new Run(new Text(title)));
134
+ body.Append(titlePara);
135
+ }
136
+
137
+ // Author subtitle
138
+ if (!string.IsNullOrEmpty(author))
139
+ {
140
+ var authorPara = new Paragraph(
141
+ new ParagraphProperties(new ParagraphStyleId { Val = "Subtitle" }),
142
+ new Run(new Text(author)));
143
+ body.Append(authorPara);
144
+ }
145
+
146
+ // TOC placeholder
147
+ if (tocPlaceholder)
148
+ {
149
+ body.Append(new Paragraph(
150
+ new ParagraphProperties(new ParagraphStyleId { Val = "TOCHeading" }),
151
+ new Run(new Text("Table of Contents"))));
152
+
153
+ // Insert TOC field
154
+ var tocPara = new Paragraph();
155
+ tocPara.Append(new Run(new FieldChar { FieldCharType = FieldCharValues.Begin }));
156
+ tocPara.Append(new Run(new FieldCode(" TOC \\o \"1-3\" \\h \\z \\u ") { Space = SpaceProcessingModeValues.Preserve }));
157
+ tocPara.Append(new Run(new FieldChar { FieldCharType = FieldCharValues.Separate }));
158
+ tocPara.Append(new Run(new Text("Update this field to generate table of contents.")));
159
+ tocPara.Append(new Run(new FieldChar { FieldCharType = FieldCharValues.End }));
160
+ body.Append(tocPara);
161
+
162
+ // Page break after TOC
163
+ body.Append(new Paragraph(new Run(new Break { Type = BreakValues.Page })));
164
+ }
165
+
166
+ // Content from JSON (if provided)
167
+ if (!string.IsNullOrEmpty(contentJson) && File.Exists(contentJson))
168
+ {
169
+ var jsonContent = File.ReadAllText(contentJson);
170
+ AddContentFromJson(body, jsonContent, fontConfig);
171
+ }
172
+
173
+ // Ensure body has at least one paragraph
174
+ if (!body.Elements<Paragraph>().Any())
175
+ {
176
+ body.Append(new Paragraph());
177
+ }
178
+
179
+ // sectPr must be the last child of body
180
+ body.Append(sectPr);
181
+
182
+ mainPart.Document.Save();
183
+ Console.WriteLine($"Created {docType} document: {output}");
184
+ });
185
+
186
+ return cmd;
187
+ }
188
+
189
+ private static FontConfig GetFontConfig(string docType) => docType.ToLowerInvariant() switch
190
+ {
191
+ "letter" => FontDefaults.Letter,
192
+ "memo" => FontDefaults.Memo,
193
+ "academic" => FontDefaults.Academic,
194
+ _ => FontDefaults.Report,
195
+ };
196
+
197
+ private static Typography.PageSize GetPageSizeConfig(string name) => name.ToLowerInvariant() switch
198
+ {
199
+ "a4" => PageSizes.A4,
200
+ "legal" => PageSizes.Legal,
201
+ "a3" => PageSizes.A3,
202
+ _ => PageSizes.Letter,
203
+ };
204
+
205
+ private static MarginConfig GetMargins(string name) => name.ToLowerInvariant() switch
206
+ {
207
+ "narrow" => PageSizes.NarrowMargins,
208
+ "wide" => PageSizes.WideMargins,
209
+ _ => PageSizes.StandardMargins,
210
+ };
211
+
212
+ private static void AddDefaultStyles(MainDocumentPart mainPart, FontConfig fontConfig)
213
+ {
214
+ var stylesPart = mainPart.AddNewPart<StyleDefinitionsPart>();
215
+ var styles = new Styles();
216
+
217
+ // Default run properties
218
+ var defaultRPr = new StyleRunProperties(
219
+ new RunFonts { Ascii = fontConfig.BodyFont, HighAnsi = fontConfig.BodyFont },
220
+ new FontSize { Val = UnitConverter.FontSizeToSz(fontConfig.BodySize) },
221
+ new FontSizeComplexScript { Val = UnitConverter.FontSizeToSz(fontConfig.BodySize) });
222
+
223
+ // Normal style
224
+ styles.Append(new Style(
225
+ new StyleName { Val = "Normal" },
226
+ new PrimaryStyle(),
227
+ defaultRPr)
228
+ { Type = StyleValues.Paragraph, StyleId = "Normal", Default = true });
229
+
230
+ // Heading styles 1-6
231
+ double[] headingSizes = [fontConfig.Heading1Size, fontConfig.Heading2Size, fontConfig.Heading3Size,
232
+ fontConfig.Heading4Size, fontConfig.Heading5Size, fontConfig.Heading6Size];
233
+ for (int i = 0; i < 6; i++)
234
+ {
235
+ var level = i + 1;
236
+ var headingStyle = new Style(
237
+ new StyleName { Val = $"heading {level}" },
238
+ new BasedOn { Val = "Normal" },
239
+ new NextParagraphStyle { Val = "Normal" },
240
+ new PrimaryStyle(),
241
+ new StyleParagraphProperties(
242
+ new KeepNext(),
243
+ new KeepLines(),
244
+ new SpacingBetweenLines { Before = "240", After = "120" },
245
+ new OutlineLevel { Val = i }),
246
+ new StyleRunProperties(
247
+ new RunFonts { Ascii = fontConfig.HeadingFont, HighAnsi = fontConfig.HeadingFont },
248
+ new FontSize { Val = UnitConverter.FontSizeToSz(headingSizes[i]) },
249
+ new FontSizeComplexScript { Val = UnitConverter.FontSizeToSz(headingSizes[i]) },
250
+ new Bold()))
251
+ { Type = StyleValues.Paragraph, StyleId = $"Heading{level}" };
252
+ styles.Append(headingStyle);
253
+ }
254
+
255
+ // Title style
256
+ styles.Append(new Style(
257
+ new StyleName { Val = "Title" },
258
+ new BasedOn { Val = "Normal" },
259
+ new NextParagraphStyle { Val = "Normal" },
260
+ new PrimaryStyle(),
261
+ new StyleParagraphProperties(
262
+ new Justification { Val = JustificationValues.Center },
263
+ new SpacingBetweenLines { After = "300" }),
264
+ new StyleRunProperties(
265
+ new RunFonts { Ascii = fontConfig.HeadingFont, HighAnsi = fontConfig.HeadingFont },
266
+ new FontSize { Val = UnitConverter.FontSizeToSz(fontConfig.Heading1Size + 6) },
267
+ new FontSizeComplexScript { Val = UnitConverter.FontSizeToSz(fontConfig.Heading1Size + 6) }))
268
+ { Type = StyleValues.Paragraph, StyleId = "Title" });
269
+
270
+ // Subtitle style
271
+ styles.Append(new Style(
272
+ new StyleName { Val = "Subtitle" },
273
+ new BasedOn { Val = "Normal" },
274
+ new NextParagraphStyle { Val = "Normal" },
275
+ new StyleParagraphProperties(
276
+ new Justification { Val = JustificationValues.Center },
277
+ new SpacingBetweenLines { After = "200" }),
278
+ new StyleRunProperties(
279
+ new Color { Val = "5A5A5A" },
280
+ new FontSize { Val = UnitConverter.FontSizeToSz(fontConfig.BodySize + 2) }))
281
+ { Type = StyleValues.Paragraph, StyleId = "Subtitle" });
282
+
283
+ stylesPart.Styles = styles;
284
+ stylesPart.Styles.Save();
285
+ }
286
+
287
+ private static void AddContentFromJson(Body body, string jsonContent, FontConfig fontConfig)
288
+ {
289
+ // Simple JSON content format: array of {type, text, level?}
290
+ // e.g. [{"type":"heading","text":"Introduction","level":1},{"type":"paragraph","text":"..."}]
291
+ try
292
+ {
293
+ using var jsonDoc = System.Text.Json.JsonDocument.Parse(jsonContent);
294
+ foreach (var element in jsonDoc.RootElement.EnumerateArray())
295
+ {
296
+ var type = element.GetProperty("type").GetString() ?? "paragraph";
297
+ var text = element.GetProperty("text").GetString() ?? "";
298
+
299
+ switch (type)
300
+ {
301
+ case "heading":
302
+ var level = element.TryGetProperty("level", out var lvl) ? lvl.GetInt32() : 1;
303
+ level = Math.Clamp(level, 1, 6);
304
+ body.Append(new Paragraph(
305
+ new ParagraphProperties(new ParagraphStyleId { Val = $"Heading{level}" }),
306
+ new Run(new Text(text))));
307
+ break;
308
+
309
+ case "paragraph":
310
+ body.Append(new Paragraph(new Run(new Text(text))));
311
+ break;
312
+
313
+ case "pagebreak":
314
+ body.Append(new Paragraph(new Run(new Break { Type = BreakValues.Page })));
315
+ break;
316
+ }
317
+ }
318
+ }
319
+ catch (System.Text.Json.JsonException ex)
320
+ {
321
+ Console.Error.WriteLine($"Warning: could not parse content JSON: {ex.Message}");
322
+ }
323
+ }
324
+ }