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

package/dist/src/extract/services/quality/helpers/authorability/evaluate-authorability.js

@@ -1,67 +0,0 @@
-const HANDLER_TYPE_PATTERN = /=>|EventHandler|Dispatch<|SetStateAction/;
-const REF_TYPE_PATTERN = /Ref<|RefObject<|MutableRefObject/;
-/** Returns true when the prop is an event-handler function or a React ref — not something a content editor configures. */
-export function isHandlerOrRefProp(prop) {
-    if (HANDLER_TYPE_PATTERN.test(prop.type))
-        return true;
-    if (REF_TYPE_PATTERN.test(prop.type))
-        return true;
-    if (/^on[A-Z]/.test(prop.name) || /^set[A-Z]/.test(prop.name))
-        return true;
-    if (prop.name === 'ref' || prop.name === 'innerRef')
-        return true;
-    return false;
-}
-/** Rule 1: no props AND no slots — analytics scripts, GTM tags, layout fixers, security tokens, etc. */
-export function hasNoPropsAndNoSlots(props, slots) {
-    return props.length === 0 && slots.length === 0;
-}
-/** Rule 2: createContext source with a prop literally named `value` — the canonical `<Context.Provider value={...}>` call site. */
-export function isContextProviderWithValueProp(props, usesCreateContext) {
-    return !!usesCreateContext && props.some((p) => p.name === 'value');
-}
-/** Rule 3: createContext source with zero props — a Provider that hard-codes its context value internally (e.g. FontProvider). */
-export function isHardwiredContextProvider(props, usesCreateContext) {
-    return !!usesCreateContext && props.length === 0;
-}
-/** Rule 4: createContext source with exactly one non-handler prop — a Provider that takes its context value as a single data prop (e.g. LocaleProvider, NavigationProvider). */
-export function isSingleDataPropContextWrapper(props, usesCreateContext) {
-    return !!usesCreateContext && props.length === 1 && !isHandlerOrRefProp(props[0]);
-}
-/** Rule 5: every prop is an event handler or ref — pure plumbing with no authoring surface (e.g. OsanoCookiePlaceholder({ onBannerLoaded })). */
-export function hasOnlyEventHandlers(props) {
-    return props.length > 0 && props.every(isHandlerOrRefProp);
-}
-/**
- * Checks whether a component has no surface for a content editor to configure.
- * Returns { skip: true, reason } for infrastructure components that should be
- * flagged for operator review 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 function hasNoAuthoringSurface(component) {
-    const { props, slots, usesCreateContext } = component;
-    if (hasNoPropsAndNoSlots(props, slots))
-        return { skip: true, reason: 'component has no props and no slots' };
-    if (isContextProviderWithValueProp(props, usesCreateContext))
-        return {
-            skip: true,
-            reason: 'source uses createContext and component exposes a Context.Provider value prop',
-        };
-    if (isHardwiredContextProvider(props, usesCreateContext))
-        return {
-            skip: true,
-            reason: 'source uses createContext and component has no props',
-        };
-    if (isSingleDataPropContextWrapper(props, usesCreateContext))
-        return {
-            skip: true,
-            reason: 'source uses createContext and component has a single non-handler prop',
-        };
-    if (hasOnlyEventHandlers(props))
-        return { skip: true, reason: 'every prop is a handler or ref' };
-    return { skip: false };
-}

package/dist/src/extract/services/quality/helpers/inspection/detect-data-wrapper-patterns.d.ts

@@ -1,16 +0,0 @@
-import type { RawComponentDefinition } from '../../../../types/component.js';
-export declare const DATA_WRAPPER_REASON_PREFIX = "data-wrapper:";
-export declare const VISIBLE_UI_TAG_PATTERN: RegExp;
-export declare const GENERATED_IMPORT_PATTERN: RegExp;
-export declare const GENERATED_QUERY_HOOK_PATTERN: RegExp;
-export declare const GQL_FILENAME_PATTERN: RegExp;
-export declare const LOADING_NULL_GUARD_PATTERN: RegExp;
-export declare function escapeRegExp(value: string): string;
-export declare function collectSiblingRendererImports(sourceText: string): string[];
-export declare function hasSiblingForwardRender(sourceText: string, siblingImports: string[]): boolean;
-export declare function hasVisibleUiRender(sourceText: string): boolean;
-/** Returns the prop names when all props are infra-only fetch props; returns empty array otherwise. */
-export declare function collectInfraPropNames(component: RawComponentDefinition): string[];
-/** Maps a raw wrapper evidence score (0–∞) to a 0–5 confidence value. */
-export declare function mapScoreToWrapperConfidence(score: number): 0 | 1 | 2 | 3 | 4 | 5;
-export declare function dedupeStrings(values: string[]): string[];

