@decantr/content 3.8.0

package/patterns/waveform-track.json

@@ -0,0 +1,102 @@
+{
+  "id": "waveform-track",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Waveform Track",
+  "description": "Audio waveform track displaying regions, automation lanes, gain control, and beat grid for DAW-style audio editing interfaces.",
+  "category": "music",
+  "tags": ["2026", "music", "audio", "waveform", "daw", "track", "editor"],
+  "components": ["WaveformCanvas", "RegionBlock", "AutomationLane", "GainSlider", "TrackHeader", "MuteSolo"],
+  "default_preset": "track",
+  "presets": {
+    "track": {
+      "description": "Single horizontal track row with header controls and waveform area, suitable for track lists in multi-track editors and timeline views",
+      "layout": {
+        "layout": "flex",
+        "atoms": "_flex _flex-row _items-stretch _w-full _bg-surface _border-b"
+      }
+    },
+    "stem": {
+      "description": "Multi-stem stacked variant showing multiple related audio stems within a single track group with shared transport for stem editing workflows",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _flex-col _gap-1 _w-full _bg-surface _border-b"
+      }
+    },
+    "minimal": {
+      "description": "Compact waveform without automation lanes, ideal for preview tracks, inspection panels, and read-only playback interfaces",
+      "layout": {
+        "layout": "flex",
+        "atoms": "_flex _flex-row _items-stretch _w-full _bg-surface-muted _h-16"
+      }
+    }
+  },
+  "visual_brief": "A horizontal track row approximately 96px tall (track preset). Track header on the left (160px fixed width) contains: track name in semibold 13px, mute/solo/arm circular buttons (24px each) in a row, and a horizontal gain slider with dB value display. Track header has subtle border-right separating it from the waveform. Waveform canvas fills remaining horizontal space rendering symmetrical amplitude envelope: mirrored above and below horizontal centerline in accent color (e.g. blue for audio, green for synth), against a muted background. Regions appear as colored semi-transparent rectangles overlaid on the waveform with 2px colored borders and clip names in 11px text at top-left. Beat grid lines run vertically through the waveform at BPM-synced intervals (1px, subtle muted color, brighter on bar lines). Automation lanes (optional, 32px tall each) stack below the main waveform showing parameter curves (volume, pan) as line graphs with draggable node points. Hovering on the waveform shows a vertical playhead indicator and timecode tooltip.",
+  "default_layout": {
+    "layout": "flex",
+    "atoms": "_flex _flex-row _items-stretch _w-full _bg-surface _border-b",
+    "slots": {
+      "track-header": "Fixed-width (160px) column on left containing track name, mute/solo/arm buttons, and gain slider with dB readout. Subtle border separates from waveform.",
+      "track-name": "Editable label at top of header in semibold 13px type. Click-to-rename.",
+      "mute-solo-arm": "Row of 3 circular toggle buttons (24px each): M (mute), S (solo), R (record arm). Active states color-coded.",
+      "gain-slider": "Horizontal slider with dB value display. Range -inf to +6dB. Shows current value in monospace text.",
+      "waveform-canvas": "Main horizontal area rendering symmetrical amplitude waveform. Fills remaining width. Supports zoom via timeline controls.",
+      "region-block": "Colored rectangle overlay representing an audio clip/region. Has clip name, trim handles at edges, fade-in/fade-out curves at corners.",
+      "automation-lane": "Optional 32px tall lane below waveform showing parameter automation as line graph with draggable nodes.",
+      "beat-grid": "Vertical grid lines at BPM-synced intervals. Bar lines brighter than beat lines."
+    }
+  },
+  "responsive": {
+    "mobile": "Track header collapses to 64px with icon-only controls. Gain slider becomes popover. Automation lanes hidden; toggle to view. Waveform height reduces to 56px.",
+    "tablet": "Standard layout with condensed track name. Full mute/solo/arm visible.",
+    "desktop": "Full 96px track with all automation lanes expanded and hover interactions."
+  },
+  "motion": {
+    "micro": {
+      "mute-solo-toggle": "button color transition 150ms + ripple on click",
+      "gain-drag": "slider follows pointer at 60fps with real-time dB update"
+    },
+    "transitions": {
+      "region-add": "region scale-in + fade 200ms spring",
+      "automation-node-drag": "curve reshape 16ms per frame during drag"
+    },
+    "ambient": {
+      "active-playback": "vertical playhead line moves continuously across waveform at playback rate",
+      "armed-recording-pulse": "arm button red pulse 1s ease-in-out infinite when recording"
+    }
+  },
+  "interactions": [
+    "animate-on-mount",
+    "inline-edit",
+    "keyboard-navigation"
+  ],
+  "composition": {
+    "WaveformTrack": "Root(d-surface, flex-row) > [TrackHeader + WaveformArea]",
+    "TrackHeader": "Column(d-control) > [TrackName + MuteSoloArm + GainSlider]",
+    "WaveformArea": "Container > [WaveformCanvas + RegionBlock* + BeatGrid + AutomationLane*]",
+    "RegionBlock": "Overlay(absolute, d-interactive) > [ClipName + TrimHandles + FadeCurves]"
+  },
+  "layout_hints": {
+    "timeline_priority": "Track controls should stay subordinate to the waveform timeline so clip timing, regions, and automation remain the primary editing signal.",
+    "header_density": "Mute, solo, arm, and gain controls should feel compact and studio-like without stealing horizontal space from the editable waveform canvas.",
+    "automation_attachment": "Automation lanes should feel structurally attached to the parent track and preserve timing alignment with the waveform above."
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Audio track",
+    "announcements": [
+      "Track {name} gain set to {value} dB",
+      "Track {name} {muted|soloed|armed}",
+      "Region {name} added at {timestamp}"
+    ],
+    "keyboard": [
+      "M: toggle mute on focused track",
+      "S: toggle solo on focused track",
+      "R: toggle record-arm on focused track",
+      "Up/Down: adjust gain 1dB",
+      "Shift+Up/Down: adjust gain 0.1dB",
+      "Delete: remove focused region"
+    ]
+  }
+}

