FE-1447: Emit layer facts and relations as structured data with card components

[kube]

🌟 What is the purpose of this PR?

Implements FE-1447: generated layer pages baked their facts into MDX prose (the Package/Layer id/Files/Lines line, "Declared in", and the "Depends on" / "Depended on by" heading-plus-table blocks), so a host could not restyle them. The pages now render two components shipped in the bundle, receiving structured props.

Top of stack #9226, on FE-1443 (its "Declared" edge tables fold into the relations component).

🔗 Related links

• FE-1447 (internal): this PR
• FE-1443 (internal): the declared edges this renders as dashed protocol pills

🔍 What does this change?

libs/@local/petrinaut-arch-docs:

• Three shipped components, emitted into the bundle's components/ beside authored ones:
  • LayerFacts: an aligned Package / Layer id / Files / Lines grid with a Declared-in footer link, as one compact bordered card. The role reads as the page's plain lead paragraph above it, outside the card.
  • LayerRelations: both directions side by side (single column under 640px) with the column headings top-aligned, layer names left and count/pkg badges pinned right, and a dashed protocol pill on its own line for declared edges.
  • LayerSource: the file count and source root as a matching card, replacing the old "Source" heading and sentence.
• Styling: plain CSS, colors derived from currentColor via color-mix, so both Starlight themes work without theme-specific rules.
• Emission (mdx.ts): pages import the components by page-relative path and pass props as JSON expressions (JSX string attributes cannot escape a " in a role). One relation entry per line keeps diffs reviewable. Pages without edges emit no relations block. architecture.md keeps plain text.
• The generator's tsconfig excludes the component sources: the Astro build compiles them, same as authored content/components/.

Contract note, documented in the README: hosts now need a React-capable MDX pipeline for generated layer pages, not only for authored pages.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• modifies a workspace but not a publishable library

📜 Does this require a change to the docs?

The changes in this PR:

• require changes to docs which are made as part of this PR

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph

🛡 What tests cover this?

• mdx.test.ts: import-path depth per page, structured props, declared-edge entries in the relations props, and the removal of the old heading-plus-table sections.
• lint:arch-docs and turbo run build --filter @apps/petrinaut-docs prove the emitted MDX compiles and renders.

❓ How to test this?

1. turbo run dev --filter @apps/petrinaut-docs
2. Open any layer page (for example architecture/bindings): the facts card replaces the header prose, the relations card shows both directions, and the declared edge to cli renders as a dashed protocol pill.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview	Aug 20, 2026 10:21am
petrinaut	Ready	Preview	Aug 20, 2026 10:21am
petrinaut-docs	Ready	Preview	Aug 20, 2026 10:21am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hashdotdesign-tokens	Ignored	Preview	Aug 20, 2026 10:21am