@taprootio/espalier 4.3.0 → 4.5.0

package/dist/tabs/esp-tab.js

@@ -1,4 +1,4 @@
-var l=function(s,e,o,r){var p=arguments.length,a=p<3?e:r===null?r=Object.getOwnPropertyDescriptor(e,o):r,n;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(s,e,o,r);else for(var d=s.length-1;d>=0;d--)(n=s[d])&&(a=(p<3?n(a):p>3?n(e,o,a):n(e,o))||a);return p>3&&a&&Object.defineProperty(e,o,a),a};import{css as f,html as u}from"lit";import{customElement as c,property as i}from"lit/decorators.js";import{EspalierElementBase as b}from"../shared/esp-element-base.js";let t=class extends b{constructor(){super(...arguments),this.label="",this.active=!1,this.disabled=!1,this.panelId="",this.ariaLabelledBy=""}updated(e){super.updated(e),(e.has("label")||e.has("active")||e.has("disabled"))&&this.dispatchEvent(new CustomEvent("esp-internal-tab-updated",{bubbles:!0,composed:!0}))}render(){return u`
+var l=function(i,e,o,r){var p=arguments.length,a=p<3?e:r===null?r=Object.getOwnPropertyDescriptor(e,o):r,n;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")a=Reflect.decorate(i,e,o,r);else for(var d=i.length-1;d>=0;d--)(n=i[d])&&(a=(p<3?n(a):p>3?n(e,o,a):n(e,o))||a);return p>3&&a&&Object.defineProperty(e,o,a),a};import{css as f,html as c}from"lit";import{customElement as v,property as s}from"lit/decorators.js";import{EspalierElementBase as b}from"../shared/esp-element-base.js";let t=class extends b{constructor(){super(...arguments),this.label="",this.active=!1,this.disabled=!1,this.panelId="",this.ariaLabelledBy=""}updated(e){super.updated(e),(e.has("label")||e.has("active")||e.has("disabled"))&&this.dispatchEvent(new CustomEvent("esp-internal-tab-updated",{bubbles:!0,composed:!0}))}render(){return c`
       <div
         part="panel"
         role="tabpanel"
@@ -19,9 +19,12 @@ var l=function(s,e,o,r){var p=arguments.length,a=p<3?e:r===null?r=Object.getOwnP
 
       [part="panel"] {
         padding: var(--esp-tab-size-padding, var(--esp-size-padding));
-        font-family: var(--esp-font-body);
+        font-family: var(
+          --_esp-font-body-effective,
+          var(--esp-font-body, var(--_esp-font-body-fallback))
+        );
         font-size: var(--esp-size-font);
         color: var(--esp-color-text);
         outline: none;
       }
-    `],l([i({type:String})],t.prototype,"label",void 0),l([i({type:Boolean,reflect:!0})],t.prototype,"active",void 0),l([i({type:Boolean,reflect:!0})],t.prototype,"disabled",void 0),l([i({attribute:!1})],t.prototype,"panelId",void 0),l([i({attribute:!1})],t.prototype,"ariaLabelledBy",void 0),t=l([c("esp-tab")],t);export{t as EspalierTab};
+    `],l([s({type:String})],t.prototype,"label",void 0),l([s({type:Boolean,reflect:!0})],t.prototype,"active",void 0),l([s({type:Boolean,reflect:!0})],t.prototype,"disabled",void 0),l([s({attribute:!1})],t.prototype,"panelId",void 0),l([s({attribute:!1})],t.prototype,"ariaLabelledBy",void 0),t=l([v("esp-tab")],t);export{t as EspalierTab};

package/dist/tree/esp-tree.js

@@ -264,7 +264,10 @@ var d=function(c,e,t,i){var s=arguments.length,o=s<3?e:i===null?i=Object.getOwnP
       }
 
       .tree {
-        font-family: var(--esp-font-body);
+        font-family: var(
+          --_esp-font-body-effective,
+          var(--esp-font-body, var(--_esp-font-body-fallback))
+        );
         font-size: var(--esp-size-font);
         color: var(--esp-color-text);
         display: grid;

package/espalier.css-data.json

@@ -543,19 +543,19 @@
     },
     {
       "name": "--esp-font-body",
-      "description": ""
+      "description": "Always-emitted family for body and UI text. Defaults to `system-ui, sans-serif` when `fontBody` is omitted or empty."
     },
     {
       "name": "--esp-font-brand",
-      "description": ""
+      "description": "Consumer-authored brand family. Emitted only when configured; brand recipes otherwise fall back through headings to `--esp-font-body`."
     },
     {
       "name": "--esp-font-headings",
-      "description": ""
+      "description": "Consumer-authored heading family. Emitted only when configured; heading recipes otherwise fall back to `--esp-font-body`."
     },
     {
       "name": "--esp-font-monospace",
-      "description": ""
+      "description": "Family for code and monospace text. Defaults to `monospace`."
     },
     {
       "name": "--esp-font-weight-body",
@@ -807,7 +807,7 @@
     },
     {
       "name": "--esp-header-brand-font-family",
-      "description": "The configured brand font family. Defaults to `var(--esp-font-brand, var(--esp-font-headings))`."
+      "description": "The configured brand font family. Defaults through `--esp-font-brand` and `--esp-font-headings` to `--esp-font-body`."
     },
     {
       "name": "--esp-header-brand-font-size",
@@ -833,6 +833,10 @@
       "name": "--esp-header-brand-hover-decoration",
       "description": "The configured brand hover text decoration. Defaults to `none`."
     },
+    {
+      "name": "--esp-header-brand-hover-transform",
+      "description": "The configured brand hover transform. Defaults to `none`."
+    },
     {
       "name": "--esp-header-brand-inline-placement",
       "description": "The CSS `justify-content` value for the brand container. Defaults to `start`."

package/espalier.token-manifest.json

@@ -737,22 +737,24 @@
     {
       "name": "--esp-font-body",
       "category": "root-theme",
-      "description": ""
+      "description": "Always-emitted family for body and UI text. Defaults to `system-ui, sans-serif` when `fontBody` is omitted or empty.",
+      "default": "system-ui, sans-serif"
     },
     {
       "name": "--esp-font-brand",
       "category": "root-theme",
-      "description": ""
+      "description": "Consumer-authored brand family. Emitted only when configured; brand recipes otherwise fall back through headings to `--esp-font-body`."
     },
     {
       "name": "--esp-font-headings",
       "category": "root-theme",
-      "description": ""
+      "description": "Consumer-authored heading family. Emitted only when configured; heading recipes otherwise fall back to `--esp-font-body`."
     },
     {
       "name": "--esp-font-monospace",
       "category": "root-theme",
-      "description": ""
+      "description": "Family for code and monospace text. Defaults to `monospace`.",
+      "default": "monospace"
     },
     {
       "name": "--esp-font-weight-body",
@@ -1126,7 +1128,7 @@
       "name": "--esp-header-brand-font-family",
       "category": "component",
       "component": "esp-header",
-      "description": "The configured brand font family. Defaults to `var(--esp-font-brand, var(--esp-font-headings))`."
+      "description": "The configured brand font family. Defaults through `--esp-font-brand` and `--esp-font-headings` to `--esp-font-body`."
     },
     {
       "name": "--esp-header-brand-font-size",
@@ -1164,6 +1166,12 @@
       "component": "esp-header",
       "description": "The configured brand hover text decoration. Defaults to `none`."
     },
+    {
+      "name": "--esp-header-brand-hover-transform",
+      "category": "component",
+      "component": "esp-header",
+      "description": "The configured brand hover transform. Defaults to `none`."
+    },
     {
       "name": "--esp-header-brand-inline-placement",
       "category": "component",

package/licenses/ASSET_PROVENANCE.md

@@ -8,7 +8,8 @@ removing, or replacing non-code assets.
 
 | Asset area | Provenance | Notice |
 |------------|------------|--------|
-| `css/fonts/**` | Generated Google Fonts preview CSS with per-family notices generated from upstream Google Fonts metadata links. | `licenses/GOOGLE_FONTS_NOTICES.md` |
+| `css/fonts/*.css`, `css/fonts/font-definitions.json` | Generated Google Fonts preview CSS and catalog with per-family notices generated from upstream Google Fonts metadata links. | `licenses/GOOGLE_FONTS_NOTICES.md` |
+| `css/fonts/font-fallback-profiles.json` | Variant metrics derived from `@capsizecss/metrics` with `@capsizecss/core`, serialized by Taproot's deterministic maintainer generator. | `licenses/THIRD_PARTY_NOTICES.md` |
 | `assets/shell-fonts.css`, `assets/shell-fonts/**` | Docs-only self-hosted Quicksand, Oswald, and Sometype Mono WOFF2 subsets under OFL 1.1, downloaded once from the Google Fonts css2 endpoint and checked in so the documentation shell never calls Google at runtime. | `licenses/THIRD_PARTY_NOTICES.md` |
 | `assets/icons.svg` | Tabler-derived SVG symbols plus Taproot-owned logo symbol. | `licenses/THIRD_PARTY_NOTICES.md` |
 | `*.ts` | Inline Tabler-style SVG templates and Taproot rendering helpers. | `licenses/THIRD_PARTY_NOTICES.md` |

package/licenses/THIRD_PARTY_NOTICES.md

@@ -76,6 +76,41 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+## Capsize Font Metrics
+
+`css/fonts/font-fallback-profiles.json` is generated from the Google and system
+font metrics distributed by `@capsizecss/metrics`, using the calculations in
+`@capsizecss/core`. The packages are maintainer-only dependencies; their
+derived variant metrics are included in the published profile catalog.
+
+- Project: Capsize
+- Upstream: https://github.com/seek-oss/capsize
+- Packages: `@capsizecss/metrics` 4.2.0 and `@capsizecss/core` 4.1.3
+- License: MIT License
+- Copyright: Copyright (c) 2021 SEEK
+
+MIT License
+
+Copyright (c) 2021 SEEK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 ## Documentation Shell Fonts
 
 The Espalier documentation site self-hosts the three faces its theme names, so

package/licenses/asset-provenance.json

@@ -1,11 +1,12 @@
 {
   "schemaVersion": 1,
-  "updatedAt": "2026-08-22",
+  "updatedAt": "2026-08-28",
   "entries": [
     {
       "id": "google-font-preview-assets",
       "paths": [
-        "css/fonts/**"
+        "css/fonts/*.css",
+        "css/fonts/font-definitions.json"
       ],
       "assetType": "generated font preview assets",
       "classification": "third-party-generated",
@@ -25,6 +26,29 @@
       ],
       "reviewStatus": "manifest-gated"
     },
+    {
+      "id": "capsize-font-fallback-profiles",
+      "paths": [
+        "css/fonts/font-fallback-profiles.json"
+      ],
+      "assetType": "generated font metric profile catalog",
+      "classification": "third-party-derived",
+      "owner": "SEEK for Capsize metrics and calculations; Taproot for catalog serialization",
+      "source": "@capsizecss/metrics 4.2.0 and @capsizecss/core 4.1.3",
+      "license": "MIT License",
+      "transformations": [
+        "Join the committed Google Fonts catalog to Capsize family, variant, and system fallback metrics",
+        "Calculate subset-specific size-adjust and vertical metric overrides",
+        "Encode the selected fallback variants and bounded-precision percentages as deterministic JSON"
+      ],
+      "packageInclusion": "included in npm package for host build tooling; never required by the browser runtime",
+      "docsInclusion": "documented as the build-time source for site-specific inline font plans",
+      "noticeRequirement": "required",
+      "noticePaths": [
+        "licenses/THIRD_PARTY_NOTICES.md"
+      ],
+      "reviewStatus": "manifest-gated"
+    },
     {
       "id": "tabler-svg-sprite",
       "paths": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/espalier",
-  "version": "4.3.0",
+  "version": "4.5.0",
   "packageManager": "bun@1.3.12",
   "description": "Espalier — a themeable, accessible, framework-agnostic, enterprise-grade design system built on web standards and love.",
   "customElements": "custom-elements.json",
@@ -313,6 +313,10 @@
       "types": "./dist/shared/font-helpers.d.ts",
       "import": "./dist/shared/font-helpers.js"
     },
+    "./shared/font-plan": {
+      "types": "./dist/shared/font-plan.d.ts",
+      "import": "./dist/shared/font-plan.js"
+    },
     "./shared/cursor-pagination": {
       "types": "./dist/shared/cursor-pagination.d.ts",
       "import": "./dist/shared/cursor-pagination.js"
@@ -337,7 +341,17 @@
       "types": "./dist/shared/bus-events.d.ts",
       "import": "./dist/shared/bus-events.js"
     },
+    "./shared/events": {
+      "types": "./dist/shared/events.d.ts",
+      "import": "./dist/shared/events.js"
+    },
+    "./shared/toast-events": {
+      "types": "./dist/shared/toast-events.d.ts",
+      "import": "./dist/shared/toast-events.js"
+    },
     "./espalier.token-manifest.json": "./espalier.token-manifest.json",
+    "./css/fonts/font-definitions.json": "./css/fonts/font-definitions.json",
+    "./css/fonts/font-fallback-profiles.json": "./css/fonts/font-fallback-profiles.json",
     "./textures/banner-textures.css": "./css/textures/banner-textures.css",
     "./textures/espalier-paper.png": "./css/textures/espalier-paper.png",
     "./textures/espalier-grain.png": "./css/textures/espalier-grain.png",
@@ -345,7 +359,6 @@
     "./custom-elements.json": "./custom-elements.json",
     "./espalier.css-data.json": "./espalier.css-data.json",
     "./css/esp-reset.css": "./css/esp-reset.css",
-    "./css/fonts/font-definitions.json": "./css/fonts/font-definitions.json",
     "./css/fonts/*.css": "./css/fonts/*.css"
   },
   "sideEffects": [
@@ -362,6 +375,7 @@
     "css/esp-reset.css",
     "css/fonts/**/*.css",
     "css/fonts/font-definitions.json",
+    "css/fonts/font-fallback-profiles.json",
     "css/textures/banner-textures.css",
     "css/textures/*.png",
     "custom-elements.json",