@qds.dev/tools 0.6.2 → 0.7.5

package/lib-types/utils/icons/ast/expressions.d.ts

@@ -1,50 +0,0 @@
-import type { Node } from "@oxc-project/types";
-import { type Extracted } from "./jsx";
-/**
- * Handles various expression types in asChild elements
- * @param expression - The expression to handle
- * @param source - Original source code
- * @returns Extracted type and props, or null if unsupported
- */
-export declare function handleExpression(expression: Node, source: string): Extracted | null;
-/**
- * Handles conditional expressions (ternary operator)
- * @param expr - Conditional expression
- * @param source - Original source code
- * @returns Extracted type and props
- */
-export declare function handleConditionalExpression(expr: Node, source: string): Extracted;
-/**
- * Handles logical expressions (&&, ||)
- * @param expr - Logical expression
- * @param source - Original source code
- * @returns Extracted type and props, or null if unsupported
- */
-export declare function handleLogicalExpression(expr: Node, source: string): Extracted | null;
-/**
- * Handles identifier expressions (variables)
- * @param expr - Identifier expression
- * @param source - Original source code
- * @returns Extracted type and props
- */
-export declare function handleIdentifierExpression(expr: Node, source: string): Extracted;
-/**
- * Handles call expressions (function calls)
- * @param expr - Call expression
- * @param source - Original source code
- * @returns Extracted type and props
- */
-export declare function handleCallExpression(expr: Node, source: string): Extracted;
-/**
- * Handles member expressions (object.property, object.method())
- * @param expr - Member expression
- * @param source - Original source code
- * @returns Extracted type and props
- */
-export declare function handleMemberExpression(expr: Node, source: string): Extracted;
-/**
- * Checks if an expression type is supported
- * @param expressionType - The expression type to check
- * @returns True if the expression type is supported
- */
-export declare function isSupportedExpressionType(expressionType: string): boolean;

package/lib-types/utils/icons/ast/expressions.unit.d.ts

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

package/lib-types/utils/icons/ast/jsx.d.ts

@@ -1,81 +0,0 @@
-import type { Expression, JSXAttribute, JSXAttributeItem, JSXElement, JSXExpressionContainer, JSXMemberExpression, JSXText, Node } from "@oxc-project/types";
-export interface Extracted {
-    type: string;
-    props: string;
-}
-/**
- * Type guard to check if a node is a JSX element
- * @param node - AST node to check
- * @returns True if node is a JSX element
- */
-export declare function isJSXElement(node: Node): node is JSXElement;
-/**
- * Type guard to check if a node is a JSX expression container
- * @param node - AST node to check
- * @returns True if node is a JSX expression container
- */
-export declare function isJSXExpressionContainer(node: Node): node is JSXExpressionContainer;
-/**
- * Type guard to check if a node is JSX text
- * @param node - AST node to check
- * @returns True if node is JSX text
- */
-export declare function isJSXText(node: Node): node is JSXText;
-/**
- * Extracts type and props from various node types in conditional expressions
- * @param node - AST node to extract from
- * @param source - Original source code
- * @returns Object containing extracted type and props
- */
-export declare function extractFromNode(node: Node, source: string): Extracted;
-/**
- * Extracts type and props from a JSX element
- * @param elem - JSX element to extract from
- * @param source - Original source code
- * @returns Object containing extracted type and props
- */
-export declare function extractFromElement(elem: JSXElement, source: string): Extracted;
-/**
- * Extracts the full name from a JSX member expression (e.g., Menu.Item)
- * @param memberExpr - JSX member expression node
- * @param source - Original source code
- * @returns The full member expression as a string
- */
-export declare function extractJSXMemberExpressionName(memberExpr: JSXMemberExpression, source: string): string;
-/**
- * Extracts props from JSX attributes into object literal string
- * @param attributes - Array of JSX attributes
- * @param source - Original source code
- * @returns Object literal string representation of props
- */
-export declare function extractProps(attributes: JSXAttributeItem[], source: string): string;
-/**
- * Extracts the value from a JSX attribute
- * @param attr - JSX attribute to extract value from
- * @param source - Original source code
- * @returns String representation of the attribute value
- */
-export declare function getAttributeValue(attr: JSXAttribute, source: string): string;
-/**
- * Gets line number from source position for better error messages
- * @param source - Original source code
- * @param position - Character position in source
- * @returns Line number (1-based)
- */
-export declare function getLineNumber(source: string, position: number): number;
-/**
- * Convert extractProps result (object string) to attribute array
- * @param propsObj - Props object string from extractProps (e.g., '{ "class": "text-red" }')
- * @returns Array of attribute strings (e.g., ['class="text-red"'])
- */
-export declare function propsObjectToAttributes(propsObj: string): string[];
-/**
- * Extract children from JSX element, converting title and description props to SVG elements
- * @param elem - JSX element
- * @param source - Original source code
- * @param titleProp - Title prop value if present
- * @param descriptionProp - Description prop value if present
- * @param handleExpression - Expression handler function
- * @returns Children JSX code or null
- */
-export declare function extractChildren(elem: JSXElement, source: string, titleProp: string | undefined, descriptionProp: string | undefined, handleExpression: (expr: Expression, source: string) => unknown): string | null;

