@wix/web5-core 1.63.5 → 1.63.7

package/dist/cjs/component/types.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/component/types.ts"],"sourcesContent":["import type { FC } from 'react';\nimport type { Callout } from '../types/callout';\n\n/** Props extracted from markdown (base layer). */\nexport interface BaseCompProps {}\nexport interface SlotCompProps extends BaseCompProps {\n  callout?: Callout;\n}\n\nexport interface SectionCompProps extends BaseCompProps {\n  callout?: Callout;\n}\n\n/** Section props with a slot. TSlot enforces which slot component this section accepts. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SectionCompPropsWithSlot<TSlot extends FC<any> = FC<any>>\n  extends SectionCompProps {\n  slot?: TSlot;\n}\n\n// ----------------------\n// Base Components\n// ----------------------\n\nexport interface TextCompProps extends BaseCompProps {\n  content: string;\n  variant?: 'h1' | 'h2' | 'body' | 'caption';\n}\n\nexport interface ButtonCompProps extends BaseCompProps {\n  label: string;\n  variant?: 'primary' | 'secondary' | 'ghost';\n  onClick?: string;\n}\n\nexport interface ImageCompProps extends BaseCompProps {\n  src: string;\n  alt: string;\n  ratio?: '16:9' | '4:3' | '1:1' | '9:16' | '3:4';\n}\n\nexport interface BadgeCompProps extends BaseCompProps {\n  label: string;\n  color?: 'primary' | 'secondary' | 'success' | 'warning' | 'error';\n}\n\n// ----------------------\n// Hero Button (aligned to HeroSection1Button)\n// ----------------------\n\nexport interface HeroButton {\n  id: string;\n  text: string;\n  variant?: 'primary' | 'secondary';\n  onClick?: string;\n}\n\n// ----------------------\n// Slot Components\n// ----------------------\n\nexport interface KpiItemCompProps extends SlotCompProps {\n  title: string;\n  description: string;\n  icon?: string;\n}\n\n/** Feature item — aligned to web50-server-ui Feature interface */\nexport interface FeatureItemCompProps extends SlotCompProps {\n  title?: string;\n  description?: string;\n  icon?: string;\n}\n\n/** Feature card — aligned to web50-server-ui FeatureCard */\nexport interface FeatureCardCompProps extends SlotCompProps {\n  title: string;\n  description: string;\n  imageUrl?: string;\n  imageFromText?: boolean;\n  linkText?: string;\n  linkHref?: string;\n  callout?: Callout;\n}\n\n/** Resolved entity data (populated at runtime via useResolveGenericEntityData) */\nexport interface EntityItemData {\n  url: string;\n  title: string;\n  type: string;\n  description?: string;\n  excerpt?: string;\n  imageUrl?: string;\n  date?: string;\n  publishDate?: string;\n  author?: string;\n  cmsItemId?: string;\n  usage?: number;\n  tags?: string[];\n  /** Product vendor / brand name (e.g. \"HOKA\") */\n  vendor?: string;\n  /** Formatted price string (e.g. \"542.00 NIS\") */\n  price?: string;\n  /** Secondary product image URL — shown on hover */\n  secondaryImageUrl?: string;\n  /** Available sizes for the product */\n  sizes?: string[];\n  /** Original price before discount (formatted, e.g. \"494.00 NIS\") — shown with strikethrough */\n  compareAtPrice?: string;\n  /** Discount percentage (e.g. \"30% OFF\") */\n  discountPercent?: string;\n  /** Product variants with IDs and availability — used for add-to-cart and size display */\n  variants?: {\n    label: string;\n    variantId: string;\n    available: boolean;\n    selectedOptions?: { name: string; value: string }[];\n    price?: string;\n    compareAtPrice?: string;\n  }[];\n  /** All product image URLs (not just featured + secondary) */\n  allImages?: string[];\n  /** Product option groups (e.g. Size, Color) with their available values */\n  options?: { name: string; values: string[] }[];\n}\n\n/** Single entity item within an entity section */\nexport interface EntityItem {\n  entityId: string;\n  linkText?: string;\n  entityType: string;\n  entityUrl: string;\n  description?: string;\n  imageUrl?: string;\n  /** Per-item callout from a blockquote inside the list item */\n  callout?: Callout;\n  /** Resolved at runtime via useResolveGenericEntityData hook; not produced by parse() */\n  data?: EntityItemData;\n}\n\n// ---------------------------------------------------------------------------\n// Deprecated aliases — kept for seed-components compilation\n// ---------------------------------------------------------------------------\n/** @deprecated Use EntityItemData */\nexport type GenericEntityData = EntityItemData;\n/** @deprecated Use EntityItemData */\nexport type SolutionEntityData = EntityItemData;\n/** @deprecated Use EntityItemData */\nexport type BlogEntityData = EntityItemData;\n/** @deprecated Use EntityItem */\nexport type GenericEntityCompProps = EntityItem;\n\n/** Comparison row — aligned to web50-server-ui ComparisonRow */\nexport interface ComparisonRow {\n  feature: string;\n  iconHint?: string;\n  values: (boolean | string)[];\n}\n\nexport interface ComparisonColumn {\n  label: string;\n  href?: string;\n  entityId?: string;\n  entityType?: string;\n}\n\n/** @deprecated Use Callout from types/callout instead */\nexport interface AiNarrativeCompProps extends SlotCompProps {\n  content: string;\n}\n\n// ----------------------\n// Section Components\n// ----------------------\n\n/** Hero — aligned to HeroSection1Props */\nexport interface HeroCompProps extends SectionCompProps {\n  headline: string;\n  badge?: string | { text: string; showIndicator?: boolean };\n  content?: string;\n  buttons?: HeroButton[];\n  image?: string;\n  trailingList?: string;\n  leadingQuote?: string;\n}\n\n/**\n * Entity hero — a hero section whose body carries one or more web5 entity\n * links (`web5://entity/...`). Shares the hero framing fields with\n * {@link HeroCompProps} but, instead of CTA buttons, surfaces the entities as\n * resolvable {@link EntityItem}s for rich rendering.\n */\nexport interface HeroEntityCompProps extends SectionCompProps {\n  headline: string;\n  badge?: string | { text: string; showIndicator?: boolean };\n  content?: string;\n  image?: string;\n  leadingQuote?: string;\n  items: EntityItem[];\n}\n\n/** KPI — aligned to KpiSectionProps */\nexport interface KpiCompProps\n  extends SectionCompPropsWithSlot<KpiItemComponent> {\n  title: string;\n  items: KpiItemCompProps[];\n}\n\n/** Feature cards — aligned to FeatureCardsSectionProps */\nexport interface FeatureCardsCompProps extends SectionCompProps {\n  cards: FeatureCardCompProps[];\n}\n\n/** Unified entity section — replaces EntityCompProps, SolutionEntityCompProps, BlogEntityCompProps */\nexport interface EntityCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  items: EntityItem[];\n}\n\n/** Comparison — aligned to ComparisonSection1Props */\nexport interface ComparisonCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  columnLabels: string[];\n  columns?: ComparisonColumn[];\n  rows: ComparisonRow[];\n  featureColumnLabel?: string;\n  ctaText?: string;\n  ctaHref?: string;\n}\n\n/** General text — aligned to GeneralTextSectionProps (used by Fallback) */\nexport interface GeneralTextCompProps extends SectionCompProps {\n  markdown: string;\n}\n\n/** Callout — aligned to CalloutSectionProps */\nexport interface CalloutCompProps extends SectionCompProps {\n  callouts: Callout[];\n  title?: string;\n  relatedLinks?: { text: string; url: string }[];\n}\n\n/** Next steps — aligned to NextStepsSectionProps */\nexport interface NextStepsCompProps extends SectionCompProps {\n  title: string;\n  body?: string;\n  /**\n   * True when the chips are already rendered inline inside `body`. Renderers\n   * must show `body` alone in that case — listing `steps` as well repeats every\n   * chip. `steps` stays populated either way; it is the machine-readable chip\n   * list (the scroll chips under the answer are built from it).\n   */\n  chipsInlineInBody?: boolean;\n  backgroundImage?: string;\n  steps: { content: string; iconHint?: string }[];\n}\n\n/** Feature section 9+ — aligned to FeatureSection9PlusProps */\nexport interface FeatureSection9PlusCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  features: { title?: string; description: string; iconHint?: string }[];\n}\n\n/** List items section — title + a list of feature items. */\nexport interface ListItemsSectionCompProps extends SectionCompProps {\n  title: string;\n  features: { title?: string; description: string }[];\n}\n\nexport type ListItemsSectionComponent = FC<ListItemsSectionCompProps>;\n\n/** Error — aligned to ErrorSection */\nexport interface ErrorCompProps extends SectionCompProps {\n  type: import('../errors/conversationErrorTypes').ConversationErrorType;\n}\n\n/** Skip/HTML/Search — null-component parsers */\nexport interface NullCompProps extends SectionCompProps {}\n\n/** @deprecated Use EntityCompProps */\nexport type SolutionEntityCompProps = EntityCompProps;\n/** @deprecated Use EntityCompProps */\nexport type BlogEntityCompProps = EntityCompProps;\n\n/** CTA Banner — dark purple gradient card with headline, description, and pill link buttons */\nexport interface CtaBannerCompProps extends SectionCompProps {\n  headline: string;\n  description?: string;\n  links: { text: string; href: string }[];\n  /** Contextual background image — resolved from allowed keywords during parse() */\n  imageUrl?: string;\n  imageFromText?: boolean;\n}\n\nexport type CtaBannerSectionComponent = FC<CtaBannerCompProps>;\n\n/** Text block — heading + body with an optional pullquote callout on the side */\nexport interface TextBlockCompProps extends SectionCompProps {\n  title: string;\n  description: string;\n}\n\n/** Personalized narrative — standalone section with no parse() definition */\nexport interface PersonalizedNarrativeCompProps extends SectionCompProps {\n  title: string;\n  content?: string;\n}\n\n// --------------------------------\n// Types of component - all components\n// --------------------------------\n\nexport type Component = BaseComponent | SlotComponent | SectionComponent;\n\nexport type BaseComponent = FC<BaseCompProps>;\nexport type SlotComponent = FC<SlotCompProps>;\nexport type SectionComponent = FC<SectionCompProps>;\n\n// Base Components\nexport type TextComponent = FC<TextCompProps>;\nexport type ButtonComponent = FC<ButtonCompProps>;\nexport type ImageComponent = FC<ImageCompProps>;\nexport type BadgeComponent = FC<BadgeCompProps>;\n\n// Slot Components\nexport type KpiItemComponent = FC<KpiItemCompProps>;\nexport type FeatureItemComponent = FC<FeatureItemCompProps>;\nexport type FeatureCardComponent = FC<FeatureCardCompProps>;\n/** @deprecated Use FC<EntityItem> */\nexport type GenericEntityComponent = FC<EntityItem>;\nexport type AiNarrativeComponent = FC<AiNarrativeCompProps>;\n\n// Section Components\nexport type ComparisonSectionComponent = FC<ComparisonCompProps>;\nexport type GeneralTextSectionComponent = FC<GeneralTextCompProps>;\nexport type TextBlockSectionComponent = FC<TextBlockCompProps>;\nexport type HeroSectionComponent = FC<HeroCompProps>;\nexport type HeroEntitySectionComponent = FC<HeroEntityCompProps>;\n\n// section components with slots\nexport type KpiSectionComponent = FC<KpiCompProps>;\nexport type FeatureCardsSectionComponent = FC<FeatureCardsCompProps>;\nexport type EntitySectionComponent = FC<EntityCompProps>;\n\n// New section component types for Phase 4\nexport type CalloutSectionComponent = FC<CalloutCompProps>;\nexport type NextStepsSectionComponent = FC<NextStepsCompProps>;\nexport type FeatureSection9PlusSectionComponent =\n  FC<FeatureSection9PlusCompProps>;\nexport type NullSectionComponent = FC<NullCompProps>;\nexport type ErrorSectionComponent = FC<ErrorCompProps>;\nexport type SolutionEntitySectionComponent = FC<SolutionEntityCompProps>;\nexport type BlogEntitySectionComponent = FC<BlogEntityCompProps>;\nexport type PersonalizedNarrativeSectionComponent =\n  FC<PersonalizedNarrativeCompProps>;\n\nexport type PropsOf<T> = T extends (props: infer P) => unknown ? P : never;\n\nexport interface SectionFixture<TProps> {\n  markdown: string;\n  expected: Partial<TProps>;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../src/component/types.ts"],"sourcesContent":["import type { FC } from 'react';\nimport type { Callout } from '../types/callout';\n\n/** Props extracted from markdown (base layer). */\nexport interface BaseCompProps {}\nexport interface SlotCompProps extends BaseCompProps {\n  callout?: Callout;\n}\n\nexport interface SectionCompProps extends BaseCompProps {\n  callout?: Callout;\n}\n\n/** Section props with a slot. TSlot enforces which slot component this section accepts. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SectionCompPropsWithSlot<TSlot extends FC<any> = FC<any>>\n  extends SectionCompProps {\n  slot?: TSlot;\n}\n\n// ----------------------\n// Base Components\n// ----------------------\n\nexport interface TextCompProps extends BaseCompProps {\n  content: string;\n  variant?: 'h1' | 'h2' | 'body' | 'caption';\n}\n\nexport interface ButtonCompProps extends BaseCompProps {\n  label: string;\n  variant?: 'primary' | 'secondary' | 'ghost';\n  onClick?: string;\n}\n\nexport interface ImageCompProps extends BaseCompProps {\n  src: string;\n  alt: string;\n  ratio?: '16:9' | '4:3' | '1:1' | '9:16' | '3:4';\n}\n\nexport interface BadgeCompProps extends BaseCompProps {\n  label: string;\n  color?: 'primary' | 'secondary' | 'success' | 'warning' | 'error';\n}\n\n// ----------------------\n// Hero Button (aligned to HeroSection1Button)\n// ----------------------\n\nexport interface HeroButton {\n  id: string;\n  text: string;\n  variant?: 'primary' | 'secondary';\n  onClick?: string;\n}\n\n// ----------------------\n// Slot Components\n// ----------------------\n\nexport interface KpiItemCompProps extends SlotCompProps {\n  title: string;\n  description: string;\n  icon?: string;\n}\n\n/** Feature item — aligned to web50-server-ui Feature interface */\nexport interface FeatureItemCompProps extends SlotCompProps {\n  title?: string;\n  description?: string;\n  icon?: string;\n}\n\n/** Feature card — aligned to web50-server-ui FeatureCard */\nexport interface FeatureCardCompProps extends SlotCompProps {\n  title: string;\n  description: string;\n  imageUrl?: string;\n  imageFromText?: boolean;\n  linkText?: string;\n  linkHref?: string;\n  callout?: Callout;\n}\n\n/** Resolved entity data (populated at runtime via useResolveGenericEntityData) */\nexport interface EntityItemData {\n  url: string;\n  title: string;\n  type: string;\n  description?: string;\n  excerpt?: string;\n  imageUrl?: string;\n  date?: string;\n  publishDate?: string;\n  author?: string;\n  cmsItemId?: string;\n  usage?: number;\n  tags?: string[];\n  /** Product vendor / brand name (e.g. \"HOKA\") */\n  vendor?: string;\n  /**\n   * The `{ name, value }` pairs of the one variant a search matched, in the\n   * store's own order. Present only when retrieval resolved the product down\n   * to a single variant. The names are the store's own, so read this by\n   * iterating it — never by looking a name up.\n   */\n  matchedOptions?: { name: string; value: string }[];\n  /**\n   * Id of the one variant a search matched — the same variant `imageUrl`,\n   * `url` and `matchedOptions` describe. Bare store id, no `gid://` prefix.\n   * A live enricher reads this to price that variant rather than the product.\n   */\n  variantId?: string;\n  /** Whether the matched variant is in stock, as of the last live fetch */\n  available?: boolean;\n  /** Formatted lowest price across the product's variants (e.g. \"$107.95\") */\n  priceMin?: string;\n  /** Formatted highest price across the product's variants */\n  priceMax?: string;\n  /** Formatted price string (e.g. \"542.00 NIS\") */\n  price?: string;\n  /** Secondary product image URL — shown on hover */\n  secondaryImageUrl?: string;\n  /** Available sizes for the product */\n  sizes?: string[];\n  /** Original price before discount (formatted, e.g. \"494.00 NIS\") — shown with strikethrough */\n  compareAtPrice?: string;\n  /** Discount percentage (e.g. \"30% OFF\") */\n  discountPercent?: string;\n  /** Product variants with IDs and availability — used for add-to-cart and size display */\n  variants?: {\n    label: string;\n    variantId: string;\n    available: boolean;\n    selectedOptions?: { name: string; value: string }[];\n    price?: string;\n    compareAtPrice?: string;\n  }[];\n  /** All product image URLs (not just featured + secondary) */\n  allImages?: string[];\n  /** Product option groups (e.g. Size, Color) with their available values */\n  options?: { name: string; values: string[] }[];\n}\n\n/** Single entity item within an entity section */\nexport interface EntityItem {\n  entityId: string;\n  linkText?: string;\n  entityType: string;\n  entityUrl: string;\n  description?: string;\n  imageUrl?: string;\n  /** Per-item callout from a blockquote inside the list item */\n  callout?: Callout;\n  /** Resolved at runtime via useResolveGenericEntityData hook; not produced by parse() */\n  data?: EntityItemData;\n}\n\n// ---------------------------------------------------------------------------\n// Deprecated aliases — kept for seed-components compilation\n// ---------------------------------------------------------------------------\n/** @deprecated Use EntityItemData */\nexport type GenericEntityData = EntityItemData;\n/** @deprecated Use EntityItemData */\nexport type SolutionEntityData = EntityItemData;\n/** @deprecated Use EntityItemData */\nexport type BlogEntityData = EntityItemData;\n/** @deprecated Use EntityItem */\nexport type GenericEntityCompProps = EntityItem;\n\n/** Comparison row — aligned to web50-server-ui ComparisonRow */\nexport interface ComparisonRow {\n  feature: string;\n  iconHint?: string;\n  values: (boolean | string)[];\n}\n\nexport interface ComparisonColumn {\n  label: string;\n  href?: string;\n  entityId?: string;\n  entityType?: string;\n}\n\n/** @deprecated Use Callout from types/callout instead */\nexport interface AiNarrativeCompProps extends SlotCompProps {\n  content: string;\n}\n\n// ----------------------\n// Section Components\n// ----------------------\n\n/** Hero — aligned to HeroSection1Props */\nexport interface HeroCompProps extends SectionCompProps {\n  headline: string;\n  badge?: string | { text: string; showIndicator?: boolean };\n  content?: string;\n  buttons?: HeroButton[];\n  image?: string;\n  trailingList?: string;\n  leadingQuote?: string;\n}\n\n/**\n * Entity hero — a hero section whose body carries one or more web5 entity\n * links (`web5://entity/...`). Shares the hero framing fields with\n * {@link HeroCompProps} but, instead of CTA buttons, surfaces the entities as\n * resolvable {@link EntityItem}s for rich rendering.\n */\nexport interface HeroEntityCompProps extends SectionCompProps {\n  headline: string;\n  badge?: string | { text: string; showIndicator?: boolean };\n  content?: string;\n  image?: string;\n  leadingQuote?: string;\n  items: EntityItem[];\n}\n\n/** KPI — aligned to KpiSectionProps */\nexport interface KpiCompProps\n  extends SectionCompPropsWithSlot<KpiItemComponent> {\n  title: string;\n  items: KpiItemCompProps[];\n}\n\n/** Feature cards — aligned to FeatureCardsSectionProps */\nexport interface FeatureCardsCompProps extends SectionCompProps {\n  cards: FeatureCardCompProps[];\n}\n\n/** Unified entity section — replaces EntityCompProps, SolutionEntityCompProps, BlogEntityCompProps */\nexport interface EntityCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  items: EntityItem[];\n}\n\n/** Comparison — aligned to ComparisonSection1Props */\nexport interface ComparisonCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  columnLabels: string[];\n  columns?: ComparisonColumn[];\n  rows: ComparisonRow[];\n  featureColumnLabel?: string;\n  ctaText?: string;\n  ctaHref?: string;\n}\n\n/** General text — aligned to GeneralTextSectionProps (used by Fallback) */\nexport interface GeneralTextCompProps extends SectionCompProps {\n  markdown: string;\n}\n\n/** Callout — aligned to CalloutSectionProps */\nexport interface CalloutCompProps extends SectionCompProps {\n  callouts: Callout[];\n  title?: string;\n  relatedLinks?: { text: string; url: string }[];\n}\n\n/** Next steps — aligned to NextStepsSectionProps */\nexport interface NextStepsCompProps extends SectionCompProps {\n  title: string;\n  body?: string;\n  /**\n   * True when the chips are already rendered inline inside `body`. Renderers\n   * must show `body` alone in that case — listing `steps` as well repeats every\n   * chip. `steps` stays populated either way; it is the machine-readable chip\n   * list (the scroll chips under the answer are built from it).\n   */\n  chipsInlineInBody?: boolean;\n  backgroundImage?: string;\n  steps: { content: string; iconHint?: string }[];\n}\n\n/** Feature section 9+ — aligned to FeatureSection9PlusProps */\nexport interface FeatureSection9PlusCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  features: { title?: string; description: string; iconHint?: string }[];\n}\n\n/** List items section — title + a list of feature items. */\nexport interface ListItemsSectionCompProps extends SectionCompProps {\n  title: string;\n  features: { title?: string; description: string }[];\n}\n\nexport type ListItemsSectionComponent = FC<ListItemsSectionCompProps>;\n\n/** Error — aligned to ErrorSection */\nexport interface ErrorCompProps extends SectionCompProps {\n  type: import('../errors/conversationErrorTypes').ConversationErrorType;\n}\n\n/** Skip/HTML/Search — null-component parsers */\nexport interface NullCompProps extends SectionCompProps {}\n\n/** @deprecated Use EntityCompProps */\nexport type SolutionEntityCompProps = EntityCompProps;\n/** @deprecated Use EntityCompProps */\nexport type BlogEntityCompProps = EntityCompProps;\n\n/** CTA Banner — dark purple gradient card with headline, description, and pill link buttons */\nexport interface CtaBannerCompProps extends SectionCompProps {\n  headline: string;\n  description?: string;\n  links: { text: string; href: string }[];\n  /** Contextual background image — resolved from allowed keywords during parse() */\n  imageUrl?: string;\n  imageFromText?: boolean;\n}\n\nexport type CtaBannerSectionComponent = FC<CtaBannerCompProps>;\n\n/** Text block — heading + body with an optional pullquote callout on the side */\nexport interface TextBlockCompProps extends SectionCompProps {\n  title: string;\n  description: string;\n}\n\n/** Personalized narrative — standalone section with no parse() definition */\nexport interface PersonalizedNarrativeCompProps extends SectionCompProps {\n  title: string;\n  content?: string;\n}\n\n// --------------------------------\n// Types of component - all components\n// --------------------------------\n\nexport type Component = BaseComponent | SlotComponent | SectionComponent;\n\nexport type BaseComponent = FC<BaseCompProps>;\nexport type SlotComponent = FC<SlotCompProps>;\nexport type SectionComponent = FC<SectionCompProps>;\n\n// Base Components\nexport type TextComponent = FC<TextCompProps>;\nexport type ButtonComponent = FC<ButtonCompProps>;\nexport type ImageComponent = FC<ImageCompProps>;\nexport type BadgeComponent = FC<BadgeCompProps>;\n\n// Slot Components\nexport type KpiItemComponent = FC<KpiItemCompProps>;\nexport type FeatureItemComponent = FC<FeatureItemCompProps>;\nexport type FeatureCardComponent = FC<FeatureCardCompProps>;\n/** @deprecated Use FC<EntityItem> */\nexport type GenericEntityComponent = FC<EntityItem>;\nexport type AiNarrativeComponent = FC<AiNarrativeCompProps>;\n\n// Section Components\nexport type ComparisonSectionComponent = FC<ComparisonCompProps>;\nexport type GeneralTextSectionComponent = FC<GeneralTextCompProps>;\nexport type TextBlockSectionComponent = FC<TextBlockCompProps>;\nexport type HeroSectionComponent = FC<HeroCompProps>;\nexport type HeroEntitySectionComponent = FC<HeroEntityCompProps>;\n\n// section components with slots\nexport type KpiSectionComponent = FC<KpiCompProps>;\nexport type FeatureCardsSectionComponent = FC<FeatureCardsCompProps>;\nexport type EntitySectionComponent = FC<EntityCompProps>;\n\n// New section component types for Phase 4\nexport type CalloutSectionComponent = FC<CalloutCompProps>;\nexport type NextStepsSectionComponent = FC<NextStepsCompProps>;\nexport type FeatureSection9PlusSectionComponent =\n  FC<FeatureSection9PlusCompProps>;\nexport type NullSectionComponent = FC<NullCompProps>;\nexport type ErrorSectionComponent = FC<ErrorCompProps>;\nexport type SolutionEntitySectionComponent = FC<SolutionEntityCompProps>;\nexport type BlogEntitySectionComponent = FC<BlogEntityCompProps>;\nexport type PersonalizedNarrativeSectionComponent =\n  FC<PersonalizedNarrativeCompProps>;\n\nexport type PropsOf<T> = T extends (props: infer P) => unknown ? P : never;\n\nexport interface SectionFixture<TProps> {\n  markdown: string;\n  expected: Partial<TProps>;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/entity/defaultExtractor.js

