@riverbankcms/sdk 0.78.2 → 0.79.0

package/dist/_dts/blocks/src/system/blocks/testimonials.d.ts

@@ -10,6 +10,7 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
     readonly variants: {
         readonly carousel: NodeDefinition;
         readonly grid: NodeDefinition;
+        readonly 'split-grid': NodeDefinition;
     };
     readonly defaultVariant: "carousel";
     readonly variantOptions: {
@@ -23,6 +24,11 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
             readonly description: "Responsive grid layout";
             readonly icon: "Grid";
         };
+        readonly 'split-grid': {
+            readonly label: "Split grid";
+            readonly description: "Heading on the left with testimonial cards on the right";
+            readonly icon: "PanelLeft";
+        };
     };
     readonly additionalFields: import("../../../../block-form/src/backend/index").FieldDefinition[];
     readonly description: "Display customer testimonials in carousel or grid layouts.";
@@ -41,7 +47,7 @@ export declare const testimonialsManifest: import("..").DefinedBlockManifest<imp
     };
 }>>;
 export type TestimonialsBlockContent = {
-    variant?: 'carousel' | 'grid' | null;
+    variant?: 'carousel' | 'grid' | 'split-grid' | null;
     heading?: string | null;
     subheading?: string | null;
     avatarLayout?: 'above-centered' | 'inline-left' | 'hidden' | null;

package/dist/_dts/blocks/src/system/customize/backgrounds.d.ts

@@ -0,0 +1,170 @@
+import { type MediaAssetId } from '../../../../core/src/index';
+import { type ThemeColorToken } from '../../../../theme-core/src/tokens/index';
+import type { AppearancePresetId, LayoutVariantKey } from '../../../../theme-core/src/site-styles/index';
+export type BackgroundMode = 'default' | 'color' | 'gradient' | 'image';
+export type BackgroundModeCycleDirection = 'prev' | 'next';
+export type GradientPresetId = string & {
+    readonly __brand: 'GradientPresetId';
+};
+export type BackgroundOverride = Readonly<{
+    kind: 'default';
+}> | Readonly<{
+    kind: 'color';
+    token: ThemeColorToken;
+}> | Readonly<{
+    kind: 'gradient';
+    gradientId: GradientPresetId;
+}> | Readonly<{
+    kind: 'image';
+    mediaId: MediaAssetId;
+}>;
+export type LegacyBackgroundReason = 'unsupported-shape' | 'unsupported-mode' | 'invalid-color-token' | 'arbitrary-gradient-css' | 'missing-gradient-preset-id' | 'invalid-gradient-preset-id' | 'missing-image-media-id' | 'invalid-image-media-id' | 'video-background';
+export type ParsedBackgroundOverride = Readonly<{
+    kind: 'supported';
+    override: BackgroundOverride;
+}> | Readonly<{
+    kind: 'legacy';
+    reason: LegacyBackgroundReason;
+    background: Readonly<Record<string, unknown>>;
+}>;
+export type BackgroundImagePoolSource = 'current' | 'generated-ambient' | 'previous-background' | 'general-media';
+export type BackgroundImagePoolItem = Readonly<{
+    mediaId: MediaAssetId;
+    source: BackgroundImagePoolSource;
+    label?: string;
+    rank?: number;
+}>;
+export type BackgroundContrastTreatment = Readonly<{
+    kind: 'theme-foreground';
+    minContrastRatio: 4.5;
+}> | Readonly<{
+    kind: 'look-owned-image-overlay';
+    minContrastRatio: 4.5;
+    minOverlayOpacity: 0.64;
+}>;
+export type BackgroundModeCapability = Readonly<{
+    kind: 'default';
+}> | Readonly<{
+    kind: 'color';
+    recommendedTokens: readonly ThemeColorToken[];
+    advancedTokens: readonly ThemeColorToken[];
+    selectableTokens: readonly ThemeColorToken[];
+    treatment: BackgroundContrastTreatment;
+}> | Readonly<{
+    kind: 'gradient';
+    gradientIds: readonly GradientPresetId[];
+    treatment: BackgroundContrastTreatment;
+}> | Readonly<{
+    kind: 'image';
+    imagePool: readonly BackgroundImagePoolItem[];
+    treatment: BackgroundContrastTreatment;
+}>;
+export type BackgroundCapability = Readonly<{
+    modeCapabilities: readonly BackgroundModeCapability[];
+    modes: readonly BackgroundMode[];
+    recommendedColorTokens?: readonly ThemeColorToken[];
+    advancedColorTokens?: readonly ThemeColorToken[];
+    colorTokens?: readonly ThemeColorToken[];
+    gradientIds?: readonly GradientPresetId[];
+    imagePool?: readonly BackgroundImagePoolItem[];
+    colorTreatment?: BackgroundContrastTreatment;
+    gradientTreatment?: BackgroundContrastTreatment;
+    imageTreatment?: BackgroundContrastTreatment;
+}>;
+export type BackgroundTransitionAction = Readonly<{
+    kind: 'cycle-mode';
+    direction: BackgroundModeCycleDirection;
+}> | Readonly<{
+    kind: 'cycle-value';
+    direction: BackgroundModeCycleDirection;
+}> | Readonly<{
+    kind: 'choose-color';
+    token: ThemeColorToken;
+}> | Readonly<{
+    kind: 'choose-gradient';
+    gradientId: GradientPresetId;
+}> | Readonly<{
+    kind: 'choose-image';
+    mediaId: MediaAssetId;
+}> | Readonly<{
+    kind: 'clear-default';
+}>;
+export type BackgroundPersistenceSideEffect = Readonly<{
+    kind: 'mark-background-used';
+    mediaId: MediaAssetId;
+}>;
+export type BackgroundTransitionPlan = Readonly<{
+    kind: 'apply';
+    override: BackgroundOverride;
+    sideEffects: readonly BackgroundPersistenceSideEffect[];
+}> | Readonly<{
+    kind: 'blocked';
+    reason: BackgroundTransitionBlockedReason;
+}>;
+export type BackgroundTransitionBlockedReason = 'mode-unavailable' | 'value-unavailable' | 'empty-image-pool' | 'current-value-not-cycleable';
+export type BackgroundOverridePlan = Readonly<{
+    kind: 'apply';
+    override: BackgroundOverride;
+    fromOverride: BackgroundOverride;
+    sideEffects: readonly BackgroundPersistenceSideEffect[];
+}> | Readonly<{
+    kind: 'unchanged';
+    override: BackgroundOverride;
+}> | Readonly<{
+    kind: 'blocked';
+    reason: BackgroundOverrideBlockedReason;
+}>;
+export type BackgroundOverrideBlockedReason = 'mode-unavailable' | 'value-unavailable' | 'legacy-current-background';
+export type BackgroundCustomizeContent = Record<string, unknown>;
+export type BackgroundCapabilityBlock = Readonly<{
+    blockKind: string;
+    layout: Readonly<{
+        effectiveValue: LayoutVariantKey;
+    }> | null;
+    availableLayouts: readonly BackgroundCapabilityLayoutOption[];
+    look: Readonly<{
+        effectiveValue: AppearancePresetId | null;
+    }>;
+    availableLooks: readonly BackgroundCapabilityLookOption[];
+}>;
+export type BackgroundCapabilityLayoutOption = Readonly<{
+    id: LayoutVariantKey;
+    profile: Readonly<{
+        layoutFamily: string;
+    }>;
+}>;
+export type BackgroundCapabilityLookOption = Readonly<{
+    id: AppearancePresetId;
+    design: Readonly<{
+        sectionSurface: string;
+    }>;
+}>;
+export type ResolveBackgroundCapabilityInput = Readonly<{
+    block: BackgroundCapabilityBlock;
+    imagePool?: readonly BackgroundImagePoolItem[];
+}>;
+export declare const BACKGROUND_MODES: readonly ["default", "color", "gradient", "image"];
+export declare const DEFAULT_BACKGROUND_OVERRIDE: BackgroundOverride;
+export declare const BACKGROUND_CUSTOMIZABLE_BLOCK_KINDS: readonly ["block.hero", "block.testimonials", "block.cta-full", "block.form"];
+export declare const BACKGROUND_RICH_LAYOUT_FAMILIES: readonly ["split"];
+export declare const BACKGROUND_RICH_SECTION_SURFACES: readonly ["hero-image"];
+export declare function isBackgroundCustomizableBlockKind(blockKind: string): boolean;
+export declare const backgroundColorTokens: readonly ThemeColorToken[];
+export declare const recommendedBackgroundColorTokens: readonly ThemeColorToken[];
+export declare const advancedBackgroundColorTokens: ThemeColorToken[];
+export declare function parseGradientPresetId(value: unknown): GradientPresetId | null;
+export declare function isGradientPresetId(value: unknown): value is GradientPresetId;
+export declare function backgroundModeForOverride(override: BackgroundOverride): BackgroundMode;
+export declare function backgroundOverrideEquals(left: BackgroundOverride, right: BackgroundOverride): boolean;
+export declare function imagePoolForOverride(override: BackgroundOverride): readonly BackgroundImagePoolItem[];
+export declare function defaultBackgroundOverrideForMode(mode: BackgroundMode, capability: BackgroundCapability): BackgroundOverride;
+export declare function resolveBackgroundCapability(input: ResolveBackgroundCapabilityInput): BackgroundCapability;
+export declare function backgroundCapabilityFromModes(modeCapabilities: readonly BackgroundModeCapability[]): BackgroundCapability;
+export declare function parseBackgroundOverrideFromContent(content: BackgroundCustomizeContent): ParsedBackgroundOverride;
+export declare function parseBackgroundOverride(value: unknown): ParsedBackgroundOverride;
+export declare function serializeBackgroundOverride(override: BackgroundOverride): Record<string, unknown> | null;
+export declare function applyBackgroundOverrideContentPatch(content: BackgroundCustomizeContent, override: BackgroundOverride): BackgroundCustomizeContent;
+export declare function planBackgroundTransition(current: BackgroundOverride, capability: BackgroundCapability, action: BackgroundTransitionAction): BackgroundTransitionPlan;
+export declare function planBackgroundOverride(current: ParsedBackgroundOverride, capability: BackgroundCapability, override: BackgroundOverride): BackgroundOverridePlan;
+export declare function rankBackgroundImagePoolItems(items: readonly BackgroundImagePoolItem[]): readonly BackgroundImagePoolItem[];
+export declare function enabledBackgroundModes(capability: BackgroundCapability): readonly BackgroundMode[];

package/dist/_dts/blocks/src/system/fragments/library/testimonialsCarousel.d.ts

@@ -20,6 +20,11 @@ export declare function buildCarouselLayout(): NodeDefinition;
  * Renders testimonials in a responsive grid with configurable columns.
  */
 export declare function buildGridLayout(): NodeDefinition;
+/**
+ * Build just the responsive testimonial card grid, for variants that place
+ * heading copy in a sibling column instead of above the cards.
+ */
+export declare function buildGridCardsLayout(className: string): NodeDefinition;
 /**
  * Fragment definition for testimonials carousel.
  * Provides field definitions and data loader configuration.

package/dist/_dts/blocks/src/system/helpers/resolveBackground.d.ts

@@ -6,7 +6,7 @@
  * behavior of the default declarative block system.
  */
 import * as React from "react";
-import type { ThemeTokens } from "../theme";
+import { type ThemeTokens } from "../theme";
 import type { Media } from "../../lib/media";
 import { type BackgroundMedia } from "./backgroundMedia";
 import { type ResolveImageUrlContext } from "../runtime/nodes/media";
@@ -19,6 +19,8 @@ export type BackgroundInput = {
     color?: string | null;
     /** CSS gradient string */
     gradient?: string | null;
+    /** Curated gradient preset identifier. Used for Customize-mode backgrounds. */
+    gradientPresetId?: string | null;
     /** Background image or decorative video media object */
     image?: Media | null;
     /** Whether decorative background video should play on mobile. Defaults to false. */

package/dist/_dts/blocks/src/system/icons/ids.d.ts

@@ -0,0 +1,13 @@
+import type { Brand } from '../../../../core/src/index';
+export type GeneratedIconSetId = Brand<string, 'GeneratedIconSetId'>;
+export type GeneratedIconAssetId = Brand<string, 'GeneratedIconAssetId'>;
+export type SiteIconStyleGuideVersionId = Brand<string, 'SiteIconStyleGuideVersionId'>;
+export type ApprovedIconExampleSetId = Brand<string, 'ApprovedIconExampleSetId'>;
+export declare function unsafeAsGeneratedIconSetId(value: string): GeneratedIconSetId;
+export declare function unsafeAsGeneratedIconAssetId(value: string): GeneratedIconAssetId;
+export declare function unsafeAsSiteIconStyleGuideVersionId(value: string): SiteIconStyleGuideVersionId;
+export declare function unsafeAsApprovedIconExampleSetId(value: string): ApprovedIconExampleSetId;
+export declare function parseGeneratedIconSetId(value: unknown): GeneratedIconSetId | null;
+export declare function parseGeneratedIconAssetId(value: unknown): GeneratedIconAssetId | null;
+export declare function parseSiteIconStyleGuideVersionId(value: unknown): SiteIconStyleGuideVersionId | null;
+export declare function parseApprovedIconExampleSetId(value: unknown): ApprovedIconExampleSetId | null;

package/dist/_dts/blocks/src/system/icons/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cta';
+export * from './ids';
+export * from './presets';
+export * from './semantic';
+export * from './registry';
+export * from './value';

package/dist/_dts/blocks/src/system/icons/presets.d.ts

@@ -0,0 +1,4 @@
+export declare const ICON_PICKER_PRESETS: readonly ["cta", "feature"];
+export type IconPickerPreset = (typeof ICON_PICKER_PRESETS)[number];
+export declare function isIconPickerPreset(value: unknown): value is IconPickerPreset;
+export declare function resolveIconPickerPreset(value: unknown): IconPickerPreset;

package/dist/_dts/blocks/src/system/icons/registry.d.ts

@@ -0,0 +1,18 @@
+import type { LucideIcon } from 'lucide-react';
+import { type CtaIconName } from './cta';
+import { type SemanticIconId } from './semantic';
+import { type IconPickerPreset } from './presets';
+export type IconName = CtaIconName | SemanticIconId;
+export type IconIdForPreset<Preset extends IconPickerPreset> = Preset extends 'cta' ? CtaIconName : Preset extends 'feature' ? SemanticIconId : never;
+export type IconPickerOption<Preset extends IconPickerPreset = IconPickerPreset> = {
+    id: IconIdForPreset<Preset>;
+    label: string;
+    searchText: string;
+    preset: Preset;
+};
+export declare function getIconPickerOptionsForPreset(preset: 'cta'): readonly IconPickerOption<'cta'>[];
+export declare function getIconPickerOptionsForPreset(preset: 'feature'): readonly IconPickerOption<'feature'>[];
+export declare function getIconPickerOptionsForPreset(preset: IconPickerPreset): readonly IconPickerOption[];
+export declare function getIconPickerOptionsForUnknownPreset(value: unknown): readonly IconPickerOption[];
+export declare function isKnownIconName(value: unknown): value is IconName;
+export declare function getIconComponent(name: unknown): LucideIcon | null;

package/dist/_dts/blocks/src/system/icons/semantic.d.ts

@@ -0,0 +1,239 @@
+import type { LucideIcon } from 'lucide-react';
+import type { IconPickerPreset } from './presets';
+export declare const ICON_DOMAINS: readonly ["wellbeing", "coaching", "community", "education", "commerce", "events", "services", "hospitality", "creative", "technology"];
+export type IconDomain = (typeof ICON_DOMAINS)[number];
+export declare const ICON_TONES: readonly ["warm", "human", "calm", "trustworthy", "practical", "playful", "premium"];
+export type IconTone = (typeof ICON_TONES)[number];
+export declare const SEMANTIC_ICON_IDS: readonly ["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"];
+export type SemanticIconId = (typeof SEMANTIC_ICON_IDS)[number];
+export type SemanticIconDefinition = {
+    id: SemanticIconId;
+    label: string;
+    tags: readonly string[];
+    domains: readonly IconDomain[];
+    tone: readonly IconTone[];
+    presets: readonly IconPickerPreset[];
+};
+export declare const SEMANTIC_ICON_COMPONENTS: Record<SemanticIconId, LucideIcon>;
+export declare const SEMANTIC_ICON_DEFINITIONS: readonly [{
+    readonly id: "protection-trust";
+    readonly label: "Protection and trust";
+    readonly tags: readonly ["safe", "safety", "security", "trust", "privacy", "confidence"];
+    readonly domains: readonly ["wellbeing", "services", "technology"];
+    readonly tone: readonly ["trustworthy", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "confidentiality";
+    readonly label: "Confidentiality";
+    readonly tags: readonly ["confidential", "privacy", "secure", "protected", "private"];
+    readonly domains: readonly ["wellbeing", "coaching", "services", "technology"];
+    readonly tone: readonly ["trustworthy", "calm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "care-support";
+    readonly label: "Care and support";
+    readonly tags: readonly ["care", "support", "therapy", "kindness", "help", "compassion"];
+    readonly domains: readonly ["wellbeing", "coaching", "community"];
+    readonly tone: readonly ["warm", "human"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "partnership";
+    readonly label: "Partnership";
+    readonly tags: readonly ["partnership", "together", "support", "relationship", "collaboration"];
+    readonly domains: readonly ["coaching", "community", "services"];
+    readonly tone: readonly ["warm", "human", "trustworthy"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "warmth";
+    readonly label: "Warmth";
+    readonly tags: readonly ["heart", "warmth", "care", "love", "wellbeing", "personal"];
+    readonly domains: readonly ["wellbeing", "community", "hospitality"];
+    readonly tone: readonly ["warm", "human"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "community";
+    readonly label: "Community";
+    readonly tags: readonly ["community", "group", "people", "team", "members", "belonging"];
+    readonly domains: readonly ["community", "education", "events"];
+    readonly tone: readonly ["human", "warm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "personal-guidance";
+    readonly label: "Personal guidance";
+    readonly tags: readonly ["guidance", "personal", "coach", "expert", "one to one", "trusted"];
+    readonly domains: readonly ["coaching", "services", "education"];
+    readonly tone: readonly ["trustworthy", "human"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "conversation";
+    readonly label: "Conversation";
+    readonly tags: readonly ["conversation", "talk", "chat", "communication", "support"];
+    readonly domains: readonly ["coaching", "community", "services"];
+    readonly tone: readonly ["human", "warm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "friendly-welcome";
+    readonly label: "Friendly welcome";
+    readonly tags: readonly ["friendly", "welcome", "positive", "happy", "approachable"];
+    readonly domains: readonly ["hospitality", "community", "services"];
+    readonly tone: readonly ["warm", "playful", "human"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "insight-learning";
+    readonly label: "Insight and learning";
+    readonly tags: readonly ["mind", "insight", "learning", "clarity", "thinking", "therapy"];
+    readonly domains: readonly ["wellbeing", "coaching", "education"];
+    readonly tone: readonly ["calm", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "natural-wellbeing";
+    readonly label: "Natural wellbeing";
+    readonly tags: readonly ["natural", "wellbeing", "growth", "eco", "calm", "organic"];
+    readonly domains: readonly ["wellbeing", "hospitality", "creative"];
+    readonly tone: readonly ["calm", "warm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "growth";
+    readonly label: "Growth";
+    readonly tags: readonly ["growth", "new", "progress", "development", "nurture"];
+    readonly domains: readonly ["wellbeing", "coaching", "education", "community"];
+    readonly tone: readonly ["warm", "calm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "gentle-care";
+    readonly label: "Gentle care";
+    readonly tags: readonly ["gentle", "soft", "care", "wellbeing", "beauty", "calm"];
+    readonly domains: readonly ["wellbeing", "creative", "hospitality"];
+    readonly tone: readonly ["warm", "calm", "premium"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "special-touch";
+    readonly label: "Special touch";
+    readonly tags: readonly ["special", "sparkle", "magic", "polish", "delight", "creative"];
+    readonly domains: readonly ["creative", "commerce", "hospitality"];
+    readonly tone: readonly ["playful", "premium"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "ideas";
+    readonly label: "Ideas";
+    readonly tags: readonly ["idea", "innovation", "clarity", "creative", "strategy"];
+    readonly domains: readonly ["coaching", "education", "creative", "technology"];
+    readonly tone: readonly ["practical", "playful"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "direction";
+    readonly label: "Direction";
+    readonly tags: readonly ["direction", "navigation", "path", "journey", "guidance"];
+    readonly domains: readonly ["coaching", "education", "services"];
+    readonly tone: readonly ["trustworthy", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "focus";
+    readonly label: "Focus";
+    readonly tags: readonly ["focus", "goal", "outcome", "aim", "strategy"];
+    readonly domains: readonly ["coaching", "services", "technology"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "quality";
+    readonly label: "Quality";
+    readonly tags: readonly ["quality", "award", "standard", "achievement", "premium"];
+    readonly domains: readonly ["services", "education", "commerce"];
+    readonly tone: readonly ["premium", "trustworthy"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "highlight";
+    readonly label: "Highlight";
+    readonly tags: readonly ["highlight", "featured", "favorite", "quality", "special"];
+    readonly domains: readonly ["creative", "commerce", "services"];
+    readonly tone: readonly ["playful", "premium"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "verified-quality";
+    readonly label: "Verified quality";
+    readonly tags: readonly ["verified", "quality", "approved", "trusted", "check"];
+    readonly domains: readonly ["services", "commerce", "education"];
+    readonly tone: readonly ["trustworthy", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "learning";
+    readonly label: "Learning";
+    readonly tags: readonly ["learning", "book", "course", "knowledge", "education"];
+    readonly domains: readonly ["education", "coaching", "community"];
+    readonly tone: readonly ["calm", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "training";
+    readonly label: "Training";
+    readonly tags: readonly ["training", "course", "qualification", "school", "education"];
+    readonly domains: readonly ["education", "coaching"];
+    readonly tone: readonly ["trustworthy", "practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "programmes-dates";
+    readonly label: "Programmes and dates";
+    readonly tags: readonly ["calendar", "dates", "schedule", "events", "programme", "classes"];
+    readonly domains: readonly ["events", "education", "community"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "place";
+    readonly label: "Place";
+    readonly tags: readonly ["place", "location", "local", "venue", "destination"];
+    readonly domains: readonly ["events", "hospitality", "services"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "products";
+    readonly label: "Products";
+    readonly tags: readonly ["products", "shop", "store", "retail", "commerce"];
+    readonly domains: readonly ["commerce"];
+    readonly tone: readonly ["practical", "premium"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "packages";
+    readonly label: "Packages";
+    readonly tags: readonly ["package", "bundle", "delivery", "offer", "product"];
+    readonly domains: readonly ["commerce", "services"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "time";
+    readonly label: "Time";
+    readonly tags: readonly ["time", "duration", "schedule", "availability", "appointment"];
+    readonly domains: readonly ["events", "services", "wellbeing"];
+    readonly tone: readonly ["practical", "calm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "practical-service";
+    readonly label: "Practical service";
+    readonly tags: readonly ["service", "repair", "setup", "practical", "tools", "support"];
+    readonly domains: readonly ["services", "technology"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "at-home";
+    readonly label: "At home";
+    readonly tags: readonly ["home", "domestic", "comfort", "local", "space"];
+    readonly domains: readonly ["hospitality", "services", "community"];
+    readonly tone: readonly ["warm", "calm"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "worldwide";
+    readonly label: "Worldwide";
+    readonly tags: readonly ["global", "online", "worldwide", "remote", "international"];
+    readonly domains: readonly ["technology", "education", "services"];
+    readonly tone: readonly ["practical"];
+    readonly presets: readonly ["feature"];
+}, {
+    readonly id: "professional-service";
+    readonly label: "Professional service";
+    readonly tags: readonly ["business", "professional", "consulting", "service", "work"];
+    readonly domains: readonly ["services", "technology", "coaching"];
+    readonly tone: readonly ["practical", "trustworthy"];
+    readonly presets: readonly ["feature"];
+}];
+export type SemanticIconOption = Pick<SemanticIconDefinition, 'id' | 'label'>;
+export declare const SEMANTIC_ICON_OPTIONS: SemanticIconOption[];
+export declare function isSemanticIconId(value: unknown): value is SemanticIconId;
+export declare function getSemanticIconComponent(name: unknown): LucideIcon | null;

package/dist/_dts/blocks/src/system/icons/value.d.ts

@@ -0,0 +1,94 @@
+import type { Brand } from '../../../../core/src/index';
+import { type GeneratedIconAssetId, type GeneratedIconSetId, type SiteIconStyleGuideVersionId } from './ids';
+import type { SemanticIconId } from './semantic';
+export type NoBlockIconValue = {
+    kind: 'none';
+};
+export type SemanticBlockIconValue = {
+    kind: 'semantic';
+    iconId: SemanticIconId;
+};
+export type GeneratedBlockIconValue = {
+    kind: 'generated';
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: SiteIconStyleGuideVersionId;
+};
+export type BlockIconValue = NoBlockIconValue | SemanticBlockIconValue | GeneratedBlockIconValue;
+export declare const NO_BLOCK_ICON_VALUE: NoBlockIconValue;
+export type GeneratedBlockIconAssetSrc = Brand<string, 'GeneratedBlockIconAssetSrc'>;
+export type GeneratedBlockIconRenderAssetInput = Readonly<{
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+    src: string;
+    width?: number;
+    height?: number;
+}>;
+export type GeneratedBlockIconRenderAsset = Readonly<{
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+    src: GeneratedBlockIconAssetSrc;
+    width?: number;
+    height?: number;
+}>;
+export type GeneratedBlockIconRenderAssetLookup = ReadonlyMap<string, GeneratedBlockIconRenderAsset>;
+export type GeneratedBlockIconRenderAssetLookupBuildResult = Readonly<{
+    kind: 'ok';
+    lookup: GeneratedBlockIconRenderAssetLookup;
+}> | Readonly<{
+    kind: 'duplicate_asset';
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+}> | Readonly<{
+    kind: 'invalid_src';
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+    src: string;
+}>;
+export type GeneratedBlockIconRenderAssetLookupUnknownBuildResult = GeneratedBlockIconRenderAssetLookupBuildResult | Readonly<{
+    kind: 'invalid_asset_list';
+}> | Readonly<{
+    kind: 'invalid_asset_entry';
+    index: number;
+    reason: 'not_object' | 'invalid_set_id' | 'invalid_asset_id' | 'invalid_src';
+}>;
+export type ResolvedBlockIconRenderValue = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'semantic';
+    iconId: SemanticIconId;
+}> | Readonly<{
+    kind: 'generated_asset';
+    asset: GeneratedBlockIconRenderAsset;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: SiteIconStyleGuideVersionId;
+}> | Readonly<{
+    kind: 'generated_fallback';
+    setId: GeneratedIconSetId;
+    assetId: GeneratedIconAssetId;
+    semanticFallbackIconId: SemanticIconId;
+    styleGuideVersionId: SiteIconStyleGuideVersionId;
+    reason: 'asset_unavailable';
+}>;
+export type GeneratedBlockIconStyleState = Readonly<{
+    kind: 'not_generated';
+}> | Readonly<{
+    kind: 'invalid_generated';
+}> | Readonly<{
+    kind: 'current';
+    styleGuideVersionId: SiteIconStyleGuideVersionId;
+}> | Readonly<{
+    kind: 'stale';
+    previousStyleGuideVersionId: SiteIconStyleGuideVersionId;
+    currentStyleGuideVersionId: SiteIconStyleGuideVersionId;
+}>;
+export declare function parseBlockIconValue(value: unknown): BlockIconValue;
+export declare function getBlockIconSemanticFallbackId(value: unknown): SemanticIconId | null;
+export declare function hasRenderableBlockIcon(value: unknown): boolean;
+export declare function parseGeneratedBlockIconAssetSrc(value: unknown): GeneratedBlockIconAssetSrc | null;
+export declare function buildGeneratedBlockIconRenderAssetLookup(assets: readonly GeneratedBlockIconRenderAssetInput[]): GeneratedBlockIconRenderAssetLookupBuildResult;
+export declare function buildGeneratedBlockIconRenderAssetLookupFromUnknown(value: unknown): GeneratedBlockIconRenderAssetLookupUnknownBuildResult;
+export declare function resolveBlockIconRenderValue(value: unknown, generatedAssets?: GeneratedBlockIconRenderAssetLookup): ResolvedBlockIconRenderValue;
+export declare function getGeneratedBlockIconStyleState(value: unknown, currentStyleGuideVersionId: SiteIconStyleGuideVersionId): GeneratedBlockIconStyleState;
+export declare function isGeneratedBlockIconStale(value: unknown, currentStyleGuideVersionId: SiteIconStyleGuideVersionId): boolean;

package/dist/_dts/blocks/src/system/index.d.ts

@@ -8,6 +8,7 @@ export * from "./blocks";
 export * from "./componentFactory";
 export * from "./designCapabilities";
 export * from "./fragments";
+export * from "./icons";
 export * from "./layout";
 export * from "./defineBlock";
 export { SYSTEM_BLOCK_KINDS, type CustomBlockKind } from "./constants/blockKinds";

package/dist/_dts/blocks/src/system/manifest/fieldValidation/index.d.ts

@@ -94,7 +94,10 @@ type LinkObjectConstraint = Readonly<{
 type ReferenceTextConstraint = Readonly<{
     kind: "referenceText";
 }>;
-type StringConstraint = RequiredConstraint | TextTypeConstraint | MaxLengthConstraint | EmailFormatConstraint | PhoneFormatConstraint | PatternFormatConstraint | UrlFormatConstraint | DateFormatConstraint | TimeFormatConstraint | DateTimeFormatConstraint | SlugFormatConstraint | ReferenceTextConstraint;
+type BlockIconValueConstraint = Readonly<{
+    kind: "blockIconValue";
+}>;
+type StringConstraint = RequiredConstraint | TextTypeConstraint | MaxLengthConstraint | EmailFormatConstraint | PhoneFormatConstraint | PatternFormatConstraint | UrlFormatConstraint | DateFormatConstraint | TimeFormatConstraint | DateTimeFormatConstraint | SlugFormatConstraint | ReferenceTextConstraint | BlockIconValueConstraint;
 type NumberConstraint = RequiredConstraint | NumberTypeConstraint | NumberMinConstraint | NumberMaxConstraint;
 type SelectConstraint = RequiredConstraint | SelectOptionConstraint;
 type ArrayConstraint = RequiredConstraint | ArrayTypeConstraint | MinItemsConstraint | MaxItemsConstraint;