@qwickapps/react-framework 1.4.0 → 1.4.2

package/dist/src/components/layout/GridCellWrapper.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GridCellWrapper - Responsive grid cell wrapper for layout consistency
+ *
+ * This component provides a flexible wrapper for content within a Material-UI Grid,
+ * supporting responsive sizing, full-width option, and easy integration with form fields or layout elements.
+ *
+ * Features:
+ * - Responsive grid sizing via breakpoint props (xs, sm, md, lg, xl)
+ * - Optional fullWidth prop to force cell to span all columns
+ * - Passes additional GridProps for customization
+ * - Designed for use in forms and layouts needing consistent grid behavior
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+import { GridProps } from '@mui/material';
+/**
+ * Props for GridCellWrapper
+ * @property children - Content to render inside the grid cell
+ * @property xs, sm, md, lg, xl - Grid breakpoint sizes (number or 'auto')
+ * @property fullWidth - If true, cell spans all columns (xs=12)
+ * @property ...gridProps - Additional GridProps except 'item' and 'children'
+ */
+export interface GridCellWrapperProps extends Omit<GridProps, 'children'> {
+    /** Content to render inside the grid cell */
+    children: React.ReactNode;
+    /** Grid breakpoint size for extra-small screens */
+    xs?: number | 'auto';
+    /** Grid breakpoint size for small screens */
+    sm?: number | 'auto';
+    /** Grid breakpoint size for medium screens */
+    md?: number | 'auto';
+    /** Grid breakpoint size for large screens */
+    lg?: number | 'auto';
+    /** Grid breakpoint size for extra-large screens */
+    xl?: number | 'auto';
+    /** If true, cell spans all columns (xs=12) */
+    fullWidth?: boolean;
+}
+/**
+ * GridCellWrapper component
+ * Wraps content in a Material-UI Grid cell with responsive sizing and full-width option.
+ */
+declare const GridCellWrapper: React.FC<GridCellWrapperProps>;
+export default GridCellWrapper;
+//# sourceMappingURL=GridCellWrapper.d.ts.map

package/dist/src/components/layout/GridCellWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridCellWrapper.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/GridCellWrapper.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAQ,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACvE,6CAA6C;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAsCnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/src/components/layout/GridLayout.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GridLayout - Factory-based implementation using createSerializableView
+ *
+ * Migrated from class-based ModelView to factory pattern for better
+ * schema-driven architecture while preserving all functionality.
+ *
+ * Works with any component that has grid props (span, xs, sm, md, lg, xl)
+ * Automatically wraps components in Grid when grid props are detected
+ * Full serialization support
+ *
+ * Usage:
+ * - Traditional: <GridLayout columns={3} spacing="medium">...</GridLayout>
+ * - Data-driven: <GridLayout dataSource="layouts.main" />
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { SerializableComponent } from '../shared/createSerializableView';
+import { ViewProps } from '../shared/viewProps';
+/**
+ * Props interface for GridLayout component - extends ViewProps
+ */
+export interface GridLayoutProps extends ViewProps {
+    /** Number of equal-width columns for auto-distribution */
+    columns?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Spacing between grid items */
+    spacing?: string;
+    /** Make all grid items the same height */
+    equalHeight?: boolean;
+    /** Grid container height */
+    height?: string;
+    /** Grid container width */
+    width?: string;
+    /** Minimum grid container height */
+    minHeight?: string;
+    /** Minimum grid container width */
+    minWidth?: string;
+    /** Maximum grid container height */
+    maxHeight?: string;
+    /** Maximum grid container width */
+    maxWidth?: string;
+}
+/**
+ * Create GridLayout component using the factory pattern
+ */
+export declare const GridLayout: SerializableComponent<GridLayoutProps>;
+/**
+ * Export the component as default
+ */
+export default GridLayout;
+//# sourceMappingURL=GridLayout.d.ts.map

package/dist/src/components/layout/GridLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridLayout.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/GridLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAA0B,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyID;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,qBAAqB,CAAC,eAAe,CAK5D,CAAC;AAEH;;GAEG;AACH,eAAe,UAAU,CAAC"}

