dimcode-darwin-arm64 0.2.19-beta.0 → 0.2.20-beta.0

package/bin/skills-assets/docx/references/openxml_namespaces.md

@@ -1,82 +0,0 @@
-# OpenXML Namespaces, Relationship Types, and Content Types
-
-## Core Namespaces
-
-| Prefix | URI | Used In |
-|--------|-----|---------|
-| `w` | `http://schemas.openxmlformats.org/wordprocessingml/2006/main` | document.xml, styles.xml, numbering.xml, headers, footers |
-| `r` | `http://schemas.openxmlformats.org/officeDocument/2006/relationships` | Relationship references (r:id) |
-| `wp` | `http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing` | Image/drawing placement in document |
-| `a` | `http://schemas.openxmlformats.org/drawingml/2006/main` | DrawingML core (shapes, images, themes) |
-| `pic` | `http://schemas.openxmlformats.org/drawingml/2006/picture` | Picture element in DrawingML |
-| `v` | `urn:schemas-microsoft-com:vml` | VML (legacy shapes, watermarks) |
-| `o` | `urn:schemas-microsoft-com:office:office` | Office VML extensions |
-| `m` | `http://schemas.openxmlformats.org/officeDocument/2006/math` | Math equations (OMML) |
-| `mc` | `http://schemas.openxmlformats.org/markup-compatibility/2006` | Markup compatibility (Ignorable, AlternateContent) |
-
-## Extended Namespaces
-
-| Prefix | URI | Purpose |
-|--------|-----|---------|
-| `w14` | `http://schemas.microsoft.com/office/word/2010/wordml` | Word 2010 extensions (contentPart, etc.) |
-| `w15` | `http://schemas.microsoft.com/office/word/2012/wordml` | Word 2013 extensions (commentEx, etc.) |
-| `w16cid` | `http://schemas.microsoft.com/office/word/2016/wordml/cid` | Comment IDs (durable IDs) |
-| `w16cex` | `http://schemas.microsoft.com/office/word/2018/wordml/cex` | Comment extensible |
-| `w16se` | `http://schemas.microsoft.com/office/word/2015/wordml/symex` | Symbol extensions |
-| `wps` | `http://schemas.microsoft.com/office/word/2010/wordprocessingShape` | WordprocessingML shapes |
-| `wpc` | `http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas` | Drawing canvas |
-
-## Relationship Types
-
-| Relationship | Type URI |
-|-------------|----------|
-| Document | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument` |
-| Styles | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles` |
-| Numbering | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering` |
-| Font Table | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable` |
-| Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings` |
-| Theme | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme` |
-| Image | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/image` |
-| Hyperlink | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink` |
-| Header | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/header` |
-| Footer | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer` |
-| Comments | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments` |
-| CommentsExtended | `http://schemas.microsoft.com/office/2011/relationships/commentsExtended` |
-| CommentsIds | `http://schemas.microsoft.com/office/2016/09/relationships/commentsIds` |
-| CommentsExtensible | `http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible` |
-| Footnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes` |
-| Endnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes` |
-| Glossary | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument` |
-| Web Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings` |
-
-## Content Types (`[Content_Types].xml`)
-
-### Default Extensions
-
-```xml
-<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml" />
-<Default Extension="xml" ContentType="application/xml" />
-<Default Extension="png" ContentType="image/png" />
-<Default Extension="jpeg" ContentType="image/jpeg" />
-<Default Extension="gif" ContentType="image/gif" />
-<Default Extension="emf" ContentType="image/x-emf" />
-```
-
-### Part Overrides
-
-| Part | Content Type |
-|------|-------------|
-| `/word/document.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml` |
-| `/word/styles.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml` |
-| `/word/numbering.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml` |
-| `/word/settings.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml` |
-| `/word/fontTable.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml` |
-| `/word/theme/theme1.xml` | `application/vnd.openxmlformats-officedocument.theme+xml` |
-| `/word/header1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml` |
-| `/word/footer1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml` |
-| `/word/comments.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml` |
-| `/word/commentsExtended.xml` | `application/vnd.ms-word.commentsExtended+xml` |
-| `/word/commentsIds.xml` | `application/vnd.ms-word.commentsIds+xml` |
-| `/word/commentsExtensible.xml` | `application/vnd.ms-word.commentsExtensible+xml` |
-| `/word/footnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml` |
-| `/word/endnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml` |

