@contentful/experience-design-system-extraction 2.36.2-dev-build-c4497102.0 → 2.36.2-dev-build-a6f80ae6.0

package/dist/src/index.d.ts

@@ -1,27 +1,21 @@
-export type { RawComponentDefinition, RawPropDefinition, RawSlotDefinition, ComponentExtractionResult, ExtractionExclusion, ExtractorProgress, ExtractionValidationIssue, ExtractionValidationIssueCode, } from './extract/types/component.js';
-export { stripScoringFields } from './extract/types/display.js';
-export type { ExtractorOptions } from './extract/types/options.js';
-export type { ComponentExtractor } from './extract/types/component-extractor.js';
-export { extractComponents } from './extract/services/extraction/extract-components.js';
-export { extractEndpoint } from './extract/controller/extract-controller.js';
-export type { ExtractionEndpointProgress, ExtractionEndpointRequest, ExtractionEndpointResponse, } from './extract/types/contract.js';
-export { extractReactComponents } from './extract/framework-adapters/react/extractor.js';
-export { extractVueComponents } from './extract/framework-adapters/vue/extractor.js';
-export { extractVueTsxComponents } from './extract/framework-adapters/vue-tsx/extractor.js';
-export { extractStencilComponents } from './extract/framework-adapters/stencil/extractor.js';
-export { extractAstroComponents } from './extract/framework-adapters/astro/extractor.js';
-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 { 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';
-export { computeExtractionScore, deriveNeedsReview, } from './extract/services/quality/helpers/scoring/compute-extraction-score.js';
-export type { ExtractionScore, ExtractionScoreOptions, ExtractionConfidence } from './extract/types/scoring.js';
-export { inspectComponentSource, describeReviewReasons, describeReviewReason, isDataWrapperReviewReason, HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON, POSSIBLE_DATA_FETCH_WRAPPER_REASON, ZERO_SURFACE_RENDERED_UI_REASON, } from './extract/services/quality/helpers/inspection/inspect-component-source.js';
-export type { ComponentSourceInspection } from './extract/types/source-inspection.js';
-export { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, formatExcludedComponentLines, } from './extract/services/quality/helpers/inspection/validate-extracted-components.js';
-export { parseImportedNames } from './extract/helpers/evidence/parse-source-imports.js';
-export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/helpers/evidence/detect-slot-from-prop.js';
-export { preClassifyProp, preClassifyComponent } from './extract/services/classification/classify-component-props.js';
-export type { PreClassification } from './extract/types/classification.js';
+export type { RawComponentDefinition, RawPropDefinition, RawSlotDefinition, ComponentExtractionResult, ExtractionExclusion, ExtractorProgress, ExtractorOptions, ComponentExtractor, ExtractionValidationIssue, ExtractionValidationIssueCode, } from './types.js';
+export { stripScoringFields } from './types.js';
+export { extractComponents } from './extract/pipeline.js';
+export { extractReactComponents } from './extract/react.js';
+export { extractVueComponents } from './extract/vue.js';
+export { extractVueTsxComponents } from './extract/vue-tsx.js';
+export { extractStencilComponents } from './extract/stencil.js';
+export { extractAstroComponents } from './extract/astro.js';
+export { extractWebComponentDefinitions } from './extract/web-components.js';
+export { extractSvelteComponents } from './extract/svelte.js';
+export { extractAllowedComponentsFromTypeText, extractAllowedComponentsFromJsdoc, } from './extract/slot-allowed-components.js';
+export { isNonAuthorableComponent } from './extract/non-authorable-filter.js';
+export { computeExtractionScore, deriveNeedsReview } from './extract/scoring.js';
+export type { ExtractionScore, ExtractionScoreOptions, ExtractionConfidence } from './extract/scoring.js';
+export { inspectComponentSource, describeReviewReasons, describeReviewReason, isDataWrapperReviewReason, HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON, POSSIBLE_DATA_FETCH_WRAPPER_REASON, ZERO_SURFACE_RENDERED_UI_REASON, } from './extract/source-inspection.js';
+export type { ComponentSourceInspection } from './extract/source-inspection.js';
+export { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, formatExcludedComponentLines, } from './extract/validate.js';
+export { parseImportedNames } from './extract/parse-imported-names.js';
+export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/slot-detection.js';
+export { preClassifyProp, preClassifyComponent } from './pre-classify.js';
+export type { PreClassification } from './pre-classify.js';

package/dist/src/index.js

@@ -1,27 +1,23 @@
-export { stripScoringFields } from './extract/types/display.js';
+export { stripScoringFields } from './types.js';
 // Core extraction pipeline
-export { extractComponents } from './extract/services/extraction/extract-components.js';
-export { extractEndpoint } from './extract/controller/extract-controller.js';
+export { extractComponents } from './extract/pipeline.js';
 // Framework-specific extractors
-export { extractReactComponents } from './extract/framework-adapters/react/extractor.js';
-export { extractVueComponents } from './extract/framework-adapters/vue/extractor.js';
-export { extractVueTsxComponents } from './extract/framework-adapters/vue-tsx/extractor.js';
-export { extractStencilComponents } from './extract/framework-adapters/stencil/extractor.js';
-export { extractAstroComponents } from './extract/framework-adapters/astro/extractor.js';
-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 { extractReactComponents } from './extract/react.js';
+export { extractVueComponents } from './extract/vue.js';
+export { extractVueTsxComponents } from './extract/vue-tsx.js';
+export { extractStencilComponents } from './extract/stencil.js';
+export { extractAstroComponents } from './extract/astro.js';
+export { extractWebComponentDefinitions } from './extract/web-components.js';
+export { extractSvelteComponents } from './extract/svelte.js';
+export { extractAllowedComponentsFromTypeText, extractAllowedComponentsFromJsdoc, } from './extract/slot-allowed-components.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';
-// Backwards-compatible alias for callers that used the pre-refactor name
-export { hasNoAuthoringSurface as isNonAuthorableComponent } from './extract/services/quality/helpers/authorability/evaluate-authorability.js';
-export { computeExtractionScore, deriveNeedsReview, } from './extract/services/quality/helpers/scoring/compute-extraction-score.js';
-export { inspectComponentSource, describeReviewReasons, describeReviewReason, isDataWrapperReviewReason, HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON, POSSIBLE_DATA_FETCH_WRAPPER_REASON, ZERO_SURFACE_RENDERED_UI_REASON, } from './extract/services/quality/helpers/inspection/inspect-component-source.js';
+export { isNonAuthorableComponent } from './extract/non-authorable-filter.js';
+export { computeExtractionScore, deriveNeedsReview } from './extract/scoring.js';
+export { inspectComponentSource, describeReviewReasons, describeReviewReason, isDataWrapperReviewReason, HIGH_CONFIDENCE_DATA_FETCH_WRAPPER_REASON, POSSIBLE_DATA_FETCH_WRAPPER_REASON, ZERO_SURFACE_RENDERED_UI_REASON, } from './extract/source-inspection.js';
 // Validation
-export { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, formatExcludedComponentLines, } from './extract/services/quality/helpers/inspection/validate-extracted-components.js';
-export { parseImportedNames } from './extract/helpers/evidence/parse-source-imports.js';
+export { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, formatExcludedComponentLines, } from './extract/validate.js';
+export { parseImportedNames } from './extract/parse-imported-names.js';
 // Slot detection helpers
-export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/helpers/evidence/detect-slot-from-prop.js';
+export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/slot-detection.js';
 // Pre-classification
-export { preClassifyProp, preClassifyComponent } from './extract/services/classification/classify-component-props.js';
+export { preClassifyProp, preClassifyComponent } from './pre-classify.js';

package/dist/src/{extract/services/classification/classify-component-props.d.ts → pre-classify.d.ts}

@@ -1,6 +1,8 @@
-import type { RawPropDefinition, RawComponentDefinition } from '../../types/component.js';
-import type { PreClassification } from '../../types/classification.js';
-export type { PreClassification } from '../../types/classification.js';
+import type { RawPropDefinition, RawComponentDefinition } from './types.js';
+export interface PreClassification {
+    category: 'content' | 'design' | 'state' | 'exclude';
+    cdfTypeHint?: 'string' | 'enum' | 'richtext' | 'media' | 'boolean';
+}
 /**
  * Deterministic pre-classification rule engine.
  * Applies rules in priority order and returns on the first match.

package/dist/src/{extract/services/classification/classify-component-props.js → pre-classify.js}

@@ -1,5 +1,96 @@
-import { isStringLiteralUnion, isBooleanType, isStringType, isNumberType, isComplexType, } from './helpers/check-prop-types.js';
-import { isDomPassThroughProp } from './helpers/detect-dom-props.js';
+/**
+ * Determines whether a type string represents a simple/primitive type
+ * (string, boolean, number, or string literal union) vs a complex type
+ * (object, function, array, generic, etc.).
+ */
+function isSimpleType(type) {
+    const t = type.trim();
+    if (t === 'string' || t === 'boolean' || t === 'number')
+        return true;
+    // String literal union (e.g., "'a' | 'b'")
+    if (isStringLiteralUnion(t))
+        return true;
+    return false;
+}
+function isStringLiteralUnion(type) {
+    return type.includes('|') && type.includes("'");
+}
+function isBooleanType(type) {
+    return type.trim() === 'boolean';
+}
+function isStringType(type) {
+    return type.trim() === 'string';
+}
+function isNumberType(type) {
+    return type.trim() === 'number';
+}
+function isComplexType(type) {
+    return !isSimpleType(type);
+}
+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',
+]);
+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;
+    if (name.startsWith('data-'))
+        return true;
+    return false;
+}
 /**
  * Deterministic pre-classification rule engine.
  * Applies rules in priority order and returns on the first match.
@@ -7,6 +98,7 @@ import { isDomPassThroughProp } from './helpers/detect-dom-props.js';
 export function preClassifyProp(prop) {
     const { name, type } = prop;
     // Rule 1: Event handlers
+    // name starts with `on` + uppercase, OR type contains `=> void` or `EventHandler`
     if (/^on[A-Z]/.test(name) || type.includes('=> void') || type.includes('EventHandler')) {
         return { category: 'exclude' };
     }
@@ -27,6 +119,9 @@ export function preClassifyProp(prop) {
         return { category: 'exclude' };
     }
     // Rule 6: DOM / a11y / framework pass-through props
+    // These are escape hatches developers use to wire components into the DOM.
+    // Marketers should never configure them in the ExO editor; exposing them
+    // generates noise that obscures the props that actually carry intent.
     if (isDomPassThroughProp(name)) {
         return { category: 'exclude' };
     }
@@ -116,18 +211,15 @@ export function preClassifyComponent(component) {
         // Provenance is extraction-only evidence. Do not add it to the payload
         // presented to downstream agents.
         const { domAttribute: _domAttribute, ...authorableProp } = prop;
+        // If category is already set, leave unchanged
         if (prop.category) {
             return [authorableProp];
         }
         if (!result) {
             return [authorableProp];
         }
-        return [
-            {
-                ...authorableProp,
-                category: result.category,
-            },
-        ];
+        // Set category hint
+        return [{ ...authorableProp, category: result.category }];
     });
     return { ...component, props };
 }

package/dist/src/{extract/types/component.d.ts → types.d.ts}

@@ -76,3 +76,25 @@ export type ExtractorProgress = {
     filesProcessed: number;
     componentsFound: number;
 };
+/**
+ * Optional extraction-time settings forwarded from the CLI through the
+ * pipeline to each extractor. Only the Svelte extractor currently consumes
+ * any of these; other extractors ignore the value.
+ */
+export interface ExtractorOptions {
+    /**
+     * Whether the Svelte extractor should run a retry pass for components whose
+     * declared Props type couldn't be resolved on the first pass (cross-package
+     * extends, path-alias-only types, etc.). See svelte.ts for the policy.
+     */
+    resolveUnreachable?: 'auto' | 'always' | 'never';
+    /** Absolute project root — used by the retry pass to locate tsconfig.json and node_modules. */
+    projectRoot?: string;
+}
+export interface ComponentExtractor {
+    name: string;
+    fileFilter: (filePath: string) => boolean;
+    extract(filePaths: string[], onProgress?: (p: ExtractorProgress) => void, opts?: ExtractorOptions): Promise<ComponentExtractionResult>;
+}
+/** Strip internal scoring fields before serialising a RawComponentDefinition for display or editing. */
+export declare function stripScoringFields({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }: RawComponentDefinition): Omit<RawComponentDefinition, 'extractionConfidence' | 'reviewReasons' | 'needsReview'>;

