@qwickapps/react-framework 1.4.0 → 1.4.2

package/dist/src/utils/htmlTransform.d.ts

@@ -0,0 +1,44 @@
+/**
+ * HTML Transform Utilities - Shared transformation logic for HTML content
+ *
+ * Provides configurable HTML element transformation rules to convert
+ * standard HTML elements into Framework components.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+export interface TransformRule {
+    selector: string;
+    transform: (element: Element, key: string) => React.ReactNode;
+}
+export interface TransformConfig {
+    rules: TransformRule[];
+    sanitize?: boolean;
+    sanitizeOptions?: any;
+    fallbackComponent?: (element: Element, key: string) => React.ReactNode;
+}
+/**
+ * Default transformation rules for article/blog content
+ */
+export declare const defaultArticleRules: TransformRule[];
+/**
+ * Transform rules optimized for Markdown content
+ */
+export declare const defaultMarkdownRules: TransformRule[];
+/**
+ * Default fallback component - renders element as-is with SafeSpan content
+ */
+export declare const defaultFallback: (element: Element, key: string) => React.ReactNode;
+/**
+ * Transform a single HTML element to React component
+ */
+export declare function transformElement(element: Element, key: string, config?: TransformConfig): React.ReactNode;
+/**
+ * Transform HTML string to React components
+ */
+export declare function transformHtmlToReact(html: string, config?: TransformConfig): React.ReactNode[];
+/**
+ * Strip header elements from HTML content (for articles)
+ */
+export declare function stripHeaderFromContent(html: string): string;
+//# sourceMappingURL=htmlTransform.d.ts.map

