@activecollab/components 2.0.424 → 2.0.425

package/dist/esm/components/PortableText/renderers.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderers.js","names":["React","Fragment","StyledCode","StyledCodeBlock","StyledDivider","StyledLink","StyledList","StyledTableBlock","isPortableTextMediaImageVariant","Media","Table","Tbody","Thead","TitledText","titledTextHeadings","Body1","Typography","portableTextDefaultMarkRenderers","strong","_ref","children","createElement","em","_ref2","code","_ref3","link","_ref4","mark","href","target","rel","HEADING_LEVEL_VARIANTS","DEFAULT_HEADING_LEVEL","headingVariantForLevel","level","undefined","variant","console","warn","HeadingBlock","_ref5","block","_ref6","id","Heading","portableTextDefaultBlockRenderers","paragraph","_ref7","heading","list","_ref8","ordered","style","as","$ordered","_ref9","media","_ref0","_ref1","src","alt","caption","_ref10","_ref11","title","_ref12","_ref13","language","table","_ref14","renderSpans","_ref15","header","rows","cell","spans","map","span","index","key","text","row","rowIndex","cellIndex","divider"],"sources":["../../../../src/components/PortableText/renderers.tsx"],"sourcesContent":["import React, { Fragment, ReactNode } from \"react\";\n\nimport {\n  StyledCode,\n  StyledCodeBlock,\n  StyledDivider,\n  StyledLink,\n  StyledList,\n  StyledTableBlock,\n} from \"./Styles\";\nimport {\n  isPortableTextMediaImageVariant,\n  PortableTextBlockRenderer,\n  PortableTextCodeBlock,\n  PortableTextDefaultBlockType,\n  PortableTextDefaultMark,\n  PortableTextHeadingBlock,\n  PortableTextHeadingLevel,\n  PortableTextLinkMark,\n  PortableTextListBlock,\n  PortableTextMarkRenderer,\n  PortableTextMediaBlock,\n  PortableTextSpan,\n  PortableTextTableBlock,\n  PortableTextTitledTextBlock,\n} from \"./types\";\nimport { Media } from \"../Media\";\nimport { Table, Tbody, Thead } from \"../Tables\";\nimport {\n  TitledText,\n  TitledTextVariant,\n  titledTextHeadings,\n} from \"../TitledText\";\nimport { Body1 } from \"../Typography\";\nimport { Typography } from \"../Typography/Typography\";\n\n/**\n * The default renderers for the universal set — everything a client renders\n * without injection, and nothing more: no product element ever lands here.\n * Injected {@link PortableTextComponents} maps take precedence entry by entry.\n */\n\nexport const portableTextDefaultMarkRenderers: Record<\n  PortableTextDefaultMark,\n  PortableTextMarkRenderer\n> = {\n  strong: ({ children }) => <strong>{children}</strong>,\n  em: ({ children }) => <em>{children}</em>,\n  code: ({ children }) => <StyledCode>{children}</StyledCode>,\n  link: ({ mark, children }) => {\n    const href = (mark as PortableTextLinkMark | undefined)?.href;\n\n    // A link mark without an href (authored as a plain string) has nowhere\n    // to go — keep the text, skip the anchor.\n    if (!href) {\n      return <>{children}</>;\n    }\n\n    return (\n      <StyledLink href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n        {children}\n      </StyledLink>\n    );\n  },\n};\n\n/** The semantic wire levels resolve to typography only here, in the renderer. */\nconst HEADING_LEVEL_VARIANTS: Record<\n  PortableTextHeadingLevel,\n  TitledTextVariant\n> = {\n  1: \"title1\",\n  2: \"title2\",\n  3: \"header2\",\n};\n\n/** The level `heading` and `titled-text` fall back to. */\nconst DEFAULT_HEADING_LEVEL: PortableTextHeadingLevel = 3;\n\n/**\n * Resolve a semantic wire level to its typography variant. An absent level is\n * the documented default; any other unrecognised level is a serializer bug on\n * a fixed 1–3 scale, so it falls back to the default and is logged, per the\n * contract's degradation rule.\n */\nconst headingVariantForLevel = (\n  level: PortableTextHeadingLevel | undefined\n): TitledTextVariant => {\n  if (level === undefined) {\n    return HEADING_LEVEL_VARIANTS[DEFAULT_HEADING_LEVEL];\n  }\n\n  const variant = HEADING_LEVEL_VARIANTS[level];\n  if (!variant) {\n    console.warn(\n      `PortableText: unknown heading level ${level}, falling back to ${DEFAULT_HEADING_LEVEL}.`\n    );\n    return HEADING_LEVEL_VARIANTS[DEFAULT_HEADING_LEVEL];\n  }\n\n  return variant;\n};\n\n/** Heading levels map to the same typography TitledText uses. */\nconst HeadingBlock: PortableTextBlockRenderer = ({ block, children }) => {\n  const { level, id } = block as PortableTextHeadingBlock;\n  const Heading = titledTextHeadings[headingVariantForLevel(level)];\n  return <Heading id={id}>{children}</Heading>;\n};\n\nexport const portableTextDefaultBlockRenderers: Record<\n  PortableTextDefaultBlockType,\n  PortableTextBlockRenderer\n> = {\n  paragraph: ({ children }) => <Body1>{children}</Body1>,\n  heading: HeadingBlock,\n  list: ({ block, children }) => {\n    const ordered = (block as PortableTextListBlock).style === \"number\";\n    return (\n      // `data-portable-list` scopes the depth-marker rules in Styles.ts to\n      // design-system lists, and marks the ancestors those rules count.\n      <StyledList\n        as={ordered ? \"ol\" : \"ul\"}\n        $ordered={ordered}\n        data-portable-list=\"\"\n      >\n        {children}\n      </StyledList>\n    );\n  },\n  \"list-item\": ({ children }) => (\n    <Typography variant=\"Body 1\" as=\"li\">\n      {children}\n    </Typography>\n  ),\n  media: ({ block }) => {\n    const { src, alt, variant, caption } = block as PortableTextMediaBlock;\n\n    // Video (and future) variants carry service semantics, so their renderer\n    // is application-catalog territory — an injected `media` override. The\n    // universal set covers images only; anything else degrades and warns, per\n    // the contract's degradation rule.\n    if (variant !== undefined && !isPortableTextMediaImageVariant(variant)) {\n      console.warn(\n        `PortableText: no default renderer for media variant \"${variant}\".`\n      );\n      return null;\n    }\n\n    return <Media src={src} alt={alt} variant={variant} caption={caption} />;\n  },\n  \"titled-text\": ({ block, children }) => {\n    const { title, level } = block as PortableTextTitledTextBlock;\n    return (\n      <TitledText title={title} variant={headingVariantForLevel(level)}>\n        {children}\n      </TitledText>\n    );\n  },\n  // No highlighter ships with the default set, so every language — known,\n  // unknown or absent — is plain preformatted text; the hint travels on\n  // data-language for surfaces that highlight.\n  \"code-block\": ({ block }) => {\n    const { code, language } = block as PortableTextCodeBlock;\n    return (\n      <StyledCodeBlock data-language={language || undefined}>\n        <code>{code}</code>\n      </StyledCodeBlock>\n    );\n  },\n  table: ({ block, renderSpans }) => {\n    const { header, rows } = block as PortableTextTableBlock;\n    // Standalone (engine-less) use has no span renderer — keep the raw text.\n    const cell = (spans: PortableTextSpan[]): ReactNode =>\n      renderSpans\n        ? renderSpans(spans)\n        : spans.map((span, index) => (\n            <Fragment key={index}>{span.text}</Fragment>\n          ));\n\n    return (\n      <StyledTableBlock>\n        <Table>\n          <Thead>\n            <tr>\n              {header.map((spans, index) => (\n                <th key={index}>{cell(spans)}</th>\n              ))}\n            </tr>\n          </Thead>\n          <Tbody>\n            {rows.map((row, rowIndex) => (\n              <tr key={rowIndex}>\n                {row.map((spans, cellIndex) => (\n                  <td key={cellIndex}>{cell(spans)}</td>\n                ))}\n              </tr>\n            ))}\n          </Tbody>\n        </Table>\n      </StyledTableBlock>\n    );\n  },\n  divider: () => <StyledDivider />,\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"renderers.js","names":["React","Fragment","StyledCode","StyledCodeBlock","StyledDivider","StyledLink","StyledList","StyledTableBlock","isPortableTextMediaImageVariant","Media","Table","Tbody","Thead","TitledText","titledTextHeadings","Body1","Typography","portableTextDefaultMarkRenderers","strong","_ref","children","createElement","em","_ref2","code","_ref3","link","_ref4","mark","href","target","rel","HEADING_LEVEL_VARIANTS","DEFAULT_HEADING_LEVEL","headingVariantForLevel","level","undefined","variant","console","warn","HeadingBlock","_ref5","block","_ref6","id","Heading","portableTextDefaultBlockRenderers","paragraph","_ref7","heading","list","_ref8","ordered","style","as","$ordered","_ref9","media","_ref0","_ref1","src","alt","caption","width","height","density","_ref10","_ref11","title","_ref12","_ref13","language","table","_ref14","renderSpans","_ref15","header","rows","cell","spans","map","span","index","key","text","row","rowIndex","cellIndex","divider"],"sources":["../../../../src/components/PortableText/renderers.tsx"],"sourcesContent":["import React, { Fragment, ReactNode } from \"react\";\n\nimport {\n  StyledCode,\n  StyledCodeBlock,\n  StyledDivider,\n  StyledLink,\n  StyledList,\n  StyledTableBlock,\n} from \"./Styles\";\nimport {\n  isPortableTextMediaImageVariant,\n  PortableTextBlockRenderer,\n  PortableTextCodeBlock,\n  PortableTextDefaultBlockType,\n  PortableTextDefaultMark,\n  PortableTextHeadingBlock,\n  PortableTextHeadingLevel,\n  PortableTextLinkMark,\n  PortableTextListBlock,\n  PortableTextMarkRenderer,\n  PortableTextMediaBlock,\n  PortableTextSpan,\n  PortableTextTableBlock,\n  PortableTextTitledTextBlock,\n} from \"./types\";\nimport { Media } from \"../Media\";\nimport { Table, Tbody, Thead } from \"../Tables\";\nimport {\n  TitledText,\n  TitledTextVariant,\n  titledTextHeadings,\n} from \"../TitledText\";\nimport { Body1 } from \"../Typography\";\nimport { Typography } from \"../Typography/Typography\";\n\n/**\n * The default renderers for the universal set — everything a client renders\n * without injection, and nothing more: no product element ever lands here.\n * Injected {@link PortableTextComponents} maps take precedence entry by entry.\n */\n\nexport const portableTextDefaultMarkRenderers: Record<\n  PortableTextDefaultMark,\n  PortableTextMarkRenderer\n> = {\n  strong: ({ children }) => <strong>{children}</strong>,\n  em: ({ children }) => <em>{children}</em>,\n  code: ({ children }) => <StyledCode>{children}</StyledCode>,\n  link: ({ mark, children }) => {\n    const href = (mark as PortableTextLinkMark | undefined)?.href;\n\n    // A link mark without an href (authored as a plain string) has nowhere\n    // to go — keep the text, skip the anchor.\n    if (!href) {\n      return <>{children}</>;\n    }\n\n    return (\n      <StyledLink href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n        {children}\n      </StyledLink>\n    );\n  },\n};\n\n/** The semantic wire levels resolve to typography only here, in the renderer. */\nconst HEADING_LEVEL_VARIANTS: Record<\n  PortableTextHeadingLevel,\n  TitledTextVariant\n> = {\n  1: \"title1\",\n  2: \"title2\",\n  3: \"header2\",\n};\n\n/** The level `heading` and `titled-text` fall back to. */\nconst DEFAULT_HEADING_LEVEL: PortableTextHeadingLevel = 3;\n\n/**\n * Resolve a semantic wire level to its typography variant. An absent level is\n * the documented default; any other unrecognised level is a serializer bug on\n * a fixed 1–3 scale, so it falls back to the default and is logged, per the\n * contract's degradation rule.\n */\nconst headingVariantForLevel = (\n  level: PortableTextHeadingLevel | undefined\n): TitledTextVariant => {\n  if (level === undefined) {\n    return HEADING_LEVEL_VARIANTS[DEFAULT_HEADING_LEVEL];\n  }\n\n  const variant = HEADING_LEVEL_VARIANTS[level];\n  if (!variant) {\n    console.warn(\n      `PortableText: unknown heading level ${level}, falling back to ${DEFAULT_HEADING_LEVEL}.`\n    );\n    return HEADING_LEVEL_VARIANTS[DEFAULT_HEADING_LEVEL];\n  }\n\n  return variant;\n};\n\n/** Heading levels map to the same typography TitledText uses. */\nconst HeadingBlock: PortableTextBlockRenderer = ({ block, children }) => {\n  const { level, id } = block as PortableTextHeadingBlock;\n  const Heading = titledTextHeadings[headingVariantForLevel(level)];\n  return <Heading id={id}>{children}</Heading>;\n};\n\nexport const portableTextDefaultBlockRenderers: Record<\n  PortableTextDefaultBlockType,\n  PortableTextBlockRenderer\n> = {\n  paragraph: ({ children }) => <Body1>{children}</Body1>,\n  heading: HeadingBlock,\n  list: ({ block, children }) => {\n    const ordered = (block as PortableTextListBlock).style === \"number\";\n    return (\n      // `data-portable-list` scopes the depth-marker rules in Styles.ts to\n      // design-system lists, and marks the ancestors those rules count.\n      <StyledList\n        as={ordered ? \"ol\" : \"ul\"}\n        $ordered={ordered}\n        data-portable-list=\"\"\n      >\n        {children}\n      </StyledList>\n    );\n  },\n  \"list-item\": ({ children }) => (\n    <Typography variant=\"Body 1\" as=\"li\">\n      {children}\n    </Typography>\n  ),\n  media: ({ block }) => {\n    const { src, alt, variant, caption, width, height, density } =\n      block as PortableTextMediaBlock;\n\n    // Video (and future) variants carry service semantics, so their renderer\n    // is application-catalog territory — an injected `media` override. The\n    // universal set covers images only; anything else degrades and warns, per\n    // the contract's degradation rule.\n    if (variant !== undefined && !isPortableTextMediaImageVariant(variant)) {\n      console.warn(\n        `PortableText: no default renderer for media variant \"${variant}\".`\n      );\n      return null;\n    }\n\n    return (\n      <Media\n        src={src}\n        alt={alt}\n        variant={variant}\n        caption={caption}\n        width={width}\n        height={height}\n        density={density}\n      />\n    );\n  },\n  \"titled-text\": ({ block, children }) => {\n    const { title, level } = block as PortableTextTitledTextBlock;\n    return (\n      <TitledText title={title} variant={headingVariantForLevel(level)}>\n        {children}\n      </TitledText>\n    );\n  },\n  // No highlighter ships with the default set, so every language — known,\n  // unknown or absent — is plain preformatted text; the hint travels on\n  // data-language for surfaces that highlight.\n  \"code-block\": ({ block }) => {\n    const { code, language } = block as PortableTextCodeBlock;\n    return (\n      <StyledCodeBlock data-language={language || undefined}>\n        <code>{code}</code>\n      </StyledCodeBlock>\n    );\n  },\n  table: ({ block, renderSpans }) => {\n    const { header, rows } = block as PortableTextTableBlock;\n    // Standalone (engine-less) use has no span renderer — keep the raw text.\n    const cell = (spans: PortableTextSpan[]): ReactNode =>\n      renderSpans\n        ? renderSpans(spans)\n        : spans.map((span, index) => (\n            <Fragment key={index}>{span.text}</Fragment>\n          ));\n\n    return (\n      <StyledTableBlock>\n        <Table>\n          <Thead>\n            <tr>\n              {header.map((spans, index) => (\n                <th key={index}>{cell(spans)}</th>\n              ))}\n            </tr>\n          </Thead>\n          <Tbody>\n            {rows.map((row, rowIndex) => (\n              <tr key={rowIndex}>\n                {row.map((spans, cellIndex) => (\n                  <td key={cellIndex}>{cell(spans)}</td>\n                ))}\n              </tr>\n            ))}\n          </Tbody>\n        </Table>\n      </StyledTableBlock>\n    );\n  },\n  divider: () => <StyledDivider />,\n};\n"],"mappings":"AAAA,OAAOA,KAAK,IAAIC,QAAQ,QAAmB,OAAO;AAElD,SACEC,UAAU,EACVC,eAAe,EACfC,aAAa,EACbC,UAAU,EACVC,UAAU,EACVC,gBAAgB,QACX,UAAU;AACjB,SACEC,+BAA+B,QAc1B,SAAS;AAChB,SAASC,KAAK,QAAQ,UAAU;AAChC,SAASC,KAAK,EAAEC,KAAK,EAAEC,KAAK,QAAQ,WAAW;AAC/C,SACEC,UAAU,EAEVC,kBAAkB,QACb,eAAe;AACtB,SAASC,KAAK,QAAQ,eAAe;AACrC,SAASC,UAAU,QAAQ,0BAA0B;;AAErD;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,gCAGZ,GAAG;EACFC,MAAM,EAAEC,IAAA;IAAA,IAAGC,QAAQ,GAAAD,IAAA,CAARC,QAAQ;IAAA,oBAAOpB,KAAA,CAAAqB,aAAA,iBAASD,QAAiB,CAAC;EAAA;EACrDE,EAAE,EAAEC,KAAA;IAAA,IAAGH,QAAQ,GAAAG,KAAA,CAARH,QAAQ;IAAA,oBAAOpB,KAAA,CAAAqB,aAAA,aAAKD,QAAa,CAAC;EAAA;EACzCI,IAAI,EAAEC,KAAA;IAAA,IAAGL,QAAQ,GAAAK,KAAA,CAARL,QAAQ;IAAA,oBAAOpB,KAAA,CAAAqB,aAAA,CAACnB,UAAU,QAAEkB,QAAqB,CAAC;EAAA;EAC3DM,IAAI,EAAEC,KAAA,IAAwB;IAAA,IAArBC,IAAI,GAAAD,KAAA,CAAJC,IAAI;MAAER,QAAQ,GAAAO,KAAA,CAARP,QAAQ;IACrB,MAAMS,IAAI,GAAID,IAAI,oBAAJA,IAAI,CAAuCC,IAAI;;IAE7D;IACA;IACA,IAAI,CAACA,IAAI,EAAE;MACT,oBAAO7B,KAAA,CAAAqB,aAAA,CAAArB,KAAA,CAAAC,QAAA,QAAGmB,QAAW,CAAC;IACxB;IAEA,oBACEpB,KAAA,CAAAqB,aAAA,CAAChB,UAAU;MAACwB,IAAI,EAAEA,IAAK;MAACC,MAAM,EAAC,QAAQ;MAACC,GAAG,EAAC;IAAqB,GAC9DX,QACS,CAAC;EAEjB;AACF,CAAC;;AAED;AACA,MAAMY,sBAGL,GAAG;EACF,CAAC,EAAE,QAAQ;EACX,CAAC,EAAE,QAAQ;EACX,CAAC,EAAE;AACL,CAAC;;AAED;AACA,MAAMC,qBAA+C,GAAG,CAAC;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,sBAAsB,GAC1BC,KAA2C,IACrB;EACtB,IAAIA,KAAK,KAAKC,SAAS,EAAE;IACvB,OAAOJ,sBAAsB,CAACC,qBAAqB,CAAC;EACtD;EAEA,MAAMI,OAAO,GAAGL,sBAAsB,CAACG,KAAK,CAAC;EAC7C,IAAI,CAACE,OAAO,EAAE;IACZC,OAAO,CAACC,IAAI,0CAC6BJ,KAAK,0BAAqBF,qBAAqB,MACxF,CAAC;IACD,OAAOD,sBAAsB,CAACC,qBAAqB,CAAC;EACtD;EAEA,OAAOI,OAAO;AAChB,CAAC;;AAED;AACA,MAAMG,YAAuC,GAAGC,KAAA,IAAyB;EAAA,IAAtBC,KAAK,GAAAD,KAAA,CAALC,KAAK;IAAEtB,QAAQ,GAAAqB,KAAA,CAARrB,QAAQ;EAChE,MAAAuB,KAAA,GAAsBD,KAAK;IAAnBP,KAAK,GAAAQ,KAAA,CAALR,KAAK;IAAES,EAAE,GAAAD,KAAA,CAAFC,EAAE;EACjB,MAAMC,OAAO,GAAG/B,kBAAkB,CAACoB,sBAAsB,CAACC,KAAK,CAAC,CAAC;EACjE,oBAAOnC,KAAA,CAAAqB,aAAA,CAACwB,OAAO;IAACD,EAAE,EAAEA;EAAG,GAAExB,QAAkB,CAAC;AAC9C,CAAC;AAED,OAAO,MAAM0B,iCAGZ,GAAG;EACFC,SAAS,EAAEC,KAAA;IAAA,IAAG5B,QAAQ,GAAA4B,KAAA,CAAR5B,QAAQ;IAAA,oBAAOpB,KAAA,CAAAqB,aAAA,CAACN,KAAK,QAAEK,QAAgB,CAAC;EAAA;EACtD6B,OAAO,EAAET,YAAY;EACrBU,IAAI,EAAEC,KAAA,IAAyB;IAAA,IAAtBT,KAAK,GAAAS,KAAA,CAALT,KAAK;MAAEtB,QAAQ,GAAA+B,KAAA,CAAR/B,QAAQ;IACtB,MAAMgC,OAAO,GAAIV,KAAK,CAA2BW,KAAK,KAAK,QAAQ;IACnE;MAAA;MACE;MACA;MACArD,KAAA,CAAAqB,aAAA,CAACf,UAAU;QACTgD,EAAE,EAAEF,OAAO,GAAG,IAAI,GAAG,IAAK;QAC1BG,QAAQ,EAAEH,OAAQ;QAClB,sBAAmB;MAAE,GAEpBhC,QACS;IAAC;EAEjB,CAAC;EACD,WAAW,EAAEoC,KAAA;IAAA,IAAGpC,QAAQ,GAAAoC,KAAA,CAARpC,QAAQ;IAAA,oBACtBpB,KAAA,CAAAqB,aAAA,CAACL,UAAU;MAACqB,OAAO,EAAC,QAAQ;MAACiB,EAAE,EAAC;IAAI,GACjClC,QACS,CAAC;EAAA,CACd;EACDqC,KAAK,EAAEC,KAAA,IAAe;IAAA,IAAZhB,KAAK,GAAAgB,KAAA,CAALhB,KAAK;IACb,MAAAiB,KAAA,GACEjB,KAAK;MADCkB,GAAG,GAAAD,KAAA,CAAHC,GAAG;MAAEC,GAAG,GAAAF,KAAA,CAAHE,GAAG;MAAExB,OAAO,GAAAsB,KAAA,CAAPtB,OAAO;MAAEyB,OAAO,GAAAH,KAAA,CAAPG,OAAO;MAAEC,KAAK,GAAAJ,KAAA,CAALI,KAAK;MAAEC,MAAM,GAAAL,KAAA,CAANK,MAAM;MAAEC,OAAO,GAAAN,KAAA,CAAPM,OAAO;;IAG1D;IACA;IACA;IACA;IACA,IAAI5B,OAAO,KAAKD,SAAS,IAAI,CAAC5B,+BAA+B,CAAC6B,OAAO,CAAC,EAAE;MACtEC,OAAO,CAACC,IAAI,4DAC8CF,OAAO,QACjE,CAAC;MACD,OAAO,IAAI;IACb;IAEA,oBACErC,KAAA,CAAAqB,aAAA,CAACZ,KAAK;MACJmD,GAAG,EAAEA,GAAI;MACTC,GAAG,EAAEA,GAAI;MACTxB,OAAO,EAAEA,OAAQ;MACjByB,OAAO,EAAEA,OAAQ;MACjBC,KAAK,EAAEA,KAAM;MACbC,MAAM,EAAEA,MAAO;MACfC,OAAO,EAAEA;IAAQ,CAClB,CAAC;EAEN,CAAC;EACD,aAAa,EAAEC,MAAA,IAAyB;IAAA,IAAtBxB,KAAK,GAAAwB,MAAA,CAALxB,KAAK;MAAEtB,QAAQ,GAAA8C,MAAA,CAAR9C,QAAQ;IAC/B,MAAA+C,MAAA,GAAyBzB,KAAK;MAAtB0B,KAAK,GAAAD,MAAA,CAALC,KAAK;MAAEjC,KAAK,GAAAgC,MAAA,CAALhC,KAAK;IACpB,oBACEnC,KAAA,CAAAqB,aAAA,CAACR,UAAU;MAACuD,KAAK,EAAEA,KAAM;MAAC/B,OAAO,EAAEH,sBAAsB,CAACC,KAAK;IAAE,GAC9Df,QACS,CAAC;EAEjB,CAAC;EACD;EACA;EACA;EACA,YAAY,EAAEiD,MAAA,IAAe;IAAA,IAAZ3B,KAAK,GAAA2B,MAAA,CAAL3B,KAAK;IACpB,MAAA4B,MAAA,GAA2B5B,KAAK;MAAxBlB,IAAI,GAAA8C,MAAA,CAAJ9C,IAAI;MAAE+C,QAAQ,GAAAD,MAAA,CAARC,QAAQ;IACtB,oBACEvE,KAAA,CAAAqB,aAAA,CAAClB,eAAe;MAAC,iBAAeoE,QAAQ,IAAInC;IAAU,gBACpDpC,KAAA,CAAAqB,aAAA,eAAOG,IAAW,CACH,CAAC;EAEtB,CAAC;EACDgD,KAAK,EAAEC,MAAA,IAA4B;IAAA,IAAzB/B,KAAK,GAAA+B,MAAA,CAAL/B,KAAK;MAAEgC,WAAW,GAAAD,MAAA,CAAXC,WAAW;IAC1B,MAAAC,MAAA,GAAyBjC,KAAK;MAAtBkC,MAAM,GAAAD,MAAA,CAANC,MAAM;MAAEC,IAAI,GAAAF,MAAA,CAAJE,IAAI;IACpB;IACA,MAAMC,IAAI,GAAIC,KAAyB,IACrCL,WAAW,GACPA,WAAW,CAACK,KAAK,CAAC,GAClBA,KAAK,CAACC,GAAG,CAAC,CAACC,IAAI,EAAEC,KAAK,kBACpBlF,KAAA,CAAAqB,aAAA,CAACpB,QAAQ;MAACkF,GAAG,EAAED;IAAM,GAAED,IAAI,CAACG,IAAe,CAC5C,CAAC;IAER,oBACEpF,KAAA,CAAAqB,aAAA,CAACd,gBAAgB,qBACfP,KAAA,CAAAqB,aAAA,CAACX,KAAK,qBACJV,KAAA,CAAAqB,aAAA,CAACT,KAAK,qBACJZ,KAAA,CAAAqB,aAAA,aACGuD,MAAM,CAACI,GAAG,CAAC,CAACD,KAAK,EAAEG,KAAK,kBACvBlF,KAAA,CAAAqB,aAAA;MAAI8D,GAAG,EAAED;IAAM,GAAEJ,IAAI,CAACC,KAAK,CAAM,CAClC,CACC,CACC,CAAC,eACR/E,KAAA,CAAAqB,aAAA,CAACV,KAAK,QACHkE,IAAI,CAACG,GAAG,CAAC,CAACK,GAAG,EAAEC,QAAQ,kBACtBtF,KAAA,CAAAqB,aAAA;MAAI8D,GAAG,EAAEG;IAAS,GACfD,GAAG,CAACL,GAAG,CAAC,CAACD,KAAK,EAAEQ,SAAS,kBACxBvF,KAAA,CAAAqB,aAAA;MAAI8D,GAAG,EAAEI;IAAU,GAAET,IAAI,CAACC,KAAK,CAAM,CACtC,CACC,CACL,CACI,CACF,CACS,CAAC;EAEvB,CAAC;EACDS,OAAO,EAAEA,CAAA,kBAAMxF,KAAA,CAAAqB,aAAA,CAACjB,aAAa,MAAE;AACjC,CAAC","ignoreList":[]}