package/dist/src/components/layout/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Layout components export
+ *
+ * Layout components using the new base props pattern
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { GridLayout } from './GridLayout';
+export type { GridLayoutProps } from './GridLayout';
+export { GridCell } from './GridCell';
+export type { GridCellProps } from './GridCell';
+export { CollapsibleLayout, CollapsibleLayoutView, useCollapsibleState } from './CollapsibleLayout';
+export type { CollapsibleLayoutProps, CollapsibleLayoutViewProps, UseCollapsibleLayoutState } from './CollapsibleLayout';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpG,YAAY,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/components/menu/Menu.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=Menu.d.ts.map

package/dist/src/components/menu/Menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/Menu.tsx"],"names":[],"mappings":""}

package/dist/src/components/menu/MenuItem.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MenuItem - Standardized menu item type for navigation components
+ *
+ * Used by Scaffold, navigation rails, drawers, and other menu systems.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+export interface MenuItem {
+    /** Unique identifier for the menu item */
+    id: string;
+    /** Display label for the menu item */
+    label: string;
+    /** Icon component or JSX element to display */
+    icon?: React.ReactNode;
+    /** Click handler for the menu item */
+    onClick?: () => void;
+    /** External link URL (if this is a link) */
+    href?: string;
+    /** Route path for automatic navigation (React Router) */
+    route?: string;
+    /** Whether this item is currently active/selected */
+    active?: boolean;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Badge text or number to display */
+    badge?: string | number;
+    /** Priority for ordering (lower numbers = higher priority) */
+    priority?: number;
+}
+//# sourceMappingURL=MenuItem.d.ts.map

package/dist/src/components/menu/MenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuItem.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/MenuItem.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/components/menu/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Menu components export
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { type MenuItem } from './MenuItem';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/menu/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/components/pages/FormPage.d.ts

@@ -0,0 +1,66 @@
+/**
+ * FormPage - Reusable page layout for forms with consistent header, status, and footer
+ *
+ * Provides a standardized full-page layout for forms with:
+ * - CoverImageHeader as the default header with smart branding defaults
+ * - Status message handling (info, success, warning, error)
+ * - Consistent form container and footer
+ * - Background variants (default, gradient, image)
+ * - Responsive design for all screen sizes
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+export interface FormPageProps {
+    /**
+     * Page title (required)
+     */
+    title: string;
+    /**
+     * Page subtitle/description
+     */
+    description?: string;
+    /**
+     * Cover image URL or React element for the header
+     * If not provided, will use Logo component with app name
+     */
+    coverImage?: string | React.ReactNode;
+    /**
+     * Form content (required)
+     */
+    form: React.ReactNode;
+    /**
+     * Footer content
+     */
+    footer?: React.ReactNode;
+    /**
+     * Status message type
+     */
+    status?: 'info' | 'success' | 'warning' | 'error';
+    /**
+     * Status message content
+     */
+    message?: string;
+    /**
+     * Maximum width of the form container
+     */
+    maxWidth?: 'xs' | 'sm' | 'md';
+    /**
+     * Background style variant
+     */
+    background?: 'default' | 'gradient' | 'image';
+    /**
+     * Background image URL (when background='image')
+     */
+    backgroundImage?: string;
+    /**
+     * Custom styling
+     */
+    sx?: object;
+}
+/**
+ * FormPage component for consistent form page layouts
+ */
+export declare const FormPage: React.FC<FormPageProps>;
+export default FormPage;
+//# sourceMappingURL=FormPage.d.ts.map