package/dist/src/utils/htmlTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlTransform.d.ts","sourceRoot":"","sources":["../../../src/utils/htmlTransform.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CACxE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,EA6H9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,EA0C/C,CAAC;AAsBF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,EAAE,KAAK,MAAM,KAAG,KAAK,CAAC,SAoCrE,CAAC;AAkBF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,eAAgD,GACvD,KAAK,CAAC,SAAS,CA0CjB;AAmCD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,eAAgD,GACvD,KAAK,CAAC,SAAS,EAAE,CAYnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuB3D"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utility functions and types for QwickApps React Framework
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export * from './cssUtils';
+export * from './customPaletteManager';
+export * from './dimensions';
+export * from './logger';
+export * from './paletteUtils';
+export * from './persistenceUtils';
+export * from './reactUtils';
+export * from './spacing';
+export * from './themePerformanceMonitor';
+export * from './themeUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * QwickApps React Framework - Logger Utility
+ *
+ * Optional logging with fallback to console when @qwickapps/logging is not available
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export interface Logger {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+/**
+ * Create logger with optional @qwickapps/logging dependency
+ */
+declare function getLogger(name: string): Logger;
+/**
+ * Re-export Logger type and getLogger function for compatibility
+ */
+export { getLogger };
+/**
+ * Framework-specific loggers
+ */
+export declare const loggers: Record<string, Logger>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9C;AAqCD;;GAEG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvC;AAED;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAU1C,CAAC"}

package/dist/src/utils/paletteUtils.d.ts

@@ -0,0 +1,38 @@
+import { PaletteConfig } from '../contexts/PaletteContext';
+/**
+ * Available palette options
+ */
+export declare const AVAILABLE_PALETTES: PaletteConfig[];
+/**
+ * Get the current palette from CSS variables
+ */
+export declare const getCurrentPalette: () => string;
+/**
+ * Set palette and update CSS variables
+ */
+export declare const setPalette: (palette: string) => void;
+/**
+ * Get palette display name
+ */
+export declare const getPaletteName: (paletteId: string) => string;
+/**
+ * Get palette configuration by ID
+ */
+export declare const getPaletteConfig: (paletteId: string) => PaletteConfig | undefined;
+/**
+ * Initialize palette system
+ */
+export declare const initializePalette: () => void;
+/**
+ * Save palette preference to localStorage
+ */
+export declare const savePalettePreference: (palette: string) => void;
+/**
+ * Get CSS custom property value
+ */
+export declare const getCSSVariable: (property: string) => string;
+/**
+ * Set CSS custom property value
+ */
+export declare const setCSSVariable: (property: string, value: string) => void;
+//# sourceMappingURL=paletteUtils.d.ts.map

package/dist/src/utils/paletteUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paletteUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/paletteUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAM7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAGpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAM5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,MAGlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,aAAa,GAAG,SAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,IAGpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,KAAG,IAGvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAEjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,KAAG,IAEhE,CAAC"}

package/dist/src/utils/persistenceUtils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Persistence utilities for theme and palette preferences
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { ThemeMode } from '../contexts/ThemeContext';
+/**
+ * Load user theme preference from localStorage
+ */
+export declare const loadUserThemePreference: (storageKey: string | null) => ThemeMode | null;
+/**
+ * Save user theme preference to localStorage
+ */
+export declare const saveUserThemePreference: (storageKey: string | null, theme: ThemeMode) => void;
+/**
+ * Clear user theme preference from localStorage
+ */
+export declare const clearUserThemePreference: (storageKey: string | null) => void;
+/**
+ * Load user palette preference from localStorage
+ */
+export declare const loadUserPalettePreference: (storageKey: string | null, availablePalettes: string[]) => string | null;
+/**
+ * Save user palette preference to localStorage
+ */
+export declare const saveUserPalettePreference: (storageKey: string | null, palette: string) => void;
+/**
+ * Clear user palette preference from localStorage
+ */
+export declare const clearUserPalettePreference: (storageKey: string | null) => void;
+//# sourceMappingURL=persistenceUtils.d.ts.map

package/dist/src/utils/persistenceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistenceUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/persistenceUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,GAAG,IAAI,KAAG,SAAS,GAAG,IAe/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,GAAG,IAAI,EAAE,OAAO,SAAS,KAAG,IAUrF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,YAAY,MAAM,GAAG,IAAI,KAAG,IAUpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,GAAG,IAAI,EAAE,mBAAmB,MAAM,EAAE,KAAG,MAAM,GAAG,IAe3G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,GAAG,IAAI,EAAE,SAAS,MAAM,KAAG,IAUtF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,YAAY,MAAM,GAAG,IAAI,KAAG,IAUtE,CAAC"}

package/dist/src/utils/reactUtils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * QwickApps React Framework - React Utilities
+ * This module provides utility functions for React components in the QwickApps React Framework.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ReactNode } from 'react';
+/** Location type for React Router */
+type LocationType = {
+    pathname: string;
+    search: string;
+    hash: string;
+};
+/**
+ * Custom hook to get the current location
+ * @returns {object | undefined} - The location object if React Router is available, otherwise undefined
+ */
+export declare const useSafeLocation: () => LocationType | undefined;
+/**
+ * Custom hook to get the navigate function with fallback
+ * @returns {Function} - The navigate function (React Router or window.location fallback)
+ */
+export declare const useSafeNavigate: () => Function;
+/**
+ * Extract text content from ReactNode for code processing
+ * Handles natural React usage like <Code>const x = 1;</Code>
+ *
+ * @param node - The ReactNode to extract text from
+ * @returns String representation of the node's text content
+ */
+export declare function extractTextFromReactNode(node: ReactNode): string;
+export {};
+//# sourceMappingURL=reactUtils.d.ts.map

package/dist/src/utils/reactUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/reactUtils.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC,qCAAqC;AACrC,KAAK,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,YAAY,GAAG,SAOjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,QAqBlC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BhE"}

