@wix/web5-core 1.56.0

package/dist/cjs/component/componentParser.js

@@ -0,0 +1,365 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.mergeSectionsWithStableReferences = mergeSectionsWithStableReferences;
+exports.parseMarkdownToComponents = parseMarkdownToComponents;
+exports.tryParseComponent = tryParseComponent;
+var _react = _interopRequireDefault(require("react"));
+var _patternValidator = require("../patternValidator");
+var _astToParts = require("../match/astToParts");
+var _linkTypes = require("../types/link-types");
+var _web5LinkValidator = require("../utils/web5LinkValidator");
+var _diagnosticTypes = require("./diagnosticTypes");
+var _componentTracking = require("../utils/componentTracking");
+var _diagnosticsCollector = require("../utils/diagnosticsCollector");
+var _unifiedMarkdownParser = require("../utils/unifiedMarkdownParser");
+var _markdownPreprocessor = require("../utils/markdownPreprocessor");
+var _intentExtractor = require("../utils/intentExtractor");
+var _contentKeywordMatcher = require("../utils/contentKeywordMatcher");
+var _propsExtractor = require("../utils/propsExtractor");
+/**
+ * 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.
+ */
+
+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.
+ */
+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.default.createElement(FallbackComponent, mergedProps);
+  return (0, _propsExtractor.createPageSection)({
+    sectionType: 'fallback',
+    componentName: FallbackComponent.displayName || FallbackComponent.name,
+    index,
+    component: mergedComponent,
+    sourceMarkdown: mergedSourceMarkdown,
+    debugProps: mergedProps
+  });
+}
+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
+  } = (0, _markdownPreprocessor.preprocessMarkdown)(pageMarkdown);
+  const intentInfo = providedIntent ?? (0, _intentExtractor.getIntentFromMarkdown)(preprocessedMarkdown);
+  const allNodes = [...(0, _unifiedMarkdownParser.parseMarkdownToAst)(preprocessedMarkdown).children];
+  const nodes = [...allNodes];
+  const sections = [];
+  const tracking = new _componentTracking.ComponentTracking();
+  const diagnosticsCollector = options.diagnosticsCollector ?? new _diagnosticsCollector.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 = (0, _unifiedMarkdownParser.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 (0, _web5LinkValidator.findInvalidWeb5Links)(allNodes)) {
+    let diagnosticType;
+    let label;
+    switch (link.reason) {
+      case 'legacy':
+        diagnosticType = _diagnosticTypes.DIAGNOSTIC_TYPES.LEGACY_PROTOCOL_LINK;
+        label = 'legacy protocol';
+        break;
+      case 'empty':
+        diagnosticType = _diagnosticTypes.DIAGNOSTIC_TYPES.INVALID_LINK_FORMAT;
+        label = 'empty href';
+        break;
+      default:
+        diagnosticType = _diagnosticTypes.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
+  };
+}
+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 = (0, _contentKeywordMatcher.getContextualImageFilename)(contentParts, allowedKeywords, '', context.tracking);
+      return (0, _linkTypes.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 = (0, _patternValidator.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 = (0, _astToParts.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.default.createElement(Component, props);
+      const componentName = Component.displayName || Component.name || undefined;
+      const section = (0, _propsExtractor.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/cjs/component/componentParser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_patternValidator","_astToParts","_linkTypes","_web5LinkValidator","_diagnosticTypes","_componentTracking","_diagnosticsCollector","_unifiedMarkdownParser","_markdownPreprocessor","_intentExtractor","_contentKeywordMatcher","_propsExtractor","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","React","createElement","createPageSection","componentName","displayName","name","parseMarkdownToComponents","pageMarkdown","options","_clientConfig$feature","clientConfig","enrichEntityProps","clientId","intentInfo","providedIntent","payload","disableContextualImages","explicitDisableImages","preprocessedMarkdown","diagnostics","preprocessDiagnostics","preprocessMarkdown","getIntentFromMarkdown","allNodes","parseMarkdownToAst","children","nodes","tracking","ComponentTracking","diagnosticsCollector","DiagnosticsCollector","d","report","diagnosticType","type","sectionIndex","details","original","normalized","features","disableContextualImagesEnrichment","context","intent","currentGlobalIndex","startIndex","parsedCount","tryParseComponent","parseAstToMarkdown","endIndex","addRange","splice","link","findInvalidWeb5Links","label","reason","DIAGNOSTIC_TYPES","LEGACY_PROTOCOL_LINK","INVALID_LINK_FORMAT","BROKEN_WEB5_LINK","nodeType","url","combinedSections","definitions","getAllDefinitions","allowedKeywords","allowedImageSearchKeywords","baseParseContext","getContextualImage","undefined","contentParts","result","getContextualImageFilename","isWeb5ImageUrl","filename","getComponentCount","setMeta","key","value","getMeta","definition","isPlacementOnly","pattern","patterns","_parts$find","_context$intent","validatePattern","valid","parsedNodes","astEndIndex","maxNodes","maxConsumedNodes","matchedNodes","parts","nodesToParts","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":"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","ignoreList":[]}

package/dist/cjs/component/diagnosticTypes.js

@@ -0,0 +1,30 @@
+"use strict";
+
+exports.__esModule = true;
+exports.DIAGNOSTIC_TYPES = void 0;
+const DIAGNOSTIC_TYPES = exports.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/cjs/component/diagnosticTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DIAGNOSTIC_TYPES","exports","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":";;;;AAAO,MAAMA,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAG;EAC9BE,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/cjs/component/parser-types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=parser-types.js.map

package/dist/cjs/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/cjs/component/section-definition.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=section-definition.js.map

package/dist/cjs/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/cjs/component/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=types.js.map

package/dist/cjs/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/cjs/components/placement/PlacementPayloadContext.js

@@ -0,0 +1,29 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.PlacementPayloadProvider = void 0;
+exports.usePlacementPayload = usePlacementPayload;
+var _react = _interopRequireDefault(require("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.default.createContext(DEFAULT_VALUE);
+const PlacementPayloadProvider = exports.PlacementPayloadProvider = PlacementPayloadContext.Provider;
+function usePlacementPayload() {
+  return _react.default.useContext(PlacementPayloadContext);
+}
+//# sourceMappingURL=PlacementPayloadContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","DEFAULT_VALUE","entityConfig","PlacementPayloadContext","React","createContext","PlacementPayloadProvider","exports","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,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,MAAMC,aAA2C,GAAG;EAClDC,YAAY,EAAE;AAChB,CAAC;AAED,MAAMC,uBAAuB,gBAC3BC,cAAK,CAACC,aAAa,CAA+BJ,aAAa,CAAC;AAE3D,MAAMK,wBAAwB,GAAAC,OAAA,CAAAD,wBAAA,GAAGH,uBAAuB,CAACK,QAAQ;AAEjE,SAASC,mBAAmBA,CAAA,EAAiC;EAClE,OAAOL,cAAK,CAACM,UAAU,CAACP,uBAAuB,CAAC;AAClD","ignoreList":[]}