@riverbankcms/sdk 0.4.3 → 0.5.1

package/dist/client/client.mjs

@@ -872,7 +872,7 @@ function parseToken(source) {
   if (source.includes("/")) {
     const [token, opacity] = source.split("/");
     const alpha = Number(opacity) / 100;
-    if (!Number.isNaN(alpha)) {
+    if (!Number.isNaN(alpha) && token) {
       return { token, alpha };
     }
     return { token: source };
@@ -912,7 +912,8 @@ function headingGroup(opts) {
     containerClass = "text-center",
     className,
     eyebrowClass = "heading-eyebrow text-sm font-semibold tracking-wide",
-    titleClass = "heading-title text-3xl font-semibold sm:text-4xl",
+    // h2 now gets size/weight from theme typography CSS
+    titleClass = "heading-title",
     eyebrowStyle = textColorStyle("neutral-500"),
     titleStyle = textColorStyle("neutral-900")
   } = opts;
@@ -1493,6 +1494,8 @@ var bodyCopyFragment = defineFragment({
       text(
         {
           as: "h2",
+          // h2 now gets size/weight from theme typography CSS
+          // Only dynamic class here is for text alignment
           className: {
             $bind: {
               from: "content.alignment",
@@ -1500,11 +1503,11 @@ var bodyCopyFragment = defineFragment({
                 {
                   id: "ui.headingClassFromAlignment",
                   options: {
-                    base: "text-3xl font-semibold sm:text-4xl"
+                    base: ""
                   }
                 }
               ],
-              fallback: "text-3xl font-semibold sm:text-4xl"
+              fallback: ""
             }
           },
           style: textColorStyle("neutral-900")
@@ -1577,7 +1580,9 @@ var heroCopyFragment = defineFragment({
     text(
       {
         as: "h1",
-        className: "hero-headline text-4xl font-semibold sm:text-5xl md:text-6xl",
+        // heading-display: uses fluid typography from theme (--fs-h1-display-fluid)
+        // Removes hardcoded text-4xl/5xl/6xl - size now controlled by theme
+        className: "hero-headline heading-display",
         style: textColorStyle("neutral-900")
       },
       bind("content.headline")
@@ -1756,7 +1761,8 @@ var testimonialsHeadingFragment = defineFragment({
       { gap: "md", className: "mx-auto max-w-2xl text-center" },
       [
         text(
-          { as: "h2", className: "text-3xl font-semibold sm:text-4xl", style: textColorStyle("neutral-900") },
+          // h2 now gets size/weight from theme typography CSS
+          { as: "h2", style: textColorStyle("neutral-900") },
           when("content.heading"),
           bind("content.heading")
         ),
@@ -2206,7 +2212,7 @@ var blogFeaturedPostFragment = defineFragment({
           text(
             {
               as: "h2",
-              className: "text-2xl font-semibold md:text-3xl",
+              // h2 now gets size/weight from theme typography CSS
               style: textColorStyle("neutral-900")
             },
             bind("title", { fallback: "Latest post" })
@@ -2603,7 +2609,8 @@ var faqHeadingFragment = defineFragment({
       text(
         {
           as: "h2",
-          className: "faq-title text-3xl font-semibold sm:text-4xl",
+          // h2 now gets size/weight from theme typography CSS
+          className: "faq-title",
           style: textColorStyle("neutral-900")
         },
         when("content.title"),
@@ -4546,7 +4553,11 @@ var simpleFooterLayout = stack(
     }
   },
   [
-    navRow({ align: "center", className: "flex flex-wrap justify-center gap-x-6 gap-y-3" }),
+    navRow({
+      align: "center",
+      className: "flex flex-wrap justify-center gap-x-6 gap-y-3",
+      linkClassName: "footer-nav-link inline-flex items-center px-4 py-2 text-sm font-medium transition-theme-standard"
+    }),
     ...bottomTextLayout()
   ],
   when("$root.theme.footer.variant", { equals: "simple" })
@@ -4574,7 +4585,11 @@ var columnsFooterLayout = stack(
       { className: "flex w-full flex-wrap items-center justify-between gap-4" },
       [
         text({ as: "span", className: "text-sm font-semibold", style: textColorStyle("text") }, bind("site.title", { fallback: "Your Site" })),
-        navRow({ className: "flex flex-wrap justify-end gap-x-6 gap-y-3", align: "end" })
+        navRow({
+          className: "flex flex-wrap justify-end gap-x-6 gap-y-3",
+          align: "end",
+          linkClassName: "footer-nav-link inline-flex items-center px-4 py-2 text-sm font-medium transition-theme-standard"
+        })
       ]
     ),
     ...bottomTextLayout()
@@ -5865,7 +5880,7 @@ function splitPath(path) {
   for (const raw of parts) {
     if (!raw) continue;
     const baseMatch = raw.match(/^([^\[]+)/);
-    if (baseMatch) {
+    if (baseMatch && baseMatch[1]) {
       segments.push(baseMatch[1]);
     }
     const bracketMatches = raw.matchAll(BRACKET_ACCESS_REGEX2);
@@ -6647,6 +6662,10 @@ var resolveLinkTransform = {
       const href = link2.href.trim();
       return href.length > 0 ? href : null;
     }
+    if (!kind && typeof link2.href === "string") {
+      const href = link2.href.trim();
+      return href.length > 0 ? href : null;
+    }
     return null;
   }
 };
@@ -7470,7 +7489,7 @@ var COLUMN_CLASSES = {
   "4": "sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4"
 };
 function formatDateForUrl(isoTimestamp) {
-  return isoTimestamp.split("T")[0];
+  return isoTimestamp.split("T")[0] ?? "";
 }
 function buildEventUrl(basePath, slug, startsAt) {
   const date = formatDateForUrl(startsAt);
@@ -7655,7 +7674,7 @@ function getContainerClass(layout, columns) {
   return `grid gap-6 ${COLUMN_CLASSES2[columns] || COLUMN_CLASSES2["3"]}`;
 }
 function formatDateForUrl2(isoTimestamp) {
-  return isoTimestamp.split("T")[0];
+  return isoTimestamp.split("T")[0] ?? "";
 }
 function buildEventUrl2(basePath, slug, startsAt) {
   const date = formatDateForUrl2(startsAt);
@@ -7874,7 +7893,7 @@ function extractSegmentsFromPart(part) {
   if (!part) return [];
   const segments = [];
   const baseMatch = part.match(/^([^\[]+)/);
-  if (baseMatch) {
+  if (baseMatch && baseMatch[1]) {
     segments.push(baseMatch[1]);
   }
   const bracketMatches = Array.from(part.matchAll(BRACKET_ACCESS_REGEX));
@@ -8840,8 +8859,8 @@ function getLabWhitePoint() {
 var lab2rgb = (...args) => {
   args = unpack_default(args, "lab");
   const [L, a, b] = args;
-  const [x, y, z19] = lab2xyz(L, a, b);
-  const [r2, g, b_] = xyz2rgb(x, y, z19);
+  const [x, y, z20] = lab2xyz(L, a, b);
+  const [r2, g, b_] = xyz2rgb(x, y, z20);
   return [r2, g, b_, args.length > 3 ? args[3] : 1];
 };
 var lab2xyz = (L, a, b) => {
@@ -8856,15 +8875,15 @@ var lab2xyz = (L, a, b) => {
   const zr = fz3 > kE ? fz3 : (116 * fz - 16) / kK;
   const x = xr * Xn;
   const y = yr * Yn;
-  const z19 = zr * Zn;
-  return [x, y, z19];
+  const z20 = zr * Zn;
+  return [x, y, z20];
 };
 var compand = (linear) => {
   const sign = Math.sign(linear);
   linear = Math.abs(linear);
   return (linear <= 31308e-7 ? linear * 12.92 : 1.055 * Math.pow(linear, 1 / 2.4) - 0.055) * sign;
 };
-var xyz2rgb = (x, y, z19) => {
+var xyz2rgb = (x, y, z20) => {
   const { MtxAdaptMa, MtxAdaptMaI, MtxXYZ2RGB, RefWhiteRGB, Xn, Yn, Zn } = lab_constants_default;
   const As = Xn * MtxAdaptMa.m00 + Yn * MtxAdaptMa.m10 + Zn * MtxAdaptMa.m20;
   const Bs = Xn * MtxAdaptMa.m01 + Yn * MtxAdaptMa.m11 + Zn * MtxAdaptMa.m21;
@@ -8872,9 +8891,9 @@ var xyz2rgb = (x, y, z19) => {
   const Ad = RefWhiteRGB.X * MtxAdaptMa.m00 + RefWhiteRGB.Y * MtxAdaptMa.m10 + RefWhiteRGB.Z * MtxAdaptMa.m20;
   const Bd = RefWhiteRGB.X * MtxAdaptMa.m01 + RefWhiteRGB.Y * MtxAdaptMa.m11 + RefWhiteRGB.Z * MtxAdaptMa.m21;
   const Cd = RefWhiteRGB.X * MtxAdaptMa.m02 + RefWhiteRGB.Y * MtxAdaptMa.m12 + RefWhiteRGB.Z * MtxAdaptMa.m22;
-  const X1 = (x * MtxAdaptMa.m00 + y * MtxAdaptMa.m10 + z19 * MtxAdaptMa.m20) * (Ad / As);
-  const Y1 = (x * MtxAdaptMa.m01 + y * MtxAdaptMa.m11 + z19 * MtxAdaptMa.m21) * (Bd / Bs);
-  const Z1 = (x * MtxAdaptMa.m02 + y * MtxAdaptMa.m12 + z19 * MtxAdaptMa.m22) * (Cd / Cs);
+  const X1 = (x * MtxAdaptMa.m00 + y * MtxAdaptMa.m10 + z20 * MtxAdaptMa.m20) * (Ad / As);
+  const Y1 = (x * MtxAdaptMa.m01 + y * MtxAdaptMa.m11 + z20 * MtxAdaptMa.m21) * (Bd / Bs);
+  const Z1 = (x * MtxAdaptMa.m02 + y * MtxAdaptMa.m12 + z20 * MtxAdaptMa.m22) * (Cd / Cs);
   const X2 = X1 * MtxAdaptMaI.m00 + Y1 * MtxAdaptMaI.m10 + Z1 * MtxAdaptMaI.m20;
   const Y2 = X1 * MtxAdaptMaI.m01 + Y1 * MtxAdaptMaI.m11 + Z1 * MtxAdaptMaI.m21;
   const Z2 = X1 * MtxAdaptMaI.m02 + Y1 * MtxAdaptMaI.m12 + Z1 * MtxAdaptMaI.m22;
@@ -8894,15 +8913,15 @@ var lab2rgb_default = lab2rgb;
 // ../../node_modules/.pnpm/chroma-js@3.1.2/node_modules/chroma-js/src/io/lab/rgb2lab.js
 var rgb2lab = (...args) => {
   const [r2, g, b, ...rest] = unpack_default(args, "rgb");
-  const [x, y, z19] = rgb2xyz(r2, g, b);
-  const [L, a, b_] = xyz2lab(x, y, z19);
+  const [x, y, z20] = rgb2xyz(r2, g, b);
+  const [L, a, b_] = xyz2lab(x, y, z20);
   return [L, a, b_, ...rest.length > 0 && rest[0] < 1 ? [rest[0]] : []];
 };
-function xyz2lab(x, y, z19) {
+function xyz2lab(x, y, z20) {
   const { Xn, Yn, Zn, kE, kK } = lab_constants_default;
   const xr = x / Xn;
   const yr = y / Yn;
-  const zr = z19 / Zn;
+  const zr = z20 / Zn;
   const fx = xr > kE ? Math.pow(xr, 1 / 3) : (kK * xr + 16) / 116;
   const fy = yr > kE ? Math.pow(yr, 1 / 3) : (kK * yr + 16) / 116;
   const fz = zr > kE ? Math.pow(zr, 1 / 3) : (kK * zr + 16) / 116;
@@ -8921,20 +8940,20 @@ var rgb2xyz = (r2, g, b) => {
   const { MtxRGB2XYZ, MtxAdaptMa, MtxAdaptMaI, Xn, Yn, Zn, As, Bs, Cs } = lab_constants_default;
   let x = r2 * MtxRGB2XYZ.m00 + g * MtxRGB2XYZ.m10 + b * MtxRGB2XYZ.m20;
   let y = r2 * MtxRGB2XYZ.m01 + g * MtxRGB2XYZ.m11 + b * MtxRGB2XYZ.m21;
-  let z19 = r2 * MtxRGB2XYZ.m02 + g * MtxRGB2XYZ.m12 + b * MtxRGB2XYZ.m22;
+  let z20 = r2 * MtxRGB2XYZ.m02 + g * MtxRGB2XYZ.m12 + b * MtxRGB2XYZ.m22;
   const Ad = Xn * MtxAdaptMa.m00 + Yn * MtxAdaptMa.m10 + Zn * MtxAdaptMa.m20;
   const Bd = Xn * MtxAdaptMa.m01 + Yn * MtxAdaptMa.m11 + Zn * MtxAdaptMa.m21;
   const Cd = Xn * MtxAdaptMa.m02 + Yn * MtxAdaptMa.m12 + Zn * MtxAdaptMa.m22;
-  let X = x * MtxAdaptMa.m00 + y * MtxAdaptMa.m10 + z19 * MtxAdaptMa.m20;
-  let Y = x * MtxAdaptMa.m01 + y * MtxAdaptMa.m11 + z19 * MtxAdaptMa.m21;
-  let Z = x * MtxAdaptMa.m02 + y * MtxAdaptMa.m12 + z19 * MtxAdaptMa.m22;
+  let X = x * MtxAdaptMa.m00 + y * MtxAdaptMa.m10 + z20 * MtxAdaptMa.m20;
+  let Y = x * MtxAdaptMa.m01 + y * MtxAdaptMa.m11 + z20 * MtxAdaptMa.m21;
+  let Z = x * MtxAdaptMa.m02 + y * MtxAdaptMa.m12 + z20 * MtxAdaptMa.m22;
   X *= Ad / As;
   Y *= Bd / Bs;
   Z *= Cd / Cs;
   x = X * MtxAdaptMaI.m00 + Y * MtxAdaptMaI.m10 + Z * MtxAdaptMaI.m20;
   y = X * MtxAdaptMaI.m01 + Y * MtxAdaptMaI.m11 + Z * MtxAdaptMaI.m21;
-  z19 = X * MtxAdaptMaI.m02 + Y * MtxAdaptMaI.m12 + Z * MtxAdaptMaI.m22;
-  return [x, y, z19];
+  z20 = X * MtxAdaptMaI.m02 + Y * MtxAdaptMaI.m12 + Z * MtxAdaptMaI.m22;
+  return [x, y, z20];
 };
 var rgb2lab_default = rgb2lab;
 
@@ -11263,7 +11282,7 @@ function generateShades(hexColor, name) {
       900: 0.1,
       950: 0.05
     };
-    const lightness = lightnessMap[shadeNumber];
+    const lightness = lightnessMap[shadeNumber] ?? 0.5;
     const shadeColor = base.luminance(lightness).hex();
     return {
       name: shadeName,
@@ -11334,7 +11353,7 @@ function expandPalette(palette) {
   if (base.text) expanded.body = base.text;
   const isDark = base.background ? isBackgroundDark(base.background) : false;
   const isDarkMode = palette.meta?.mode === "dark" || isDark;
-  expanded.mutedText = isDarkMode ? expanded["neutral-600"] : expanded["neutral-500"];
+  expanded.mutedText = isDarkMode ? expanded["neutral-600"] ?? "#666" : expanded["neutral-500"] ?? "#888";
   return expanded;
 }
 
@@ -11402,6 +11421,83 @@ function generateShadowCssVars(theme) {
   };
 }
 
+// ../blocks/src/theme/tokens/resolver.ts
+var TokenResolver = class {
+  constructor(theme) {
+    this.theme = theme;
+  }
+  /**
+   * Resolve a color token to a CSS variable reference wrapped in rgb()
+   *
+   * @param token - Token name (e.g., 'primary-500', 'white', 'text-900')
+   * @returns CSS rgb() function with var reference (e.g., 'rgb(var(--tb-primary-500))')
+   *
+   * Note: CSS variables are stored as RGB channels (e.g., "37 99 235") following Tailwind convention,
+   * so we must wrap them with rgb() to create a valid color value.
+   *
+   * @example
+   * resolver.getColor('primary-500') // => 'rgb(var(--tb-primary-500))'
+   * resolver.getColor('white') // => 'rgb(var(--tb-white))'
+   */
+  getColor(token) {
+    if (!this.tokenExists(token)) {
+      console.warn(
+        `[TokenResolver] Color token "${token}" not found in theme palette. Button may render incorrectly.`
+      );
+    }
+    return `rgb(var(--tb-${token}))`;
+  }
+  /**
+   * Adjust a color token's shade by a given amount
+   *
+   * @param token - Base token (e.g., 'primary-500')
+   * @param amount - Shade adjustment (+100 = darker, -100 = lighter)
+   * @returns Adjusted token name (e.g., 'primary-600')
+   *
+   * @example
+   * resolver.adjustShade('primary-500', 100) // => 'primary-600' (darker)
+   * resolver.adjustShade('primary-500', -100) // => 'primary-400' (lighter)
+   */
+  adjustShade(token, amount) {
+    const parts = token.split("-");
+    if (parts.length < 2) {
+      const newShade2 = Math.max(100, Math.min(900, 500 + amount));
+      return `${token}-${newShade2}`;
+    }
+    const base = parts.slice(0, -1).join("-");
+    const shade = parseInt(parts[parts.length - 1] ?? "", 10);
+    if (isNaN(shade)) {
+      console.warn(
+        `[TokenResolver] Cannot adjust shade for non-shade token "${token}". Returning original token.`
+      );
+      return token;
+    }
+    const newShade = Math.max(100, Math.min(900, shade + amount));
+    return `${base}-${newShade}`;
+  }
+  /**
+   * Check if a token exists in the theme palette
+   *
+   * @param token - Token name to check
+   * @returns True if token exists in theme
+   */
+  tokenExists(token) {
+    const commonTokens = ["white", "black", "transparent"];
+    if (commonTokens.includes(token)) {
+      return true;
+    }
+    const parts = token.split("-");
+    if (parts.length >= 2) {
+      const lastPart = parts[parts.length - 1] ?? "";
+      const shade = parseInt(lastPart, 10);
+      if (!isNaN(shade) && shade >= 100 && shade <= 900 && shade % 100 === 0) {
+        return true;
+      }
+    }
+    return true;
+  }
+};
+
 // ../blocks/src/theme/buttons/effects/presets/background.ts
 var darkenBackgroundEffect = {
   id: "darken-background",
@@ -11409,6 +11505,7 @@ var darkenBackgroundEffect = {
   description: "Darkens the background color on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "amount",
     type: "number",
@@ -11440,6 +11537,7 @@ var lightenBackgroundEffect = {
   description: "Lightens the background color on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "amount",
     type: "number",
@@ -11471,6 +11569,7 @@ var fadeBackgroundEffect = {
   description: "Reduces background opacity on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "opacity",
     type: "percentage",
@@ -11493,6 +11592,7 @@ var opacityReduceEffect = {
   description: "Reduces button opacity on hover by a percentage",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "reduction",
     type: "percentage",
@@ -11516,6 +11616,7 @@ var animatedGradientEffect = {
   description: "Animates gradient position on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "direction",
     type: "select",
@@ -11555,6 +11656,7 @@ var backgroundOnHoverEffect = {
   description: "Adds background color on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "colorToken",
     type: "select",
@@ -11580,6 +11682,7 @@ var backgroundOnHoverAlphaEffect = {
   description: "Adds semi-transparent background on hover",
   category: "background",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "opacity",
     type: "percentage",
@@ -11601,6 +11704,33 @@ var backgroundOnHoverAlphaEffect = {
   }
 };
 
+// ../blocks/src/theme/buttons/effects/cssUtils.ts
+var STATE_SELECTORS = {
+  hover: ':hover, [data-force-hover="true"]',
+  active: ":active",
+  focus: ":focus-visible",
+  base: ""
+};
+function getStateSelector(themeId, variantId, state) {
+  const stateSelector = STATE_SELECTORS[state];
+  if (state === "base") {
+    return `:where([data-theme-scope="${themeId}"]) .${variantId}`;
+  }
+  if (state === "hover") {
+    return `:where([data-theme-scope="${themeId}"]) .${variantId}:hover,
+      :where([data-theme-scope="${themeId}"]) .${variantId}[data-force-hover="true"]`;
+  }
+  return `:where([data-theme-scope="${themeId}"]) .${variantId}${stateSelector}`;
+}
+function generateStateCSS(themeId, variantId, state, cssProperties) {
+  const selector = getStateSelector(themeId, variantId, state);
+  return `
+    ${selector} {
+      ${cssProperties}
+    }
+  `;
+}
+
 // ../blocks/src/theme/buttons/effects/presets/shadow.ts
 var borderGlowEffect = {
   id: "border-glow",
@@ -11608,6 +11738,7 @@ var borderGlowEffect = {
   description: "Adds a glowing shadow on hover",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "glowColorToken",
     type: "colorToken",
@@ -11618,11 +11749,7 @@ var borderGlowEffect = {
     const { themeId, variantId, options, tokens } = ctx;
     const glowToken = options.glowColorToken || "primary-400";
     const glowColor = tokens.getColor(glowToken);
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        box-shadow: 0 0 15px ${glowColor};
-      }
-    `;
+    return generateStateCSS(themeId, variantId, "hover", `box-shadow: 0 0 15px ${glowColor};`);
   }
 };
 var dropShadowEffect = {
@@ -11631,6 +11758,7 @@ var dropShadowEffect = {
   description: "Adds an elevated shadow on hover",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "intensity",
     type: "select",
@@ -11646,11 +11774,7 @@ var dropShadowEffect = {
       medium: "0 10px 15px rgba(0, 0, 0, 0.15)",
       strong: "0 20px 25px rgba(0, 0, 0, 0.2)"
     };
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        box-shadow: ${shadows[intensity]};
-      }
-    `;
+    return generateStateCSS(themeId, variantId, "hover", `box-shadow: ${shadows[intensity]};`);
   }
 };
 var innerShadowEffect = {
@@ -11659,6 +11783,7 @@ var innerShadowEffect = {
   description: "Adds an inset shadow for a pressed appearance",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button"],
   generateCSS: (ctx) => {
     const { themeId, variantId } = ctx;
     return `
@@ -11674,6 +11799,7 @@ var neumorphicShadowEffect = {
   description: "Dual shadows for soft UI design (raised or pressed)",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "mode",
     type: "select",
@@ -11716,6 +11842,7 @@ var outerGlowEffect = {
   description: "Creates an outer glow around the button",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "spread",
     type: "number",
@@ -11750,6 +11877,7 @@ var retro3DShadowEffect = {
   description: "3D pressed shadow with vertical movement (retro style)",
   category: "shadow",
   pseudoElement: "none",
+  applicableTo: ["button"],
   generateCSS: (ctx) => {
     const { themeId, variantId } = ctx;
     return `
@@ -11782,6 +11910,7 @@ var scaleUpEffect = {
   description: "Slightly enlarges the button on hover",
   category: "transform",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "scale",
     type: "select",
@@ -11792,11 +11921,7 @@ var scaleUpEffect = {
   generateCSS: (ctx) => {
     const { themeId, variantId, options } = ctx;
     const scale = options.scale || "1.05";
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        transform: scale(${scale});
-      }
-    `;
+    return generateStateCSS(themeId, variantId, "hover", `transform: scale(${scale});`);
   }
 };
 var scaleDownEffect = {
@@ -11805,6 +11930,7 @@ var scaleDownEffect = {
   description: "Slightly shrinks the button when clicked",
   category: "transform",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "scale",
     type: "select",
@@ -11828,6 +11954,7 @@ var liftEffect = {
   description: "Lifts the button upward on hover",
   category: "transform",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "amount",
     type: "select",
@@ -11838,11 +11965,7 @@ var liftEffect = {
   generateCSS: (ctx) => {
     const { themeId, variantId, options } = ctx;
     const amount = options.amount || "0.5";
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        transform: translateY(-${amount}rem);
-      }
-    `;
+    return generateStateCSS(themeId, variantId, "hover", `transform: translateY(-${amount}rem);`);
   }
 };
 var pressDownEffect = {
@@ -11851,6 +11974,7 @@ var pressDownEffect = {
   description: "Translates button to shadow position and removes shadow on hover",
   category: "transform",
   pseudoElement: "none",
+  applicableTo: ["button"],
   generateCSS: (ctx) => {
     const { themeId, variantId, theme } = ctx;
     const shadowConfig = theme.shadow;
@@ -11863,12 +11987,12 @@ var pressDownEffect = {
     const offset = elevationOffsets[shadowConfig.elevation];
     const xOffset = (shadowConfig.position || "bottom") === "bottom-right" ? offset : 0;
     const yOffset = offset;
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        transform: translate(${xOffset}px, ${yOffset}px);
-        box-shadow: none;
-      }
-    `;
+    return generateStateCSS(
+      themeId,
+      variantId,
+      "hover",
+      `transform: translate(${xOffset}px, ${yOffset}px); box-shadow: none;`
+    );
   }
 };
 var popEffect = {
@@ -11877,6 +12001,7 @@ var popEffect = {
   description: "Scales up and tilts the button on hover for a playful pop effect",
   category: "transform",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "intensity",
     type: "select",
@@ -11893,11 +12018,12 @@ var popEffect = {
       dramatic: { scale: 1.08, rotate: 3 }
     };
     const config = intensityConfig[intensity] || intensityConfig.medium;
-    return `
-      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
-        transform: scale(${config.scale}) rotate(${config.rotate}deg);
-      }
-    `;
+    return generateStateCSS(
+      themeId,
+      variantId,
+      "hover",
+      `transform: scale(${config.scale}) rotate(${config.rotate}deg);`
+    );
   }
 };
 
@@ -11908,6 +12034,7 @@ var auroraGlowEffect = {
   description: "Blurred gradient glow that appears on hover",
   category: "overlay",
   pseudoElement: "before",
+  applicableTo: ["button"],
   customizableOption: {
     name: "intensity",
     type: "percentage",
@@ -11920,8 +12047,8 @@ var auroraGlowEffect = {
     let toColor;
     if (buttonConfig.background.type === "gradient") {
       const stops = buttonConfig.background.stops;
-      fromColor = tokens.getColor(stops[0]);
-      toColor = tokens.getColor(stops[stops.length - 1]);
+      fromColor = tokens.getColor(stops[0] ?? "primary-500");
+      toColor = tokens.getColor(stops[stops.length - 1] ?? "primary-300");
     } else if (buttonConfig.background.type === "solid") {
       fromColor = tokens.getColor(buttonConfig.background.colorToken);
       const lighterToken = tokens.adjustShade(buttonConfig.background.colorToken, -200);
@@ -11964,6 +12091,7 @@ var cosmicStardustEffect = {
   description: "Rotating rainbow gradient glow (always visible, intensifies on hover)",
   category: "overlay",
   pseudoElement: "before",
+  applicableTo: ["button"],
   customizableOption: {
     name: "speed",
     type: "select",
@@ -12026,6 +12154,7 @@ var gradientBorderFillEffect = {
   description: "Gradient border that fills on hover using ::before pseudo-element",
   category: "overlay",
   pseudoElement: "before",
+  applicableTo: ["button"],
   customizableOption: {
     name: "borderWidth",
     type: "number",
@@ -12082,6 +12211,7 @@ var animatedGradientBorderFillEffect = {
   description: "Rotating gradient border that fills on hover",
   category: "overlay",
   pseudoElement: "before",
+  applicableTo: ["button"],
   customizableOption: {
     name: "speed",
     type: "select",
@@ -12157,6 +12287,7 @@ var borderBottomGrowEffect = {
   description: "Animated underline that grows on hover",
   category: "overlay",
   pseudoElement: "after",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "height",
     type: "number",
@@ -12204,6 +12335,7 @@ var gradientTextEffect = {
   description: "Gradient text using background-clip",
   category: "text",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "solidOnHover",
     type: "select",
@@ -12255,6 +12387,7 @@ var textColorChangeEffect = {
   description: "Changes text color on hover",
   category: "text",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "hoverColorToken",
     type: "select",
@@ -12282,6 +12415,7 @@ var borderColorChangeEffect = {
   description: "Changes border color on hover",
   category: "border",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "hoverColorToken",
     type: "select",
@@ -12307,6 +12441,7 @@ var sketchyBorderEffect = {
   description: "Hand-drawn style with imperfect edges",
   category: "border",
   pseudoElement: "none",
+  applicableTo: ["button"],
   customizableOption: {
     name: "intensity",
     type: "select",
@@ -12354,6 +12489,7 @@ var pulseAnimationEffect = {
   description: "Continuous pulse animation (opacity fade)",
   category: "animation",
   pseudoElement: "none",
+  applicableTo: ["button", "nav-link"],
   customizableOption: {
     name: "speed",
     type: "select",
@@ -12382,6 +12518,138 @@ var pulseAnimationEffect = {
   }
 };
 
+// ../blocks/src/theme/interactive/effects/nav-underline.ts
+var navUnderlineEffect = {
+  id: "nav-underline",
+  name: "Nav Underline",
+  description: "Underline that appears or grows on hover",
+  category: "overlay",
+  pseudoElement: "after",
+  applicableTo: ["nav-link"],
+  customizableOption: {
+    name: "style",
+    type: "select",
+    label: "Underline Style",
+    default: "static",
+    options: ["static", "grow"]
+  },
+  generateCSS: (ctx) => {
+    const { themeId, variantId, options, tokens } = ctx;
+    const style = options.style || "static";
+    const colorToken = options.colorToken || "primary";
+    const color = tokens.getColor(colorToken);
+    const height = options.height || 2;
+    if (style === "grow") {
+      return `
+        /* Setup nav link for pseudo-element */
+        :where([data-theme-scope="${themeId}"]) .${variantId} {
+          position: relative;
+        }
+
+        /* Underline using ::after - starts at 0 width */
+        :where([data-theme-scope="${themeId}"]) .${variantId}::after {
+          content: '';
+          position: absolute;
+          bottom: 0;
+          left: 50%;
+          width: 0;
+          height: ${height}px;
+          background: ${color};
+          transform: translateX(-50%);
+          transition: width 200ms ease-in-out;
+        }
+
+        /* Grow underline on hover */
+        :where([data-theme-scope="${themeId}"]) .${variantId}:hover::after {
+          width: 100%;
+        }
+      `;
+    }
+    return `
+      /* Setup nav link for pseudo-element */
+      :where([data-theme-scope="${themeId}"]) .${variantId} {
+        position: relative;
+      }
+
+      /* Hidden underline using ::after */
+      :where([data-theme-scope="${themeId}"]) .${variantId}::after {
+        content: '';
+        position: absolute;
+        bottom: 0;
+        left: 0;
+        width: 100%;
+        height: ${height}px;
+        background: ${color};
+        opacity: 0;
+        transition: opacity 150ms ease-in-out;
+      }
+
+      /* Show underline on hover */
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover::after {
+        opacity: 1;
+      }
+    `;
+  }
+};
+
+// ../blocks/src/theme/interactive/effects/nav-frosted.ts
+var navFrostedBaseEffect = {
+  id: "nav-frosted-base",
+  name: "Nav Frosted Base",
+  description: "Base frosted glass styling for nav links",
+  category: "background",
+  pseudoElement: "none",
+  applicableTo: ["nav-link"],
+  generateCSS: (ctx) => {
+    const { themeId, variantId } = ctx;
+    return `
+      /* Frosted glass base state */
+      :where([data-theme-scope="${themeId}"]) .${variantId} {
+        background: rgba(255, 255, 255, 0.05);
+        backdrop-filter: blur(4px);
+        -webkit-backdrop-filter: blur(4px);
+        transition: background 150ms ease, backdrop-filter 150ms ease;
+      }
+    `;
+  }
+};
+var navFrostedHoverEffect = {
+  id: "nav-frosted-hover",
+  name: "Nav Frosted Hover",
+  description: "Enhanced frosted glass on hover",
+  category: "background",
+  pseudoElement: "none",
+  applicableTo: ["nav-link"],
+  generateCSS: (ctx) => {
+    const { themeId, variantId } = ctx;
+    return `
+      /* Frosted glass hover state */
+      :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
+        background: rgba(255, 255, 255, 0.1);
+        backdrop-filter: blur(8px);
+        -webkit-backdrop-filter: blur(8px);
+      }
+    `;
+  }
+};
+var navFrostedActiveEffect = {
+  id: "nav-frosted-active",
+  name: "Nav Frosted Active",
+  description: "Frosted glass active/pressed state",
+  category: "background",
+  pseudoElement: "none",
+  applicableTo: ["nav-link"],
+  generateCSS: (ctx) => {
+    const { themeId, variantId } = ctx;
+    return `
+      /* Frosted glass active state */
+      :where([data-theme-scope="${themeId}"]) .${variantId}:active {
+        background: rgba(255, 255, 255, 0.15);
+      }
+    `;
+  }
+};
+
 // ../blocks/src/theme/buttons/effects/registry.ts
 var EFFECT_PRESETS = [
   // Background effects
@@ -12418,88 +12686,65 @@ var EFFECT_PRESETS = [
   borderColorChangeEffect,
   sketchyBorderEffect,
   // Animation effects
-  pulseAnimationEffect
+  pulseAnimationEffect,
+  // Nav-link specific effects
+  navUnderlineEffect,
+  navFrostedBaseEffect,
+  navFrostedHoverEffect,
+  navFrostedActiveEffect
 ];
 function getEffectPreset(id) {
   return EFFECT_PRESETS.find((preset) => preset.id === id);
 }
 
-// ../blocks/src/theme/tokens/resolver.ts
-var TokenResolver = class {
-  constructor(theme) {
-    this.theme = theme;
-  }
-  /**
-   * Resolve a color token to a CSS variable reference wrapped in rgb()
-   *
-   * @param token - Token name (e.g., 'primary-500', 'white', 'text-900')
-   * @returns CSS rgb() function with var reference (e.g., 'rgb(var(--tb-primary-500))')
-   *
-   * Note: CSS variables are stored as RGB channels (e.g., "37 99 235") following Tailwind convention,
-   * so we must wrap them with rgb() to create a valid color value.
-   *
-   * @example
-   * resolver.getColor('primary-500') // => 'rgb(var(--tb-primary-500))'
-   * resolver.getColor('white') // => 'rgb(var(--tb-white))'
-   */
-  getColor(token) {
-    if (!this.tokenExists(token)) {
-      console.warn(
-        `[TokenResolver] Color token "${token}" not found in theme palette. Button may render incorrectly.`
+// ../blocks/src/theme/interactive/generateEffectsCSS.ts
+function generateEffectsCSS(options) {
+  const { themeId, variantId, effects, elementConfig, tokens, theme } = options;
+  if (!effects) return "";
+  const cssChunks = [];
+  const stateGroups = [
+    ["base", effects.base],
+    ["hover", effects.hover],
+    ["active", effects.active],
+    ["focus", effects.focus]
+  ];
+  for (const [stateGroup, effectApps] of stateGroups) {
+    if (!effectApps || effectApps.length === 0) continue;
+    for (const effectApp of effectApps) {
+      const css2 = generateSingleEffectCSS(
+        themeId,
+        variantId,
+        stateGroup,
+        effectApp,
+        elementConfig,
+        tokens,
+        theme
       );
+      if (css2) {
+        cssChunks.push(css2);
+      }
     }
-    return `rgb(var(--tb-${token}))`;
   }
-  /**
-   * Adjust a color token's shade by a given amount
-   *
-   * @param token - Base token (e.g., 'primary-500')
-   * @param amount - Shade adjustment (+100 = darker, -100 = lighter)
-   * @returns Adjusted token name (e.g., 'primary-600')
-   *
-   * @example
-   * resolver.adjustShade('primary-500', 100) // => 'primary-600' (darker)
-   * resolver.adjustShade('primary-500', -100) // => 'primary-400' (lighter)
-   */
-  adjustShade(token, amount) {
-    const parts = token.split("-");
-    if (parts.length < 2) {
-      const newShade2 = Math.max(100, Math.min(900, 500 + amount));
-      return `${token}-${newShade2}`;
-    }
-    const base = parts.slice(0, -1).join("-");
-    const shade = parseInt(parts[parts.length - 1], 10);
-    if (isNaN(shade)) {
-      console.warn(
-        `[TokenResolver] Cannot adjust shade for non-shade token "${token}". Returning original token.`
-      );
-      return token;
-    }
-    const newShade = Math.max(100, Math.min(900, shade + amount));
-    return `${base}-${newShade}`;
+  return cssChunks.join("\n\n");
+}
+function generateSingleEffectCSS(themeId, variantId, stateGroup, effectApp, elementConfig, tokens, theme) {
+  const effectPreset = getEffectPreset(effectApp.effectId);
+  if (!effectPreset) {
+    console.warn(`[generateEffectsCSS] Unknown effect: ${effectApp.effectId}`);
+    return "";
   }
-  /**
-   * Check if a token exists in the theme palette
-   *
-   * @param token - Token name to check
-   * @returns True if token exists in theme
-   */
-  tokenExists(token) {
-    const commonTokens = ["white", "black", "transparent"];
-    if (commonTokens.includes(token)) {
-      return true;
-    }
-    const parts = token.split("-");
-    if (parts.length >= 2) {
-      const lastPart = parts[parts.length - 1];
-      const shade = parseInt(lastPart, 10);
-      if (!isNaN(shade) && shade >= 100 && shade <= 900 && shade % 100 === 0) {
-        return true;
-      }
-    }
-    return true;
-  }
-};
+  const ctx = {
+    themeId,
+    variantId,
+    stateGroup,
+    options: effectApp.options || {},
+    buttonConfig: elementConfig,
+    // Effects access .background, .textColorToken, .border
+    tokens,
+    theme
+  };
+  return effectPreset.generateCSS(ctx);
+}
 
 // ../blocks/src/theme/buttons/constants.ts
 var GRADIENT_DIRECTION_MAP = {
@@ -12558,6 +12803,11 @@ var FONT_SIZE_MAP = {
   "text-xl": "1.25rem",
   "text-2xl": "1.5rem"
 };
+var BUTTON_PADDING_PRESETS = {
+  compact: "0.375rem 0.75rem",
+  default: "0.5rem 1rem",
+  spacious: "0.75rem 1.5rem"
+};
 
 // ../blocks/src/theme/buttons/utils/contrast.ts
 function getContrastingTextColorToken(backgroundToken, theme) {
@@ -12567,7 +12817,7 @@ function getContrastingTextColorToken(backgroundToken, theme) {
   }
   if (backgroundToken.startsWith("neutral-")) {
     const match = backgroundToken.match(/neutral-(\d+)/);
-    if (match) {
+    if (match?.[1]) {
       const shade = parseInt(match[1], 10);
       return shade >= 500 ? "neutral-50" : "neutral-950";
     }
@@ -12576,16 +12826,6 @@ function getContrastingTextColorToken(backgroundToken, theme) {
 }
 
 // ../blocks/src/theme/buttons/generateDefaultButtonSystem.ts
-var CORNERS_TO_RADIUS_MAP = {
-  square: "rounded-none",
-  // 0px - sharp corners
-  soft: "rounded-md",
-  // 6px - subtle rounding
-  rounded: "rounded-md",
-  // 6px - standard rounded (same as soft for buttons)
-  pill: "rounded-full"
-  // 9999px - full pill shape
-};
 var BORDER_WIDTH_TO_CLASS_MAP = {
   none: "border-0",
   // 0px
@@ -12597,7 +12837,6 @@ var BORDER_WIDTH_TO_CLASS_MAP = {
   // 4px - clearly thick
 };
 function generateDefaultButtonSystem(theme) {
-  const borderRadius = CORNERS_TO_RADIUS_MAP[theme.corners] || "rounded-lg";
   const borderWidthClass = BORDER_WIDTH_TO_CLASS_MAP[theme.border.width] || "border-2";
   const variants = [];
   const primaryVariant = {
@@ -12607,10 +12846,11 @@ function generateDefaultButtonSystem(theme) {
     priority: 1,
     background: {
       type: "solid",
-      colorToken: "primary-500"
+      colorToken: "primary"
     },
-    textColorToken: getContrastingTextColorToken("primary-500", theme),
-    borderRadius,
+    textColorToken: getContrastingTextColorToken("primary", theme),
+    borderRadius: "",
+    // Empty string = inherit from global.cornerStyle
     // Inherits shadow from theme
     effects: {
       hover: [
@@ -12632,7 +12872,8 @@ function generateDefaultButtonSystem(theme) {
       colorToken: "neutral-700"
     },
     textColorToken: getContrastingTextColorToken("neutral-700", theme),
-    borderRadius,
+    borderRadius: "",
+    // Empty string = inherit from global.cornerStyle
     // Inherits shadow from theme
     effects: {
       hover: [
@@ -12652,12 +12893,13 @@ function generateDefaultButtonSystem(theme) {
     background: {
       type: "transparent"
     },
-    textColorToken: "primary-600",
-    borderRadius,
+    textColorToken: "primary",
+    borderRadius: "",
+    // Empty string = inherit from global.cornerStyle
     shadow: { elevation: "none", softness: null, position: "bottom" },
     // Outline buttons typically don't have shadows
     border: {
-      colorToken: "primary-500",
+      colorToken: "primary",
       widthClass: borderWidthClass
     },
     effects: {
@@ -12678,8 +12920,9 @@ function generateDefaultButtonSystem(theme) {
     background: {
       type: "transparent"
     },
-    textColorToken: "primary-600",
-    borderRadius,
+    textColorToken: "primary",
+    borderRadius: "",
+    // Empty string = inherit from global.cornerStyle
     shadow: { elevation: "none", softness: null, position: "bottom" },
     // Ghost buttons have no shadow
     // No border for ghost buttons
@@ -12745,6 +12988,10 @@ function generateButtonCss(options) {
     if (!variant.enabled) continue;
     const baseCSS = generateVariantBaseCSS(variant, buttonSystem.global, themeId, tokens, theme);
     cssChunks.push(baseCSS);
+    const hoverBgCSS = generateHoverBackgroundCSS(variant, buttonSystem.global, themeId, tokens);
+    if (hoverBgCSS) {
+      cssChunks.push(hoverBgCSS);
+    }
     const effectCSS = generateVariantEffectCSS(variant, themeId, tokens, theme);
     if (effectCSS) {
       cssChunks.push(effectCSS);
@@ -12763,7 +13010,7 @@ function generateVariantBaseCSS(variant, global, themeId, tokens, theme) {
   const rules = [];
   const borderWidth = variant.border ? BORDER_WIDTH_MAP[variant.border.widthClass] || "1px" : "0px";
   const hasBorder = borderWidth !== "0px";
-  const padding = variant.padding || STRUCTURAL_BASE_STYLES.padding;
+  const padding = variant.padding || (global.paddingPreset ? BUTTON_PADDING_PRESETS[global.paddingPreset] : null) || STRUCTURAL_BASE_STYLES.padding;
   const paddingParts = padding.split(" ");
   const verticalPadding = paddingParts[0] || "0.5rem";
   const horizontalPadding = paddingParts[1] || paddingParts[0] || "1rem";
@@ -12776,6 +13023,15 @@ function generateVariantBaseCSS(variant, global, themeId, tokens, theme) {
     rules.push(`padding: ${padding};`);
   }
   rules.push(`font-weight: ${global.fontWeight};`);
+  if (global.typography === "heading") {
+    rules.push(`font-family: var(--font-heading);`);
+    rules.push(`letter-spacing: var(--ls-heading);`);
+  } else {
+    rules.push(`font-family: var(--font-body);`);
+  }
+  if (global.italic) {
+    rules.push(`font-style: italic;`);
+  }
   if (variant.fontSize) {
     const fontSize = FONT_SIZE_MAP[variant.fontSize] || "1rem";
     rules.push(`font-size: ${fontSize};`);
@@ -12789,16 +13045,16 @@ function generateVariantBaseCSS(variant, global, themeId, tokens, theme) {
   rules.push(`align-items: ${STRUCTURAL_BASE_STYLES.alignItems};`);
   rules.push(`justify-content: ${STRUCTURAL_BASE_STYLES.justifyContent};`);
   let borderRadius;
-  if (variant.borderRadius) {
-    borderRadius = BORDER_RADIUS_MAP[variant.borderRadius] || BORDER_RADIUS_MAP["rounded"];
+  if (variant.borderRadius && variant.borderRadius !== "") {
+    borderRadius = BORDER_RADIUS_MAP[variant.borderRadius] ?? BORDER_RADIUS_MAP["rounded"] ?? "0.375rem";
   } else {
     const cornerStyleMap = {
       "square": "rounded-none",
       "rounded": "rounded-md",
       "pill": "rounded-full"
     };
-    const fallbackRadius = cornerStyleMap[global.cornerStyle] || "rounded-md";
-    borderRadius = BORDER_RADIUS_MAP[fallbackRadius] || BORDER_RADIUS_MAP["rounded"];
+    const fallbackRadius = cornerStyleMap[global.cornerStyle] ?? "rounded-md";
+    borderRadius = BORDER_RADIUS_MAP[fallbackRadius] ?? BORDER_RADIUS_MAP["rounded"] ?? "0.375rem";
   }
   rules.push(`border-radius: ${borderRadius};`);
   const shadowConfig = variant.shadow || shadowSizeToShadow(global.shadow, theme) || theme.shadow;
@@ -12834,31 +13090,33 @@ ${selector} {
 }
 function generateVariantEffectCSS(variant, themeId, tokens, theme) {
   if (!variant.effects) return "";
-  const cssChunks = [];
-  for (const [stateGroup, effectApps] of Object.entries(variant.effects)) {
-    if (!effectApps || effectApps.length === 0) continue;
-    for (const effectApp of effectApps) {
-      const effectPreset = getEffectPreset(effectApp.effectId);
-      if (!effectPreset) {
-        console.warn(`[generateVariantEffectCSS] Unknown effect: ${effectApp.effectId}`);
-        continue;
-      }
-      const ctx = {
-        themeId,
-        variantId: variant.id,
-        stateGroup,
-        options: effectApp.options || {},
-        buttonConfig: variant,
-        tokens,
-        theme
-      };
-      const css2 = effectPreset.generateCSS(ctx);
-      if (css2) {
-        cssChunks.push(css2);
-      }
-    }
+  const elementConfig = {
+    background: variant.background,
+    textColorToken: variant.textColorToken,
+    border: variant.border ? { colorToken: variant.border.colorToken } : void 0
+  };
+  return generateEffectsCSS({
+    themeId,
+    variantId: variant.id,
+    effects: variant.effects,
+    elementConfig,
+    tokens,
+    theme
+  });
+}
+function generateHoverBackgroundCSS(variant, global, themeId, tokens) {
+  let hoverToken = variant.hoverBackgroundToken;
+  if (!hoverToken && global.hoverColor === "token" && global.hoverColorToken) {
+    hoverToken = global.hoverColorToken;
   }
-  return cssChunks.join("\n\n");
+  if (!hoverToken) return null;
+  const selector = `:where([data-theme-scope="${themeId}"]) .${variant.id}:hover`;
+  const hoverBgColor = tokens.getColor(hoverToken);
+  return `
+${selector} {
+  background-color: ${hoverBgColor};
+}
+  `.trim();
 }
 function generateDisabledCSS(variant, themeId) {
   const selector = `:where([data-theme-scope="${themeId}"]) .${variant.id}:disabled`;
@@ -13751,6 +14009,345 @@ function generateDefaultInputSystem(theme) {
   };
 }
 
+// ../blocks/src/theme/navigation/types.ts
+import { z as z19 } from "zod";
+
+// ../blocks/src/theme/interactive/baseSchema.ts
+import { z as z18 } from "zod";
+var interactiveTypographySchema = z18.object({
+  /** Font family source */
+  typography: z18.enum(["body", "heading"]).default("body"),
+  /** Font weight */
+  fontWeight: z18.enum(["regular", "medium", "semibold", "bold"]).default("medium"),
+  /** Text transform */
+  textTransform: z18.enum(["none", "uppercase", "capitalize"]).default("none"),
+  /** Italic style */
+  italic: z18.boolean().default(false)
+});
+var effectApplicationSchema = z18.object({
+  /** Effect preset ID */
+  effectId: z18.string(),
+  /** User-provided customization options */
+  options: z18.record(z18.string(), z18.any()).optional()
+});
+var effectCompositionSchema = z18.object({
+  /** Effects always applied */
+  base: z18.array(effectApplicationSchema).optional(),
+  /** Effects applied on hover */
+  hover: z18.array(effectApplicationSchema).optional(),
+  /** Effects applied on active/pressed */
+  active: z18.array(effectApplicationSchema).optional(),
+  /** Effects applied on focus */
+  focus: z18.array(effectApplicationSchema).optional()
+});
+
+// ../blocks/src/theme/navigation/types.ts
+var navLinkPaddingSchema = z19.enum(["none", "compact", "default"]);
+var navLinkBorderRadiusSchema = z19.enum(["none", "sm", "md", "full"]);
+var navLinkStyleSchema = z19.object({
+  /** Display name for the style */
+  name: z19.string().min(1).max(30).optional(),
+  /** Typography settings (inherited from interactive base) */
+  ...interactiveTypographySchema.shape,
+  /** Text color token */
+  colorToken: z19.string().default("text"),
+  /** Hover/active color token (for color-change effects) */
+  hoverColorToken: z19.string().nullable().optional(),
+  /** Padding preset */
+  padding: navLinkPaddingSchema.default("compact"),
+  /** Border radius (for capsule/pill styles) */
+  borderRadius: navLinkBorderRadiusSchema.default("none"),
+  /** Composable effects */
+  effects: effectCompositionSchema.optional()
+});
+var NAV_LINK_PADDING_MAP = {
+  none: "0",
+  compact: "0.5rem 1rem",
+  default: "0.75rem 1.25rem"
+};
+var NAV_LINK_BORDER_RADIUS_MAP = {
+  none: "0",
+  sm: "0.25rem",
+  md: "0.5rem",
+  full: "9999px"
+};
+
+// ../blocks/src/theme/interactive/generateBaseCSS.ts
+var FONT_WEIGHT_MAP2 = {
+  regular: 400,
+  medium: 500,
+  semibold: 600,
+  bold: 700
+};
+function generateBaseInteractiveCSS(options) {
+  const {
+    typography,
+    padding,
+    borderRadius,
+    includeTransition = true,
+    includeFlexCenter = false,
+    borderWidth
+  } = options;
+  const rules = [];
+  if (typography.fontWeight !== void 0) {
+    const weight = typeof typography.fontWeight === "number" ? typography.fontWeight : FONT_WEIGHT_MAP2[typography.fontWeight];
+    rules.push(`font-weight: ${weight};`);
+  }
+  if (typography.typography === "heading") {
+    rules.push(`font-family: var(--font-heading);`);
+    rules.push(`letter-spacing: var(--ls-heading);`);
+  } else if (typography.typography === "body") {
+    rules.push(`font-family: var(--font-body);`);
+  }
+  if (typography.italic) {
+    rules.push(`font-style: italic;`);
+  }
+  if (typography.textTransform && typography.textTransform !== "none") {
+    rules.push(`text-transform: ${typography.textTransform};`);
+  }
+  if (padding) {
+    if (borderWidth && borderWidth !== "0px") {
+      const paddingParts = padding.split(" ");
+      const verticalPadding = paddingParts[0] || "0.5rem";
+      const horizontalPadding = paddingParts[1] || paddingParts[0] || "1rem";
+      rules.push(`padding-top: calc(${verticalPadding} - ${borderWidth} - 1px);`);
+      rules.push(`padding-bottom: calc(${verticalPadding} - ${borderWidth} - 1px);`);
+      rules.push(`padding-left: calc(${horizontalPadding} - ${borderWidth});`);
+      rules.push(`padding-right: calc(${horizontalPadding} - ${borderWidth});`);
+    } else {
+      rules.push(`padding: ${padding};`);
+    }
+  }
+  if (borderRadius) {
+    rules.push(`border-radius: ${borderRadius};`);
+  }
+  if (includeTransition) {
+    rules.push(`transition: all 200ms ease;`);
+  }
+  if (includeFlexCenter) {
+    rules.push(`display: inline-flex;`);
+    rules.push(`align-items: center;`);
+    rules.push(`justify-content: center;`);
+    rules.push(`cursor: pointer;`);
+  }
+  return rules;
+}
+
+// ../blocks/src/theme/navigation/generateNavLinkCSS.ts
+function generateNavLinkCSS(options) {
+  const { themeId, tokens, theme, style, className } = options;
+  const selector = `:where([data-theme-scope="${themeId}"]) .${className}`;
+  const hoverSelector = `${selector}:hover`;
+  const activeSelector = `${selector}:active, ${selector}[data-active="true"]`;
+  const cssChunks = [];
+  const hoverRules = [];
+  const activeRules = [];
+  const baseRules = generateBaseInteractiveCSS({
+    typography: {
+      typography: style.typography,
+      fontWeight: style.fontWeight,
+      textTransform: style.textTransform,
+      italic: style.italic
+    },
+    padding: style.padding ? NAV_LINK_PADDING_MAP[style.padding] : void 0,
+    borderRadius: style.borderRadius ? NAV_LINK_BORDER_RADIUS_MAP[style.borderRadius] : void 0,
+    includeTransition: true,
+    includeFlexCenter: false
+  });
+  if (style.colorToken) {
+    baseRules.push(`color: ${tokens.getColor(style.colorToken)};`);
+  }
+  if (style.hoverColorToken && !style.effects?.hover?.length) {
+    hoverRules.push(`color: ${tokens.getColor(style.hoverColorToken)};`);
+  }
+  const elementConfig = {
+    background: { type: "transparent" },
+    textColorToken: style.colorToken || "text"
+  };
+  if (style.effects) {
+    const effectsCss = generateEffectsCSS({
+      themeId,
+      variantId: className,
+      effects: style.effects,
+      elementConfig,
+      tokens,
+      theme
+    });
+    if (effectsCss) {
+      cssChunks.push(effectsCss);
+    }
+  }
+  if (baseRules.length > 0) {
+    cssChunks.unshift(`
+${selector} {
+  ${baseRules.join("\n  ")}
+}
+`);
+  }
+  if (hoverRules.length > 0) {
+    cssChunks.push(`
+${hoverSelector} {
+  ${hoverRules.join("\n  ")}
+}
+`);
+  }
+  if (activeRules.length > 0) {
+    cssChunks.push(`
+${activeSelector} {
+  ${activeRules.join("\n  ")}
+}
+`);
+  }
+  return cssChunks.join("");
+}
+
+// ../blocks/src/theme/navigation/presets.ts
+var NAV_LINK_PRESETS = {
+  /**
+   * Minimal - subtle color change on hover
+   */
+  minimal: {
+    name: "Minimal",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    hoverColorToken: "primary",
+    padding: "none",
+    borderRadius: "none",
+    effects: {
+      hover: [
+        { effectId: "text-color-change", options: { colorToken: "primary" } }
+      ]
+    }
+  },
+  /**
+   * Underline - static underline appears on hover
+   */
+  underline: {
+    name: "Underline",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "none",
+    borderRadius: "none",
+    effects: {
+      hover: [
+        { effectId: "nav-underline", options: { style: "static" } }
+      ]
+    }
+  },
+  /**
+   * Underline Grow - animated underline grows from center on hover
+   */
+  "underline-grow": {
+    name: "Underline Grow",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "none",
+    borderRadius: "none",
+    effects: {
+      hover: [
+        { effectId: "nav-underline", options: { style: "grow" } }
+      ]
+    }
+  },
+  /**
+   * Capsule - pill-shaped background on hover
+   */
+  capsule: {
+    name: "Capsule",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "compact",
+    borderRadius: "full",
+    effects: {
+      hover: [
+        { effectId: "background-on-hover-alpha", options: { colorToken: "primary", opacity: 0.1 } }
+      ],
+      active: [
+        { effectId: "background-on-hover-alpha", options: { colorToken: "primary", opacity: 0.15 } }
+      ]
+    }
+  },
+  /**
+   * Solid - solid background color on hover
+   */
+  solid: {
+    name: "Solid",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "compact",
+    borderRadius: "none",
+    effects: {
+      hover: [
+        { effectId: "background-on-hover", options: { colorToken: "primary" } }
+      ],
+      active: [
+        { effectId: "background-on-hover", options: { colorToken: "primary" } }
+      ]
+    }
+  },
+  /**
+   * Scale - gentle scale-up on hover
+   */
+  scale: {
+    name: "Scale",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "none",
+    borderRadius: "none",
+    effects: {
+      hover: [
+        { effectId: "scale-up", options: { scale: 1.05 } }
+      ]
+    }
+  },
+  /**
+   * Frosted - semi-transparent glass-like background
+   */
+  frosted: {
+    name: "Frosted",
+    typography: "body",
+    fontWeight: "medium",
+    textTransform: "none",
+    italic: false,
+    colorToken: "text",
+    padding: "compact",
+    borderRadius: "md",
+    effects: {
+      base: [
+        { effectId: "nav-frosted-base" }
+      ],
+      hover: [
+        { effectId: "nav-frosted-hover" }
+      ],
+      active: [
+        { effectId: "nav-frosted-active" }
+      ]
+    }
+  }
+};
+function getNavLinkPreset(presetId) {
+  return NAV_LINK_PRESETS[presetId];
+}
+var NAV_LINK_PRESET_IDS = Object.keys(NAV_LINK_PRESETS);
+
 // ../blocks/src/theme/header/generateHeaderCss.ts
 function generateHeaderCss(options) {
   const { themeId, theme } = options;
@@ -13758,10 +14355,8 @@ function generateHeaderCss(options) {
   const header = theme.header;
   const cssChunks = [];
   cssChunks.push(generateHeaderRootStyles(header, themeId, tokens, theme));
-  if (header.logo) {
-    cssChunks.push(generateLogoStyles(header.logo, themeId, tokens));
-  }
-  cssChunks.push(generateNavLinkStyles(header, themeId, tokens));
+  cssChunks.push(generateLogoStyles(header.logo, themeId, tokens, header.textColor));
+  cssChunks.push(generateNavLinkStyles(header, themeId, tokens, theme));
   if (header.variant === "floating" && header.container) {
     cssChunks.push(generateFloatingContainerStyles(header.container, themeId, tokens));
   }
@@ -13817,32 +14412,36 @@ ${selector} {
 }
 `;
 }
-function generateLogoStyles(logo, themeId, tokens) {
-  if (!logo) return "";
+function generateLogoStyles(logo, themeId, tokens, textColor) {
   const selector = `:where([data-theme-scope="${themeId}"]) .header-logo-text`;
   const rules = [];
   const primaryColor = tokens.getColor("primary");
   const accentColor = tokens.getColor("accent");
-  if (logo.fontFamily === "mono") {
-    rules.push(`font-family: ui-monospace, monospace;`);
-  } else if (logo.fontFamily === "serif") {
-    rules.push(`font-family: ui-serif, serif;`);
-  }
-  if (logo.letterSpacing && logo.letterSpacing !== "normal") {
-    const spacingMap = {
-      "normal": "0em",
-      "wide": "0.05em",
-      "wider": "0.1em",
-      "widest": "0.15em"
-    };
-    rules.push(`letter-spacing: ${spacingMap[logo.letterSpacing]};`);
-  }
-  if (logo.gradient) {
-    rules.push(`background: linear-gradient(to right, ${primaryColor}, ${accentColor});`);
-    rules.push(`-webkit-background-clip: text;`);
-    rules.push(`-webkit-text-fill-color: transparent;`);
-    rules.push(`background-clip: text;`);
-    rules.push(`color: transparent;`);
+  if (textColor && !logo?.gradient) {
+    rules.push(`color: ${tokens.getColor(textColor)};`);
+  }
+  if (logo) {
+    if (logo.fontFamily === "mono") {
+      rules.push(`font-family: ui-monospace, monospace;`);
+    } else if (logo.fontFamily === "serif") {
+      rules.push(`font-family: ui-serif, serif;`);
+    }
+    if (logo.letterSpacing && logo.letterSpacing !== "normal") {
+      const spacingMap = {
+        "normal": "0em",
+        "wide": "0.05em",
+        "wider": "0.1em",
+        "widest": "0.15em"
+      };
+      rules.push(`letter-spacing: ${spacingMap[logo.letterSpacing]};`);
+    }
+    if (logo.gradient) {
+      rules.push(`background: linear-gradient(to right, ${primaryColor}, ${accentColor});`);
+      rules.push(`-webkit-background-clip: text;`);
+      rules.push(`-webkit-text-fill-color: transparent;`);
+      rules.push(`background-clip: text;`);
+      rules.push(`color: transparent;`);
+    }
   }
   if (rules.length === 0) return "";
   return `
@@ -13851,129 +14450,82 @@ ${selector} {
 }
 `;
 }
-function generateNavLinkStyles(header, themeId, tokens) {
-  const selector = `:where([data-theme-scope="${themeId}"]) .header-nav-link`;
-  const hoverSelector = `${selector}:hover`;
-  const activeSelector = `${selector}[data-active="true"]`;
-  const cssChunks = [];
-  const baseRules = [];
-  const hoverRules = [];
-  const activeRules = [];
-  const navContainerType = header.navContainer?.type ?? "none";
-  const usesGlassNavContainer = navContainerType === "glass";
-  const navColorToken = header.navColor?.trim();
-  const primaryColor = tokens.getColor("primary");
-  const navWeight = header.navWeight ?? "medium";
-  const navWeightMap = {
-    regular: 400,
-    medium: 500,
-    semibold: 600,
-    bold: 700
-  };
-  if (navColorToken) {
-    baseRules.push(`color: ${tokens.getColor(navColorToken)};`);
-  }
-  if (navWeight) {
-    baseRules.push(`font-weight: ${navWeightMap[navWeight]};`);
-  }
-  if (navWeight === "bold" && header.navStyle === "solid") {
-    baseRules.push(`text-transform: uppercase;`);
-  }
-  switch (header.navStyle) {
-    case "minimal":
-      baseRules.push(`transition: color 200ms ease;`);
-      hoverRules.push(`color: ${primaryColor};`);
-      activeRules.push(`color: ${primaryColor};`);
-      break;
-    case "underline":
-      baseRules.push(`transition: all 200ms ease;`);
-      hoverRules.push(`text-decoration: underline;`);
-      hoverRules.push(`text-underline-offset: 4px;`);
-      activeRules.push(`text-decoration: underline;`);
-      activeRules.push(`text-underline-offset: 4px;`);
-      break;
-    case "underline-grow":
-      baseRules.push(`position: relative;`);
-      baseRules.push(`transition: color 200ms ease;`);
-      hoverRules.push(`color: ${primaryColor};`);
-      activeRules.push(`color: ${primaryColor};`);
-      cssChunks.push(generateUnderlineGrowCSS(themeId));
-      break;
-    case "capsule":
-      baseRules.push(`border-radius: 9999px;`);
-      baseRules.push(`transition: background-color 200ms ease;`);
-      hoverRules.push(`background-color: color-mix(in srgb, ${primaryColor} 10%, transparent);`);
-      activeRules.push(`background-color: color-mix(in srgb, ${primaryColor} 15%, transparent);`);
-      break;
-    case "solid":
-      baseRules.push(`border-radius: 0;`);
-      baseRules.push(`transition: background-color 200ms ease, color 200ms ease;`);
-      hoverRules.push(`background-color: ${primaryColor};`);
-      if (navColorToken) {
-        hoverRules.push(`color: ${tokens.getColor(navColorToken)};`);
-      }
-      activeRules.push(`background-color: ${primaryColor};`);
-      if (navColorToken) {
-        activeRules.push(`color: ${tokens.getColor(navColorToken)};`);
-      }
-      break;
-    case "scale":
-      baseRules.push(`transition: all 200ms ease;`);
-      hoverRules.push(`transform: scale(1.05);`);
-      break;
-    case "frosted":
-      baseRules.push(`border-radius: 0.5rem;`);
-      baseRules.push(`background-color: rgb(255 255 255 / 0.1);`);
-      baseRules.push(`backdrop-filter: blur(8px);`);
-      baseRules.push(`transition: background-color 200ms ease;`);
-      hoverRules.push(`background-color: rgb(255 255 255 / 0.2);`);
-      activeRules.push(`background-color: rgb(255 255 255 / 0.25);`);
-      break;
+function generateNavLinkStyles(header, themeId, tokens, theme) {
+  if (header.navLinkStyle) {
+    return generateNavLinkCSS({
+      themeId,
+      tokens,
+      theme,
+      style: header.navLinkStyle,
+      className: "header-nav-link"
+    });
   }
-  if (usesGlassNavContainer && header.navStyle === "minimal") {
-    baseRules.push(`border-radius: 9999px;`);
-    hoverRules.push(`background-color: rgba(255, 255, 255, 0.1);`);
-    activeRules.push(`background-color: rgba(255, 255, 255, 0.18);`);
-    hoverRules.push(`color: #fff;`);
-    activeRules.push(`color: #fff;`);
+  const navStyle = header.navStyle ?? "minimal";
+  const basePreset = getNavLinkPreset(navStyle);
+  if (!basePreset) {
+    console.warn(`[generateHeaderCss] Nav link preset not found: ${navStyle}`);
+    return "";
+  }
+  const mergedStyle = {
+    ...basePreset,
+    // Override with legacy settings
+    fontWeight: header.navWeight ?? basePreset.fontWeight,
+    colorToken: (header.navColor ?? header.textColor)?.trim() || basePreset.colorToken
+  };
+  if (header.navWeight === "bold" && navStyle === "solid") {
+    mergedStyle.textTransform = "uppercase";
   }
   if (header.navEffects) {
+    mergedStyle.effects = {
+      ...mergedStyle.effects,
+      hover: [...mergedStyle.effects?.hover || []],
+      active: [...mergedStyle.effects?.active || []]
+    };
     if (header.navEffects.glow) {
-      hoverRules.push(`filter: drop-shadow(0 0 5px currentColor);`);
+      mergedStyle.effects.hover.push({
+        effectId: "outer-glow",
+        options: { spread: 5 }
+      });
     }
     if (header.navEffects.neumorphic) {
-      console.log("[generateHeaderCss] Generating neumorphic styles for theme:", themeId);
-      baseRules.push(`transition: all 200ms ease;`);
-      baseRules.push(`border-radius: 0.5rem;`);
-      hoverRules.push(`box-shadow: inset 4px 4px 8px #c7c7c7, inset -4px -4px 8px #ffffff;`);
-      hoverRules.push(`color: ${primaryColor};`);
+      mergedStyle.effects.hover.push({
+        effectId: "neumorphic-shadow",
+        options: { mode: "pressed" }
+      });
+      mergedStyle.effects.hover.push({
+        effectId: "text-color-change",
+        options: { hoverColorToken: "primary" }
+      });
     }
     if (header.navEffects.underlineGradient) {
-      cssChunks.push(generateGradientUnderlineCSS(themeId, tokens));
+      mergedStyle.effects.hover.push({
+        effectId: "border-bottom-grow",
+        options: { origin: "center" }
+      });
     }
   }
-  if (baseRules.length > 0) {
-    cssChunks.push(`
-${selector} {
-  ${baseRules.join("\n  ")}
-}
-`);
-  }
-  if (hoverRules.length > 0) {
-    cssChunks.push(`
-${hoverSelector} {
-  ${hoverRules.join("\n  ")}
-}
-`);
-  }
-  if (activeRules.length > 0) {
-    cssChunks.push(`
-${activeSelector} {
-  ${activeRules.join("\n  ")}
-}
-`);
+  const navContainerType = header.navContainer?.type ?? "none";
+  if (navContainerType === "glass" && navStyle === "minimal") {
+    mergedStyle.borderRadius = "full";
+    mergedStyle.effects = {
+      ...mergedStyle.effects,
+      hover: [
+        { effectId: "background-on-hover-alpha", options: { colorToken: "neutral-50", opacity: 10 } },
+        { effectId: "text-color-change", options: { hoverColorToken: "neutral-50" } }
+      ],
+      active: [
+        { effectId: "background-on-hover-alpha", options: { colorToken: "neutral-50", opacity: 18 } },
+        { effectId: "text-color-change", options: { hoverColorToken: "neutral-50" } }
+      ]
+    };
   }
-  return cssChunks.join("");
+  return generateNavLinkCSS({
+    themeId,
+    tokens,
+    theme,
+    style: mergedStyle,
+    className: "header-nav-link"
+  });
 }
 function generateNavContainerStyles(header, themeId, tokens) {
   const navContainer = header.navContainer;
@@ -14010,52 +14562,6 @@ function generateNavContainerStyles(header, themeId, tokens) {
   }
   return "";
 }
-function generateGradientUnderlineCSS(themeId, tokens) {
-  const selector = `:where([data-theme-scope="${themeId}"]) .header-nav-link`;
-  const primaryColor = tokens.getColor("primary");
-  const accentColor = tokens.getColor("accent");
-  return `
-${selector}::after {
-  content: '';
-  position: absolute;
-  bottom: 0;
-  left: 0;
-  width: 100%;
-  height: 2px;
-  background: linear-gradient(to right, ${primaryColor}, ${accentColor});
-  transform: scaleX(0);
-  transform-origin: center;
-  transition: transform 0.3s ease;
-}
-
-${selector}:hover::after,
-${selector}[data-active="true"]::after {
-  transform: scaleX(1);
-}
-  `.trim();
-}
-function generateUnderlineGrowCSS(themeId) {
-  const selector = `:where([data-theme-scope="${themeId}"]) .header-nav-link`;
-  return `
-${selector}::after {
-  content: '';
-  position: absolute;
-  bottom: 0;
-  left: 0;
-  width: 100%;
-  height: 2px;
-  background: currentColor;
-  transform: scaleX(0);
-  transform-origin: center;
-  transition: transform 0.3s ease;
-}
-
-${selector}:hover::after,
-${selector}[data-active="true"]::after {
-  transform: scaleX(1);
-}
-  `.trim();
-}
 function generateFloatingContainerStyles(container, themeId, tokens) {
   if (!container) return "";
   const selector = `:where([data-theme-scope="${themeId}"]) .header-floating-container`;
@@ -14112,12 +14618,52 @@ function applyAlpha(color, opacity) {
   const clamped = clampOpacity(opacity, 1);
   if (color.startsWith("rgb(") && color.endsWith(")")) {
     const inner = color.slice(4, -1).trim();
-    const channels = inner.includes("/") ? inner.split("/")[0].trim() : inner;
+    const channels = inner.includes("/") ? (inner.split("/")[0] ?? inner).trim() : inner;
     return `rgb(${channels} / ${clamped})`;
   }
   return color;
 }
 
+// ../blocks/src/theme/footer/generateFooterCss.ts
+function generateFooterCss(options) {
+  const { themeId, theme } = options;
+  const tokens = new TokenResolver(theme);
+  const footer = theme.footer;
+  const cssChunks = [];
+  cssChunks.push(generateFooterNavLinkStyles(footer, themeId, tokens, theme));
+  return cssChunks.filter(Boolean).join("\n\n");
+}
+function generateFooterNavLinkStyles(footer, themeId, tokens, theme) {
+  if (footer.navLinkStyle) {
+    return generateNavLinkCSS({
+      themeId,
+      tokens,
+      theme,
+      style: footer.navLinkStyle,
+      className: "footer-nav-link"
+    });
+  }
+  const navStyle = footer.navStyle ?? "minimal";
+  const basePreset = getNavLinkPreset(navStyle);
+  if (!basePreset) {
+    console.warn(`[generateFooterCss] Nav link preset not found: ${navStyle}`);
+    return "";
+  }
+  const mergedStyle = {
+    ...basePreset,
+    // Override with legacy settings
+    fontWeight: footer.navWeight ?? basePreset.fontWeight,
+    colorToken: footer.navColor?.trim() || basePreset.colorToken
+  };
+  return generateNavLinkCSS({
+    themeId,
+    tokens,
+    theme,
+    style: mergedStyle,
+    className: "footer-nav-link"
+  });
+}
+
 // ../blocks/src/theme/layout/generateLayoutCss.ts
 function generateLayoutCss(options) {
   const { themeId } = options;
@@ -14271,6 +14817,105 @@ ${root} .step-connector {
   return cssBlocks.join("\n\n");
 }
 
+// ../blocks/src/theme/typography/generateTypographyCss.ts
+function generateTypographyCss({ themeId }) {
+  const root = `:where([data-theme-scope="${themeId}"])`;
+  const cssBlocks = [];
+  cssBlocks.push(`/* Base heading styles */
+${root} :where(h1, h2, h3, h4, h5, h6) {
+  font-family: var(--font-heading);
+  font-style: var(--fi-heading, normal);
+  text-transform: var(--tt-heading, none);
+  font-variant: var(--fv-heading, normal);
+  margin: 0;
+}`);
+  cssBlocks.push(`/* Heading level styles with fluid typography */
+${root} :where(h1) {
+  font-size: var(--fs-h1-fluid, var(--fs-h1));
+  font-weight: var(--fw-h1, var(--font-weight-heading));
+  font-style: var(--fi-h1, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h1, var(--ls-heading));
+  line-height: var(--lh-h1, var(--lh-heading));
+}
+
+${root} :where(h2) {
+  font-size: var(--fs-h2-fluid, var(--fs-h2));
+  font-weight: var(--fw-h2, var(--font-weight-heading));
+  font-style: var(--fi-h2, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h2, var(--ls-heading));
+  line-height: var(--lh-h2, var(--lh-heading));
+}
+
+${root} :where(h3) {
+  font-size: var(--fs-h3-fluid, var(--fs-h3));
+  font-weight: var(--fw-h3, var(--font-weight-heading));
+  font-style: var(--fi-h3, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h3, var(--ls-heading));
+  line-height: var(--lh-h3, var(--lh-heading));
+}
+
+${root} :where(h4) {
+  font-size: var(--fs-h4-fluid, var(--fs-h4, var(--fs-h3)));
+  font-weight: var(--fw-h4, var(--font-weight-heading));
+  font-style: var(--fi-h4, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h4, var(--ls-heading));
+  line-height: var(--lh-h4, var(--lh-heading));
+}
+
+${root} :where(h5) {
+  font-size: var(--fs-h5-fluid, var(--fs-h5, var(--fs-body)));
+  font-weight: var(--fw-h5, var(--font-weight-heading));
+  font-style: var(--fi-h5, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h5, var(--ls-heading));
+  line-height: var(--lh-h5, var(--lh-heading));
+}
+
+${root} :where(h6) {
+  font-size: var(--fs-h6-fluid, var(--fs-h6, var(--fs-body)));
+  font-weight: var(--fw-h6, var(--font-weight-heading));
+  font-style: var(--fi-h6, var(--fi-heading, normal));
+  letter-spacing: var(--ls-h6, var(--ls-heading));
+  line-height: var(--lh-h6, var(--lh-heading));
+}`);
+  cssBlocks.push(`/* Display variant for hero/splash headings */
+${root} :where(.heading-display) {
+  font-size: var(--fs-display-fluid, var(--fs-display));
+}
+
+${root} :where(h1.heading-display) {
+  font-size: var(--fs-h1-display-fluid, var(--fs-h1-display, calc(var(--fs-h1) * 1.5)));
+}
+
+${root} :where(h2.heading-display) {
+  font-size: var(--fs-h2-display-fluid, var(--fs-h2-display, calc(var(--fs-h2) * 1.35)));
+}`);
+  cssBlocks.push(`/* Compact variant for cards/sidebars */
+${root} :where(.heading-compact) {
+  font-size: var(--fs-compact);
+}
+
+${root} :where(h1.heading-compact) {
+  font-size: calc(var(--fs-h1) * 0.75);
+}
+
+${root} :where(h2.heading-compact) {
+  font-size: calc(var(--fs-h2) * 0.8);
+}
+
+${root} :where(h3.heading-compact) {
+  font-size: calc(var(--fs-h3) * 0.85);
+}`);
+  cssBlocks.push(`/* Body text base styles */
+${root} :where(p, li, td, th, label, span) {
+  font-family: var(--font-body);
+  font-weight: var(--font-weight-body);
+  font-size: var(--fs-body);
+  letter-spacing: var(--ls-body);
+  line-height: var(--lh-body);
+}`);
+  return cssBlocks.join("\n\n");
+}
+
 // ../blocks/src/theme/runtime/buildThemeRuntime.ts
 function buildThemeRuntime(theme, options) {
   const hydrated = hydrateTheme(theme);
@@ -14285,6 +14930,10 @@ function buildThemeRuntime(theme, options) {
     themeId,
     theme
   });
+  const footerCss = generateFooterCss({
+    themeId,
+    theme
+  });
   const cardCss = generateCardCss({
     themeId,
     theme,
@@ -14314,8 +14963,12 @@ function buildThemeRuntime(theme, options) {
     themeId,
     theme
   });
+  const typographyCss = generateTypographyCss({
+    themeId,
+    theme
+  });
   const tokens = buildThemeTokens(hydrated, theme);
-  return { hydrated, cssVars, tokens, paletteTokens: hydrated.palette, buttonCss, headerCss, cardCss, accordionCss, inputCss, layoutCss, statusCss, progressCss };
+  return { hydrated, cssVars, tokens, paletteTokens: hydrated.palette, buttonCss, headerCss, footerCss, cardCss, accordionCss, inputCss, layoutCss, statusCss, progressCss, typographyCss };
 }
 function hydrateTheme(theme) {
   return {
@@ -14345,17 +14998,39 @@ function buildThemeCssVars(theme) {
     ...typography.headings.h1.letterSpacing ? { ["--ls-h1"]: mapLetterSpacing(typography.headings.h1.letterSpacing) } : {},
     ...typography.headings.h2.letterSpacing ? { ["--ls-h2"]: mapLetterSpacing(typography.headings.h2.letterSpacing) } : {},
     ...typography.headings.h3.letterSpacing ? { ["--ls-h3"]: mapLetterSpacing(typography.headings.h3.letterSpacing) } : {},
+    ...typography.headings.h4?.letterSpacing ? { ["--ls-h4"]: mapLetterSpacing(typography.headings.h4.letterSpacing) } : {},
+    ...typography.headings.h5?.letterSpacing ? { ["--ls-h5"]: mapLetterSpacing(typography.headings.h5.letterSpacing) } : {},
+    ...typography.headings.h6?.letterSpacing ? { ["--ls-h6"]: mapLetterSpacing(typography.headings.h6.letterSpacing) } : {},
     ["--lh-heading"]: mapLineHeight(typography.headings.default.lineHeight),
     ["--lh-body"]: mapLineHeight(typography.body.lineHeight),
     ...typography.headings.h1.lineHeight ? { ["--lh-h1"]: mapLineHeight(typography.headings.h1.lineHeight) } : {},
     ...typography.headings.h2.lineHeight ? { ["--lh-h2"]: mapLineHeight(typography.headings.h2.lineHeight) } : {},
     ...typography.headings.h3.lineHeight ? { ["--lh-h3"]: mapLineHeight(typography.headings.h3.lineHeight) } : {},
+    ...typography.headings.h4?.lineHeight ? { ["--lh-h4"]: mapLineHeight(typography.headings.h4.lineHeight) } : {},
+    ...typography.headings.h5?.lineHeight ? { ["--lh-h5"]: mapLineHeight(typography.headings.h5.lineHeight) } : {},
+    ...typography.headings.h6?.lineHeight ? { ["--lh-h6"]: mapLineHeight(typography.headings.h6.lineHeight) } : {},
     ["--tt-heading"]: mapTextTransform(typography.headings.default.case),
     ["--fv-heading"]: mapFontVariant(typography.headings.default.case),
+    ["--fi-heading"]: mapFontStyle(typography.headings.default.italic),
+    // Per-level italic overrides
+    ...typography.headings.h1.italic != null ? { ["--fi-h1"]: mapFontStyle(typography.headings.h1.italic) } : {},
+    ...typography.headings.h2.italic != null ? { ["--fi-h2"]: mapFontStyle(typography.headings.h2.italic) } : {},
+    ...typography.headings.h3.italic != null ? { ["--fi-h3"]: mapFontStyle(typography.headings.h3.italic) } : {},
+    ...typography.headings.h4?.italic != null ? { ["--fi-h4"]: mapFontStyle(typography.headings.h4.italic) } : {},
+    ...typography.headings.h5?.italic != null ? { ["--fi-h5"]: mapFontStyle(typography.headings.h5.italic) } : {},
+    ...typography.headings.h6?.italic != null ? { ["--fi-h6"]: mapFontStyle(typography.headings.h6.italic) } : {},
+    // Static font sizes (fallback)
     ["--fs-body"]: sized.body,
     ["--fs-h3"]: sized.h3,
     ["--fs-h2"]: sized.h2,
     ["--fs-h1"]: sized.h1,
+    // Fluid font sizes (responsive with clamp)
+    ["--fs-h1-fluid"]: sized.h1Fluid,
+    ["--fs-h2-fluid"]: sized.h2Fluid,
+    ["--fs-h3-fluid"]: sized.h3Fluid,
+    // Display variant (for hero/splash headings)
+    ["--fs-h1-display"]: sized.h1Display,
+    ["--fs-h1-display-fluid"]: sized.h1DisplayFluid,
     ["--shadow-elev"]: mapShadow(shadow.elevation, shadow.softness, shadow.position || "bottom"),
     ["--space-mult"]: mapSpaceMult(space),
     ["--motion-duration"]: mapMotionDuration(motion.level),
@@ -14461,33 +15136,81 @@ function mapMotionEasing(e) {
     gentle: "cubic-bezier(.15,.85,.15,1)"
   }[e];
 }
+function normalizeScaleName(scale) {
+  const aliasMap = {
+    minorThird: "compact",
+    majorThird: "balanced",
+    perfectFourth: "spacious",
+    compact: "compact",
+    balanced: "balanced",
+    spacious: "spacious"
+  };
+  return aliasMap[scale] ?? "balanced";
+}
 function computeTypeScale(scale, bodySize) {
   const base = { md: 16, lg: 17, xl: 18 }[bodySize];
-  const ratio = { minorThird: 1.2, majorThird: 1.25, perfectFourth: 1.333 }[scale];
+  const normalizedScale = normalizeScaleName(scale);
+  const ratio = { compact: 1.2, balanced: 1.25, spacious: 1.333 }[normalizedScale];
   const h3 = Math.round(base * ratio);
   const h2 = Math.round(h3 * ratio);
   const h1 = Math.round(h2 * ratio);
+  const fluidMin = 0.7;
+  const fluidMax = 1.3;
   return {
+    // Static sizes (fallback)
     ["--fs-body"]: `${base}px`,
     ["--fs-h3"]: `${h3}px`,
     ["--fs-h2"]: `${h2}px`,
-    ["--fs-h1"]: `${h1}px`
+    ["--fs-h1"]: `${h1}px`,
+    // Fluid typography min/max values
+    ["--fs-h1-min"]: `${Math.round(h1 * fluidMin)}px`,
+    ["--fs-h1-max"]: `${Math.round(h1 * fluidMax)}px`,
+    ["--fs-h2-min"]: `${Math.round(h2 * fluidMin)}px`,
+    ["--fs-h2-max"]: `${Math.round(h2 * fluidMax)}px`,
+    ["--fs-h3-min"]: `${Math.round(h3 * fluidMin)}px`,
+    ["--fs-h3-max"]: `${Math.round(h3 * fluidMax)}px`,
+    // Fluid clamp values (320px to 1200px viewport range = 880px)
+    ["--fs-h1-fluid"]: `clamp(${Math.round(h1 * fluidMin)}px, calc(${Math.round(h1 * fluidMin)}px + ${Math.round(h1 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h1 * fluidMax)}px)`,
+    ["--fs-h2-fluid"]: `clamp(${Math.round(h2 * fluidMin)}px, calc(${Math.round(h2 * fluidMin)}px + ${Math.round(h2 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h2 * fluidMax)}px)`,
+    ["--fs-h3-fluid"]: `clamp(${Math.round(h3 * fluidMin)}px, calc(${Math.round(h3 * fluidMin)}px + ${Math.round(h3 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h3 * fluidMax)}px)`,
+    // Display variant sizes (1.5x for hero headings)
+    ["--fs-h1-display"]: `${Math.round(h1 * 1.5)}px`,
+    ["--fs-h1-display-fluid"]: `clamp(${Math.round(h1 * fluidMin * 1.5)}px, calc(${Math.round(h1 * fluidMin * 1.5)}px + ${Math.round(h1 * (fluidMax - fluidMin) * 1.5)} * ((100vw - 320px) / 880)), ${Math.round(h1 * fluidMax * 1.5)}px)`
   };
 }
+var SIZE_SCALE_MAP = {
+  xs: 0.85,
+  sm: 0.925,
+  md: 1,
+  lg: 1.1,
+  xl: 1.2,
+  "2xl": 1.35
+};
 function applyHeadingSizeOverrides(base, typography) {
   const body = base["--fs-body"];
   const h1Base = parseFloat(base["--fs-h1"].replace("px", ""));
   const h2Base = parseFloat(base["--fs-h2"].replace("px", ""));
   const h3Base = parseFloat(base["--fs-h3"].replace("px", ""));
-  const scaleMap = { md: 1, lg: 1.1, xl: 1.2 };
-  const h1Scale = typography.headings.h1.size ? scaleMap[typography.headings.h1.size] : 1;
-  const h2Scale = typography.headings.h2.size ? scaleMap[typography.headings.h2.size] : 1;
-  const h3Scale = typography.headings.h3.size ? scaleMap[typography.headings.h3.size] : 1;
+  const h1Scale = typography.headings.h1.size ? SIZE_SCALE_MAP[typography.headings.h1.size] : 1;
+  const h2Scale = typography.headings.h2.size ? SIZE_SCALE_MAP[typography.headings.h2.size] : 1;
+  const h3Scale = typography.headings.h3.size ? SIZE_SCALE_MAP[typography.headings.h3.size] : 1;
+  const h1 = Math.round(h1Base * h1Scale);
+  const h2 = Math.round(h2Base * h2Scale);
+  const h3 = Math.round(h3Base * h3Scale);
+  const fluidMin = 0.7;
+  const fluidMax = 1.3;
   return {
     body,
-    h1: `${Math.round(h1Base * h1Scale)}px`,
-    h2: `${Math.round(h2Base * h2Scale)}px`,
-    h3: `${Math.round(h3Base * h3Scale)}px`
+    h1: `${h1}px`,
+    h2: `${h2}px`,
+    h3: `${h3}px`,
+    // Fluid versions with size overrides applied
+    h1Fluid: `clamp(${Math.round(h1 * fluidMin)}px, calc(${Math.round(h1 * fluidMin)}px + ${Math.round(h1 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h1 * fluidMax)}px)`,
+    h2Fluid: `clamp(${Math.round(h2 * fluidMin)}px, calc(${Math.round(h2 * fluidMin)}px + ${Math.round(h2 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h2 * fluidMax)}px)`,
+    h3Fluid: `clamp(${Math.round(h3 * fluidMin)}px, calc(${Math.round(h3 * fluidMin)}px + ${Math.round(h3 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h3 * fluidMax)}px)`,
+    // Display variant (1.5x scale for hero headings)
+    h1Display: `${Math.round(h1 * 1.5)}px`,
+    h1DisplayFluid: `clamp(${Math.round(h1 * 1.5 * fluidMin)}px, calc(${Math.round(h1 * 1.5 * fluidMin)}px + ${Math.round(h1 * 1.5 * (fluidMax - fluidMin))} * ((100vw - 320px) / 880)), ${Math.round(h1 * 1.5 * fluidMax)}px)`
   };
 }
 function mapLetterSpacing(s) {
@@ -14504,6 +15227,9 @@ function mapFontVariant(c) {
   if (c === "smallCaps") return "small-caps";
   return "normal";
 }
+function mapFontStyle(italic) {
+  return italic ? "italic" : "normal";
+}
 
 // ../blocks/src/system/manifest/hydrateLinks.ts
 function hydrateManifestLinks(manifest, content, routes) {
@@ -15096,6 +15822,28 @@ var ENDPOINT_DEFINITIONS = {
     tags: ["site-{siteId}", "api-keys", "access-logs"],
     responseKind: "json"
   },
+  // Management API Keys (SDK write operations)
+  listManagementKeys: {
+    path: "/sites/{siteId}/api-keys/management",
+    method: "GET",
+    auth: "user",
+    tags: ["site-{siteId}", "api-keys", "management-keys"],
+    responseKind: "json"
+  },
+  createManagementKey: {
+    path: "/sites/{siteId}/api-keys/management",
+    method: "POST",
+    auth: "user",
+    tags: ["site-{siteId}", "api-keys", "management-keys"],
+    responseKind: "json"
+  },
+  revokeManagementKey: {
+    path: "/sites/{siteId}/api-keys/management",
+    method: "DELETE",
+    auth: "user",
+    tags: ["site-{siteId}", "api-keys", "management-keys"],
+    responseKind: "json"
+  },
   getBookingSettings: {
     path: "/sites/{siteId}/bookings/settings",
     method: "GET",
@@ -16371,6 +17119,15 @@ var ENDPOINT_DEFINITIONS = {
     auth: "public",
     responseKind: "json"
   },
+  // Resolve event occurrence by URL segment (date or UUID)
+  resolveEventOccurrence: {
+    path: "/public/sites/{siteId}/events/occurrences/resolve",
+    method: "GET",
+    revalidate: 60,
+    tags: ["public-events-{siteId}", "event-occurrence"],
+    auth: "public",
+    responseKind: "json"
+  },
   // Public event registration
   registerForEvent: {
     path: "/public/sites/{siteId}/events/register",
@@ -16545,6 +17302,20 @@ if (typeof window === "undefined") {
     revalidateTag = null;
   }
 }
+var sdkVersion;
+function generateRequestId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r2 = Math.random() * 16 | 0;
+    const v = c === "x" ? r2 : r2 & 3 | 8;
+    return v.toString(16);
+  });
+}
+function setSdkVersion(version2) {
+  sdkVersion = version2;
+}
 var ApiRequestError = class extends Error {
   constructor(message, options) {
     super(message);
@@ -16556,6 +17327,7 @@ var ApiRequestError = class extends Error {
     this.requestId = options.requestId;
     this.body = options.body;
     this.cause = options.cause;
+    this.errorCode = options.errorCode;
   }
 };
 function buildEndpointURL(baseURL, endpoint) {
@@ -16592,6 +17364,29 @@ async function parseErrorBody(response) {
     return null;
   }
 }
+function buildSuccessEnvelope(data, requestId) {
+  return {
+    success: true,
+    data,
+    meta: {
+      requestId: requestId ?? generateRequestId(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      apiVersion: "2025-01-01"
+    }
+  };
+}
+function buildErrorEnvelope(code, message, status, requestId) {
+  return {
+    success: false,
+    error: {
+      code,
+      message,
+      requestId: requestId ?? generateRequestId(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      status
+    }
+  };
+}
 async function parseSuccessResponse(endpoint, response, config) {
   const responseKind = config.responseKind ?? "json";
   const auth = config.auth ?? "user";
@@ -16599,14 +17394,15 @@ async function parseSuccessResponse(endpoint, response, config) {
   switch (responseKind) {
     case "json": {
       if (response.status === 204 || response.status === 205 || response.status === 304) {
-        return void 0;
+        return buildSuccessEnvelope(void 0, requestId);
       }
       const raw = await response.text();
       if (!raw.trim()) {
-        return void 0;
+        return buildSuccessEnvelope(void 0, requestId);
       }
+      let parsed;
       try {
-        return JSON.parse(raw);
+        parsed = JSON.parse(raw);
       } catch (cause) {
         throw new ApiRequestError(
           `Failed to parse JSON response for endpoint ${String(endpoint)}`,
@@ -16621,32 +17417,33 @@ async function parseSuccessResponse(endpoint, response, config) {
           }
         );
       }
+      if (parsed && typeof parsed === "object" && "success" in parsed && typeof parsed.success === "boolean") {
+        return parsed;
+      }
+      return buildSuccessEnvelope(parsed, requestId);
     }
     case "text": {
-      return await response.text();
+      const text2 = await response.text();
+      return buildSuccessEnvelope(text2, requestId);
     }
     case "stream": {
       const body = response.body;
       if (!body) {
-        throw new ApiRequestError(
+        return buildErrorEnvelope(
+          "server:internal_error",
           `Expected a streamed body for endpoint ${String(endpoint)}`,
-          {
-            endpoint,
-            status: response.status,
-            method: config.method,
-            auth,
-            requestId
-          }
+          response.status,
+          requestId
         );
       }
       const stream = body;
-      return stream;
+      return buildSuccessEnvelope(stream, requestId);
     }
     case "void": {
-      return void 0;
+      return buildSuccessEnvelope(void 0, requestId);
     }
     default: {
-      return void 0;
+      return buildSuccessEnvelope(void 0, requestId);
     }
   }
 }
@@ -16712,11 +17509,15 @@ function createRawCMSClient(headers = {}, baseUrl) {
     const requestInit = {
       method,
       ...options,
+      // Include credentials for same-origin requests (sends cookies for auth)
+      credentials: "same-origin",
       // Don't include body for GET/HEAD requests
       body: isGetOrHead ? void 0 : isFormData ? body : body ? JSON.stringify(body) : void 0,
       headers: {
         ...options.headers,
         ...headers,
+        // Include SDK version if set
+        ...sdkVersion && { "x-sdk-version": sdkVersion },
         // Don't set Content-Type for GET/HEAD requests without body
         ...isGetOrHead ? {} : isFormData ? {} : { "Content-Type": "application/json" }
       },
@@ -16770,94 +17571,30 @@ function createBearerAPIClient(token, baseUrl) {
   return createCMSClient(authHeaders, baseUrl);
 }
 
-// ../api/src/aiPlayground.ts
-import { z as z18 } from "zod";
-var Rfc6902PatchOp = z18.discriminatedUnion("op", [
-  // Standard RFC-6902 operations
-  z18.object({
-    op: z18.literal("add"),
-    path: z18.string(),
-    value: z18.unknown()
-  }),
-  z18.object({
-    op: z18.literal("remove"),
-    path: z18.string()
-  }),
-  z18.object({
-    op: z18.literal("replace"),
-    path: z18.string(),
-    value: z18.unknown()
-  }),
-  z18.object({
-    op: z18.literal("move"),
-    from: z18.string(),
-    path: z18.string()
-  }),
-  z18.object({
-    op: z18.literal("copy"),
-    from: z18.string(),
-    path: z18.string()
-  }),
-  // Block-level operations (Phase 2)
-  z18.object({
-    op: z18.literal("add_block"),
-    blockKind: z18.string(),
-    afterBlockId: z18.string().nullable(),
-    content: z18.record(z18.string(), z18.unknown()),
-    rationale: z18.string()
-  }),
-  z18.object({
-    op: z18.literal("delete_block"),
-    blockId: z18.string(),
-    rationale: z18.string()
-  }),
-  z18.object({
-    op: z18.literal("reorder_block"),
-    blockId: z18.string(),
-    afterBlockId: z18.string().nullable(),
-    rationale: z18.string()
-  })
-]);
-var PatchEnvelope = z18.object({
-  blockId: z18.string(),
-  blockKind: z18.string().optional(),
-  blockPurpose: z18.string().optional().nullable(),
-  ops: z18.array(Rfc6902PatchOp),
-  rationale: z18.string(),
-  currentContent: z18.record(z18.string(), z18.unknown()).optional()
-});
-var ContentUpdateResponse = z18.object({
-  patches: z18.array(PatchEnvelope),
-  assistantMessage: z18.string()
-});
-var PlaygroundProposeRequest = z18.object({
-  request: z18.string().min(1).max(2e3)
-});
-var PlaygroundProposeResponse = z18.object({
-  patches: z18.array(PatchEnvelope),
-  assistantMessage: z18.string(),
-  validation: z18.object({
-    valid: z18.boolean(),
-    issues: z18.array(z18.string()),
-    filtered: z18.number()
-  })
-});
-var MultiPagePatchEnvelope = z18.object({
-  pageId: z18.string(),
-  blockId: z18.string().optional(),
-  // Not present for page-level ops
-  blockKind: z18.string().optional(),
-  blockPurpose: z18.string().optional().nullable(),
-  ops: z18.array(Rfc6902PatchOp),
-  rationale: z18.string(),
-  currentContent: z18.record(z18.string(), z18.unknown()).optional()
-});
-var MultiPageUpdateResponse = z18.object({
-  patches: z18.array(MultiPagePatchEnvelope),
-  assistantMessage: z18.string(),
-  pagesModified: z18.number(),
-  toolCallsUsed: z18.number()
-});
+// ../api/src/common/envelope.ts
+function isApiError(result) {
+  return result.success === false;
+}
+function isApiSuccess(result) {
+  return result.success === true;
+}
+var ApiEnvelopeError = class extends Error {
+  constructor(error) {
+    super(error.message);
+    this.name = "ApiEnvelopeError";
+    this.code = error.code;
+    this.requestId = error.requestId;
+    this.timestamp = error.timestamp;
+    this.status = error.status;
+    this.fieldErrors = error.fieldErrors;
+  }
+};
+function unwrapResponse(result) {
+  if (isApiSuccess(result)) {
+    return result.data;
+  }
+  throw new ApiEnvelopeError(result.error);
+}
 
 // src/client/cache.ts
 var SimpleCache = class {
@@ -16895,7 +17632,100 @@ var SimpleCache = class {
   }
 };
 
+// src/version.ts
+var SDK_VERSION = "0.5.0";
+
+// src/client/error.ts
+var RiverbankApiError = class _RiverbankApiError extends Error {
+  constructor(apiError) {
+    super(apiError.message);
+    this.name = "RiverbankApiError";
+    this.code = apiError.code;
+    this.requestId = apiError.requestId;
+    this.status = apiError.status;
+    this.fieldErrors = apiError.fieldErrors;
+    this.timestamp = apiError.timestamp;
+    Object.setPrototypeOf(this, _RiverbankApiError.prototype);
+  }
+  /**
+   * Check if this error matches a specific error code
+   *
+   * @example
+   * ```ts
+   * if (error.is('auth:unauthenticated')) {
+   *   // Redirect to login
+   * }
+   * ```
+   */
+  is(code) {
+    return this.code === code;
+  }
+  /**
+   * Check if this is an authentication or authorization error
+   *
+   * Matches: auth:unauthenticated, auth:token_expired, auth:token_invalid,
+   * auth:forbidden, auth:mfa_required, auth:insufficient_permissions
+   */
+  isAuthError() {
+    return this.code.startsWith("auth:");
+  }
+  /**
+   * Check if this is a validation error
+   *
+   * Matches: validation:invalid_input, validation:missing_field, validation:invalid_format
+   */
+  isValidationError() {
+    return this.code.startsWith("validation:");
+  }
+  /**
+   * Check if this is a resource error (not found, conflict, etc.)
+   *
+   * Matches: resource:not_found, resource:already_exists, resource:conflict, resource:gone
+   */
+  isResourceError() {
+    return this.code.startsWith("resource:");
+  }
+  /**
+   * Check if this is a rate limiting error
+   */
+  isRateLimitError() {
+    return this.code.startsWith("rate_limit:");
+  }
+  /**
+   * Check if this is a billing/payment error
+   */
+  isBillingError() {
+    return this.code.startsWith("billing:");
+  }
+  /**
+   * Check if this is a server error
+   */
+  isServerError() {
+    return this.code.startsWith("server:");
+  }
+};
+
 // src/client/index.ts
+setSdkVersion(SDK_VERSION);
+function convertToTypedError(error) {
+  if (error instanceof ApiEnvelopeError) {
+    throw new RiverbankApiError({
+      code: error.code,
+      message: error.message,
+      requestId: error.requestId,
+      timestamp: error.timestamp,
+      status: error.status,
+      fieldErrors: error.fieldErrors
+    });
+  }
+  if (error instanceof ApiRequestError && error.body && typeof error.body === "object") {
+    const body = error.body;
+    if (isApiError(body)) {
+      throw new RiverbankApiError(body.error);
+    }
+  }
+  throw error;
+}
 function createRiverbankClient(config) {
   if (!config.baseUrl) {
     throw new Error(
@@ -16922,7 +17752,13 @@ function createRiverbankClient(config) {
         return cached;
       }
     }
-    const data = await fetcher();
+    let data;
+    try {
+      const response = await fetcher();
+      data = unwrapResponse(response);
+    } catch (error) {
+      convertToTypedError(error);
+    }
     if (cacheEnabled) {
       cache.set(cacheKey, data);
     }
@@ -16957,33 +17793,27 @@ function createRiverbankClient(config) {
       const entryIdsCacheKey = mode === "manual" && entryIds?.length ? entryIds.join(",") : "";
       const cacheKey = `entries:${siteId}:${contentType}:${limit ?? ""}:${offset ?? ""}:${order ?? ""}:${preview}:${mode ?? ""}:${entryIdsCacheKey}:${includeMeta ?? ""}`;
       return cachedFetch(cacheKey, async () => {
-        const apiParams = {
-          siteId,
-          type: contentType
-        };
-        if (typeof limit === "number") {
-          apiParams.limit = String(limit);
-        }
-        if (typeof offset === "number") {
-          apiParams.offset = String(offset);
-        }
-        if (includeMeta) {
-          apiParams.meta = "true";
-        }
+        let orderParam;
         if (order === "newest") {
-          apiParams.order = "published_at.desc";
+          orderParam = "published_at.desc";
         } else if (order === "oldest") {
-          apiParams.order = "published_at.asc";
+          orderParam = "published_at.asc";
         } else if (order === "title") {
-          apiParams.order = "title.asc";
-        }
-        if (preview) {
-          apiParams.stage = "preview";
-        }
-        if (mode === "manual" && entryIds?.length) {
-          apiParams.mode = "manual";
-          apiParams.entryIds = JSON.stringify(entryIds);
+          orderParam = "title.asc";
         }
+        const apiParams = {
+          siteId,
+          type: contentType,
+          ...typeof limit === "number" && { limit: String(limit) },
+          ...typeof offset === "number" && { offset: String(offset) },
+          ...includeMeta && { meta: "true" },
+          ...orderParam && { order: orderParam },
+          ...preview && { stage: "preview" },
+          ...mode === "manual" && entryIds?.length && {
+            mode: "manual",
+            entryIds: JSON.stringify(entryIds)
+          }
+        };
         return await apiClient({ endpoint: "listPublishedEntries", params: apiParams });
       });
     },
@@ -17011,8 +17841,10 @@ function createRiverbankClient(config) {
       }
       const cacheKey = `public-booking-services:${siteId}:${ids ?? ""}`;
       return cachedFetch(cacheKey, async () => {
-        const apiParams = { siteId };
-        if (ids) apiParams.ids = ids;
+        const apiParams = {
+          siteId,
+          ...ids && { ids }
+        };
         return await apiClient({ endpoint: "getPublicBookingServices", params: apiParams });
       });
     },
@@ -17023,14 +17855,42 @@ function createRiverbankClient(config) {
       }
       const cacheKey = `public-events:${siteId}:${limit ?? ""}:${from ?? ""}:${to ?? ""}:${stage ?? ""}`;
       return cachedFetch(cacheKey, async () => {
-        const apiParams = { siteId };
-        if (typeof limit === "number") apiParams.limit = String(limit);
-        if (from) apiParams.from = from;
-        if (to) apiParams.to = to;
-        if (stage) apiParams.stage = stage;
+        const apiParams = {
+          siteId,
+          ...typeof limit === "number" && { limit: String(limit) },
+          ...from && { from },
+          ...to && { to },
+          ...stage && { stage }
+        };
         return await apiClient({ endpoint: "listPublicEvents", params: apiParams });
       });
     },
+    async resolveEventOccurrence(params) {
+      const { siteId, entryId, segment } = params;
+      if (!siteId || !entryId || !segment) {
+        throw new Error("resolveEventOccurrence() requires siteId, entryId, and segment");
+      }
+      const cacheKey = `event-occurrence:${siteId}:${entryId}:${segment}`;
+      return cachedFetch(cacheKey, async () => {
+        return await apiClient({
+          endpoint: "resolveEventOccurrence",
+          params: { siteId, entryId, segment }
+        });
+      });
+    },
+    async checkRedirect(params) {
+      const { siteId, path } = params;
+      if (!siteId || !path) {
+        throw new Error("checkRedirect() requires siteId and path");
+      }
+      const cacheKey = `redirect:${siteId}:${path}`;
+      return cachedFetch(cacheKey, async () => {
+        return await apiClient({
+          endpoint: "checkRedirect",
+          params: { site: siteId, path }
+        });
+      });
+    },
     clearCache() {
       cache.clear();
     }