@importcsv/react 0.2.9 → 0.2.11

package/build/preact/js.d.ts

@@ -0,0 +1,12 @@
+import { CSVImporterProps } from './types';
+type CreateImporterProps = CSVImporterProps & {
+    domElement?: Element;
+};
+export declare function createCSVImporter(props: CreateImporterProps): {
+    instance: (import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<CSVImporterProps> & {
+        ref?: import('preact').Ref<unknown> | undefined;
+    }> & HTMLDialogElement) | null;
+    showModal: () => void;
+    closeModal: () => void;
+};
+export {};

package/build/preact/settings/defaults.d.ts

@@ -0,0 +1,3 @@
+import { CSVImporterProps } from '../types';
+declare const defaults: CSVImporterProps;
+export default defaults;

package/build/preact/styles.d.ts

@@ -0,0 +1 @@
+export declare const importcsvStyles: string;

package/build/preact/types/index.d.ts

@@ -0,0 +1,132 @@
+import { ThemeConfig } from './theme';
+export interface Column {
+    id: string;
+    label: string;
+    type?: 'string' | 'number' | 'email' | 'date' | 'phone' | 'select';
+    validators?: Validator[];
+    transformations?: Transformer[];
+    options?: string[];
+    description?: string;
+    placeholder?: string;
+}
+export type Validator = {
+    type: 'required';
+    message?: string;
+} | {
+    type: 'unique';
+    message?: string;
+} | {
+    type: 'regex';
+    pattern: string;
+    message?: string;
+} | {
+    type: 'min';
+    value: number;
+    message?: string;
+} | {
+    type: 'max';
+    value: number;
+    message?: string;
+} | {
+    type: 'min_length';
+    value: number;
+    message?: string;
+} | {
+    type: 'max_length';
+    value: number;
+    message?: string;
+};
+export type TransformationStage = 'pre' | 'post';
+export type Transformer = {
+    type: 'trim';
+    stage?: TransformationStage;
+} | {
+    type: 'uppercase';
+    stage?: TransformationStage;
+} | {
+    type: 'lowercase';
+    stage?: TransformationStage;
+} | {
+    type: 'capitalize';
+    stage?: TransformationStage;
+} | {
+    type: 'remove_special_chars';
+    stage?: TransformationStage;
+} | {
+    type: 'normalize_phone';
+    stage?: TransformationStage;
+} | {
+    type: 'normalize_date';
+    format?: string;
+    stage?: TransformationStage;
+} | {
+    type: 'default';
+    value: string;
+    stage?: TransformationStage;
+} | {
+    type: 'replace';
+    find: string;
+    replace: string;
+    stage?: TransformationStage;
+} | {
+    type: 'custom';
+    fn: (value: any) => any;
+    stage?: TransformationStage;
+};
+export interface ColumnMapping {
+    id: string;
+    label?: string;
+    include: boolean;
+    selected?: boolean;
+}
+export interface ColumnMappingDictionary {
+    [uploadColumnIndex: number]: ColumnMapping;
+}
+type ModalParams = {
+    isModal?: boolean;
+    modalIsOpen?: boolean;
+    modalOnCloseTriggered?: () => void;
+    modalCloseOnOutsideClick?: boolean;
+};
+type CustomTranslationResource = {
+    [language: string]: {
+        [key: string]: string;
+    };
+};
+export type CSVImporterProps = {
+    columns?: Column[];
+    importerKey?: string;
+    onComplete?: (data: any) => void;
+    backendUrl?: string;
+    user?: Record<string, any>;
+    metadata?: Record<string, any>;
+    theme?: ThemeConfig | 'default' | 'minimal' | 'modern' | 'compact' | 'dark';
+    darkMode?: boolean;
+    primaryColor?: string;
+    className?: string;
+    customStyles?: Record<string, string> | string;
+    classNames?: {
+        root?: string;
+        modal?: string;
+        header?: string;
+        stepper?: string;
+        content?: string;
+        footer?: string;
+        button?: string;
+        input?: string;
+        table?: string;
+        dropzone?: string;
+    };
+    showDownloadTemplateButton?: boolean;
+    skipHeaderRowSelection?: boolean;
+    waitOnComplete?: boolean;
+    invalidRowHandling?: 'include' | 'exclude' | 'block';
+    includeUnmatchedColumns?: boolean;
+    language?: string;
+    customTranslations?: CustomTranslationResource;
+    demoData?: {
+        fileName: string;
+        csvContent: string;
+    };
+} & ModalParams;
+export {};

