@qwickapps/react-framework 1.4.1 → 1.4.2

package/dist/src/schemas/SwitchInputFieldSchema.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SwitchInputField Schema - Data model for switch input field component
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ViewSchema } from './ViewSchema';
+export declare class SwitchInputFieldModel extends ViewSchema {
+    label?: string;
+    checked?: boolean;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    helperText?: string;
+    size?: 'small' | 'medium';
+    color?: 'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning';
+}
+export default SwitchInputFieldModel;
+//# sourceMappingURL=SwitchInputFieldSchema.d.ts.map

package/dist/src/schemas/SwitchInputFieldSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwitchInputFieldSchema.d.ts","sourceRoot":"","sources":["../../../src/schemas/SwitchInputFieldSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,qBACa,qBAAsB,SAAQ,UAAU;IASnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,OAAO,CAAC,EAAE,OAAO,CAAC;IAUlB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAUnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAUnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,UAAU,CAAC,EAAE,MAAM,CAAC;IAUpB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAU1B,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACxF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/src/schemas/TextInputFieldSchema.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Schema for TextInputField component - Reusable text input with consistent styling
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import 'reflect-metadata';
+import { ViewSchema } from './ViewSchema';
+export declare class TextInputFieldModel extends ViewSchema {
+    label?: string;
+    value?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    helperText?: string;
+    placeholder?: string;
+    type?: string;
+    multiline?: boolean;
+    rows?: number;
+    maxRows?: number;
+}
+export default TextInputFieldModel;
+//# sourceMappingURL=TextInputFieldSchema.d.ts.map

package/dist/src/schemas/TextInputFieldSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInputFieldSchema.d.ts","sourceRoot":"","sources":["../../../src/schemas/TextInputFieldSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qBACa,mBAAoB,SAAQ,UAAU;IASjD,KAAK,CAAC,EAAE,MAAM,CAAC;IAWf,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAUnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAWnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAWf,UAAU,CAAC,EAAE,MAAM,CAAC;IAWpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAWrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAUd,SAAS,CAAC,EAAE,OAAO,CAAC;IAUpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAUd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAe,mBAAmB,CAAC"}

package/dist/src/schemas/TextSchema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Schema for Text component - Comprehensive typography component
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { ReactNode } from 'react';
+import 'reflect-metadata';
+import { Model } from '@qwickapps/schema';
+export type TextVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'subtitle1' | 'subtitle2' | 'body1' | 'body2' | 'button' | 'caption' | 'overline';
+export type TextAlign = 'left' | 'center' | 'right' | 'justify' | 'inherit';
+export type TextColor = 'primary' | 'secondary' | 'textPrimary' | 'textSecondary' | 'error' | 'warning' | 'info' | 'success' | 'inherit';
+export type TextElement = 'p' | 'span' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'legend';
+export type TextDecoration = 'none' | 'underline' | 'overline' | 'line-through';
+export type FontWeight = 'inherit' | 'lighter' | 'normal' | 'bold' | 'bolder' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
+export type TextTransform = 'none' | 'capitalize' | 'uppercase' | 'lowercase' | 'inherit';
+export declare class TextModel extends Model {
+    content?: string;
+    variant?: TextVariant;
+    color?: TextColor;
+    align?: TextAlign;
+    component?: TextElement;
+    fontWeight?: FontWeight;
+    textDecoration?: TextDecoration;
+    textTransform?: TextTransform;
+    noWrap?: boolean;
+    paragraph?: boolean;
+    gutterBottom?: boolean;
+    fontSize?: string;
+    lineHeight?: string;
+    letterSpacing?: string;
+    fontFamily?: string;
+    customColor?: string;
+    maxWidth?: string;
+    children?: ReactNode;
+}
+export default TextModel;
+//# sourceMappingURL=TextSchema.d.ts.map

