funuicss 3.6.10 → 3.6.11

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.6.10",
+  "version": "3.6.11",
   "name": "funuicss",
   "description": "React and Next.js component UI Library for creating Easy and good looking websites with fewer lines of code. Elevate your web development experience with our cutting-edge React/Next.js component UI Library. Craft stunning websites effortlessly, boasting both seamless functionality and aesthetic appeal—all achieved with minimal lines of code. Unleash the power of simplicity and style in your projects!",
   "main": "index.js",

package/ui/carousel/Carousel.d.ts

@@ -1,10 +1,12 @@
 import React, { ReactNode } from 'react';
-interface CarouselProps {
+interface CarouselProps extends React.HTMLAttributes<HTMLDivElement> {
     scrollNumber?: number;
     gap?: number;
     funcss?: string;
     children: ReactNode;
     showDashes?: boolean;
+    allowVerticalOverflow?: boolean;
+    itemPadding?: string;
 }
 declare const Carousel: React.FC<CarouselProps>;
 export default Carousel;

package/ui/carousel/Carousel.js

@@ -1,5 +1,16 @@
 "use strict";
 'use client';
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -33,6 +44,17 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -43,11 +65,11 @@ var Circle_1 = __importDefault(require("../specials/Circle"));
 var RowFlex_1 = __importDefault(require("../specials/RowFlex"));
 var Functions_1 = require("../../utils/Functions");
 var Carousel = function (_a) {
-    var _b = _a.scrollNumber, scrollNumber = _b === void 0 ? 320 : _b, _c = _a.gap, gap = _c === void 0 ? 0.5 : _c, _d = _a.funcss, funcss = _d === void 0 ? '' : _d, _e = _a.showDashes, showDashes = _e === void 0 ? true : _e, children = _a.children;
+    var _b = _a.scrollNumber, scrollNumber = _b === void 0 ? 320 : _b, _c = _a.gap, gap = _c === void 0 ? 0.5 : _c, _d = _a.funcss, funcss = _d === void 0 ? '' : _d, _e = _a.showDashes, showDashes = _e === void 0 ? true : _e, _f = _a.allowVerticalOverflow, allowVerticalOverflow = _f === void 0 ? false : _f, _g = _a.itemPadding, itemPadding = _g === void 0 ? '0rem' : _g, children = _a.children, rest = __rest(_a, ["scrollNumber", "gap", "funcss", "showDashes", "allowVerticalOverflow", "itemPadding", "children"]);
     var scrollRef = (0, react_1.useRef)(null);
-    var _f = (0, react_1.useState)('start'), scrollPosition = _f[0], setScrollPosition = _f[1];
-    var _g = (0, react_1.useState)(false), isPhone = _g[0], setIsPhone = _g[1];
-    var _h = (0, react_1.useState)(false), isScrollable = _h[0], setIsScrollable = _h[1];
+    var _h = (0, react_1.useState)('start'), scrollPosition = _h[0], setScrollPosition = _h[1];
+    var _j = (0, react_1.useState)(false), isPhone = _j[0], setIsPhone = _j[1];
+    var _k = (0, react_1.useState)(false), isScrollable = _k[0], setIsScrollable = _k[1];
     var checkScrollable = function () {
         var container = scrollRef.current;
         if (container) {
@@ -100,7 +122,7 @@ var Carousel = function (_a) {
             return function () { return container.removeEventListener('scroll', handleScroll); };
         }
     }, []);
-    return (react_1.default.createElement("div", { className: "carousel-wrapper ".concat(funcss) },
+    return (react_1.default.createElement("div", __assign({ className: "carousel-wrapper ".concat(funcss) }, rest),
         react_1.default.createElement(RowFlex_1.default, { gap: 1, wrap: "nowrap", alignItems: "center" },
             !isPhone && isScrollable && (react_1.default.createElement("div", null,
                 react_1.default.createElement(Circle_1.default, { onClick: function () { return scroll('left'); } },
@@ -109,10 +131,12 @@ var Carousel = function (_a) {
                     width: '100%',
                     gap: gap + 'rem',
                     overflowX: 'auto',
+                    overflowY: 'visible',
                     display: 'flex',
                     justifyItems: (isScrollable || isPhone) ? 'flex-start' : 'center',
                     scrollSnapType: 'x mandatory',
                     scrollBehavior: 'smooth',
+                    padding: itemPadding || "0.5rem"
                 } }, react_1.default.Children.map(children, function (child) { return (react_1.default.createElement("div", { className: "carousel-item", style: { flexShrink: 0 } },
                 react_1.default.createElement("div", { className: "carousel-card" }, child))); })),
             !isPhone && isScrollable && (react_1.default.createElement("div", null,

package/ui/vista/Vista.js

@@ -57,25 +57,30 @@ var Vista = function (_a) {
         containerClass: containerClass,
         textWrapperClass: textWrapperClass,
         imageWrapperClass: imageWrapperClass,
+        gap: gap,
         // Enhanced content props
+        heading: heading,
         headingSize: headingSize,
         headingWeight: headingWeight,
         headingColor: headingColor,
         headingClass: headingClass,
+        subheading: subheading,
         subheadingSize: subheadingSize,
         subheadingWeight: subheadingWeight,
         subheadingColor: subheadingColor,
         subheadingClass: subheadingClass,
+        content: content,
         contentSize: contentSize,
         contentWeight: contentWeight,
         contentColor: contentColor,
         contentClass: contentClass,
+        image: image,
         imageUrl: imageUrl,
         imageSize: imageSize,
         imageAlt: imageAlt,
         imageClass: imageClass,
-        gap: gap,
-        ctaClass: ctaClass
+        cta: cta,
+        ctaClass: ctaClass,
     }).props;
     var layoutClass = [
         mergedProps.layout,
@@ -86,14 +91,14 @@ var Vista = function (_a) {
         .join(' ');
     // Enhanced Text Content with flexible styling
     var TextContent = (react_1.default.createElement("div", { className: "vista-text ".concat(mergedProps.layout === 'centered' ? "text-center" : "", " ").concat(mergedProps.textWrapperClass) },
-        heading && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.headingSize, weight: mergedProps.headingWeight, color: mergedProps.headingColor, funcss: mergedProps.headingClass }, heading)),
-        subheading && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.subheadingSize, weight: mergedProps.subheadingWeight, color: mergedProps.subheadingColor, funcss: "mt-2 ".concat(mergedProps.subheadingClass) }, subheading)),
-        content && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.contentSize, weight: mergedProps.contentWeight, color: mergedProps.contentColor, funcss: "mt-4 ".concat(mergedProps.contentClass), article: true }, content || children)),
-        cta && (react_1.default.createElement("div", { className: "mt-6 ".concat(mergedProps.ctaClass) }, cta))));
+        mergedProps.heading && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.headingSize, weight: mergedProps.headingWeight, color: mergedProps.headingColor, funcss: mergedProps.headingClass }, mergedProps.heading)),
+        mergedProps.subheading && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.subheadingSize, weight: mergedProps.subheadingWeight, color: mergedProps.subheadingColor, funcss: "mt-2 ".concat(mergedProps.subheadingClass) }, mergedProps.subheading)),
+        mergedProps.content && (react_1.default.createElement(Text_1.default, { block: true, size: mergedProps.contentSize, weight: mergedProps.contentWeight, color: mergedProps.contentColor, funcss: "mt-4 ".concat(mergedProps.contentClass), article: true }, mergedProps.content || children)),
+        mergedProps.cta && (react_1.default.createElement("div", { className: "mt-6 ".concat(mergedProps.ctaClass) }, mergedProps.cta))));
     // Enhanced Image Content - uses imageUrl if no image component provided