package/dist/esm/components/PortableText/types.d.ts

@@ -80,6 +80,22 @@ export interface PortableTextMediaBlock {
     alt?: string;
     variant?: PortableTextMediaVariant;
     caption?: string;
+    /**
+     * Display size in CSS pixels — the image's real on-screen size after the
+     * compile-time density divide (a 2x screenshot is measured, then halved).
+     * The renderer draws the image at this size, capping the width at the
+     * column and never upscaling past it. Absent when the build could not
+     * measure the source (e.g. a remote `http(s)` src); the renderer then falls
+     * back to the column-width cap.
+     */
+    width?: number;
+    height?: number;
+    /**
+     * The density factor the width and height were derived from (2 for a Retina
+     * capture). Drives the `srcset` so Retina viewers get full sharpness at the
+     * same display size. Opaque to layout.
+     */
+    density?: number;
 }
 export interface PortableTextTitledTextBlock {
     type: "titled-text";

package/dist/esm/components/PortableText/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/PortableText/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/PortableText/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/PortableText/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":["PORTABLE_TEXT_DEFAULT_MARKS","MEDIA_IMAGE_VARIANTS","screenshot","illustration","isPortableTextMediaImageVariant","value","DEFAULT_BLOCK_TYPES","paragraph","heading","list","media","table","divider","PORTABLE_TEXT_DEFAULT_BLOCKS","Object","keys","isRecord","isPortableTextSpan","text","isPortableTextTableRow","Array","isArray","every","cell","isPortableTextObjectNode","type","_type","isPortableTextBlock","children","id","undefined","child","src","title","content","isPortableTextContent","code","language","header","rows","node"],"sources":["../../../../src/components/PortableText/types.ts"],"sourcesContent":["import { ComponentType, ReactNode } from \"react\";\n\n/**\n * Portable Text envelope — the general content contract for structured,\n * renderer-independent content (in-app messages, help, changelogs).\n *\n * The design system owns this envelope and the universal default set below.\n * It never hardcodes a product element: concrete elements (callout,\n * button-reference, doc-link, …) are defined in the application catalog and\n * injected into the Portable Text engine through {@link PortableTextComponents}.\n * See README.md next to this file for the full contract.\n */\n\n/* ---- Spans and marks ------------------------------------------------- */\n\n/**\n * A mark with data. Parameterless marks travel as plain strings (\"strong\");\n * marks that need data travel as objects discriminated by `type`.\n */\nexport interface PortableTextMarkObject {\n  type: string;\n  [data: string]: unknown;\n}\n\n/** The one default mark that carries data. */\nexport interface PortableTextLinkMark extends PortableTextMarkObject {\n  type: \"link\";\n  href: string;\n}\n\nexport type PortableTextMark = string | PortableTextMarkObject;\n\n/** The leaf of every text run: a piece of text plus the marks wrapping it. */\nexport interface PortableTextSpan {\n  text: string;\n  marks?: PortableTextMark[];\n}\n\n/** Marks every client understands without injection. */\nexport const PORTABLE_TEXT_DEFAULT_MARKS = [\n  \"strong\",\n  \"em\",\n  \"code\",\n  \"link\",\n] as const;\n\nexport type PortableTextDefaultMark =\n  (typeof PORTABLE_TEXT_DEFAULT_MARKS)[number];\n\n/* ---- Blocks ----------------------------------------------------------- */\n\nexport interface PortableTextParagraphBlock {\n  type: \"paragraph\";\n  children: PortableTextSpan[];\n}\n\n/** 1 maps to Title1, 2 to Title2, 3 to Header2 typography. */\nexport type PortableTextHeadingLevel = 1 | 2 | 3;\n\nexport interface PortableTextHeadingBlock {\n  type: \"heading\";\n  level: PortableTextHeadingLevel;\n  /**\n   * Optional anchor id, rendered verbatim as the heading element's `id` so the\n   * heading is a scroll target (e.g. subarticle deep-links). Opaque to the\n   * renderer — any slug convention lives with whoever produced the block.\n   */\n  id?: string;\n  children: PortableTextSpan[];\n}\n\nexport type PortableTextListStyle = \"bullet\" | \"number\";\n\n/**\n * A list item's children are its own spans first, then any nested `list`\n * block(s) — the shape that carries multi-level lists. A spans-only item (no\n * nested list) is the common, flat case and stays valid unchanged.\n */\nexport interface PortableTextListItemBlock {\n  type: \"list-item\";\n  children: (PortableTextSpan | PortableTextListBlock)[];\n}\n\nexport interface PortableTextListBlock {\n  type: \"list\";\n  style?: PortableTextListStyle;\n  children: PortableTextListItemBlock[];\n}\n\n/** Screenshots render framed (border, no shadow); illustrations render flat. */\nexport type PortableTextMediaImageVariant = \"screenshot\" | \"illustration\";\n\n/**\n * Video variants name the hosting service; `src` is the canonical video URL.\n * Their rendering carries service semantics (URL parsing, embed derivation),\n * so it belongs to the application catalog — injected as a `media` block\n * override — never to the default set. The default renderer degrades them.\n */\nexport type PortableTextMediaVideoVariant = \"vimeo\" | \"youtube\";\n\nexport type PortableTextMediaVariant =\n  | PortableTextMediaImageVariant\n  | PortableTextMediaVideoVariant;\n\n// A Record so the compiler checks the list against the union in both\n// directions: a missing and a stray key each fail to build.\nconst MEDIA_IMAGE_VARIANTS: Record<PortableTextMediaImageVariant, true> = {\n  screenshot: true,\n  illustration: true,\n};\n\nexport const isPortableTextMediaImageVariant = (\n  value: unknown\n): value is PortableTextMediaImageVariant =>\n  typeof value === \"string\" && value in MEDIA_IMAGE_VARIANTS;\n\nexport interface PortableTextMediaBlock {\n  type: \"media\";\n  src: string;\n  alt?: string;\n  variant?: PortableTextMediaVariant;\n  caption?: string;\n}\n\nexport interface PortableTextTitledTextBlock {\n  type: \"titled-text\";\n  /**\n   * Same semantic scale as `heading` — 1, 2 or 3 (the default) — so the wire\n   * format never encodes a typography name. How a level looks is the\n   * renderer's business.\n   */\n  level?: PortableTextHeadingLevel;\n  title: string;\n  content?: PortableTextNode[];\n}\n\nexport interface PortableTextCodeBlock {\n  type: \"code-block\";\n  /**\n   * A language hint (e.g. \"php\", \"json\"). The default renderer does no\n   * highlighting, so any value — known, unknown or absent — renders as plain\n   * preformatted text; it travels as data for surfaces that highlight.\n   */\n  language?: string;\n  code: string;\n}\n\n/** A table cell is a span array, so inline marks work inside cells. */\nexport type PortableTextTableCell = PortableTextSpan[];\nexport type PortableTextTableRow = PortableTextTableCell[];\n\nexport interface PortableTextTableBlock {\n  type: \"table\";\n  header: PortableTextTableRow;\n  rows: PortableTextTableRow[];\n}\n\n/** A themed horizontal rule between sections. Carries no data. */\nexport interface PortableTextDividerBlock {\n  type: \"divider\";\n}\n\nexport type PortableTextBlock =\n  | PortableTextParagraphBlock\n  | PortableTextHeadingBlock\n  | PortableTextListBlock\n  | PortableTextMediaBlock\n  | PortableTextTitledTextBlock\n  | PortableTextCodeBlock\n  | PortableTextTableBlock\n  | PortableTextDividerBlock;\n\n/**\n * Derived from the union's discriminators, so adding a block to the union\n * without a renderer entry is a compile error, never silent drift.\n */\nexport type PortableTextDefaultBlockType = (\n  | PortableTextBlock\n  | PortableTextListItemBlock\n)[\"type\"];\n\n// A Record so the compiler checks the list against the union in both\n// directions: a missing and a stray key each fail to build.\nconst DEFAULT_BLOCK_TYPES: Record<PortableTextDefaultBlockType, true> = {\n  paragraph: true,\n  heading: true,\n  list: true,\n  \"list-item\": true,\n  media: true,\n  \"titled-text\": true,\n  \"code-block\": true,\n  table: true,\n  divider: true,\n};\n\n/** Blocks every client understands without injection. */\nexport const PORTABLE_TEXT_DEFAULT_BLOCKS = Object.keys(\n  DEFAULT_BLOCK_TYPES\n) as readonly PortableTextDefaultBlockType[];\n\n/* ---- Objects ----------------------------------------------------------- */\n\n/**\n * An embedded component the envelope does not interpret: `_type` names an\n * application-catalog element, everything else is that element's data. An\n * object whose `_type` has no injected renderer renders nothing and is logged.\n */\nexport interface PortableTextObjectNode {\n  type: \"object\";\n  _type: string;\n  [data: string]: unknown;\n}\n\nexport type PortableTextNode = PortableTextBlock | PortableTextObjectNode;\n\n/** The root of a message body: what an API returns under `content`. */\nexport type PortableTextContent = PortableTextNode[];\n\n/* ---- Injection contract ------------------------------------------------ */\n\nexport interface PortableTextMarkRendererProps<\n  TMark extends PortableTextMarkObject = PortableTextMarkObject\n> {\n  /** Present for object marks; absent when the mark is a plain string. */\n  mark?: TMark;\n  children: ReactNode;\n}\n\nexport type PortableTextMarkRenderer<\n  TMark extends PortableTextMarkObject = PortableTextMarkObject\n> = ComponentType<PortableTextMarkRendererProps<TMark>>;\n\nexport interface PortableTextObjectRendererProps<\n  TNode extends PortableTextObjectNode = PortableTextObjectNode\n> {\n  node: TNode;\n  /** The object's nested `content`, already rendered by the engine. */\n  children?: ReactNode;\n}\n\nexport type PortableTextObjectRenderer<\n  TNode extends PortableTextObjectNode = PortableTextObjectNode\n> = ComponentType<PortableTextObjectRendererProps<TNode>>;\n\nexport interface PortableTextBlockRendererProps<\n  TBlock extends PortableTextBlock = PortableTextBlock\n> {\n  block: TBlock;\n  /** The block's rendered children/content, when it has any. */\n  children?: ReactNode;\n  /**\n   * Engine-bound span renderer for blocks that carry spans outside `children`\n   * (table cells). Resolves marks with the same precedence — injected first,\n   * then defaults — as flowing text. Absent when a renderer is used without\n   * the engine.\n   */\n  renderSpans?: (spans: PortableTextSpan[]) => ReactNode;\n}\n\nexport type PortableTextBlockRenderer<\n  TBlock extends PortableTextBlock = PortableTextBlock\n> = ComponentType<PortableTextBlockRendererProps<TBlock>>;\n\nexport type PortableTextUnknownKind = \"block\" | \"mark\" | \"object\";\n\n/**\n * Called once per unknown type instead of rendering it, so content written\n * for newer clients degrades silently on older ones.\n */\nexport type PortableTextUnknownTypeHandler = (\n  kind: PortableTextUnknownKind,\n  type: string\n) => void;\n\n/**\n * What an application injects into the Portable Text engine: renderers for\n * its catalog marks and objects, optional overrides for the default blocks,\n * and the unknown-type hook.\n */\nexport interface PortableTextComponents {\n  marks?: Record<string, PortableTextMarkRenderer>;\n  objects?: Record<string, PortableTextObjectRenderer>;\n  blocks?: Partial<\n    Record<PortableTextDefaultBlockType, PortableTextBlockRenderer>\n  >;\n  onUnknownType?: PortableTextUnknownTypeHandler;\n}\n\n/* ---- Runtime guards ----------------------------------------------------- */\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nexport const isPortableTextSpan = (value: unknown): value is PortableTextSpan =>\n  isRecord(value) && typeof value.text === \"string\";\n\nexport const isPortableTextTableRow = (\n  value: unknown\n): value is PortableTextTableRow =>\n  Array.isArray(value) &&\n  value.every((cell) => Array.isArray(cell) && cell.every(isPortableTextSpan));\n\nexport const isPortableTextObjectNode = (\n  value: unknown\n): value is PortableTextObjectNode =>\n  isRecord(value) && value.type === \"object\" && typeof value._type === \"string\";\n\n/**\n * A block is any non-object node with a string `type`. Unknown block types\n * stay valid on purpose — they render nothing on clients that predate them.\n * Known types are held to their shape, so a serializer bug (a paragraph\n * without `children`, a list of non-nodes) fails here instead of at render.\n */\nexport const isPortableTextBlock = (\n  value: unknown\n): value is PortableTextBlock => {\n  if (\n    !isRecord(value) ||\n    typeof value.type !== \"string\" ||\n    value.type === \"object\"\n  ) {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"paragraph\":\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(isPortableTextSpan)\n      );\n    case \"heading\":\n      return (\n        (value.id === undefined || typeof value.id === \"string\") &&\n        Array.isArray(value.children) &&\n        value.children.every(isPortableTextSpan)\n      );\n    case \"list-item\":\n      // The item's spans, plus optional nested `list` block(s). Widened only\n      // for nested lists: any other block child (a stray paragraph, an object)\n      // still fails, so a serializer bug is caught here, not at render.\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(\n          (child) =>\n            isPortableTextSpan(child) ||\n            (isPortableTextBlock(child) && child.type === \"list\")\n        )\n      );\n    case \"list\":\n      // A list holds `list-item`s only. A sublist emitted as a sibling of the\n      // items (the classic half-implemented-nesting bug) renders invalid HTML\n      // — <ul> with a direct <ul> child — so it fails here, not at render.\n      // `list-item` is validated but sits outside the PortableTextBlock union,\n      // so the discriminator is checked before isPortableTextBlock narrows it.\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(\n          (child) =>\n            isRecord(child) &&\n            child.type === \"list-item\" &&\n            isPortableTextBlock(child)\n        )\n      );\n    case \"media\":\n      return typeof value.src === \"string\";\n    case \"titled-text\":\n      return (\n        typeof value.title === \"string\" &&\n        (value.content === undefined || isPortableTextContent(value.content))\n      );\n    case \"code-block\":\n      return (\n        typeof value.code === \"string\" &&\n        (value.language === undefined || typeof value.language === \"string\")\n      );\n    case \"table\":\n      return (\n        isPortableTextTableRow(value.header) &&\n        Array.isArray(value.rows) &&\n        value.rows.every(isPortableTextTableRow)\n      );\n    case \"divider\":\n      return true;\n    default:\n      return true;\n  }\n};\n\nexport const isPortableTextContent = (\n  value: unknown\n): value is PortableTextContent =>\n  Array.isArray(value) &&\n  value.every(\n    (node) => isPortableTextBlock(node) || isPortableTextObjectNode(node)\n  );\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"types.js","names":["PORTABLE_TEXT_DEFAULT_MARKS","MEDIA_IMAGE_VARIANTS","screenshot","illustration","isPortableTextMediaImageVariant","value","DEFAULT_BLOCK_TYPES","paragraph","heading","list","media","table","divider","PORTABLE_TEXT_DEFAULT_BLOCKS","Object","keys","isRecord","isPortableTextSpan","text","isPortableTextTableRow","Array","isArray","every","cell","isPortableTextObjectNode","type","_type","isPortableTextBlock","children","id","undefined","child","src","title","content","isPortableTextContent","code","language","header","rows","node"],"sources":["../../../../src/components/PortableText/types.ts"],"sourcesContent":["import { ComponentType, ReactNode } from \"react\";\n\n/**\n * Portable Text envelope — the general content contract for structured,\n * renderer-independent content (in-app messages, help, changelogs).\n *\n * The design system owns this envelope and the universal default set below.\n * It never hardcodes a product element: concrete elements (callout,\n * button-reference, doc-link, …) are defined in the application catalog and\n * injected into the Portable Text engine through {@link PortableTextComponents}.\n * See README.md next to this file for the full contract.\n */\n\n/* ---- Spans and marks ------------------------------------------------- */\n\n/**\n * A mark with data. Parameterless marks travel as plain strings (\"strong\");\n * marks that need data travel as objects discriminated by `type`.\n */\nexport interface PortableTextMarkObject {\n  type: string;\n  [data: string]: unknown;\n}\n\n/** The one default mark that carries data. */\nexport interface PortableTextLinkMark extends PortableTextMarkObject {\n  type: \"link\";\n  href: string;\n}\n\nexport type PortableTextMark = string | PortableTextMarkObject;\n\n/** The leaf of every text run: a piece of text plus the marks wrapping it. */\nexport interface PortableTextSpan {\n  text: string;\n  marks?: PortableTextMark[];\n}\n\n/** Marks every client understands without injection. */\nexport const PORTABLE_TEXT_DEFAULT_MARKS = [\n  \"strong\",\n  \"em\",\n  \"code\",\n  \"link\",\n] as const;\n\nexport type PortableTextDefaultMark =\n  (typeof PORTABLE_TEXT_DEFAULT_MARKS)[number];\n\n/* ---- Blocks ----------------------------------------------------------- */\n\nexport interface PortableTextParagraphBlock {\n  type: \"paragraph\";\n  children: PortableTextSpan[];\n}\n\n/** 1 maps to Title1, 2 to Title2, 3 to Header2 typography. */\nexport type PortableTextHeadingLevel = 1 | 2 | 3;\n\nexport interface PortableTextHeadingBlock {\n  type: \"heading\";\n  level: PortableTextHeadingLevel;\n  /**\n   * Optional anchor id, rendered verbatim as the heading element's `id` so the\n   * heading is a scroll target (e.g. subarticle deep-links). Opaque to the\n   * renderer — any slug convention lives with whoever produced the block.\n   */\n  id?: string;\n  children: PortableTextSpan[];\n}\n\nexport type PortableTextListStyle = \"bullet\" | \"number\";\n\n/**\n * A list item's children are its own spans first, then any nested `list`\n * block(s) — the shape that carries multi-level lists. A spans-only item (no\n * nested list) is the common, flat case and stays valid unchanged.\n */\nexport interface PortableTextListItemBlock {\n  type: \"list-item\";\n  children: (PortableTextSpan | PortableTextListBlock)[];\n}\n\nexport interface PortableTextListBlock {\n  type: \"list\";\n  style?: PortableTextListStyle;\n  children: PortableTextListItemBlock[];\n}\n\n/** Screenshots render framed (border, no shadow); illustrations render flat. */\nexport type PortableTextMediaImageVariant = \"screenshot\" | \"illustration\";\n\n/**\n * Video variants name the hosting service; `src` is the canonical video URL.\n * Their rendering carries service semantics (URL parsing, embed derivation),\n * so it belongs to the application catalog — injected as a `media` block\n * override — never to the default set. The default renderer degrades them.\n */\nexport type PortableTextMediaVideoVariant = \"vimeo\" | \"youtube\";\n\nexport type PortableTextMediaVariant =\n  | PortableTextMediaImageVariant\n  | PortableTextMediaVideoVariant;\n\n// A Record so the compiler checks the list against the union in both\n// directions: a missing and a stray key each fail to build.\nconst MEDIA_IMAGE_VARIANTS: Record<PortableTextMediaImageVariant, true> = {\n  screenshot: true,\n  illustration: true,\n};\n\nexport const isPortableTextMediaImageVariant = (\n  value: unknown\n): value is PortableTextMediaImageVariant =>\n  typeof value === \"string\" && value in MEDIA_IMAGE_VARIANTS;\n\nexport interface PortableTextMediaBlock {\n  type: \"media\";\n  src: string;\n  alt?: string;\n  variant?: PortableTextMediaVariant;\n  caption?: string;\n  /**\n   * Display size in CSS pixels — the image's real on-screen size after the\n   * compile-time density divide (a 2x screenshot is measured, then halved).\n   * The renderer draws the image at this size, capping the width at the\n   * column and never upscaling past it. Absent when the build could not\n   * measure the source (e.g. a remote `http(s)` src); the renderer then falls\n   * back to the column-width cap.\n   */\n  width?: number;\n  height?: number;\n  /**\n   * The density factor the width and height were derived from (2 for a Retina\n   * capture). Drives the `srcset` so Retina viewers get full sharpness at the\n   * same display size. Opaque to layout.\n   */\n  density?: number;\n}\n\nexport interface PortableTextTitledTextBlock {\n  type: \"titled-text\";\n  /**\n   * Same semantic scale as `heading` — 1, 2 or 3 (the default) — so the wire\n   * format never encodes a typography name. How a level looks is the\n   * renderer's business.\n   */\n  level?: PortableTextHeadingLevel;\n  title: string;\n  content?: PortableTextNode[];\n}\n\nexport interface PortableTextCodeBlock {\n  type: \"code-block\";\n  /**\n   * A language hint (e.g. \"php\", \"json\"). The default renderer does no\n   * highlighting, so any value — known, unknown or absent — renders as plain\n   * preformatted text; it travels as data for surfaces that highlight.\n   */\n  language?: string;\n  code: string;\n}\n\n/** A table cell is a span array, so inline marks work inside cells. */\nexport type PortableTextTableCell = PortableTextSpan[];\nexport type PortableTextTableRow = PortableTextTableCell[];\n\nexport interface PortableTextTableBlock {\n  type: \"table\";\n  header: PortableTextTableRow;\n  rows: PortableTextTableRow[];\n}\n\n/** A themed horizontal rule between sections. Carries no data. */\nexport interface PortableTextDividerBlock {\n  type: \"divider\";\n}\n\nexport type PortableTextBlock =\n  | PortableTextParagraphBlock\n  | PortableTextHeadingBlock\n  | PortableTextListBlock\n  | PortableTextMediaBlock\n  | PortableTextTitledTextBlock\n  | PortableTextCodeBlock\n  | PortableTextTableBlock\n  | PortableTextDividerBlock;\n\n/**\n * Derived from the union's discriminators, so adding a block to the union\n * without a renderer entry is a compile error, never silent drift.\n */\nexport type PortableTextDefaultBlockType = (\n  | PortableTextBlock\n  | PortableTextListItemBlock\n)[\"type\"];\n\n// A Record so the compiler checks the list against the union in both\n// directions: a missing and a stray key each fail to build.\nconst DEFAULT_BLOCK_TYPES: Record<PortableTextDefaultBlockType, true> = {\n  paragraph: true,\n  heading: true,\n  list: true,\n  \"list-item\": true,\n  media: true,\n  \"titled-text\": true,\n  \"code-block\": true,\n  table: true,\n  divider: true,\n};\n\n/** Blocks every client understands without injection. */\nexport const PORTABLE_TEXT_DEFAULT_BLOCKS = Object.keys(\n  DEFAULT_BLOCK_TYPES\n) as readonly PortableTextDefaultBlockType[];\n\n/* ---- Objects ----------------------------------------------------------- */\n\n/**\n * An embedded component the envelope does not interpret: `_type` names an\n * application-catalog element, everything else is that element's data. An\n * object whose `_type` has no injected renderer renders nothing and is logged.\n */\nexport interface PortableTextObjectNode {\n  type: \"object\";\n  _type: string;\n  [data: string]: unknown;\n}\n\nexport type PortableTextNode = PortableTextBlock | PortableTextObjectNode;\n\n/** The root of a message body: what an API returns under `content`. */\nexport type PortableTextContent = PortableTextNode[];\n\n/* ---- Injection contract ------------------------------------------------ */\n\nexport interface PortableTextMarkRendererProps<\n  TMark extends PortableTextMarkObject = PortableTextMarkObject\n> {\n  /** Present for object marks; absent when the mark is a plain string. */\n  mark?: TMark;\n  children: ReactNode;\n}\n\nexport type PortableTextMarkRenderer<\n  TMark extends PortableTextMarkObject = PortableTextMarkObject\n> = ComponentType<PortableTextMarkRendererProps<TMark>>;\n\nexport interface PortableTextObjectRendererProps<\n  TNode extends PortableTextObjectNode = PortableTextObjectNode\n> {\n  node: TNode;\n  /** The object's nested `content`, already rendered by the engine. */\n  children?: ReactNode;\n}\n\nexport type PortableTextObjectRenderer<\n  TNode extends PortableTextObjectNode = PortableTextObjectNode\n> = ComponentType<PortableTextObjectRendererProps<TNode>>;\n\nexport interface PortableTextBlockRendererProps<\n  TBlock extends PortableTextBlock = PortableTextBlock\n> {\n  block: TBlock;\n  /** The block's rendered children/content, when it has any. */\n  children?: ReactNode;\n  /**\n   * Engine-bound span renderer for blocks that carry spans outside `children`\n   * (table cells). Resolves marks with the same precedence — injected first,\n   * then defaults — as flowing text. Absent when a renderer is used without\n   * the engine.\n   */\n  renderSpans?: (spans: PortableTextSpan[]) => ReactNode;\n}\n\nexport type PortableTextBlockRenderer<\n  TBlock extends PortableTextBlock = PortableTextBlock\n> = ComponentType<PortableTextBlockRendererProps<TBlock>>;\n\nexport type PortableTextUnknownKind = \"block\" | \"mark\" | \"object\";\n\n/**\n * Called once per unknown type instead of rendering it, so content written\n * for newer clients degrades silently on older ones.\n */\nexport type PortableTextUnknownTypeHandler = (\n  kind: PortableTextUnknownKind,\n  type: string\n) => void;\n\n/**\n * What an application injects into the Portable Text engine: renderers for\n * its catalog marks and objects, optional overrides for the default blocks,\n * and the unknown-type hook.\n */\nexport interface PortableTextComponents {\n  marks?: Record<string, PortableTextMarkRenderer>;\n  objects?: Record<string, PortableTextObjectRenderer>;\n  blocks?: Partial<\n    Record<PortableTextDefaultBlockType, PortableTextBlockRenderer>\n  >;\n  onUnknownType?: PortableTextUnknownTypeHandler;\n}\n\n/* ---- Runtime guards ----------------------------------------------------- */\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nexport const isPortableTextSpan = (value: unknown): value is PortableTextSpan =>\n  isRecord(value) && typeof value.text === \"string\";\n\nexport const isPortableTextTableRow = (\n  value: unknown\n): value is PortableTextTableRow =>\n  Array.isArray(value) &&\n  value.every((cell) => Array.isArray(cell) && cell.every(isPortableTextSpan));\n\nexport const isPortableTextObjectNode = (\n  value: unknown\n): value is PortableTextObjectNode =>\n  isRecord(value) && value.type === \"object\" && typeof value._type === \"string\";\n\n/**\n * A block is any non-object node with a string `type`. Unknown block types\n * stay valid on purpose — they render nothing on clients that predate them.\n * Known types are held to their shape, so a serializer bug (a paragraph\n * without `children`, a list of non-nodes) fails here instead of at render.\n */\nexport const isPortableTextBlock = (\n  value: unknown\n): value is PortableTextBlock => {\n  if (\n    !isRecord(value) ||\n    typeof value.type !== \"string\" ||\n    value.type === \"object\"\n  ) {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"paragraph\":\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(isPortableTextSpan)\n      );\n    case \"heading\":\n      return (\n        (value.id === undefined || typeof value.id === \"string\") &&\n        Array.isArray(value.children) &&\n        value.children.every(isPortableTextSpan)\n      );\n    case \"list-item\":\n      // The item's spans, plus optional nested `list` block(s). Widened only\n      // for nested lists: any other block child (a stray paragraph, an object)\n      // still fails, so a serializer bug is caught here, not at render.\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(\n          (child) =>\n            isPortableTextSpan(child) ||\n            (isPortableTextBlock(child) && child.type === \"list\")\n        )\n      );\n    case \"list\":\n      // A list holds `list-item`s only. A sublist emitted as a sibling of the\n      // items (the classic half-implemented-nesting bug) renders invalid HTML\n      // — <ul> with a direct <ul> child — so it fails here, not at render.\n      // `list-item` is validated but sits outside the PortableTextBlock union,\n      // so the discriminator is checked before isPortableTextBlock narrows it.\n      return (\n        Array.isArray(value.children) &&\n        value.children.every(\n          (child) =>\n            isRecord(child) &&\n            child.type === \"list-item\" &&\n            isPortableTextBlock(child)\n        )\n      );\n    case \"media\":\n      return typeof value.src === \"string\";\n    case \"titled-text\":\n      return (\n        typeof value.title === \"string\" &&\n        (value.content === undefined || isPortableTextContent(value.content))\n      );\n    case \"code-block\":\n      return (\n        typeof value.code === \"string\" &&\n        (value.language === undefined || typeof value.language === \"string\")\n      );\n    case \"table\":\n      return (\n        isPortableTextTableRow(value.header) &&\n        Array.isArray(value.rows) &&\n        value.rows.every(isPortableTextTableRow)\n      );\n    case \"divider\":\n      return true;\n    default:\n      return true;\n  }\n};\n\nexport const isPortableTextContent = (\n  value: unknown\n): value is PortableTextContent =>\n  Array.isArray(value) &&\n  value.every(\n    (node) => isPortableTextBlock(node) || isPortableTextObjectNode(node)\n  );\n"],"mappings":"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","ignoreList":[]}