package/dist/src/{extract/types/display.js → types.js}

@@ -1,4 +1,4 @@
-/** Removes internal scoring fields from a component before showing it in the editor or writing it to disk. */
+/** Strip internal scoring fields before serialising a RawComponentDefinition for display or editing. */
 export function stripScoringFields({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }) {
     return rest;
 }

package/package.json

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

package/dist/src/extract/controller/extract-controller.d.ts

@@ -1,10 +0,0 @@
-import type { ExtractionEndpointRequest, ExtractionEndpointResponse } from '../types/contract.js';
-export type { ExtractionEndpointProgress, ExtractionEndpointRequest, ExtractionEndpointResponse, } from '../types/contract.js';
-/**
- * Stable in-process extraction contract.
- *
- * The controller owns public request validation and progress translation. The
- * extraction service owns source analysis and quality policy; neither layer
- * scans directories, invokes agents, or persists sessions.
- */
-export declare function extractEndpoint(request: ExtractionEndpointRequest): Promise<ExtractionEndpointResponse>;

package/dist/src/extract/controller/extract-controller.js

@@ -1,33 +0,0 @@
-import { executeExtractionOrchestrator } from '../orchestrator/execute-extraction-orchestrator.js';
-import { validateRequest } from './helpers/validate-endpoint-request.js';
-/**
- * Stable in-process extraction contract.
- *
- * The controller owns public request validation and progress translation. The
- * extraction service owns source analysis and quality policy; neither layer
- * scans directories, invokes agents, or persists sessions.
- */
-export async function extractEndpoint(request) {
-    validateRequest(request);
-    const filePaths = [...request.filePaths];
-    const result = await executeExtractionOrchestrator({
-        filePaths,
-        ...(request.resolveUnreachable !== undefined ? { resolveUnreachable: request.resolveUnreachable } : {}),
-        ...(request.projectRoot !== undefined ? { projectRoot: request.projectRoot } : {}),
-        onProgress: ({ filesProcessed, componentsFound }) => {
-            request.onProgress?.({
-                phase: 'extract',
-                filesProcessed,
-                totalFiles: filePaths.length,
-                componentsFound,
-            });
-        },
-    });
-    request.onProgress?.({
-        phase: 'extract',
-        filesProcessed: filePaths.length,
-        totalFiles: filePaths.length,
-        componentsFound: result.components.length,
-    });
-    return result;
-}