@@ -7,6 +7,7 @@ exports.transformToGenericEntityData = transformToGenericEntityData;
 exports.transformToSolutionEntityData = transformToSolutionEntityData;
 var _linkTypes = require("../types/link-types");
 var _entityLinkParser = require("../utils/entityLinkParser");
+var _matchedVariant = require("./matchedVariant");
 /**
  * Extract entity type and ID from a web5://entity/ URL.
  * Delegates to the central `parseWeb5Url` parser.
@@ -97,6 +98,12 @@ function transformToGenericEntityData(payloadItem, config) {
     const imgAlreadyAbsolute = payloadItem.img.startsWith('http');
     imageUrl = config.imageBaseUrl && !imgAlreadyAbsolute ? `${config.imageBaseUrl}${payloadItem.img}` : payloadItem.img;
   }
+
+  // A document that retrieval narrowed to one child arrives with that child's
+  // presentation fields already overlaid (`url`, `img`, `price`) plus the pairs
+  // that identify it and the span its parent covers. The overlay is done
+  // server-side; all that is left here is to shape those two for display.
+  const currency = (0, _matchedVariant.readCurrencyCode)(payloadItem.currency, payloadItem.priceCurrency);
   return {
     url: payloadItem.url,
     title: payloadItem.title,
@@ -104,6 +111,10 @@ function transformToGenericEntityData(payloadItem, config) {
     description: payloadItem.description,
     excerpt: payloadItem.excerpt,
     imageUrl,
+    matchedOptions: (0, _matchedVariant.toMatchedOptions)(payloadItem.options),
+    price: (0, _matchedVariant.formatPriceField)(payloadItem.price, currency),
+    priceMin: (0, _matchedVariant.formatPriceField)(payloadItem.priceMin, currency),
+    priceMax: (0, _matchedVariant.formatPriceField)(payloadItem.priceMax, currency),
     date: payloadItem.update_ts ? formatEntityDate(payloadItem.update_ts) : undefined,
     publishDate: publishTimestamp ? formatEntityDate(publishTimestamp) : undefined,
     author: payloadItem.author || payloadItem.authorName,

package/dist/cjs/entity/defaultExtractor.js.map

@@ -1 +1 @@
-{"version":3,"names":["_linkTypes","require","_entityLinkParser","extractEntityIdFromUrl","entityUrl","trimmedUrl","trim","isWeb5EntityUrl","parsed","parseWeb5Url","type","Web5UrlType","ENTITY","entityType","entityId","matchesUrl","payloadItem","config","id","urlValue","urlMatchProperty","pattern","urlMatchPattern","endsWith","includes","findEntityInPayload","payload","entityConfig","typeConfig","entityTypes","matchedItem","find","item","transformToSolutionEntityData","transformToGenericEntityData","formatEntityDate","timestamp","_parts$find","_parts$find2","_parts$find3","date","Date","isNaN","getTime","undefined","formatter","Intl","DateTimeFormat","day","month","timeZone","year","parts","formatToParts","part","value","transformToBlogPostEntityData","_payloadItem$labels","_payloadItem$tags","imageUrl","publishTimestamp","publishDate","published_at","img","imgAlreadyAbsolute","startsWith","imageBaseUrl","url","title","description","excerpt","update_ts","author","authorName","cmsItemId","cms_item_id","usage","tags","labels","length","defaultExtractor","exports"],"sources":["../../../src/entity/defaultExtractor.ts"],"sourcesContent":["import type { SolutionEntityData, BlogEntityData, EntityItemData } from '../component/types';\nimport type {\n  ApiPayloadItem,\n  EntityConfig,\n  EntityTypeConfig,\n} from '../types/entity';\nimport type { EntityExtractor } from './types';\nimport { Web5UrlType, isWeb5EntityUrl } from '../types/link-types';\nimport { parseWeb5Url } from '../utils/entityLinkParser';\n\n/**\n * Extract entity type and ID from a web5://entity/ URL.\n * Delegates to the central `parseWeb5Url` parser.\n */\nfunction extractEntityIdFromUrl(\n  entityUrl: string,\n): { entityType: string; entityId: string } | null {\n  const trimmedUrl = entityUrl?.trim();\n  if (!trimmedUrl || !isWeb5EntityUrl(trimmedUrl)) {\n    return null;\n  }\n  const parsed = parseWeb5Url(trimmedUrl);\n  if (parsed?.type !== Web5UrlType.ENTITY || !parsed.entityType || !parsed.entityId) {\n    return null;\n  }\n  return { entityType: parsed.entityType, entityId: parsed.entityId };\n}\n\nfunction matchesUrl(\n  payloadItem: ApiPayloadItem,\n  entityId: string,\n  config: EntityTypeConfig,\n): boolean {\n  // Entities resolve by `entityId` (the `<id>` in `web5://entity/<type>/<id>`).\n  // Accept a direct `id` match, then fall back to the configured url strategy.\n  if (payloadItem.id === entityId) {\n    return true;\n  }\n\n  const urlValue = payloadItem[config.urlMatchProperty as keyof ApiPayloadItem];\n\n  if (typeof urlValue !== 'string') {\n    return false;\n  }\n\n  const pattern = config.urlMatchPattern || 'endsWith';\n\n  switch (pattern) {\n    case 'endsWith':\n      return urlValue.endsWith(`/${entityId}`);\n    case 'contains':\n      return urlValue.includes(entityId);\n    case 'equals':\n      return urlValue === entityId;\n    default:\n      return urlValue.endsWith(`/${entityId}`);\n  }\n}\n\nfunction findEntityInPayload(\n  entityType: string,\n  entityId: string,\n  payload: ApiPayloadItem[],\n  entityConfig: EntityConfig,\n): ApiPayloadItem | null {\n  const typeConfig = entityConfig.entityTypes[entityType];\n\n  if (!typeConfig) {\n    return null;\n  }\n\n  // Resolution keys off `entityId` (not the type): find the payload item whose\n  // id/url matches, using the type's configured url strategy.\n  const matchedItem = payload.find((item) =>\n    matchesUrl(item, entityId, typeConfig),\n  );\n\n  return matchedItem || null;\n}\n\n/** @deprecated Use transformToGenericEntityData */\nexport function transformToSolutionEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): SolutionEntityData {\n  return transformToGenericEntityData(payloadItem, config);\n}\n\nfunction formatEntityDate(timestamp: string): string | undefined {\n  const date = new Date(timestamp);\n  if (isNaN(date.getTime())) {\n    return undefined;\n  }\n  const formatter = new Intl.DateTimeFormat('en-US', {\n    day: 'numeric',\n    month: 'short',\n    timeZone: 'Europe/Kiev',\n    year: 'numeric',\n  });\n  const parts = formatter.formatToParts(date);\n  const day = parts.find((part) => part.type === 'day')?.value;\n  const month = parts.find((part) => part.type === 'month')?.value;\n  const year = parts.find((part) => part.type === 'year')?.value;\n\n  if (!day || !month || !year) {\n    return undefined;\n  }\n\n  return `${day} ${month} ${year}`;\n}\n\n/** @deprecated Use transformToGenericEntityData */\nexport function transformToBlogPostEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): BlogEntityData {\n  return transformToGenericEntityData(payloadItem, config);\n}\n\nexport function transformToGenericEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): EntityItemData {\n  let imageUrl: string | undefined;\n  const publishTimestamp = payloadItem.publishDate || payloadItem.published_at;\n\n  if (payloadItem.img) {\n    const imgAlreadyAbsolute = payloadItem.img.startsWith('http');\n    imageUrl = config.imageBaseUrl && !imgAlreadyAbsolute\n      ? `${config.imageBaseUrl}${payloadItem.img}`\n      : payloadItem.img;\n  }\n\n  return {\n    url: payloadItem.url,\n    title: payloadItem.title,\n    type: payloadItem.type,\n    description: payloadItem.description,\n    excerpt: payloadItem.excerpt,\n    imageUrl,\n    date: payloadItem.update_ts\n      ? formatEntityDate(payloadItem.update_ts)\n      : undefined,\n    publishDate: publishTimestamp\n      ? formatEntityDate(publishTimestamp)\n      : undefined,\n    author: payloadItem.author || payloadItem.authorName,\n    cmsItemId: payloadItem.cms_item_id,\n    usage: payloadItem.usage,\n    tags: payloadItem.labels?.length\n      ? payloadItem.labels\n      : payloadItem.tags?.length\n      ? payloadItem.tags\n      : undefined,\n  };\n}\n\n/**\n * Default entity extractor - config-driven extraction for any client.\n * Uses entityConfig from client JSON to resolve web5://entity/ URLs against API payload.\n */\nexport const defaultExtractor: EntityExtractor = {\n  extractEntityIdFromUrl,\n  findEntityInPayload,\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_linkTypes","require","_entityLinkParser","_matchedVariant","extractEntityIdFromUrl","entityUrl","trimmedUrl","trim","isWeb5EntityUrl","parsed","parseWeb5Url","type","Web5UrlType","ENTITY","entityType","entityId","matchesUrl","payloadItem","config","id","urlValue","urlMatchProperty","pattern","urlMatchPattern","endsWith","includes","findEntityInPayload","payload","entityConfig","typeConfig","entityTypes","matchedItem","find","item","transformToSolutionEntityData","transformToGenericEntityData","formatEntityDate","timestamp","_parts$find","_parts$find2","_parts$find3","date","Date","isNaN","getTime","undefined","formatter","Intl","DateTimeFormat","day","month","timeZone","year","parts","formatToParts","part","value","transformToBlogPostEntityData","_payloadItem$labels","_payloadItem$tags","imageUrl","publishTimestamp","publishDate","published_at","img","imgAlreadyAbsolute","startsWith","imageBaseUrl","currency","readCurrencyCode","priceCurrency","url","title","description","excerpt","matchedOptions","toMatchedOptions","options","price","formatPriceField","priceMin","priceMax","update_ts","author","authorName","cmsItemId","cms_item_id","usage","tags","labels","length","defaultExtractor","exports"],"sources":["../../../src/entity/defaultExtractor.ts"],"sourcesContent":["import type { SolutionEntityData, BlogEntityData, EntityItemData } from '../component/types';\nimport type {\n  ApiPayloadItem,\n  EntityConfig,\n  EntityTypeConfig,\n} from '../types/entity';\nimport type { EntityExtractor } from './types';\nimport { Web5UrlType, isWeb5EntityUrl } from '../types/link-types';\nimport { parseWeb5Url } from '../utils/entityLinkParser';\nimport {\n  formatPriceField,\n  readCurrencyCode,\n  toMatchedOptions,\n} from './matchedVariant';\n\n/**\n * Extract entity type and ID from a web5://entity/ URL.\n * Delegates to the central `parseWeb5Url` parser.\n */\nfunction extractEntityIdFromUrl(\n  entityUrl: string,\n): { entityType: string; entityId: string } | null {\n  const trimmedUrl = entityUrl?.trim();\n  if (!trimmedUrl || !isWeb5EntityUrl(trimmedUrl)) {\n    return null;\n  }\n  const parsed = parseWeb5Url(trimmedUrl);\n  if (parsed?.type !== Web5UrlType.ENTITY || !parsed.entityType || !parsed.entityId) {\n    return null;\n  }\n  return { entityType: parsed.entityType, entityId: parsed.entityId };\n}\n\nfunction matchesUrl(\n  payloadItem: ApiPayloadItem,\n  entityId: string,\n  config: EntityTypeConfig,\n): boolean {\n  // Entities resolve by `entityId` (the `<id>` in `web5://entity/<type>/<id>`).\n  // Accept a direct `id` match, then fall back to the configured url strategy.\n  if (payloadItem.id === entityId) {\n    return true;\n  }\n\n  const urlValue = payloadItem[config.urlMatchProperty as keyof ApiPayloadItem];\n\n  if (typeof urlValue !== 'string') {\n    return false;\n  }\n\n  const pattern = config.urlMatchPattern || 'endsWith';\n\n  switch (pattern) {\n    case 'endsWith':\n      return urlValue.endsWith(`/${entityId}`);\n    case 'contains':\n      return urlValue.includes(entityId);\n    case 'equals':\n      return urlValue === entityId;\n    default:\n      return urlValue.endsWith(`/${entityId}`);\n  }\n}\n\nfunction findEntityInPayload(\n  entityType: string,\n  entityId: string,\n  payload: ApiPayloadItem[],\n  entityConfig: EntityConfig,\n): ApiPayloadItem | null {\n  const typeConfig = entityConfig.entityTypes[entityType];\n\n  if (!typeConfig) {\n    return null;\n  }\n\n  // Resolution keys off `entityId` (not the type): find the payload item whose\n  // id/url matches, using the type's configured url strategy.\n  const matchedItem = payload.find((item) =>\n    matchesUrl(item, entityId, typeConfig),\n  );\n\n  return matchedItem || null;\n}\n\n/** @deprecated Use transformToGenericEntityData */\nexport function transformToSolutionEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): SolutionEntityData {\n  return transformToGenericEntityData(payloadItem, config);\n}\n\nfunction formatEntityDate(timestamp: string): string | undefined {\n  const date = new Date(timestamp);\n  if (isNaN(date.getTime())) {\n    return undefined;\n  }\n  const formatter = new Intl.DateTimeFormat('en-US', {\n    day: 'numeric',\n    month: 'short',\n    timeZone: 'Europe/Kiev',\n    year: 'numeric',\n  });\n  const parts = formatter.formatToParts(date);\n  const day = parts.find((part) => part.type === 'day')?.value;\n  const month = parts.find((part) => part.type === 'month')?.value;\n  const year = parts.find((part) => part.type === 'year')?.value;\n\n  if (!day || !month || !year) {\n    return undefined;\n  }\n\n  return `${day} ${month} ${year}`;\n}\n\n/** @deprecated Use transformToGenericEntityData */\nexport function transformToBlogPostEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): BlogEntityData {\n  return transformToGenericEntityData(payloadItem, config);\n}\n\nexport function transformToGenericEntityData(\n  payloadItem: ApiPayloadItem,\n  config: EntityTypeConfig,\n): EntityItemData {\n  let imageUrl: string | undefined;\n  const publishTimestamp = payloadItem.publishDate || payloadItem.published_at;\n\n  if (payloadItem.img) {\n    const imgAlreadyAbsolute = payloadItem.img.startsWith('http');\n    imageUrl = config.imageBaseUrl && !imgAlreadyAbsolute\n      ? `${config.imageBaseUrl}${payloadItem.img}`\n      : payloadItem.img;\n  }\n\n  // A document that retrieval narrowed to one child arrives with that child's\n  // presentation fields already overlaid (`url`, `img`, `price`) plus the pairs\n  // that identify it and the span its parent covers. The overlay is done\n  // server-side; all that is left here is to shape those two for display.\n  const currency = readCurrencyCode(\n    payloadItem.currency,\n    payloadItem.priceCurrency,\n  );\n\n  return {\n    url: payloadItem.url,\n    title: payloadItem.title,\n    type: payloadItem.type,\n    description: payloadItem.description,\n    excerpt: payloadItem.excerpt,\n    imageUrl,\n    matchedOptions: toMatchedOptions(payloadItem.options),\n    price: formatPriceField(payloadItem.price, currency),\n    priceMin: formatPriceField(payloadItem.priceMin, currency),\n    priceMax: formatPriceField(payloadItem.priceMax, currency),\n    date: payloadItem.update_ts\n      ? formatEntityDate(payloadItem.update_ts)\n      : undefined,\n    publishDate: publishTimestamp\n      ? formatEntityDate(publishTimestamp)\n      : undefined,\n    author: payloadItem.author || payloadItem.authorName,\n    cmsItemId: payloadItem.cms_item_id,\n    usage: payloadItem.usage,\n    tags: payloadItem.labels?.length\n      ? payloadItem.labels\n      : payloadItem.tags?.length\n      ? payloadItem.tags\n      : undefined,\n  };\n}\n\n/**\n * Default entity extractor - config-driven extraction for any client.\n * Uses entityConfig from client JSON to resolve web5://entity/ URLs against API payload.\n */\nexport const defaultExtractor: EntityExtractor = {\n  extractEntityIdFromUrl,\n  findEntityInPayload,\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/entity/index.js

@@ -1,11 +1,11 @@
 "use strict";
 
 exports.__esModule = true;
-exports.fetchEntityListData = exports.enrichEntitiesFromPayload = exports.LIST_ITEMS_ENDPOINT = void 0;
+exports.formatProductPriceLabel = exports.formatPriceField = exports.formatMoney = exports.fetchEntityListData = exports.enrichEntitiesFromPayload = exports.LIST_ITEMS_ENDPOINT = void 0;
 exports.getEntityExtractor = getEntityExtractor;
-exports.listEntityItems = void 0;
+exports.readCurrencyCode = exports.listEntityItems = void 0;
 exports.registerEntityExtractor = registerEntityExtractor;
-exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = void 0;
+exports.transformToSolutionEntityData = exports.transformToGenericEntityData = exports.transformToBlogPostEntityData = exports.toMatchedOptions = void 0;
 var _defaultExtractor = require("./defaultExtractor");
 exports.defaultExtractor = _defaultExtractor.defaultExtractor;
 exports.transformToSolutionEntityData = _defaultExtractor.transformToSolutionEntityData;
@@ -13,6 +13,12 @@ exports.transformToBlogPostEntityData = _defaultExtractor.transformToBlogPostEnt
 exports.transformToGenericEntityData = _defaultExtractor.transformToGenericEntityData;
 var _enrichEntitiesFromPayload = require("./enrichEntitiesFromPayload");
 exports.enrichEntitiesFromPayload = _enrichEntitiesFromPayload.enrichEntitiesFromPayload;
+var _matchedVariant = require("./matchedVariant");
+exports.toMatchedOptions = _matchedVariant.toMatchedOptions;
+exports.formatMoney = _matchedVariant.formatMoney;
+exports.readCurrencyCode = _matchedVariant.readCurrencyCode;
+exports.formatPriceField = _matchedVariant.formatPriceField;
+exports.formatProductPriceLabel = _matchedVariant.formatProductPriceLabel;
 var _fetchEntityListData = require("./fetchEntityListData");
 exports.fetchEntityListData = _fetchEntityListData.fetchEntityListData;
 var _listEntityItems = require("./listEntityItems");

package/dist/cjs/entity/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_defaultExtractor","require","exports","defaultExtractor","transformToSolutionEntityData","transformToBlogPostEntityData","transformToGenericEntityData","_enrichEntitiesFromPayload","enrichEntitiesFromPayload","_fetchEntityListData","fetchEntityListData","_listEntityItems","listEntityItems","LIST_ITEMS_ENDPOINT","extractorRegistry","getEntityExtractor","clientId","registerEntityExtractor","extractor"],"sources":["../../../src/entity/index.ts"],"sourcesContent":["import type { EntityExtractor } from './types';\nimport { defaultExtractor } from './defaultExtractor';\n\nexport {\n  defaultExtractor,\n  transformToSolutionEntityData,\n  transformToBlogPostEntityData,\n  transformToGenericEntityData,\n} from './defaultExtractor';\n\nexport { enrichEntitiesFromPayload } from './enrichEntitiesFromPayload';\nexport {\n  fetchEntityListData,\n  type FetchEntityListDataOptions,\n} from './fetchEntityListData';\nexport {\n  listEntityItems,\n  LIST_ITEMS_ENDPOINT,\n  type ListEntityItemsOptions,\n} from './listEntityItems';\n\nexport type { EntityExtractor } from './types';\n\n/**\n * Registry of client-specific entity extractors.\n * Only needed if a client requires custom extraction logic beyond the config-driven default.\n */\nconst extractorRegistry: Record<string, EntityExtractor> = {};\n\n/**\n * Get the entity extractor for a specific client.\n * The default extractor is config-driven and works for any client with entityConfig.\n */\nexport function getEntityExtractor(clientId?: string): EntityExtractor {\n  if (clientId && extractorRegistry[clientId]) {\n    return extractorRegistry[clientId];\n  }\n  return defaultExtractor;\n}\n\n/**\n * Register a custom entity extractor for a client\n * Useful for runtime registration or testing\n */\nexport function registerEntityExtractor(\n  clientId: string,\n  extractor: EntityExtractor,\n): void {\n  extractorRegistry[clientId] = extractor;\n}\n"],"mappings":";;;;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AAAsDC,OAAA,CAAAC,gBAAA,GAAAH,iBAAA,CAAAG,gBAAA;AAAAD,OAAA,CAAAE,6BAAA,GAAAJ,iBAAA,CAAAI,6BAAA;AAAAF,OAAA,CAAAG,6BAAA,GAAAL,iBAAA,CAAAK,6BAAA;AAAAH,OAAA,CAAAI,4BAAA,GAAAN,iBAAA,CAAAM,4BAAA;AAStD,IAAAC,0BAAA,GAAAN,OAAA;AAAwEC,OAAA,CAAAM,yBAAA,GAAAD,0BAAA,CAAAC,yBAAA;AACxE,IAAAC,oBAAA,GAAAR,OAAA;AAG+BC,OAAA,CAAAQ,mBAAA,GAAAD,oBAAA,CAAAC,mBAAA;AAC/B,IAAAC,gBAAA,GAAAV,OAAA;AAI2BC,OAAA,CAAAU,eAAA,GAAAD,gBAAA,CAAAC,eAAA;AAAAV,OAAA,CAAAW,mBAAA,GAAAF,gBAAA,CAAAE,mBAAA;AAI3B;AACA;AACA;AACA;AACA,MAAMC,iBAAkD,GAAG,CAAC,CAAC;;AAE7D;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,QAAiB,EAAmB;EACrE,IAAIA,QAAQ,IAAIF,iBAAiB,CAACE,QAAQ,CAAC,EAAE;IAC3C,OAAOF,iBAAiB,CAACE,QAAQ,CAAC;EACpC;EACA,OAAOb,kCAAgB;AACzB;;AAEA;AACA;AACA;AACA;AACO,SAASc,uBAAuBA,CACrCD,QAAgB,EAChBE,SAA0B,EACpB;EACNJ,iBAAiB,CAACE,QAAQ,CAAC,GAAGE,SAAS;AACzC","ignoreList":[]}
+{"version":3,"names":["_defaultExtractor","require","exports","defaultExtractor","transformToSolutionEntityData","transformToBlogPostEntityData","transformToGenericEntityData","_enrichEntitiesFromPayload","enrichEntitiesFromPayload","_matchedVariant","toMatchedOptions","formatMoney","readCurrencyCode","formatPriceField","formatProductPriceLabel","_fetchEntityListData","fetchEntityListData","_listEntityItems","listEntityItems","LIST_ITEMS_ENDPOINT","extractorRegistry","getEntityExtractor","clientId","registerEntityExtractor","extractor"],"sources":["../../../src/entity/index.ts"],"sourcesContent":["import type { EntityExtractor } from './types';\nimport { defaultExtractor } from './defaultExtractor';\n\nexport {\n  defaultExtractor,\n  transformToSolutionEntityData,\n  transformToBlogPostEntityData,\n  transformToGenericEntityData,\n} from './defaultExtractor';\n\nexport { enrichEntitiesFromPayload } from './enrichEntitiesFromPayload';\nexport {\n  toMatchedOptions,\n  formatMoney,\n  readCurrencyCode,\n  formatPriceField,\n  formatProductPriceLabel,\n  type MatchedOption,\n  type ProductPriceFields,\n} from './matchedVariant';\nexport {\n  fetchEntityListData,\n  type FetchEntityListDataOptions,\n} from './fetchEntityListData';\nexport {\n  listEntityItems,\n  LIST_ITEMS_ENDPOINT,\n  type ListEntityItemsOptions,\n} from './listEntityItems';\n\nexport type { EntityExtractor } from './types';\n\n/**\n * Registry of client-specific entity extractors.\n * Only needed if a client requires custom extraction logic beyond the config-driven default.\n */\nconst extractorRegistry: Record<string, EntityExtractor> = {};\n\n/**\n * Get the entity extractor for a specific client.\n * The default extractor is config-driven and works for any client with entityConfig.\n */\nexport function getEntityExtractor(clientId?: string): EntityExtractor {\n  if (clientId && extractorRegistry[clientId]) {\n    return extractorRegistry[clientId];\n  }\n  return defaultExtractor;\n}\n\n/**\n * Register a custom entity extractor for a client\n * Useful for runtime registration or testing\n */\nexport function registerEntityExtractor(\n  clientId: string,\n  extractor: EntityExtractor,\n): void {\n  extractorRegistry[clientId] = extractor;\n}\n"],"mappings":";;;;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AAAsDC,OAAA,CAAAC,gBAAA,GAAAH,iBAAA,CAAAG,gBAAA;AAAAD,OAAA,CAAAE,6BAAA,GAAAJ,iBAAA,CAAAI,6BAAA;AAAAF,OAAA,CAAAG,6BAAA,GAAAL,iBAAA,CAAAK,6BAAA;AAAAH,OAAA,CAAAI,4BAAA,GAAAN,iBAAA,CAAAM,4BAAA;AAStD,IAAAC,0BAAA,GAAAN,OAAA;AAAwEC,OAAA,CAAAM,yBAAA,GAAAD,0BAAA,CAAAC,yBAAA;AACxE,IAAAC,eAAA,GAAAR,OAAA;AAQ0BC,OAAA,CAAAQ,gBAAA,GAAAD,eAAA,CAAAC,gBAAA;AAAAR,OAAA,CAAAS,WAAA,GAAAF,eAAA,CAAAE,WAAA;AAAAT,OAAA,CAAAU,gBAAA,GAAAH,eAAA,CAAAG,gBAAA;AAAAV,OAAA,CAAAW,gBAAA,GAAAJ,eAAA,CAAAI,gBAAA;AAAAX,OAAA,CAAAY,uBAAA,GAAAL,eAAA,CAAAK,uBAAA;AAC1B,IAAAC,oBAAA,GAAAd,OAAA;AAG+BC,OAAA,CAAAc,mBAAA,GAAAD,oBAAA,CAAAC,mBAAA;AAC/B,IAAAC,gBAAA,GAAAhB,OAAA;AAI2BC,OAAA,CAAAgB,eAAA,GAAAD,gBAAA,CAAAC,eAAA;AAAAhB,OAAA,CAAAiB,mBAAA,GAAAF,gBAAA,CAAAE,mBAAA;AAI3B;AACA;AACA;AACA;AACA,MAAMC,iBAAkD,GAAG,CAAC,CAAC;;AAE7D;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,QAAiB,EAAmB;EACrE,IAAIA,QAAQ,IAAIF,iBAAiB,CAACE,QAAQ,CAAC,EAAE;IAC3C,OAAOF,iBAAiB,CAACE,QAAQ,CAAC;EACpC;EACA,OAAOnB,kCAAgB;AACzB;;AAEA;AACA;AACA;AACA;AACO,SAASoB,uBAAuBA,CACrCD,QAAgB,EAChBE,SAA0B,EACpB;EACNJ,iBAAiB,CAACE,QAAQ,CAAC,GAAGE,SAAS;AACzC","ignoreList":[]}

package/dist/cjs/entity/matchedVariant.js

@@ -0,0 +1,151 @@
+"use strict";
+
+exports.__esModule = true;
+exports.formatMoney = formatMoney;
+exports.formatPriceField = formatPriceField;
+exports.formatProductPriceLabel = formatProductPriceLabel;
+exports.readCurrencyCode = readCurrencyCode;
+exports.toMatchedOptions = toMatchedOptions;
+/**
+ * Presentation helpers for a document that retrieval resolved down to one
+ * child.
+ *
+ * When a query filters on an attribute that lives on the child rather than on
+ * the parent, retrieval overlays the matching child's presentation fields onto
+ * the parent document before it reaches us: `url`, `img` and `price` already
+ * describe the child, while `title`, `description` and `doc_id` stay the
+ * parent's. Two fields need shaping before a card can print them, and both
+ * live here:
+ *
+ *   - `options` — the child's own `{ name: value }` pairs.
+ *   - `priceMin` / `priceMax` — the parent's span, against which the child's
+ *     single `price` has to be read.
+ *
+ * The overlay itself is done server-side and is deliberately NOT repeated
+ * here.
+ */
+
+/** One `{ name: value }` pair, exactly as the store named it. */
+
+function readText(value) {
+  if (typeof value === 'string') {
+    return value.trim();
+  }
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return String(value);
+  }
+  return '';
+}
+
+/**
+ * Turn a document's raw `options` map into an ordered list of pairs.
+ *
+ * Every entry the store put in the map is kept, under the store's own name and
+ * in the store's own order. Nothing here knows — or may learn — what any
+ * particular name means: one catalogue's pairs describe a garment, the next
+ * one's a power tool, and both have to come out identical. Entries with an
+ * empty name or an empty/non-printable value are dropped, since a card can do
+ * nothing with them.
+ *
+ * Returns `undefined` (not `[]`) when there is nothing to show, so callers can
+ * treat it like every other optional field on the entity.
+ */
+function toMatchedOptions(raw) {
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+    return undefined;
+  }
+  const pairs = [];
+  for (const [rawName, rawValue] of Object.entries(raw)) {
+    const name = rawName.trim();
+    const value = readText(rawValue);
+    if (name && value) {
+      pairs.push({
+        name,
+        value
+      });
+    }
+  }
+  return pairs.length ? pairs : undefined;
+}
+
+/**
+ * Render one amount in the document's currency.
+ *
+ * With no currency code on the document the amount is printed bare: assuming
+ * "$" prints a false fact on every store that doesn't sell in dollars. Whole
+ * amounts stay whole ("107" not "107.00"); a real fractional amount keeps its
+ * minor units.
+ */
+function formatMoney(amount, currency) {
+  if (!currency) {
+    return String(amount);
+  }
+  try {
+    return new Intl.NumberFormat(undefined, {
+      style: 'currency',
+      currency,
+      minimumFractionDigits: Number.isInteger(amount) ? 0 : 2
+    }).format(amount);
+  } catch {
+    // A well-formed but unknown code: show it rather than dropping it.
+    return `${amount} ${currency}`;
+  }
+}
+
+/** Normalize a document currency to an ISO-4217 code, or drop it. */
+function readCurrencyCode(...candidates) {
+  for (const candidate of candidates) {
+    if (typeof candidate !== 'string') {
+      continue;
+    }
+    const code = candidate.trim().toUpperCase();
+    if (/^[A-Z]{3}$/.test(code)) {
+      return code;
+    }
+  }
+  return undefined;
+}
+
+/**
+ * Format one of a document's price fields for display. Numbers are rendered in
+ * the document's currency; an already-formatted string is passed through
+ * untouched; anything else yields `undefined`.
+ */
+function formatPriceField(value, currency) {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return formatMoney(value, currency);
+  }
+  if (typeof value === 'string' && value.trim()) {
+    return value.trim();
+  }
+  return undefined;
+}
+
+/** The already-formatted price fields a card reads. */
+
+/**
+ * What a product card should print as its price.
+ *
+ * `price` belongs to the single variant the search matched — the same variant
+ * the card's image and link point at. `priceMin`/`priceMax` describe the whole
+ * product. When those two differ the product has no one price, and printing
+ * the matched variant's number on its own would pass it off as the product's;
+ * printing it after "from" would be worse still, because "from" is a claim
+ * about the floor of the span and the matched variant is not always the
+ * cheapest one. So a span prints its own floor, prefixed.
+ *
+ * With no span — the two ends equal, or only one of them known — nothing
+ * changes: the matched variant's price is printed as it always was.
+ */
+function formatProductPriceLabel(fields) {
+  const {
+    price,
+    priceMin,
+    priceMax
+  } = fields;
+  if (priceMin && priceMax && priceMin !== priceMax) {
+    return `from ${priceMin}`;
+  }
+  return price;
+}
+//# sourceMappingURL=matchedVariant.js.map

