@taprootio/site-authoring 0.5.0 → 0.6.0

package/examples/riverbend-wellness/settings/taproot-styles.json

@@ -716,10 +716,6 @@
       "viewportMin": 320
     },
     "defaultScheme": "system",
-    "fontBrand": "",
-    "fontWeightBrand": "",
-    "fontMenu": "",
-    "fontWeightMenu": "",
     "lightLogoId": "a0000000-0000-4000-8000-0000000000a0",
     "darkLogoId": "a0000000-0000-4000-8000-0000000000a1",
     "lightCanvasImageId": "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/site-authoring",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Taproot site authoring CLI: sign in once in the browser, then pull, validate, push, preview, approve, and deploy a site from the terminal",
   "type": "module",
   "license": "ISC",
@@ -28,7 +28,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@taprootio/espalier": "4.8.0"
+    "@taprootio/espalier": "4.9.0"
   },
   "scripts": {
     "test": "node --test",

package/src/appearance-contract.js

@@ -26,34 +26,6 @@ export const APPEARANCE_SCALAR_FIELDS = Object.freeze([
     values: Object.freeze(["system", "light", "dark"]),
     default: "light",
   }),
-  Object.freeze({
-    settingsType: SETTINGS_TYPE_TAPROOT_STYLES,
-    name: "fontBrand",
-    path: "taproot-styles.fontBrand",
-    type: "string",
-    default: "",
-  }),
-  Object.freeze({
-    settingsType: SETTINGS_TYPE_TAPROOT_STYLES,
-    name: "fontWeightBrand",
-    path: "taproot-styles.fontWeightBrand",
-    type: "string",
-    default: "",
-  }),
-  Object.freeze({
-    settingsType: SETTINGS_TYPE_TAPROOT_STYLES,
-    name: "fontMenu",
-    path: "taproot-styles.fontMenu",
-    type: "string",
-    default: "",
-  }),
-  Object.freeze({
-    settingsType: SETTINGS_TYPE_TAPROOT_STYLES,
-    name: "fontWeightMenu",
-    path: "taproot-styles.fontWeightMenu",
-    type: "string",
-    default: "",
-  }),
   ...["lightLogoId", "darkLogoId", "lightCanvasImageId", "darkCanvasImageId"].map((name) =>
     Object.freeze({
       settingsType: SETTINGS_TYPE_TAPROOT_STYLES,
@@ -186,6 +158,33 @@ export const APPEARANCE_SCALAR_FIELDS = Object.freeze([
   ),
 ]);
 
+// TR00728: these four scalars were retired in favor of per-scheme theme
+// properties (docs/architecture/decisions/site-fonts-are-per-scheme-theme-properties.md).
+// There is no compatibility read path: a workspace pulled before the change
+// can still carry them at the top level of the styles document, and the
+// owner must move each value into lightTheme/darkTheme by hand rather than
+// have it silently discarded. Declaration order is refusal order.
+const RETIRED_TAPROOT_STYLES_SCALARS = Object.freeze([
+  "fontBrand",
+  "fontWeightBrand",
+  "fontMenu",
+  "fontWeightMenu",
+]);
+
+function refuseRetiredScalarFonts(stylesDocument) {
+  if (stylesDocument === null || typeof stylesDocument !== "object") return;
+  for (const name of RETIRED_TAPROOT_STYLES_SCALARS) {
+    if (Object.hasOwn(stylesDocument, name)) {
+      fail(
+        "appearance.retired_scalar",
+        `taproot-styles.${name} is retired; move its value into lightTheme.${name} and darkTheme.${name} `
+          + "instead. Fonts are per-scheme theme properties now.",
+        `taproot-styles.${name}`,
+      );
+    }
+  }
+}
+
 export const APPEARANCE_READ_ONLY_FIELDS = Object.freeze([
   Object.freeze({ file: APPEARANCE_FILES[SETTINGS_TYPE_TAPROOT_STYLES], path: "settings.lightLogoUrl" }),
   Object.freeze({ file: APPEARANCE_FILES[SETTINGS_TYPE_TAPROOT_STYLES], path: "settings.darkLogoUrl" }),
@@ -297,6 +296,7 @@ export function buildAppearanceScalarOperations(documents, knownImageIds) {
   if (!(knownImageIds instanceof Set)) {
     throw new TypeError("Appearance validation requires the known site-owned image identities.");
   }
+  refuseRetiredScalarFonts(documents[SETTINGS_TYPE_TAPROOT_STYLES]);
   return APPEARANCE_SCALAR_FIELDS.map((definition) => ({
     settingsType: definition.settingsType,
     setting: definition.name,

package/src/constants.js

@@ -1,5 +1,5 @@
 export const CLI_NAME = "@taprootio/site-authoring";
-export const CLI_VERSION = "0.5.0";
+export const CLI_VERSION = "0.6.0";
 export const CLI_BINARY_NAME = "taproot-site";
 export const RESULT_SCHEMA_VERSION = 1;
 export const CONFIG_FILE_NAME = "taproot-site.json";

package/src/content/components.js

@@ -253,6 +253,8 @@ const IMAGE_BANNER = Object.freeze({
   scrim: enumOf("auto", "none", "flat", "top", "bottom", "left", "right", "radial"),
   scrimStrength: enumOf("soft", "medium", "strong"),
   bannerScheme: enumOf("auto", "light", "dark"),
+  // Drop-shadow strength applied to the overlay text.
+  textShadow: enumOf("none", "light", "medium", "strong"),
   // A built-in or application-registered Espalier texture name.
   texture: textureName(),
   textureScale: enumOf("fine", "medium", "coarse"),
@@ -486,6 +488,7 @@ const COMPONENT_DEFINITIONS = Object.freeze({
       scrim: "auto",
       scrimStrength: "medium",
       bannerScheme: "auto",
+      textShadow: "none",
       texture: "none",
       textureScale: "medium",
     },

package/src/presentation-reference.js

@@ -57,12 +57,6 @@ function getEspalierVersion() {
 
 const OPTIONAL_THEME_FIELDS = Object.freeze([
   "explicitMappingTokens",
-  // Espalier 4.7.0 menu typography: documented so the theme help covers the
-  // installed contract, optional so pulled baselines that predate it stay
-  // complete (the server seeds and requires the fields listed in
-  // DefaultSiteTheme.RequiredProperties only).
-  "fontMenu",
-  "fontWeightMenu",
   "boxBackgroundImage",
   "boxBackgroundImageOpacity",
   "vellumOpacity",
@@ -350,11 +344,12 @@ export function getAppearanceReference() {
       "navDrawerStyle 'full-screen' (the published default) opens the mobile menu over the whole viewport with the "
       + "brand centered above large centered items and navDrawerTransition choosing how it appears (fade, slide-down, "
       + "slide-up, slide-left, or slide-right); 'panel' keeps the side panel, which exists for application-style "
-      + "menus with many groups. fontMenu and fontWeightMenu set the navigation face the way fontBrand sets the "
-      + "brand; an empty fontMenu falls back to the body font, never to headings.",
+      + "menus with many groups. The navigation face itself is not an appearance scalar: fontMenu and fontWeightMenu "
+      + "are per-scheme theme fields set in settings.lightTheme/darkTheme the same way fontBrand is, and an empty "
+      + "fontMenu falls back to the body font, never to headings.",
     mutationOrder: [
       "fresh footer read plus concurrency-protected ten-color overlay",
-      "default scheme, brand fonts and assets, favicon, and header scalars",
+      "default scheme, assets, favicon, and header scalars",
       "complete light theme, then complete dark theme",
     ],
     nonAtomic: true,

package/src/reference-help.js

@@ -56,7 +56,7 @@ import {
 
 export { getAppearanceReference, getFooterReference, getThemeReference };
 
-export const REFERENCE_VERSION = 18;
+export const REFERENCE_VERSION = 19;
 export const PAGE_TYPES = Object.freeze(["free-form"]);
 export const REFERENCE_TOPICS = Object.freeze([
   Object.freeze({ name: "pages", usage: `${CLI_BINARY_NAME} help pages`, summary: "List authorable page types." }),

package/src/settings-catalog.js

@@ -56,10 +56,6 @@ export const SETTINGS_GROUPS = Object.freeze([
       { name: "darkTheme", wireType: "theme" },
       ...stringFields(
         "defaultScheme",
-        "fontBrand",
-        "fontWeightBrand",
-        "fontMenu",
-        "fontWeightMenu",
         "lightLogoId",
         "lightLogoUrl",
         "darkLogoId",

package/src/theme-validation.js

@@ -44,10 +44,12 @@ export const REQUIRED_THEME_PROPERTIES = Object.freeze([
   "fontHeadings",
   "fontBrand",
   "fontMonospace",
+  "fontMenu",
   "fontWeightBody",
   "fontWeightHeadings",
   "fontWeightBrand",
   "fontWeightMonospace",
+  "fontWeightMenu",
 ]);
 
 const REQUIRED_ANGLE_LEAVES = Object.freeze([