@decantr/content 3.8.0

package/patterns/recipefork-recipe-card.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-recipe-card",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Recipe Card",
+  "description": "Food-forward recipe card for Brownfield RecipeFork-style feeds, cookbooks, and profile grids. Covers recipe photo, title, author avatar/name, fork lineage, save/like/comment counts, tags, prep/cook time, and cookbook assignment cues.",
+  "tags": [
+    "recipe",
+    "recipes",
+    "food",
+    "feed",
+    "cookbook",
+    "social",
+    "avatar",
+    "like",
+    "fork",
+    "photo",
+    "brownfield",
+    "ai-food"
+  ],
+  "components": [
+    "Card",
+    "Image",
+    "Avatar",
+    "Badge",
+    "Button",
+    "icon"
+  ],
+  "default_preset": "feed",
+  "presets": {
+    "feed": {
+      "description": "Responsive recipe feed card with photo, author row, engagement bar, and fork provenance.",
+      "components": [
+        "Card",
+        "Image",
+        "Avatar",
+        "Badge",
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "card",
+        "atoms": "_flex _col _gap3",
+        "slots": {
+          "photo": "Recipe photo with aspect-ratio crop and fallback gradient",
+          "author": "Avatar, author name, and timestamp",
+          "title": "Recipe title and optional short description",
+          "metadata": "Prep time, cook time, servings, tags, and fork lineage",
+          "engagement": "Like, comment, save, and fork counts"
+        }
+      }
+    },
+    "cookbook": {
+      "description": "Compact cookbook-grid recipe card emphasizing cover image, title, and assignment state.",
+      "components": [
+        "Card",
+        "Image",
+        "Badge",
+        "icon"
+      ],
+      "layout": {
+        "layout": "card",
+        "atoms": "_flex _col _gap2",
+        "slots": {
+          "cover": "Recipe/cookbook image",
+          "summary": "Title, tags, and cookbook assignment",
+          "status": "Saved, private, forked, or generated badges"
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "card",
+    "atoms": "_flex _col _gap3",
+    "slots": {
+      "photo": "Recipe image",
+      "author": "Author identity",
+      "summary": "Recipe summary",
+      "engagement": "Social counts"
+    }
+  },
+  "visual_brief": "A clean food-photo card that feels native to a modern cookbook app, not a generic SaaS card. The photo should be the first read; author identity and social counts should be immediately scannable without stealing focus from the dish. Dark mode may use glassy or elevated surfaces, but Brownfield implementations should preserve the app's existing component library and token system.",
+  "composition": {
+    "RecipeCard": "Card(recipefork-card) > [Photo(recipefork-photo) + AuthorRow(Avatar + Name + Timestamp) + RecipeSummary + MetadataBadges + EngagementBar]",
+    "EngagementBar": "Row > [LikeCount + CommentCount + SaveButton + ForkCount]",
+    "ForkCue": "Badge or inline trail showing root recipe or fork depth when available"
+  },
+  "layout_hints": {
+    "feed_grid": "Use a 1-column mobile, 2-column tablet, and 3-column desktop grid when the containing route is a discovery/feed page.",
+    "author_identity": "Avatar and name are not decorative; preserve them on feed/profile cards.",
+    "image_priority": "Reserve stable aspect-ratio space before the image loads to avoid feed jumps.",
+    "brownfield_styling": "Map this card to existing shadcn/Tailwind/CSS primitives before adding Decantr CSS."
+  },
+  "motion": {
+    "micro": {
+      "hover": "Cards may lift by 1-2px with a slightly stronger shadow over 150-200ms.",
+      "engagement": "Like/save actions may pulse or swap icon fill without shifting surrounding text."
+    },
+    "transitions": {
+      "entry": "Feed cards may fade up with short stagger when entering viewport."
+    }
+  },
+  "interactions": [
+    "lift-hover",
+    "scroll-reveal"
+  ],
+  "responsive": {
+    "mobile": "Single-column cards with image first and engagement controls wrapping under metadata.",
+    "tablet": "Two-column grid or roomy list depending on route density.",
+    "desktop": "Three-column feed grid or compact cookbook grid."
+  },
+  "accessibility": {
+    "role": "article",
+    "aria-label": "Recipe card",
+    "keyboard": [
+      "Primary card navigation and engagement actions must be separately focusable."
+    ],
+    "announcements": [
+      "Expose author, recipe title, forked/generated state, and engagement counts as text, not image-only badges."
+    ]
+  }
+}

package/patterns/recipefork-recipe-metadata-form.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-recipe-metadata-form",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Recipe Metadata Form",
+  "description": "Shared Recipefork authoring scaffold for hero image, title, description, servings, difficulty, timing, tags, and draft-versus-publish controls across Simple Mode and Chef Mode.",
+  "dependencies": {
+    "patterns": {
+      "recipefork-recipe-story-editor": "^1.0.0"
+    },
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "Input",
+        "Textarea",
+        "Select",
+        "Badge",
+        "Card",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "Input",
+    "Textarea",
+    "Select",
+    "Badge",
+    "Card",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "authoring",
+  "presets": {
+    "authoring": {
+      "description": "Top section of the create and edit experience with hero upload, recipe title block, core metadata, tags, and draft/publish actions.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "hero-upload": "Large image picker with current preview and replacement affordance",
+          "identity": "Title and description fields",
+          "core-metadata": "Servings, difficulty, prep time, and cook time controls",
+          "tags": "Tag chips and tag input row",
+          "actions": "Save draft, publish, and update buttons"
+        }
+      }
+    }
+  },
+  "visual_brief": "A clean product authoring header built from stacked cards rather than a giant wizard. The hero image sits first, followed by clear metadata rows and compact action controls that make draft-versus-publish state obvious without overpowering the editor.",
+  "composition": {
+    "RecipeMetadataForm": "Stack(recipefork-editor-stack) > [HeroUpload + Identity + CoreMetadata + Tags + Actions]"
+  }
+}

