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

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import-source.d.ts

@@ -1,7 +0,0 @@
-import { Node, type Project, type SourceFile } from 'ts-morph';
-export declare function loadSourceFile(project: Project, filePath: string): SourceFile | null;
-export declare function resolveImportSourcePath(fromFilePath: string, specifier: string): string | null;
-export declare function resolveImportSpecifierSource(declarationNode: Node, sourceFile: SourceFile, project: Project): {
-    sourceFile: SourceFile;
-    importedName: string;
-} | undefined;

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import-source.js

@@ -1,47 +0,0 @@
-import { dirname, resolve } from 'node:path';
-import { Node } from 'ts-morph';
-export function loadSourceFile(project, filePath) {
-    let sourceFile = project.getSourceFile(filePath);
-    if (sourceFile)
-        return sourceFile;
-    try {
-        sourceFile = project.addSourceFileAtPath(filePath);
-        return sourceFile;
-    }
-    catch {
-        return null;
-    }
-}
-export function resolveImportSourcePath(fromFilePath, specifier) {
-    if (specifier.startsWith('.')) {
-        const resolvedPath = resolve(dirname(fromFilePath), specifier);
-        if (resolvedPath.endsWith('.js'))
-            return `${resolvedPath.slice(0, -3)}.ts`;
-        return resolvedPath;
-    }
-    const spectrumPrefix = '@spectrum-web-components/core/components/';
-    if (!specifier.startsWith(spectrumPrefix))
-        return null;
-    const packagesMarker = `${'2nd-gen/packages'}${fromFilePath.includes('\\') ? '\\' : '/'}`;
-    const markerIndex = fromFilePath.lastIndexOf(packagesMarker);
-    if (markerIndex === -1)
-        return null;
-    const packagesRoot = fromFilePath.slice(0, markerIndex + packagesMarker.length - 1);
-    const componentPath = specifier.slice(spectrumPrefix.length);
-    return `${packagesRoot}/core/components/${componentPath}/index.ts`;
-}
-export function resolveImportSpecifierSource(declarationNode, sourceFile, project) {
-    if (!Node.isImportSpecifier(declarationNode))
-        return undefined;
-    const importDecl = declarationNode.getImportDeclaration();
-    const resolvedImportPath = resolveImportSourcePath(sourceFile.getFilePath(), importDecl.getModuleSpecifierValue());
-    if (!resolvedImportPath)
-        return undefined;
-    const importedFile = loadSourceFile(project, resolvedImportPath);
-    if (!importedFile)
-        return undefined;
-    return {
-        sourceFile: importedFile,
-        importedName: declarationNode.getNameNode().getText(),
-    };
-}

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import.d.ts

@@ -1,4 +0,0 @@
-import { Node, type Project, type SourceFile } from 'ts-morph';
-import { loadSourceFile, resolveImportSourcePath, resolveImportSpecifierSource } from './resolve-wc-import-source.js';
-export { loadSourceFile, resolveImportSourcePath, resolveImportSpecifierSource };
-export declare function resolveStaticStringExpression(node: Node | undefined, sourceFile: SourceFile, project: Project): string | null;

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-import.js

