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,86 @@
|
|
|
1
|
+
"""Draw bounding-box previews on top of a rasterised page.
|
|
2
|
+
|
|
3
|
+
Reads the new-style ``fields.json`` config (see docs/forms-guide.md
|
|
4
|
+
for the schema) and overlays each entry/tag rectangle onto a single
|
|
5
|
+
page image so the operator can eyeball the geometry before running
|
|
6
|
+
``scripts.fill.overlay_apply``.
|
|
7
|
+
|
|
8
|
+
Run from the skill root::
|
|
9
|
+
|
|
10
|
+
python -m scripts.render.overlay_preview \\
|
|
11
|
+
1 fields.json out_dir/page_1.png out_dir/page_1_overlay.png
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
from __future__ import annotations
|
|
15
|
+
|
|
16
|
+
import json
|
|
17
|
+
import sys
|
|
18
|
+
|
|
19
|
+
from PIL import Image, ImageDraw
|
|
20
|
+
|
|
21
|
+
from scripts.lib.cli_utils import emit, fail, make_parser
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def render_overlay_preview(
|
|
25
|
+
page_no: int,
|
|
26
|
+
cfg_path: str,
|
|
27
|
+
base_img: str,
|
|
28
|
+
out_img: str,
|
|
29
|
+
*,
|
|
30
|
+
quiet: bool = False,
|
|
31
|
+
) -> int:
|
|
32
|
+
with open(cfg_path, "r") as handle:
|
|
33
|
+
cfg = json.load(handle)
|
|
34
|
+
|
|
35
|
+
canvas = Image.open(base_img)
|
|
36
|
+
painter = ImageDraw.Draw(canvas)
|
|
37
|
+
drawn_boxes = 0
|
|
38
|
+
|
|
39
|
+
for slot in cfg.get("slots", []):
|
|
40
|
+
if slot.get("page_no") != page_no:
|
|
41
|
+
continue
|
|
42
|
+
slot_box = slot.get("slot_box")
|
|
43
|
+
tag_box = slot.get("tag_box")
|
|
44
|
+
if slot_box:
|
|
45
|
+
painter.rectangle(slot_box, outline="red", width=2)
|
|
46
|
+
drawn_boxes += 1
|
|
47
|
+
if tag_box:
|
|
48
|
+
painter.rectangle(tag_box, outline="blue", width=2)
|
|
49
|
+
drawn_boxes += 1
|
|
50
|
+
|
|
51
|
+
canvas.save(out_img)
|
|
52
|
+
emit(
|
|
53
|
+
f"Rendered overlay preview to {out_img} ({drawn_boxes} boxes drawn)",
|
|
54
|
+
quiet=quiet,
|
|
55
|
+
)
|
|
56
|
+
return drawn_boxes
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def main(argv: list[str] | None = None) -> int:
|
|
60
|
+
parser = make_parser(
|
|
61
|
+
"overlay_preview",
|
|
62
|
+
"Draw slot/tag bounding boxes on top of a rasterised page image.",
|
|
63
|
+
)
|
|
64
|
+
parser.add_argument("page_no", type=int, help="1-based page number.")
|
|
65
|
+
parser.add_argument("cfg_path", help="Path to fields.json (new schema).")
|
|
66
|
+
parser.add_argument("base_img", help="Input page PNG.")
|
|
67
|
+
parser.add_argument("out_img", help="Output PNG with overlay drawn.")
|
|
68
|
+
args = parser.parse_args(argv)
|
|
69
|
+
|
|
70
|
+
try:
|
|
71
|
+
render_overlay_preview(
|
|
72
|
+
args.page_no,
|
|
73
|
+
args.cfg_path,
|
|
74
|
+
args.base_img,
|
|
75
|
+
args.out_img,
|
|
76
|
+
quiet=args.quiet,
|
|
77
|
+
)
|
|
78
|
+
except FileNotFoundError as exc:
|
|
79
|
+
fail(f"File not found: {exc.filename}", code=2)
|
|
80
|
+
except Exception as exc: # noqa: BLE001
|
|
81
|
+
fail(f"Overlay preview failed: {exc}", code=2)
|
|
82
|
+
return 0
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
if __name__ == "__main__":
|
|
86
|
+
sys.exit(main())
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
"""Rasterise PDF pages to PNG images.
|
|
2
|
+
|
|
3
|
+
Each page becomes ``page_<N>.png`` inside the destination directory.
|
|
4
|
+
Pages larger than ``--max-edge`` (in pixels along the longer side)
|
|
5
|
+
are downsampled with PIL before being written, which keeps the output
|
|
6
|
+
manageable for visual inspection.
|
|
7
|
+
|
|
8
|
+
Run from the skill root::
|
|
9
|
+
|
|
10
|
+
python -m scripts.render.page_rasterize input.pdf out_dir/ \\
|
|
11
|
+
--max-edge 1200 --dpi 200
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
from __future__ import annotations
|
|
15
|
+
|
|
16
|
+
import os
|
|
17
|
+
import sys
|
|
18
|
+
|
|
19
|
+
from pdf2image import convert_from_path
|
|
20
|
+
|
|
21
|
+
from scripts.lib.cli_utils import emit, fail, make_parser
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def rasterize(
|
|
25
|
+
src_pdf: str,
|
|
26
|
+
dst_dir: str,
|
|
27
|
+
*,
|
|
28
|
+
max_edge: int = 1000,
|
|
29
|
+
dpi: int = 200,
|
|
30
|
+
quiet: bool = False,
|
|
31
|
+
) -> int:
|
|
32
|
+
os.makedirs(dst_dir, exist_ok=True)
|
|
33
|
+
page_imgs = convert_from_path(src_pdf, dpi=dpi)
|
|
34
|
+
|
|
35
|
+
for idx, img in enumerate(page_imgs):
|
|
36
|
+
w, h = img.size
|
|
37
|
+
if w > max_edge or h > max_edge:
|
|
38
|
+
shrink = min(max_edge / w, max_edge / h)
|
|
39
|
+
img = img.resize((int(w * shrink), int(h * shrink)))
|
|
40
|
+
out_png = os.path.join(dst_dir, f"page_{idx + 1}.png")
|
|
41
|
+
img.save(out_png)
|
|
42
|
+
emit(f" page {idx + 1} -> {out_png} ({img.size[0]}x{img.size[1]})", quiet=quiet)
|
|
43
|
+
|
|
44
|
+
emit(f"Rasterised {len(page_imgs)} page(s) into {dst_dir}", quiet=quiet)
|
|
45
|
+
return len(page_imgs)
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def main(argv: list[str] | None = None) -> int:
|
|
49
|
+
parser = make_parser(
|
|
50
|
+
"page_rasterize",
|
|
51
|
+
"Convert each PDF page into a PNG file under the output directory.",
|
|
52
|
+
)
|
|
53
|
+
parser.add_argument("src_pdf", help="Input PDF path.")
|
|
54
|
+
parser.add_argument("dst_dir", help="Output directory for PNGs.")
|
|
55
|
+
parser.add_argument(
|
|
56
|
+
"--max-edge",
|
|
57
|
+
type=int,
|
|
58
|
+
default=1000,
|
|
59
|
+
help="Cap the longer side (pixels). Set 0 to disable resizing.",
|
|
60
|
+
)
|
|
61
|
+
parser.add_argument(
|
|
62
|
+
"--dpi",
|
|
63
|
+
type=int,
|
|
64
|
+
default=200,
|
|
65
|
+
help="Initial render resolution before optional resizing.",
|
|
66
|
+
)
|
|
67
|
+
args = parser.parse_args(argv)
|
|
68
|
+
|
|
69
|
+
try:
|
|
70
|
+
rasterize(
|
|
71
|
+
args.src_pdf,
|
|
72
|
+
args.dst_dir,
|
|
73
|
+
max_edge=args.max_edge if args.max_edge > 0 else 10**9,
|
|
74
|
+
dpi=args.dpi,
|
|
75
|
+
quiet=args.quiet,
|
|
76
|
+
)
|
|
77
|
+
except FileNotFoundError:
|
|
78
|
+
fail(f"PDF not found: {args.src_pdf}", code=2)
|
|
79
|
+
except Exception as exc: # noqa: BLE001
|
|
80
|
+
fail(f"Rasterisation failed: {exc}", code=2)
|
|
81
|
+
return 0
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
if __name__ == "__main__":
|
|
85
|
+
sys.exit(main())
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* render_html.cjs — Render any HTML (file or URL) → PDF via Playwright.
|
|
4
|
+
*
|
|
5
|
+
* Usage:
|
|
6
|
+
* node render_html.cjs --in page.html --out report.pdf
|
|
7
|
+
* node render_html.cjs --in page.html --out report.pdf --wait 15000
|
|
8
|
+
* node render_html.cjs --in https://example.com --out site.pdf --landscape
|
|
9
|
+
*
|
|
10
|
+
* Options:
|
|
11
|
+
* --in <file|url> HTML file path or http(s):// URL (required)
|
|
12
|
+
* --out <file> Output PDF path (required)
|
|
13
|
+
* --wait <ms> Extra settle time after networkidle (default 800).
|
|
14
|
+
* Bump to 15000+ for Chart.js / heavy JS pages.
|
|
15
|
+
* --format <A4|Letter> Page format (default A4)
|
|
16
|
+
* --margin <css> CSS margin shorthand, e.g. "14mm 12mm" (default "14mm 12mm")
|
|
17
|
+
* --landscape Landscape orientation
|
|
18
|
+
* --scale <n> Print scale 0.1–2 (default 1)
|
|
19
|
+
* --no-print-background Disable -webkit-print-color-adjust:exact rendering
|
|
20
|
+
* --header <html> Optional header HTML template
|
|
21
|
+
* --footer <html> Optional footer HTML template
|
|
22
|
+
*
|
|
23
|
+
* Exit codes: 0 success, 1 bad args, 2 dependency missing, 3 render error
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
const path = require('path');
|
|
27
|
+
const fs = require('fs');
|
|
28
|
+
|
|
29
|
+
function usage(msg) {
|
|
30
|
+
if (msg) console.error(msg);
|
|
31
|
+
console.error(
|
|
32
|
+
'Usage: node render_html.cjs --in <file.html|url> --out <file.pdf>\n' +
|
|
33
|
+
' [--wait <ms>] [--format A4|Letter] [--margin "14mm 12mm"]\n' +
|
|
34
|
+
' [--landscape] [--scale 1] [--no-print-background]\n' +
|
|
35
|
+
' [--header <html>] [--footer <html>]',
|
|
36
|
+
);
|
|
37
|
+
process.exit(1);
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// ── Arg parsing ────────────────────────────────────────────────────────────────
|
|
41
|
+
const args = process.argv.slice(2);
|
|
42
|
+
let input = null;
|
|
43
|
+
let outFile = null;
|
|
44
|
+
let waitMs = 800;
|
|
45
|
+
let format = 'A4';
|
|
46
|
+
let margin = '14mm 12mm';
|
|
47
|
+
let landscape = false;
|
|
48
|
+
let scale = 1;
|
|
49
|
+
let printBackground = true;
|
|
50
|
+
let headerHtml = null;
|
|
51
|
+
let footerHtml = null;
|
|
52
|
+
|
|
53
|
+
for (let i = 0; i < args.length; i++) {
|
|
54
|
+
const a = args[i];
|
|
55
|
+
if ((a === '--in' || a === '--input') && args[i + 1]) input = args[++i];
|
|
56
|
+
else if (a === '--out' && args[i + 1]) outFile = args[++i];
|
|
57
|
+
else if (a === '--wait' && args[i + 1]) waitMs = parseInt(args[++i], 10);
|
|
58
|
+
else if (a === '--format' && args[i + 1]) format = args[++i];
|
|
59
|
+
else if (a === '--margin' && args[i + 1]) margin = args[++i];
|
|
60
|
+
else if (a === '--scale' && args[i + 1]) scale = parseFloat(args[++i]);
|
|
61
|
+
else if (a === '--landscape') landscape = true;
|
|
62
|
+
else if (a === '--no-print-background') printBackground = false;
|
|
63
|
+
else if (a === '--header' && args[i + 1]) headerHtml = args[++i];
|
|
64
|
+
else if (a === '--footer' && args[i + 1]) footerHtml = args[++i];
|
|
65
|
+
else if (a === '-h' || a === '--help') usage();
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
if (!input || !outFile) usage('error: --in and --out are required');
|
|
69
|
+
|
|
70
|
+
// Resolve --in to file:// URL or pass through if already http(s)://
|
|
71
|
+
let pageUrl;
|
|
72
|
+
if (/^https?:\/\//i.test(input)) {
|
|
73
|
+
pageUrl = input;
|
|
74
|
+
} else {
|
|
75
|
+
if (!fs.existsSync(input)) {
|
|
76
|
+
console.error(JSON.stringify({ status: 'error', error: `File not found: ${input}` }));
|
|
77
|
+
process.exit(1);
|
|
78
|
+
}
|
|
79
|
+
pageUrl = 'file://' + path.resolve(input);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
// Parse CSS margin shorthand → Playwright margin object
|
|
83
|
+
function parseMargin(css) {
|
|
84
|
+
const parts = css.trim().split(/\s+/);
|
|
85
|
+
const [t, r, b, l] = (() => {
|
|
86
|
+
if (parts.length === 1) return [parts[0], parts[0], parts[0], parts[0]];
|
|
87
|
+
if (parts.length === 2) return [parts[0], parts[1], parts[0], parts[1]];
|
|
88
|
+
if (parts.length === 3) return [parts[0], parts[1], parts[2], parts[1]];
|
|
89
|
+
return [parts[0], parts[1], parts[2], parts[3]];
|
|
90
|
+
})();
|
|
91
|
+
return { top: t, right: r, bottom: b, left: l };
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// ── Playwright loader (tolerates global npm installs) ─────────────────────────
|
|
95
|
+
function loadPlaywright() {
|
|
96
|
+
const { execSync } = require('child_process');
|
|
97
|
+
try {
|
|
98
|
+
return require('playwright');
|
|
99
|
+
} catch (_) {}
|
|
100
|
+
try {
|
|
101
|
+
const root = execSync('npm root -g', { stdio: ['ignore', 'pipe', 'ignore'] })
|
|
102
|
+
.toString()
|
|
103
|
+
.trim();
|
|
104
|
+
return require(path.join(root, 'playwright'));
|
|
105
|
+
} catch (_) {}
|
|
106
|
+
console.error(
|
|
107
|
+
JSON.stringify({
|
|
108
|
+
status: 'error',
|
|
109
|
+
error: 'playwright not found',
|
|
110
|
+
hint: 'Run: bash scripts/make.sh fix (or: npm install -g playwright && npx playwright install chromium)',
|
|
111
|
+
}),
|
|
112
|
+
);
|
|
113
|
+
process.exit(2);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
// ── Main ───────────────────────────────────────────────────────────────────────
|
|
117
|
+
(async () => {
|
|
118
|
+
const { chromium } = loadPlaywright();
|
|
119
|
+
|
|
120
|
+
let browser;
|
|
121
|
+
try {
|
|
122
|
+
browser = await chromium.launch();
|
|
123
|
+
} catch (_) {
|
|
124
|
+
// Chromium binary missing — try installing once
|
|
125
|
+
const { spawnSync } = require('child_process');
|
|
126
|
+
const r = spawnSync('npx', ['playwright', 'install', 'chromium'], {
|
|
127
|
+
stdio: 'inherit',
|
|
128
|
+
shell: true,
|
|
129
|
+
});
|
|
130
|
+
if (r.status !== 0) {
|
|
131
|
+
console.error(
|
|
132
|
+
JSON.stringify({
|
|
133
|
+
status: 'error',
|
|
134
|
+
error: 'Chromium not installed and auto-install failed',
|
|
135
|
+
hint: 'Run: npx playwright install chromium',
|
|
136
|
+
}),
|
|
137
|
+
);
|
|
138
|
+
process.exit(2);
|
|
139
|
+
}
|
|
140
|
+
browser = await chromium.launch();
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
try {
|
|
144
|
+
const page = await browser.newPage();
|
|
145
|
+
page.setDefaultTimeout(60_000);
|
|
146
|
+
page.setDefaultNavigationTimeout(60_000);
|
|
147
|
+
|
|
148
|
+
await page.goto(pageUrl, { waitUntil: 'networkidle', timeout: 60_000 });
|
|
149
|
+
|
|
150
|
+
// Wait for web fonts to actually load (otherwise body text falls back to
|
|
151
|
+
// a generic sans-serif while the snapshot is taken).
|
|
152
|
+
try {
|
|
153
|
+
await page.waitForFunction(() => document.fonts && document.fonts.ready, { timeout: 15_000 });
|
|
154
|
+
await page.evaluate(() => document.fonts.ready);
|
|
155
|
+
} catch (_) {
|
|
156
|
+
// Best effort — some pages have no @font-face; ignore.
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
// Extra settle window for Chart.js / lazy images / late JS.
|
|
160
|
+
if (waitMs > 0) await page.waitForTimeout(waitMs);
|
|
161
|
+
|
|
162
|
+
const pdfOpts = {
|
|
163
|
+
path: outFile,
|
|
164
|
+
format,
|
|
165
|
+
printBackground,
|
|
166
|
+
landscape,
|
|
167
|
+
scale,
|
|
168
|
+
margin: parseMargin(margin),
|
|
169
|
+
};
|
|
170
|
+
if (headerHtml || footerHtml) {
|
|
171
|
+
pdfOpts.displayHeaderFooter = true;
|
|
172
|
+
if (headerHtml) pdfOpts.headerTemplate = headerHtml;
|
|
173
|
+
if (footerHtml) pdfOpts.footerTemplate = footerHtml;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
await page.pdf(pdfOpts);
|
|
177
|
+
await browser.close();
|
|
178
|
+
|
|
179
|
+
const stat = fs.statSync(outFile);
|
|
180
|
+
if (stat.size < 5000) {
|
|
181
|
+
console.error(
|
|
182
|
+
JSON.stringify({
|
|
183
|
+
status: 'error',
|
|
184
|
+
error: 'Output PDF is suspiciously small — page may be blank',
|
|
185
|
+
hint: 'Open the source HTML in a browser and check for render errors',
|
|
186
|
+
}),
|
|
187
|
+
);
|
|
188
|
+
process.exit(3);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
console.log(
|
|
192
|
+
JSON.stringify({
|
|
193
|
+
status: 'ok',
|
|
194
|
+
out: outFile,
|
|
195
|
+
size_kb: Math.round(stat.size / 1024),
|
|
196
|
+
format,
|
|
197
|
+
landscape,
|
|
198
|
+
}),
|
|
199
|
+
);
|
|
200
|
+
} catch (e) {
|
|
201
|
+
if (browser) await browser.close().catch(() => {});
|
|
202
|
+
console.error(JSON.stringify({ status: 'error', error: String(e) }));
|
|
203
|
+
process.exit(3);
|
|
204
|
+
}
|
|
205
|
+
})();
|
|
File without changes
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
"""Lint bounding-box geometry inside a fields.json config.
|
|
2
|
+
|
|
3
|
+
Catches the two mistakes operators make most often when hand-editing
|
|
4
|
+
``fields.json``:
|
|
5
|
+
|
|
6
|
+
1. **Overlapping rectangles** (slot vs. slot, slot vs. tag, tag vs.
|
|
7
|
+
tag), which cause text to land on top of other text.
|
|
8
|
+
2. **Slot boxes that are too short** for the configured font size,
|
|
9
|
+
which clips glyphs.
|
|
10
|
+
|
|
11
|
+
The script returns exit code 0 only if no findings are produced.
|
|
12
|
+
|
|
13
|
+
Run from the skill root::
|
|
14
|
+
|
|
15
|
+
python -m scripts.validate.geometry_lint fields.json --max-findings 20
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
from __future__ import annotations
|
|
19
|
+
|
|
20
|
+
import json
|
|
21
|
+
import sys
|
|
22
|
+
from dataclasses import dataclass
|
|
23
|
+
|
|
24
|
+
from scripts.lib.cli_utils import make_parser
|
|
25
|
+
from scripts.lib.geometry import boxes_overlap
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
@dataclass
|
|
29
|
+
class BoxRecord:
|
|
30
|
+
bbox: list[float]
|
|
31
|
+
kind: str # "slot" or "tag"
|
|
32
|
+
owner: dict # the original slot dict
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def _label_for(slot: dict) -> str:
|
|
36
|
+
return slot.get("description") or slot.get("tag_text") or "<unnamed>"
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def lint(cfg_path: str, max_findings: int = 20) -> tuple[bool, list[str]]:
|
|
40
|
+
with open(cfg_path) as handle:
|
|
41
|
+
cfg = json.load(handle)
|
|
42
|
+
|
|
43
|
+
findings: list[str] = []
|
|
44
|
+
findings.append(f"Read {len(cfg['slots'])} slots from {cfg_path}")
|
|
45
|
+
|
|
46
|
+
boxes: list[BoxRecord] = []
|
|
47
|
+
for slot in cfg["slots"]:
|
|
48
|
+
if "tag_box" in slot:
|
|
49
|
+
boxes.append(BoxRecord(slot["tag_box"], "tag", slot))
|
|
50
|
+
if "slot_box" in slot:
|
|
51
|
+
boxes.append(BoxRecord(slot["slot_box"], "slot", slot))
|
|
52
|
+
|
|
53
|
+
failed = False
|
|
54
|
+
|
|
55
|
+
# --- intersection scan ---
|
|
56
|
+
for i, left in enumerate(boxes):
|
|
57
|
+
for right in boxes[i + 1 :]:
|
|
58
|
+
if left.owner["page_no"] != right.owner["page_no"]:
|
|
59
|
+
continue
|
|
60
|
+
if not boxes_overlap(left.bbox, right.bbox):
|
|
61
|
+
continue
|
|
62
|
+
failed = True
|
|
63
|
+
if left.owner is right.owner:
|
|
64
|
+
findings.append(
|
|
65
|
+
f"FAILURE: slot/tag overlap inside `{_label_for(left.owner)}`: "
|
|
66
|
+
f"{left.bbox} vs {right.bbox}"
|
|
67
|
+
)
|
|
68
|
+
else:
|
|
69
|
+
findings.append(
|
|
70
|
+
f"FAILURE: {left.kind} of `{_label_for(left.owner)}` "
|
|
71
|
+
f"({left.bbox}) overlaps {right.kind} of "
|
|
72
|
+
f"`{_label_for(right.owner)}` ({right.bbox})"
|
|
73
|
+
)
|
|
74
|
+
if len(findings) >= max_findings:
|
|
75
|
+
findings.append("Too many findings; aborting further checks.")
|
|
76
|
+
return True, findings
|
|
77
|
+
|
|
78
|
+
# --- height check ---
|
|
79
|
+
for record in boxes:
|
|
80
|
+
if record.kind != "slot":
|
|
81
|
+
continue
|
|
82
|
+
glyph_spec = record.owner.get("value")
|
|
83
|
+
if not glyph_spec:
|
|
84
|
+
continue
|
|
85
|
+
glyph_pt = glyph_spec.get("size", 14)
|
|
86
|
+
slot_h = record.bbox[3] - record.bbox[1]
|
|
87
|
+
if slot_h < glyph_pt:
|
|
88
|
+
failed = True
|
|
89
|
+
findings.append(
|
|
90
|
+
f"FAILURE: slot height {slot_h} for `{_label_for(record.owner)}` "
|
|
91
|
+
f"is shorter than glyph size {glyph_pt}; either grow the box or "
|
|
92
|
+
"shrink value.size."
|
|
93
|
+
)
|
|
94
|
+
if len(findings) >= max_findings:
|
|
95
|
+
findings.append("Too many findings; aborting further checks.")
|
|
96
|
+
return True, findings
|
|
97
|
+
|
|
98
|
+
if not failed:
|
|
99
|
+
findings.append("SUCCESS: all bounding boxes look sane.")
|
|
100
|
+
return failed, findings
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
def main(argv: list[str] | None = None) -> int:
|
|
104
|
+
parser = make_parser(
|
|
105
|
+
"geometry_lint",
|
|
106
|
+
"Validate bounding-box geometry inside a fields.json file.",
|
|
107
|
+
)
|
|
108
|
+
parser.add_argument("cfg_path", help="Path to fields.json.")
|
|
109
|
+
parser.add_argument(
|
|
110
|
+
"--max-findings",
|
|
111
|
+
type=int,
|
|
112
|
+
default=20,
|
|
113
|
+
help="Stop reporting after this many findings (default 20).",
|
|
114
|
+
)
|
|
115
|
+
args = parser.parse_args(argv)
|
|
116
|
+
|
|
117
|
+
failed, findings = lint(args.cfg_path, max_findings=args.max_findings)
|
|
118
|
+
for line in findings:
|
|
119
|
+
print(line)
|
|
120
|
+
return 1 if failed else 0
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
if __name__ == "__main__":
|
|
124
|
+
sys.exit(main())
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# Templates Index
|
|
2
|
+
|
|
3
|
+
Eight production-grade PDF templates — every CREATE / REFORMAT skeleton renders via Playwright
|
|
4
|
+
HTML+CSS → PDF (no token pipeline, no LaTeX). Use them as starting points; copy, re-skin, and
|
|
5
|
+
render.
|
|
6
|
+
|
|
7
|
+
> **Diversity reminder.** Each skeleton ships with a baseline palette, fonts, and section ordering
|
|
8
|
+
> so the layout demo works out-of-the-box. **Adapt these to the user's brand, topic, mood, or
|
|
9
|
+
> audience every time** — do not return three different documents using the same bronze/gold (menu)
|
|
10
|
+
> or navy (research report) palette. Each README §7 lists the **structural invariants** you must
|
|
11
|
+
> keep and the **swappables** you should vary.
|
|
12
|
+
|
|
13
|
+
| Slug | Route | Use case | Trigger keywords |
|
|
14
|
+
| ------------------------- | -------------------- | ------------------------------------------------ | --------------------------------------------------------- |
|
|
15
|
+
| bilingual-menu-premium | CREATE | Premium bilingual menus | "menu", "bilingual menu", "餐厅菜单" |
|
|
16
|
+
| brand-guide-2page | CREATE | 2-page brand guide | "brand guide", "design system" |
|
|
17
|
+
| data-viz-report | CREATE | Chart-rich data analysis brief | "data report", "可视化", "benchmark", "图文报告" |
|
|
18
|
+
| multi-article-aggregator | CREATE | Article digest / anthology | "article digest", "newsletter" |
|
|
19
|
+
| multilang-research-report | CREATE | Multi-country research report | "research report", "regulatory survey" |
|
|
20
|
+
| reformat-default | REFORMAT | Default markdown / text / pdf reformat | "reformat", "markdown to PDF", "重排版" |
|
|
21
|
+
| translate-preserve-layout | REFORMAT | Translate while preserving layout | "translate PDF", "翻译保版" |
|
|
22
|
+
| form-fill-acroform | FILL | Government / official form fill | "fill form", "visa form", "签证表" |
|
|
23
|
+
| latex-technical-book | LATEX_TECHNICAL_BOOK | Chinese technical books / engineering monographs | "技术书", "源码解析书", "LaTeX 技术出版", "O'Reilly 风格" |
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
### CREATE — copy a skeleton, fill placeholders, render
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# 1. Pick a template
|
|
31
|
+
cat templates/INDEX.md # the file you are reading
|
|
32
|
+
cat templates/<slug>/README.md # 7-section recipe (when-to-use → generalization)
|
|
33
|
+
|
|
34
|
+
# 2. Copy the skeleton + edit
|
|
35
|
+
cp templates/<slug>/skeleton.html /tmp/work/page.html
|
|
36
|
+
$EDITOR /tmp/work/page.html # replace <!-- PLACEHOLDER --> tokens
|
|
37
|
+
|
|
38
|
+
# 3. Render (15s settle if Chart.js is on the page)
|
|
39
|
+
bash scripts/make.sh render --in /tmp/work/page.html --out /tmp/work/out.pdf --wait 15000
|
|
40
|
+
|
|
41
|
+
# 4. Verify
|
|
42
|
+
pdfinfo /tmp/work/out.pdf | grep Pages
|
|
43
|
+
open /tmp/work/out.pdf
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### REFORMAT — single-command markdown → PDF
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
bash scripts/make.sh reformat \
|
|
50
|
+
--input doc.md --out report.pdf \
|
|
51
|
+
--title "My Report" --author "Jane" --accent "#0a7488"
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
The `reformat-default` template is auto-applied. Pass `--template <slug>` to use a different
|
|
55
|
+
`templates/reformat-*/` skeleton.
|
|
56
|
+
|
|
57
|
+
### FILL — see [form-fill-acroform/README.md](form-fill-acroform/README.md)
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
bash scripts/make.sh fill probe form.pdf
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Per-template files
|
|
64
|
+
|
|
65
|
+
Each `templates/<slug>/` contains:
|
|
66
|
+
|
|
67
|
+
- `README.md` — the full seven-section recipe (when-to-use / pipeline / shape / visual / skeleton /
|
|
68
|
+
pitfalls / generalization).
|
|
69
|
+
- `skeleton.html` (or `skeleton.json` / `pipeline.md`) — a copy-and-edit starting point with
|
|
70
|
+
placeholders marked `<!-- PLACEHOLDER -->`.
|
|
71
|
+
- A small helper file when relevant (`terminology.template.json`, `field_values.template.json`).
|
|
72
|
+
|
|
73
|
+
## Case exemplars
|
|
74
|
+
|
|
75
|
+
| Case | Source | Use when | Files |
|
|
76
|
+
| ---------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
77
|
+
| Chinese technical book (LaTeX) | Structured HTML / Markdown chapters for a technical book | Long-form source-code reading or engineering book needs B5 book typography, O'Reilly-like cover, clickable TOC, code blocks, callouts, and diagrams; read `../docs/latex-technical-book-guide.md` first | `latex-technical-book/source.tex`; `latex-technical-book/README.md` |
|
|
78
|
+
|
|
79
|
+
## When nothing matches
|
|
80
|
+
|
|
81
|
+
- Document is structurally close to a template → **adapt the closest one** and re-skin (palette +
|
|
82
|
+
cover archetype). Faster than from-zero authoring.
|
|
83
|
+
- Completely different shape → hand-author HTML following
|
|
84
|
+
[`../docs/html-pdf-spec.md`](../docs/html-pdf-spec.md) (the mechanical contract) and
|
|
85
|
+
[`../docs/design-guide.md`](../docs/design-guide.md) (the aesthetic contract). Copy individual
|
|
86
|
+
primitives (KPI grid, chart card, pill table, conclusion block) from
|
|
87
|
+
`data-viz-report/skeleton.html`.
|
|
88
|
+
- Still unsure → read a reference PDF first via the READ route:
|
|
89
|
+
`python3 -m scripts.read_pdf_vision --input <reference.pdf> --pages 1`, understand the structure,
|
|
90
|
+
then choose.
|