mui-toolpad-extended-tuni 3.0.2 → 3.1.0

package/dist/src/LMSToolpad/components/Navigation/hooks/useNavigationSectionManager.d.ts

@@ -1,23 +0,0 @@
-/**
- * Hook that provides a simplified interface for managing navigation sections.
- * Abstracts away the complexity of the navigation store and filter store interaction.
- *
- * @returns {Object} Section management functions
- * @property {Function} addDynamicSection - Adds or updates a section in navigation
- */
-interface DynamicSection {
-    header: string;
-    keepVisible?: boolean;
-    pages?: Array<{
-        segment: string;
-        title: string;
-        Icon?: any;
-        description?: string;
-        instances?: string[];
-        microservices?: string[];
-    }>;
-}
-export declare const useNavigationSectionManager: () => {
-    addDynamicSection: (section: DynamicSection) => void;
-};
-export {};

package/dist/src/LMSToolpad/components/Navigation/hooks/useSyncNavigationFilters.d.ts

@@ -1 +0,0 @@
-export declare const useSyncNavigationFilters: () => void;

package/dist/src/LMSToolpad/components/Navigation/store/microserviceUtils.d.ts

@@ -1,9 +0,0 @@
-import { NavigationPageStoreItem, ViewStore } from './types';
-/**
- * Aggregates microservices from all available sources (app-level + external).
- * This is microservice-agnostic - it doesn't hard-code specific store types.
- *
- * @param state - The navigation store state
- * @returns Array of all available microservice navigation items
- */
-export declare const getAllMicroservices: (state: ViewStore) => NavigationPageStoreItem[];

package/dist/src/LMSToolpad/components/Navigation/store/navigationCalculator.d.ts

@@ -1,11 +0,0 @@
-import { NavigationStoreItem, NavigationSection } from './types';
-/**
- * Calculates the navigation structure from sections.
- * Pure function that takes sections, order, and visibility and returns a flat navigation array.
- *
- * @param sections - Record of navigation sections keyed by section key
- * @param sectionOrder - Array of section keys in display order
- * @param visibleSections - Record of section visibility flags
- * @returns Flat array of navigation items for rendering
- */
-export declare const calculateNavigationFromSections: (sections: Record<string, NavigationSection>, sectionOrder: string[], visibleSections: Record<string, boolean>) => NavigationStoreItem[];

package/dist/src/LMSToolpad/components/Navigation/store/sectionManager.d.ts

@@ -1,9 +0,0 @@
-import { ViewStore } from './types';
-/**
- * Updates microservice navigation for all sections.
- * Orchestrates the update process across all sections and recalculates navigation.
- *
- * @param state - The current navigation store state
- * @returns Updated state with sections and navigation, or null if no changes
- */
-export declare const updateMicroserviceNavigationForSections: (state: ViewStore) => Partial<ViewStore> | null;

package/dist/src/LMSToolpad/components/Navigation/store/types.d.ts

