@wix/web5-core 1.57.2 → 1.59.0

package/dist/esm/component/componentDefinitions/HeroSectionDefinition.js

@@ -1,5 +1,5 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { headingText, bodyText, firstImageSrc, parseCalloutTag, extractListItemText } from './parse-utils.js';
+import { headingText, headingMarkdown, bodyText, firstImageSrc, parseCalloutTag, extractListItemText } from './parse-utils.js';
 import { getPartsByType, getLinks } from '../../parts/parts.js';
 export class HeroSectionDefinition {
   constructor() {
@@ -198,7 +198,10 @@ Get started today with our amazing features.
       leadingQuote = parseCalloutTag(raw).text || undefined;
     }
     return {
-      headline: headingText(parts, 1),
+      // Markdown-preserving (not headingText): the hero title now carries the
+      // bold+italic hook the ECHO callout used to own, so the FE needs the
+      // formatting, not just the plain text. See FeatureComparisonHero.tsx.
+      headline: headingMarkdown(parts, 1),
       badge: headingText(parts, 3) || undefined,
       content: bodyText(parts) || undefined,
       buttons: buttons.length > 0 ? buttons : undefined,

package/dist/esm/component/componentDefinitions/HeroSectionDefinition.js.map

@@ -1 +1 @@
-{"version":3,"names":["headingText","bodyText","firstImageSrc","parseCalloutTag","extractListItemText","getPartsByType","getLinks","HeroSectionDefinition","constructor","_defineProperty","headline","content","buttons","id","text","variant","markdown","expected","onClick","image","parse","parts","lists","list","item","_list$meta","meta","items","_item$meta","itemParts","nestedImage","buttonIndex","map","l","i","_l$content","trim","href","length","trailingList","filteredItems","_list$meta2","_item$meta2","hasImage","some","p","type","push","allItemsAreLinks","listLinks","_item$meta3","_itemLinkParts$0$cont","itemLinkParts","filter","allText","linkTexts","_l$content2","join","link","isFirstButton","lines","_item$meta4","h1Index","findIndex","_p$meta","level","blockquotes","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","undefined","badge"],"sources":["../../../../src/component/componentDefinitions/HeroSectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  bodyText,\n  firstImageSrc,\n  parseCalloutTag,\n  extractListItemText,\n} from './parse-utils';\nimport type { Part, ListPart, LinkPart, ListItemPart } from '../../parts/parts';\nimport { getPartsByType, getLinks } from '../../parts/parts';\nimport type {\n  HeroButton,\n  HeroCompProps,\n  HeroSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition } from '../section-definition';\n\nexport class HeroSectionDefinition\n  implements SectionDefinition<HeroSectionComponent>\n{\n  sectionType = 'hero' as const;\n  singleInstance = true;\n  patterns = [\n    // Canonical hero shape: section descriptor, then the leading ECHO callout\n    // (optional in the grammar — the orchestrator always emits it, but a missing\n    // ECHO must not stop the hero from rendering), then an optional h3 badge,\n    // then the h1. The callout and badge are independent slots so a hero can\n    // carry both. The second `html_comment?` keeps the legacy ordering\n    // (callout before the descriptor) matching for pages saved before this change.\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t | link)* > list?',\n  ];\n\n  defaults: HeroCompProps = {\n    headline: 'Build something amazing',\n    content: 'Your platform for data-driven decisions.',\n    buttons: [{ id: 'btn-0', text: 'Get started', variant: 'primary' }],\n  };\n\n  fixtures: SectionFixture<HeroCompProps>[] = [\n    {\n      markdown:\n        '# Welcome\\n\\nBuild amazing things.\\n\\n[Get Started](/) [Learn More](/about)',\n      expected: {\n        headline: 'Welcome',\n        content: 'Build amazing things.',\n        buttons: [\n          {\n            id: 'btn-0',\n            text: 'Get Started',\n            variant: 'primary',\n            onClick: '/',\n          },\n          {\n            id: 'btn-1',\n            text: 'Learn More',\n            variant: 'secondary',\n            onClick: '/about',\n          },\n        ],\n      },\n    },\n    {\n      markdown: `<!-- Hero Section -->\n\n# Welcome to Our Platform\n\n![Hero Image](hero.jpg)\n\nGet started today with our amazing features.\n\n[Get Started](/signup) [Learn More](/about)`,\n      expected: {\n        headline: 'Welcome to Our Platform',\n        content: 'Get started today with our amazing features.',\n        buttons: [\n          {\n            id: 'btn-0',\n            text: 'Get Started',\n            variant: 'primary',\n            onClick: '/signup',\n          },\n          {\n            id: 'btn-1',\n            text: 'Learn More',\n            variant: 'secondary',\n            onClick: '/about',\n          },\n        ],\n        image: 'hero.jpg',\n      },\n    },\n  ];\n\n  parse(parts: Part[]): HeroCompProps {\n    let image = firstImageSrc(parts);\n    const lists = getPartsByType<ListPart>(parts, 'list');\n\n    if (!image) {\n      for (const list of lists) {\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const nestedImage = firstImageSrc(itemParts);\n          if (nestedImage) {\n            image = nestedImage;\n            break;\n          }\n        }\n        if (image) {\n          break;\n        }\n      }\n    }\n\n    // Start with top-level links as buttons\n    let buttonIndex = 0;\n    const buttons: HeroButton[] = getLinks(parts).map(\n      (l, i): HeroButton => ({\n        id: `btn-${i}`,\n        text: l.content?.trim() || 'Learn more',\n        variant: i === 0 ? 'primary' : 'secondary',\n        onClick: l.meta.href,\n      }),\n    );\n    buttonIndex = buttons.length;\n\n    // Process lists: filter out image-only items, then check if remaining\n    // items are all link-only. If so, convert to buttons; otherwise keep as trailingList.\n    let trailingList: string | undefined;\n    if (lists.length > 0) {\n      for (const list of lists) {\n        // Filter out image-only items\n        const filteredItems: ListItemPart[] = [];\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const hasImage = itemParts.some((p) => p.type === 'image');\n          if (hasImage) {\n            continue;\n          }\n          filteredItems.push(item);\n        }\n\n        if (filteredItems.length === 0) {\n          continue;\n        }\n\n        // Check if ALL remaining items contain only links (no other text)\n        let allItemsAreLinks = true;\n        const listLinks: { text: string; href: string }[] = [];\n\n        for (const item of filteredItems) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const itemLinkParts = itemParts.filter(\n            (p): p is LinkPart => p.type === 'link',\n          );\n\n          if (itemLinkParts.length === 0) {\n            allItemsAreLinks = false;\n            break;\n          }\n\n          // Check if the item text is entirely link text (no extra content)\n          const allText = extractListItemText(item).trim();\n          const linkTexts = itemLinkParts\n            .map((l) => l.content?.trim() || '')\n            .join(' ')\n            .trim();\n\n          if (allText !== linkTexts) {\n            allItemsAreLinks = false;\n            break;\n          }\n\n          listLinks.push({\n            text: itemLinkParts[0].content?.trim() || 'Learn more',\n            href: itemLinkParts[0].meta.href,\n          });\n        }\n\n        if (allItemsAreLinks && listLinks.length > 0) {\n          // Convert link-only list items to buttons\n          for (const link of listLinks) {\n            const isFirstButton = buttons.length === 0;\n            buttons.push({\n              id: `btn-${buttonIndex++}`,\n              text: link.text,\n              variant: isFirstButton ? 'primary' : 'secondary',\n              onClick: link.href,\n            });\n          }\n        } else {\n          // Keep as trailing list markdown\n          const lines: string[] = [];\n          for (const item of filteredItems) {\n            const text =\n              (item.meta?.markdown as string) || extractListItemText(item);\n            if (text) {\n              lines.push(`- ${text}`);\n            }\n          }\n          if (lines.length > 0) {\n            trailingList = lines.join('\\n');\n          }\n        }\n      }\n    }\n\n    // The hero claims the leading callout before the h1 — the ECHO the\n    // orchestrator emits as the hero's opening line, right after the section\n    // descriptor. A trailing blockquote is not part of the hero pattern, so it\n    // falls through to a downstream callout section instead.\n    const h1Index = parts.findIndex(\n      (p) => p.type === 'heading' && (p.meta as { level: number })?.level === 1,\n    );\n    const blockquotes = getPartsByType<Part>(parts, 'callout');\n    let leadingQuote: string | undefined;\n\n    for (const bq of blockquotes) {\n      const bqIndex = parts.indexOf(bq);\n      if (h1Index >= 0 && bqIndex > h1Index) {\n        continue;\n      }\n      const raw = (bq.meta?.markdown as string)?.trim() || bq.content?.trim();\n      if (!raw) {\n        continue;\n      }\n      leadingQuote = parseCalloutTag(raw).text || undefined;\n    }\n\n    return {\n      headline: headingText(parts, 1),\n      badge: headingText(parts, 3) || undefined,\n      content: bodyText(parts) || undefined,\n      buttons: buttons.length > 0 ? buttons : undefined,\n      image,\n      trailingList,\n      leadingQuote,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["headingText","headingMarkdown","bodyText","firstImageSrc","parseCalloutTag","extractListItemText","getPartsByType","getLinks","HeroSectionDefinition","constructor","_defineProperty","headline","content","buttons","id","text","variant","markdown","expected","onClick","image","parse","parts","lists","list","item","_list$meta","meta","items","_item$meta","itemParts","nestedImage","buttonIndex","map","l","i","_l$content","trim","href","length","trailingList","filteredItems","_list$meta2","_item$meta2","hasImage","some","p","type","push","allItemsAreLinks","listLinks","_item$meta3","_itemLinkParts$0$cont","itemLinkParts","filter","allText","linkTexts","_l$content2","join","link","isFirstButton","lines","_item$meta4","h1Index","findIndex","_p$meta","level","blockquotes","leadingQuote","bq","_bq$meta","_bq$content","bqIndex","indexOf","raw","undefined","badge"],"sources":["../../../../src/component/componentDefinitions/HeroSectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  headingMarkdown,\n  bodyText,\n  firstImageSrc,\n  parseCalloutTag,\n  extractListItemText,\n} from './parse-utils';\nimport type { Part, ListPart, LinkPart, ListItemPart } from '../../parts/parts';\nimport { getPartsByType, getLinks } from '../../parts/parts';\nimport type {\n  HeroButton,\n  HeroCompProps,\n  HeroSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition } from '../section-definition';\n\nexport class HeroSectionDefinition\n  implements SectionDefinition<HeroSectionComponent>\n{\n  sectionType = 'hero' as const;\n  singleInstance = true;\n  patterns = [\n    // Canonical hero shape: section descriptor, then the leading ECHO callout\n    // (optional in the grammar — the orchestrator always emits it, but a missing\n    // ECHO must not stop the hero from rendering), then an optional h3 badge,\n    // then the h1. The callout and badge are independent slots so a hero can\n    // carry both. The second `html_comment?` keeps the legacy ordering\n    // (callout before the descriptor) matching for pages saved before this change.\n    'html_comment? > callout? > html_comment? > h3? > h1 > (image | t | link)* > list?',\n  ];\n\n  defaults: HeroCompProps = {\n    headline: 'Build something amazing',\n    content: 'Your platform for data-driven decisions.',\n    buttons: [{ id: 'btn-0', text: 'Get started', variant: 'primary' }],\n  };\n\n  fixtures: SectionFixture<HeroCompProps>[] = [\n    {\n      markdown:\n        '# Welcome\\n\\nBuild amazing things.\\n\\n[Get Started](/) [Learn More](/about)',\n      expected: {\n        headline: 'Welcome',\n        content: 'Build amazing things.',\n        buttons: [\n          {\n            id: 'btn-0',\n            text: 'Get Started',\n            variant: 'primary',\n            onClick: '/',\n          },\n          {\n            id: 'btn-1',\n            text: 'Learn More',\n            variant: 'secondary',\n            onClick: '/about',\n          },\n        ],\n      },\n    },\n    {\n      markdown: `<!-- Hero Section -->\n\n# Welcome to Our Platform\n\n![Hero Image](hero.jpg)\n\nGet started today with our amazing features.\n\n[Get Started](/signup) [Learn More](/about)`,\n      expected: {\n        headline: 'Welcome to Our Platform',\n        content: 'Get started today with our amazing features.',\n        buttons: [\n          {\n            id: 'btn-0',\n            text: 'Get Started',\n            variant: 'primary',\n            onClick: '/signup',\n          },\n          {\n            id: 'btn-1',\n            text: 'Learn More',\n            variant: 'secondary',\n            onClick: '/about',\n          },\n        ],\n        image: 'hero.jpg',\n      },\n    },\n  ];\n\n  parse(parts: Part[]): HeroCompProps {\n    let image = firstImageSrc(parts);\n    const lists = getPartsByType<ListPart>(parts, 'list');\n\n    if (!image) {\n      for (const list of lists) {\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const nestedImage = firstImageSrc(itemParts);\n          if (nestedImage) {\n            image = nestedImage;\n            break;\n          }\n        }\n        if (image) {\n          break;\n        }\n      }\n    }\n\n    // Start with top-level links as buttons\n    let buttonIndex = 0;\n    const buttons: HeroButton[] = getLinks(parts).map(\n      (l, i): HeroButton => ({\n        id: `btn-${i}`,\n        text: l.content?.trim() || 'Learn more',\n        variant: i === 0 ? 'primary' : 'secondary',\n        onClick: l.meta.href,\n      }),\n    );\n    buttonIndex = buttons.length;\n\n    // Process lists: filter out image-only items, then check if remaining\n    // items are all link-only. If so, convert to buttons; otherwise keep as trailingList.\n    let trailingList: string | undefined;\n    if (lists.length > 0) {\n      for (const list of lists) {\n        // Filter out image-only items\n        const filteredItems: ListItemPart[] = [];\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const hasImage = itemParts.some((p) => p.type === 'image');\n          if (hasImage) {\n            continue;\n          }\n          filteredItems.push(item);\n        }\n\n        if (filteredItems.length === 0) {\n          continue;\n        }\n\n        // Check if ALL remaining items contain only links (no other text)\n        let allItemsAreLinks = true;\n        const listLinks: { text: string; href: string }[] = [];\n\n        for (const item of filteredItems) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n          const itemLinkParts = itemParts.filter(\n            (p): p is LinkPart => p.type === 'link',\n          );\n\n          if (itemLinkParts.length === 0) {\n            allItemsAreLinks = false;\n            break;\n          }\n\n          // Check if the item text is entirely link text (no extra content)\n          const allText = extractListItemText(item).trim();\n          const linkTexts = itemLinkParts\n            .map((l) => l.content?.trim() || '')\n            .join(' ')\n            .trim();\n\n          if (allText !== linkTexts) {\n            allItemsAreLinks = false;\n            break;\n          }\n\n          listLinks.push({\n            text: itemLinkParts[0].content?.trim() || 'Learn more',\n            href: itemLinkParts[0].meta.href,\n          });\n        }\n\n        if (allItemsAreLinks && listLinks.length > 0) {\n          // Convert link-only list items to buttons\n          for (const link of listLinks) {\n            const isFirstButton = buttons.length === 0;\n            buttons.push({\n              id: `btn-${buttonIndex++}`,\n              text: link.text,\n              variant: isFirstButton ? 'primary' : 'secondary',\n              onClick: link.href,\n            });\n          }\n        } else {\n          // Keep as trailing list markdown\n          const lines: string[] = [];\n          for (const item of filteredItems) {\n            const text =\n              (item.meta?.markdown as string) || extractListItemText(item);\n            if (text) {\n              lines.push(`- ${text}`);\n            }\n          }\n          if (lines.length > 0) {\n            trailingList = lines.join('\\n');\n          }\n        }\n      }\n    }\n\n    // The hero claims the leading callout before the h1 — the ECHO the\n    // orchestrator emits as the hero's opening line, right after the section\n    // descriptor. A trailing blockquote is not part of the hero pattern, so it\n    // falls through to a downstream callout section instead.\n    const h1Index = parts.findIndex(\n      (p) => p.type === 'heading' && (p.meta as { level: number })?.level === 1,\n    );\n    const blockquotes = getPartsByType<Part>(parts, 'callout');\n    let leadingQuote: string | undefined;\n\n    for (const bq of blockquotes) {\n      const bqIndex = parts.indexOf(bq);\n      if (h1Index >= 0 && bqIndex > h1Index) {\n        continue;\n      }\n      const raw = (bq.meta?.markdown as string)?.trim() || bq.content?.trim();\n      if (!raw) {\n        continue;\n      }\n      leadingQuote = parseCalloutTag(raw).text || undefined;\n    }\n\n    return {\n      // Markdown-preserving (not headingText): the hero title now carries the\n      // bold+italic hook the ECHO callout used to own, so the FE needs the\n      // formatting, not just the plain text. See FeatureComparisonHero.tsx.\n      headline: headingMarkdown(parts, 1),\n      badge: headingText(parts, 3) || undefined,\n      content: bodyText(parts) || undefined,\n      buttons: buttons.length > 0 ? buttons : undefined,\n      image,\n      trailingList,\n      leadingQuote,\n    };\n  }\n}\n"],"mappings":";AAAA,SACEA,WAAW,EACXC,eAAe,EACfC,QAAQ,EACRC,aAAa,EACbC,eAAe,EACfC,mBAAmB,QACd,eAAe;AAEtB,SAASC,cAAc,EAAEC,QAAQ,QAAQ,mBAAmB;AAS5D,OAAO,MAAMC,qBAAqB,CAElC;EAAAC,YAAA;IAAAC,eAAA,sBACgB,MAAM;IAAAA,eAAA,yBACH,IAAI;IAAAA,eAAA,mBACV;IACT;IACA;IACA;IACA;IACA;IACA;IACA,mFAAmF,CACpF;IAAAA,eAAA,mBAEyB;MACxBC,QAAQ,EAAE,yBAAyB;MACnCC,OAAO,EAAE,0CAA0C;MACnDC,OAAO,EAAE,CAAC;QAAEC,EAAE,EAAE,OAAO;QAAEC,IAAI,EAAE,aAAa;QAAEC,OAAO,EAAE;MAAU,CAAC;IACpE,CAAC;IAAAN,eAAA,mBAE2C,CAC1C;MACEO,QAAQ,EACN,6EAA6E;MAC/EC,QAAQ,EAAE;QACRP,QAAQ,EAAE,SAAS;QACnBC,OAAO,EAAE,uBAAuB;QAChCC,OAAO,EAAE,CACP;UACEC,EAAE,EAAE,OAAO;UACXC,IAAI,EAAE,aAAa;UACnBC,OAAO,EAAE,SAAS;UAClBG,OAAO,EAAE;QACX,CAAC,EACD;UACEL,EAAE,EAAE,OAAO;UACXC,IAAI,EAAE,YAAY;UAClBC,OAAO,EAAE,WAAW;UACpBG,OAAO,EAAE;QACX,CAAC;MAEL;IACF,CAAC,EACD;MACEF,QAAQ,EAAE;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA,4CAA4C;MACtCC,QAAQ,EAAE;QACRP,QAAQ,EAAE,yBAAyB;QACnCC,OAAO,EAAE,8CAA8C;QACvDC,OAAO,EAAE,CACP;UACEC,EAAE,EAAE,OAAO;UACXC,IAAI,EAAE,aAAa;UACnBC,OAAO,EAAE,SAAS;UAClBG,OAAO,EAAE;QACX,CAAC,EACD;UACEL,EAAE,EAAE,OAAO;UACXC,IAAI,EAAE,YAAY;UAClBC,OAAO,EAAE,WAAW;UACpBG,OAAO,EAAE;QACX,CAAC,CACF;QACDC,KAAK,EAAE;MACT;IACF,CAAC,CACF;EAAA;EAEDC,KAAKA,CAACC,KAAa,EAAiB;IAClC,IAAIF,KAAK,GAAGjB,aAAa,CAACmB,KAAK,CAAC;IAChC,MAAMC,KAAK,GAAGjB,cAAc,CAAWgB,KAAK,EAAE,MAAM,CAAC;IAErD,IAAI,CAACF,KAAK,EAAE;MACV,KAAK,MAAMI,IAAI,IAAID,KAAK,EAAE;QACxB,KAAK,MAAME,IAAI,IAAI,EAAAC,UAAA,GAAAF,IAAI,CAACG,IAAI,qBAATD,UAAA,CAAWE,KAAK,KAAI,EAAE,EAAE;UAAA,IAAAF,UAAA,EAAAG,UAAA;UACzC,MAAMC,SAAS,GAAI,EAAAD,UAAA,GAAAJ,IAAI,CAACE,IAAI,qBAATE,UAAA,CAAWP,KAAK,KAAI,EAAa;UACpD,MAAMS,WAAW,GAAG5B,aAAa,CAAC2B,SAAS,CAAC;UAC5C,IAAIC,WAAW,EAAE;YACfX,KAAK,GAAGW,WAAW;YACnB;UACF;QACF;QACA,IAAIX,KAAK,EAAE;UACT;QACF;MACF;IACF;;IAEA;IACA,IAAIY,WAAW,GAAG,CAAC;IACnB,MAAMnB,OAAqB,GAAGN,QAAQ,CAACe,KAAK,CAAC,CAACW,GAAG,CAC/C,CAACC,CAAC,EAAEC,CAAC;MAAA,IAAAC,UAAA;MAAA,OAAkB;QACrBtB,EAAE,EAAE,OAAOqB,CAAC,EAAE;QACdpB,IAAI,EAAE,EAAAqB,UAAA,GAAAF,CAAC,CAACtB,OAAO,qBAATwB,UAAA,CAAWC,IAAI,CAAC,CAAC,KAAI,YAAY;QACvCrB,OAAO,EAAEmB,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,WAAW;QAC1ChB,OAAO,EAAEe,CAAC,CAACP,IAAI,CAACW;MAClB,CAAC;IAAA,CACH,CAAC;IACDN,WAAW,GAAGnB,OAAO,CAAC0B,MAAM;;IAE5B;IACA;IACA,IAAIC,YAAgC;IACpC,IAAIjB,KAAK,CAACgB,MAAM,GAAG,CAAC,EAAE;MACpB,KAAK,MAAMf,IAAI,IAAID,KAAK,EAAE;QACxB;QACA,MAAMkB,aAA6B,GAAG,EAAE;QACxC,KAAK,MAAMhB,IAAI,IAAI,EAAAiB,WAAA,GAAAlB,IAAI,CAACG,IAAI,qBAATe,WAAA,CAAWd,KAAK,KAAI,EAAE,EAAE;UAAA,IAAAc,WAAA,EAAAC,WAAA;UACzC,MAAMb,SAAS,GAAI,EAAAa,WAAA,GAAAlB,IAAI,CAACE,IAAI,qBAATgB,WAAA,CAAWrB,KAAK,KAAI,EAAa;UACpD,MAAMsB,QAAQ,GAAGd,SAAS,CAACe,IAAI,CAAEC,CAAC,IAAKA,CAAC,CAACC,IAAI,KAAK,OAAO,CAAC;UAC1D,IAAIH,QAAQ,EAAE;YACZ;UACF;UACAH,aAAa,CAACO,IAAI,CAACvB,IAAI,CAAC;QAC1B;QAEA,IAAIgB,aAAa,CAACF,MAAM,KAAK,CAAC,EAAE;UAC9B;QACF;;QAEA;QACA,IAAIU,gBAAgB,GAAG,IAAI;QAC3B,MAAMC,SAA2C,GAAG,EAAE;QAEtD,KAAK,MAAMzB,IAAI,IAAIgB,aAAa,EAAE;UAAA,IAAAU,WAAA,EAAAC,qBAAA;UAChC,MAAMtB,SAAS,GAAI,EAAAqB,WAAA,GAAA1B,IAAI,CAACE,IAAI,qBAATwB,WAAA,CAAW7B,KAAK,KAAI,EAAa;UACpD,MAAM+B,aAAa,GAAGvB,SAAS,CAACwB,MAAM,CACnCR,CAAC,IAAoBA,CAAC,CAACC,IAAI,KAAK,MACnC,CAAC;UAED,IAAIM,aAAa,CAACd,MAAM,KAAK,CAAC,EAAE;YAC9BU,gBAAgB,GAAG,KAAK;YACxB;UACF;;UAEA;UACA,MAAMM,OAAO,GAAGlD,mBAAmB,CAACoB,IAAI,CAAC,CAACY,IAAI,CAAC,CAAC;UAChD,MAAMmB,SAAS,GAAGH,aAAa,CAC5BpB,GAAG,CAAEC,CAAC;YAAA,IAAAuB,WAAA;YAAA,OAAK,EAAAA,WAAA,GAAAvB,CAAC,CAACtB,OAAO,qBAAT6C,WAAA,CAAWpB,IAAI,CAAC,CAAC,KAAI,EAAE;UAAA,EAAC,CACnCqB,IAAI,CAAC,GAAG,CAAC,CACTrB,IAAI,CAAC,CAAC;UAET,IAAIkB,OAAO,KAAKC,SAAS,EAAE;YACzBP,gBAAgB,GAAG,KAAK;YACxB;UACF;UAEAC,SAAS,CAACF,IAAI,CAAC;YACbjC,IAAI,EAAE,EAAAqC,qBAAA,GAAAC,aAAa,CAAC,CAAC,CAAC,CAACzC,OAAO,qBAAxBwC,qBAAA,CAA0Bf,IAAI,CAAC,CAAC,KAAI,YAAY;YACtDC,IAAI,EAAEe,aAAa,CAAC,CAAC,CAAC,CAAC1B,IAAI,CAACW;UAC9B,CAAC,CAAC;QACJ;QAEA,IAAIW,gBAAgB,IAAIC,SAAS,CAACX,MAAM,GAAG,CAAC,EAAE;UAC5C;UACA,KAAK,MAAMoB,IAAI,IAAIT,SAAS,EAAE;YAC5B,MAAMU,aAAa,GAAG/C,OAAO,CAAC0B,MAAM,KAAK,CAAC;YAC1C1B,OAAO,CAACmC,IAAI,CAAC;cACXlC,EAAE,EAAE,OAAOkB,WAAW,EAAE,EAAE;cAC1BjB,IAAI,EAAE4C,IAAI,CAAC5C,IAAI;cACfC,OAAO,EAAE4C,aAAa,GAAG,SAAS,GAAG,WAAW;cAChDzC,OAAO,EAAEwC,IAAI,CAACrB;YAChB,CAAC,CAAC;UACJ;QACF,CAAC,MAAM;UACL;UACA,MAAMuB,KAAe,GAAG,EAAE;UAC1B,KAAK,MAAMpC,IAAI,IAAIgB,aAAa,EAAE;YAAA,IAAAqB,WAAA;YAChC,MAAM/C,IAAI,GACR,EAAA+C,WAAA,GAACrC,IAAI,CAACE,IAAI,qBAATmC,WAAA,CAAW7C,QAAQ,KAAeZ,mBAAmB,CAACoB,IAAI,CAAC;YAC9D,IAAIV,IAAI,EAAE;cACR8C,KAAK,CAACb,IAAI,CAAC,KAAKjC,IAAI,EAAE,CAAC;YACzB;UACF;UACA,IAAI8C,KAAK,CAACtB,MAAM,GAAG,CAAC,EAAE;YACpBC,YAAY,GAAGqB,KAAK,CAACH,IAAI,CAAC,IAAI,CAAC;UACjC;QACF;MACF;IACF;;IAEA;IACA;IACA;IACA;IACA,MAAMK,OAAO,GAAGzC,KAAK,CAAC0C,SAAS,CAC5BlB,CAAC;MAAA,IAAAmB,OAAA;MAAA,OAAKnB,CAAC,CAACC,IAAI,KAAK,SAAS,IAAI,EAAAkB,OAAA,GAACnB,CAAC,CAACnB,IAAI,qBAAPsC,OAAA,CAA+BC,KAAK,MAAK,CAAC;IAAA,CAC3E,CAAC;IACD,MAAMC,WAAW,GAAG7D,cAAc,CAAOgB,KAAK,EAAE,SAAS,CAAC;IAC1D,IAAI8C,YAAgC;IAEpC,KAAK,MAAMC,EAAE,IAAIF,WAAW,EAAE;MAAA,IAAAG,QAAA,EAAAC,WAAA;MAC5B,MAAMC,OAAO,GAAGlD,KAAK,CAACmD,OAAO,CAACJ,EAAE,CAAC;MACjC,IAAIN,OAAO,IAAI,CAAC,IAAIS,OAAO,GAAGT,OAAO,EAAE;QACrC;MACF;MACA,MAAMW,GAAG,GAAG,EAAAJ,QAAA,GAACD,EAAE,CAAC1C,IAAI,cAAA2C,QAAA,GAAPA,QAAA,CAASrD,QAAQ,qBAAlBqD,QAAA,CAA+BjC,IAAI,CAAC,CAAC,OAAAkC,WAAA,GAAIF,EAAE,CAACzD,OAAO,qBAAV2D,WAAA,CAAYlC,IAAI,CAAC,CAAC;MACvE,IAAI,CAACqC,GAAG,EAAE;QACR;MACF;MACAN,YAAY,GAAGhE,eAAe,CAACsE,GAAG,CAAC,CAAC3D,IAAI,IAAI4D,SAAS;IACvD;IAEA,OAAO;MACL;MACA;MACA;MACAhE,QAAQ,EAAEV,eAAe,CAACqB,KAAK,EAAE,CAAC,CAAC;MACnCsD,KAAK,EAAE5E,WAAW,CAACsB,KAAK,EAAE,CAAC,CAAC,IAAIqD,SAAS;MACzC/D,OAAO,EAAEV,QAAQ,CAACoB,KAAK,CAAC,IAAIqD,SAAS;MACrC9D,OAAO,EAAEA,OAAO,CAAC0B,MAAM,GAAG,CAAC,GAAG1B,OAAO,GAAG8D,SAAS;MACjDvD,KAAK;MACLoB,YAAY;MACZ4B;IACF,CAAC;EACH;AACF","ignoreList":[]}

package/dist/esm/component/componentDefinitions/NextStepsSectionDefinition.js

@@ -1,5 +1,5 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { headingText, extractListItemText, firstImageSrc } from './parse-utils.js';
+import { headingText, bodyText, extractListItemText, firstImageSrc } from './parse-utils.js';
 import { getPartsByType, getLinks } from '../../parts/parts.js';
 function linkToMarkdown(link) {
   var _link$content, _link$meta;
@@ -35,16 +35,39 @@ function inlineBodyMarkdown(parts) {
 export class NextStepsSectionDefinition {
   constructor() {
     _defineProperty(this, "sectionType", 'nextSteps');
-    _defineProperty(this, "patterns", ['(html_comment[section^="next"] | html_comment[semantic^="next"]) > h2 > image? > list{item[1-]:(icon | t)* > (t? > link)+}', '(html_comment[section^="next"] | html_comment[semantic^="next"]) > h2 > image? > (t | link)+']);
+    _defineProperty(this, "patterns", [
+    // Framing sentence (`t?`) then one chip per bullet — the authored shape.
+    '(html_comment[section^="next"] | html_comment[semantic^="next"]) > h2 > image? > t? > list{item[1-]:(icon | t)* > (t? > link)+}',
+    // Legacy inline shape: chips embedded in the prose. Still arrives from
+    // sites whose next-steps prompt has not moved to the list shape.
+    '(html_comment[section^="next"] | html_comment[semantic^="next"]) > h2 > image? > (t | link)+']);
     _defineProperty(this, "defaults", {
       title: 'Next Steps',
-      body: '[Get started](/start)',
+      body: 'Where would you like to go next?',
       backgroundImage: undefined,
       steps: [{
         content: '[Get started](/start)'
       }]
     });
     _defineProperty(this, "fixtures", [{
+      markdown: `<!-- section:next-steps, semantic:next_steps -->
+
+## Find the right care for mature, sensitive skin
+
+Want to focus on rich hydrators and barrier builders?
+
+- [hydrating creams →](web5://ask/hydrating+creams+for+mature+skin)
+- [gentle resurfacing serums →](web5://ask/gentle+resurfacing+serums)`,
+      expected: {
+        title: 'Find the right care for mature, sensitive skin',
+        body: 'Want to focus on rich hydrators and barrier builders?',
+        steps: [{
+          content: '[hydrating creams →](web5://ask/hydrating+creams+for+mature+skin)'
+        }, {
+          content: '[gentle resurfacing serums →](web5://ask/gentle+resurfacing+serums)'
+        }]
+      }
+    }, {
       markdown: `<!-- section: next_steps -->
 
 ## Next Steps
@@ -66,10 +89,14 @@ export class NextStepsSectionDefinition {
     const backgroundImage = firstImageSrc(parts);
     const steps = [];
     let body;
+    let chipsInlineInBody = false;
 
     // Try list-based pattern first
     const lists = getPartsByType(parts, 'list');
     if (lists.length > 0) {
+      // The framing sentence is the only top-level prose — list items live
+      // under each list's meta.items, so bodyText never picks up a chip.
+      body = bodyText(parts) || undefined;
       for (const list of lists) {
         for (const item of ((_list$meta = list.meta) == null ? void 0 : _list$meta.items) ?? []) {
           var _list$meta, _item$meta, _iconPart$meta;
@@ -99,6 +126,9 @@ export class NextStepsSectionDefinition {
       }
     } else {
       body = inlineBodyMarkdown(parts);
+      // body carries the chips as inline links — flag it so renderers show the
+      // prose alone instead of repeating every chip as a row beneath it.
+      chipsInlineInBody = Boolean(body);
     }
 
     // Fallback: inline links pattern
@@ -120,6 +150,9 @@ export class NextStepsSectionDefinition {
       ...(body ? {
         body
       } : {}),
+      ...(chipsInlineInBody ? {
+        chipsInlineInBody
+      } : {}),
       ...(backgroundImage ? {
         backgroundImage
       } : {}),

package/dist/esm/component/componentDefinitions/NextStepsSectionDefinition.js.map

@@ -1 +1 @@
-{"version":3,"names":["headingText","extractListItemText","firstImageSrc","getPartsByType","getLinks","linkToMarkdown","link","_link$content","_link$meta","content","trim","meta","href","appendInlineToken","current","token","trimmed","test","inlineBodyMarkdown","parts","body","reduce","part","type","_part$meta","markdown","undefined","NextStepsSectionDefinition","constructor","_defineProperty","title","backgroundImage","steps","expected","parse","lists","length","list","item","_list$meta","items","_item$meta","_iconPart$meta","itemParts","iconPart","find","p","iconHint","contentFragments","push","_p$content","filter","Boolean","join","links","_link$content2","_link$meta2","text"],"sources":["../../../../src/component/componentDefinitions/NextStepsSectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  extractListItemText,\n  firstImageSrc,\n} from './parse-utils';\nimport {\n  getPartsByType,\n  getLinks,\n  type Part,\n  type ListPart,\n  type LinkPart,\n  type IconPart,\n} from '../../parts/parts';\nimport type {\n  NextStepsCompProps,\n  NextStepsSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition } from '../section-definition';\n\nfunction linkToMarkdown(link: LinkPart): string {\n  return `[${link.content?.trim() || ''}](${link.meta?.href || ''})`;\n}\n\nfunction appendInlineToken(current: string, token: string): string {\n  const trimmed = token.trim();\n  if (!trimmed) {\n    return current;\n  }\n  if (!current) {\n    return trimmed;\n  }\n  if (/^[,.;:!?)]/.test(trimmed)) {\n    return `${current}${trimmed}`;\n  }\n  return `${current} ${trimmed}`;\n}\n\nfunction inlineBodyMarkdown(parts: Part[]): string | undefined {\n  const body = parts.reduce((current, part) => {\n    if (part.type === 'link') {\n      return appendInlineToken(current, linkToMarkdown(part as LinkPart));\n    }\n    if (part.type === 'text' || part.type === 'richText') {\n      const markdown = (part.meta?.markdown as string | undefined)?.trim();\n      return appendInlineToken(current, markdown || part.content || '');\n    }\n    return current;\n  }, '');\n\n  return body || undefined;\n}\n\nexport class NextStepsSectionDefinition\n  implements SectionDefinition<NextStepsSectionComponent>\n{\n  sectionType = 'nextSteps' as const;\n  patterns = [\n    '(html_comment[section^=\"next\"] | html_comment[semantic^=\"next\"]) > h2 > image? > list{item[1-]:(icon | t)* > (t? > link)+}',\n    '(html_comment[section^=\"next\"] | html_comment[semantic^=\"next\"]) > h2 > image? > (t | link)+',\n  ];\n\n  defaults: NextStepsCompProps = {\n    title: 'Next Steps',\n    body: '[Get started](/start)',\n    backgroundImage: undefined,\n    steps: [{ content: '[Get started](/start)' }],\n  };\n\n  fixtures: SectionFixture<NextStepsCompProps>[] = [\n    {\n      markdown: `<!-- section: next_steps -->\n\n## Next Steps\n\n- Check out [Documentation](/docs)\n- Try [Examples](/examples)`,\n      expected: {\n        title: 'Next Steps',\n        steps: [\n          { content: 'Check out [Documentation](/docs)' },\n          { content: 'Try [Examples](/examples)' },\n        ],\n      },\n    },\n  ];\n\n  parse(parts: Part[]): NextStepsCompProps {\n    const title = headingText(parts, 2) || 'Next Steps';\n    const backgroundImage = firstImageSrc(parts);\n    const steps: { content: string; iconHint?: string }[] = [];\n    let body: string | undefined;\n\n    // Try list-based pattern first\n    const lists = getPartsByType<ListPart>(parts, 'list');\n    if (lists.length > 0) {\n      for (const list of lists) {\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n\n          const iconPart = itemParts.find((p) => p.type === 'icon') as\n            | IconPart\n            | undefined;\n          const iconHint = (iconPart?.meta as { iconHint?: string })?.iconHint;\n\n          const contentFragments: string[] = [];\n          for (const p of itemParts) {\n            if (p.type === 'link') {\n              const link = p as LinkPart;\n              contentFragments.push(linkToMarkdown(link));\n            } else if (p.type === 'text' || p.type === 'richText') {\n              contentFragments.push(p.content?.trim() || '');\n            }\n          }\n          const content =\n            contentFragments.filter(Boolean).join(' ') ||\n            extractListItemText(item);\n          if (content.trim()) {\n            steps.push({\n              content: content.trim(),\n              ...(iconHint ? { iconHint } : {}),\n            });\n          }\n        }\n      }\n    } else {\n      body = inlineBodyMarkdown(parts);\n    }\n\n    // Fallback: inline links pattern\n    if (steps.length === 0) {\n      const links = getLinks(parts);\n      for (const link of links) {\n        const text = link.content?.trim();\n        const href = link.meta?.href;\n        if (text && href) {\n          steps.push({ content: linkToMarkdown(link) });\n        }\n      }\n    }\n\n    return {\n      title,\n      ...(body ? { body } : {}),\n      ...(backgroundImage ? { backgroundImage } : {}),\n      steps,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["headingText","bodyText","extractListItemText","firstImageSrc","getPartsByType","getLinks","linkToMarkdown","link","_link$content","_link$meta","content","trim","meta","href","appendInlineToken","current","token","trimmed","test","inlineBodyMarkdown","parts","body","reduce","part","type","_part$meta","markdown","undefined","NextStepsSectionDefinition","constructor","_defineProperty","title","backgroundImage","steps","expected","parse","chipsInlineInBody","lists","length","list","item","_list$meta","items","_item$meta","_iconPart$meta","itemParts","iconPart","find","p","iconHint","contentFragments","push","_p$content","filter","Boolean","join","links","_link$content2","_link$meta2","text"],"sources":["../../../../src/component/componentDefinitions/NextStepsSectionDefinition.ts"],"sourcesContent":["import {\n  headingText,\n  bodyText,\n  extractListItemText,\n  firstImageSrc,\n} from './parse-utils';\nimport {\n  getPartsByType,\n  getLinks,\n  type Part,\n  type ListPart,\n  type LinkPart,\n  type IconPart,\n} from '../../parts/parts';\nimport type {\n  NextStepsCompProps,\n  NextStepsSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition } from '../section-definition';\n\nfunction linkToMarkdown(link: LinkPart): string {\n  return `[${link.content?.trim() || ''}](${link.meta?.href || ''})`;\n}\n\nfunction appendInlineToken(current: string, token: string): string {\n  const trimmed = token.trim();\n  if (!trimmed) {\n    return current;\n  }\n  if (!current) {\n    return trimmed;\n  }\n  if (/^[,.;:!?)]/.test(trimmed)) {\n    return `${current}${trimmed}`;\n  }\n  return `${current} ${trimmed}`;\n}\n\nfunction inlineBodyMarkdown(parts: Part[]): string | undefined {\n  const body = parts.reduce((current, part) => {\n    if (part.type === 'link') {\n      return appendInlineToken(current, linkToMarkdown(part as LinkPart));\n    }\n    if (part.type === 'text' || part.type === 'richText') {\n      const markdown = (part.meta?.markdown as string | undefined)?.trim();\n      return appendInlineToken(current, markdown || part.content || '');\n    }\n    return current;\n  }, '');\n\n  return body || undefined;\n}\n\nexport class NextStepsSectionDefinition\n  implements SectionDefinition<NextStepsSectionComponent>\n{\n  sectionType = 'nextSteps' as const;\n  patterns = [\n    // Framing sentence (`t?`) then one chip per bullet — the authored shape.\n    '(html_comment[section^=\"next\"] | html_comment[semantic^=\"next\"]) > h2 > image? > t? > list{item[1-]:(icon | t)* > (t? > link)+}',\n    // Legacy inline shape: chips embedded in the prose. Still arrives from\n    // sites whose next-steps prompt has not moved to the list shape.\n    '(html_comment[section^=\"next\"] | html_comment[semantic^=\"next\"]) > h2 > image? > (t | link)+',\n  ];\n\n  defaults: NextStepsCompProps = {\n    title: 'Next Steps',\n    body: 'Where would you like to go next?',\n    backgroundImage: undefined,\n    steps: [{ content: '[Get started](/start)' }],\n  };\n\n  fixtures: SectionFixture<NextStepsCompProps>[] = [\n    {\n      markdown: `<!-- section:next-steps, semantic:next_steps -->\n\n## Find the right care for mature, sensitive skin\n\nWant to focus on rich hydrators and barrier builders?\n\n- [hydrating creams →](web5://ask/hydrating+creams+for+mature+skin)\n- [gentle resurfacing serums →](web5://ask/gentle+resurfacing+serums)`,\n      expected: {\n        title: 'Find the right care for mature, sensitive skin',\n        body: 'Want to focus on rich hydrators and barrier builders?',\n        steps: [\n          {\n            content:\n              '[hydrating creams →](web5://ask/hydrating+creams+for+mature+skin)',\n          },\n          {\n            content:\n              '[gentle resurfacing serums →](web5://ask/gentle+resurfacing+serums)',\n          },\n        ],\n      },\n    },\n    {\n      markdown: `<!-- section: next_steps -->\n\n## Next Steps\n\n- Check out [Documentation](/docs)\n- Try [Examples](/examples)`,\n      expected: {\n        title: 'Next Steps',\n        steps: [\n          { content: 'Check out [Documentation](/docs)' },\n          { content: 'Try [Examples](/examples)' },\n        ],\n      },\n    },\n  ];\n\n  parse(parts: Part[]): NextStepsCompProps {\n    const title = headingText(parts, 2) || 'Next Steps';\n    const backgroundImage = firstImageSrc(parts);\n    const steps: { content: string; iconHint?: string }[] = [];\n    let body: string | undefined;\n    let chipsInlineInBody = false;\n\n    // Try list-based pattern first\n    const lists = getPartsByType<ListPart>(parts, 'list');\n    if (lists.length > 0) {\n      // The framing sentence is the only top-level prose — list items live\n      // under each list's meta.items, so bodyText never picks up a chip.\n      body = bodyText(parts) || undefined;\n\n      for (const list of lists) {\n        for (const item of list.meta?.items ?? []) {\n          const itemParts = (item.meta?.parts ?? []) as Part[];\n\n          const iconPart = itemParts.find((p) => p.type === 'icon') as\n            | IconPart\n            | undefined;\n          const iconHint = (iconPart?.meta as { iconHint?: string })?.iconHint;\n\n          const contentFragments: string[] = [];\n          for (const p of itemParts) {\n            if (p.type === 'link') {\n              const link = p as LinkPart;\n              contentFragments.push(linkToMarkdown(link));\n            } else if (p.type === 'text' || p.type === 'richText') {\n              contentFragments.push(p.content?.trim() || '');\n            }\n          }\n          const content =\n            contentFragments.filter(Boolean).join(' ') ||\n            extractListItemText(item);\n          if (content.trim()) {\n            steps.push({\n              content: content.trim(),\n              ...(iconHint ? { iconHint } : {}),\n            });\n          }\n        }\n      }\n    } else {\n      body = inlineBodyMarkdown(parts);\n      // body carries the chips as inline links — flag it so renderers show the\n      // prose alone instead of repeating every chip as a row beneath it.\n      chipsInlineInBody = Boolean(body);\n    }\n\n    // Fallback: inline links pattern\n    if (steps.length === 0) {\n      const links = getLinks(parts);\n      for (const link of links) {\n        const text = link.content?.trim();\n        const href = link.meta?.href;\n        if (text && href) {\n          steps.push({ content: linkToMarkdown(link) });\n        }\n      }\n    }\n\n    return {\n      title,\n      ...(body ? { body } : {}),\n      ...(chipsInlineInBody ? { chipsInlineInBody } : {}),\n      ...(backgroundImage ? { backgroundImage } : {}),\n      steps,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/component/componentDefinitions/TextBlockSectionDefinition.js

@@ -4,7 +4,24 @@ import { DIAGNOSTIC_TYPES } from '../diagnosticTypes.js';
 export class TextBlockSectionDefinition {
   constructor() {
     _defineProperty(this, "sectionType", 'textBlock');
-    _defineProperty(this, "patterns", ['html_comment? > h2 > t > callout']);
+    // The trailing callout is OPTIONAL. A heading plus running copy is the shape
+    // stores emit constantly for explainer content, and requiring the blockquote
+    // meant those blocks matched no definition at all and fell through to
+    // `FallbackSectionDefinition` — rendered as undifferentiated prose with no
+    // section treatment. `parse()` already tolerates a missing callout (it only
+    // rejects when title AND description are empty).
+    //
+    // NOTE for registry authors: with the callout optional this also matches a
+    // bare `h2 > t`, and a pattern matches a PREFIX of the block. Register
+    // `textBlock` BELOW every definition whose block opens `h2 > t` — entity,
+    // entityCollection, listItemsSection, featureCards, ctaBanner, comparison,
+    // kpi, nextSteps. Above them it claims the heading + intro paragraph off the
+    // front of the block and strands the list / links / table that follow
+    // (`EntitySectionDefinition` allows `h2 > (t | callout)* > links…`, and
+    // `listItemsSection` / `ctaBanner` are the same shape). `createSdkRegistry`
+    // and the client registries in this repo order it that way; a client
+    // registry living outside this repo has to do the same.
+    _defineProperty(this, "patterns", ['html_comment? > h2 > t > callout?']);
     _defineProperty(this, "defaults", {
       title: 'Text Block Title',
       description: 'Description text.',
@@ -39,6 +56,15 @@ The platform scales with your needs.
           text: 'Start small with Go, then expand to the full suite as your data maturity grows.'
         }
       }
+    }, {
+      markdown: `## How to choose between a clinical serum and a nourishing dry oil
+
+Clinically tested serums with patented actives target visible reduction of marks and uneven tone, while dry oils focus on broad nourishment and a satin finish.`,
+      expected: {
+        title: 'How to choose between a clinical serum and a nourishing dry oil',
+        description: 'Clinically tested serums with patented actives target visible reduction of marks and uneven tone, while dry oils focus on broad nourishment and a satin finish.',
+        callout: undefined
+      }
     }]);
   }
   parse(parts, context) {

package/dist/esm/component/componentDefinitions/TextBlockSectionDefinition.js.map

@@ -1 +1 @@
-{"version":3,"names":["headingMarkdown","bodyText","calloutFromParts","DIAGNOSTIC_TYPES","TextBlockSectionDefinition","constructor","_defineProperty","title","description","callout","text","markdown","expected","parse","parts","context","reportDiagnostic","SECTION_REJECTED"],"sources":["../../../../src/component/componentDefinitions/TextBlockSectionDefinition.ts"],"sourcesContent":["import type { Part } from '../../parts/parts';\nimport { headingMarkdown, bodyText, calloutFromParts } from './parse-utils';\nimport type {\n  TextBlockCompProps,\n  TextBlockSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition, ParseContext } from '../section-definition';\nimport { DIAGNOSTIC_TYPES } from '../diagnosticTypes';\n\nexport class TextBlockSectionDefinition\n  implements SectionDefinition<TextBlockSectionComponent>\n{\n  sectionType = 'textBlock' as const;\n  patterns = ['html_comment? > h2 > t > callout'];\n\n  defaults: TextBlockCompProps = {\n    title: 'Text Block Title',\n    description: 'Description text.',\n    callout: { text: 'A key insight or quote.' },\n  };\n\n  fixtures: SectionFixture<TextBlockCompProps>[] = [\n    {\n      markdown: `## Choosing the Right Liquid Data Option\n\nLiquid Data Go is designed for brands that want affordable, scalable access to syndicated POS, shopper, and pricing insights with minimal setup and no data expertise required.\n\n> If you mainly need fast, packaged insights in one category, Liquid Data Go is usually the right fit; if you need to integrate many datasets and support multiple enterprise workflows, the broader Liquid Data platform and its solutions become more relevant.`,\n      expected: {\n        title: 'Choosing the Right Liquid Data Option',\n        description:\n          'Liquid Data Go is designed for brands that want affordable, scalable access to syndicated POS, shopper, and pricing insights with minimal setup and no data expertise required.',\n        callout: {\n          text: 'If you mainly need fast, packaged insights in one category, Liquid Data Go is usually the right fit; if you need to integrate many datasets and support multiple enterprise workflows, the broader Liquid Data platform and its solutions become more relevant.',\n        },\n      },\n    },\n    {\n      markdown: `<!-- section: textBlock -->\n## Key Takeaway\n\nThe platform scales with your needs.\n\n> Start small with Go, then expand to the full suite as your data maturity grows.`,\n      expected: {\n        title: 'Key Takeaway',\n        description: 'The platform scales with your needs.',\n        callout: {\n          text: 'Start small with Go, then expand to the full suite as your data maturity grows.',\n        },\n      },\n    },\n  ];\n\n  parse(parts: Part[], context?: ParseContext): TextBlockCompProps | null {\n    const title = headingMarkdown(parts, 2) || '';\n    const description = bodyText(parts) || '';\n    const callout = calloutFromParts(parts);\n\n    if (!title && !description) {\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'textBlock: both title and description are empty',\n      );\n      return null;\n    }\n\n    return { title, description, callout };\n  }\n}\n"],"mappings":";AACA,SAASA,eAAe,EAAEC,QAAQ,EAAEC,gBAAgB,QAAQ,eAAe;AAO3E,SAASC,gBAAgB,QAAQ,oBAAoB;AAErD,OAAO,MAAMC,0BAA0B,CAEvC;EAAAC,YAAA;IAAAC,eAAA,sBACgB,WAAW;IAAAA,eAAA,mBACd,CAAC,kCAAkC,CAAC;IAAAA,eAAA,mBAEhB;MAC7BC,KAAK,EAAE,kBAAkB;MACzBC,WAAW,EAAE,mBAAmB;MAChCC,OAAO,EAAE;QAAEC,IAAI,EAAE;MAA0B;IAC7C,CAAC;IAAAJ,eAAA,mBAEgD,CAC/C;MACEK,QAAQ,EAAE;AAChB;AACA;AACA;AACA,kQAAkQ;MAC5PC,QAAQ,EAAE;QACRL,KAAK,EAAE,uCAAuC;QAC9CC,WAAW,EACT,iLAAiL;QACnLC,OAAO,EAAE;UACPC,IAAI,EAAE;QACR;MACF;IACF,CAAC,EACD;MACEC,QAAQ,EAAE;AAChB;AACA;AACA;AACA;AACA,kFAAkF;MAC5EC,QAAQ,EAAE;QACRL,KAAK,EAAE,cAAc;QACrBC,WAAW,EAAE,sCAAsC;QACnDC,OAAO,EAAE;UACPC,IAAI,EAAE;QACR;MACF;IACF,CAAC,CACF;EAAA;EAEDG,KAAKA,CAACC,KAAa,EAAEC,OAAsB,EAA6B;IACtE,MAAMR,KAAK,GAAGP,eAAe,CAACc,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;IAC7C,MAAMN,WAAW,GAAGP,QAAQ,CAACa,KAAK,CAAC,IAAI,EAAE;IACzC,MAAML,OAAO,GAAGP,gBAAgB,CAACY,KAAK,CAAC;IAEvC,IAAI,CAACP,KAAK,IAAI,CAACC,WAAW,EAAE;MAC1BO,OAAO,YAAPA,OAAO,CAAEC,gBAAgB,YAAzBD,OAAO,CAAEC,gBAAgB,CACvBb,gBAAgB,CAACc,gBAAgB,EACjC,iDACF,CAAC;MACD,OAAO,IAAI;IACb;IAEA,OAAO;MAAEV,KAAK;MAAEC,WAAW;MAAEC;IAAQ,CAAC;EACxC;AACF","ignoreList":[]}
+{"version":3,"names":["headingMarkdown","bodyText","calloutFromParts","DIAGNOSTIC_TYPES","TextBlockSectionDefinition","constructor","_defineProperty","title","description","callout","text","markdown","expected","undefined","parse","parts","context","reportDiagnostic","SECTION_REJECTED"],"sources":["../../../../src/component/componentDefinitions/TextBlockSectionDefinition.ts"],"sourcesContent":["import type { Part } from '../../parts/parts';\nimport { headingMarkdown, bodyText, calloutFromParts } from './parse-utils';\nimport type {\n  TextBlockCompProps,\n  TextBlockSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition, ParseContext } from '../section-definition';\nimport { DIAGNOSTIC_TYPES } from '../diagnosticTypes';\n\nexport class TextBlockSectionDefinition\n  implements SectionDefinition<TextBlockSectionComponent>\n{\n  sectionType = 'textBlock' as const;\n  // The trailing callout is OPTIONAL. A heading plus running copy is the shape\n  // stores emit constantly for explainer content, and requiring the blockquote\n  // meant those blocks matched no definition at all and fell through to\n  // `FallbackSectionDefinition` — rendered as undifferentiated prose with no\n  // section treatment. `parse()` already tolerates a missing callout (it only\n  // rejects when title AND description are empty).\n  //\n  // NOTE for registry authors: with the callout optional this also matches a\n  // bare `h2 > t`, and a pattern matches a PREFIX of the block. Register\n  // `textBlock` BELOW every definition whose block opens `h2 > t` — entity,\n  // entityCollection, listItemsSection, featureCards, ctaBanner, comparison,\n  // kpi, nextSteps. Above them it claims the heading + intro paragraph off the\n  // front of the block and strands the list / links / table that follow\n  // (`EntitySectionDefinition` allows `h2 > (t | callout)* > links…`, and\n  // `listItemsSection` / `ctaBanner` are the same shape). `createSdkRegistry`\n  // and the client registries in this repo order it that way; a client\n  // registry living outside this repo has to do the same.\n  patterns = ['html_comment? > h2 > t > callout?'];\n\n  defaults: TextBlockCompProps = {\n    title: 'Text Block Title',\n    description: 'Description text.',\n    callout: { text: 'A key insight or quote.' },\n  };\n\n  fixtures: SectionFixture<TextBlockCompProps>[] = [\n    {\n      markdown: `## Choosing the Right Liquid Data Option\n\nLiquid Data Go is designed for brands that want affordable, scalable access to syndicated POS, shopper, and pricing insights with minimal setup and no data expertise required.\n\n> If you mainly need fast, packaged insights in one category, Liquid Data Go is usually the right fit; if you need to integrate many datasets and support multiple enterprise workflows, the broader Liquid Data platform and its solutions become more relevant.`,\n      expected: {\n        title: 'Choosing the Right Liquid Data Option',\n        description:\n          'Liquid Data Go is designed for brands that want affordable, scalable access to syndicated POS, shopper, and pricing insights with minimal setup and no data expertise required.',\n        callout: {\n          text: 'If you mainly need fast, packaged insights in one category, Liquid Data Go is usually the right fit; if you need to integrate many datasets and support multiple enterprise workflows, the broader Liquid Data platform and its solutions become more relevant.',\n        },\n      },\n    },\n    {\n      markdown: `<!-- section: textBlock -->\n## Key Takeaway\n\nThe platform scales with your needs.\n\n> Start small with Go, then expand to the full suite as your data maturity grows.`,\n      expected: {\n        title: 'Key Takeaway',\n        description: 'The platform scales with your needs.',\n        callout: {\n          text: 'Start small with Go, then expand to the full suite as your data maturity grows.',\n        },\n      },\n    },\n    {\n      markdown: `## How to choose between a clinical serum and a nourishing dry oil\n\nClinically tested serums with patented actives target visible reduction of marks and uneven tone, while dry oils focus on broad nourishment and a satin finish.`,\n      expected: {\n        title: 'How to choose between a clinical serum and a nourishing dry oil',\n        description:\n          'Clinically tested serums with patented actives target visible reduction of marks and uneven tone, while dry oils focus on broad nourishment and a satin finish.',\n        callout: undefined,\n      },\n    },\n  ];\n\n  parse(parts: Part[], context?: ParseContext): TextBlockCompProps | null {\n    const title = headingMarkdown(parts, 2) || '';\n    const description = bodyText(parts) || '';\n    const callout = calloutFromParts(parts);\n\n    if (!title && !description) {\n      context?.reportDiagnostic?.(\n        DIAGNOSTIC_TYPES.SECTION_REJECTED,\n        'textBlock: both title and description are empty',\n      );\n      return null;\n    }\n\n    return { title, description, callout };\n  }\n}\n"],"mappings":";AACA,SAASA,eAAe,EAAEC,QAAQ,EAAEC,gBAAgB,QAAQ,eAAe;AAO3E,SAASC,gBAAgB,QAAQ,oBAAoB;AAErD,OAAO,MAAMC,0BAA0B,CAEvC;EAAAC,YAAA;IAAAC,eAAA,sBACgB,WAAW;IACzB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAAAA,eAAA,mBACW,CAAC,mCAAmC,CAAC;IAAAA,eAAA,mBAEjB;MAC7BC,KAAK,EAAE,kBAAkB;MACzBC,WAAW,EAAE,mBAAmB;MAChCC,OAAO,EAAE;QAAEC,IAAI,EAAE;MAA0B;IAC7C,CAAC;IAAAJ,eAAA,mBAEgD,CAC/C;MACEK,QAAQ,EAAE;AAChB;AACA;AACA;AACA,kQAAkQ;MAC5PC,QAAQ,EAAE;QACRL,KAAK,EAAE,uCAAuC;QAC9CC,WAAW,EACT,iLAAiL;QACnLC,OAAO,EAAE;UACPC,IAAI,EAAE;QACR;MACF;IACF,CAAC,EACD;MACEC,QAAQ,EAAE;AAChB;AACA;AACA;AACA;AACA,kFAAkF;MAC5EC,QAAQ,EAAE;QACRL,KAAK,EAAE,cAAc;QACrBC,WAAW,EAAE,sCAAsC;QACnDC,OAAO,EAAE;UACPC,IAAI,EAAE;QACR;MACF;IACF,CAAC,EACD;MACEC,QAAQ,EAAE;AAChB;AACA,gKAAgK;MAC1JC,QAAQ,EAAE;QACRL,KAAK,EAAE,iEAAiE;QACxEC,WAAW,EACT,iKAAiK;QACnKC,OAAO,EAAEI;MACX;IACF,CAAC,CACF;EAAA;EAEDC,KAAKA,CAACC,KAAa,EAAEC,OAAsB,EAA6B;IACtE,MAAMT,KAAK,GAAGP,eAAe,CAACe,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;IAC7C,MAAMP,WAAW,GAAGP,QAAQ,CAACc,KAAK,CAAC,IAAI,EAAE;IACzC,MAAMN,OAAO,GAAGP,gBAAgB,CAACa,KAAK,CAAC;IAEvC,IAAI,CAACR,KAAK,IAAI,CAACC,WAAW,EAAE;MAC1BQ,OAAO,YAAPA,OAAO,CAAEC,gBAAgB,YAAzBD,OAAO,CAAEC,gBAAgB,CACvBd,gBAAgB,CAACe,gBAAgB,EACjC,iDACF,CAAC;MACD,OAAO,IAAI;IACb;IAEA,OAAO;MAAEX,KAAK;MAAEC,WAAW;MAAEC;IAAQ,CAAC;EACxC;AACF","ignoreList":[]}

package/dist/esm/component/componentDefinitions/index.js

@@ -5,6 +5,7 @@ export { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition.js';
 export { KpiSectionDefinition } from './KpiSectionDefinition.js';
 export { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition.js';
 export { EntitySectionDefinition } from './EntitySectionDefinition.js';
+export { EntityCollectionSectionDefinition } from './EntityCollectionSectionDefinition.js';
 export { CtaBannerSectionDefinition } from './CtaBannerSectionDefinition.js';
 export { CalloutSectionDefinition } from './CalloutSectionDefinition.js';
 export { NextStepsSectionDefinition } from './NextStepsSectionDefinition.js';
@@ -21,6 +22,7 @@ import { SearchSectionDefinition } from './SearchSectionDefinition.js';
 import { KpiSectionDefinition } from './KpiSectionDefinition.js';
 import { NextStepsSectionDefinition } from './NextStepsSectionDefinition.js';
 import { EntitySectionDefinition } from './EntitySectionDefinition.js';
+import { EntityCollectionSectionDefinition } from './EntityCollectionSectionDefinition.js';
 import { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition.js';
 import { HeroSectionDefinition } from './HeroSectionDefinition.js';
 import { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition.js';
@@ -40,6 +42,17 @@ import { TextBlockSectionDefinition } from './TextBlockSectionDefinition.js';
  * Registration order determines evaluation priority — first match wins.
  */
 export function createSdkRegistry() {
-  return new ComponentRegistry(null).register(new SkipNodesSectionDefinition()).register(new SearchSectionDefinition()).register(new KpiSectionDefinition()).register(new NextStepsSectionDefinition()).register(new EntitySectionDefinition()).register(new HeroEntitySectionDefinition()).register(new HeroSectionDefinition()).register(new FeatureCardsSectionDefinition()).register(new TextBlockSectionDefinition()).register(new ListItemsSectionDefinition()).register(new FeatureSection9PlusDefinition()).register(new ComparisonSectionDefinition()).register(new HtmlCommentSectionDefinition()).register(new CtaBannerSectionDefinition()).register(new CalloutSectionDefinition()).register(new FallbackSectionDefinition()).register(new ErrorSectionDefinition());
+  return new ComponentRegistry(null).register(new SkipNodesSectionDefinition()).register(new SearchSectionDefinition()).register(new KpiSectionDefinition()).register(new NextStepsSectionDefinition())
+  // Collection entities are claimed by their own definition first — it is a
+  // strictly narrower match than EntitySectionDefinition, which would
+  // otherwise swallow collection, product and article blocks alike.
+  .register(new EntityCollectionSectionDefinition()).register(new EntitySectionDefinition()).register(new HeroEntitySectionDefinition()).register(new HeroSectionDefinition()).register(new FeatureCardsSectionDefinition()).register(new ListItemsSectionDefinition()).register(new FeatureSection9PlusDefinition()).register(new ComparisonSectionDefinition()).register(new HtmlCommentSectionDefinition()).register(new CtaBannerSectionDefinition())
+  // textBlock comes after every definition whose block opens `h2 > t`
+  // (entity, listItems, featureCards, ctaBanner, comparison, …). Its
+  // trailing callout is optional, so its pattern also matches a bare
+  // `h2 > t`, and a pattern matches a PREFIX of the block — registered
+  // above those it would claim the heading + intro paragraph and strand
+  // the list / links / table that follow in a separate section.
+  .register(new TextBlockSectionDefinition()).register(new CalloutSectionDefinition()).register(new FallbackSectionDefinition()).register(new ErrorSectionDefinition());
 }
 //# sourceMappingURL=index.js.map

package/dist/esm/component/componentDefinitions/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ComparisonSectionDefinition","TextBlockSectionDefinition","HeroSectionDefinition","HeroEntitySectionDefinition","KpiSectionDefinition","FeatureCardsSectionDefinition","EntitySectionDefinition","CtaBannerSectionDefinition","CalloutSectionDefinition","NextStepsSectionDefinition","FeatureSection9PlusDefinition","ListItemsSectionDefinition","SkipNodesSectionDefinition","HtmlCommentSectionDefinition","SearchSectionDefinition","ErrorSectionDefinition","FallbackSectionDefinition","ComponentRegistry","createSdkRegistry","register"],"sources":["../../../../src/component/componentDefinitions/index.ts"],"sourcesContent":["export type { SectionDefinition } from '../section-definition';\nexport { ComparisonSectionDefinition } from './ComparisonSectionDefinition';\nexport { TextBlockSectionDefinition } from './TextBlockSectionDefinition';\nexport { HeroSectionDefinition } from './HeroSectionDefinition';\nexport { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition';\nexport { KpiSectionDefinition } from './KpiSectionDefinition';\nexport { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition';\nexport { EntitySectionDefinition } from './EntitySectionDefinition';\nexport { CtaBannerSectionDefinition } from './CtaBannerSectionDefinition';\nexport { CalloutSectionDefinition } from './CalloutSectionDefinition';\nexport { NextStepsSectionDefinition } from './NextStepsSectionDefinition';\nexport { FeatureSection9PlusDefinition } from './FeatureSection9PlusDefinition';\nexport { ListItemsSectionDefinition } from './listItemsSectionDefinition';\nexport { SkipNodesSectionDefinition } from './SkipNodesSectionDefinition';\nexport { HtmlCommentSectionDefinition } from './HtmlCommentSectionDefinition';\nexport { SearchSectionDefinition } from './SearchSectionDefinition';\nexport { ErrorSectionDefinition } from './ErrorSectionDefinition';\nexport { FallbackSectionDefinition } from './FallbackSectionDefinition';\n\nimport { ComponentRegistry } from '../../registry';\nimport { SkipNodesSectionDefinition } from './SkipNodesSectionDefinition';\nimport { SearchSectionDefinition } from './SearchSectionDefinition';\nimport { KpiSectionDefinition } from './KpiSectionDefinition';\nimport { NextStepsSectionDefinition } from './NextStepsSectionDefinition';\nimport { EntitySectionDefinition } from './EntitySectionDefinition';\nimport { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition';\nimport { HeroSectionDefinition } from './HeroSectionDefinition';\nimport { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition';\nimport { FeatureSection9PlusDefinition } from './FeatureSection9PlusDefinition';\nimport { ListItemsSectionDefinition } from './listItemsSectionDefinition';\nimport { ComparisonSectionDefinition } from './ComparisonSectionDefinition';\nimport { HtmlCommentSectionDefinition } from './HtmlCommentSectionDefinition';\nimport { CtaBannerSectionDefinition } from './CtaBannerSectionDefinition';\nimport { CalloutSectionDefinition } from './CalloutSectionDefinition';\nimport { FallbackSectionDefinition } from './FallbackSectionDefinition';\nimport { ErrorSectionDefinition } from './ErrorSectionDefinition';\nimport { TextBlockSectionDefinition } from './TextBlockSectionDefinition';\n\n/**\n * Creates an SDK registry with all section definitions registered in the\n * same priority order as the app registry (createAppRegistry.ts).\n * Registration order determines evaluation priority — first match wins.\n */\nexport function createSdkRegistry(): ComponentRegistry<null> {\n  return new ComponentRegistry<null>(null)\n    .register(new SkipNodesSectionDefinition())\n    .register(new SearchSectionDefinition())\n    .register(new KpiSectionDefinition())\n    .register(new NextStepsSectionDefinition())\n    .register(new EntitySectionDefinition())\n    .register(new HeroEntitySectionDefinition())\n    .register(new HeroSectionDefinition())\n    .register(new FeatureCardsSectionDefinition())\n    .register(new TextBlockSectionDefinition())\n    .register(new ListItemsSectionDefinition())\n    .register(new FeatureSection9PlusDefinition())\n    .register(new ComparisonSectionDefinition())\n    .register(new HtmlCommentSectionDefinition())\n    .register(new CtaBannerSectionDefinition())\n    .register(new CalloutSectionDefinition())\n    .register(new FallbackSectionDefinition())\n    .register(new ErrorSectionDefinition());\n}\n"],"mappings":"AACA,SAASA,2BAA2B,QAAQ,+BAA+B;AAC3E,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,qBAAqB,QAAQ,yBAAyB;AAC/D,SAASC,2BAA2B,QAAQ,+BAA+B;AAC3E,SAASC,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASC,6BAA6B,QAAQ,iCAAiC;AAC/E,SAASC,uBAAuB,QAAQ,2BAA2B;AACnE,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,wBAAwB,QAAQ,4BAA4B;AACrE,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,6BAA6B,QAAQ,iCAAiC;AAC/E,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,4BAA4B,QAAQ,gCAAgC;AAC7E,SAASC,uBAAuB,QAAQ,2BAA2B;AACnE,SAASC,sBAAsB,QAAQ,0BAA0B;AACjE,SAASC,yBAAyB,QAAQ,6BAA6B;AAEvE,SAASC,iBAAiB,QAAQ,gBAAgB;AAClD,SAASL,0BAA0B,QAAQ,8BAA8B;AACzE,SAASE,uBAAuB,QAAQ,2BAA2B;AACnE,SAASV,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASK,0BAA0B,QAAQ,8BAA8B;AACzE,SAASH,uBAAuB,QAAQ,2BAA2B;AACnE,SAASH,2BAA2B,QAAQ,+BAA+B;AAC3E,SAASD,qBAAqB,QAAQ,yBAAyB;AAC/D,SAASG,6BAA6B,QAAQ,iCAAiC;AAC/E,SAASK,6BAA6B,QAAQ,iCAAiC;AAC/E,SAASC,0BAA0B,QAAQ,8BAA8B;AACzE,SAASX,2BAA2B,QAAQ,+BAA+B;AAC3E,SAASa,4BAA4B,QAAQ,gCAAgC;AAC7E,SAASN,0BAA0B,QAAQ,8BAA8B;AACzE,SAASC,wBAAwB,QAAQ,4BAA4B;AACrE,SAASQ,yBAAyB,QAAQ,6BAA6B;AACvE,SAASD,sBAAsB,QAAQ,0BAA0B;AACjE,SAASd,0BAA0B,QAAQ,8BAA8B;;AAEzE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASiB,iBAAiBA,CAAA,EAA4B;EAC3D,OAAO,IAAID,iBAAiB,CAAO,IAAI,CAAC,CACrCE,QAAQ,CAAC,IAAIP,0BAA0B,CAAC,CAAC,CAAC,CAC1CO,QAAQ,CAAC,IAAIL,uBAAuB,CAAC,CAAC,CAAC,CACvCK,QAAQ,CAAC,IAAIf,oBAAoB,CAAC,CAAC,CAAC,CACpCe,QAAQ,CAAC,IAAIV,0BAA0B,CAAC,CAAC,CAAC,CAC1CU,QAAQ,CAAC,IAAIb,uBAAuB,CAAC,CAAC,CAAC,CACvCa,QAAQ,CAAC,IAAIhB,2BAA2B,CAAC,CAAC,CAAC,CAC3CgB,QAAQ,CAAC,IAAIjB,qBAAqB,CAAC,CAAC,CAAC,CACrCiB,QAAQ,CAAC,IAAId,6BAA6B,CAAC,CAAC,CAAC,CAC7Cc,QAAQ,CAAC,IAAIlB,0BAA0B,CAAC,CAAC,CAAC,CAC1CkB,QAAQ,CAAC,IAAIR,0BAA0B,CAAC,CAAC,CAAC,CAC1CQ,QAAQ,CAAC,IAAIT,6BAA6B,CAAC,CAAC,CAAC,CAC7CS,QAAQ,CAAC,IAAInB,2BAA2B,CAAC,CAAC,CAAC,CAC3CmB,QAAQ,CAAC,IAAIN,4BAA4B,CAAC,CAAC,CAAC,CAC5CM,QAAQ,CAAC,IAAIZ,0BAA0B,CAAC,CAAC,CAAC,CAC1CY,QAAQ,CAAC,IAAIX,wBAAwB,CAAC,CAAC,CAAC,CACxCW,QAAQ,CAAC,IAAIH,yBAAyB,CAAC,CAAC,CAAC,CACzCG,QAAQ,CAAC,IAAIJ,sBAAsB,CAAC,CAAC,CAAC;AAC3C","ignoreList":[]}
+{"version":3,"names":["ComparisonSectionDefinition","TextBlockSectionDefinition","HeroSectionDefinition","HeroEntitySectionDefinition","KpiSectionDefinition","FeatureCardsSectionDefinition","EntitySectionDefinition","EntityCollectionSectionDefinition","CtaBannerSectionDefinition","CalloutSectionDefinition","NextStepsSectionDefinition","FeatureSection9PlusDefinition","ListItemsSectionDefinition","SkipNodesSectionDefinition","HtmlCommentSectionDefinition","SearchSectionDefinition","ErrorSectionDefinition","FallbackSectionDefinition","ComponentRegistry","createSdkRegistry","register"],"sources":["../../../../src/component/componentDefinitions/index.ts"],"sourcesContent":["export type { SectionDefinition } from '../section-definition';\nexport { ComparisonSectionDefinition } from './ComparisonSectionDefinition';\nexport { TextBlockSectionDefinition } from './TextBlockSectionDefinition';\nexport { HeroSectionDefinition } from './HeroSectionDefinition';\nexport { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition';\nexport { KpiSectionDefinition } from './KpiSectionDefinition';\nexport { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition';\nexport { EntitySectionDefinition } from './EntitySectionDefinition';\nexport { EntityCollectionSectionDefinition } from './EntityCollectionSectionDefinition';\nexport { CtaBannerSectionDefinition } from './CtaBannerSectionDefinition';\nexport { CalloutSectionDefinition } from './CalloutSectionDefinition';\nexport { NextStepsSectionDefinition } from './NextStepsSectionDefinition';\nexport { FeatureSection9PlusDefinition } from './FeatureSection9PlusDefinition';\nexport { ListItemsSectionDefinition } from './listItemsSectionDefinition';\nexport { SkipNodesSectionDefinition } from './SkipNodesSectionDefinition';\nexport { HtmlCommentSectionDefinition } from './HtmlCommentSectionDefinition';\nexport { SearchSectionDefinition } from './SearchSectionDefinition';\nexport { ErrorSectionDefinition } from './ErrorSectionDefinition';\nexport { FallbackSectionDefinition } from './FallbackSectionDefinition';\n\nimport { ComponentRegistry } from '../../registry';\nimport { SkipNodesSectionDefinition } from './SkipNodesSectionDefinition';\nimport { SearchSectionDefinition } from './SearchSectionDefinition';\nimport { KpiSectionDefinition } from './KpiSectionDefinition';\nimport { NextStepsSectionDefinition } from './NextStepsSectionDefinition';\nimport { EntitySectionDefinition } from './EntitySectionDefinition';\nimport { EntityCollectionSectionDefinition } from './EntityCollectionSectionDefinition';\nimport { HeroEntitySectionDefinition } from './HeroEntitySectionDefinition';\nimport { HeroSectionDefinition } from './HeroSectionDefinition';\nimport { FeatureCardsSectionDefinition } from './FeatureCardsSectionDefinition';\nimport { FeatureSection9PlusDefinition } from './FeatureSection9PlusDefinition';\nimport { ListItemsSectionDefinition } from './listItemsSectionDefinition';\nimport { ComparisonSectionDefinition } from './ComparisonSectionDefinition';\nimport { HtmlCommentSectionDefinition } from './HtmlCommentSectionDefinition';\nimport { CtaBannerSectionDefinition } from './CtaBannerSectionDefinition';\nimport { CalloutSectionDefinition } from './CalloutSectionDefinition';\nimport { FallbackSectionDefinition } from './FallbackSectionDefinition';\nimport { ErrorSectionDefinition } from './ErrorSectionDefinition';\nimport { TextBlockSectionDefinition } from './TextBlockSectionDefinition';\n\n/**\n * Creates an SDK registry with all section definitions registered in the\n * same priority order as the app registry (createAppRegistry.ts).\n * Registration order determines evaluation priority — first match wins.\n */\nexport function createSdkRegistry(): ComponentRegistry<null> {\n  return (\n    new ComponentRegistry<null>(null)\n      .register(new SkipNodesSectionDefinition())\n      .register(new SearchSectionDefinition())\n      .register(new KpiSectionDefinition())\n      .register(new NextStepsSectionDefinition())\n      // Collection entities are claimed by their own definition first — it is a\n      // strictly narrower match than EntitySectionDefinition, which would\n      // otherwise swallow collection, product and article blocks alike.\n      .register(new EntityCollectionSectionDefinition())\n      .register(new EntitySectionDefinition())\n      .register(new HeroEntitySectionDefinition())\n      .register(new HeroSectionDefinition())\n      .register(new FeatureCardsSectionDefinition())\n      .register(new ListItemsSectionDefinition())\n      .register(new FeatureSection9PlusDefinition())\n      .register(new ComparisonSectionDefinition())\n      .register(new HtmlCommentSectionDefinition())\n      .register(new CtaBannerSectionDefinition())\n      // textBlock comes after every definition whose block opens `h2 > t`\n      // (entity, listItems, featureCards, ctaBanner, comparison, …). Its\n      // trailing callout is optional, so its pattern also matches a bare\n      // `h2 > t`, and a pattern matches a PREFIX of the block — registered\n      // above those it would claim the heading + intro paragraph and strand\n      // the list / links / table that follow in a separate section.\n      .register(new TextBlockSectionDefinition())\n      .register(new CalloutSectionDefinition())\n      .register(new FallbackSectionDefinition())\n      .register(new ErrorSectionDefinition())\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/component/componentParser.js

@@ -21,6 +21,7 @@ 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 { isMatchDebugEnabled, logMatchDebug } from '../utils/matchDebug.js';
 import { DiagnosticsCollector } from '../utils/diagnosticsCollector.js';
 import { parseAstToMarkdown, parseMarkdownToAst } from '../utils/unifiedMarkdownParser.js';
 import { preprocessMarkdown } from '../utils/markdownPreprocessor.js';
@@ -30,8 +31,17 @@ import { createPageSection } from '../utils/propsExtractor.js';
 function isEntityCompProps(props) {
   return typeof props === 'object' && props !== null && Array.isArray(props.items);
 }
+
+/**
+ * Section types whose props are `EntityCompProps` and therefore participate in
+ * payload enrichment. `entityCollection` is `entity` narrowed to collection
+ * links — it produces the same props and arrives under the same
+ * `semantic: items` descriptor, so leaving it out would silently strip its
+ * items of their catalog data (image, title) and render the section blank.
+ */
+const ENRICHABLE_ENTITY_SECTION_TYPES = new Set(['entity', 'entityCollection']);
 function isItemsFromContentSection(sectionType, semantic, serverSectionId) {
-  if (sectionType !== 'entity') {
+  if (!ENRICHABLE_ENTITY_SECTION_TYPES.has(sectionType)) {
     return false;
   }
   const normalizedSemantic = semantic == null ? void 0 : semantic.toLowerCase().replace(/_/g, '-');
@@ -261,6 +271,15 @@ export function tryParseComponent(nodes, sectionIndex, context) {
     setMeta: context.tracking ? (sectionType, key, value) => context.tracking.setMeta(sectionType, key, value) : undefined,
     getMeta: context.tracking ? (sectionType, key) => context.tracking.getMeta(sectionType, key) : undefined
   };
+
+  // Debug-only trace (`?web5DebugMatch=1`). The registry order line doubles as
+  // a "is my definition even registered?" check — a definition missing from it
+  // never reached `register()` (stale client bundle / web5-core version skew).
+  const trace = isMatchDebugEnabled();
+  if (trace) {
+    logMatchDebug(`block #${sectionIndex} [${nodes.map(n => n.type).join(', ')}]`);
+    logMatchDebug(`  registry order: ${definitions.map(d => d.sectionType).join(' > ')}`);
+  }
   for (const {
     sectionType,
     definition
@@ -270,12 +289,18 @@ export function tryParseComponent(nodes, sectionIndex, context) {
     // 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)) {
+      if (trace) {
+        logMatchDebug(`  ${sectionType}: skipped (placement-only)`);
+      }
       continue;
     }
     for (const pattern of definition.patterns) {
       var _parts$find, _context$intent;
       const result = validatePattern(nodes, pattern);
       if (!result.valid) {
+        if (trace) {
+          logMatchDebug(`  ${sectionType}: no match — ${result.error ?? 'pattern did not match'}\n      pattern: ${pattern}`);
+        }
         continue;
       }
       let parsedNodes = result.astEndIndex !== undefined && result.astEndIndex >= 0 ? result.astEndIndex + 1 : result.endIndex >= 0 ? result.endIndex + 1 : 1;
@@ -298,8 +323,14 @@ export function tryParseComponent(nodes, sectionIndex, context) {
       };
       let props = definition.parse(parts, parseContext);
       if (props === null) {
+        if (trace) {
+          logMatchDebug(`  ${sectionType}: pattern matched ${parsedNodes} node(s) but parse() returned null — falling through`);
+        }
         continue;
       }
+      if (trace) {
+        logMatchDebug(`  ${sectionType}: MATCHED ${parsedNodes} node(s) via ${pattern}`);
+      }
       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;
@@ -313,6 +344,9 @@ export function tryParseComponent(nodes, sectionIndex, context) {
         });
       }
       if (definition.singleInstance && context.tracking && context.tracking.getComponentCount(sectionType) > 0) {
+        if (trace) {
+          logMatchDebug(`  ${sectionType}: dropped (singleInstance, already rendered once)`);
+        }
         continue;
       }
       const isNullComponent = definition.nullComponent === true;
@@ -360,6 +394,9 @@ export function tryParseComponent(nodes, sectionIndex, context) {
       };
     }
   }
+  if (trace) {
+    logMatchDebug('  no definition claimed this block');
+  }
   return {};
 }
 //# sourceMappingURL=componentParser.js.map