package/dist/cjs/entity/matchedVariant.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["readText","value","trim","Number","isFinite","String","toMatchedOptions","raw","Array","isArray","undefined","pairs","rawName","rawValue","Object","entries","name","push","length","formatMoney","amount","currency","Intl","NumberFormat","style","minimumFractionDigits","isInteger","format","readCurrencyCode","candidates","candidate","code","toUpperCase","test","formatPriceField","formatProductPriceLabel","fields","price","priceMin","priceMax"],"sources":["../../../src/entity/matchedVariant.ts"],"sourcesContent":["/**\n * Presentation helpers for a document that retrieval resolved down to one\n * child.\n *\n * When a query filters on an attribute that lives on the child rather than on\n * the parent, retrieval overlays the matching child's presentation fields onto\n * the parent document before it reaches us: `url`, `img` and `price` already\n * describe the child, while `title`, `description` and `doc_id` stay the\n * parent's. Two fields need shaping before a card can print them, and both\n * live here:\n *\n *   - `options` — the child's own `{ name: value }` pairs.\n *   - `priceMin` / `priceMax` — the parent's span, against which the child's\n *     single `price` has to be read.\n *\n * The overlay itself is done server-side and is deliberately NOT repeated\n * here.\n */\n\n/** One `{ name: value }` pair, exactly as the store named it. */\nexport interface MatchedOption {\n  name: string;\n  value: string;\n}\n\nfunction readText(value: unknown): string {\n  if (typeof value === 'string') {\n    return value.trim();\n  }\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return String(value);\n  }\n  return '';\n}\n\n/**\n * Turn a document's raw `options` map into an ordered list of pairs.\n *\n * Every entry the store put in the map is kept, under the store's own name and\n * in the store's own order. Nothing here knows — or may learn — what any\n * particular name means: one catalogue's pairs describe a garment, the next\n * one's a power tool, and both have to come out identical. Entries with an\n * empty name or an empty/non-printable value are dropped, since a card can do\n * nothing with them.\n *\n * Returns `undefined` (not `[]`) when there is nothing to show, so callers can\n * treat it like every other optional field on the entity.\n */\nexport function toMatchedOptions(raw: unknown): MatchedOption[] | undefined {\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return undefined;\n  }\n\n  const pairs: MatchedOption[] = [];\n  for (const [rawName, rawValue] of Object.entries(\n    raw as Record<string, unknown>,\n  )) {\n    const name = rawName.trim();\n    const value = readText(rawValue);\n    if (name && value) {\n      pairs.push({ name, value });\n    }\n  }\n\n  return pairs.length ? pairs : undefined;\n}\n\n/**\n * Render one amount in the document's currency.\n *\n * With no currency code on the document the amount is printed bare: assuming\n * \"$\" prints a false fact on every store that doesn't sell in dollars. Whole\n * amounts stay whole (\"107\" not \"107.00\"); a real fractional amount keeps its\n * minor units.\n */\nexport function formatMoney(amount: number, currency?: string): string {\n  if (!currency) {\n    return String(amount);\n  }\n  try {\n    return new Intl.NumberFormat(undefined, {\n      style: 'currency',\n      currency,\n      minimumFractionDigits: Number.isInteger(amount) ? 0 : 2,\n    }).format(amount);\n  } catch {\n    // A well-formed but unknown code: show it rather than dropping it.\n    return `${amount} ${currency}`;\n  }\n}\n\n/** Normalize a document currency to an ISO-4217 code, or drop it. */\nexport function readCurrencyCode(...candidates: unknown[]): string | undefined {\n  for (const candidate of candidates) {\n    if (typeof candidate !== 'string') {\n      continue;\n    }\n    const code = candidate.trim().toUpperCase();\n    if (/^[A-Z]{3}$/.test(code)) {\n      return code;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Format one of a document's price fields for display. Numbers are rendered in\n * the document's currency; an already-formatted string is passed through\n * untouched; anything else yields `undefined`.\n */\nexport function formatPriceField(\n  value: unknown,\n  currency?: string,\n): string | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) {\n    return formatMoney(value, currency);\n  }\n  if (typeof value === 'string' && value.trim()) {\n    return value.trim();\n  }\n  return undefined;\n}\n\n/** The already-formatted price fields a card reads. */\nexport interface ProductPriceFields {\n  /** Price of the one variant this result matched. */\n  price?: string;\n  /** Lowest price across the whole product's variants. */\n  priceMin?: string;\n  /** Highest price across the whole product's variants. */\n  priceMax?: string;\n}\n\n/**\n * What a product card should print as its price.\n *\n * `price` belongs to the single variant the search matched — the same variant\n * the card's image and link point at. `priceMin`/`priceMax` describe the whole\n * product. When those two differ the product has no one price, and printing\n * the matched variant's number on its own would pass it off as the product's;\n * printing it after \"from\" would be worse still, because \"from\" is a claim\n * about the floor of the span and the matched variant is not always the\n * cheapest one. So a span prints its own floor, prefixed.\n *\n * With no span — the two ends equal, or only one of them known — nothing\n * changes: the matched variant's price is printed as it always was.\n */\nexport function formatProductPriceLabel(\n  fields: ProductPriceFields,\n): string | undefined {\n  const { price, priceMin, priceMax } = fields;\n  if (priceMin && priceMax && priceMin !== priceMax) {\n    return `from ${priceMin}`;\n  }\n  return price;\n}\n"],"mappings":";;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAMA,SAASA,QAAQA,CAACC,KAAc,EAAU;EACxC,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC7B,OAAOA,KAAK,CAACC,IAAI,CAAC,CAAC;EACrB;EACA,IAAI,OAAOD,KAAK,KAAK,QAAQ,IAAIE,MAAM,CAACC,QAAQ,CAACH,KAAK,CAAC,EAAE;IACvD,OAAOI,MAAM,CAACJ,KAAK,CAAC;EACtB;EACA,OAAO,EAAE;AACX;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,gBAAgBA,CAACC,GAAY,EAA+B;EAC1E,IAAI,CAACA,GAAG,IAAI,OAAOA,GAAG,KAAK,QAAQ,IAAIC,KAAK,CAACC,OAAO,CAACF,GAAG,CAAC,EAAE;IACzD,OAAOG,SAAS;EAClB;EAEA,MAAMC,KAAsB,GAAG,EAAE;EACjC,KAAK,MAAM,CAACC,OAAO,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAC9CR,GACF,CAAC,EAAE;IACD,MAAMS,IAAI,GAAGJ,OAAO,CAACV,IAAI,CAAC,CAAC;IAC3B,MAAMD,KAAK,GAAGD,QAAQ,CAACa,QAAQ,CAAC;IAChC,IAAIG,IAAI,IAAIf,KAAK,EAAE;MACjBU,KAAK,CAACM,IAAI,CAAC;QAAED,IAAI;QAAEf;MAAM,CAAC,CAAC;IAC7B;EACF;EAEA,OAAOU,KAAK,CAACO,MAAM,GAAGP,KAAK,GAAGD,SAAS;AACzC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,WAAWA,CAACC,MAAc,EAAEC,QAAiB,EAAU;EACrE,IAAI,CAACA,QAAQ,EAAE;IACb,OAAOhB,MAAM,CAACe,MAAM,CAAC;EACvB;EACA,IAAI;IACF,OAAO,IAAIE,IAAI,CAACC,YAAY,CAACb,SAAS,EAAE;MACtCc,KAAK,EAAE,UAAU;MACjBH,QAAQ;MACRI,qBAAqB,EAAEtB,MAAM,CAACuB,SAAS,CAACN,MAAM,CAAC,GAAG,CAAC,GAAG;IACxD,CAAC,CAAC,CAACO,MAAM,CAACP,MAAM,CAAC;EACnB,CAAC,CAAC,MAAM;IACN;IACA,OAAO,GAAGA,MAAM,IAAIC,QAAQ,EAAE;EAChC;AACF;;AAEA;AACO,SAASO,gBAAgBA,CAAC,GAAGC,UAAqB,EAAsB;EAC7E,KAAK,MAAMC,SAAS,IAAID,UAAU,EAAE;IAClC,IAAI,OAAOC,SAAS,KAAK,QAAQ,EAAE;MACjC;IACF;IACA,MAAMC,IAAI,GAAGD,SAAS,CAAC5B,IAAI,CAAC,CAAC,CAAC8B,WAAW,CAAC,CAAC;IAC3C,IAAI,YAAY,CAACC,IAAI,CAACF,IAAI,CAAC,EAAE;MAC3B,OAAOA,IAAI;IACb;EACF;EACA,OAAOrB,SAAS;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASwB,gBAAgBA,CAC9BjC,KAAc,EACdoB,QAAiB,EACG;EACpB,IAAI,OAAOpB,KAAK,KAAK,QAAQ,IAAIE,MAAM,CAACC,QAAQ,CAACH,KAAK,CAAC,EAAE;IACvD,OAAOkB,WAAW,CAAClB,KAAK,EAAEoB,QAAQ,CAAC;EACrC;EACA,IAAI,OAAOpB,KAAK,KAAK,QAAQ,IAAIA,KAAK,CAACC,IAAI,CAAC,CAAC,EAAE;IAC7C,OAAOD,KAAK,CAACC,IAAI,CAAC,CAAC;EACrB;EACA,OAAOQ,SAAS;AAClB;;AAEA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASyB,uBAAuBA,CACrCC,MAA0B,EACN;EACpB,MAAM;IAAEC,KAAK;IAAEC,QAAQ;IAAEC;EAAS,CAAC,GAAGH,MAAM;EAC5C,IAAIE,QAAQ,IAAIC,QAAQ,IAAID,QAAQ,KAAKC,QAAQ,EAAE;IACjD,OAAO,QAAQD,QAAQ,EAAE;EAC3B;EACA,OAAOD,KAAK;AACd","ignoreList":[]}