package/patterns/recipefork-recipe-mode-switch.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-recipe-mode-switch",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Recipe Mode Switch",
+  "description": "Two-mode authoring switch for choosing between Simple Mode and Chef Mode before starting or editing a recipe. Designed for Recipefork's dual authoring workflow.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Tabs",
+        "Badge",
+        "Button",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Tabs",
+    "Badge",
+    "Button",
+    "icon"
+  ],
+  "default_preset": "split",
+  "presets": {
+    "split": {
+      "description": "Two equal-width tabs rendered as rich tiles with title, icon, and supporting description.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "tabs": "Two-column tab list",
+          "simple-tile": "Simple Mode summary tile",
+          "chef-tile": "Chef Mode summary tile",
+          "content": "Selected mode content below"
+        }
+      }
+    }
+  },
+  "visual_brief": "A card-contained two-mode switch where each option behaves like a tab tile rather than a plain text tab. Simple Mode uses a gentle utility sparkle icon with copy about fast creation. Chef Mode uses a chef-hat icon plus an 'Advanced' badge and copy about measurements, hierarchy, and deep editing. Active mode feels like a selected product tile.",
+  "responsive": {
+    "mobile": "Tiles stack comfortably inside a two-column tab rail with enough vertical padding to keep the mode distinction obvious.",
+    "tablet": "Equal-width mode tiles with generous description text.",
+    "desktop": "Wide card surface with supporting mode detail visible at a glance before the authoring form begins."
+  },
+  "composition": {
+    "RecipeModeSwitch": "Container(d-card, flex-col) > [Tabs(d-control) > [SimpleModeTile + ChefModeTile] + SelectedModeContent]"
+  }
+}

