@decantr/content 3.8.0

package/patterns/detail-header.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "detail-header",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Detail Header",
+  "description": "Page header for detail views with title, metadata, status, and action buttons",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Avatar",
+        "Badge",
+        "Button",
+        "Breadcrumb",
+        "Separator",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Avatar",
+    "Badge",
+    "Button",
+    "Breadcrumb"
+  ],
+  "contained": false,
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Title, subtitle/description, status badge, breadcrumb, and action buttons. Horizontal layout with bottom border.",
+      "components": [
+        "Badge",
+        "Button",
+        "Breadcrumb",
+        "Separator",
+        "icon"
+      ],
+      "layout": {
+        "layout": "row",
+        "atoms": "_flex _col _gap4 _pb4 _bbsolid _bcborder",
+        "slots": {
+          "breadcrumb": "Navigation breadcrumb trail with BreadcrumbItem links",
+          "title-row": "Horizontal row with title on left and action buttons on right: _flex _row _jcsb _aic",
+          "title": "Page heading with _heading2",
+          "subtitle": "Description text with _bodysm _fgmuted",
+          "status": "Badge showing current status (active, draft, archived)",
+          "actions": "Action buttons group: edit, delete, share with _flex _gap2"
+        }
+      }
+    },
+    "profile": {
+      "description": "Large avatar on the left, name/title/bio on the right, stats row, and action buttons (follow, message).",
+      "components": [
+        "Avatar",
+        "Badge",
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "row",
+        "atoms": "_flex _row _gap6 _items[start]",
+        "slots": {
+          "avatar": "Large Avatar (96px) with image and fallback initials",
+          "info": "Vertical column with name, title, bio: _flex _col _gap2 _flex1",
+          "name": "Display name with _heading2",
+          "title": "Role or title with _bodysm _fgmuted",
+          "bio": "Short biography with _body _fgmuted",
+          "stats": "Horizontal stats row (followers, posts, etc.): _flex _gap6",
+          "actions": "Action buttons: follow (primary), message (outline)"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "row",
+    "atoms": "_flex _col _gap4 _pb4 _bbsolid _bcborder",
+    "slots": {
+      "breadcrumb": "Navigation breadcrumb trail",
+      "title-row": "Title + actions horizontal row",
+      "title": "Page heading",
+      "subtitle": "Description text",
+      "status": "Status badge",
+      "actions": "Action buttons"
+    }
+  },
+  "io": {
+    "consumes": [
+      "data"
+    ],
+    "produces": [
+      "actions"
+    ],
+    "actions": [
+      "edit",
+      "delete",
+      "share"
+    ]
+  },
+  "visual_brief": "Page header area with a breadcrumb navigation trail at the top, followed by a title row containing a large heading on the left and action buttons on the right. Below the title, a subtitle or description paragraph in muted text. An optional status badge appears inline next to the title. The profile preset adds an avatar to the left of the title. All elements are separated by consistent vertical spacing with a subtle bottom border below the entire header block.",
+  "layout_hints": {
+    "shell_alignment": "Treat detail-header as a section that sits inside the shell rhythm. It should not recreate shell-level page-width wrappers or duplicate breadcrumb bars already owned by the shell.",
+    "action_balance": "Action controls should support the title rather than overpower it. Keep the title as the primary visual anchor and use compact buttons for secondary actions.",
+    "status_badge": "Status indicators should read as supporting metadata and wrap gracefully below the title on narrow widths."
+  },
+  "responsive": {
+    "mobile": "Breadcrumb collapses to back arrow with parent name. Action buttons move below the title and stack full-width. Status badge wraps below the title on its own line.",
+    "tablet": "Standard layout. Actions remain inline right of title. Breadcrumb shows full path.",
+    "desktop": "Full header with all elements comfortably positioned. Generous whitespace above and below."
+  },
+  "motion": {
+    "micro": "Action buttons may use subtle hover and focus transitions. Status badges should remain visually stable rather than animate heavily.",
+    "transitions": "Detail headers can fade up softly with the page container, but avoid dramatic motion that competes with the title hierarchy."
+  },
+  "interactions": [
+    "hover-reveal",
+    "keyboard-navigation",
+    "animate-on-mount",
+    "click-select"
+  ],
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Detail header",
+    "keyboard": [
+      "Tab moves through breadcrumbs and action buttons in reading order."
+    ],
+    "announcements": [
+      "The page title should be announced before supporting metadata and actions."
+    ],
+    "focus_management": "If a route change lands at a detail header, keep the heading reachable as an early focus destination and ensure breadcrumb links remain semantically distinct from actions."
+  },
+  "composition": {
+    "DetailHeader": "Section(d-section, flex-col, gap-4, border-bottom) > [Breadcrumb + TitleRow + Subtitle?(text-muted)]",
+    "TitleRow": "Row(space-between) > [Title(heading2) + StatusBadge?(d-annotation) + ActionButtons(d-interactive)]",
+    "ActionButtons": "Row(gap-2) > Button(variant: ghost)[]",
+    "ProfileHeader": "Row(d-section, gap-6) > [Avatar(large, 96px) + InfoColumn > [Name(heading2) + Title(text-muted) + Bio + StatsRow + ActionButtons]]"
+  }
+}

