tailwind-typescript-plugin 1.4.1-beta.3 → 1.4.1-beta.31

package/lib/extractors/VueAttributeExtractor.d.ts

@@ -0,0 +1,202 @@
+import * as ts from 'typescript/lib/tsserverlibrary';
+import { NodeFilterFn } from '../core/interfaces';
+import { ClassNameInfo, ExtractionContext, UtilityFunction } from '../core/types';
+import { BaseExtractor } from './BaseExtractor';
+/**
+ * Extracts class names from Vue template class attributes
+ *
+ * When @vue/language-tools (Volar) transforms Vue SFC templates, it generates
+ * TypeScript code using function calls with object spreads:
+ *
+ * ```typescript
+ * __VLS_asFunctionalElement(__VLS_intrinsicElements.div)({
+ *   ...{ class: "flex items-center" },
+ * });
+ * ```
+ *
+ * For dynamic classes:
+ * ```typescript
+ * __VLS_asFunctionalElement(__VLS_intrinsicElements.div)({
+ *   ...{ class: ({ 'bg-red-500': isActive }) },
+ * });
+ * ```
+ *
+ * This extractor handles these patterns to extract class names.
+ */
+export declare class VueAttributeExtractor extends BaseExtractor {
+    private expressionExtractor;
+    constructor();
+    /**
+     * Fast filter: Vue patterns are always CallExpression nodes (~95% node skip rate)
+     * Volar transforms templates into: __VLS_asFunctionalElement(...)({...})
+     */
+    getNodeFilter(): NodeFilterFn;
+    /**
+     * Override to handle Vue's __VLS_ctx pattern.
+     *
+     * Vue generates code like __VLS_ctx.clsx(...) for template expressions
+     * where clsx is imported in the script section. We need to check if the
+     * function name (not __VLS_ctx) is directly imported.
+     *
+     * Also handles namespace imports: __VLS_ctx.utils.clsx(...) for `import * as utils from 'clsx'`
+     */
+    protected shouldValidateFunctionCall(callExpression: ts.CallExpression, utilityFunctions: UtilityFunction[], context?: ExtractionContext): boolean;
+    canHandle(node: ts.Node, context: ExtractionContext): boolean;
+    private hasClassSpreadProperty;
+    /**
+     * Check if an object has direct class attribute properties (for custom components).
+     * Vue generates direct properties like: { colorStyles: "bg-blue-500" }
+     */
+    private hasClassDirectProperty;
+    extract(node: ts.Node, context: ExtractionContext): ClassNameInfo[];
+    private extractClassesFromValue;
+    /**
+     * Extract classes from an array expression, handling __VLS_ctx references.
+     * This method processes array elements directly to support variable references.
+     */
+    private extractFromArrayExpression;
+    /**
+     * Extract classes from an object expression, handling computed property names.
+     */
+    private extractFromObjectExpression;
+    /**
+     * Extract classes from a conditional (ternary) expression in array context.
+     */
+    private extractFromConditionalElement;
+    /**
+     * Extract classes from a conditional (ternary) expression.
+     * Handles: isActive ? 'flex' : 'hidden'
+     */
+    private extractFromConditionalExpression;
+    /**
+     * Extract classes from a binary expression.
+     * Handles: isActive && 'flex', isDisabled || 'fallback'
+     */
+    private extractFromBinaryExpression;
+    /**
+     * Extract classes from a branch expression (ternary branch or binary operand).
+     * Handles string literals, nested ternaries, nested binaries, and VLS references.
+     */
+    private extractFromBranchExpression;
+    /**
+     * Extract classes from CVA/TV function calls with class override.
+     * Handles patterns like: button({ color: 'primary', class: 'invalid-class' })
+     *
+     * Only extracts from functions that are defined using cva() or tv(),
+     * not from arbitrary custom functions.
+     */
+    private extractFromCvaTvClassOverride;
+    /**
+     * Check if a function is defined using cva() or tv().
+     * Resolves the function symbol and checks if its initializer is a cva/tv call.
+     */
+    private isCvaTvFunction;
+    /**
+     * Check if an expression is a call to cva() or tv().
+     */
+    private isCallToCvaOrTv;
+    /**
+     * Extract classes from a string literal with attributeId.
+     */
+    private extractClassesFromStringLiteral;
+    /**
+     * Extract classes from __VLS_ctx patterns by resolving variable/function references.
+     *
+     * Vue's generated code transforms template expressions in two ways:
+     * - :class="myClass" becomes class: (__VLS_ctx.myClass) - property access
+     * - :class="getClasses()" becomes class: (__VLS_ctx.getClasses()) - call expression
+     *
+     * The symbol resolves to a property assignment in Vue's generated code like:
+     * `return { myClass: myClass as typeof myClass }` or
+     * `return { getClasses: getClasses as typeof getClasses }`
+     * We need to follow the reference chain to find the actual declaration.
+     *
+     * IMPORTANT: We use the TEMPLATE position (the propertyName in __VLS_ctx.propertyName)
+     * for diagnostics because Volar only maps diagnostics from the template-generated section,
+     * not from the script section. Script section positions have valid mappings but Volar
+     * doesn't apply them for diagnostics.
+     */
+    private extractFromVlsCtxReference;
+    /**
+     * Extract classes from a PropertySignature by getting the type.
+     *
+     * In Volar 3.x, script variables are exposed via a type like:
+     * type __VLS_SetupExposed = { myClass: typeof myClass; }
+     *
+     * We prioritize finding the actual variable declaration to use original positions,
+     * so errors point to the actual class strings in the script section.
+     */
+    private extractFromPropertySignatureType;
+    /**
+     * Parse a class string into ClassNameInfo array.
+     * Uses the identifier position for diagnostics (mapped by Volar).
+     */
+    private parseClassString;
+    /**
+     * Extract classes from a __VLS_ctx.functionName() call by resolving the function.
+     */
+    private extractFromVlsCtxFunctionCall;
+    /**
+     * Extract classes from a function referenced via PropertySignature.
+     * In Volar 3.x: `type __VLS_SetupExposed = { getClasses: typeof getClasses; }`
+     */
+    private extractFromPropertySignatureFunction;
+    /**
+     * Extract classes from a TypeScript type (for union types, string literals, etc.)
+     */
+    private extractClassesFromType;
+    /**
+     * Resolve a function identifier to its declaration and extract classes from return statements.
+     */
+    private resolveFunctionIdentifier;
+    /**
+     * Resolve classes from a property assignment initializer.
+     * Handles patterns like `myClass as typeof myClass` or just `myClass`.
+     */
+    private resolvePropertyAssignmentClasses;
+    /**
+     * Resolve classes from an identifier by finding its declaration.
+     */
+    private resolveIdentifierClasses;
+    /**
+     * Extract classes from a computed() call expression.
+     * Handles: const classes = computed(() => ['flex', 'items-center'])
+     */
+    private extractFromComputedCall;
+    /**
+     * Extract classes from an inject() call with a default value.
+     * Handles: const classes = inject('key', 'flex items-center')
+     */
+    private extractFromInjectCall;
+    /**
+     * Extract classes from a function declaration's return statements.
+     * Handles: function getClasses() { return ['flex', 'items-center']; }
+     */
+    private extractFromFunctionDeclaration;
+    /**
+     * Extract classes from a function body (block or expression).
+     * Handles both arrow function expressions and function blocks.
+     */
+    private extractFromFunctionBody;
+    /**
+     * Extract classes from an expression (array, object, string, etc.)
+     * @param expr The expression to extract from
+     * @param context The extraction context
+     * @param attributeId Optional attribute ID for tracking
+     */
+    private extractFromExpression;
+    /**
+     * Extract classes from props.propertyName patterns with default values.
+     * Vue generates __VLS_defaults for withDefaults() calls.
+     *
+     * Generated code pattern:
+     * const __VLS_defaults = { buttonClass: 'flex items-center' };
+     * ...{ class: (props.buttonClass) }
+     */
+    private extractFromPropsWithDefaults;
+    /**
+     * Find a property value in __VLS_defaults object.
+     */
+    private findVlsDefaultsProperty;
+}
+//# sourceMappingURL=VueAttributeExtractor.d.ts.map

