Docs + DX: zero-runtime-first positioning and scopeId collision guardrails (P3.5.1, P3.5.2)

[dbanksdesign]

Summary

• P3.5.1 — Zero-runtime-first docs: Restructures the getting-started guide, landing page, and sidebar navigation so build extraction is the primary story, not runtime injection. An evaluator's first impression is now "zero-runtime in production" rather than "another runtime CSS-in-JS library."
• P3.5.2 — scopeId collision guardrails: Adds a dev-mode console.warn when styles.component() registers the same namespace twice without a scopeId. Documents scope isolation best practices for apps, published packages, and per-file isolation.

Docs changes (P3.5.1)

• Getting started: Installs @typestyles/vite by default, shows Vite plugin setup and convention entry before the first style example, explains the dev/prod runtime split
• Landing page: Hero sample uses createTypeStyles({ scopeId }), benefit card chore: version packages #3 rewritten from "lean output" to "static CSS in production"
• Navigation: Promotes "Zero-runtime extraction" and "Vite Plugin" from Advanced Features into Getting Started section
• Next steps table: Leads with zero-runtime extraction
• Best practices: New "Scope isolation" section with guidance for apps, packages, and fileScopeId
• Component library guide: Adds required scopeId section for published packages

Code changes (P3.5.2)

• registry.ts: New warnUnscopedCollision() emits once per namespace when the same unscoped namespace is registered more than once
• component.ts: Calls warnUnscopedCollision in claimComponentNamespace when no scopeId is set
• 3 new tests covering: warning fires on collision, no false positive with scoped HMR, warning emits only once per namespace

Test plan

• pnpm --filter typestyles test — 334 tests pass (including 3 new)
• pnpm --filter typestyles typecheck — clean
• Verify docs site builds and renders updated navigation/content correctly
• Verify warning appears in browser console when two unscoped components share a namespace

🤖 Generated with Claude Code