package/patterns/diff-view.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "diff-view",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Diff View",
+  "description": "Side-by-side or unified diff display for code and text comparison.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {
+      "terminal": "^1.0.0"
+    },
+    "requires_core": {
+      "components": [
+        "Button",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "icon"
+  ],
+  "default_preset": "split",
+  "presets": {
+    "split": {
+      "description": "Side-by-side split diff view with original and modified panels, line numbers, and change markers",
+      "components": [
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _hfull _mono _bgblack _fggreen",
+        "slots": {
+          "header": "File names, stats",
+          "left": "Original content",
+          "right": "Modified content",
+          "gutter": "Line numbers, change markers"
+        }
+      }
+    },
+    "unified": {
+      "description": "Unified diff format with interleaved additions and deletions in a single scrollable column",
+      "components": [
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _mono _bgblack _fggreen",
+        "slots": {
+          "header": "Diff header with stats",
+          "hunks": "Diff hunks with context"
+        }
+      }
+    },
+    "inline": {
+      "description": "Inline word-level diff highlighting character changes within individual lines",
+      "components": [],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _mono _bgblack _fggreen",
+        "slots": {
+          "content": "Mixed inline additions and deletions"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "grid",
+    "atoms": "_grid _hfull _mono _bgblack _fggreen",
+    "slots": {
+      "header": "File names and stats",
+      "left": "Original",
+      "right": "Modified"
+    }
+  },
+  "features": [
+    "syntax-highlighting",
+    "line-navigation",
+    "copy-hunks",
+    "expand-collapse",
+    "jump-to-change"
+  ],
+  "keyboard_shortcuts": {
+    "n": "Next change",
+    "p": "Previous change",
+    "e": "Expand all",
+    "c": "Collapse all"
+  },
+  "visual_brief": "Code comparison display with two side-by-side panels (split preset) or a single merged panel (unified preset). Each panel shows line numbers in a narrow gutter column with a monospace font. Added lines have a green-tinted background with a '+' marker. Removed lines have a red-tinted background with a '-' marker. Unchanged lines render with no background tint. A header bar above each panel shows the file name and change statistics (additions/deletions count). The inline preset highlights changed characters within a line with a stronger color accent.",
+  "responsive": {
+    "mobile": "Defaults to unified diff view — single column with added/removed lines interleaved. Horizontal scroll for long lines. Line numbers use minimal width.",
+    "tablet": "Split view available with narrower panes. Synchronized scrolling between panels.",
+    "desktop": "Full split view with generous panel widths. Character-level diff highlighting. Expandable context lines."
+  },
+  "layout_hints": {
+    "comparison_role": "The pattern should preserve a clear comparison between original and changed states. Headers, gutters, and hunk boundaries should all reinforce that reading model rather than acting like generic code panes.",
+    "hunk_focus": "Changed lines and inline highlights should dominate visually, while unchanged context remains supportive and easy to collapse or skim past.",
+    "mobile_fallback": "Unified mode is the canonical narrow-screen fallback. Do not try to force split panes into cramped widths where comparison becomes unreadable."
+  },
+  "motion": {
+    "micro": "Active hunks or focused lines may brighten subtly, and copied or expanded hunks may acknowledge interaction with restrained feedback.",
+    "transitions": "Expanding context, switching between split and unified views, and jumping between hunks should preserve orientation without flashy animation."
+  },
+  "interactions": [
+    "hover-reveal",
+    "click-select",
+    "scroll-reveal"
+  ],
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Diff view",
+    "keyboard": [
+      "Keyboard navigation between hunks should keep the currently focused change obvious in both split and unified modes."
+    ],
+    "announcements": [
+      "Added, removed, and unchanged lines should be distinguishable semantically and not rely only on color or gutter markers."
+    ]
+  }
+}

package/patterns/dividend-ledger.json

@@ -0,0 +1,120 @@
+{
+  "id": "dividend-ledger",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Dividend Ledger",
+  "description": "A dividend payment history ledger that records declaration dates, ex-dates, payment dates, per-share amounts, total payouts, and tax treatment classifications across an investor's entire dividend income timeline.",
+  "category": "finance",
+  "tags": [
+    "2026",
+    "finance",
+    "dividends",
+    "ledger",
+    "tax",
+    "income",
+    "investor",
+    "history"
+  ],
+  "components": [
+    "DividendRow",
+    "DateBadge",
+    "AmountCell",
+    "TaxTreatmentChip",
+    "TotalFooter",
+    "YearGroupHeader",
+    "ScheduledBadge"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Detailed row-by-row ledger showing declaration date, ex-date, pay date, amount per share, total amount, and tax treatment chip. Every dividend payment appears as a discrete row with alternating backgrounds for readability.",
+      "layout": {
+        "layout": "data-table",
+        "atoms": "_w100 _grid _gap2"
+      }
+    },
+    "annual": {
+      "description": "Yearly-grouped summary with YearGroupHeader rows aggregating dividend income per calendar year plus per-year subtotals broken down by tax treatment category, ideal for tax-season preparation and annual reporting.",
+      "layout": {
+        "layout": "data-table",
+        "atoms": "_w100 _grid _gap2"
+      }
+    },
+    "upcoming": {
+      "description": "Forward-looking view highlighting only scheduled and announced-but-unpaid dividends with ScheduledBadge indicators, sorted by pay date ascending, intended for cash-flow planning dashboards.",
+      "layout": {
+        "layout": "data-table",
+        "atoms": "_w100 _grid _gap2"
+      }
+    }
+  },
+  "visual_brief": "A dense financial ledger rendered inside a d-surface card. The table header spans the full width with d-annotation small-caps column labels: Declaration, Ex-Date, Pay Date, Per Share, Total, Tax Treatment. A thin border separates the header from data rows. DividendRows alternate between the default surface color and a subtle 2% primary-tinted background for zebra striping. Each row contains: three DateBadges in compact pill form (e.g., 'Dec 14, 2025' in mono-data small text with a calendar icon glyph), then an AmountCell showing per-share amount ($0.24) in mono-data tabular-nums figures, then the total amount paid (computed from shares held × per-share) in semibold mono-data, then a TaxTreatmentChip color-coded by category: Qualified=emerald, Ordinary=slate, Return-of-Capital=amber, Foreign=violet, Section199A=teal. Chips are pill-shaped with tiny icon prefixes. Rows are clickable and expand inline to reveal source security ticker, shares held at record date, withholding tax breakdown, and notes. A sticky TotalFooter at the bottom shows aggregate totals: total dividends received, total shares paid on, effective yield, and breakdown percentages per tax treatment. Annual preset inserts YearGroupHeader rows (full-width pill with year number in large semibold text, background matching surface-elevated) between year boundaries, with a subtotal row beneath each year showing annual dividend income grouped by tax category. Upcoming preset replaces the default row background with a subtle amber-tinted surface for scheduled dividends and adds a ScheduledBadge ('Scheduled' or 'Announced') in each row, with a days-until-pay countdown chip.",
+  "layout_hints": {
+    "container": "d-surface card",
+    "note": "Dividend ledgers are tax-critical financial records. Use mono-data with tabular-nums for ALL monetary and date figures. Right-align amount columns, left-align dates. Never round or truncate monetary values.",
+    "date_badges": "DateBadge uses d-annotation[data-date] in pill form with a subtle calendar glyph prefix. All three date types (declaration/ex/pay) use identical styling to keep the row balanced. Dates formatted as 'MMM D, YYYY'.",
+    "tax_treatment_colors": "TaxTreatmentChip colors MUST be consistent across the application: Qualified=emerald, Ordinary=slate, ROC=amber, Foreign=violet, 199A=teal. Never use red/green alone (colorblind-safe — pair with icon prefix).",
+    "total_footer": "TotalFooter uses sticky positioning with color-mix background. Shows aggregate total plus percentage breakdown by tax treatment. Essential for 1099-DIV preparation.",
+    "year_group": "YearGroupHeader uses d-row[data-group-header] with a larger text size (text-lg) and elevated background. Annual subtotal rows sit immediately below the final dividend row of each year, before the next YearGroupHeader."
+  },
+  "default_layout": {
+    "layout": "data-table",
+    "atoms": "_w100 _grid _gap2 _p4",
+    "slots": {
+      "table-header": "Sticky column-label row showing Declaration, Ex-Date, Pay Date, Per Share, Total, and Tax Treatment labels in d-annotation small-caps. Underline border separates header from data rows during scroll.",
+      "dividend-rows": "Repeating slot — one DividendRow per dividend payment event. Each row contains three DateBadges (declaration/ex/pay), AmountCell for per-share amount, AmountCell for total dollars received, and TaxTreatmentChip. Rows are interactive and expand inline to show source security, shares held at record date, withholding tax, and notes.",
+      "year-group-headers": "Annual-preset-only slot. Full-width header rows grouping dividends by calendar year. Each header shows the year number and a right-aligned annual total. Subtotal row beneath each year breaks down by tax treatment category.",
+      "scheduled-badges": "Upcoming-preset-only slot. Each DividendRow includes a ScheduledBadge showing 'Announced', 'Scheduled', or 'Declared' status plus a countdown chip with days-until-pay. Rows tinted amber to distinguish from paid dividends.",
+      "total-footer": "Sticky footer aggregating total dividends received, total shares paid on, weighted-average yield, and breakdown percentages by tax treatment category. Uses bold mono-data figures."
+    }
+  },
+  "accessibility": {
+    "role": "table",
+    "aria-label": "Dividend payment history ledger",
+    "announcements": [
+      "Dividend of {amount} paid on {date} from {security}",
+      "Annual total for {year}: {total} across {count} payments",
+      "Upcoming dividend of {amount} scheduled for {date}"
+    ],
+    "keyboard": [
+      "Tab: cycle through dividend rows",
+      "Enter: expand row for payment details",
+      "Escape: collapse expanded row",
+      "Arrow Down/Up: navigate between rows",
+      "G: jump to next year group (annual preset)"
+    ]
+  },
+  "responsive": {
+    "mobile": "Table reflows to a vertical card-stack. Each dividend becomes a card showing total amount and tax treatment chip prominently, with dates and per-share stacked beneath. TotalFooter remains sticky. YearGroupHeaders remain visible as section dividers.",
+    "tablet": "Standard table with DateBadges condensed to show only pay-date; ex-date and declaration-date revealed on row expand."
+  },
+  "motion": {
+    "micro": {
+      "row-hover": "background-color shift 150ms ease-out",
+      "chip-glow": "tax-chip subtle scale 1.03 on hover 120ms ease-out"
+    },
+    "transitions": {
+      "row-expand": "height auto + fade 250ms ease-out",
+      "row-collapse": "height 0 + fade 200ms ease-in",
+      "year-group-collapse": "height auto + fade 300ms ease-in-out"
+    },
+    "ambient": {
+      "upcoming-pulse": "ScheduledBadge border glow 1.5s ease-in-out infinite on unpaid dividends"
+    }
+  },
+  "interactions": [
+    "animate-on-mount",
+    "real-time-updates",
+    "hover-tooltip"
+  ],
+  "composition": {
+    "DividendLedger": "Surface(d-surface, card) > [TableHeader + YearGroupHeader[]? + DividendRow[] + TotalFooter]",
+    "DividendRow": "Row(d-row, data-interactive) > [DeclarationBadge + ExDateBadge + PayDateBadge + AmountCell + TotalCell + TaxTreatmentChip + ScheduledBadge?]",
+    "DateBadge": "Chip(d-annotation, data-date) > [CalendarIcon + DateText]",
+    "AmountCell": "Cell(d-annotation, data-currency) > [CurrencySymbol + AmountText]",
+    "TaxTreatmentChip": "Chip(d-annotation, data-tax-treatment) > [CategoryIcon + CategoryLabel]",
+    "YearGroupHeader": "Row(d-row, data-group-header) > [YearLabel + AnnualTotal]",
+    "TotalFooter": "Footer(d-row, sticky) > [AggregateTotal + BreakdownByTaxCategory + WeightedYield]"
+  }
+}