package/build/preact/types/theme.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Theme configuration types for CSV Importer
+ */
+export interface ThemeConfig {
+    colors?: {
+        primary?: string;
+        primaryHover?: string;
+        primaryForeground?: string;
+        secondary?: string;
+        secondaryHover?: string;
+        secondaryForeground?: string;
+        background?: string;
+        foreground?: string;
+        card?: string;
+        cardForeground?: string;
+        border?: string;
+        input?: string;
+        ring?: string;
+        muted?: string;
+        mutedForeground?: string;
+        accent?: string;
+        accentForeground?: string;
+        destructive?: string;
+        destructiveForeground?: string;
+        success?: string;
+        successForeground?: string;
+        warning?: string;
+        warningForeground?: string;
+        info?: string;
+        infoForeground?: string;
+    };
+    typography?: {
+        fontFamily?: string;
+        fontFamilyMono?: string;
+        fontSize?: {
+            xs?: string;
+            sm?: string;
+            base?: string;
+            lg?: string;
+            xl?: string;
+            '2xl'?: string;
+            '3xl'?: string;
+        };
+        fontWeight?: {
+            light?: number;
+            normal?: number;
+            medium?: number;
+            semibold?: number;
+            bold?: number;
+        };
+        lineHeight?: {
+            tight?: string;
+            normal?: string;
+            relaxed?: string;
+        };
+    };
+    spacing?: {
+        xs?: string;
+        sm?: string;
+        md?: string;
+        lg?: string;
+        xl?: string;
+        '2xl'?: string;
+        '3xl'?: string;
+    };
+    borders?: {
+        radius?: {
+            none?: string;
+            sm?: string;
+            md?: string;
+            lg?: string;
+            xl?: string;
+            full?: string;
+        };
+        width?: {
+            none?: string;
+            thin?: string;
+            medium?: string;
+            thick?: string;
+        };
+    };
+    components?: {
+        button?: {
+            padding?: string;
+            fontSize?: string;
+            fontWeight?: string;
+            borderRadius?: string;
+            height?: string;
+            minWidth?: string;
+        };
+        input?: {
+            padding?: string;
+            fontSize?: string;
+            borderRadius?: string;
+            borderWidth?: string;
+            height?: string;
+            background?: string;
+        };
+        modal?: {
+            width?: string;
+            maxWidth?: string;
+            maxHeight?: string;
+            padding?: string;
+            borderRadius?: string;
+            backdropOpacity?: string;
+        };
+        table?: {
+            headerBackground?: string;
+            headerForeground?: string;
+            rowHoverBackground?: string;
+            borderColor?: string;
+            cellPadding?: string;
+        };
+        stepper?: {
+            activeColor?: string;
+            inactiveColor?: string;
+            completedColor?: string;
+            lineColor?: string;
+            dotSize?: string;
+        };
+        dropzone?: {
+            borderStyle?: string;
+            borderColor?: string;
+            borderColorHover?: string;
+            backgroundColor?: string;
+            backgroundColorHover?: string;
+            padding?: string;
+            borderRadius?: string;
+        };
+    };
+    shadows?: {
+        sm?: string;
+        md?: string;
+        lg?: string;
+        xl?: string;
+    };
+    animations?: {
+        duration?: {
+            fast?: string;
+            normal?: string;
+            slow?: string;
+        };
+        easing?: string;
+    };
+}
+export declare const defaultTheme: ThemeConfig;
+export declare const presetThemes: {
+    default: ThemeConfig;
+    minimal: ThemeConfig;
+    modern: ThemeConfig;
+    compact: ThemeConfig;
+    dark: ThemeConfig;
+};

package/build/preact/utils/cn.d.ts

@@ -0,0 +1,6 @@
+import { ClassValue } from 'clsx';
+/**
+ * Utility function to merge Tailwind CSS classes with proper precedence
+ * Combines clsx for conditional classes and tailwind-merge for deduplication
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/build/preact/validation/transformationStages.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Transformation stage definitions for smart auto-detection
+ *
+ * Pre-validation transformations clean and normalize data before validation rules are applied.
+ * Post-validation transformations enrich and format data after validation passes.
+ */
+/**
+ * Transformations that should run BEFORE validation
+ * These typically clean or normalize input to prepare it for validation
+ */
+export declare const PRE_VALIDATION_TRANSFORMS: readonly ["trim", "uppercase", "lowercase", "remove_special_chars", "normalize_phone", "normalize_date"];
+/**
+ * Transformations that should run AFTER validation
+ * These typically format, enrich, or provide defaults for valid data
+ */
+export declare const POST_VALIDATION_TRANSFORMS: readonly ["default", "capitalize", "replace", "custom"];
+export type PreValidationTransform = typeof PRE_VALIDATION_TRANSFORMS[number];
+export type PostValidationTransform = typeof POST_VALIDATION_TRANSFORMS[number];
+/**
+ * Check if a transformation type should run before validation
+ */
+export declare function isPreValidationTransform(type: string): boolean;
+/**
+ * Check if a transformation type should run after validation
+ */
+export declare function isPostValidationTransform(type: string): boolean;

package/build/preact/validation/transformer.d.ts

