@qwickapps/react-framework 1.4.0 → 1.4.2

package/dist/src/types/CollapsibleLayout.d.ts

@@ -0,0 +1,142 @@
+/**
+ * TypeScript type definitions for CollapsibleLayout component
+ *
+ * Provides TypeScript interfaces that extend the schema model with React-specific types
+ * and component-level functionality for the CollapsibleLayout component.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ReactNode } from 'react';
+import type { WithDataBinding, SchemaProps } from '@qwickapps/schema';
+import type { WithBaseProps } from '../hooks/useBaseProps';
+import CollapsibleLayoutModel from '../schemas/CollapsibleLayoutSchema';
+/**
+ * Core CollapsibleLayout properties extending the schema model
+ *
+ * This interface combines the schema-defined properties with React-specific types
+ * and additional component functionality not captured in the schema.
+ */
+export type CollapsibleLayoutViewProps = SchemaProps<CollapsibleLayoutModel> & WithBaseProps & {
+    /**
+     * Callback fired when the collapsed state changes
+     * @param collapsed - The new collapsed state
+     */
+    onToggle?: (collapsed: boolean) => void;
+    /** Lead icon as React node (overrides string-based leadIcon from schema) */
+    leadIcon?: ReactNode;
+    /** Header actions as React node (overrides string-based headerActions from schema) */
+    headerActions?: ReactNode;
+    /** Collapsed view content as React node (overrides string-based collapsedView from schema) */
+    collapsedView?: ReactNode;
+    /** Main content as React node (overrides string-based children from schema) */
+    children?: ReactNode;
+    /** Footer content as React node (overrides string-based footerView from schema) */
+    footerView?: ReactNode;
+    /** Collapsed state icon as React node (overrides string-based collapsedIcon from schema) */
+    collapsedIcon?: ReactNode;
+    /** Expanded state icon as React node (overrides string-based expandedIcon from schema) */
+    expandedIcon?: ReactNode;
+    /**
+     * Unique key for local storage persistence (when persistState is true)
+     * Defaults to component id or generates one automatically
+     */
+    storageKey?: string;
+    /**
+     * Animation duration in milliseconds
+     * @default 300
+     */
+    animationDuration?: number;
+    /**
+     * Disable all animations (useful for testing or accessibility)
+     * @default false
+     */
+    disableAnimations?: boolean;
+    /**
+     * Custom CSS class for the container
+     */
+    containerClassName?: string;
+    /**
+     * Custom CSS class for the header
+     */
+    headerClassName?: string;
+    /**
+     * Custom CSS class for the content area
+     */
+    contentClassName?: string;
+    /**
+     * Custom CSS class for the footer
+     */
+    footerClassName?: string;
+    /**
+     * ARIA label for the toggle button
+     * @default "Toggle content visibility"
+     */
+    toggleAriaLabel?: string;
+    /**
+     * ID of element that describes the collapsible content
+     */
+    'aria-describedby'?: string;
+    /**
+     * Additional ARIA attributes for the content region
+     */
+    contentAriaProps?: {
+        'aria-label'?: string;
+        'aria-labelledby'?: string;
+        role?: string;
+    };
+};
+/**
+ * Complete CollapsibleLayout component props interface
+ *
+ * This is the interface that should be used by the CollapsibleLayout component.
+ * It combines the view props with data binding capabilities.
+ */
+export interface CollapsibleLayoutProps extends CollapsibleLayoutViewProps, WithDataBinding {
+}
+/**
+ * Type guard to check if a component has CollapsibleLayout props
+ */
+export declare function isCollapsibleLayoutProps(props: any): props is CollapsibleLayoutProps;
+/**
+ * Default props for CollapsibleLayout component
+ */
+export declare const defaultCollapsibleLayoutProps: Partial<CollapsibleLayoutProps>;
+/**
+ * Animation style configurations
+ */
+export interface AnimationConfig {
+    duration: number;
+    easing: string;
+    transform?: string;
+    opacity?: [number, number];
+}
+export declare const animationConfigs: Record<NonNullable<CollapsibleLayoutProps['animationStyle']>, AnimationConfig>;
+/**
+ * Spacing configurations
+ */
+export interface SpacingConfig {
+    padding: string;
+    gap?: string;
+}
+export declare const spacingConfigs: Record<NonNullable<CollapsibleLayoutProps['headerSpacing'] | CollapsibleLayoutProps['contentSpacing']>, SpacingConfig>;
+/**
+ * Utility type for extracting controlled vs uncontrolled props
+ */
+export type ControlledCollapsibleLayoutProps = CollapsibleLayoutProps & {
+    collapsed: boolean;
+    onToggle: (collapsed: boolean) => void;
+};
+export type UncontrolledCollapsibleLayoutProps = CollapsibleLayoutProps & {
+    defaultCollapsed?: boolean;
+    onToggle?: (collapsed: boolean) => void;
+};
+/**
+ * Hook return type for managing collapsed state
+ */
+export interface UseCollapsibleLayoutState {
+    collapsed: boolean;
+    toggle: () => void;
+    setCollapsed: (collapsed: boolean) => void;
+    isControlled: boolean;
+}
+//# sourceMappingURL=CollapsibleLayout.d.ts.map

