@taprootio/espalier 2.0.2 → 2.1.1

package/espalier.token-manifest.json

@@ -842,6 +842,18 @@
       "component": "esp-header",
       "description": "The height of compact scroll-reactive headers. Defaults to `max(44px, calc(3.5 * var(--esp-size-small)))`."
     },
+    {
+      "name": "--esp-header-content-lead",
+      "category": "component",
+      "component": "esp-header",
+      "description": "Surface-alignment contract set by `esp-page`: the fraction of the leftover width placed before the content, aligning it (`0` = start, `0.5` = center, `1` = end). Defaults to `0`."
+    },
+    {
+      "name": "--esp-header-content-max-width",
+      "category": "component",
+      "component": "esp-header",
+      "description": "Surface-alignment contract set by `esp-page`: the maximum width the bar content is constrained to (the bar background stays full-bleed). Defaults to `100%` (no constraint). `esp-page` sets this to its resolved content cap."
+    },
     {
       "name": "--esp-header-extended-menu-border",
       "category": "component",
@@ -1219,7 +1231,7 @@
       "name": "--esp-page-background",
       "category": "component",
       "component": "esp-page",
-      "description": "The background color of the page. Defaults to `var(--esp-color-background)`."
+      "description": "The background color of the page. Fills both the surface and the canvas gutters; the canvas tokens paint over it in the gutters only. Defaults to `var(--esp-color-background)`."
     },
     {
       "name": "--esp-page-background-image",
@@ -1231,6 +1243,24 @@
       "category": "root-theme",
       "description": "The opacity of the background image layer. Defaults to `1`."
     },
+    {
+      "name": "--esp-page-canvas-background",
+      "category": "component",
+      "component": "esp-page",
+      "description": "The background color of the canvas gutters (the outer regions revealed when the viewport exceeds the cap). Defaults to `transparent`, so gutters match the page until styled and narrow viewports are unaffected."
+    },
+    {
+      "name": "--esp-page-canvas-background-image",
+      "category": "component",
+      "component": "esp-page",
+      "description": "A background image for the canvas gutters, mirroring the page background-image knob. Defaults to `none`."
+    },
+    {
+      "name": "--esp-page-canvas-background-image-opacity",
+      "category": "component",
+      "component": "esp-page",
+      "description": "The opacity of the canvas gutter image layer. Defaults to `1`."
+    },
     {
       "name": "--esp-page-fixed-header-offset",
       "category": "component",
@@ -1247,7 +1277,7 @@
       "name": "--esp-page-max-width",
       "category": "component",
       "component": "esp-page",
-      "description": "The maximum width of the main content well. Set automatically by the `kind` attribute: `1536px` (wide), `768px` (narrow), or `none` (full)."
+      "description": "The maximum width of the main content well. Set automatically by the `kind` attribute: `1536px` (wide), `768px` (narrow), or `none` (full). This cap now sizes the main grid track; surplus width beyond it becomes the canvas gutters."
     },
     {
       "name": "--esp-page-sticky-header-top",
@@ -1255,6 +1285,18 @@
       "component": "esp-page",
       "description": "Top inset for sticky headers. Defaults to `0`."
     },