package/dist/index.js

@@ -26196,16 +26196,52 @@
   var StyledMedia = styled__default["default"].div.withConfig({
     displayName: "Styles__StyledMedia",
     componentId: "sc-zjz7mh-0"
-  })(["display:flex;flex-direction:column;gap:", ";width:100%;.c-media-frame{", "}.c-media-frame img{display:block;width:100%;height:auto;}"], SPACE.sm, function (_ref) {
+  })(["display:flex;flex-direction:column;gap:", ";width:100%;.c-media-frame{width:fit-content;max-width:100%;margin-inline:auto;", "}.c-media-frame img{display:block;height:auto;", "}"], SPACE.sm, function (_ref) {
     var $bordered = _ref.$bordered;
     return $bordered && styled.css(["overflow:hidden;border:1px solid var(--border-primary);border-radius:", ";"], "0.5rem");
+  }, function (_ref2) {
+    var $sized = _ref2.$sized;
+    return $sized ? styled.css(["max-width:100%;"]) : styled.css(["width:100%;"]);
   });
   StyledMedia.displayName = "StyledMedia";
 
-  var _excluded$q = ["src", "alt", "variant", "caption"];
+  var _excluded$q = ["src", "alt", "variant", "caption", "width", "height", "density"];
+  /** A tall image (height greater than width) is capped at this display height. */
+  var MEDIA_PORTRAIT_MAX_HEIGHT = 680;
+
+  /**
+   * The box the `<img>` is laid out in, in CSS pixels. A portrait image taller
+   * than the cap is scaled down to the cap, keeping its aspect ratio. Resolving
+   * the cap here — rather than with `width: auto; max-height` in CSS — keeps the
+   * size independent of the file's natural pixel size, so a 2x capture without a
+   * `density` (and therefore no `srcset` descriptor) never renders upscaled.
+   */
+  var displaySize = function displaySize(width, height) {
+    if (width == null || height == null) {
+      return undefined;
+    }
+    if (height > width && height > MEDIA_PORTRAIT_MAX_HEIGHT) {
+      return {
+        width: Math.round(width * MEDIA_PORTRAIT_MAX_HEIGHT / height),
+        height: MEDIA_PORTRAIT_MAX_HEIGHT
+      };
+    }
+    return {
+      width,
+      height
+    };
+  };
+
   /**
    * An image block: a screenshot renders framed (border, no shadow), a flat
    * illustration renders without a frame. The caption sits below the frame.
+   *
+   * `width`/`height` are the image's real display size in CSS pixels, measured
+   * at compile time. When present, the image renders at that size — centered,
+   * capped at the column width, never upscaled — and the `<img>` reserves the
+   * space so the layout does not jump as it loads. A tall image (height greater
+   * than width) is capped by height instead. When absent (e.g. a remote source
+   * the build could not measure), the image falls back to the column-width cap.
    */
   var Media = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     var src = _ref.src,