package/dist/src/utils/spacing.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Spacing utilities for QwickApps React Framework
+ *
+ * Provides standardized spacing value resolution with t-shirt sizing
+ * Based on Material-UI's 8px spacing system
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export type SpacingValue = number | 'none' | 'tiny' | 'small' | 'medium' | 'large' | 'huge' | string | undefined;
+export type SpacingContext = 'padding' | 'margin' | 'gap';
+/**
+ * Resolves a spacing value to MUI spacing units or CSS value
+ */
+export declare function resolveSpacing(value: SpacingValue, context?: SpacingContext): number | string | undefined;
+/**
+ * Resolves spacing props with support for directional values
+ */
+export declare function resolveSpacingProps(props: {
+    padding?: SpacingValue;
+    paddingTop?: SpacingValue;
+    paddingRight?: SpacingValue;
+    paddingBottom?: SpacingValue;
+    paddingLeft?: SpacingValue;
+    paddingX?: SpacingValue;
+    paddingY?: SpacingValue;
+    margin?: SpacingValue;
+    marginTop?: SpacingValue;
+    marginRight?: SpacingValue;
+    marginBottom?: SpacingValue;
+    marginLeft?: SpacingValue;
+    marginX?: SpacingValue;
+    marginY?: SpacingValue;
+}): any;
+//# sourceMappingURL=spacing.d.ts.map

package/dist/src/utils/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../../src/utils/spacing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAoB1D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,cAA0B,GAClC,MAAM,GAAG,MAAM,GAAG,SAAS,CA+C7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,OAkDA"}

package/dist/src/utils/themePerformanceMonitor.d.ts

@@ -0,0 +1,32 @@
+export function getThemePerformanceStats(): {
+    totalMeasurements: number;
+    averageDuration: string;
+    minDuration: string;
+    maxDuration: string;
+    recentMeasurements: any[];
+} | null;
+export function logThemePerformanceStats(): void;
+export function resetThemePerformanceStats(): void;
+export default themePerformanceMonitor;
+declare const themePerformanceMonitor: ThemePerformanceMonitor;
+/**
+ * Theme Performance Monitor - Track theme switching performance
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+declare class ThemePerformanceMonitor {
+    measurements: any[];
+    isEnabled: boolean;
+    initializeListeners(): void;
+    measureThemeSwitch(type: any, value: any): void;
+    getStatistics(): {
+        totalMeasurements: number;
+        averageDuration: string;
+        minDuration: string;
+        maxDuration: string;
+        recentMeasurements: any[];
+    } | null;
+    logStatistics(): void;
+    reset(): void;
+}
+//# sourceMappingURL=themePerformanceMonitor.d.ts.map

package/dist/src/utils/themePerformanceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themePerformanceMonitor.d.ts","sourceRoot":"","sources":["../../../src/utils/themePerformanceMonitor.js"],"names":[],"mappings":"AA2GO;;;;;;SAA8E;AAC9E,iDAA8E;AAC9E,mDAAwE;;AAL/E,+DAA8D;AAxG9D;;;;GAIG;AAEH;IAEI,oBAAsB;IACtB,mBAAuD;IAOzD,4BAUC;IAED,gDAkCC;IAED;;;;;;aAiBC;IAED,sBAaC;IAED,cAEC;CACF"}

package/dist/src/utils/themeUtils.d.ts

@@ -0,0 +1,27 @@
+import { ThemeMode, ActualThemeMode } from '../contexts/ThemeContext';
+export type { ThemeMode, ActualThemeMode } from '../contexts/ThemeContext';
+/**
+ * Get the current theme mode from CSS variables
+ */
+export declare const getCurrentTheme: () => ThemeMode;
+/**
+ * Set theme mode and update CSS variables
+ */
+export declare const setTheme: (theme: ThemeMode) => void;
+/**
+ * Get system preference for dark mode
+ */
+export declare const getSystemTheme: () => ActualThemeMode;
+/**
+ * Get computed theme (resolves 'system' to actual light/dark)
+ */
+export declare const getComputedTheme: (theme?: ThemeMode) => ActualThemeMode;
+/**
+ * Initialize theme system
+ */
+export declare const initializeTheme: () => void;
+/**
+ * Save theme preference to localStorage
+ */
+export declare const saveThemePreference: (theme: ThemeMode) => void;
+//# sourceMappingURL=themeUtils.d.ts.map