package/patterns/recipefork-recipe-story-editor.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-recipe-story-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Recipe Story Editor",
+  "description": "Expandable optional rich-text story editor for recipe narratives, family context, and cooking notes. Mirrors Recipefork's optional story flow with toolbar and sanitization-aware output expectations.",
+  "dependencies": {
+    "patterns": {
+      "doc-editor": "^1.0.0"
+    },
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "Badge",
+        "Card",
+        "Textarea",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "Badge",
+    "Card",
+    "Textarea",
+    "icon"
+  ],
+  "default_preset": "expandable",
+  "presets": {
+    "expandable": {
+      "description": "Collapsed optional section that expands into a lightweight rich-text editor with formatting toolbar.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap3",
+        "slots": {
+          "header": "Toggleable section header",
+          "toolbar": "Bold, italic, heading, list, ordered list, link actions",
+          "editor": "Rich text area",
+          "meta": "Character count and helper copy"
+        }
+      }
+    }
+  },
+  "visual_brief": "A dashed-border card with an optional badge and a collapsible header labeled as the recipe story. When expanded, it reveals a compact formatting toolbar and a narrative editing surface for recipe origin stories, memories, and serving notes.",
+  "composition": {
+    "RecipeStoryEditor": "Card(recipefork-editor) > [Header(toggle) + Toolbar? + EditorArea + MetaRow]"
+  }
+}

package/patterns/recipefork-simple-recipe-editor.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "recipefork-simple-recipe-editor",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Recipefork Simple Recipe Editor",
+  "description": "Simple Mode authoring pattern for ordered ingredient and instruction lists, designed to coexist with Recipefork's Chef Mode without sacrificing the streamlined path.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Button",
+        "Input",
+        "Textarea",
+        "Card",
+        "Label",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Button",
+    "Input",
+    "Textarea",
+    "Card",
+    "Label",
+    "icon"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Basic recipe editor with two ordered lists: raw ingredient lines and raw instruction lines.",
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap4",
+        "slots": {
+          "ingredients": "Ordered ingredient rows with add/remove and drag-sort affordances",
+          "instructions": "Ordered instruction rows with add/remove and drag-sort affordances"
+        }
+      }
+    }
+  },
+  "visual_brief": "Simple Mode should feel intentionally lighter than Chef Mode, but not stripped down. Ingredients and instructions are handled as clean stacked rows that stay fast to edit, reorder, and scan.",
+  "composition": {
+    "SimpleRecipeEditor": "Stack(recipefork-editor-stack) > [IngredientList + InstructionList]"
+  }
+}

package/patterns/redline-track-changes.json