-    var ImageContent = (image || mergedProps.imageUrl) && (react_1.default.createElement("div", { className: "vista-image ".concat(mergedProps.imageWrapperClass) }, image ? (image) : (react_1.default.createElement("img", { src: mergedProps.imageUrl, alt: mergedProps.imageAlt || 'Vista image', className: "".concat(mergedProps.imageClass), style: {
+    var ImageContent = (mergedProps.image || mergedProps.imageUrl) && (react_1.default.createElement("div", { className: "vista-image ".concat(mergedProps.imageWrapperClass) }, mergedProps.image ? (mergedProps.image) : (react_1.default.createElement("img", { src: mergedProps.imageUrl, alt: mergedProps.imageAlt || 'Vista image', className: "".concat(mergedProps.imageClass), style: {
             objectFit: 'cover',
-            maxWidth: imageSize,
+            maxWidth: mergedProps.imageSize,
             borderRadius: 'inherit'
         } }))));
     var isCentered = mergedProps.layout === 'centered';

package/utils/componentUtils.d.ts

@@ -33,16 +33,42 @@ export interface MergedConfig {
 export interface UseComponentConfigReturn extends ComponentConfig {
     mergeWithLocal: (localProps?: ComponentProps) => MergedConfig;
     getProp: <T = any>(propName: string, defaultValue?: T) => T;
+    hasVariant: boolean;
+    isDefaultVariant: boolean;
 }
 /**
  * Universal component config getter
+ *
+ * @param projectData - The project configuration data
+ * @param componentName - Name of the component to get config for
+ * @param variantName - Name of the variant (defaults to 'default')
+ * @returns Component configuration with metadata
  */
 export declare const getComponentConfig: (projectData: ProjectData | null | undefined, componentName: string, variantName?: string) => ComponentConfig;
 /**
  * Merge component config with local props - only applies config if variant exists
+ *
+ * @param config - Component configuration from getComponentConfig
+ * @param localProps - Props passed directly to the component
+ * @returns Merged configuration with metadata
  */
 export declare const mergeComponentConfig: (config: ComponentConfig, localProps?: ComponentProps) => MergedConfig;
 /**
  * Hook for easy component config usage - only applies if variant is provided and exists
+ * Uses useMemo to prevent unnecessary re-computation
+ *
+ * @param componentName - Name of the component
+ * @param variantName - Optional variant name
+ * @returns Configuration object with helper methods
  */
 export declare const useComponentConfiguration: (componentName: string, variantName?: string) => UseComponentConfigReturn;
+/**
+ * Utility function to check if a component variant exists
+ * Useful for conditional rendering logic
+ */
+export declare const hasComponentVariant: (projectData: ProjectData | null | undefined, componentName: string, variantName: string) => boolean;
+/**
+ * Get all available variants for a component
+ * Useful for variant selectors/dropdowns
+ */
+export declare const getAvailableVariants: (projectData: ProjectData | null | undefined, componentName: string) => string[];

package/utils/componentUtils.js

@@ -1,4 +1,5 @@
 "use strict";
+// import { useTheme } from "../ui/theme/theme"
 var __assign = (this && this.__assign) || function () {
     __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
@@ -11,14 +12,168 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useComponentConfiguration = exports.mergeComponentConfig = exports.getComponentConfig = void 0;
+exports.getAvailableVariants = exports.hasComponentVariant = exports.useComponentConfiguration = exports.mergeComponentConfig = exports.getComponentConfig = void 0;
+// // utils/componentUtils.ts
+// // Type definitions
+// export interface ComponentProps {
+//   [key: string]: any
+// }
+// export interface ComponentMetadata {
+//   createdAt?: Date
+//   updatedAt?: Date
+//   isCustom?: boolean
+//   baseVariant?: string
+// }
+// export interface ComponentVariant {
+//   componentProps: ComponentProps
+//   metadata?: ComponentMetadata
+// }
+// export interface ComponentConfig {
+//   componentProps: ComponentProps
+//   variantExists: boolean
+//   actualVariant: string
+//   availableVariants: string[]
+//   metadata: ComponentMetadata
+// }
+// export interface ProjectData {
+//   components?: {
+//     [componentName: string]: {
+//       [variantName: string]: ComponentVariant
+//     }
+//   }
+// }
+// export interface MergedConfig {
+//   props: ComponentProps
+//   variant: string
+//   hasConfig: boolean
+// }
+// export interface UseComponentConfigReturn extends ComponentConfig {
+//   mergeWithLocal: (localProps?: ComponentProps) => MergedConfig
+//   getProp: <T = any>(propName: string, defaultValue?: T) => T
+// }
+// /**
+//  * Universal component config getter
+//  */
+// export const getComponentConfig = (
+//   projectData: ProjectData | null | undefined,
+//   componentName: string,
+//   variantName: string = 'default'
+// ): ComponentConfig => {
+//   if (!projectData?.components?.[componentName]) {
+//     return {
+//       componentProps: {},
+//       variantExists: false,
+//       actualVariant: variantName,
+//       availableVariants: [],
+//       metadata: {}
+//     }
+//   }
+//   const component = projectData.components[componentName]
+//   const availableVariants = Object.keys(component)
+//   // Find the best variant match
+//   let targetVariant = variantName
+//   if (!availableVariants.includes(variantName)) {
+//     if (availableVariants.includes('default')) {
+//       targetVariant = 'default'
+//     } else if (availableVariants.length > 0) {
+//       targetVariant = availableVariants[0]
+//     } else {
+//       return {
+//         componentProps: {},
+//         variantExists: false,
+//         actualVariant: variantName,
+//         availableVariants: [],
+//         metadata: {}
+//       }
+//     }
+//   }
+//   const variantData = component[targetVariant] || {}
+//   return {
+//     componentProps: variantData.componentProps || {},
+//     variantExists: true,
+//     actualVariant: targetVariant,
+//     availableVariants,
+//     metadata: variantData.metadata || {}
+//   }
+// }
+// /**
+//  * Merge component config with local props - only applies config if variant exists
+//  */
+// export const mergeComponentConfig = (
+//   config: ComponentConfig,
+//   localProps: ComponentProps = {}
+// ): MergedConfig => {
+//   // Only apply config if variant exists and has actual configuration
+//   const hasValidConfig = config.variantExists && Object.keys(config.componentProps).length > 0
+//   if (!hasValidConfig) {
+//     return {
+//       props: localProps,
+//       variant: config.actualVariant,
+//       hasConfig: false
+//     }
+//   }
+//   return {
+//     // Props: config overrides local only if variant exists
+//     props: {
+//       ...localProps,
+//       ...config.componentProps
+//     },
+//     // Metadata
+//     variant: config.actualVariant,
+//     hasConfig: true
+//   }
+// }
+// /**
+//  * Hook for easy component config usage - only applies if variant is provided and exists
+//  */
+// export const useComponentConfiguration = (
+//   componentName: string, 
+//   variantName?: string // Make variantName optional
+// ): UseComponentConfigReturn => {
+//   const { projectData } = useTheme()
+//   // Only get config if variantName is provided
+//   const config = variantName ? getComponentConfig(projectData, componentName, variantName) : {
+//     componentProps: {},
+//     variantExists: false,
+//     actualVariant: '',
+//     availableVariants: [],
+//     metadata: {}
+//   }
+//   const mergeWithLocal = (
+//     localProps: ComponentProps = {}
+//   ): MergedConfig => {
+//     // If no variant name was provided, return local props as-is
+//     if (!variantName) {
+//       return {
+//         props: localProps,
+//         variant: '',
+//         hasConfig: false
+//       }
+//     }
+//     return mergeComponentConfig(config, localProps)
+//   }
+//   const getProp = <T = any>(propName: string, defaultValue?: T): T => 
+//     (config.componentProps[propName] ?? defaultValue) as T
+//   return {
+//     ...config,
+//     mergeWithLocal,
+//     getProp
+//   }
+// }
 var theme_1 = require("../ui/theme/theme");
+var react_1 = require("react");
 /**
  * Universal component config getter
+ *
+ * @param projectData - The project configuration data
+ * @param componentName - Name of the component to get config for
+ * @param variantName - Name of the variant (defaults to 'default')
+ * @returns Component configuration with metadata
  */
 var getComponentConfig = function (projectData, componentName, variantName) {
     var _a;
     if (variantName === void 0) { variantName = 'default'; }
+    // Early return if no component exists
     if (!((_a = projectData === null || projectData === void 0 ? void 0 : projectData.components) === null || _a === void 0 ? void 0 : _a[componentName])) {
         return {
             componentProps: {},
@@ -30,14 +185,18 @@ var getComponentConfig = function (projectData, componentName, variantName) {
     }
     var component = projectData.components[componentName];
     var availableVariants = Object.keys(component);
-    // Find the best variant match
+    // Find the best variant match with fallback chain
     var targetVariant = variantName;
-    if (!availableVariants.includes(variantName)) {
+    var variantExists = availableVariants.includes(variantName);
+    if (!variantExists) {
+        // Fallback priority: default → first available → none
         if (availableVariants.includes('default')) {
             targetVariant = 'default';
+            variantExists = true;
         }
         else if (availableVariants.length > 0) {
             targetVariant = availableVariants[0];
+            variantExists = true;
         }
         else {
             return {
@@ -49,18 +208,41 @@ var getComponentConfig = function (projectData, componentName, variantName) {
             };
         }
     }
-    var variantData = component[targetVariant] || {};
+    var variantData = component[targetVariant];
     return {
-        componentProps: variantData.componentProps || {},
-        variantExists: true,
+        componentProps: (variantData === null || variantData === void 0 ? void 0 : variantData.componentProps) || {},
+        variantExists: variantExists,
         actualVariant: targetVariant,
         availableVariants: availableVariants,
-        metadata: variantData.metadata || {}
+        metadata: (variantData === null || variantData === void 0 ? void 0 : variantData.metadata) || {}
     };
 };
 exports.getComponentConfig = getComponentConfig;
+/**
+ * Deep merge utility for nested objects
+ * Config props override local props, but we preserve nested structure
+ */
+var deepMerge = function (target, source) {
+    var result = __assign({}, target);
+    for (var key in source) {
+        if (source[key] !== undefined) {
+            // For objects, do shallow merge (we don't go too deep to avoid complexity)
+            if (typeof source[key] === 'object' && !Array.isArray(source[key]) && source[key] !== null) {
+                result[key] = __assign(__assign({}, (target[key] || {})), source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+    }
+    return result;
+};
 /**
  * Merge component config with local props - only applies config if variant exists
+ *
+ * @param config - Component configuration from getComponentConfig
+ * @param localProps - Props passed directly to the component
+ * @returns Merged configuration with metadata
  */
 var mergeComponentConfig = function (config, localProps) {
     if (localProps === void 0) { localProps = {}; }
@@ -74,9 +256,9 @@ var mergeComponentConfig = function (config, localProps) {
         };
     }
     return {
-        // FIXED: Local props should override config (correct order)
-        props: __assign(__assign({}, config.componentProps), localProps // Local props second (higher priority)
-        ),
+        // Props: config overrides local, with deep merge for nested objects
+        props: deepMerge(localProps, config.componentProps),
+        // Metadata
         variant: config.actualVariant,
         hasConfig: true
     };
@@ -84,31 +266,64 @@ var mergeComponentConfig = function (config, localProps) {
 exports.mergeComponentConfig = mergeComponentConfig;
 /**
  * Hook for easy component config usage - only applies if variant is provided and exists
+ * Uses useMemo to prevent unnecessary re-computation
+ *
+ * @param componentName - Name of the component
+ * @param variantName - Optional variant name
+ * @returns Configuration object with helper methods
  */
-var useComponentConfiguration = function (componentName, variantName // Make variantName optional
-) {
+var useComponentConfiguration = function (componentName, variantName) {
     var projectData = (0, theme_1.useTheme)().projectData;
-    // Only get config if variantName is provided
-    var config = variantName ? (0, exports.getComponentConfig)(projectData, componentName, variantName) : {
-        componentProps: {},
-        variantExists: false,
-        actualVariant: '',
-        availableVariants: [],
-        metadata: {}
-    };
-    var mergeWithLocal = function (localProps) {
-        if (localProps === void 0) { localProps = {}; }
-        // If no variant name was provided, return local props as-is
+    // Memoize config computation - only recompute when dependencies change
+    var config = (0, react_1.useMemo)(function () {
         if (!variantName) {
             return {
-                props: localProps,
-                variant: '',
-                hasConfig: false
+                componentProps: {},
+                variantExists: false,
+                actualVariant: '',
+                availableVariants: [],
+                metadata: {}
             };
         }
-        return (0, exports.mergeComponentConfig)(config, localProps);
-    };
-    var getProp = function (propName, defaultValue) { var _a; return ((_a = config.componentProps[propName]) !== null && _a !== void 0 ? _a : defaultValue); };
-    return __assign(__assign({}, config), { mergeWithLocal: mergeWithLocal, getProp: getProp });
+        return (0, exports.getComponentConfig)(projectData, componentName, variantName);
+    }, [projectData, componentName, variantName]);
+    // Memoize merge function
+    var mergeWithLocal = (0, react_1.useMemo)(function () {
+        return function (localProps) {
+            if (localProps === void 0) { localProps = {}; }
+            // If no variant name was provided, return local props as-is
+            if (!variantName) {
+                return {
+                    props: localProps,
+                    variant: '',
+                    hasConfig: false
+                };
+            }
+            return (0, exports.mergeComponentConfig)(config, localProps);
+        };
+    }, [config, variantName]);
+    // Memoize getProp function
+    var getProp = (0, react_1.useMemo)(function () {
+        return function (propName, defaultValue) { var _a; return ((_a = config.componentProps[propName]) !== null && _a !== void 0 ? _a : defaultValue); };
+    }, [config.componentProps]);
+    return __assign(__assign({}, config), { mergeWithLocal: mergeWithLocal, getProp: getProp, hasVariant: config.variantExists, isDefaultVariant: config.actualVariant === 'default' });
 };
 exports.useComponentConfiguration = useComponentConfiguration;
+/**
+ * Utility function to check if a component variant exists
+ * Useful for conditional rendering logic
+ */
+var hasComponentVariant = function (projectData, componentName, variantName) {
+    var _a, _b;
+    return !!((_b = (_a = projectData === null || projectData === void 0 ? void 0 : projectData.components) === null || _a === void 0 ? void 0 : _a[componentName]) === null || _b === void 0 ? void 0 : _b[variantName]);
+};
+exports.hasComponentVariant = hasComponentVariant;
+/**
+ * Get all available variants for a component
+ * Useful for variant selectors/dropdowns
+ */
+var getAvailableVariants = function (projectData, componentName) {
+    var _a;
+    return Object.keys(((_a = projectData === null || projectData === void 0 ? void 0 : projectData.components) === null || _a === void 0 ? void 0 : _a[componentName]) || {});
+};
+exports.getAvailableVariants = getAvailableVariants;