@riverbankcms/sdk 0.78.0 → 0.79.0

package/dist/{PreviewEditorSidebar-RIKFQ72L.mjs → PreviewEditorSidebar-56NMJMIK.mjs}

@@ -1,9 +1,9 @@
 "use client";
-import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, canInspectSiteStyle, usePreviewDesignCoordinator, resolveStyleConfiguratorInitialSnapshot, createStyleConfiguratorState, createOptimisticActionRunner, syncStyleConfiguratorState, isPreviewingChange, planSiteStylePreviewChange, openRow, previewSiteStyle, applyResolvedSelections, previewButtonPersonality, previewHeaderLayout, previewHeaderStyle, planSiteChromeLookSelection, previewFooterLook, previewPaletteVariant, previewTypographyPreset, setTypographyBodyFontOverride, setTypographyHeadingFontOverride, clearTypographyFontOverrides, setPaletteOverrides, toggleRow, cancelPreview, dismissWarnings, dismissNotices, markApplyFailed, markApplySaved, markApplySaving, canApplySiteStyle, buildSiteChromeLookModels, cycleSiteChromeLookId, cycleableSiteChromeOptions } from './chunk-NIDXI46P.mjs';
-import { KeyboardCode, getBlockDefinition, CSS, useSdkConfig, listBlockDescriptors, useSensor, PointerSensor, useSensors, deleteBlock, createEditorRemoveBlockCommand, asEditorBlockId, DndContext, closestCenter, Button, Plus, useDroppable, useDraggable, useCombinedRefs, isKeyboardEvent, createCustomBlockRegistry, Card, cn, Collapsible, CollapsibleContent, listContentTypes, mergeBlockDescriptorsWithRegistry, createBlock, createEditorReorderBlocksCommand, reorderBlocks, mutateBlockContent, useDndContext, useUniqueId, useIsomorphicLayoutEffect, EmptyState, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Search, getClientRect, resolveBlockTitle, CardHeader, GripVertical, ChevronRight, CardTitle, ArrowUp, ArrowDown, DropdownMenu, DropdownMenuTrigger, EllipsisVertical, DropdownMenuContent, DropdownMenuItem, Settings, DropdownMenuSeparator, Copy, Trash2, DialogFooter, DialogClose, CardContent, createEditorInsertBlockCommand, LoaderCircle, ChevronDown, normalEditorCuratedPromotedFieldPaths, resolveVisiblePromotedFieldPathsForEditorBlock, createStoreBackend, validateBlockManifestIssues, Callout, CalloutTitle, unfinishedBlockCopy, CalloutDescription, recoveryConflictCopy, ManifestForm, asEditorBlockValues, Box, createManifestFormAdapter, getModalConfig, isNonEmptyValue, ScrollableDialogContent, FormRenderer, Tabs, TabsList, TabsTrigger, TabsContent, mergeManifestWithSdkOptions, augmentManifestWithStyleGroups, lucide_react_exports, isThemeV2NormalEditorRawStylePath, getFieldIntent, isHeaderField, isThemeV2NormalEditorRawStyleFieldName, unwrapResponse, useEntryController, useEditorUiStoreInstance, useUISelector, resolvePreviewSidebarTab, BackgroundGradientField, BackgroundColorField, X, omitRouteTitleFieldFromManifest, getRouteMetadataManifestForType, createManifestValidation, previewAssistantEnabled, useField, FieldFrame, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, isCtaIconName, Combobox, CTA_ICON_OPTIONS, getCtaIconComponent, useBackendWatch, useAsyncPickerOptions, shouldShowPickerSearch, normalizePickerSearchThreshold, Badge, resolvePickerSelectionLabel, useMediaEditorOptional, useRichTextEditor, RichTextEditorSurface, ThemeScope, useBlockContext, resolveMediaSlotContract, asRecord, parseAspectRatioValue, MediaEditor, PUBLIC_FILE_FIELD_KINDS, CollapsibleTrigger, ContentFieldsForm, getCuratedSiteStyle, paletteOverridesSchema, findButtonPersonality, findPaletteVariant, findTypographyPreset, getHeaderLayout, getHeaderStyle, findFooterLook, footerLookCatalog, isObjectRecord, EMPTY_DOC, getRichTextImagePositionFromTarget, insertOrReplaceRichTextImage, resolveVideoSelectionIntentForMediaField, emitMediaCropDebug, Pencil, foldSubroute, SUBROUTE_KINDS, Smartphone, Tablet, Monitor, Maximize2, DropdownMenuLabel, asSiteId, buildThemeRuntime, PaletteProvider, MediaEditorProvider, curatedSiteStyles, ChevronLeft, requireEntriesForCuratedChoices, buttonPersonalities, typographyPresets, paletteVariants, resolveImageUrlWithContext, Root2, List, Trigger, Content, Input, Check, Label, isInternalResolvedLinkValue, evaluateTypographyFontSlot, Separator, classifyKnownMimeType, toRoutableLinkPayload, useMediaEditor, MediaPickerMini, MediaPickerDialog, Surface, ColorPicker, getDirectImageUrlForMediaAsset, isSvgMimeType } from './chunk-OECWLDHN.mjs';
-import { usePreviewAuth, getDashboardUrl } from './chunk-SVMMM2NA.mjs';
-import './chunk-XGB3TDIC.mjs';
-import React, { createContext, memo, useMemo, useState, useRef, useEffect, forwardRef, useCallback, useImperativeHandle, useContext, useSyncExternalStore, useLayoutEffect, useTransition, useId } from 'react';
+import { resolvePreviewDashboardSetupHandoff, buildPreviewDashboardSetupUrl, resolvePreviewSidebarChromeModel, resolvePreviewEditorGuidanceModel, canInspectSiteStyle, usePreviewDesignCoordinator, resolveStyleConfiguratorInitialSnapshot, createStyleConfiguratorState, createOptimisticActionRunner, syncStyleConfiguratorState, isPreviewingChange, planSiteStylePreviewChange, openRow, previewSiteStyle, applyResolvedSelections, previewButtonPersonality, previewHeaderLayout, previewHeaderStyle, planSiteChromeLookSelection, previewFooterLook, previewPaletteVariant, previewTypographyPreset, setTypographyBodyFontOverride, setTypographyHeadingFontOverride, clearTypographyFontOverrides, setPaletteOverrides, toggleRow, cancelPreview, dismissWarnings, dismissNotices, markApplyFailed, markApplySaved, markApplySaving, canApplySiteStyle, buildSiteChromeLookModels, cycleSiteChromeLookId, cycleableSiteChromeOptions } from './chunk-LCY32PXF.mjs';
+import { KeyboardCode, getBlockDefinition, CSS, useSdkConfig, unwrapResponse, parseSiteIconStyleGuideVersionId, parseBlockIconValue, listBlockDescriptors, useSensor, PointerSensor, useSensors, deleteBlock, createEditorRemoveBlockCommand, unsafeAsEditorBlockId, DndContext, closestCenter, Button, Plus, useDroppable, useDraggable, useCombinedRefs, isKeyboardEvent, createCustomBlockRegistry, Card, cn, Collapsible, CollapsibleContent, listContentTypes, mergeBlockDescriptorsWithRegistry, createBlock, createEditorReorderBlocksCommand, reorderBlocks, mutateBlockContent, useDndContext, useUniqueId, useIsomorphicLayoutEffect, EmptyState, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, Search, getClientRect, resolveBlockTitle, CardHeader, GripVertical, ChevronRight, CardTitle, ArrowUp, ArrowDown, DropdownMenu, DropdownMenuTrigger, EllipsisVertical, DropdownMenuContent, DropdownMenuItem, Settings, DropdownMenuSeparator, Sparkles, RotateCcw, ImagePlus, Copy, Trash2, DialogFooter, DialogClose, CardContent, createEditorInsertBlockCommand, LoaderCircle, ChevronDown, getFeatureCardIconCompletion, toFeatureCardIconSuggestionInputs, getBlockIconSemanticFallbackId, suggestSemanticIconForFeatureCard, getGeneratedBlockIconStyleState, assertNever, suggestFeatureCardSemanticIcons, applyFeatureCardIconSuggestions, createFeatureCardIconKey, Textarea, Callout, CalloutDescription, normalEditorCuratedPromotedFieldPaths, resolveVisiblePromotedFieldPathsForEditorBlock, createStoreBackend, validateBlockManifestIssues, CalloutTitle, unfinishedBlockCopy, recoveryConflictCopy, ManifestForm, unsafeAsEditorBlockValues, Box, createManifestFormAdapter, getModalConfig, isNonEmptyValue, ScrollableDialogContent, FormRenderer, Tabs, TabsList, TabsTrigger, TabsContent, mergeManifestWithSdkOptions, augmentManifestWithStyleGroups, lucide_react_exports, isThemeV2NormalEditorRawStylePath, getFieldIntent, isHeaderField, isThemeV2NormalEditorRawStyleFieldName, useEntryController, useEditorUiStoreInstance, useUISelector, resolvePreviewSidebarTab, BackgroundGradientField, BackgroundColorField, X, omitRouteTitleFieldFromManifest, getRouteMetadataManifestForType, createManifestValidation, previewAssistantEnabled, useField, FieldFrame, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, resolveIconPickerPreset, isIconPickerPreset, getIconPickerOptionsForPreset, isKnownIconName, Combobox, getIconComponent, useBackendWatch, useAsyncPickerOptions, shouldShowPickerSearch, normalizePickerSearchThreshold, Badge, resolvePickerSelectionLabel, useMediaEditorOptional, useRichTextEditor, RichTextEditorSurface, ThemeScope, useBlockContext, resolveMediaSlotContract, asRecord, parseAspectRatioValue, MediaEditor, PUBLIC_FILE_FIELD_KINDS, CollapsibleTrigger, ContentFieldsForm, getCuratedSiteStyle, paletteOverridesSchema, findButtonPersonality, findPaletteVariant, findTypographyPreset, getHeaderLayout, getHeaderStyle, findFooterLook, footerLookCatalog, isObjectRecord, EMPTY_DOC, getRichTextImagePositionFromTarget, insertOrReplaceRichTextImage, resolveVideoSelectionIntentForMediaField, emitMediaCropDebug, Pencil, foldSubroute, SUBROUTE_KINDS, Smartphone, Tablet, Monitor, Maximize2, DropdownMenuLabel, expectParsedBrandedId, parseSiteId, buildThemeRuntime, PaletteProvider, MediaEditorProvider, curatedSiteStyles, ChevronLeft, requireEntriesForCuratedChoices, buttonPersonalities, typographyPresets, paletteVariants, resolveImageUrlWithContext, Root2, List, Trigger, Content, Input, Check, Label, isInternalResolvedLinkValue, evaluateTypographyFontSlot, Separator, classifyKnownMimeType, toRoutableLinkPayload, useMediaEditor, MediaPickerMini, MediaPickerDialog, Surface, ColorPicker, getDirectImageUrlForMediaAsset, isSvgMimeType } from './chunk-V47ZU33I.mjs';
+import { usePreviewAuth, getDashboardUrl } from './chunk-K2IIF34C.mjs';
+import './chunk-R7POPVJR.mjs';
+import React, { createContext, memo, useMemo, useState, useRef, useEffect, forwardRef, useCallback, useImperativeHandle, useContext, useSyncExternalStore, useLayoutEffect, useReducer, useTransition, useId } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { useRouter } from 'next/navigation';
 