+    {
+      "name": "--esp-page-surface-border",
+      "category": "component",
+      "component": "esp-page",
+      "description": "An optional border on the inline edges of the surface, for themes preferring a hairline over a shadow. Defaults to `none` (e.g. `1px solid var(--esp-color-border)`)."
+    },
+    {
+      "name": "--esp-page-surface-shadow",
+      "category": "component",
+      "component": "esp-page",
+      "description": "The box shadow drawn on the left and right edges of the content surface. On by default; casts into the gutters and is clipped away when the surface fills the viewport, so it only shows above the cap. Set to `none` to remove it."
+    },
     {
       "name": "--esp-progress-border-color",
       "category": "component",

package/licenses/ASSET_PROVENANCE.md

@@ -14,6 +14,8 @@ removing, or replacing non-code assets.
 | `dist/shared/virtualizer/**` | Vendored Lit Virtualizer runtime source compiled into Espalier's package. | `licenses/THIRD_PARTY_NOTICES.md` |
 | Brand favicons/logos | Taproot-owned Espalier brand assets. | None |
 | Demo textures | Taproot-owned generated PNG textures created for this repository. | None |
+| `assets/canvas-bg.jpg` | Docs-only light canvas texture — Envato Elements item "Seamless Pattern Design With Colorful Flowers" by yusufdemirci; certificate `licenses/license_certificate_A2BVZ6Y9DN.pdf`; attribution not required; kept out of the published `@taprootio/espalier` package. | None |
+| `assets/canvas-bg-dark.jpg` | Docs-only dark canvas texture — Envato Elements item "Nocturnal Garden Pattern" by Webvilla; certificate `licenses/license_certificate_HF5ZVPRNC2.pdf`; attribution not required; kept out of the published package. | None |
 | Demo JSON data | Taproot-authored fictitious samples or standards-derived factual color data. | None |
 
 ## Texture Replacement

package/licenses/asset-provenance.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "updatedAt": "2026-06-30",
+  "updatedAt": "2026-07-11",
   "entries": [
     {
       "id": "google-font-preview-assets",
@@ -211,6 +211,44 @@
       "noticeRequirement": "none",
       "noticePaths": [],
       "reviewStatus": "documented"
+    },
+    {
+      "id": "envato-canvas-background-texture",
+      "paths": [
+        "assets/canvas-bg.jpg"
+      ],
+      "assetType": "decorative floral background texture (JPEG, 400x400 seamless tile)",
+      "classification": "third-party licensed",
+      "owner": "Envato Elements author \"yusufdemirci\" retains ownership; licensed to Jereme Evans / Taproot under an Envato Elements subscription",
+      "source": "Envato Elements item \"Seamless Pattern Design With Colorful Flowers\" (item id ab0dc3dd-7d36-44be-9898-d148173189da, https://app.envato.com/item/ab0dc3dd-7d36-44be-9898-d148173189da), downloaded 2026-07-11 under an active subscription. License certificate A2BVZ6Y9DN on file at licenses/license_certificate_A2BVZ6Y9DN.pdf.",
+      "license": "Envato Elements subscription license (certificate A2BVZ6Y9DN): broad commercial use permitted and attribution is not required for this use. The author retains ownership; the item (or any product using it) may not be trademarked or claimed as Taproot-owned, and it must not be redistributed so that others can extract it. Valid only while the Envato subscription remains active.",
+      "transformations": [
+        "None; used as-is as a repeating docs-site canvas gutter background at 50% image-layer opacity"
+      ],
+      "packageInclusion": "not included in npm package",
+      "docsInclusion": "docs-site only — referenced as --esp-page-canvas-background-image in css/docs.css (which the public @taprootio/espalier package excludes) and served from the Eleventy /assets passthrough",
+      "noticeRequirement": "none",
+      "noticePaths": [],
+      "reviewStatus": "documented"
+    },
+    {
+      "id": "envato-canvas-background-texture-dark",
+      "paths": [
+        "assets/canvas-bg-dark.jpg"
+      ],
+      "assetType": "decorative dark botanical background texture (JPEG, 500x500 seamless tile)",
+      "classification": "third-party licensed",
+      "owner": "Envato Elements author \"Webvilla\" retains ownership; licensed to Jereme Evans / Taproot under an Envato Elements subscription",
+      "source": "Envato Elements item \"Nocturnal Garden Pattern\" (item id df520f04-5dfb-41c3-aa87-2ce3c03c8c34, https://app.envato.com/item/df520f04-5dfb-41c3-aa87-2ce3c03c8c34), downloaded 2026-07-11 under an active subscription as the dark-mode counterpart to canvas-bg.jpg. License certificate HF5ZVPRNC2 on file at licenses/license_certificate_HF5ZVPRNC2.pdf.",
+      "license": "Envato Elements subscription license (certificate HF5ZVPRNC2), same terms as canvas-bg.jpg: broad commercial use permitted and attribution not required; author retains ownership, no trademark/ownership claims, no redistribution for extraction, valid only while the subscription is active.",
+      "transformations": [
+        "None; used as-is as a repeating docs-site dark-mode canvas gutter background at 50% image-layer opacity"
+      ],
+      "packageInclusion": "not included in npm package",
+      "docsInclusion": "docs-site only — referenced as --esp-page-canvas-background-image under esp-root[scheme=\"dark\"] in css/docs.css (excluded from the public @taprootio/espalier package) and served from the Eleventy /assets passthrough",
+      "noticeRequirement": "none",
+      "noticePaths": [],
+      "reviewStatus": "documented"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/espalier",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "Espalier — a themeable, accessible, framework-agnostic, enterprise-grade design system built on web standards and love.",
   "customElements": "custom-elements.json",
   "type": "module",