@wix/web5-core 1.56.0

package/dist/esm/component/componentParser.js

@@ -0,0 +1,358 @@
+/**
+ * Markdown → component orchestrator. Lifted from
+ * `web50-server-ui/src/utils/componentParser.ts` per DL #088 B9.5.
+ *
+ * The lift replaces three app-side singletons with options:
+ *  - `getAppRegistry()` → `options.registry`
+ *  - `getClientConfigSync(clientId)` → `options.clientConfig`
+ *  - `setLastDiagnosticsCollector(...)` → returned in the result object
+ *
+ * Adds a `placement` option that flows into every `registry.resolveSection`
+ * call so the placement bundle can pick the placement variant of each section.
+ *
+ * The app-side `componentParser.ts` is a thin wrapper around this orchestrator
+ * that pre-binds its singletons and a product-payload enrichment callback.
+ */
+
+import React from 'react';
+import { validatePattern } from '../patternValidator/index.js';
+import { nodesToParts } from '../match/astToParts.js';
+import { isWeb5ImageUrl } from '../types/link-types.js';
+import { findInvalidWeb5Links } from '../utils/web5LinkValidator.js';
+import { DIAGNOSTIC_TYPES } from './diagnosticTypes.js';
+import { ComponentTracking } from '../utils/componentTracking.js';
+import { DiagnosticsCollector } from '../utils/diagnosticsCollector.js';
+import { parseAstToMarkdown, parseMarkdownToAst } from '../utils/unifiedMarkdownParser.js';
+import { preprocessMarkdown } from '../utils/markdownPreprocessor.js';
+import { getIntentFromMarkdown } from '../utils/intentExtractor.js';
+import { getContextualImageFilename } from '../utils/contentKeywordMatcher.js';
+import { createPageSection } from '../utils/propsExtractor.js';
+function isEntityCompProps(props) {
+  return typeof props === 'object' && props !== null && Array.isArray(props.items);
+}
+function isItemsFromContentSection(sectionType, semantic, serverSectionId) {
+  if (sectionType !== 'entity') {
+    return false;
+  }
+  const normalizedSemantic = semantic == null ? void 0 : semantic.toLowerCase().replace(/_/g, '-');
+  const normalizedId = serverSectionId == null ? void 0 : serverSectionId.toLowerCase().replace(/_/g, '-');
+  return normalizedSemantic === 'items' || normalizedSemantic === 'items-from-content' || (normalizedId == null ? void 0 : normalizedId.includes('items-from-content')) === true;
+}
+
+/**
+ * Merges new sections with existing sections, maintaining stable references
+ * for unchanged sections to prevent unnecessary rerenders.
+ */
+export function mergeSectionsWithStableReferences(existingSections, newSections) {
+  if (existingSections.length === 0) {
+    return newSections;
+  }
+  if (newSections.length < existingSections.length) {
+    return newSections;
+  }
+  const merged = [];
+  for (let i = 0; i < existingSections.length; i++) {
+    var _existing$sourceMarkd, _updated$sourceMarkdo;
+    const existing = existingSections[i];
+    const updated = newSections[i];
+    if (!updated) {
+      merged.push(existing);
+      continue;
+    }
+    const existingLength = ((_existing$sourceMarkd = existing.sourceMarkdown) == null ? void 0 : _existing$sourceMarkd.length) || 0;
+    const updatedLength = ((_updated$sourceMarkdo = updated.sourceMarkdown) == null ? void 0 : _updated$sourceMarkdo.length) || 0;
+    if (existingLength === updatedLength) {
+      existing.sourceMarkdown = updated.sourceMarkdown;
+      existing.component = updated.component;
+      existing.componentOptions = updated.componentOptions;
+      existing.debugProps = updated.debugProps;
+      // V3 (DL #106): a skeleton and its real section both have empty
+      // sourceMarkdown, so without carrying this flag the slot would stay a
+      // skeleton forever (its real component never rendering).
+      existing.isSkeleton = updated.isSkeleton;
+      merged.push(existing);
+    } else {
+      merged.push(updated);
+    }
+  }
+  if (newSections.length > existingSections.length) {
+    const newSectionsToAdd = newSections.slice(existingSections.length);
+    merged.push(...newSectionsToAdd);
+  }
+  return merged;
+}
+function combineAdjacentGeneralTextSections(sections, registry, placement, placementId) {
+  if (sections.length === 0) {
+    return sections;
+  }
+  const combined = [];
+  let i = 0;
+  while (i < sections.length) {
+    const currentSection = sections[i];
+    if (currentSection.sectionType === 'fallback') {
+      const sectionsToCombine = [currentSection];
+      let j = i + 1;
+      while (j < sections.length && sections[j].sectionType === 'fallback') {
+        sectionsToCombine.push(sections[j]);
+        j++;
+      }
+      if (sectionsToCombine.length > 1) {
+        const mergedSection = mergeGeneralTextSections(sectionsToCombine, combined.length, registry, placement, placementId);
+        combined.push(mergedSection);
+        i = j;
+      } else {
+        combined.push(currentSection);
+        i++;
+      }
+    } else {
+      combined.push(currentSection);
+      i++;
+    }
+  }
+  return combined;
+}
+function mergeGeneralTextSections(sections, index, registry, placement, placementId) {
+  if (sections.length === 0) {
+    throw new Error('Cannot merge empty sections array');
+  }
+  if (sections.length === 1) {
+    return sections[0];
+  }
+  const mergedSourceMarkdown = sections.map(section => section.sourceMarkdown || '').filter(markdown => markdown.trim().length > 0).join('\n\n');
+  const mergedProps = {
+    markdown: mergedSourceMarkdown
+  };
+  const FallbackComponent = registry.resolveSection('fallback', {
+    placement,
+    placementId
+  });
+  const mergedComponent = /*#__PURE__*/React.createElement(FallbackComponent, mergedProps);
+  return createPageSection({
+    sectionType: 'fallback',
+    componentName: FallbackComponent.displayName || FallbackComponent.name,
+    index,
+    component: mergedComponent,
+    sourceMarkdown: mergedSourceMarkdown,
+    debugProps: mergedProps
+  });
+}
+export function parseMarkdownToComponents(pageMarkdown, options) {
+  var _clientConfig$feature;
+  const {
+    registry,
+    clientConfig,
+    placement,
+    placementId,
+    enrichEntityProps,
+    clientId,
+    intentInfo: providedIntent,
+    payload,
+    disableContextualImages: explicitDisableImages
+  } = options;
+  const {
+    markdown: preprocessedMarkdown,
+    diagnostics: preprocessDiagnostics
+  } = preprocessMarkdown(pageMarkdown);
+  const intentInfo = providedIntent ?? getIntentFromMarkdown(preprocessedMarkdown);
+  const allNodes = [...parseMarkdownToAst(preprocessedMarkdown).children];
+  const nodes = [...allNodes];
+  const sections = [];
+  const tracking = new ComponentTracking();
+  const diagnosticsCollector = options.diagnosticsCollector ?? new DiagnosticsCollector();
+  for (const d of preprocessDiagnostics) {
+    diagnosticsCollector.report({
+      diagnosticType: d.type,
+      sectionType: 'preprocessor',
+      sectionIndex: -1,
+      details: `${d.original} → ${d.normalized}`
+    });
+  }
+  const disableContextualImages = explicitDisableImages ?? (clientConfig == null || (_clientConfig$feature = clientConfig.features) == null ? void 0 : _clientConfig$feature.disableContextualImagesEnrichment) ?? false;
+  const context = {
+    registry,
+    clientConfig,
+    placement,
+    placementId,
+    enrichEntityProps,
+    clientId,
+    intent: intentInfo,
+    tracking,
+    disableContextualImages,
+    diagnosticsCollector,
+    payload
+  };
+  let currentGlobalIndex = 0;
+  while (nodes.length > 0) {
+    const startIndex = currentGlobalIndex;
+    const {
+      section,
+      parsedCount
+    } = tryParseComponent(nodes, sections.length, context);
+    if (!parsedCount) {
+      break;
+    }
+    if (section) {
+      section.sourceMarkdown = parseAstToMarkdown(nodes.slice(0, parsedCount));
+      sections.push(section);
+      const endIndex = startIndex + parsedCount;
+      tracking.addRange(section.sectionType, startIndex, endIndex, sections.length - 1);
+    } else {
+      const endIndex = startIndex + parsedCount;
+      tracking.addRange('', startIndex, endIndex, -1);
+    }
+    currentGlobalIndex += parsedCount;
+    nodes.splice(0, parsedCount);
+  }
+  for (const link of findInvalidWeb5Links(allNodes)) {
+    let diagnosticType;
+    let label;
+    switch (link.reason) {
+      case 'legacy':
+        diagnosticType = DIAGNOSTIC_TYPES.LEGACY_PROTOCOL_LINK;
+        label = 'legacy protocol';
+        break;
+      case 'empty':
+        diagnosticType = DIAGNOSTIC_TYPES.INVALID_LINK_FORMAT;
+        label = 'empty href';
+        break;
+      default:
+        diagnosticType = DIAGNOSTIC_TYPES.BROKEN_WEB5_LINK;
+        label = 'web5://';
+        break;
+    }
+    diagnosticsCollector.report({
+      diagnosticType,
+      sectionType: 'parser',
+      sectionIndex: -1,
+      details: `Invalid ${label} URL in ${link.nodeType}: ${link.url}`.slice(0, 200)
+    });
+  }
+  const combinedSections = combineAdjacentGeneralTextSections(sections, registry, placement, placementId);
+  return {
+    sections: combinedSections,
+    tracking,
+    diagnosticsCollector
+  };
+}
+export function tryParseComponent(nodes, sectionIndex, context) {
+  if (!(nodes != null && nodes.length)) {
+    return {};
+  }
+  const registry = context.registry;
+  const placement = context.placement;
+  const placementId = context.placementId;
+  const definitions = registry.getAllDefinitions();
+  const clientConfig = context.clientConfig ?? null;
+  const allowedKeywords = (clientConfig == null ? void 0 : clientConfig.allowedImageSearchKeywords) ?? [];
+  const disableContextualImages = context.disableContextualImages ?? false;
+  const baseParseContext = {
+    getContextualImage: disableContextualImages || allowedKeywords.length === 0 ? undefined : contentParts => {
+      const result = getContextualImageFilename(contentParts, allowedKeywords, '', context.tracking);
+      return isWeb5ImageUrl(result.filename) ? result : null;
+    },
+    getComponentCount: context.tracking ? sectionType => context.tracking.getComponentCount(sectionType) : undefined,
+    setMeta: context.tracking ? (sectionType, key, value) => context.tracking.setMeta(sectionType, key, value) : undefined,
+    getMeta: context.tracking ? (sectionType, key) => context.tracking.getMeta(sectionType, key) : undefined
+  };
+  for (const {
+    sectionType,
+    definition
+  } of definitions) {
+    // Placement-only definitions (registered with `{ placement: true }`
+    // variants and no non-placement variant) must not match in a non-placement
+    // render (the main app) — their markdown should fall through to the generic
+    // sections there. Skip them unless this is a placement parse.
+    if (!placement && registry.isPlacementOnly(sectionType)) {
+      continue;
+    }
+    for (const pattern of definition.patterns) {
+      var _parts$find, _context$intent;
+      const result = validatePattern(nodes, pattern);
+      if (!result.valid) {
+        continue;
+      }
+      let parsedNodes = result.astEndIndex !== undefined && result.astEndIndex >= 0 ? result.astEndIndex + 1 : result.endIndex >= 0 ? result.endIndex + 1 : 1;
+      const maxNodes = definition.maxConsumedNodes;
+      if (typeof maxNodes === 'number' && parsedNodes > maxNodes) {
+        parsedNodes = maxNodes;
+      }
+      const matchedNodes = nodes.slice(0, parsedNodes);
+      const parts = nodesToParts(matchedNodes);
+      const parseContext = {
+        ...baseParseContext,
+        reportDiagnostic: context.diagnosticsCollector ? (type, details) => {
+          context.diagnosticsCollector.report({
+            diagnosticType: type,
+            sectionType,
+            sectionIndex,
+            details: details.slice(0, 200)
+          });
+        } : undefined
+      };
+      let props = definition.parse(parts, parseContext);
+      if (props === null) {
+        continue;
+      }
+      const leadingHtmlCommentMeta = (_parts$find = parts.find(p => p.type === 'htmlComment' && p.meta)) == null ? void 0 : _parts$find.meta;
+      const semantic = leadingHtmlCommentMeta == null ? void 0 : leadingHtmlCommentMeta.semantic;
+      const serverSectionId = leadingHtmlCommentMeta == null ? void 0 : leadingHtmlCommentMeta.id;
+      if (isEntityCompProps(props) && isItemsFromContentSection(sectionType, semantic, serverSectionId) && context.enrichEntityProps) {
+        props = context.enrichEntityProps(props, {
+          payload: context.payload,
+          clientConfig,
+          sectionType,
+          semantic,
+          serverSectionId
+        });
+      }
+      if (definition.singleInstance && context.tracking && context.tracking.getComponentCount(sectionType) > 0) {
+        continue;
+      }
+      const isNullComponent = definition.nullComponent === true;
+      if (isNullComponent) {
+        return {
+          parsedCount: parsedNodes
+        };
+      }
+      const intent = (_context$intent = context.intent) == null ? void 0 : _context$intent.intent;
+      const Component = registry.resolveSection(sectionType, {
+        intent,
+        semantic,
+        placement,
+        placementId
+      });
+      const resolvedSectionOptions = registry.resolveSectionOptions(sectionType, {
+        intent,
+        semantic,
+        placement,
+        placementId
+      });
+      const component = /*#__PURE__*/React.createElement(Component, props);
+      const componentName = Component.displayName || Component.name || undefined;
+      const section = createPageSection({
+        sectionType,
+        componentName,
+        semantic,
+        componentOptions: resolvedSectionOptions == null ? void 0 : resolvedSectionOptions.componentOptions,
+        index: sectionIndex,
+        id: serverSectionId,
+        component,
+        sourceMarkdown: '',
+        debugProps: {
+          ...props,
+          patternValidation: {
+            astStartIndex: result.astStartIndex,
+            astEndIndex: result.astEndIndex,
+            endIndex: result.endIndex
+          }
+        }
+      });
+      return {
+        section,
+        parsedCount: parsedNodes
+      };
+    }
+  }
+  return {};
+}
+//# sourceMappingURL=componentParser.js.map