package/patterns/doc-editor.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "doc-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Document Editor",
+  "description": "Rich text block editor with real-time collaboration support. CRDT-based synchronization, floating toolbar, slash commands, and remote cursor overlay.",
+  "dependencies": {
+    "patterns": {
+      "block-toolbar": "^1.0.0",
+      "slash-command": "^1.0.0",
+      "mention-popup": "^1.0.0",
+      "remote-cursor": "^1.0.0"
+    },
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "Avatar",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "Avatar",
+    "icon"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full-featured block editor with toolbar, slash commands, and collaboration features",
+      "components": [
+        "Button",
+        "Avatar",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _hfull _relative",
+        "slots": {
+          "cursors-layer": "Overlay for remote collaborator cursors",
+          "selections-layer": "Overlay for remote text selections",
+          "toolbar": "Floating formatting toolbar on selection",
+          "content": "Contenteditable block container",
+          "slash-menu": "Block type command palette",
+          "mention-popup": "@mention autocomplete dropdown"
+        }
+      }
+    },
+    "minimal": {
+      "description": "Focused writing mode with minimal UI",
+      "components": [
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _hfull _relative",
+        "slots": {
+          "content": "Contenteditable with minimal distractions",
+          "word-count": "Optional word/character count"
+        }
+      }
+    },
+    "presentation": {
+      "description": "Read-only view mode for sharing",
+      "components": [],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _hfull",
+        "slots": {
+          "content": "Rendered document (non-editable)"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _hfull _relative",
+    "slots": {
+      "cursors-layer": "Overlay for remote collaborator cursors",
+      "selections-layer": "Overlay for remote text selections",
+      "toolbar": "Floating formatting toolbar on selection",
+      "content": "Contenteditable block container",
+      "slash-menu": "Block type command palette",
+      "mention-popup": "@mention autocomplete dropdown"
+    }
+  },
+  "io": {
+    "consumes": [
+      "doc",
+      "collaborators",
+      "permissions"
+    ],
+    "produces": [
+      "content-update",
+      "selection-change",
+      "cursor-move"
+    ],
+    "actions": [
+      "format-text",
+      "insert-block",
+      "delete-block",
+      "add-comment"
+    ]
+  },
+  "visual_brief": "Contenteditable block-based document area occupying the main content region. Each block (paragraph, heading, list, image, code) is a discrete editable unit. A floating formatting toolbar appears on text selection. Typing '/' at the start of a block opens a slash command menu. Remote collaborator cursors appear as colored caret lines with name labels. Remote selections render as colored highlights. The top area may include a document title field. Minimal preset hides all chrome except the content. Presentation preset uses larger type sizes and hides editing UI.",
+  "layout_hints": {
+    "editing_focus": "The editor surface should feel like one primary work plane. Floating toolbars, slash menus, and collaborator overlays should support that plane without fragmenting it.",
+    "overlay_discipline": "Selection toolbars, cursors, and slash menus should not obscure the active text block more than necessary.",
+    "document_measure": "Keep the editable column at a comfortable reading and writing width even when the surrounding workspace is wide."
+  },
+  "responsive": {
+    "mobile": "Full-width editor with bottom-fixed formatting toolbar above the keyboard. Slash menu takes full width. Remote cursors show abbreviated names.",
+    "tablet": "Standard editor layout. Floating toolbar near selection. Comfortable block spacing.",
+    "desktop": "Full editor with generous margins. Floating toolbar tracks selection precisely. All collaboration indicators visible."
+  },
+  "motion": {
+    "micro": "Selection toolbar, slash menu, and collaborator cursor states may animate softly over 120-180ms.",
+    "transitions": "Block insertions, slash-menu reveals, and comment-entry states should feel smooth and responsive without turning the editor into a motion-heavy surface."
+  },
+  "interactions": [
+    "animate-on-mount",
+    "inline-edit",
+    "keyboard-navigation"
+  ],
+  "accessibility": {
+    "role": "application",
+    "aria-label": "Document editor",
+    "keyboard": [
+      "Tab moves between title, editor tooling, and contextual editing controls.",
+      "Slash-menu and formatting controls should remain keyboard navigable."
+    ],
+    "announcements": [
+      "Formatting changes, collaborator presence, and structural insertions should be announced in a concise way."
+    ],
+    "focus_management": "Do not steal focus from the active editor block when collaboration indicators update. Floating controls should return focus to the editor after action completion."
+  },
+  "composition": {
+    "DocEditor": "Container(d-section, flex-col, full-height, relative) > [CursorsLayer + SelectionsLayer + ContentArea + FloatingToolbar? + SlashMenu? + MentionPopup?]",
+    "ContentArea": "Editor(d-surface, contenteditable) > Block[]",
+    "CursorsLayer": "Overlay(absolute) > RemoteCursor(colored, named)[]",
+    "FloatingToolbar": "Bar(d-control, floating, on-selection)"
+  }
+}

