Skip to content

docs(arch-5): SFC primitives audit + design spec (design/styles/data/auth/i18n/a11y/routing)#63

Merged
srmcguirt merged 1 commit intomainfrom
feat/arch-5-sfc-primitives
May 5, 2026
Merged

docs(arch-5): SFC primitives audit + design spec (design/styles/data/auth/i18n/a11y/routing)#63
srmcguirt merged 1 commit intomainfrom
feat/arch-5-sfc-primitives

Conversation

@srmcguirt
Copy link
Copy Markdown
Member

Summary

Architecture spec auditing 39 shipped macros and proposing 27 new SFC primitives across 7 dimensions.

Dimensions covered

Dimension New primitives
Design <$theme>
Styles <$container>, <$prefers>, <$reactive>(() => expr) amendment
Data <$mutation> (deferred v1.2)
Auth <$user>, <$signin>, <$signout>
i18n <$locale>, <$translate>, <$t>, <$plural>, <$relativeTime>, <$dateTime>, <$number>
a11y <$liveRegion>, <$focusTrap>, <$skipLink>, <$visuallyHidden>, <$announce>
Routing <$router>, <$route>, <$link>, <$outlet>, <$navigate>, <$beforeNavigate>, <$afterNavigate>

Decisions

  • 22 accept for v1.1, 4 defer to v1.2, 3 reject with rationale
  • New plugin: @aihu/i18n (~2 kB ICU subset, zero deps, full ICU opt-in via custom parser)
  • a11y stays in core — pure Web API wrappers, ~800 bytes runtime, accessible by default
  • 25 RFC stubs (RFC-A5-001 through RFC-A5-025): 8 require core vocabulary amendments, 17 are plugin spec entries

Phased delivery

  • v1.1 M1 — a11y + routing (no plugin gates, ship immediately)
  • v1.1 M2 — design + styles + auth + i18n (post live-binding RATIFY; @aihu/auth + @aihu/i18n ships)
  • v1.2<$mutation>, full ICU, breadcrumbs, polling

Hard gate

<$guard> enforcement remains gated on live-binding RFC #56 ratification per Directive 3 — fallback UI renders correctly regardless; enforcement activates via single wiring change post-RATIFY.

🤖 Generated with Claude Code

…ta/auth/i18n/a11y/routing

* Audits 39 shipped macros across 4 blocks
* Proposes 27 new primitives (22 accept v1.1, 4 defer v1.2, 3 reject)
* Covers 7 dimensions: design, styles, data, auth, i18n, a11y, routing
* Adds @aihu/i18n plugin proposal (~2 kB ICU subset, zero deps)
* 25 RFC stubs (RFC-A5-001 through RFC-A5-025)
* 8 require core vocabulary amendments; 17 are plugin spec entries
* Phased delivery: M1 unblocks routing + a11y (no plugin gates),
  M2 lights up design/styles/auth/i18n primitives post live-binding RATIFY

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 5, 2026

⚠️ No Changeset found

Latest commit: 9b42f68

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@srmcguirt srmcguirt merged commit 306209c into main May 5, 2026
@srmcguirt srmcguirt deleted the feat/arch-5-sfc-primitives branch May 5, 2026 17:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant