@idealyst/tooling 1.2.24 → 1.2.25

package/dist/types-CvIlSIOV.d.ts

@@ -0,0 +1,149 @@
+/**
+ * File type classification based on file extension patterns
+ */
+type FileType = 'shared' | 'web' | 'native' | 'styles' | 'types' | 'other';
+/**
+ * Platform classification for imports
+ */
+type Platform = 'react-native' | 'react-dom' | 'neutral';
+/**
+ * Violation type describing what kind of platform mismatch occurred
+ */
+type ViolationType = 'native-in-shared' | 'dom-in-shared' | 'native-in-web' | 'dom-in-native';
+/**
+ * Severity level for violations
+ */
+type Severity = 'error' | 'warning' | 'info';
+/**
+ * Information about a single import
+ */
+interface ImportInfo {
+    /** The imported identifier name */
+    name: string;
+    /** Original name if aliased (e.g., `Image as RNImage`) */
+    originalName?: string;
+    /** The module source (e.g., 'react-native', 'react-dom') */
+    source: string;
+    /** The platform this import belongs to */
+    platform: Platform;
+    /** Line number in source file */
+    line: number;
+    /** Column number in source file */
+    column: number;
+    /** Whether this is a default import */
+    isDefault: boolean;
+    /** Whether this is a namespace import (import * as X) */
+    isNamespace: boolean;
+    /** Whether this is a type-only import */
+    isTypeOnly: boolean;
+}
+/**
+ * A single violation found during analysis
+ */
+interface Violation {
+    /** Type of violation */
+    type: ViolationType;
+    /** The primitive/component that caused the violation */
+    primitive: string;
+    /** The module source (e.g., 'react-native', 'react-dom') */
+    source: string;
+    /** Path to the file with the violation */
+    filePath: string;
+    /** Line number where violation occurred */
+    line: number;
+    /** Column number where violation occurred */
+    column: number;
+    /** Human-readable message describing the violation */
+    message: string;
+    /** Severity level of this violation */
+    severity: Severity;
+}
+/**
+ * Result of analyzing a single file
+ */
+interface AnalysisResult {
+    /** Path to the analyzed file */
+    filePath: string;
+    /** Classified type of the file */
+    fileType: FileType;
+    /** List of violations found */
+    violations: Violation[];
+    /** All imports found in the file */
+    imports: ImportInfo[];
+    /** Whether the file passed validation (no violations) */
+    passed: boolean;
+}
+/**
+ * Options for configuring the platform import analyzer
+ */
+interface AnalyzerOptions {
+    /**
+     * Default severity level for violations
+     * @default 'error'
+     */
+    severity?: Severity;
+    /**
+     * Additional React Native primitives to flag beyond the built-in list
+     * Useful for flagging custom native-only components
+     */
+    additionalNativePrimitives?: string[];
+    /**
+     * Additional React DOM primitives to flag beyond the built-in list
+     * Useful for flagging custom web-only components
+     */
+    additionalDomPrimitives?: string[];
+    /**
+     * Primitives to ignore/allow even if they would normally be flagged
+     */
+    ignoredPrimitives?: string[];
+    /**
+     * Glob patterns for files to skip analysis on
+     * @example ['**\/*.test.tsx', '**\/*.stories.tsx']
+     */
+    ignoredPatterns?: string[];
+    /**
+     * Additional module sources to treat as React Native
+     * @example ['react-native-gesture-handler', 'react-native-reanimated']
+     */
+    additionalNativeSources?: string[];
+    /**
+     * Additional module sources to treat as React DOM
+     * @example ['react-dom/client']
+     */
+    additionalDomSources?: string[];
+}
+/**
+ * Input for batch file analysis
+ */
+interface FileInput {
+    /** File path */
+    path: string;
+    /** File content (source code) */
+    content: string;
+}
+/**
+ * Primitive rule definition
+ */
+interface PrimitiveRule {
+    /** Name of the primitive/component */
+    name: string;
+    /** Module source it comes from */
+    source: string;
+    /** Platform it belongs to */
+    platform: Platform;
+    /** Optional description of why it's platform-specific */
+    description?: string;
+}
+/**
+ * Rule set containing primitives for a specific platform
+ */
+interface PrimitiveRuleSet {
+    /** Platform these rules apply to */
+    platform: Platform;
+    /** List of primitive rules */
+    primitives: PrimitiveRule[];
+    /** Module sources that indicate this platform */
+    sources: string[];
+}
+
+export type { AnalysisResult as A, FileType as F, ImportInfo as I, Platform as P, Severity as S, ViolationType as V, Violation as a, AnalyzerOptions as b, FileInput as c, PrimitiveRule as d, PrimitiveRuleSet as e };

