@contentful/experience-design-system-extraction 2.34.5-dev-build-4a4b9e84.0 → 2.34.5-dev-build-9dff4380.0

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

@@ -1,16 +0,0 @@
-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/model/contract.js

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

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

@@ -1,15 +0,0 @@
-/**
- * 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/model/options.js

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

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

@@ -1,9 +0,0 @@
-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/model/scoring.js

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

package/dist/src/extract/policies/quality/scoring.d.ts

@@ -1,5 +0,0 @@
-import type { RawComponentDefinition } from '../../model/component.js';
-import type { ExtractionConfidence, ExtractionScore, ExtractionScoreOptions } from '../../model/scoring.js';
-export type { ExtractionConfidence, ExtractionScore, ExtractionScoreOptions } from '../../model/scoring.js';
-export declare function computeExtractionScore(component: RawComponentDefinition, options?: ExtractionScoreOptions): ExtractionScore;
-export declare function deriveNeedsReview(confidence: ExtractionConfidence): boolean;

package/dist/src/extract/services/component-deduplicator.d.ts

@@ -1,2 +0,0 @@
-import type { ComponentExtractionResult } from '../model/component.js';
-export declare function deduplicateComponents(results: readonly ComponentExtractionResult[]): ComponentExtractionResult;

package/dist/src/extract/services/extraction-pipeline.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentExtractionResult, ExtractorProgress } from '../model/component.js';
-import type { ExtractorOptions } from '../model/options.js';
-export declare function extractComponents(filePaths: string[], onProgress?: (progress: ExtractorProgress) => void, opts?: ExtractorOptions): Promise<ComponentExtractionResult>;

package/dist/src/extract/services/extraction-pipeline.js

@@ -1,43 +0,0 @@
-import { deduplicateComponents } from './component-deduplicator.js';
-import { extractorRegistry, routeFilesToExtractors } from './extractor-registry.js';
-import { runExtractorBatches } from './extraction-runner.js';
-export async function extractComponents(filePaths, onProgress, opts) {
-    const exclusions = filePaths.flatMap((filePath) => {
-        if (!filePath.endsWith('.svelte'))
-            return [];
-        const name = filePath.replace(/\\/g, '/').split('/').pop() ?? '';
-        if (!/^\+(page|layout|error)\.svelte$/.test(name))
-            return [];
-        return [
-            {
-                itemType: 'file',
-                name,
-                source: filePath,
-                reason: 'SvelteKit route entrypoints are framework-managed, not authorable components',
-                stage: 'file-filter',
-            },
-        ];
-    });
-    const routedFiles = routeFilesToExtractors(filePaths, extractorRegistry);
-    const results = await runExtractorBatches(routedFiles, onProgress, opts);
-    const deduplicated = deduplicateComponents(results);
-    const components = deduplicated.components.filter((component) => {
-        if (!/^use[A-Z]/.test(component.name))
-            return true;
-        deduplicated.warnings.push(`Skipped hook: ${component.name} (hooks are not renderable components)`);
-        exclusions.push({
-            itemType: 'component',
-            name: component.name,
-            source: component.source,
-            reason: 'Hook names are not renderable components',
-            stage: 'component-filter',
-        });
-        return false;
-    });
-    const allExclusions = [...exclusions, ...(deduplicated.exclusions ?? [])];
-    return {
-        components,
-        warnings: deduplicated.warnings,
-        ...(allExclusions.length > 0 ? { exclusions: allExclusions } : {}),
-    };
-}

package/dist/src/extract/services/extraction-runner.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentExtractionResult, ExtractorProgress } from '../model/component.js';
-import type { ExtractorOptions } from '../model/options.js';
-import type { ExtractorFileGroup } from './extractor-registry.js';
-export declare function runExtractorBatches(batches: readonly ExtractorFileGroup[], onProgress?: (progress: ExtractorProgress) => void, options?: ExtractorOptions): Promise<ComponentExtractionResult[]>;

package/dist/src/extract/services/extraction-runner.js

@@ -1,21 +0,0 @@
-export async function runExtractorBatches(batches, onProgress, options) {
-    const perExtractorFiles = new Map();
-    const perExtractorComponents = new Map();
-    let totalFilesProcessed = 0;
-    let totalComponentsFound = 0;
-    return Promise.all(batches.map(async ({ extractor, filePaths }) => {
-        if (filePaths.length === 0)
-            return { components: [], warnings: [] };
-        perExtractorFiles.set(extractor, 0);
-        perExtractorComponents.set(extractor, 0);
-        return extractor.extract(filePaths, (progress) => {
-            const previousFiles = perExtractorFiles.get(extractor) ?? 0;
-            const previousComponents = perExtractorComponents.get(extractor) ?? 0;
-            totalFilesProcessed += progress.filesProcessed - previousFiles;
-            totalComponentsFound += progress.componentsFound - previousComponents;
-            perExtractorFiles.set(extractor, progress.filesProcessed);
-            perExtractorComponents.set(extractor, progress.componentsFound);
-            onProgress?.({ filesProcessed: totalFilesProcessed, componentsFound: totalComponentsFound });
-        }, options);
-    }));
-}

package/dist/src/extract/services/extraction-service.d.ts

@@ -1,13 +0,0 @@
-import type { ExtractorProgress } from '../model/component.js';
-import type { ExtractionEndpointResponse } from '../model/contract.js';
-import type { ExtractorOptions } from '../model/options.js';
-export interface ExtractionServiceRequest extends ExtractorOptions {
-    readonly filePaths: readonly string[];
-    onProgress?: (progress: ExtractorProgress) => void;
-}
-/**
- * Executes the extraction use case after the controller has validated the
- * public request. This service owns extraction-time classification, inspection,
- * quality signals, scoring, and validation, but not transport or persistence.
- */
-export declare function runExtractionService(request: ExtractionServiceRequest): Promise<ExtractionEndpointResponse>;