@@ -1,90 +0,0 @@
-import { SvgIconComponent } from '@mui/icons-material';
-import { default as React } from 'react';
-export interface NavigationItemBase {
-    kind: "header" | "page" | "divider";
-    title?: string;
-    actionFC?: React.FC;
-}
-export interface ToolMetadata {
-    description?: string;
-    forRoles?: string[];
-    isRootTool?: boolean;
-    underHeader?: string;
-    microservices?: string[];
-}
-export interface NavigationHeaderItem extends NavigationItemBase {
-    kind: "header";
-    title: string;
-}
-export interface NavigationDividerItem extends NavigationItemBase {
-    kind: "divider";
-}
-export interface NavigationPageStoreItem extends NavigationItemBase {
-    kind: "page";
-    segment: string;
-    iconFC?: SvgIconComponent;
-    icon?: React.ReactElement;
-    children?: NavigationPageStoreItem[];
-    view?: React.ComponentType;
-    action?: React.ReactElement;
-    showTitle?: boolean;
-    metadata?: ToolMetadata;
-}
-export type NavigationStoreItem = NavigationHeaderItem | NavigationPageStoreItem | NavigationDividerItem;
-/**
- * Updated addSectionProps type.
- * Now you provide a header (underHeader) and an array of page configs.
- */
-export type addSectionProps = {
-    underHeader: string;
-    keepVisible?: boolean;
-    pages: Array<{
-        segment: string;
-        title: string;
-        Icon?: SvgIconComponent;
-        description?: string;
-        instances?: string[];
-        microservices?: string[];
-        actionFC?: React.FC;
-    }>;
-};
-/**
- * New interface for a navigation section.
- * Each section is keyed by its header (or unique id) and contains:
- *  - header: the header item (NavigationHeaderItem)
- *  - pages: a dictionary of pages keyed by their segment
- *  - pageOrder: an array of page keys (segments) to preserve ordering
- */
-export interface NavigationSection {
-    header: NavigationHeaderItem;
-    pages: Record<string, NavigationPageStoreItem>;
-    pageOrder: string[];
-}
-export type ViewStore = {
-    navigation: NavigationStoreItem[];
-    sections: Record<string, NavigationSection>;
-    sectionOrder: string[];
-    /**
-     * App-level microservice navigation items only.
-     * These are typically registered via NavigationRegistry for app-level routes.
-     */
-    allMicroserviceNavigation: NavigationPageStoreItem[];
-    addSection: (props: addSectionProps) => void;
-    removeHeader: (header: string) => void;
-    addMicroserviceNavigation: (microserviceNavigation: NavigationPageStoreItem) => void;
-    addStandaloneNavigation: (navigation: NavigationPageStoreItem) => void;
-    updateMicroserviceNavigationForSections: () => void;
-    recalculateNavigation: () => void;
-    visibleSections: Record<string, boolean>;
-    setVisibleSections: (options: Record<string, boolean>) => void;
-    collapsedSections: Record<string, boolean>;
-    setCollapsedSections: (options: Record<string, boolean>) => void;
-    toggleSectionCollapse: (sectionKey: string) => void;
-    /**
-     * Externally registered microservice navigation items.
-     * These are provided by external components (like CourseMicroservice) via setExternalMicroservices.
-     * The store is microservice-agnostic - it doesn't know or care about specific microservice types.
-     */
-    externalMicroservices: NavigationPageStoreItem[];
-    setExternalMicroservices: (microservices: NavigationPageStoreItem[]) => void;
-};

package/dist/src/LMSToolpad/components/Navigation/store/useNavigationFilterStore.d.ts

@@ -1,6 +0,0 @@
-export interface NavigationFilterState {
-    filterOptions: Record<string, boolean>;
-    setFilterOptions: (optionsOrUpdater: Record<string, boolean> | ((prev: Record<string, boolean>) => Record<string, boolean>)) => void;
-    initializeFilters: () => void;
-}
-export declare const useNavigationFilterStore: import('zustand/traditional').UseBoundStoreWithEqualityFn<import('zustand').StoreApi<NavigationFilterState>>;

package/dist/src/LMSToolpad/components/Navigation/store/useNavigationStore.d.ts

