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.
- package/ALRAN_TOOLS_NOTICES.md +64 -0
- package/LICENSE +27 -0
- package/LICENSE-STATUS.md +21 -0
- package/NOTICE +6 -0
- package/README.md +289 -2
- package/THIRD_PARTY_NOTICES.md +113 -0
- package/alran-tools.js +3 -0
- package/assets/agents/_default/prompt-auto_classifier.md +185 -0
- package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
- package/assets/agents/_default/prompt-base-all.md +133 -0
- package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
- package/assets/agents/_default/prompt-base-windows.md +5 -0
- package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
- package/assets/agents/_default/prompt-base-worker.md +10 -0
- package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
- package/assets/agents/_default/prompt-compact.md +76 -0
- package/assets/agents/_default/prompt-compact_continue.md +9 -0
- package/assets/agents/_default/prompt-git.md +8 -0
- package/assets/agents/_default/prompt-goal.md +13 -0
- package/assets/agents/_default/prompt-session-branch.md +3 -0
- package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
- package/assets/agents/_default/prompt-session-root.md +3 -0
- package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
- package/assets/agents/_default/prompt-title.md +11 -0
- package/assets/agents/_default/prompt-tool_agent.md +22 -0
- package/assets/agents/_migration/README.md +20 -0
- package/assets/agents/_migration/coder/PERSONA.md +11 -0
- package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
- package/assets/agents/_migration/general/PERSONA.md +11 -0
- package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
- package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
- package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
- package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
- package/assets/agents/_v2/explore.md.hbs +38 -0
- package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
- package/assets/agents/_v2/verifier.md.hbs +32 -0
- package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
- package/assets/agents/_v2/worker.md.hbs +27 -0
- package/assets/agents/alran/PERSONA.md +7 -0
- package/assets/agents/alran/features/cron.md.hbs +0 -0
- package/assets/agents/alran/features/delegation.md.hbs +56 -0
- package/assets/agents/alran/features/memory.md.hbs +61 -0
- package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
- package/assets/agents/alran/features/task-management.md.hbs +11 -0
- package/assets/agents/alran/features/web-search.md.hbs +11 -0
- package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
- package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
- package/assets/agents/alran/prompt-session-root.md +4 -0
- package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
- package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
- package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
- package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
- package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
- package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
- package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
- package/assets/agents/alran/system-prompt.md.hbs +97 -0
- package/assets/agents/builtin-agents.json +1 -0
- package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
- package/assets/agents/desktop-task/checkpoint/system.md +19 -0
- package/assets/agents/desktop-task/output-revision/system.md +1 -0
- package/assets/agents/desktop-task/retry/continuation.md +4 -0
- package/assets/agents/desktop-task/session-title/system.md +41 -0
- package/assets/agents/explore/PERSONA.md +8 -0
- package/assets/agents/explore/agent.md +14 -0
- package/assets/agents/explore/system-prompt.md.hbs +35 -0
- package/assets/agents/greeting.md +61 -0
- package/assets/agents/managed-prompts.json +47 -0
- package/assets/agents/prompt-exemptions.json +36 -0
- package/assets/agents/verifier/PERSONA.md +8 -0
- package/assets/agents/verifier/agent.md +17 -0
- package/assets/agents/verifier/system-prompt.md.hbs +28 -0
- package/assets/agents/worker/PERSONA.md +8 -0
- package/assets/agents/worker/agent.md +18 -0
- package/assets/agents/worker/system-prompt.md.hbs +22 -0
- package/assets/agents/workflow/code-review/review-candidates.md +120 -0
- package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
- package/assets/agents/workflow/goal/budget-limit.md +16 -0
- package/assets/agents/workflow/goal/continuation.md +62 -0
- package/assets/agents/workflow/goal/objective-updated.md +16 -0
- package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
- package/assets/agents/workflow/goal/recovery.md +11 -0
- package/assets/agents/workflow/goal/terminal-audit.md +10 -0
- package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
- package/assets/agents/workflow/prompt-hook/system.md +0 -0
- package/assets/models-dev-catalog.json.gz +0 -0
- package/assets/prompts/code-review/review-candidates.md +120 -0
- package/assets/prompts/code-review/reviewer-system.md +75 -0
- package/assets/skills/alran-tools-master/SKILL.md +127 -0
- package/assets/skills/code-review/SKILL.md +51 -0
- package/assets/skills/cu-desktop/SKILL.md +255 -0
- package/assets/skills/deep-research/SKILL.md +30 -0
- package/assets/skills/deploy-website/SKILL.md +52 -0
- package/assets/skills/docx/LICENSE +21 -0
- package/assets/skills/docx/SKILL.md +259 -0
- package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
- package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
- package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
- package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
- package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
- package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
- package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
- package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
- package/assets/skills/docx/docs/acceptance.md +139 -0
- package/assets/skills/docx/docs/anti-patterns.md +14 -0
- package/assets/skills/docx/docs/backends.md +116 -0
- package/assets/skills/docx/docs/evidence.md +73 -0
- package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
- package/assets/skills/docx/docs/index.md +50 -0
- package/assets/skills/docx/docs/rendered-delivery.md +125 -0
- package/assets/skills/docx/docs/router.md +122 -0
- package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
- package/assets/skills/docx/docs/task-apply-template.md +141 -0
- package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
- package/assets/skills/docx/docs/task-create.md +124 -0
- package/assets/skills/docx/docs/task-edit-fill.md +69 -0
- package/assets/skills/docx/docs/task-read-content.md +148 -0
- package/assets/skills/docx/docs/task-read-rendered.md +78 -0
- package/assets/skills/docx/docs/task-read-structure.md +93 -0
- package/assets/skills/docx/docs/task-repair-layout.md +70 -0
- package/assets/skills/docx/docs/template-dsl.md +32 -0
- package/assets/skills/docx/docs/track-changes.md +15 -0
- package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
- package/assets/skills/docx/references/cjk_typography.md +357 -0
- package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
- package/assets/skills/docx/references/comments_guide.md +191 -0
- package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
- package/assets/skills/docx/references/design_principles.md +819 -0
- package/assets/skills/docx/references/openxml_element_order.md +308 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/assets/skills/docx/references/openxml_namespaces.md +82 -0
- package/assets/skills/docx/references/openxml_units.md +72 -0
- package/assets/skills/docx/references/sample-patch-plans.json +22 -0
- package/assets/skills/docx/references/sample-task-intents.json +5 -0
- package/assets/skills/docx/references/sample-template-manifests.json +21 -0
- package/assets/skills/docx/references/scenario_a_create.md +284 -0
- package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
- package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
- package/assets/skills/docx/references/track_changes_guide.md +200 -0
- package/assets/skills/docx/references/troubleshooting.md +506 -0
- package/assets/skills/docx/references/typography_guide.md +294 -0
- package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
- package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
- package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
- package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
- package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
- package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
- package/assets/skills/docx/scripts/docx_preview.sh +37 -0
- package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
- package/assets/skills/docx/scripts/env_check.ps1 +327 -0
- package/assets/skills/docx/scripts/env_check.sh +340 -0
- package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
- package/assets/skills/docx/scripts/pack_docx.py +31 -0
- package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
- package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
- package/assets/skills/docx/scripts/rendered_report.py +609 -0
- package/assets/skills/docx/scripts/setup.ps1 +542 -0
- package/assets/skills/docx/scripts/setup.sh +537 -0
- package/assets/skills/docx/scripts/unpack_docx.py +29 -0
- package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
- package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
- package/assets/skills/edit-deployed-website/SKILL.md +27 -0
- package/assets/skills/init/SKILL.md +135 -0
- package/assets/skills/llm-call/SKILL.md +48 -0
- package/assets/skills/llm-call/scripts/llm_call.py +458 -0
- package/assets/skills/pdf/SKILL.md +280 -0
- package/assets/skills/pdf/docs/advanced-reference.md +711 -0
- package/assets/skills/pdf/docs/create-guide.md +437 -0
- package/assets/skills/pdf/docs/design-guide.md +204 -0
- package/assets/skills/pdf/docs/forms-guide.md +462 -0
- package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
- package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
- package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
- package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
- package/assets/skills/pdf/docs/read-guide.md +358 -0
- package/assets/skills/pdf/docs/reformat-guide.md +238 -0
- package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
- package/assets/skills/pdf/docs/troubleshooting.md +86 -0
- package/assets/skills/pdf/docs/vision-guide.md +188 -0
- package/assets/skills/pdf/scripts/__init__.py +0 -0
- package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
- package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
- package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
- package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
- package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
- package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
- package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
- package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
- package/assets/skills/pdf/scripts/make.sh +388 -0
- package/assets/skills/pdf/scripts/merge.py +112 -0
- package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
- package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
- package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
- package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
- package/assets/skills/pdf/scripts/render/__init__.py +0 -0
- package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
- package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
- package/assets/skills/pdf/scripts/render_html.cjs +205 -0
- package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
- package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
- package/assets/skills/pdf/templates/INDEX.md +90 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
- package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
- package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
- package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
- package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
- package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
- package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
- package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
- package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
- package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
- package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
- package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
- package/assets/skills/pptx/SKILL.md +283 -0
- package/assets/skills/pptx/references/design-system.md +424 -0
- package/assets/skills/pptx/references/editing.md +162 -0
- package/assets/skills/pptx/references/element-map.md +229 -0
- package/assets/skills/pptx/references/pitfalls.md +205 -0
- package/assets/skills/pptx/references/pptxgenjs.md +420 -0
- package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
- package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
- package/assets/skills/pptx/references/slide-types.md +413 -0
- package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
- package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
- package/assets/skills/pptx/scripts/extract_comments.py +468 -0
- package/assets/skills/pptx/scripts/extract_images.py +226 -0
- package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
- package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
- package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
- package/assets/skills/resume-codex/SKILL.md +53 -0
- package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
- package/assets/skills/skill-creator/SKILL.md +188 -0
- package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
- package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
- package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
- package/assets/skills/skill-creator/references/description-rubric.md +83 -0
- package/assets/skills/skill-creator/references/skill-template.md +101 -0
- package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
- package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
- package/assets/skills/skill-refiner/SKILL.md +137 -0
- package/assets/skills/visual-page/SKILL.md +194 -0
- package/assets/skills/x-link-reader/SKILL.md +108 -0
- package/assets/skills/xlsx/SKILL.md +498 -0
- package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
- package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
- package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
- package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
- package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
- package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
- package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
- package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
- package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/assets/skills/xlsx/scripts/office/pack.py +159 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
- package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
- package/assets/skills/xlsx/scripts/office/validate.py +117 -0
- package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
- package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
- package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
- package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
- package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
- package/assets/skills/xlsx/scripts/recalc.py +450 -0
- package/chunks/account-commands-JZ6NXTTK.js +2 -0
- package/chunks/anthropic-MN33DP4E.js +2 -0
- package/chunks/application-ITGAJ4HC.js +2 -0
- package/chunks/auth-command-V3RVPLZO.js +2 -0
- package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
- package/chunks/chunk-2TF6JAQM.js +2 -0
- package/chunks/chunk-33CNY6GP.js +2 -0
- package/chunks/chunk-3AODGLMF.js +2 -0
- package/chunks/chunk-44VPC5LA.js +38 -0
- package/chunks/chunk-4CN3IJFH.js +2 -0
- package/chunks/chunk-4PDIO3M6.js +2 -0
- package/chunks/chunk-4X22UJQH.js +164 -0
- package/chunks/chunk-6255CZPL.js +2 -0
- package/chunks/chunk-6P4UKHGR.js +2 -0
- package/chunks/chunk-7QLAXRD2.js +1085 -0
- package/chunks/chunk-7XYOYZX2.js +2 -0
- package/chunks/chunk-A7GMJNA2.js +29 -0
- package/chunks/chunk-AGUSPIUP.js +2 -0
- package/chunks/chunk-BQ3CF3KE.js +2 -0
- package/chunks/chunk-C3CMJAAV.js +3 -0
- package/chunks/chunk-CJM7ZJ6W.js +7 -0
- package/chunks/chunk-CSOUJVKM.js +2 -0
- package/chunks/chunk-D66ZSHXR.js +2 -0
- package/chunks/chunk-D7MGU75P.js +2 -0
- package/chunks/chunk-E3GLGDGC.js +5 -0
- package/chunks/chunk-ENHOPPS7.js +16 -0
- package/chunks/chunk-EOR6EDNR.js +2 -0
- package/chunks/chunk-EYK25HWR.js +2 -0
- package/chunks/chunk-F46IELF5.js +2 -0
- package/chunks/chunk-FC4M2B7E.js +2 -0
- package/chunks/chunk-FSNYOJPJ.js +2 -0
- package/chunks/chunk-FUERW2DW.js +3 -0
- package/chunks/chunk-FXOH6TEQ.js +21 -0
- package/chunks/chunk-GP52JZMY.js +2 -0
- package/chunks/chunk-GRXX6I72.js +2 -0
- package/chunks/chunk-GSYHBK5Q.js +6 -0
- package/chunks/chunk-HNWBFJNO.js +2 -0
- package/chunks/chunk-IIE366LR.js +6706 -0
- package/chunks/chunk-IWK7PZP7.js +207 -0
- package/chunks/chunk-J3KCPYZT.js +2 -0
- package/chunks/chunk-KCLRJQ53.js +59 -0
- package/chunks/chunk-LU4RPLJ3.js +2 -0
- package/chunks/chunk-LZJYNT32.js +2 -0
- package/chunks/chunk-M7GW4VMR.js +27 -0
- package/chunks/chunk-MACBL5HF.js +2 -0
- package/chunks/chunk-N5NTXCJI.js +2 -0
- package/chunks/chunk-N5SVBCUB.js +7 -0
- package/chunks/chunk-N6W7ZL26.js +2 -0
- package/chunks/chunk-NWB7LFOK.js +131 -0
- package/chunks/chunk-OIQ336YE.js +16 -0
- package/chunks/chunk-OQNU3VPS.js +30 -0
- package/chunks/chunk-OTDNOWXG.js +16 -0
- package/chunks/chunk-PNXZWSWT.js +3 -0
- package/chunks/chunk-QFUV5PX6.js +2 -0
- package/chunks/chunk-QIN5ZBE2.js +2 -0
- package/chunks/chunk-QKBN5CGI.js +2 -0
- package/chunks/chunk-QPGTKSIQ.js +2 -0
- package/chunks/chunk-SIOLUFGG.js +2 -0
- package/chunks/chunk-TW23QKAD.js +3 -0
- package/chunks/chunk-U3RMPDXU.js +2 -0
- package/chunks/chunk-U7U3DJHF.js +2 -0
- package/chunks/chunk-VLXX22YO.js +2 -0
- package/chunks/chunk-WHD2XVT2.js +2 -0
- package/chunks/chunk-WTAJMYF2.js +249 -0
- package/chunks/chunk-WWNUAU4P.js +29 -0
- package/chunks/chunk-WYANV3IX.js +4 -0
- package/chunks/chunk-XAGZ6ZEU.js +9 -0
- package/chunks/chunk-XFCC2CI2.js +24 -0
- package/chunks/chunk-XQK7JM66.js +2 -0
- package/chunks/chunk-YLQXZBEL.js +2 -0
- package/chunks/chunk-YPV2X2RG.js +2 -0
- package/chunks/chunk-Z6BHCXKT.js +25 -0
- package/chunks/chunk-Z6HBNJCA.js +8 -0
- package/chunks/chunk-ZQKVUPKA.js +2 -0
- package/chunks/chunk-ZQOALVGL.js +2 -0
- package/chunks/clipboard-image-PQPC4EHR.js +2 -0
- package/chunks/data-dir-LDVKDCJ2.js +2 -0
- package/chunks/dist-2BRD4JFU.js +11 -0
- package/chunks/dist-EXKHRFQO.js +5 -0
- package/chunks/emscripten-module-RD6P2XH5.js +2 -0
- package/chunks/emscripten-module-WYNDFH3N.js +2 -0
- package/chunks/emscripten-module-XPTEOIWW.js +2 -0
- package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
- package/chunks/ffi-IO7WZQNG.js +2 -0
- package/chunks/ffi-M5UP5J6C.js +2 -0
- package/chunks/ffi-ORLOPBB3.js +2 -0
- package/chunks/ffi-OUPK6AY6.js +2 -0
- package/chunks/google-UJAPMFAB.js +2 -0
- package/chunks/google-vertex-VLSF55PW.js +2 -0
- package/chunks/install-source-JTIUC4G4.js +2 -0
- package/chunks/launcher-FCZ3EDBF.js +61 -0
- package/chunks/lifecycle-GY435YMF.js +2 -0
- package/chunks/main-TQGGRHTS.js +13 -0
- package/chunks/mistral-ZJZUEF2X.js +3 -0
- package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
- package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
- package/chunks/multipart-parser-L6M455MS.js +2 -0
- package/chunks/network-proxy-U72JCK2I.js +2 -0
- package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
- package/chunks/openai-completions-D32YW6KL.js +2 -0
- package/chunks/openai-responses-ZCGSENM4.js +2 -0
- package/chunks/openrouter-G2EHY5BD.js +2 -0
- package/chunks/otel-OHXIZ666.js +2 -0
- package/chunks/package-contract-GVXTMJ3N.js +2 -0
- package/chunks/pdfjs-SHZAF7PF.js +107 -0
- package/chunks/photon_rs-C52RL4CI.js +3 -0
- package/chunks/plugin-command-OSAFHS7C.js +2 -0
- package/chunks/provider-command-SKTCHD4E.js +2 -0
- package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
- package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
- package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
- package/chunks/skills-command-XXXEZAG6.js +2 -0
- package/chunks/src-DNIDEMVV.js +2 -0
- package/chunks/src-IBHIRTD7.js +2 -0
- package/chunks/telemetry-J7ZLGF5X.js +2 -0
- package/chunks/telemetry-command-COQG2AKK.js +5 -0
- package/chunks/tools-WDBB2JKV.js +2 -0
- package/chunks/undici-TUGHZJSA.js +2 -0
- package/chunks/update-NB6OD572.js +14 -0
- package/chunks/update-hint-ED7O67WU.js +3 -0
- package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
- package/cli.js +5 -0
- package/configs/data-minimal.yaml +50 -0
- package/embedded/alran-tools/cli.mjs +4961 -0
- package/embedded/alran-tools/manifest.json +25 -0
- package/emscripten-module.wasm +0 -0
- package/image-preview-worker.js +2 -0
- package/internal-bin/alran-tools +9 -0
- package/internal-bin/alran-tools.cmd +8 -0
- package/matrix-mcp-stdio.js +4 -0
- package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
- package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
- package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
- package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
- package/package.json +38 -4
- package/photon_rs_bg.wasm +0 -0
- package/quickjs-worker.js +152 -0
- package/vendor/java-proxy-agent/build.ts +97 -0
- package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
- package/vendor/seccomp/arm64/apply-seccomp +0 -0
- package/vendor/seccomp/build.ts +74 -0
- package/vendor/seccomp/x64/apply-seccomp +0 -0
- package/vendor/srt-win/arm64/srt-win.exe +0 -0
- package/vendor/srt-win/build.ts +40 -0
- package/vendor/srt-win/x64/srt-win.exe +0 -0
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# OpenXML Namespaces, Relationship Types, and Content Types
|
|
2
|
+
|
|
3
|
+
## Core Namespaces
|
|
4
|
+
|
|
5
|
+
| Prefix | URI | Used In |
|
|
6
|
+
|--------|-----|---------|
|
|
7
|
+
| `w` | `http://schemas.openxmlformats.org/wordprocessingml/2006/main` | document.xml, styles.xml, numbering.xml, headers, footers |
|
|
8
|
+
| `r` | `http://schemas.openxmlformats.org/officeDocument/2006/relationships` | Relationship references (r:id) |
|
|
9
|
+
| `wp` | `http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing` | Image/drawing placement in document |
|
|
10
|
+
| `a` | `http://schemas.openxmlformats.org/drawingml/2006/main` | DrawingML core (shapes, images, themes) |
|
|
11
|
+
| `pic` | `http://schemas.openxmlformats.org/drawingml/2006/picture` | Picture element in DrawingML |
|
|
12
|
+
| `v` | `urn:schemas-microsoft-com:vml` | VML (legacy shapes, watermarks) |
|
|
13
|
+
| `o` | `urn:schemas-microsoft-com:office:office` | Office VML extensions |
|
|
14
|
+
| `m` | `http://schemas.openxmlformats.org/officeDocument/2006/math` | Math equations (OMML) |
|
|
15
|
+
| `mc` | `http://schemas.openxmlformats.org/markup-compatibility/2006` | Markup compatibility (Ignorable, AlternateContent) |
|
|
16
|
+
|
|
17
|
+
## Extended Namespaces
|
|
18
|
+
|
|
19
|
+
| Prefix | URI | Purpose |
|
|
20
|
+
|--------|-----|---------|
|
|
21
|
+
| `w14` | `http://schemas.microsoft.com/office/word/2010/wordml` | Word 2010 extensions (contentPart, etc.) |
|
|
22
|
+
| `w15` | `http://schemas.microsoft.com/office/word/2012/wordml` | Word 2013 extensions (commentEx, etc.) |
|
|
23
|
+
| `w16cid` | `http://schemas.microsoft.com/office/word/2016/wordml/cid` | Comment IDs (durable IDs) |
|
|
24
|
+
| `w16cex` | `http://schemas.microsoft.com/office/word/2018/wordml/cex` | Comment extensible |
|
|
25
|
+
| `w16se` | `http://schemas.microsoft.com/office/word/2015/wordml/symex` | Symbol extensions |
|
|
26
|
+
| `wps` | `http://schemas.microsoft.com/office/word/2010/wordprocessingShape` | WordprocessingML shapes |
|
|
27
|
+
| `wpc` | `http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas` | Drawing canvas |
|
|
28
|
+
|
|
29
|
+
## Relationship Types
|
|
30
|
+
|
|
31
|
+
| Relationship | Type URI |
|
|
32
|
+
|-------------|----------|
|
|
33
|
+
| Document | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument` |
|
|
34
|
+
| Styles | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles` |
|
|
35
|
+
| Numbering | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering` |
|
|
36
|
+
| Font Table | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable` |
|
|
37
|
+
| Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings` |
|
|
38
|
+
| Theme | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme` |
|
|
39
|
+
| Image | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/image` |
|
|
40
|
+
| Hyperlink | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink` |
|
|
41
|
+
| Header | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/header` |
|
|
42
|
+
| Footer | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer` |
|
|
43
|
+
| Comments | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments` |
|
|
44
|
+
| CommentsExtended | `http://schemas.microsoft.com/office/2011/relationships/commentsExtended` |
|
|
45
|
+
| CommentsIds | `http://schemas.microsoft.com/office/2016/09/relationships/commentsIds` |
|
|
46
|
+
| CommentsExtensible | `http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible` |
|
|
47
|
+
| Footnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes` |
|
|
48
|
+
| Endnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes` |
|
|
49
|
+
| Glossary | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument` |
|
|
50
|
+
| Web Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings` |
|
|
51
|
+
|
|
52
|
+
## Content Types (`[Content_Types].xml`)
|
|
53
|
+
|
|
54
|
+
### Default Extensions
|
|
55
|
+
|
|
56
|
+
```xml
|
|
57
|
+
<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml" />
|
|
58
|
+
<Default Extension="xml" ContentType="application/xml" />
|
|
59
|
+
<Default Extension="png" ContentType="image/png" />
|
|
60
|
+
<Default Extension="jpeg" ContentType="image/jpeg" />
|
|
61
|
+
<Default Extension="gif" ContentType="image/gif" />
|
|
62
|
+
<Default Extension="emf" ContentType="image/x-emf" />
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Part Overrides
|
|
66
|
+
|
|
67
|
+
| Part | Content Type |
|
|
68
|
+
|------|-------------|
|
|
69
|
+
| `/word/document.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml` |
|
|
70
|
+
| `/word/styles.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml` |
|
|
71
|
+
| `/word/numbering.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml` |
|
|
72
|
+
| `/word/settings.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml` |
|
|
73
|
+
| `/word/fontTable.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml` |
|
|
74
|
+
| `/word/theme/theme1.xml` | `application/vnd.openxmlformats-officedocument.theme+xml` |
|
|
75
|
+
| `/word/header1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml` |
|
|
76
|
+
| `/word/footer1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml` |
|
|
77
|
+
| `/word/comments.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml` |
|
|
78
|
+
| `/word/commentsExtended.xml` | `application/vnd.ms-word.commentsExtended+xml` |
|
|
79
|
+
| `/word/commentsIds.xml` | `application/vnd.ms-word.commentsIds+xml` |
|
|
80
|
+
| `/word/commentsExtensible.xml` | `application/vnd.ms-word.commentsExtensible+xml` |
|
|
81
|
+
| `/word/footnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml` |
|
|
82
|
+
| `/word/endnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml` |
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# OpenXML Unit Conversion Quick Reference
|
|
2
|
+
|
|
3
|
+
## Master Conversion Table
|
|
4
|
+
|
|
5
|
+
| Unit | 1 inch | 1 cm | 1 mm | 1 pt | Description |
|
|
6
|
+
|------|--------|------|------|------|-------------|
|
|
7
|
+
| DXA (twips) | 1440 | 567 | 56.7 | 20 | 1/20 of a point. Used for margins, indents, spacing, page size. |
|
|
8
|
+
| EMU | 914400 | 360000 | 36000 | 12700 | English Metric Unit. Used for images, drawings, shapes. |
|
|
9
|
+
| Half-points | 144 | 56.7 | 5.67 | 2 | Used for font sizes (`w:sz`, `w:szCs`). |
|
|
10
|
+
| Points | 72 | 28.35 | 2.835 | 1 | Standard typographic unit. Not used directly in most attributes. |
|
|
11
|
+
| Eighths of a point | 576 | 226.8 | 22.68 | 8 | Used for `w:spacing` character spacing. |
|
|
12
|
+
|
|
13
|
+
## Common Page Sizes
|
|
14
|
+
|
|
15
|
+
| Size | Width (DXA) | Height (DXA) | Width (mm) | Height (mm) |
|
|
16
|
+
|------|-------------|--------------|------------|-------------|
|
|
17
|
+
| A4 | 11906 | 16838 | 210 | 297 |
|
|
18
|
+
| Letter | 12240 | 15840 | 215.9 | 279.4 |
|
|
19
|
+
| Legal | 12240 | 20160 | 215.9 | 355.6 |
|
|
20
|
+
| A3 | 16838 | 23811 | 297 | 420 |
|
|
21
|
+
| A5 | 8391 | 11906 | 148 | 210 |
|
|
22
|
+
|
|
23
|
+
## Common Margin Values
|
|
24
|
+
|
|
25
|
+
| Margin | DXA | Inches | cm |
|
|
26
|
+
|--------|-----|--------|----|
|
|
27
|
+
| 0.5 inch | 720 | 0.5 | 1.27 |
|
|
28
|
+
| 0.75 inch | 1080 | 0.75 | 1.91 |
|
|
29
|
+
| 1 inch | 1440 | 1.0 | 2.54 |
|
|
30
|
+
| 1.25 inch | 1800 | 1.25 | 3.18 |
|
|
31
|
+
| 1.5 inch | 2160 | 1.5 | 3.81 |
|
|
32
|
+
|
|
33
|
+
## Font Size Values (`w:sz`)
|
|
34
|
+
|
|
35
|
+
| Display Size | w:sz value | Notes |
|
|
36
|
+
|-------------|-----------|-------|
|
|
37
|
+
| 8pt | 16 | |
|
|
38
|
+
| 9pt | 18 | |
|
|
39
|
+
| 10pt | 20 | |
|
|
40
|
+
| 10.5pt | 21 | Common CJK body size |
|
|
41
|
+
| 11pt | 22 | Default Calibri body |
|
|
42
|
+
| 12pt | 24 | Default TNR body |
|
|
43
|
+
| 14pt | 28 | Small heading |
|
|
44
|
+
| 16pt | 32 | |
|
|
45
|
+
| 18pt | 36 | |
|
|
46
|
+
| 20pt | 40 | |
|
|
47
|
+
| 24pt | 48 | |
|
|
48
|
+
| 28pt | 56 | |
|
|
49
|
+
| 36pt | 72 | |
|
|
50
|
+
|
|
51
|
+
## Line Spacing Values
|
|
52
|
+
|
|
53
|
+
Line spacing in `w:spacing` uses the `w:line` attribute in 240ths of a line (when `w:lineRule="auto"`):
|
|
54
|
+
|
|
55
|
+
| Spacing | w:line value | w:lineRule |
|
|
56
|
+
|---------|-------------|-----------|
|
|
57
|
+
| Single | 240 | auto |
|
|
58
|
+
| 1.15 (Word default) | 276 | auto |
|
|
59
|
+
| 1.5 | 360 | auto |
|
|
60
|
+
| Double | 480 | auto |
|
|
61
|
+
| Exact 12pt | 240 | exact |
|
|
62
|
+
| At least 12pt | 240 | atLeast |
|
|
63
|
+
|
|
64
|
+
Note: When `lineRule="exact"` or `"atLeast"`, `w:line` is in **twips** (DXA), not 240ths. So `line="240"` with `lineRule="exact"` means exactly 12pt (240/20 = 12pt).
|
|
65
|
+
|
|
66
|
+
## Conversion Formulas
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
DXA = inches × 1440 = cm × 567 = pt × 20
|
|
70
|
+
EMU = inches × 914400 = cm × 360000 = pt × 12700
|
|
71
|
+
sz = pt × 2 (half-points)
|
|
72
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"ops": [
|
|
4
|
+
{
|
|
5
|
+
"op": "fill_anchor",
|
|
6
|
+
"anchor": "@@FIELD:author@@",
|
|
7
|
+
"value": "Shiki"
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
"op": "insert_paragraph_after",
|
|
11
|
+
"locator": {
|
|
12
|
+
"type": "heading_text",
|
|
13
|
+
"value": "方案设计"
|
|
14
|
+
},
|
|
15
|
+
"content": {
|
|
16
|
+
"format": "markdown",
|
|
17
|
+
"value": "新增一段说明。"
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
]
|
|
21
|
+
}
|
|
22
|
+
]
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"template_name": "thesis-template-2026",
|
|
4
|
+
"template_mode": "institutional_multi_section",
|
|
5
|
+
"sections": [
|
|
6
|
+
{ "name": "cover", "required": true, "titlePg": true },
|
|
7
|
+
{ "name": "toc", "required": true, "titlePg": true },
|
|
8
|
+
{ "name": "body", "required": true, "titlePg": false }
|
|
9
|
+
],
|
|
10
|
+
"style_requirements": {
|
|
11
|
+
"heading1_style_id": "1",
|
|
12
|
+
"heading2_style_id": "2",
|
|
13
|
+
"normal_style_id": "a"
|
|
14
|
+
},
|
|
15
|
+
"anchor_rules": {
|
|
16
|
+
"must_be_atomic": true,
|
|
17
|
+
"allowed_placeholders": ["@@FIELD:title@@", "@@FIELD:author@@"]
|
|
18
|
+
},
|
|
19
|
+
"validation_profile": "thesis_strict"
|
|
20
|
+
}
|
|
21
|
+
]
|
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
# Scenario A: Creating a New DOCX from Scratch
|
|
2
|
+
|
|
3
|
+
## When to Use
|
|
4
|
+
|
|
5
|
+
Use Scenario A when:
|
|
6
|
+
- The user has no existing file and wants a brand new document
|
|
7
|
+
- The user provides content (text, tables, images) and wants it assembled into a DOCX
|
|
8
|
+
- The user specifies a document type (report, letter, memo, academic) or describes a custom layout
|
|
9
|
+
|
|
10
|
+
Do NOT use when: the user already has a DOCX they want to modify (→ Scenario B) or wants to restyle an existing document (→ Scenario C).
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Step-by-Step Workflow
|
|
15
|
+
|
|
16
|
+
### 1. Determine Document Type
|
|
17
|
+
|
|
18
|
+
Ask or infer the document type from the user's request:
|
|
19
|
+
|
|
20
|
+
| Type | Typical Signals |
|
|
21
|
+
|------|----------------|
|
|
22
|
+
| Report | "report", "analysis", "whitepaper", sections with headings |
|
|
23
|
+
| Letter | "letter", "dear", address block, salutation |
|
|
24
|
+
| Memo | "memo", "memorandum", To/From/Subject fields |
|
|
25
|
+
| Academic | "paper", "essay", "thesis", APA/MLA/Chicago mention |
|
|
26
|
+
| Custom | None of the above, or user specifies exact formatting |
|
|
27
|
+
|
|
28
|
+
### 2. Gather Content Requirements
|
|
29
|
+
|
|
30
|
+
Collect from the user:
|
|
31
|
+
- Title and subtitle (if any)
|
|
32
|
+
- Author / organization
|
|
33
|
+
- Section structure (headings and nesting)
|
|
34
|
+
- Body content per section
|
|
35
|
+
- Tables (headers + rows)
|
|
36
|
+
- Images (file paths or placeholders)
|
|
37
|
+
- Special elements: TOC, page numbers, watermark, headers/footers
|
|
38
|
+
|
|
39
|
+
### 3. Select Style Set
|
|
40
|
+
|
|
41
|
+
Based on document type, load the matching styles XML asset:
|
|
42
|
+
- Report → `assets/styles/default_styles.xml` or `assets/styles/corporate_styles.xml`
|
|
43
|
+
- Academic → `assets/styles/academic_styles.xml`
|
|
44
|
+
- Letter / Memo / Custom → `assets/styles/default_styles.xml` (with overrides)
|
|
45
|
+
|
|
46
|
+
### 4. Configure Page Setup
|
|
47
|
+
|
|
48
|
+
Set `w:sectPr` values based on document type defaults (see below) or user overrides.
|
|
49
|
+
|
|
50
|
+
```xml
|
|
51
|
+
<w:sectPr>
|
|
52
|
+
<w:pgSz w:w="11906" w:h="16838" /> <!-- A4 -->
|
|
53
|
+
<w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440"
|
|
54
|
+
w:header="720" w:footer="720" w:gutter="0" />
|
|
55
|
+
</w:sectPr>
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### 5. Build Document Structure
|
|
59
|
+
|
|
60
|
+
Assemble `word/document.xml` with:
|
|
61
|
+
1. `w:body` as root container
|
|
62
|
+
2. Paragraphs (`w:p`) with heading styles for section titles
|
|
63
|
+
3. Body paragraphs with `Normal` style
|
|
64
|
+
4. Tables, images, and other elements as needed
|
|
65
|
+
5. Final `w:sectPr` as last child of `w:body`
|
|
66
|
+
|
|
67
|
+
### 6. Apply Typography Defaults
|
|
68
|
+
|
|
69
|
+
Set document-level defaults in `styles.xml` under `w:docDefaults`:
|
|
70
|
+
```xml
|
|
71
|
+
<w:docDefaults>
|
|
72
|
+
<w:rPrDefault>
|
|
73
|
+
<w:rPr>
|
|
74
|
+
<w:rFonts w:ascii="Calibri" w:hAnsi="Calibri" w:eastAsia="SimSun" w:cs="Arial" />
|
|
75
|
+
<w:sz w:val="22" /> <!-- 11pt -->
|
|
76
|
+
<w:szCs w:val="22" />
|
|
77
|
+
</w:rPr>
|
|
78
|
+
</w:rPrDefault>
|
|
79
|
+
<w:pPrDefault>
|
|
80
|
+
<w:pPr>
|
|
81
|
+
<w:spacing w:after="160" w:line="259" w:lineRule="auto" />
|
|
82
|
+
</w:pPr>
|
|
83
|
+
</w:pPrDefault>
|
|
84
|
+
</w:docDefaults>
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 7. Add Complex Elements
|
|
88
|
+
|
|
89
|
+
See the Complex Elements Guide section below.
|
|
90
|
+
|
|
91
|
+
### 8. Run Validation Pipeline
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
dotnet run ... validate --xsd wml-subset.xsd
|
|
95
|
+
dotnet run ... validate --xsd business-rules.xsd # if applying a template
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## Document Type Defaults
|
|
101
|
+
|
|
102
|
+
### Report
|
|
103
|
+
| Property | Value |
|
|
104
|
+
|----------|-------|
|
|
105
|
+
| Body font | Calibri 11pt |
|
|
106
|
+
| Heading font | Calibri Light |
|
|
107
|
+
| H1 / H2 / H3 / H4 size | 28pt / 24pt / 18pt / 14pt |
|
|
108
|
+
| Heading color | #2F5496 (corporate blue) |
|
|
109
|
+
| Margins | 1 inch (1440 DXA) all sides |
|
|
110
|
+
| Page size | A4 (11906 × 16838 DXA) |
|
|
111
|
+
| Line spacing | Single (line="240") |
|
|
112
|
+
| Paragraph spacing | 0pt before, 8pt after body |
|
|
113
|
+
|
|
114
|
+
### Letter
|
|
115
|
+
| Property | Value |
|
|
116
|
+
|----------|-------|
|
|
117
|
+
| Font | Calibri 11pt |
|
|
118
|
+
| Page size | Letter (12240 × 15840 DXA) |
|
|
119
|
+
| Margins | 1 inch all sides |
|
|
120
|
+
| Structure | Date → Address → Salutation → Body → Closing → Signature |
|
|
121
|
+
| Line spacing | Single |
|
|
122
|
+
|
|
123
|
+
### Memo
|
|
124
|
+
| Property | Value |
|
|
125
|
+
|----------|-------|
|
|
126
|
+
| Font | Arial 11pt |
|
|
127
|
+
| Page size | Letter |
|
|
128
|
+
| Margins | 0.75 inch (1080 DXA) |
|
|
129
|
+
| Header | "MEMO" centered, bold, 16pt |
|
|
130
|
+
| Fields | To, From, Date, Subject (bold labels, tab-aligned values) |
|
|
131
|
+
|
|
132
|
+
### Academic
|
|
133
|
+
| Property | Value |
|
|
134
|
+
|----------|-------|
|
|
135
|
+
| Font | Times New Roman 12pt |
|
|
136
|
+
| Line spacing | Double (line="480") |
|
|
137
|
+
| Margins | 1 inch all sides |
|
|
138
|
+
| Page size | Letter |
|
|
139
|
+
| Headings | Bold, same font, 14/13/12pt for H1/H2/H3 |
|
|
140
|
+
| First line indent | 0.5 inch (720 DXA) |
|
|
141
|
+
| Heading color | Black (no color) |
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## Content Configuration JSON Format
|
|
146
|
+
|
|
147
|
+
The CLI `create` command accepts a JSON config:
|
|
148
|
+
|
|
149
|
+
```json
|
|
150
|
+
{
|
|
151
|
+
"type": "report",
|
|
152
|
+
"title": "Quarterly Revenue Analysis",
|
|
153
|
+
"subtitle": "Q1 2026",
|
|
154
|
+
"author": "Finance Team",
|
|
155
|
+
"pageSize": "A4",
|
|
156
|
+
"margins": { "top": 1440, "right": 1440, "bottom": 1440, "left": 1440 },
|
|
157
|
+
"sections": [
|
|
158
|
+
{
|
|
159
|
+
"heading": "Executive Summary",
|
|
160
|
+
"level": 1,
|
|
161
|
+
"content": [
|
|
162
|
+
{ "type": "paragraph", "text": "Revenue grew 12% year-over-year..." },
|
|
163
|
+
{
|
|
164
|
+
"type": "table",
|
|
165
|
+
"headers": ["Region", "Revenue", "Growth"],
|
|
166
|
+
"rows": [
|
|
167
|
+
["North America", "$4.2M", "+15%"],
|
|
168
|
+
["Europe", "$2.8M", "+8%"],
|
|
169
|
+
["Asia Pacific", "$1.9M", "+18%"]
|
|
170
|
+
]
|
|
171
|
+
},
|
|
172
|
+
{ "type": "image", "path": "charts/revenue.png", "width": "5in", "alt": "Revenue chart" }
|
|
173
|
+
]
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
"heading": "Detailed Analysis",
|
|
177
|
+
"level": 1,
|
|
178
|
+
"content": [
|
|
179
|
+
{ "type": "paragraph", "text": "Breaking down by product line..." }
|
|
180
|
+
]
|
|
181
|
+
}
|
|
182
|
+
]
|
|
183
|
+
}
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
Supported content types:
|
|
187
|
+
- `paragraph` — body text (applies Normal style)
|
|
188
|
+
- `table` — headers + rows (applies TableGrid style)
|
|
189
|
+
- `image` — inline image with width/height control
|
|
190
|
+
- `list` — bulleted or numbered list items
|
|
191
|
+
- `pageBreak` — forces a page break
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## Complex Elements Guide
|
|
196
|
+
|
|
197
|
+
### Table of Contents
|
|
198
|
+
|
|
199
|
+
Insert a TOC field code. Word will update the actual entries when the file is opened:
|
|
200
|
+
|
|
201
|
+
```xml
|
|
202
|
+
<w:p>
|
|
203
|
+
<w:pPr><w:pStyle w:val="TOCHeading" /></w:pPr>
|
|
204
|
+
<w:r><w:t>Table of Contents</w:t></w:r>
|
|
205
|
+
</w:p>
|
|
206
|
+
<w:p>
|
|
207
|
+
<w:r>
|
|
208
|
+
<w:fldChar w:fldCharType="begin" />
|
|
209
|
+
</w:r>
|
|
210
|
+
<w:r>
|
|
211
|
+
<w:instrText xml:space="preserve"> TOC \o "1-3" \h \z \u </w:instrText>
|
|
212
|
+
</w:r>
|
|
213
|
+
<w:r>
|
|
214
|
+
<w:fldChar w:fldCharType="separate" />
|
|
215
|
+
</w:r>
|
|
216
|
+
<w:r>
|
|
217
|
+
<w:t>[Table of contents — update to populate]</w:t>
|
|
218
|
+
</w:r>
|
|
219
|
+
<w:r>
|
|
220
|
+
<w:fldChar w:fldCharType="end" />
|
|
221
|
+
</w:r>
|
|
222
|
+
</w:p>
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### Page Numbers in Footer
|
|
226
|
+
|
|
227
|
+
Add a footer part (`word/footer1.xml`) and reference it in `w:sectPr`:
|
|
228
|
+
|
|
229
|
+
```xml
|
|
230
|
+
<!-- In footer1.xml -->
|
|
231
|
+
<w:ftr xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
|
|
232
|
+
<w:p>
|
|
233
|
+
<w:pPr><w:jc w:val="center" /></w:pPr>
|
|
234
|
+
<w:r>
|
|
235
|
+
<w:fldChar w:fldCharType="begin" />
|
|
236
|
+
</w:r>
|
|
237
|
+
<w:r>
|
|
238
|
+
<w:instrText>PAGE</w:instrText>
|
|
239
|
+
</w:r>
|
|
240
|
+
<w:r>
|
|
241
|
+
<w:fldChar w:fldCharType="separate" />
|
|
242
|
+
</w:r>
|
|
243
|
+
<w:r><w:t>1</w:t></w:r>
|
|
244
|
+
<w:r>
|
|
245
|
+
<w:fldChar w:fldCharType="end" />
|
|
246
|
+
</w:r>
|
|
247
|
+
</w:p>
|
|
248
|
+
</w:ftr>
|
|
249
|
+
|
|
250
|
+
<!-- In sectPr -->
|
|
251
|
+
<w:footerReference w:type="default" r:id="rId8" />
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
### Watermark
|
|
255
|
+
|
|
256
|
+
Add a header part with a shape behind the text:
|
|
257
|
+
|
|
258
|
+
```xml
|
|
259
|
+
<w:hdr>
|
|
260
|
+
<w:p>
|
|
261
|
+
<w:r>
|
|
262
|
+
<w:pict>
|
|
263
|
+
<v:shape style="position:absolute;margin-left:0;margin-top:0;width:468pt;height:180pt;
|
|
264
|
+
z-index:-251657216;mso-position-horizontal:center;
|
|
265
|
+
mso-position-vertical:center"
|
|
266
|
+
fillcolor="silver" stroked="f">
|
|
267
|
+
<v:textpath style="font-family:'Calibri';font-size:1pt" string="DRAFT" />
|
|
268
|
+
</v:shape>
|
|
269
|
+
</w:pict>
|
|
270
|
+
</w:r>
|
|
271
|
+
</w:p>
|
|
272
|
+
</w:hdr>
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
## Post-Creation Checklist
|
|
278
|
+
|
|
279
|
+
1. **Validate** against `wml-subset.xsd` — all elements in correct order, required attributes present
|
|
280
|
+
2. **Merge adjacent runs** with identical formatting to keep XML clean
|
|
281
|
+
3. **Verify relationships** — every `r:id` in document.xml has a matching entry in `document.xml.rels`
|
|
282
|
+
4. **Check content types** — every part in the package is registered in `[Content_Types].xml`
|
|
283
|
+
5. **Preview** — open in Word or LibreOffice to visually confirm layout
|
|
284
|
+
6. **File size** — confirm images are reasonably sized (compress if > 2MB each)
|