2 commits

Author	SHA1	Message	Date
le king fu	554373e7d8	feat(gating): UI guard — RequireFeature + UpsellGate + i18n ... Add the reusable gating guard components on top of the #297 foundation: - UpsellGate: full locked screen (lock icon, tier title, per-feature description). Two CTAs: "Get <tier>" rendered VISIBLE but DISABLED with an "online purchase coming soon" note (per planning decision — #270 will activate it), and "I already have a key" navigating to /settings/users (LicenseCard). - RequireFeature: renders a neutral loader while the license is not ready (no upsell flash at boot), then children or UpsellGate. Renders <Outlet/> when children are omitted so it also works as a layout route grouping all routes of one feature. - requiredTierFor() pure helper in shared/entitlements.ts derives the minimum unlocking tier from matrix membership (not array order). - i18n: upsell.* (title, per-feature descriptions, CTAs) + nav.locked in BOTH locales; tier labels reuse the existing license.editions.* keys. - Tests: requiredTierFor mapping/minimality + upsell i18n coverage for every FeatureKey in fr and en (the components themselves are not testable without jsdom). Resolves #298 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-20 22:05:04 -04:00
le king fu	fd7e053239	feat(gating): license provider + entitlements matrix + useEntitlement (#297) ... Socle for tier-based feature gating (UI-only soft-paywall). - LicenseContext: machine-level provider (createContext<T|null>, useReducer, throwing consumer hook), mounted above ProfileProvider in main.tsx so a profile switch (BrowserRouter key remount) does not reload the license. Loads edition + info once; exposes { status, edition, features, info, error, refresh, submitKey }. Boot-error recovery (CWE-703): neutral state + capped exponential-backoff retry, never the upsell. - shared/entitlements.ts: FeatureKey (kebab-case), ENTITLEMENTS matrix, pure isEntitled() fail-closed in Free (CWE-863) — the features[] override is ignored before edition==="free" is checked. - useEntitlement(f): { allowed, ready } (ready = status==="ready"), synchronous. - useIsPremium + its test migrated onto the context (drops the per-call double invoke); LicenseCard consumes the context. useLicense.ts removed (fully replaced, no remaining consumers). - services/entitlements.test.ts: matrix, features[] override, override ignored in Free, unknown-feature deny-all. Resolves #297 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-07-19 21:05:10 -04:00