@colixsystems/widget-sdk 0.255.0 → 0.256.0

package/README.md

@@ -85,7 +85,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.255.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.256.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.256.0 (contract 1.207.0)
+
+**A page's top navigation bar can centre its tabs again.** `resolveTopBarTokens().tabAlignment` is `"left"` | `"center"` | `"right"`. A `theme_config.topBar.tabAlignment` of `"center"` places the tabs between two flexible spacers, never by centring the row, so a row with more tabs than fit still scrolls from its first tab. Unset or unknown still resolves to `"left"`, so an app that never chose is unchanged. Host-integration surface only — no author-facing hook, prop, primitive, or manifest field changed.
 
 ### What's new in 0.255.0
 

package/dist/contract.cjs

@@ -6372,7 +6372,9 @@ const CONTRACT = deepFreeze({
   //    showing, the app's appearance preference, `canSwitch` and
   //    `setPreference`, backed by the optional `appearance` host slice. Hosts
   //    without it read light / false.
-  version: "1.206.0",
+  // 1.207.0: additive (sc-12198) — `resolveTopBarTokens().tabAlignment` is
+  //    "left" | "center" | "right" again; "center" centres the tabs.
+  version: "1.207.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -6368,7 +6368,9 @@ const CONTRACT = deepFreeze({
   //    showing, the app's appearance preference, `canSwitch` and
   //    `setPreference`, backed by the optional `appearance` host slice. Hosts
   //    without it read light / false.
-  version: "1.206.0",
+  // 1.207.0: additive (sc-12198) — `resolveTopBarTokens().tabAlignment` is
+  //    "left" | "center" | "right" again; "center" centres the tabs.
+  version: "1.207.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/host.d.ts

@@ -409,7 +409,7 @@ export interface TopBarTokens {
    *  current tab so the page shows through it. */
   tabStyle: "underline" | "attached";
   /** Where the row's tabs sit across its width; `left` unless authored. */
-  tabAlignment: "left" | "right";
+  tabAlignment: "left" | "center" | "right";
   /** The column the tabs sit in: the whole bar, or the page content's. The
    *  bar's surface spans the full width either way. */
   tabRowWidth: "full" | "content";

package/dist/navigation.cjs

@@ -566,11 +566,8 @@ function resolveTopStripeLayout(theme) {
     // reading the bar; so does the SITE header, which is shown instead of this
     // row rather than beside it.
     //
-    // The notification bell is the one member of `slots` this does not reach.
-    // It keeps its own resting colour on both hosts — web reads the authored
-    // `topBar.textColor` and the export tints it not at all — and moving it
-    // here would widen that difference rather than close it. Whoever closes it
-    // should move both hosts at once.
+    // The notification bell is one of the row's icons and takes this tint on
+    // both hosts; the bells outside the row keep the bar's.
     tintColor: hexOr(stripe.textColor, barTokens.tintColor),
     titleColor: hexOr(stripe.textColor, barTokens.titleColor),
     order,
@@ -617,7 +614,7 @@ function resolveAppLogo(logo, darkSurfaceLogo, onDark) {
   return onDark && darkSurfaceLogo ? darkSurfaceLogo : logo;
 }
 
-const TAB_ALIGNMENTS = ["left", "right"];
+const TAB_ALIGNMENTS = ["left", "center", "right"];
 const TAB_ROW_WIDTHS = ["full", "content"];
 
 function resolveTopBarTokens(theme) {

package/dist/navigation.js

@@ -557,11 +557,8 @@ export function resolveTopStripeLayout(theme) {
     // reading the bar; so does the SITE header, which is shown instead of this
     // row rather than beside it.
     //
-    // The notification bell is the one member of `slots` this does not reach.
-    // It keeps its own resting colour on both hosts — web reads the authored
-    // `topBar.textColor` and the export tints it not at all — and moving it
-    // here would widen that difference rather than close it. Whoever closes it
-    // should move both hosts at once.
+    // The notification bell is one of the row's icons and takes this tint on
+    // both hosts; the bells outside the row keep the bar's.
     tintColor: hexOr(stripe.textColor, barTokens.tintColor),
     titleColor: hexOr(stripe.textColor, barTokens.titleColor),
     order,
@@ -608,7 +605,7 @@ export function resolveAppLogo(logo, darkSurfaceLogo, onDark) {
   return onDark && darkSurfaceLogo ? darkSurfaceLogo : logo;
 }
 
-const TAB_ALIGNMENTS = ["left", "right"];
+const TAB_ALIGNMENTS = ["left", "center", "right"];
 const TAB_ROW_WIDTHS = ["full", "content"];
 
 export function resolveTopBarTokens(theme) {

package/package.json

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

package/src/contract.js

@@ -6368,7 +6368,9 @@ const CONTRACT = deepFreeze({
   //    showing, the app's appearance preference, `canSwitch` and
   //    `setPreference`, backed by the optional `appearance` host slice. Hosts
   //    without it read light / false.
-  version: "1.206.0",
+  // 1.207.0: additive (sc-12198) — `resolveTopBarTokens().tabAlignment` is
+  //    "left" | "center" | "right" again; "center" centres the tabs.
+  version: "1.207.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,