package/dist/src/extract/controller/helpers/validate-endpoint-request.d.ts

@@ -1,2 +0,0 @@
-import type { ExtractionEndpointRequest } from '../../types/contract.js';
-export declare function validateRequest(request: ExtractionEndpointRequest): void;

package/dist/src/extract/controller/helpers/validate-endpoint-request.js

@@ -1,24 +0,0 @@
-export function validateRequest(request) {
-    if (request === null || typeof request !== 'object') {
-        throw new TypeError('extractEndpoint requires a request object');
-    }
-    if (!Array.isArray(request.filePaths)) {
-        throw new TypeError('extractEndpoint requires filePaths to be an array');
-    }
-    if (request.filePaths.some((filePath) => typeof filePath !== 'string' || filePath.trim().length === 0)) {
-        throw new TypeError('extractEndpoint requires filePaths to contain non-empty strings');
-    }
-    if (request.projectRoot !== undefined &&
-        (typeof request.projectRoot !== 'string' || request.projectRoot.trim().length === 0)) {
-        throw new TypeError('extractEndpoint requires projectRoot to be a non-empty string when provided');
-    }
-    if (request.resolveUnreachable !== undefined &&
-        request.resolveUnreachable !== 'auto' &&
-        request.resolveUnreachable !== 'always' &&
-        request.resolveUnreachable !== 'never') {
-        throw new TypeError("extractEndpoint requires resolveUnreachable to be 'auto', 'always', or 'never'");
-    }
-    if (request.onProgress !== undefined && typeof request.onProgress !== 'function') {
-        throw new TypeError('extractEndpoint requires onProgress to be a function when provided');
-    }
-}