package/dist/src/extract/services/quality/helpers/inspection/detect-data-wrapper-patterns.js

@@ -1,63 +0,0 @@
-import { parseImportedNames } from '../../../../helpers/evidence/parse-source-imports.js';
-export const DATA_WRAPPER_REASON_PREFIX = 'data-wrapper:';
-const INFRA_PROP_NAMES = new Set(['id', 'locale', 'preview', 'slug', 'topic', 'previousComponent', '__typename']);
-export const VISIBLE_UI_TAG_PATTERN = /<(?:[A-Z][A-Za-z0-9_.]*|div|span|section|main|article|header|footer|nav|aside|img|video|p|h[1-6]|ul|ol|li|button|input|textarea|select|form|label|table|tbody|thead|tr|td|th)\b/;
-export const GENERATED_IMPORT_PATTERN = /from\s+['"][^'"]*__generated[^'"]*['"]/;
-export const GENERATED_QUERY_HOOK_PATTERN = /\buse[A-Z][A-Za-z0-9]*(?:Lazy|Suspense)?Query\s*\(/;
-export const GQL_FILENAME_PATTERN = /(?:-gql|-ggl)\.[cm]?[jt]sx?$/i;
-export const LOADING_NULL_GUARD_PATTERN = /if\s*\([^)]*(?:isLoading|loading|!data|!\w+Collection|!\w+Item|!\w+)\s*[^)]*\)\s*return\s+null\b/;
-const IMPORT_PATTERN = /import\s+(?:type\s+)?(.+?)\s+from\s+['"]([^'"]+)['"]/g;
-export function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-export function collectSiblingRendererImports(sourceText) {
-    const names = new Set();
-    for (const match of sourceText.matchAll(IMPORT_PATTERN)) {
-        const importClause = match[1]?.trim() ?? '';
-        const importPath = match[2]?.trim() ?? '';
-        if (!importPath.startsWith('./'))
-            continue;
-        if (importPath.includes('__generated'))
-            continue;
-        if (/-g(?:ql|gl)(?:$|\.)/i.test(importPath))
-            continue;
-        for (const name of parseImportedNames(importClause)) {
-            if (name)
-                names.add(name);
-        }
-    }
-    return [...names];
-}
-export function hasSiblingForwardRender(sourceText, siblingImports) {
-    return siblingImports.some((name) => {
-        const renderPattern = new RegExp(`<${escapeRegExp(name)}\\b[\\s\\S]*?(?:/>|</${escapeRegExp(name)}>)`);
-        if (!renderPattern.test(sourceText))
-            return false;
-        const siblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
-        const propsPlusSiblingSpreadPattern = new RegExp(`<${escapeRegExp(name)}\\b[^>]*\\{\\.\\.\\.props\\}[^>]*\\{\\.\\.\\.(?!props\\b)[^}]+\\}`);
-        return siblingSpreadPattern.test(sourceText) || propsPlusSiblingSpreadPattern.test(sourceText);
-    });
-}
-export function hasVisibleUiRender(sourceText) {
-    return /return\s*(?:\(|<)/.test(sourceText) && VISIBLE_UI_TAG_PATTERN.test(sourceText);
-}
-/** Returns the prop names when all props are infra-only fetch props; returns empty array otherwise. */
-export function collectInfraPropNames(component) {
-    const props = component.props.map((prop) => prop.name);
-    return props.length > 0 && props.every((prop) => INFRA_PROP_NAMES.has(prop)) ? props : [];
-}
-/** Maps a raw wrapper evidence score (0–∞) to a 0–5 confidence value. */
-export function mapScoreToWrapperConfidence(score) {
-    if (score <= 0)
-        return 0;
-    if (score <= 2)
-        return 2;
-    if (score <= 4)
-        return 3;
-    if (score <= 6)
-        return 4;
-    return 5;
-}
-export function dedupeStrings(values) {
-    return [...new Set(values)];
-}

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

@@ -1,14 +0,0 @@
-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/services/quality/helpers/scoring/compute-extraction-score.d.ts

@@ -1,6 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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

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

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

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

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

@@ -1,7 +0,0 @@
-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

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

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

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

package/dist/src/extract/types/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/types/contract.js

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

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

@@ -1,3 +0,0 @@
-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/extract/types/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/types/options.js

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

package/dist/src/extract/types/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/types/scoring.js

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

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

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

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

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