package/dist/src/schemas/TextSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSchema.d.ts","sourceRoot":"","sources":["../../../src/schemas/TextSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAyB,KAAK,EAAuB,MAAM,mBAAmB,CAAC;AAGtF,MAAM,MAAM,WAAW,GACnB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,WAAW,GAAG,WAAW,GACzB,OAAO,GAAG,OAAO,GACjB,QAAQ,GACR,SAAS,GACT,UAAU,CAAC;AAGf,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAG5E,MAAM,MAAM,SAAS,GACjB,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,eAAe,GACzD,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GACxC,SAAS,CAAC;AAGd,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;AAG9G,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;AAGhF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAGtJ,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1F,qBACa,SAAU,SAAQ,KAAK;IAUlC,OAAO,CAAC,EAAE,MAAM,CAAC;IA4BjB,OAAO,CAAC,EAAE,WAAW,CAAC;IAwBtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAoBlB,KAAK,CAAC,EAAE,SAAS,CAAC;IA0BlB,SAAS,CAAC,EAAE,WAAW,CAAC;IA6BxB,UAAU,CAAC,EAAE,UAAU,CAAC;IAmBxB,cAAc,CAAC,EAAE,cAAc,CAAC;IAoBhC,aAAa,CAAC,EAAE,aAAa,CAAC;IAU9B,MAAM,CAAC,EAAE,OAAO,CAAC;IAUjB,SAAS,CAAC,EAAE,OAAO,CAAC;IAUpB,YAAY,CAAC,EAAE,OAAO,CAAC;IAWvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAWlB,UAAU,CAAC,EAAE,MAAM,CAAC;IAWpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAWvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAWpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAWrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAWlB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAe,SAAS,CAAC"}

package/dist/src/schemas/ThemeSwitcherSchema.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Schema for ThemeSwitcher component - Theme selection control
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import 'reflect-metadata';
+import { Model } from '@qwickapps/schema';
+export declare class ThemeSwitcherModel extends Model {
+    disabled?: boolean;
+    size?: 'small' | 'medium' | 'large';
+    tooltipText?: string;
+    showTooltip?: boolean;
+    menuPosition?: 'bottom' | 'top' | 'left' | 'right';
+    showLightTheme?: boolean;
+    showDarkTheme?: boolean;
+    showSystemTheme?: boolean;
+}
+export default ThemeSwitcherModel;
+//# sourceMappingURL=ThemeSwitcherSchema.d.ts.map

package/dist/src/schemas/ThemeSwitcherSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeSwitcherSchema.d.ts","sourceRoot":"","sources":["../../../src/schemas/ThemeSwitcherSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAyB,KAAK,EAAa,MAAM,mBAAmB,CAAC;AAE5E,qBACa,kBAAmB,SAAQ,KAAK;IAS3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAWnB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAWpC,WAAW,CAAC,EAAE,MAAM,CAAC;IAUrB,WAAW,CAAC,EAAE,OAAO,CAAC;IAWtB,YAAY,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAUnD,cAAc,CAAC,EAAE,OAAO,CAAC;IAUzB,aAAa,CAAC,EAAE,OAAO,CAAC;IAUxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAe,kBAAkB,CAAC"}

package/dist/src/schemas/ViewSchema.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ViewSchema - Comprehensive base class for all view components
+ *
+ * Provides ALL props from BaseComponentProps as schema fields including:
+ * - Grid layout props (span, breakpoints)
+ * - Dimension props (width, height with t-shirt sizing)
+ * - Spacing props (padding, margin with t-shirt sizing)
+ * - Background and styling props
+ * - Accessibility and HTML attributes
+ * - Event handlers
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { Model } from '@qwickapps/schema';
+import type { SxProps, Theme } from '@mui/material/styles';
+import 'reflect-metadata';
+import type { FocusEventHandler, MouseEventHandler } from 'react';
+export declare class ViewSchema extends Model {
+    span?: number | 'auto' | 'grow';
+    xs?: number | 'auto';
+    sm?: number | 'auto';
+    md?: number | 'auto';
+    lg?: number | 'auto';
+    xl?: number | 'auto';
+    className?: string;
+    sx?: SxProps<Theme>;
+    style?: React.CSSProperties;
+    width?: string | number;
+    height?: string | number;
+    minWidth?: string | number;
+    minHeight?: string | number;
+    maxWidth?: string | number;
+    maxHeight?: string | number;
+    padding?: string | number;
+    paddingTop?: string | number;
+    paddingRight?: string | number;
+    paddingBottom?: string | number;
+    paddingLeft?: string | number;
+    paddingX?: string | number;
+    paddingY?: string | number;
+    margin?: string | number;
+    marginTop?: string | number;
+    marginRight?: string | number;
+    marginBottom?: string | number;
+    marginLeft?: string | number;
+    marginX?: string | number;
+    marginY?: string | number;
+    background?: string;
+    backgroundColor?: string;
+    backgroundImage?: string;
+    backgroundGradient?: string;
+    textAlign?: 'left' | 'center' | 'right' | 'justify';
+    id?: string;
+    role?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'data-testid'?: string;
+    onClick?: MouseEventHandler<any>;
+    onMouseEnter?: MouseEventHandler<any>;
+    onMouseLeave?: MouseEventHandler<any>;
+    onFocus?: FocusEventHandler<any>;
+    onBlur?: FocusEventHandler<any>;
+}
+export default ViewSchema;
+//# sourceMappingURL=ViewSchema.d.ts.map

