@contentful/experience-design-system-extraction 2.35.1-dev-build-236b6909.0 → 2.35.1-dev-build-b8da2525.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-extraction",
-  "version": "2.35.1-dev-build-236b6909.0",
+  "version": "2.35.1-dev-build-b8da2525.0",
   "description": "Component extraction engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",

package/dist/src/extract/services/classification/bucket-component-props.d.ts

@@ -0,0 +1,11 @@
+import type { RawComponentDefinition } from '../../types/component.js';
+export type PropBucket = 'custom' | 'dom-passthrough' | 'other';
+export interface PropBucketAssignment {
+    component: string;
+    source: string;
+    customPropNames: string[];
+    domPassthroughPropNames: string[];
+    otherPropNames: string[];
+}
+export declare function bucketComponentProps(component: RawComponentDefinition): PropBucketAssignment;
+export declare function bucketComponentsProps(components: readonly RawComponentDefinition[]): PropBucketAssignment[];

package/dist/src/extract/services/classification/bucket-component-props.js

@@ -0,0 +1,29 @@
+export function bucketComponentProps(component) {
+    const customPropNames = [];
+    const domPassthroughPropNames = [];
+    const otherPropNames = [];
+    for (const prop of component.props) {
+        if (!prop.type.trim()) {
+            otherPropNames.push(prop.name);
+        }
+        else if (prop.domAttribute === true) {
+            domPassthroughPropNames.push(prop.name);
+        }
+        else {
+            customPropNames.push(prop.name);
+        }
+    }
+    const sortNames = (names) => names.toSorted((left, right) => left.localeCompare(right));
+    return {
+        component: component.name,
+        source: component.source,
+        customPropNames: sortNames(customPropNames),
+        domPassthroughPropNames: sortNames(domPassthroughPropNames),
+        otherPropNames: sortNames(otherPropNames),
+    };
+}
+export function bucketComponentsProps(components) {
+    return components
+        .map(bucketComponentProps)
+        .toSorted((left, right) => `${left.component}\u0000${left.source}`.localeCompare(`${right.component}\u0000${right.source}`));
+}

package/dist/src/extract/services/classification/classify-component-props.js

@@ -1,5 +1,4 @@
 import { isStringLiteralUnion, isBooleanType, isStringType, isNumberType, isComplexType, } from './helpers/check-prop-types.js';
