@redsift/design-system 12.5.3-alpha.5 → 12.5.3-alpha.6

package/_internal/Text2.js

@@ -2,6 +2,7 @@ import { b as _objectWithoutProperties, c as _extends } from './_rollupPluginBab
 import React__default, { forwardRef } from 'react';
 import classNames from 'classnames';
 import { S as StyledText, b as StyledHighlightMarker } from './styles6.js';
+import { w as warnOnAliasProps } from './warnAliasProps.js';
 import { n as normalizeHighlightOptions, i as isNonAscii, r as replaceInvisibleChars } from './highlightNonAscii.js';
 import { F as FontFamily } from './fonts.js';
 import { f as getStylingTransientProps } from './styles.js';
@@ -10,6 +11,31 @@ import { u as useTheme } from './useTheme.js';
 const _excluded = ["as", "children", "className", "color", "fontFamily", "fontSize", "fontWeight", "highlightNonAscii", "lineHeight", "noWrap", "theme", "variant", "wordBreak"];
 const COMPONENT_NAME = 'Text';
 const CLASSNAME = 'redsift-text';
+const TEXT_ALIAS_WARNINGS = [{
+  prop: 'kind',
+  use: 'variant'
+}, {
+  prop: 'appearance',
+  use: 'variant'
+}, {
+  prop: 'size',
+  use: 'fontSize',
+  hint: 'Text uses fontSize / variant for sizing.'
+}, {
+  prop: 'weight',
+  use: 'fontWeight'
+}, {
+  prop: 'level',
+  use: 'as',
+  hint: 'For headings (h1-h6) use the Heading component, not Text.'
+}, {
+  prop: 'tag',
+  use: 'as'
+}, {
+  prop: 'slot',
+  use: 'children',
+  hint: 'Text does not implement a slot API; pass content as children.'
+}];
 
 /**
  * Processes a string and wraps consecutive non-ASCII characters in highlight markers.
@@ -103,6 +129,7 @@ const highlightNonAsciiChars = (text, options) => {
  * <Text highlightNonAscii>ƅankofamerica.com</Text>
  */
 const Text = /*#__PURE__*/forwardRef((props, ref) => {
+  warnOnAliasProps(COMPONENT_NAME, props, TEXT_ALIAS_WARNINGS);
   const {
     transientProps,
     otherProps

package/_internal/Text2.js.map

@@ -1 +1 @@
-{"version":3,"file":"Text2.js","sources":["../../src/components/text/Text.tsx"],"sourcesContent":["import React, { forwardRef, ReactNode, RefObject } from 'react';\nimport classNames from 'classnames';\nimport { Comp, FontFamily, getStylingTransientProps } from '../../types';\nimport { StyledText, StyledHighlightMarker } from './styles';\nimport { TextProps } from './types';\nimport { useTheme } from '../theme';\nimport {\n  isNonAscii,\n  replaceInvisibleChars,\n  normalizeHighlightOptions,\n  NormalizedHighlightOptions,\n} from '../../utils/highlightNonAscii';\n\nconst COMPONENT_NAME = 'Text';\nconst CLASSNAME = 'redsift-text';\n\n/**\n * Processes a string and wraps consecutive non-ASCII characters in highlight markers.\n * Groups consecutive non-ASCII characters to minimize DOM nodes.\n * Invisible characters are replaced with visible indicators (•).\n */\nconst highlightNonAsciiChars = (text: string, options: NormalizedHighlightOptions): ReactNode[] => {\n  const result: ReactNode[] = [];\n  let currentAscii = '';\n  let currentNonAscii = '';\n  let keyIndex = 0;\n\n  // Use Array.from to correctly handle Unicode surrogate pairs (e.g., emojis)\n  const chars = Array.from(text);\n\n  for (const char of chars) {\n    if (isNonAscii(char)) {\n      // Flush ASCII buffer\n      if (currentAscii) {\n        result.push(currentAscii);\n        currentAscii = '';\n      }\n      currentNonAscii += char;\n    } else {\n      // Flush non-ASCII buffer\n      if (currentNonAscii) {\n        result.push(\n          <StyledHighlightMarker key={keyIndex++} $font={options.font} $background={options.background}>\n            {replaceInvisibleChars(currentNonAscii)}\n          </StyledHighlightMarker>\n        );\n        currentNonAscii = '';\n      }\n      currentAscii += char;\n    }\n  }\n\n  // Flush remaining buffers\n  if (currentAscii) {\n    result.push(currentAscii);\n  }\n  if (currentNonAscii) {\n    result.push(\n      <StyledHighlightMarker key={keyIndex} $font={options.font} $background={options.background}>\n        {replaceInvisibleChars(currentNonAscii)}\n      </StyledHighlightMarker>\n    );\n  }\n\n  return result;\n};\n\n/**\n * Text renders text content with consistent styling. By default renders a\n * `<span>` but can be changed via the `as` prop.\n *\n * Variants: `body`, `button`, `caption`, `inherit`\n * Semantic elements: `span` (default), `p`, `b`, `i`, `u`, `abbr`, `cite`,\n * `del`, `em`, `ins`, `kbd`, `mark`, `s`, `samp`, `sub`, `sup`\n *\n * @example\n * // Basic text\n * <Text>Hello world</Text>\n *\n * @example\n * // Typography variants\n * <Text variant=\"body\">Body text for paragraphs</Text>\n * <Text variant=\"button\">Button-style text</Text>\n * <Text variant=\"caption\">Small caption text</Text>\n *\n * @example\n * // Semantic elements\n * <Text as=\"p\">Paragraph element</Text>\n * <Text as=\"b\">Bold text</Text>\n * <Text as=\"em\">Emphasized text</Text>\n * <Text as=\"mark\">Highlighted text</Text>\n * <Text as=\"kbd\">Keyboard input</Text>\n *\n * @example\n * // Custom styling\n * <Text color=\"grey\" fontSize=\"14px\" fontWeight={600}>Custom styled</Text>\n *\n * @example\n * // Truncated text with ellipsis\n * <Text noWrap>Very long text that will be truncated with ellipsis...</Text>\n *\n * @example\n * // Caption with color\n * <Text variant=\"caption\" color=\"grey\">Last updated: Jan 2024</Text>\n *\n * @example\n * // Highlight non-ASCII characters (useful for IDN domain names)\n * <Text highlightNonAscii>ƅankofamerica.com</Text>\n */\nexport const Text: Comp<TextProps, HTMLDivElement> = forwardRef((props, ref) => {\n  const { transientProps, otherProps } = getStylingTransientProps(props);\n\n  const {\n    as,\n    children,\n    className,\n    color,\n    fontFamily = FontFamily.poppins,\n    fontSize,\n    fontWeight,\n    highlightNonAscii,\n    lineHeight,\n    noWrap,\n    theme: propsTheme,\n    variant,\n    wordBreak,\n    ...forwardedProps\n  } = otherProps;\n\n  const theme = useTheme(propsTheme);\n\n  // Process children to highlight non-ASCII characters if enabled and children is a string\n  let renderedChildren = children;\n  if (highlightNonAscii && typeof children === 'string') {\n    const options = normalizeHighlightOptions(highlightNonAscii);\n    renderedChildren = highlightNonAsciiChars(children, options);\n  }\n\n  return (\n    <StyledText\n      as={as}\n      {...forwardedProps}\n      {...transientProps}\n      className={classNames(Text.className, className)}\n      ref={ref as RefObject<HTMLDivElement>}\n      $as={as}\n      $color={color}\n      $fontFamily={fontFamily}\n      $fontSize={fontSize}\n      $fontWeight={fontWeight}\n      $lineHeight={lineHeight}\n      $noWrap={noWrap}\n      $wordBreak={wordBreak}\n      $theme={theme}\n      $variant={variant}\n    >\n      {renderedChildren}\n    </StyledText>\n  );\n});\nText.className = CLASSNAME;\nText.displayName = COMPONENT_NAME;\n"],"names":["COMPONENT_NAME","CLASSNAME","highlightNonAsciiChars","text","options","result","currentAscii","currentNonAscii","keyIndex","chars","Array","from","char","isNonAscii","push","React","createElement","StyledHighlightMarker","key","$font","font","$background","background","replaceInvisibleChars","Text","forwardRef","props","ref","transientProps","otherProps","getStylingTransientProps","as","children","className","color","fontFamily","FontFamily","poppins","fontSize","fontWeight","highlightNonAscii","lineHeight","noWrap","theme","propsTheme","variant","wordBreak","forwardedProps","_objectWithoutProperties","_excluded","useTheme","renderedChildren","normalizeHighlightOptions","StyledText","_extends","classNames","$as","$color","$fontFamily","$fontSize","$fontWeight","$lineHeight","$noWrap","$wordBreak","$theme","$variant","displayName"],"mappings":"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"}
+{"version":3,"file":"Text2.js","sources":["../../src/components/text/Text.tsx"],"sourcesContent":["import React, { forwardRef, ReactNode, RefObject } from 'react';\nimport classNames from 'classnames';\nimport { Comp, FontFamily, getStylingTransientProps } from '../../types';\nimport { StyledText, StyledHighlightMarker } from './styles';\nimport { TextProps } from './types';\nimport { useTheme } from '../theme';\nimport { warnOnAliasProps } from '../../utils/warnAliasProps';\nimport {\n  isNonAscii,\n  replaceInvisibleChars,\n  normalizeHighlightOptions,\n  NormalizedHighlightOptions,\n} from '../../utils/highlightNonAscii';\n\nconst COMPONENT_NAME = 'Text';\nconst CLASSNAME = 'redsift-text';\n\nconst TEXT_ALIAS_WARNINGS = [\n  { prop: 'kind', use: 'variant' },\n  { prop: 'appearance', use: 'variant' },\n  { prop: 'size', use: 'fontSize', hint: 'Text uses fontSize / variant for sizing.' },\n  { prop: 'weight', use: 'fontWeight' },\n  { prop: 'level', use: 'as', hint: 'For headings (h1-h6) use the Heading component, not Text.' },\n  { prop: 'tag', use: 'as' },\n  { prop: 'slot', use: 'children', hint: 'Text does not implement a slot API; pass content as children.' },\n];\n\n/**\n * Processes a string and wraps consecutive non-ASCII characters in highlight markers.\n * Groups consecutive non-ASCII characters to minimize DOM nodes.\n * Invisible characters are replaced with visible indicators (•).\n */\nconst highlightNonAsciiChars = (text: string, options: NormalizedHighlightOptions): ReactNode[] => {\n  const result: ReactNode[] = [];\n  let currentAscii = '';\n  let currentNonAscii = '';\n  let keyIndex = 0;\n\n  // Use Array.from to correctly handle Unicode surrogate pairs (e.g., emojis)\n  const chars = Array.from(text);\n\n  for (const char of chars) {\n    if (isNonAscii(char)) {\n      // Flush ASCII buffer\n      if (currentAscii) {\n        result.push(currentAscii);\n        currentAscii = '';\n      }\n      currentNonAscii += char;\n    } else {\n      // Flush non-ASCII buffer\n      if (currentNonAscii) {\n        result.push(\n          <StyledHighlightMarker key={keyIndex++} $font={options.font} $background={options.background}>\n            {replaceInvisibleChars(currentNonAscii)}\n          </StyledHighlightMarker>\n        );\n        currentNonAscii = '';\n      }\n      currentAscii += char;\n    }\n  }\n\n  // Flush remaining buffers\n  if (currentAscii) {\n    result.push(currentAscii);\n  }\n  if (currentNonAscii) {\n    result.push(\n      <StyledHighlightMarker key={keyIndex} $font={options.font} $background={options.background}>\n        {replaceInvisibleChars(currentNonAscii)}\n      </StyledHighlightMarker>\n    );\n  }\n\n  return result;\n};\n\n/**\n * Text renders text content with consistent styling. By default renders a\n * `<span>` but can be changed via the `as` prop.\n *\n * Variants: `body`, `button`, `caption`, `inherit`\n * Semantic elements: `span` (default), `p`, `b`, `i`, `u`, `abbr`, `cite`,\n * `del`, `em`, `ins`, `kbd`, `mark`, `s`, `samp`, `sub`, `sup`\n *\n * @example\n * // Basic text\n * <Text>Hello world</Text>\n *\n * @example\n * // Typography variants\n * <Text variant=\"body\">Body text for paragraphs</Text>\n * <Text variant=\"button\">Button-style text</Text>\n * <Text variant=\"caption\">Small caption text</Text>\n *\n * @example\n * // Semantic elements\n * <Text as=\"p\">Paragraph element</Text>\n * <Text as=\"b\">Bold text</Text>\n * <Text as=\"em\">Emphasized text</Text>\n * <Text as=\"mark\">Highlighted text</Text>\n * <Text as=\"kbd\">Keyboard input</Text>\n *\n * @example\n * // Custom styling\n * <Text color=\"grey\" fontSize=\"14px\" fontWeight={600}>Custom styled</Text>\n *\n * @example\n * // Truncated text with ellipsis\n * <Text noWrap>Very long text that will be truncated with ellipsis...</Text>\n *\n * @example\n * // Caption with color\n * <Text variant=\"caption\" color=\"grey\">Last updated: Jan 2024</Text>\n *\n * @example\n * // Highlight non-ASCII characters (useful for IDN domain names)\n * <Text highlightNonAscii>ƅankofamerica.com</Text>\n */\nexport const Text: Comp<TextProps, HTMLDivElement> = forwardRef((props, ref) => {\n  warnOnAliasProps(COMPONENT_NAME, props as unknown as Record<string, unknown>, TEXT_ALIAS_WARNINGS);\n  const { transientProps, otherProps } = getStylingTransientProps(props);\n\n  const {\n    as,\n    children,\n    className,\n    color,\n    fontFamily = FontFamily.poppins,\n    fontSize,\n    fontWeight,\n    highlightNonAscii,\n    lineHeight,\n    noWrap,\n    theme: propsTheme,\n    variant,\n    wordBreak,\n    ...forwardedProps\n  } = otherProps;\n\n  const theme = useTheme(propsTheme);\n\n  // Process children to highlight non-ASCII characters if enabled and children is a string\n  let renderedChildren = children;\n  if (highlightNonAscii && typeof children === 'string') {\n    const options = normalizeHighlightOptions(highlightNonAscii);\n    renderedChildren = highlightNonAsciiChars(children, options);\n  }\n\n  return (\n    <StyledText\n      as={as}\n      {...forwardedProps}\n      {...transientProps}\n      className={classNames(Text.className, className)}\n      ref={ref as RefObject<HTMLDivElement>}\n      $as={as}\n      $color={color}\n      $fontFamily={fontFamily}\n      $fontSize={fontSize}\n      $fontWeight={fontWeight}\n      $lineHeight={lineHeight}\n      $noWrap={noWrap}\n      $wordBreak={wordBreak}\n      $theme={theme}\n      $variant={variant}\n    >\n      {renderedChildren}\n    </StyledText>\n  );\n});\nText.className = CLASSNAME;\nText.displayName = COMPONENT_NAME;\n"],"names":["COMPONENT_NAME","CLASSNAME","TEXT_ALIAS_WARNINGS","prop","use","hint","highlightNonAsciiChars","text","options","result","currentAscii","currentNonAscii","keyIndex","chars","Array","from","char","isNonAscii","push","React","createElement","StyledHighlightMarker","key","$font","font","$background","background","replaceInvisibleChars","Text","forwardRef","props","ref","warnOnAliasProps","transientProps","otherProps","getStylingTransientProps","as","children","className","color","fontFamily","FontFamily","poppins","fontSize","fontWeight","highlightNonAscii","lineHeight","noWrap","theme","propsTheme","variant","wordBreak","forwardedProps","_objectWithoutProperties","_excluded","useTheme","renderedChildren","normalizeHighlightOptions","StyledText","_extends","classNames","$as","$color","$fontFamily","$fontSize","$fontWeight","$lineHeight","$noWrap","$wordBreak","$theme","$variant","displayName"],"mappings":"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"}

package/_internal/warnAliasProps.js

@@ -0,0 +1,46 @@
+/**
+ * Dev-mode warning when a known mis-aliased prop is passed to a primitive.
+ *
+ * Catches the common SOFA-6 / ODM-2933 failure mode where AI agents pass
+ * props from other UI libraries (Chakra `kind`, Mantine `appearance`,
+ * MUI `level`, etc.) that are HTML-valid (so React doesn't warn) but
+ * silently ignored by the DS primitive.
+ *
+ * Each (component, propName) pair warns once per session.
+ */
+
+const seen = new Set();
+/**
+ * Warn (once) for any prop in `props` that matches an entry in `aliases`.
+ *
+ * @param componentName  Component name used in the warning message.
+ * @param props          The component's runtime props (post-destructure spread).
+ * @param aliases        Known mis-aliased prop entries.
+ */
+function warnOnAliasProps(componentName, props, aliases) {
+  if (process.env.NODE_ENV === 'production') return;
+  if (!props) return;
+  for (const {
+    prop,
+    use,
+    hint
+  } of aliases) {
+    if (!(prop in props)) continue;
+    const key = `${componentName}:${prop}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const tail = hint ? ` ${hint}` : '';
+    console.error(`[${componentName}] Unknown prop \`${prop}\` — did you mean \`${use}\`? ` + `${componentName} does not accept \`${prop}\`; the value will be passed through to the DOM.${tail}`);
+  }
+}
+
+/**
+ * Reset the warn-once cache. Test-only.
+ * @internal
+ */
+function __resetAliasWarnings() {
+  seen.clear();
+}
+
+export { __resetAliasWarnings as _, warnOnAliasProps as w };
+//# sourceMappingURL=warnAliasProps.js.map

package/_internal/warnAliasProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnAliasProps.js","sources":["../../src/utils/warnAliasProps.ts"],"sourcesContent":["/**\n * Dev-mode warning when a known mis-aliased prop is passed to a primitive.\n *\n * Catches the common SOFA-6 / ODM-2933 failure mode where AI agents pass\n * props from other UI libraries (Chakra `kind`, Mantine `appearance`,\n * MUI `level`, etc.) that are HTML-valid (so React doesn't warn) but\n * silently ignored by the DS primitive.\n *\n * Each (component, propName) pair warns once per session.\n */\n\nconst seen = new Set<string>();\n\nexport type AliasWarning = {\n  /** Prop name to detect (e.g. `direction`). */\n  prop: string;\n  /** Suggested correct prop name (e.g. `flexDirection`). */\n  use: string;\n  /** Optional extra context appended to the warning. */\n  hint?: string;\n};\n\n/**\n * Warn (once) for any prop in `props` that matches an entry in `aliases`.\n *\n * @param componentName  Component name used in the warning message.\n * @param props          The component's runtime props (post-destructure spread).\n * @param aliases        Known mis-aliased prop entries.\n */\nexport function warnOnAliasProps(componentName: string, props: Record<string, unknown>, aliases: AliasWarning[]): void {\n  if (process.env.NODE_ENV === 'production') return;\n  if (!props) return;\n\n  for (const { prop, use, hint } of aliases) {\n    if (!(prop in props)) continue;\n    const key = `${componentName}:${prop}`;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    const tail = hint ? ` ${hint}` : '';\n    console.error(\n      `[${componentName}] Unknown prop \\`${prop}\\` — did you mean \\`${use}\\`? ` +\n        `${componentName} does not accept \\`${prop}\\`; the value will be passed through to the DOM.${tail}`\n    );\n  }\n}\n\n/**\n * Reset the warn-once cache. Test-only.\n * @internal\n */\nexport function __resetAliasWarnings(): void {\n  seen.clear();\n}\n"],"names":["seen","Set","warnOnAliasProps","componentName","props","aliases","process","env","NODE_ENV","prop","use","hint","key","has","add","tail","console","error","__resetAliasWarnings","clear"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,IAAI,GAAG,IAAIC,GAAG,EAAU,CAAA;AAW9B;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,aAAqB,EAAEC,KAA8B,EAAEC,OAAuB,EAAQ;AACrH,EAAA,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE,OAAA;EAC3C,IAAI,CAACJ,KAAK,EAAE,OAAA;AAEZ,EAAA,KAAK,MAAM;IAAEK,IAAI;IAAEC,GAAG;AAAEC,IAAAA,IAAAA;GAAM,IAAIN,OAAO,EAAE;AACzC,IAAA,IAAI,EAAEI,IAAI,IAAIL,KAAK,CAAC,EAAE,SAAA;AACtB,IAAA,MAAMQ,GAAG,GAAI,CAAA,EAAET,aAAc,CAAA,CAAA,EAAGM,IAAK,CAAC,CAAA,CAAA;AACtC,IAAA,IAAIT,IAAI,CAACa,GAAG,CAACD,GAAG,CAAC,EAAE,SAAA;AACnBZ,IAAAA,IAAI,CAACc,GAAG,CAACF,GAAG,CAAC,CAAA;IACb,MAAMG,IAAI,GAAGJ,IAAI,GAAI,IAAGA,IAAK,CAAA,CAAC,GAAG,EAAE,CAAA;AACnCK,IAAAA,OAAO,CAACC,KAAK,CACV,IAAGd,aAAc,CAAA,iBAAA,EAAmBM,IAAK,CAAsBC,oBAAAA,EAAAA,GAAI,CAAK,IAAA,CAAA,GACtE,GAAEP,aAAc,CAAA,mBAAA,EAAqBM,IAAK,CAAkDM,gDAAAA,EAAAA,IAAK,EACtG,CAAC,CAAA;AACH,GAAA;AACF,CAAA;;AAEA;AACA;AACA;AACA;AACO,SAASG,oBAAoBA,GAAS;EAC3ClB,IAAI,CAACmB,KAAK,EAAE,CAAA;AACd;;;;"}

package/_internal/warnCompoundMisuse.js

@@ -0,0 +1,55 @@
+import React__default from 'react';
+
+/**
+ * Walk children and warn if any child has a displayName in the restricted set.
+ * Used to detect nesting of compound sub-components inside each other.
+ *
+ * @example
+ * // Inside DataCard, check that Body/Listbox don't contain other sub-components
+ * warnOnNestedSubComponents(bodyChildren, 'DataCard', 'DataCardBody', SUB_NAMES);
+ */
+function warnOnNestedSubComponents(children, componentName, parentName, restrictedDisplayNames) {
+  if (process.env.NODE_ENV === 'production') return;
+  React__default.Children.forEach(children, child => {
+    var _child$type;
+    if (! /*#__PURE__*/React__default.isValidElement(child)) return;
+    const childDisplayName = (_child$type = child.type) === null || _child$type === void 0 ? void 0 : _child$type.displayName;
+    if (childDisplayName && restrictedDisplayNames.has(childDisplayName)) {
+      console.error(`[${componentName}] <${childDisplayName}> was rendered inside <${parentName}>. ` + `${componentName} sub-components must be direct children of <${componentName}>, ` + 'not nested inside each other.');
+    }
+  });
+}
+
+/**
+ * Walk children and warn if any child's displayName is NOT in the allowed set.
+ * Used for components that silently drop unrecognised children (e.g. Card, Breadcrumbs).
+ * Fragments, nulls, strings, and numbers are ignored.
+ */
+function warnOnUnknownChildren(children, componentName, allowedDisplayNames) {
+  if (process.env.NODE_ENV === 'production') return;
+  React__default.Children.forEach(children, child => {
+    var _child$type2;
+    if (! /*#__PURE__*/React__default.isValidElement(child)) return;
+    // Skip fragments — they're a transparent grouping mechanism
+    if (child.type === React__default.Fragment) return;
+    const childDisplayName = (_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.displayName;
+    if (!childDisplayName || !allowedDisplayNames.has(childDisplayName)) {
+      const label = childDisplayName || (typeof child.type === 'string' ? child.type : 'unknown');
+      console.error(`[${componentName}] Unexpected child <${label}> will be ignored. ` + `${componentName} only accepts these sub-components as children: ` + `${[...allowedDisplayNames].join(', ')}.`);
+    }
+  });
+}
+
+/**
+ * Warn when a sub-component is rendered outside its required parent.
+ * Call from the sub-component after reading its context.
+ */
+function warnOnMissingContext(contextValue, componentName, parentName) {
+  if (process.env.NODE_ENV === 'production') return;
+  if (contextValue === null || contextValue === undefined) {
+    console.error(`[${componentName}] <${componentName}> was rendered outside of <${parentName}>. ` + `${componentName} must be a child of ${parentName} to function correctly.`);
+  }
+}
+
+export { warnOnUnknownChildren as a, warnOnMissingContext as b, warnOnNestedSubComponents as w };
+//# sourceMappingURL=warnCompoundMisuse.js.map

package/_internal/warnCompoundMisuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnCompoundMisuse.js","sources":["../../src/utils/warnCompoundMisuse.ts"],"sourcesContent":["import React from 'react';\n\n/**\n * Walk children and warn if any child has a displayName in the restricted set.\n * Used to detect nesting of compound sub-components inside each other.\n *\n * @example\n * // Inside DataCard, check that Body/Listbox don't contain other sub-components\n * warnOnNestedSubComponents(bodyChildren, 'DataCard', 'DataCardBody', SUB_NAMES);\n */\nexport function warnOnNestedSubComponents(\n  children: React.ReactNode,\n  componentName: string,\n  parentName: string,\n  restrictedDisplayNames: Set<string>\n): void {\n  if (process.env.NODE_ENV === 'production') return;\n\n  React.Children.forEach(children, (child) => {\n    if (!React.isValidElement(child)) return;\n\n    const childDisplayName = (child.type as any)?.displayName;\n    if (childDisplayName && restrictedDisplayNames.has(childDisplayName)) {\n      console.error(\n        `[${componentName}] <${childDisplayName}> was rendered inside <${parentName}>. ` +\n          `${componentName} sub-components must be direct children of <${componentName}>, ` +\n          'not nested inside each other.'\n      );\n    }\n  });\n}\n\n/**\n * Walk children and warn if any child's displayName is NOT in the allowed set.\n * Used for components that silently drop unrecognised children (e.g. Card, Breadcrumbs).\n * Fragments, nulls, strings, and numbers are ignored.\n */\nexport function warnOnUnknownChildren(\n  children: React.ReactNode,\n  componentName: string,\n  allowedDisplayNames: Set<string>\n): void {\n  if (process.env.NODE_ENV === 'production') return;\n\n  React.Children.forEach(children, (child) => {\n    if (!React.isValidElement(child)) return;\n    // Skip fragments — they're a transparent grouping mechanism\n    if (child.type === React.Fragment) return;\n\n    const childDisplayName = (child.type as any)?.displayName;\n    if (!childDisplayName || !allowedDisplayNames.has(childDisplayName)) {\n      const label = childDisplayName || (typeof child.type === 'string' ? child.type : 'unknown');\n      console.error(\n        `[${componentName}] Unexpected child <${label}> will be ignored. ` +\n          `${componentName} only accepts these sub-components as children: ` +\n          `${[...allowedDisplayNames].join(', ')}.`\n      );\n    }\n  });\n}\n\n/**\n * Warn when a sub-component is rendered outside its required parent.\n * Call from the sub-component after reading its context.\n */\nexport function warnOnMissingContext(contextValue: unknown, componentName: string, parentName: string): void {\n  if (process.env.NODE_ENV === 'production') return;\n\n  if (contextValue === null || contextValue === undefined) {\n    console.error(\n      `[${componentName}] <${componentName}> was rendered outside of <${parentName}>. ` +\n        `${componentName} must be a child of ${parentName} to function correctly.`\n    );\n  }\n}\n"],"names":["warnOnNestedSubComponents","children","componentName","parentName","restrictedDisplayNames","process","env","NODE_ENV","React","Children","forEach","child","_child$type","isValidElement","childDisplayName","type","displayName","has","console","error","warnOnUnknownChildren","allowedDisplayNames","_child$type2","Fragment","label","join","warnOnMissingContext","contextValue","undefined"],"mappings":"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"}