@@ -1,93 +0,0 @@
-import { Node, SyntaxKind } from 'ts-morph';
-import { loadSourceFile, resolveImportSourcePath, resolveImportSpecifierSource } from './resolve-wc-import-source.js';
-export { loadSourceFile, resolveImportSourcePath, resolveImportSpecifierSource };
-export function resolveStaticStringExpression(node, sourceFile, project) {
-    if (!node)
-        return null;
-    if (Node.isStringLiteral(node) || Node.isNoSubstitutionTemplateLiteral(node))
-        return node.getLiteralValue();
-    if (Node.isTemplateExpression(node)) {
-        let resolved = node.getHead().getLiteralText();
-        for (const span of node.getTemplateSpans()) {
-            const interpolation = resolveStaticStringExpression(span.getExpression(), sourceFile, project);
-            if (!interpolation)
-                return null;
-            resolved += interpolation;
-            resolved += span.getLiteral().getLiteralText();
-        }
-        return resolved;
-    }
-    if (Node.isIdentifier(node)) {
-        for (const definition of node.getDefinitions()) {
-            const declarationNode = definition.getDeclarationNode();
-            if (!declarationNode)
-                continue;
-            if (Node.isVariableDeclaration(declarationNode)) {
-                const resolved = resolveStaticStringExpression(declarationNode.getInitializer(), declarationNode.getSourceFile(), project);
-                if (resolved)
-                    return resolved;
-            }
-            if (Node.isImportSpecifier(declarationNode)) {
-                const importedSource = resolveImportSpecifierSource(declarationNode, sourceFile, project);
-                if (!importedSource)
-                    continue;
-                const importedDeclaration = importedSource.sourceFile.getVariableDeclaration(importedSource.importedName);
-                if (!importedDeclaration)
-                    continue;
-                const resolved = resolveStaticStringExpression(importedDeclaration.getInitializer(), importedSource.sourceFile, project);
-                if (resolved)
-                    return resolved;
-            }
-        }
-        const text = node.getText();
-        if (/Prefix$/.test(text))
-            return camelToKebab(text.replace(/Prefix$/, ''));
-        return null;
-    }
-    if (Node.isPropertyAccessExpression(node)) {
-        const target = node.getExpression();
-        if (!Node.isIdentifier(target))
-            return null;
-        const propertyName = node.getName();
-        for (const definition of target.getDefinitions()) {
-            const declarationNode = definition.getDeclarationNode();
-            if (!declarationNode)
-                continue;
-            let variableDeclaration;
-            if (Node.isVariableDeclaration(declarationNode)) {
-                variableDeclaration = declarationNode;
-            }
-            else if (Node.isImportSpecifier(declarationNode)) {
-                const importedSource = resolveImportSpecifierSource(declarationNode, sourceFile, project);
-                if (!importedSource)
-                    continue;
-                variableDeclaration = importedSource.sourceFile.getVariableDeclaration(importedSource.importedName);
-            }
-            if (!variableDeclaration)
-                continue;
-            let objectLiteral = variableDeclaration.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
-            const initializer = variableDeclaration.getInitializer();
-            if (!objectLiteral &&
-                initializer &&
-                Node.isCallExpression(initializer) &&
-                initializer.getExpression().getText() === 'Object.freeze') {
-                objectLiteral = initializer.getArguments()[0]?.asKind(SyntaxKind.ObjectLiteralExpression) ?? undefined;
-            }
-            const property = objectLiteral
-                ?.getProperties()
-                .find((prop) => Node.isPropertyAssignment(prop) && prop.getName() === propertyName);
-            if (!property)
-                continue;
-            const resolved = resolveStaticStringExpression(property.getInitializer(), variableDeclaration.getSourceFile(), project);
-            if (resolved)
-                return resolved;
-        }
-    }
-    return null;
-}
-function camelToKebab(input) {
-    return input
-        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
-        .toLowerCase();
-}

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-sibling-definition.d.ts

@@ -1,4 +0,0 @@
-import { type ClassDeclaration, type Project, type SourceFile } from 'ts-morph';
-export declare function buildTagNameMap(sourceFile: SourceFile): Map<string, string>;
-export declare function getElementTagNameFromSiblingDefine(classDecl: ClassDeclaration, project: Project): string | null;
-export declare function getElementTagNameFromFastDefinition(classDecl: ClassDeclaration, project: Project): string | null;

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-sibling-definition.js