package/dist/src/components/pages/FormPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPage.d.ts","sourceRoot":"","sources":["../../../../src/components/pages/FormPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IAEtC;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAElD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAE9C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA2B5C,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/src/components/pages/Page.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Page provides a unified Page component supporting:
+ *  - Layout variants (width, padding, background)
+ *  - Template-based metadata (title / description / slug)
+ *  - Declarative print mode with dynamic header/footer sizing
+ *  - Centralized context (route, loading/error flags, print controls)
+ *  - Optional class-based extension (Page) for legacy / OOP style
+ *
+ * Typical usage (functional):
+ *   <Page title="Orders" printConfig={{ printTitle: 'Orders' }}>
+ *     <OrdersList />
+ *   </Page>
+ *
+ * Class-based (override only what you need):
+ *   class OrdersPage extends Page {
+ *     protected getPageProps() { return { title: 'Orders' }; }
+ *     protected renderPrintView() { return <PrintOnlyLayout />; }
+ *   }
+ *
+ * Printing:
+ *   const { triggerPrint } = usePageContext();
+ *   triggerPrint(optionalOverrides);
+ *
+ * Copyright (c) 2025 QwickApps
+ */
+import React from 'react';
+import { WithBaseProps } from '../../hooks/useBaseProps';
+import { PageTemplateSchema } from '../../schemas/PageTemplateSchema';
+import { PrintConfigSchema } from '../../schemas/PrintConfigSchema';
+import './Page.css';
+export interface PageContextValue {
+    route?: string;
+    isPrintMode: boolean;
+    printConfig: PrintConfigSchema;
+    triggerPrint: (config?: Partial<PrintConfigSchema>) => void;
+    setLoading: (loading: boolean) => void;
+    setError: (error: string | null) => void;
+    isLoading: boolean;
+    error: string | null;
+}
+export declare const usePageContext: () => PageContextValue;
+export interface PageProps extends WithBaseProps {
+    route?: string;
+    variant?: 'default' | 'centered' | 'narrow' | 'wide' | 'fullwidth';
+    padding?: 'none' | 'small' | 'medium' | 'large';
+    background?: 'default' | 'surface' | 'alternate';
+    maxWidth?: 'small' | 'medium' | 'large' | 'extra-large' | 'none';
+    printConfig?: Partial<PrintConfigSchema>;
+    template?: PageTemplateSchema;
+    title?: string;
+    description?: string;
+    name?: string;
+    slug?: string;
+    children?: React.ReactNode;
+}
+interface PageViewProps extends PageProps {
+    renderView: () => React.ReactNode;
+    renderPrintView: () => React.ReactNode;
+}
+export declare const PageView: React.FC<PageViewProps>;
+export declare class Page<P extends PageProps = PageProps, S = {}> extends React.Component<P, S> {
+    protected getPageProps(): Partial<PageProps>;
+    protected renderView(): React.ReactNode;
+    protected renderPrintView(): React.ReactNode;
+    render(): import("react/jsx-runtime").JSX.Element;
+}
+export default Page;
+//# sourceMappingURL=Page.d.ts.map

package/dist/src/components/pages/Page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../../src/components/pages/Page.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAQN,MAAM,OAAO,CAAC;AAEf,OAAO,EAAgB,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAIpE,OAAO,YAAY,CAAC;AAMpB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC5D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAID,eAAO,MAAM,cAAc,QAAO,gBAIjC,CAAC;AAyEF,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAKD,UAAU,aAAc,SAAQ,SAAS;IACvC,UAAU,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;CACxC;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0M5C,CAAC;AAKF,qBAAa,IAAI,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,CAAE,SAAQ,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IACtF,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAC5C,SAAS,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS;IACvC,SAAS,CAAC,eAAe,IAAI,KAAK,CAAC,SAAS;IAE5C,MAAM;CAaP;AAED,eAAe,IAAI,CAAC"}

package/dist/src/components/pages/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * All page components available in QwickApps React Framework.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { default as FormPage } from './FormPage';
+export { default as Page, usePageContext } from './Page';
+export type { FormPageProps } from './FormPage';
+export type { PageContextValue, PageProps } from './Page';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/pages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/pages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEzD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC"}

package/dist/src/components/shared/createSerializableView.d.ts