package/dist/utils/index.d.ts

@@ -0,0 +1,94 @@
+import { F as FileType, I as ImportInfo, P as Platform } from '../types-CvIlSIOV.js';
+
+/**
+ * Classifies a file based on its path and extension
+ *
+ * @param filePath - The file path to classify
+ * @returns The file type classification
+ *
+ * @example
+ * classifyFile('Button.tsx') // 'shared'
+ * classifyFile('Button.web.tsx') // 'web'
+ * classifyFile('Button.native.tsx') // 'native'
+ * classifyFile('Button.styles.tsx') // 'styles'
+ * classifyFile('types.ts') // 'types'
+ */
+declare function classifyFile(filePath: string): FileType;
+/**
+ * Checks if a file is a component file that should be analyzed
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is a component file (.tsx or .jsx)
+ */
+declare function isComponentFile(filePath: string): boolean;
+/**
+ * Checks if a file is a shared (cross-platform) component file
+ * These are the files that should NOT contain platform-specific imports
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is a shared component file
+ */
+declare function isSharedFile(filePath: string): boolean;
+/**
+ * Checks if a file is platform-specific
+ *
+ * @param filePath - The file path to check
+ * @returns True if the file is web or native specific
+ */
+declare function isPlatformSpecificFile(filePath: string): boolean;
+/**
+ * Gets the expected platform for a file
+ *
+ * @param filePath - The file path to check
+ * @returns The expected platform, or null for shared/other files
+ */
+declare function getExpectedPlatform(filePath: string): 'web' | 'native' | null;
+/**
+ * Extracts the base component name from a file path
+ *
+ * @param filePath - The file path
+ * @returns The base component name without platform suffix or extension
+ *
+ * @example
+ * getBaseName('Button.web.tsx') // 'Button'
+ * getBaseName('Button.native.tsx') // 'Button'
+ * getBaseName('Button.tsx') // 'Button'
+ */
+declare function getBaseName(filePath: string): string;
+
+/**
+ * Options for import parsing
+ */
+interface ImportParserOptions {
+    /** Additional sources to treat as React Native */
+    additionalNativeSources?: string[];
+    /** Additional sources to treat as React DOM */
+    additionalDomSources?: string[];
+}
+/**
+ * Determines the platform for a given import source
+ */
+declare function getPlatformForSource(source: string, options?: ImportParserOptions): Platform;
+/**
+ * Parses import statements from TypeScript/JavaScript source code
+ *
+ * @param sourceCode - The source code to parse
+ * @param filePath - Optional file path for better error messages
+ * @param options - Parser options
+ * @returns Array of import information
+ */
+declare function parseImports(sourceCode: string, filePath?: string, options?: ImportParserOptions): ImportInfo[];
+/**
+ * Filters imports to only those from platform-specific sources
+ */
+declare function filterPlatformImports(imports: ImportInfo[], platform?: Platform): ImportInfo[];
+/**
+ * Gets all unique import sources from a list of imports
+ */
+declare function getUniqueSources(imports: ImportInfo[]): string[];
+/**
+ * Groups imports by their source module
+ */
+declare function groupImportsBySource(imports: ImportInfo[]): Map<string, ImportInfo[]>;
+
+export { type ImportParserOptions, classifyFile, filterPlatformImports, getBaseName, getExpectedPlatform, getPlatformForSource, getUniqueSources, groupImportsBySource, isComponentFile, isPlatformSpecificFile, isSharedFile, parseImports };