package/dist/esm/component/componentParser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","validatePattern","nodesToParts","isWeb5ImageUrl","findInvalidWeb5Links","DIAGNOSTIC_TYPES","ComponentTracking","DiagnosticsCollector","parseAstToMarkdown","parseMarkdownToAst","preprocessMarkdown","getIntentFromMarkdown","getContextualImageFilename","createPageSection","isEntityCompProps","props","Array","isArray","items","isItemsFromContentSection","sectionType","semantic","serverSectionId","normalizedSemantic","toLowerCase","replace","normalizedId","includes","mergeSectionsWithStableReferences","existingSections","newSections","length","merged","i","_existing$sourceMarkd","_updated$sourceMarkdo","existing","updated","push","existingLength","sourceMarkdown","updatedLength","component","componentOptions","debugProps","isSkeleton","newSectionsToAdd","slice","combineAdjacentGeneralTextSections","sections","registry","placement","placementId","combined","currentSection","sectionsToCombine","j","mergedSection","mergeGeneralTextSections","index","Error","mergedSourceMarkdown","map","section","filter","markdown","trim","join","mergedProps","FallbackComponent","resolveSection","mergedComponent","createElement","componentName","displayName","name","parseMarkdownToComponents","pageMarkdown","options","_clientConfig$feature","clientConfig","enrichEntityProps","clientId","intentInfo","providedIntent","payload","disableContextualImages","explicitDisableImages","preprocessedMarkdown","diagnostics","preprocessDiagnostics","allNodes","children","nodes","tracking","diagnosticsCollector","d","report","diagnosticType","type","sectionIndex","details","original","normalized","features","disableContextualImagesEnrichment","context","intent","currentGlobalIndex","startIndex","parsedCount","tryParseComponent","endIndex","addRange","splice","link","label","reason","LEGACY_PROTOCOL_LINK","INVALID_LINK_FORMAT","BROKEN_WEB5_LINK","nodeType","url","combinedSections","definitions","getAllDefinitions","allowedKeywords","allowedImageSearchKeywords","baseParseContext","getContextualImage","undefined","contentParts","result","filename","getComponentCount","setMeta","key","value","getMeta","definition","isPlacementOnly","pattern","patterns","_parts$find","_context$intent","valid","parsedNodes","astEndIndex","maxNodes","maxConsumedNodes","matchedNodes","parts","parseContext","reportDiagnostic","parse","leadingHtmlCommentMeta","find","p","meta","id","singleInstance","isNullComponent","nullComponent","Component","resolvedSectionOptions","resolveSectionOptions","patternValidation","astStartIndex"],"sources":["../../../src/component/componentParser.ts"],"sourcesContent":["/**\n * Markdown → component orchestrator. Lifted from\n * `web50-server-ui/src/utils/componentParser.ts` per DL #088 B9.5.\n *\n * The lift replaces three app-side singletons with options:\n *  - `getAppRegistry()` → `options.registry`\n *  - `getClientConfigSync(clientId)` → `options.clientConfig`\n *  - `setLastDiagnosticsCollector(...)` → returned in the result object\n *\n * Adds a `placement` option that flows into every `registry.resolveSection`\n * call so the placement bundle can pick the placement variant of each section.\n *\n * The app-side `componentParser.ts` is a thin wrapper around this orchestrator\n * that pre-binds its singletons and a product-payload enrichment callback.\n */\nimport type { RootContent } from 'mdast';\nimport React from 'react';\n\nimport { validatePattern } from '../patternValidator';\nimport { nodesToParts } from '../match/astToParts';\nimport { isWeb5ImageUrl } from '../types/link-types';\nimport { findInvalidWeb5Links } from '../utils/web5LinkValidator';\nimport { DIAGNOSTIC_TYPES, type DiagnosticType } from './diagnosticTypes';\nimport { ComponentTracking } from '../utils/componentTracking';\nimport {\n  DiagnosticsCollector,\n} from '../utils/diagnosticsCollector';\nimport {\n  parseAstToMarkdown,\n  parseMarkdownToAst,\n} from '../utils/unifiedMarkdownParser';\nimport { preprocessMarkdown } from '../utils/markdownPreprocessor';\nimport { getIntentFromMarkdown, type IntentInfo } from '../utils/intentExtractor';\nimport { getContextualImageFilename } from '../utils/contentKeywordMatcher';\nimport { createPageSection } from '../utils/propsExtractor';\nimport type { PageSection } from '../types/page-section';\nimport type { ApiPayloadItem } from '../types/entity';\nimport type { ComponentRegistry } from '../registry';\nimport type {\n  EntityCompProps,\n  GeneralTextCompProps,\n} from './types';\nimport type { SectionDefinition, ParseContext } from './section-definition';\nimport type {\n  EnrichEntityProps,\n  ParserClientConfig,\n  ParserContext,\n} from './parser-types';\n\nexport type { ComponentMatch, ParserContext } from './parser-types';\n\nexport interface ParseMarkdownOptions {\n  /** Required — replaces the app-side `getAppRegistry()` singleton. */\n  registry: ComponentRegistry<React.FC<any>>;\n  /** Replaces `getClientConfigSync(clientId)` — caller resolves it first. */\n  clientConfig?: ParserClientConfig | null;\n  /** When true, resolveSection prefers placement variants (DL #088 D3.1). */\n  placement?: boolean;\n  /**\n   * Placement slot id (the `data-web5-placement` value) — forwarded to\n   * `resolveSection` so a section can resolve a per-placement variant. Only\n   * meaningful with `placement: true`.\n   */\n  placementId?: string;\n  /** App-specific payload-to-entity enrichment; omitted by the placement bundle. */\n  enrichEntityProps?: EnrichEntityProps;\n  /** Reuse an existing collector (e.g. for streaming) instead of creating one. */\n  diagnosticsCollector?: DiagnosticsCollector;\n  clientId?: string;\n  intentInfo?: IntentInfo | null;\n  payload?: ApiPayloadItem[];\n  disableContextualImages?: boolean;\n}\n\nexport interface ParseMarkdownResult {\n  sections: PageSection[];\n  tracking: ComponentTracking;\n  diagnosticsCollector: DiagnosticsCollector;\n}\n\nfunction isEntityCompProps(props: unknown): props is EntityCompProps {\n  return (\n    typeof props === 'object' &&\n    props !== null &&\n    Array.isArray((props as EntityCompProps).items)\n  );\n}\n\nfunction isItemsFromContentSection(\n  sectionType: string,\n  semantic?: string,\n  serverSectionId?: string,\n): boolean {\n  if (sectionType !== 'entity') {\n    return false;\n  }\n  const normalizedSemantic = semantic?.toLowerCase().replace(/_/g, '-');\n  const normalizedId = serverSectionId?.toLowerCase().replace(/_/g, '-');\n  return (\n    normalizedSemantic === 'items' ||\n    normalizedSemantic === 'items-from-content' ||\n    normalizedId?.includes('items-from-content') === true\n  );\n}\n\n/**\n * Merges new sections with existing sections, maintaining stable references\n * for unchanged sections to prevent unnecessary rerenders.\n */\nexport function mergeSectionsWithStableReferences(\n  existingSections: PageSection[],\n  newSections: PageSection[],\n): PageSection[] {\n  if (existingSections.length === 0) {\n    return newSections;\n  }\n  if (newSections.length < existingSections.length) {\n    return newSections;\n  }\n\n  const merged: PageSection[] = [];\n\n  for (let i = 0; i < existingSections.length; i++) {\n    const existing = existingSections[i];\n    const updated = newSections[i];\n\n    if (!updated) {\n      merged.push(existing);\n      continue;\n    }\n\n    const existingLength = existing.sourceMarkdown?.length || 0;\n    const updatedLength = updated.sourceMarkdown?.length || 0;\n\n    if (existingLength === updatedLength) {\n      existing.sourceMarkdown = updated.sourceMarkdown;\n      existing.component = updated.component;\n      existing.componentOptions = updated.componentOptions;\n      existing.debugProps = updated.debugProps;\n      // V3 (DL #106): a skeleton and its real section both have empty\n      // sourceMarkdown, so without carrying this flag the slot would stay a\n      // skeleton forever (its real component never rendering).\n      existing.isSkeleton = updated.isSkeleton;\n      merged.push(existing);\n    } else {\n      merged.push(updated);\n    }\n  }\n\n  if (newSections.length > existingSections.length) {\n    const newSectionsToAdd = newSections.slice(existingSections.length);\n    merged.push(...newSectionsToAdd);\n  }\n\n  return merged;\n}\n\nfunction combineAdjacentGeneralTextSections(\n  sections: PageSection[],\n  registry: ComponentRegistry<React.FC<any>>,\n  placement?: boolean,\n  placementId?: string,\n): PageSection[] {\n  if (sections.length === 0) {\n    return sections;\n  }\n\n  const combined: PageSection[] = [];\n  let i = 0;\n\n  while (i < sections.length) {\n    const currentSection = sections[i];\n    if (currentSection.sectionType === 'fallback') {\n      const sectionsToCombine: PageSection[] = [currentSection];\n      let j = i + 1;\n\n      while (j < sections.length && sections[j].sectionType === 'fallback') {\n        sectionsToCombine.push(sections[j]);\n        j++;\n      }\n\n      if (sectionsToCombine.length > 1) {\n        const mergedSection = mergeGeneralTextSections(\n          sectionsToCombine,\n          combined.length,\n          registry,\n          placement,\n          placementId,\n        );\n        combined.push(mergedSection);\n        i = j;\n      } else {\n        combined.push(currentSection);\n        i++;\n      }\n    } else {\n      combined.push(currentSection);\n      i++;\n    }\n  }\n\n  return combined;\n}\n\nfunction mergeGeneralTextSections(\n  sections: PageSection[],\n  index: number,\n  registry: ComponentRegistry<React.FC<any>>,\n  placement?: boolean,\n  placementId?: string,\n): PageSection {\n  if (sections.length === 0) {\n    throw new Error('Cannot merge empty sections array');\n  }\n  if (sections.length === 1) {\n    return sections[0];\n  }\n\n  const mergedSourceMarkdown = sections\n    .map((section) => section.sourceMarkdown || '')\n    .filter((markdown) => markdown.trim().length > 0)\n    .join('\\n\\n');\n\n  const mergedProps: GeneralTextCompProps = {\n    markdown: mergedSourceMarkdown,\n  };\n\n  const FallbackComponent = registry.resolveSection('fallback', {\n    placement,\n    placementId,\n  });\n  const mergedComponent = React.createElement(FallbackComponent, mergedProps);\n\n  return createPageSection({\n    sectionType: 'fallback',\n    componentName:\n      (FallbackComponent as React.FC).displayName || FallbackComponent.name,\n    index,\n    component: mergedComponent,\n    sourceMarkdown: mergedSourceMarkdown,\n    debugProps: mergedProps,\n  });\n}\n\nexport function parseMarkdownToComponents(\n  pageMarkdown: string,\n  options: ParseMarkdownOptions,\n): ParseMarkdownResult {\n  const {\n    registry,\n    clientConfig,\n    placement,\n    placementId,\n    enrichEntityProps,\n    clientId,\n    intentInfo: providedIntent,\n    payload,\n    disableContextualImages: explicitDisableImages,\n  } = options;\n\n  const { markdown: preprocessedMarkdown, diagnostics: preprocessDiagnostics } =\n    preprocessMarkdown(pageMarkdown);\n\n  const intentInfo =\n    providedIntent ?? getIntentFromMarkdown(preprocessedMarkdown);\n\n  const allNodes: RootContent[] = [\n    ...parseMarkdownToAst(preprocessedMarkdown).children,\n  ];\n  const nodes: RootContent[] = [...allNodes];\n\n  const sections: PageSection[] = [];\n  const tracking = new ComponentTracking();\n  const diagnosticsCollector =\n    options.diagnosticsCollector ?? new DiagnosticsCollector();\n\n  for (const d of preprocessDiagnostics) {\n    diagnosticsCollector.report({\n      diagnosticType: d.type as DiagnosticType,\n      sectionType: 'preprocessor',\n      sectionIndex: -1,\n      details: `${d.original} → ${d.normalized}`,\n    });\n  }\n\n  const disableContextualImages =\n    explicitDisableImages ??\n    clientConfig?.features?.disableContextualImagesEnrichment ??\n    false;\n\n  const context: ParserContext = {\n    registry,\n    clientConfig,\n    placement,\n    placementId,\n    enrichEntityProps,\n    clientId,\n    intent: intentInfo,\n    tracking,\n    disableContextualImages,\n    diagnosticsCollector,\n    payload,\n  };\n  let currentGlobalIndex = 0;\n\n  while (nodes.length > 0) {\n    const startIndex = currentGlobalIndex;\n    const { section, parsedCount } = tryParseComponent(\n      nodes,\n      sections.length,\n      context,\n    );\n\n    if (!parsedCount) {\n      break;\n    }\n\n    if (section) {\n      section.sourceMarkdown = parseAstToMarkdown(nodes.slice(0, parsedCount));\n      sections.push(section);\n\n      const endIndex = startIndex + parsedCount;\n      tracking.addRange(\n        section.sectionType,\n        startIndex,\n        endIndex,\n        sections.length - 1,\n      );\n    } else {\n      const endIndex = startIndex + parsedCount;\n      tracking.addRange('', startIndex, endIndex, -1);\n    }\n\n    currentGlobalIndex += parsedCount;\n    nodes.splice(0, parsedCount);\n  }\n\n  for (const link of findInvalidWeb5Links(allNodes)) {\n    let diagnosticType: DiagnosticType;\n    let label: string;\n    switch (link.reason) {\n      case 'legacy':\n        diagnosticType = DIAGNOSTIC_TYPES.LEGACY_PROTOCOL_LINK;\n        label = 'legacy protocol';\n        break;\n      case 'empty':\n        diagnosticType = DIAGNOSTIC_TYPES.INVALID_LINK_FORMAT;\n        label = 'empty href';\n        break;\n      default:\n        diagnosticType = DIAGNOSTIC_TYPES.BROKEN_WEB5_LINK;\n        label = 'web5://';\n        break;\n    }\n    diagnosticsCollector.report({\n      diagnosticType,\n      sectionType: 'parser',\n      sectionIndex: -1,\n      details: `Invalid ${label} URL in ${link.nodeType}: ${link.url}`.slice(\n        0,\n        200,\n      ),\n    });\n  }\n\n  const combinedSections = combineAdjacentGeneralTextSections(\n    sections,\n    registry,\n    placement,\n    placementId,\n  );\n\n  return {\n    sections: combinedSections,\n    tracking,\n    diagnosticsCollector,\n  };\n}\n\nexport function tryParseComponent(\n  nodes: RootContent[],\n  sectionIndex: number,\n  context: ParserContext,\n): { section?: PageSection; parsedCount?: number } {\n  if (!nodes?.length) {\n    return {};\n  }\n\n  const registry = context.registry;\n  const placement = context.placement;\n  const placementId = context.placementId;\n  const definitions = registry.getAllDefinitions();\n\n  const clientConfig = context.clientConfig ?? null;\n  const allowedKeywords = clientConfig?.allowedImageSearchKeywords ?? [];\n  const disableContextualImages = context.disableContextualImages ?? false;\n\n  const baseParseContext: ParseContext = {\n    getContextualImage:\n      disableContextualImages || allowedKeywords.length === 0\n        ? undefined\n        : (contentParts) => {\n            const result = getContextualImageFilename(\n              contentParts,\n              allowedKeywords,\n              '',\n              context.tracking,\n            );\n            return isWeb5ImageUrl(result.filename) ? result : null;\n          },\n    getComponentCount: context.tracking\n      ? (sectionType) => context.tracking!.getComponentCount(sectionType)\n      : undefined,\n    setMeta: context.tracking\n      ? (sectionType, key, value) =>\n          context.tracking!.setMeta(sectionType, key, value)\n      : undefined,\n    getMeta: context.tracking\n      ? (sectionType, key) => context.tracking!.getMeta(sectionType, key)\n      : undefined,\n  };\n\n  for (const { sectionType, definition } of definitions) {\n    // Placement-only definitions (registered with `{ placement: true }`\n    // variants and no non-placement variant) must not match in a non-placement\n    // render (the main app) — their markdown should fall through to the generic\n    // sections there. Skip them unless this is a placement parse.\n    if (!placement && registry.isPlacementOnly(sectionType)) {\n      continue;\n    }\n    for (const pattern of definition.patterns) {\n      const result = validatePattern(nodes, pattern);\n      if (!result.valid) {\n        continue;\n      }\n\n      let parsedNodes =\n        result.astEndIndex !== undefined && result.astEndIndex >= 0\n          ? result.astEndIndex + 1\n          : result.endIndex >= 0\n          ? result.endIndex + 1\n          : 1;\n\n      const maxNodes = (\n        definition as SectionDefinition & { maxConsumedNodes?: number }\n      ).maxConsumedNodes;\n      if (typeof maxNodes === 'number' && parsedNodes > maxNodes) {\n        parsedNodes = maxNodes;\n      }\n\n      const matchedNodes = nodes.slice(0, parsedNodes);\n      const parts = nodesToParts(matchedNodes);\n      const parseContext: ParseContext = {\n        ...baseParseContext,\n        reportDiagnostic: context.diagnosticsCollector\n          ? (type, details) => {\n              context.diagnosticsCollector!.report({\n                diagnosticType: type,\n                sectionType,\n                sectionIndex,\n                details: details.slice(0, 200),\n              });\n            }\n          : undefined,\n      };\n      let props = definition.parse(parts, parseContext);\n\n      if (props === null) {\n        continue;\n      }\n\n      const leadingHtmlCommentMeta = parts.find(\n        (p) => p.type === 'htmlComment' && p.meta,\n      )?.meta;\n      const semantic = leadingHtmlCommentMeta?.semantic as string | undefined;\n      const serverSectionId = leadingHtmlCommentMeta?.id as string | undefined;\n\n      if (\n        isEntityCompProps(props) &&\n        isItemsFromContentSection(sectionType, semantic, serverSectionId) &&\n        context.enrichEntityProps\n      ) {\n        props = context.enrichEntityProps(props, {\n          payload: context.payload,\n          clientConfig,\n          sectionType,\n          semantic,\n          serverSectionId,\n        });\n      }\n\n      if (\n        definition.singleInstance &&\n        context.tracking &&\n        context.tracking.getComponentCount(sectionType) > 0\n      ) {\n        continue;\n      }\n\n      const isNullComponent =\n        (definition as SectionDefinition & { nullComponent?: boolean })\n          .nullComponent === true;\n      if (isNullComponent) {\n        return { parsedCount: parsedNodes };\n      }\n\n      const intent = context.intent?.intent;\n      const Component = registry.resolveSection(sectionType, {\n        intent,\n        semantic,\n        placement,\n        placementId,\n      });\n      const resolvedSectionOptions = registry.resolveSectionOptions(\n        sectionType,\n        { intent, semantic, placement, placementId },\n      );\n      const component = React.createElement(Component, props);\n      const componentName =\n        Component.displayName || Component.name || undefined;\n\n      const section = createPageSection({\n        sectionType,\n        componentName,\n        semantic,\n        componentOptions: resolvedSectionOptions?.componentOptions,\n        index: sectionIndex,\n        id: serverSectionId,\n        component,\n        sourceMarkdown: '',\n        debugProps: {\n          ...props,\n          patternValidation: {\n            astStartIndex: result.astStartIndex,\n            astEndIndex: result.astEndIndex,\n            endIndex: result.endIndex,\n          },\n        },\n      });\n\n      return { section, parsedCount: parsedNodes };\n    }\n  }\n\n  return {};\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,eAAe,QAAQ,qBAAqB;AACrD,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,cAAc,QAAQ,qBAAqB;AACpD,SAASC,oBAAoB,QAAQ,4BAA4B;AACjE,SAASC,gBAAgB,QAA6B,mBAAmB;AACzE,SAASC,iBAAiB,QAAQ,4BAA4B;AAC9D,SACEC,oBAAoB,QACf,+BAA+B;AACtC,SACEC,kBAAkB,EAClBC,kBAAkB,QACb,gCAAgC;AACvC,SAASC,kBAAkB,QAAQ,+BAA+B;AAClE,SAASC,qBAAqB,QAAyB,0BAA0B;AACjF,SAASC,0BAA0B,QAAQ,gCAAgC;AAC3E,SAASC,iBAAiB,QAAQ,yBAAyB;AA8C3D,SAASC,iBAAiBA,CAACC,KAAc,EAA4B;EACnE,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACdC,KAAK,CAACC,OAAO,CAAEF,KAAK,CAAqBG,KAAK,CAAC;AAEnD;AAEA,SAASC,yBAAyBA,CAChCC,WAAmB,EACnBC,QAAiB,EACjBC,eAAwB,EACf;EACT,IAAIF,WAAW,KAAK,QAAQ,EAAE;IAC5B,OAAO,KAAK;EACd;EACA,MAAMG,kBAAkB,GAAGF,QAAQ,oBAARA,QAAQ,CAAEG,WAAW,CAAC,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;EACrE,MAAMC,YAAY,GAAGJ,eAAe,oBAAfA,eAAe,CAAEE,WAAW,CAAC,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;EACtE,OACEF,kBAAkB,KAAK,OAAO,IAC9BA,kBAAkB,KAAK,oBAAoB,IAC3C,CAAAG,YAAY,oBAAZA,YAAY,CAAEC,QAAQ,CAAC,oBAAoB,CAAC,MAAK,IAAI;AAEzD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,iCAAiCA,CAC/CC,gBAA+B,EAC/BC,WAA0B,EACX;EACf,IAAID,gBAAgB,CAACE,MAAM,KAAK,CAAC,EAAE;IACjC,OAAOD,WAAW;EACpB;EACA,IAAIA,WAAW,CAACC,MAAM,GAAGF,gBAAgB,CAACE,MAAM,EAAE;IAChD,OAAOD,WAAW;EACpB;EAEA,MAAME,MAAqB,GAAG,EAAE;EAEhC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGJ,gBAAgB,CAACE,MAAM,EAAEE,CAAC,EAAE,EAAE;IAAA,IAAAC,qBAAA,EAAAC,qBAAA;IAChD,MAAMC,QAAQ,GAAGP,gBAAgB,CAACI,CAAC,CAAC;IACpC,MAAMI,OAAO,GAAGP,WAAW,CAACG,CAAC,CAAC;IAE9B,IAAI,CAACI,OAAO,EAAE;MACZL,MAAM,CAACM,IAAI,CAACF,QAAQ,CAAC;MACrB;IACF;IAEA,MAAMG,cAAc,GAAG,EAAAL,qBAAA,GAAAE,QAAQ,CAACI,cAAc,qBAAvBN,qBAAA,CAAyBH,MAAM,KAAI,CAAC;IAC3D,MAAMU,aAAa,GAAG,EAAAN,qBAAA,GAAAE,OAAO,CAACG,cAAc,qBAAtBL,qBAAA,CAAwBJ,MAAM,KAAI,CAAC;IAEzD,IAAIQ,cAAc,KAAKE,aAAa,EAAE;MACpCL,QAAQ,CAACI,cAAc,GAAGH,OAAO,CAACG,cAAc;MAChDJ,QAAQ,CAACM,SAAS,GAAGL,OAAO,CAACK,SAAS;MACtCN,QAAQ,CAACO,gBAAgB,GAAGN,OAAO,CAACM,gBAAgB;MACpDP,QAAQ,CAACQ,UAAU,GAAGP,OAAO,CAACO,UAAU;MACxC;MACA;MACA;MACAR,QAAQ,CAACS,UAAU,GAAGR,OAAO,CAACQ,UAAU;MACxCb,MAAM,CAACM,IAAI,CAACF,QAAQ,CAAC;IACvB,CAAC,MAAM;MACLJ,MAAM,CAACM,IAAI,CAACD,OAAO,CAAC;IACtB;EACF;EAEA,IAAIP,WAAW,CAACC,MAAM,GAAGF,gBAAgB,CAACE,MAAM,EAAE;IAChD,MAAMe,gBAAgB,GAAGhB,WAAW,CAACiB,KAAK,CAAClB,gBAAgB,CAACE,MAAM,CAAC;IACnEC,MAAM,CAACM,IAAI,CAAC,GAAGQ,gBAAgB,CAAC;EAClC;EAEA,OAAOd,MAAM;AACf;AAEA,SAASgB,kCAAkCA,CACzCC,QAAuB,EACvBC,QAA0C,EAC1CC,SAAmB,EACnBC,WAAoB,EACL;EACf,IAAIH,QAAQ,CAAClB,MAAM,KAAK,CAAC,EAAE;IACzB,OAAOkB,QAAQ;EACjB;EAEA,MAAMI,QAAuB,GAAG,EAAE;EAClC,IAAIpB,CAAC,GAAG,CAAC;EAET,OAAOA,CAAC,GAAGgB,QAAQ,CAAClB,MAAM,EAAE;IAC1B,MAAMuB,cAAc,GAAGL,QAAQ,CAAChB,CAAC,CAAC;IAClC,IAAIqB,cAAc,CAAClC,WAAW,KAAK,UAAU,EAAE;MAC7C,MAAMmC,iBAAgC,GAAG,CAACD,cAAc,CAAC;MACzD,IAAIE,CAAC,GAAGvB,CAAC,GAAG,CAAC;MAEb,OAAOuB,CAAC,GAAGP,QAAQ,CAAClB,MAAM,IAAIkB,QAAQ,CAACO,CAAC,CAAC,CAACpC,WAAW,KAAK,UAAU,EAAE;QACpEmC,iBAAiB,CAACjB,IAAI,CAACW,QAAQ,CAACO,CAAC,CAAC,CAAC;QACnCA,CAAC,EAAE;MACL;MAEA,IAAID,iBAAiB,CAACxB,MAAM,GAAG,CAAC,EAAE;QAChC,MAAM0B,aAAa,GAAGC,wBAAwB,CAC5CH,iBAAiB,EACjBF,QAAQ,CAACtB,MAAM,EACfmB,QAAQ,EACRC,SAAS,EACTC,WACF,CAAC;QACDC,QAAQ,CAACf,IAAI,CAACmB,aAAa,CAAC;QAC5BxB,CAAC,GAAGuB,CAAC;MACP,CAAC,MAAM;QACLH,QAAQ,CAACf,IAAI,CAACgB,cAAc,CAAC;QAC7BrB,CAAC,EAAE;MACL;IACF,CAAC,MAAM;MACLoB,QAAQ,CAACf,IAAI,CAACgB,cAAc,CAAC;MAC7BrB,CAAC,EAAE;IACL;EACF;EAEA,OAAOoB,QAAQ;AACjB;AAEA,SAASK,wBAAwBA,CAC/BT,QAAuB,EACvBU,KAAa,EACbT,QAA0C,EAC1CC,SAAmB,EACnBC,WAAoB,EACP;EACb,IAAIH,QAAQ,CAAClB,MAAM,KAAK,CAAC,EAAE;IACzB,MAAM,IAAI6B,KAAK,CAAC,mCAAmC,CAAC;EACtD;EACA,IAAIX,QAAQ,CAAClB,MAAM,KAAK,CAAC,EAAE;IACzB,OAAOkB,QAAQ,CAAC,CAAC,CAAC;EACpB;EAEA,MAAMY,oBAAoB,GAAGZ,QAAQ,CAClCa,GAAG,CAAEC,OAAO,IAAKA,OAAO,CAACvB,cAAc,IAAI,EAAE,CAAC,CAC9CwB,MAAM,CAAEC,QAAQ,IAAKA,QAAQ,CAACC,IAAI,CAAC,CAAC,CAACnC,MAAM,GAAG,CAAC,CAAC,CAChDoC,IAAI,CAAC,MAAM,CAAC;EAEf,MAAMC,WAAiC,GAAG;IACxCH,QAAQ,EAAEJ;EACZ,CAAC;EAED,MAAMQ,iBAAiB,GAAGnB,QAAQ,CAACoB,cAAc,CAAC,UAAU,EAAE;IAC5DnB,SAAS;IACTC;EACF,CAAC,CAAC;EACF,MAAMmB,eAAe,gBAAGvE,KAAK,CAACwE,aAAa,CAACH,iBAAiB,EAAED,WAAW,CAAC;EAE3E,OAAOvD,iBAAiB,CAAC;IACvBO,WAAW,EAAE,UAAU;IACvBqD,aAAa,EACVJ,iBAAiB,CAAcK,WAAW,IAAIL,iBAAiB,CAACM,IAAI;IACvEhB,KAAK;IACLjB,SAAS,EAAE6B,eAAe;IAC1B/B,cAAc,EAAEqB,oBAAoB;IACpCjB,UAAU,EAAEwB;EACd,CAAC,CAAC;AACJ;AAEA,OAAO,SAASQ,yBAAyBA,CACvCC,YAAoB,EACpBC,OAA6B,EACR;EAAA,IAAAC,qBAAA;EACrB,MAAM;IACJ7B,QAAQ;IACR8B,YAAY;IACZ7B,SAAS;IACTC,WAAW;IACX6B,iBAAiB;IACjBC,QAAQ;IACRC,UAAU,EAAEC,cAAc;IAC1BC,OAAO;IACPC,uBAAuB,EAAEC;EAC3B,CAAC,GAAGT,OAAO;EAEX,MAAM;IAAEb,QAAQ,EAAEuB,oBAAoB;IAAEC,WAAW,EAAEC;EAAsB,CAAC,GAC1EhF,kBAAkB,CAACmE,YAAY,CAAC;EAElC,MAAMM,UAAU,GACdC,cAAc,IAAIzE,qBAAqB,CAAC6E,oBAAoB,CAAC;EAE/D,MAAMG,QAAuB,GAAG,CAC9B,GAAGlF,kBAAkB,CAAC+E,oBAAoB,CAAC,CAACI,QAAQ,CACrD;EACD,MAAMC,KAAoB,GAAG,CAAC,GAAGF,QAAQ,CAAC;EAE1C,MAAM1C,QAAuB,GAAG,EAAE;EAClC,MAAM6C,QAAQ,GAAG,IAAIxF,iBAAiB,CAAC,CAAC;EACxC,MAAMyF,oBAAoB,GACxBjB,OAAO,CAACiB,oBAAoB,IAAI,IAAIxF,oBAAoB,CAAC,CAAC;EAE5D,KAAK,MAAMyF,CAAC,IAAIN,qBAAqB,EAAE;IACrCK,oBAAoB,CAACE,MAAM,CAAC;MAC1BC,cAAc,EAAEF,CAAC,CAACG,IAAsB;MACxC/E,WAAW,EAAE,cAAc;MAC3BgF,YAAY,EAAE,CAAC,CAAC;MAChBC,OAAO,EAAE,GAAGL,CAAC,CAACM,QAAQ,MAAMN,CAAC,CAACO,UAAU;IAC1C,CAAC,CAAC;EACJ;EAEA,MAAMjB,uBAAuB,GAC3BC,qBAAqB,KACrBP,YAAY,aAAAD,qBAAA,GAAZC,YAAY,CAAEwB,QAAQ,qBAAtBzB,qBAAA,CAAwB0B,iCAAiC,KACzD,KAAK;EAEP,MAAMC,OAAsB,GAAG;IAC7BxD,QAAQ;IACR8B,YAAY;IACZ7B,SAAS;IACTC,WAAW;IACX6B,iBAAiB;IACjBC,QAAQ;IACRyB,MAAM,EAAExB,UAAU;IAClBW,QAAQ;IACRR,uBAAuB;IACvBS,oBAAoB;IACpBV;EACF,CAAC;EACD,IAAIuB,kBAAkB,GAAG,CAAC;EAE1B,OAAOf,KAAK,CAAC9D,MAAM,GAAG,CAAC,EAAE;IACvB,MAAM8E,UAAU,GAAGD,kBAAkB;IACrC,MAAM;MAAE7C,OAAO;MAAE+C;IAAY,CAAC,GAAGC,iBAAiB,CAChDlB,KAAK,EACL5C,QAAQ,CAAClB,MAAM,EACf2E,OACF,CAAC;IAED,IAAI,CAACI,WAAW,EAAE;MAChB;IACF;IAEA,IAAI/C,OAAO,EAAE;MACXA,OAAO,CAACvB,cAAc,GAAGhC,kBAAkB,CAACqF,KAAK,CAAC9C,KAAK,CAAC,CAAC,EAAE+D,WAAW,CAAC,CAAC;MACxE7D,QAAQ,CAACX,IAAI,CAACyB,OAAO,CAAC;MAEtB,MAAMiD,QAAQ,GAAGH,UAAU,GAAGC,WAAW;MACzChB,QAAQ,CAACmB,QAAQ,CACflD,OAAO,CAAC3C,WAAW,EACnByF,UAAU,EACVG,QAAQ,EACR/D,QAAQ,CAAClB,MAAM,GAAG,CACpB,CAAC;IACH,CAAC,MAAM;MACL,MAAMiF,QAAQ,GAAGH,UAAU,GAAGC,WAAW;MACzChB,QAAQ,CAACmB,QAAQ,CAAC,EAAE,EAAEJ,UAAU,EAAEG,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjD;IAEAJ,kBAAkB,IAAIE,WAAW;IACjCjB,KAAK,CAACqB,MAAM,CAAC,CAAC,EAAEJ,WAAW,CAAC;EAC9B;EAEA,KAAK,MAAMK,IAAI,IAAI/G,oBAAoB,CAACuF,QAAQ,CAAC,EAAE;IACjD,IAAIO,cAA8B;IAClC,IAAIkB,KAAa;IACjB,QAAQD,IAAI,CAACE,MAAM;MACjB,KAAK,QAAQ;QACXnB,cAAc,GAAG7F,gBAAgB,CAACiH,oBAAoB;QACtDF,KAAK,GAAG,iBAAiB;QACzB;MACF,KAAK,OAAO;QACVlB,cAAc,GAAG7F,gBAAgB,CAACkH,mBAAmB;QACrDH,KAAK,GAAG,YAAY;QACpB;MACF;QACElB,cAAc,GAAG7F,gBAAgB,CAACmH,gBAAgB;QAClDJ,KAAK,GAAG,SAAS;QACjB;IACJ;IACArB,oBAAoB,CAACE,MAAM,CAAC;MAC1BC,cAAc;MACd9E,WAAW,EAAE,QAAQ;MACrBgF,YAAY,EAAE,CAAC,CAAC;MAChBC,OAAO,EAAE,WAAWe,KAAK,WAAWD,IAAI,CAACM,QAAQ,KAAKN,IAAI,CAACO,GAAG,EAAE,CAAC3E,KAAK,CACpE,CAAC,EACD,GACF;IACF,CAAC,CAAC;EACJ;EAEA,MAAM4E,gBAAgB,GAAG3E,kCAAkC,CACzDC,QAAQ,EACRC,QAAQ,EACRC,SAAS,EACTC,WACF,CAAC;EAED,OAAO;IACLH,QAAQ,EAAE0E,gBAAgB;IAC1B7B,QAAQ;IACRC;EACF,CAAC;AACH;AAEA,OAAO,SAASgB,iBAAiBA,CAC/BlB,KAAoB,EACpBO,YAAoB,EACpBM,OAAsB,EAC2B;EACjD,IAAI,EAACb,KAAK,YAALA,KAAK,CAAE9D,MAAM,GAAE;IAClB,OAAO,CAAC,CAAC;EACX;EAEA,MAAMmB,QAAQ,GAAGwD,OAAO,CAACxD,QAAQ;EACjC,MAAMC,SAAS,GAAGuD,OAAO,CAACvD,SAAS;EACnC,MAAMC,WAAW,GAAGsD,OAAO,CAACtD,WAAW;EACvC,MAAMwE,WAAW,GAAG1E,QAAQ,CAAC2E,iBAAiB,CAAC,CAAC;EAEhD,MAAM7C,YAAY,GAAG0B,OAAO,CAAC1B,YAAY,IAAI,IAAI;EACjD,MAAM8C,eAAe,GAAG,CAAA9C,YAAY,oBAAZA,YAAY,CAAE+C,0BAA0B,KAAI,EAAE;EACtE,MAAMzC,uBAAuB,GAAGoB,OAAO,CAACpB,uBAAuB,IAAI,KAAK;EAExE,MAAM0C,gBAA8B,GAAG;IACrCC,kBAAkB,EAChB3C,uBAAuB,IAAIwC,eAAe,CAAC/F,MAAM,KAAK,CAAC,GACnDmG,SAAS,GACRC,YAAY,IAAK;MAChB,MAAMC,MAAM,GAAGxH,0BAA0B,CACvCuH,YAAY,EACZL,eAAe,EACf,EAAE,EACFpB,OAAO,CAACZ,QACV,CAAC;MACD,OAAO3F,cAAc,CAACiI,MAAM,CAACC,QAAQ,CAAC,GAAGD,MAAM,GAAG,IAAI;IACxD,CAAC;IACPE,iBAAiB,EAAE5B,OAAO,CAACZ,QAAQ,GAC9B1E,WAAW,IAAKsF,OAAO,CAACZ,QAAQ,CAAEwC,iBAAiB,CAAClH,WAAW,CAAC,GACjE8G,SAAS;IACbK,OAAO,EAAE7B,OAAO,CAACZ,QAAQ,GACrB,CAAC1E,WAAW,EAAEoH,GAAG,EAAEC,KAAK,KACtB/B,OAAO,CAACZ,QAAQ,CAAEyC,OAAO,CAACnH,WAAW,EAAEoH,GAAG,EAAEC,KAAK,CAAC,GACpDP,SAAS;IACbQ,OAAO,EAAEhC,OAAO,CAACZ,QAAQ,GACrB,CAAC1E,WAAW,EAAEoH,GAAG,KAAK9B,OAAO,CAACZ,QAAQ,CAAE4C,OAAO,CAACtH,WAAW,EAAEoH,GAAG,CAAC,GACjEN;EACN,CAAC;EAED,KAAK,MAAM;IAAE9G,WAAW;IAAEuH;EAAW,CAAC,IAAIf,WAAW,EAAE;IACrD;IACA;IACA;IACA;IACA,IAAI,CAACzE,SAAS,IAAID,QAAQ,CAAC0F,eAAe,CAACxH,WAAW,CAAC,EAAE;MACvD;IACF;IACA,KAAK,MAAMyH,OAAO,IAAIF,UAAU,CAACG,QAAQ,EAAE;MAAA,IAAAC,WAAA,EAAAC,eAAA;MACzC,MAAMZ,MAAM,GAAGnI,eAAe,CAAC4F,KAAK,EAAEgD,OAAO,CAAC;MAC9C,IAAI,CAACT,MAAM,CAACa,KAAK,EAAE;QACjB;MACF;MAEA,IAAIC,WAAW,GACbd,MAAM,CAACe,WAAW,KAAKjB,SAAS,IAAIE,MAAM,CAACe,WAAW,IAAI,CAAC,GACvDf,MAAM,CAACe,WAAW,GAAG,CAAC,GACtBf,MAAM,CAACpB,QAAQ,IAAI,CAAC,GACpBoB,MAAM,CAACpB,QAAQ,GAAG,CAAC,GACnB,CAAC;MAEP,MAAMoC,QAAQ,GACZT,UAAU,CACVU,gBAAgB;MAClB,IAAI,OAAOD,QAAQ,KAAK,QAAQ,IAAIF,WAAW,GAAGE,QAAQ,EAAE;QAC1DF,WAAW,GAAGE,QAAQ;MACxB;MAEA,MAAME,YAAY,GAAGzD,KAAK,CAAC9C,KAAK,CAAC,CAAC,EAAEmG,WAAW,CAAC;MAChD,MAAMK,KAAK,GAAGrJ,YAAY,CAACoJ,YAAY,CAAC;MACxC,MAAME,YAA0B,GAAG;QACjC,GAAGxB,gBAAgB;QACnByB,gBAAgB,EAAE/C,OAAO,CAACX,oBAAoB,GAC1C,CAACI,IAAI,EAAEE,OAAO,KAAK;UACjBK,OAAO,CAACX,oBAAoB,CAAEE,MAAM,CAAC;YACnCC,cAAc,EAAEC,IAAI;YACpB/E,WAAW;YACXgF,YAAY;YACZC,OAAO,EAAEA,OAAO,CAACtD,KAAK,CAAC,CAAC,EAAE,GAAG;UAC/B,CAAC,CAAC;QACJ,CAAC,GACDmF;MACN,CAAC;MACD,IAAInH,KAAK,GAAG4H,UAAU,CAACe,KAAK,CAACH,KAAK,EAAEC,YAAY,CAAC;MAEjD,IAAIzI,KAAK,KAAK,IAAI,EAAE;QAClB;MACF;MAEA,MAAM4I,sBAAsB,IAAAZ,WAAA,GAAGQ,KAAK,CAACK,IAAI,CACtCC,CAAC,IAAKA,CAAC,CAAC1D,IAAI,KAAK,aAAa,IAAI0D,CAAC,CAACC,IACvC,CAAC,qBAF8Bf,WAAA,CAE5Be,IAAI;MACP,MAAMzI,QAAQ,GAAGsI,sBAAsB,oBAAtBA,sBAAsB,CAAEtI,QAA8B;MACvE,MAAMC,eAAe,GAAGqI,sBAAsB,oBAAtBA,sBAAsB,CAAEI,EAAwB;MAExE,IACEjJ,iBAAiB,CAACC,KAAK,CAAC,IACxBI,yBAAyB,CAACC,WAAW,EAAEC,QAAQ,EAAEC,eAAe,CAAC,IACjEoF,OAAO,CAACzB,iBAAiB,EACzB;QACAlE,KAAK,GAAG2F,OAAO,CAACzB,iBAAiB,CAAClE,KAAK,EAAE;UACvCsE,OAAO,EAAEqB,OAAO,CAACrB,OAAO;UACxBL,YAAY;UACZ5D,WAAW;UACXC,QAAQ;UACRC;QACF,CAAC,CAAC;MACJ;MAEA,IACEqH,UAAU,CAACqB,cAAc,IACzBtD,OAAO,CAACZ,QAAQ,IAChBY,OAAO,CAACZ,QAAQ,CAACwC,iBAAiB,CAAClH,WAAW,CAAC,GAAG,CAAC,EACnD;QACA;MACF;MAEA,MAAM6I,eAAe,GAClBtB,UAAU,CACRuB,aAAa,KAAK,IAAI;MAC3B,IAAID,eAAe,EAAE;QACnB,OAAO;UAAEnD,WAAW,EAAEoC;QAAY,CAAC;MACrC;MAEA,MAAMvC,MAAM,IAAAqC,eAAA,GAAGtC,OAAO,CAACC,MAAM,qBAAdqC,eAAA,CAAgBrC,MAAM;MACrC,MAAMwD,SAAS,GAAGjH,QAAQ,CAACoB,cAAc,CAAClD,WAAW,EAAE;QACrDuF,MAAM;QACNtF,QAAQ;QACR8B,SAAS;QACTC;MACF,CAAC,CAAC;MACF,MAAMgH,sBAAsB,GAAGlH,QAAQ,CAACmH,qBAAqB,CAC3DjJ,WAAW,EACX;QAAEuF,MAAM;QAAEtF,QAAQ;QAAE8B,SAAS;QAAEC;MAAY,CAC7C,CAAC;MACD,MAAMV,SAAS,gBAAG1C,KAAK,CAACwE,aAAa,CAAC2F,SAAS,EAAEpJ,KAAK,CAAC;MACvD,MAAM0D,aAAa,GACjB0F,SAAS,CAACzF,WAAW,IAAIyF,SAAS,CAACxF,IAAI,IAAIuD,SAAS;MAEtD,MAAMnE,OAAO,GAAGlD,iBAAiB,CAAC;QAChCO,WAAW;QACXqD,aAAa;QACbpD,QAAQ;QACRsB,gBAAgB,EAAEyH,sBAAsB,oBAAtBA,sBAAsB,CAAEzH,gBAAgB;QAC1DgB,KAAK,EAAEyC,YAAY;QACnB2D,EAAE,EAAEzI,eAAe;QACnBoB,SAAS;QACTF,cAAc,EAAE,EAAE;QAClBI,UAAU,EAAE;UACV,GAAG7B,KAAK;UACRuJ,iBAAiB,EAAE;YACjBC,aAAa,EAAEnC,MAAM,CAACmC,aAAa;YACnCpB,WAAW,EAAEf,MAAM,CAACe,WAAW;YAC/BnC,QAAQ,EAAEoB,MAAM,CAACpB;UACnB;QACF;MACF,CAAC,CAAC;MAEF,OAAO;QAAEjD,OAAO;QAAE+C,WAAW,EAAEoC;MAAY,CAAC;IAC9C;EACF;EAEA,OAAO,CAAC,CAAC;AACX","ignoreList":[]}

package/dist/esm/component/diagnosticTypes.js

@@ -0,0 +1,26 @@
+export const DIAGNOSTIC_TYPES = {
+  BROKEN_WEB5_LINK: 'broken_web5_link',
+  INVALID_LINK_FORMAT: 'invalid_link_format',
+  LEGACY_PROTOCOL_LINK: 'legacy_protocol_link',
+  MALFORMED_LIST: 'malformed_list',
+  MISSING_ENTITY_DATA: 'missing_entity_data',
+  SECTION_REJECTED: 'section_rejected',
+  ITEMS_DROPPED: 'items_dropped',
+  IMAGE_RESOLUTION_FAILED: 'image_resolution_failed',
+  ICON_RESOLUTION_FAILED: 'icon_resolution_failed',
+  UNKNOWN_ENTITY_TYPE: 'unknown_entity_type',
+  MISSING_NEXT_STEPS: 'missing_next_steps',
+  UNKNOWN_WEB5_ACTION: 'unknown_web5_action',
+  NO_CTA_REPLACED_WITH_ASK: 'no_cta_replaced_with_ask',
+  NEXT_STEPS_CAPPED: 'next_steps_capped',
+  ICON_URL_NORMALIZED: 'icon_url_normalized',
+  TABLE_SEPARATOR_INSERTED: 'table_separator_inserted',
+  MISSING_ENTITY_URL: 'missing_entity_url',
+  MISSING_ENTITY_IMAGE: 'missing_entity_image',
+  // V3 streaming shipped the whole page inline under id 0 with no per-section
+  // body frames (e.g. orchestrator rendered a full page → 0 placeholders → no
+  // sub-agents); the client rendered the id-0 buffer directly instead of the
+  // body-less slot skeletons.
+  V3_INLINE_FALLBACK: 'v3_inline_fallback'
+};
+//# sourceMappingURL=diagnosticTypes.js.map

package/dist/esm/component/diagnosticTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DIAGNOSTIC_TYPES","BROKEN_WEB5_LINK","INVALID_LINK_FORMAT","LEGACY_PROTOCOL_LINK","MALFORMED_LIST","MISSING_ENTITY_DATA","SECTION_REJECTED","ITEMS_DROPPED","IMAGE_RESOLUTION_FAILED","ICON_RESOLUTION_FAILED","UNKNOWN_ENTITY_TYPE","MISSING_NEXT_STEPS","UNKNOWN_WEB5_ACTION","NO_CTA_REPLACED_WITH_ASK","NEXT_STEPS_CAPPED","ICON_URL_NORMALIZED","TABLE_SEPARATOR_INSERTED","MISSING_ENTITY_URL","MISSING_ENTITY_IMAGE","V3_INLINE_FALLBACK"],"sources":["../../../src/component/diagnosticTypes.ts"],"sourcesContent":["export const DIAGNOSTIC_TYPES = {\n  BROKEN_WEB5_LINK: 'broken_web5_link',\n  INVALID_LINK_FORMAT: 'invalid_link_format',\n  LEGACY_PROTOCOL_LINK: 'legacy_protocol_link',\n  MALFORMED_LIST: 'malformed_list',\n  MISSING_ENTITY_DATA: 'missing_entity_data',\n  SECTION_REJECTED: 'section_rejected',\n  ITEMS_DROPPED: 'items_dropped',\n  IMAGE_RESOLUTION_FAILED: 'image_resolution_failed',\n  ICON_RESOLUTION_FAILED: 'icon_resolution_failed',\n  UNKNOWN_ENTITY_TYPE: 'unknown_entity_type',\n  MISSING_NEXT_STEPS: 'missing_next_steps',\n  UNKNOWN_WEB5_ACTION: 'unknown_web5_action',\n  NO_CTA_REPLACED_WITH_ASK: 'no_cta_replaced_with_ask',\n  NEXT_STEPS_CAPPED: 'next_steps_capped',\n  ICON_URL_NORMALIZED: 'icon_url_normalized',\n  TABLE_SEPARATOR_INSERTED: 'table_separator_inserted',\n  MISSING_ENTITY_URL: 'missing_entity_url',\n  MISSING_ENTITY_IMAGE: 'missing_entity_image',\n  // V3 streaming shipped the whole page inline under id 0 with no per-section\n  // body frames (e.g. orchestrator rendered a full page → 0 placeholders → no\n  // sub-agents); the client rendered the id-0 buffer directly instead of the\n  // body-less slot skeletons.\n  V3_INLINE_FALLBACK: 'v3_inline_fallback',\n} as const;\n\nexport type DiagnosticType =\n  (typeof DIAGNOSTIC_TYPES)[keyof typeof DIAGNOSTIC_TYPES];\n"],"mappings":"AAAA,OAAO,MAAMA,gBAAgB,GAAG;EAC9BC,gBAAgB,EAAE,kBAAkB;EACpCC,mBAAmB,EAAE,qBAAqB;EAC1CC,oBAAoB,EAAE,sBAAsB;EAC5CC,cAAc,EAAE,gBAAgB;EAChCC,mBAAmB,EAAE,qBAAqB;EAC1CC,gBAAgB,EAAE,kBAAkB;EACpCC,aAAa,EAAE,eAAe;EAC9BC,uBAAuB,EAAE,yBAAyB;EAClDC,sBAAsB,EAAE,wBAAwB;EAChDC,mBAAmB,EAAE,qBAAqB;EAC1CC,kBAAkB,EAAE,oBAAoB;EACxCC,mBAAmB,EAAE,qBAAqB;EAC1CC,wBAAwB,EAAE,0BAA0B;EACpDC,iBAAiB,EAAE,mBAAmB;EACtCC,mBAAmB,EAAE,qBAAqB;EAC1CC,wBAAwB,EAAE,0BAA0B;EACpDC,kBAAkB,EAAE,oBAAoB;EACxCC,oBAAoB,EAAE,sBAAsB;EAC5C;EACA;EACA;EACA;EACAC,kBAAkB,EAAE;AACtB,CAAU","ignoreList":[]}

package/dist/esm/component/parser-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser-types.js.map

package/dist/esm/component/parser-types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/component/parser-types.ts"],"sourcesContent":["/**\n * Parser context + helper types — lifted from\n * `web50-server-ui/src/utils/parserTypes.ts` per DL #088 B9.5.\n *\n * The lifted orchestrator (`parseMarkdownToComponents`) is dependency-injected:\n * - `registry` is a required option (no `getAppRegistry()` singleton in core)\n * - `clientConfig` is a minimal shape that matches both the full app config\n *   and a placement-bundle config\n * - `enrichEntityProps` is an optional plug for app-specific product-payload\n *   enrichment that the placement bundle omits\n */\nimport type { FC, ReactElement } from 'react';\nimport type { ComponentRegistry } from '../registry';\nimport type { ApiPayloadItem, EntityTypeConfig } from '../types/entity';\nimport type { ComponentTracking } from '../utils/componentTracking';\nimport type { DiagnosticsCollector } from '../utils/diagnosticsCollector';\nimport type { IntentInfo } from '../utils/intentExtractor';\nimport type { EntityCompProps } from './types';\n\nexport interface ComponentMatch {\n  component: ReactElement | null;\n  sectionType: string;\n  confidence: 'high' | 'medium' | 'low';\n  parsedNodes: number;\n  debugProps?: any;\n}\n\n/**\n * Minimal client-config shape the parser reads. The full\n * `ClientConfig` in `web50-server-ui` is assignable to this.\n */\nexport interface ParserClientConfig {\n  features?: {\n    disableContextualImagesEnrichment?: boolean;\n  };\n  allowedImageSearchKeywords?: string[];\n  entityConfig?: {\n    enabled: boolean;\n    entityTypes: Record<string, EntityTypeConfig>;\n  };\n}\n\n/**\n * Caller-injected enrichment hook for entity sections sourced from the API\n * payload. Returns possibly-modified EntityCompProps. Used by the full app\n * to merge product payload items into entity components; the placement\n * bundle omits this and the parser uses props as-is.\n */\nexport type EnrichEntityProps = (\n  props: EntityCompProps,\n  ctx: {\n    payload?: ApiPayloadItem[];\n    clientConfig?: ParserClientConfig | null;\n    sectionType: string;\n    semantic?: string;\n    serverSectionId?: string;\n  },\n) => EntityCompProps;\n\nexport interface ParserContext {\n  /** Required for resolving section components by type/intent/placement. */\n  registry: ComponentRegistry<FC<any>>;\n  /** Parser reads `features`, `allowedImageSearchKeywords`. */\n  clientConfig?: ParserClientConfig | null;\n  /** When true, resolveSection prefers placement variants (DL #088 D3.1). */\n  placement?: boolean;\n  /** Placement slot id (`data-web5-placement` value), forwarded to resolveSection. */\n  placementId?: string;\n  /** Optional caller-supplied enrichment for entity-section payload merging. */\n  enrichEntityProps?: EnrichEntityProps;\n  clientId?: string;\n  intent?: IntentInfo;\n  tracking?: ComponentTracking;\n  diagnosticsCollector?: DiagnosticsCollector;\n  disableContextualImages?: boolean;\n  payload?: ApiPayloadItem[];\n}\n"],"mappings":"","ignoreList":[]}

package/dist/esm/component/section-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-definition.js.map

package/dist/esm/component/section-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/component/section-definition.ts"],"sourcesContent":["import type { FC } from 'react';\nimport type { Part } from '../parts/parts';\nimport type { PropsOf, SectionFixture } from './types';\nimport type { DiagnosticType } from './diagnosticTypes';\n\nexport interface ContextualImageResult {\n  filename: string;\n  alt: string;\n  isFromText: boolean;\n}\n\nexport interface ParseContext {\n  /** Returns a contextual image://keyword URL based on content keywords. null = no match. */\n  getContextualImage?: (\n    contentParts: (string | undefined | null)[],\n  ) => ContextualImageResult | null;\n  /** Returns how many times a given sectionType has been matched so far in this parse run. */\n  getComponentCount?: (sectionType: string) => number;\n  /** Store a value scoped to a sectionType for the duration of the parse run. */\n  setMeta?: (sectionType: string, key: string, value: unknown) => void;\n  /** Retrieve a value previously stored via setMeta. */\n  getMeta?: (sectionType: string, key: string) => unknown;\n  /** Report a markdown diagnostic (e.g. broken link, invalid format). */\n  reportDiagnostic?: (type: DiagnosticType, details: string) => void;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SectionDefinition<T extends FC<any> = FC<any>> {\n  sectionType: string;\n  patterns: string[];\n  singleInstance?: boolean;\n  /** Cap the number of AST nodes consumed per match (e.g., 1 for the fallback parser). */\n  maxConsumedNodes?: number;\n  defaults?: PropsOf<T>;\n  fixtures: SectionFixture<PropsOf<T>>[];\n  parse(parts: Part[], context?: ParseContext): PropsOf<T> | null;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/esm/component/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +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  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 — aligned to ListItemsSectionProps */\nexport interface ListItemsSectionCompProps extends SectionCompProps {\n  title: string;\n  description?: string;\n  features: { title?: string; description: string }[];\n  imageUrl?: string;\n  imageFromText?: boolean;\n  variant: 'list' | 'cards';\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/esm/components/placement/PlacementPayloadContext.js

@@ -0,0 +1,24 @@
+import React from 'react';
+
+/**
+ * Carries the placement's `entityConfig` (from the client UMD's
+ * `clientConfig.entityConfig`) down to the placement-bundled
+ * `useResolveGenericEntityData` impl. The hook uses it to look up
+ * per-entity-type `typeConfig` rows when transforming items-API rows.
+ *
+ * Originally also carried the streaming `answer.payload` as a
+ * payload-only enrichment path (DL #099 PR 4). That path was removed —
+ * the placement now resolves entity data exclusively via the items API
+ * (`fetchEntityListData`), like the main app's `useEntityListData`.
+ * Name kept for diff hygiene; the context's purpose narrowed.
+ */
+
+const DEFAULT_VALUE = {
+  entityConfig: null
+};
+const PlacementPayloadContext = /*#__PURE__*/React.createContext(DEFAULT_VALUE);
+export const PlacementPayloadProvider = PlacementPayloadContext.Provider;
+export function usePlacementPayload() {
+  return React.useContext(PlacementPayloadContext);
+}
+//# sourceMappingURL=PlacementPayloadContext.js.map

package/dist/esm/components/placement/PlacementPayloadContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","DEFAULT_VALUE","entityConfig","PlacementPayloadContext","createContext","PlacementPayloadProvider","Provider","usePlacementPayload","useContext"],"sources":["../../../../src/components/placement/PlacementPayloadContext.tsx"],"sourcesContent":["import React from 'react';\nimport type { EntityConfig } from '../../types/entity';\n\n/**\n * Carries the placement's `entityConfig` (from the client UMD's\n * `clientConfig.entityConfig`) down to the placement-bundled\n * `useResolveGenericEntityData` impl. The hook uses it to look up\n * per-entity-type `typeConfig` rows when transforming items-API rows.\n *\n * Originally also carried the streaming `answer.payload` as a\n * payload-only enrichment path (DL #099 PR 4). That path was removed —\n * the placement now resolves entity data exclusively via the items API\n * (`fetchEntityListData`), like the main app's `useEntityListData`.\n * Name kept for diff hygiene; the context's purpose narrowed.\n */\nexport interface PlacementPayloadContextValue {\n  entityConfig: EntityConfig | null;\n}\n\nconst DEFAULT_VALUE: PlacementPayloadContextValue = {\n  entityConfig: null,\n};\n\nconst PlacementPayloadContext =\n  React.createContext<PlacementPayloadContextValue>(DEFAULT_VALUE);\n\nexport const PlacementPayloadProvider = PlacementPayloadContext.Provider;\n\nexport function usePlacementPayload(): PlacementPayloadContextValue {\n  return React.useContext(PlacementPayloadContext);\n}\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;;AAGzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,MAAMC,aAA2C,GAAG;EAClDC,YAAY,EAAE;AAChB,CAAC;AAED,MAAMC,uBAAuB,gBAC3BH,KAAK,CAACI,aAAa,CAA+BH,aAAa,CAAC;AAElE,OAAO,MAAMI,wBAAwB,GAAGF,uBAAuB,CAACG,QAAQ;AAExE,OAAO,SAASC,mBAAmBA,CAAA,EAAiC;EAClE,OAAOP,KAAK,CAACQ,UAAU,CAACL,uBAAuB,CAAC;AAClD","ignoreList":[]}