@@ -0,0 +1,17 @@
+import { Transformer } from '../types';
+/**
+ * Apply transformations to a value
+ * @param value The value to transform
+ * @param transformations Array of transformations to apply
+ * @returns Transformed value
+ */
+export declare function applyTransformations(value: any, transformations?: Transformer[]): any;
+/**
+ * Categorize transformations into pre-validation and post-validation stages
+ * @param transformations Array of transformations to categorize
+ * @returns Object with pre and post transformation arrays
+ */
+export declare function categorizeTransformations(transformations?: Transformer[]): {
+    pre: Transformer[];
+    post: Transformer[];
+};

package/build/preact/validation/validator.d.ts

@@ -0,0 +1,23 @@
+import { Column } from '../types';
+/**
+ * Validates a single value against a column's validators
+ * @param value The value to validate
+ * @param column The column definition with validators
+ * @returns Error message if validation fails, null if valid
+ */
+export declare function validateColumn(value: any, column: Column): string | null;
+/**
+ * Validates uniqueness across all rows for a column
+ * @param rows All data rows
+ * @param columnIndex The column index to check
+ * @param column The column definition
+ * @returns Array of row indices that have duplicate values
+ */
+export declare function validateUniqueness(rows: any[][], columnIndex: number, column: Column): number[];
+/**
+ * Batch validation for all rows
+ * @param rows Data rows to validate
+ * @param columns Column definitions
+ * @returns Validation results with errors per cell
+ */
+export declare function validateBatch(rows: any[][], columns: Column[]): Map<string, string>;

package/build/react/shims/react-compat-types-shim.d.ts

@@ -0,0 +1,67 @@
+// TypeScript type shim to bridge Preact and React types
+// This allows Preact code to use React type definitions
+// Based on HelloCSV's approach: https://github.com/HelloCSV/HelloCSV
+
+// Declare that Preact modules export React types
+declare module '../../react' {
+  export * from 'react';
+}
+
+declare module './react-hooks-shim.js' {
+  export * from 'react';
+}
+
+declare module './react-compat-shim.js' {
+  export * from 'react';
+  export { createPortal } from 'react-dom';
+}
+
+declare module '../../react/jsx-runtime' {
+  export * from 'react/jsx-runtime';
+}
+
+declare module '../../react/jsx-dev-runtime' {
+  export * from 'react/jsx-dev-runtime';
+}
+
+// Type augmentations to handle Preact-specific types
+declare module '../../react' {
+  import type { ReactNode, ReactElement } from 'react';
+
+  // Map Preact's ComponentChildren to React's ReactNode
+  export interface ComponentChildren extends ReactNode {}
+
+  // Ensure VNode is compatible with ReactElement
+  export interface VNode extends ReactElement {}
+}
+
+// Extend global JSX namespace to include React types
+declare global {
+  namespace JSX {
+    // Import React's JSX types
+    interface IntrinsicElements extends React.JSX.IntrinsicElements {}
+    interface Element extends React.ReactElement {}
+    interface ElementClass extends React.Component<any> {}
+    interface ElementAttributesProperty extends React.Component<any> {}
+    interface ElementChildrenAttribute extends React.Component<any> {}
+
+    // HTML attribute interfaces
+    interface HTMLAttributes<T> extends React.HTMLAttributes<T> {}
+    interface SVGAttributes<T> extends React.SVGAttributes<T> {}
+    interface DOMAttributes<T> extends React.DOMAttributes<T> {}
+    interface CSSProperties extends React.CSSProperties {}
+  }
+}
+
+// Make common React types globally available for files that use them without imports
+declare global {
+  type ReactElement = React.ReactElement;
+  type ReactNode = React.ReactNode;
+  type PropsWithChildren<P = {}> = P & { children?: React.ReactNode };
+  type ComponentChildren = React.ReactNode;
+  type FunctionComponent<P = {}> = React.FC<P>;
+  type FC<P = {}> = React.FC<P>;
+}
+
+// Export to make this a module
+export {};

package/build/react/types/style.d.ts

@@ -0,0 +1,13 @@
+// Treat CSS Modules as class maps
+declare module '*.module.css' {
+  const classes: { readonly [className: string]: string };
+  export default classes;
+}
+
+// Non-module styles are plain strings
+declare module '*.css' {
+  const content: string;
+  export default content;
+}
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@importcsv/react",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "AI-powered CSV importer for React. Smart column mapping with OpenAI, natural language transformations. Self-hosted.",
   "main": "build/react/index.js",
   "module": "build/react/index.esm.js",
@@ -47,10 +47,10 @@
   "author": "ImportCSV",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/abhishekray07/importcsv/issues"
+    "url": "https://github.com/importcsv/importcsv/issues"
   },
-  "homepage": "https://github.com/abhishekray07/importcsv#readme",
-  "types": "build/index.d.ts",
+  "homepage": "https://github.com/importcsv/importcsv#readme",
+  "types": "build/react/index.d.ts",
   "scripts": {
     "build:react": "vite build --mode react",
     "build:preact": "vite build --mode preact",