@@ -1,50 +0,0 @@
-import { NavigationStoreItem, ViewStore } from './types';
-/**
- * Navigation management store with enhanced section management and filtering capabilities.
- *
- * @version 3.1.0
- * @updates
- * - Complete rewrite of navigation structure using sections
- * - Added section-based visibility filtering
- * - Enhanced microservice integration with automatic updates
- * - Added support for dividers in navigation
- * - Introduced flexible section management with ordered headers
- * - Added action components support in navigation items
- * - Clear separation: app-level navigation only (course microservices handled separately)
- * - Refactored: Extracted types, utilities, and complex logic into separate modules
- *
- * @breaking-changes
- * - Removed updateSection and updateCourseInstanceSection methods
- * - Changed addSection API to use header-based organization
- * - Sections are now managed through a structured record instead of flat array
- * - Navigation items require explicit header assignment
- * - Changed microservice update mechanism to be section-aware
- *
- * @scope
- * This store handles navigation for the application:
- * - Global sections (Help, Contact, etc.)
- * - App-level microservices registered via NavigationRegistry
- * - External microservices provided via setExternalMicroservices (e.g., from CourseMicroservice)
- *
- * @structure
- * Navigation is now organized into sections:
- * - Each section has a header, pages, and maintained order
- * - Pages can have nested children (for instances or microservices)
- * - Sections can be individually shown/hidden through visibleSections
- *
- * @example
- * ```typescript
- * useNavigationStore.getState().addSection({
- *   underHeader: "Courses",
- *   pages: [{
- *     segment: "course-1",
- *     title: "Course 1",
- *     description: "Example course",
- *     microservices: ["attendance", "grades"]
- *   }]
- * });
- * ```
- */
-export declare const useNavigationStore: import('zustand/traditional').UseBoundStoreWithEqualityFn<import('zustand').StoreApi<ViewStore>>;
-export declare const filterNavigationByRole: (role: string) => NavigationStoreItem[];
-export type { NavigationItemBase, ToolMetadata, NavigationHeaderItem, NavigationDividerItem, NavigationPageStoreItem, NavigationStoreItem, addSectionProps, NavigationSection, } from './types';

package/dist/src/LMSToolpad/components/Notifications/Notifications.d.ts

@@ -1,3 +0,0 @@
-/** @format */
-declare const Notifications: () => import("react/jsx-runtime").JSX.Element;
-export default Notifications;

package/dist/src/LMSToolpad/components/Notifications/store/useNotificationsStore.d.ts

@@ -1,22 +0,0 @@
-/** @format */
-export type NotificationRaw = {
-    type: string;
-    message: string;
-    singular?: boolean;
-    singularId?: string;
-};
-export type Notification = {
-    type: string;
-    message: string;
-    id: string;
-    singular?: boolean;
-    singularId?: string;
-};
-type NotificationStore = {
-    notifications: Notification[] | [];
-    addNotificationData: (notificationData: NotificationRaw) => void;
-    removeNotificationData: (notificationId: number) => void;
-    clearNotificationsByType: (type: string) => void;
-};
-export declare const useNotificationStore: import('zustand/traditional').UseBoundStoreWithEqualityFn<import('zustand').StoreApi<NotificationStore>>;
-export {};

package/dist/src/LMSToolpad/utils/apiPrefix.d.ts

@@ -1,2 +0,0 @@
-/** @format */
-export declare const getApiPrefix: () => "" | "lms-toolpad/";

package/dist/src/LMSToolpad/utils/caseConverter.d.ts

@@ -1,17 +0,0 @@
-/** @format */
-/**
- * Converts a camelCase string to underscore_case
- */
-export declare const camelCaseToUnderscore: (str: string) => string;
-/**
- * Converts an underscore_case string to camelCase
- */
-export declare const underscoreToCamelCase: (str: string) => string;
-/**
- * Deep converts object keys from camelCase to underscore_case
- */
-export declare const convertObjectKeysToCamelCase: <T>(obj: T) => T;
-/**
- * Deep converts object keys from underscore_case to camelCase
- */
-export declare const convertObjectKeysToUnderscore: <T>(obj: T) => T;

package/dist/src/LMSToolpad/utils/cookieUtils.d.ts

@@ -1,27 +0,0 @@
-/** @format */
-export type ColorSchemePreference = 'light' | 'dark' | 'system';
-/**
- * Get a cookie value by name
- */
-export declare function getCookie(name: string): string | null;
-/**
- * Set a cookie value
- */
-export declare function setCookie(name: string, value: string, days?: number): void;
-/**
- * Delete a cookie by name
- */
-export declare function deleteCookie(name: string): void;
-/**
- * Get the color scheme preference from cookie
- * Returns 'system' as default if not set
- */
-export declare function getColorSchemePreference(): ColorSchemePreference;
-/**
- * Set the color scheme preference in cookie
- */
-export declare function setColorSchemePreference(preference: ColorSchemePreference): void;
-/**
- * Get the effective color scheme (resolves 'system' to actual light/dark based on system preference)
- */
-export declare function getEffectiveColorScheme(preference: ColorSchemePreference): 'light' | 'dark';