@@ -1,79 +0,0 @@
-import { Node, SyntaxKind } from 'ts-morph';
-import { resolveStaticStringExpression, loadSourceFile } from './resolve-wc-import.js';
-export function buildTagNameMap(sourceFile) {
-    const tagNameMap = new Map();
-    sourceFile.forEachDescendant((node) => {
-        if (!Node.isCallExpression(node))
-            return;
-        const expr = node.getExpression();
-        if (!Node.isPropertyAccessExpression(expr) || expr.getName() !== 'define')
-            return;
-        if (expr.getExpression().getText() !== 'customElements')
-            return;
-        const args = node.getArguments();
-        if (args.length < 2)
-            return;
-        const tagArg = args[0];
-        const classArg = args[1];
-        if (!Node.isStringLiteral(tagArg))
-            return;
-        tagNameMap.set(classArg.getText(), tagArg.getLiteralValue());
-    });
-    return tagNameMap;
-}
-export function getElementTagNameFromSiblingDefine(classDecl, project) {
-    const sourceFilePath = classDecl.getSourceFile().getFilePath();
-    if (!sourceFilePath.endsWith('.component.ts'))
-        return null;
-    const siblingPath = `${sourceFilePath.slice(0, -'.component.ts'.length)}.ts`;
-    let siblingFile = project.getSourceFile(siblingPath);
-    if (!siblingFile) {
-        try {
-            siblingFile = project.addSourceFileAtPath(siblingPath);
-        }
-        catch {
-            return null;
-        }
-    }
-    const className = classDecl.getName();
-    if (!className)
-        return null;
-    for (const node of siblingFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
-        const expression = node.getExpression();
-        if (!Node.isPropertyAccessExpression(expression) || expression.getName() !== 'define')
-            continue;
-        if (expression.getExpression().getText() !== className)
-            continue;
-        const tagArg = node.getArguments()[0];
-        if (!tagArg || !Node.isStringLiteral(tagArg))
-            continue;
-        return tagArg.getLiteralValue();
-    }
-    return null;
-}
-export function getElementTagNameFromFastDefinition(classDecl, project) {
-    const sourceFilePath = classDecl.getSourceFile().getFilePath();
-    if (!sourceFilePath.endsWith('.ts') || sourceFilePath.endsWith('.definition.ts'))
-        return null;
-    const definitionPath = `${sourceFilePath.slice(0, -'.ts'.length)}.definition.ts`;
-    const definitionFile = loadSourceFile(project, definitionPath);
-    if (!definitionFile)
-        return null;
-    for (const callExpr of definitionFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
-        const expression = callExpr.getExpression();
-        if (!Node.isPropertyAccessExpression(expression) || expression.getName() !== 'compose')
-            continue;
-        const options = callExpr.getArguments()[0];
-        if (!options || !Node.isObjectLiteralExpression(options))
-            continue;
-        const nameProperty = options
-            .getProperties()
-            .find((prop) => Node.isPropertyAssignment(prop) && (prop.getName() === 'name' || prop.getName() === 'baseName'));
-        if (!nameProperty)
-            continue;
-        const resolved = resolveStaticStringExpression(nameProperty.getInitializer(), definitionFile, project);
-        if (resolved)
-            return resolved;
-    }
-    return null;
-}

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-tag-name.d.ts

@@ -1,7 +0,0 @@
-import { type ClassDeclaration, type Project } from 'ts-morph';
-import { getElementTagNameFromDecorator } from './resolve-wc-decorator-tag.js';
-import { buildTagNameMap, getElementTagNameFromSiblingDefine, getElementTagNameFromFastDefinition } from './resolve-wc-sibling-definition.js';
-export { buildTagNameMap, getElementTagNameFromDecorator, getElementTagNameFromSiblingDefine, getElementTagNameFromFastDefinition, };
-export declare function chooseComponentName(classDecl: ClassDeclaration, className: string, tagName: string | undefined): string;
-export declare function getElementTagNameFromJsDoc(classDecl: ClassDeclaration): string | null;
-export declare function resolveWcTagName(classDecl: ClassDeclaration, tagNameMap: Map<string, string>, project: Project): string | undefined;

package/dist/src/extract/framework-adapters/web-components/helpers/resolve-wc-tag-name.js

