@json-to-office/core-docx 1.4.0 → 1.6.0

package/dist/quality/facts.d.ts

@@ -0,0 +1,112 @@
+import type { PreparedDocument, QualityFact } from '@json-to-office/quality';
+import type { FontRuntimeOpts, GenerationWarning } from '@json-to-office/shared';
+import type { ReportComponentDefinition } from '../types';
+import type { ThemeConfig } from '../styles';
+import { type GenerationThemeContext } from '../core/generationContext';
+import { type ResolvedDocumentTree } from '../core/structure';
+export interface DocxTableWidthFact extends QualityFact {
+    kind: 'docx/table-width';
+    totalWidthTwips: number;
+    availableWidthTwips: number;
+    hasExplicitWidth: boolean;
+    allColumnsExplicit: boolean;
+    pointSum: number;
+    percentSum: number;
+    /**
+     * Authored explicit widths by column index (points as numbers, `"NN%"`
+     * strings kept verbatim) — what a fix has to rescale. Columns without an
+     * explicit width are absent.
+     */
+    explicitWidths: ReadonlyArray<{
+        index: number;
+        width: number | string;
+    }>;
+}
+export interface DocxHeadingFact extends QualityFact {
+    kind: 'docx/heading';
+    level: number;
+    previousLevel?: number;
+}
+/**
+ * A paragraph pinned into a floating frame — the one place in DOCX where the
+ * author, not the layout engine, decides how much room the text gets. Flowed
+ * body copy repaginates; a frame keeps its declared box and lets the text spill
+ * or break inside it.
+ */
+export interface DocxFrameTextFact extends QualityFact {
+    kind: 'docx/frame-text';
+    text: string;
+    fontSizePt: number;
+    /** Height of one line, including the resolved line-spacing rule. */
+    lineHeightPt: number;
+    /** Signed tracking in points: negative when the run is condensed. */
+    characterSpacingPt: number;
+    frameWidthTwips: number;
+    frameHeightTwips?: number;
+    /** Frame top, when pinned with an absolute vertical offset. */
+    offsetYTwips?: number;
+    /** The paper edge — the last twip anything can render on. */
+    pageBottomTwips: number;
+    /** The longest whitespace-delimited token — the one with nowhere to wrap. */
+    longestWord: string;
+    /**
+     * Resolved anchor when the frame is pinned by numeric offsets; an unstated
+     * axis pins at 0, exactly as the compiler resolves it. Absent for
+     * alignment-positioned frames and for percentage offsets, which this static
+     * pass does not resolve.
+     */
+    absoluteOffsetTwips?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * What each axis's offset is measured from — `page` unless authored.
+     * Offsets are only comparable between frames sharing both references.
+     */
+    anchorHorizontal: string;
+    anchorVertical: string;
+    /**
+     * Shared by consecutive paragraphs whose frame properties are identical.
+     * OOXML merges those into one flowing frame (§17.3.1.11 — the stock stat
+     * cards stack number, caption and body this way), so their texts stack
+     * inside the box rather than painting over each other. Any rule comparing
+     * frame rects must treat a chain as a single frame.
+     */
+    frameChainId: string;
+    /**
+     * Top-level flow this frame renders in. Every top-level `section` starts a
+     * new page, so frames in different flows never share one; top-level content
+     * outside any section shares the flow it lands in.
+     */
+    flowIndex: number;
+}
+/**
+ * A `<text>` element inside an inline SVG, with the canvas it has to sit in.
+ * SVG has no overflow rule to fall back on: a baseline past the viewBox is
+ * simply not painted, and the words leave the document's text layer with it.
+ */
+export interface DocxSvgTextFact extends QualityFact {
+    kind: 'docx/svg-text';
+    content: string;
+    /** Baseline position and nominal size, in viewBox units. */
+    baselineY: number;
+    fontSizeUnits: number;
+    viewBoxMinY: number;
+    viewBoxHeight: number;
+}
+export type DocxQualityFact = DocxTableWidthFact | DocxHeadingFact | DocxFrameTextFact | DocxSvgTextFact;
+export interface DocxQualityModel {
+    authored: ReportComponentDefinition;
+    context: GenerationThemeContext;
+    document: ResolvedDocumentTree;
+    themeName: string;
+}
+export interface PrepareDocxQualityOptions {
+    customThemes?: Record<string, ThemeConfig>;
+    fonts?: FontRuntimeOpts;
+    warnings?: GenerationWarning[];
+    context?: GenerationThemeContext;
+    renderer?: string;
+}
+export declare function prepareDocxQualityDocument(document: ReportComponentDefinition, options?: PrepareDocxQualityOptions): PreparedDocument<DocxQualityModel, DocxQualityFact>;
+//# sourceMappingURL=facts.d.ts.map

