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

package/dist/src/extract/services/quality/helpers/scoring/collect-scoring-inputs.d.ts

@@ -0,0 +1,14 @@
+import type { RawComponentDefinition } from '../../../../types/component.js';
+import type { ExtractionConfidence, ExtractionScoreOptions } from '../../../../types/scoring.js';
+/** Returns true when the union mixes 3+ distinct base primitive types (ignoring nullability). */
+export declare function isWidePrimitiveUnion(type: string): boolean;
+/** Counts quality issues in the component and returns the count with labels. */
+export declare function countExtractionIssues(component: RawComponentDefinition, options?: ExtractionScoreOptions): {
+    count: number;
+    reasons: string[];
+};
+/**
+ * Maps issue count to a 1–5 confidence scale:
+ *   0 → 5 (clean), 1 → 4, 2 → 3, 3 → 2, 4+ → 1
+ */
+export declare function mapIssueCountToConfidence(count: number): ExtractionConfidence;

package/dist/src/extract/{scoring.js → services/quality/helpers/scoring/collect-scoring-inputs.js}

@@ -1,6 +1,6 @@
 // Prop type strings that indicate the extractor couldn't resolve a concrete type
 const OPAQUE_TYPES = new Set(['any', 'unknown', 'object', 'Record<string, unknown>', 'Record<string, any>']);