package/bin/skills-assets/docx/references/openxml_units.md

@@ -1,72 +0,0 @@
-# OpenXML Unit Conversion Quick Reference
-
-## Master Conversion Table
-
-| Unit | 1 inch | 1 cm | 1 mm | 1 pt | Description |
-|------|--------|------|------|------|-------------|
-| DXA (twips) | 1440 | 567 | 56.7 | 20 | 1/20 of a point. Used for margins, indents, spacing, page size. |
-| EMU | 914400 | 360000 | 36000 | 12700 | English Metric Unit. Used for images, drawings, shapes. |
-| Half-points | 144 | 56.7 | 5.67 | 2 | Used for font sizes (`w:sz`, `w:szCs`). |
-| Points | 72 | 28.35 | 2.835 | 1 | Standard typographic unit. Not used directly in most attributes. |
-| Eighths of a point | 576 | 226.8 | 22.68 | 8 | Used for `w:spacing` character spacing. |
-
-## Common Page Sizes
-
-| Size | Width (DXA) | Height (DXA) | Width (mm) | Height (mm) |
-|------|-------------|--------------|------------|-------------|
-| A4 | 11906 | 16838 | 210 | 297 |
-| Letter | 12240 | 15840 | 215.9 | 279.4 |
-| Legal | 12240 | 20160 | 215.9 | 355.6 |
-| A3 | 16838 | 23811 | 297 | 420 |
-| A5 | 8391 | 11906 | 148 | 210 |
-
-## Common Margin Values
-
-| Margin | DXA | Inches | cm |
-|--------|-----|--------|----|
-| 0.5 inch | 720 | 0.5 | 1.27 |
-| 0.75 inch | 1080 | 0.75 | 1.91 |
-| 1 inch | 1440 | 1.0 | 2.54 |
-| 1.25 inch | 1800 | 1.25 | 3.18 |
-| 1.5 inch | 2160 | 1.5 | 3.81 |
-
-## Font Size Values (`w:sz`)
-
-| Display Size | w:sz value | Notes |
-|-------------|-----------|-------|
-| 8pt | 16 | |
-| 9pt | 18 | |
-| 10pt | 20 | |
-| 10.5pt | 21 | Common CJK body size |
-| 11pt | 22 | Default Calibri body |
-| 12pt | 24 | Default TNR body |
-| 14pt | 28 | Small heading |
-| 16pt | 32 | |
-| 18pt | 36 | |
-| 20pt | 40 | |
-| 24pt | 48 | |
-| 28pt | 56 | |
-| 36pt | 72 | |
-
-## Line Spacing Values
-
-Line spacing in `w:spacing` uses the `w:line` attribute in 240ths of a line (when `w:lineRule="auto"`):
-
-| Spacing | w:line value | w:lineRule |
-|---------|-------------|-----------|
-| Single | 240 | auto |
-| 1.15 (Word default) | 276 | auto |
-| 1.5 | 360 | auto |
-| Double | 480 | auto |
-| Exact 12pt | 240 | exact |
-| At least 12pt | 240 | atLeast |
-
-Note: When `lineRule="exact"` or `"atLeast"`, `w:line` is in **twips** (DXA), not 240ths. So `line="240"` with `lineRule="exact"` means exactly 12pt (240/20 = 12pt).
-
-## Conversion Formulas
-
-```
-DXA     = inches × 1440  = cm × 567     = pt × 20
-EMU     = inches × 914400 = cm × 360000 = pt × 12700
-sz      = pt × 2          (half-points)
-```

package/bin/skills-assets/docx/references/scenario_a_create.md