package/dist/src/LMSToolpad/utils/parseDate.d.ts

@@ -1,2 +0,0 @@
-import { DateTime } from 'luxon';
-export declare const parseDate: (dateString: string | null | undefined) => DateTime<true> | DateTime<false> | null;

package/dist/src/LMSToolpad/utils/slugify.d.ts

@@ -1 +0,0 @@
-export declare const slugify: (text: string) => string;

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

@@ -1,2 +0,0 @@
-export * from './ui';
-export * from './layout';

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

@@ -1,17 +0,0 @@
-import { default as React, ReactNode } from 'react';
-export interface GridItemProps {
-    children: ReactNode;
-    id: string;
-    isFlexContainer?: boolean;
-}
-/**
- * Grid item component that applies consistent styling and resize visual feedback.
- *
- * Features:
- * - Visual indication when in resize or move mode
- * - Consistent styling for all grid items
- * - Optional flex container for content that needs to fill the space
- * - Content is non-interactable when in edit mode (using BlurOverlay)
- */
-declare const GridItem: React.FC<GridItemProps>;
-export default GridItem;

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

@@ -1,26 +0,0 @@
-import { default as React, ReactNode } from 'react';
-import { Layout } from 'react-grid-layout';
-export interface GridItem {
-    id: string;
-    content: ReactNode;
-    layout?: Layout;
-}
-export interface GridItemEntry {
-    id: string;
-    content: ReactNode;
-    layout?: Layout;
-}
-interface GridItemContextType {
-    gridItems: GridItemEntry[];
-    registerGridItem: (id: string, content: ReactNode, layout?: Layout) => void;
-    unregisterGridItem: (id: string) => void;
-    getGridItem: (id: string) => GridItemEntry | undefined;
-    getAllGridItems: () => GridItemEntry[];
-}
-declare const GridItemContext: React.Context<GridItemContextType | undefined>;
-export declare const useGridItemContext: () => GridItemContextType;
-interface GridItemProviderProps {
-    children: ReactNode;
-}
-export declare const GridItemProvider: React.FC<GridItemProviderProps>;
-export default GridItemContext;

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

@@ -1,16 +0,0 @@
-import { default as React, ReactNode } from 'react';
-import { Layout } from 'react-grid-layout';
-export interface GridItem {
-    id: string;
-    content: ReactNode;
-    layout?: Layout;
-}
-export interface GridLayoutProps {
-    items: GridItem[];
-    storageKey: string;
-    defaultLayouts: {
-        [key: string]: Layout[];
-    };
-}
-declare const ResponsiveGridLayout: React.FC<GridLayoutProps>;
-export default ResponsiveGridLayout;

package/dist/src/common/components/layout/GridLayout/Tools/BreakpointIndicator.d.ts

@@ -1,8 +0,0 @@
-import { default as React } from 'react';
-/**
- * Shows which responsive breakpoint is currently active
- */
-declare const BreakpointIndicator: React.FC<{
-    showLabel?: boolean;
-}>;
-export default BreakpointIndicator;

package/dist/src/common/components/layout/GridLayout/Tools/EditModeToggler.d.ts

@@ -1,7 +0,0 @@
-/** @format */
-/**
- * Toggles edit mode for the grid layout system.
- * This activates both resize and move functionality at once.
- */
-declare const EditModeToggler: () => import("react/jsx-runtime").JSX.Element;
-export default EditModeToggler;

package/dist/src/common/components/layout/GridLayout/hooks/useGridLayoutManagement.d.ts