package/dist/quality/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/quality/facts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAuB,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,IAAI,EAAE,kBAAkB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6RD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,yBAAyB,EACnC,OAAO,GAAE,yBAA8B,GACtC,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CA2GrD"}

package/dist/quality/preflight.d.ts

@@ -0,0 +1,15 @@
+/** DOCX quality analysis over renderer-aligned prepared facts. */
+import { type PreparedDocument, type QualityAnalysis, type QualityPolicy, type QualityProfile } from '@json-to-office/quality';
+import type { ThemeConfig } from '../styles';
+import type { DocxQualityFact, DocxQualityModel } from './facts';
+export interface DocxQualityOptions {
+    customThemes?: Record<string, ThemeConfig>;
+}
+export interface DocxQualityAnalysisOptions extends DocxQualityOptions {
+    renderer?: string;
+    profile?: QualityProfile;
+    policy?: QualityPolicy;
+    prepared?: PreparedDocument<DocxQualityModel, DocxQualityFact>;
+}
+export declare function analyzeDocxQuality(doc: unknown, options?: DocxQualityAnalysisOptions): QualityAnalysis;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/quality/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/quality/preflight.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAUjE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;CAChE;AAiBD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,0BAA+B,GACvC,eAAe,CA2CjB"}

package/dist/quality/rules.d.ts

@@ -0,0 +1,39 @@
+import { QualityEngine, type QualityProfile, type QualityRule, type QualityRulePack } from '@json-to-office/quality';
+import type { DocxQualityFact, DocxQualityModel } from './facts';
+export declare const docxTableWidthRule: QualityRule<DocxQualityModel, DocxQualityFact>;
+export declare const docxHeadingHierarchyRule: QualityRule<DocxQualityModel, DocxQualityFact>;
+export declare const docxTextFitRule: QualityRule<DocxQualityModel, DocxQualityFact>;
+export declare const docxFrameCollisionRule: QualityRule<DocxQualityModel, DocxQualityFact>;
+export declare const docxSvgTextBoundsRule: QualityRule<DocxQualityModel, DocxQualityFact>;
+export declare const DOCX_QUALITY_RULES: QualityRulePack<DocxQualityModel, DocxQualityFact>;
+export declare const DOCX_QUALITY_PROFILES: {
+    readonly 'executive-report': {
+        readonly id: "executive-report";
+        readonly formats: readonly ["docx"];
+        readonly description: "Short decision document with strict outline continuity.";
+        readonly rules: {
+            readonly 'docx/heading-hierarchy': {
+                readonly severity: "warning";
+            };
+        };
+    };
+    readonly 'technical-report': {
+        readonly id: "technical-report";
+        readonly formats: readonly ["docx"];
+        readonly description: "Portable professional report defaults.";
+    };
+    readonly 'legal-appendix': {
+        readonly id: "legal-appendix";
+        readonly formats: readonly ["docx"];
+        readonly description: "Dense appendix: preserve integrity without editorial taste.";
+    };
+};
+export declare const DOCX_DEFAULT_QUALITY_PROFILE: QualityProfile;
+/**
+ * Callers name a shipped profile by id — `{ id: 'executive-report', formats: ['docx'] }`.
+ * Without this lookup that request reaches the engine carrying nothing but its id,
+ * so the analysis runs on defaults while stamping the requested profileId.
+ */
+export declare function resolveDocxQualityProfile(requested: QualityProfile | undefined): QualityProfile | undefined;
+export declare const docxQualityEngine: QualityEngine<DocxQualityModel, DocxQualityFact>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/quality/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/quality/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAGV,eAAe,EACf,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAejB,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAC1C,gBAAgB,EAChB,eAAe,CA6DhB,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAChD,gBAAgB,EAChB,eAAe,CAuChB,CAAC;AAsBF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,gBAAgB,EAAE,eAAe,CAwF1E,CAAC;AA+BF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAC9C,gBAAgB,EAChB,eAAe,CA6HhB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAC7C,gBAAgB,EAChB,eAAe,CAqChB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAAe,CAC9C,gBAAgB,EAChB,eAAe,CAUhB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAmBiB,CAAC;AAEpD,eAAO,MAAM,4BAA4B,EAAE,cACA,CAAC;AAK5C;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,cAAc,GAAG,SAAS,GACpC,cAAc,GAAG,SAAS,CAK5B;AAED,eAAO,MAAM,iBAAiB,kDAA8C,CAAC"}