package/patterns/webhook-debugger.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "webhook-debugger",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Webhook Debugger",
+  "description": "Webhook delivery log with payload inspection, header viewing, status timeline, and retry controls for diagnosing integration failures.",
+  "category": "developer",
+  "tags": [
+    "2026",
+    "developer",
+    "webhook",
+    "debugging",
+    "api",
+    "integration",
+    "logs"
+  ],
+  "components": [
+    "DeliveryLog",
+    "DeliveryRow",
+    "PayloadViewer",
+    "HeadersTable",
+    "RetryButton",
+    "StatusTimeline",
+    "EndpointFilter"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full delivery log with expandable detail panel showing payload, headers, and status timeline per delivery",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4 _py4 _w-full"
+      }
+    },
+    "compact": {
+      "description": "Dense table-only view with status badges and inline retry buttons — no expandable detail, optimized for high-volume scanning",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap1 _py2 _w-full _mono"
+      }
+    },
+    "live": {
+      "description": "Streaming log that auto-scrolls to the latest delivery as webhooks arrive in real time with slide-in animation and a pulsing live indicator",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3 _py4 _overflow-y-auto _w-full"
+      }
+    }
+  },
+  "visual_brief": "Table listing webhook deliveries with columns: timestamp (muted monospace), endpoint URL (truncated with tooltip on hover), event type as a small pill label (e.g. 'invoice.paid', 'customer.created'), status badge (delivered = green filled pill with checkmark, failed = red filled pill with X icon, pending = yellow outlined pill with spinner), response time in milliseconds (green if <500ms, yellow if 500-2000ms, red if >2000ms), and a retry icon button on the far right. Each row is separated by a 1px border. Hovering a row highlights it with a subtle surface tint. Clicking a row expands an inline detail panel below it: the panel has three tabbed sections. First tab 'Request' shows request headers as a two-column key-value table and request body as syntax-highlighted JSON with line numbers in a monospace code block. Second tab 'Response' shows response status code as a large colored badge (2xx green, 4xx yellow, 5xx red), response headers table, and response body (syntax-highlighted). Third tab 'Timeline' shows a horizontal status timeline: sent timestamp with arrow, received timestamp with arrow, processed timestamp, each connected by a thin line with duration labels above. Failed deliveries have a red-tinted background row (rgba red at 0.05). The EndpointFilter sits above the table as a dropdown or multi-select chip row. Live preset adds a green pulsing dot labeled 'Live' in the top-right corner, and new rows slide in from the top with a fade-slide animation and briefly flash with an accent highlight before settling.",
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _gap4 _py4 _w-full",
+    "slots": {
+      "filter-bar": "A row above the table containing the EndpointFilter dropdown (multi-select for filtering by endpoint URL), an event type filter dropdown, a status filter (all/delivered/failed/pending toggle chips), and a date range picker. Active filters show as removable chips below the filter row.",
+      "delivery-table": "The main data table with a sticky header row showing column labels: Timestamp, Endpoint, Event, Status, Response Time, Actions. Each DeliveryRow renders one webhook delivery as a table row. Rows are sorted by timestamp descending (newest first). The table supports infinite scroll or pagination at the bottom. Alternating row backgrounds at very subtle opacity for scannability.",
+      "delivery-detail": "An expandable panel that appears inline below a clicked DeliveryRow. Contains three tabs: Request (headers table + JSON body viewer), Response (status badge + headers + body), and Timeline (horizontal step indicator showing sent/received/processed with timestamps and durations). The panel has a slightly inset background and a colored left border matching the delivery status. A 'Retry' button sits in the top-right corner of the detail panel. Close button (X) in the top-right dismisses the detail."
+    }
+  },
+  "responsive": {
+    "mobile": "Table switches to card layout — each delivery renders as a stacked card showing status badge, event type, endpoint (truncated), and timestamp. Tap opens detail as a bottom sheet. Filter bar collapses to a single filter icon button that opens a drawer.",
+    "tablet": "Table layout maintained with horizontal scroll if needed. Detail panel opens inline below the row. Filter bar fully visible.",
+    "desktop": "Full table with all columns visible without scroll. Detail panel opens inline with comfortable width. Filter bar displays all controls in a single row."
+  },
+  "motion": {
+    "micro": {
+      "row-hover": "background-color surface-hover 120ms ease-out",
+      "retry-press": "scale(0.95) 100ms ease-in + rotate(360deg) 600ms ease-out on trigger",
+      "status-badge-pulse": "opacity 0.7→1 200ms ease-out on status change"
+    },
+    "transitions": {
+      "detail-expand": "max-height 0→auto + opacity 0→1 300ms ease-out",
+      "detail-collapse": "max-height auto→0 + opacity 1→0 200ms ease-in",
+      "new-delivery-slide": "translateY(-20px)→0 + opacity 0→1 400ms ease-out"
+    },
+    "ambient": {
+      "live-indicator-pulse": "scale(1→1.4→1) + opacity(1→0.5→1) 2s ease-in-out infinite",
+      "pending-spinner": "rotate(0→360deg) 1s linear infinite"
+    }
+  },
+  "interactions": [
+    "animate-on-mount"
+  ],
+  "composition": {
+    "WebhookDebugger": "Container(d-section, flex-col) > [EndpointFilter(d-control) + DeliveryLog(d-data)]",
+    "DeliveryLog": "Table(d-data, sortable, scrollable) > DeliveryRow(d-row, expandable)[]",
+    "DeliveryRow": "Row(d-interactive, hover-highlight, status-tint: failed→red) > [Timestamp(mono-data) + Endpoint(truncate) + EventType(d-annotation, pill) + StatusBadge(d-annotation, color: status) + ResponseTime(mono-data, color: threshold) + RetryButton(d-interactive, icon-only)]",
+    "DeliveryDetail": "Panel(d-surface, inset, border-left: status-color, tabbed) > [RequestTab > [HeadersTable(d-data) + PayloadViewer(d-data, syntax-highlight: json)] + ResponseTab > [StatusCode(d-annotation, large) + HeadersTable + PayloadViewer] + TimelineTab > StatusTimeline(d-data, horizontal-steps)]",
+    "StatusTimeline": "Row(d-data) > TimelineStep(d-annotation, connected-by-line)[]"
+  },
+  "layout_hints": {
+    "delivery_priority": "Delivery state and endpoint identity should be visible before expanded payload detail. The row list is the primary operational surface; request/response panes are secondary inspection layers.",
+    "detail_paneling": "Expanded request, response, and timeline views should remain clearly tied to the active delivery row so debugging context is never lost.",
+    "live_mode": "When new deliveries stream in, preserve row stability and status visibility rather than letting the list jump around unpredictably."
+  },
+  "accessibility": {
+    "role": "table",
+    "aria-label": "Webhook delivery log with payload inspection",
+    "keyboard": [
+      "Arrow Up/Down: navigate between delivery rows",
+      "Enter: expand/collapse delivery detail for the focused row",
+      "Tab: move between detail tabs (Request, Response, Timeline)",
+      "R: retry the focused delivery",
+      "F: focus the filter bar",
+      "Escape: close expanded detail panel"
+    ],
+    "announcements": [
+      "Delivery {event_type} to {endpoint}: {status}",
+      "Detail panel expanded for delivery at {timestamp}",
+      "Retry triggered for delivery {id}",
+      "Filter applied: showing {filter_description}",
+      "New delivery received: {event_type} — {status}"
+    ]
+  }
+}