@@ -1,62 +0,0 @@
-import { basename } from 'node:path';
-import { kebabToPascal } from '../../shared/helpers/tsx-shared.js';
-import { getElementTagNameFromDecorator } from './resolve-wc-decorator-tag.js';
-import { buildTagNameMap, getElementTagNameFromSiblingDefine, getElementTagNameFromFastDefinition, } from './resolve-wc-sibling-definition.js';
-export { buildTagNameMap, getElementTagNameFromDecorator, getElementTagNameFromSiblingDefine, getElementTagNameFromFastDefinition, };
-function normalizeComponentName(input) {
-    return input.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
-}
-function shouldPreferTagName(className, tagName) {
-    const pascalTagName = kebabToPascal(tagName);
-    if (className.startsWith('HTML') && className.endsWith('Element'))
-        return true;
-    if (className.endsWith('Element'))
-        return true;
-    if (normalizeComponentName(className) === normalizeComponentName(pascalTagName))
-        return false;
-    return false;
-}
-function getFileDerivedComponentName(sourceFile) {
-    const baseName = basename(sourceFile.getFilePath())
-        .replace(/\.[^.]+$/, '')
-        .replace(/\.component$/, '');
-    return kebabToPascal(baseName);
-}
-export function chooseComponentName(classDecl, className, tagName) {
-    if (!tagName)
-        return className;
-    const tagDerivedName = kebabToPascal(tagName);
-    const fileDerivedName = getFileDerivedComponentName(classDecl.getSourceFile());
-    if (normalizeComponentName(className) === normalizeComponentName(tagDerivedName))
-        return className;
-    if (normalizeComponentName(className) === normalizeComponentName(fileDerivedName))
-        return className;
-    if (fileDerivedName && tagDerivedName.endsWith(fileDerivedName))
-        return fileDerivedName;
-    if (shouldPreferTagName(className, tagName))
-        return tagDerivedName;
-    return className;
-}
-export function getElementTagNameFromJsDoc(classDecl) {
-    for (const doc of classDecl.getJsDocs()) {
-        for (const tag of doc.getTags()) {
-            if (tag.getTagName() !== 'element')
-                continue;
-            const comment = tag.getCommentText();
-            if (comment)
-                return comment.trim();
-        }
-    }
-    return null;
-}
-export function resolveWcTagName(classDecl, tagNameMap, project) {
-    const className = classDecl.getName();
-    if (!className)
-        return undefined;
-    return (tagNameMap.get(className) ??
-        getElementTagNameFromSiblingDefine(classDecl, project) ??
-        getElementTagNameFromDecorator(classDecl) ??
-        getElementTagNameFromJsDoc(classDecl) ??
-        getElementTagNameFromFastDefinition(classDecl, project) ??
-        undefined);
-}

package/dist/src/extract/helpers/evidence/ast/collect-structural-jsx-evidence.d.ts

@@ -1,5 +0,0 @@
-import { type FunctionDeclaration, type ArrowFunction, type FunctionExpression } from 'ts-morph';
-type FunctionLike = FunctionDeclaration | ArrowFunction | FunctionExpression;
-export declare function collectRenderedComponentReferences(funcNode: FunctionLike, componentNames: ReadonlySet<string>, ownComponentName: string): string[];
-export declare function collectArrayMapRenderComponentReferences(funcNode: FunctionLike, componentNames: ReadonlySet<string>, ownComponentName: string, propTypesByName: ReadonlyMap<string, string>): string[];
-export {};

package/dist/src/extract/helpers/evidence/ast/collect-structural-jsx-evidence.js

@@ -1,63 +0,0 @@
-import { SyntaxKind } from 'ts-morph';
-import { isIntrinsicJsxElement } from '../../../framework-adapters/shared/helpers/tsx-shared.js';
-import { getReturnedJsxTagName, isJsxCarryingTypeText } from './get-jsx-ast-data.js';
-export function collectRenderedComponentReferences(funcNode, componentNames, ownComponentName) {
-    const found = new Set();
-    const jsxElements = [
-        ...funcNode.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),
-        ...funcNode.getDescendantsOfKind(SyntaxKind.JsxOpeningElement),
-    ];
-    for (const jsxElement of jsxElements) {
-        const tagName = jsxElement.getTagNameNode().getText();
-        if (isIntrinsicJsxElement(tagName))
-            continue;
-        if (tagName === ownComponentName)
-            continue;
-        if (!componentNames.has(tagName))
-            continue;
-        found.add(tagName);
-    }
-    return [...found].sort();
-}
-export function collectArrayMapRenderComponentReferences(funcNode, componentNames, ownComponentName, propTypesByName) {
-    const found = new Set();
-    const propNames = new Set(propTypesByName.keys());
-    const renderCountByComponent = new Map();
-    for (const jsxElement of [
-        ...funcNode.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),
-        ...funcNode.getDescendantsOfKind(SyntaxKind.JsxOpeningElement),
-    ]) {
-        const tagName = jsxElement.getTagNameNode().getText();
-        if (isIntrinsicJsxElement(tagName) || tagName === ownComponentName || !componentNames.has(tagName))
-            continue;
-        renderCountByComponent.set(tagName, (renderCountByComponent.get(tagName) ?? 0) + 1);
-    }
-    for (const callExpr of funcNode.getDescendantsOfKind(SyntaxKind.CallExpression)) {
-        const callee = callExpr.getExpression();
-        if (!callee.isKind(SyntaxKind.PropertyAccessExpression))
-            continue;
-        if (callee.getName() !== 'map')
-            continue;
-        const receiver = callee.getExpression();
-        if (!receiver.isKind(SyntaxKind.Identifier))
-            continue;
-        const propName = receiver.getText();
-        if (!propNames.has(propName))
-            continue;
-        const propTypeText = propTypesByName.get(propName) ?? '';
-        if (isJsxCarryingTypeText(propTypeText))
-            continue;
-        const [callbackArg] = callExpr.getArguments();
-        if (!callbackArg)
-            continue;
-        if (!callbackArg.isKind(SyntaxKind.ArrowFunction) && !callbackArg.isKind(SyntaxKind.FunctionExpression))
-            continue;
-        const returnedJsxTag = getReturnedJsxTagName(callbackArg);
-        if (!returnedJsxTag || returnedJsxTag === ownComponentName || !componentNames.has(returnedJsxTag))
-            continue;
-        if ((renderCountByComponent.get(returnedJsxTag) ?? 0) !== 1)
-            continue;
-        found.add(returnedJsxTag);
-    }
-    return [...found].sort();
-}

