@the-portland-company/shell 0.47.0-rc.3 → 0.47.0

package/CHANGELOG.md

@@ -64,9 +64,25 @@ Dark mode keeps the platform's neutral ramp. The Brand sheet resets the Mode
 SURFACES to the guaranteed-invalid value under `.dark` so they fall through to
 the neutrals; only the accent, a foreground colour, carries over.
 
-Active sub-rows also gain a 3px left rail drawn from `--nav-row-active-rail`,
-which resolves `transparent` unless the Mode declared a chrome group — so for
-every other app the span renders invisible and out of flow.
+Active sub-rows also gain a 3px left rail drawn from
+`var(--mode-accent, transparent)` — invisible and out of flow for any app whose
+Mode declares no chrome group.
+
+**Where Mode SURFACES are read matters, and the rule is not obvious.** They are
+resolved at the point of use with the pre-0.47 value as an inline fallback:
+
+```
+bg-[color:var(--mode-accent-surface,var(--panel-elevated))]
+```
+
+Not through an alias declared in the `[data-politogy-mode]` block — that block
+does not match an app which is not mode-scoped, so the alias would be unset and
+a bare `var()` is invalid at computed-value time, dropping the property to its
+initial value. And not through a `:root` alias either — `.dark` is a separate
+top-level selector, so a `:root` alias substitutes the LIGHT value and inherits
+it into dark. Point of use is the only placement correct in both themes, scoped
+and unscoped. Two tests enforce it; both mistakes were made and caught during
+the release candidates.
 
 Needs the matching Brand API release (`tokens.modes.<id>.chrome`).
 
@@ -108,6 +124,19 @@ a silent effect.
 
 A grant is for a fact only the app HAS, never for a look.
 
+### Added — the brand lockup follows the Mode
+
+`brandLogoSrc` became core-only in 0.43, so every mode-scoped app rendered the
+Relationship lockup — a red wordmark on a purple `vrm` badge — whatever Mode it
+was scoped to. Petition Mode shipped a green Petition lockup in V1 and lost it in
+that migration.
+
+Resolved from the registry by Mode, like the accent:
+`MODE_BRAND_LOGOS = { petition: '/brand/logos/petition-mode-logo.svg' }`. Only
+Modes with a shipped lockup are listed; everything else keeps today's default.
+The path is app-relative, so add the asset to the app's `public/` before adding
+a Mode here.
+
 ### Changed — prereleases publish under the `next` dist-tag
 
 `npm publish` tags `latest` whatever the semver, so an rc would silently become

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-portland-company/shell",
-  "version": "0.47.0-rc.3",
+  "version": "0.47.0",
   "description": "Shared chrome (header, sidebar, footer, theme, auth) for politogy apps. Drop into any Vite SPA to inherit the politogy look and signed-in user.",
   "license": "UNLICENSED",
   "private": false,