@@ -0,0 +1,81 @@
+/**
+ * createSerializableView - Factory for schema-driven components
+ *
+ * Creates functional components that:
+ * - Normalize schema props using normalizeViewProps
+ * - Apply useBaseProps exactly once for style/html/grid processing
+ * - Optionally integrate data binding (gated by enabled flag)
+ * - Attach static tagName/version/fromJson/toJson for serialization
+ *
+ * Works seamlessly with existing BaseComponentProps system and provides
+ * the foundation for the new schema-driven architecture.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ComponentType, ReactElement } from 'react';
+import { QWICKAPP_COMPONENT } from '../../hooks';
+import { ViewProps } from './viewProps';
+/**
+ * Children handling strategy for serialization
+ */
+type ChildrenStrategy = {
+    mode: 'react-children';
+} | {
+    mode: 'content-prop';
+    propName?: string;
+};
+/**
+ * Component factory configuration
+ */
+interface CreateSerializableViewConfig<P extends ViewProps> {
+    /** Component tag name for serialization */
+    tagName: string;
+    /** Component version for serialization */
+    version: string;
+    /** Component role: 'view' for display components, 'container' for layout components */
+    role: 'view' | 'container';
+    /** View function that renders the component */
+    View: ComponentType<P>;
+    /** Children handling strategy - defaults to 'react-children' */
+    childrenStrategy?: ChildrenStrategy;
+    /** Optional prop finalizer function */
+    finalize?: (props: P) => P;
+}
+/**
+ * Serializable component interface with all required static properties
+ */
+export interface SerializableComponent<P extends ViewProps> {
+    (props: P): ReactElement;
+    tagName: string;
+    version: string;
+    fromJson: (data: any) => ReactElement;
+    toJson: (props: P) => any;
+    displayName?: string;
+    [QWICKAPP_COMPONENT]: symbol;
+}
+/**
+ * Create a serializable view component using the factory pattern
+ *
+ * @param config - Factory configuration
+ * @returns Serializable component with attached static methods
+ */
+export declare function createSerializableView<P extends ViewProps>(config: CreateSerializableViewConfig<P>): SerializableComponent<P>;
+/**
+ * Type helper for components created with createSerializableView
+ */
+export type SerializableViewComponent<P extends ViewProps> = SerializableComponent<P>;
+/**
+ * Type guard to check if a component is serializable
+ */
+export declare function isSerializableComponent(component: any): component is SerializableComponent<any>;
+/**
+ * Extract component metadata for registration
+ */
+export declare function getComponentMetadata(component: SerializableComponent<any>): {
+    tagName: string;
+    version: string;
+    fromJson: (data: any) => ReactElement;
+    toJson: (props: any) => any;
+};
+export {};
+//# sourceMappingURL=createSerializableView.d.ts.map

package/dist/src/components/shared/createSerializableView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSerializableView.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/createSerializableView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAc,EAAE,aAAa,EAAE,YAAY,EAAa,MAAM,OAAO,CAAC;AAEtE,OAAO,EAAgC,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAsB,SAAS,EAAE,MAAM,aAAa,CAAC;AAa5D;;GAEG;AACH,KAAK,gBAAgB,GACjB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD;;GAEG;AACH,UAAU,4BAA4B,CAAC,CAAC,SAAS,SAAS;IACxD,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACvB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,SAAS;IACxD,CAAC,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,YAAY,CAAC;IACtC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,SAAS,EACxD,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACtC,qBAAqB,CAAC,CAAC,CAAC,CA4K1B;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,SAAS,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC;AAEtF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAQ/F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,qBAAqB,CAAC,GAAG,CAAC;;;qBAjNvD,GAAG,KAAK,YAAY;4BACf,GAAG;EAuN1B"}

package/dist/src/components/shared/viewProps.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ViewProps - Runtime-friendly props derived from ViewSchema
+ *
+ * Provides normalized view props that integrate seamlessly with the existing
+ * BaseComponentProps system and useBaseProps hook. Handles type conversion
+ * from schema strings to proper React prop types including event handlers,
+ * styling props, and grid values.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { SchemaProps, WithDataBinding } from '@qwickapps/schema';
+import { BaseComponentProps } from '../../hooks/useBaseProps';
+import { ViewSchema } from '../../schemas/ViewSchema';
+/**
+ * ViewProps - Single source of truth for all base component props
+ *
+ * Extends SchemaProps<ViewSchema> to get all base properties with proper types
+ * and adds WithDataBinding for CMS integration. ViewSchema is the authoritative
+ * source for all base props including styling, grid, events, accessibility, etc.
+ */
+export interface ViewProps extends SchemaProps<ViewSchema>, WithDataBinding {
+    children?: React.ReactNode;
+}
+/**
+ * Normalize ViewProps for runtime use
+ *
+ * Converts schema-friendly string props to runtime-friendly React props:
+ * - Parses sx/style JSON strings
+ * - Converts string event handlers to functions
+ * - Coerces grid span/breakpoint values from strings to numbers/keywords
+ * - Maintains compatibility with BaseComponentProps system
+ *
+ * @param props - Raw ViewProps from schema
+ * @returns Normalized props compatible with useBaseProps
+ */
+export declare function normalizeViewProps<T extends ViewProps>(props: T): T & BaseComponentProps;
+//# sourceMappingURL=viewProps.d.ts.map

