@decantr/content 3.8.0

package/patterns/kds-ticket-rail.json

@@ -0,0 +1,133 @@
+{
+  "id": "kds-ticket-rail",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "KDS Ticket Rail",
+  "description": "A kitchen display system ticket rail rendering active order tickets as horizontal cards with item rows, station routing tags, prep timers counting up, priority flags, and bump buttons for kitchen flow management.",
+  "category": "restaurant",
+  "tags": [
+    "2026",
+    "restaurant",
+    "kitchen",
+    "kds",
+    "orders",
+    "tickets",
+    "pos",
+    "operations"
+  ],
+  "components": [
+    "OrderTicket",
+    "ItemRow",
+    "StationTag",
+    "PrepTimer",
+    "BumpButton",
+    "PriorityFlag",
+    "OrderHeader",
+    "ModifierChip",
+    "StationHeader"
+  ],
+  "default_preset": "horizontal",
+  "presets": {
+    "horizontal": {
+      "description": "Horizontal rail of order tickets flowing left-to-right in chronological order (oldest left). New tickets slide in from right, bumped tickets animate out to left. Primary kitchen line display mode.",
+      "layout": {
+        "layout": "rail",
+        "atoms": "_w100 _flex _gap3 _overflow-x-auto _p3"
+      }
+    },
+    "grid": {
+      "description": "Station-grouped grid layout with tickets organized into columns by station (Grill/Fry/Salad/Expo). Each station header tops its column. Tickets stack vertically within their assigned station column.",
+      "layout": {
+        "layout": "grid",
+        "atoms": "_w100 _grid _grid-cols-[repeat(auto-fit,minmax(260px,1fr))] _gap3 _p3"
+      }
+    },
+    "compact": {
+      "description": "Summary rendering showing tickets as small rows with order number, table, item count, and elapsed time only. Used on secondary kitchen displays where detail must be truncated to fit many tickets.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_w100 _grid _gap1 _p2"
+      }
+    }
+  },
+  "visual_brief": "A high-contrast kitchen-grade display rail rendered on a dark-background d-section with large, glove-friendly touch targets. OrderTickets render as d-surface cards with thick borders and generous padding (min-width 260px, max-width 320px in horizontal mode). Each ticket's OrderHeader shows the order number in text-2xl mono-data bold ('#2047'), table identifier ('T-12' or 'BAR-4' or 'T/O' for takeout) in text-lg semibold, and a server initial avatar. A PrepTimer counts up from ticket-fire time in large mono-data figures ('04:32') positioned top-right; background color shifts with elapsed time: 0-4min=emerald, 4-8min=amber, 8+min=red (visual urgency escalation). The ticket body contains a vertical stack of ItemRows; each item row shows quantity ('2x') in bold, item name in semibold text-base ('RIBEYE 12oz'), and below it a row of ModifierChips ('med-rare', 'no rosemary', 'add garlic butter') in small pill form. Allergies display in red-outlined ModifierChips with warning icons. A StationTag chip on each item row color-codes the station routing (grill=red, fry=amber, salad=green, saute=blue, expo=violet) with small icon prefix. A PriorityFlag (red flag icon + 'RUSH' label) appears in the top-left corner of urgent tickets with a subtle border glow. If the ticket is part of a course-sequenced meal, a course-indicator badge shows 'Course 2' above the item list. At the bottom of each ticket, a large BumpButton spans full width (48px height) with text 'BUMP' in bold uppercase — tapping completes the ticket and triggers an animation sliding the ticket out to the left with a subtle chime. In grid preset, StationHeaders tower above each column ('GRILL', 'FRY', 'SALAD', 'EXPO') with the current active-ticket count. Recently bumped tickets fade-out and collapse smoothly. Ticket border color reflects priority: normal=neutral, rush=red, VIP=gold. Table-is-ready indicator shows a small clock icon on each ticket when all items are complete but not yet bumped.",
+  "layout_hints": {
+    "container": "d-section dark-bg with horizontal scroll",
+    "note": "KDS displays are operated by line cooks at high speed in kitchen conditions. Touch targets MUST be 48px minimum. Text MUST be readable at arm's length (text-base minimum). Timers MUST be mono-data tabular-nums for scannable readability.",
+    "prep_timer_escalation": "PrepTimer background MUST transition through emerald (0-4min) → amber (4-8min) → red (8+min). Elapsed time visibility is safety-critical for food quality. Use d-annotation[data-timer-state].",
+    "station_tag_colors": "StationTag colors fixed across venue: grill=red, fry=amber, salad=green, saute=blue, expo=violet. Include icon prefix (flame/fryer/leaf/pan/bell) — color alone is insufficient in busy kitchen.",
+    "bump_button": "BumpButton MUST be full-width 48px minimum tap target. Bold uppercase text. Single-tap completion (no confirm dialog — speed-critical). Post-tap animation confirms action.",
+    "modifier_chips": "ModifierChip allergies MUST have red outline + warning icon + red text. Never rely on text alone. Size slightly larger than regular modifiers for emphasis.",
+    "priority_flag": "PriorityFlag renders with red border glow on entire ticket card. 'RUSH' or 'VIP' text unmissable at arm's length. Escalates further with pulsing animation if >6min elapsed."
+  },
+  "default_layout": {
+    "layout": "rail",
+    "atoms": "_w100 _flex _gap3 _overflow-x-auto _p3",
+    "slots": {
+      "ticket-rail": "Horizontal scrolling container holding all active OrderTickets in chronological order (oldest left, newest right). Tickets flow in from right on creation and out to left on bump.",
+      "order-tickets": "Repeating slot — one OrderTicket per active order. Contains OrderHeader, ItemRow stack, PriorityFlag (if urgent), and BumpButton footer. Min-width 260px for ergonomic touch.",
+      "order-header": "Top section of each ticket showing order number (large bold mono-data), table identifier, server initial, and PrepTimer (color-escalating background).",
+      "item-rows": "Vertical stack of ItemRows within ticket body. Each row shows quantity, item name, StationTag, and ModifierChips beneath.",
+      "station-tags": "Per-item chips color-coded by kitchen station (grill/fry/salad/saute/expo). Icon + label format.",
+      "modifier-chips": "Sub-slot beneath each item row. Small pills showing modifications (no onion, med-rare, add cheese, allergies). Allergies use red-outlined emphasis.",
+      "prep-timer": "Top-right of each ticket. Counts up from fire-time in mm:ss. Background color escalates with elapsed time (emerald→amber→red).",
+      "priority-flag": "Top-left corner flag indicator for RUSH or VIP tickets. Red border glow on entire ticket card. Unmissable at arm's length.",
+      "bump-button": "Full-width button at ticket bottom. Bold uppercase 'BUMP' text. Single-tap completes ticket and animates it off the rail.",
+      "station-headers": "Grid-preset-only slot. Column headers identifying each station (GRILL/FRY/SALAD/EXPO) with active ticket count. Tall and bold for visibility."
+    }
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Kitchen display system ticket rail",
+    "announcements": [
+      "New ticket #{number} for table {table}: {itemCount} items",
+      "Ticket #{number} elapsed {time} — approaching quality threshold",
+      "Ticket #{number} bumped, prep time {duration}",
+      "RUSH ticket #{number} fired for table {table}"
+    ],
+    "keyboard": [
+      "Arrow keys: navigate between tickets",
+      "B: bump focused ticket",
+      "R: mark focused ticket as rush/priority",
+      "1-9: jump to ticket by position on rail",
+      "Escape: deselect focused ticket"
+    ]
+  },
+  "responsive": {
+    "mobile": "Switches to compact preset. Tickets render as rows with order number, table, item count, elapsed time, and bump button. Suitable for expo-station tablet but not line cooks.",
+    "tablet": "Full horizontal rail with standard ticket size. Touch-optimized. BumpButton remains full-width 48px minimum."
+  },
+  "motion": {
+    "micro": {
+      "timer-tick": "digit-flip 60ms every second",
+      "ticket-fire": "scale 0.95 to 1.0 + fade-in + slide-from-right 400ms spring",
+      "bump-tap": "button scale 1.0 to 0.9 to 1.0 100ms ease-out + flash"
+    },
+    "transitions": {
+      "ticket-bump": "slide-out-left + fade + collapse 300ms ease-in",
+      "timer-escalation": "background color crossfade 600ms ease-in-out at each threshold",
+      "priority-add": "red-glow border fade-in 250ms ease-out + RUSH flag slide-in"
+    },
+    "ambient": {
+      "rush-pulse": "RUSH tickets border red-glow pulse 1.2s ease-in-out infinite",
+      "overdue-shake": "tickets >8min subtle horizontal shake every 15s",
+      "timer-seconds": "seconds digit subtle brightness pulse 1s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "animate-on-mount"
+  ],
+  "composition": {
+    "KdsTicketRail": "Section(d-section, rail, dark-bg) > [StationHeader[]? + OrderTicket[]]",
+    "OrderTicket": "Surface(d-surface, data-interactive, data-priority?) > [OrderHeader + ItemRow[] + PriorityFlag? + BumpButton]",
+    "OrderHeader": "Header(d-annotation) > [OrderNumber + TableIdentifier + ServerInitial + PrepTimer]",
+    "ItemRow": "Row(d-row, data-item) > [Quantity + ItemName + StationTag + ModifierChip[]]",
+    "StationTag": "Chip(d-annotation, data-station) > [StationIcon + StationLabel]",
+    "ModifierChip": "Chip(d-annotation, data-modifier, data-allergy?) > [ModifierText + WarningIcon?]",
+    "PrepTimer": "Display(d-annotation, data-timer-state, mono-data) > [ElapsedTime]",
+    "PriorityFlag": "Flag(d-annotation, data-priority, red-glow) > [FlagIcon + PriorityLabel]",
+    "BumpButton": "Button(d-control, data-bump, full-width, 48px) > [BumpLabel]",
+    "StationHeader": "Header(d-annotation, data-station-header) > [StationName + ActiveCount]"
+  }
+}

