@colixsystems/widget-sdk 0.131.0 → 0.132.0

package/README.md

@@ -70,7 +70,13 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.131.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.132.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.132.0 (contract 1.102.0)
+
+**BREAKING: the top bar has no divider — `resolveTopBarTokens` drops `borderColor` and `borderWidth` (sc-7360).** The bar and its tab row are one surface; a line under the bar ruled it off from its own menu, and a line under the tabs ruled the menu off from the page it navigates. Neither host draws one any more, the Design page offers no colour or width for one, and `TopBarTokens` no longer carries the two fields. A stored `topBar.borderColor` / `borderWidth` is **inert, not migrated** — nothing reads it, and the theme coercer drops it from a saved look or a Mason `set_theme`. The rail's, footer's and site header's dividers are unchanged.
+
+- `resolveSidebarTokens` / `resolveFooterTokens` are unchanged. No `CONTRACT` change.
 
 ### What's new in 0.131.0 (contract 1.102.0)
 

package/dist/host.d.ts

@@ -222,13 +222,12 @@ export function resolveSidebarTokens(theme: unknown): SidebarTokens;
 
 /** The top app bar's resolved tokens. `tintColor` and `titleColor` are separate
  *  because an unthemed bar paints its icons slate and its app name in the brand
- *  colour; an authored `topBar.textColor` drives both. */
+ *  colour; an authored `topBar.textColor` drives both. The bar carries NO
+ *  divider (sc-7360): a stored `topBar.borderColor` / `borderWidth` is inert. */
 export interface TopBarTokens {
   backgroundColor: string;
   tintColor: string;
   titleColor: string;
-  borderColor: string | null;
-  borderWidth: number | null;
   /** The current page's mark — the active link's label, and an active tab's
    *  label plus its indicator. Falls back to the RAIL's `activeColor` and then
    *  to the brand, so an app states its navigation colour once. */

package/dist/navigation.cjs

@@ -281,7 +281,9 @@ function resolveSidebarTokens(theme) {
 }
 
 /**
- * The top app bar's surface, its two text colours and its opt-in divider.
+ * The top app bar's surface and its two text colours. It has NO divider
+ * (sc-7360): the bar and its tab row sit in one surface, so a stored divider
+ * colour or width on the block is inert on both hosts.
  *
  * `tintColor` and `titleColor` are SEPARATE because the web bar has always
  * painted them differently when the author names nothing: the hamburger and
@@ -295,13 +297,11 @@ function resolveSidebarTokens(theme) {
  * @param {unknown} theme — the whole `theme_config`; the app's
  *   `backgroundColor`/`backgroundGradient` are read because an unset surface
  *   resolves to the page's, as an `attached` tab's already did (sc-6596).
- * @returns {{ backgroundColor: string, tintColor: string, titleColor: string,
- *   borderColor: string|null, borderWidth: number|null }}
+ * @returns {{ backgroundColor: string, tintColor: string, titleColor: string }}
  */
 function resolveTopBarTokens(theme) {
   const config = isPlainObject(theme) ? theme : {};
   const topBar = isPlainObject(config.topBar) ? config.topBar : {};
-  const borderColor = hexOrNull(topBar.borderColor);
   // An explicit colour drives BOTH slots; only the unset case splits.
   const authored = hexOrNull(topBar.textColor);
   return {
@@ -324,13 +324,10 @@ function resolveTopBarTokens(theme) {
       topBar.activeColor,
       hexOr(sidebarBlock(config).activeColor, brandPrimary(config)),
     ),
-    borderColor,
-    borderWidth: borderColor ? borderWidthOr(topBar.borderWidth) : null,
     // REQ-NAV-STRUCTURE: how the tab row marks its current page.
     // `underline` keeps the tab in the bar's surface and marks it with an
     // indicator. `attached` makes it a real folder tab: it takes the CONTENT's
-    // surface and sits over the row's divider, so the tab and the page beneath
-    // read as one plane. Meaningless on a shape that draws no tab row — a host
+    // surface and meets the page beneath it, so the two read as one plane. Meaningless on a shape that draws no tab row — a host
     // reads it only where it has tabs to draw.
     tabStyle: topBar.tabStyle === "attached" ? "attached" : "underline",
     // The surface an `attached` tab AND its content panel share. One value for

package/dist/navigation.js

@@ -272,7 +272,9 @@ export function resolveSidebarTokens(theme) {
 }
 
 /**
- * The top app bar's surface, its two text colours and its opt-in divider.
+ * The top app bar's surface and its two text colours. It has NO divider
+ * (sc-7360): the bar and its tab row sit in one surface, so a stored divider
+ * colour or width on the block is inert on both hosts.
  *
  * `tintColor` and `titleColor` are SEPARATE because the web bar has always
  * painted them differently when the author names nothing: the hamburger and
@@ -286,13 +288,11 @@ export function resolveSidebarTokens(theme) {
  * @param {unknown} theme — the whole `theme_config`; the app's
  *   `backgroundColor`/`backgroundGradient` are read because an unset surface
  *   resolves to the page's, as an `attached` tab's already did (sc-6596).
- * @returns {{ backgroundColor: string, tintColor: string, titleColor: string,
- *   borderColor: string|null, borderWidth: number|null }}
+ * @returns {{ backgroundColor: string, tintColor: string, titleColor: string }}
  */
 export function resolveTopBarTokens(theme) {
   const config = isPlainObject(theme) ? theme : {};
   const topBar = isPlainObject(config.topBar) ? config.topBar : {};
-  const borderColor = hexOrNull(topBar.borderColor);
   // An explicit colour drives BOTH slots; only the unset case splits.
   const authored = hexOrNull(topBar.textColor);
   return {
@@ -315,13 +315,10 @@ export function resolveTopBarTokens(theme) {
       topBar.activeColor,
       hexOr(sidebarBlock(config).activeColor, brandPrimary(config)),
     ),
-    borderColor,
-    borderWidth: borderColor ? borderWidthOr(topBar.borderWidth) : null,
     // REQ-NAV-STRUCTURE: how the tab row marks its current page.
     // `underline` keeps the tab in the bar's surface and marks it with an
     // indicator. `attached` makes it a real folder tab: it takes the CONTENT's
-    // surface and sits over the row's divider, so the tab and the page beneath
-    // read as one plane. Meaningless on a shape that draws no tab row — a host
+    // surface and meets the page beneath it, so the two read as one plane. Meaningless on a shape that draws no tab row — a host
     // reads it only where it has tabs to draw.
     tabStyle: topBar.tabStyle === "attached" ? "attached" : "underline",
     // The surface an `attached` tab AND its content panel share. One value for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.131.0",
+  "version": "0.132.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",