package/lib-types/utils/icons/ast/jsx.unit.d.ts

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

package/lib-types/utils/icons/collections/loader.d.ts

@@ -1,38 +0,0 @@
-import type { IconifyJSON } from "@iconify/types";
-export type LazyCollections = Map<string, Promise<IconifyJSON>>;
-export type IconData = {
-    body: string;
-    viewBox: string;
-};
-export type LazyIconCache = Map<string, Promise<IconData | null>>;
-/**
- * Collection loader with lazy loading and caching
- */
-export declare class CollectionLoader {
-    private debug;
-    private lazyCollections;
-    private lazyIconCache;
-    private availableCollections;
-    private require;
-    constructor(debug: (message: string, ...data: unknown[]) => void);
-    /**
-     * Discover all available collections
-     */
-    discoverCollections(): void;
-    /**
-     * Get available collections
-     */
-    getAvailableCollections(): Set<string>;
-    /**
-     * Check if a collection is available
-     */
-    hasCollection(name: string): boolean;
-    /**
-     * Lazy load a collection
-     */
-    loadCollectionLazy(prefix: string): Promise<IconifyJSON>;
-    /**
-     * Lazy load icon data
-     */
-    loadIconDataLazy(prefix: string, name: string): Promise<IconData | null>;
-}

package/lib-types/utils/icons/import-resolver.d.ts

@@ -1,37 +0,0 @@
-import type { Program } from "@oxc-project/types";
-import type { PacksMap } from "../../vite/icons";
-/**
- * Map an imported name to a pack and collection name
- * @param importedName - The imported name from the import specifier
- * @param localAlias - The local alias for the import
- * @param aliasToPack - Map to store the alias to pack mapping
- * @param availableCollections - Set of available collection names
- * @param collectionNames - Map of alias to collection name
- * @param packs - Custom packs configuration
- * @param debug - Debug logging function
- * @param prefix - Debug prefix (e.g., "[MDX]")
- */
-export declare function mapImportToPack(importedName: string, localAlias: string, aliasToPack: Map<string, string>, availableCollections: Set<string>, collectionNames: Map<string, string>, packs: PacksMap | undefined, debug: (message: string, ...data: unknown[]) => void, prefix?: string): void;
-/**
- * Resolve import aliases from AST (for TSX/JSX files)
- * @param ast - AST program
- * @param importSources - Sources to scan for imports
- * @param availableCollections - Set of available collection names
- * @param collectionNames - Map of alias to collection name
- * @param packs - Custom packs configuration
- * @param debug - Debug logging function
- * @returns Map of local alias to pack name
- */
-export declare function resolveImportAliases(ast: Program, importSources: string[], availableCollections: Set<string>, collectionNames: Map<string, string>, packs: PacksMap | undefined, debug: (message: string, ...data: unknown[]) => void): Map<string, string>;
-/**
- * Extract import aliases from MDX MDAST using its built-in ESTree data
- * Uses oxc-walker for fast traversal
- * @param mdast - The MDAST from remark-mdx
- * @param importSources - Sources to scan for imports
- * @param availableCollections - Set of available collection names
- * @param collectionNames - Map of alias to collection name
- * @param packs - Custom packs configuration
- * @param debug - Debug logging function
- * @returns Map of local alias to pack name
- */
-export declare function extractMDXImportAliases(mdast: unknown, importSources: string[], availableCollections: Set<string>, collectionNames: Map<string, string>, packs: PacksMap | undefined, debug: (message: string, ...data: unknown[]) => void): Map<string, string>;

package/lib-types/utils/icons/naming.d.ts