package/dist/src/schemas/ViewSchema.d.ts.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * Schemas Module - Declarative Model schema definitions and Component Serialization System
+ *
+ * Exports all Model classes and their type-safe props using the new
+ * declarative pattern with @Schema, @Field, and @Editor decorators.
+ *
+ * Also exports the new Component Serialization System for "WebView for React" functionality.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export type { Serializable, SerializableConstructor } from './types/Serializable';
+export { ComponentTransformer } from './transformers/ComponentTransformer';
+import './transformers/registry';
+export * from './ActionSchema';
+export * from './ArticleSchema';
+export * from './CardListGridSchema';
+export * from './ChoiceInputFieldSchema';
+export * from './CodeSchema';
+export * from './ContentSchema';
+export * from './CoverImageHeaderSchema';
+export * from './FeatureCardSchema';
+export * from './FeatureGridSchema';
+export * from './FeatureItemSchema';
+export * from './FooterItemSchema';
+export * from './FormBlockSchema';
+export * from './FooterSchema';
+export * from './FooterSectionSchema';
+export * from './GridCellSchema';
+export * from './GridLayoutSchema';
+export * from './HeaderActionSchema';
+export * from './HeroBlockSchema';
+export * from './HtmlSchema';
+export * from './ImageSchema';
+export * from './MarkdownSchema';
+export * from './MetadataItemSchema';
+export * from './PageBannerHeaderSchema';
+export * from './PaletteSwitcherSchema';
+export * from './ProductCardSchema';
+export * from './SafeSpanSchema';
+export * from './SectionSchema';
+export * from './TextInputFieldSchema';
+export * from './TextSchema';
+export * from './ThemeSwitcherSchema';
+export * from './ViewSchema';
+export * from './PrintConfigSchema';
+export * from './PageTemplateSchema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,yBAAyB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/src/schemas/transformers/ComponentTransformer.d.ts