package/dist/src/types/CollapsibleLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollapsibleLayout.d.ts","sourceRoot":"","sources":["../../../src/types/CollapsibleLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,sBAAsB,MAAM,oCAAoC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAC,sBAAsB,CAAC,GAC1E,aAAa,GAAG;IAKd;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAMxC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,sFAAsF;IACtF,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,8FAA8F;IAC9F,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,mFAAmF;IACnF,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,0FAA0F;IAC1F,YAAY,CAAC,EAAE,SAAS,CAAC;IAMzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAMzB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,gBAAgB,CAAC,EAAE;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B,EAAE,eAAe;CAAG;AAE9F;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,sBAAsB,CAEpF;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAAO,CAAC,sBAAsB,CAazE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,EAAE,eAAe,CAiB3G,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,eAAe,CAAC,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,EAAE,aAAa,CAajJ,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,sBAAsB,GAAG;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,sBAAsB,GAAG;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/dist/src/types/ContentProxy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * DataProxy class to enhance Data with nested property access
+ * This class wraps a Data object and provides a proxy to allow
+ * accessing nested properties using dot notation, e.g., {{company.name}}
+ *
+ * Copyright (c) 2024 QwickApps.com. All rights reserved.
+ */
+import { Data, Field, FieldGroup, Action } from "./DataTypes";
+/**
+ * Enhanced data with nested property access for template resolution
+ * Supports deep nested access like {{company.profile.address.city}}
+ */
+export declare class DataProxy implements Data {
+    name: string;
+    type: string;
+    title?: string;
+    subtitle?: string;
+    overline?: string;
+    icon?: string;
+    fields?: Field[];
+    fieldGroups?: FieldGroup[];
+    actions?: Action[];
+    repeatable?: boolean;
+    minRows?: number;
+    maxRows?: number;
+    autoCreate?: boolean;
+    private data;
+    constructor(content: Data, data?: Record<string, any>);
+    /**
+     * Get nested value from data using dot notation
+     * Supports: company.name, user.profile.avatar.url, etc.
+     */
+    private getNestedValue;
+    /**
+     * Set nested value in data using dot notation
+     */
+    setNestedValue(path: string, value: any): void;
+    /**
+     * Get all data including nested structures
+     */
+    getData(): Record<string, any>;
+    /**
+     * Update data while preserving nested structure
+     */
+    updateData(newData: Record<string, any>): void;
+}
+//# sourceMappingURL=ContentProxy.d.ts.map

package/dist/src/types/ContentProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentProxy.d.ts","sourceRoot":"","sources":["../../../src/types/ContentProxy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9D;;;GAGG;AACH,qBAAa,SAAU,YAAW,IAAI;IAC7B,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,CAAC,IAAI,CAAsB;gBAEtB,OAAO,EAAE,IAAI,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAkBzD;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAgBrD;;OAEG;IACI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIrC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAGtD"}