@@ -1,27 +0,0 @@
-import { Layout, Layouts } from 'react-grid-layout';
-/**
- * Options for the useGridLayoutManagement hook
- */
-interface UseGridLayoutManagementOptions {
-    /** Storage key for persisting layouts */
-    storageKey: string;
-    /** Default layouts to use if none found in storage */
-    defaultLayouts: Layouts;
-    /** Function to run when layout changes */
-    onLayoutChangeCallback?: (layouts: Layouts) => void;
-    /** Debounce time for saving to localStorage (ms) */
-    debounceTime?: number;
-}
-/**
- * Hook for managing grid layouts, including persistence, updates, and preset handling
- *
- * @param options Configuration options
- * @returns Layout management utilities
- */
-export declare function useGridLayoutManagement({ storageKey, defaultLayouts, onLayoutChangeCallback, debounceTime, }: UseGridLayoutManagementOptions): {
-    layouts: Layouts;
-    onLayoutChange: (_: Layout[], allLayouts: Layouts) => void;
-    applyLayout: (newLayouts: Layouts) => void;
-    resetToDefault: () => void;
-};
-export {};

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

@@ -1,12 +0,0 @@
-/** @format */
-export * from './GridItemContext';
-export * from './layoutUtils';
-export { default as GridItem } from './GridItem';
-export { default as ResponsiveGridLayout } from './ResponsiveGridLayout';
-export type { GridItem as GridItemType, GridLayoutProps } from './ResponsiveGridLayout';
-export { default as useGridLayout } from './useGridLayout';
-export * from './layoutStorageUtils';
-export * from './hooks/useGridLayoutManagement';
-export { default as EditModeToggler } from './Tools/EditModeToggler';
-export { default as BreakpointIndicator } from './Tools/BreakpointIndicator';
-export * from './store/usePanelStore';

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

@@ -1,52 +0,0 @@
-import { Layouts } from 'react-grid-layout';
-/**
- * Helper function to get layout from localStorage
- * @param key Storage key for the layout
- * @returns The stored layout or null if not found
- */
-export declare function getFromLS(key: string): Layouts | null;
-/**
- * Helper function to save layout to localStorage
- * @param key Storage key for the layout
- * @param value The layout to store
- */
-export declare function saveToLS(key: string, value: Layouts): void;
-export declare const USER_PRESETS_KEY = "user-layout-presets";
-/**
- * Layout preset interface
- */
-export interface LayoutPreset {
-    id: string;
-    name: string;
-    layouts: Layouts;
-    createdAt?: number;
-    updatedAt?: number;
-}
-/**
- * Helper function to get user presets from localStorage
- * @returns Array of user-defined layout presets
- */
-export declare function getUserPresets(): LayoutPreset[];
-/**
- * Helper function to save a user preset to localStorage
- * @param name Name of the preset
- * @param layouts Layout configuration to save
- * @returns ID of the newly created preset
- */
-export declare function saveUserPreset(name: string, layouts: Layouts): string;
-/**
- * Helper function to delete a user preset from localStorage
- * @param presetId ID of the preset to delete
- * @returns true if deletion was successful, false otherwise
- */
-export declare function deleteUserPreset(presetId: string): boolean;
-/**
- * Helper function to update a user preset in localStorage
- * @param presetId ID of the preset to update
- * @param updates Object with properties to update
- * @returns true if update was successful, false otherwise
- */
-export declare function updateUserPreset(presetId: string, updates: Partial<{
-    name: string;
-    layouts: Layouts;
-}>): boolean;

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