-// Prop names that are non-obvious and benefit from a description
+// Well-known prop names whose purpose is obvious without a description
 const OBVIOUS_PROP_NAMES = new Set([
     'className',
     'style',
@@ -31,9 +31,8 @@ const OBVIOUS_PROP_NAMES = new Set([
     'aria-label',
     'aria-describedby',
 ]);
-// A union is "wide" if it mixes 3+ distinct base primitive types (ignoring nullability modifiers).
-// e.g. "string | number | boolean" → wide. "string | null | undefined" → NOT wide (just nullable string).
-function isWidePrimitiveUnion(type) {
+/** Returns true when the union mixes 3+ distinct base primitive types (ignoring nullability). */
+export function isWidePrimitiveUnion(type) {
     const parts = type.split('|').map((p) => p.trim());
     if (parts.length < 3)
         return false;
@@ -43,8 +42,8 @@ function isWidePrimitiveUnion(type) {
     const nullabilityCount = parts.filter((p) => nullability.has(p)).length;
     return baseCount >= 3 || (baseCount >= 2 && nullabilityCount > 0 && baseCount + nullabilityCount >= 3);
 }
-// Count the number of issues found for scoring
-function countIssues(component, options = {}) {
+/** Counts quality issues in the component and returns the count with labels. */
+export function countExtractionIssues(component, options = {}) {
     let count = 0;
     const reasons = [];
     if (component.props.length === 0 && component.slots.length === 0) {
@@ -78,13 +77,11 @@ function countIssues(component, options = {}) {
     }
     return { count, reasons: [...new Set(reasons)] };
 }
-// Maps issue count to a 1–5 confidence scale:
-//   0 issues → 5 (clean)
-//   1 issue  → 4 (minor concern)
-//   2 issues → 3 (moderate concern)
-//   3 issues → 2 (significant concern)
-//   4+ issues → 1 (likely wrong)
-function issueCountToConfidence(count) {
+/**
+ * Maps issue count to a 1–5 confidence scale:
+ *   0 → 5 (clean), 1 → 4, 2 → 3, 3 → 2, 4+ → 1
+ */
+export function mapIssueCountToConfidence(count) {
     if (count === 0)
         return 5;
     if (count === 1)
@@ -95,14 +92,3 @@ function issueCountToConfidence(count) {
         return 2;
     return 1;
 }
-export function computeExtractionScore(component, options = {}) {
-    const { count, reasons } = countIssues(component, options);
-    return {
-        confidence: issueCountToConfidence(count),
-        reasons,
-    };
-}
-// Flag components scoring 2 or below for human review
-export function deriveNeedsReview(confidence) {
-    return confidence <= 2;
-}

package/dist/src/extract/services/quality/helpers/scoring/compute-extraction-score.d.ts

@@ -0,0 +1,6 @@
+import type { RawComponentDefinition } from '../../../../types/component.js';
+import type { ExtractionConfidence, ExtractionScore, ExtractionScoreOptions } from '../../../../types/scoring.js';
+export type { ExtractionConfidence, ExtractionScore, ExtractionScoreOptions } from '../../../../types/scoring.js';
+export declare function computeExtractionScore(component: RawComponentDefinition, options?: ExtractionScoreOptions): ExtractionScore;
+/** Returns true when the confidence score is low enough to require human review. */
+export declare function deriveNeedsReview(confidence: ExtractionConfidence): boolean;

package/dist/src/extract/services/quality/helpers/scoring/compute-extraction-score.js

@@ -0,0 +1,12 @@
+import { countExtractionIssues, mapIssueCountToConfidence } from './collect-scoring-inputs.js';
+export function computeExtractionScore(component, options = {}) {
+    const { count, reasons } = countExtractionIssues(component, options);
+    return {
+        confidence: mapIssueCountToConfidence(count),
+        reasons,
+    };
+}
+/** Returns true when the confidence score is low enough to require human review. */
+export function deriveNeedsReview(confidence) {
+    return confidence <= 2;
+}

package/dist/src/extract/types/classification.d.ts

@@ -0,0 +1,4 @@
+export interface PreClassification {
+    category: 'content' | 'design' | 'state' | 'exclude';
+    cdfTypeHint?: 'string' | 'enum' | 'richtext' | 'media' | 'boolean';
+}

package/dist/src/extract/types/classification.js

@@ -0,0 +1 @@
+export {};

package/dist/src/extract/types/component-extractor.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentExtractionResult, ExtractorProgress } from './component.js';
+import type { ExtractorOptions } from './options.js';
+export interface ComponentExtractor {
+    name: string;
+    fileFilter: (filePath: string) => boolean;
+    extract(filePaths: string[], onProgress?: (progress: ExtractorProgress) => void, options?: ExtractorOptions): Promise<ComponentExtractionResult>;
+}

package/dist/src/extract/types/component-extractor.js

@@ -0,0 +1 @@
+export {};

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

@@ -76,25 +76,3 @@ 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/component.js

@@ -0,0 +1 @@
+export {};

package/dist/src/extract/types/contract.d.ts

@@ -0,0 +1,16 @@
+import type { RawComponentDefinition } from './component.js';
+import type { ExtractorOptions } from './options.js';
+export type ExtractionEndpointProgress = {
+    phase: 'extract';
+    filesProcessed: number;
+    totalFiles: number;
+    componentsFound: number;
+};
+export interface ExtractionEndpointRequest extends ExtractorOptions {
+    readonly filePaths: readonly string[];
+    onProgress?: (progress: ExtractionEndpointProgress) => void;
+}
+export interface ExtractionEndpointResponse {
+    components: RawComponentDefinition[];
+    warnings: string[];
+}

package/dist/src/extract/types/contract.js

@@ -0,0 +1 @@
+export {};

package/dist/src/extract/types/display.d.ts

@@ -0,0 +1,3 @@
+import type { RawComponentDefinition } from './component.js';
+/** Removes internal scoring fields from a component before showing it in the editor or writing it to disk. */
+export declare function stripScoringFields({ extractionConfidence: _c, reviewReasons: _r, needsReview: _n, ...rest }: RawComponentDefinition): Omit<RawComponentDefinition, 'extractionConfidence' | 'reviewReasons' | 'needsReview'>;

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

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

package/dist/src/extract/types/options.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 could not 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;
+}

package/dist/src/extract/types/options.js

@@ -0,0 +1 @@
+export {};

package/dist/src/extract/types/scoring.d.ts

@@ -0,0 +1,9 @@
+export type ExtractionConfidence = 1 | 2 | 3 | 4 | 5;
+export type ExtractionScore = {
+    confidence: ExtractionConfidence;
+    reasons: string[];
+};
+export interface ExtractionScoreOptions {
+    additionalIssueCount?: number;
+    additionalReasons?: string[];
+}

package/dist/src/extract/types/scoring.js

@@ -0,0 +1 @@
+export {};

package/dist/src/extract/types/source-inspection.d.ts

@@ -0,0 +1,5 @@
+export interface ComponentSourceInspection {
+    wrapperConfidence: 0 | 1 | 2 | 3 | 4 | 5;
+    reviewReasons: string[];
+    keepDespiteZeroSurface: boolean;
+}

package/dist/src/extract/types/source-inspection.js

@@ -0,0 +1 @@
+export {};

package/dist/src/index.d.ts

@@ -1,21 +1,27 @@
-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';
+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';

package/dist/src/index.js

@@ -1,23 +1,27 @@
-export { stripScoringFields } from './types.js';
+export { stripScoringFields } from './extract/types/display.js';
 // Core extraction pipeline
-export { extractComponents } from './extract/pipeline.js';
+export { extractComponents } from './extract/services/extraction/extract-components.js';
+export { extractEndpoint } from './extract/controller/extract-controller.js';
 // Framework-specific extractors
-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 { 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';
 // Post-extraction filtering and scoring
-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';
+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';
 // Validation
-export { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, formatExcludedComponentLines, } from './extract/validate.js';
-export { parseImportedNames } from './extract/parse-imported-names.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';
 // Slot detection helpers
-export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/slot-detection.js';
+export { CONTENT_NAME_EXCEPTIONS, isReactNodeType, isArrayReactNodeType, shouldBeSlot, } from './extract/helpers/evidence/detect-slot-from-prop.js';
 // Pre-classification
-export { preClassifyProp, preClassifyComponent } from './pre-classify.js';
+export { preClassifyProp, preClassifyComponent } from './extract/services/classification/classify-component-props.js';

package/package.json

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

package/dist/src/extract/astro.js

@@ -1,226 +0,0 @@
-import os from 'node:os';
-import { basename } from 'node:path';
-import { Project, Node } from 'ts-morph';
-import { createSortedExtractionResult, runFileExtractionWorkers } from './file-extraction-workers.js';
-import { resolveTypeProperty } from './resolve-type-property.js';
-import { getSourceLineMetadata } from './source-line-metadata.js';
-function extractAllowedValues(typeText) {
-    // Check if the type is a union of string literals like 'a' | 'b' | 'c'
-    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;
-}
-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;
-}
-function extractBindingPropName(element) {
-    if (element.getText().startsWith('...'))
-        return null;
-    return element.getPropertyNameNode()?.getText() ?? element.getNameNode().getText();
-}
-function createAstroFrontmatterProject() {
-    return new Project({
-        compilerOptions: {
-            strict: false,
-            target: 99,
-            module: 99,
-            allowJs: true,
-        },
-        useInMemoryFileSystem: true,
-        skipAddingFilesFromTsConfig: true,
-    });
-}
-function forEachAstroPropsBinding(frontmatter, visit) {
-    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())
-            visit(element);
-    });
-}
-function extractFallbackPropsFromFrontmatter(frontmatter) {
-    const props = new Map();
-    forEachAstroPropsBinding(frontmatter, (element) => {
-        const propName = extractBindingPropName(element);
-        if (!propName)
-            return;
-        props.set(propName, {
-            name: propName,
-            type: 'any',
-            required: !element.getInitializer(),
-        });
-    });
-    return [...props.values()].sort((a, b) => a.name.localeCompare(b.name));
-}
-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));
-}
-function extractPropsFromFrontmatter(frontmatter) {
-    const sf = createAstroFrontmatterProject().createSourceFile('__frontmatter__.ts', frontmatter);
-    const props = [];
-    // Find `interface Props` or `type 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));
-}
-function extractDefaultsFromFrontmatter(frontmatter) {
-    const defaults = new Map();
-    forEachAstroPropsBinding(frontmatter, (element) => {
-        const propName = extractBindingPropName(element);
-        if (!propName)
-            return;
-        const elementInitializer = element.getInitializer();
-        if (!elementInitializer)
-            return;
-        const value = elementInitializer.getText().replace(/^['"]|['"]$/g, '');
-        defaults.set(propName, value);
-    });
-    return defaults;
-}
-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;
-}
-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;
-}
-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;
-}
-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/non-authorable-filter.d.ts

@@ -1,17 +0,0 @@
-import type { RawComponentDefinition } from '../types.js';
-interface NonAuthorableResult {
-    skip: boolean;
-    reason?: string;
-}
-/**
- * Decides whether a component is non-authorable infrastructure (Context.Provider,
- * analytics shim, layout-only utility, etc.) and should be filtered out of the
- * analyze TUI before authoring-token generation.
- *
- * Uses prop-shape signals only — no component-name or source-path patterns.
- * A design system can live anywhere under any naming convention; relying on
- * suffixes like `*Provider` or paths like `src/lib/` would silently fail in
- * other repos.
- */
-export declare function isNonAuthorableComponent(component: RawComponentDefinition): NonAuthorableResult;
-export {};