package/dist/src/types/DataTypes.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Content Types for QwickApps React Framework
+ *
+ * These interfaces define the framework-agnostic content structure that can be
+ * automatically created and managed across different CMS systems and used
+ * for template resolution and component rendering.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Base content structure - common properties for all content elements
+ */
+export interface BaseContent {
+    /** Unique identifier for this content element */
+    name: string;
+    /** Display title for this content element */
+    title?: string;
+    /** Subtitle or description */
+    subtitle?: string;
+    /** Short text displayed above the title */
+    overline?: string;
+    /** Icon identifier or URL for this content element */
+    icon?: string;
+}
+/**
+ * Individual content field definition
+ */
+export interface Field extends BaseContent {
+    /** The type of field */
+    type: string;
+    /** Current value of the field */
+    value?: any;
+    /** Default value for the field */
+    defaultValue?: any;
+    /** Whether this field is required */
+    required?: boolean;
+    /** Placeholder text for input fields */
+    placeholder?: string;
+    /** Help text or instructions */
+    instructions?: string;
+    /** Options for select/radio/checkbox fields */
+    choices?: Array<{
+        label: string;
+        value: any;
+    }>;
+    /** Minimum value (for numbers) or length (for text) */
+    min?: number;
+    /** Maximum value (for numbers) or length (for text) */
+    max?: number;
+    /** Regular expression for validation */
+    pattern?: string;
+}
+/**
+ * HTTP methods for form submission
+ */
+export declare enum FormMethod {
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH"
+}
+/**
+ * Action types for interactive elements
+ */
+export declare enum ActionType {
+    NAVIGATE = "navigate",
+    SUBMIT = "submit",
+    RESET = "reset",
+    CANCEL = "cancel"
+}
+/**
+ * Action definition for interactive elements
+ */
+export interface Action extends BaseContent {
+    /** The type of action */
+    type: ActionType;
+    /** Target URL for navigation actions */
+    target?: string;
+    /** JavaScript handler function name */
+    handler?: string;
+    /** Whether the action is disabled */
+    disabled?: boolean;
+}
+/**
+ * Field group - container for fields and nested field groups
+ */
+export interface FieldGroup extends BaseContent {
+    /** Child fields in this group */
+    fields?: Field[];
+    /** Nested field groups */
+    fieldGroups?: FieldGroup[];
+    /** Actions available for this field group */
+    actions?: Action[];
+    /** Whether this field group is repeatable */
+    repeatable?: boolean;
+    /** Minimum number of repetitions */
+    minRows?: number;
+    /** Maximum number of repetitions */
+    maxRows?: number;
+}
+/**
+ * Form-specific field with validation
+ */
+export interface FormField extends Field {
+    /** Validation rules for forms */
+    validation?: {
+        required?: boolean;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: RegExp;
+        custom?: (value: any) => boolean | string;
+    };
+}
+/**
+ * Form-specific action
+ */
+export interface FormAction extends Action {
+    type: ActionType;
+    /** Form validation behavior */
+    validateOnAction?: boolean;
+}
+/**
+ * Form field group
+ */
+export interface FormFieldGroup extends FieldGroup {
+    fields?: FormField[];
+    actions?: FormAction[];
+    /** Form submission endpoint */
+    submitUrl?: string;
+    /** Form method */
+    method?: FormMethod;
+}
+/**
+ * Content represents any structured data that can be persisted and managed
+ * through the CMS. All content is essentially a field group with a unique type name.
+ *
+ * Content types are string-based for maximum flexibility - can be anything
+ * as long as it's unique (e.g., 'contact', 'product', 'blog-post', 'testimonial').
+ */
+export interface Data extends FieldGroup {
+    /** The type of content - flexible string identifier */
+    type: string;
+    /** Whether this content should be auto-created if missing */
+    autoCreate?: boolean;
+}
+/**
+ * Generic link interface for database persistence
+ * This is a simple data structure, not a Content type
+ */
+export interface Link {
+    /** Unique identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** URL */
+    url: string;
+    /** Icon identifier or URL */
+    icon?: string;
+}
+/**
+ * Social media link extending base Link
+ * This is a simple data structure, not a Content type
+ */
+export interface SocialLink extends Link {
+    /** Social media platform */
+    platform: string;
+    /** Social media handle or username */
+    handle?: string;
+}
+/**
+ * Footer section containing multiple links
+ * This is a simple data structure, not a Content type
+ */
+export interface FooterSection {
+    /** Unique section identifier */
+    id: string;
+    /** Section title */
+    title: string;
+    /** Links in this section */
+    items: Link[];
+    /** Display order */
+    order?: number;
+    /** Whether section is visible */
+    visible?: boolean;
+}
+//# sourceMappingURL=DataTypes.d.ts.map

package/dist/src/types/DataTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTypes.d.ts","sourceRoot":"","sources":["../../../src/types/DataTypes.ts"],"names":[],"mappings":"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"}

package/dist/src/types/TemplateProvider.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure template resolution provider interface
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export interface TemplateProvider {
+    /** Resolve template with given context using mustache syntax */
+    resolve(template: string, context: any): string;
+}
+//# sourceMappingURL=TemplateProvider.d.ts.map

