@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

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 (656) hide show
  1. package/bin/mcode-webui.mjs +6 -2
  2. package/package.json +1 -1
  3. package/server/assets/agents/_default/prompt-base-all.md +121 -0
  4. package/server/assets/agents/_default/prompt-base-all.md.hbs +255 -0
  5. package/server/assets/agents/_default/prompt-base-windows.md +6 -0
  6. package/server/assets/agents/_default/prompt-base-windows.md.hbs +6 -0
  7. package/server/assets/agents/_default/prompt-base-worker.md +12 -0
  8. package/server/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  9. package/server/assets/agents/_default/prompt-session-branch.md +3 -0
  10. package/server/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  11. package/server/assets/agents/_default/prompt-session-root.md +4 -0
  12. package/server/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  13. package/server/assets/agents/_migration/README.md +20 -0
  14. package/server/assets/agents/_migration/coder/PERSONA-zh.md +10 -0
  15. package/server/assets/agents/_migration/coder/PERSONA.md +11 -0
  16. package/server/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  17. package/server/assets/agents/_migration/general/PERSONA-zh.md +11 -0
  18. package/server/assets/agents/_migration/general/PERSONA.md +11 -0
  19. package/server/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  20. package/server/assets/agents/_v2/AGENT_CONTEXT.md.hbs +222 -0
  21. package/server/assets/agents/_v2/coding/SYSTEM.md.hbs +161 -0
  22. package/server/assets/agents/_v2/explore.md.hbs +38 -0
  23. package/server/assets/agents/_v2/tui/SYSTEM.md.hbs +147 -0
  24. package/server/assets/agents/_v2/verifier.md.hbs +32 -0
  25. package/server/assets/agents/_v2/work/SYSTEM.md.hbs +173 -0
  26. package/server/assets/agents/_v2/worker.md.hbs +27 -0
  27. package/server/assets/agents/builtin-agents.json +1 -0
  28. package/server/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  29. package/server/assets/agents/desktop-task/archive-title/system-zh.md +1 -0
  30. package/server/assets/agents/desktop-task/checkpoint/system.md +15 -0
  31. package/server/assets/agents/desktop-task/output-revision/system.md +1 -0
  32. package/server/assets/agents/desktop-task/retry/continuation.md +4 -0
  33. package/server/assets/agents/desktop-task/session-title/system.md +41 -0
  34. package/server/assets/agents/explore/PERSONA-zh.md +8 -0
  35. package/server/assets/agents/explore/PERSONA.md +8 -0
  36. package/server/assets/agents/explore/agent.md +14 -0
  37. package/server/assets/agents/explore/system-prompt.md.hbs +35 -0
  38. package/server/assets/agents/greeting-zh.md +61 -0
  39. package/server/assets/agents/greeting.md +61 -0
  40. package/server/assets/agents/managed-prompts.json +54 -0
  41. package/server/assets/agents/mavis/PERSONA-zh.md +7 -0
  42. package/server/assets/agents/mavis/PERSONA.md +7 -0
  43. package/server/assets/agents/mavis/features/cron.md.hbs +23 -0
  44. package/server/assets/agents/mavis/features/delegation.md.hbs +56 -0
  45. package/server/assets/agents/mavis/features/memory.md.hbs +61 -0
  46. package/server/assets/agents/mavis/features/recoverable-deletion.md.hbs +10 -0
  47. package/server/assets/agents/mavis/features/task-management.md.hbs +11 -0
  48. package/server/assets/agents/mavis/features/web-search.md.hbs +11 -0
  49. package/server/assets/agents/mavis/modes/coding/online/PERSONA-zh.md.hbs +20 -0
  50. package/server/assets/agents/mavis/modes/coding/online/PERSONA.md.hbs +20 -0
  51. package/server/assets/agents/mavis/modes/coding/online/SYSTEM.md.hbs +159 -0
  52. package/server/assets/agents/mavis/modes/work/online/PERSONA-zh.md.hbs +20 -0
  53. package/server/assets/agents/mavis/modes/work/online/PERSONA.md.hbs +20 -0
  54. package/server/assets/agents/mavis/modes/work/online/SYSTEM.md.hbs +161 -0
  55. package/server/assets/agents/mavis/prompt-session-root.md +4 -0
  56. package/server/assets/agents/mavis/prompt-session-root.md.hbs +4 -0
  57. package/server/assets/agents/mavis/skills/control-in-app-browser/SKILL.md +491 -0
  58. package/server/assets/agents/mavis/skills/minimax-code-product/SKILL.md +114 -0
  59. package/server/assets/agents/mavis/skills/minimax-code-product/references/account-models.md +32 -0
  60. package/server/assets/agents/mavis/skills/minimax-code-product/references/agents.md +25 -0
  61. package/server/assets/agents/mavis/skills/minimax-code-product/references/extensions.md +33 -0
  62. package/server/assets/agents/mavis/skills/minimax-code-product/references/workflows.md +30 -0
  63. package/server/assets/agents/mavis/system-prompt.md.hbs +97 -0
  64. package/server/assets/agents/prompt-exemptions.json +38 -0
  65. package/server/assets/agents/verifier/PERSONA-zh.md +8 -0
  66. package/server/assets/agents/verifier/PERSONA.md +8 -0
  67. package/server/assets/agents/verifier/agent.md +17 -0
  68. package/server/assets/agents/verifier/system-prompt.md.hbs +28 -0
  69. package/server/assets/agents/worker/PERSONA-zh.md +8 -0
  70. package/server/assets/agents/worker/PERSONA.md +8 -0
  71. package/server/assets/agents/worker/agent.md +18 -0
  72. package/server/assets/agents/worker/system-prompt.md.hbs +22 -0
  73. package/server/assets/agents/workflow/code-review/review-candidates.md +120 -0
  74. package/server/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  75. package/server/assets/agents/workflow/goal/budget-limit.md +16 -0
  76. package/server/assets/agents/workflow/goal/continuation.md +62 -0
  77. package/server/assets/agents/workflow/goal/objective-updated.md +16 -0
  78. package/server/assets/agents/workflow/goal/recovery-terminal-audit.md +12 -0
  79. package/server/assets/agents/workflow/goal/recovery.md +11 -0
  80. package/server/assets/agents/workflow/goal/terminal-audit.md +9 -0
  81. package/server/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  82. package/server/assets/agents/workflow/prompt-hook/system.md +0 -0
  83. package/server/assets/models-dev-catalog.json.gz +0 -0
  84. package/server/assets/prompts/code-review/review-candidates.md +120 -0
  85. package/server/assets/prompts/code-review/reviewer-system.md +75 -0
  86. package/server/assets/skills/code-review/SKILL.md +51 -0
  87. package/server/assets/skills/cu-desktop/SKILL.md +257 -0
  88. package/server/assets/skills/deep-research/SKILL.md +219 -0
  89. package/server/assets/skills/deep-research/scripts/render_plan.py +33 -0
  90. package/server/assets/skills/deep-research/steps/1_background.md +65 -0
  91. package/server/assets/skills/deep-research/steps/2_judgment.md +66 -0
  92. package/server/assets/skills/deep-research/steps/3_analysis.md +114 -0
  93. package/server/assets/skills/deep-research/steps/4_research.md +161 -0
  94. package/server/assets/skills/deep-research/steps/5_writing.md +358 -0
  95. package/server/assets/skills/deploy-website/SKILL.md +55 -0
  96. package/server/assets/skills/docx/LICENSE +21 -0
  97. package/server/assets/skills/docx/SKILL.md +261 -0
  98. package/server/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  99. package/server/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  100. package/server/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  101. package/server/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  102. package/server/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  103. package/server/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  104. package/server/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  105. package/server/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  106. package/server/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  107. package/server/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  108. package/server/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  109. package/server/assets/skills/docx/docs/acceptance.md +139 -0
  110. package/server/assets/skills/docx/docs/anti-patterns.md +14 -0
  111. package/server/assets/skills/docx/docs/backends.md +116 -0
  112. package/server/assets/skills/docx/docs/evidence.md +73 -0
  113. package/server/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  114. package/server/assets/skills/docx/docs/index.md +50 -0
  115. package/server/assets/skills/docx/docs/rendered-delivery.md +125 -0
  116. package/server/assets/skills/docx/docs/router.md +122 -0
  117. package/server/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  118. package/server/assets/skills/docx/docs/task-apply-template.md +141 -0
  119. package/server/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  120. package/server/assets/skills/docx/docs/task-create.md +124 -0
  121. package/server/assets/skills/docx/docs/task-edit-fill.md +69 -0
  122. package/server/assets/skills/docx/docs/task-read-content.md +148 -0
  123. package/server/assets/skills/docx/docs/task-read-rendered.md +78 -0
  124. package/server/assets/skills/docx/docs/task-read-structure.md +93 -0
  125. package/server/assets/skills/docx/docs/task-repair-layout.md +70 -0
  126. package/server/assets/skills/docx/docs/template-dsl.md +32 -0
  127. package/server/assets/skills/docx/docs/track-changes.md +15 -0
  128. package/server/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  129. package/server/assets/skills/docx/references/cjk_typography.md +357 -0
  130. package/server/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  131. package/server/assets/skills/docx/references/comments_guide.md +191 -0
  132. package/server/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  133. package/server/assets/skills/docx/references/design_principles.md +819 -0
  134. package/server/assets/skills/docx/references/openxml_element_order.md +308 -0
  135. package/server/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  136. package/server/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  137. package/server/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  138. package/server/assets/skills/docx/references/openxml_namespaces.md +82 -0
  139. package/server/assets/skills/docx/references/openxml_units.md +72 -0
  140. package/server/assets/skills/docx/references/sample-patch-plans.json +22 -0
  141. package/server/assets/skills/docx/references/sample-task-intents.json +5 -0
  142. package/server/assets/skills/docx/references/sample-template-manifests.json +21 -0
  143. package/server/assets/skills/docx/references/scenario_a_create.md +284 -0
  144. package/server/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  145. package/server/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  146. package/server/assets/skills/docx/references/track_changes_guide.md +200 -0
  147. package/server/assets/skills/docx/references/troubleshooting.md +506 -0
  148. package/server/assets/skills/docx/references/typography_guide.md +294 -0
  149. package/server/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  150. package/server/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  151. package/server/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  152. package/server/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  153. package/server/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  154. package/server/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  155. package/server/assets/skills/docx/scripts/docx_preview.sh +37 -0
  156. package/server/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  157. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj +19 -0
  158. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Cli/Program.cs +18 -0
  159. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/MiniMaxAIDocx.Core.csproj +15 -0
  168. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  169. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  170. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  171. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  172. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  173. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  174. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  175. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  176. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  177. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  178. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  179. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  180. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  181. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  182. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  183. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  184. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  185. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ImageSamples.cs +917 -0
  186. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  187. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  188. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  189. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TableSamples.cs +1163 -0
  190. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  191. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/CjkHelper.cs +39 -0
  192. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/FontDefaults.cs +24 -0
  193. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Typography/PageSizes.cs +20 -0
  194. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  195. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  196. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/ValidationResult.cs +23 -0
  197. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.Core/Validation/XsdValidator.cs +69 -0
  198. package/server/assets/skills/docx/scripts/dotnet/MiniMaxAIDocx.slnx +4 -0
  199. package/server/assets/skills/docx/scripts/env_check.ps1 +327 -0
  200. package/server/assets/skills/docx/scripts/env_check.sh +340 -0
  201. package/server/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  202. package/server/assets/skills/docx/scripts/pack_docx.py +31 -0
  203. package/server/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  204. package/server/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  205. package/server/assets/skills/docx/scripts/rendered_report.py +609 -0
  206. package/server/assets/skills/docx/scripts/setup.ps1 +542 -0
  207. package/server/assets/skills/docx/scripts/setup.sh +537 -0
  208. package/server/assets/skills/docx/scripts/unpack_docx.py +29 -0
  209. package/server/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  210. package/server/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  211. package/server/assets/skills/edit-deployed-website/SKILL.md +27 -0
  212. package/server/assets/skills/init/SKILL.md +137 -0
  213. package/server/assets/skills/lark-tools/SKILL.md +321 -0
  214. package/server/assets/skills/lark-tools/cli-skills/lark-approval/SKILL.md +48 -0
  215. package/server/assets/skills/lark-tools/cli-skills/lark-attendance/SKILL.md +57 -0
  216. package/server/assets/skills/lark-tools/cli-skills/lark-base/SKILL.md +372 -0
  217. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/dashboard-block-data-config.md +350 -0
  218. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/examples.md +130 -0
  219. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/formula-field-guide.md +735 -0
  220. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-advperm-disable.md +83 -0
  221. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-advperm-enable.md +80 -0
  222. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-base-copy.md +74 -0
  223. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-base-create.md +68 -0
  224. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-base-get.md +39 -0
  225. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-arrange.md +83 -0
  226. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-block-create.md +108 -0
  227. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-block-delete.md +46 -0
  228. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-block-get.md +57 -0
  229. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-block-list.md +53 -0
  230. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-block-update.md +84 -0
  231. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-create.md +73 -0
  232. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-delete.md +44 -0
  233. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-get.md +59 -0
  234. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-list.md +52 -0
  235. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard-update.md +69 -0
  236. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-dashboard.md +240 -0
  237. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-data-query.md +375 -0
  238. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-create.md +104 -0
  239. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-delete.md +51 -0
  240. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-get.md +42 -0
  241. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-list.md +44 -0
  242. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-search-options.md +48 -0
  243. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-update.md +97 -0
  244. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field.md +22 -0
  245. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-create.md +87 -0
  246. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-delete.md +64 -0
  247. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-get.md +68 -0
  248. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-list.md +73 -0
  249. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-questions-create.md +118 -0
  250. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-questions-delete.md +68 -0
  251. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-questions-list.md +84 -0
  252. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-questions-update.md +92 -0
  253. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-questions.md +23 -0
  254. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-update.md +82 -0
  255. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form.md +24 -0
  256. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-history.md +16 -0
  257. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-batch-create.md +76 -0
  258. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-batch-update.md +71 -0
  259. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-delete.md +51 -0
  260. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-get.md +38 -0
  261. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-history-list.md +86 -0
  262. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-list.md +83 -0
  263. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-search.md +72 -0
  264. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-upload-attachment.md +51 -0
  265. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record-upsert.md +89 -0
  266. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-record.md +28 -0
  267. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-role-create.md +89 -0
  268. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-role-delete.md +83 -0
  269. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-role-get.md +87 -0
  270. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-role-list.md +81 -0
  271. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-role-update.md +94 -0
  272. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-shortcut-field-properties.md +679 -0
  273. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-shortcut-record-value.md +200 -0
  274. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table-create.md +62 -0
  275. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table-delete.md +51 -0
  276. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table-get.md +46 -0
  277. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table-list.md +43 -0
  278. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table-update.md +49 -0
  279. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-table.md +20 -0
  280. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-create.md +83 -0
  281. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-delete.md +48 -0
  282. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-card.md +38 -0
  283. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-filter.md +38 -0
  284. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-group.md +38 -0
  285. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-sort.md +38 -0
  286. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-timebar.md +38 -0
  287. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get-visible-fields.md +38 -0
  288. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-get.md +38 -0
  289. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-list.md +44 -0
  290. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-rename.md +44 -0
  291. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-card.md +81 -0
  292. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-filter.md +92 -0
  293. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-group.md +77 -0
  294. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-sort.md +77 -0
  295. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-timebar.md +79 -0
  296. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view-set-visible-fields.md +73 -0
  297. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-view.md +44 -0
  298. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-create.md +180 -0
  299. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-disable.md +94 -0
  300. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-enable.md +94 -0
  301. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-get.md +147 -0
  302. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-guide.md +718 -0
  303. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-list.md +123 -0
  304. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-schema.md +935 -0
  305. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow-update.md +167 -0
  306. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workflow.md +23 -0
  307. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-workspace.md +18 -0
  308. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lookup-field-guide.md +508 -0
  309. package/server/assets/skills/lark-tools/cli-skills/lark-base/references/role-config.md +532 -0
  310. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/SKILL.md +143 -0
  311. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-agenda.md +78 -0
  312. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-create.md +109 -0
  313. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-freebusy.md +124 -0
  314. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-room-find.md +89 -0
  315. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-rsvp.md +42 -0
  316. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-schedule-meeting.md +194 -0
  317. package/server/assets/skills/lark-tools/cli-skills/lark-calendar/references/lark-calendar-suggestion.md +125 -0
  318. package/server/assets/skills/lark-tools/cli-skills/lark-contact/SKILL.md +23 -0
  319. package/server/assets/skills/lark-tools/cli-skills/lark-contact/references/lark-contact-get-user.md +47 -0
  320. package/server/assets/skills/lark-tools/cli-skills/lark-contact/references/lark-contact-search-user.md +39 -0
  321. package/server/assets/skills/lark-tools/cli-skills/lark-doc/SKILL.md +189 -0
  322. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-create.md +673 -0
  323. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-fetch.md +120 -0
  324. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-media-download.md +50 -0
  325. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-media-insert.md +51 -0
  326. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-media-preview.md +41 -0
  327. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-search.md +213 -0
  328. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-update.md +264 -0
  329. package/server/assets/skills/lark-tools/cli-skills/lark-doc/references/lark-doc-whiteboard-update.md +6 -0
  330. package/server/assets/skills/lark-tools/cli-skills/lark-drive/SKILL.md +294 -0
  331. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-add-comment.md +99 -0
  332. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-create-folder.md +73 -0
  333. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-create-shortcut.md +103 -0
  334. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-delete.md +79 -0
  335. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-download.md +31 -0
  336. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-export-download.md +50 -0
  337. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-export.md +100 -0
  338. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-import.md +132 -0
  339. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-move.md +120 -0
  340. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-reactions.md +113 -0
  341. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-task-result.md +264 -0
  342. package/server/assets/skills/lark-tools/cli-skills/lark-drive/references/lark-drive-upload.md +67 -0
  343. package/server/assets/skills/lark-tools/cli-skills/lark-event/SKILL.md +21 -0
  344. package/server/assets/skills/lark-tools/cli-skills/lark-event/references/lark-event-subscribe.md +217 -0
  345. package/server/assets/skills/lark-tools/cli-skills/lark-im/SKILL.md +140 -0
  346. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-chat-create.md +156 -0
  347. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-chat-identity.md +55 -0
  348. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-chat-messages-list.md +142 -0
  349. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-chat-search.md +114 -0
  350. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-chat-update.md +84 -0
  351. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-messages-mget.md +95 -0
  352. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-messages-reply.md +222 -0
  353. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-messages-resources-download.md +94 -0
  354. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-messages-search.md +213 -0
  355. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-messages-send.md +223 -0
  356. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-reactions.md +297 -0
  357. package/server/assets/skills/lark-tools/cli-skills/lark-im/references/lark-im-threads-messages-list.md +111 -0
  358. package/server/assets/skills/lark-tools/cli-skills/lark-mail/SKILL.md +550 -0
  359. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-draft-create.md +110 -0
  360. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-draft-edit.md +376 -0
  361. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-forward.md +208 -0
  362. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-message.md +201 -0
  363. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-messages.md +108 -0
  364. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-reply-all.md +184 -0
  365. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-reply.md +220 -0
  366. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-send.md +178 -0
  367. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-signature.md +98 -0
  368. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-thread.md +111 -0
  369. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-triage.md +122 -0
  370. package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-watch.md +94 -0
  371. package/server/assets/skills/lark-tools/cli-skills/lark-minutes/SKILL.md +116 -0
  372. package/server/assets/skills/lark-tools/cli-skills/lark-minutes/references/lark-minutes-download.md +119 -0
  373. package/server/assets/skills/lark-tools/cli-skills/lark-minutes/references/lark-minutes-search.md +180 -0
  374. package/server/assets/skills/lark-tools/cli-skills/lark-openapi-explorer/SKILL.md +153 -0
  375. package/server/assets/skills/lark-tools/cli-skills/lark-shared/SKILL.md +141 -0
  376. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/SKILL.md +262 -0
  377. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-add-dimension.md +51 -0
  378. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-append.md +56 -0
  379. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-batch-set-style.md +53 -0
  380. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-create-filter-view-condition.md +42 -0
  381. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-create-filter-view.md +42 -0
  382. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-create.md +69 -0
  383. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-dimension.md +53 -0
  384. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-dropdown.md +46 -0
  385. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-filter-view-condition.md +26 -0
  386. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-filter-view.md +25 -0
  387. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-export.md +51 -0
  388. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-find.md +62 -0
  389. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-formula.md +89 -0
  390. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-dropdown.md +43 -0
  391. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-filter-view-condition.md +27 -0
  392. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-filter-view.md +26 -0
  393. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-info.md +43 -0
  394. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-insert-dimension.md +51 -0
  395. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-list-filter-view-conditions.md +28 -0
  396. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-list-filter-views.md +26 -0
  397. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-merge-cells.md +47 -0
  398. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-move-dimension.md +52 -0
  399. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-read.md +61 -0
  400. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-replace.md +62 -0
  401. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-set-dropdown.md +62 -0
  402. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-set-style.md +71 -0
  403. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-unmerge-cells.md +46 -0
  404. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-update-dimension.md +60 -0
  405. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-update-dropdown.md +51 -0
  406. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-update-filter-view-condition.md +27 -0
  407. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-update-filter-view.md +24 -0
  408. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-write-image.md +65 -0
  409. package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-write.md +60 -0
  410. package/server/assets/skills/lark-tools/cli-skills/lark-skill-maker/SKILL.md +85 -0
  411. package/server/assets/skills/lark-tools/cli-skills/lark-slides/SKILL.md +368 -0
  412. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/examples.md +179 -0
  413. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/lark-slides-create.md +137 -0
  414. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/lark-slides-media-upload.md +143 -0
  415. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/lark-slides-xml-presentation-slide-create.md +215 -0
  416. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/lark-slides-xml-presentation-slide-delete.md +119 -0
  417. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/lark-slides-xml-presentations-get.md +94 -0
  418. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/slide-templates.md +199 -0
  419. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/slides_demo.xml +226 -0
  420. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/slides_xml_schema_definition.xml +3004 -0
  421. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/xml-format-guide.md +369 -0
  422. package/server/assets/skills/lark-tools/cli-skills/lark-slides/references/xml-schema-quick-ref.md +215 -0
  423. package/server/assets/skills/lark-tools/cli-skills/lark-task/SKILL.md +151 -0
  424. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-assign.md +35 -0
  425. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-comment.md +28 -0
  426. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-complete.md +27 -0
  427. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-create.md +51 -0
  428. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-followers.md +32 -0
  429. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-get-my-tasks.md +55 -0
  430. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-get-related-tasks.md +53 -0
  431. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-reminder.md +36 -0
  432. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-reopen.md +27 -0
  433. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-search.md +41 -0
  434. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-set-ancestor.md +32 -0
  435. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-subscribe-event.md +86 -0
  436. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-tasklist-create.md +35 -0
  437. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-tasklist-members.md +36 -0
  438. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-tasklist-search.md +38 -0
  439. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-tasklist-task-add.md +38 -0
  440. package/server/assets/skills/lark-tools/cli-skills/lark-task/references/lark-task-update.md +37 -0
  441. package/server/assets/skills/lark-tools/cli-skills/lark-vc/SKILL.md +143 -0
  442. package/server/assets/skills/lark-tools/cli-skills/lark-vc/references/lark-vc-notes.md +126 -0
  443. package/server/assets/skills/lark-tools/cli-skills/lark-vc/references/lark-vc-recording.md +141 -0
  444. package/server/assets/skills/lark-tools/cli-skills/lark-vc/references/lark-vc-search.md +159 -0
  445. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard/SKILL.md +118 -0
  446. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard/references/lark-whiteboard-query.md +49 -0
  447. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard/references/lark-whiteboard-update.md +97 -0
  448. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/SKILL.md +236 -0
  449. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/connectors.md +102 -0
  450. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/content.md +40 -0
  451. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/layout.md +374 -0
  452. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/schema.md +333 -0
  453. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/style.md +318 -0
  454. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/references/typography.md +73 -0
  455. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/architecture.md +433 -0
  456. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/bar-chart.md +181 -0
  457. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/comparison.md +135 -0
  458. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/fishbone.md +238 -0
  459. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/flowchart.md +185 -0
  460. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/flywheel.md +195 -0
  461. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/funnel.md +101 -0
  462. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/line-chart.md +208 -0
  463. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/mermaid.md +136 -0
  464. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/milestone.md +139 -0
  465. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/organization.md +175 -0
  466. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/pyramid.md +99 -0
  467. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/swimlane.md +370 -0
  468. package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/treemap.md +210 -0
  469. package/server/assets/skills/lark-tools/cli-skills/lark-wiki/SKILL.md +93 -0
  470. package/server/assets/skills/lark-tools/cli-skills/lark-wiki/references/lark-wiki-move.md +183 -0
  471. package/server/assets/skills/lark-tools/cli-skills/lark-wiki/references/lark-wiki-node-create.md +127 -0
  472. package/server/assets/skills/lark-tools/cli-skills/lark-workflow-meeting-summary/SKILL.md +99 -0
  473. package/server/assets/skills/lark-tools/cli-skills/lark-workflow-standup-report/SKILL.md +120 -0
  474. package/server/assets/skills/lark-tools/references/commands-macos-linux.md +42 -0
  475. package/server/assets/skills/lark-tools/references/commands-windows-powershell.md +54 -0
  476. package/server/assets/skills/lark-tools/references/storage-paths.md +21 -0
  477. package/server/assets/skills/llm-call/SKILL.md +50 -0
  478. package/server/assets/skills/llm-call/scripts/llm_call.py +458 -0
  479. package/server/assets/skills/mcode-tools-master/SKILL.md +133 -0
  480. package/server/assets/skills/pdf/SKILL.md +287 -0
  481. package/server/assets/skills/pdf/docs/advanced-reference.md +711 -0
  482. package/server/assets/skills/pdf/docs/ai-voice-cloning-regulatory-report-case.md +303 -0
  483. package/server/assets/skills/pdf/docs/annual-report-financial-digest-latex-case.md +233 -0
  484. package/server/assets/skills/pdf/docs/create-guide.md +438 -0
  485. package/server/assets/skills/pdf/docs/design-guide.md +204 -0
  486. package/server/assets/skills/pdf/docs/docx-contract-roundtrip-professional-case.md +328 -0
  487. package/server/assets/skills/pdf/docs/email-translation-goldman-two-sessions-case.md +346 -0
  488. package/server/assets/skills/pdf/docs/forms-guide.md +462 -0
  489. package/server/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  490. package/server/assets/skills/pdf/docs/italy-schengen-visa-acroform-case.md +22 -0
  491. package/server/assets/skills/pdf/docs/latex-academic-thesis-guide.md +234 -0
  492. package/server/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  493. package/server/assets/skills/pdf/docs/markdown-static-academic-data-viz-case.md +280 -0
  494. package/server/assets/skills/pdf/docs/pitfalls-index.md +798 -0
  495. package/server/assets/skills/pdf/docs/read-guide.md +358 -0
  496. package/server/assets/skills/pdf/docs/reformat-guide.md +238 -0
  497. package/server/assets/skills/pdf/docs/skill-readme-archive.md +152 -0
  498. package/server/assets/skills/pdf/docs/troubleshooting.md +86 -0
  499. package/server/assets/skills/pdf/docs/vision-guide.md +188 -0
  500. package/server/assets/skills/pdf/scripts/__init__.py +0 -0
  501. package/server/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  502. package/server/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  503. package/server/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  504. package/server/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  505. package/server/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  506. package/server/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  507. package/server/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  508. package/server/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  509. package/server/assets/skills/pdf/scripts/make.sh +388 -0
  510. package/server/assets/skills/pdf/scripts/merge.py +112 -0
  511. package/server/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  512. package/server/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  513. package/server/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  514. package/server/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  515. package/server/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  516. package/server/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  517. package/server/assets/skills/pdf/scripts/render/__init__.py +0 -0
  518. package/server/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  519. package/server/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  520. package/server/assets/skills/pdf/scripts/render_html.cjs +205 -0
  521. package/server/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  522. package/server/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  523. package/server/assets/skills/pdf/templates/INDEX.md +97 -0
  524. package/server/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  525. package/server/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  526. package/server/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  527. package/server/assets/skills/pdf/templates/brand-guide-2page/cases/minimax-web-brand-guide/README.md +155 -0
  528. package/server/assets/skills/pdf/templates/brand-guide-2page/cases/minimax-web-brand-guide/source.html +188 -0
  529. package/server/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  530. package/server/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  531. package/server/assets/skills/pdf/templates/data-viz-report/cases/annual-report-financial-digest-latex/README.md +12 -0
  532. package/server/assets/skills/pdf/templates/data-viz-report/cases/annual-report-financial-digest-latex/build_charts.py +341 -0
  533. package/server/assets/skills/pdf/templates/data-viz-report/cases/annual-report-financial-digest-latex/source.tex +161 -0
  534. package/server/assets/skills/pdf/templates/data-viz-report/cases/apple-m-ai-static-academic/assets/fig_1_1_table_1_1_specs.png +0 -0
  535. package/server/assets/skills/pdf/templates/data-viz-report/cases/apple-m-ai-static-academic/assets/fig_1_2_table_1_2_geekbench.png +0 -0
  536. package/server/assets/skills/pdf/templates/data-viz-report/cases/apple-m-ai-static-academic/assets/fig_1_3_mmax_generation.png +0 -0
  537. package/server/assets/skills/pdf/templates/data-viz-report/cases/apple-m-ai-static-academic/source.html +656 -0
  538. package/server/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  539. package/server/assets/skills/pdf/templates/form-fill-acroform/README.md +198 -0
  540. package/server/assets/skills/pdf/templates/form-fill-acroform/cases/italy-schengen-visa-example/USER-FINAL-SUMMARY.template.md +42 -0
  541. package/server/assets/skills/pdf/templates/form-fill-acroform/cases/italy-schengen-visa-example/extract_pdfs_key_info.py +80 -0
  542. package/server/assets/skills/pdf/templates/form-fill-acroform/cases/italy-schengen-visa-example/field_values.case.json +233 -0
  543. package/server/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  544. package/server/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  545. package/server/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  546. package/server/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  547. package/server/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  548. package/server/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  549. package/server/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  550. package/server/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  551. package/server/assets/skills/pdf/templates/multilang-research-report/README.md +146 -0
  552. package/server/assets/skills/pdf/templates/multilang-research-report/cases/ai-voice-cloning-regulatory/source.html +244 -0
  553. package/server/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  554. package/server/assets/skills/pdf/templates/reformat-default/README.md +137 -0
  555. package/server/assets/skills/pdf/templates/reformat-default/cases/pku-contract-roundtrip/docx_engine.py +68 -0
  556. package/server/assets/skills/pdf/templates/reformat-default/cases/pku-contract-roundtrip/source.html +231 -0
  557. package/server/assets/skills/pdf/templates/reformat-default/cases/pku-contract-roundtrip/source.md +196 -0
  558. package/server/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  559. package/server/assets/skills/pdf/templates/translate-preserve-layout/README.md +147 -0
  560. package/server/assets/skills/pdf/templates/translate-preserve-layout/cases/goldman-china-two-sessions-cn.html +1660 -0
  561. package/server/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  562. package/server/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  563. package/server/assets/skills/pptx/SKILL.md +285 -0
  564. package/server/assets/skills/pptx/references/design-system.md +424 -0
  565. package/server/assets/skills/pptx/references/editing.md +162 -0
  566. package/server/assets/skills/pptx/references/element-map.md +229 -0
  567. package/server/assets/skills/pptx/references/pitfalls.md +205 -0
  568. package/server/assets/skills/pptx/references/pptxgenjs.md +420 -0
  569. package/server/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  570. package/server/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  571. package/server/assets/skills/pptx/references/slide-types.md +413 -0
  572. package/server/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  573. package/server/assets/skills/pptx/scripts/extract_comments.py +468 -0
  574. package/server/assets/skills/pptx/scripts/extract_images.py +226 -0
  575. package/server/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  576. package/server/assets/skills/pptx/scripts/mavis-ppt-map.cjs +280 -0
  577. package/server/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  578. package/server/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  579. package/server/assets/skills/resume-codex/SKILL.md +55 -0
  580. package/server/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  581. package/server/assets/skills/skill-creator/SKILL.md +190 -0
  582. package/server/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  583. package/server/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  584. package/server/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  585. package/server/assets/skills/skill-creator/references/description-rubric.md +83 -0
  586. package/server/assets/skills/skill-creator/references/skill-template.md +101 -0
  587. package/server/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  588. package/server/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  589. package/server/assets/skills/skill-refiner/SKILL.md +139 -0
  590. package/server/assets/skills/visual-page/SKILL.md +196 -0
  591. package/server/assets/skills/x-link-reader/SKILL.md +110 -0
  592. package/server/assets/skills/xlsx/SKILL.md +501 -0
  593. package/server/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  594. package/server/assets/skills/xlsx/docs/cases/superstore-multiformat/conversion_manifest.example.json +49 -0
  595. package/server/assets/skills/xlsx/docs/cases/superstore-multiformat/superstore_orders_print.html +17 -0
  596. package/server/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  597. package/server/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  598. package/server/assets/skills/xlsx/docs/pitfalls-index.md +760 -0
  599. package/server/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  600. package/server/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  601. package/server/assets/skills/xlsx/docs/superstore-multiformat-conversion-case.md +413 -0
  602. package/server/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  603. package/server/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  604. package/server/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  605. package/server/assets/skills/xlsx/scripts/office/pack.py +159 -0
  606. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  607. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  608. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  609. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  610. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  611. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  612. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  613. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  614. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  615. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  616. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  617. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  618. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  619. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  620. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  621. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  622. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  623. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  624. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  625. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  626. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  627. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  628. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  629. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  630. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  631. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  632. package/server/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  633. package/server/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  634. package/server/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  635. package/server/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  636. package/server/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  637. package/server/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  638. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  639. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  640. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  641. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  642. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  643. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  644. package/server/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  645. package/server/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  646. package/server/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  647. package/server/assets/skills/xlsx/scripts/office/validate.py +117 -0
  648. package/server/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  649. package/server/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  650. package/server/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  651. package/server/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  652. package/server/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  653. package/server/assets/skills/xlsx/scripts/recalc.py +450 -0
  654. package/server/mcode-tools.js +2 -0
  655. package/server/package-info.json +1 -1
  656. package/server/server.js +2 -0