package/patterns/workflow-canvas.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "workflow-canvas",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Workflow Canvas",
+  "description": "Visual node-graph editor for business logic, ETL pipelines, or automation flows. Provides an infinite pannable canvas with draggable nodes, bezier-curve edges, a minimap, toolbar, node palette sidebar, and property panel for configuring selected elements.",
+  "category": "builder",
+  "tags": [
+    "2026",
+    "builder",
+    "workflow",
+    "node-graph",
+    "automation",
+    "visual-editor",
+    "ETL",
+    "canvas",
+    "drag-and-drop"
+  ],
+  "components": [
+    "Canvas",
+    "Node",
+    "NodePort",
+    "Edge",
+    "Minimap",
+    "Toolbar",
+    "PropertyPanel",
+    "NodePalette"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full node-graph editor with draggable nodes, bezier edges, toolbar, node palette sidebar, minimap, and property panel",
+      "layout": {
+        "layout": "row",
+        "atoms": "_flex _row _h-full _w-full _overflow-hidden"
+      }
+    },
+    "compact": {
+      "description": "Compact mode with smaller mini-nodes (icon + label only, no body), hidden palette, and minimal toolbar — suited for embedded or preview contexts",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_relative _h-full _w-full _overflow-hidden"
+      }
+    },
+    "readonly": {
+      "description": "Presentation mode with all editing disabled — nodes and edges render normally but cannot be moved, connected, or deleted; ideal for sharing or documentation",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_relative _h-full _w-full _overflow-hidden _pointer-events-auto"
+      }
+    }
+  },
+  "visual_brief": "Full-viewport canvas area with a subtle dot-grid background (dots are 1px circles at 20px intervals, color muted at 15% opacity). The canvas supports infinite pan (click-drag on background) and zoom (scroll wheel, range 25%-400%). Nodes are rounded-rectangle cards (min 160px wide, 80px tall) with a 4px colored top stripe indicating node type: blue for triggers, green for actions, yellow for conditions, gray for transforms. Each node has a white/surface background, 8px border-radius, and subtle shadow (0 2px 8px rgba(0,0,0,0.1)). Node interior shows an icon and type label in the colored header area, and a body area with the node's configured name or a brief description. Input ports sit on the left edge and output ports on the right edge of each node — they are 10px diameter circles with a 2px border in the node's type color, filled white by default. On hover, ports glow with the type color and scale to 12px. Dragging from a port draws a temporary bezier curve following the cursor. Edges are smooth cubic bezier curves connecting output ports to input ports. Edge stroke is 2px in muted gray, with animated dashes (4px dash, 4px gap) flowing in the data direction at a steady speed. Selected edges turn accent color. Selected nodes gain a 2px accent border glow and slight elevation increase. Multi-select by shift-click or rubber-band drag. The Toolbar sits at the top of the canvas as a horizontal bar with icon buttons: zoom in, zoom out, fit-to-view, undo, redo, delete selected, and a toggle for snap-to-grid. The NodePalette is a 240px wide left sidebar listing available node types grouped by category (Triggers, Actions, Conditions, Transforms), each showing icon + label. Nodes are added by dragging from the palette onto the canvas. The PropertyPanel is a 280px right sidebar that appears when a node is selected, showing editable fields for the node's configuration (name, parameters, description). The Minimap sits in the bottom-right corner as a 160x100px translucent panel showing a zoomed-out view of the entire graph with a viewport indicator rectangle. Clicking the minimap pans the canvas to that location.",
+  "default_layout": {
+    "layout": "row",
+    "atoms": "_flex _row _h-full _w-full _overflow-hidden",
+    "slots": {
+      "node-palette": "Left sidebar (240px wide) listing draggable node types grouped by category (Triggers, Actions, Conditions, Transforms). Each entry is a small card with the type icon, label, and a brief description. Dragging an entry onto the canvas creates a new node of that type at the drop position. The palette has a search input at the top for filtering node types. Collapsible category sections with chevron toggles.",
+      "toolbar": "Horizontal bar spanning the top of the canvas area. Contains icon buttons: zoom in (+), zoom out (-), fit-to-view (frame icon), undo (arrow-left), redo (arrow-right), delete selected (trash), snap-to-grid toggle, and a zoom percentage display. Buttons are 32px square with ghost styling. Separator lines between button groups.",
+      "canvas-area": "The main infinite-scroll pannable area with dot-grid background. Contains all Node and Edge elements. Supports pan (drag background), zoom (scroll wheel), rubber-band selection (shift+drag), and node placement (drop from palette). Coordinate system is world-space; the viewport transforms via CSS translate/scale.",
+      "node": "Repeating slot — one per workflow step. A rounded card (min 160x80px) with colored top stripe (4px, color by type). Header row: type icon + type label. Body: node name or configured description. Left edge: input NodePort circles. Right edge: output NodePort circles. Selected state: accent border glow + elevated shadow. Draggable to reposition.",
+      "edge": "Repeating slot — one per connection. A cubic bezier SVG path connecting an output port to an input port. Stroke: 2px muted gray with animated dashes flowing in data direction. Selected: accent color. Hover: stroke widens to 3px. Click to select. Delete key removes selected edge.",
+      "minimap": "Bottom-right corner panel (160x100px, rounded-lg, semi-transparent background). Shows a scaled-down view of the entire graph with all nodes as tiny colored rectangles and edges as thin lines. A translucent rectangle indicates the current viewport bounds. Click or drag within the minimap to pan the main canvas.",
+      "property-panel": "Right sidebar (280px wide) that slides in when a node is selected. Shows the node's type, icon, and editable configuration fields (name text input, parameter key-value pairs, description textarea, port configuration). Save/apply changes in real time. Close button or deselect to hide."
+    }
+  },
+  "accessibility": {
+    "role": "application",
+    "aria-label": "Workflow canvas editor",
+    "announcements": [
+      "Node {name} added at position {x}, {y}",
+      "Node {name} selected — {input_count} inputs, {output_count} outputs",
+      "Edge connected: {source_node} to {target_node}",
+      "Edge removed between {source_node} and {target_node}",
+      "Canvas zoomed to {zoom_percent}%",
+      "Undo: {action_description}",
+      "Redo: {action_description}",
+      "{count} nodes selected"
+    ],
+    "keyboard": [
+      "Tab: cycle focus between toolbar, palette, canvas nodes, and property panel",
+      "Arrow keys: move selected node by grid increment (or pan canvas if no selection)",
+      "Delete/Backspace: remove selected nodes or edges",
+      "Ctrl+Z / Cmd+Z: undo last action",
+      "Ctrl+Shift+Z / Cmd+Shift+Z: redo",
+      "Ctrl+A / Cmd+A: select all nodes",
+      "Escape: deselect all and close property panel",
+      "Space+drag: pan canvas regardless of pointer location",
+      "+/-: zoom in/out",
+      "Ctrl+0: fit to view"
+    ]
+  },
+  "responsive": {
+    "mobile": "Canvas is touch-pannable with two-finger scroll and pinch-to-zoom. Node palette hidden behind a floating '+' button that opens a bottom sheet. Toolbar collapses to a floating action menu. Property panel opens as a bottom sheet. Minimap hidden. Nodes use minimum 44px touch targets for ports.",
+    "tablet": "Canvas supports touch pan and pinch zoom. Node palette as a collapsible left drawer (swipe from left edge). Toolbar remains at top. Property panel as a right drawer. Minimap visible in bottom-right. Port touch targets 36px minimum.",
+    "desktop": "Full layout with persistent palette sidebar (collapsible), toolbar, minimap, and property panel. Mouse drag to pan, scroll to zoom. Hover states on ports and edges. Keyboard shortcuts fully active. Rubber-band multi-select with click-drag on empty canvas."
+  },
+  "layout_hints": {
+    "canvas_priority": "The graph itself is the primary surface. Palette, toolbar, minimap, and property panel should support composition and inspection without competing with node readability.",
+    "node_hierarchy": "Node identity and connection points should be readable before configuration details. The property panel is where deeper editing belongs.",
+    "panel_rhythm": "Palette and property panel should feel like contextual side tools around one shared canvas, not like two separate applications framing it."
+  },
+  "layout_hints": {
+    "canvas_priority": "The graph itself is the primary surface. Palette, toolbar, minimap, and property panel should support composition and inspection without competing with node readability.",
+    "node_hierarchy": "Node identity and connection points should be readable before configuration details. The property panel is where deeper editing belongs.",
+    "panel_rhythm": "Palette and property panel should feel like contextual side tools around one shared canvas, not like two separate applications framing it."
+  },
+  "motion": {
+    "micro": {
+      "port-hover": "scale(1→1.2) + glow(type-color) 150ms ease-out on port hover",
+      "node-hover": "shadow elevation increase 150ms ease-out",
+      "toolbar-button-press": "scale(0.92) 80ms ease-in"
+    },
+    "transitions": {
+      "node-drop": "scale(0.8→1) + opacity 0→1 250ms cubic-bezier(0.34, 1.56, 0.64, 1) when dropped from palette",
+      "node-delete": "scale(1→0.8) + opacity 1→0 200ms ease-in",
+      "edge-draw": "bezier path animates in real-time following cursor during connection drag",
+      "palette-toggle": "width 240px↔0 + opacity 300ms ease-in-out",
+      "property-panel-enter": "translateX(280px)→translateX(0) 250ms ease-out",
+      "property-panel-exit": "translateX(0)→translateX(280px) 200ms ease-in",
+      "fit-to-view": "viewport transform (translate + scale) 500ms ease-in-out"
+    },
+    "ambient": {
+      "edge-flow": "stroke-dashoffset animation creating flowing dashes in data direction, 1s linear infinite per edge",
+      "dot-grid-breathe": "subtle opacity oscillation 0.1→0.15 on dot grid, 4s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "drag-nodes",
+    "pan-background",
+    "zoom-scroll",
+    "click-select",
+    "hover-tooltip",
+    "animate-on-mount"
+  ],
+  "composition": {
+    "Canvas": "Section(d-section, infinite-pan, dot-grid-bg) > [Toolbar(d-surface, sticky-top) + NodePalette?(d-surface, left-sidebar)] + Node*(d-interactive) > [NodeHeader(color-stripe: type) + NodeBody? + NodePort*(left|right)] + Edge*(svg-bezier, animated-dash) + Minimap(d-surface, bottom-right)",
+    "Node": "Card(d-interactive, draggable, rounded-lg, shadow, border-top: type-color) > [Header(icon + label) + Body?(name + description) + InputPorts(left-edge) + OutputPorts(right-edge)]",
+    "NodePort": "Circle(d-interactive, 10px, border: type-color, glow-on-hover, connectable)",
+    "Edge": "BezierPath(svg, stroke: 2px, dash-animated, direction: source→target)",
+    "Toolbar": "Row(d-surface, sticky, gap-2) > IconButton(ghost, 32px)[]",
+    "NodePalette": "Sidebar(d-surface, w-240, collapsible) > [SearchInput + CategoryGroup* > DraggableNodeType*]",
+    "PropertyPanel": "Sidebar(d-surface, w-280, slide-in-right) > [NodeTypeHeader + ConfigFields + PortConfig]",
+    "Minimap": "Panel(d-surface, fixed-bottom-right, 160x100, semi-transparent) > [ScaledGraph + ViewportRect]"
+  }
+}