package/dist/src/types/TemplateProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateProvider.d.ts","sourceRoot":"","sources":["../../../src/types/TemplateProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC;CACjD"}

package/dist/src/types/TemplateResolver.d.ts

@@ -0,0 +1,23 @@
+import { ICacheProvider, IDataProvider } from "@qwickapps/schema";
+import { TemplateProvider } from "./TemplateProvider";
+/**
+ * Configuration for Data Provider orchestrator
+ */
+export interface TemplateResolverConfig {
+    /** Data provider for fetching raw data */
+    dataProvider: IDataProvider;
+    /** Template resolver (optional, defaults to MustacheTemplateResolver) */
+    templateResolver?: TemplateProvider;
+    /** Cache provider (optional, defaults to MemoryCacheProvider, false = no cache) */
+    cacheProvider?: ICacheProvider<any[]> | boolean;
+    /** Enable debug logging */
+    enableLogging?: boolean;
+} /**
+ * Content resolver interface
+ * This is now an orchestrator that combines data, template, and cache providers
+ */
+export interface ITemplateResolver extends IDataProvider {
+    /** Resolve template string with mustache syntax */
+    resolveTemplate(template: string): Promise<string>;
+}
+//# sourceMappingURL=TemplateResolver.d.ts.map

package/dist/src/types/TemplateResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateResolver.d.ts","sourceRoot":"","sources":["../../../src/types/TemplateResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,YAAY,EAAE,aAAa,CAAC;IAC5B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mFAAmF;IACnF,aAAa,CAAC,EAAE,cAAc,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IAChD,2BAA2B;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAA;;;GAGE;AAEH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,mDAAmD;IACnD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD"}

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

@@ -0,0 +1,82 @@
+/**
+ * Centralized Type Definitions for QwickApps React Framework
+ *
+ * This file consolidates all common types used throughout the framework
+ * to ensure consistency and eliminate duplication.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Standard t-shirt sizing system used across the framework
+ */
+export type TShirtSize = 'tiny' | 'small' | 'medium' | 'large' | 'x-large' | 'huge';
+/**
+ * MUI breakpoint values for responsive design
+ */
+export type MUIBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Extended MUI breakpoint names for better readability
+ */
+export type ExtendedBreakpoint = 'extra-small' | 'small' | 'medium' | 'large' | 'extra-large';
+/**
+ * Combined breakpoint type supporting all naming conventions
+ */
+export type BreakpointValue = MUIBreakpoint | ExtendedBreakpoint | false;
+/**
+ * Height presets commonly used in layout components
+ */
+export type HeightPreset = TShirtSize | 'viewport' | 'auto';
+/**
+ * Note: SpacingValue is defined in utils/spacing.ts to avoid circular dependencies
+ */
+/**
+ * Dimension values supporting CSS units and t-shirt sizes
+ */
+export type DimensionValue = TShirtSize | MUIBreakpoint | number | 'auto' | 'grow' | string | undefined;
+/**
+ * Background variant types for themed components
+ */
+export type BackgroundVariant = 'default' | 'primary' | 'secondary' | 'surface' | 'paper';
+/**
+ * Text alignment options
+ */
+export type TextAlignment = 'left' | 'center' | 'right' | 'justify';
+/**
+ * Common spacing presets for layout components
+ */
+export type SpacingPreset = 'none' | 'compact' | 'comfortable' | 'spacious';
+/**
+ * Component size variants (different from dimension sizes)
+ */
+export type ComponentSize = 'small' | 'medium' | 'large';
+/**
+ * Elevation levels for Material-UI components
+ */
+export type ElevationLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 8 | 12 | 16 | 24;
+/**
+ * Common variant styles for components
+ */
+export type ComponentVariant = 'default' | 'elevated' | 'outlined' | 'filled' | 'text';
+/**
+ * Animation durations
+ */
+export type AnimationDuration = 'fast' | 'medium' | 'slow' | number;
+/**
+ * Grid span values for layout systems
+ */
+export type GridSpan = number | 'auto' | 'grow';
+/**
+ * Color intensity levels
+ */
+export type ColorIntensity = 'light' | 'main' | 'dark';
+/**
+ * Common loading states
+ */
+export type LoadingState = 'idle' | 'loading' | 'success' | 'error';
+export * from './CacheProvider';
+export * from './CollapsibleLayout';
+export * from './ContentProxy';
+export * from './DataTypes';
+export * from './TemplateProvider';
+export * from './TemplateResolver';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,kBAAkB,GAAG,KAAK,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAExG;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAGpE,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Breakpoint utilities for QwickApps React Framework
+ *
+ * Consolidates all breakpoint-related logic and type conversions
+ * to ensure consistency across components.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { MUIBreakpoint, BreakpointValue, ExtendedBreakpoint } from '../types';
+/**
+ * Standard MUI breakpoint pixel values
+ */
+export declare const MUI_BREAKPOINT_VALUES: Record<MUIBreakpoint, number>;
+/**
+ * Converts any breakpoint value to MUI breakpoint format
+ * Handles extended names, MUI names, and false values
+ */
+export declare function mapToMUIBreakpoint(value?: BreakpointValue): MUIBreakpoint | false;
+/**
+ * Gets the pixel value for a breakpoint
+ */
+export declare function getBreakpointPixelValue(breakpoint: MUIBreakpoint | BreakpointValue): number;
+/**
+ * Type guard to check if a value is a valid MUI breakpoint
+ */
+export declare function isMUIBreakpoint(value: unknown): value is MUIBreakpoint;
+/**
+ * Type guard to check if a value is an extended breakpoint name
+ */
+export declare function isExtendedBreakpoint(value: unknown): value is ExtendedBreakpoint;
+/**
+ * Type guard to check if a value is any valid breakpoint
+ */
+export declare function isBreakpointValue(value: unknown): value is BreakpointValue;
+//# sourceMappingURL=breakpoints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","sourceRoot":"","sources":["../../../src/utils/breakpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAM/D,CAAC;AAaF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,KAAK,CAiBjF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,aAAa,GAAG,eAAe,GAAG,MAAM,CAM3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/src/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/src/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/src/utils/customPaletteManager.d.ts

