@eduboxpro/studio 0.1.32 → 0.1.34

package/index.d.ts

@@ -3203,5 +3203,318 @@ declare function loadGoogleFonts(fonts: Array<{
     display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
 }>): void;
 
-export { BadgeComponent, BadgeWrapperComponent, BottomNavigationComponent, ButtonComponent, ButtonGroupComponent, ButtonToggleGroupComponent, COUNTRY_OPTIONS, CardComponent, ChatComponent, ChatInputComponent, ChatMessageComponent, CheckboxComponent, ColorPickerCompactComponent, ColorPickerComponent, ConfirmDialogComponent, ConfirmDialogService, DEFAULT_COLOR_PRESETS, DrawerComponent, DrawerService, DropdownComponent, IconComponent, InputComponent, InspectorComponent, MASK_PRESETS, MaskDirective, MaskEngine, MenuComponent, ModalComponent, NavbarComponent, PaginationComponent, PhoneInputComponent, PopoverComponent, RadioButtonComponent, STUDIO_CONFIG, SelectComponent, SidebarComponent, StudioConfigService, SwitchComponent, TableColumnDirective, TableComponent, TabsComponent, TextareaComponent, ThemeSwitchComponent, ToastComponent, ToastService, TooltipComponent, classNames, isSafeUrl, loadGoogleFont, loadGoogleFonts, provideStudioConfig, provideStudioIcons, sanitizeUrl, withConfigDefault };
-export type { BadgeColor, BadgeDefaultsConfig, BadgeIconPosition, BadgeRadius, BadgeSize, BadgeVariant, BadgeWrapperPosition, BadgeWrapperSize, BottomNavigationDefaultsConfig, BottomNavigationFabPosition, BottomNavigationItem, BottomNavigationLabelMode, BottomNavigationSize, BottomNavigationVariant, ButtonDefaultsConfig, ButtonGroupDefaultsConfig, ButtonToggleGroupDefaultsConfig, ButtonToggleGroupOption, ButtonToggleGroupValue, CardColor, CardDefaultsConfig, CardImagePosition, CardOrientation, CardPadding, CardRadius, CardShadow, CardSize, CardVariant, ChatMessage, ChatSize, ChatUser, ChatVariant, CheckboxColor, CheckboxDefaultsConfig, CheckboxRadius, CheckboxSize, CheckboxVariant, ColorConfig, ColorFormat, ColorPickerDefaultsConfig, ColorPickerSize, ColorPickerVariant, ColorPreset, ColorSwatchGroup, ColorValue, ComponentsConfig, ConfirmDialogConfig, ConfirmDialogVariant, CountryOption, DrawerAnimationEasing, DrawerCloseButtonPosition, DrawerConfig, DrawerDefaultsConfig, DrawerPosition, DrawerRadius, DrawerRole, DrawerShadowSize, DrawerSize, DropdownDefaultsConfig, DropdownItem, DropdownPosition, EmptyStateConfig, HSL, InputDefaultsConfig, InputMode, InputType, InspectorComponentSize, InspectorComponentVariant, InspectorData, InspectorGroup, InspectorGroupDivider, InspectorOption, InspectorParameter, InspectorParameterType, InspectorSection, InspectorSpacing, MaskConfig, MaskPreset, MaskResult, MaskToken, MenuColor, MenuExpandEvent, MenuExpandIconPosition, MenuItem, MenuItemBadgeColor, MenuItemClickEvent, MenuItemCommandEvent, MenuItemIconPosition, MenuItemTarget, MenuItemTooltipPosition, MenuMode, MenuOrientation, MenuRadius, MenuSize, MenuSpacing, MenuVariant, ModalAnimation, ModalDefaultsConfig, ModalPosition, ModalSize, ModalVariant, NavbarColor, NavbarShadow, NavbarSize, NavbarVariant, PaginationPageChangeEvent, PaginationPageSizeChangeEvent, PaginationSize, PaginationVariant, PhoneCountry, PopoverAnimation, PopoverBoundary, PopoverConfig, PopoverDefaultsConfig, PopoverPosition, PopoverSize, PopoverTrigger, PopoverVariant, PopoverWidth, RGB, RadioButtonColor, RadioButtonDefaultsConfig, RadioButtonRadius, RadioButtonSize, RadioButtonVariant, RowAction, RowExpansion, SelectDefaultsConfig, SelectDisplayContext, SelectOption, SelectOptionGroup, SelectPosition, SelectSize, SelectVariant, SelectionEvent, SelectionMode, SidebarConfig, SidebarDefaultsConfig, SidebarPosition, SidebarSize, SidebarVariant, SortDirection, SortEvent, StudioConfig, StudioThemeConfig, SwitchDefaultsConfig, TabItem, TableCellContext, TableColumn, TableDefaultsConfig, TableDensity, TableHeaderContext, TableSort, TableState, TableVariant, TabsDefaultsConfig, TabsOrientation, TabsSize, TabsVariant, TextareaColor, TextareaDefaultsConfig, TextareaRadius, TextareaSize, TextareaVariant, ThemeMode, ToastConfig, ToastMessage, ToastPosition, ToastSeverity, TooltipDefaultsConfig };
+declare abstract class SignalStore<T> {
+    protected readonly state: WritableSignal<T>;
+    constructor(initialState: T);
+    get$(): Signal<T>;
+    snapshot(): T;
+    protected setState(newState: T): void;
+    protected updateState(updateFn: (state: T) => T): void;
+    protected patchState(partial: Partial<T>): void;
+    protected resetState(initialState: T): void;
+    protected select<R>(selector: (state: T) => R): Signal<R>;
+    protected onStateChange(callback: (state: T) => void): void;
+    protected onStateChangeWithPrevious(callback: (current: T, previous: T) => void): void;
+    protected batchUpdate(updates: Partial<T>[]): void;
+}
+
+/**
+ * Block System Types and Interfaces
+ * Core models for dynamic page rendering in EduBox
+ *
+ * @packageDocumentation
+ */
+type BlockType = 'flex-container' | 'grid-container' | 'div' | 'card' | 'section' | 'text' | 'image' | 'video' | 'html' | 'code' | 'list' | 'navbar' | 'footer' | 'alert' | 'badge' | 'button' | 'link' | 'slider' | 'tabs' | 'accordion' | 'form' | 'input' | 'textarea' | 'select' | 'checkbox' | `studio-${string}`;
+interface NavigateAction {
+    type: 'navigate';
+    url: string;
+    queryParams?: Record<string, string>;
+}
+interface ExternalLinkAction {
+    type: 'external-link';
+    url: string;
+    target?: '_blank' | '_self';
+}
+interface ScrollToAction {
+    type: 'scroll-to';
+    targetId: string;
+    behavior?: 'smooth' | 'auto';
+}
+interface SubmitFormAction {
+    type: 'submit-form';
+    formId: string;
+}
+interface SubmitLeadAction {
+    type: 'submit-lead';
+    endpoint: string;
+}
+interface CustomAction {
+    type: 'custom';
+    handler: string;
+    params?: Record<string, unknown>;
+}
+type BlockAction = NavigateAction | ExternalLinkAction | ScrollToAction | SubmitFormAction | SubmitLeadAction | CustomAction;
+type AnimationType = 'fade-in' | 'fade-out' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'scale-in' | 'scale-out' | 'rotate-in' | 'scroll-reveal';
+interface BlockAnimation {
+    type: AnimationType;
+    duration?: number;
+    delay?: number;
+    easing?: 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear';
+    trigger?: 'load' | 'hover' | 'in-viewport';
+    once?: boolean;
+}
+interface BaseBlock {
+    id?: string;
+    type: BlockType;
+    classes?: string;
+    styles?: Record<string, string>;
+    animation?: BlockAnimation;
+    children?: Block[];
+    condition?: string;
+}
+interface FlexContainerBlock extends BaseBlock {
+    type: 'flex-container';
+    children: Block[];
+}
+interface GridContainerBlock extends BaseBlock {
+    type: 'grid-container';
+    children: Block[];
+}
+interface DivBlock extends BaseBlock {
+    type: 'div';
+    children?: Block[];
+}
+interface CardBlock extends BaseBlock {
+    type: 'card';
+    children: Block[];
+}
+interface SectionBlock extends BaseBlock {
+    type: 'section';
+    children: Block[];
+}
+interface TextBlock extends BaseBlock {
+    type: 'text';
+    tag: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span' | 'div';
+    content: string;
+    children?: never;
+}
+interface ImageBlock extends BaseBlock {
+    type: 'image';
+    src: string;
+    alt: string;
+    lazy?: boolean;
+    width?: string | number;
+    height?: string | number;
+    children?: never;
+}
+interface VideoBlock extends BaseBlock {
+    type: 'video';
+    src: string;
+    provider?: 'youtube' | 'vimeo' | 'direct';
+    alt?: string;
+    autoplay?: boolean;
+    controls?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    children?: never;
+}
+interface HtmlBlock extends BaseBlock {
+    type: 'html';
+    content: string;
+    sanitize?: boolean;
+    children?: never;
+}
+interface CodeBlock extends BaseBlock {
+    type: 'code';
+    code: string;
+    language?: string;
+    showLineNumbers?: boolean;
+    highlightLines?: number[];
+    filename?: string;
+    children?: never;
+}
+interface ListBlock extends BaseBlock {
+    type: 'list';
+    listType: 'ul' | 'ol';
+    items: Array<{
+        content: string;
+        children?: Block[];
+    }>;
+    children?: never;
+}
+interface NavbarBlock extends BaseBlock {
+    type: 'navbar';
+    logo?: {
+        text?: string;
+        image?: string;
+        href?: string;
+    };
+    links: Array<{
+        label: string;
+        href: string;
+        action?: BlockAction;
+    }>;
+    sticky?: boolean;
+    transparent?: boolean;
+    children?: never;
+}
+interface FooterBlock extends BaseBlock {
+    type: 'footer';
+    sections?: Array<{
+        title: string;
+        links: Array<{
+            label: string;
+            href: string;
+            action?: BlockAction;
+        }>;
+    }>;
+    copyright?: string;
+    socialLinks?: Array<{
+        platform: string;
+        url: string;
+        icon?: string;
+    }>;
+    children?: never;
+}
+interface ButtonBlock extends BaseBlock {
+    type: 'button';
+    content: string;
+    action?: BlockAction;
+    disabled?: boolean;
+    children?: never;
+}
+interface AlertBlock extends BaseBlock {
+    type: 'alert';
+    alertType: 'info' | 'success' | 'warning' | 'error';
+    title?: string;
+    message: string;
+    dismissible?: boolean;
+    children?: never;
+}
+interface BadgeBlock extends BaseBlock {
+    type: 'badge';
+    content: string;
+    variant?: 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+    size?: 'sm' | 'md' | 'lg';
+    children?: never;
+}
+interface LinkBlock extends BaseBlock {
+    type: 'link';
+    content: string;
+    href: string;
+    target?: '_blank' | '_self';
+    children?: Block[];
+}
+interface SliderBlock extends BaseBlock {
+    type: 'slider';
+    slides: Block[];
+    config?: {
+        autoplay?: boolean;
+        interval?: number;
+        loop?: boolean;
+        showControls?: boolean;
+        showIndicators?: boolean;
+    };
+    children?: never;
+}
+interface TabsBlock extends BaseBlock {
+    type: 'tabs';
+    tabs: Array<{
+        id: string;
+        label: string;
+        content: Block[];
+    }>;
+    defaultTab?: string;
+    children?: never;
+}
+interface AccordionBlock extends BaseBlock {
+    type: 'accordion';
+    items: Array<{
+        id: string;
+        title: string;
+        content: Block[];
+    }>;
+    allowMultiple?: boolean;
+    defaultOpen?: string[];
+    children?: never;
+}
+interface FormBlock extends BaseBlock {
+    type: 'form';
+    action?: BlockAction;
+    method?: 'GET' | 'POST';
+    children: Block[];
+}
+interface InputBlock extends BaseBlock {
+    type: 'input';
+    name: string;
+    inputType: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
+    placeholder?: string;
+    required?: boolean;
+    validation?: {
+        pattern?: string;
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        message?: string;
+    };
+    children?: never;
+}
+interface TextareaBlock extends BaseBlock {
+    type: 'textarea';
+    name: string;
+    placeholder?: string;
+    required?: boolean;
+    rows?: number;
+    children?: never;
+}
+interface SelectBlock extends BaseBlock {
+    type: 'select';
+    name: string;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    required?: boolean;
+    multiple?: boolean;
+    children?: never;
+}
+interface CheckboxBlock extends BaseBlock {
+    type: 'checkbox';
+    name: string;
+    label: string;
+    required?: boolean;
+    children?: never;
+}
+interface StudioComponentBlock extends BaseBlock {
+    type: `studio-${string}`;
+    props?: Record<string, unknown>;
+    content?: string;
+    action?: BlockAction;
+}
+type Block = FlexContainerBlock | GridContainerBlock | DivBlock | CardBlock | SectionBlock | TextBlock | ImageBlock | VideoBlock | HtmlBlock | CodeBlock | ListBlock | NavbarBlock | FooterBlock | ButtonBlock | AlertBlock | BadgeBlock | LinkBlock | SliderBlock | TabsBlock | AccordionBlock | FormBlock | InputBlock | TextareaBlock | SelectBlock | CheckboxBlock | StudioComponentBlock;
+interface PageMeta {
+    title?: string;
+    description?: string;
+    keywords?: string[];
+    ogImage?: string;
+}
+interface PageData {
+    pageId: string;
+    slug: string;
+    meta?: PageMeta;
+    blocks: Block[];
+    publishedAt?: string;
+    version?: number;
+}
+declare function isLayoutBlock(block: Block): block is FlexContainerBlock | GridContainerBlock | DivBlock | CardBlock | SectionBlock;
+declare function isContentBlock(block: Block): block is TextBlock | ImageBlock | VideoBlock | HtmlBlock | CodeBlock | ListBlock;
+declare function isInteractiveBlock(block: Block): block is ButtonBlock | AlertBlock | BadgeBlock | LinkBlock | SliderBlock | TabsBlock | AccordionBlock;
+declare function isFormBlock(block: Block): block is FormBlock | InputBlock | TextareaBlock | SelectBlock | CheckboxBlock;
+declare function isStudioBlock(block: Block): block is StudioComponentBlock;
+declare function hasChildren(block: Block): block is Block & {
+    children: Block[];
+};
+
+export { BadgeComponent, BadgeWrapperComponent, BottomNavigationComponent, ButtonComponent, ButtonGroupComponent, ButtonToggleGroupComponent, COUNTRY_OPTIONS, CardComponent, ChatComponent, ChatInputComponent, ChatMessageComponent, CheckboxComponent, ColorPickerCompactComponent, ColorPickerComponent, ConfirmDialogComponent, ConfirmDialogService, DEFAULT_COLOR_PRESETS, DrawerComponent, DrawerService, DropdownComponent, IconComponent, InputComponent, InspectorComponent, MASK_PRESETS, MaskDirective, MaskEngine, MenuComponent, ModalComponent, NavbarComponent, PaginationComponent, PhoneInputComponent, PopoverComponent, RadioButtonComponent, STUDIO_CONFIG, SelectComponent, SidebarComponent, SignalStore, StudioConfigService, SwitchComponent, TableColumnDirective, TableComponent, TabsComponent, TextareaComponent, ThemeSwitchComponent, ToastComponent, ToastService, TooltipComponent, classNames, hasChildren, isContentBlock, isFormBlock, isInteractiveBlock, isLayoutBlock, isSafeUrl, isStudioBlock, loadGoogleFont, loadGoogleFonts, provideStudioConfig, provideStudioIcons, sanitizeUrl, withConfigDefault };
+export type { AccordionBlock, AlertBlock, AnimationType, BadgeBlock, BadgeColor, BadgeDefaultsConfig, BadgeIconPosition, BadgeRadius, BadgeSize, BadgeVariant, BadgeWrapperPosition, BadgeWrapperSize, BaseBlock, Block, BlockAction, BlockAnimation, BlockType, BottomNavigationDefaultsConfig, BottomNavigationFabPosition, BottomNavigationItem, BottomNavigationLabelMode, BottomNavigationSize, BottomNavigationVariant, ButtonBlock, ButtonDefaultsConfig, ButtonGroupDefaultsConfig, ButtonToggleGroupDefaultsConfig, ButtonToggleGroupOption, ButtonToggleGroupValue, CardBlock, CardColor, CardDefaultsConfig, CardImagePosition, CardOrientation, CardPadding, CardRadius, CardShadow, CardSize, CardVariant, ChatMessage, ChatSize, ChatUser, ChatVariant, CheckboxBlock, CheckboxColor, CheckboxDefaultsConfig, CheckboxRadius, CheckboxSize, CheckboxVariant, CodeBlock, ColorConfig, ColorFormat, ColorPickerDefaultsConfig, ColorPickerSize, ColorPickerVariant, ColorPreset, ColorSwatchGroup, ColorValue, ComponentsConfig, ConfirmDialogConfig, ConfirmDialogVariant, CountryOption, CustomAction, DivBlock, DrawerAnimationEasing, DrawerCloseButtonPosition, DrawerConfig, DrawerDefaultsConfig, DrawerPosition, DrawerRadius, DrawerRole, DrawerShadowSize, DrawerSize, DropdownDefaultsConfig, DropdownItem, DropdownPosition, EmptyStateConfig, ExternalLinkAction, FlexContainerBlock, FooterBlock, FormBlock, GridContainerBlock, HSL, HtmlBlock, ImageBlock, InputBlock, InputDefaultsConfig, InputMode, InputType, InspectorComponentSize, InspectorComponentVariant, InspectorData, InspectorGroup, InspectorGroupDivider, InspectorOption, InspectorParameter, InspectorParameterType, InspectorSection, InspectorSpacing, LinkBlock, ListBlock, MaskConfig, MaskPreset, MaskResult, MaskToken, MenuColor, MenuExpandEvent, MenuExpandIconPosition, MenuItem, MenuItemBadgeColor, MenuItemClickEvent, MenuItemCommandEvent, MenuItemIconPosition, MenuItemTarget, MenuItemTooltipPosition, MenuMode, MenuOrientation, MenuRadius, MenuSize, MenuSpacing, MenuVariant, ModalAnimation, ModalDefaultsConfig, ModalPosition, ModalSize, ModalVariant, NavbarBlock, NavbarColor, NavbarShadow, NavbarSize, NavbarVariant, NavigateAction, PageData, PageMeta, PaginationPageChangeEvent, PaginationPageSizeChangeEvent, PaginationSize, PaginationVariant, PhoneCountry, PopoverAnimation, PopoverBoundary, PopoverConfig, PopoverDefaultsConfig, PopoverPosition, PopoverSize, PopoverTrigger, PopoverVariant, PopoverWidth, RGB, RadioButtonColor, RadioButtonDefaultsConfig, RadioButtonRadius, RadioButtonSize, RadioButtonVariant, RowAction, RowExpansion, ScrollToAction, SectionBlock, SelectBlock, SelectDefaultsConfig, SelectDisplayContext, SelectOption, SelectOptionGroup, SelectPosition, SelectSize, SelectVariant, SelectionEvent, SelectionMode, SidebarConfig, SidebarDefaultsConfig, SidebarPosition, SidebarSize, SidebarVariant, SliderBlock, SortDirection, SortEvent, StudioComponentBlock, StudioConfig, StudioThemeConfig, SubmitFormAction, SubmitLeadAction, SwitchDefaultsConfig, TabItem, TableCellContext, TableColumn, TableDefaultsConfig, TableDensity, TableHeaderContext, TableSort, TableState, TableVariant, TabsBlock, TabsDefaultsConfig, TabsOrientation, TabsSize, TabsVariant, TextBlock, TextareaBlock, TextareaColor, TextareaDefaultsConfig, TextareaRadius, TextareaSize, TextareaVariant, ThemeMode, ToastConfig, ToastMessage, ToastPosition, ToastSeverity, TooltipDefaultsConfig, VideoBlock };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eduboxpro/studio",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "description": "Modern Angular UI library for educational platforms with customizable design system",
   "keywords": [
     "angular",