package/dist/src/extract/framework-adapters/astro/extractor.js

@@ -1,45 +0,0 @@
-import os from 'node:os';
-import { basename } from 'node:path';
-import { runFileExtractionWorkers } from '../shared/helpers/file-processing/file-workers.js';
-import { createSortedExtractionResult } from '../shared/helpers/file-processing/result-normalizer.js';
-import { extractFallbackPropsFromFrontmatter, extractPropsFromFrontmatter, extractDefaultsFromFrontmatter, mergeProps, } from './frontmatter.js';
-import { extractSlotsFromTemplate, extractSlotsFromFrontmatter, mergeSlots } from './slots.js';
-function extractFromAstroFile(filePath, source) {
-    const name = basename(filePath, '.astro');
-    // Split on `---` fences: frontmatter is between first and second `---`.
-    // If there is no `---`, the entire file is a template-only component.
-    const fenceIndex = source.startsWith('---') ? 0 : -1;
-    let frontmatter = '';
-    let template = source;
-    if (fenceIndex !== -1) {
-        const endFenceIndex = source.indexOf('---', fenceIndex + 3);
-        if (endFenceIndex !== -1) {
-            frontmatter = source.slice(fenceIndex + 3, endFenceIndex);
-            template = source.slice(endFenceIndex + 3);
-        }
-    }
-    const props = frontmatter
-        ? mergeProps(extractFallbackPropsFromFrontmatter(frontmatter), extractPropsFromFrontmatter(frontmatter))
-        : [];
-    const defaults = frontmatter ? extractDefaultsFromFrontmatter(frontmatter) : new Map();
-    const propsWithDefaults = props.map((p) => {
-        const defaultValue = defaults.get(p.name);
-        return defaultValue ? { ...p, defaultValue } : p;
-    });
-    const slots = mergeSlots(extractSlotsFromTemplate(template), extractSlotsFromFrontmatter(frontmatter));
-    return {
-        name,
-        source: filePath,
-        sourcePath: filePath,
-        framework: 'astro',
-        props: propsWithDefaults,
-        slots,
-    };
-}
-export async function extractAstroComponents(filePaths, onProgress) {
-    const astroFiles = filePaths.filter((f) => f.endsWith('.astro'));
-    const { items: components, warnings } = await runFileExtractionWorkers(astroFiles, os.cpus().length, async (filePath, source) => ({
-        item: extractFromAstroFile(filePath, source),
-    }), (filePath, error) => `Failed to extract from ${filePath}: ${error instanceof Error ? error.message : String(error)}`, onProgress);
-    return createSortedExtractionResult(components, warnings);
-}

