@sudosandwich/limps-headless 0.1.3

package/dist/analyzer/props.js

@@ -0,0 +1,235 @@
+/**
+ * Props extraction from local component files.
+ * Handles various prop patterns: interfaces, inline props, FC generics, ForwardRef.
+ */
+import { extractPropsFromInterface } from '../extractor/props.js';
+import { findForwardRefDeclarations, extractPropsFromForwardRef, } from '../extractor/forward-ref.js';
+import { classifyProp } from '../extractor/classifier.js';
+import { filterReactInternals } from '../extractor/type-resolver.js';
+/**
+ * Extract props from a component file.
+ * Tries multiple patterns:
+ * 1. Named Props interface (e.g., ModalProps)
+ * 2. Inline props in function parameters
+ * 3. FC generic (const Modal: FC<ModalProps>)
+ * 4. ForwardRefExoticComponent
+ */
+export function extractProps(sourceFile, componentName) {
+    const propsMap = new Map();
+    // Try to find named Props interface first
+    const propsInterface = findPropsInterface(sourceFile, componentName);
+    if (propsInterface) {
+        const rawProps = extractPropsFromInterface(propsInterface);
+        for (const rawProp of rawProps) {
+            const classified = classifyProp(rawProp);
+            propsMap.set(classified.name, classified);
+        }
+        return propsMap;
+    }
+    // Try ForwardRef declarations
+    const forwardRefDecls = findForwardRefDeclarations(sourceFile);
+    if (forwardRefDecls.length > 0) {
+        for (const decl of forwardRefDecls) {
+            if (componentName && decl.name !== componentName)
+                continue;
+            const rawProps = extractPropsFromForwardRef(sourceFile, decl);
+            if (rawProps) {
+                const filtered = filterReactInternals(rawProps);
+                for (const rawProp of filtered) {
+                    const classified = classifyProp(rawProp);
+                    propsMap.set(classified.name, classified);
+                }
+                return propsMap;
+            }
+        }
+    }
+    // Try function component with inline props
+    const funcDecl = findFunctionComponent(sourceFile, componentName);
+    if (funcDecl) {
+        const rawProps = extractPropsFromFunction(funcDecl);
+        for (const rawProp of rawProps) {
+            const classified = classifyProp(rawProp);
+            propsMap.set(classified.name, classified);
+        }
+        return propsMap;
+    }
+    // Try FC generic pattern
+    const fcDecl = findFCComponent(sourceFile, componentName);
+    if (fcDecl) {
+        const rawProps = extractPropsFromFC(fcDecl, sourceFile);
+        for (const rawProp of rawProps) {
+            const classified = classifyProp(rawProp);
+            propsMap.set(classified.name, classified);
+        }
+        return propsMap;
+    }
+    return propsMap;
+}
+/**
+ * Find a Props interface (e.g., ModalProps, DialogProps).
+ */
+function findPropsInterface(sourceFile, componentName) {
+    const interfaces = sourceFile.getInterfaces();
+    // If component name provided, look for ComponentNameProps
+    if (componentName) {
+        const propsName = `${componentName}Props`;
+        const iface = sourceFile.getInterface(propsName);
+        if (iface)
+            return iface;
+    }
+    // Look for any interface ending in "Props"
+    for (const iface of interfaces) {
+        if (iface.getName().endsWith('Props')) {
+            return iface;
+        }
+    }
+    return null;
+}
+/**
+ * Find a function component declaration.
+ */
+function findFunctionComponent(sourceFile, componentName) {
+    const functions = sourceFile.getFunctions();
+    if (componentName) {
+        const func = sourceFile.getFunction(componentName);
+        if (func)
+            return func;
+    }
+    // Look for exported function (common pattern)
+    for (const func of functions) {
+        if (func.isExported()) {
+            return func;
+        }
+    }
+    return null;
+}
+/**
+ * Extract props from a function component with inline props.
+ * Handles: function Modal({ open, onOpenChange }: { open: boolean; ... }) { ... }
+ */
+function extractPropsFromFunction(func) {
+    const params = func.getParameters();
+    if (params.length === 0)
+        return [];
+    // First parameter is usually the props
+    const propsParam = params[0];
+    const typeNode = propsParam.getTypeNode();
+    if (!typeNode) {
+        // Try to infer from type
+        const type = propsParam.getType();
+        return extractPropsFromType(type);
+    }
+    // Extract from type node
+    return extractPropsFromTypeNode(typeNode);
+}
+/**
+ * Extract props from a TypeNode (inline type literal).
+ */
+function extractPropsFromTypeNode(typeNode) {
+    const props = [];
+    const type = typeNode.getType();
+    // Get properties from the type
+    for (const prop of type.getProperties()) {
+        const name = prop.getName();
+        const declarations = prop.getDeclarations();
+        const propDecl = declarations[0];
+        if (!propDecl)
+            continue;
+        const propType = prop.getTypeAtLocation(propDecl);
+        const typeText = propType.getText();
+        // Check if optional
+        const isOptional = propDecl.getKindName() === 'PropertySignature'
+            ? propDecl
+                .hasQuestionToken?.() ?? false
+            : typeText.includes('undefined');
+        props.push({
+            name,
+            type: simplifyTypeText(typeText),
+            required: !isOptional,
+        });
+    }
+    return props;
+}
+/**
+ * Extract props from a Type (from type checker).
+ */
+function extractPropsFromType(type) {
+    const props = [];
+    for (const prop of type.getProperties()) {
+        const name = prop.getName();
+        const declarations = prop.getDeclarations();
+        const propDecl = declarations[0];
+        if (!propDecl)
+            continue;
+        const propType = prop.getTypeAtLocation(propDecl);
+        const typeText = propType.getText();
+        // Check if optional (union with undefined)
+        const isOptional = typeText.includes('undefined');
+        props.push({
+            name,
+            type: simplifyTypeText(typeText),
+            required: !isOptional,
+        });
+    }
+    return props;
+}
+/**
+ * Find a React.FC component declaration.
+ * Handles: const Modal: FC<ModalProps> = ...
+ */
+function findFCComponent(sourceFile, componentName) {
+    for (const statement of sourceFile.getVariableStatements()) {
+        for (const decl of statement.getDeclarations()) {
+            const name = decl.getName();
+            if (componentName && name !== componentName)
+                continue;
+            const typeNode = decl.getTypeNode();
+            if (!typeNode)
+                continue;
+            const typeText = typeNode.getText();
+            if (typeText.includes('FC<') || typeText.includes('React.FC<')) {
+                return decl;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract props from a React.FC declaration.
+ */
+function extractPropsFromFC(decl, sourceFile) {
+    const typeNode = decl.getTypeNode();
+    if (!typeNode)
+        return [];
+    const type = typeNode.getType();
+    const typeArgs = type.getTypeArguments();
+    if (typeArgs.length === 0)
+        return [];
+    // First type argument is the props type
+    const propsType = typeArgs[0];
+    // Try to get the interface name
+    const typeText = typeNode.getText();
+    const match = typeText.match(/(?:React\.)?FC<(\w+)>/);
+    if (match) {
+        const propsTypeName = match[1];
+        const propsInterface = sourceFile.getInterface(propsTypeName);
+        if (propsInterface) {
+            return extractPropsFromInterface(propsInterface);
+        }
+    }
+    // Fallback: extract from type directly
+    return extractPropsFromType(propsType);
+}
+/**
+ * Simplify complex type text for readability.
+ */
+function simplifyTypeText(text) {
+    return text
+        .replace(/React\.ReactNode/g, 'ReactNode')
+        .replace(/React\.ReactElement/g, 'ReactElement')
+        .replace(/React\.CSSProperties/g, 'CSSProperties')
+        .replace(/React\.HTMLAttributes<.*?>/g, 'HTMLAttributes')
+        .replace(/React\.ComponentPropsWithoutRef<.*?>/g, 'ComponentProps')
+        .replace(/import\(".*?"\)\./g, '');
+}
+//# sourceMappingURL=props.js.map

package/dist/analyzer/props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../../src/analyzer/props.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/rules/checkbox-switch-toggle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Disambiguation rule for Checkbox vs Switch vs Toggle.
+ */
+import type { ComponentAnalysis } from '../../types/index.js';
+/**
+ * Disambiguate between Checkbox, Switch, and Toggle.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export declare function disambiguateCheckboxSwitchToggle(analysis: ComponentAnalysis): 'Checkbox' | 'Switch' | 'Toggle' | null;
+//# sourceMappingURL=checkbox-switch-toggle.d.ts.map

package/dist/analyzer/rules/checkbox-switch-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-switch-toggle.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/checkbox-switch-toggle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,iBAAiB,GAC1B,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAqBzC"}

package/dist/analyzer/rules/checkbox-switch-toggle.js

@@ -0,0 +1,26 @@
+/**
+ * Disambiguation rule for Checkbox vs Switch vs Toggle.
+ */
+/**
+ * Disambiguate between Checkbox, Switch, and Toggle.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export function disambiguateCheckboxSwitchToggle(analysis) {
+    const props = analysis.propsInterface;
+    const subComponents = analysis.subComponents;
+    // Switch: has Thumb sub-component (distinctive)
+    if (subComponents.includes('Thumb')) {
+        return 'Switch';
+    }
+    // Toggle: has pressed state (distinctive)
+    if (props.has('pressed') || props.has('defaultPressed')) {
+        return 'Toggle';
+    }
+    // Checkbox: has checked state (but not pressed)
+    if (props.has('checked') || props.has('defaultChecked')) {
+        return 'Checkbox';
+    }
+    // Cannot disambiguate
+    return null;
+}
+//# sourceMappingURL=checkbox-switch-toggle.js.map

package/dist/analyzer/rules/checkbox-switch-toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-switch-toggle.js","sourceRoot":"","sources":["../../../src/analyzer/rules/checkbox-switch-toggle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC;IACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;IAE7C,gDAAgD;IAChD,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0CAA0C;IAC1C,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gDAAgD;IAChD,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sBAAsB;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/rules/dialog-popover.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Disambiguation rule for Dialog vs Popover.
+ */
+import type { ComponentAnalysis } from '../../types/index.js';
+/**
+ * Disambiguate between Dialog and Popover.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export declare function disambiguateDialogPopover(analysis: ComponentAnalysis): 'Dialog' | 'Popover' | null;
+//# sourceMappingURL=dialog-popover.d.ts.map

package/dist/analyzer/rules/dialog-popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-popover.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/dialog-popover.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAC1B,QAAQ,GAAG,SAAS,GAAG,IAAI,CAoB7B"}

package/dist/analyzer/rules/dialog-popover.js

@@ -0,0 +1,25 @@
+/**
+ * Disambiguation rule for Dialog vs Popover.
+ */
+/**
+ * Disambiguate between Dialog and Popover.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export function disambiguateDialogPopover(analysis) {
+    const props = analysis.propsInterface;
+    // Dialog: has modal prop
+    if (props.has('modal')) {
+        return 'Dialog';
+    }
+    // Dialog: has Overlay sub-component
+    if (analysis.subComponents.includes('Overlay')) {
+        return 'Dialog';
+    }
+    // Popover: has side or align props (positioning props)
+    if (props.has('side') || props.has('align')) {
+        return 'Popover';
+    }
+    // Cannot disambiguate
+    return null;
+}
+//# sourceMappingURL=dialog-popover.js.map

package/dist/analyzer/rules/dialog-popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-popover.js","sourceRoot":"","sources":["../../../src/analyzer/rules/dialog-popover.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC;IAEtC,yBAAyB;IACzB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,oCAAoC;IACpC,IAAI,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uDAAuD;IACvD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,sBAAsB;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/rules/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Disambiguation rules registry.
+ */
+import type { ComponentAnalysis } from '../../types/index.js';
+/**
+ * Disambiguation rule function type.
+ */
+export type DisambiguationRule = (analysis: ComponentAnalysis) => string | null;
+/**
+ * Disambiguation rules map.
+ * Key: pair of primitives (sorted alphabetically, joined with '-')
+ * Value: disambiguation function
+ */
+export declare const DISAMBIGUATION_RULES: Map<string, DisambiguationRule>;
+/**
+ * Get disambiguation rule for a pair of primitives.
+ */
+export declare function getDisambiguationRule(primitive1: string, primitive2: string): DisambiguationRule | null;
+/**
+ * Get disambiguation rule for multiple primitives.
+ * Also checks if the provided primitives are a subset of any registered rule.
+ */
+export declare function getDisambiguationRuleForGroup(primitives: string[]): DisambiguationRule | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzer/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,iBAAiB,KACxB,MAAM,GAAG,IAAI,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iCAI/B,CAAC;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,IAAI,CAM3B;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAAE,GACnB,kBAAkB,GAAG,IAAI,CAuB3B"}

package/dist/analyzer/rules/index.js

@@ -0,0 +1,51 @@
+/**
+ * Disambiguation rules registry.
+ */
+import { disambiguateDialogPopover } from './dialog-popover.js';
+import { disambiguateTooltipHoverCard } from './tooltip-hovercard.js';
+import { disambiguateCheckboxSwitchToggle } from './checkbox-switch-toggle.js';
+/**
+ * Disambiguation rules map.
+ * Key: pair of primitives (sorted alphabetically, joined with '-')
+ * Value: disambiguation function
+ */
+export const DISAMBIGUATION_RULES = new Map([
+    ['Dialog-Popover', disambiguateDialogPopover],
+    ['HoverCard-Tooltip', disambiguateTooltipHoverCard],
+    ['Checkbox-Switch-Toggle', disambiguateCheckboxSwitchToggle],
+]);
+/**
+ * Get disambiguation rule for a pair of primitives.
+ */
+export function getDisambiguationRule(primitive1, primitive2) {
+    // Sort primitives alphabetically for consistent key lookup
+    const sorted = [primitive1, primitive2].sort();
+    const key = sorted.join('-');
+    return DISAMBIGUATION_RULES.get(key) || null;
+}
+/**
+ * Get disambiguation rule for multiple primitives.
+ * Also checks if the provided primitives are a subset of any registered rule.
+ */
+export function getDisambiguationRuleForGroup(primitives) {
+    // Sort primitives alphabetically for consistent key lookup
+    const sorted = [...primitives].sort();
+    const key = sorted.join('-');
+    // Try exact match first
+    const exactMatch = DISAMBIGUATION_RULES.get(key);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // Try to find a rule where the provided primitives are a subset
+    // e.g., ['Checkbox', 'Switch'] should match 'Checkbox-Switch-Toggle'
+    for (const [ruleKey, rule] of DISAMBIGUATION_RULES.entries()) {
+        const rulePrimitives = ruleKey.split('-');
+        // Check if all provided primitives are in the rule
+        const allMatch = sorted.every((p) => rulePrimitives.includes(p));
+        if (allMatch && sorted.length >= 2) {
+            return rule;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzer/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAS/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAA6B;IACtE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IAC7C,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;IACnD,CAAC,wBAAwB,EAAE,gCAAgC,CAAC;CAC7D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,UAAkB;IAElB,2DAA2D;IAC3D,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7B,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAoB;IAEpB,2DAA2D;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7B,wBAAwB;IACxB,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,gEAAgE;IAChE,qEAAqE;IACrE,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/rules/tooltip-hovercard.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Disambiguation rule for Tooltip vs HoverCard.
+ */
+import type { ComponentAnalysis } from '../../types/index.js';
+/**
+ * Disambiguate between Tooltip and HoverCard.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export declare function disambiguateTooltipHoverCard(analysis: ComponentAnalysis): 'Tooltip' | 'HoverCard' | null;
+//# sourceMappingURL=tooltip-hovercard.d.ts.map

package/dist/analyzer/rules/tooltip-hovercard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-hovercard.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/tooltip-hovercard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,GAC1B,SAAS,GAAG,WAAW,GAAG,IAAI,CAehC"}

package/dist/analyzer/rules/tooltip-hovercard.js

@@ -0,0 +1,21 @@
+/**
+ * Disambiguation rule for Tooltip vs HoverCard.
+ */
+/**
+ * Disambiguate between Tooltip and HoverCard.
+ * Returns the preferred primitive or null if cannot disambiguate.
+ */
+export function disambiguateTooltipHoverCard(analysis) {
+    const props = analysis.propsInterface;
+    // Tooltip: has delayDuration prop (common naming)
+    if (props.has('delayDuration')) {
+        return 'Tooltip';
+    }
+    // HoverCard: has openDelay prop (common naming)
+    if (props.has('openDelay')) {
+        return 'HoverCard';
+    }
+    // Cannot disambiguate
+    return null;
+}
+//# sourceMappingURL=tooltip-hovercard.js.map

package/dist/analyzer/rules/tooltip-hovercard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-hovercard.js","sourceRoot":"","sources":["../../../src/analyzer/rules/tooltip-hovercard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC;IAEtC,kDAAkD;IAClD,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,sBAAsB;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/scorer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Confidence scoring for component analysis.
+ * Scores components against Radix signatures using weighted dimensions.
+ */
+import type { ComponentAnalysis, PrimitiveMatch, BehaviorSignature } from '../types/index.js';
+import { type ScoringWeights } from './weights.js';
+/**
+ * Score a component analysis against a Radix signature.
+ * Returns a PrimitiveMatch with confidence score and breakdown.
+ */
+export declare function scoreAgainstSignatures(analysis: ComponentAnalysis, signatures: BehaviorSignature[], weights?: Partial<ScoringWeights>): PrimitiveMatch[];
+//# sourceMappingURL=scorer.d.ts.map

package/dist/analyzer/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/analyzer/scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,cAAc,EAAE,CAalB"}

package/dist/analyzer/scorer.js

@@ -0,0 +1,171 @@
+/**
+ * Confidence scoring for component analysis.
+ * Scores components against Radix signatures using weighted dimensions.
+ */
+import { getScoringWeights } from './weights.js';
+/**
+ * Score a component analysis against a Radix signature.
+ * Returns a PrimitiveMatch with confidence score and breakdown.
+ */
+export function scoreAgainstSignatures(analysis, signatures, weights) {
+    const scoringWeights = getScoringWeights(weights);
+    const matches = [];
+    for (const signature of signatures) {
+        const match = scoreComponent(analysis, signature, scoringWeights);
+        matches.push(match);
+    }
+    // Sort by confidence (descending)
+    matches.sort((a, b) => b.confidence - a.confidence);
+    return matches;
+}
+/**
+ * Score a single component against a signature.
+ */
+function scoreComponent(analysis, signature, weights) {
+    const breakdown = {
+        statePatternScore: scoreStatePattern(analysis.inferredStatePattern, signature.statePattern, weights.statePattern),
+        compositionScore: scoreComposition(analysis.inferredCompositionPattern, signature.compositionPattern, weights.composition),
+        propsSignatureScore: scorePropsSignature(analysis.propsInterface, signature, weights.propsSignature),
+        accessibilityScore: scoreAccessibility(analysis.ariaRoles, analysis.dataAttributes, signature, weights.accessibility),
+        renderingScore: scoreRendering(analysis.inferredRenderingPattern, signature.renderingPattern, weights.rendering),
+    };
+    // Calculate total confidence
+    let confidence = breakdown.statePatternScore +
+        breakdown.compositionScore +
+        breakdown.propsSignatureScore +
+        breakdown.accessibilityScore +
+        breakdown.renderingScore;
+    // Apply anti-pattern penalty
+    const antiPatternPenalty = calculateAntiPatternPenalty(analysis.propsInterface, signature.antiPatternProps);
+    confidence = Math.max(0, confidence - antiPatternPenalty);
+    // Collect signals
+    const signals = collectSignals(analysis, signature);
+    return {
+        primitive: signature.primitive,
+        package: signature.package,
+        confidence: Math.round(confidence),
+        breakdown,
+        signals,
+    };
+}
+/**
+ * Score state pattern match (0 to maxScore).
+ */
+function scoreStatePattern(inferred, expected, maxScore) {
+    if (inferred === expected) {
+        return maxScore;
+    }
+    return 0;
+}
+/**
+ * Score composition pattern match (0 to maxScore).
+ */
+function scoreComposition(inferred, expected, maxScore) {
+    if (inferred === expected) {
+        return maxScore;
+    }
+    return 0;
+}
+/**
+ * Score props signature match (0 to maxScore).
+ * Checks for distinguishing props and gives partial credit.
+ */
+function scorePropsSignature(props, signature, maxScore) {
+    const distinguishingProps = signature.distinguishingProps;
+    if (distinguishingProps.length === 0) {
+        // No distinguishing props to check, return neutral score
+        return 0;
+    }
+    let matchedCount = 0;
+    for (const propName of distinguishingProps) {
+        if (props.has(propName)) {
+            matchedCount++;
+        }
+    }
+    // Proportional score based on how many distinguishing props match
+    return Math.round((matchedCount / distinguishingProps.length) * maxScore);
+}
+/**
+ * Score accessibility features (0 to maxScore).
+ * Checks for aria roles and data attributes that match expected patterns.
+ */
+function scoreAccessibility(ariaRoles, dataAttributes, _signature, maxScore) {
+    // Basic scoring: if component has accessibility features, give partial credit
+    // More sophisticated scoring could check for specific roles/attributes
+    if (ariaRoles.length > 0 || dataAttributes.length > 0) {
+        // Give partial credit for having accessibility features
+        return Math.round(maxScore * 0.5);
+    }
+    return 0;
+}
+/**
+ * Score rendering pattern match (0 to maxScore).
+ */
+function scoreRendering(inferred, expected, maxScore) {
+    if (inferred === expected) {
+        return maxScore;
+    }
+    return 0;
+}
+/**
+ * Calculate anti-pattern penalty.
+ * Returns penalty points to subtract from total score.
+ */
+function calculateAntiPatternPenalty(props, antiPatternProps) {
+    let penalty = 0;
+    for (const antiProp of antiPatternProps) {
+        if (props.has(antiProp)) {
+            // Each anti-pattern prop reduces score by 10 points
+            penalty += 10;
+        }
+    }
+    return penalty;
+}
+/**
+ * Collect signals (matched, missing, anti-patterns) for debugging.
+ */
+function collectSignals(analysis, signature) {
+    const matched = [];
+    const missing = [];
+    const antiPatterns = [];
+    // Check distinguishing props
+    for (const propName of signature.distinguishingProps) {
+        if (analysis.propsInterface.has(propName)) {
+            matched.push(`prop:${propName}`);
+        }
+        else {
+            missing.push(`prop:${propName}`);
+        }
+    }
+    // Check patterns
+    if (analysis.inferredStatePattern === signature.statePattern) {
+        matched.push(`state:${signature.statePattern}`);
+    }
+    else {
+        missing.push(`state:${signature.statePattern}`);
+    }
+    if (analysis.inferredCompositionPattern === signature.compositionPattern) {
+        matched.push(`composition:${signature.compositionPattern}`);
+    }
+    else {
+        missing.push(`composition:${signature.compositionPattern}`);
+    }
+    if (analysis.inferredRenderingPattern === signature.renderingPattern) {
+        matched.push(`rendering:${signature.renderingPattern}`);
+    }
+    else {
+        missing.push(`rendering:${signature.renderingPattern}`);
+    }
+    // Check anti-patterns
+    for (const antiProp of signature.antiPatternProps) {
+        if (analysis.propsInterface.has(antiProp)) {
+            antiPatterns.push(antiProp);
+        }
+    }
+    return {
+        matched,
+        missing,
+        antiPatterns,
+    };
+}
+//# sourceMappingURL=scorer.js.map