@@ -0,0 +1,113 @@
+{
+  "id": "redline-track-changes",
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Redline Track Changes",
+  "description": "A document review surface with inline track-changes, margin comments, author attribution, accept/reject controls, and a revision version timeline.",
+  "category": "legal",
+  "tags": [
+    "2026",
+    "legal",
+    "redline",
+    "track-changes",
+    "review",
+    "collaboration",
+    "document"
+  ],
+  "components": [
+    "DocumentPane",
+    "InlineChange",
+    "CommentBubble",
+    "AuthorBadge",
+    "AcceptRejectControls",
+    "VersionTimeline"
+  ],
+  "default_preset": "standard",
+  "presets": {
+    "standard": {
+      "description": "Full editorial review mode displaying inline tracked changes with margin comment bubbles and per-change accept and reject controls on hover",
+      "layout": {
+        "layout": "document-with-margin",
+        "atoms": "_grid _grid-cols-[1fr_320px] _gap-6 _w100 _max-w-6xl _mx-auto _p-6"
+      }
+    },
+    "clean": {
+      "description": "Approved-state view rendering the document as if all accepted changes were applied with no markup visible for final review presentation",
+      "layout": {
+        "layout": "single-column",
+        "atoms": "_flex _flex-col _w100 _max-w-3xl _mx-auto _p-8"
+      }
+    },
+    "author": {
+      "description": "Author-attribution mode color-coding every change by its contributing reviewer with a legend of authors active during the revision cycle",
+      "layout": {
+        "layout": "document-with-margin",
+        "atoms": "_grid _grid-cols-[1fr_320px] _gap-6 _w100 _max-w-6xl _mx-auto _p-6"
+      }
+    }
+  },
+  "visual_brief": "A document rendered in serif font with generous margins, similar to Word track-changes. Insertions appear underlined in an author-specific color (author A red, author B blue, author C purple, etc.) with author initial badge floating at start of insertion. Deletions shown with strikethrough in the same author color. Comment bubbles in right margin are rounded rectangles with author avatar, timestamp, comment text, and thin connecting line drawn to the referenced text span. Hovering any change surface reveals a floating action bar with Accept (green check) and Reject (red X) icon buttons plus 'Reply' option. Top header contains a horizontal version timeline chip strip showing v1, v2, v3... with dots for revision authors, current version highlighted. Side panel can filter by author, change type, or resolved/unresolved comments.",
+  "layout_hints": {
+    "container": "d-section",
+    "note": "Comments in margin must have visible connector lines to source text. Author badges use initials, never emoji.",
+    "color_attribution": "Each author gets a stable color assigned at entry. Do not recycle colors mid-revision."
+  },
+  "default_layout": {
+    "layout": "document-with-margin",
+    "atoms": "_grid _grid-cols-[1fr_320px] _gap-6 _w100 _max-w-6xl _mx-auto _p-6",
+    "slots": {
+      "document-pane": "Main serif-font document surface containing paragraphs with inline change markup interspersed.",
+      "inline-change": "Repeating span within document representing an insertion or deletion. Color-coded by author, attached to author badge.",
+      "comment-bubble": "Right-margin card showing author avatar, timestamp, comment body, thread replies, and resolve toggle.",
+      "author-badge": "Small colored circular badge with author initials. Placed at start of each change span and on each comment bubble.",
+      "accept-reject-controls": "Floating action bar revealed on hover over any change containing Accept, Reject, and Reply buttons.",
+      "version-timeline": "Horizontal strip across top header with numbered version pills and author dots showing revision progression."
+    }
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Document track changes review",
+    "announcements": [
+      "Change by {author}: {type} at paragraph {n}",
+      "Comment added by {author}: {excerpt}",
+      "Change {accepted|rejected}"
+    ],
+    "keyboard": [
+      "J / K: next / previous change",
+      "A: accept focused change",
+      "R: reject focused change",
+      "C: add comment to selection",
+      "Arrow keys: navigate within document",
+      "Escape: close comment thread"
+    ]
+  },
+  "responsive": {
+    "mobile": "Comment margin collapses to a drawer with indicator badges inline in the document. Controls appear in a bottom action sheet.",
+    "tablet": "Narrower margin column. Version timeline collapses to current-version dropdown."
+  },
+  "motion": {
+    "micro": {
+      "change-hover": "background brighten + controls fade-in 180ms ease-out",
+      "comment-focus": "bubble elevation raise 200ms ease"
+    },
+    "transitions": {
+      "accept-change": "background flash green then content reflow 400ms ease-in-out",
+      "reject-change": "strikethrough pulse then content removal 400ms",
+      "comment-resolve": "bubble fade to muted 300ms"
+    },
+    "ambient": {
+      "unresolved-pulse": "unresolved comment bubble subtle ring-pulse 3s ease-in-out infinite"
+    }
+  },
+  "interactions": [
+    "animate-on-mount"
+  ],
+  "composition": {
+    "RedlineTrackChanges": "Section(d-section) > [VersionTimeline(header) + DocumentPane(main) > [Paragraph[] > InlineChange[](author-colored) > [AuthorBadge + ChangeText + AcceptRejectControls]] + CommentMargin > CommentBubble[](d-annotation) > [AuthorBadge + Timestamp + CommentBody + ReplyThread + ResolveToggle]]",
+    "DocumentPane": "Article(serif, margin-sized) > Paragraph[]",
+    "InlineChange": "Span(colored, underline|strikethrough, data-author) > [AuthorBadge + TextContent]",
+    "CommentBubble": "Card(d-annotation, connector-line) > [Header(avatar+name+time) + Body + Replies + Actions]",
+    "VersionTimeline": "Strip(horizontal) > VersionPill[] > [VersionNumber + AuthorDots + DateLabel]"
+  }
+}