@@ -1,78 +0,0 @@
-import { Layout } from 'react-grid-layout';
-/**
- * Options for creating a grid item layout.
- * All properties are optional, allowing for flexible grid item creation.
- */
-export interface CreateGridItemOptions {
-    /**
-     * Unique identifier for the grid item.
-     * If not provided, a unique ID will be generated.
-     */
-    id?: string;
-    /**
-     * X position in the grid (column index).
-     * Defaults to 0 if not specified.
-     */
-    x?: number;
-    /**
-     * Y position in the grid (row index).
-     * Defaults to 0 if not specified.
-     */
-    y?: number;
-    /**
-     * Width of the grid item in grid units.
-     * If null, the item will span the full width of the grid.
-     * Defaults to 1 if not specified.
-     */
-    w?: number | null;
-    /**
-     * Height of the grid item in grid units.
-     * Defaults to 1 if not specified.
-     */
-    h?: number | null;
-    /**
-     * Minimum width constraint.
-     * Defaults to 1 if not specified.
-     */
-    minW?: number;
-    /**
-     * Maximum width constraint.
-     * If null, no maximum width constraint.
-     */
-    maxW?: number | null;
-    /**
-     * Minimum height constraint.
-     * Defaults to 1 if not specified.
-     */
-    minH?: number;
-    /**
-     * Maximum height constraint.
-     * If null, no maximum height constraint.
-     */
-    maxH?: number | null;
-    /**
-     * Whether the item is static (cannot be moved or resized).
-     * Defaults to false.
-     */
-    static?: boolean;
-}
-/**
- * Creates a grid item layout configuration.
- *
- * @example
- * // Create a grid item with default settings
- * createGridItem({ id: "my-item" });
- *
- * @example
- * // Create a grid item with specific dimensions
- * createGridItem({ id: "my-item", x: 0, y: 0, w: 7, h: 5 });
- *
- * @example
- * // Create a full-width grid item
- * createGridItem({
- *   id: "my-item",
- *   w: null, // null means full width
- *   h: 5
- * });
- */
-export declare function createGridItem(options: CreateGridItemOptions): Layout;

package/dist/src/common/components/layout/GridLayout/store/usePanelStore.d.ts

@@ -1,27 +0,0 @@
-/** @format */
-interface PanelState {
-    editMode: boolean;
-    toggleEditMode: () => void;
-    resizeMode: boolean;
-    toggleResizeMode: () => void;
-    moveMode: boolean;
-    toggleMoveMode: () => void;
-}
-/**
- * Store for managing panel state related to grid layouts.
- *
- * This uses a single editMode that enables both dragging and resizing.
- * It also manages saved layout presets.
- */
-export declare const usePanelStore: import('zustand/traditional').UseBoundStoreWithEqualityFn<Omit<import('zustand').StoreApi<PanelState>, "persist"> & {
-    persist: {
-        setOptions: (options: Partial<import('zustand/middleware').PersistOptions<PanelState, PanelState>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: PanelState) => void) => () => void;
-        onFinishHydration: (fn: (state: PanelState) => void) => () => void;
-        getOptions: () => Partial<import('zustand/middleware').PersistOptions<PanelState, PanelState>>;
-    };
-}>;
-export default usePanelStore;

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

@@ -1,11 +0,0 @@
-/** @format */
-/**
- * Hook to manage grid layout state
- *
- * @returns Object containing grid layout state and actions
- */
-declare const useGridLayout: () => {
-    editMode: boolean;
-    toggleEditMode: () => void;
-};
-export default useGridLayout;

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

@@ -1 +0,0 @@
-export * from './GridLayout';

package/dist/src/common/components/ui/CenteredHeading/CenteredHeading.d.ts

@@ -1,7 +0,0 @@
-/** @format */
-type CenteredHeadingProps = {
-    heading: string;
-    subheading?: string;
-};
-declare const CenteredHeading: ({ heading, subheading }: CenteredHeadingProps) => import("react/jsx-runtime").JSX.Element;
-export default CenteredHeading;

package/dist/src/common/components/ui/CollapsingButtons/CollapsingButtons.d.ts

@@ -1,11 +0,0 @@
-import { default as React } from 'react';
-interface CollapsingButtonsProps {
-    collapseIcon: React.ReactNode;
-    children: React.ReactNode;
-    collapseWidth: number;
-    delay?: number;
-    tooltipTitle?: string;
-    fullWidth?: boolean;
-}
-export declare const CollapsingButtons: ({ collapseIcon, children, collapseWidth, delay, tooltipTitle, fullWidth, }: CollapsingButtonsProps) => import("react/jsx-runtime").JSX.Element;
-export {};