package/dist/src/extract/helpers/evidence/ast/detect-react-node-types.d.ts

@@ -1,2 +0,0 @@
-export declare function isArrayReactNodeType(typeText: string): boolean;
-export declare function isReactNodeType(typeText: string): boolean;

package/dist/src/extract/helpers/evidence/ast/detect-react-node-types.js

@@ -1,24 +0,0 @@
-const REACT_NODE_EXACT_PATTERNS = ['ReactNode', 'React.ReactNode', 'ReactElement', 'React.ReactElement', 'JSX.Element'];
-function normalizeReactNodeType(typeText) {
-    return typeText
-        .replace(/\s+/g, ' ')
-        .trim()
-        .split('|')
-        .map((part) => part.trim())
-        .filter((part) => part !== 'null' && part !== 'undefined')
-        .join(' | ');
-}
-export function isArrayReactNodeType(typeText) {
-    const stripped = normalizeReactNodeType(typeText);
-    for (const pattern of REACT_NODE_EXACT_PATTERNS) {
-        if (stripped === `${pattern}[]` || stripped === `Array<${pattern}>`)
-            return true;
-    }
-    return false;
-}
-export function isReactNodeType(typeText) {
-    const stripped = normalizeReactNodeType(typeText);
-    if (REACT_NODE_EXACT_PATTERNS.includes(stripped))
-        return true;
-    return isArrayReactNodeType(typeText);
-}

package/dist/src/extract/helpers/evidence/ast/get-jsx-ast-data.d.ts

@@ -1,14 +0,0 @@
-import { Node, type ArrowFunction, type FunctionExpression, type SourceFile } from 'ts-morph';
-/** Collects all names bound in the file via imports or top-level declarations. */
-export declare function collectLocallyBoundNames(sourceFile: SourceFile): Set<string>;
-/**
- * Returns the tag identifier of the JSX element a callback returns, or
- * `undefined` if the callback doesn't return exactly one identifier-tagged JSX element.
- */
-export declare function getReturnedJsxTagName(callback: ArrowFunction | FunctionExpression): string | undefined;
-/** Unwraps a JSX node from an expression body, block body return, or parenthesized expression. */
-export declare function unwrapReturnedJsx(bodyOrExpr: Node): Node | undefined;
-/** Returns the single JSX child of a fragment, or undefined if the fragment has 0 or 2+ children. */
-export declare function unwrapSingleJsxChildOfFragment(fragment: Node): Node | undefined;
-/** Returns true when the type text refers to a React JSX-carrying type (ReactNode, ReactElement, JSX.Element). */
-export declare function isJsxCarryingTypeText(typeText: string): boolean;

package/dist/src/extract/helpers/evidence/ast/get-jsx-ast-data.js