package/patterns/registry-discovery-cta-grid.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "registry-discovery-cta-grid",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Registry Discovery CTA Grid",
+  "description": "Editorial quick-start discovery cards for the public registry homepage. Each card helps builders choose a path into the registry with a strong icon, concise framing copy, and a clearly-owned Decantr action treatment.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Card",
+        "Button",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Card",
+    "Button",
+    "icon"
+  ],
+  "contained": false,
+  "default_preset": "editorial",
+  "presets": {
+    "editorial": {
+      "description": "Three discovery cards in a responsive grid. Each card has an icon badge, eyebrow, title, supporting description, and a bottom action rail that reads like the next step a builder should take.",
+      "components": [
+        "Card",
+        "Button",
+        "icon"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gc1 _md:gc2 _xl:gc3 _gap4",
+        "slots": {
+          "card-icon": "Compact icon badge tied to the discovery path. Distinct but not louder than the title.",
+          "card-eyebrow": "Uppercase label using d-label treatment to explain the decision lens for the card.",
+          "card-title": "Strong section heading that frames the user intent.",
+          "card-description": "Two-to-four lines of editorial helper copy that explains why a builder would take this path.",
+          "card-action": "Primary CTA rail with icon, label, and supporting hint. The action must feel clearly clickable, not like body copy."
+        }
+      }
+    }
+  },
+  "visual_brief": "A premium discovery grid that feels closer to a product decision surface than a checklist. Cards should be calm, dark, and atmospheric with subtle accent gradients, a strong top-left icon moment, and a bottom CTA rail that is unmistakably interactive. The CTA should not collapse into generic ghost-button text. Think curated launchpad cards: crisp type, clear action hierarchy, and just enough motion and accent contrast to feel current without becoming noisy.",
+  "responsive": {
+    "mobile": "Single-column cards with full-width CTA rails. The icon, eyebrow, title, description, and CTA stack vertically with no dead space.",
+    "tablet": "Two-column layout when space allows. Cards keep even height and a clear action zone at the bottom.",
+    "desktop": "Three-column editorial grid with balanced card height, stronger hover treatment, and CTA rails aligned along the bottom edge."
+  },
+  "motion": {
+    "micro": "Discovery cards may lift slightly and brighten their accent treatment on hover. CTA rails should respond clearly on hover and focus with a directional sense of momentum.",
+    "transitions": "Grid cards may reveal with a short stagger or fade-up sequence, but the surface should still feel curated rather than animated for its own sake."
+  },
+  "interactions": [
+    "lift-hover",
+    "click-select",
+    "animate-on-mount",
+    "stagger-children",
+    "scroll-reveal"
+  ],
+  "layout_hints": {
+    "card_structure": "Use one visual lane per card: icon + eyebrow at the top, narrative in the middle, action rail at the bottom. Avoid chip clouds, diagnostics, or inline metadata.",
+    "cta_treatment": "CTA rails should be explicit actions with iconography and supporting hint copy. Prefer directional arrow or external-link affordances over plain text-only links.",
+    "tone_mapping": "Each discovery card can use its own accent family so the user can quickly parse blueprint-first vs showcase-first vs registry-wide exploration."
+  },
+  "accessibility": {
+    "role": "region",
+    "aria-label": "Registry discovery actions",
+    "keyboard": [
+      "Tab moves through discovery CTAs in card order."
+    ],
+    "announcements": [
+      "Card title, supporting narrative, and CTA intent should be available without relying on color or hover effects."
+    ],
+    "focus_management": "Each discovery card should expose a clear focusable CTA rather than forcing keyboard users to parse the whole card surface as one unlabeled block."
+  },
+  "composition": {
+    "RegistryDiscoveryCtaGrid": "Grid(1/2/3-col responsive) > DiscoveryCard[]",
+    "DiscoveryCard": "Card(d-surface, raised) > [CardHead > [IconBadge + Eyebrow] + Title + Description + ActionRail]",
+    "ActionRail": "Button(d-interactive, primary or strong secondary) > [ActionLabel + ActionHint + TrailingIcon]"
+  },
+  "io": {
+    "consumes": [],
+    "produces": [],
+    "actions": [
+      "cta-click"
+    ]
+  }
+}

