dimcode-darwin-x64 0.1.2-beta.1 → 0.1.2

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

@@ -1,294 +0,0 @@
-# Professional Document Design & Typography Guide
-
-## Table of Contents
-1. [Font Pairing](#font-pairing)
-2. [Font Sizes by Document Type](#font-sizes-by-document-type)
-3. [Line Spacing](#line-spacing)
-4. [Paragraph Spacing](#paragraph-spacing)
-5. [Page Layout](#page-layout)
-6. [Table Design](#table-design)
-7. [Color Schemes](#color-schemes)
-8. [Visual Hierarchy](#visual-hierarchy)
-9. [Quick Reference Defaults](#quick-reference-defaults)
-
----
-
-## Font Pairing
-
-### Recommended Pairs
-
-| Headings | Body | Style | Best For |
-|----------|------|-------|----------|
-| Calibri Light | Calibri | Modern sans | Corporate reports |
-| Aptos | Aptos | Office 365 default | Modern business docs |
-| Cambria | Calibri | Serif + sans | Academic-corporate hybrid |
-| Times New Roman | Times New Roman | Traditional serif | Academic, legal |
-| Arial | Arial | Clean sans | Memos, internal docs |
-| Georgia | Garamond | Classical serif pair | Formal reports |
-
-### Rules
-
-- **Limit**: 2 font families max (3 if CJK mixed)
-- **Contrast**: Pair serif with sans-serif, OR use weight contrast within one family
-- **Consistency**: Same font for all body text, same font for all headings
-
----
-
-## Font Sizes by Document Type
-
-| Document Type | Body | H1 | H2 | H3 | Footnotes |
-|--------------|------|----|----|----|----|
-| **Business report** | 11pt | 18-20pt | 14-16pt | 12-13pt bold | 9pt |
-| **Business letter** | 11-12pt | — | — | — | 9-10pt |
-| **Memo** | 11pt | 14pt bold | 12pt bold | 11pt bold | 9pt |
-| **Contract / Legal** | 12pt | 14pt bold caps | 12pt bold | 12pt bold | 10pt |
-| **Academic (APA 7)** | 12pt | 12pt bold center | 12pt bold left | 12pt bold italic | 10pt |
-| **Resume / CV** | 10-11pt | 14-16pt | 12pt bold | 11pt bold | 8-9pt |
-| **Chinese 公文** | 三号(16pt) | 二号(22pt) | 三号(16pt) | 四号(14pt) | 小四(12pt) |
-
-### OpenXML `w:sz` Values (half-points)
-
-| Point Size | `w:sz` Val | Common Use |
-|-----------|-----------|------------|
-| 9pt | 18 | Footnotes, captions |
-| 10pt | 20 | Compact body text |
-| 10.5pt (五号) | 21 | CJK body small |
-| 11pt | 22 | Standard body (Calibri) |
-| 12pt (小四) | 24 | Standard body (TNR), CJK |
-| 14pt (四号) | 28 | CJK body, subheading |
-| 16pt (三号) | 32 | CJK heading, western H2 |
-| 18pt (小二) | 36 | Western H1 |
-| 22pt (二号) | 44 | CJK document title |
-| 26pt (一号) | 52 | Large title |
-
----
-
-## Line Spacing
-
-| Spacing | OpenXML `w:spacing line` | When to Use |
-|---------|--------------------------|-------------|
-| Single (1.0) | `line="240"` lineRule="auto" | Tables, footnotes, captions |
-| 1.08 (MS default) | `line="259"` lineRule="auto" | Modern Office documents |
-| 1.15 | `line="276"` lineRule="auto" | Business reports — best general default |
-| 1.5 | `line="360"` lineRule="auto" | Some academic, drafts for markup |
-| Double (2.0) | `line="480"` lineRule="auto" | APA/MLA manuscripts, legal briefs |
-| Fixed 28pt | `line="560"` lineRule="exact" | Chinese 公文 (GB/T 9704) |
-
-**`lineRule` values**: `auto` = proportional (240 = 1 line), `exact` = fixed height, `atLeast` = minimum.
-
----
-
-## Paragraph Spacing
-
-| Element | Space Before (DXA) | Space After (DXA) |
-|---------|-------------------|-------------------|
-| Body paragraph | 0 | 120-160 (6-8pt) |
-| Heading 1 | 480 (24pt) | 120-240 |
-| Heading 2 | 360 (18pt) | 120 |
-| Heading 3 | 240 (12pt) | 80-120 |
-| List items | 0 | 40-80 (2-4pt) |
-| Block quote | 120-240 | 120-240 |
-| Table/Figure caption | 240 | 240 |
-
-**Principle**: Space before a heading > space after, so heading visually "belongs to" content below (2:1 or 3:1 ratio).
-
----
-
-## Page Layout
-
-### Margins by Document Type
-
-| Document Type | Top | Bottom | Left | Right | DXA Values |
-|--------------|-----|--------|------|-------|------------|
-| **Standard business** | 1 in | 1 in | 1 in | 1 in | 1440 all |
-| **Academic (APA/MLA)** | 1 in | 1 in | 1 in | 1 in | 1440 all |
-| **Thesis (binding)** | 1 in | 1 in | 1.5 in | 1 in | T/B:1440 L:2160 R:1440 |
-| **Chinese 公文** | 37mm | 35mm | 28mm | 26mm | T:2098 B:1984 L:1588 R:1474 |
-| **Narrow modern** | 0.75 in | 0.75 in | 0.75 in | 0.75 in | 1080 all |
-| **Wide** | 1 in | 1 in | 2 in | 2 in | T/B:1440 L/R:2880 |
-
-### Page Sizes
-
-| Size | Width × Height | DXA Width × Height |
-|------|---------------|-------------------|
-| US Letter | 8.5 × 11 in | 12240 × 15840 |
-| A4 | 210 × 297 mm | 11906 × 16838 |
-| Legal | 8.5 × 14 in | 12240 × 20160 |
-| A3 | 297 × 420 mm | 16838 × 23811 |
-
-**Rule**: A4 for international audiences, Letter for US-only.
-
-### Page Numbers
-
-| Convention | Placement | Common In |
-|-----------|-----------|-----------|
-| Bottom center | Footer, centered | Academic, government |
-| Bottom right | Footer, right-aligned | Business reports |
-| "Page X of Y" | Footer, right-aligned | Contracts, legal |
-| Bottom outside | Alternating L/R for odd/even | Books, bound reports |
-| Chinese 公文 | Bottom center, format "-X-" | Government documents |
-
----
-
-## Table Design
-
-### Style Patterns
-
-| Style | Description | When to Use |
-|-------|------------|-------------|
-| **Three-line (三线表)** | Top rule + header-bottom rule + bottom rule only, no vertical lines | Academic, scientific — gold standard |
-| **Banded rows** | Alternating white/light-gray, no borders | Modern corporate |
-| **Light grid** | Thin 0.5pt gray borders all cells | Business reports |
-| **Header-accent** | Dark/colored header row, no other borders | Modern templates |
-| **Full border** | All cells bordered | Financial tables, forms |
-
-### Border Weights (OpenXML `w:sz` in eighths of a point)
-
-| Visual | `Size` value | Points |
-|--------|-------------|--------|
-| Hairline | 2 | 0.25pt |
-| Thin | 4 | 0.5pt |
-| Medium | 8 | 1pt |
-| Thick | 12 | 1.5pt |
-
-### Cell Padding
-
-- **Minimum**: 0.05 in (28 DXA) — too tight for most uses
-- **Recommended**: 0.08-0.1 in (57-72 DXA) top/bottom, 0.1-0.15 in (72-108 DXA) left/right
-- **Spacious**: 0.12 in (86 DXA) top/bottom, 0.19 in (137 DXA) left/right
-
-### Header Row Best Practices
-
-- Bold text, optionally SMALL CAPS
-- Background: light gray (#F2F2F2) or dark with white text (#2F5496 + white)
-- Repeat header row on each page (`w:tblHeader` on `w:trPr`)
-- Right-align number columns, left-align text columns
-
----
-
-## Color Schemes
-
-### Corporate / Business
-
-| Element | Hex | Notes |
-|---------|-----|-------|
-| Primary heading | #1F3864 | Dark navy, authoritative |
-| Secondary heading | #2E75B6 | Medium blue |
-| Body text | #333333 | Near-black (softer than #000) |
-| Table header bg | #4472C4 | With white #FFFFFF text |
-| Alternate row | #F2F2F2 | Subtle gray banding |
-| Hyperlink | #0563C1 | Standard blue |
-
-### Academic
-
-All text **#000000** (black). Color only in figures/charts.
-
-### Chinese Government (公文)
-
-| Element | Color |
-|---------|-------|
-| All body text | Black (required) |
-| 红头 agency name | Red #FF0000 |
-| 红线 separator | Red #FF0000 |
-| 公章 seal | Red |
-
-### Accessibility
-
-- Minimum contrast ratio 4.5:1 for normal text, 3:1 for large text (WCAG AA)
-- Never use color as sole means of conveying information
-- Ensure distinguishable in grayscale for printed documents
-
----
-
-## Visual Hierarchy
-
-### Heading Levels by Document Length
-
-| Pages | Recommended Levels |
-|-------|-------------------|
-| 1-5 (memo, letter) | 1-2 levels |
-| 5-20 (report) | 2-3 levels |
-| 20-100 (long report) | 3-4 levels |
-| 100+ (thesis) | 4-5 levels max |
-
-### Numbering Systems
-
-**Decimal (ISO 2145)** — technical, international:
-```
-1 → 1.1 → 1.1.1 → 1.1.1.1
-```
-
-**Traditional outline (US legal):**
-```
-I. → A. → 1. → a. → (1) → (a)
-```
-
-**Chinese government (公文):**
-```
-一、(黑体) → （一）(楷体) → 1.(仿宋加粗) → (1)(仿宋)
-```
-
-### Typography Emphasis
-
-| Format | Use For | Avoid |
-|--------|---------|-------|
-| **Bold** | Key terms, headings, emphasis | Entire paragraphs |
-| *Italic* | Titles, foreign words, mild emphasis | Long passages (hard to read) |
-| Underline | Hyperlinks only (digital) | General emphasis (archaic) |
-| SMALL CAPS | Legal defined terms, acronyms | Body text |
-| ALL CAPS | Very short headings | Long text (reduces readability 15%) |
-
-**CJK note**: Chinese/Japanese have no true italic. Use bold for emphasis.
-
-### List Formatting
-
-**Bullets** (unordered): `•` → `○` → `■` by level
-
-**Numbers** (ordered): `1.` → `a.` → `i.` by level
-
-- Indent each level 0.25-0.5 in (360-720 DXA)
-- Hanging indent: number hangs, text aligns consistently
-- Spacing between items: 2-4pt (less than paragraph spacing)
-
----
-
-## Quick Reference Defaults
-
-### Business Report (Safe Default)
-
-| Parameter | Value | OpenXML |
-|-----------|-------|---------|
-| Body font | Calibri 11pt | sz="22", RunFonts Ascii="Calibri" |
-| H1 | 18pt Bold Dark Blue | sz="36", Bold, Color="#1F3864" |
-| H2 | 14pt Bold Dark Blue | sz="28", Bold |
-| H3 | 12pt Bold Dark Blue | sz="24", Bold |
-| Line spacing | 1.15 | line="276" lineRule="auto" |
-| Para after | 8pt | after="160" |
-| Margins | 1 in all | 1440 DXA all |
-| Page size | Letter or A4 | 12240×15840 or 11906×16838 |
-| Page numbers | Bottom right, 10pt | |
-
-### Academic Paper (APA 7th)
-
-| Parameter | Value | OpenXML |
-|-----------|-------|---------|
-| Font | Times New Roman 12pt | sz="24" |
-| Line spacing | Double | line="480" lineRule="auto" |
-| First-line indent | 0.5 in | ind firstLine="720" |
-| Margins | 1 in all | 1440 DXA all |
-| Page numbers | Top right | Header, right-aligned |
-
-### Chinese Government (公文 GB/T 9704)
-
-| Parameter | Value | OpenXML |
-|-----------|-------|---------|
-| Body font | 仿宋_GB2312 三号 | sz="32", EastAsia="FangSong_GB2312" |
-| Title | 小标宋 二号 centered | sz="44" |
-| L1 heading | 黑体 三号 | sz="32", EastAsia="SimHei" |
-| L2 heading | 楷体 三号 | sz="32", EastAsia="KaiTi_GB2312" |
-| Line spacing | Fixed 28pt | line="560" lineRule="exact" |
-| Margins | T:37mm B:35mm L:28mm R:26mm | T:2098 B:1984 L:1588 R:1474 |
-| Page size | A4 | 11906×16838 |
-| Page numbers | Bottom center, 宋体 四号, "-X-" | sz="28" |
-| Chars/line | 28 | |
-| Lines/page | 22 | |

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

@@ -1,158 +0,0 @@
-# XSD Validation Guide
-
-## Running Validation
-
-```bash
-# Validate against the WML subset schema
-dotnet run --project docx validate input.docx --xsd assets/xsd/wml-subset.xsd
-
-# Validate against business rules (REQUIRED for Scenario C gate-check)
-dotnet run --project docx validate input.docx --xsd assets/xsd/business-rules.xsd
-
-# Validate against both
-dotnet run --project docx validate input.docx --xsd assets/xsd/wml-subset.xsd --xsd assets/xsd/business-rules.xsd
-```
-
----
-
-## What wml-subset.xsd Covers
-
-The subset schema validates the most common WordprocessingML elements:
-
-| Area | Elements Validated |
-|------|--------------------|
-| Document structure | `w:document`, `w:body`, `w:sectPr` |
-| Paragraphs | `w:p`, `w:pPr`, `w:r`, `w:rPr`, `w:t` |
-| Tables | `w:tbl`, `w:tblPr`, `w:tblGrid`, `w:tr`, `w:tc` |
-| Styles | `w:styles`, `w:style`, `w:docDefaults` |
-| Lists | `w:numbering`, `w:abstractNum`, `w:num` |
-| Headers/Footers | `w:hdr`, `w:ftr` |
-| Track Changes | `w:ins`, `w:del`, `w:rPrChange`, `w:pPrChange` |
-| Comments | `w:comment`, `w:commentRangeStart`, `w:commentRangeEnd` |
-
-### What It Does NOT Cover
-
-- DrawingML elements (`a:`, `pic:`, `wp:`) — image/shape internals
-- VML elements (`v:`, `o:`) — legacy shapes
-- Math elements (`m:`) — equations
-- Extended namespaces (`w14`, `w15`, `w16*`) — vendor extensions
-- Custom XML data parts
-- Relationship and content type validation (structural, not schema-based)
-
----
-
-## Interpreting Errors
-
-### Element Ordering Error
-
-```
-ERROR: Element 'w:jc' is not expected at this position.
-Expected: w:spacing, w:ind, w:contextualSpacing, ...
-Location: /word/document.xml, line 45
-```
-
-**Cause**: Child elements are in wrong order. See `references/openxml_element_order.md`.
-**Fix**: Reorder children to match schema sequence.
-
-### Missing Required Element
-
-```
-ERROR: Element 'w:tbl' missing required child 'w:tblPr'.
-Location: /word/document.xml, line 102
-```
-
-**Cause**: A required child element is absent.
-**Fix**: Add the missing element. Tables require both `w:tblPr` and `w:tblGrid`.
-
-### Invalid Attribute Value
-
-```
-ERROR: Attribute 'w:val' has invalid value 'middle'.
-Expected: 'left', 'center', 'right', 'both', 'distribute'
-Location: /word/document.xml, line 78
-```
-
-**Cause**: An attribute value is not in the allowed enumeration.
-**Fix**: Use one of the valid values listed in the error.
-
-### Unexpected Element
-
-```
-ERROR: Element 'w:customTag' is not expected.
-Location: /word/document.xml, line 200
-```
-
-**Cause**: An element not defined in the subset schema. May be a vendor extension.
-**Fix**: Check if it's a known extension (w14/w15/w16). If so, it's likely safe. If unknown, investigate or remove.
-
----
-
-## Business Rules XSD
-
-The `business-rules.xsd` schema enforces project-specific constraints beyond standard OpenXML validity:
-
-| Rule | What It Checks |
-|------|---------------|
-| Required styles | `Normal`, `Heading1`-`Heading3`, `TableGrid` must exist in `styles.xml` |
-| Font consistency | `w:docDefaults` fonts match expected values |
-| Margin ranges | Page margins within acceptable range (720-2160 DXA) |
-| Page size | Must be A4 or Letter |
-| Heading hierarchy | No gaps (e.g., H1 → H3 without H2) |
-| Style chain | `w:basedOn` references must resolve to existing styles |
-
-### Extending Business Rules
-
-To add project-specific rules, add `xs:assert` or `xs:restriction` elements:
-
-```xml
-<!-- Require minimum 1-inch margins -->
-<xs:element name="pgMar">
-  <xs:complexType>
-    <xs:attribute name="top" type="xs:integer">
-      <xs:restriction>
-        <xs:minInclusive value="1440" />
-      </xs:restriction>
-    </xs:attribute>
-  </xs:complexType>
-</xs:element>
-```
-
----
-
-## Gate-Check: Scenario C Hard Gate
-
-In Scenario C (Apply Template), the output document **MUST** pass `business-rules.xsd` validation before delivery:
-
-```
-1. Apply template  →  output.docx
-2. Validate        →  dotnet run ... validate output.docx --xsd business-rules.xsd
-3. PASS?           →  Deliver to user
-4. FAIL?           →  Fix issues, re-validate, repeat until PASS
-```
-
-**This is a hard gate.** A document that fails business-rules validation is NOT deliverable, even if it opens correctly in Word.
-
----
-
-## False Positives
-
-### Vendor Extensions
-
-Elements from extended namespaces (`w14`, `w15`, `w16*`) are not in the subset schema and may trigger warnings:
-
-```
-WARNING: Element '{http://schemas.microsoft.com/office/word/2010/wordml}shadow' is not expected.
-```
-
-These are generally safe to ignore — they are Microsoft extensions for newer features (e.g., advanced text effects, comment extensions).
-
-### Markup Compatibility
-
-Documents may contain `mc:AlternateContent` blocks with fallback content. The subset schema may not recognize the `mc:` namespace processing. These are safe if the document opens correctly in Word.
-
-### Recommended Approach
-
-1. Run validation
-2. Treat **errors** as must-fix
-3. Review **warnings** — ignore known vendor extensions, investigate unknown elements
-4. After fixing errors, re-validate to confirm

package/bin/skills-assets/docx/scripts/doc_to_docx.sh

@@ -1,40 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  echo "Usage: $(basename "$0") <file.doc> [output_directory]"
-  echo "Convert .doc to .docx using LibreOffice."
-  exit 1
-}
-
-if [ $# -lt 1 ]; then
-  usage
-fi
-
-INPUT="$1"
-OUTDIR="${2:-.}"
-
-if [ ! -f "$INPUT" ]; then
-  echo "Error: File not found: $INPUT"
-  exit 1
-fi
-
-if ! command -v soffice &>/dev/null; then
-  echo "Error: soffice (LibreOffice) is required for .doc conversion but not found."
-  echo "Install LibreOffice: brew install --cask libreoffice"
-  exit 1
-fi
-
-BASENAME=$(basename "$INPUT" .doc)
-mkdir -p "$OUTDIR"
-
-echo "Converting: $INPUT -> $OUTDIR/$BASENAME.docx"
-soffice --headless --convert-to docx --outdir "$OUTDIR" "$INPUT" >/dev/null 2>&1
-
-OUTPUT="$OUTDIR/$BASENAME.docx"
-if [ ! -f "$OUTPUT" ]; then
-  echo "Error: Conversion failed. Output file not created: $OUTPUT"
-  exit 1
-fi
-
-echo "Success: $OUTPUT"

package/bin/skills-assets/docx/scripts/docx_preview.sh

@@ -1,37 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  echo "Usage: $(basename "$0") <file.docx>"
-  echo "Preview DOCX content as plain text."
-  exit 1
-}
-
-if [ $# -lt 1 ]; then
-  usage
-fi
-
-INPUT="$1"
-
-if [ ! -f "$INPUT" ]; then
-  echo "Error: File not found: $INPUT"
-  exit 1
-fi
-
-FILE_SIZE=$(du -h "$INPUT" | cut -f1)
-echo "=== DOCX Preview: $(basename "$INPUT") ==="
-echo "File size: $FILE_SIZE"
-
-if command -v pandoc &>/dev/null; then
-  CONTENT=$(pandoc -f docx -t plain "$INPUT" 2>/dev/null)
-  WORD_COUNT=$(echo "$CONTENT" | wc -w | tr -d ' ')
-  EST_PAGES=$(( (WORD_COUNT + 249) / 250 ))
-  echo "Word count: $WORD_COUNT"
-  echo "Estimated pages: $EST_PAGES"
-  echo "---"
-  echo "$CONTENT"
-else
-  echo "(pandoc not available, falling back to raw XML extract)"
-  echo "---"
-  unzip -p "$INPUT" word/document.xml 2>/dev/null | head -100
-fi

package/bin/skills-assets/docx/scripts/dotnet/Docx.Cli/Docx.Cli.csproj

@@ -1,19 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <ItemGroup>
-    <ProjectReference Include="..\Docx.Core\Docx.Core.csproj" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="System.CommandLine" Version="2.0.5" />
-  </ItemGroup>
-
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>net8.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <NeutralLanguage>en</NeutralLanguage>
-  </PropertyGroup>
-
-</Project>

package/bin/skills-assets/docx/scripts/dotnet/Docx.Cli/Program.cs

@@ -1,18 +0,0 @@
-using System.CommandLine;
-using Docx.Core.Commands;
-
-var rootCommand = new RootCommand("docx: OpenXML document generation and manipulation CLI");
-
-// Scenario commands
-rootCommand.Add(CreateCommand.Create());
-rootCommand.Add(EditContentCommand.Create());
-rootCommand.Add(ApplyTemplateCommand.Create());
-
-// Tool commands
-rootCommand.Add(ValidateCommand.Create());
-rootCommand.Add(MergeRunsCommand.Create());
-rootCommand.Add(FixOrderCommand.Create());
-rootCommand.Add(AnalyzeCommand.Create());
-rootCommand.Add(DiffCommand.Create());
-
-return rootCommand.Parse(args).Invoke();