package/patterns/document-vault.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "document-vault",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Document Vault",
+  "description": "Document storage and organization with folder navigation, preview, version history, expiration tracking, and sharing.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "icon",
+        "Badge",
+        "Input"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "icon",
+    "Badge",
+    "Input"
+  ],
+  "default_preset": "list",
+  "presets": {
+    "list": {
+      "description": "Three-panel file list view with folder tree sidebar, document rows, and preview pane",
+      "components": [
+        "Button",
+        "icon",
+        "Badge",
+        "Input"
+      ],
+      "layout": {
+        "layout": "split",
+        "atoms": "_flex _gap6",
+        "slots": {
+          "header": "Title, upload button, view toggle",
+          "navigation": "Folder tree sidebar",
+          "search": "Document search",
+          "items": "Document list/grid",
+          "preview": "Document preview pane"
+        }
+      }
+    },
+    "grid": {
+      "description": "Thumbnail grid view displaying document cards with file type icons and preview images",
+      "components": [
+        "Button",
+        "icon",
+        "Badge"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _cols4 _gap4",
+        "slots": {
+          "items": "Document thumbnail cards"
+        }
+      }
+    },
+    "tenant": {
+      "description": "Tenant document view (limited)",
+      "components": [
+        "Button",
+        "icon",
+        "Badge"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "header": "Title",
+          "documents": "Tenant's accessible documents"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "split",
+    "atoms": "_flex _gap6",
+    "slots": {
+      "navigation": "Folder sidebar",
+      "content": "Document list/grid",
+      "preview": "Preview pane"
+    }
+  },
+  "visual_brief": "Three-panel layout: a folder tree sidebar on the left for navigation, a document list or grid in the center, and an optional preview pane on the right. Each document item shows a file-type icon, document name, upload date, file size, and status badges (active, expired, shared). Folder sidebar shows a nested tree of folders with expand/collapse controls. The grid preset displays documents as card tiles with thumbnail previews. Tenant preset filters by tenant and adds a tenant selector header. Version history is accessible via a timeline popover on each document.",
+  "responsive": {
+    "mobile": "Single-panel view — folder navigation becomes a top dropdown or drawer. Document list takes full width as cards. Preview opens as a full-screen overlay.",
+    "tablet": "Two-panel layout — sidebar and document list. Preview opens as a slide-over.",
+    "desktop": "Full three-panel layout with resizable sidebar. Preview pane docked on the right."
+  },
+  "layout_hints": {
+    "three_panel_role": "The pattern owns folder navigation, document list, and preview rhythm as one integrated workspace. Parent pages should not add competing sidebars around it.",
+    "document_priority": "Lead with document identity, status, and recency. Deep metadata or version history should stay in the preview or secondary disclosure layer.",
+    "tenant_variant": "Tenant-facing variants should feel more focused and lighter-weight than operator-facing vault views, with fewer controls and clearer download affordances."
+  },
+  "motion": {
+    "micro": "Preview panes may fade or slide in gently, and hovered document rows may elevate or sharpen slightly for clarity.",
+    "transitions": "Folder navigation and preview changes should preserve orientation within the vault rather than reflowing the whole surface abruptly."
+  },
+  "interactions": [
+    "click-select",
+    "animate-on-mount",
+    "keyboard-navigation",
+    "hover-reveal"
+  ],
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Document vault",
+    "keyboard": [
+      "Tab through folder navigation, search, document rows, and preview actions in a predictable left-to-right order.",
+      "Expandable folders and version history disclosures should use standard button semantics."
+    ],
+    "announcements": [
+      "Document name, status, date, and access state should be exposed semantically so the vault remains navigable without visual preview."
+    ]
+  },
+  "composition": {
+    "DocumentVault": "Container(d-section, split-3-panel) > [FolderSidebar + DocumentList + PreviewPane?]",
+    "FolderSidebar": "Panel(d-surface, flex-col) > [TreeNode(expandable)[] + NewFolderButton?(d-interactive)]",
+    "DocumentList": "Panel(d-data) > [Header > [Title + UploadButton(d-interactive) + ViewToggle] + SearchInput(d-control) + DocumentRow(d-data-row)[]]",
+    "DocumentRow": "Row(hoverable) > [FileIcon + Name + Date(text-muted) + Size(mono-data) + StatusBadge(d-annotation) + DownloadButton(d-interactive)]",
+    "PreviewPane": "Panel(d-surface) > [PreviewContent + VersionTimeline?]"
+  }
+}