@@ -1,46 +0,0 @@
-/**
- * Convert PascalCase to kebab-case
- * @param str - Input string
- * @returns kebab-case string
- */
-export declare function toKebabCase(str: string): string;
-/**
- * Convert kebab-case or snake_case to PascalCase
- * @param str - Input string
- * @returns PascalCase string
- */
-export declare function toPascalCase(str: string): string;
-/**
- * Sanitize icon name to ensure valid identifier
- * @param name - Icon name
- * @param packName - Pack name (for custom sanitization)
- * @param customSanitizer - Optional custom sanitization function
- * @returns Sanitized icon name
- */
-export declare function sanitizeIconName(name: string, packName: string, customSanitizer?: (pascal: string) => string): string;
-/**
- * Resolve icon names to possible variants (kebab-case and lowercase)
- * @param pascalName - Icon name in PascalCase
- * @returns Array of possible icon name variants
- */
-export declare function resolveIconNames(pascalName: string): string[];
-/**
- * Generate stable import variable name for an icon
- * @param prefix - Iconify prefix
- * @param name - Icon name (kebab-case)
- * @param existingVars - Set of existing variable names in the file
- * @returns Unique variable name
- */
-export declare function generateImportVar(prefix: string, name: string, existingVars: Set<string>): string;
-/**
- * Get available Iconify collections from @iconify/json
- * @returns Array of collection prefixes
- */
-export declare function getAvailableCollections(): string[];
-/**
- * Discover all available iconify collections from node_modules
- * @returns Record of collection names to their configurations
- */
-export declare function discoverAllIconifyCollections(): Record<string, {
-    iconifyPrefix: string;
-}>;

package/lib-types/utils/icons/transform/mdx.d.ts

@@ -1,28 +0,0 @@
-import MagicString from "magic-string";
-import type { PacksMap } from "../../../vite/icons";
-import type { MDXJSXElement } from "../types/mdx-ast";
-/**
- * Extract attributes from MDX JSX node, handling title and description specially
- * @param jsxNode - MDX JSX node
- * @returns Object with attributes array and special props
- */
-export declare function extractMDXAttributes(jsxNode: MDXJSXElement): {
-    attrs: string[];
-    titleProp?: string;
-    descriptionProp?: string;
-};
-/**
- * Transform MDX file using remark-mdx for semantic analysis
- * @param code - Original MDX source code
- * @param id - File ID
- * @param importSources - Sources to scan for imports
- * @param availableCollections - Set of available collection names
- * @param collectionNames - Map of alias to collection name
- * @param packs - Custom packs configuration
- * @param debug - Debug logging function
- * @returns Transformation result or null
- */
-export declare function transformMDXFile(code: string, id: string, importSources: string[], availableCollections: Set<string>, collectionNames: Map<string, string>, packs: PacksMap | undefined, debug: (message: string, ...data: unknown[]) => void): {
-    code: string;
-    map: ReturnType<MagicString["generateMap"]>;
-} | null;

package/lib-types/utils/icons/transform/shared.d.ts

@@ -1,31 +0,0 @@
-import type { PacksMap } from "../../../vite/icons";
-/**
- * Shared transformation context for both TSX/JSX and MDX files
- */
-export interface TransformContext {
-    usedImports: Set<string>;
-    importVars: Set<string>;
-    virtualToVar: Map<string, string>;
-}
-/**
- * Generate virtual module ID and import variable for an icon
- * @param alias - The import alias used in the code
- * @param iconName - The icon name (PascalCase)
- * @param packName - The pack name
- * @param packs - Custom packs configuration
- * @param collectionNames - Map of alias to collection name
- * @param ctx - Transformation context
- * @returns Object with virtualId and varName
- */
-export declare function generateIconImport(alias: string, iconName: string, packName: string, packs: PacksMap | undefined, collectionNames: Map<string, string>, ctx: TransformContext): {
-    virtualId: string;
-    varName: string;
-};
-/**
- * Build SVG element string from attributes and import variable
- * @param attrs - Array of attribute strings
- * @param varName - Import variable name for dangerouslySetInnerHTML
- * @param children - Optional children JSX code
- * @returns Complete SVG element string
- */
-export declare function buildSVGElement(attrs: string[], varName: string, children?: string): string;

package/lib-types/utils/icons/transform/tsx.d.ts