package/dist/cjs/hooks/useResolveSearchSpringEntityData.js

@@ -31,8 +31,20 @@ function getSearchSpringHandle(entity) {
   var _entity$data;
   return extractProductHandle((_entity$data = entity.data) == null ? void 0 : _entity$data.url) || entity.entityId;
 }
+
+/**
+ * The turn owns WHICH thing to show; the live fetch owns VOLATILE FACTS about
+ * it.
+ *
+ * Only the turn saw the shopper's question, so only it knows that the brown
+ * variant was the one asked for — its `title`, `imageUrl`, `url`,
+ * `matchedOptions` and `variantId` all describe that one variant and must
+ * survive enrichment. Everything SearchSpring answers with that can go stale
+ * between the turn and the render — `price`, `compareAtPrice`, `available`,
+ * `priceMin`, `priceMax` — comes from `resolved`.
+ */
 function mergeSearchSpringEntityData(existing, resolved) {
-  var _existing$sizes, _existing$variants, _existing$options, _existing$allImages;
+  var _existing$matchedOpti, _existing$sizes, _existing$variants, _existing$options, _existing$allImages;
   if (!existing) {
     return resolved;
   }
@@ -40,6 +52,10 @@ function mergeSearchSpringEntityData(existing, resolved) {
     ...existing,
     ...resolved,
     url: existing.url || resolved.url,
+    title: existing.title || resolved.title,
+    imageUrl: existing.imageUrl || resolved.imageUrl,
+    variantId: existing.variantId || resolved.variantId,
+    matchedOptions: (_existing$matchedOpti = existing.matchedOptions) != null && _existing$matchedOpti.length ? existing.matchedOptions : resolved.matchedOptions,
     sizes: (_existing$sizes = existing.sizes) != null && _existing$sizes.length ? existing.sizes : resolved.sizes,
     variants: (_existing$variants = existing.variants) != null && _existing$variants.length ? existing.variants : resolved.variants,
     options: (_existing$options = existing.options) != null && _existing$options.length ? existing.options : resolved.options,

package/dist/cjs/hooks/useResolveSearchSpringEntityData.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_searchSpringClient","_transformSSProduct","ssEntityCache","Map","extractProductHandle","url","trimmed","trim","undefined","pathname","test","URL","withoutQuery","split","withoutLeadingSlash","replace","productsIndex","indexOf","handle","slice","length","getSearchSpringHandle","entity","_entity$data","data","entityId","mergeSearchSpringEntityData","existing","resolved","_existing$sizes","_existing$variants","_existing$options","_existing$allImages","sizes","variants","options","allImages","useResolveSearchSpringEntityData","entities","config","resolvedMap","setResolvedMap","useState","settled","setSettled","entityKey","useMemo","map","e","entityType","join","useEffect","ignore","siteId","productEntityHandles","filter","toLowerCase","includes","handlesToFetch","Set","has","cached","forEach","item","get","set","fetchAll","productMap","fetchProductsByHandlesMap","product","itemData","transformSSProductToEntityItemData","finalMap","enrichedEntities","loading"],"sources":["../../../src/hooks/useResolveSearchSpringEntityData.ts"],"sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { fetchProductsByHandlesMap } from '../services/searchspring/searchSpringClient';\nimport { transformSSProductToEntityItemData } from '../services/searchspring/transformSSProduct';\nimport type { SearchSpringConfig } from '../services/searchspring/types';\nimport type { EntityItemData } from '../component/types';\n\n// Session-level cache: handle → resolved EntityItemData\nconst ssEntityCache = new Map<string, EntityItemData>();\n\nfunction extractProductHandle(url: string | undefined): string | undefined {\n  const trimmed = url?.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  let pathname = trimmed;\n  try {\n    if (/^https?:\\/\\//i.test(trimmed)) {\n      pathname = new URL(trimmed).pathname;\n    }\n  } catch {\n    pathname = trimmed;\n  }\n\n  const withoutQuery = pathname.split(/[?#]/)[0];\n  const withoutLeadingSlash = withoutQuery.replace(/^\\/+/, '');\n  const productsIndex = withoutLeadingSlash.indexOf('products/');\n  const handle =\n    productsIndex >= 0\n      ? withoutLeadingSlash.slice(productsIndex + 'products/'.length)\n      : withoutLeadingSlash;\n\n  return handle || undefined;\n}\n\nfunction getSearchSpringHandle(entity: {\n  entityId: string;\n  data?: EntityItemData;\n}): string {\n  return extractProductHandle(entity.data?.url) || entity.entityId;\n}\n\nexport function mergeSearchSpringEntityData(\n  existing: EntityItemData | undefined,\n  resolved: EntityItemData,\n): EntityItemData {\n  if (!existing) {\n    return resolved;\n  }\n\n  return {\n    ...existing,\n    ...resolved,\n    url: existing.url || resolved.url,\n    sizes: existing.sizes?.length ? existing.sizes : resolved.sizes,\n    variants: existing.variants?.length ? existing.variants : resolved.variants,\n    options: existing.options?.length ? existing.options : resolved.options,\n    allImages: existing.allImages?.length\n      ? existing.allImages\n      : resolved.allImages,\n  };\n}\n\n/**\n * SearchSpring-backed entity resolution hook.\n *\n * Fetches product data from the SearchSpring Search API by handle\n * and transforms it to EntityItemData. Uses a single batched API call\n * for all products (bgfilter.handle supports OR).\n */\nexport function useResolveSearchSpringEntityData<\n  TEntity extends {\n    entityId: string;\n    entityUrl: string;\n    entityType: string;\n    data?: EntityItemData;\n  },\n>(\n  entities: TEntity[],\n  config: SearchSpringConfig,\n): { enrichedEntities: TEntity[]; loading: boolean } {\n  const [resolvedMap, setResolvedMap] = useState<Map<string, EntityItemData>>(\n    new Map(),\n  );\n  const [settled, setSettled] = useState(false);\n\n  // Stable key for dependency tracking\n  const entityKey = useMemo(\n    () =>\n      entities\n        .map((e) => `${e.entityType}:${e.entityId}:${getSearchSpringHandle(e)}`)\n        .join(','),\n    [entities],\n  );\n\n  useEffect(() => {\n    let ignore = false;\n\n    if (!entities.length || !config.siteId) {\n      setSettled(true);\n      return;\n    }\n\n    const productEntityHandles = entities\n      .filter((e) => e.entityType.toLowerCase().includes('product'))\n      .map((entity) => ({\n        entity,\n        handle: getSearchSpringHandle(entity),\n      }));\n\n    // Collect handles that need fetching. CMS payload IDs use payload url as the handle.\n    const handlesToFetch = [\n      ...new Set(\n        productEntityHandles\n          .map(({ handle }) => handle)\n          .filter((handle) => !ssEntityCache.has(handle)),\n      ),\n    ];\n\n    // If everything is cached, resolve immediately\n    if (handlesToFetch.length === 0) {\n      const cached = new Map<string, EntityItemData>();\n      productEntityHandles.forEach(({ entity, handle }) => {\n        const item = ssEntityCache.get(handle);\n        if (item) {\n          cached.set(entity.entityId, item);\n        }\n      });\n      setResolvedMap(cached);\n      setSettled(true);\n      return;\n    }\n\n    setSettled(false);\n\n    const fetchAll = async () => {\n      const productMap = await fetchProductsByHandlesMap(\n        config.siteId,\n        handlesToFetch,\n      );\n\n      // Transform and cache\n      for (const [handle, product] of productMap) {\n        const itemData = transformSSProductToEntityItemData(product);\n        ssEntityCache.set(handle, itemData);\n      }\n\n      if (ignore) {\n        return;\n      }\n\n      // Build the final map\n      const finalMap = new Map<string, EntityItemData>();\n      productEntityHandles.forEach(({ entity, handle }) => {\n        const item = ssEntityCache.get(handle);\n        if (item) {\n          finalMap.set(entity.entityId, item);\n        }\n      });\n\n      setResolvedMap(finalMap);\n      setSettled(true);\n    };\n\n    fetchAll();\n    return () => {\n      ignore = true;\n    };\n  }, [entityKey, config.siteId]);\n\n  // Merge resolved data into entities\n  const enrichedEntities = useMemo(() => {\n    return entities.map((entity) => {\n      const resolved = resolvedMap.get(entity.entityId);\n      if (resolved) {\n        return {\n          ...entity,\n          data: mergeSearchSpringEntityData(entity.data, resolved),\n        };\n      }\n      return entity;\n    });\n  }, [entities, resolvedMap]);\n\n  return { enrichedEntities, loading: !settled };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_searchSpringClient","_transformSSProduct","ssEntityCache","Map","extractProductHandle","url","trimmed","trim","undefined","pathname","test","URL","withoutQuery","split","withoutLeadingSlash","replace","productsIndex","indexOf","handle","slice","length","getSearchSpringHandle","entity","_entity$data","data","entityId","mergeSearchSpringEntityData","existing","resolved","_existing$matchedOpti","_existing$sizes","_existing$variants","_existing$options","_existing$allImages","title","imageUrl","variantId","matchedOptions","sizes","variants","options","allImages","useResolveSearchSpringEntityData","entities","config","resolvedMap","setResolvedMap","useState","settled","setSettled","entityKey","useMemo","map","e","entityType","join","useEffect","ignore","siteId","productEntityHandles","filter","toLowerCase","includes","handlesToFetch","Set","has","cached","forEach","item","get","set","fetchAll","productMap","fetchProductsByHandlesMap","product","itemData","transformSSProductToEntityItemData","finalMap","enrichedEntities","loading"],"sources":["../../../src/hooks/useResolveSearchSpringEntityData.ts"],"sourcesContent":["import { useState, useEffect, useMemo } from 'react';\nimport { fetchProductsByHandlesMap } from '../services/searchspring/searchSpringClient';\nimport { transformSSProductToEntityItemData } from '../services/searchspring/transformSSProduct';\nimport type { SearchSpringConfig } from '../services/searchspring/types';\nimport type { EntityItemData } from '../component/types';\n\n// Session-level cache: handle → resolved EntityItemData\nconst ssEntityCache = new Map<string, EntityItemData>();\n\nfunction extractProductHandle(url: string | undefined): string | undefined {\n  const trimmed = url?.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  let pathname = trimmed;\n  try {\n    if (/^https?:\\/\\//i.test(trimmed)) {\n      pathname = new URL(trimmed).pathname;\n    }\n  } catch {\n    pathname = trimmed;\n  }\n\n  const withoutQuery = pathname.split(/[?#]/)[0];\n  const withoutLeadingSlash = withoutQuery.replace(/^\\/+/, '');\n  const productsIndex = withoutLeadingSlash.indexOf('products/');\n  const handle =\n    productsIndex >= 0\n      ? withoutLeadingSlash.slice(productsIndex + 'products/'.length)\n      : withoutLeadingSlash;\n\n  return handle || undefined;\n}\n\nfunction getSearchSpringHandle(entity: {\n  entityId: string;\n  data?: EntityItemData;\n}): string {\n  return extractProductHandle(entity.data?.url) || entity.entityId;\n}\n\n/**\n * The turn owns WHICH thing to show; the live fetch owns VOLATILE FACTS about\n * it.\n *\n * Only the turn saw the shopper's question, so only it knows that the brown\n * variant was the one asked for — its `title`, `imageUrl`, `url`,\n * `matchedOptions` and `variantId` all describe that one variant and must\n * survive enrichment. Everything SearchSpring answers with that can go stale\n * between the turn and the render — `price`, `compareAtPrice`, `available`,\n * `priceMin`, `priceMax` — comes from `resolved`.\n */\nexport function mergeSearchSpringEntityData(\n  existing: EntityItemData | undefined,\n  resolved: EntityItemData,\n): EntityItemData {\n  if (!existing) {\n    return resolved;\n  }\n\n  return {\n    ...existing,\n    ...resolved,\n    url: existing.url || resolved.url,\n    title: existing.title || resolved.title,\n    imageUrl: existing.imageUrl || resolved.imageUrl,\n    variantId: existing.variantId || resolved.variantId,\n    matchedOptions: existing.matchedOptions?.length\n      ? existing.matchedOptions\n      : resolved.matchedOptions,\n    sizes: existing.sizes?.length ? existing.sizes : resolved.sizes,\n    variants: existing.variants?.length ? existing.variants : resolved.variants,\n    options: existing.options?.length ? existing.options : resolved.options,\n    allImages: existing.allImages?.length\n      ? existing.allImages\n      : resolved.allImages,\n  };\n}\n\n/**\n * SearchSpring-backed entity resolution hook.\n *\n * Fetches product data from the SearchSpring Search API by handle\n * and transforms it to EntityItemData. Uses a single batched API call\n * for all products (bgfilter.handle supports OR).\n */\nexport function useResolveSearchSpringEntityData<\n  TEntity extends {\n    entityId: string;\n    entityUrl: string;\n    entityType: string;\n    data?: EntityItemData;\n  },\n>(\n  entities: TEntity[],\n  config: SearchSpringConfig,\n): { enrichedEntities: TEntity[]; loading: boolean } {\n  const [resolvedMap, setResolvedMap] = useState<Map<string, EntityItemData>>(\n    new Map(),\n  );\n  const [settled, setSettled] = useState(false);\n\n  // Stable key for dependency tracking\n  const entityKey = useMemo(\n    () =>\n      entities\n        .map((e) => `${e.entityType}:${e.entityId}:${getSearchSpringHandle(e)}`)\n        .join(','),\n    [entities],\n  );\n\n  useEffect(() => {\n    let ignore = false;\n\n    if (!entities.length || !config.siteId) {\n      setSettled(true);\n      return;\n    }\n\n    const productEntityHandles = entities\n      .filter((e) => e.entityType.toLowerCase().includes('product'))\n      .map((entity) => ({\n        entity,\n        handle: getSearchSpringHandle(entity),\n      }));\n\n    // Collect handles that need fetching. CMS payload IDs use payload url as the handle.\n    const handlesToFetch = [\n      ...new Set(\n        productEntityHandles\n          .map(({ handle }) => handle)\n          .filter((handle) => !ssEntityCache.has(handle)),\n      ),\n    ];\n\n    // If everything is cached, resolve immediately\n    if (handlesToFetch.length === 0) {\n      const cached = new Map<string, EntityItemData>();\n      productEntityHandles.forEach(({ entity, handle }) => {\n        const item = ssEntityCache.get(handle);\n        if (item) {\n          cached.set(entity.entityId, item);\n        }\n      });\n      setResolvedMap(cached);\n      setSettled(true);\n      return;\n    }\n\n    setSettled(false);\n\n    const fetchAll = async () => {\n      const productMap = await fetchProductsByHandlesMap(\n        config.siteId,\n        handlesToFetch,\n      );\n\n      // Transform and cache\n      for (const [handle, product] of productMap) {\n        const itemData = transformSSProductToEntityItemData(product);\n        ssEntityCache.set(handle, itemData);\n      }\n\n      if (ignore) {\n        return;\n      }\n\n      // Build the final map\n      const finalMap = new Map<string, EntityItemData>();\n      productEntityHandles.forEach(({ entity, handle }) => {\n        const item = ssEntityCache.get(handle);\n        if (item) {\n          finalMap.set(entity.entityId, item);\n        }\n      });\n\n      setResolvedMap(finalMap);\n      setSettled(true);\n    };\n\n    fetchAll();\n    return () => {\n      ignore = true;\n    };\n  }, [entityKey, config.siteId]);\n\n  // Merge resolved data into entities\n  const enrichedEntities = useMemo(() => {\n    return entities.map((entity) => {\n      const resolved = resolvedMap.get(entity.entityId);\n      if (resolved) {\n        return {\n          ...entity,\n          data: mergeSearchSpringEntityData(entity.data, resolved),\n        };\n      }\n      return entity;\n    });\n  }, [entities, resolvedMap]);\n\n  return { enrichedEntities, loading: !settled };\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/hooks/useResolveShopifyEntityData.js

@@ -7,10 +7,10 @@ var _react = require("react");
 var _shopifyStorefrontClient = require("../services/shopify/shopifyStorefrontClient");
 var _shopifyEntityResolver = require("../services/shopify/shopifyEntityResolver");
 var _transformShopifyEntity = require("../services/shopify/transformShopifyEntity");
-// Session-level cache: entityType:entityId → resolved EntityItemData
+// Session-level cache: entityType:entityId:variantId → resolved EntityItemData
 const shopifyEntityCache = new Map();
-function cacheKey(entityType, entityId) {
-  return `${entityType}:${entityId}`;
+function cacheKey(entityType, entityId, variantId) {
+  return `${entityType}:${entityId}:${variantId || ''}`;
 }
 function normalizeShopifyEntityType(entityType) {
   const lower = entityType.toLowerCase();
@@ -51,23 +51,41 @@ function extractHandleFromUrl(url) {
   return withoutLeadingSlash || undefined;
 }
 function getShopifyLookup(entity) {
-  var _entity$data;
+  var _entity$data, _entity$data2;
   const entityType = normalizeShopifyEntityType(entity.entityType);
   const urlHandle = extractHandleFromUrl((_entity$data = entity.data) == null ? void 0 : _entity$data.url);
   const entityId = (entityType === 'product' || entityType === 'collection') && urlHandle ? urlHandle : entity.entityId;
   return {
     entityType,
-    entityId
+    entityId,
+    variantId: (_entity$data2 = entity.data) == null ? void 0 : _entity$data2.variantId
   };
 }
+
+/**
+ * The turn owns WHICH thing to show; the live fetch owns VOLATILE FACTS about
+ * it.
+ *
+ * Only the turn saw the shopper's question, so only it knows that the brown
+ * variant was the one asked for — its `title`, `imageUrl`, `url`,
+ * `matchedOptions` and `variantId` all describe that one variant and must
+ * survive enrichment. Everything the Storefront answers with that can go stale
+ * between the turn and the render — `price`, `compareAtPrice`, `available`,
+ * `priceMin`, `priceMax` — comes from `resolved`.
+ */
 function mergeShopifyEntityData(existing, resolved) {
+  var _existing$matchedOpti;
   if (!existing) {
     return resolved;
   }
   return {
     ...existing,
     ...resolved,
-    url: existing.url || resolved.url
+    url: existing.url || resolved.url,
+    title: existing.title || resolved.title,
+    imageUrl: existing.imageUrl || resolved.imageUrl,
+    variantId: existing.variantId || resolved.variantId,
+    matchedOptions: (_existing$matchedOpti = existing.matchedOptions) != null && _existing$matchedOpti.length ? existing.matchedOptions : resolved.matchedOptions
   };
 }
 
@@ -93,7 +111,7 @@ function useResolveShopifyEntityData(entities, shopifyConfig) {
   }
   const entityIds = (0, _react.useMemo)(() => entities.map(e => {
     const lookup = getShopifyLookup(e);
-    return `${e.entityType}:${e.entityId}:${lookup.entityType}:${lookup.entityId}`;
+    return `${e.entityType}:${e.entityId}:${cacheKey(lookup.entityType, lookup.entityId, lookup.variantId)}`;
   }).join(','), [entities]);
   (0, _react.useEffect)(() => {
     let ignore = false;
@@ -107,7 +125,10 @@ function useResolveShopifyEntityData(entities, shopifyConfig) {
       return {
         entity,
         lookup,
-        key: cacheKey(lookup.entityType, lookup.entityId)
+        // The variant is part of the key: the cached entry carries that
+        // variant's live price, so two entities on the same product but
+        // different variants must not share it.
+        key: cacheKey(lookup.entityType, lookup.entityId, lookup.variantId)
       };
     });
 
@@ -141,7 +162,7 @@ function useResolveShopifyEntityData(entities, shopifyConfig) {
       }) => {
         const resolved = await (0, _shopifyEntityResolver.resolveShopifyEntity)(client, lookup.entityType, lookup.entityId, shopifyConfig);
         if (resolved) {
-          const itemData = (0, _transformShopifyEntity.transformShopifyEntityToItemData)(resolved, lookup.entityType);
+          const itemData = (0, _transformShopifyEntity.transformShopifyEntityToItemData)(resolved, lookup.entityType, lookup.variantId);
           shopifyEntityCache.set(key, mergeShopifyEntityData(entity.data, itemData));
         }
       }));