@decantr/content 3.8.0

package/patterns/scope-breakdown.json

@@ -0,0 +1,108 @@
+{
+  "id": "scope-breakdown",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Scope Breakdown",
+  "description": "A structured breakdown of Scope 1, 2, and 3 emissions with drill-down category detail, year-over-year change indicators, and multiple visualization modes.",
+  "category": "climate",
+  "tags": [
+    "2026",
+    "climate",
+    "emissions",
+    "scope",
+    "ghg-protocol",
+    "breakdown",
+    "sustainability"
+  ],
+  "components": [
+    "ScopeCard",
+    "CategoryList",
+    "EmissionBar",
+    "PercentChange",
+    "TrendIndicator"
+  ],
+  "default_preset": "bars",
+  "presets": {
+    "bars": {
+      "description": "Three horizontally-stacked scope cards with expandable category bars showing emission sources ranked by magnitude within each scope",
+      "layout": {
+        "layout": "grid-3",
+        "atoms": "_grid _grid-cols-3 _gap-6 _w100 _p-6"
+      }
+    },
+    "donut": {
+      "description": "Three-ring nested donut chart with Scope 1/2/3 totals in outer ring and categories as inner ring segments with center value label",
+      "layout": {
+        "layout": "centered",
+        "atoms": "_flex _items-center _justify-center _w100 _p-6"
+      }
+    },
+    "timeline": {
+      "description": "Quarterly progression view stacking scope contributions over time showing trend lines and cumulative emissions across reporting periods",
+      "layout": {
+        "layout": "horizontal-stack",
+        "atoms": "_flex _flex-col _w100 _p-6 _gap-4"
+      }
+    }
+  },
+  "visual_brief": "Three large equal-width cards sit side-by-side (Scope 1, Scope 2, Scope 3), each with a bold header strip colored to scope semantics (red, orange, yellow). Inside each card, the total tCO2e is rendered extremely large in monospace numerals (48px) with the scope title above. Directly below the total, a percent-of-company-total badge and a YoY change chip with up/down arrow indicator (red arrow = emissions increased, green = decreased). Expanding the card reveals a list of emission categories (Stationary Combustion, Mobile Combustion, Purchased Electricity, Purchased Heat, Purchased Goods, Business Travel, Employee Commuting, etc.) as horizontal bars with category name on left, bar fill showing relative size, and tCO2e value right-aligned in monospace. Timeline preset replaces cards with a stacked area chart crossing Q1-Q4 columns.",
+  "layout_hints": {
+    "container": "d-section",
+    "note": "Scope cards must be clickable (d-surface data-interactive) to expand/collapse category detail. Use elevation change on expand.",
+    "number_formatting": "Emission totals rendered in monospace. Use comma separators for thousands. Always include tCO2e unit suffix.",
+    "trend_direction": "In climate contexts, decreasing emissions is POSITIVE. Green arrow for decrease, red for increase. Do not invert."
+  },
+  "default_layout": {
+    "layout": "grid-3",
+    "atoms": "_grid _grid-cols-3 _gap-6 _w100 _p-6",
+    "slots": {
+      "scope-card": "Repeating card per scope. Rounded surface with colored header strip. Shows scope name, total tCO2e (large monospace), percent of total, YoY change chip, and expandable category list.",
+      "category-list": "Nested list within each scope-card, revealed on expand. Each row shows category name, horizontal emission bar, and tonnage value.",
+      "emission-bar": "Horizontal progress-style bar with width proportional to the category's share of scope total. Colored to match scope semantics.",
+      "percent-change": "Small chip displaying YoY delta. Positioned below the total. Includes directional arrow and absolute percentage.",
+      "trend-indicator": "Arrow glyph (up/down) with semantic color. Green down = improvement, red up = regression in climate context."
+    }
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Emissions scope breakdown",
+    "announcements": [
+      "Scope {n}: {value} tCO2e, {change} year over year",
+      "Category {name} expanded with {count} line items"
+    ],
+    "keyboard": [
+      "Tab: cycle through scope cards",
+      "Enter or Space: expand/collapse category detail",
+      "Arrow Down: move to next category within expanded card",
+      "Escape: collapse expanded card"
+    ]
+  },
+  "responsive": {
+    "mobile": "Scope cards stack vertically at full width. Category lists remain expandable. Timeline preset renders as vertical time axis.",
+    "tablet": "Two-column grid for scope cards with third card full-width below. Donut preset maintains centered layout with smaller diameter."
+  },
+  "motion": {
+    "micro": {
+      "card-hover": "elevation raise + border-highlight 150ms ease-out",
+      "bar-fill": "width 0 to target 600ms ease-out on mount"
+    },
+    "transitions": {
+      "card-expand": "height auto + content fade-in 300ms ease-in-out",
+      "preset-switch": "cross-fade 400ms"
+    },
+    "ambient": {
+      "trend-pulse": "subtle trend-indicator opacity 0.8 to 1.0 3s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "animate-on-mount"
+  ],
+  "composition": {
+    "ScopeBreakdown": "Section(d-section) > ScopeCard[](d-surface, data-interactive) > [ScopeName + TotalEmissions(mono-lg) + PercentChange + TrendIndicator + CategoryList > EmissionBar[]]",
+    "ScopeCard": "Surface(rounded, colored-header) > [Header(ScopeName + ScopeBadge) + Body(Total + Change) + Footer(ExpandToggle)]",
+    "CategoryList": "List(collapsible) > CategoryRow[] > [CategoryName + EmissionBar + TonnageValue]",
+    "EmissionBar": "Bar(horizontal, proportional) > Fill(scope-colored)",
+    "PercentChange": "Chip(d-annotation) > [TrendIndicator + DeltaPercent]"
+  }
+}

package/patterns/scoreboard-live.json

@@ -0,0 +1,116 @@
+{
+  "id": "scoreboard-live",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Scoreboard Live",
+  "description": "A live match scoreboard with team logos, real-time score, game timer, event ticker, momentum streak indicator, and viewer count for broadcast surfaces.",
+  "category": "esports",
+  "tags": [
+    "2026",
+    "esports",
+    "scoreboard",
+    "live",
+    "broadcast",
+    "match",
+    "realtime"
+  ],
+  "components": [
+    "TeamLogo",
+    "TeamScore",
+    "GameTimer",
+    "EventTicker",
+    "StreakIndicator",
+    "ViewerCount"
+  ],
+  "default_preset": "detail",
+  "presets": {
+    "compact": {
+      "description": "Slim top-bar scoreboard strip showing only logos, scores, and timer for embedding in streaming overlays or persistent site headers",
+      "layout": {
+        "layout": "horizontal-bar",
+        "atoms": "_flex _items-center _justify-between _w100 _px-4 _py-2 _bg-surface _border-b"
+      }
+    },
+    "detail": {
+      "description": "Full scoreboard panel with logos, large scores, timer, streak indicators, rolling event ticker, and live viewer counter in one cohesive block",
+      "layout": {
+        "layout": "panel",
+        "atoms": "_flex _flex-col _gap-3 _w100 _p-4 _rounded-lg _bg-surface _border"
+      }
+    },
+    "broadcast": {
+      "description": "Widescreen broadcast overlay format with oversized team sections, center timer, and ticker optimized for 1920x1080 streaming compositions",
+      "layout": {
+        "layout": "widescreen-overlay",
+        "atoms": "_grid _grid-cols-[1fr_auto_1fr] _items-center _w100 _h-24 _px-8 _bg-surface _backdrop-blur"
+      }
+    }
+  },
+  "visual_brief": "A horizontal scoreboard bar dominated by two team sections flanking a center timer block. Left section: Team A logo (48-72px, team-branded background tint), team tricode below logo (e.g. 'FNC' in bold monospace), large team score in very large monospace (72px broadcast, 36px detail, 24px compact). Center block: game timer counting down or up in prominent monospace, above/below it the map or round indicator (e.g. 'MAP 2 - ASCENT' or 'ROUND 14'). Right section: mirrors left with Team B. A streak indicator (small fire icon with count or momentum arrow) appears under whichever team has a winning streak, glowing in their team color. Below the main bar, a horizontal auto-scrolling event ticker shows recent plays with icons and text ('16:42 Aspas ACE' 'Derke 3K' 'Plant B'). Top-right corner has viewer count pill with live red dot and count in monospace (e.g. '142K viewers'). Team colors provide accent trim. Live indicator (pulsing red dot + 'LIVE' text) near viewer count.",
+  "layout_hints": {
+    "container": "d-section",
+    "note": "Timer must be prominent monospace, center-aligned. Team tricodes always visible as text, never logo-only.",
+    "live_indicator": "Live state uses text 'LIVE' with pulsing dot, never just color. Viewer count formatted with K/M suffixes."
+  },
+  "default_layout": {
+    "layout": "panel",
+    "atoms": "_flex _flex-col _gap-3 _w100 _p-4 _rounded-lg _bg-surface _border",
+    "slots": {
+      "team-logo": "Team emblem with tricode label beneath. Appears twice mirrored on left and right.",
+      "team-score": "Large monospace score number, sized per preset (largest in broadcast).",
+      "game-timer": "Center-block monospace timer with map/round label line above or below.",
+      "event-ticker": "Auto-scrolling horizontal strip of recent play events with timestamps and icons.",
+      "streak-indicator": "Small momentum badge appearing under the leading team showing consecutive round wins.",
+      "viewer-count": "Live pill with pulsing red dot, 'LIVE' text, and formatted viewer count."
+    }
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Live match scoreboard",
+    "announcements": [
+      "Score update: {teamA} {scoreA}, {teamB} {scoreB}",
+      "Event: {event} at {time}",
+      "Viewer count {count}"
+    ],
+    "keyboard": [
+      "Tab: cycle through team sections and ticker",
+      "Enter: open team detail",
+      "T: pause ticker scroll"
+    ]
+  },
+  "responsive": {
+    "mobile": "Broadcast preset falls back to compact. Ticker scroll speed reduced. Tricodes stay visible; logos shrink.",
+    "tablet": "Detail preset retained with slightly smaller scores. Ticker single-line truncation."
+  },
+  "motion": {
+    "micro": {
+      "score-change": "scale(1.2) + color flash team-color 400ms spring",
+      "ticker-event-in": "new event slide-in from right 300ms ease-out"
+    },
+    "transitions": {
+      "map-change": "full scoreboard fade-out and fade-in 500ms ease-in-out",
+      "timer-tick": "monospace digit flip 100ms ease"
+    },
+    "ambient": {
+      "live-dot-pulse": "red dot opacity 0.4 to 1.0 1s ease-in-out infinite",
+      "ticker-scroll": "marquee translate-x continuous 30s linear infinite",
+      "streak-glow": "streak indicator team-color glow pulse 2s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "drag-reorder",
+    "click-select",
+    "animate-on-mount",
+    "stagger-children",
+    "scroll-reveal"
+  ],
+  "composition": {
+    "ScoreboardLive": "Section(d-section) > [MainBar > [TeamSection(left) > [TeamLogo + TeamTricode + TeamScore(mono-xl) + StreakIndicator?] + CenterBlock > [MapLabel + GameTimer(mono-xl) + RoundLabel] + TeamSection(right) > [TeamScore(mono-xl) + TeamTricode + TeamLogo + StreakIndicator?]] + EventTicker(marquee) + ViewerCount(top-right, d-annotation) > [LiveDot + ViewerLabel(mono)]]",
+    "TeamLogo": "Image(team-branded, tricode-adjacent) > [LogoImg + TeamTricode(mono)]",
+    "TeamScore": "Text(mono, size-varies-by-preset)",
+    "GameTimer": "Block(centered) > [MapLabel(small) + TimerDigits(mono-xl) + RoundLabel(small)]",
+    "EventTicker": "Marquee(horizontal, auto-scroll) > EventEntry[] > [Timestamp + EventIcon + EventText]",
+    "ViewerCount": "Pill(d-annotation) > [LiveDot(pulsing) + LiveText + ViewerCount(mono)]"
+  }
+}

package/patterns/scrim-calendar.json

@@ -0,0 +1,114 @@
+{
+  "id": "scrim-calendar",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Scrim Calendar",
+  "description": "A team scrimmage scheduling calendar showing opponent matchups, map plans, time slots, player availability, and confirmation status across weeks or months.",
+  "category": "esports",
+  "tags": [
+    "2026",
+    "esports",
+    "calendar",
+    "scrim",
+    "scheduling",
+    "team-management",
+    "availability"
+  ],
+  "components": [
+    "CalendarGrid",
+    "ScrimBlock",
+    "TeamLogo",
+    "MapChip",
+    "TimeSlot",
+    "AvailabilityStatus"
+  ],
+  "default_preset": "week",
+  "presets": {
+    "week": {
+      "description": "Seven-column weekly grid with hourly time rows and scrim blocks spanning their duration for tactical weekly planning workflows",
+      "layout": {
+        "layout": "grid-week",
+        "atoms": "_grid _grid-cols-[64px_repeat(7,1fr)] _w100 _h-full _overflow-auto"
+      }
+    },
+    "month": {
+      "description": "Standard monthly calendar grid with condensed scrim pills inside each day cell for long-horizon season schedule planning overviews",
+      "layout": {
+        "layout": "grid-month",
+        "atoms": "_grid _grid-cols-7 _w100 _gap-px _bg-border"
+      }
+    },
+    "list": {
+      "description": "Agenda list view grouped by date with detailed scrim entries showing opponent, map pool, roster, and confirmation status per entry",
+      "layout": {
+        "layout": "agenda-list",
+        "atoms": "_flex _flex-col _gap-4 _w100 _max-w-3xl _mx-auto _p-4"
+      }
+    }
+  },
+  "visual_brief": "A week grid with days as columns and hourly time slots as rows. Each scrim appears as a colored block spanning its duration (e.g. 7pm-9pm slot). Block contains: opponent team logo in top-left, opponent name in bold, map chips row (e.g. 'Haven' 'Ascent' 'Pearl') with small map thumbnails, and an availability status indicator (Confirmed: green filled, Pending: amber striped, Cancelled: gray strikethrough). Time-slot backgrounds faintly shaded to show standard practice hours. Block color encodes importance: Official match red, Tournament orange, Practice scrim teal, Coaching session purple. Player availability dots appear along the left edge of each block showing which 5 players are confirmed (green), tentative (amber), or unavailable (red). 'Now' horizontal line overlays the current time. Month preset shows condensed event pills inside day cells.",
+  "layout_hints": {
+    "container": "d-section",
+    "note": "Calendar must support drag-to-reschedule. Scrim blocks clickable (d-interactive) for edit modal.",
+    "status_labels": "Availability status uses text labels not color-only (Confirmed/Pending/Cancelled)."
+  },
+  "default_layout": {
+    "layout": "grid-week",
+    "atoms": "_grid _grid-cols-[64px_repeat(7,1fr)] _w100 _h-full _overflow-auto",
+    "slots": {
+      "calendar-grid": "Main grid container with time-axis column on left and day columns across. Hosts scrim blocks absolutely positioned.",
+      "scrim-block": "Repeating colored block positioned by start/end time and day. Contains opponent, maps, status, and availability dots.",
+      "team-logo": "Opponent team emblem image shown in top-left of each scrim block.",
+      "map-chip": "Small labeled pill with map name and thumbnail, grouped in a row inside each block.",
+      "time-slot": "Repeating hour row in the time-axis column with HH:MM label.",
+      "availability-status": "Text indicator (Confirmed/Pending/Cancelled) with semantic color."
+    }
+  },
+  "accessibility": {
+    "role": "grid",
+    "aria-label": "Team scrimmage calendar",
+    "announcements": [
+      "Scrim against {opponent} on {date} at {time}, status {status}",
+      "Scrim moved to {newDate} {newTime}"
+    ],
+    "keyboard": [
+      "Arrow keys: navigate grid cells",
+      "Enter: open scrim block detail",
+      "N: create new scrim on focused cell",
+      "Delete: remove scrim",
+      "[/]: previous/next week"
+    ]
+  },
+  "responsive": {
+    "mobile": "Week view shrinks to single-day scrollable column. Month view becomes list preset automatically.",
+    "tablet": "Week view retained with narrower day columns. Map chips collapse to count badge."
+  },
+  "motion": {
+    "micro": {
+      "block-hover": "elevation raise + border-highlight 150ms ease-out",
+      "drag-handle": "cursor grab + block scale(1.02) on drag 120ms"
+    },
+    "transitions": {
+      "block-create": "scale(0) to scale(1) + fade 300ms spring",
+      "block-move": "position lerp 200ms ease-out",
+      "status-change": "block color transition 300ms ease-in-out"
+    },
+    "ambient": {
+      "now-line": "current time horizontal line subtle pulse 3s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "click-select",
+    "drag-reorder",
+    "keyboard-navigation",
+    "animate-on-mount"
+  ],
+  "composition": {
+    "ScrimCalendar": "Section(d-section) > [Toolbar(week-nav + view-switcher) + CalendarGrid > [TimeAxis > TimeSlot[] + DayColumns > ScrimBlock[](d-interactive) > [TeamLogo + OpponentName + MapChip[] + AvailabilityStatus + PlayerAvailabilityDots]] + NowLine]",
+    "CalendarGrid": "Grid(time-x-day) > [TimeColumn + DayColumn[]]",
+    "ScrimBlock": "Block(positioned, importance-colored, d-interactive) > [Header + Maps + Status]",
+    "MapChip": "Chip(d-annotation) > [MapThumbnail + MapName]",
+    "AvailabilityStatus": "Label(data-status) > [StatusDot + StatusText]"
+  }
+}

package/patterns/search-filter-bar.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "search-filter-bar",
+  "version": "1.1.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Search Filter Bar",
+  "description": "Search-first public registry filter bar with type tabs, a source filter, sort controls, and result count. Designed for builders browsing Decantr content, not for exposing internal registry-intelligence taxonomy.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Input",
+        "Select",
+        "Button",
+        "Badge",
+        "Chip",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "contained": false,
+  "components": [
+    "Input",
+    "Select",
+    "Button",
+    "Badge",
+    "Chip",
+    "icon"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full public registry filter bar with search, type tabs, source filter, sort, and result count.",
+      "components": [
+        "Input",
+        "Select",
+        "Button",
+        "Chip",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "search-row": "Search input with icon prefix",
+          "type-row": "Scrollable row of type tabs (All, Patterns, Themes, Blueprints, Archetypes, Shells)",
+          "meta-row": "Result count on the left, source filter and sort on the right",
+          "mobile-filters": "Collapsible mobile filter surface for source and sort"
+        }
+      }
+    },
+    "compact": {
+      "description": "Compact search with inline type and source controls for tighter surfaces.",
+      "components": [
+        "Input",
+        "Select",
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "row",
+        "atoms": "_flex _aic _gap3",
+        "slots": {
+          "search-input": "Search Input with icon prefix",
+          "type-select": "Content type Select dropdown",
+          "source-select": "Source Select dropdown"
+        }
+      }
+    },
+    "with-results-count": {
+      "description": "Search bar with result count summary for registry browsing.",
+      "components": [
+        "Input",
+        "Select",
+        "Button",
+        "Badge",
+        "Chip",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3",
+        "slots": {
+          "search-row": "Search Input with filters",
+          "results-summary": "Result count text and source/sort controls",
+          "clear-all": "Optional reset action when filters are active"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _gap4",
+    "slots": {
+      "search-row": "Search input with icon",
+      "type-row": "Type tabs",
+      "meta-row": "Result count, source filter, and sort"
+    }
+  },
+  "visual_brief": "Public registry filter bar with one clear purpose: help builders find the right Decantr starting point quickly. Search is the hero. Type tabs are distinct and color-coded. Source filtering is understandable to humans: Official, Community, Organizations. Sort remains available but visually secondary. The bar should feel premium, breathable, and unambiguous, not like an operator console.",
+  "responsive": {
+    "mobile": "Search input full-width on its own row. Type tabs become a horizontal scrollable strip. Source and sort move into a collapsible filter surface instead of squeezing the main bar.",
+    "tablet": "Search and filters fit comfortably in stacked rows. Type tabs remain visible. Source filter can stay inline if space allows.",
+    "desktop": "Search, type tabs, source filter, and sort remain visible without feeling like one dense toolbar. Result count stays readable but subdued."
+  },
+  "motion": {
+    "micro": "Tabs, chips, and filter controls may animate lightly on hover and selection, but search remains the dominant visual action.",
+    "transitions": "Filter-surface expansion, chip removal, and result-state updates should animate over 150-240ms without making the bar feel operator-heavy."
+  },
+  "interactions": [
+    "inline-edit",
+    "animate-on-mount",
+    "keyboard-navigation",
+    "hover-reveal"
+  ],
+  "layout_hints": {
+    "search_input": "Full-width search input with magnifying glass icon. Placeholder should explicitly mention Decantr content types and app-starting intent.",
+    "filter_tabs": "Type tabs should use distinct type-linked treatments so all-type browsing is easy to parse at a glance. The patterns icon should read like a puzzle-piece rather than a generic component glyph.",
+    "source_filter": "Use human-facing source language: Official, Community, Organizations. Do not expose authored/benchmark/hybrid intelligence taxonomy here.",
+    "sort_dropdown": "Right-aligned sort with a restrained visual footprint. Keep sort available, but subordinate to search and content-type/source selection."
+  },
+  "accessibility": {
+    "role": "search",
+    "aria-label": "Search and filter bar",
+    "keyboard": [
+      "Tab moves from search input to tabs to source and sort controls in logical order.",
+      "Arrow keys may move between tab-style filters when implemented as a tab list."
+    ],
+    "announcements": [
+      "Active filters, source selection, and sort changes should be announced clearly.",
+      "Result count updates should remain available without depending on purely visual placement."
+    ],
+    "focus_management": "Opening mobile filter surfaces should move focus into the filter panel and return it to the invoking control on close."
+  },
+  "composition": {
+    "SearchFilterBar": "Stack > [SearchRow > SearchInput(d-control, icon: search) + TypeRow > TypeTabs(d-interactive)[] + MetaRow > [ResultCount + SourceFilter + SortSelect(d-control)]]",
+    "MobileFilters": "Surface(d-surface) > [SourceFilter + SortSelect]"
+  }
+}

package/patterns/secure-document-viewer.json

@@ -0,0 +1,107 @@
+{
+  "id": "secure-document-viewer",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Secure Document Viewer",
+  "description": "Secure document viewing surface with watermark overlay, download guards, redaction display, and audit trail indicators for confidential document workflows.",
+  "category": "document",
+  "tags": ["2026", "document", "secure", "viewer", "watermark", "audit", "confidential"],
+  "components": ["DocumentCanvas", "WatermarkLayer", "PageNavigator", "ZoomControls", "DownloadGuard", "AuditBadge"],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full viewer with page navigator, zoom controls, watermark overlay, download guard, and audit badge for complete secure viewing",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _flex-col _w-full _h-full _bg-canvas"
+      }
+    },
+    "minimal": {
+      "description": "Preview-only mode without download controls or pagination, used for quick reviews and inline embeds with watermark still enforced",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _flex-col _w-full _h-full _bg-canvas _pointer-events-restricted"
+      }
+    },
+    "redacted": {
+      "description": "Specialized variant highlighting redaction overlays prominently for legal and compliance review workflows where redactions must be auditable",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _flex-col _w-full _h-full _bg-canvas"
+      }
+    }
+  },
+  "visual_brief": "A document page rendered within a scrollable viewport with a diagonal repeating watermark overlay that covers the entire document area. Watermark text reads 'CONFIDENTIAL - {user.email} - {timestamp}' at 45 degrees, repeated in a grid pattern with approximately 12% opacity in text-muted color, rotated and tiled across the page. A thin control bar (48px tall) sits above the document showing: page navigator center (e.g. '3 of 24') with previous/next arrows, zoom controls right (-, percentage, +), download button at far right that shows a lock icon and opens a permission-check modal. Audit badge floats in the bottom-right corner as a small dark pill reading 'VIEW LOGGED' with a small eye icon, semi-transparent with backdrop-blur. Redactions appear as solid black rectangles overlaid on document text with white 'REDACTED' label centered. Page transitions with smooth scroll. Document canvas has subtle shadow suggesting paper.",
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _flex-col _w-full _h-full _bg-canvas",
+    "slots": {
+      "control-bar": "Horizontal toolbar (48px) at top with page navigator, zoom controls, and download guard button. Light background with subtle border-bottom.",
+      "document-canvas": "Main scrollable document viewport. Renders pages sequentially with subtle paper shadow and gutter between pages. Supports click-to-zoom and pan at higher zoom levels.",
+      "watermark-layer": "Overlay layer on top of document content rendering diagonal repeating watermark pattern. Non-interactive pointer-events-none. Opacity 12% of text-muted color. Text includes user identity and timestamp.",
+      "page-content": "Individual rendered page within the canvas. Standard document page with text, images, and layout preserved from source.",
+      "redaction-overlay": "Black rectangles positioned absolutely over redacted regions with white 'REDACTED' label centered. Must render above document content but below watermark.",
+      "audit-badge": "Floating pill (bottom-right) showing that this view is being logged. Backdrop-blur semi-transparent. Small eye icon with 'VIEW LOGGED' text.",
+      "download-guard": "Download button that triggers permission check modal before allowing file download. Shows lock icon when user lacks download permission."
+    }
+  },
+  "responsive": {
+    "mobile": "Control bar stacks: page navigator on top row, zoom and download on second row. Watermark text reduces font size but maintains density. Single-page scroll mode only.",
+    "tablet": "Standard layout with slightly condensed control bar. Touch pinch-to-zoom enabled.",
+    "desktop": "Full layout with all controls inline. Keyboard shortcuts for navigation and zoom enabled."
+  },
+  "layout_hints": {
+    "document_priority": "The secured document itself is the primary surface. Watermarks, redactions, and audit cues should protect the content without obscuring normal reading more than necessary.",
+    "control_role": "Navigation, zoom, and guarded download controls belong in one compact strip above the page stack, not scattered around the viewer.",
+    "audit_visibility": "Audit and confidentiality signals should stay present and credible without overpowering the legal or review content."
+  },
+  "layout_hints": {
+    "document_priority": "The secured document itself is the primary surface. Watermarks, redactions, and audit cues should protect the content without obscuring normal reading more than necessary.",
+    "control_role": "Navigation, zoom, and guarded download controls belong in one compact strip above the page stack, not scattered around the viewer.",
+    "audit_visibility": "Audit and confidentiality signals should stay present and credible without overpowering the legal or review content."
+  },
+  "motion": {
+    "micro": {
+      "page-change": "scroll-snap 200ms ease-out to new page",
+      "zoom-change": "scale transform 180ms ease-out on document-canvas"
+    },
+    "transitions": {
+      "redaction-reveal": "opacity fade 300ms when redaction hover shows audit info",
+      "download-guard-open": "modal scale + backdrop fade 200ms ease-out"
+    },
+    "ambient": {
+      "audit-badge-pulse": "subtle opacity 0.7 to 1 pulse 3s ease-in-out infinite reminding user of logging"
+    }
+  },
+  "interactions": [
+    "click-select",
+    "animate-on-mount",
+    "keyboard-navigation",
+    "hover-reveal"
+  ],
+  "composition": {
+    "SecureDocumentViewer": "Root(d-section, stack) > [ControlBar + DocumentCanvas + AuditBadge]",
+    "ControlBar": "Toolbar(d-control) > [PageNavigator + ZoomControls + DownloadGuard]",
+    "DocumentCanvas": "Viewport(scrollable) > [PageContent* + RedactionOverlay* + WatermarkLayer(pointer-events-none)]",
+    "AuditBadge": "Pill(d-annotation, fixed, bottom-right, backdrop-blur) > [EyeIcon + 'VIEW LOGGED']"
+  },
+  "accessibility": {
+    "role": "document",
+    "aria-label": "Secure document viewer",
+    "announcements": [
+      "Page {current} of {total}",
+      "Zoom set to {level}%",
+      "Download requires {permission} permission",
+      "{count} redactions on this page"
+    ],
+    "keyboard": [
+      "PageDown/PageUp: next/previous page",
+      "Home/End: first/last page",
+      "+/-: zoom in/out",
+      "0: fit to width",
+      "Ctrl+D: download (if permitted)",
+      "Escape: close guard modal"
+    ]
+  }
+}