@@ -1,51 +0,0 @@
-import type { JSXElement, Program } from "@oxc-project/types";
-import MagicString from "magic-string";
-import type { PacksMap } from "../../../vite/icons";
-import { type TransformContext } from "./shared";
-/**
- * Check if a JSX element is an icon element based on its structure
- * @param elem - JSX element to check
- * @param aliasToPack - Map of aliases to pack names
- * @param collectionNames - Map of alias to collection name
- * @param availableCollections - Set of available collection names
- * @returns True if the element is an icon element
- */
-export declare function isIconElement(elem: JSXElement, aliasToPack: Map<string, string>, collectionNames: Map<string, string>, availableCollections: Set<string>): boolean;
-/**
- * Find all icon elements in an AST
- * @param ast - AST to search
- * @param aliasToPack - Map of aliases to pack names
- * @param collectionNames - Map of alias to collection name
- * @param availableCollections - Set of available collection names
- * @returns Array of JSX elements that are icon elements
- */
-export declare function findIconElements(ast: Program, aliasToPack: Map<string, string>, collectionNames: Map<string, string>, availableCollections: Set<string>): JSXElement[];
-/**
- * Transform a JSX icon element to SVG JSX
- * @param elem - JSX element to transform
- * @param s - MagicString instance
- * @param source - Original source code
- * @param aliasToPack - Map of aliases to pack names
- * @param collectionNames - Map of alias to collection name
- * @param packs - Custom packs configuration
- * @param ctx - Transformation context
- * @param debug - Debug logging function
- * @returns True if transformation was applied
- */
-export declare function transformIconElement(elem: JSXElement, s: MagicString, source: string, aliasToPack: Map<string, string>, collectionNames: Map<string, string>, packs: PacksMap | undefined, ctx: TransformContext, debug: (message: string, ...data: unknown[]) => void): boolean;
-/**
- * Transform TSX/JSX file
- * @param code - Original source code
- * @param id - File ID
- * @param ast - Parsed AST
- * @param aliasToPack - Map of aliases to pack names
- * @param collectionNames - Map of alias to collection name
- * @param availableCollections - Set of available collection names
- * @param packs - Custom packs configuration
- * @param debug - Debug logging function
- * @returns Transformation result or null
- */
-export declare function transformTSXFile(code: string, id: string, ast: Program, aliasToPack: Map<string, string>, collectionNames: Map<string, string>, availableCollections: Set<string>, packs: PacksMap | undefined, debug: (message: string, ...data: unknown[]) => void): {
-    code: string;
-    map: ReturnType<MagicString["generateMap"]>;
-} | null;

package/lib-types/utils/icons/types/mdx-ast.d.ts

@@ -1,74 +0,0 @@
-/**
- * Type definitions for MDX AST nodes
- * These types are based on the MDAST and ESTree structures used by remark-mdx
- */
-export interface Position {
-    start: {
-        offset: number;
-        line: number;
-        column: number;
-    };
-    end: {
-        offset: number;
-        line: number;
-        column: number;
-    };
-}
-export interface MDXJSXAttribute {
-    type: "mdxJsxAttribute";
-    name: string;
-    value?: string | {
-        type: "mdxJsxAttributeValueExpression";
-        value: string;
-        data?: {
-            estree?: unknown;
-        };
-    };
-}
-export interface MDXJSXElement {
-    type: "mdxJsxFlowElement" | "mdxJsxTextElement";
-    name: string | null;
-    attributes?: MDXJSXAttribute[];
-    position?: Position;
-    children?: unknown[];
-}
-export interface ESTreeProgram {
-    type: "Program";
-    body: ESTreeStatement[];
-    sourceType?: string;
-}
-export interface ESTreeImportDeclaration {
-    type: "ImportDeclaration";
-    source: {
-        value: string;
-        type: string;
-    };
-    specifiers: ESTreeImportSpecifier[];
-}
-export interface ESTreeImportSpecifier {
-    type: "ImportSpecifier" | "ImportNamespaceSpecifier" | "ImportDefaultSpecifier";
-    local: {
-        name: string;
-        type: string;
-    };
-    imported?: {
-        name?: string;
-        value?: string;
-        type: string;
-    };
-}
-export type ESTreeStatement = ESTreeImportDeclaration | {
-    type: string;
-    [key: string]: unknown;
-};
-export interface MDXjsEsmNode {
-    type: "mdxjsEsm";
-    data?: {
-        estree?: ESTreeProgram;
-    };
-    position?: Position;
-}
-export type MDXNode = MDXJSXElement | MDXjsEsmNode | {
-    type: string;
-    [key: string]: unknown;
-};