package/dist/src/extract/framework-adapters/astro/frontmatter.d.ts

@@ -1,11 +0,0 @@
-import type { RawPropDefinition } from '../../types/component.js';
-/** Returns the string literals from a union type like `'a' | 'b' | 'c'`, or undefined if fewer than two are found. */
-export declare function extractAllowedValues(typeText: string): string[] | undefined;
-/** Reads prop names and requiredness from destructured `Astro.props` bindings when no typed Props interface exists. */
-export declare function extractFallbackPropsFromFrontmatter(frontmatter: string): RawPropDefinition[];
-/** Reads typed props from an `interface Props` or `type Props = ...` declaration in the frontmatter. */
-export declare function extractPropsFromFrontmatter(frontmatter: string): RawPropDefinition[];
-/** Reads default values from destructuring initializers in `const { foo = 'bar' } = Astro.props`. */
-export declare function extractDefaultsFromFrontmatter(frontmatter: string): Map<string, string>;
-/** Merges multiple prop arrays, preferring later entries on name collision and treating a prop as required only if all sources require it. */
-export declare function mergeProps(...propGroups: RawPropDefinition[][]): RawPropDefinition[];

package/dist/src/extract/framework-adapters/astro/frontmatter.js

@@ -1,96 +0,0 @@
-import { resolveTypeProperty } from '../shared/helpers/resolve-type-symbol.js';
-import { getSourceLineMetadata } from '../shared/helpers/get-node-source-lines.js';
-import { createAstroFrontmatterProject, collectAstroPropsBindings, extractBindingPropName, } from './helpers/collect-astro-props-bindings.js';
-/** Returns the string literals from a union type like `'a' | 'b' | 'c'`, or undefined if fewer than two are found. */
-export function extractAllowedValues(typeText) {
-    const parts = typeText.split('|').map((p) => p.trim());
-    const literals = parts.filter((p) => /^['"]/.test(p)).map((p) => p.replace(/^['"]|['"]$/g, ''));
-    return literals.length >= 2 ? literals.sort() : undefined;
-}
-/** Reads prop names and requiredness from destructured `Astro.props` bindings when no typed Props interface exists. */
-export function extractFallbackPropsFromFrontmatter(frontmatter) {
-    const props = new Map();
-    for (const element of collectAstroPropsBindings(frontmatter)) {
-        const propName = extractBindingPropName(element);
-        if (!propName)
-            continue;
-        props.set(propName, {
-            name: propName,
-            type: 'any',
-            required: !element.getInitializer(),
-        });
-    }
-    return [...props.values()].sort((a, b) => a.name.localeCompare(b.name));
-}
-/** Reads typed props from an `interface Props` or `type Props = ...` declaration in the frontmatter. */
-export function extractPropsFromFrontmatter(frontmatter) {
-    const sf = createAstroFrontmatterProject().createSourceFile('__frontmatter__.ts', frontmatter);
-    const props = [];
-    const propsInterface = sf.getInterface('Props');
-    const propsTypeAlias = sf.getTypeAlias('Props');
-    if (propsInterface) {
-        for (const member of propsInterface.getProperties()) {
-            const name = member.getName();
-            const typeText = member.getTypeNode()?.getText() ?? 'any';
-            const required = !member.hasQuestionToken();
-            const allowedValues = extractAllowedValues(typeText);
-            props.push({
-                name,
-                type: typeText,
-                required,
-                ...(allowedValues && { allowedValues }),
-                sourceStartLine: member.getStartLineNumber(),
-                sourceEndLine: member.getEndLineNumber(),
-            });
-        }
-    }
-    else if (propsTypeAlias) {
-        const type = propsTypeAlias.getType();
-        for (const property of type.getProperties()) {
-            const resolved = resolveTypeProperty(property);
-            if (!resolved)
-                continue;
-            const { name, declaration: decl, typeText, required } = resolved;
-            const allowedValues = extractAllowedValues(typeText);
-            props.push({
-                name,
-                type: typeText,
-                required,
-                ...(allowedValues && { allowedValues }),
-                ...getSourceLineMetadata(decl),
-            });
-        }
-    }
-    return props.sort((a, b) => a.name.localeCompare(b.name));
-}
-/** Reads default values from destructuring initializers in `const { foo = 'bar' } = Astro.props`. */
-export function extractDefaultsFromFrontmatter(frontmatter) {
-    const defaults = new Map();
-    for (const element of collectAstroPropsBindings(frontmatter)) {
-        const propName = extractBindingPropName(element);
-        if (!propName)
-            continue;
-        const elementInitializer = element.getInitializer();
-        if (!elementInitializer)
-            continue;
-        defaults.set(propName, elementInitializer.getText().replace(/^['"]|['"]$/g, ''));
-    }
-    return defaults;
-}
-/** Merges multiple prop arrays, preferring later entries on name collision and treating a prop as required only if all sources require it. */
-export function mergeProps(...propGroups) {
-    const merged = new Map();
-    for (const props of propGroups) {
-        for (const prop of props) {
-            const existing = merged.get(prop.name);
-            merged.set(prop.name, existing
-                ? {
-                    ...existing,
-                    ...prop,
-                    required: existing.required && prop.required,
-                }
-                : prop);
-        }
-    }
-    return [...merged.values()].sort((a, b) => a.name.localeCompare(b.name));
-}

package/dist/src/extract/framework-adapters/astro/helpers/collect-astro-props-bindings.d.ts

@@ -1,4 +0,0 @@
-import { Project } from 'ts-morph';
-export declare function createAstroFrontmatterProject(): Project;
-export declare function extractBindingPropName(element: import('ts-morph').BindingElement): string | null;
-export declare function collectAstroPropsBindings(frontmatter: string): import('ts-morph').BindingElement[];

package/dist/src/extract/framework-adapters/astro/helpers/collect-astro-props-bindings.js

@@ -1,47 +0,0 @@
-import { Node, Project } from 'ts-morph';
-export function createAstroFrontmatterProject() {
-    return new Project({
-        compilerOptions: { strict: false, target: 99, module: 99, allowJs: true },
-        useInMemoryFileSystem: true,
-        skipAddingFilesFromTsConfig: true,
-    });
-}
-function usesAstroProps(initializer) {
-    if (!initializer)
-        return false;
-    if (initializer.getText() === 'Astro.props')
-        return true;
-    let found = false;
-    initializer.forEachDescendant((node) => {
-        if (found)
-            return false;
-        if (Node.isPropertyAccessExpression(node) && node.getText() === 'Astro.props') {
-            found = true;
-            return false;
-        }
-        return undefined;
-    });
-    return found;
-}
-export function extractBindingPropName(element) {
-    if (element.getText().startsWith('...'))
-        return null;
-    return element.getPropertyNameNode()?.getText() ?? element.getNameNode().getText();
-}
-export function collectAstroPropsBindings(frontmatter) {
-    const elements = [];
-    const sf = createAstroFrontmatterProject().createSourceFile('__frontmatter__.ts', frontmatter);
-    sf.forEachDescendant((node) => {
-        if (!Node.isVariableDeclaration(node))
-            return;
-        const initializer = node.getInitializer();
-        if (!initializer || !usesAstroProps(initializer))
-            return;
-        const nameNode = node.getNameNode();
-        if (!Node.isObjectBindingPattern(nameNode))
-            return;
-        for (const element of nameNode.getElements())
-            elements.push(element);
-    });
-    return elements;
-}

package/dist/src/extract/framework-adapters/astro/slots.d.ts

@@ -1,7 +0,0 @@
-import type { RawSlotDefinition } from '../../types/component.js';
-/** Finds `<slot name="...">` tags in the Astro template section. */
-export declare function extractSlotsFromTemplate(template: string): RawSlotDefinition[];
-/** Finds `Astro.slots.render('name')` calls in the frontmatter to detect programmatically-rendered slots. */
-export declare function extractSlotsFromFrontmatter(frontmatter: string): RawSlotDefinition[];
-/** Merges slot arrays, keeping the first occurrence of each name. */
-export declare function mergeSlots(...slotGroups: RawSlotDefinition[][]): RawSlotDefinition[];

package/dist/src/extract/framework-adapters/astro/slots.js

@@ -1,44 +0,0 @@
-/** Finds `<slot name="...">` tags in the Astro template section. */
-export function extractSlotsFromTemplate(template) {
-    const slots = [];
-    const seen = new Set();
-    const slotRegex = /<slot(?:\s+name=["']([^"']+)["'])?\s*\/?>/g;
-    let match;
-    while ((match = slotRegex.exec(template)) !== null) {
-        const slotName = match[1] ?? 'default';
-        if (!seen.has(slotName)) {
-            seen.add(slotName);
-            slots.push({ name: slotName, isDefault: slotName === 'default' });
-        }
-    }
-    return slots;
-}
-/** Finds `Astro.slots.render('name')` calls in the frontmatter to detect programmatically-rendered slots. */
-export function extractSlotsFromFrontmatter(frontmatter) {
-    const slots = [];
-    const seen = new Set();
-    const slotRenderRegex = /Astro\.slots\.render\(\s*['"]([^'"]+)['"]\s*\)/g;
-    let match;
-    while ((match = slotRenderRegex.exec(frontmatter)) !== null) {
-        const slotName = match[1];
-        if (!seen.has(slotName)) {
-            seen.add(slotName);
-            slots.push({ name: slotName, isDefault: slotName === 'default' });
-        }
-    }
-    return slots;
-}
-/** Merges slot arrays, keeping the first occurrence of each name. */
-export function mergeSlots(...slotGroups) {
-    const merged = [];
-    const seen = new Set();
-    for (const slots of slotGroups) {
-        for (const slot of slots) {
-            if (seen.has(slot.name))
-                continue;
-            seen.add(slot.name);
-            merged.push(slot);
-        }
-    }
-    return merged;
-}