@@ -0,0 +1,128 @@
+/**
+ * ComponentTransformer - Core component serialization and HTML pattern transformation system
+ *
+ * Enables "WebView for React" functionality by providing serialization
+ * and deserialization of React components to/from JSON structures.
+ * Also supports HTML pattern-based transformations where components can
+ * register HTML patterns they can handle.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ReactNode } from 'react';
+import { SerializableConstructor } from '../types/Serializable';
+/**
+ * Type for HTML pattern transformation handlers
+ */
+export type PatternHandler = (element: Element) => any;
+/**
+ * Core transformer for React component serialization
+ * Provides static methods for component registration and transformation
+ */
+export declare class ComponentTransformer {
+    /**
+     * Enable or disable strict mode
+     * @param enabled - Whether to enable strict mode (throws on unregistered components)
+     */
+    static setStrictMode(enabled: boolean): void;
+    /**
+     * Check if strict mode is enabled
+     * @returns True if strict mode is enabled
+     */
+    static isStrictMode(): boolean;
+    /**
+     * Register a component class for serialization
+     * Component must declare its own tagName and version via static properties
+     * @param componentClass - Component class that implements Serializable interface
+     */
+    static registerComponent(componentClass: SerializableConstructor): void;
+    /**
+     * Serialize React node(s) to JSON string
+     * In strict mode: throws on unregistered components
+     * In legacy mode: uses fallback tag for unregistered components/html/text
+     */
+    static serialize(node: ReactNode | ReactNode[]): string;
+    /**
+     * Deserialize JSON input to React node(s)
+     * In strict mode: throws on unregistered components
+     * In legacy mode: never throws; always returns a valid ReactNode (or array) or null
+     * - Strings: try JSON.parse; if fails, return the string as a text node
+     * - Objects/arrays: only schema objects are transformed; non-schema become text via JSON.stringify
+     */
+    static deserialize(input: string | object | object[]): ReactNode | ReactNode[];
+    /**
+   * Type guard for serialized component schema objects
+   * Requires: { tagName: string; version: string; data: any }
+   * Optional: key?: string
+   */
+    private static isSerializedComponent;
+    /**
+     * Internal method to deserialize data back to React nodes
+     * @param data - Data to deserialize
+     * @returns React node(s)
+     */
+    private static deserializeData;
+    /**
+     * Internal method to serialize a single React node
+     * @param node - React node to serialize
+     * @returns Serializable data structure { tagName, version, data }
+     */
+    private static serializeNode;
+    /**
+     * Deserialize unregistered nodes using ReactNodeTransformer
+     * @param data - Serialized data from ReactNodeTransformer
+     * @returns React node
+     */
+    private static deserializeUnregisteredComponent;
+    /**
+     * Find the tag name for a given component constructor
+     * @param componentType - Component constructor function
+     * @returns Tag name or null if not found
+     */
+    private static findTagNameForComponent;
+    /**
+     * Get list of registered component tags (for debugging/testing)
+     * @returns Array of registered tag names
+     */
+    static getRegisteredComponents(): string[];
+    /**
+     * Clear all registered components (for testing)
+     */
+    static clearRegistry(): void;
+    /**
+     * Register an HTML pattern handler
+     * @param pattern - CSS selector pattern (e.g., 'pre code', 'section.blog-section')
+     * @param handler - Function to transform matching elements to component data
+     */
+    static registerPattern(pattern: string, handler: PatternHandler): void;
+    /**
+     * Check if a pattern is registered
+     * @param pattern - CSS selector pattern to check
+     * @returns True if pattern is registered
+     */
+    static hasPattern(pattern: string): boolean;
+    /**
+     * Transform an HTML element to React component if a matching pattern exists
+     * @param element - DOM Element to transform
+     * @returns React node if pattern matches, null otherwise
+     */
+    static transformHTMLElement(element: Element): ReactNode | null;
+    /**
+     * Transform HTML string to React nodes using registered patterns
+     * @param html - HTML string to transform
+     * @returns Array of React nodes
+     */
+    static transformHTML(html: string): ReactNode[];
+    /**
+     * Recursively transform an element and its children
+     * @param element - DOM Element to transform
+     * @param key - React key for the element
+     * @returns React node
+     */
+    private static transformElement;
+    /**
+     * Get list of registered patterns (for debugging/testing)
+     * @returns Array of registered patterns
+     */
+    static getRegisteredPatterns(): string[];
+}
+//# sourceMappingURL=ComponentTransformer.d.ts.map

package/dist/src/schemas/transformers/ComponentTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentTransformer.d.ts","sourceRoot":"","sources":["../../../../src/schemas/transformers/ComponentTransformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAc,EAAE,SAAS,EAAgB,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAahE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,GAAG,CAAC;AAcvD;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI5C;;;OAGG;IACH,MAAM,CAAC,YAAY,IAAI,OAAO;IAI9B;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,uBAAuB,GAAG,IAAI;IA4BvE;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,MAAM;IAKvD;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE;IAe9E;;;;KAIC;IACD,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAQpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAsC9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqE5B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gCAAgC;IAI/C;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA4BtC;;;OAGG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAI1C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAOtE;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAe/D;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAS/C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAsC/B;;;OAGG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,EAAE;CAGzC"}

package/dist/src/schemas/transformers/ReactNodeTransformer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ReactNodeTransformer - Fallback transformer for standard React content
+ *
+ * Provides serialization/deserialization for unregistered React components,
+ * HTML elements, and other React content that doesn't implement the
+ * Serializable interface.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ReactNode } from 'react';
+/**
+ * Transformer for standard React content and HTML elements
+ * Used as fallback when components are not registered in ComponentTransformer
+ */
+export declare class ReactNodeTransformer {
+    /**
+     * Serialize a React node to JSON-compatible structure
+     * @param node - React node to serialize
+     * @returns Serializable data structure
+     */
+    static serialize(node: ReactNode): any;
+    /**
+     * Deserialize data back to React node
+     * @param data - Data to deserialize
+     * @returns React node
+     */
+    static deserialize(data: any): ReactNode;
+    /**
+     * Serialize props object, handling nested React nodes
+     * @param props - Props object to serialize
+     * @returns Serialized props
+     */
+    private static serializeProps;
+    /**
+     * Deserialize React element data back to React element
+     * @param data - Serialized React element data
+     * @returns React element or fallback content
+     */
+    private static deserializeReactElement;
+    /**
+     * Deserialize props object, handling nested React nodes
+     * @param props - Serialized props object
+     * @returns Deserialized props
+     */
+    private static deserializeProps;
+    /**
+     * Extract text content from props for fallback rendering
+     * @param props - Props object
+     * @returns Text content or null
+     */
+    private static extractTextContent;
+}
+//# sourceMappingURL=ReactNodeTransformer.d.ts.map