package/patterns/kpi-grid.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "kpi-grid",
+  "version": "1.1.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "KPI Grid",
+  "description": "A grid of key performance indicator cards showing metrics with labels, values, and trend indicators",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Badge",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "contained": false,
+  "components": [
+    "Card",
+    "icon",
+    "Badge"
+  ],
+  "default_preset": "dashboard",
+  "presets": {
+    "dashboard": {
+      "description": "4-column grid of stat cards with icon, label, value, and change percentage. This pattern owns the grid and cards, not the surrounding section rhythm.",
+      "components": [
+        "Card",
+        "icon",
+        "Badge"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gc2 _lg:gc4 _gap4",
+        "slots": {
+          "kpi-card": "Repeated Card with icon, label, value, and trend Badge",
+          "icon": "Abstract icon placeholder for each KPI category",
+          "value": "Primary metric value with _heading2 styling",
+          "trend": "Change percentage Badge with positive/negative variant"
+        }
+      },
+      "slots": {
+        "kpi-card": "Repeated Card with icon, label, value+unit (gap: 0.25em), trend Badge. Each KPI card data shape: `{ label, value, unit, delta_pct, lower_is_better, sparkline_data }`. Trend badge color is derived from `lower_is_better XOR delta_sign` — never from delta direction alone."
+      }
+    },
+    "compact": {
+      "description": "Denser 2-row layout with smaller cards, no icons, just label + value + sparkline placeholder. Outer region spacing still belongs to the parent workspace layout.",
+      "components": [
+        "Card"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gc2 _lg:gc4 _gap2",
+        "slots": {
+          "kpi-card": "Compact Card with label, value, and sparkline area",
+          "value": "Primary metric value with _heading4 styling",
+          "sparkline": "Placeholder area for inline sparkline chart"
+        }
+      }
+    }
+  },
+  "visual_brief": "Row of KPI cards in a responsive grid. Each card is a compact surface with an icon in a rounded muted-background circle at top-left, a small muted label below describing the metric, the primary value in large heading2-scale bold text, and a trend badge showing percentage change — green with an up-arrow for positive, red with a down-arrow for negative. Cards have equal height and consistent internal padding. The compact preset removes icons and replaces the trend badge with an inline sparkline chart placeholder. Cards use subtle border or shadow to delineate from the background. The grid itself should sit inside a parent workspace region stack rather than pretending to be a full section.",
+  "responsive": {
+    "mobile": "Two columns (2x2 grid). Card padding reduces to p3. Value text drops to heading3 scale. Icons shrink to 20px. Sparklines in compact preset maintain aspect ratio.",
+    "tablet": "Two columns at default, four columns if space allows. Standard padding. Full heading2 values.",
+    "desktop": "Four-column single row. Full layout with icons, values, and trend badges. Comfortable gap4 spacing between cards."
+  },
+  "motion": {
+    "micro": "Cards may softly elevate on hover, and trend indicators may brighten or pulse subtly when values improve.",
+    "transitions": "Counter animations and KPI entry reveals should remain short and restrained so the grid still reads like instrumentation, not spectacle."
+  },
+  "interactions": [
+    "lift-hover",
+    "click-select",
+    "animate-on-mount",
+    "stagger-children",
+    "real-time-updates",
+    "hover-tooltip"
+  ],
+  "accessibility": {
+    "role": "region",
+    "aria-label": "KPI grid",
+    "keyboard": [
+      "Tab moves through interactive KPI cards and any embedded actions in reading order."
+    ],
+    "announcements": [
+      "Metric label, value, and trend should be conveyed semantically and not rely on color alone."
+    ],
+    "focus_management": "If KPI cards are actionable, focused cards should receive a clear outline or selected treatment equivalent to hover."
+  },
+  "default_layout": {
+    "layout": "grid",
+    "atoms": "_grid _gc2 _lg:gc4 _gap4 _p4",
+    "slots": {
+      "kpi-card": "Repeated Card with icon, label, value, and trend Badge",
+      "icon": "Abstract icon placeholder for each KPI category",
+      "value": "Primary metric value with _heading2 styling",
+      "trend": "Change percentage Badge with positive/negative variant"
+    }
+  },
+  "io": {
+    "produces": [
+      "kpi-data"
+    ],
+    "consumes": [
+      "date-range"
+    ]
+  },
+  "layout_hints": {
+    "stat_treatment": "Each KPI uses lum-stat-glow: filled circle in accent/primary color with number inside (dark text). Label below in text-muted. Sparkline trend to the right.",
+    "animation": "Counter animation on mount — numbers count from 0 to value over 500ms.",
+    "grid": "4 columns desktop, 2 tablet, 1 mobile. Cards should breathe, but the parent workspace layout owns any gap before or after the KPI grid.",
+    "semantic_direction": "Each KPI has both a delta (numeric change) AND a semantic direction. Lower-is-better metrics (latency, error-rate, MTTR, SLO-budget-burn) should color the trend badge GREEN when value drops, RED when it rises. Higher-is-better metrics (throughput, requests/sec, uptime%, SLO-budget-remaining) get the inverse mapping. Direction-only coloring is wrong: latency dropping is a WIN, not a neutral change. Pass `lower_is_better: true` per KPI in the data shape and route the trend badge color from that flag, not from the delta sign alone.",
+    "kpi_value_unit_spacing": "Value + unit pair (e.g., \"82ms\", \"31.2k\", \"0.42%\") should use `gap: 0.25em` between number and unit — NOT the inherited container content_gap. Larger gaps make the value read as detached from its unit."
+  },
+  "composition": {
+    "KPIGrid": "Grid(d-data, responsive: 2/4-col) > KPICard[]",
+    "KPICard": "Card(d-surface, padding) > [Icon(d-annotation, rounded-bg) + Label(text-muted, text-sm) + Value(heading2, mono-data) + TrendBadge(d-annotation, variant: positive|negative)]"
+  }
+}