@@ -0,0 +1,851 @@
1
+ """
2
+ Base validator with common validation logic for document files.
3
+ """
4
+
5
+ import re
6
+ from pathlib import Path
7
+
8
+ import defusedxml.minidom
9
+ import lxml.etree
10
+
11
+
12
+ class BaseSchemaValidator:
13
+
14
+ IGNORED_VALIDATION_ERRORS = [
15
+ "hyphenationZone",
16
+ "purl.org/dc/terms",
17
+ ]
18
+
19
+ UNIQUE_ID_REQUIREMENTS = {
20
+ "comment": ("id", "file"),
21
+ "commentrangestart": ("id", "file"),
22
+ "commentrangeend": ("id", "file"),
23
+ "bookmarkstart": ("id", "file"),
24
+ "bookmarkend": ("id", "file"),
25
+ "sldid": ("id", "file"),
26
+ "sldmasterid": ("id", "global"),
27
+ "sldlayoutid": ("id", "global"),
28
+ "cm": ("authorid", "file"),
29
+ "sheet": ("sheetid", "file"),
30
+ "definedname": ("id", "file"),
31
+ "cxnsp": ("id", "file"),
32
+ "sp": ("id", "file"),
33
+ "pic": ("id", "file"),
34
+ "grpsp": ("id", "file"),
35
+ }
36
+
37
+ EXCLUDED_ID_CONTAINERS = {
38
+ "sectionlst",
39
+ }
40
+
41
+ ELEMENT_RELATIONSHIP_TYPES = {}
42
+
43
+ SCHEMA_MAPPINGS = {
44
+ "word": "ISO-IEC29500-4_2016/wml.xsd",
45
+ "ppt": "ISO-IEC29500-4_2016/pml.xsd",
46
+ "xl": "ISO-IEC29500-4_2016/sml.xsd",
47
+ "[Content_Types].xml": "ecma/fouth-edition/opc-contentTypes.xsd",
48
+ "app.xml": "ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd",
49
+ "core.xml": "ecma/fouth-edition/opc-coreProperties.xsd",
50
+ "custom.xml": "ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd",
51
+ ".rels": "ecma/fouth-edition/opc-relationships.xsd",
52
+ "people.xml": "microsoft/wml-2012.xsd",
53
+ "commentsIds.xml": "microsoft/wml-cid-2016.xsd",
54
+ "commentsExtensible.xml": "microsoft/wml-cex-2018.xsd",
55
+ "commentsExtended.xml": "microsoft/wml-2012.xsd",
56
+ "chart": "ISO-IEC29500-4_2016/dml-chart.xsd",
57
+ "theme": "ISO-IEC29500-4_2016/dml-main.xsd",
58
+ "drawing": "ISO-IEC29500-4_2016/dml-main.xsd",
59
+ }
60
+
61
+ MC_NAMESPACE = "http://schemas.openxmlformats.org/markup-compatibility/2006"
62
+ XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace"
63
+
64
+ PACKAGE_RELATIONSHIPS_NAMESPACE = (
65
+ "http://schemas.openxmlformats.org/package/2006/relationships"
66
+ )
67
+ OFFICE_RELATIONSHIPS_NAMESPACE = (
68
+ "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
69
+ )
70
+ CONTENT_TYPES_NAMESPACE = (
71
+ "http://schemas.openxmlformats.org/package/2006/content-types"
72
+ )
73
+
74
+ MAIN_CONTENT_FOLDERS = {"word", "ppt", "xl"}
75
+
76
+ OOXML_NAMESPACES = {
77
+ "http://schemas.openxmlformats.org/officeDocument/2006/math",
78
+ "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
79
+ "http://schemas.openxmlformats.org/schemaLibrary/2006/main",
80
+ "http://schemas.openxmlformats.org/drawingml/2006/main",
81
+ "http://schemas.openxmlformats.org/drawingml/2006/chart",
82
+ "http://schemas.openxmlformats.org/drawingml/2006/chartDrawing",
83
+ "http://schemas.openxmlformats.org/drawingml/2006/diagram",
84
+ "http://schemas.openxmlformats.org/drawingml/2006/picture",
85
+ "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing",
86
+ "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
87
+ "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
88
+ "http://schemas.openxmlformats.org/presentationml/2006/main",
89
+ "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
90
+ "http://schemas.openxmlformats.org/officeDocument/2006/sharedTypes",
91
+ "http://www.w3.org/XML/1998/namespace",
92
+ }
93
+
94
+ def __init__(self, unpacked_dir, original_file=None, verbose=False):
95
+ self.unpacked_dir = Path(unpacked_dir).resolve()
96
+ self.original_file = Path(original_file) if original_file else None
97
+ self.verbose = verbose
98
+
99
+ self.schemas_dir = Path(__file__).parent.parent / "schemas"
100
+
101
+ patterns = ["*.xml", "*.rels"]
102
+ self.xml_files = [
103
+ f for pattern in patterns for f in self.unpacked_dir.rglob(pattern)
104
+ ]
105
+
106
+ if not self.xml_files:
107
+ print(f"Warning: No XML files found in {self.unpacked_dir}")
108
+
109
+ def validate(self):
110
+ raise NotImplementedError("Subclasses must implement the validate method")
111
+
112
+ def repair(self) -> int:
113
+ return self.repair_whitespace_preservation()
114
+
115
+ def repair_whitespace_preservation(self) -> int:
116
+ repairs = 0
117
+
118
+ for xml_file in self.xml_files:
119
+ try:
120
+ content = xml_file.read_text(encoding="utf-8")
121
+ dom = defusedxml.minidom.parseString(content)
122
+ modified = False
123
+
124
+ for elem in dom.getElementsByTagName("*"):
125
+ if elem.tagName.endswith(":t") and elem.firstChild:
126
+ text = elem.firstChild.nodeValue
127
+ if text and (text.startswith((' ', '\t')) or text.endswith((' ', '\t'))):
128
+ if elem.getAttribute("xml:space") != "preserve":
129
+ elem.setAttribute("xml:space", "preserve")
130
+ text_preview = repr(text[:30]) + "..." if len(text) > 30 else repr(text)
131
+ print(f" Repaired: {xml_file.name}: Added xml:space='preserve' to {elem.tagName}: {text_preview}")
132
+ repairs += 1
133
+ modified = True
134
+
135
+ if modified:
136
+ xml_file.write_bytes(dom.toxml(encoding="UTF-8"))
137
+
138
+ except Exception:
139
+ pass
140
+
141
+ return repairs
142
+
143
+ def validate_xml(self):
144
+ errors = []
145
+
146
+ for xml_file in self.xml_files:
147
+ try:
148
+ lxml.etree.parse(str(xml_file))
149
+ except lxml.etree.XMLSyntaxError as e:
150
+ errors.append(
151
+ f" {xml_file.relative_to(self.unpacked_dir)}: "
152
+ f"Line {e.lineno}: {e.msg}"
153
+ )
154
+ except Exception as e:
155
+ errors.append(
156
+ f" {xml_file.relative_to(self.unpacked_dir)}: "
157
+ f"Unexpected error: {str(e)}"
158
+ )
159
+
160
+ if errors:
161
+ print(f"FAILED - Found {len(errors)} XML violations:")
162
+ for error in errors:
163
+ print(error)
164
+ return False
165
+ else:
166
+ if self.verbose:
167
+ print("PASSED - All XML files are well-formed")
168
+ return True
169
+
170
+ def validate_namespaces(self):
171
+ errors = []
172
+
173
+ for xml_file in self.xml_files:
174
+ try:
175
+ root = lxml.etree.parse(str(xml_file)).getroot()
176
+ declared = set(root.nsmap.keys()) - {None}
177
+
178
+ for attr_val in [
179
+ v for k, v in root.attrib.items() if k.endswith("Ignorable")
180
+ ]:
181
+ undeclared = set(attr_val.split()) - declared
182
+ errors.extend(
183
+ f" {xml_file.relative_to(self.unpacked_dir)}: "
184
+ f"Namespace '{ns}' in Ignorable but not declared"
185
+ for ns in undeclared
186
+ )
187
+ except lxml.etree.XMLSyntaxError:
188
+ continue
189
+
190
+ if errors:
191
+ print(f"FAILED - {len(errors)} namespace issues:")
192
+ for error in errors:
193
+ print(error)
194
+ return False
195
+ if self.verbose:
196
+ print("PASSED - All namespace prefixes properly declared")
197
+ return True
198
+
199
+ def validate_unique_ids(self):
200
+ errors = []
201
+ global_ids = {}
202
+
203
+ for xml_file in self.xml_files:
204
+ try:
205
+ root = lxml.etree.parse(str(xml_file)).getroot()
206
+ file_ids = {}
207
+
208
+ mc_elements = root.xpath(
209
+ ".//mc:AlternateContent", namespaces={"mc": self.MC_NAMESPACE}
210
+ )
211
+ for elem in mc_elements:
212
+ elem.getparent().remove(elem)
213
+
214
+ for elem in root.iter():
215
+ if not hasattr(elem, "tag") or callable(elem.tag):
216
+ continue
217
+ tag = (
218
+ elem.tag.split("}")[-1].lower()
219
+ if "}" in elem.tag
220
+ else elem.tag.lower()
221
+ )
222
+
223
+ if tag in self.UNIQUE_ID_REQUIREMENTS:
224
+ in_excluded_container = any(
225
+ ancestor.tag.split("}")[-1].lower() in self.EXCLUDED_ID_CONTAINERS
226
+ for ancestor in elem.iterancestors()
227
+ )
228
+ if in_excluded_container:
229
+ continue
230
+
231
+ attr_name, scope = self.UNIQUE_ID_REQUIREMENTS[tag]
232
+
233
+ id_value = None
234
+ for attr, value in elem.attrib.items():
235
+ attr_local = (
236
+ attr.split("}")[-1].lower()
237
+ if "}" in attr
238
+ else attr.lower()
239
+ )
240
+ if attr_local == attr_name:
241
+ id_value = value
242
+ break
243
+
244
+ if id_value is not None:
245
+ if scope == "global":
246
+ if id_value in global_ids:
247
+ prev_file, prev_line, prev_tag = global_ids[
248
+ id_value
249
+ ]
250
+ errors.append(
251
+ f" {xml_file.relative_to(self.unpacked_dir)}: "
252
+ f"Line {elem.sourceline}: Global ID '{id_value}' in <{tag}> "
253
+ f"already used in {prev_file} at line {prev_line} in <{prev_tag}>"
254
+ )
255
+ else:
256
+ global_ids[id_value] = (
257
+ xml_file.relative_to(self.unpacked_dir),
258
+ elem.sourceline,
259
+ tag,
260
+ )
261
+ elif scope == "file":
262
+ key = (tag, attr_name)
263
+ if key not in file_ids:
264
+ file_ids[key] = {}
265
+
266
+ if id_value in file_ids[key]:
267
+ prev_line = file_ids[key][id_value]
268
+ errors.append(
269
+ f" {xml_file.relative_to(self.unpacked_dir)}: "
270
+ f"Line {elem.sourceline}: Duplicate {attr_name}='{id_value}' in <{tag}> "
271
+ f"(first occurrence at line {prev_line})"
272
+ )
273
+ else:
274
+ file_ids[key][id_value] = elem.sourceline
275
+
276
+ except (lxml.etree.XMLSyntaxError, Exception) as e:
277
+ errors.append(
278
+ f" {xml_file.relative_to(self.unpacked_dir)}: Error: {e}"
279
+ )
280
+
281
+ if errors:
282
+ print(f"FAILED - Found {len(errors)} ID uniqueness violations:")
283
+ for error in errors:
284
+ print(error)
285
+ return False
286
+ else:
287
+ if self.verbose:
288
+ print("PASSED - All required IDs are unique")
289
+ return True
290
+
291
+ def validate_file_references(self):
292
+ errors = []
293
+
294
+ rels_files = list(self.unpacked_dir.rglob("*.rels"))
295
+
296
+ if not rels_files:
297
+ if self.verbose:
298
+ print("PASSED - No .rels files found")
299
+ return True
300
+
301
+ all_files = []
302
+ for file_path in self.unpacked_dir.rglob("*"):
303
+ if (
304
+ file_path.is_file()
305
+ and file_path.name != "[Content_Types].xml"
306
+ and not file_path.name.endswith(".rels")
307
+ ):
308
+ all_files.append(file_path.resolve())
309
+
310
+ all_referenced_files = set()
311
+
312
+ if self.verbose:
313
+ print(
314
+ f"Found {len(rels_files)} .rels files and {len(all_files)} target files"
315
+ )
316
+
317
+ for rels_file in rels_files:
318
+ try:
319
+ rels_root = lxml.etree.parse(str(rels_file)).getroot()
320
+
321
+ rels_dir = rels_file.parent
322
+
323
+ referenced_files = set()
324
+ broken_refs = []
325
+
326
+ for rel in rels_root.findall(
327
+ ".//ns:Relationship",
328
+ namespaces={"ns": self.PACKAGE_RELATIONSHIPS_NAMESPACE},
329
+ ):
330
+ target = rel.get("Target")
331
+ if target and not target.startswith(
332
+ ("http", "mailto:")
333
+ ):
334
+ if target.startswith("/"):
335
+ target_path = self.unpacked_dir / target.lstrip("/")
336
+ elif rels_file.name == ".rels":
337
+ target_path = self.unpacked_dir / target
338
+ else:
339
+ base_dir = rels_dir.parent
340
+ target_path = base_dir / target
341
+
342
+ try:
343
+ target_path = target_path.resolve()
344
+ if target_path.exists() and target_path.is_file():
345
+ referenced_files.add(target_path)
346
+ all_referenced_files.add(target_path)
347
+ else:
348
+ broken_refs.append((target, rel.sourceline))
349
+ except (OSError, ValueError):
350
+ broken_refs.append((target, rel.sourceline))
351
+
352
+ if broken_refs:
353
+ rel_path = rels_file.relative_to(self.unpacked_dir)
354
+ for broken_ref, line_num in broken_refs:
355
+ errors.append(
356
+ f" {rel_path}: Line {line_num}: Broken reference to {broken_ref}"
357
+ )
358
+
359
+ except Exception as e:
360
+ rel_path = rels_file.relative_to(self.unpacked_dir)
361
+ errors.append(f" Error parsing {rel_path}: {e}")
362
+
363
+ unreferenced_files = set(all_files) - all_referenced_files
364
+
365
+ if unreferenced_files:
366
+ for unref_file in sorted(unreferenced_files):
367
+ unref_rel_path = unref_file.relative_to(self.unpacked_dir)
368
+ errors.append(f" Unreferenced file: {unref_rel_path}")
369
+
370
+ if errors:
371
+ print(f"FAILED - Found {len(errors)} relationship validation errors:")
372
+ for error in errors:
373
+ print(error)
374
+ print(
375
+ "CRITICAL: These errors will cause the document to appear corrupt. "
376
+ + "Broken references MUST be fixed, "
377
+ + "and unreferenced files MUST be referenced or removed."
378
+ )
379
+ return False
380
+ else:
381
+ if self.verbose:
382
+ print(
383
+ "PASSED - All references are valid and all files are properly referenced"
384
+ )
385
+ return True
386
+
387
+ def validate_all_relationship_ids(self):
388
+ import lxml.etree
389
+
390
+ errors = []
391
+
392
+ for xml_file in self.xml_files:
393
+ if xml_file.suffix == ".rels":
394
+ continue
395
+
396
+ rels_dir = xml_file.parent / "_rels"
397
+ rels_file = rels_dir / f"{xml_file.name}.rels"
398
+
399
+ if not rels_file.exists():
400
+ continue
401
+
402
+ try:
403
+ rels_root = lxml.etree.parse(str(rels_file)).getroot()
404
+ rid_to_type = {}
405
+
406
+ for rel in rels_root.findall(
407
+ f".//{{{self.PACKAGE_RELATIONSHIPS_NAMESPACE}}}Relationship"
408
+ ):
409
+ rid = rel.get("Id")
410
+ rel_type = rel.get("Type", "")
411
+ if rid:
412
+ if rid in rid_to_type:
413
+ rels_rel_path = rels_file.relative_to(self.unpacked_dir)
414
+ errors.append(
415
+ f" {rels_rel_path}: Line {rel.sourceline}: "
416
+ f"Duplicate relationship ID '{rid}' (IDs must be unique)"
417
+ )
418
+ type_name = (
419
+ rel_type.split("/")[-1] if "/" in rel_type else rel_type
420
+ )
421
+ rid_to_type[rid] = type_name
422
+
423
+ xml_root = lxml.etree.parse(str(xml_file)).getroot()
424
+
425
+ r_ns = self.OFFICE_RELATIONSHIPS_NAMESPACE
426
+ rid_attrs_to_check = ["id", "embed", "link"]
427
+ for elem in xml_root.iter():
428
+ if not hasattr(elem, "tag") or callable(elem.tag):
429
+ continue
430
+ for attr_name in rid_attrs_to_check:
431
+ rid_attr = elem.get(f"{{{r_ns}}}{attr_name}")
432
+ if not rid_attr:
433
+ continue
434
+ xml_rel_path = xml_file.relative_to(self.unpacked_dir)
435
+ elem_name = (
436
+ elem.tag.split("}")[-1] if "}" in elem.tag else elem.tag
437
+ )
438
+
439
+ if rid_attr not in rid_to_type:
440
+ errors.append(
441
+ f" {xml_rel_path}: Line {elem.sourceline}: "
442
+ f"<{elem_name}> r:{attr_name} references non-existent relationship '{rid_attr}' "
443
+ f"(valid IDs: {', '.join(sorted(rid_to_type.keys())[:5])}{'...' if len(rid_to_type) > 5 else ''})"
444
+ )
445
+ elif attr_name == "id" and self.ELEMENT_RELATIONSHIP_TYPES:
446
+ expected_type = self._get_expected_relationship_type(
447
+ elem_name
448
+ )
449
+ if expected_type:
450
+ actual_type = rid_to_type[rid_attr]
451
+ if expected_type not in actual_type.lower():
452
+ errors.append(
453
+ f" {xml_rel_path}: Line {elem.sourceline}: "
454
+ f"<{elem_name}> references '{rid_attr}' which points to '{actual_type}' "
455
+ f"but should point to a '{expected_type}' relationship"
456
+ )
457
+
458
+ except Exception as e:
459
+ xml_rel_path = xml_file.relative_to(self.unpacked_dir)
460
+ errors.append(f" Error processing {xml_rel_path}: {e}")
461
+
462
+ if errors:
463
+ print(f"FAILED - Found {len(errors)} relationship ID reference errors:")
464
+ for error in errors:
465
+ print(error)
466
+ print("\nThese ID mismatches will cause the document to appear corrupt!")
467
+ return False
468
+ else:
469
+ if self.verbose:
470
+ print("PASSED - All relationship ID references are valid")
471
+ return True
472
+
473
+ def _get_expected_relationship_type(self, element_name):
474
+ elem_lower = element_name.lower()
475
+
476
+ if elem_lower in self.ELEMENT_RELATIONSHIP_TYPES:
477
+ return self.ELEMENT_RELATIONSHIP_TYPES[elem_lower]
478
+
479
+ if elem_lower.endswith("id") and len(elem_lower) > 2:
480
+ prefix = elem_lower[:-2]
481
+ if prefix.endswith("master"):
482
+ return prefix.lower()
483
+ elif prefix.endswith("layout"):
484
+ return prefix.lower()
485
+ else:
486
+ if prefix == "sld":
487
+ return "slide"
488
+ return prefix.lower()
489
+
490
+ if elem_lower.endswith("reference") and len(elem_lower) > 9:
491
+ prefix = elem_lower[:-9]
492
+ return prefix.lower()
493
+
494
+ return None
495
+
496
+ def validate_content_types(self):
497
+ errors = []
498
+
499
+ content_types_file = self.unpacked_dir / "[Content_Types].xml"
500
+ if not content_types_file.exists():
501
+ print("FAILED - [Content_Types].xml file not found")
502
+ return False
503
+
504
+ try:
505
+ root = lxml.etree.parse(str(content_types_file)).getroot()
506
+ declared_parts = set()
507
+ declared_extensions = set()
508
+
509
+ for override in root.findall(
510
+ f".//{{{self.CONTENT_TYPES_NAMESPACE}}}Override"
511
+ ):
512
+ part_name = override.get("PartName")
513
+ if part_name is not None:
514
+ declared_parts.add(part_name.lstrip("/"))
515
+
516
+ for default in root.findall(
517
+ f".//{{{self.CONTENT_TYPES_NAMESPACE}}}Default"
518
+ ):
519
+ extension = default.get("Extension")
520
+ if extension is not None:
521
+ declared_extensions.add(extension.lower())
522
+
523
+ declarable_roots = {
524
+ "sld",
525
+ "sldLayout",
526
+ "sldMaster",
527
+ "presentation",
528
+ "document",
529
+ "workbook",
530
+ "worksheet",
531
+ "theme",
532
+ }
533
+
534
+ media_extensions = {
535
+ "png": "image/png",
536
+ "jpg": "image/jpeg",
537
+ "jpeg": "image/jpeg",
538
+ "gif": "image/gif",
539
+ "bmp": "image/bmp",
540
+ "tiff": "image/tiff",
541
+ "wmf": "image/x-wmf",
542
+ "emf": "image/x-emf",
543
+ }
544
+
545
+ all_files = list(self.unpacked_dir.rglob("*"))
546
+ all_files = [f for f in all_files if f.is_file()]
547
+
548
+ for xml_file in self.xml_files:
549
+ path_str = str(xml_file.relative_to(self.unpacked_dir)).replace(
550
+ "\\", "/"
551
+ )
552
+
553
+ if any(
554
+ skip in path_str
555
+ for skip in [".rels", "[Content_Types]", "docProps/", "_rels/"]
556
+ ):
557
+ continue
558
+
559
+ try:
560
+ root_tag = lxml.etree.parse(str(xml_file)).getroot().tag
561
+ root_name = root_tag.split("}")[-1] if "}" in root_tag else root_tag
562
+
563
+ if root_name in declarable_roots and path_str not in declared_parts:
564
+ errors.append(
565
+ f" {path_str}: File with <{root_name}> root not declared in [Content_Types].xml"
566
+ )
567
+
568
+ except Exception:
569
+ continue
570
+
571
+ for file_path in all_files:
572
+ if file_path.suffix.lower() in {".xml", ".rels"}:
573
+ continue
574
+ if file_path.name == "[Content_Types].xml":
575
+ continue
576
+ if "_rels" in file_path.parts or "docProps" in file_path.parts:
577
+ continue
578
+
579
+ extension = file_path.suffix.lstrip(".").lower()
580
+ if extension and extension not in declared_extensions:
581
+ if extension in media_extensions:
582
+ relative_path = file_path.relative_to(self.unpacked_dir)
583
+ errors.append(
584
+ f' {relative_path}: File with extension \'{extension}\' not declared in [Content_Types].xml - should add: <Default Extension="{extension}" ContentType="{media_extensions[extension]}"/>'
585
+ )
586
+
587
+ except Exception as e:
588
+ errors.append(f" Error parsing [Content_Types].xml: {e}")
589
+
590
+ if errors:
591
+ print(f"FAILED - Found {len(errors)} content type declaration errors:")
592
+ for error in errors:
593
+ print(error)
594
+ return False
595
+ else:
596
+ if self.verbose:
597
+ print(
598
+ "PASSED - All content files are properly declared in [Content_Types].xml"
599
+ )
600
+ return True
601
+
602
+ def validate_file_against_xsd(self, xml_file, verbose=False):
603
+ xml_file = Path(xml_file).resolve()
604
+ unpacked_dir = self.unpacked_dir.resolve()
605
+
606
+ is_valid, current_errors = self._validate_single_file_xsd(
607
+ xml_file, unpacked_dir
608
+ )
609
+
610
+ if is_valid is None:
611
+ return None, set()
612
+ elif is_valid:
613
+ return True, set()
614
+
615
+ original_errors = self._get_original_file_errors(xml_file)
616
+
617
+ assert current_errors is not None
618
+ new_errors = current_errors - original_errors
619
+
620
+ new_errors = {
621
+ e for e in new_errors
622
+ if not any(pattern in e for pattern in self.IGNORED_VALIDATION_ERRORS)
623
+ }
624
+
625
+ if new_errors:
626
+ if verbose:
627
+ relative_path = xml_file.relative_to(unpacked_dir)
628
+ print(f"FAILED - {relative_path}: {len(new_errors)} new error(s)")
629
+ for error in list(new_errors)[:3]:
630
+ truncated = error[:250] + "..." if len(error) > 250 else error
631
+ print(f" - {truncated}")
632
+ return False, new_errors
633
+ else:
634
+ if verbose:
635
+ print(
636
+ f"PASSED - No new errors (original had {len(current_errors)} errors)"
637
+ )
638
+ return True, set()
639
+
640
+ def validate_against_xsd(self):
641
+ new_errors = []
642
+ original_error_count = 0
643
+ valid_count = 0
644
+ skipped_count = 0
645
+
646
+ for xml_file in self.xml_files:
647
+ relative_path = str(xml_file.relative_to(self.unpacked_dir))
648
+ is_valid, new_file_errors = self.validate_file_against_xsd(
649
+ xml_file, verbose=False
650
+ )
651
+
652
+ if is_valid is None:
653
+ skipped_count += 1
654
+ continue
655
+ elif is_valid and not new_file_errors:
656
+ valid_count += 1
657
+ continue
658
+ elif is_valid:
659
+ original_error_count += 1
660
+ valid_count += 1
661
+ continue
662
+
663
+ new_errors.append(f" {relative_path}: {len(new_file_errors)} new error(s)")
664
+ for error in list(new_file_errors)[:3]:
665
+ new_errors.append(
666
+ f" - {error[:250]}..." if len(error) > 250 else f" - {error}"
667
+ )
668
+
669
+ if self.verbose:
670
+ print(f"Validated {len(self.xml_files)} files:")
671
+ print(f" - Valid: {valid_count}")
672
+ print(f" - Skipped (no schema): {skipped_count}")
673
+ if original_error_count:
674
+ print(f" - With original errors (ignored): {original_error_count}")
675
+ print(
676
+ f" - With NEW errors: {len(new_errors) > 0 and len([e for e in new_errors if not e.startswith(' ')]) or 0}"
677
+ )
678
+
679
+ if new_errors:
680
+ print("\nFAILED - Found NEW validation errors:")
681
+ for error in new_errors:
682
+ print(error)
683
+ return False
684
+ else:
685
+ if self.verbose:
686
+ print("\nPASSED - No new XSD validation errors introduced")
687
+ return True
688
+
689
+ def _get_schema_path(self, xml_file):
690
+ if xml_file.name in self.SCHEMA_MAPPINGS:
691
+ return self.schemas_dir / self.SCHEMA_MAPPINGS[xml_file.name]
692
+
693
+ if xml_file.suffix == ".rels":
694
+ return self.schemas_dir / self.SCHEMA_MAPPINGS[".rels"]
695
+
696
+ if "charts/" in str(xml_file) and xml_file.name.startswith("chart"):
697
+ return self.schemas_dir / self.SCHEMA_MAPPINGS["chart"]
698
+
699
+ if "theme/" in str(xml_file) and xml_file.name.startswith("theme"):
700
+ return self.schemas_dir / self.SCHEMA_MAPPINGS["theme"]
701
+
702
+ if xml_file.parent.name in self.MAIN_CONTENT_FOLDERS:
703
+ return self.schemas_dir / self.SCHEMA_MAPPINGS[xml_file.parent.name]
704
+
705
+ return None
706
+
707
+ def _clean_ignorable_namespaces(self, xml_doc):
708
+ xml_string = lxml.etree.tostring(xml_doc, encoding="unicode")
709
+ xml_copy = lxml.etree.fromstring(xml_string)
710
+
711
+ for elem in xml_copy.iter():
712
+ attrs_to_remove = []
713
+
714
+ for attr in elem.attrib:
715
+ if "{" in attr:
716
+ ns = attr.split("}")[0][1:]
717
+ if ns not in self.OOXML_NAMESPACES:
718
+ attrs_to_remove.append(attr)
719
+
720
+ for attr in attrs_to_remove:
721
+ del elem.attrib[attr]
722
+
723
+ self._remove_ignorable_elements(xml_copy)
724
+
725
+ return lxml.etree.ElementTree(xml_copy)
726
+
727
+ def _remove_ignorable_elements(self, root):
728
+ elements_to_remove = []
729
+
730
+ for elem in list(root):
731
+ if not hasattr(elem, "tag") or callable(elem.tag):
732
+ continue
733
+
734
+ tag_str = str(elem.tag)
735
+ if tag_str.startswith("{"):
736
+ ns = tag_str.split("}")[0][1:]
737
+ if ns not in self.OOXML_NAMESPACES:
738
+ elements_to_remove.append(elem)
739
+ continue
740
+
741
+ self._remove_ignorable_elements(elem)
742
+
743
+ for elem in elements_to_remove:
744
+ root.remove(elem)
745
+
746
+ def _preprocess_for_mc_ignorable(self, xml_doc):
747
+ root = xml_doc.getroot()
748
+
749
+ if f"{{{self.MC_NAMESPACE}}}Ignorable" in root.attrib:
750
+ del root.attrib[f"{{{self.MC_NAMESPACE}}}Ignorable"]
751
+
752
+ return xml_doc
753
+
754
+ def _validate_single_file_xsd(self, xml_file, base_path):
755
+ schema_path = self._get_schema_path(xml_file)
756
+ if not schema_path:
757
+ return None, None
758
+
759
+ try:
760
+ with open(schema_path, "rb") as xsd_file:
761
+ parser = lxml.etree.XMLParser()
762
+ xsd_doc = lxml.etree.parse(
763
+ xsd_file, parser=parser, base_url=str(schema_path)
764
+ )
765
+ schema = lxml.etree.XMLSchema(xsd_doc)
766
+
767
+ with open(xml_file, "r") as f:
768
+ xml_doc = lxml.etree.parse(f)
769
+
770
+ xml_doc, _ = self._remove_template_tags_from_text_nodes(xml_doc)
771
+ xml_doc = self._preprocess_for_mc_ignorable(xml_doc)
772
+
773
+ relative_path = xml_file.relative_to(base_path)
774
+ if (
775
+ relative_path.parts
776
+ and relative_path.parts[0] in self.MAIN_CONTENT_FOLDERS
777
+ ):
778
+ xml_doc = self._clean_ignorable_namespaces(xml_doc)
779
+
780
+ if schema.validate(xml_doc):
781
+ return True, set()
782
+ else:
783
+ errors = set()
784
+ for error in schema.error_log:
785
+ errors.add(error.message)
786
+ return False, errors
787
+
788
+ except Exception as e:
789
+ return False, {str(e)}
790
+
791
+ def _get_original_file_errors(self, xml_file):
792
+ if self.original_file is None:
793
+ return set()
794
+
795
+ import tempfile
796
+ import zipfile
797
+
798
+ xml_file = Path(xml_file).resolve()
799
+ unpacked_dir = self.unpacked_dir.resolve()
800
+ relative_path = xml_file.relative_to(unpacked_dir)
801
+
802
+ with tempfile.TemporaryDirectory() as temp_dir:
803
+ temp_path = Path(temp_dir)
804
+
805
+ with zipfile.ZipFile(self.original_file, "r") as zip_ref:
806
+ zip_ref.extractall(temp_path)
807
+
808
+ original_xml_file = temp_path / relative_path
809
+
810
+ if not original_xml_file.exists():
811
+ return set()
812
+
813
+ is_valid, errors = self._validate_single_file_xsd(
814
+ original_xml_file, temp_path
815
+ )
816
+ return errors if errors else set()
817
+
818
+ def _remove_template_tags_from_text_nodes(self, xml_doc):
819
+ warnings = []
820
+ template_pattern = re.compile(r"\{\{[^}]*\}\}")
821
+
822
+ xml_string = lxml.etree.tostring(xml_doc, encoding="unicode")
823
+ xml_copy = lxml.etree.fromstring(xml_string)
824
+
825
+ def process_text_content(text, content_type):
826
+ if not text:
827
+ return text
828
+ matches = list(template_pattern.finditer(text))
829
+ if matches:
830
+ for match in matches:
831
+ warnings.append(
832
+ f"Found template tag in {content_type}: {match.group()}"
833
+ )
834
+ return template_pattern.sub("", text)
835
+ return text
836
+
837
+ for elem in xml_copy.iter():
838
+ if not hasattr(elem, "tag") or callable(elem.tag):
839
+ continue
840
+ tag_str = str(elem.tag)
841
+ if tag_str.endswith("}t") or tag_str == "t":
842
+ continue
843
+
844
+ elem.text = process_text_content(elem.text, "text content")
845
+ elem.tail = process_text_content(elem.tail, "tail content")
846
+
847
+ return lxml.etree.ElementTree(xml_copy), warnings
848
+
849
+
850
+ if __name__ == "__main__":
851
+ raise RuntimeError("This module should not be run directly.")