package/patterns/registry-link-list.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "https://decantr.ai/schemas/pattern.v2.json",
+  "id": "registry-link-list",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Registry Link List",
+  "description": "Compact list of registry destinations, documentation references, namespaces, or related content links. Optimized for sidebars, detail pages, and post-hero navigation blocks.",
+  "dependencies": {
+    "patterns": {},
+    "styles": {},
+    "requires_core": {
+      "components": [
+        "Link",
+        "Badge",
+        "icon"
+      ],
+      "charts": []
+    }
+  },
+  "components": [
+    "Link",
+    "Badge",
+    "icon"
+  ],
+  "contained": false,
+  "default_preset": "compact",
+  "presets": {
+    "compact": {
+      "description": "Single-column link list with icon, title, short helper text, and optional count or status badge.",
+      "components": [
+        "Link",
+        "Badge",
+        "icon"
+      ],
+      "layout": {
+        "layout": "stack",
+        "atoms": "_flex _col _gap2",
+        "slots": {
+          "link-icon": "Small icon or type marker.",
+          "link-title": "Destination name.",
+          "link-description": "One-line helper copy.",
+          "link-badge": "Optional count, namespace, or status."
+        }
+      }
+    },
+    "two-column": {
+      "description": "Two-column link inventory for larger registry overview sections.",
+      "components": [
+        "Link",
+        "Badge",
+        "icon"
+      ],
+      "layout": {
+        "layout": "grid",
+        "atoms": "_grid _gc1 _md:gc2 _gap3",
+        "slots": {
+          "link-item": "Full row link with icon, title, helper copy, and trailing affordance."
+        }
+      }
+    }
+  },
+  "default_layout": {
+    "layout": "stack",
+    "atoms": "_flex _col _gap2",
+    "slots": {
+      "link-icon": "Icon or type marker",
+      "link-title": "Destination title",
+      "link-description": "Helper copy",
+      "link-badge": "Optional metadata badge"
+    }
+  },
+  "visual_brief": "A utilitarian but polished registry navigation list. It should feel like a trustworthy map of related destinations, not a decorative card grid. Rows should be easy to scan, with clear link affordances, subtle dividers or hover states, and enough helper copy to explain why the destination matters.",
+  "responsive": {
+    "mobile": "Single-column full-width rows with titles and helper copy wrapping cleanly.",
+    "tablet": "Single or two-column layout depending on available width.",
+    "desktop": "May use two columns or a sidebar list. Keep row height consistent."
+  },
+  "layout_hints": {
+    "row_density": "Keep rows compact. Avoid card-heavy treatment unless each link has substantial context.",
+    "trailing_affordance": "Use an arrow, external-link icon, or subtle badge so links are unmistakable.",
+    "metadata": "Counts and namespaces belong in a trailing badge, not mixed into the title."
+  },
+  "motion": {
+    "micro": "Rows may brighten or slide their trailing icon a few pixels on hover.",
+    "transitions": "Filter updates should preserve list position and avoid dramatic reflow."
+  },
+  "interactions": [
+    "click-select",
+    "hover-reveal",
+    "keyboard-navigation"
+  ],
+  "accessibility": {
+    "role": "navigation",
+    "aria-label": "Registry links",
+    "keyboard": [
+      "Each row should expose one clear link target with a descriptive accessible name."
+    ],
+    "announcements": [
+      "Destination title and helper copy should be included in the accessible label or nearby description."
+    ],
+    "focus_management": "Focused rows should show an obvious outline or background shift."
+  },
+  "composition": {
+    "RegistryLinkList": "NavOrList > RegistryLinkItem[]",
+    "RegistryLinkItem": "LinkRow > [Icon + TextStack(Title + Description) + Badge? + TrailingIcon]"
+  },
+  "io": {
+    "consumes": [
+      "related-links"
+    ],
+    "produces": [
+      "navigation-intent"
+    ],
+    "actions": [
+      "link-click"
+    ]
+  }
+}