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,170 @@
|
|
|
1
|
+
"""AcroForm metadata enumeration for the Alran PDF skill.
|
|
2
|
+
|
|
3
|
+
The functions here produce the JSON-shaped records that the
|
|
4
|
+
``inspect`` and ``fill`` script groups consume. The schema is:
|
|
5
|
+
|
|
6
|
+
[
|
|
7
|
+
{
|
|
8
|
+
"qname": str, # fully qualified field name
|
|
9
|
+
"page_no": int, # 1-based page number
|
|
10
|
+
"box": [l, b, r, t], # rectangle in PDF user space
|
|
11
|
+
"type": "text" | "checkbox" | "radio_group" | "choice" | "unknown (...)",
|
|
12
|
+
# type-specific extras:
|
|
13
|
+
"on_value": str, # checkbox: the value that ticks the box
|
|
14
|
+
"off_value": str, # checkbox: the value that unticks it
|
|
15
|
+
"radio_choices": [...], # radio: [{"set_to": str, "box": [...]}]
|
|
16
|
+
"choice_options": [...] # choice: [{"set_to": str, "label": str}]
|
|
17
|
+
}
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
The qname is the dotted path of every ``/T`` from the leaf annotation
|
|
21
|
+
up to the root, joined with "." (so "address.line2" stays distinct
|
|
22
|
+
from "shipping.line2"). When pypdf cannot resolve the parent chain we
|
|
23
|
+
return ``None``.
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
from __future__ import annotations
|
|
27
|
+
|
|
28
|
+
from typing import Any
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def resolve_full_qualified_name(annot: Any) -> str | None:
|
|
32
|
+
"""Walk the ``/Parent`` chain of an annotation/field and join names."""
|
|
33
|
+
parts: list[str] = []
|
|
34
|
+
cursor = annot
|
|
35
|
+
while cursor is not None:
|
|
36
|
+
leaf = cursor.get("/T")
|
|
37
|
+
if leaf:
|
|
38
|
+
parts.append(leaf)
|
|
39
|
+
cursor = cursor.get("/Parent")
|
|
40
|
+
if not parts:
|
|
41
|
+
return None
|
|
42
|
+
return ".".join(reversed(parts))
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def build_field_record(raw_field: Any, qname: str) -> dict:
|
|
46
|
+
"""Turn a pypdf field object into our JSON record (without box/page)."""
|
|
47
|
+
record: dict = {"qname": qname}
|
|
48
|
+
ft = raw_field.get("/FT")
|
|
49
|
+
if ft == "/Tx":
|
|
50
|
+
record["type"] = "text"
|
|
51
|
+
elif ft == "/Btn":
|
|
52
|
+
record["type"] = "checkbox"
|
|
53
|
+
states = raw_field.get("/_States_", [])
|
|
54
|
+
if len(states) == 2:
|
|
55
|
+
if "/Off" in states:
|
|
56
|
+
on = states[0] if states[0] != "/Off" else states[1]
|
|
57
|
+
record["on_value"] = on
|
|
58
|
+
record["off_value"] = "/Off"
|
|
59
|
+
else:
|
|
60
|
+
# Unusual two-state checkbox without an explicit /Off.
|
|
61
|
+
# Fall back to positional guess and warn the caller.
|
|
62
|
+
print(
|
|
63
|
+
f"WARN: checkbox `{qname}` has non-standard states "
|
|
64
|
+
f"{states}; verify the rendered PDF before relying on it."
|
|
65
|
+
)
|
|
66
|
+
record["on_value"] = states[0]
|
|
67
|
+
record["off_value"] = states[1]
|
|
68
|
+
elif ft == "/Ch":
|
|
69
|
+
record["type"] = "choice"
|
|
70
|
+
states = raw_field.get("/_States_", [])
|
|
71
|
+
record["choice_options"] = [
|
|
72
|
+
{"set_to": pair[0], "label": pair[1]} for pair in states
|
|
73
|
+
]
|
|
74
|
+
else:
|
|
75
|
+
record["type"] = f"unknown ({ft})"
|
|
76
|
+
return record
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def enumerate_acroform_fields(pdf_doc) -> list[dict]:
|
|
80
|
+
"""Return every fillable field in reading order, with location info.
|
|
81
|
+
|
|
82
|
+
``pdf_doc`` is a ``pypdf.PdfReader``. Fields without a resolvable
|
|
83
|
+
page/box are skipped with a printed warning so a caller scanning the
|
|
84
|
+
JSON output never sees half-populated records.
|
|
85
|
+
"""
|
|
86
|
+
raw_fields = pdf_doc.get_fields() or {}
|
|
87
|
+
|
|
88
|
+
record_by_qname: dict[str, dict] = {}
|
|
89
|
+
candidate_radio_qnames: set[str] = set()
|
|
90
|
+
|
|
91
|
+
for qname, field in raw_fields.items():
|
|
92
|
+
if field.get("/Kids"):
|
|
93
|
+
if field.get("/FT") == "/Btn":
|
|
94
|
+
candidate_radio_qnames.add(qname)
|
|
95
|
+
continue
|
|
96
|
+
record_by_qname[qname] = build_field_record(field, qname)
|
|
97
|
+
|
|
98
|
+
radio_groups_by_qname: dict[str, dict] = {}
|
|
99
|
+
|
|
100
|
+
for page_index, pg in enumerate(pdf_doc.pages):
|
|
101
|
+
for ann in pg.get("/Annots", []):
|
|
102
|
+
qname = resolve_full_qualified_name(ann)
|
|
103
|
+
if qname in record_by_qname:
|
|
104
|
+
record_by_qname[qname]["page_no"] = page_index + 1
|
|
105
|
+
record_by_qname[qname]["box"] = ann.get("/Rect")
|
|
106
|
+
elif qname in candidate_radio_qnames:
|
|
107
|
+
try:
|
|
108
|
+
on_states = [v for v in ann["/AP"]["/N"] if v != "/Off"]
|
|
109
|
+
except KeyError:
|
|
110
|
+
continue
|
|
111
|
+
if len(on_states) != 1:
|
|
112
|
+
continue
|
|
113
|
+
box = ann.get("/Rect")
|
|
114
|
+
if qname not in radio_groups_by_qname:
|
|
115
|
+
radio_groups_by_qname[qname] = {
|
|
116
|
+
"qname": qname,
|
|
117
|
+
"type": "radio_group",
|
|
118
|
+
"page_no": page_index + 1,
|
|
119
|
+
"radio_choices": [],
|
|
120
|
+
}
|
|
121
|
+
radio_groups_by_qname[qname]["radio_choices"].append(
|
|
122
|
+
{"set_to": on_states[0], "box": box}
|
|
123
|
+
)
|
|
124
|
+
|
|
125
|
+
placed_records: list[dict] = []
|
|
126
|
+
for record in record_by_qname.values():
|
|
127
|
+
if "page_no" in record:
|
|
128
|
+
placed_records.append(record)
|
|
129
|
+
else:
|
|
130
|
+
print(
|
|
131
|
+
f"WARN: cannot place field `{record.get('qname')}`, "
|
|
132
|
+
"skipping it in the output."
|
|
133
|
+
)
|
|
134
|
+
|
|
135
|
+
def reading_order_key(rec: dict):
|
|
136
|
+
if "radio_choices" in rec:
|
|
137
|
+
box = rec["radio_choices"][0]["box"] or [0, 0, 0, 0]
|
|
138
|
+
else:
|
|
139
|
+
box = rec.get("box") or [0, 0, 0, 0]
|
|
140
|
+
# sort top-to-bottom (negative y so larger y first), then left-to-right
|
|
141
|
+
return [rec.get("page_no"), [-box[1], box[0]]]
|
|
142
|
+
|
|
143
|
+
ordered_records = placed_records + list(radio_groups_by_qname.values())
|
|
144
|
+
ordered_records.sort(key=reading_order_key)
|
|
145
|
+
return ordered_records
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def patch_pypdf_inheritance() -> None:
|
|
149
|
+
"""Smooth over a pypdf quirk for choice fields.
|
|
150
|
+
|
|
151
|
+
pypdf's ``DictionaryObject.get_inherited`` returns the raw ``/Opt``
|
|
152
|
+
list which, for choice widgets that store ``[value, display]`` pairs,
|
|
153
|
+
breaks downstream value validation. We unwrap the pair so callers see
|
|
154
|
+
a flat list of valid values.
|
|
155
|
+
"""
|
|
156
|
+
from pypdf.generic import DictionaryObject
|
|
157
|
+
from pypdf.constants import FieldDictionaryAttributes
|
|
158
|
+
|
|
159
|
+
original = DictionaryObject.get_inherited
|
|
160
|
+
|
|
161
|
+
def patched(self, key: str, default=None):
|
|
162
|
+
result = original(self, key, default)
|
|
163
|
+
if key == FieldDictionaryAttributes.Opt:
|
|
164
|
+
if isinstance(result, list) and all(
|
|
165
|
+
isinstance(v, list) and len(v) == 2 for v in result
|
|
166
|
+
):
|
|
167
|
+
result = [r[0] for r in result]
|
|
168
|
+
return result
|
|
169
|
+
|
|
170
|
+
DictionaryObject.get_inherited = patched
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
"""Tiny CLI helpers shared across the Alran PDF skill scripts.
|
|
2
|
+
|
|
3
|
+
Each entry-point script in ``scripts/`` builds its argparse parser
|
|
4
|
+
through :func:`make_parser` so the help output, default ``--quiet`` /
|
|
5
|
+
``--verbose`` flags, and exit-code conventions stay uniform. The
|
|
6
|
+
``emit`` / ``warn`` / ``fail`` helpers funnel all chatter through a
|
|
7
|
+
single place so we can later switch to ``logging`` if needed.
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
from __future__ import annotations
|
|
11
|
+
|
|
12
|
+
import argparse
|
|
13
|
+
import sys
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def make_parser(prog: str, description: str) -> argparse.ArgumentParser:
|
|
17
|
+
"""Build a parser pre-loaded with the project-wide flags."""
|
|
18
|
+
parser = argparse.ArgumentParser(prog=prog, description=description)
|
|
19
|
+
parser.add_argument(
|
|
20
|
+
"--quiet",
|
|
21
|
+
action="store_true",
|
|
22
|
+
help="Suppress informational output (warnings and errors still print).",
|
|
23
|
+
)
|
|
24
|
+
return parser
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def emit(msg: str, *, quiet: bool = False) -> None:
|
|
28
|
+
"""Print an informational message unless ``--quiet`` is in effect."""
|
|
29
|
+
if not quiet:
|
|
30
|
+
print(msg)
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def warn(msg: str) -> None:
|
|
34
|
+
"""Print a warning to stderr; never silenced by ``--quiet``."""
|
|
35
|
+
print(f"WARN: {msg}", file=sys.stderr)
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def fail(msg: str, code: int = 1) -> None:
|
|
39
|
+
"""Print an error to stderr and exit with a non-zero status."""
|
|
40
|
+
print(f"ERROR: {msg}", file=sys.stderr)
|
|
41
|
+
sys.exit(code)
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
"""Geometry helpers for the Alran PDF skill.
|
|
2
|
+
|
|
3
|
+
This module concentrates the coordinate-system bridges that the
|
|
4
|
+
form-fill scripts share:
|
|
5
|
+
|
|
6
|
+
- ``image_box_to_pdf_rect``: rasterised page pixel coords -> pypdf rect
|
|
7
|
+
(origin at the bottom-left of the page).
|
|
8
|
+
- ``pdf_box_to_pypdf_rect``: pdfplumber-style PDF coords (origin at
|
|
9
|
+
the top-left) -> pypdf rect (origin at the bottom-left).
|
|
10
|
+
- ``boxes_overlap``: boolean intersection check used by the geometry
|
|
11
|
+
linter.
|
|
12
|
+
|
|
13
|
+
All functions are intentionally side-effect free so the module can be
|
|
14
|
+
imported at unit-test time without touching disk or pulling in heavy
|
|
15
|
+
PDF dependencies.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
from __future__ import annotations
|
|
19
|
+
|
|
20
|
+
from typing import Sequence
|
|
21
|
+
|
|
22
|
+
# Type aliases (Python 3.9+ accepts these in annotations because
|
|
23
|
+
# ``from __future__ import annotations`` defers evaluation).
|
|
24
|
+
Box = Sequence[float]
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def image_box_to_pdf_rect(
|
|
28
|
+
bbox: Box,
|
|
29
|
+
img_w: float,
|
|
30
|
+
img_h: float,
|
|
31
|
+
pdf_w: float,
|
|
32
|
+
pdf_h: float,
|
|
33
|
+
) -> tuple[float, float, float, float]:
|
|
34
|
+
"""Convert a pixel-space bbox into a pypdf rectangle.
|
|
35
|
+
|
|
36
|
+
``bbox`` is ``[left, top, right, bottom]`` in raster pixels. The
|
|
37
|
+
output is ``(left, bottom, right, top)`` in PDF user-space points,
|
|
38
|
+
with the origin at the bottom-left of the page (which is what
|
|
39
|
+
``pypdf.annotations.FreeText`` expects).
|
|
40
|
+
"""
|
|
41
|
+
sx = pdf_w / img_w
|
|
42
|
+
sy = pdf_h / img_h
|
|
43
|
+
|
|
44
|
+
left = bbox[0] * sx
|
|
45
|
+
right = bbox[2] * sx
|
|
46
|
+
|
|
47
|
+
top = pdf_h - (bbox[1] * sy)
|
|
48
|
+
bottom = pdf_h - (bbox[3] * sy)
|
|
49
|
+
|
|
50
|
+
return left, bottom, right, top
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def pdf_box_to_pypdf_rect(
|
|
54
|
+
bbox: Box,
|
|
55
|
+
pdf_h: float,
|
|
56
|
+
) -> tuple[float, float, float, float]:
|
|
57
|
+
"""Flip a pdfplumber-style bbox to pypdf orientation.
|
|
58
|
+
|
|
59
|
+
pdfplumber reports ``[x0, top, x1, bottom]`` with the origin at the
|
|
60
|
+
top-left; pypdf expects the origin at the bottom-left.
|
|
61
|
+
"""
|
|
62
|
+
left = bbox[0]
|
|
63
|
+
right = bbox[2]
|
|
64
|
+
pypdf_top = pdf_h - bbox[1]
|
|
65
|
+
pypdf_bottom = pdf_h - bbox[3]
|
|
66
|
+
return left, pypdf_bottom, right, pypdf_top
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def boxes_overlap(box_a: Box, box_b: Box) -> bool:
|
|
70
|
+
"""True iff two axis-aligned boxes have a non-empty intersection.
|
|
71
|
+
|
|
72
|
+
Both inputs are ``[left, top, right, bottom]`` (the convention used
|
|
73
|
+
in the ``fields.json`` schema). Edge contact is treated as
|
|
74
|
+
*non-overlapping* so the linter does not complain about boxes that
|
|
75
|
+
happen to share a border.
|
|
76
|
+
"""
|
|
77
|
+
apart_x = box_a[0] >= box_b[2] or box_a[2] <= box_b[0]
|
|
78
|
+
apart_y = box_a[1] >= box_b[3] or box_a[3] <= box_b[1]
|
|
79
|
+
return not (apart_x or apart_y)
|
|
@@ -0,0 +1,388 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# make.sh — pdf unified CLI (HTML → PDF)
|
|
3
|
+
# Usage: bash make.sh <command> [options]
|
|
4
|
+
#
|
|
5
|
+
# Commands:
|
|
6
|
+
# check Verify all dependencies
|
|
7
|
+
# fix Auto-install missing dependencies
|
|
8
|
+
# render --in page.html --out report.pdf [--wait 15000] [--format A4] ...
|
|
9
|
+
# CREATE: render any HTML file/URL → PDF
|
|
10
|
+
# reformat --input doc.md --out report.pdf [--title T] [--accent #HEX] ...
|
|
11
|
+
# REFORMAT: parse markdown/text/pdf → HTML → PDF
|
|
12
|
+
# fill <subcommand> [args...] FILL: probe / inspect / apply (AcroForm)
|
|
13
|
+
# scan / rasterize / preview / overlay / lint (visual)
|
|
14
|
+
#
|
|
15
|
+
# For READ / extract existing PDFs, see docs/read-guide.md (pdfplumber default,
|
|
16
|
+
# scripts/read_pdf_vision.py for vision escalation).
|
|
17
|
+
# For PDF mutation (merge / split / rotate / watermark / annotate), see
|
|
18
|
+
# docs/advanced-reference.md (qpdf / pypdf / reportlab cookbook).
|
|
19
|
+
#
|
|
20
|
+
# Exit codes: 0 success, 1 usage error, 2 dep missing, 3 runtime error
|
|
21
|
+
|
|
22
|
+
set -euo pipefail
|
|
23
|
+
SCRIPTS="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
24
|
+
SKILL_ROOT="$(cd "$SCRIPTS/.." && pwd)"
|
|
25
|
+
PY="${PYTHON:-$(command -v python3 2>/dev/null || command -v python 2>/dev/null || echo python3)}"
|
|
26
|
+
|
|
27
|
+
# ── Colour helpers ─────────────────────────────────────────────────────────────
|
|
28
|
+
red() { printf '\033[0;31m%s\033[0m\n' "$*"; }
|
|
29
|
+
green() { printf '\033[0;32m%s\033[0m\n' "$*"; }
|
|
30
|
+
yellow() { printf '\033[0;33m%s\033[0m\n' "$*"; }
|
|
31
|
+
bold() { printf '\033[1m%s\033[0m\n' "$*"; }
|
|
32
|
+
|
|
33
|
+
# ── Minimum versions (single source of truth for `check` and `fix`) ───────────
|
|
34
|
+
PY_MIN="3.9"
|
|
35
|
+
NODE_MIN_MAJOR=18
|
|
36
|
+
PYPDF_MIN="3.0"
|
|
37
|
+
MARKDOWN_IT_MIN="3.0"
|
|
38
|
+
|
|
39
|
+
# Compare two dotted versions A and B; succeed iff A >= B.
|
|
40
|
+
ver_ge() {
|
|
41
|
+
$PY - "$1" "$2" <<'PYEOF'
|
|
42
|
+
import sys
|
|
43
|
+
def parts(v):
|
|
44
|
+
out = []
|
|
45
|
+
for chunk in v.split("."):
|
|
46
|
+
digits = "".join(c for c in chunk if c.isdigit())
|
|
47
|
+
out.append(int(digits) if digits else 0)
|
|
48
|
+
return out
|
|
49
|
+
a, b = parts(sys.argv[1]), parts(sys.argv[2])
|
|
50
|
+
n = max(len(a), len(b))
|
|
51
|
+
a += [0] * (n - len(a))
|
|
52
|
+
b += [0] * (n - len(b))
|
|
53
|
+
sys.exit(0 if a >= b else 1)
|
|
54
|
+
PYEOF
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
# Print "OK <label> <version> (>= <min>)" or set ok=false and warn.
|
|
58
|
+
# Args: <import-name> <pretty-label> <min-version> [optional]
|
|
59
|
+
py_pkg_check() {
|
|
60
|
+
local import_name="$1" label="$2" min="$3" optional="${4:-}"
|
|
61
|
+
if ! $PY -c "import importlib, sys; m=importlib.import_module('$import_name'); v=getattr(m,'__version__','0'); print(v)" 2>/dev/null >/tmp/.pdfgen_ver; then
|
|
62
|
+
if [[ "$optional" == "true" ]]; then
|
|
63
|
+
yellow " WARN $label not installed (optional)"
|
|
64
|
+
else
|
|
65
|
+
yellow " MISSING $label (run: bash make.sh fix)"
|
|
66
|
+
ok=false
|
|
67
|
+
fi
|
|
68
|
+
return
|
|
69
|
+
fi
|
|
70
|
+
local ver
|
|
71
|
+
ver="$(cat /tmp/.pdfgen_ver)"
|
|
72
|
+
if ver_ge "$ver" "$min"; then
|
|
73
|
+
green " OK $label $ver (>= $min)"
|
|
74
|
+
else
|
|
75
|
+
red " FAIL $label $ver is below required $min"
|
|
76
|
+
ok=false
|
|
77
|
+
fi
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
# ── check ──────────────────────────────────────────────────────────────────────
|
|
81
|
+
cmd_check() {
|
|
82
|
+
local ok=true
|
|
83
|
+
bold "Checking dependencies..."
|
|
84
|
+
|
|
85
|
+
# Python interpreter + version gate
|
|
86
|
+
if ! command -v $PY &>/dev/null; then
|
|
87
|
+
red " MISSING python3 not found"
|
|
88
|
+
ok=false
|
|
89
|
+
else
|
|
90
|
+
local py_ver
|
|
91
|
+
py_ver=$($PY -c 'import sys;print(f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")' 2>/dev/null || echo "?")
|
|
92
|
+
if ver_ge "$py_ver" "$PY_MIN"; then
|
|
93
|
+
green " OK python3 $py_ver (>= $PY_MIN) at $(command -v $PY)"
|
|
94
|
+
else
|
|
95
|
+
red " FAIL python3 $py_ver is below required $PY_MIN"
|
|
96
|
+
ok=false
|
|
97
|
+
fi
|
|
98
|
+
# pip must be importable so 'fix' can do its job
|
|
99
|
+
if $PY -m pip --version &>/dev/null; then
|
|
100
|
+
local pip_ver
|
|
101
|
+
pip_ver=$($PY -m pip --version 2>/dev/null | awk '{print $2}')
|
|
102
|
+
green " OK pip $pip_ver"
|
|
103
|
+
else
|
|
104
|
+
yellow " WARN pip not importable from $PY (try: $PY -m ensurepip)"
|
|
105
|
+
ok=false
|
|
106
|
+
fi
|
|
107
|
+
fi
|
|
108
|
+
|
|
109
|
+
# Python packages — pypdf is needed by fill/, markdown-it-py by reformat
|
|
110
|
+
py_pkg_check pypdf "pypdf" "$PYPDF_MIN"
|
|
111
|
+
py_pkg_check markdown_it "markdown-it-py" "$MARKDOWN_IT_MIN"
|
|
112
|
+
|
|
113
|
+
# Node.js + version gate
|
|
114
|
+
if command -v node &>/dev/null; then
|
|
115
|
+
local node_ver node_major
|
|
116
|
+
node_ver=$(node --version 2>&1 | sed 's/^v//')
|
|
117
|
+
node_major=${node_ver%%.*}
|
|
118
|
+
if [[ "$node_major" -ge "$NODE_MIN_MAJOR" ]]; then
|
|
119
|
+
green " OK node v$node_ver (>= v$NODE_MIN_MAJOR)"
|
|
120
|
+
else
|
|
121
|
+
red " FAIL node v$node_ver is below required v$NODE_MIN_MAJOR"
|
|
122
|
+
ok=false
|
|
123
|
+
fi
|
|
124
|
+
else
|
|
125
|
+
red " MISSING node not found - HTML rendering unavailable"
|
|
126
|
+
ok=false
|
|
127
|
+
fi
|
|
128
|
+
|
|
129
|
+
# Playwright (resolved either locally or globally)
|
|
130
|
+
if node -e "require('playwright')" 2>/dev/null || \
|
|
131
|
+
node -e "require(require('child_process').execSync('npm root -g').toString().trim()+'/playwright')" 2>/dev/null; then
|
|
132
|
+
green " OK playwright"
|
|
133
|
+
else
|
|
134
|
+
yellow " WARN playwright not found (run: bash make.sh fix)"
|
|
135
|
+
ok=false
|
|
136
|
+
fi
|
|
137
|
+
|
|
138
|
+
# pdfinfo / qpdf are nice-to-have for verification & mutation
|
|
139
|
+
if command -v pdfinfo &>/dev/null; then green " OK pdfinfo $(pdfinfo -v 2>&1 | head -1 | awk '{print $NF}')"
|
|
140
|
+
else yellow " WARN pdfinfo not found (brew install poppler) — only used for verification"; fi
|
|
141
|
+
if command -v qpdf &>/dev/null; then green " OK qpdf $(qpdf --version | head -1 | awk '{print $NF}')"
|
|
142
|
+
else yellow " WARN qpdf not found (brew install qpdf) — only used for advanced PDF mutation"; fi
|
|
143
|
+
|
|
144
|
+
if $ok; then
|
|
145
|
+
green ""
|
|
146
|
+
green "All required dependencies satisfied."
|
|
147
|
+
exit 0
|
|
148
|
+
else
|
|
149
|
+
yellow ""
|
|
150
|
+
yellow "Some dependencies are missing or below the supported minimum."
|
|
151
|
+
yellow "Run: bash make.sh fix"
|
|
152
|
+
exit 2
|
|
153
|
+
fi
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
# ── fix ────────────────────────────────────────────────────────────────────────
|
|
157
|
+
cmd_fix() {
|
|
158
|
+
bold "Installing missing dependencies..."
|
|
159
|
+
local rc=0
|
|
160
|
+
|
|
161
|
+
if ! command -v $PY &>/dev/null; then
|
|
162
|
+
red " python3 not found - install Python $PY_MIN+ first"
|
|
163
|
+
exit 2
|
|
164
|
+
fi
|
|
165
|
+
if ! $PY -m pip --version &>/dev/null; then
|
|
166
|
+
red " pip is not importable from $(command -v $PY)"
|
|
167
|
+
yellow " Try: $PY -m ensurepip --upgrade"
|
|
168
|
+
exit 2
|
|
169
|
+
fi
|
|
170
|
+
|
|
171
|
+
# Python packages
|
|
172
|
+
local pip_log
|
|
173
|
+
pip_log=$(mktemp -t pdfgen-pip.XXXXXX)
|
|
174
|
+
local pip_specs=("pypdf>=$PYPDF_MIN" "markdown-it-py>=$MARKDOWN_IT_MIN")
|
|
175
|
+
bold " Running: $PY -m pip install ${pip_specs[*]}"
|
|
176
|
+
if $PY -m pip install --break-system-packages -q "${pip_specs[@]}" >"$pip_log" 2>&1 \
|
|
177
|
+
|| $PY -m pip install -q "${pip_specs[@]}" >"$pip_log" 2>&1; then
|
|
178
|
+
green " OK Python packages installed (pypdf, markdown-it-py)"
|
|
179
|
+
else
|
|
180
|
+
yellow " pip install failed -- last 20 lines of output:"
|
|
181
|
+
tail -20 "$pip_log" | sed 's/^/ /'
|
|
182
|
+
rc=3
|
|
183
|
+
fi
|
|
184
|
+
rm -f "$pip_log"
|
|
185
|
+
|
|
186
|
+
# Playwright -- skip when already resolvable
|
|
187
|
+
if node -e "require('playwright')" 2>/dev/null || \
|
|
188
|
+
node -e "require(require('child_process').execSync('npm root -g').toString().trim()+'/playwright')" 2>/dev/null; then
|
|
189
|
+
green " OK playwright already installed -- skipping"
|
|
190
|
+
elif command -v npm &>/dev/null; then
|
|
191
|
+
if npm install -g playwright --silent 2>/dev/null && \
|
|
192
|
+
npx playwright install chromium --silent 2>/dev/null; then
|
|
193
|
+
green " OK Playwright + Chromium installed"
|
|
194
|
+
else
|
|
195
|
+
yellow " playwright install failed -- try: npm install -g playwright && npx playwright install chromium"
|
|
196
|
+
rc=3
|
|
197
|
+
fi
|
|
198
|
+
else
|
|
199
|
+
yellow " npm not found - cannot install Playwright (HTML rendering will fail)"
|
|
200
|
+
rc=2
|
|
201
|
+
fi
|
|
202
|
+
|
|
203
|
+
if [[ $rc -eq 0 ]]; then
|
|
204
|
+
green ""
|
|
205
|
+
green "All dependencies installed. Run: bash make.sh check"
|
|
206
|
+
else
|
|
207
|
+
yellow ""
|
|
208
|
+
yellow "Some installs failed -- run 'bash make.sh check' for the current state."
|
|
209
|
+
fi
|
|
210
|
+
exit $rc
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
# ── render ────────────────────────────────────────────────────────────────────
|
|
214
|
+
# Thin wrapper around scripts/render_html.cjs. Forwards every flag through.
|
|
215
|
+
# Usage:
|
|
216
|
+
# bash make.sh render --in page.html --out report.pdf [--wait 15000] ...
|
|
217
|
+
cmd_render() {
|
|
218
|
+
if [[ $# -eq 0 ]]; then
|
|
219
|
+
cat <<'USAGE'
|
|
220
|
+
Usage: bash make.sh render --in <file.html|url> --out <file.pdf>
|
|
221
|
+
[--wait <ms>] extra settle time (Chart.js: 15000)
|
|
222
|
+
[--format A4|Letter] page format (default A4)
|
|
223
|
+
[--margin "14mm 12mm"] CSS margin shorthand
|
|
224
|
+
[--landscape] landscape orientation
|
|
225
|
+
[--scale 1] print scale 0.1–2
|
|
226
|
+
[--no-print-background] disable color-exact print
|
|
227
|
+
[--header <html>] header template
|
|
228
|
+
[--footer <html>] footer template
|
|
229
|
+
|
|
230
|
+
Examples:
|
|
231
|
+
bash make.sh render --in templates/data-viz-report/skeleton.html \
|
|
232
|
+
--out demo.pdf --wait 15000
|
|
233
|
+
bash make.sh render --in https://example.com --out site.pdf --landscape
|
|
234
|
+
USAGE
|
|
235
|
+
exit 1
|
|
236
|
+
fi
|
|
237
|
+
exec node "$SCRIPTS/render_html.cjs" "$@"
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
# ── reformat ───────────────────────────────────────────────────────────────────
|
|
241
|
+
# Parse a markdown / text / pdf source into HTML using the reformat-default
|
|
242
|
+
# template, then render to PDF.
|
|
243
|
+
cmd_reformat() {
|
|
244
|
+
local input="" out="output.pdf"
|
|
245
|
+
local title="" subtitle="" author="" date="" accent=""
|
|
246
|
+
local template="default" wait_ms="800"
|
|
247
|
+
local keep_html=false
|
|
248
|
+
|
|
249
|
+
while [[ $# -gt 0 ]]; do
|
|
250
|
+
case "$1" in
|
|
251
|
+
--input) input="$2"; shift 2 ;;
|
|
252
|
+
--out) out="$2"; shift 2 ;;
|
|
253
|
+
--title) title="$2"; shift 2 ;;
|
|
254
|
+
--subtitle) subtitle="$2"; shift 2 ;;
|
|
255
|
+
--author) author="$2"; shift 2 ;;
|
|
256
|
+
--date) date="$2"; shift 2 ;;
|
|
257
|
+
--accent) accent="$2"; shift 2 ;;
|
|
258
|
+
--template) template="$2"; shift 2 ;;
|
|
259
|
+
--wait) wait_ms="$2"; shift 2 ;;
|
|
260
|
+
--keep-html) keep_html=true; shift ;;
|
|
261
|
+
-h|--help)
|
|
262
|
+
cat <<'USAGE'
|
|
263
|
+
Usage: bash make.sh reformat --input <file.md|.txt|.pdf|.html> --out <file.pdf>
|
|
264
|
+
[--title T] [--subtitle S] [--author A] [--date D]
|
|
265
|
+
[--accent "#007AFF"] [--template default]
|
|
266
|
+
[--wait <ms>] [--keep-html]
|
|
267
|
+
|
|
268
|
+
Pipeline: source → markdown → reformat-default skeleton → PDF
|
|
269
|
+
USAGE
|
|
270
|
+
exit 0 ;;
|
|
271
|
+
*) red "Unknown option: $1"; exit 1 ;;
|
|
272
|
+
esac
|
|
273
|
+
done
|
|
274
|
+
|
|
275
|
+
if [[ -z "$input" ]]; then
|
|
276
|
+
red "error: --input is required"
|
|
277
|
+
bash "$0" reformat --help
|
|
278
|
+
exit 1
|
|
279
|
+
fi
|
|
280
|
+
if [[ ! -f "$input" ]]; then
|
|
281
|
+
red "error: input not found: $input"
|
|
282
|
+
exit 1
|
|
283
|
+
fi
|
|
284
|
+
|
|
285
|
+
local tmpdir
|
|
286
|
+
tmpdir="$(mktemp -d -t pdfgen-reformat.XXXXXX)"
|
|
287
|
+
local html="$tmpdir/page.html"
|
|
288
|
+
|
|
289
|
+
bold "Parsing → HTML: $input"
|
|
290
|
+
local parse_args=(--input "$input" --out "$html" --template "$template")
|
|
291
|
+
[[ -n "$title" ]] && parse_args+=(--title "$title")
|
|
292
|
+
[[ -n "$subtitle" ]] && parse_args+=(--subtitle "$subtitle")
|
|
293
|
+
[[ -n "$author" ]] && parse_args+=(--author "$author")
|
|
294
|
+
[[ -n "$date" ]] && parse_args+=(--date "$date")
|
|
295
|
+
[[ -n "$accent" ]] && parse_args+=(--accent "$accent")
|
|
296
|
+
$PY "$SCRIPTS/reformat_parse.py" "${parse_args[@]}"
|
|
297
|
+
|
|
298
|
+
bold "Rendering → PDF: $out"
|
|
299
|
+
node "$SCRIPTS/render_html.cjs" --in "$html" --out "$out" --wait "$wait_ms"
|
|
300
|
+
|
|
301
|
+
if $keep_html; then
|
|
302
|
+
yellow " (--keep-html) intermediate HTML kept at: $html"
|
|
303
|
+
else
|
|
304
|
+
rm -rf "$tmpdir"
|
|
305
|
+
fi
|
|
306
|
+
green "OK reformat complete: $out"
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
# ── fill ──────────────────────────────────────────────────────────────────────
|
|
310
|
+
# FILL is dispatched via subverbs that map to subpackages under scripts/.
|
|
311
|
+
# All scripts run as `python -m scripts.<group>.<name>` from the skill root.
|
|
312
|
+
cmd_fill() {
|
|
313
|
+
if [[ $# -lt 1 ]]; then
|
|
314
|
+
cat <<'USAGE'
|
|
315
|
+
Usage: make.sh fill <subcommand> [args...]
|
|
316
|
+
|
|
317
|
+
Subcommands:
|
|
318
|
+
probe <input.pdf> Detect AcroForm: prints acroform=true|false
|
|
319
|
+
inspect <input.pdf> <meta.json> Dump AcroForm field metadata
|
|
320
|
+
apply <input.pdf> <values.json> <output.pdf> Apply values to AcroForm fields
|
|
321
|
+
scan <input.pdf> <layout.json> Scan visual layout (non-fillable PDFs)
|
|
322
|
+
rasterize <input.pdf> <out_dir/> [--max-edge N] [--dpi N]
|
|
323
|
+
Render pages to PNG
|
|
324
|
+
preview <page> <fields.json> <page.png> <out.png> Overlay bbox preview on a page image
|
|
325
|
+
overlay <input.pdf> <fields.json> <output.pdf> Lay text via FreeText annotations
|
|
326
|
+
lint <fields.json> [--max-findings N] Lint bounding-box geometry in fields.json
|
|
327
|
+
|
|
328
|
+
Decision tree: run 'fill probe' first.
|
|
329
|
+
acroform=true → inspect → apply
|
|
330
|
+
acroform=false → scan → rasterize → preview → overlay → lint
|
|
331
|
+
USAGE
|
|
332
|
+
exit 1
|
|
333
|
+
fi
|
|
334
|
+
|
|
335
|
+
local sub="$1"; shift
|
|
336
|
+
cd "$SKILL_ROOT"
|
|
337
|
+
# Prepend the skill root to PYTHONPATH so `python -m scripts.X` works even
|
|
338
|
+
# when PYTHONSAFEPATH=1 is set in the user environment.
|
|
339
|
+
export PYTHONPATH="$SKILL_ROOT${PYTHONPATH:+:$PYTHONPATH}"
|
|
340
|
+
|
|
341
|
+
case "$sub" in
|
|
342
|
+
probe) bold "Probing AcroForm: $1"; $PY -m scripts.pdf_inspect.acroform_probe "$@" ;;
|
|
343
|
+
inspect) bold "Inspecting AcroForm: $1 → $2"; $PY -m scripts.pdf_inspect.acroform_inspect "$@" ;;
|
|
344
|
+
apply) bold "Applying values: $1 + $2 → $3"; $PY -m scripts.fill.acroform_apply "$@" ;;
|
|
345
|
+
scan) bold "Scanning layout: $1 → $2"; $PY -m scripts.pdf_inspect.layout_scan "$@" ;;
|
|
346
|
+
rasterize) bold "Rasterising pages: $1 → $2"; $PY -m scripts.render.page_rasterize "$@" ;;
|
|
347
|
+
preview) bold "Overlay preview: page $1 → $4"; $PY -m scripts.render.overlay_preview "$@" ;;
|
|
348
|
+
overlay) bold "Filling via overlay: $1 + $2 → $3"; $PY -m scripts.fill.overlay_apply "$@" ;;
|
|
349
|
+
lint) bold "Linting fields: $1"; $PY -m scripts.validate.geometry_lint "$@" ;;
|
|
350
|
+
*) red "Unknown fill subcommand: $sub"; exit 1 ;;
|
|
351
|
+
esac
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
# ── dispatch ───────────────────────────────────────────────────────────────────
|
|
355
|
+
main() {
|
|
356
|
+
if [[ $# -lt 1 ]]; then
|
|
357
|
+
bold "pdf — make.sh (HTML → PDF)"
|
|
358
|
+
cat <<'USAGE'
|
|
359
|
+
|
|
360
|
+
Usage: bash make.sh <command> [options]
|
|
361
|
+
|
|
362
|
+
Commands:
|
|
363
|
+
check Verify all dependencies
|
|
364
|
+
fix Auto-install missing dependencies
|
|
365
|
+
render --in HTML --out PDF [opts] CREATE: render HTML file or URL → PDF
|
|
366
|
+
(see: bash make.sh render with no args)
|
|
367
|
+
reformat --input SRC --out PDF REFORMAT: markdown/text/pdf → HTML → PDF
|
|
368
|
+
(see: bash make.sh reformat --help)
|
|
369
|
+
fill <subcommand> [args...] FILL: AcroForm probe/apply, visual overlay
|
|
370
|
+
(see: bash make.sh fill with no args)
|
|
371
|
+
|
|
372
|
+
For READ / extract existing PDFs, see docs/read-guide.md.
|
|
373
|
+
For PDF mutation (merge / split / rotate / watermark), see docs/advanced-reference.md.
|
|
374
|
+
USAGE
|
|
375
|
+
exit 0
|
|
376
|
+
fi
|
|
377
|
+
|
|
378
|
+
case "$1" in
|
|
379
|
+
check) cmd_check ;;
|
|
380
|
+
fix) cmd_fix ;;
|
|
381
|
+
render) shift; cmd_render "$@" ;;
|
|
382
|
+
reformat) shift; cmd_reformat "$@" ;;
|
|
383
|
+
fill) shift; cmd_fill "$@" ;;
|
|
384
|
+
*) red "Unknown command: $1"; exit 1 ;;
|
|
385
|
+
esac
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
main "$@"
|