package/dist/quality/text-metrics.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A width model for authored runs, used only to answer "does this text fit".
+ *
+ * A single characters-per-point factor cannot do this job. Measured against the
+ * shipped display headings (`pdftotext -bbox`), the implied factor ran 0.435
+ * for mixed-case words and 0.694 for all-caps — a 39% spread that no single
+ * constant survives, because caps and lowercase are simply different widths.
+ *
+ * These are the standard Helvetica advance widths in 1/1000 em. The grotesque
+ * sans faces the stock templates use (DM Sans, Inter, Geist, Archivo) track
+ * them closely enough that summing real characters lands within about 8% of the
+ * rendered width, and it under-estimates more often than it over-estimates —
+ * the safe direction for a rule that only speaks up on overflow.
+ *
+ * Validated against rendered geometry at authoring time:
+ *
+ *   "Vision,"      80pt  model 179.2pt  actual 182.7pt  −1.9%
+ *   "Financial"    80pt  model 241.8pt  actual 246.8pt  −2.0%
+ *   "Global"      107pt  model 251.6pt  actual 264.4pt  −4.8%
+ *   "Performance"  80pt  model 362.2pt  actual 383.0pt  −5.4%
+ *   "OUR"          76pt  model 168.9pt  actual 158.2pt  +6.8%
+ */
+/**
+ * Width of `text` in points at `fontSizePt`, with `trackingPt` of signed
+ * letter-spacing applied per character (negative when the run is condensed).
+ */
+export declare function estimateTextWidthPt(text: string, fontSizePt: number, trackingPt?: number): number;
+/**
+ * Lines `text` needs when wrapped at `widthPt`, breaking on spaces. A word
+ * wider than the line gets its own line here; the renderer would break it
+ * mid-word, which `docx/text-fit` reports separately.
+ */
+export declare function estimateWrappedLines(text: string, widthPt: number, fontSizePt: number, trackingPt?: number): number;
+//# sourceMappingURL=text-metrics.d.ts.map

package/dist/quality/text-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../src/quality/text-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgFH;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,SAAI,GACb,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,SAAI,GACb,MAAM,CAuBR"}

package/dist/templates/documents/proposal.docx.json

@@ -6,77 +6,305 @@
       "author": "Apex Consulting",
       "description": "Strategic proposal for Meridian Financial Group's cloud transformation initiative"
     },