package/dist/src/components/shared/viewProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewProps.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/viewProps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW,CAAC,UAAU,CAAC,EAAE,eAAe;IAEzE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA4GD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,kBAAkB,CA4DxF"}

package/dist/src/config/AppConfig.d.ts

@@ -0,0 +1,49 @@
+/**
+ * QwickApps AppConfig Implementation
+ *
+ * Immutable configuration object with computed properties for Vite and PWA.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { UserConfig as ViteUserConfig } from 'vite';
+import type { AppConfig as IAppConfig, AppIdentity, BuildConfig, PWAConfig, UIConfig, CopyrightConfig } from './types';
+/**
+ * Immutable application configuration
+ */
+export declare class AppConfig implements IAppConfig {
+    readonly app: AppIdentity;
+    readonly build: BuildConfig;
+    readonly pwa: PWAConfig;
+    readonly ui: UIConfig;
+    readonly copyright: CopyrightConfig;
+    constructor(config: {
+        app: AppIdentity;
+        build: BuildConfig;
+        pwa: PWAConfig;
+        ui: UIConfig;
+        copyright: CopyrightConfig;
+    });
+    /**
+     * Generate complete Vite configuration
+     */
+    get viteConfig(): ViteUserConfig;
+    /**
+     * Generate PWA manifest
+     */
+    get pwaManifest(): Record<string, any>;
+    /**
+     * Convert to plain object (for serialization)
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Create a copy with overrides (returns new immutable instance)
+     */
+    with(overrides: Partial<{
+        app: Partial<AppIdentity>;
+        build: Partial<BuildConfig>;
+        pwa: Partial<PWAConfig>;
+        ui: Partial<UIConfig>;
+        copyright: Partial<CopyrightConfig>;
+    }>): AppConfig;
+}
+//# sourceMappingURL=AppConfig.d.ts.map

package/dist/src/config/AppConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppConfig.d.ts","sourceRoot":"","sources":["../../../src/config/AppConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EACV,SAAS,IAAI,UAAU,EACvB,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,SAAgB,GAAG,EAAE,WAAW,CAAC;IACjC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,GAAG,EAAE,SAAS,CAAC;IAC/B,SAAgB,EAAE,EAAE,QAAQ,CAAC;IAC7B,SAAgB,SAAS,EAAE,eAAe,CAAC;gBAE/B,MAAM,EAAE;QAClB,GAAG,EAAE,WAAW,CAAC;QACjB,KAAK,EAAE,WAAW,CAAC;QACnB,GAAG,EAAE,SAAS,CAAC;QACf,EAAE,EAAE,QAAQ,CAAC;QACb,SAAS,EAAE,eAAe,CAAC;KAC5B;IAYD;;OAEG;IACH,IAAI,UAAU,IAAI,cAAc,CAqB/B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAwBrC;IAED;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAU7B;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACtB,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5B,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACxB,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;KACrC,CAAC,GAAG,SAAS;CASf"}

package/dist/src/config/AppConfigBuilder.d.ts