package/lib-types/utils/index.d.ts

@@ -1,13 +0,0 @@
-export * from "./ast/core";
-export * from "./ast/imports";
-export * from "./ast/jsx-helpers";
-export * from "./icons/ast/expressions";
-export * from "./icons/ast/jsx";
-export * from "./icons/collections/loader";
-export * from "./icons/import-resolver";
-export * from "./icons/naming";
-export * from "./icons/transform/mdx";
-export * from "./icons/transform/shared";
-export * from "./icons/transform/tsx";
-export * from "./package-json";
-export * from "./transform-dts";

package/lib-types/utils/package-json.d.ts

@@ -1,13 +0,0 @@
-export type PackageJson = {
-    dependencies?: Record<string, string>;
-    peerDependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    [key: string]: unknown;
-};
-/**
- * Safely reads and parses a package.json file
- * @param relativePath - Relative path to the package.json file from the current working directory
- * @returns Parsed package.json object
- * @throws Error if the file doesn't exist or has invalid structure
- */
-export declare function readPackageJson(relativePath?: string): PackageJson;

package/lib-types/utils/transform-dts.d.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-import type { Node } from "@oxc-project/types";
-import MagicString from "magic-string";
-import { parseSync } from "oxc-parser";
-declare function injectAsChildTypesIntoComponent(node: Node, content: string, s: MagicString): boolean;
-/**
- * Injects AsChildTypes import into the declaration file
- */
-declare function injectAsChildTypesImport(options: {
-    ast: ReturnType<typeof parseSync>;
-    magicString: MagicString;
-    toolsImportNode: Node | null;
-}): void;
-declare function transformTypeFile(dtsPath: string, sourcePath: string): Promise<boolean>;
-export { injectAsChildTypesImport, injectAsChildTypesIntoComponent, transformTypeFile };

package/lib-types/utils/transform-dts.unit.d.ts

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

package/lib-types/vite/as-child.d.ts

@@ -1,13 +0,0 @@
-import type { Plugin as VitePlugin } from "vite";
-export type AsChildTypes = {
-    asChild?: true;
-};
-export type AsChildPluginOptions = {
-    debug?: boolean;
-};
-/**
- * Vite plugin that transforms JSX elements with asChild prop by moving child element props to the parent
- * @param options - Plugin configuration options
- * @returns Vite plugin object
- */
-export declare const asChild: (options?: AsChildPluginOptions) => VitePlugin;

package/lib-types/vite/as-child.unit.d.ts

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

package/lib-types/vite/component-props.d.ts

@@ -1,24 +0,0 @@
-import type { Plugin as VitePlugin } from "vite";
-export type PropType = {
-    name: string;
-    type: "boolean" | "string" | "number" | "union" | "function" | "unknown";
-    unionValues?: string[];
-    isBindable: boolean;
-    defaultValue?: unknown;
-    comment?: string;
-};
-export type ComponentPiece = {
-    name: string;
-    props: PropType[];
-};
-export type ComponentMetadata = {
-    componentName: string;
-    pieces: ComponentPiece[];
-};
-/**
- * Vite plugin that extracts component prop types and generates metadata JSON files
- */
-export declare const componentProps: (options: {
-    componentsDir: string;
-    outputDir: string;
-}) => VitePlugin;

package/lib-types/vite/icons.d.ts

@@ -1,19 +0,0 @@
-import type { Plugin as VitePlugin } from "vite";
-export type PacksMap = Record<string, {
-    iconifyPrefix: string;
-    sanitizeIcon?: (pascal: string) => string;
-}>;
-export type IconsPluginOptions = {
-    debug?: boolean;
-    /**
-     * The sources to scan for imports. By default this includes QDS, you can also add your own when creating library wrappers.
-     */
-    importSources?: string[];
-    packs?: PacksMap;
-};
-/**
- * Vite plugin that transforms icon JSX elements to direct <svg /> calls
- * @param options - Plugin configuration options
- * @returns Vite plugin object
- */
-export declare const icons: (options?: IconsPluginOptions) => VitePlugin;

package/lib-types/vite/icons.unit.d.ts

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

package/lib-types/vite/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./as-child";
-export * from "./icons";
-export type { AsChildTypes } from "./as-child";