@@ -1,85 +0,0 @@
-import { Node } from 'ts-morph';
-/** Collects all names bound in the file via imports or top-level declarations. */
-export function collectLocallyBoundNames(sourceFile) {
-    const names = new Set();
-    for (const imp of sourceFile.getImportDeclarations()) {
-        const defaultImport = imp.getDefaultImport();
-        if (defaultImport)
-            names.add(defaultImport.getText());
-        const namespaceImport = imp.getNamespaceImport();
-        if (namespaceImport)
-            names.add(namespaceImport.getText());
-        for (const named of imp.getNamedImports()) {
-            names.add((named.getAliasNode() ?? named.getNameNode()).getText());
-        }
-    }
-    for (const decl of sourceFile.getVariableDeclarations())
-        names.add(decl.getName());
-    for (const decl of sourceFile.getFunctions()) {
-        const declName = decl.getName();
-        if (declName)
-            names.add(declName);
-    }
-    return names;
-}
-/**
- * Returns the tag identifier of the JSX element a callback returns, or
- * `undefined` if the callback doesn't return exactly one identifier-tagged JSX element.
- */
-export function getReturnedJsxTagName(callback) {
-    const body = callback.getBody();
-    const jsxNode = unwrapReturnedJsx(body);
-    if (!jsxNode)
-        return undefined;
-    if (Node.isJsxSelfClosingElement(jsxNode) || Node.isJsxOpeningElement(jsxNode)) {
-        return jsxNode.getTagNameNode().getText();
-    }
-    if (Node.isJsxElement(jsxNode)) {
-        return jsxNode.getOpeningElement().getTagNameNode().getText();
-    }
-    return undefined;
-}
-/** Unwraps a JSX node from an expression body, block body return, or parenthesized expression. */
-export function unwrapReturnedJsx(bodyOrExpr) {
-    if (Node.isJsxElement(bodyOrExpr) ||
-        Node.isJsxSelfClosingElement(bodyOrExpr) ||
-        Node.isJsxOpeningElement(bodyOrExpr)) {
-        return bodyOrExpr;
-    }
-    if (Node.isJsxFragment(bodyOrExpr)) {
-        return unwrapSingleJsxChildOfFragment(bodyOrExpr);
-    }
-    if (Node.isParenthesizedExpression(bodyOrExpr)) {
-        return unwrapReturnedJsx(bodyOrExpr.getExpression());
-    }
-    if (Node.isBlock(bodyOrExpr)) {
-        const returns = bodyOrExpr.getStatements().filter(Node.isReturnStatement);
-        if (returns.length !== 1)
-            return undefined;
-        const expr = returns[0].getExpression();
-        if (!expr)
-            return undefined;
-        return unwrapReturnedJsx(expr);
-    }
-    return undefined;
-}
-/** Returns the single JSX child of a fragment, or undefined if the fragment has 0 or 2+ children. */
-export function unwrapSingleJsxChildOfFragment(fragment) {
-    if (!Node.isJsxFragment(fragment))
-        return undefined;
-    const jsxChildren = fragment
-        .getJsxChildren()
-        .filter((child) => Node.isJsxElement(child) || Node.isJsxSelfClosingElement(child));
-    if (jsxChildren.length !== 1)
-        return undefined;
-    return jsxChildren[0];
-}
-const JSX_CARRYING_TYPE_TOKENS = ['ReactNode', 'ReactElement', 'JSX.Element'];
-/** Returns true when the type text refers to a React JSX-carrying type (ReactNode, ReactElement, JSX.Element). */
-export function isJsxCarryingTypeText(typeText) {
-    for (const token of JSX_CARRYING_TYPE_TOKENS) {
-        if (typeText.includes(token))
-            return true;
-    }
-    return false;
-}

package/dist/src/extract/helpers/evidence/collect-jsx-component-references.d.ts

@@ -1,5 +0,0 @@
-import { type SourceFile } from 'ts-morph';
-import { type AllowedComponentsContext } from './collect-allowed-component-names.js';
-export { collectRenderedComponentReferences, collectArrayMapRenderComponentReferences, } from './ast/collect-structural-jsx-evidence.js';
-export declare function collectTypePredicateComponentReferences(sourceFile: SourceFile, ctx: AllowedComponentsContext): string[];
-export declare function collectRuntimeTypeCheckComponentReferences(sourceFile: SourceFile, componentNames: ReadonlySet<string>): string[];

package/dist/src/extract/helpers/evidence/collect-jsx-component-references.js