package/lib/extractors/VueAttributeExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VueAttributeExtractor.d.ts","sourceRoot":"","sources":["../../src/extractors/VueAttributeExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACvD,OAAO,CAAC,mBAAmB,CAAyB;;IAOpD;;;OAGG;IACH,aAAa,IAAI,YAAY;IAI7B;;;;;;;;OAQG;cACgB,0BAA0B,CAC5C,cAAc,EAAE,EAAE,CAAC,cAAc,EACjC,gBAAgB,EAAE,eAAe,EAAE,EACnC,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO;IA6DV,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO;IAyC7D,OAAO,CAAC,sBAAsB;IAyB9B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAiB9B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,aAAa,EAAE;IA+DnE,OAAO,CAAC,uBAAuB;IAsN/B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAqFlC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiEnC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAQrC;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IAmCxC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA0DnC;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IA0ErC;;;OAGG;IACH,OAAO,CAAC,eAAe;IA0EvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAkCvC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,0BAA0B;IAyQlC;;;;;;;;OAQG;IACH,OAAO,CAAC,gCAAgC;IAmJxC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA2ErC;;;OAGG;IACH,OAAO,CAAC,oCAAoC;IAkD5C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0CjC;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IA6BxC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2EhC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiD/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAoBtC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2C/B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAiL7B;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IA0CpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAuC/B"}