package/dist/src/extract/services/extraction-service.js

@@ -1,17 +0,0 @@
-import { extractComponents } from './extraction-pipeline.js';
-import { preClassifyComponent } from './classification-service.js';
-import { evaluateExtractionQuality } from './quality-service.js';
-/**
- * Executes the extraction use case after the controller has validated the
- * public request. This service owns extraction-time classification, inspection,
- * quality signals, scoring, and validation, but not transport or persistence.
- */
-export async function runExtractionService(request) {
-    const filePaths = [...request.filePaths];
-    const extraction = await extractComponents(filePaths, request.onProgress, {
-        ...(request.resolveUnreachable !== undefined ? { resolveUnreachable: request.resolveUnreachable } : {}),
-        ...(request.projectRoot !== undefined ? { projectRoot: request.projectRoot } : {}),
-    });
-    const classifiedComponents = extraction.components.map(preClassifyComponent);
-    return evaluateExtractionQuality(classifiedComponents, extraction.warnings);
-}

package/dist/src/extract/services/extractor-registry.d.ts

@@ -1,8 +0,0 @@
-import type { ComponentExtractor } from './ports/component-extractor.js';
-export interface ExtractorFileGroup {
-    extractor: ComponentExtractor;
-    filePaths: string[];
-}
-/** Ordered adapter registration; overlapping filters intentionally allow a file to be inspected by multiple adapters. */
-export declare const extractorRegistry: readonly ComponentExtractor[];
-export declare function routeFilesToExtractors(filePaths: readonly string[], extractors?: readonly ComponentExtractor[]): ExtractorFileGroup[];

package/dist/src/extract/services/extractor-registry.js

@@ -1,68 +0,0 @@
-import { extractAstroComponents } from '../adapters/astro/extractor.js';
-import { extractReactComponents } from '../adapters/react/extractor.js';
-import { extractStencilComponents } from '../adapters/stencil/extractor.js';
-import { extractSvelteComponents } from '../adapters/svelte/extractor.js';
-import { extractVueTsxComponents } from '../adapters/vue-tsx/extractor.js';
-import { extractVueComponents } from '../adapters/vue/extractor.js';
-import { extractWebComponentDefinitions } from '../adapters/web-components/extractor.js';
-/** Ordered adapter registration; overlapping filters intentionally allow a file to be inspected by multiple adapters. */
-export const extractorRegistry = [
-    {
-        name: 'stencil',
-        fileFilter: (filePath) => /\.[jt]sx$/.test(filePath),
-        extract: extractStencilComponents,
-    },
-    {
-        name: 'react',
-        fileFilter: (filePath) => /\.[jt]sx?$/.test(filePath) && !filePath.endsWith('.d.ts'),
-        extract: extractReactComponents,
-    },
-    {
-        name: 'vue-tsx',
-        fileFilter: (filePath) => /\.[jt]sx?$/.test(filePath) && !filePath.endsWith('.d.ts'),
-        extract: extractVueTsxComponents,
-    },
-    {
-        name: 'vue',
-        fileFilter: (filePath) => filePath.endsWith('.vue'),
-        extract: extractVueComponents,
-    },
-    {
-        name: 'astro',
-        fileFilter: (filePath) => filePath.endsWith('.astro'),
-        extract: extractAstroComponents,
-    },
-    {
-        name: 'web-components',
-        fileFilter: (filePath) => /\.[jt]s$/.test(filePath) && !/\.[jt]sx$/.test(filePath) && !filePath.endsWith('.d.ts'),
-        extract: extractWebComponentDefinitions,
-    },
-    {
-        name: 'svelte',
-        fileFilter: (filePath) => {
-            if (!filePath.endsWith('.svelte'))
-                return false;
-            const filename = filePath.replace(/\\/g, '/').split('/').pop() ?? '';
-            if (/^\+(page|layout|error)\.svelte$/.test(filename))
-                return false;
-            return true;
-        },
-        extract: extractSvelteComponents,
-    },
-];
-export function routeFilesToExtractors(filePaths, extractors = extractorRegistry) {
-    const filesByExtractor = new Map();
-    for (const extractor of extractors) {
-        filesByExtractor.set(extractor, []);
-    }
-    for (const filePath of filePaths) {
-        for (const extractor of extractors) {
-            if (extractor.fileFilter(filePath)) {
-                filesByExtractor.get(extractor)?.push(filePath);
-            }
-        }
-    }
-    return extractors
-        .map((extractor) => ({ extractor, filePaths: filesByExtractor.get(extractor) ?? [] }))
-        .filter(({ filePaths: groupedFilePaths }) => groupedFilePaths.length > 0);
-}