@@ -1,52 +0,0 @@
-import { Node, SyntaxKind, } from 'ts-morph';
-import { extractAllowedComponentsFromTypeText, } from './collect-allowed-component-names.js';
-import { collectLocallyBoundNames } from './ast/get-jsx-ast-data.js';
-export { collectRenderedComponentReferences, collectArrayMapRenderComponentReferences, } from './ast/collect-structural-jsx-evidence.js';
-export function collectTypePredicateComponentReferences(sourceFile, ctx) {
-    const found = new Set();
-    const candidates = [
-        ...sourceFile.getDescendantsOfKind(SyntaxKind.FunctionDeclaration),
-        ...sourceFile.getDescendantsOfKind(SyntaxKind.ArrowFunction),
-        ...sourceFile.getDescendantsOfKind(SyntaxKind.FunctionExpression),
-    ];
-    for (const fn of candidates) {
-        const returnTypeNode = fn.getReturnTypeNode();
-        if (!returnTypeNode || !Node.isTypePredicate(returnTypeNode))
-            continue;
-        const assertedTypeNode = returnTypeNode.getTypeNode();
-        if (!assertedTypeNode)
-            continue;
-        for (const name of extractAllowedComponentsFromTypeText(assertedTypeNode.getText(), ctx)) {
-            found.add(name);
-        }
-    }
-    return [...found].sort();
-}
-export function collectRuntimeTypeCheckComponentReferences(sourceFile, componentNames) {
-    const found = new Set();
-    const localBindings = collectLocallyBoundNames(sourceFile);
-    for (const binary of sourceFile.getDescendantsOfKind(SyntaxKind.BinaryExpression)) {
-        const operator = binary.getOperatorToken().getText();
-        if (operator !== '===' && operator !== '==')
-            continue;
-        const left = binary.getLeft();
-        const right = binary.getRight();
-        const candidateFromTypeAccess = (typeAccessSide, otherSide) => {
-            if (!Node.isPropertyAccessExpression(typeAccessSide) || typeAccessSide.getName() !== 'type')
-                return undefined;
-            if (!Node.isIdentifier(otherSide) && !Node.isPropertyAccessExpression(otherSide))
-                return undefined;
-            const name = otherSide.getText().split('.').pop();
-            if (!name || !componentNames.has(name))
-                return undefined;
-            const baseIdentifier = Node.isPropertyAccessExpression(otherSide) ? otherSide.getExpression() : otherSide;
-            if (!Node.isIdentifier(baseIdentifier) || !localBindings.has(baseIdentifier.getText()))
-                return undefined;
-            return name;
-        };
-        const match = candidateFromTypeAccess(left, right) ?? candidateFromTypeAccess(right, left);
-        if (match)
-            found.add(match);
-    }
-    return [...found].sort();
-}

package/dist/src/extract/helpers/evidence/detect-slot-from-prop.d.ts

@@ -1,16 +0,0 @@
-export { isReactNodeType, isArrayReactNodeType } from './ast/detect-react-node-types.js';
-/**
- * Prop names that should remain as props even when typed as ReactNode.
- * These are typically text-content names, not composable slots.
- */
-export declare const CONTENT_NAME_EXCEPTIONS: Set<string>;
-/**
- * Determines whether a prop should be converted to a slot based on its name and type.
- *
- * Rules:
- * 1. If the type is not a ReactNode type → false
- * 2. If the type is an array ReactNode → true (overrides exception list)
- * 3. If the name is in the content-name exception list → false
- * 4. Otherwise → true
- */
-export declare function shouldBeSlot(propName: string, typeText: string): boolean;

package/dist/src/extract/helpers/evidence/detect-slot-from-prop.js

@@ -1,39 +0,0 @@
-export { isReactNodeType, isArrayReactNodeType } from './ast/detect-react-node-types.js';
-import { isReactNodeType, isArrayReactNodeType } from './ast/detect-react-node-types.js';
-/**
- * Prop names that should remain as props even when typed as ReactNode.
- * These are typically text-content names, not composable slots.
- */
-export const CONTENT_NAME_EXCEPTIONS = new Set([
-    'label',
-    'title',
-    'description',
-    'text',
-    'caption',
-    'message',
-    'placeholder',
-    'tooltip',
-    'heading',
-    'subheading',
-    'body',
-    'summary',
-    'excerpt',
-]);
-/**
- * Determines whether a prop should be converted to a slot based on its name and type.
- *
- * Rules:
- * 1. If the type is not a ReactNode type → false
- * 2. If the type is an array ReactNode → true (overrides exception list)
- * 3. If the name is in the content-name exception list → false
- * 4. Otherwise → true
- */
-export function shouldBeSlot(propName, typeText) {
-    if (!isReactNodeType(typeText))
-        return false;
-    if (isArrayReactNodeType(typeText))
-        return true;
-    if (CONTENT_NAME_EXCEPTIONS.has(propName))
-        return false;
-    return true;
-}

package/dist/src/extract/orchestrator/execute-extraction-orchestrator.d.ts

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