-import { isDomPassThroughProp } from './helpers/detect-dom-props.js';
 /**
  * Deterministic pre-classification rule engine.
  * Applies rules in priority order and returns on the first match.
@@ -26,16 +25,6 @@ export function preClassifyProp(prop) {
     if (type.includes('Dispatch<') || type.includes('SetStateAction')) {
         return { category: 'exclude' };
     }
-    // Rule 6: DOM / a11y / framework pass-through props
-    if (isDomPassThroughProp(name)) {
-        return { category: 'exclude' };
-    }
-    // `name` is overloaded: form controls forward it to the DOM, while icons,
-    // flags, and animations often use it as an authorable semantic selector.
-    // Exclude only when the extractor retained concrete DOM provenance.
-    if (name === 'name' && prop.domAttribute) {
-        return { category: 'exclude' };
-    }
     // Rule 7: String literal union
     if (isStringLiteralUnion(type)) {
         return { category: 'design', cdfTypeHint: 'enum' };
@@ -113,21 +102,13 @@ export function preClassifyComponent(component) {
         if (result?.category === 'exclude') {
             return [];
         }
-        // Provenance is extraction-only evidence. Do not add it to the payload
-        // presented to downstream agents.
-        const { domAttribute: _domAttribute, ...authorableProp } = prop;
         if (prop.category) {
-            return [authorableProp];
+            return [prop];
         }
         if (!result) {
-            return [authorableProp];
+            return [prop];
         }
-        return [
-            {
-                ...authorableProp,
-                category: result.category,
-            },
-        ];
+        return [{ ...prop, category: result.category }];
     });
     return { ...component, props };
 }

package/dist/src/index.d.ts

@@ -13,6 +13,8 @@ export { extractAstroComponents } from './extract/framework-adapters/astro/extra
 export { extractWebComponentDefinitions } from './extract/framework-adapters/web-components/extractor.js';
 export { extractSvelteComponents } from './extract/framework-adapters/svelte/extractor.js';
 export { extractAllowedComponentsFromTypeText, extractAllowedComponentsFromJsdoc, } from './extract/helpers/evidence/collect-allowed-component-names.js';
+export type { PropBucket, PropBucketAssignment } from './extract/services/classification/bucket-component-props.js';
+export { bucketComponentProps, bucketComponentsProps, } from './extract/services/classification/bucket-component-props.js';
 export { evaluateExtractionQuality } from './extract/services/quality/evaluate-extraction-quality.js';
 export { hasNoAuthoringSurface } from './extract/services/quality/helpers/authorability/evaluate-authorability.js';
 export { hasNoAuthoringSurface as isNonAuthorableComponent } from './extract/services/quality/helpers/authorability/evaluate-authorability.js';

package/dist/src/index.js

@@ -11,6 +11,7 @@ export { extractAstroComponents } from './extract/framework-adapters/astro/extra
 export { extractWebComponentDefinitions } from './extract/framework-adapters/web-components/extractor.js';
 export { extractSvelteComponents } from './extract/framework-adapters/svelte/extractor.js';
 export { extractAllowedComponentsFromTypeText, extractAllowedComponentsFromJsdoc, } from './extract/helpers/evidence/collect-allowed-component-names.js';
+export { bucketComponentProps, bucketComponentsProps, } from './extract/services/classification/bucket-component-props.js';
 // Post-extraction filtering and scoring
 export { evaluateExtractionQuality } from './extract/services/quality/evaluate-extraction-quality.js';
 export { hasNoAuthoringSurface } from './extract/services/quality/helpers/authorability/evaluate-authorability.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-extraction",
-  "version": "2.35.1-dev-build-236b6909.0",
+  "version": "2.35.1-dev-build-b8da2525.0",
   "description": "Component extraction engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",

package/dist/src/extract/services/classification/helpers/detect-dom-props.d.ts

@@ -1,2 +0,0 @@
-/** Returns true when the prop name is a DOM attribute, a11y attribute, or framework pass-through escape hatch. */
-export declare function isDomPassThroughProp(name: string): boolean;

package/dist/src/extract/services/classification/helpers/detect-dom-props.js

@@ -1,63 +0,0 @@
-const DOM_PASS_THROUGH_PROPS = new Set([
-    // Bare HTML / framework styling pass-through
-    'className',
-    'class',
-    'classes',
-    'classNames',
-    'rootClassName',
-    'prefixCls',
-    'style',
-    'styles',
-    // Bare HTML attributes
-    'id',
-    'role',
-    'tabIndex',
-    'tabindex',
-    'htmlFor',
-    'for',
-    'slot',
-    'is',
-    'lang',
-    'dir',
-    'hidden',
-    'draggable',
-    'spellCheck',
-    'spellcheck',
-    'contentEditable',
-    'contenteditable',
-    'inputMode',
-    'inputmode',
-    'autoComplete',
-    'autocomplete',
-    'autoFocus',
-    'autofocus',
-    'translate',
-    'part',
-    'exportparts',
-    'aria',
-    // Framework theming / pass-through escape hatches — dev-facing, never marketer-configurable
-    'dt',
-    'pt',
-    'ptOptions',
-    'unstyled',
-    'sx',
-    // Polymorphic component props — change rendered HTML/component, not marketer-visible behavior
-    'as',
-    'element',
-    'component',
-    // QA / vendor test attributes
-    'dataQa',
-    'data-qa',
-    // Vue v-model internals — framework wiring, never marketer-configurable
-    'modelValue',
-    'modelModifiers',
-]);
-/** Returns true when the prop name is a DOM attribute, a11y attribute, or framework pass-through escape hatch. */
-export function isDomPassThroughProp(name) {
-    if (DOM_PASS_THROUGH_PROPS.has(name))
-        return true;
-    // aria-label, aria-hidden, ariaLabel, ariaHidden — both kebab and camel forms
-    if (/^aria[-A-Z]/.test(name))
-        return true;
-    return name.startsWith('data-');
-}