@@ -0,0 +1,8 @@
+export function saveCustomPalette(palette: Object): void;
+export function getCustomPalettes(): any[];
+export function deleteCustomPalette(paletteId: string): void;
+export function exportPalette(palette: Object): void;
+export function importPalette(file: File): Promise<Object>;
+export function createPaletteFromCurrentTheme(name: string, description: string): Object;
+export function applyCustomPalette(palette: Object): void;
+//# sourceMappingURL=customPaletteManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customPaletteManager.d.ts","sourceRoot":"","sources":["../../../src/utils/customPaletteManager.js"],"names":[],"mappings":"AAUO,2CAFI,MAAM,QAahB;AAMM,2CAQN;AAMM,+CAFI,MAAM,QAYhB;AAMM,uCAFI,MAAM,QAYhB;AAOM,oCAHI,IAAI,GACF,OAAO,CAAC,MAAM,CAAC,CA+B3B;AAQM,oDAJI,MAAM,eACN,MAAM,GACJ,MAAM,CAoElB;AAMM,4CAFI,MAAM,QAgChB"}

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

@@ -0,0 +1,34 @@
+/**
+ * Dimension utilities for QwickApps React Framework
+ *
+ * Provides standardized dimension value resolution with t-shirt sizing
+ * and MUI breakpoint compatibility
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { DimensionValue } from '../types';
+export type { DimensionValue };
+export type DimensionContext = 'width' | 'height' | 'maxWidth' | 'maxHeight' | 'minWidth' | 'minHeight';
+/**
+ * Resolves a dimension value to a valid CSS value
+ */
+export declare function resolveDimension(value: DimensionValue, context?: DimensionContext): string | number | undefined;
+/**
+ * Resolves multiple dimension props at once
+ */
+export declare function resolveDimensions(props: {
+    width?: DimensionValue;
+    height?: DimensionValue;
+    minWidth?: DimensionValue;
+    minHeight?: DimensionValue;
+    maxWidth?: DimensionValue;
+    maxHeight?: DimensionValue;
+}): {
+    width: string | number | undefined;
+    height: string | number | undefined;
+    minWidth: string | number | undefined;
+    minHeight: string | number | undefined;
+    maxWidth: string | number | undefined;
+    maxHeight: string | number | undefined;
+};
+//# sourceMappingURL=dimensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../../src/utils/dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,UAAU,CAAC;AAG1E,YAAY,EAAE,cAAc,EAAE,CAAC;AAG/B,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AA6DxG;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,gBAA0B,GAClC,MAAM,GAAG,MAAM,GAAG,SAAS,CA2C7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;;;;;;;EASA"}