-    "theme": "apex"
+    "theme": "vermilion"
   },
   "children": [
     {
       "name": "section",
       "props": {
         "meta": {
-          "title": "Cloud Migration Proposal"
+          "title": "Cover"
         },
-        "header": [
-          {
-            "name": "paragraph",
-            "props": {
-              "text": "Apex Consulting — Confidential",
-              "alignment": "right"
+        "page": {
+          "margins": {
+            "top": 0,
+            "right": 0,
+            "bottom": 0,
+            "left": 0,
+            "header": 0,
+            "footer": 0
+          }
+        },
+        "header": [],
+        "footer": []
+      },
+      "children": [
+        {
+          "name": "image",
+          "props": {
+            "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"8.39in\" height=\"11.81in\" viewBox=\"0 0 806 1134\"><rect width=\"806\" height=\"1134\" fill=\"#EF4130\"/><rect x=\"0\" y=\"522\" width=\"806\" height=\"92\" fill=\"#F68F71\"/><rect x=\"0\" y=\"614\" width=\"806\" height=\"520\" fill=\"#C7C8CA\"/><rect x=\"216\" y=\"231\" width=\"46\" height=\"1.6\" fill=\"#FFFFFF\"/><rect x=\"544\" y=\"231\" width=\"46\" height=\"1.6\" fill=\"#FFFFFF\"/><rect x=\"402.5\" y=\"468\" width=\"1\" height=\"44\" fill=\"#FFFFFF\"/><circle cx=\"403\" cy=\"540\" r=\"18\" fill=\"#FFFFFF\"/><path d=\"M403,532 L403,546 M397,541 L403,547 L409,541\" stroke=\"#EF4130\" stroke-width=\"2\" fill=\"none\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>",
+            "width": 806,
+            "height": 1134,
+            "floating": {
+              "behindDocument": true,
+              "zIndex": 0,
+              "allowOverlap": true,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": -86
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": -86
+              },
+              "wrap": {
+                "type": "none"
+              }
             }
           }
-        ],
-        "footer": [
-          {
-            "name": "paragraph",
-            "props": {
-              "text": "Prepared for Meridian Financial Group",
-              "alignment": "left"
+        },
+        {
+          "name": "paragraph",
+          "props": {
+            "text": "APEX CONSULTING",
+            "noProof": true,
+            "alignment": "center",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
+            "font": {
+              "size": 10.5,
+              "color": "#FFFFFF",
+              "family": "Calibri",
+              "bold": true,
+              "characterSpacing": {
+                "type": "expanded",
+                "value": 50
+              }
+            },
+            "floating": {
+              "width": 11906,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 0
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 1120
+              },
+              "wrap": {
+                "type": "none"
+              }
             }
           }
-        ]
-      },
-      "children": [
+        },
         {
-          "name": "heading",
+          "name": "paragraph",
           "props": {
-            "text": "Cloud Migration Proposal",
-            "level": 1
+            "text": "CLOUD",
+            "noProof": true,
+            "alignment": "center",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
+            "font": {
+              "size": 13,
+              "color": "#FFFFFF",
+              "family": "Calibri",
+              "bold": true,
+              "characterSpacing": {
+                "type": "expanded",
+                "value": 90
+              }
+            },
+            "floating": {
+              "width": 11906,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 0
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 3260
+              },
+              "wrap": {
+                "type": "none"
+              }
+            }
           }
         },
         {
-          "name": "heading",
+          "name": "paragraph",
           "props": {
-            "text": "Strategic Infrastructure Transformation for Meridian Financial Group",
-            "level": 2
+            "text": "MIGRATION",
+            "noProof": true,
+            "alignment": "center",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
+            "font": {
+              "size": 58,
+              "color": "#FFFFFF",
+              "family": "Arial",
+              "bold": true,
+              "lineSpacing": {
+                "type": "exactly",
+                "value": 62
+              },
+              "characterSpacing": {
+                "type": "condensed",
+                "value": 10
+              }
+            },
+            "floating": {
+              "width": 11906,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 0
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 3700
+              },
+              "wrap": {
+                "type": "none"
+              }
+            }
           }
         },
         {
           "name": "paragraph",
           "props": {
-            "text": "Prepared by Apex Consulting — April 2026",
+            "text": "PROPOSAL 2026",
+            "noProof": true,
+            "alignment": "center",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
             "font": {
-              "italic": true,
-              "color": "textSecondary"
+              "size": 30,
+              "color": "#FFFFFF",
+              "family": "Arial",
+              "bold": true,
+              "characterSpacing": {
+                "type": "expanded",
+                "value": 20
+              }
+            },
+            "floating": {
+              "width": 11906,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 0
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 5000
+              },
+              "wrap": {
+                "type": "none"
+              }
             }
           }
         },
         {
           "name": "paragraph",
           "props": {
-            "text": ""
+            "text": "Prepared for Meridian Financial Group  ·  April 2026",
+            "noProof": true,
+            "alignment": "left",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
+            "font": {
+              "size": 9.5,
+              "color": "#282829",
+              "family": "Calibri"
+            },
+            "floating": {
+              "width": 7000,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 1180
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 14980
+              },
+              "wrap": {
+                "type": "none"
+              }
+            }
           }
         },
+        {
+          "name": "paragraph",
+          "props": {
+            "text": "Confidential",
+            "noProof": true,
+            "alignment": "right",
+            "spacing": {
+              "before": 0,
+              "after": 0
+            },
+            "font": {
+              "size": 9.5,
+              "color": "#EF4130",
+              "family": "Calibri",
+              "bold": true
+            },
+            "floating": {
+              "width": 2230,
+              "horizontalPosition": {
+                "relative": "page",
+                "offset": 8500
+              },
+              "verticalPosition": {
+                "relative": "page",
+                "offset": 14980
+              },
+              "wrap": {
+                "type": "none"
+              }
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "section",
+      "props": {
+        "meta": {
+          "title": "Overview & Contents"
+        },
+        "header": [
+          {
+            "name": "paragraph",
+            "props": {
+              "text": "Apex Consulting — Confidential",
+              "alignment": "right"
+            }
+          }
+        ],
+        "footer": [
+          {
+            "name": "paragraph",
+            "props": {
+              "text": "Prepared for Meridian Financial Group",
+              "alignment": "left"
+            }
+          }
+        ],
+        "pageBreak": true
+      },
+      "children": [
         {
           "name": "image",
           "props": {
-            "path": "https://placehold.co/800x200/0C2340/D4A843?text=APEX+CONSULTING&font=georgia",
-            "width": "100%",
-            "caption": "Figure: Apex Consulting — Enterprise Cloud Advisory"
+            "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"800\" height=\"120\" viewBox=\"0 0 800 120\"><rect width=\"800\" height=\"120\" fill=\"#EF4130\"/><rect width=\"8\" height=\"120\" fill=\"#282829\"/><rect x=\"712\" y=\"59.2\" width=\"1\" height=\"26\" fill=\"#FFFFFF\"/><circle cx=\"712.5\" cy=\"48\" r=\"12\" fill=\"#FFFFFF\"/><path d=\"M712.5,43 L712.5,52 M708.5,48.5 L712.5,52.5 L716.5,48.5\" stroke=\"#EF4130\" stroke-width=\"1.6\" fill=\"none\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><text x=\"40\" y=\"56\" font-family=\"Arial, sans-serif\" font-size=\"28\" font-weight=\"bold\" letter-spacing=\"3\" fill=\"#FFFFFF\">APEX CONSULTING</text><text x=\"40\" y=\"84\" font-family=\"Arial, sans-serif\" font-size=\"10\" letter-spacing=\"5\" fill=\"#FEE9DF\">ENTERPRISE CLOUD ADVISORY</text></svg>",
+            "width": "100%"
           }
         },
         {
-          "name": "paragraph",
+          "name": "heading",
           "props": {
-            "text": ""
+            "text": "About This Proposal",
+            "level": 1
           }
         },
         {
@@ -91,6 +319,13 @@
             "text": "Apex Consulting brings 14 years of experience in financial services cloud transformations, having successfully migrated 23 regulated financial institutions to cloud-native architectures. Our team holds AWS Advanced Consulting Partner status and specializes in PCI-DSS and SOC 2 compliant migrations."
           }
         },
+        {
+          "name": "heading",
+          "props": {
+            "text": "Contents",
+            "level": 2
+          }
+        },
         {
           "name": "toc",
           "props": {
@@ -271,7 +506,7 @@
                 "size": 10
               }
             },
-            "borderColor": "D6DAE0",
+            "borderColor": "EFEAE4",
             "borderSize": 1,
             "hideBorders": {
               "insideVertical": true
@@ -481,7 +716,7 @@
                 "size": 10
               }
             },
-            "borderColor": "D6DAE0",
+            "borderColor": "EFEAE4",
             "borderSize": 1,
             "hideBorders": {
               "insideVertical": true
@@ -607,9 +842,9 @@
         {
           "name": "image",
           "props": {
-            "path": "https://placehold.co/800x300/F4F5F8/0C2340?text=Migration+Architecture+Diagram&font=georgia",
+            "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"800\" height=\"340\" viewBox=\"0 0 800 340\"><rect width=\"800\" height=\"340\" fill=\"#FAF7F5\"/><rect x=\"0.5\" y=\"0.5\" width=\"799\" height=\"339\" fill=\"none\" stroke=\"#EFEAE4\"/><defs><marker id=\"arw\" viewBox=\"0 0 10 10\" refX=\"9\" refY=\"5\" markerWidth=\"7\" markerHeight=\"7\" orient=\"auto-start-reverse\"><path d=\"M0,0 L10,5 L0,10 z\" fill=\"#EF4130\"/></marker></defs><rect x=\"30\" y=\"115\" width=\"150\" height=\"110\" rx=\"6\" fill=\"#FFFFFF\" stroke=\"#282829\" stroke-width=\"1.5\"/><text x=\"105\" y=\"145\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"13\" font-weight=\"bold\" fill=\"#282829\">Meridian DC</text><text x=\"105\" y=\"166\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10\" fill=\"#58595B\">Oracle RAC · VMware</text><text x=\"105\" y=\"182\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10\" fill=\"#58595B\">12 physical hosts</text><text x=\"105\" y=\"203\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"9\" fill=\"#58595B\">decommissioned in Phase 3</text><line x1=\"180\" y1=\"170\" x2=\"253\" y2=\"170\" stroke=\"#EF4130\" stroke-width=\"2.5\" marker-end=\"url(#arw)\"/><text x=\"216\" y=\"150\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"9.5\" fill=\"#58595B\">Direct Connect</text><text x=\"216\" y=\"192\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"9.5\" fill=\"#58595B\">10 Gbps</text><rect x=\"258\" y=\"35\" width=\"512\" height=\"270\" rx=\"10\" fill=\"#FFFFFF\" stroke=\"#282829\" stroke-width=\"1.5\"/><text x=\"280\" y=\"62\" font-family=\"Calibri, sans-serif\" font-size=\"11\" font-weight=\"bold\" fill=\"#282829\">AWS</text><rect x=\"280\" y=\"75\" width=\"228\" height=\"205\" rx=\"8\" fill=\"#FFFFFF\" stroke=\"#58595B\"/><text x=\"394\" y=\"99\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" font-weight=\"bold\" fill=\"#282829\">us-east-1 — Production</text><rect x=\"299\" y=\"114\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"394.0\" y=\"135\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">ECS Fargate — app tier</text><rect x=\"299\" y=\"158\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"394.0\" y=\"179\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">Aurora PostgreSQL — Multi-AZ</text><rect x=\"299\" y=\"202\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"394.0\" y=\"223\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">S3 — object storage</text><text x=\"394\" y=\"264\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"9\" fill=\"#58595B\">GuardDuty · Security Hub · Config</text><rect x=\"528\" y=\"75\" width=\"222\" height=\"205\" rx=\"8\" fill=\"#FFFFFF\" stroke=\"#58595B\"/><text x=\"639\" y=\"99\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" font-weight=\"bold\" fill=\"#282829\">eu-west-1 — DR</text><rect x=\"544\" y=\"114\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"639.0\" y=\"135\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">Aurora Global — replica</text><rect x=\"544\" y=\"158\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"639.0\" y=\"179\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">ECS — warm standby</text><rect x=\"544\" y=\"202\" width=\"190\" height=\"34\" rx=\"4\" fill=\"#FAF7F5\" stroke=\"#EFEAE4\"/><text x=\"639.0\" y=\"223\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"10.5\" fill=\"#282829\">S3 — cross-region replication</text><text x=\"639\" y=\"264\" text-anchor=\"middle\" font-family=\"Calibri, sans-serif\" font-size=\"9\" fill=\"#58595B\">RPO &lt; 1 min · RTO &lt; 15 min</text><line x1=\"508\" y1=\"170\" x2=\"528\" y2=\"170\" stroke=\"#EF4130\" stroke-width=\"2\" stroke-dasharray=\"4 3\" marker-end=\"url(#arw)\" marker-start=\"url(#arw)\"/></svg>",
             "width": "100%",
-            "caption": "Figure 2: Target cloud architecture — multi-AZ deployment across us-east-1 and eu-west-1"
+            "caption": "Figure 1: Target cloud architecture — multi-AZ deployment across us-east-1 and eu-west-1"
           }
         },
         {
@@ -678,7 +913,7 @@
                 "size": 10
               }
             },
-            "borderColor": "D6DAE0",
+            "borderColor": "EFEAE4",
             "borderSize": 1,
             "hideBorders": {
               "insideVertical": true
@@ -887,7 +1122,7 @@
                 "size": 10
               }
             },
-            "borderColor": "D6DAE0",
+            "borderColor": "EFEAE4",
             "borderSize": 1,
             "hideBorders": {
               "insideVertical": true
@@ -1047,7 +1282,7 @@
                     "size": 9
                   }
                 },
-                "borderColor": "D6DAE0",
+                "borderColor": "EFEAE4",
                 "borderSize": 1,
                 "hideBorders": {
                   "insideVertical": true
@@ -1145,7 +1380,7 @@
                     "size": 9
                   }
                 },
-                "borderColor": "D6DAE0",
+                "borderColor": "EFEAE4",
                 "borderSize": 1,
                 "hideBorders": {
                   "insideVertical": true
@@ -1277,7 +1512,7 @@
                 "size": 10
               }
             },
-            "borderColor": "D6DAE0",
+            "borderColor": "EFEAE4",
             "borderSize": 1,
             "hideBorders": {
               "insideVertical": true