@@ -26213,15 +26249,23 @@
       _ref$variant = _ref.variant,
       variant = _ref$variant === void 0 ? "illustration" : _ref$variant,
       caption = _ref.caption,
+      width = _ref.width,
+      height = _ref.height,
+      density = _ref.density,
       rest = _objectWithoutProperties(_ref, _excluded$q);
+    var size = displaySize(width, height);
     return /*#__PURE__*/React__default["default"].createElement(StyledMedia, _extends({
       ref: ref,
-      $bordered: variant === "screenshot"
+      $bordered: variant === "screenshot",
+      $sized: size !== undefined
     }, rest), /*#__PURE__*/React__default["default"].createElement("div", {
       className: "c-media-frame"
     }, /*#__PURE__*/React__default["default"].createElement("img", {
       src: src,
-      alt: alt !== null && alt !== void 0 ? alt : ""
+      alt: alt !== null && alt !== void 0 ? alt : "",
+      width: size === null || size === void 0 ? void 0 : size.width,
+      height: size === null || size === void 0 ? void 0 : size.height,
+      srcSet: density ? "".concat(src, " ").concat(density, "x") : undefined
     })), caption ? /*#__PURE__*/React__default["default"].createElement(Caption1, {
       color: "secondary"
     }, caption) : null);
@@ -26413,7 +26457,10 @@
         src = _ref1.src,
         alt = _ref1.alt,
         variant = _ref1.variant,
-        caption = _ref1.caption;
+        caption = _ref1.caption,
+        width = _ref1.width,
+        height = _ref1.height,
+        density = _ref1.density;
 
       // Video (and future) variants carry service semantics, so their renderer
       // is application-catalog territory — an injected `media` override. The
@@ -26427,7 +26474,10 @@
         src: src,
         alt: alt,
         variant: variant,
-        caption: caption
+        caption: caption,
+        width: width,
+        height: height,
+        density: density
       });
     },
     "titled-text": function titledText(_ref10) {
@@ -31013,6 +31063,7 @@
   exports.ListSeparator = ListSeparator;
   exports.LockIcon = LockIcon$1;
   exports.LockSmallIcon = LockSmallIcon$1;
+  exports.MEDIA_PORTRAIT_MAX_HEIGHT = MEDIA_PORTRAIT_MAX_HEIGHT;
   exports.MarkerIcon = MarkerIcon$1;
   exports.MeasuredPane = MeasuredPane;
   exports.Media = Media;