Stage 5: Theming maturity

[ntucker]

Summary

• Add product-grade tenant branding in @reactive/silk-core: OKLCH generateScale, paired light/dark generatePairedPalette, and public checkThemeContrast / contrast helpers (with culori).
• Split web theme-scope CSS vars into semanticVars vs customVars so named nests replace tenant semantics in portals while component hooks still inherit.
• Freeze and document the public component CSS-variable surface (silkComponentVarMeta + Theming.mdx sync test); ship Ocean/Ember TenantGallery and ThemePlayground docs exit demos.

Test plan

• yarn build && yarn typecheck && yarn test
• yarn test:packed && yarn test:perf
• yarn docs:build && yarn test:storybook
• Spot-check Theme → TenantGallery (four panels) and Theme → ThemePlayground (seed/scheme controls + contrast readout)
• Confirm Dialog/Select portal under outer tenant + inner colorScheme="dark" keeps --silk-button-* hooks without outer semantic surfaces

Made with Cursor

[changeset-bot]

🦋 Changeset detected

Latest commit: 3e3bcf6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@reactive/silk-core	Minor
@reactive/silk	Minor
@reactive/silk-docs	Patch
@reactive/silk-native-spike	Patch

Not sure what this means? Click here to learn what changesets are.

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