package/dist/src/extract/services/ports/component-extractor.d.ts

@@ -1,7 +0,0 @@
-import type { ComponentExtractionResult, ExtractorProgress } from '../../model/component.js';
-import type { ExtractorOptions } from '../../model/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/services/ports/component-extractor.js

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

package/dist/src/extract/services/quality-service.d.ts

@@ -1,4 +0,0 @@
-import type { RawComponentDefinition } from '../model/component.js';
-import type { ExtractionEndpointResponse } from '../model/contract.js';
-/** Applies inspection, authorability, scoring, review, and validation policies to extracted models. */
-export declare function evaluateExtractionQuality(components: readonly RawComponentDefinition[], initialWarnings?: readonly string[]): Promise<ExtractionEndpointResponse>;

package/dist/src/extract/services/quality-service.js

@@ -1,61 +0,0 @@
-import { isNonAuthorableComponent } from '../policies/quality/authorability.js';
-import { computeExtractionScore, deriveNeedsReview } from '../policies/quality/scoring.js';
-import { inspectComponentSource, describeReviewReasons } from '../policies/quality/source-inspection.js';
-import { validateExtractedComponents } from '../policies/quality/validation.js';
-function wrapperConfidenceToIssueCount(confidence) {
-    if (confidence >= 4)
-        return 2;
-    if (confidence === 3)
-        return 1;
-    return 0;
-}
-/** Applies inspection, authorability, scoring, review, and validation policies to extracted models. */
-export async function evaluateExtractionQuality(components, initialWarnings = []) {
-    const inspectedComponents = await Promise.all(components.map(async (component) => ({
-        component,
-        inspection: await inspectComponentSource(component),
-    })));
-    const scoredComponents = [];
-    const warnings = [...initialWarnings];
-    for (const { component, inspection } of inspectedComponents) {
-        const verdict = isNonAuthorableComponent(component);
-        const keepDespiteZeroSurface = verdict.skip && verdict.reason === 'component has no props and no slots' && inspection.keepDespiteZeroSurface;
-        const retainedForReview = verdict.skip && !keepDespiteZeroSurface;
-        if (retainedForReview) {
-            warnings.push(`${component.name}: requires operator review (${verdict.reason})`);
-        }
-        if (keepDespiteZeroSurface) {
-            warnings.push(`${component.name}: retained despite 0 props/slots because the source renders visible or compositional UI`);
-        }
-        if (inspection.reviewReasons.length > 0) {
-            const reviewNotes = describeReviewReasons(inspection.reviewReasons)
-                .filter((note) => note !== 'high-confidence data-fetch wrapper')
-                .join('; ');
-            if (reviewNotes)
-                warnings.push(`${component.name}: ${reviewNotes}`);
-        }
-        const extractorReasons = component.reviewReasons ?? [];
-        const nonAuthorableReason = retainedForReview ? [`non-authorable:${verdict.reason}`] : [];
-        const { confidence, reasons } = computeExtractionScore(component, {
-            additionalIssueCount: wrapperConfidenceToIssueCount(inspection.wrapperConfidence) +
-                extractorReasons.length +
-                nonAuthorableReason.length,
-            additionalReasons: [...extractorReasons, ...inspection.reviewReasons, ...nonAuthorableReason],
-        });
-        scoredComponents.push({
-            ...component,
-            extractionConfidence: confidence,
-            reviewReasons: reasons,
-            needsReview: deriveNeedsReview(confidence) ||
-                inspection.wrapperConfidence >= 4 ||
-                inspection.keepDespiteZeroSurface ||
-                retainedForReview ||
-                extractorReasons.includes('props-type-unresolved') ||
-                (component.needsReview ?? false),
-        });
-    }
-    return {
-        components: validateExtractedComponents(scoredComponents),
-        warnings,
-    };
-}