@riverbankcms/sdk 0.78.2 → 0.79.0

package/dist/cli/index.mjs

@@ -439,9 +439,24 @@ var init_fileSafety = __esm({
   "../media-core/src/fileSafety.ts"() {
   }
 });
+
+// ../media-core/src/fileDomain.ts
+var AMBIENT_BACKGROUND_ROLES2;
 var init_fileDomain = __esm({
   "../media-core/src/fileDomain.ts"() {
     init_src();
+    AMBIENT_BACKGROUND_ROLES2 = [
+      "light-texture",
+      "proof-band-dark",
+      "cta-wash",
+      "footer-detail",
+      "style-atmosphere-1",
+      "style-atmosphere-2"
+    ];
+    [
+      "selected-background",
+      ...AMBIENT_BACKGROUND_ROLES2
+    ];
     ({
       audio: unsafeAsPositiveByteCount(250 * 1024 * 1024),
       rawVideoBeforeCompression: unsafeAsPositiveByteCount(500 * 1024 * 1024),
@@ -1159,6 +1174,14 @@ var init_repeaterGrid = __esm({
     DEFAULT_REPEATER_GRID_COLUMN_FIELD_ID = "gridColumn";
   }
 });
+
+// ../blocks/src/system/icons/presets.ts
+var ICON_PICKER_PRESETS;
+var init_presets = __esm({
+  "../blocks/src/system/icons/presets.ts"() {
+    ICON_PICKER_PRESETS = ["cta", "feature"];
+  }
+});
 function isDisplayMediaKind(kind) {
   return DISPLAY_MEDIA_KINDS.includes(kind);
 }
@@ -1246,6 +1269,7 @@ var init_schema2 = __esm({
     init_src2();
     init_node();
     init_repeaterGrid();
+    init_presets();
     visibilityLevels = ["admin", "designer", "author"];
     MEDIA_KINDS = [
       "image",
@@ -1397,7 +1421,7 @@ var init_schema2 = __esm({
       layoutGridColumnField: z.string().optional(),
       layoutGridMaxRows: z.number().int().positive().optional(),
       // Icon picker configuration (used when ui.widget === 'iconPicker')
-      iconPickerPreset: z.enum(["cta"]).optional(),
+      iconPickerPreset: z.enum(ICON_PICKER_PRESETS).optional(),
       // Entry picker configuration
       contentTypeField: z.string().optional(),
       fixedContentType: z.string().optional(),
@@ -3067,7 +3091,7 @@ function parseThemeColorToken(value) {
   if (!isThemeColorToken(value)) return null;
   return value.trim();
 }
-var PALETTE_TOKEN_NAMES, paletteTokenNameSchema, themeColorBaseTokenNames, themeColorBaseTokenSet, SHADE_STEPS, shadeStepSet, themeColorTokenSchema;
+var PALETTE_TOKEN_NAMES, paletteTokenNameSchema, themeColorBaseTokenNames, themeColorBaseTokenSet, themeColorShadeSteps, shadeStepSet, themeColorTokenSchema;
 var init_themeColorTokens = __esm({
   "../theme-core/src/tokens/themeColorTokens.ts"() {
     init_blockColorTokens();
@@ -3101,7 +3125,7 @@ var init_themeColorTokens = __esm({
       "accentForeground"
     ];
     themeColorBaseTokenSet = new Set(themeColorBaseTokenNames);
-    SHADE_STEPS = [
+    themeColorShadeSteps = [
       "50",
       "100",
       "200",
@@ -3114,7 +3138,7 @@ var init_themeColorTokens = __esm({
       "900",
       "950"
     ];
-    shadeStepSet = new Set(SHADE_STEPS);
+    shadeStepSet = new Set(themeColorShadeSteps);
     themeColorTokenSchema = z.string().min(1).refine((value) => Boolean(isThemeColorToken(value)), "Expected a known Theme V2 color token");
   }
 });
@@ -4283,7 +4307,7 @@ var init_generateButtonCss = __esm({
 });
 
 // ../theme-core/src/buttons/presets.ts
-var init_presets = __esm({
+var init_presets2 = __esm({
   "../theme-core/src/buttons/presets.ts"() {
   }
 });
@@ -4308,7 +4332,7 @@ var init_buttons = __esm({
     init_generateButtonCss();
     init_generateDefaultButtonSystem();
     init_constants();
-    init_presets();
+    init_presets2();
     init_personalities();
     init_types5();
     init_registry();
@@ -7473,6 +7497,7 @@ var init_curatedSiteStyles = __esm({
       "site-style:personal-retreat-journal",
       "site-style:tactile-workshop",
       "site-style:modern-wellness",
+      "site-style:clarity-zen-blue",
       SOFT_EARTH_SITE_STYLE_ID_VALUE,
       "site-style:bold-launch",
       "site-style:south-west-twerk-school"
@@ -7825,6 +7850,114 @@ var init_curatedSiteStyles = __esm({
           paletteChoice("warm-neutral-clay")
         ]
       }),
+      defineCuratedSiteStyle({
+        id: "site-style:clarity-zen-blue",
+        name: "Clarity Zen",
+        description: "Calm, editorial, and reassuring for therapy, counselling, and wellbeing support practices.",
+        generationBrief: "Use a calm, soft palette, editorial serif headings, warm grounded copy, rounded cards, calm proof sections, and clear booking routes. Keep the tone compassionate and straightforward, with professional trust rather than hard-sell wellness language.",
+        siteCreatorSelection: {
+          kind: "site_creator_keyword_heuristic",
+          priority: 25
+        },
+        selectionKeywordRules: [
+          { kind: "substring", value: "psychotherap" },
+          { kind: "phrase", value: "mental health" },
+          { kind: "phrase", value: "talk therapy" },
+          { kind: "phrase", value: "therapy and wellbeing" }
+        ],
+        tokenRecipes: {
+          palette: "brand-led",
+          contrast: "standard",
+          radius: "rounded",
+          shadow: "subtle",
+          typography: "serif-editorial",
+          spacing: "airy",
+          motion: "subtle"
+        },
+        compositionBudget: balancedBudget,
+        themeOverrides: {
+          typography: {
+            body: {
+              family: "Inter, system-ui, sans-serif",
+              size: "md",
+              weight: "regular",
+              lineHeight: "relaxed",
+              letterSpacing: "normal"
+            },
+            headings: {
+              default: {
+                family: '"Cormorant Garamond", Georgia, serif',
+                weight: "regular",
+                lineHeight: "normal",
+                letterSpacing: "normal",
+                colorToken: "text",
+                italic: null,
+                case: null
+              },
+              h1: {
+                size: "xl",
+                weight: "regular",
+                lineHeight: "normal",
+                letterSpacing: "normal",
+                italic: null
+              },
+              h2: {
+                size: "lg",
+                weight: "regular",
+                lineHeight: "normal",
+                letterSpacing: "normal",
+                italic: null
+              },
+              h3: {
+                size: "md",
+                weight: "regular",
+                lineHeight: "normal",
+                letterSpacing: "normal",
+                italic: null
+              }
+            },
+            scale: "majorThird"
+          },
+          bodyText: {
+            intro: {
+              paragraphSize: "default",
+              headingSize: "editorial"
+            }
+          }
+        },
+        defaultBlockVariants: {
+          "block.faq": "split-heading-columns"
+        },
+        recommendedAppearancePresetIds: [
+          "hero-split-editorial",
+          "intro-organic-statement",
+          "feature-cards-raised-rule",
+          "media-text-quiet-story",
+          "testimonials-brand-background-quotes",
+          "faq-contained-help",
+          "contact-form-panel"
+        ],
+        recommendedHeaderLookIds: [
+          "centered-calm",
+          "serif-line",
+          "minimal-transparent"
+        ],
+        recommendedFooterLookIds: [
+          "footer-muted-grounding",
+          "site-footer-brand-two-band"
+        ],
+        buttonPersonalityChoices: [
+          buttonChoice("soft-pill"),
+          buttonChoice("pebble"),
+          buttonChoice("editorial-link")
+        ],
+        paletteVariantChoices: [
+          paletteChoice("brand-led-cool"),
+          paletteChoice("soft-natural-watercolor"),
+          paletteChoice("soft-natural-stone"),
+          paletteChoice("warm-neutral-cream")
+        ]
+      }),
       defineCuratedSiteStyle({
         id: "site-style:personal-retreat-journal",
         name: "Personal Retreat Journal",
@@ -12212,36 +12345,46 @@ function buildCarouselLayout() {
     [buildTestimonialCard(repeat("data.entries", "testimonial"))]
   );
 }
+function buildResponsiveGridCards() {
+  return [
+    // 2 columns
+    grid(
+      { gap: "lg", cols: { base: 1, sm: 2 } },
+      [buildTestimonialCard(repeat("data.entries", "testimonial"))],
+      when("gridColumns", { equals: "2" })
+    ),
+    // 3 columns (default when unset)
+    grid(
+      { gap: "lg", cols: { base: 1, sm: 2, lg: 3 } },
+      [buildTestimonialCard(repeat("data.entries", "testimonial"))],
+      when("gridColumns", { equals: "3" })
+    ),
+    // 4 columns
+    grid(
+      { gap: "lg", cols: { base: 1, sm: 2, lg: 3, xl: 4 } },
+      [buildTestimonialCard(repeat("data.entries", "testimonial"))],
+      when("gridColumns", { equals: "4" })
+    ),
+    // Fallback to 3 columns when gridColumns is not set
+    grid(
+      { gap: "lg", cols: { base: 1, sm: 2, lg: 3 } },
+      [buildTestimonialCard(repeat("data.entries", "testimonial"))],
+      when("gridColumns", { not: true })
+    )
+  ];
+}
 function buildGridLayout() {
   return el(
     "div",
     { className: "rb-mt-12 rb-testimonials-carousel" },
-    [
-      // 2 columns
-      grid(
-        { gap: "lg", cols: { base: 1, sm: 2 } },
-        [buildTestimonialCard(repeat("data.entries", "testimonial"))],
-        when("gridColumns", { equals: "2" })
-      ),
-      // 3 columns (default when unset)
-      grid(
-        { gap: "lg", cols: { base: 1, sm: 2, lg: 3 } },
-        [buildTestimonialCard(repeat("data.entries", "testimonial"))],
-        when("gridColumns", { equals: "3" })
-      ),
-      // 4 columns
-      grid(
-        { gap: "lg", cols: { base: 1, sm: 2, lg: 3, xl: 4 } },
-        [buildTestimonialCard(repeat("data.entries", "testimonial"))],
-        when("gridColumns", { equals: "4" })
-      ),
-      // Fallback to 3 columns when gridColumns is not set
-      grid(
-        { gap: "lg", cols: { base: 1, sm: 2, lg: 3 } },
-        [buildTestimonialCard(repeat("data.entries", "testimonial"))],
-        when("gridColumns", { not: true })
-      )
-    ]
+    buildResponsiveGridCards()
+  );
+}
+function buildGridCardsLayout(className) {
+  return el(
+    "div",
+    { className },
+    buildResponsiveGridCards()
   );
 }
 var grid, testimonialsCarouselFragment;
@@ -14477,7 +14620,7 @@ var init_form_interactive = __esm({
 });
 
 // ../blocks/src/lib/typeGuards.ts
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var init_typeGuards = __esm({
@@ -19373,6 +19516,46 @@ var ENDPOINT_DEFINITIONS = {
     auth: "user",
     responseKind: "json"
   },
+  getSiteIconStyleGuide: {
+    path: "/sites/{siteId}/settings/icon-style-guide",
+    method: "GET",
+    revalidate: 120,
+    tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+    auth: "user",
+    responseKind: "json",
+    errors: []
+  },
+  updateSiteIconStyleGuide: {
+    path: "/sites/{siteId}/settings/icon-style-guide",
+    method: "POST",
+    tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+    auth: "user",
+    responseKind: "json",
+    errors: []
+  },
+  regenerateSiteIconStyleGuide: {
+    path: "/sites/{siteId}/settings/icon-style-guide/regenerate",
+    method: "POST",
+    tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+    auth: "user",
+    responseKind: "json",
+    errors: []
+  },
+  generateGeneratedIconSet: {
+    path: "/sites/{siteId}/ai/generated-icons/generate",
+    method: "POST",
+    auth: "user",
+    responseKind: "json",
+    errors: []
+  },
+  applyGeneratedIconSet: {
+    path: "/sites/{siteId}/ai/generated-icons/apply",
+    method: "POST",
+    tags: [TAG_TEMPLATES.site, TAG_TEMPLATES.siteSettings],
+    auth: "user",
+    responseKind: "json",
+    errors: []
+  },
   getSiteAiProfile: {
     path: "/sites/{siteId}/settings/ai-site-profile",
     method: "GET",
@@ -21148,6 +21331,14 @@ var ENDPOINT_DEFINITIONS = {
     auth: "public",
     responseKind: "json"
   },
+  getGeneratedIconRenderAssets: {
+    path: "/public/sites/{siteId}/generated-icon-assets",
+    method: "POST",
+    tags: [TAG_TEMPLATES.siteRoutableContent],
+    auth: "public",
+    responseKind: "json",
+    errors: []
+  },
   // Resolve entry subroute by kind and URL segment
   resolveEntrySubroute: {
     path: "/public/sites/{siteId}/routing/subroutes/resolve",
@@ -22852,6 +23043,13 @@ var ENDPOINT_DEFINITIONS = {
     auth: "service",
     responseKind: "json"
   },
+  sdkDeleteNavigationMenu: {
+    path: "/sdk/{siteId}/navigation/{menuId}",
+    method: "DELETE",
+    auth: "service",
+    responseKind: "json",
+    errors: ["resource:not_found", "server:internal_error"]
+  },
   sdkUpsertTheme: {
     path: "/sdk/{siteId}/theme",
     method: "POST",
@@ -23619,6 +23817,370 @@ var linkSchema = z.union([
 
 // ../blocks/src/system/manifest/fieldValidation/index.ts
 init_schema2();
+
+// ../blocks/src/system/icons/ids.ts
+var GENERATED_ICON_SET_ID_PATTERN = /^generated-icon-set:[a-z0-9][a-z0-9:_-]{0,107}$/u;
+var GENERATED_ICON_ASSET_ID_PATTERN = /^generated-icon-asset:[a-z0-9][a-z0-9:_-]{0,105}$/u;
+var SITE_ICON_STYLE_GUIDE_VERSION_ID_PATTERN = /^site-icon-style-guide:[a-f0-9]{16}$/u;
+function normalizeString(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function unsafeAsGeneratedIconSetId(value) {
+  return value;
+}
+function unsafeAsGeneratedIconAssetId(value) {
+  return value;
+}
+function unsafeAsSiteIconStyleGuideVersionId(value) {
+  return value;
+}
+function parseGeneratedIconSetId(value) {
+  const normalized = normalizeString(value);
+  return normalized !== null && GENERATED_ICON_SET_ID_PATTERN.test(normalized) ? unsafeAsGeneratedIconSetId(normalized) : null;
+}
+function parseGeneratedIconAssetId(value) {
+  const normalized = normalizeString(value);
+  return normalized !== null && GENERATED_ICON_ASSET_ID_PATTERN.test(normalized) ? unsafeAsGeneratedIconAssetId(normalized) : null;
+}
+function parseSiteIconStyleGuideVersionId(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return SITE_ICON_STYLE_GUIDE_VERSION_ID_PATTERN.test(normalized) ? unsafeAsSiteIconStyleGuideVersionId(normalized) : null;
+}
+
+// ../blocks/src/system/icons/semantic.ts
+var SEMANTIC_ICON_IDS = [
+  "protection-trust",
+  "confidentiality",
+  "care-support",
+  "partnership",
+  "warmth",
+  "community",
+  "personal-guidance",
+  "conversation",
+  "friendly-welcome",
+  "insight-learning",
+  "natural-wellbeing",
+  "growth",
+  "gentle-care",
+  "special-touch",
+  "ideas",
+  "direction",
+  "focus",
+  "quality",
+  "highlight",
+  "verified-quality",
+  "learning",
+  "training",
+  "programmes-dates",
+  "place",
+  "products",
+  "packages",
+  "time",
+  "practical-service",
+  "at-home",
+  "worldwide",
+  "professional-service"
+];
+var featurePreset = ["feature"];
+var SEMANTIC_ICON_DEFINITIONS = [
+  {
+    id: "protection-trust",
+    label: "Protection and trust",
+    tags: ["safe", "safety", "security", "trust", "privacy", "confidence"],
+    domains: ["wellbeing", "services", "technology"],
+    tone: ["trustworthy", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "confidentiality",
+    label: "Confidentiality",
+    tags: ["confidential", "privacy", "secure", "protected", "private"],
+    domains: ["wellbeing", "coaching", "services", "technology"],
+    tone: ["trustworthy", "calm"],
+    presets: featurePreset
+  },
+  {
+    id: "care-support",
+    label: "Care and support",
+    tags: ["care", "support", "therapy", "kindness", "help", "compassion"],
+    domains: ["wellbeing", "coaching", "community"],
+    tone: ["warm", "human"],
+    presets: featurePreset
+  },
+  {
+    id: "partnership",
+    label: "Partnership",
+    tags: ["partnership", "together", "support", "relationship", "collaboration"],
+    domains: ["coaching", "community", "services"],
+    tone: ["warm", "human", "trustworthy"],
+    presets: featurePreset
+  },
+  {
+    id: "warmth",
+    label: "Warmth",
+    tags: ["heart", "warmth", "care", "love", "wellbeing", "personal"],
+    domains: ["wellbeing", "community", "hospitality"],
+    tone: ["warm", "human"],
+    presets: featurePreset
+  },
+  {
+    id: "community",
+    label: "Community",
+    tags: ["community", "group", "people", "team", "members", "belonging"],
+    domains: ["community", "education", "events"],
+    tone: ["human", "warm"],
+    presets: featurePreset
+  },
+  {
+    id: "personal-guidance",
+    label: "Personal guidance",
+    tags: ["guidance", "personal", "coach", "expert", "one to one", "trusted"],
+    domains: ["coaching", "services", "education"],
+    tone: ["trustworthy", "human"],
+    presets: featurePreset
+  },
+  {
+    id: "conversation",
+    label: "Conversation",
+    tags: ["conversation", "talk", "chat", "communication", "support"],
+    domains: ["coaching", "community", "services"],
+    tone: ["human", "warm"],
+    presets: featurePreset
+  },
+  {
+    id: "friendly-welcome",
+    label: "Friendly welcome",
+    tags: ["friendly", "welcome", "positive", "happy", "approachable"],
+    domains: ["hospitality", "community", "services"],
+    tone: ["warm", "playful", "human"],
+    presets: featurePreset
+  },
+  {
+    id: "insight-learning",
+    label: "Insight and learning",
+    tags: ["mind", "insight", "learning", "clarity", "thinking", "therapy"],
+    domains: ["wellbeing", "coaching", "education"],
+    tone: ["calm", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "natural-wellbeing",
+    label: "Natural wellbeing",
+    tags: ["natural", "wellbeing", "growth", "eco", "calm", "organic"],
+    domains: ["wellbeing", "hospitality", "creative"],
+    tone: ["calm", "warm"],
+    presets: featurePreset
+  },
+  {
+    id: "growth",
+    label: "Growth",
+    tags: ["growth", "new", "progress", "development", "nurture"],
+    domains: ["wellbeing", "coaching", "education", "community"],
+    tone: ["warm", "calm"],
+    presets: featurePreset
+  },
+  {
+    id: "gentle-care",
+    label: "Gentle care",
+    tags: ["gentle", "soft", "care", "wellbeing", "beauty", "calm"],
+    domains: ["wellbeing", "creative", "hospitality"],
+    tone: ["warm", "calm", "premium"],
+    presets: featurePreset
+  },
+  {
+    id: "special-touch",
+    label: "Special touch",
+    tags: ["special", "sparkle", "magic", "polish", "delight", "creative"],
+    domains: ["creative", "commerce", "hospitality"],
+    tone: ["playful", "premium"],
+    presets: featurePreset
+  },
+  {
+    id: "ideas",
+    label: "Ideas",
+    tags: ["idea", "innovation", "clarity", "creative", "strategy"],
+    domains: ["coaching", "education", "creative", "technology"],
+    tone: ["practical", "playful"],
+    presets: featurePreset
+  },
+  {
+    id: "direction",
+    label: "Direction",
+    tags: ["direction", "navigation", "path", "journey", "guidance"],
+    domains: ["coaching", "education", "services"],
+    tone: ["trustworthy", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "focus",
+    label: "Focus",
+    tags: ["focus", "goal", "outcome", "aim", "strategy"],
+    domains: ["coaching", "services", "technology"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "quality",
+    label: "Quality",
+    tags: ["quality", "award", "standard", "achievement", "premium"],
+    domains: ["services", "education", "commerce"],
+    tone: ["premium", "trustworthy"],
+    presets: featurePreset
+  },
+  {
+    id: "highlight",
+    label: "Highlight",
+    tags: ["highlight", "featured", "favorite", "quality", "special"],
+    domains: ["creative", "commerce", "services"],
+    tone: ["playful", "premium"],
+    presets: featurePreset
+  },
+  {
+    id: "verified-quality",
+    label: "Verified quality",
+    tags: ["verified", "quality", "approved", "trusted", "check"],
+    domains: ["services", "commerce", "education"],
+    tone: ["trustworthy", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "learning",
+    label: "Learning",
+    tags: ["learning", "book", "course", "knowledge", "education"],
+    domains: ["education", "coaching", "community"],
+    tone: ["calm", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "training",
+    label: "Training",
+    tags: ["training", "course", "qualification", "school", "education"],
+    domains: ["education", "coaching"],
+    tone: ["trustworthy", "practical"],
+    presets: featurePreset
+  },
+  {
+    id: "programmes-dates",
+    label: "Programmes and dates",
+    tags: ["calendar", "dates", "schedule", "events", "programme", "classes"],
+    domains: ["events", "education", "community"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "place",
+    label: "Place",
+    tags: ["place", "location", "local", "venue", "destination"],
+    domains: ["events", "hospitality", "services"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "products",
+    label: "Products",
+    tags: ["products", "shop", "store", "retail", "commerce"],
+    domains: ["commerce"],
+    tone: ["practical", "premium"],
+    presets: featurePreset
+  },
+  {
+    id: "packages",
+    label: "Packages",
+    tags: ["package", "bundle", "delivery", "offer", "product"],
+    domains: ["commerce", "services"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "time",
+    label: "Time",
+    tags: ["time", "duration", "schedule", "availability", "appointment"],
+    domains: ["events", "services", "wellbeing"],
+    tone: ["practical", "calm"],
+    presets: featurePreset
+  },
+  {
+    id: "practical-service",
+    label: "Practical service",
+    tags: ["service", "repair", "setup", "practical", "tools", "support"],
+    domains: ["services", "technology"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "at-home",
+    label: "At home",
+    tags: ["home", "domestic", "comfort", "local", "space"],
+    domains: ["hospitality", "services", "community"],
+    tone: ["warm", "calm"],
+    presets: featurePreset
+  },
+  {
+    id: "worldwide",
+    label: "Worldwide",
+    tags: ["global", "online", "worldwide", "remote", "international"],
+    domains: ["technology", "education", "services"],
+    tone: ["practical"],
+    presets: featurePreset
+  },
+  {
+    id: "professional-service",
+    label: "Professional service",
+    tags: ["business", "professional", "consulting", "service", "work"],
+    domains: ["services", "technology", "coaching"],
+    tone: ["practical", "trustworthy"],
+    presets: featurePreset
+  }
+];
+SEMANTIC_ICON_DEFINITIONS.map(({ id, label }) => ({
+  id,
+  label
+}));
+function isSemanticIconId(value) {
+  return typeof value === "string" && SEMANTIC_ICON_IDS.includes(value);
+}
+
+// ../blocks/src/system/icons/value.ts
+var NO_BLOCK_ICON_VALUE = { kind: "none" };
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseBlockIconValue(value) {
+  if (isSemanticIconId(value)) {
+    return { kind: "semantic", iconId: value };
+  }
+  if (!isRecord(value)) {
+    return NO_BLOCK_ICON_VALUE;
+  }
+  switch (value.kind) {
+    case "none":
+      return NO_BLOCK_ICON_VALUE;
+    case "semantic":
+      return isSemanticIconId(value.iconId) ? { kind: "semantic", iconId: value.iconId } : NO_BLOCK_ICON_VALUE;
+    case "generated": {
+      const setId = parseGeneratedIconSetId(value.setId);
+      const assetId = parseGeneratedIconAssetId(value.assetId);
+      const styleGuideVersionId = parseSiteIconStyleGuideVersionId(value.styleGuideVersionId);
+      if (setId !== null && assetId !== null && isSemanticIconId(value.semanticFallbackIconId) && styleGuideVersionId !== null) {
+        return {
+          kind: "generated",
+          setId,
+          assetId,
+          semanticFallbackIconId: value.semanticFallbackIconId,
+          styleGuideVersionId
+        };
+      }
+      return NO_BLOCK_ICON_VALUE;
+    }
+    default:
+      return NO_BLOCK_ICON_VALUE;
+  }
+}
+
+// ../blocks/src/system/manifest/fieldValidation/index.ts
 var TEL_RE = /^[+()0-9\s-]{3,}$/;
 var SLUG_PATTERN = /^(?:[a-z0-9]+(?:-[a-z0-9]+)*)(?:\/(?:[a-z0-9]+(?:-[a-z0-9]+)*))*$/;
 var ALLOWED_URL_PROTOCOLS = ["http:", "https:"];
@@ -23707,7 +24269,7 @@ function deriveFieldValidationPlan(field, path24 = [field.id]) {
         return makePlan("number", "number", field, path24, required, constraints2);
       }
       const constraints = commonConstraints(required, {
-        kind: "textType"
+        kind: field.ui?.widget === "iconPicker" ? "blockIconValue" : "textType"
       });
       if (inputType === "email") constraints.push({ kind: "emailFormat" });
       if (inputType === "tel") constraints.push({ kind: "phoneFormat" });
@@ -24040,39 +24602,52 @@ function isMissingForPlan(plan, value) {
   return false;
 }
 function validateStringPlan(plan, value) {
+  if (plan.constraints.some((constraint) => constraint.kind === "blockIconValue")) {
+    return plan.constraints.flatMap((constraint) => validateStringConstraint(plan, constraint, value));
+  }
   if (typeof value !== "string") return [issue(plan, "wrongType", { expected: "text" })];
   return plan.constraints.flatMap((constraint) => validateStringConstraint(plan, constraint, value));
 }
 function validateStringConstraint(plan, constraint, value) {
   switch (constraint.kind) {
     case "required":
+      return [];
     case "textType":
     case "referenceText":
-      return [];
+      return typeof value === "string" ? [] : [issue(plan, "wrongType", { expected: "text" })];
+    case "blockIconValue":
+      return isValidIconPickerValue(value) ? [] : [issue(plan, "wrongType", { expected: "text or icon" })];
     case "maxLength":
-      return value.length > constraint.maximum ? [issue(plan, "tooLong", { maximum: constraint.maximum })] : [];
+      return typeof value === "string" && value.length > constraint.maximum ? [issue(plan, "tooLong", { maximum: constraint.maximum })] : [];
     case "emailFormat":
-      return isCanonicalEmailValue(value) ? [] : [issue(plan, "invalidEmail")];
+      return typeof value === "string" && isCanonicalEmailValue(value) ? [] : [issue(plan, "invalidEmail")];
     case "phoneFormat":
-      return isCanonicalPhoneValue(value) ? [] : [issue(plan, "invalidPhone")];
+      return typeof value === "string" && isCanonicalPhoneValue(value) ? [] : [issue(plan, "invalidPhone")];
     case "patternFormat": {
+      if (typeof value !== "string") return [issue(plan, "wrongType", { expected: "text" })];
       const re = compilePattern(constraint.pattern);
       return re && !re.test(value) ? [issue(plan, "invalidPattern")] : [];
     }
     case "urlFormat":
-      return isCanonicalUrlValue(value, { allowRelative: constraint.allowRelative }) ? [] : [issue(plan, "invalidUrl")];
+      return typeof value === "string" && isCanonicalUrlValue(value, { allowRelative: constraint.allowRelative }) ? [] : [issue(plan, "invalidUrl")];
     case "dateFormat":
-      return isValidDateString(value) ? [] : [issue(plan, "invalidDate")];
+      return typeof value === "string" && isValidDateString(value) ? [] : [issue(plan, "invalidDate")];
     case "timeFormat":
-      return isValidTimeString(value) ? [] : [issue(plan, "invalidTime")];
+      return typeof value === "string" && isValidTimeString(value) ? [] : [issue(plan, "invalidTime")];
     case "datetimeFormat":
-      return isValidDateTimeInstantString(value) ? [] : [issue(plan, "invalidDateTime")];
+      return typeof value === "string" && isValidDateTimeInstantString(value) ? [] : [issue(plan, "invalidDateTime")];
     case "slugFormat":
-      return SLUG_PATTERN.test(value) ? [] : [issue(plan, "invalidSlug")];
+      return typeof value === "string" && SLUG_PATTERN.test(value) ? [] : [issue(plan, "invalidSlug")];
     default:
       return assertNever2(constraint);
   }
 }
+function isValidIconPickerValue(value) {
+  if (typeof value === "string") return true;
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  if (value.kind === "none") return true;
+  return parseBlockIconValue(value).kind !== "none";
+}
 function validateNumberPlan(plan, value) {
   if (!isValidNumber(value)) return [issue(plan, "invalidNumber")];
   return plan.constraints.flatMap((constraint) => validateNumberConstraint(plan, constraint, Number(value)));
@@ -25639,6 +26214,24 @@ var questionColumnsLayout = styledSection({
   }),
   baseClass: ""
 });
+var splitHeadingColumnsLayout = styledSection({
+  children: styledContainer({
+    baseClassName: "rb-relative rb-isolate",
+    children: el(
+      "div",
+      {
+        className: "rb-faq-split-heading-columns rb-grid rb-grid-cols-1 rb-gap-8 rb-lg-grid-cols-2 rb-lg-items-start"
+      },
+      [
+        el("div", { className: "rb-faq-split-heading-columns-copy" }, [headingLayout]),
+        el("div", { className: "rb-faq-split-heading-columns-accordion" }, [
+          questionColumnsAccordionLayout
+        ])
+      ]
+    )
+  }),
+  baseClass: ""
+});
 var faqManifest = createBlockManifest({
   id: "block.faq",
   title: "FAQ",
@@ -25659,7 +26252,8 @@ var faqManifest = createBlockManifest({
   variants: {
     default: defaultLayout,
     "two-column": twoColumnLayout,
-    "question-columns": questionColumnsLayout
+    "question-columns": questionColumnsLayout,
+    "split-heading-columns": splitHeadingColumnsLayout
   },
   defaultVariant: "default",
   variantOptions: {
@@ -25674,6 +26268,10 @@ var faqManifest = createBlockManifest({
     "question-columns": {
       label: "Question columns",
       description: "A full-width heading above FAQ items split into two columns."
+    },
+    "split-heading-columns": {
+      label: "Split heading columns",
+      description: "A left heading column with FAQ items split into two columns on the right."
     }
   },
   description: "Accordion of frequently asked questions and answers.",
@@ -26912,16 +27510,16 @@ var interpolateRichTextTokensOptionsSchema = z.object({
 var richTextTokenPattern = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
 function getSiteName(context) {
   const viewModel = context.viewModel;
-  if (!isRecord2(viewModel)) return null;
+  if (!isRecord3(viewModel)) return null;
   const site = viewModel.site;
-  if (isRecord2(site) && typeof site.title === "string") {
+  if (isRecord3(site) && typeof site.title === "string") {
     const title = site.title.trim();
     return title.length > 0 ? title : null;
   }
   const root = viewModel.$root;
-  if (isRecord2(root)) {
+  if (isRecord3(root)) {
     const rootSite = root.site;
-    if (isRecord2(rootSite) && typeof rootSite.title === "string") {
+    if (isRecord3(rootSite) && typeof rootSite.title === "string") {
       const title = rootSite.title.trim();
       if (title.length > 0) return title;
     }
@@ -26943,7 +27541,7 @@ function replaceTokenText(input, allowedTokens, tokenValues) {
   });
 }
 function visitRichTextNode(node, allowedTokens, tokenValues) {
-  if (!isRecord2(node)) return node;
+  if (!isRecord3(node)) return node;
   let changed = false;
   const nextNode = { ...node };
   if (nextNode.type === "text" && typeof nextNode.text === "string") {
@@ -26969,13 +27567,13 @@ function visitRichTextNode(node, allowedTokens, tokenValues) {
   return changed ? nextNode : node;
 }
 function interpolateRichTextTokens(value, options, context) {
-  if (!isRecord2(value)) return value;
+  if (!isRecord3(value)) return value;
   const allowedTokens = new Set(options.tokens);
   const tokenValues = {
     year: String((/* @__PURE__ */ new Date()).getFullYear()),
     site_name: getSiteName(context)
   };
-  if (isRecord2(value.doc)) {
+  if (isRecord3(value.doc)) {
     const nextDoc = visitRichTextNode(value.doc, allowedTokens, tokenValues);
     if (nextDoc === value.doc) return value;
     return { ...value, doc: nextDoc };
@@ -27774,6 +28372,8 @@ init_boxStyles();
 init_defineBlock();
 init_builder();
 init_fragments2();
+init_colorStyles();
+var backgroundImageClassName = "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-object-cover rb-opacity-50";
 var wrapVariant = (variantLayout) => styledSection({
   children: styledContainer({
     children: stack(
@@ -27787,10 +28387,53 @@ var wrapVariant = (variantLayout) => styledSection({
   // styledContainer (rb-container) already provides horizontal padding
   baseClass: "",
   spacing: "comfortable",
-  imageClassName: "rb-absolute rb-inset-0 rb-z-neg-10 rb-h-full rb-w-full rb-object-cover rb-opacity-50"
+  imageClassName: backgroundImageClassName
 });
 var carouselLayout = wrapVariant(buildCarouselLayout());
 var gridLayout2 = wrapVariant(buildGridLayout());
+var splitHeading = stack(
+  { gap: "md", className: "rb-testimonials-split-heading-copy rb-max-w-xl" },
+  [
+    text(
+      { as: "h2" },
+      when("content.heading"),
+      bind("content.heading")
+    ),
+    headingDecoration({
+      family: "short-center-rule",
+      placement: "after-heading"
+    }),
+    text(
+      {
+        as: "p",
+        className: "rb-prose",
+        style: textColorStyle("mutedText")
+      },
+      when("content.subheading"),
+      bind("content.subheading")
+    )
+  ]
+);
+var splitGridLayout = styledSection({
+  children: styledContainer({
+    baseClassName: "rb-relative rb-isolate",
+    children: el(
+      "div",
+      {
+        className: "rb-testimonials-split-grid rb-grid rb-grid-cols-1 rb-gap-8 rb-lg-grid-cols-2 rb-lg-items-start"
+      },
+      [
+        el("div", { className: "rb-testimonials-split-grid-heading" }, [splitHeading]),
+        el("div", { className: "rb-testimonials-split-grid-cards" }, [
+          buildGridCardsLayout("rb-testimonials-split-grid-card-list")
+        ])
+      ]
+    )
+  }),
+  baseClass: "",
+  spacing: "comfortable",
+  imageClassName: backgroundImageClassName
+});
 var additionalFields = parseFieldDefinitions([
   // Heading fields from fragment
   ...testimonialsHeadingFragment.fields,
@@ -27822,7 +28465,7 @@ var additionalFields = parseFieldDefinitions([
     ],
     ui: {
       intent: "display",
-      visibleWhen: { field: "variant", equals: "grid" }
+      visibleWhen: { field: "variant", oneOf: ["grid", "split-grid"] }
     }
   },
   // Carousel-specific fields (from fragment)
@@ -27856,7 +28499,8 @@ var testimonialsManifest = createBlockManifest({
   // Variant system - enables the variant switcher control in the editor
   variants: {
     carousel: carouselLayout,
-    grid: gridLayout2
+    grid: gridLayout2,
+    "split-grid": splitGridLayout
   },
   defaultVariant: "carousel",
   variantOptions: {
@@ -27869,6 +28513,11 @@ var testimonialsManifest = createBlockManifest({
       label: "Grid",
       description: "Responsive grid layout",
       icon: "Grid"
+    },
+    "split-grid": {
+      label: "Split grid",
+      description: "Heading on the left with testimonial cards on the right",
+      icon: "PanelLeft"
     }
   },
   // Fields (variant field is auto-generated by augmentManifest)
@@ -28283,6 +28932,15 @@ init_ctas();
 init_builder();
 init_fragments();
 init_colorStyles();
+
+// ../blocks/src/system/blocks/feature-card-icons.ts
+var FEATURE_CARD_ICON_TREATMENTS = [
+  "plain",
+  "soft-badge",
+  "utility-badge"
+];
+
+// ../blocks/src/system/blocks/feature-cards.ts
 function grid3(props2, children) {
   return el("grid", props2 ?? void 0, children ?? void 0);
 }
@@ -28324,6 +28982,15 @@ var featureCard = styledCard(
       bind("card.media")
     ),
     stack({ gap: "sm", className: "rb-feature-card-content rb-flex-1 rb-p-6" }, [
+      el(
+        "feature-card-icon",
+        {
+          treatment: { $bind: { from: "content._iconTreatment", fallback: "soft-badge" } },
+          generatedAssets: { $bind: { from: "data.generatedIconAssets" } }
+        },
+        null,
+        bind("card.icon")
+      ),
       text(
         {
           as: "h3",
@@ -28445,6 +29112,16 @@ var featureCardsConfig = {
             defaultValue: "4/3",
             visibleWhen: { field: "media", notEquals: null }
           }),
+          {
+            id: "icon",
+            type: "text",
+            label: "Icon",
+            required: false,
+            ui: {
+              widget: "iconPicker",
+              iconPickerPreset: "feature"
+            }
+          },
           {
             id: "title",
             type: "text",
@@ -28480,6 +29157,19 @@ var featureCardsConfig = {
         ]
       }
     },
+    {
+      id: "_iconTreatment",
+      type: "select",
+      label: "Icon style",
+      required: false,
+      defaultValue: "soft-badge",
+      multiple: false,
+      options: FEATURE_CARD_ICON_TREATMENTS.map((value) => ({
+        value,
+        label: value === "plain" ? "Plain" : value === "soft-badge" ? "Soft badge" : "Utility badge"
+      })),
+      ui: { intent: "display" }
+    },
     cardStylesField({
       id: "_cardStyles",
       label: "Card styles"
@@ -33818,7 +34508,8 @@ var systemBlockDefinitionsRaw = [
     layoutProfiles: [
       layoutProfile({ variantKey: "default", family: "stack", weight: "standard" }),
       layoutProfile({ variantKey: "two-column", family: "split", weight: "standard" }),
-      layoutProfile({ variantKey: "question-columns", family: "grid", weight: "standard" })
+      layoutProfile({ variantKey: "question-columns", family: "grid", weight: "standard" }),
+      layoutProfile({ variantKey: "split-heading-columns", family: "split", weight: "standard" })
     ]
   })),
   withDesignCapability("block.site-header", siteHeaderBlockDefinition, declareNoBlockDesignCapability("site-chrome"), defineBlockDesignMetadata({
@@ -33849,6 +34540,12 @@ var systemBlockDefinitionsRaw = [
         family: "grid",
         weight: "standard",
         bias: "soft"
+      }),
+      layoutProfile({
+        variantKey: "split-grid",
+        family: "split",
+        weight: "featured",
+        bias: "soft"
       })
     ]
   })),
@@ -37392,7 +38089,7 @@ function preset(id, verticalId, canonicalBehaviour, label, pluralLabel, descript
 }
 
 // ../api/src/utils/isRecord.ts
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var APPOINTMENT_SETUP_MAX_MINUTES = 1440;
@@ -37665,7 +38362,7 @@ function sanitizeMarks(marks) {
     if (mark.type === "bold" || mark.type === "strong" || mark.type === "italic" || mark.type === "em") {
       return [{ type: mark.type }];
     }
-    if (mark.type === "link" && isRecord3(mark.attrs) && typeof mark.attrs.href === "string") {
+    if (mark.type === "link" && isRecord4(mark.attrs) && typeof mark.attrs.href === "string") {
       const attrs = { href: mark.attrs.href };
       if (typeof mark.attrs.target === "string" && mark.attrs.target.trim().length > 0) {
         attrs.target = mark.attrs.target;
@@ -37680,10 +38377,10 @@ function sanitizeMarks(marks) {
   return sanitized.length > 0 ? sanitized : void 0;
 }
 function unwrapRichTextValue(value) {
-  if (isRecord3(value) && isRecord3(value.doc)) {
+  if (isRecord4(value) && isRecord4(value.doc)) {
     return unwrapRichTextValue(value.doc);
   }
-  if (isRecord3(value) && value.type === "doc") {
+  if (isRecord4(value) && value.type === "doc") {
     return {
       type: "doc",
       content: Array.isArray(value.content) ? value.content.filter(isTipTapNodeLike).map(coerceTipTapNode) : []
@@ -37692,7 +38389,7 @@ function unwrapRichTextValue(value) {
   return EMPTY_SITE_BANNER_BODY;
 }
 function isTipTapNodeLike(value) {
-  return isRecord3(value) && typeof value.type === "string";
+  return isRecord4(value) && typeof value.type === "string";
 }
 function coerceTipTapNode(value) {
   return {
@@ -37700,9 +38397,9 @@ function coerceTipTapNode(value) {
     ...Array.isArray(value.content) ? { content: value.content.filter(isTipTapNodeLike).map(coerceTipTapNode) } : {},
     ...typeof value.text === "string" ? { text: value.text } : {},
     ...Array.isArray(value.marks) ? {
-      marks: value.marks.filter((mark) => isRecord3(mark) && typeof mark.type === "string").map((mark) => ({
+      marks: value.marks.filter((mark) => isRecord4(mark) && typeof mark.type === "string").map((mark) => ({
         type: mark.type,
-        ...isRecord3(mark.attrs) ? { attrs: mark.attrs } : {}
+        ...isRecord4(mark.attrs) ? { attrs: mark.attrs } : {}
       }))
     } : {}
   };
@@ -37818,7 +38515,7 @@ function collectCartLinkStats(items, depth = 0) {
   return result;
 }
 function isNavigationMenuValidationItem(value) {
-  if (!isRecord3(value)) return false;
+  if (!isRecord4(value)) return false;
   return typeof value.label === "string";
 }
 
@@ -37834,7 +38531,6 @@ var websiteSurfaceIds = [
   "site.footerBlocks",
   "site.navigation",
   "site.media",
-  "site.style",
   "site.performance"
 ];
 new Set(
@@ -37854,6 +38550,104 @@ var hiddenDemoSettingsNavSurfaceIds = [
   "settings.backup"
 ];
 new Set(hiddenDemoSettingsNavSurfaceIds);
+
+// ../api/src/navigation/identity.ts
+init_src();
+function unsafeAsNavigationMenuIdentifier(identifier) {
+  return identifier;
+}
+function unsafeAsNavigationMenuIdentity(identity) {
+  return identity;
+}
+var MAIN_NAVIGATION_MENU_IDENTIFIER = unsafeAsNavigationMenuIdentifier("main");
+function parseNavigationMenuIdentifier(value) {
+  if (typeof value !== "string") {
+    return err({ kind: "not_string" });
+  }
+  const trimmed = value.trim();
+  if (trimmed.length === 0) {
+    return err({ kind: "empty_string" });
+  }
+  return ok(unsafeAsNavigationMenuIdentifier(trimmed));
+}
+function normalizeNavigationMenuIdentifier(identifier) {
+  const parsed = parseNavigationMenuIdentifier(identifier);
+  return parsed.ok ? parsed.value : null;
+}
+function navigationMenuIdentity(input) {
+  return unsafeAsNavigationMenuIdentity(
+    normalizeNavigationMenuIdentifier(input.identifier) ?? input.name
+  );
+}
+function planNavigationMenuMatch(input, menus) {
+  const identifier = normalizeNavigationMenuIdentifier(input.identifier);
+  if (identifier) {
+    const identifierMatches = menus.filter(
+      (menu) => normalizeNavigationMenuIdentifier(menu.identifier) === identifier
+    );
+    const identifierMatch = identifierMatches[0];
+    if (identifierMatches.length === 1 && identifierMatch) {
+      return {
+        type: "update",
+        menuId: identifierMatch.id,
+        identifier
+      };
+    }
+    if (identifierMatches.length > 1) {
+      return {
+        type: "identifier_conflict",
+        identifier,
+        menuIds: identifierMatches.map((menu) => menu.id)
+      };
+    }
+    if (identifier === MAIN_NAVIGATION_MENU_IDENTIFIER) {
+      const legacyPrimaryMatches = menus.filter(
+        (menu) => menu.isPrimary && normalizeNavigationMenuIdentifier(menu.identifier) === null
+      );
+      const legacyPrimaryMatch = legacyPrimaryMatches[0];
+      if (legacyPrimaryMatches.length === 1 && legacyPrimaryMatch) {
+        return {
+          type: "adopt_legacy_primary",
+          menuId: legacyPrimaryMatch.id,
+          identifier
+        };
+      }
+      if (legacyPrimaryMatches.length > 1) {
+        return {
+          type: "ambiguous_legacy_primary",
+          identifier,
+          menuIds: legacyPrimaryMatches.map((menu) => menu.id)
+        };
+      }
+    }
+    return { type: "create", identifier };
+  }
+  const nameMatches = menus.filter((menu) => menu.name === input.name);
+  const nameMatch = nameMatches[0];
+  if (nameMatches.length === 1 && nameMatch) {
+    return { type: "update", menuId: nameMatch.id, identifier: null };
+  }
+  if (nameMatches.length > 1) {
+    return {
+      type: "ambiguous_name",
+      name: input.name,
+      menuIds: nameMatches.map((menu) => menu.id)
+    };
+  }
+  return { type: "create", identifier: null };
+}
+function actionableNavigationMenuMatchPlan(plan) {
+  switch (plan.type) {
+    case "create":
+    case "update":
+    case "adopt_legacy_primary":
+      return ok(plan);
+    case "identifier_conflict":
+    case "ambiguous_legacy_primary":
+    case "ambiguous_name":
+      return err(plan);
+  }
+}
 var Rfc6902PatchOp = z.discriminatedUnion("op", [
   // Standard RFC-6902 operations
   z.object({
@@ -38967,20 +39761,20 @@ var ManagementApiError = class extends Error {
 function is404Error(error) {
   return error instanceof ManagementApiError && error.statusCode === 404;
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function isFieldError(value) {
-  return isRecord4(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
+  return isRecord5(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
 }
 function parseApiResponse(value) {
-  if (!isRecord4(value)) return null;
+  if (!isRecord5(value)) return null;
   if (value.success === true) {
     return { success: true, data: value.data };
   }
   if (value.success === false) {
     const error = value.error;
-    if (!isRecord4(error) || typeof error.code !== "string" || typeof error.message !== "string") {
+    if (!isRecord5(error) || typeof error.code !== "string" || typeof error.message !== "string") {
       return { success: false, error: { code: "sdk:http-error", message: "Request failed", details: error } };
     }
     const fieldErrorsRaw = error.fieldErrors;
@@ -39324,9 +40118,10 @@ function createNavigationOperations(http) {
     async upsert(input) {
       const result = await http.post("/navigation", input);
       return mapPulledNavigationMenu({
-        ...result.menu,
-        identifier: null
-      });
+        ...result.menu});
+    },
+    async delete(menuId) {
+      await http.delete(`/navigation/${encodeURIComponent(menuId)}`);
     }
   };
 }
@@ -40496,7 +41291,7 @@ function createListCommand(config2) {
 
 // src/cli/push-config.ts
 var DEFAULT_CONFIG_PATH = "./riverbank.config.ts";
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null;
 }
 function parseErrorDetails(value) {
@@ -40504,10 +41299,10 @@ function parseErrorDetails(value) {
   if (typeof value === "string") {
     return { message: value };
   }
-  if (!isRecord5(value)) return {};
+  if (!isRecord6(value)) return {};
   const message = typeof value.message === "string" ? value.message : void 0;
   const fieldErrorsRaw = value.fieldErrors;
-  const fieldErrors = Array.isArray(fieldErrorsRaw) ? fieldErrorsRaw.filter(isRecord5).map((d) => ({
+  const fieldErrors = Array.isArray(fieldErrorsRaw) ? fieldErrorsRaw.filter(isRecord6).map((d) => ({
     field: typeof d.field === "string" ? d.field : "",
     message: typeof d.message === "string" ? d.message : ""
   })).filter((d) => d.field.length > 0 && d.message.length > 0) : void 0;
@@ -40519,12 +41314,12 @@ function formatFieldErrors(fieldErrors) {
 }
 function getDashboardErrorMessage(responseJson, fallback) {
   if (!responseJson) return fallback;
-  if (isRecord5(responseJson) && responseJson.success === false && "error" in responseJson) {
+  if (isRecord6(responseJson) && responseJson.success === false && "error" in responseJson) {
     const parsed = parseErrorDetails(responseJson.error);
     const msg = parsed.message ?? fallback;
     return msg + formatFieldErrors(parsed.fieldErrors);
   }
-  if (isRecord5(responseJson) && "error" in responseJson) {
+  if (isRecord6(responseJson) && "error" in responseJson) {
     const parsed = parseErrorDetails(responseJson.error);
     const msg = parsed.message ?? fallback;
     return msg + formatFieldErrors(parsed.fieldErrors);
@@ -40882,9 +41677,34 @@ function convertPulledFooterToLocal(remoteFooter) {
   return { bottomText: remoteFooter.bottomText };
 }
 
+// src/cli/navigationIdentity.ts
+init_src();
+var navigationIdentity = navigationMenuIdentity;
+function navigationIdentityMap(menus) {
+  const byIdentity = /* @__PURE__ */ new Map();
+  const menuNamesByIdentity = /* @__PURE__ */ new Map();
+  for (const menu of menus) {
+    const identity = navigationIdentity(menu);
+    const existingNames = menuNamesByIdentity.get(identity);
+    if (existingNames) {
+      return err({
+        code: "duplicate_navigation_identity",
+        identity,
+        menuNames: [...existingNames, menu.name]
+      });
+    }
+    byIdentity.set(identity, menu);
+    menuNamesByIdentity.set(identity, [menu.name]);
+  }
+  return ok(byIdentity);
+}
+function duplicateNavigationIdentityMessage(error) {
+  return `Duplicate navigation menu identity '${error.identity}' for menus: ${error.menuNames.join(", ")}. Use unique navigation identifiers or names before syncing.`;
+}
+
 // src/cli/media/portable.ts
 var ENV_SPECIFIC_MEDIA_KEYS = ["assetId", "storagePath", "storageBucket"];
-var isRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isMediaObject = (value) => value.type === "image" || value.type === "video";
 function stripEnvSpecificMediaFieldsInPlace(value) {
   if (value === null || value === void 0) return;
@@ -40894,7 +41714,7 @@ function stripEnvSpecificMediaFieldsInPlace(value) {
     }
     return;
   }
-  if (!isRecord6(value)) return;
+  if (!isRecord7(value)) return;
   if (isMediaObject(value)) {
     const hasCmsRef = typeof value.identifier === "string" || typeof value.assetId === "string" || typeof value.storagePath === "string" || typeof value.storageBucket === "string";
     for (const key of ENV_SPECIFIC_MEDIA_KEYS) {
@@ -40905,7 +41725,7 @@ function stripEnvSpecificMediaFieldsInPlace(value) {
     }
     delete value.mimeType;
   }
-  if (value.type === "image" && isRecord6(value.attrs)) {
+  if (value.type === "image" && isRecord7(value.attrs)) {
     const attrs = value.attrs;
     const hasIdentifier = typeof attrs.identifier === "string" && attrs.identifier.trim().length > 0;
     if (hasIdentifier) {
@@ -41076,11 +41896,11 @@ function entryFilePath(input) {
 }
 
 // src/cli/content/writer.ts
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseThemeMeta(value) {
-  if (!isRecord7(value) || typeof value.pulledAt !== "string" || !isRecord7(value.themes)) {
+  if (!isRecord8(value) || typeof value.pulledAt !== "string" || !isRecord8(value.themes)) {
     return null;
   }
   return { pulledAt: value.pulledAt, themes: value.themes };
@@ -41210,7 +42030,7 @@ async function writeNavigation(contentDir, pulledNavigation, options) {
   await writeJsonFile(filePath, localNavigation);
   const menusMeta = {};
   for (const menu of pulledNavigation.menus) {
-    menusMeta[menu.name] = {
+    menusMeta[navigationIdentity(menu)] = {
       createdAt: menu.createdAt,
       updatedAt: menu.updatedAt
     };
@@ -41519,7 +42339,7 @@ async function updateMetadataAfterPush(contentDir, remoteContent) {
     const metaPath = path5.join(metaDir, "navigation.json");
     const menusMeta = {};
     for (const menu of remoteContent.navigation) {
-      menusMeta[menu.name] = {
+      menusMeta[navigationIdentity(menu)] = {
         createdAt: menu.createdAt,
         updatedAt: menu.updatedAt
       };
@@ -42466,9 +43286,9 @@ async function localMediaFileExists(filePath) {
 }
 
 // src/cli/media/identifiers.ts
-var isRecord8 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord9 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isMediaValue = (value) => {
-  if (!isRecord8(value)) return false;
+  if (!isRecord9(value)) return false;
   const type = value.type;
   if (type !== "image" && type !== "video" && type !== "audio" && type !== "document" && type !== "spreadsheet" && type !== "archive") return false;
   return typeof value.identifier === "string" || typeof value.assetId === "string" || typeof value.storagePath === "string" || typeof value.src === "string";
@@ -42483,7 +43303,7 @@ var walkMediaValues = (value, location2, handler) => {
     });
     return;
   }
-  if (isRecord8(value)) {
+  if (isRecord9(value)) {
     Object.entries(value).forEach(([key, entry]) => {
       walkMediaValues(entry, location2 ? `${location2}.${key}` : key, handler);
     });
@@ -42591,7 +43411,7 @@ var normalizeMediaValueToIdentifierOnly = (value, identifier, asset) => {
 };
 
 // src/cli/media/rich-text.ts
-var isRecord9 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord10 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function collectRichTextImageAttrs(value, out = [], location2 = "") {
   if (Array.isArray(value)) {
     value.forEach(
@@ -42599,8 +43419,8 @@ function collectRichTextImageAttrs(value, out = [], location2 = "") {
     );
     return out;
   }
-  if (!isRecord9(value)) return out;
-  if (value.type === "image" && isRecord9(value.attrs)) {
+  if (!isRecord10(value)) return out;
+  if (value.type === "image" && isRecord10(value.attrs)) {
     out.push({ attrs: value.attrs, location: location2 ? `${location2}.attrs` : "attrs" });
   }
   for (const [key, child] of Object.entries(value)) {
@@ -43453,15 +44273,78 @@ function determineStatusChange(localStatus, remoteStatus) {
   }
   return void 0;
 }
+function findRemoteNavigationMenuForLocal(localMenu, remoteNavigation) {
+  const plan = actionableNavigationMenuMatchPlan(
+    planNavigationMenuMatch(localMenu, remoteNavigationMatchCandidates(remoteNavigation))
+  );
+  const menuId = plan.ok ? matchedNavigationMenuId(plan.value) : void 0;
+  if (!menuId) return void 0;
+  return remoteNavigation.find((menu) => remoteNavigationCandidateId(menu) === menuId);
+}
+function findLocalNavigationMenuForRemote(remoteMenu, localNavigation) {
+  const localMenus = localNavigation?.menus ?? [];
+  const directPlan = actionableNavigationMenuMatchPlan(
+    planNavigationMenuMatch(remoteMenu, localNavigationMatchCandidates(localMenus))
+  );
+  const directMenuId = directPlan.ok ? matchedNavigationMenuId(directPlan.value) : void 0;
+  if (directMenuId) {
+    return localMenus.find((menu) => navigationIdentity(menu) === directMenuId);
+  }
+  if (!remoteMenu.isPrimary || remoteMenu.identifier !== null) return void 0;
+  const legacyMainPlan = actionableNavigationMenuMatchPlan(
+    planNavigationMenuMatch(
+      { identifier: "main", name: remoteMenu.name },
+      localNavigationMatchCandidates(localMenus)
+    )
+  );
+  const legacyMainMenuId = legacyMainPlan.ok ? matchedNavigationMenuId(legacyMainPlan.value) : void 0;
+  if (!legacyMainMenuId) return void 0;
+  return localMenus.find((menu) => navigationIdentity(menu) === legacyMainMenuId);
+}
+function matchedNavigationMenuId(plan) {
+  switch (plan.type) {
+    case "create":
+      return void 0;
+    case "update":
+    case "adopt_legacy_primary":
+      return plan.menuId;
+  }
+}
+function localNavigationMatchCandidates(menus) {
+  return menus.map((menu) => ({
+    id: navigationIdentity(menu),
+    identifier: menu.identifier,
+    name: menu.name,
+    isPrimary: menu.isPrimary ?? false
+  }));
+}
+function remoteNavigationMatchCandidates(menus) {
+  return menus.map((menu) => ({
+    id: remoteNavigationCandidateId(menu),
+    identifier: menu.identifier,
+    name: menu.name,
+    isPrimary: menu.isPrimary
+  }));
+}
+function remoteNavigationCandidateId(menu) {
+  return menu.id ?? navigationIdentity(menu);
+}
 function buildJsonDiff(diff, local, remote, mode) {
   const summary = { creates: 0, updates: 0, deletes: 0, publishes: 0, unpublishes: 0 };
   const changes = [];
+  const warnings = [];
   const localPages = new Map(local.pages.map((page) => [page.identifier, page]));
   const remotePages = new Map(remote.pages.map((page) => [page.identifier, page]));
   const localEntries = local.entries;
   const remoteEntries = remote.entries;
-  const localMenus = new Map((local.navigation?.menus ?? []).map((menu) => [menu.name, menu]));
-  const remoteMenus = new Map(remote.navigation.map((menu) => [menu.name, menu]));
+  const localMenus = navigationIdentityMap(local.navigation?.menus ?? []);
+  const remoteMenus = navigationIdentityMap(remote.navigation);
+  if (!localMenus.ok) {
+    warnings.push(jsonDiffDuplicateNavigationIdentityWarning("local", localMenus.error));
+  }
+  if (!remoteMenus.ok) {
+    warnings.push(jsonDiffDuplicateNavigationIdentityWarning("remote", remoteMenus.error));
+  }
   const localForms = new Map(local.forms.map((form2) => [form2.slug, form2]));
   const remoteForms = new Map(remote.forms.map((form2) => [form2.slug, form2]));
   const addChange = (change) => {
@@ -43546,9 +44429,9 @@ function buildJsonDiff(diff, local, remote, mode) {
   for (const navDiff of diff.navigation) {
     if (navDiff.type === "unchanged") continue;
     if (navDiff.type !== "create" && navDiff.type !== "update") continue;
-    const identifier = navDiff.name;
-    const localMenu = localMenus.get(navDiff.name);
-    const remoteMenu = remoteMenus.get(navDiff.name);
+    const identifier = navigationIdentity(navDiff);
+    const localMenu = localMenus.ok ? localMenus.value.get(identifier) : void 0;
+    const remoteMenu = localMenu ? findRemoteNavigationMenuForLocal(localMenu, remote.navigation) : remoteMenus.ok ? remoteMenus.value.get(identifier) : void 0;
     const change = {
       type: "navigation",
       identifier,
@@ -43592,7 +44475,20 @@ function buildJsonDiff(diff, local, remote, mode) {
     }
     addChange(change);
   }
-  return { summary, changes };
+  return {
+    summary,
+    changes,
+    ...warnings.length > 0 ? { warnings } : {}
+  };
+}
+function jsonDiffDuplicateNavigationIdentityWarning(source, error) {
+  return {
+    type: "duplicate_navigation_identity",
+    source,
+    identity: error.identity,
+    menuNames: error.menuNames,
+    message: duplicateNavigationIdentityMessage(error)
+  };
 }
 function calculateEntryDiffs(localEntries, remoteEntries, options) {
   const diffs = /* @__PURE__ */ new Map();
@@ -43853,20 +44749,23 @@ function calculateNavigationDiffs(localNavigation, remoteNavigation) {
   if (!localNavigation || !localNavigation.menus) {
     return { diffs, summary };
   }
-  const remoteLookup = /* @__PURE__ */ new Map();
-  for (const menu of remoteNavigation) {
-    remoteLookup.set(menu.name, menu);
-  }
   for (const localMenu of localNavigation.menus) {
-    const remoteMenu = remoteLookup.get(localMenu.name);
+    const remoteMenu = findRemoteNavigationMenuForLocal(
+      localMenu,
+      remoteNavigation
+    );
     if (!remoteMenu) {
       diffs.push({
         type: "create",
+        identifier: localMenu.identifier,
         name: localMenu.name
       });
       summary.create++;
     } else {
       const changes = [];
+      if (localMenu.name !== remoteMenu.name) {
+        changes.push("name");
+      }
       if (!equal(localMenu.items, stripNavigationItemIds(remoteMenu.items))) {
         changes.push("items");
       }
@@ -43879,6 +44778,7 @@ function calculateNavigationDiffs(localNavigation, remoteNavigation) {
       if (changes.length > 0) {
         diffs.push({
           type: "update",
+          identifier: localMenu.identifier,
           name: localMenu.name,
           changes
         });
@@ -43886,6 +44786,7 @@ function calculateNavigationDiffs(localNavigation, remoteNavigation) {
       } else {
         diffs.push({
           type: "unchanged",
+          identifier: localMenu.identifier,
           name: localMenu.name
         });
         summary.unchanged++;
@@ -44270,19 +45171,23 @@ function calculatePullDiff(remote, local) {
   }
   const navDiffs = [];
   const navSummary = { create: 0, update: 0, unchanged: 0 };
-  const localNavLookup = /* @__PURE__ */ new Map();
-  if (local?.navigation?.menus) {
-    for (const menu of local.navigation.menus) {
-      localNavLookup.set(menu.name, menu);
-    }
-  }
   for (const remoteMenu of remote.navigation) {
-    const localMenu = localNavLookup.get(remoteMenu.name);
+    const localMenu = findLocalNavigationMenuForRemote(
+      remoteMenu,
+      local?.navigation ?? null
+    );
     if (!localMenu) {
-      navDiffs.push({ type: "create", name: remoteMenu.name });
+      navDiffs.push({
+        type: "create",
+        identifier: remoteMenu.identifier,
+        name: remoteMenu.name
+      });
       navSummary.create++;
     } else {
       const changes = [];
+      if (localMenu.name !== remoteMenu.name) {
+        changes.push("name");
+      }
       if (!equal(stripNavigationItemIds(remoteMenu.items), localMenu.items)) {
         changes.push("items");
       }
@@ -44293,10 +45198,19 @@ function calculatePullDiff(remote, local) {
         changes.push("isFooter");
       }
       if (changes.length > 0) {
-        navDiffs.push({ type: "update", name: remoteMenu.name, changes });
+        navDiffs.push({
+          type: "update",
+          identifier: remoteMenu.identifier,
+          name: remoteMenu.name,
+          changes
+        });
         navSummary.update++;
       } else {
-        navDiffs.push({ type: "unchanged", name: remoteMenu.name });
+        navDiffs.push({
+          type: "unchanged",
+          identifier: remoteMenu.identifier,
+          name: remoteMenu.name
+        });
         navSummary.unchanged++;
       }
     }
@@ -45234,12 +46148,17 @@ function buildPullJsonDiff(diff, remoteContent, localContent, mode) {
     }
     for (const navDiff of diff.navigation) {
       if (navDiff.type === "unchanged") continue;
-      const remoteMenu = remoteContent.navigation.find((m) => m.name === navDiff.name);
-      const localMenu = localContent?.navigation?.menus.find((m) => m.name === navDiff.name);
+      const navIdentifier = navigationIdentity(navDiff);
+      const remoteMenu = remoteContent.navigation.find(
+        (m) => navigationIdentity(m) === navIdentifier
+      );
+      const localMenu = localContent?.navigation?.menus.find(
+        (m) => navigationIdentity(m) === navIdentifier
+      );
       changes.push({
         type: "navigation",
         operation: navDiff.type,
-        identifier: navDiff.name,
+        identifier: navIdentifier,
         before: localMenu ?? null,
         after: remoteMenu ?? null
       });
@@ -46413,11 +47332,11 @@ function normalizeLocalContentShape(content) {
 function nullishToNull(value) {
   return value == null ? null : value;
 }
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function normalizeVenueAddress(value) {
-  const obj = isRecord10(value) ? value : {};
+  const obj = isRecord11(value) ? value : {};
   return {
     line1: nullishToNull(typeof obj.line1 === "string" ? obj.line1 : void 0),
     line2: nullishToNull(typeof obj.line2 === "string" ? obj.line2 : void 0),
@@ -46434,7 +47353,7 @@ function normalizeVenueAddress(value) {
   };
 }
 function normalizeVenueLocation(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const obj = value;
   const lat = typeof obj.lat === "number" ? obj.lat : null;
   const lng = typeof obj.lng === "number" ? obj.lng : null;
@@ -46442,7 +47361,7 @@ function normalizeVenueLocation(value) {
   return { lat, lng };
 }
 function normalizeVenueForCompare(venue) {
-  const obj = isRecord10(venue) ? venue : {};
+  const obj = isRecord11(venue) ? venue : {};
   return {
     slug: String(obj.slug),
     title: String(obj.title),
@@ -46455,7 +47374,7 @@ function normalizeVenueForCompare(venue) {
   };
 }
 function normalizeEventCategoryForCompare(category) {
-  const obj = isRecord10(category) ? category : {};
+  const obj = isRecord11(category) ? category : {};
   return {
     identifier: String(obj.identifier),
     name: String(obj.name),
@@ -46465,9 +47384,9 @@ function normalizeEventCategoryForCompare(category) {
   };
 }
 function normalizeRemoteEventForCompare(event) {
-  const obj = isRecord10(event) ? event : {};
-  const schedule = isRecord10(obj.schedule) ? obj.schedule : {};
-  const pricing = isRecord10(obj.pricing) ? obj.pricing : {};
+  const obj = isRecord11(event) ? event : {};
+  const schedule = isRecord11(obj.schedule) ? obj.schedule : {};
+  const pricing = isRecord11(obj.pricing) ? obj.pricing : {};
   return {
     identifier: String(obj.identifier),
     title: String(obj.title),
@@ -46500,14 +47419,14 @@ function normalizeRemoteEventForCompare(event) {
     venueRef: nullishToNull(typeof obj.venueRef === "string" ? obj.venueRef : void 0),
     categoryRef: nullishToNull(typeof obj.categoryRef === "string" ? obj.categoryRef : void 0),
     formRef: nullishToNull(typeof obj.formRef === "string" ? obj.formRef : void 0),
-    content: isRecord10(obj.content) ? obj.content : {},
-    settings: isRecord10(obj.settings) ? obj.settings : {},
-    presentation: isRecord10(obj.presentation) ? obj.presentation : null,
+    content: isRecord11(obj.content) ? obj.content : {},
+    settings: isRecord11(obj.settings) ? obj.settings : {},
+    presentation: isRecord11(obj.presentation) ? obj.presentation : null,
     tags: Array.isArray(obj.tags) ? obj.tags : []
   };
 }
 function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
-  const local = isRecord10(localEvent) ? localEvent : {};
+  const local = isRecord11(localEvent) ? localEvent : {};
   const base = remoteEvent ? normalizeRemoteEventForCompare(remoteEvent) : normalizeRemoteEventForCompare({
     identifier: local.identifier,
     title: local.title,
@@ -46525,8 +47444,8 @@ function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
     presentation: local.presentation ?? null,
     tags: local.tags ?? []
   });
-  const schedule = isRecord10(local.schedule) ? local.schedule : {};
-  const pricing = isRecord10(local.pricing) ? local.pricing : {};
+  const schedule = isRecord11(local.schedule) ? local.schedule : {};
+  const pricing = isRecord11(local.pricing) ? local.pricing : {};
   return {
     ...base,
     identifier: String(local.identifier ?? base.identifier),
@@ -46552,9 +47471,9 @@ function normalizeLocalEventAgainstRemoteForCompare(localEvent, remoteEvent) {
     venueRef: local.venueRef === void 0 ? base.venueRef : nullishToNull(typeof local.venueRef === "string" ? local.venueRef : void 0),
     categoryRef: local.categoryRef === void 0 ? base.categoryRef : nullishToNull(typeof local.categoryRef === "string" ? local.categoryRef : void 0),
     formRef: local.formRef === void 0 ? base.formRef : nullishToNull(typeof local.formRef === "string" ? local.formRef : void 0),
-    content: local.content === void 0 ? base.content : isRecord10(local.content) ? local.content : {},
-    settings: local.settings === void 0 ? base.settings : isRecord10(local.settings) ? local.settings : {},
-    presentation: local.presentation === void 0 ? base.presentation : isRecord10(local.presentation) ? local.presentation : null,
+    content: local.content === void 0 ? base.content : isRecord11(local.content) ? local.content : {},
+    settings: local.settings === void 0 ? base.settings : isRecord11(local.settings) ? local.settings : {},
+    presentation: local.presentation === void 0 ? base.presentation : isRecord11(local.presentation) ? local.presentation : null,
     tags: local.tags === void 0 ? base.tags : Array.isArray(local.tags) ? local.tags : []
   };
 }
@@ -46566,7 +47485,7 @@ function toIsoStringOrOriginal(value) {
 function normalizeCourseSessions(value) {
   if (!Array.isArray(value)) return [];
   return value.map((session) => {
-    const obj = isRecord10(session) ? session : {};
+    const obj = isRecord11(session) ? session : {};
     return {
       startsAt: toIsoStringOrOriginal(obj.startsAt),
       endsAt: toIsoStringOrOriginal(obj.endsAt)
@@ -46578,18 +47497,18 @@ function normalizeCourseSessions(value) {
 }
 function normalizeCourseProgram(value) {
   if (value == null) return null;
-  if (!isRecord10(value)) {
+  if (!isRecord11(value)) {
     return { identifier: null, data: {} };
   }
   return {
     identifier: nullishToNull(
       typeof value.identifier === "string" ? value.identifier : void 0
     ),
-    data: isRecord10(value.data) ? value.data : {}
+    data: isRecord11(value.data) ? value.data : {}
   };
 }
 function normalizeRemoteCourseForCompare(course) {
-  const obj = isRecord10(course) ? course : {};
+  const obj = isRecord11(course) ? course : {};
   return {
     identifier: String(obj.identifier),
     title: String(obj.title),
@@ -46612,7 +47531,7 @@ function normalizeRemoteCourseForCompare(course) {
   };
 }
 function normalizeLocalCourseAgainstRemoteForCompare(localCourse, remoteCourse) {
-  const local = isRecord10(localCourse) ? localCourse : {};
+  const local = isRecord11(localCourse) ? localCourse : {};
   const base = remoteCourse ? normalizeRemoteCourseForCompare(remoteCourse) : normalizeRemoteCourseForCompare({
     identifier: local.identifier,
     title: local.title,
@@ -46633,11 +47552,11 @@ function normalizeLocalCourseAgainstRemoteForCompare(localCourse, remoteCourse)
   });
   const status = local.status === void 0 ? base.status : local.status === "active" || local.status === "cancelled" || local.status === "completed" ? local.status : "draft";
   const visibility = local.visibility === void 0 ? base.visibility : local.visibility === "public" || local.visibility === "private" || local.visibility === "unlisted" ? local.visibility : "public";
-  const program2 = local.program === void 0 ? base.program : local.program === null ? null : isRecord10(local.program) ? {
+  const program2 = local.program === void 0 ? base.program : local.program === null ? null : isRecord11(local.program) ? {
     identifier: local.program.identifier === void 0 ? base.program?.identifier ?? null : nullishToNull(
       typeof local.program.identifier === "string" ? local.program.identifier : void 0
     ),
-    data: isRecord10(local.program.data) ? local.program.data : base.program?.data ?? {}
+    data: isRecord11(local.program.data) ? local.program.data : base.program?.data ?? {}
   } : base.program;
   return {
     ...base,
@@ -47539,6 +48458,7 @@ var upsertNavigationMenuCommandSchema = z.object({
   type: z.literal("upsertNavigationMenu"),
   ref: navigationRefSchema,
   input: z.object({
+    identifier: z.string().min(1).optional(),
     name: z.string().min(1).optional(),
     location: z.enum(navigationLocations).optional(),
     role: z.enum(navigationMenuRoles).optional(),
@@ -48824,7 +49744,7 @@ function getSiteCommandLifecycleIntent(command) {
 init_src();
 
 // ../site-commands/src/guards.ts
-function isRecord11(value) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -49089,7 +50009,7 @@ function collectVenueRefsFromIntervals(intervals, path24) {
 }
 function collectNavigationRefs(items, path24) {
   return items.flatMap((item, index) => {
-    if (!isRecord11(item)) return [];
+    if (!isRecord12(item)) return [];
     const itemPath = `${path24}[${index}]`;
     const refs = [];
     if (typeof item.pageRef === "string") {
@@ -49106,7 +50026,7 @@ function collectNavigationRefs(items, path24) {
 }
 function collectBlockRefs(blocks, path24) {
   return blocks.flatMap((block, index) => {
-    if (!isRecord11(block)) return [];
+    if (!isRecord12(block)) return [];
     const blockPath = `${path24}[${index}]`;
     return [
       ...collectNestedRefs(block.props, `${blockPath}.props`),
@@ -49122,7 +50042,7 @@ function collectNestedRefs(value, path24) {
   if (Array.isArray(value)) {
     return value.flatMap((item, index) => collectNestedRefs(item, `${path24}[${index}]`));
   }
-  if (!isRecord11(value)) return [];
+  if (!isRecord12(value)) return [];
   return Object.entries(value).flatMap(([key, child]) => collectNestedRefs(child, `${path24}.${key}`));
 }
 
@@ -49378,9 +50298,9 @@ function deriveIdempotencyKey(input) {
   ].join("|"));
 }
 function findUnknownCommandTypes(input) {
-  if (!isRecord11(input) || !Array.isArray(input.commands)) return [];
+  if (!isRecord12(input) || !Array.isArray(input.commands)) return [];
   return input.commands.flatMap((command, commandIndex) => {
-    if (!isRecord11(command) || typeof command.type !== "string") return [];
+    if (!isRecord12(command) || typeof command.type !== "string") return [];
     if (commandTypeSet.has(command.type)) return [];
     return [{
       code: "unknown_command_type",
@@ -49406,9 +50326,9 @@ function commandIndexForIssuePath(path24) {
   return path24[0] === "commands" && typeof path24[1] === "number" ? path24[1] : -1;
 }
 function commandTypeForIssue(input, commandIndex) {
-  if (!isRecord11(input) || !isUnknownArray3(input.commands)) return null;
+  if (!isRecord12(input) || !isUnknownArray3(input.commands)) return null;
   const command = input.commands[commandIndex];
-  return isRecord11(command) && typeof command.type === "string" ? command.type : null;
+  return isRecord12(command) && typeof command.type === "string" ? command.type : null;
 }
 function isUnknownArray3(value) {
   return Array.isArray(value);
@@ -50430,8 +51350,8 @@ function eventContentInput(content) {
   if (!content) return void 0;
   return {
     ...content.summary ? { summary: content.summary } : {},
-    ...typeof content.body === "string" || isRecord12(content.body) ? { body: content.body } : {},
-    ...typeof content.image === "string" || isRecord12(content.image) ? { image: content.image } : {}
+    ...typeof content.body === "string" || isRecord13(content.body) ? { body: content.body } : {},
+    ...typeof content.image === "string" || isRecord13(content.image) ? { image: content.image } : {}
   };
 }
 function courseUpsertInput(command) {
@@ -50603,7 +51523,7 @@ function toUtcIso(date, time) {
   const normalizedTime = time.length === 5 ? `${time}:00` : time;
   return (/* @__PURE__ */ new Date(`${date}T${normalizedTime}Z`)).toISOString();
 }
-function isRecord12(value) {
+function isRecord13(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function unsupported(identifier, message) {
@@ -51181,14 +52101,22 @@ var navigationSiteCommandTypes = [
 ];
 function compileNavigationPushCommands(input) {
   const commandBindings = [];
-  const menusByName = new Map(
-    (input.local.navigation?.menus ?? []).map((menu) => [unsafeAsCliNavigationMenuName(menu.name), menu])
+  const menusByIdentity = navigationIdentityMap(
+    input.local.navigation?.menus ?? []
   );
+  if (!menusByIdentity.ok) {
+    return err({
+      code: menusByIdentity.error.code,
+      identity: menusByIdentity.error.identity,
+      message: duplicateNavigationIdentityMessage(menusByIdentity.error)
+    });
+  }
   for (const navigationDiff of input.diff) {
     if (navigationDiff.type === "unchanged") continue;
-    const menuName = unsafeAsCliNavigationMenuName(navigationDiff.name);
-    const menu = menusByName.get(menuName);
+    const menuIdentity = navigationIdentity(navigationDiff);
+    const menu = menusByIdentity.value.get(menuIdentity);
     if (!menu) {
+      const menuName = unsafeAsCliNavigationMenuName(navigationDiff.name);
       return err({
         code: "missing_local_navigation_menu",
         name: menuName,
@@ -51202,6 +52130,7 @@ function compileNavigationPushCommands(input) {
       type: "upsertNavigationMenu",
       ref: commandRef,
       input: {
+        ...menu.identifier ? { identifier: menu.identifier } : {},
         name: localMenuName,
         ...role ? { role } : {},
         items: menu.items.map(navigationItemForCommand)
@@ -51232,6 +52161,7 @@ async function executeNavigationCommandPlan(input) {
         case "upsertNavigationMenu": {
           const role = navigationCommandRole(command);
           await input.client.navigation.upsert({
+            ...command.input.identifier ? { identifier: command.input.identifier } : {},
             name: navigationCommandMenuName(command),
             items: command.input.items.map(navigationItemInput),
             ...role === "primary" ? { isPrimary: true } : {},
@@ -51258,10 +52188,22 @@ function executeNavigationCommandPlanAsReport(input) {
 }
 function navigationCommandCompileErrorToReport(error) {
   return commandCompileFailureToReport({
-    identifier: error.code === "missing_local_navigation_menu" ? error.name : "command-validation",
+    identifier: navigationCompileErrorIdentifier(error),
     message: error.message
   });
 }
+function navigationCompileErrorIdentifier(error) {
+  switch (error.code) {
+    case "missing_local_navigation_menu":
+      return error.name;
+    case "duplicate_navigation_identity":
+      return error.identity;
+    case "command_validation_failed":
+      return "command-validation";
+    default:
+      return assertNever(error);
+  }
+}
 function navigationCommandExecutionToReport(input) {
   return commandExecutionToReport({
     execution: input.execution,
@@ -55545,6 +56487,7 @@ async function applyOneOffPageCommandReturningBlock(command, client) {
 async function applyOneOffNavigationCommand(command, client) {
   const role = navigationCommandRole2(command);
   return client.navigation.upsert({
+    ...command.input.identifier ? { identifier: command.input.identifier } : {},
     name: navigationCommandMenuName2(command),
     items: command.input.items.map(navigationItemInput2),
     ...role === "primary" ? { isPrimary: true } : {},
@@ -55704,6 +56647,7 @@ function oneOffNavigationCommandBinding(mutation) {
     type: "upsertNavigationMenu",
     ref: createNavigationRef([name]),
     input: {
+      ...mutation.identifier ? { identifier: mutation.identifier } : {},
       name,
       items: mutation.items.map(navigationItemForCommand2)
     }
@@ -56463,7 +57407,7 @@ function countItems(items) {
   }
   return count;
 }
-var upsertCommand4 = new Command("upsert").description("Create or update a navigation menu").argument("<menu-name>", "Navigation menu name").option("--file <path>", "Path to JSON file with menu items").option("--data <json>", "Menu items as JSON string").action(
+var upsertCommand4 = new Command("upsert").description("Create or update a navigation menu").argument("<menu-name>", "Navigation menu name").option("--identifier <identifier>", "Stable SDK identifier for this menu").option("--file <path>", "Path to JSON file with menu items").option("--data <json>", "Menu items as JSON string").action(
   withCommandContext(async (ctx, menuName, options) => {
     const { output, client, siteId, targetEnv } = ctx;
     const items = await parseJsonArray(options);
@@ -56472,7 +57416,12 @@ var upsertCommand4 = new Command("upsert").description("Create or update a navig
       source: "one_off_navigation",
       siteId,
       targetEnv,
-      mutation: { kind: "upsert", menuName, items }
+      mutation: {
+        kind: "upsert",
+        ...options.identifier ? { identifier: options.identifier } : {},
+        menuName,
+        items
+      }
     });
     if (!compiled.ok) {
       return output.error(compiled.error.message);
@@ -56510,10 +57459,58 @@ var listCommand4 = createListCommand({
   tableHeaders: ["Name", "Items", "Updated"],
   formatRow: formatMenuRow
 });
+function resolveNavigationMenuForDelete(menus, selector) {
+  const idMatch = menus.find((menu) => menu.id === selector);
+  if (idMatch) return idMatch;
+  const nameMatches = menus.filter((menu) => menu.name === selector);
+  const onlyNameMatch = nameMatches[0];
+  if (nameMatches.length === 1 && onlyNameMatch) {
+    return onlyNameMatch;
+  }
+  if (nameMatches.length > 1) {
+    throw new Error(
+      `Multiple navigation menus are named "${selector}". Delete by ID instead: ${nameMatches.map((menu) => menu.id).join(", ")}`
+    );
+  }
+  throw new Error(`Navigation menu not found by ID or exact name: ${selector}`);
+}
+var deleteCommand = new Command("delete").description("Delete a navigation menu by ID or exact unique name").argument("<menu-id-or-name>", "Navigation menu ID, or exact name when unique").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
+  withCommandContext(async (ctx, selector, options) => {
+    const { client, isRemote, output, targetEnv } = ctx;
+    const menu = resolveNavigationMenuForDelete(await client.navigation.list(), selector);
+    const itemCount = countItems(menu.items);
+    const flags = [
+      menu.isPrimary ? "primary" : null,
+      menu.isFooter ? "footer" : null
+    ].filter((flag) => Boolean(flag));
+    const flagText = flags.length > 0 ? flags.join(", ") : "none";
+    const confirmed = await confirmAction(
+      `Delete navigation menu "${menu.name}" (${menu.id}) from ${targetEnv}? flags: ${flagText}; items: ${itemCount}`,
+      options,
+      isRemote
+    );
+    if (!confirmed) {
+      output.info("Operation cancelled");
+      return;
+    }
+    output.info(`Deleting navigation menu: ${menu.name}`);
+    await client.navigation.delete(menu.id);
+    output.success(`Navigation menu deleted: ${menu.name}`, {
+      id: menu.id,
+      name: menu.name,
+      identifier: menu.identifier,
+      isPrimary: menu.isPrimary,
+      isFooter: menu.isFooter,
+      itemCount,
+      environment: targetEnv
+    });
+  })
+);
 var navigationCommand = new Command("navigation").description("Manage navigation menus").addHelpText("after", `
 Examples:
   $ riverbankcms navigation upsert main --file ./main-nav.json
   $ riverbankcms navigation upsert footer --data '[{"label": "Home", "url": "/"}]'
+  $ riverbankcms navigation delete "Primary navigation" --yes
   $ riverbankcms navigation get main
   $ riverbankcms navigation list
 
@@ -56526,7 +57523,7 @@ JSON file format:
       ]}
     ]
   }
-`).addCommand(upsertCommand4).addCommand(getCommand4).addCommand(listCommand4);
+`).addCommand(upsertCommand4).addCommand(deleteCommand).addCommand(getCommand4).addCommand(listCommand4);
 var deleteEntryCommand = new Command("entry").description("Delete a content entry").argument("<type>", "Content type").argument("<identifier>", "Entry identifier").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
   withConfirmation(
     (type, identifier) => `Delete entry "${type}/${identifier}"?`,
@@ -56547,7 +57544,7 @@ var deleteBlockCommand = new Command("block").description("Delete a block from a
     }
   )
 );
-var deleteCommand = new Command("delete").description("Delete content from CMS").addHelpText("after", `
+var deleteCommand2 = new Command("delete").description("Delete content from CMS").addHelpText("after", `
 Examples:
   $ riverbankcms delete entry blog-post my-post
   $ riverbankcms delete entry blog-post my-post --yes
@@ -56577,7 +57574,7 @@ var THEME_FIELD_CATEGORY_MAP = {
 };
 
 // src/cli/init-docs/zod-to-markdown.ts
-function isRecord13(value) {
+function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isZodTypeAny(value) {
@@ -56705,7 +57702,7 @@ function extractLiteralValue(schema) {
   const typeName = getTypeName(schema);
   if (typeName !== ZodTypeName.ZodLiteral) return void 0;
   const def = schema._def;
-  if (!isRecord13(def)) return void 0;
+  if (!isRecord14(def)) return void 0;
   return String(def.value);
 }
 function extractSchemaInfo(schema, skipFields = []) {
@@ -56775,7 +57772,7 @@ function extractFieldInfo(name, schema) {
   }
   if (typeName === ZodTypeName.ZodRecord) {
     const def = inner._def;
-    const valueSchema = isRecord13(def) ? def.valueType : void 0;
+    const valueSchema = isRecord14(def) ? def.valueType : void 0;
     if (!isZodTypeAny(valueSchema)) {
       info.recordValueType = "unknown";
       return info;
@@ -56790,7 +57787,7 @@ function extractFieldInfo(name, schema) {
       }
     } else if (getTypeName(valueInner) === ZodTypeName.ZodRecord) {
       const nestedDef = valueInner._def;
-      const nestedValueSchema = isRecord13(nestedDef) ? nestedDef.valueType : void 0;
+      const nestedValueSchema = isRecord14(nestedDef) ? nestedDef.valueType : void 0;
       if (!isZodTypeAny(nestedValueSchema)) {
         info.recordValueType = "record<string, unknown>";
         return info;
@@ -56801,7 +57798,7 @@ function extractFieldInfo(name, schema) {
   }
   if (typeName === ZodTypeName.ZodUnion || typeName === ZodTypeName.ZodDiscriminatedUnion) {
     const def = inner._def;
-    const optionsValue = isRecord13(def) ? def.options : void 0;
+    const optionsValue = isRecord14(def) ? def.options : void 0;
     const options = Array.isArray(optionsValue) ? optionsValue.filter(isZodTypeAny) : [];
     const optionTypes = options.map((opt) => {
       const { inner: optInner } = unwrapSchema(opt);
@@ -57190,7 +58187,7 @@ function renderConfigGuideSection() {
     "    navigation: {",
     "      siteNav: {",
     "        // mode: 'augment' | 'restrict'",
-    "        // allowIds: ['site.style']",
+    "        // allowIds: ['site.performance']",
     "        // denyIds: ['site.performance', 'site.newsletter']",
     "        roles: {",
     "          editor: { mode: 'restrict', allowIds: ['site.overview', 'site.content', 'site.media', 'site.bookings'] },",
@@ -57211,7 +58208,7 @@ function renderConfigGuideSection() {
     "Navigation IDs:",
     "",
     "- Top nav (`dashboard.navigation.siteNav`):",
-    "  - `site.overview`, `site.content`, `site.media`, `site.bookings`, `site.newsletter`, `site.style`, `site.performance`, `site.settings`",
+    "  - `site.overview`, `site.content`, `site.media`, `site.bookings`, `site.newsletter`, `site.performance`, `site.settings`",
     "- Settings sidebar (`dashboard.navigation.settingsNav`):",
     "  - `settings.general`, `settings.domains`, `settings.fonts`, `settings.navigation`, `settings.redirects`, `settings.emails`",
     "  - `settings.ai.siteProfile`, `settings.ai.brandGuidelines`",
@@ -57636,7 +58633,8 @@ async function initDocs(options) {
     { filename: "templates.md", template: "workflow-templates" },
     { filename: "cmsify-page.md", template: "workflow-cmsify-page" },
     { filename: "editor-workflows.md", template: "workflow-editor-workflows" },
-    { filename: "preview-mode.md", template: "workflow-preview-mode" }
+    { filename: "preview-mode.md", template: "workflow-preview-mode" },
+    { filename: "isr-revalidation.md", template: "workflow-isr-revalidation" }
   ];
   await Promise.all(
     coreWorkflows.map(
@@ -57961,7 +58959,7 @@ var SimpleCache = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.78.2";
+var SDK_VERSION = "0.79.0";
 
 // src/client/error.ts
 var RiverbankApiError = class _RiverbankApiError extends Error {
@@ -64553,7 +65551,7 @@ var listCommand6 = createListCommand({
   tableHeaders: ["Identifier", "Status", "Visibility", "Updated"],
   formatRow: formatEventRow
 });
-var deleteCommand2 = new Command("delete").description("Delete an event series").argument("<identifier>", "Event identifier").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
+var deleteCommand3 = new Command("delete").description("Delete an event series").argument("<identifier>", "Event identifier").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
   withConfirmation(
     (identifier) => `Delete event "${identifier}"?`,
     async (ctx, identifier) => {
@@ -64600,7 +65598,7 @@ Examples:
   $ riverbankcms event cancel summer-fest
   $ riverbankcms event delete summer-fest --yes
 `
-).addCommand(listCommand6).addCommand(getCommand5).addCommand(upsertCommand5).addCommand(cancelCommand).addCommand(deleteCommand2);
+).addCommand(listCommand6).addCommand(getCommand5).addCommand(upsertCommand5).addCommand(cancelCommand).addCommand(deleteCommand3);
 var courseUpsertInputSchema = z.object({
   identifier: z.string().min(1).optional(),
   title: z.string().min(1, "title is required"),
@@ -64722,7 +65720,7 @@ var listCommand7 = createListCommand({
   tableHeaders: ["Identifier", "Status", "Visibility", "Updated"],
   formatRow: formatCourseRow
 });
-var deleteCommand3 = new Command("delete").description("Delete a course run").argument("<identifier>", "Course identifier").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
+var deleteCommand4 = new Command("delete").description("Delete a course run").argument("<identifier>", "Course identifier").option("--yes", "Skip confirmation prompt (required for --env=remote)").action(
   withConfirmation(
     (identifier) => `Delete course "${identifier}"?`,
     async (ctx, identifier) => {
@@ -64773,7 +65771,7 @@ Examples:
   $ riverbankcms course cancel beginner-yoga
   $ riverbankcms course delete beginner-yoga --yes
 `
-).addCommand(listCommand7).addCommand(getCommand6).addCommand(upsertCommand6).addCommand(cancelCommand2).addCommand(deleteCommand3);
+).addCommand(listCommand7).addCommand(getCommand6).addCommand(upsertCommand6).addCommand(cancelCommand2).addCommand(deleteCommand4);
 function isPlainObject3(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -65170,7 +66168,7 @@ program.addCommand(entryCommand);
 program.addCommand(pageCommand);
 program.addCommand(blockCommand);
 program.addCommand(navigationCommand);
-program.addCommand(deleteCommand);
+program.addCommand(deleteCommand2);
 program.addCommand(initDocsCommand);
 program.addCommand(identifiersCommand);
 program.addCommand(deployCommand);