package/patterns/launch-update-log.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "launch-update-log",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Launch Update Log",
+  "description": "Campaign update feed for maker notes, prototype milestones, shipping updates, stretch-goal unlocks, and backer announcements.",
+  "category": "campaign",
+  "tags": [
+    "campaign",
+    "updates",
+    "changelog",
+    "launch",
+    "backers",
+    "trust"
+  ],
+  "components": [
+    "Badge",
+    "Accordion",
+    "Media",
+    "Button",
+    "Timeline"
+  ],
+  "contained": false,
+  "default_preset": "update-console",
+  "presets": {
+    "update-console": {
+      "description": "Console-like update feed with pinned latest update, category filters, and expandable entries.",
+      "components": [
+        "Badge",
+        "Accordion",
+        "Media",
+        "Button",
+        "Timeline"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gap5 _wfull _maxw[72rem] _mx[auto]",
+        "slots": {
+          "pinned-update": "Latest or critical campaign update highlighted at top.",
+          "filter-strip": "All, prototype, funding, shipping, stretch goals, press, and backer notes.",
+          "update-entry": "Date, category, title, summary, media, and expandable body.",
+          "subscribe-action": "Follow updates, email, RSS, or share action."
+        }
+      }
+    },
+    "shipping-log": {
+      "description": "Fulfillment-focused update log with manufacturing stages, shipping windows, risks, and resolved issues.",
+      "components": [
+        "Badge",
+        "Accordion",
+        "Timeline"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4 _wfull _maxw[58rem] _mx[auto]",
+        "slots": {
+          "status-summary": "Current fulfillment status.",
+          "update-entry": "Shipping or production update entry.",
+          "risk-note": "Known risks and mitigation notes."
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "grid",
+    "atoms": "_grid _gap5 _wfull _maxw[72rem] _mx[auto]",
+    "slots": {
+      "pinned-update": "Latest campaign update",
+      "filter-strip": "Update category controls",
+      "update-entry": "Expandable campaign update",
+      "subscribe-action": "Follow or share updates"
+    }
+  },
+  "visual_brief": "A trustworthy campaign update log with retro console styling. It should make progress, blockers, and decisions easy to scan. Pinned updates and shipping/production notes should be factual and visible. Avoid turning updates into anonymous blog cards.",
+  "responsive": {
+    "mobile": "Single-column update feed with category filter as segmented scroll row.",
+    "tablet": "Pinned update plus feed below.",
+    "desktop": "Pinned latest update alongside filter/status rail, with feed entries below or beside."
+  },
+  "layout_hints": {
+    "trust": "Updates should distinguish shipped, in-progress, delayed, and unlocked states.",
+    "filtering": "Categories should support campaign-specific concerns like prototype, funding, shipping, and stretch goals.",
+    "media": "Use photos/screenshots for evidence where available."
+  },
+  "motion": {
+    "micro": {
+      "filter": "selected filter snaps into active state",
+      "expand": "update body expands with short height transition"
+    }
+  },
+  "interactions": [
+    "click-select",
+    "hover-reveal",
+    "animate-on-mount",
+    "keyboard-navigation"
+  ],
+  "composition": {
+    "LaunchUpdateLog": "Section > [PinnedUpdate + FilterStrip + UpdateEntry[] + SubscribeAction?]",
+    "UpdateEntry": "Entry > [Date + CategoryBadge + Title + Summary + Media? + BodyToggle]",
+    "FilterStrip": "SegmentedControl > CategoryButton[]"
+  },
+  "accessibility": {
+    "role": "feed",
+    "aria-label": "Campaign updates",
+    "keyboard": [
+      "Filter buttons should be reachable and expose selected state.",
+      "Expandable updates should use button semantics."
+    ],
+    "announcements": [
+      "Filtered updates by {category}.",
+      "Expanded update {title}."
+    ]
+  },
+  "io": {
+    "consumes": [
+      "campaign-updates",
+      "fulfillment-status"
+    ],
+    "produces": [
+      "update-engagement"
+    ],
+    "actions": [
+      "filter-updates",
+      "expand-update",
+      "subscribe-updates"
+    ]
+  }
+}

package/patterns/launchpad-flow.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "launchpad-flow",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Launchpad Flow",
+  "description": "Guided sequence that shows how a builder moves from selecting a Decantr blueprint to initializing, refreshing, checking, and iterating with AI-ready context.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Badge",
+        "CodeBlock",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Badge",
+    "CodeBlock",
+    "icon"
+  ],
+  "contained": false,
+  "default_preset": "steps",
+  "presets": {
+    "steps": {
+      "description": "Four-step horizontal or stacked flow: Choose, Initialize, Refresh, Verify. Each step carries a compact command or artifact reference.",
+      "components": [
+        "Card",
+        "Badge",
+        "CodeBlock",
+        "icon"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gc1 _lg:gc4 _gap4",
+        "slots": {
+          "step-number": "Number or icon marker.",
+          "step-title": "Action-oriented step heading.",
+          "step-command": "Optional CLI command or file artifact.",
+          "step-proof": "Short note about what changes after this step."
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "grid",
+    "atoms": "_grid _gc1 _lg:gc4 _gap4",
+    "slots": {
+      "step-number": "Number or icon marker",
+      "step-title": "Step heading",
+      "step-command": "CLI command or artifact",
+      "step-proof": "Outcome note"
+    }
+  },
+  "visual_brief": "A crisp operational flow that makes Decantr feel immediately usable. The sequence should look like a product workflow, not a tutorial wall. Use clear step labels, small command blocks, and simple connective rhythm so users understand the path from registry choice to verified project health.",
+  "responsive": {
+    "mobile": "Stack steps vertically with compact command blocks and visible step numbers.",
+    "tablet": "Two-column grid for four steps.",
+    "desktop": "Four-column flow with subtle connectors or aligned step markers."
+  },
+  "layout_hints": {
+    "step_count": "Use three to five steps. If more detail is needed, move it into an expandable or docs link outside the core flow.",
+    "commands": "Commands should be short and copyable. Avoid large code blocks inside this pattern.",
+    "outcomes": "Every step should state the artifact or confidence it creates: essence, context, health report, or remediation prompt."
+  },
+  "motion": {
+    "micro": "Step cards can highlight in sequence on hover or focus.",
+    "transitions": "Initial reveal may stagger from first step to last over 200-320ms."
+  },
+  "interactions": [
+    "stagger-children",
+    "animate-on-mount",
+    "click-select",
+    "keyboard-navigation"
+  ],
+  "accessibility": {
+    "role": "list",
+    "aria-label": "Launchpad workflow",
+    "keyboard": [
+      "Copyable commands and links should be focusable without trapping users in the flow."
+    ],
+    "announcements": [
+      "Expose each step number, title, command, and outcome in source order."
+    ],
+    "focus_management": "Focused steps should show the same state as hover and should not depend on connector visuals."
+  },
+  "composition": {
+    "LaunchpadFlow": "OrderedList > LaunchpadStep[]",
+    "LaunchpadStep": "Card > [Marker + Title + CommandSnippet? + Outcome]",
+    "CommandSnippet": "CodeBlock(compact, copyable)"
+  },
+  "io": {
+    "consumes": [],
+    "produces": [
+      "workflow-understanding"
+    ],
+    "actions": [
+      "command-copy",
+      "docs-click"
+    ]
+  }
+}

package/patterns/leaderboard.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "leaderboard",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Leaderboard",
+  "description": "Ranked list of items with position, avatar, name, and score. Supports spotlight, ranked, and grid presets.",
+  "tags": [
+    "gaming",
+    "ranking",
+    "scores",
+    "competition",
+    "social"
+  ],
+  "classification": {
+    "triggers": [
+      "leaderboard",
+      "ranking",
+      "top players",
+      "high scores",
+      "standings"
+    ],
+    "tier": "recommended"
+  },
+  "components": ["Card", "Badge", "Avatar", "Text", "icon"],
+  "default_preset": "ranked",
+  "presets": {
+    "spotlight": {
+      "description": "Top 3 highlighted with large cards, rest in compact list",
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gap4 _md:gc3",
+        "slots": {
+          "top": "Top-three ranked entries rendered as large spotlight cards",
+          "rest": "Remaining entries rendered below as a compact ranked list"
+        }
+      }
+    },
+    "ranked": {
+      "description": "Full ranked list with position numbers and progress indicators",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap2",
+        "slots": {
+          "items": "Dense ordered list of ranked entries with position, avatar, name, score, and optional delta"
+        },
+        "style": "numbered-list",
+        "showChange": true
+      }
+    },
+    "grid": {
+      "description": "Card grid for achievements or badges display",
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gap4 _sm:gc2 _xl:gc3",
+        "slots": {
+          "items": "Ranked entries rendered as achievement cards with badge, avatar, name, and score"
+        },
+        "style": "grid",
+        "columns": 3
+      }
+    }
+  },
+  "slots": {
+    "position": {
+      "type": "number",
+      "required": true
+    },
+    "avatar": {
+      "type": "image",
+      "required": false
+    },
+    "name": {
+      "type": "text",
+      "required": true
+    },
+    "score": {
+      "type": "number",
+      "required": true
+    },
+    "change": {
+      "type": "delta",
+      "required": false
+    },
+    "badge": {
+      "type": "image",
+      "required": false
+    }
+  },
+  "layout": {
+    "container": "section",
+    "header": [
+      "title",
+      "filter?"
+    ],
+    "body": [
+      "items"
+    ],
+    "footer": [
+      "pagination?",
+      "view-all?"
+    ]
+  },
+  "visual_brief": "Ranked vertical list where each row shows a position number (with gold/silver/bronze styling for top 3), a user avatar, display name, and a numeric score on the right. Top-three items in the spotlight preset are enlarged with medal icons and a subtle glow or card treatment. The ranked preset is a dense list with alternating row shading. Grid preset arranges entries as cards in a responsive grid with position badge, avatar, name, and score. Position changes show up/down arrows with green/red coloring.",
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _gap2",
+    "slots": {
+      "items": "Dense ordered list of ranked entries with position, avatar, name, score, and optional delta"
+    }
+  },
+  "responsive": {
+    "mobile": "Single-column list. Spotlight cards stack vertically. Avatars reduce to 32px. Score values right-aligned.",
+    "tablet": "Spotlight top-3 in a horizontal row, remaining entries in a list below. Grid preset uses 2 columns.",
+    "desktop": "Spotlight top-3 prominently displayed. Full list with generous spacing. Grid preset uses 3-4 columns."
+  },
+  "layout_hints": {
+    "rank_priority": "Position and score should be the first read, with avatar and display name supporting that ranking hierarchy.",
+    "spotlight_role": "Top entries may receive stronger treatment, but the ranked list should still feel like one coherent leaderboard rather than two disconnected components.",
+    "delta_signal": "Rank movement indicators should support the ranking read without becoming more visually prominent than the score itself."
+  },
+  "motion": {
+    "micro": "Hovered rows or cards may sharpen slightly, and rank-change indicators may brighten enough to confirm movement.",
+    "transitions": "Sorting or live rank updates should preserve orientation so users can follow position changes without the board feeling unstable."
+  },
+  "interactions": [
+    "drag-reorder",
+    "click-select",
+    "animate-on-mount",
+    "stagger-children",
+    "scroll-reveal"
+  ],
+  "accessibility": {
+    "role": "list",
+    "aria-label": "Leaderboard",
+    "keyboard": [
+      "If entries are interactive, focus should move rank by rank in reading order."
+    ],
+    "announcements": [
+      "Rank, player or team name, score, and movement should be exposed semantically so leaderboard meaning does not depend on medal colors or layout treatment alone."
+    ]
+  }
+}