@@ -0,0 +1,75 @@
+/**
+ * QwickApps AppConfigBuilder
+ *
+ * Builder pattern for creating validated, immutable AppConfig instances.
+ * Supports fluent API and deferred validation.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { AppConfig } from './AppConfig';
+import type { AppConfigOptions } from './types';
+/**
+ * Builder for creating AppConfig instances with validation
+ */
+export declare class AppConfigBuilder {
+    private config;
+    private options;
+    private constructor();
+    /**
+     * Create a new AppConfigBuilder instance
+     */
+    static create(): AppConfigBuilder;
+    /**
+     * Load configuration from JSON file (Node.js only)
+     */
+    withConfig(configPath: string): AppConfigBuilder;
+    /**
+     * Set builder options
+     */
+    withOptions(options: AppConfigOptions): AppConfigBuilder;
+    withName(name: string): AppConfigBuilder;
+    withId(id: string): AppConfigBuilder;
+    withShortName(shortName: string): AppConfigBuilder;
+    withDescription(description: string): AppConfigBuilder;
+    withVersion(version: string): AppConfigBuilder;
+    withLogo(logo: string): AppConfigBuilder;
+    withAuthor(author: string): AppConfigBuilder;
+    withHomepage(homepage: string): AppConfigBuilder;
+    withPort(port: number): AppConfigBuilder;
+    withPreviewPort(previewPort: number): AppConfigBuilder;
+    withOutputDir(outputDir: string): AppConfigBuilder;
+    withPublicPath(publicPath: string): AppConfigBuilder;
+    withBase(base: string): AppConfigBuilder;
+    withThemeColor(themeColor: string): AppConfigBuilder;
+    withBackgroundColor(backgroundColor: string): AppConfigBuilder;
+    withStartUrl(startUrl: string): AppConfigBuilder;
+    withScope(scope: string): AppConfigBuilder;
+    withDisplay(display: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser'): AppConfigBuilder;
+    withOrientation(orientation: 'portrait' | 'landscape' | 'any'): AppConfigBuilder;
+    withDefaultTheme(defaultTheme: 'light' | 'dark' | 'system'): AppConfigBuilder;
+    withDefaultPalette(defaultPalette: string): AppConfigBuilder;
+    withScaffolding(enableScaffolding: boolean): AppConfigBuilder;
+    withThemeSwitcher(showThemeSwitcher: boolean): AppConfigBuilder;
+    withPaletteSwitcher(showPaletteSwitcher: boolean): AppConfigBuilder;
+    withCopyright(year: 'auto' | number, author: string, text?: string): AppConfigBuilder;
+    withCopyrightYear(year: 'auto' | number): AppConfigBuilder;
+    withCopyrightAuthor(author: string): AppConfigBuilder;
+    withCopyrightText(text: string): AppConfigBuilder;
+    /**
+     * Build and validate the configuration
+     */
+    build(): AppConfig;
+    /**
+     * Validate the current configuration
+     */
+    private validate;
+    /**
+     * Apply default values to configuration
+     */
+    private applyDefaults;
+    /**
+     * Simple color validation
+     */
+    private isValidColor;
+}
+//# sourceMappingURL=AppConfigBuilder.d.ts.map

package/dist/src/config/AppConfigBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppConfigBuilder.d.ts","sourceRoot":"","sources":["../../../src/config/AppConfigBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAMV,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CA4CZ;IAEF,OAAO,CAAC,OAAO,CAAwB;IAEvC,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,gBAAgB;IAIjC;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IA0BhD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB;IAMxD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKxC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;IAKpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAKlD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAKtD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAK9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKxC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAK5C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAMhD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKxC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAKtD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAKlD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAKpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAMxC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAKpD,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB;IAK9D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAKhD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAK1C,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB;IAK9F,eAAe,CAAC,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,gBAAgB;IAMhF,gBAAgB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,gBAAgB;IAK7E,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB;IAK5D,eAAe,CAAC,iBAAiB,EAAE,OAAO,GAAG,gBAAgB;IAK7D,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,GAAG,gBAAgB;IAK/D,mBAAmB,CAAC,mBAAmB,EAAE,OAAO,GAAG,gBAAgB;IAMnE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAOrF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB;IAK1D,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAKrD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKjD;;OAEG;IACH,KAAK,IAAI,SAAS;IAkBlB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoDhB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoDrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}

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

@@ -0,0 +1,13 @@
+/**
+ * QwickApps Configuration Module
+ *
+ * Exports configuration types and utilities for QwickApp applications.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { AppConfig } from './AppConfig';
+export { AppConfigBuilder } from './AppConfigBuilder';
+export type { AppConfig as IAppConfig, AppIdentity, BuildConfig, PWAConfig, UIConfig, CopyrightConfig, AppConfigOptions, ValidationResult, } from './types';
+import { AppConfigBuilder } from './AppConfigBuilder';
+export declare const createAppConfig: typeof AppConfigBuilder.create;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,SAAS,IAAI,UAAU,EACvB,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,eAAO,MAAM,eAAe,gCAA0B,CAAC"}