package/dist/src/utils/themeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/themeUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGtE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,SAIlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,SAAS,KAAG,IAM3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,eAEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAO,SAA6B,KAAG,eAKvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,IAWlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,SAAS,KAAG,IAGtD,CAAC"}

package/dist/utils/cssUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Utility functions for CSS value conversions.
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Converts a value to a CSS length string.
+ * @param value The value to convert (number, string, etc.).
+ * @param opts Options for controlling the conversion.
+ * @returns The CSS length string (e.g., "10px", "100%", etc.).
+ */
+export declare function toCssLength(value: unknown, opts?: {
+    defaultUnit?: string;
+    allowedUnits?: string[];
+    allowKeywords?: boolean;
+    fallback?: string;
+}): string;
+//# sourceMappingURL=cssUtils.d.ts.map

package/dist/utils/cssUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssUtils.d.ts","sourceRoot":"","sources":["../../src/utils/cssUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,MAAM,CA6BR"}

package/dist/utils/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
+export * from './cssUtils';
 export * from './customPaletteManager';
 export * from './dimensions';
 export * from './logger';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwickapps/react-framework",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "description": "Complete React framework with responsive navigation, flexible layouts, theming system, and reusable components for building modern applications.",
   "main": "dist/index.js",
@@ -21,7 +21,9 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "scripts",
+    "QUICK_START_GUIDE.md"
   ],
   "scripts": {
     "build": "rollup -c",
@@ -32,6 +34,7 @@
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "clean": "rm -rf dist node_modules .rollup.cache storybook-static",
+    "create-project": "node scripts/create-qwickapps-project.js",
     "prepublishOnly": "npm run build",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build"

package/scripts/bundle-css.cjs

@@ -0,0 +1,27 @@
+const fs = require('fs');
+const path = require('path');
+
+const distDir = path.join(__dirname, '../dist');
+const srcDir = path.join(__dirname, '../src');
+
+console.log('🎨 Bundling QwickApp Framework CSS...');
+
+try {
+    // Read all CSS from dist/index.css but replace the @import with actual content
+    const mainCss = fs.readFileSync(path.join(distDir, 'index.css'), 'utf8');
+    const palettesCss = fs.readFileSync(path.join(srcDir, 'palettes/index.css'), 'utf8');
+
+    // Replace the @import line with the actual content
+    const bundledCss = mainCss.replace('@import "../palettes/index.css";', palettesCss);
+
+    // Write the bundled CSS
+    const outputFile = path.join(distDir, 'index.bundled.css');
+    fs.writeFileSync(outputFile, bundledCss);
+
+    console.log(`✅ Created bundled CSS: ${outputFile}`);
+    console.log(`📊 Size: ${(bundledCss.length / 1024).toFixed(2)} KB`);
+    console.log('🎉 CSS bundling complete!');
+} catch (error) {
+    console.error('❌ Error bundling CSS:', error.message);
+    process.exit(1);
+}

package/scripts/create-project.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+#
+# QwickApps React Framework - Project Creation Script
+# Convenience wrapper for the main creation script
+#
+
+echo "🚀 QwickApps React Framework - Project Creator"
+echo "=============================================="
+echo ""
+
+# Check if project name is provided
+if [ -z "$1" ]; then
+    echo "❌ Error: Please provide a project name"
+    echo ""
+    echo "Usage:"
+    echo "  ./scripts/create-project.sh my-project-name"
+    echo "  OR"
+    echo "  npx @qwickapps/react-framework/scripts/create-qwickapps-project my-project-name"
+    echo ""
+    exit 1
+fi
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Run the main Node.js script
+echo "Starting project creation..."
+node "$SCRIPT_DIR/create-qwickapps-project.js" "$1"