@@ -1,284 +0,0 @@
-# Scenario A: Creating a New DOCX from Scratch
-
-## When to Use
-
-Use Scenario A when:
-- The user has no existing file and wants a brand new document
-- The user provides content (text, tables, images) and wants it assembled into a DOCX
-- The user specifies a document type (report, letter, memo, academic) or describes a custom layout
-
-Do NOT use when: the user already has a DOCX they want to modify (→ Scenario B) or wants to restyle an existing document (→ Scenario C).
-
----
-
-## Step-by-Step Workflow
-
-### 1. Determine Document Type
-
-Ask or infer the document type from the user's request:
-
-| Type | Typical Signals |
-|------|----------------|
-| Report | "report", "analysis", "whitepaper", sections with headings |
-| Letter | "letter", "dear", address block, salutation |
-| Memo | "memo", "memorandum", To/From/Subject fields |
-| Academic | "paper", "essay", "thesis", APA/MLA/Chicago mention |
-| Custom | None of the above, or user specifies exact formatting |
-
-### 2. Gather Content Requirements
-
-Collect from the user:
-- Title and subtitle (if any)
-- Author / organization
-- Section structure (headings and nesting)
-- Body content per section
-- Tables (headers + rows)
-- Images (file paths or placeholders)
-- Special elements: TOC, page numbers, watermark, headers/footers
-
-### 3. Select Style Set
-
-Based on document type, load the matching styles XML asset:
-- Report → `assets/styles/default_styles.xml` or `assets/styles/corporate_styles.xml`
-- Academic → `assets/styles/academic_styles.xml`
-- Letter / Memo / Custom → `assets/styles/default_styles.xml` (with overrides)
-
-### 4. Configure Page Setup
-
-Set `w:sectPr` values based on document type defaults (see below) or user overrides.
-
-```xml
-<w:sectPr>
-  <w:pgSz w:w="11906" w:h="16838" />  <!-- A4 -->
-  <w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440"
-           w:header="720" w:footer="720" w:gutter="0" />
-</w:sectPr>
-```
-
-### 5. Build Document Structure
-
-Assemble `word/document.xml` with:
-1. `w:body` as root container
-2. Paragraphs (`w:p`) with heading styles for section titles
-3. Body paragraphs with `Normal` style
-4. Tables, images, and other elements as needed
-5. Final `w:sectPr` as last child of `w:body`
-
-### 6. Apply Typography Defaults
-
-Set document-level defaults in `styles.xml` under `w:docDefaults`:
-```xml
-<w:docDefaults>
-  <w:rPrDefault>
-    <w:rPr>
-      <w:rFonts w:ascii="Calibri" w:hAnsi="Calibri" w:eastAsia="SimSun" w:cs="Arial" />
-      <w:sz w:val="22" />  <!-- 11pt -->
-      <w:szCs w:val="22" />
-    </w:rPr>
-  </w:rPrDefault>
-  <w:pPrDefault>
-    <w:pPr>
-      <w:spacing w:after="160" w:line="259" w:lineRule="auto" />
-    </w:pPr>
-  </w:pPrDefault>
-</w:docDefaults>
-```
-
-### 7. Add Complex Elements
-
-See the Complex Elements Guide section below.
-
-### 8. Run Validation Pipeline
-
-```
-dotnet run ... validate --xsd wml-subset.xsd
-dotnet run ... validate --xsd business-rules.xsd   # if applying a template
-```
-
----
-
-## Document Type Defaults
-
-### Report
-| Property | Value |
-|----------|-------|
-| Body font | Calibri 11pt |
-| Heading font | Calibri Light |
-| H1 / H2 / H3 / H4 size | 28pt / 24pt / 18pt / 14pt |
-| Heading color | #2F5496 (corporate blue) |
-| Margins | 1 inch (1440 DXA) all sides |
-| Page size | A4 (11906 × 16838 DXA) |
-| Line spacing | Single (line="240") |
-| Paragraph spacing | 0pt before, 8pt after body |
-
-### Letter
-| Property | Value |
-|----------|-------|
-| Font | Calibri 11pt |
-| Page size | Letter (12240 × 15840 DXA) |
-| Margins | 1 inch all sides |
-| Structure | Date → Address → Salutation → Body → Closing → Signature |
-| Line spacing | Single |
-
-### Memo
-| Property | Value |
-|----------|-------|
-| Font | Arial 11pt |
-| Page size | Letter |
-| Margins | 0.75 inch (1080 DXA) |
-| Header | "MEMO" centered, bold, 16pt |
-| Fields | To, From, Date, Subject (bold labels, tab-aligned values) |
-
-### Academic
-| Property | Value |
-|----------|-------|
-| Font | Times New Roman 12pt |
-| Line spacing | Double (line="480") |
-| Margins | 1 inch all sides |
-| Page size | Letter |
-| Headings | Bold, same font, 14/13/12pt for H1/H2/H3 |
-| First line indent | 0.5 inch (720 DXA) |
-| Heading color | Black (no color) |
-
----
-
-## Content Configuration JSON Format
-
-The CLI `create` command accepts a JSON config:
-
-```json
-{
-  "type": "report",
-  "title": "Quarterly Revenue Analysis",
-  "subtitle": "Q1 2026",
-  "author": "Finance Team",
-  "pageSize": "A4",
-  "margins": { "top": 1440, "right": 1440, "bottom": 1440, "left": 1440 },
-  "sections": [
-    {
-      "heading": "Executive Summary",
-      "level": 1,
-      "content": [
-        { "type": "paragraph", "text": "Revenue grew 12% year-over-year..." },
-        {
-          "type": "table",
-          "headers": ["Region", "Revenue", "Growth"],
-          "rows": [
-            ["North America", "$4.2M", "+15%"],
-            ["Europe", "$2.8M", "+8%"],
-            ["Asia Pacific", "$1.9M", "+18%"]
-          ]
-        },
-        { "type": "image", "path": "charts/revenue.png", "width": "5in", "alt": "Revenue chart" }
-      ]
-    },
-    {
-      "heading": "Detailed Analysis",
-      "level": 1,
-      "content": [
-        { "type": "paragraph", "text": "Breaking down by product line..." }
-      ]
-    }
-  ]
-}
-```
-
-Supported content types:
-- `paragraph` — body text (applies Normal style)
-- `table` — headers + rows (applies TableGrid style)
-- `image` — inline image with width/height control
-- `list` — bulleted or numbered list items
-- `pageBreak` — forces a page break
-
----
-
-## Complex Elements Guide
-
-### Table of Contents
-
-Insert a TOC field code. Word will update the actual entries when the file is opened:
-
-```xml
-<w:p>
-  <w:pPr><w:pStyle w:val="TOCHeading" /></w:pPr>
-  <w:r><w:t>Table of Contents</w:t></w:r>
-</w:p>
-<w:p>
-  <w:r>
-    <w:fldChar w:fldCharType="begin" />
-  </w:r>
-  <w:r>
-    <w:instrText xml:space="preserve"> TOC \o "1-3" \h \z \u </w:instrText>
-  </w:r>
-  <w:r>
-    <w:fldChar w:fldCharType="separate" />
-  </w:r>
-  <w:r>
-    <w:t>[Table of contents — update to populate]</w:t>
-  </w:r>
-  <w:r>
-    <w:fldChar w:fldCharType="end" />
-  </w:r>
-</w:p>
-```
-
-### Page Numbers in Footer
-
-Add a footer part (`word/footer1.xml`) and reference it in `w:sectPr`:
-
-```xml
-<!-- In footer1.xml -->
-<w:ftr xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:p>
-    <w:pPr><w:jc w:val="center" /></w:pPr>
-    <w:r>
-      <w:fldChar w:fldCharType="begin" />
-    </w:r>
-    <w:r>
-      <w:instrText>PAGE</w:instrText>
-    </w:r>
-    <w:r>
-      <w:fldChar w:fldCharType="separate" />
-    </w:r>
-    <w:r><w:t>1</w:t></w:r>
-    <w:r>
-      <w:fldChar w:fldCharType="end" />
-    </w:r>
-  </w:p>
-</w:ftr>
-
-<!-- In sectPr -->
-<w:footerReference w:type="default" r:id="rId8" />
-```
-
-### Watermark
-
-Add a header part with a shape behind the text:
-
-```xml
-<w:hdr>
-  <w:p>
-    <w:r>
-      <w:pict>
-        <v:shape style="position:absolute;margin-left:0;margin-top:0;width:468pt;height:180pt;
-                        z-index:-251657216;mso-position-horizontal:center;
-                        mso-position-vertical:center"
-                 fillcolor="silver" stroked="f">
-          <v:textpath style="font-family:'Calibri';font-size:1pt" string="DRAFT" />
-        </v:shape>
-      </w:pict>
-    </w:r>
-  </w:p>
-</w:hdr>
-```
-
----
-
-## Post-Creation Checklist
-
-1. **Validate** against `wml-subset.xsd` — all elements in correct order, required attributes present
-2. **Merge adjacent runs** with identical formatting to keep XML clean
-3. **Verify relationships** — every `r:id` in document.xml has a matching entry in `document.xml.rels`
-4. **Check content types** — every part in the package is registered in `[Content_Types].xml`
-5. **Preview** — open in Word or LibreOffice to visually confirm layout
-6. **File size** — confirm images are reasonably sized (compress if > 2MB each)