package/patterns/workspace-region-stack.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "workspace-region-stack",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Workspace Region Stack",
+  "description": "Internal dashboard/workspace layout primitive for stacking multiple panels, grids, or empty states inside a single labeled section without relying on d-section to create child spacing.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Comfortable vertical stack for grouping multiple surfaces or data regions inside one section label.",
+      "components": [
+        "Card"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4 _w[100%]",
+        "slots": {
+          "region-child": "Any child panel, grid, card group, or empty state that should maintain a stable vertical gap from the next child"
+        }
+      }
+    },
+    "compact": {
+      "description": "Slightly tighter stack for denser operator workspaces while preserving explicit child spacing.",
+      "components": [
+        "Card"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3 _w[100%]",
+        "slots": {
+          "region-child": "Compact child panel, grid, card group, or empty state"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _gap4 _w[100%]",
+    "slots": {
+      "region-child": "Stacked workspace children"
+    }
+  },
+  "visual_brief": "A quiet structural primitive, not a visible widget. It exists to preserve clear x- and y-axis rhythm between multiple blocks that belong inside the same dashboard section. Think of it as the section's internal cadence: label first, then a measured stack of grids, surfaces, forms, summaries, or empty states. It should prevent collisions without adding its own decorative treatment.",
+  "responsive": {
+    "mobile": "Maintain explicit vertical gaps between children even when grids collapse or cards stack. Never depend on child margin hacks.",
+    "tablet": "Preserve the same region ordering and stable spacing while allowing children to reflow responsively.",
+    "desktop": "Use a comfortable but restrained vertical cadence so dense dashboard surfaces still feel organized."
+  },
+  "layout_hints": {
+    "ownership": "This pattern owns vertical spacing between sibling regions inside one section. Parent d-section still owns outer section padding and section-to-section rhythm.",
+    "section_role": "Use this when a single section label introduces multiple children such as a KPI grid followed by a summary card, or a filter panel followed by results.",
+    "anti_pattern": "Do not place multiple unwrapped sibling panels directly under a d-section and expect d-section to create child spacing. That responsibility belongs here."
+  },
+  "interactions": [
+    "animate-on-mount"
+  ],
+  "composition": {
+    "WorkspaceRegionStack": "Stack(d-data, full-width) > RegionChild[]"
+  }
+}

package/schemas/archetype.v2.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/archetype.v2.json",
+  "title": "Decantr Archetype",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "role",
+    "version",
+    "name",
+    "description",
+    "tags",
+    "pages",
+    "features"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/archetype.v2.json"
+    },
+    "id": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "version": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "decantr_compat": {
+      "type": "string"
+    },
+    "name": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "description": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "tags": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "role": {
+      "enum": [
+        "primary",
+        "gateway",
+        "public",
+        "auxiliary"
+      ]
+    },
+    "pages": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "default_layout",
+          "shell"
+        ],
+        "properties": {
+          "id": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          "shell": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          "description": {
+            "type": "string"
+          },
+          "patterns": {
+            "type": "array",
+            "items": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/patternReference"
+            }
+          },
+          "default_layout": {
+            "type": "array",
+            "items": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/layoutItem"
+            }
+          },
+          "directives": {
+            "type": "array",
+            "description": "Per-page execution directives. Propagated to essence.blueprint.sections[].pages[].directives and rendered into the page-pack markdown.",
+            "items": { "type": "string", "minLength": 1 }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "features": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "directives": {
+      "type": "array",
+      "description": "Section-level execution directives. Propagated to essence.blueprint.sections[].directives and rendered into the section-pack markdown.",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "navigation_items": {
+      "type": "array",
+      "description": "Items rendered in the shell's primary navigation when this archetype is composed as a section. Propagated to essence.blueprint.sections[].navigation_items.",
+      "items": {
+        "type": "object",
+        "required": ["label", "route"],
+        "additionalProperties": false,
+        "properties": {
+          "label": { "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString" },
+          "route": { "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString" },
+          "icon": { "type": "string", "minLength": 1 },
+          "hotkey": { "type": "string", "minLength": 1 },
+          "active_match": { "type": "string", "minLength": 1 },
+          "badge": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    },
+    "seo_hints": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/seoHints"
+    },
+    "classification": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/classification"
+    },
+    "page_briefs": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+    },
+    "suggested_theme": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/suggestedTheme"
+    },
+    "shells": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+    },
+    "personality": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "hero_customization": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}