@@ -47,7 +47,7 @@ function parseReferenceKind(referenceKind) {
 }
 
 // ../content-model/src/contentManifest.ts
-function assertNever(value) {
+function assertNever2(value) {
   throw new Error(`Unhandled content field mapping decision: ${JSON.stringify(value)}`);
 }
 function resolveContentReferenceKind(field) {
@@ -178,7 +178,7 @@ function toFieldDefinition(field, context = {}) {
             valueFrom: mapping.valueFrom
           };
         default:
-          return assertNever(mapping);
+          return assertNever2(mapping);
       }
     }
     case "link":
@@ -1479,7 +1479,7 @@ function useBlockBaselineSync({
     const keepIds = /* @__PURE__ */ new Set();
     blockList.forEach((block, index) => {
       if (!block.id) return;
-      const blockId = asEditorBlockId(block.id);
+      const blockId = unsafeAsEditorBlockId(block.id);
       keepIds.add(blockId);
       const normalizedBaseline = applyExtendedFieldDefaults(
         block.kind,
@@ -1575,7 +1575,7 @@ var reindexBlockList = (items) => items.map((block, index) => ({ ...block, order
 
 // ../editor-blocks/src/block-editor/hooks/buildInsertBlockHistoryCommand.ts
 function toEditorBlockValues(value) {
-  return value ? asEditorBlockValues(value) : null;
+  return value ? unsafeAsEditorBlockValues(value) : null;
 }
 function buildInsertBlockHistoryCommand({
   block,
@@ -1584,7 +1584,7 @@ function buildInsertBlockHistoryCommand({
   publishedContent
 }) {
   if (!block.id) return null;
-  const blockId = asEditorBlockId(block.id);
+  const blockId = unsafeAsEditorBlockId(block.id);
   const purpose = typeof block.purpose === "string" ? block.purpose ?? null : "content";
   const baseline = draftContent ?? block.draftContent ?? block.content ?? null;
   const nextPublishedContent = publishedContent ?? block.publishedContent ?? null;
@@ -1790,7 +1790,7 @@ function useBlockDuplication({
         }
         onBlocksChange?.(next);
         if (triggerFocus) {
-          const nextBlockId = insertCommand?.block.id ?? asEditorBlockId(createdBlock.id);
+          const nextBlockId = insertCommand?.block.id ?? unsafeAsEditorBlockId(createdBlock.id);
           setTimeout(() => {
             triggerFocus({ blockId: nextBlockId });
           }, 100);
@@ -1860,7 +1860,7 @@ function useBlockReorder({
       const nextBlockIds = getBlockIds(updated);
       uiStore?.getState().history.applyCommand?.({
         ...createEditorReorderBlocksCommand(
-          nextBlockIds.map((blockId) => asEditorBlockId(blockId))
+          nextBlockIds.map((blockId) => unsafeAsEditorBlockId(blockId))
         )
       });
       try {
@@ -2065,7 +2065,7 @@ function BlockForm({
   pageDesignBlock = null
 }) {
   const formRootRef = useRef(null);
-  const blockId = typeof block.id === "string" ? asEditorBlockId(block.id) : null;
+  const blockId = typeof block.id === "string" ? unsafeAsEditorBlockId(block.id) : null;
   const blockSnapshot = useStoreSelector(
     uiStore,
     (state) => blockId ? state.drafts.getBlockSnapshot(blockId) : null
@@ -2301,6 +2301,451 @@ function blockSaveabilityEqual(left, right) {
     return nextIssue?.fieldPath === issue.fieldPath && nextIssue.message === issue.message;
   });
 }
+
+// ../editor-blocks/src/block-editor/featureCardIconActions.ts
+function getFeatureCards(content) {
+  const cards = content?.cards;
+  return Array.isArray(cards) ? cards : [];
+}
+function getFeatureCardIconStatus(content) {
+  return getFeatureCardIconCompletion(getFeatureCards(content));
+}
+function getFeatureCardIconDialogCards(content) {
+  return toFeatureCardIconSuggestionInputs(getFeatureCards(content)).map((card, index) => {
+    const semanticFallback = getBlockIconSemanticFallbackId(card.icon) ?? suggestSemanticIconForFeatureCard(card);
+    return {
+      cardKey: card.key,
+      title: card.title.trim().length > 0 ? card.title.trim() : `Card ${index + 1}`,
+      bodyText: card.bodyText.slice(0, 160),
+      semanticIconId: semanticFallback
+    };
+  });
+}
+function getFeatureCardGeneratedIconStyleSummary(content, currentStyleGuideVersionId) {
+  if (!currentStyleGuideVersionId) return { kind: "unavailable" };
+  let generatedCount = 0;
+  let staleCount = 0;
+  let invalidGeneratedCount = 0;
+  for (const card of getFeatureCards(content)) {
+    const state = getGeneratedBlockIconStyleState(card.icon, currentStyleGuideVersionId);
+    switch (state.kind) {
+      case "not_generated":
+        break;
+      case "current":
+        generatedCount += 1;
+        break;
+      case "stale":
+        generatedCount += 1;
+        staleCount += 1;
+        break;
+      case "invalid_generated":
+        invalidGeneratedCount += 1;
+        break;
+      default:
+        assertNever(state);
+    }
+  }
+  return {
+    kind: "available",
+    generatedCount,
+    staleCount,
+    invalidGeneratedCount
+  };
+}
+function applyCuratedFeatureCardIconSuggestions({
+  blockId,
+  content,
+  drafts
+}) {
+  const cards = getFeatureCards(content);
+  if (cards.length === 0) return { kind: "no_cards" };
+  const suggestions = suggestFeatureCardSemanticIcons(cards);
+  if (suggestions.length === 0) return { kind: "complete" };
+  const plan = applyFeatureCardIconSuggestions(cards, suggestions);
+  switch (plan.kind) {
+    case "applied":
+      break;
+    case "duplicate_card_key":
+    case "duplicate_suggestion_card_key":
+    case "missing_suggestion_card_key":
+    case "unknown_card_key":
+      return { kind: "plan_failed", reason: plan.kind, cardKey: plan.cardKey };
+    case "invalid_semantic_icon":
+      return { kind: "plan_failed", reason: plan.kind, iconId: plan.iconId };
+    default:
+      assertNever(plan);
+  }
+  for (const suggestion of plan.appliedSuggestions) {
+    const cardIndex = cards.findIndex((card, index) => createFeatureCardIconKey(card, index) === suggestion.cardKey);
+    if (cardIndex >= 0) {
+      drafts.setAtPath(blockId, `cards.${cardIndex}.icon`, { kind: "semantic", iconId: suggestion.iconId });
+    }
+  }
+  return { kind: "applied", appliedCount: plan.appliedSuggestions.length };
+}
+function planGeneratedFeatureCardIconSetApply(cards, assets) {
+  const cardKeys = cards.map(createFeatureCardIconKey);
+  const cardKeySet = new Set(cardKeys);
+  const iconByCardKey = /* @__PURE__ */ new Map();
+  for (const asset of assets) {
+    if (iconByCardKey.has(asset.cardKey)) {
+      return { kind: "duplicate_asset_card_key", cardKey: asset.cardKey };
+    }
+    if (!cardKeySet.has(asset.cardKey)) {
+      return { kind: "unknown_card_key", cardKey: asset.cardKey };
+    }
+    const iconValue = parseBlockIconValue(asset.iconValue);
+    if (iconValue.kind !== "generated") {
+      return { kind: "invalid_generated_icon", cardKey: asset.cardKey };
+    }
+    iconByCardKey.set(asset.cardKey, iconValue);
+  }
+  const appliedIcons = [];
+  for (const [cardIndex, cardKey] of cardKeys.entries()) {
+    const iconValue = iconByCardKey.get(cardKey);
+    if (!iconValue) {
+      return { kind: "missing_asset_card_key", cardKey };
+    }
+    appliedIcons.push({ cardIndex, cardKey, iconValue });
+  }
+  return {
+    kind: "applied",
+    appliedIcons
+  };
+}
+function applyGeneratedFeatureCardIconSet({
+  blockId,
+  content,
+  drafts,
+  assets
+}) {
+  const cards = getFeatureCards(content);
+  if (cards.length === 0) return { kind: "no_cards" };
+  const plan = planGeneratedFeatureCardIconSetApply(cards, assets);
+  switch (plan.kind) {
+    case "applied":
+      break;
+    case "duplicate_asset_card_key":
+    case "missing_asset_card_key":
+    case "unknown_card_key":
+    case "invalid_generated_icon":
+      return { kind: "plan_failed", reason: plan.kind, cardKey: plan.cardKey };
+    default:
+      assertNever(plan);
+  }
+  for (const appliedIcon of plan.appliedIcons) {
+    drafts.setAtPath(blockId, `cards.${appliedIcon.cardIndex}.icon`, appliedIcon.iconValue);
+  }
+  return { kind: "applied", appliedCount: plan.appliedIcons.length };
+}
+function reducer(state, action) {
+  switch (action.type) {
+    case "reset":
+      return { kind: "idle" };
+    case "generating":
+      return { kind: "generating" };
+    case "applying":
+      return { kind: "applying", preview: action.preview };
+    case "preview_ready":
+      return { kind: "preview_ready", preview: action.preview };
+    case "failed":
+      return { kind: "failed", message: action.message };
+  }
+}
+function getGenerationErrorMessage(error) {
+  return error instanceof Error && error.message.length > 0 ? error.message : "Failed to generate icon set";
+}
+function validateGeneratedIconSetPreview(preview, cards) {
+  const cardKeys = new Set(cards.map((card) => card.cardKey));
+  if (cardKeys.size !== cards.length) {
+    return { kind: "invalid", message: "Generated icon set could not match every card" };
+  }
+  const assetKeys = new Set(preview.assets.map((asset) => asset.cardKey));
+  if (assetKeys.size !== preview.assets.length || assetKeys.size !== cardKeys.size) {
+    return { kind: "invalid", message: "Generated icon set was incomplete" };
+  }
+  for (const asset of preview.assets) {
+    if (!cardKeys.has(asset.cardKey)) {
+      return { kind: "invalid", message: "Generated icon set was incomplete" };
+    }
+    if (parseBlockIconValue(asset.iconValue).kind !== "generated") {
+      return { kind: "invalid", message: "Generated icon set included an invalid icon reference" };
+    }
+  }
+  return { kind: "valid", preview };
+}
+function GeneratedIconSetDialog({
+  open,
+  onOpenChange,
+  cards,
+  styleGuideSummary,
+  styleGuideEditHref,
+  onGenerate,
+  onApply
+}) {
+  const [state, dispatch] = useReducer(reducer, { kind: "idle" });
+  const [styleNote, setStyleNote] = useState("");
+  const canGenerate = Boolean(onGenerate) && cards.length > 0 && state.kind !== "generating";
+  const canApply = Boolean(onApply) && state.kind === "preview_ready";
+  async function generate() {
+    if (!onGenerate || cards.length === 0) return;
+    dispatch({ type: "generating" });
+    try {
+      const result = await onGenerate({
+        cards,
+        userStyleNote: styleNote.trim().length > 0 ? styleNote.trim() : null
+      });
+      if (result.kind === "preview_ready") {
+        const validation = validateGeneratedIconSetPreview(result.preview, cards);
+        if (validation.kind === "invalid") {
+          dispatch({ type: "failed", message: validation.message });
+          return;
+        }
+        dispatch({ type: "preview_ready", preview: validation.preview });
+        return;
+      }
+      dispatch({ type: "failed", message: result.message });
+    } catch (error) {
+      dispatch({ type: "failed", message: getGenerationErrorMessage(error) });
+    }
+  }
+  function close(nextOpen) {
+    onOpenChange(nextOpen);
+    if (!nextOpen) dispatch({ type: "reset" });
+  }
+  async function apply(preview) {
+    if (!onApply) return;
+    dispatch({ type: "applying", preview });
+    try {
+      const result = await onApply(preview);
+      if (result?.kind === "failed") {
+        dispatch({ type: "failed", message: result.message });
+        return;
+      }
+      close(false);
+    } catch (error) {
+      dispatch({ type: "failed", message: getGenerationErrorMessage(error) });
+    }
+  }
+  return /* @__PURE__ */ jsx(Dialog, { open, onOpenChange: close, children: /* @__PURE__ */ jsxs(DialogContent, { className: "sm:max-w-2xl", children: [
+    /* @__PURE__ */ jsxs(DialogHeader, { children: [
+      /* @__PURE__ */ jsx(DialogTitle, { children: "Generate icon set" }),
+      /* @__PURE__ */ jsx(DialogDescription, { children: state.kind === "preview_ready" ? state.preview.styleGuideSummary : `${cards.length} cards` })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      styleGuideSummary || styleGuideEditHref ? /* @__PURE__ */ jsxs("div", { className: "rounded-md border bg-muted/20 px-3 py-2 text-sm", children: [
+        styleGuideSummary ? /* @__PURE__ */ jsx("p", { className: "text-muted-foreground", children: styleGuideSummary }) : null,
+        styleGuideEditHref ? /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: styleGuideEditHref,
+            className: "mt-1 inline-flex text-sm font-medium text-primary underline-offset-4 hover:underline",
+            children: "Edit icon style"
+          }
+        ) : null
+      ] }) : null,
+      /* @__PURE__ */ jsx("label", { className: "block text-sm font-medium", htmlFor: "generated-icon-style-note", children: "Icon style" }),
+      /* @__PURE__ */ jsx(
+        Textarea,
+        {
+          id: "generated-icon-style-note",
+          value: styleNote,
+          maxLength: 240,
+          disabled: state.kind === "generating",
+          onChange: (event) => setStyleNote(event.currentTarget.value),
+          placeholder: "Simple, soft-edged, lightly textured"
+        }
+      ),
+      state.kind === "failed" ? /* @__PURE__ */ jsx("p", { role: "alert", className: "text-sm text-destructive", children: state.message }) : null,
+      /* @__PURE__ */ jsx("div", { className: "grid gap-2 sm:grid-cols-2", children: cards.map((card) => {
+        const previewAsset = state.kind === "preview_ready" || state.kind === "applying" ? state.preview.assets.find((asset) => asset.cardKey === card.cardKey) : null;
+        return /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "grid min-h-24 grid-cols-[3rem_1fr] gap-3 rounded-md border bg-muted/20 p-3",
+            children: [
+              /* @__PURE__ */ jsx("div", { className: "flex size-12 items-center justify-center rounded-md border bg-background", children: previewAsset?.src ? /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: previewAsset.src,
+                  alt: "",
+                  className: "size-10 object-contain"
+                }
+              ) : /* @__PURE__ */ jsx(ImagePlus, { className: "size-5 text-muted-foreground", "aria-hidden": "true" }) }),
+              /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+                /* @__PURE__ */ jsx("p", { className: "truncate text-sm font-medium", children: card.title }),
+                card.bodyText ? /* @__PURE__ */ jsx("p", { className: "overflow-hidden text-ellipsis text-xs text-muted-foreground", children: card.bodyText }) : null
+              ] })
+            ]
+          },
+          card.cardKey
+        );
+      }) })
+    ] }),
+    /* @__PURE__ */ jsxs(DialogFooter, { children: [
+      /* @__PURE__ */ jsx(Button, { type: "button", variant: "outline", onClick: () => close(false), children: "Cancel" }),
+      /* @__PURE__ */ jsxs(
+        Button,
+        {
+          type: "button",
+          variant: "outline",
+          disabled: !canGenerate,
+          onClick: () => {
+            void generate();
+          },
+          children: [
+            state.kind === "preview_ready" ? /* @__PURE__ */ jsx(RotateCcw, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }) : /* @__PURE__ */ jsx(Sparkles, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }),
+            state.kind === "preview_ready" ? "Regenerate" : state.kind === "generating" ? "Generating" : "Generate"
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "button",
+          disabled: !canApply,
+          onClick: () => {
+            if (state.kind !== "preview_ready" || !onApply) return;
+            void apply(state.preview);
+          },
+          children: state.kind === "applying" ? "Applying" : "Apply set"
+        }
+      )
+    ] })
+  ] }) });
+}
+function supportsFeatureCardIconActions(blockKind) {
+  return blockKind === "block.feature-cards";
+}
+function FeatureCardIconsPanel({
+  block,
+  uiStore,
+  currentStyleGuideVersionId,
+  iconStyleGuideSummary,
+  iconStyleGuideEditHref,
+  onGenerateIconSet,
+  onApplyGeneratedIconSet
+}) {
+  const [generateDialogOpen, setGenerateDialogOpen] = useState(false);
+  const blockId = typeof block.id === "string" ? unsafeAsEditorBlockId(block.id) : null;
+  const currentValues = useStoreSelector(
+    uiStore,
+    (state) => blockId ? state.drafts.getCurrentValues(blockId) : null
+  );
+  const content = currentValues ?? block.draftContent ?? block.content ?? null;
+  const status = useMemo(() => getFeatureCardIconStatus(content), [content]);
+  const dialogCards = useMemo(() => getFeatureCardIconDialogCards(content), [content]);
+  const styleSummary = useMemo(
+    () => getFeatureCardGeneratedIconStyleSummary(content, currentStyleGuideVersionId),
+    [content, currentStyleGuideVersionId]
+  );
+  const isComplete = status.totalCards > 0 && status.cardsWithIcons >= status.totalCards;
+  const hasStaleGeneratedIcons = styleSummary.kind === "available" && styleSummary.staleCount > 0;
+  async function applyGeneratedIconSetPreview(preview) {
+    if (!blockId) return { kind: "failed", message: "Could not apply generated icon set" };
+    const appliedPreview = await onApplyGeneratedIconSet?.(preview);
+    const previewToApply = appliedPreview ?? preview;
+    const result = applyGeneratedFeatureCardIconSet({
+      blockId,
+      content,
+      drafts: uiStore.getState().drafts,
+      assets: previewToApply.assets
+    });
+    if (result.kind !== "applied") {
+      return { kind: "failed", message: "Could not apply generated icon set" };
+    }
+    return { kind: "applied" };
+  }
+  if (!supportsFeatureCardIconActions(block.kind) || !blockId) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs(
+      "section",
+      {
+        className: "rounded-md border bg-muted/20 px-3 py-3",
+        "aria-label": "Icons",
+        "data-testid": "feature-card-icons-panel",
+        children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+            /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+              /* @__PURE__ */ jsx("h3", { className: "text-sm font-medium", children: "Icons" }),
+              /* @__PURE__ */ jsxs("p", { className: "text-xs text-muted-foreground", children: [
+                status.cardsWithIcons,
+                " of ",
+                status.totalCards,
+                " cards"
+              ] })
+            ] }),
+            /* @__PURE__ */ jsxs(
+              Button,
+              {
+                type: "button",
+                variant: "outline",
+                size: "sm",
+                disabled: status.totalCards === 0 || isComplete,
+                onClick: () => {
+                  applyCuratedFeatureCardIconSuggestions({
+                    blockId,
+                    content,
+                    drafts: uiStore.getState().drafts
+                  });
+                },
+                children: [
+                  /* @__PURE__ */ jsx(Sparkles, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }),
+                  "Suggest icons"
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsxs(
+              Button,
+              {
+                type: "button",
+                variant: "outline",
+                size: "sm",
+                disabled: status.totalCards === 0,
+                onClick: () => setGenerateDialogOpen(true),
+                children: [
+                  /* @__PURE__ */ jsx(ImagePlus, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }),
+                  "Generate icon set"
+                ]
+              }
+            )
+          ] }),
+          hasStaleGeneratedIcons ? /* @__PURE__ */ jsxs(Callout, { tone: "warning", className: "mt-3 flex flex-wrap items-center gap-2", children: [
+            /* @__PURE__ */ jsx(CalloutDescription, { className: "mt-0 min-w-0 flex-1 text-xs", children: "Generated icons are out of date with the current icon style." }),
+            /* @__PURE__ */ jsxs(
+              Button,
+              {
+                type: "button",
+                variant: "outline",
+                size: "sm",
+                disabled: status.totalCards === 0 || !onGenerateIconSet,
+                onClick: () => setGenerateDialogOpen(true),
+                children: [
+                  /* @__PURE__ */ jsx(RotateCcw, { className: "mr-2 h-4 w-4", "aria-hidden": "true" }),
+                  "Regenerate set"
+                ]
+              }
+            )
+          ] }) : null
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      GeneratedIconSetDialog,
+      {
+        open: generateDialogOpen,
+        onOpenChange: setGenerateDialogOpen,
+        cards: dialogCards,
+        styleGuideSummary: iconStyleGuideSummary,
+        styleGuideEditHref: iconStyleGuideEditHref,
+        onGenerate: onGenerateIconSet,
+        onApply: applyGeneratedIconSetPreview
+      }
+    )
+  ] });
+}
 function BlockCardBody({
   siteId,
   block,
@@ -2313,29 +2758,48 @@ function BlockCardBody({
   theme,
   widgetOverrides,
   hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2 = false,
-  pageDesignBlock = null
+  pageDesignBlock = null,
+  currentStyleGuideVersionId,
+  iconStyleGuideSummary,
+  iconStyleGuideEditHref,
+  onGenerateIconSet,
+  onApplyGeneratedIconSet
 }) {
-  return /* @__PURE__ */ jsx(CardContent, { className: "space-y-4 pb-6", children: /* @__PURE__ */ jsx(
-    BlockForm,
-    {
-      siteId,
-      block,
-      manifest,
-      uiStore,
-      hasRecoveryConflict,
-      focusSignal: focusSignal ?? null,
-      onFocusHandled,
-      onSaveSuccess: (data) => {
-        if (block.id && onBlockSave) {
-          onBlockSave(block.id, data);
-        }
-      },
-      theme,
-      widgetOverrides,
-      hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
-      pageDesignBlock
-    }
-  ) });
+  return /* @__PURE__ */ jsxs(CardContent, { className: "space-y-4 pb-6", children: [
+    /* @__PURE__ */ jsx(
+      FeatureCardIconsPanel,
+      {
+        block,
+        uiStore,
+        currentStyleGuideVersionId,
+        iconStyleGuideSummary,
+        iconStyleGuideEditHref,
+        onGenerateIconSet,
+        onApplyGeneratedIconSet
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      BlockForm,
+      {
+        siteId,
+        block,
+        manifest,
+        uiStore,
+        hasRecoveryConflict,
+        focusSignal: focusSignal ?? null,
+        onFocusHandled,
+        onSaveSuccess: (data) => {
+          if (block.id && onBlockSave) {
+            onBlockSave(block.id, data);
+          }
+        },
+        theme,
+        widgetOverrides,
+        hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
+        pageDesignBlock
+      }
+    )
+  ] });
 }
 function getBaselineContent(content) {
   if (!content || typeof content !== "object") return {};
@@ -2380,7 +2844,7 @@ function BlockSettingsModal({
     },
     [controlledOpen, onOpenChange]
   );
-  const blockId = typeof block.id === "string" ? asEditorBlockId(block.id) : null;
+  const blockId = typeof block.id === "string" ? unsafeAsEditorBlockId(block.id) : null;
   const hasDraftSnapshot = useStoreSelector(
     uiStore,
     (state) => blockId ? state.drafts.getBlockSnapshot(blockId) !== null : false
@@ -2579,24 +3043,60 @@ function BlockCardHeader({
   theme,
   hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2 = false,
   reorderControlMode = "full",
-  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE
+  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE,
+  currentStyleGuideVersionId,
+  iconStyleGuideSummary,
+  iconStyleGuideEditHref,
+  onGenerateIconSet,
+  onApplyGeneratedIconSet
 }) {
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
   const [settingsDialogOpen, setSettingsDialogOpen] = useState(false);
+  const [generateIconSetDialogOpen, setGenerateIconSetDialogOpen] = useState(false);
   const [settingsAvailable, setSettingsAvailable] = useState(true);
   const showMoveButtons = shouldShowMoveButtons(reorderControlMode);
   const showActionsMenu = actionControlMode === "menu";
   const baselineContent = useDraftContent(
     uiStore,
-    typeof block.id === "string" ? asEditorBlockId(block.id) : null
+    typeof block.id === "string" ? unsafeAsEditorBlockId(block.id) : null
   );
   const contentToUse = baselineContent ?? block.content;
+  const blockId = typeof block.id === "string" ? unsafeAsEditorBlockId(block.id) : null;
+  const supportsIconActions = supportsFeatureCardIconActions(block.kind);
+  const currentContent = useStoreSelector(
+    uiStore,
+    (state) => supportsIconActions && blockId ? state.drafts.getCurrentValues(blockId) : null
+  );
+  const featureCardIconStatus = supportsIconActions ? getFeatureCardIconStatus(currentContent ?? block.draftContent ?? contentToUse) : null;
+  const featureCardIconActionsAvailable = Boolean(blockId) && supportsIconActions && (featureCardIconStatus?.totalCards ?? 0) > 0;
+  const featureCardIconsComplete = featureCardIconStatus !== null && featureCardIconStatus.totalCards > 0 && featureCardIconStatus.cardsWithIcons >= featureCardIconStatus.totalCards;
+  const featureCardSuggestionActionAvailable = featureCardIconActionsAvailable && !featureCardIconsComplete;
+  const generatedIconSetActionsAvailable = featureCardIconActionsAvailable && Boolean(onGenerateIconSet);
+  const featureCardIconContent = currentContent ?? block.draftContent ?? contentToUse;
+  const featureCardIconDialogCards = supportsIconActions ? getFeatureCardIconDialogCards(featureCardIconContent) : [];
+  const featureCardIconStyleSummary = supportsIconActions ? getFeatureCardGeneratedIconStyleSummary(featureCardIconContent, currentStyleGuideVersionId) : { kind: "unavailable" };
+  const hasStaleGeneratedIcons = featureCardIconStyleSummary.kind === "available" && featureCardIconStyleSummary.staleCount > 0;
+  async function applyGeneratedIconSetPreview(preview) {
+    if (!blockId) return { kind: "failed", message: "Could not apply generated icon set" };
+    const appliedPreview = await onApplyGeneratedIconSet?.(preview);
+    const previewToApply = appliedPreview ?? preview;
+    const result = applyGeneratedFeatureCardIconSet({
+      blockId,
+      content: featureCardIconContent,
+      drafts: uiStore.getState().drafts,
+      assets: previewToApply.assets
+    });
+    if (result.kind !== "applied") {
+      return { kind: "failed", message: "Could not apply generated icon set" };
+    }
+    return { kind: "applied" };
+  }
   const { displayTitle, showSubtitle } = resolveBlockTitle(
     manifest,
     contentToUse,
     block.kind
   );
-  const hasMenuActions = settingsAvailable || Boolean(onDuplicate) || Boolean(onDelete);
+  const hasMenuActions = settingsAvailable || featureCardSuggestionActionAvailable || generatedIconSetActionsAvailable || Boolean(onDuplicate) || Boolean(onDelete);
   const settingsModal = /* @__PURE__ */ jsx(
     BlockSettingsModal,
     {
@@ -2706,7 +3206,39 @@ function BlockCardHeader({
                     /* @__PURE__ */ jsx(Settings, { className: "mr-2 h-4 w-4" }),
                     "Settings"
                   ] }) : null,
-                  settingsAvailable && (onDuplicate || onDelete) ? /* @__PURE__ */ jsx(DropdownMenuSeparator, {}) : null,
+                  featureCardIconActionsAvailable ? /* @__PURE__ */ jsxs(Fragment, { children: [
+                    settingsAvailable ? /* @__PURE__ */ jsx(DropdownMenuSeparator, {}) : null,
+                    /* @__PURE__ */ jsxs(
+                      DropdownMenuItem,
+                      {
+                        disabled: !blockId || featureCardIconsComplete,
+                        onSelect: () => {
+                          if (!blockId) return;
+                          applyCuratedFeatureCardIconSuggestions({
+                            blockId,
+                            content: currentContent ?? block.draftContent ?? contentToUse,
+                            drafts: uiStore.getState().drafts
+                          });
+                        },
+                        children: [
+                          /* @__PURE__ */ jsx(Sparkles, { className: "mr-2 h-4 w-4" }),
+                          "Suggest icons"
+                        ]
+                      }
+                    ),
+                    generatedIconSetActionsAvailable ? /* @__PURE__ */ jsxs(
+                      DropdownMenuItem,
+                      {
+                        disabled: !blockId || featureCardIconDialogCards.length === 0,
+                        onSelect: () => setGenerateIconSetDialogOpen(true),
+                        children: [
+                          hasStaleGeneratedIcons ? /* @__PURE__ */ jsx(RotateCcw, { className: "mr-2 h-4 w-4" }) : /* @__PURE__ */ jsx(ImagePlus, { className: "mr-2 h-4 w-4" }),
+                          hasStaleGeneratedIcons ? "Regenerate icon set" : "Generate icon set"
+                        ]
+                      }
+                    ) : null
+                  ] }) : null,
+                  (settingsAvailable || featureCardIconActionsAvailable) && (onDuplicate || onDelete) ? /* @__PURE__ */ jsx(DropdownMenuSeparator, {}) : null,
                   onDuplicate ? /* @__PURE__ */ jsxs(
                     DropdownMenuItem,
                     {
@@ -2803,7 +3335,19 @@ function BlockCardHeader({
           }
         )
       ] })
-    ] }) })
+    ] }) }),
+    generatedIconSetActionsAvailable ? /* @__PURE__ */ jsx(
+      GeneratedIconSetDialog,
+      {
+        open: generateIconSetDialogOpen,
+        onOpenChange: setGenerateIconSetDialogOpen,
+        cards: featureCardIconDialogCards,
+        styleGuideSummary: iconStyleGuideSummary,
+        styleGuideEditHref: iconStyleGuideEditHref,
+        onGenerate: onGenerateIconSet,
+        onApply: applyGeneratedIconSetPreview
+      }
+    ) : null
   ] });
 }
 function BlockCard({
@@ -2831,7 +3375,12 @@ function BlockCard({
   hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2 = false,
   pageDesignBlock = null,
   reorderControlMode = DEFAULT_REORDER_CONTROL_MODE,
-  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE
+  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE,
+  currentStyleGuideVersionId,
+  iconStyleGuideSummary,
+  iconStyleGuideEditHref,
+  onGenerateIconSet,
+  onApplyGeneratedIconSet
 }) {
   const contentId = block.id ? `builder-block-content-${block.id}` : void 0;
   return /* @__PURE__ */ jsx(
@@ -2862,7 +3411,12 @@ function BlockCard({
             theme,
             hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
             reorderControlMode,
-            actionControlMode
+            actionControlMode,
+            currentStyleGuideVersionId,
+            iconStyleGuideSummary,
+            iconStyleGuideEditHref,
+            onGenerateIconSet,
+            onApplyGeneratedIconSet
           }
         ),
         /* @__PURE__ */ jsx(CollapsibleContent, { id: contentId, children: /* @__PURE__ */ jsx(
@@ -2879,7 +3433,12 @@ function BlockCard({
             theme,
             widgetOverrides,
             hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
-            pageDesignBlock
+            pageDesignBlock,
+            currentStyleGuideVersionId,
+            iconStyleGuideSummary,
+            iconStyleGuideEditHref,
+            onGenerateIconSet,
+            onApplyGeneratedIconSet
           }
         ) })
       ] })
@@ -2911,7 +3470,12 @@ var SortableBlockItem = memo(function SortableBlockItem2({
   hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2 = false,
   pageDesignBlock = null,
   reorderControlMode = DEFAULT_REORDER_CONTROL_MODE,
-  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE
+  actionControlMode = DEFAULT_BLOCK_ACTION_CONTROL_MODE,
+  currentStyleGuideVersionId,
+  iconStyleGuideSummary,
+  iconStyleGuideEditHref,
+  onGenerateIconSet,
+  onApplyGeneratedIconSet
 }) {
   const sortable = useSortable({
     id: block.id,
@@ -2994,7 +3558,12 @@ var SortableBlockItem = memo(function SortableBlockItem2({
           hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
           pageDesignBlock,
           reorderControlMode,
-          actionControlMode
+          actionControlMode,
+          currentStyleGuideVersionId,
+          iconStyleGuideSummary,
+          iconStyleGuideEditHref,
+          onGenerateIconSet,
+          onApplyGeneratedIconSet
         }
       )
     }
@@ -3046,6 +3615,7 @@ var BlockEditor = forwardRef(
     );
     const [fetchedContentTypes, setFetchedContentTypes] = useState(enabledContentTypes);
     const [fetchingContentTypes, setFetchingContentTypes] = useState(false);
+    const [iconStyleGuide, setIconStyleGuide] = useState(null);
     const allowReordering = enableReordering;
     const allowCreation = enableCreation;
     const conflictedBlockIdSet = useMemo(
@@ -3072,6 +3642,99 @@ var BlockEditor = forwardRef(
     useEffect(() => {
       setBlockList(normalizeBlockListInitial(blocks));
     }, [blocks]);
+    useEffect(() => {
+      if (typeof apiClient !== "function") {
+        setIconStyleGuide(null);
+        return void 0;
+      }
+      let cancelled = false;
+      void Promise.resolve().then(() => apiClient({
+        endpoint: "getSiteIconStyleGuide",
+        params: { siteId }
+      })).then(unwrapResponse).then((response) => {
+        if (cancelled) return;
+        const versionId = parseSiteIconStyleGuideVersionId(response.guide.versionId);
+        setIconStyleGuide(versionId ? {
+          versionId,
+          summary: response.guide.displaySummary,
+          editHref: `/dashboard/sites/${siteId}/settings/icon-style-guide`
+        } : null);
+      }).catch(() => {
+        if (!cancelled) setIconStyleGuide(null);
+      });
+      return () => {
+        cancelled = true;
+      };
+    }, [apiClient, siteId]);
+    const generateFeatureCardIconSet = useCallback(async (input) => {
+      if (typeof apiClient !== "function") {
+        return { kind: "failed", message: "Generated icon set API is unavailable" };
+      }
+      try {
+        const response = unwrapResponse(await apiClient({
+          endpoint: "generateGeneratedIconSet",
+          params: { siteId },
+          body: {
+            blockKind: "block.feature-cards",
+            blockLabel: "Feature cards",
+            userStyleNote: input.userStyleNote,
+            cards: input.cards.map((card) => ({
+              cardKey: card.cardKey,
+              title: card.title,
+              bodyText: card.bodyText,
+              semanticIconId: card.semanticIconId
+            }))
+          }
+        }));
+        const assets = response.preview.assets.map((asset) => {
+          const iconValue = parseBlockIconValue(asset.iconValue);
+          if (iconValue.kind !== "generated") {
+            throw new Error("Generated icon response included an invalid icon reference");
+          }
+          return {
+            cardKey: asset.cardKey,
+            title: input.cards.find((card) => card.cardKey === asset.cardKey)?.title ?? asset.cardKey,
+            src: asset.src,
+            iconValue
+          };
+        });
+        return {
+          kind: "preview_ready",
+          preview: {
+            setId: response.candidate.setId,
+            styleGuideSummary: response.styleGuide.displaySummary,
+            candidate: response.candidate,
+            assets
+          }
+        };
+      } catch (error) {
+        return {
+          kind: "failed",
+          message: error instanceof Error && error.message ? error.message : "Failed to generate icon set"
+        };
+      }
+    }, [apiClient, siteId]);
+    const applyGeneratedFeatureCardIconSet2 = useCallback(async (preview) => {
+      if (typeof apiClient !== "function") return preview;
+      if (!preview.candidate) return preview;
+      const response = unwrapResponse(await apiClient({
+        endpoint: "applyGeneratedIconSet",
+        params: { siteId },
+        body: { candidate: preview.candidate }
+      }));
+      const iconValuesByCardKey = new Map(response.assets.map((asset) => [asset.cardKey, asset.iconValue]));
+      return {
+        ...preview,
+        assets: preview.assets.map((asset) => {
+          const applied = iconValuesByCardKey.get(asset.cardKey);
+          const iconValue = parseBlockIconValue(applied ?? asset.iconValue);
+          if (iconValue.kind !== "generated") {
+            throw new Error("Generated icon apply response included an invalid icon reference");
+          }
+          return { ...asset, iconValue };
+        })
+      };
+    }, [apiClient, siteId]);
     useEffect(() => {
       const unsubscribe = uiStore.subscribe(() => {
         const structureList = uiStore.getState().structure.getList();
@@ -3110,7 +3773,7 @@ var BlockEditor = forwardRef(
           }
         }
       }
-      fetchContentTypesFromApi();
+      void fetchContentTypesFromApi();
       return () => {
         cancelled = true;
       };
@@ -3210,7 +3873,7 @@ var BlockEditor = forwardRef(
           setBlockList(updatedList);
           if (uiStore) {
             uiStore.getState().history.applyCommand?.({
-              ...createEditorRemoveBlockCommand(asEditorBlockId(blockId))
+              ...createEditorRemoveBlockCommand(unsafeAsEditorBlockId(blockId))
             });
           }
           onBlocksChange?.(updatedList);
@@ -3272,7 +3935,7 @@ var BlockEditor = forwardRef(
       if (!firstRecoveryBlockId) {
         return;
       }
-      uiStore.getState().requestFocus({ blockId: asEditorBlockId(firstRecoveryBlockId) });
+      uiStore.getState().requestFocus({ blockId: unsafeAsEditorBlockId(firstRecoveryBlockId) });
     }, [
       recoveryConflictBlockIds,
       recoveryConflictReviewRequestId,
@@ -3284,7 +3947,7 @@ var BlockEditor = forwardRef(
         return;
       }
       const stillExists = blockList.some(
-        (block) => typeof block.id === "string" && asEditorBlockId(block.id) === activeBlockId
+        (block) => typeof block.id === "string" && unsafeAsEditorBlockId(block.id) === activeBlockId
       );
       if (!stillExists) {
         uiStore.getState().setActiveBlockId(null);
@@ -3333,7 +3996,7 @@ var BlockEditor = forwardRef(
               children: /* @__PURE__ */ jsxs("div", { className: "space-y-0", children: [
                 allowCreation ? /* @__PURE__ */ jsx(AddBlockDivider, { onOpen: openPicker, position: 0 }) : null,
                 blockList.map((block, index) => {
-                  const focusSignal = focusRequest && block.id && focusRequest.blockId === asEditorBlockId(block.id) ? focusRequest : null;
+                  const focusSignal = focusRequest && block.id && focusRequest.blockId === unsafeAsEditorBlockId(block.id) ? focusRequest : null;
                   const collapsed = isCollapsed(block.id);
                   return /* @__PURE__ */ jsxs(
                     "div",
@@ -3365,12 +4028,12 @@ var BlockEditor = forwardRef(
                               if (!block.id) return;
                               setCollapsed(block.id, nextCollapsed);
                               if (nextCollapsed) {
-                                if (activeBlockId === asEditorBlockId(block.id)) {
+                                if (activeBlockId === unsafeAsEditorBlockId(block.id)) {
                                   uiStore.getState().setActiveBlockId(null);
                                 }
                                 return;
                               }
-                              uiStore.getState().setActiveBlockId(asEditorBlockId(block.id));
+                              uiStore.getState().setActiveBlockId(unsafeAsEditorBlockId(block.id));
                             },
                             highlighted: highlightedBlockId === block.id,
                             hasRecoveryConflict: typeof block.id === "string" && conflictedBlockIdSet.has(block.id),
@@ -3385,7 +4048,12 @@ var BlockEditor = forwardRef(
                             hideThemeV2RawStyleFields: hideThemeV2RawStyleFields2,
                             pageDesignBlock: block.id ? pageDesignBlockById.get(block.id) ?? null : null,
                             reorderControlMode,
-                            actionControlMode
+                            actionControlMode,
+                            currentStyleGuideVersionId: iconStyleGuide?.versionId ?? null,
+                            iconStyleGuideSummary: iconStyleGuide?.summary ?? null,
+                            iconStyleGuideEditHref: iconStyleGuide?.editHref ?? null,
+                            onGenerateIconSet: generateFeatureCardIconSet,
+                            onApplyGeneratedIconSet: applyGeneratedFeatureCardIconSet2
                           }
                         ),
                         allowCreation && index < blockList.length - 1 ? /* @__PURE__ */ jsx(
@@ -4589,6 +5257,8 @@ function MediaField({
   const mediaPickerAutoOpen = config.ui?.mediaPickerAutoOpen === true;
   const showMediaPreview = config.ui?.showMediaPreview !== false;
   const showMediaOverlayActions = config.ui?.showMediaOverlayActions !== false;
+  const mediaPreviewMaxWidth = config.ui?.mediaPreviewMaxWidth ?? "md";
+  const preventMediaPreviewUpscale = config.ui?.preventMediaPreviewUpscale === true;
   const slotContract = resolveMediaSlotContract({
     blockKind: blockContext?.blockKind,
     fieldPath: path,
@@ -4626,6 +5296,8 @@ function MediaField({
       fullWidth: isInlineVariant,
       previewVariant: isInlineVariant ? "thumbnail" : "default",
       showRemoveAction: !isInlineVariant,
+      previewMaxWidth: mediaPreviewMaxWidth,
+      preventPreviewUpscale: preventMediaPreviewUpscale,
       videoPrepIntent: videoPrepIntentForMediaField(
         path,
         config.mediaKinds
@@ -4652,6 +5324,8 @@ function FileField({
   const mediaPickerAutoOpen = config.ui?.mediaPickerAutoOpen === true;
   const showMediaPreview = config.ui?.showMediaPreview !== false;
   const showMediaOverlayActions = config.ui?.showMediaOverlayActions !== false;
+  const mediaPreviewMaxWidth = config.ui?.mediaPreviewMaxWidth ?? "md";
+  const preventMediaPreviewUpscale = config.ui?.preventMediaPreviewUpscale === true;
   const handleChange = (next) => {
     emitMediaCropDebug("MediaField", "file_change", {
       path,
@@ -4675,6 +5349,8 @@ function FileField({
       fullWidth: isInlineVariant,
       previewVariant: isInlineVariant ? "thumbnail" : "default",
       showRemoveAction: !isInlineVariant,
+      previewMaxWidth: mediaPreviewMaxWidth,
+      preventPreviewUpscale: preventMediaPreviewUpscale,
       uploadIntent: uploadIntentForFileField()
     }
   );
@@ -4827,15 +5503,17 @@ function EntryPickerField({
 }
 function IconPickerField({ path, backend, config }) {
   const { value, error, setValue } = useField(path, backend);
-  const preset = config.ui?.iconPickerPreset;
-  if (preset && preset !== "cta" && true) {
-    console.warn(`[IconPickerField] Unknown iconPickerPreset "${preset}" at "${path}". Falling back to "cta".`);
+  const configuredPreset = config.ui?.iconPickerPreset;
+  const preset = resolveIconPickerPreset(configuredPreset);
+  if (configuredPreset && !isIconPickerPreset(configuredPreset) && true) {
+    console.warn(`[IconPickerField] Unknown iconPickerPreset "${configuredPreset}" at "${path}". Falling back to "cta".`);
   }
-  const selected = typeof value === "string" && isCtaIconName(value) ? value : void 0;
+  const options = getIconPickerOptionsForPreset(preset);
+  const selected = typeof value === "string" && isKnownIconName(value) && options.some((option) => option.id === value) ? value : void 0;
   return /* @__PURE__ */ jsx(FieldFrame, { label: config.label, description: config.description, error: error?.message, children: () => /* @__PURE__ */ jsx(
     Combobox,
     {
-      items: CTA_ICON_OPTIONS.map((opt) => ({ id: opt.id, label: opt.label, item: opt })),
+      items: options.map((opt) => ({ id: opt.id, label: opt.label, searchText: opt.searchText, item: opt })),
       value: selected,
       onSelect: (entry) => {
         if (!entry) {
@@ -4847,7 +5525,7 @@ function IconPickerField({ path, backend, config }) {
       placeholder: "Select icon\u2026",
       clearLabel: "Clear",
       renderItem: (entry) => {
-        const Icon = getCtaIconComponent(entry.id);
+        const Icon = getIconComponent(entry.id);
         return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
           Icon ? /* @__PURE__ */ jsx(Icon, { className: "h-4 w-4 shrink-0", "aria-hidden": "true" }) : null,
           /* @__PURE__ */ jsx("span", { className: "truncate", children: entry.label })
@@ -5275,7 +5953,7 @@ function PreviewFormProvider({
   mediaAssets,
   children
 }) {
-  const siteId = useMemo(() => asSiteId(rawSiteId), [rawSiteId]);
+  const siteId = useMemo(() => expectParsedBrandedId(parseSiteId(rawSiteId)), [rawSiteId]);
   const linkAdapters = useMemo(() => createPreviewLinkAdapters(previewClient), [previewClient]);
   const entryPickerAdapter = useMemo(() => createPreviewEntryPickerAdapter(previewClient), [previewClient]);
   const referenceAdapters = useMemo(
@@ -6856,8 +7534,15 @@ function SiteChromeLookRow({
 }
 function PaletteRow({ expanded, onToggle, siteStyle, currentId, currentLabel, currentSwatch, onPreview, disabled }) {
   const options = useMemo(
-    () => requireEntriesForCuratedChoices(paletteVariants, siteStyle.paletteVariantChoices),
-    [siteStyle.paletteVariantChoices]
+    () => {
+      const recommended = requireEntriesForCuratedChoices(paletteVariants, siteStyle.paletteVariantChoices);
+      if (recommended.some((variant) => variant.id === currentId)) {
+        return recommended;
+      }
+      const current = findPaletteVariant(currentId);
+      return current ? [current, ...recommended] : recommended;
+    },
+    [currentId, siteStyle.paletteVariantChoices]
   );
   return /* @__PURE__ */ jsx(
     StyleRowFrame,
@@ -7002,7 +7687,7 @@ function describeWarning(warning) {
     case "rejected-personality":
       return `Button style changed to ${warning.fellBackTo} because ${warning.requested} is not offered for this site style.`;
     case "rejected-palette":
-      return `Palette changed to ${warning.fellBackTo} because ${warning.requested} is not offered for this site style.`;
+      return `Palette changed to ${warning.fellBackTo} because ${warning.requested} is not available.`;
     case "rejected-typography-preset":
       return `Typography changed to ${warning.fellBackTo} because ${warning.requested} is not offered for this site style.`;
     default: {
@@ -7115,7 +7800,7 @@ function PreviewEditorSidebar({
         const baseline = extractData(
           block.content ?? block.draftContent ?? block.publishedContent ?? null
         );
-        const blockId = asEditorBlockId(block.id);
+        const blockId = unsafeAsEditorBlockId(block.id);
         if (drafts.getBlockSnapshot(blockId)) {
           drafts.updateBlockBaseline(blockId, baseline, { kind: block.kind });
         } else {