package/dist/src/schemas/transformers/ReactNodeTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNodeTransformer.d.ts","sourceRoot":"","sources":["../../../../src/schemas/transformers/ReactNodeTransformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgB,SAAS,EAAiC,MAAM,OAAO,CAAC;AAG/E;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG;IAqEtC;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS;IA2CxC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAqB7B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkBtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkB/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAqBlC"}

package/dist/src/schemas/transformers/registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Component Registration - Central registry for serializable components
+ *
+ * This file registers all components that implement the Serializable interface
+ * with the ComponentTransformer system. Components must be registered here
+ * to support JSON serialization/deserialization functionality.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Register all serializable components with the ComponentTransformer
+ * This function should be called once during application initialization
+ *
+ * Phase 0: Foundation in place - ready for component migration
+ * Phase 1+: Components will be migrated to createSerializableView factory
+ */
+export declare function registerSerializableComponents(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/schemas/transformers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/schemas/transformers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAsCrD"}

package/dist/src/schemas/types/Serializable.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Serializable Interface - Component Serialization System Foundation
+ *
+ * Defines the contract for components that can be serialized to/from JSON
+ * for "WebView for React" functionality.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { ReactElement } from 'react';
+/**
+ * Interface for components that support JSON serialization
+ * Components implementing this interface can be transformed between
+ * React elements and serializable JSON data structures
+ */
+export interface Serializable {
+    /**
+     * Convert component instance to JSON data
+     * @returns Serializable data structure
+     */
+    toJson(): any;
+}
+/**
+ * Interface for serializable component constructor
+ * Defines static methods and properties required for component classes
+ * Components implementing this interface must declare their own identity
+ */
+export interface SerializableConstructor {
+    /**
+     * Component's unique tag name for serialization
+     * Must be unique across all registered components
+     */
+    readonly tagName: string;
+    /**
+     * Component's version for serialization format compatibility
+     * Should follow semantic versioning (e.g., "1.0.0")
+     */
+    readonly version: string;
+    /**
+     * Convert JSON data to a React element
+     * @param jsonData - Serialized component data
+     * @returns React element representing the component
+     */
+    fromJson(jsonData: any): ReactElement;
+    new (...args: any[]): Serializable;
+}
+//# sourceMappingURL=Serializable.d.ts.map

package/dist/src/schemas/types/Serializable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Serializable.d.ts","sourceRoot":"","sources":["../../../../src/schemas/types/Serializable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,IAAI,GAAG,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,YAAY,CAAC;IAEtC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC;CACpC"}

package/dist/src/stories/_templates/SerializationTemplate.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SerializationTemplate - Reusable template for component serialization demos
+ *
+ * Creates standardized serialization stories that demonstrate:
+ * - Component serialization to JSON
+ * - JSON deserialization back to component
+ * - Round-trip validation
+ * - JSON structure visualization
+ *
+ * Usage:
+ * ```tsx
+ * import { makeSerializationStory } from '../_templates/SerializationTemplate';
+ *
+ * export const SerializationDemo = makeSerializationStory(() => (
+ *   <Button variant="primary" label="Click Me" />
+ * ));
+ * ```
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+/**
+ * Creates a serialization demo story for any React element
+ *
+ * @param makeElement - Function that returns the React element to serialize
+ * @returns Story component that demonstrates serialization round-trip
+ */
+export declare const makeSerializationStory: (makeElement: () => React.ReactElement) => () => import("react/jsx-runtime").JSX.Element;
+/**
+ * Creates a batch serialization demo for multiple elements
+ *
+ * @param makeElements - Function that returns array of React elements to serialize
+ * @returns Story component that demonstrates batch serialization
+ */
+export declare const makeBatchSerializationStory: (makeElements: () => React.ReactElement[]) => () => import("react/jsx-runtime").JSX.Element;
+/**
+ * Creates a complex serialization demo with nested components
+ *
+ * @param makeComplexElement - Function that returns a complex nested React element
+ * @returns Story component that demonstrates nested component serialization
+ */
+export declare const makeComplexSerializationStory: (makeComplexElement: () => React.ReactElement) => () => import("react/jsx-runtime").JSX.Element;
+export default makeSerializationStory;
+//# sourceMappingURL=SerializationTemplate.d.ts.map

package/dist/src/stories/_templates/SerializationTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationTemplate.d.ts","sourceRoot":"","sources":["../../../../src/stories/_templates/SerializationTemplate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,aAAa,MAAM,KAAK,CAAC,YAAY,kDAyE3E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,cAAc,MAAM,KAAK,CAAC,YAAY,EAAE,kDAsBnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GAAI,oBAAoB,MAAM,KAAK,CAAC,YAAY,kDAezF,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

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

@@ -0,0 +1,52 @@
+import { DataResponse, Model, SelectOptions } from '@qwickapps/schema';
+import { ITemplateResolver, TemplateResolverConfig } from "../types";
+/**
+ * ContentResolver - Combines data, template, and cache providers
+ *
+ * This class follows the orchestrator pattern:
+ * - Delegates data fetching to IDataProvider
+ * - Delegates template resolution to ITemplateResolver
+ * - Optionally wraps data provider with ICacheProvider
+ * - Creates ContentProxy objects for framework compatibility
+ *
+ * Usage:
+ * ```typescript
+ * const resolver = new ContentResolver({
+ *   dataProvider: new JsonDataProvider({ data: {...} }),
+ *   templateResolver: new MustacheTemplateResolver(),
+ *   cacheProvider: new MemoryCacheProvider({ maxSize: 50, defaultTtl: 60000 })
+ * });
+ *
+ * // Or with boolean cacheProvider (uses default MemoryCacheProvider)
+ * const resolver = new ContentResolver({
+ *   dataProvider: new JsonDataProvider({ data: {...} }),
+ *   cacheProvider: true
+ * });
+ *
+ * // Or no caching
+ * const resolver = new ContentResolver({
+ *   dataProvider: new JsonDataProvider({ data: {...} }),
+ *   cacheProvider: false // or omit entirely
+ * });
+ * ```
+ */
+export declare class TemplateResolver implements ITemplateResolver {
+    private dataProvider;
+    private templateResolver;
+    private cacheProvider?;
+    private enableLogging;
+    private log;
+    constructor(config: TemplateResolverConfig);
+    get<T extends Model>(slug: string): Promise<DataResponse<T>>;
+    select<T extends Model>(schema: string, options?: SelectOptions): Promise<DataResponse<T[]>>;
+    /**
+     * Resolve template with lazy context loading
+     */
+    resolveTemplate(template: string): Promise<string>;
+    /**
+     * Create lazy loading context for template resolution
+     * Only fetches data when accessed by mustache template
+     */
+    private createLazyContext;
+}
+//# sourceMappingURL=TemplateResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateResolver.d.ts","sourceRoot":"","sources":["../../../src/templates/TemplateResolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,YAAY,EAAsD,KAAK,EAA4B,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACzK,OAAO,EAEL,iBAAiB,EAEjB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAwB;IAC9C,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,GAAG,CAAS;gBAER,MAAM,EAAE,sBAAsB;IAwBpC,GAAG,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI5D,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAIlG;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAG,MAAM,CAAE;IAsB3D;;;OAGG;YACW,iBAAiB;CAsChC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Index file for templates module
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export * from './TemplateResolver';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Pure cache provider interface - Single Responsibility: Caching only
+ */
+export interface ICacheProvider<T> {
+    /** Get cached value by key */
+    get(key: string): T | null;
+    /** Set cached value with optional TTL */
+    set(key: string, value: T, ttl?: number): void;
+    /** Clear cache entry or all entries */
+    clear(key?: string): void;
+    /** Get cache statistics */
+    getStats?(): {
+        size: number;
+        maxSize: number;
+        keys: string[];
+    };
+}
+//# sourceMappingURL=CacheProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheProvider.d.ts","sourceRoot":"","sources":["../../../src/types/CacheProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3B,yCAAyC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,uCAAuC;IACvC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;KAAE,CAAC;CACjE"}