@mui-toolpad-extended-tuni/main 3.2.0

package/README.md

@@ -0,0 +1,131 @@
+# @mui-toolpad-extended-tuni/main
+
+Main package for MUI Toolpad Extended TUNI - provides ToolpadProvider, LMS components, and platform features.
+
+## Installation
+
+```bash
+npm install @mui-toolpad-extended-tuni/main
+```
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+
+- `@emotion/react`: ^11.0.0
+- `@emotion/styled`: ^11.0.0
+- `@mui/icons-material`: ^7.0.0
+- `@mui/material`: ^7.0.0
+- `@mui/x-date-pickers`: ^7.0.0
+- `@toolpad/core`: ^0.16.0
+- `react`: ^19.0.0
+- `react-dom`: ^19.0.0
+- `react-router-dom`: ^7.0.0
+- `zustand`: ^4.5.0
+
+## Dependencies
+
+This package depends on:
+- `@mui-toolpad-extended-tuni/core`: ^3.1.0 (required)
+
+## Optional Extension Packages
+
+Install extension packages only if you need their functionality:
+
+```bash
+# Calendar microservice
+npm install @mui-toolpad-extended-tuni/calendar
+
+# Courses microservice
+npm install @mui-toolpad-extended-tuni/courses
+
+# Users microservice
+npm install @mui-toolpad-extended-tuni/users
+```
+
+**Note**: Extension packages require `@mui-toolpad-extended-tuni/main` as a peer dependency and will automatically register themselves when imported.
+
+## Basic Usage
+
+1. Setup your application with `ToolpadProvider` and routing:
+
+```tsx
+import { BrowserRouter } from 'react-router-dom';
+import { ToolpadProvider } from '@mui-toolpad-extended-tuni/main';
+
+function App() {
+  return (
+    <BrowserRouter>
+      <ToolpadProvider>{/* Your application content */}</ToolpadProvider>
+    </BrowserRouter>
+  );
+}
+```
+
+2. Use components and hooks from the package:
+
+```tsx
+import {
+  ToolpadProvider,
+  Microservices,
+  useNavigationStore,
+  useCurrentUser,
+  Notifications,
+  Dialogs,
+} from '@mui-toolpad-extended-tuni/main';
+```
+
+## Features
+
+### ToolpadProvider
+Main provider component that sets up authentication, navigation, theme, and other platform features.
+
+### Components
+- **Microservices**: Main microservice container component
+- **Home**: Default home page component
+- **Dialogs**: Dialog system (DialogOpener, FormDialog, ExtendedDialog)
+- **Notifications**: Notification system
+- **Editable Components**: Form components (EditableText, EditableSwitch, etc.)
+- **ErrorBoundary**: Error boundary component
+- **ThemeToggle**: Theme switching component
+
+### Stores & Hooks
+- Navigation stores and hooks
+- User management hooks (from core)
+- Dialog store
+- Platform store
+- Theme store
+- Toolbar store
+
+### Utilities
+- Axios configuration
+- Theme utilities
+- Cookie utilities (from core)
+- Case conversion utilities (from core)
+- Date parsing utilities (from core)
+
+## Migration from mui-toolpad-extended-tuni
+
+If you're migrating from the deprecated `mui-toolpad-extended-tuni` package:
+
+1. Update your `package.json`:
+   ```json
+   {
+     "dependencies": {
+       "@mui-toolpad-extended-tuni/main": "^3.2.0"
+     }
+   }
+   ```
+
+2. Update all imports:
+   ```typescript
+   // Old (deprecated)
+   import { ToolpadProvider } from 'mui-toolpad-extended-tuni';
+   
+   // New
+   import { ToolpadProvider } from '@mui-toolpad-extended-tuni/main';
+   ```
+
+## License
+
+MIT

package/dist/Forms/Components/Editables/EditableAutoComplete.d.ts

@@ -0,0 +1,12 @@
+/** @format */
+interface EditableAutocompleteProps<T> {
+    value: T[];
+    onChange: (value: T[]) => void;
+    label: string;
+    getOptionLabel?: (option: T) => string;
+    helperText?: string;
+}
+declare const EditableAutocomplete: <T extends string | {
+    [key: string]: any;
+}>({ value, onChange, label, getOptionLabel, helperText, }: EditableAutocompleteProps<T>) => import("react/jsx-runtime").JSX.Element;
+export default EditableAutocomplete;

package/dist/Forms/Components/Editables/EditableColor.d.ts

@@ -0,0 +1,8 @@
+/** @format */
+interface EditableColorProps {
+    value: string;
+    onChange: (value: string) => void;
+    label?: string;
+}
+declare const EditableColor: ({ value, onChange, label }: EditableColorProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableColor;

package/dist/Forms/Components/Editables/EditableImage.d.ts

@@ -0,0 +1,9 @@
+/** @format */
+interface EditableImageProps {
+    value?: string;
+    onChange: (value: string) => void;
+    defaultImage?: string;
+    label?: string;
+}
+declare const EditableImage: ({ value, onChange, defaultImage, label, }: EditableImageProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableImage;

package/dist/Forms/Components/Editables/EditableNumber.d.ts

@@ -0,0 +1,12 @@
+/** @format */
+interface EditableNumberProps {
+    value: number;
+    onChange: (value: number) => void;
+    label?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    helperText?: string;
+}
+declare const EditableNumber: ({ value, onChange, label, min, max, step, helperText, }: EditableNumberProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableNumber;

package/dist/Forms/Components/Editables/EditableSelect.d.ts

@@ -0,0 +1,14 @@
+/** @format */
+interface EditableSelectProps {
+    value: string;
+    onChange: (value: string) => void;
+    label: string;
+    options: {
+        value: string;
+        label: string;
+    }[];
+    explanation?: string;
+    helperText?: string;
+}
+declare const EditableSelect: ({ value, onChange, label, options, explanation, helperText, }: EditableSelectProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableSelect;

package/dist/Forms/Components/Editables/EditableSwitch.d.ts

@@ -0,0 +1,8 @@
+/** @format */
+interface EditableSwitchProps {
+    value: boolean;
+    onChange: (value: boolean) => void;
+    label: string;
+}
+declare const EditableSwitch: ({ value, onChange, label }: EditableSwitchProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableSwitch;

package/dist/Forms/Components/Editables/EditableText.d.ts

@@ -0,0 +1,32 @@
+/** @format */
+/**
+ * EditableText Component
+ *
+ * @version 3.0.0
+ * @breaking-changes
+ * - Added disabled state support
+ * - Enhanced layout with flex styling for better alignment
+ * - Improved hover state handling
+ * - Added justification controls for edit button
+ *
+ * A text field that can be toggled between read-only and edit modes.
+ * In read-only mode, displays text with an edit button that appears on hover.
+ * In edit mode, displays a text field for editing.
+ *
+ * @param {Object} props
+ * @param {string} props.label - Label for the text field
+ * @param {string} props.value - Current value
+ * @param {function} props.onChange - Callback when value changes
+ * @param {string} [props.helperText] - Helper text to display below the field
+ * @param {boolean} [props.disabled] - Whether the field is disabled
+ */
+interface EditableTextProps {
+    value: string;
+    onChange: (value: string) => void;
+    label: string;
+    multiline?: boolean;
+    helperText?: string;
+    disabled?: boolean;
+}
+declare const EditableText: ({ value, onChange, label, multiline, helperText, disabled, }: EditableTextProps) => import("react/jsx-runtime").JSX.Element;
+export default EditableText;

package/dist/Forms/Components/SqueezableTable/SqueezableTable.d.ts

@@ -0,0 +1,2 @@
+import { SqueezableTableProps } from './types';
+export declare function SqueezableTable<T extends string>({ columns, renderCell, data, maxHeight, stickyHeader, }: SqueezableTableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/Forms/Components/SqueezableTable/types.d.ts

@@ -0,0 +1,24 @@
+/** @format */
+export interface ColumnConfig<T extends string> {
+    key: T;
+    minWidth: number;
+    width: number;
+    squeezable: boolean;
+    label: string;
+}
+export interface SqueezableTableProps<T extends string> {
+    columns: ColumnConfig<T>[];
+    data: readonly any[] | any[];
+    renderCell: (columnKey: T, row: any) => React.ReactNode;
+    maxHeight?: string;
+    stickyHeader?: boolean;
+}
+export interface TableCellProps<T extends string> {
+    columnKey: T;
+    config: ColumnConfig<T>;
+    isSmallScreen: boolean;
+    isExpanded: boolean;
+    onHover: (key: T | null) => void;
+    onClick: (key: T) => void;
+    children: React.ReactNode;
+}

package/dist/Forms/PlatformSettings/PlatformSettings.d.ts

@@ -0,0 +1,21 @@
+/** @format */
+/**
+ * PlatformSettings Component
+ *
+ * @version 3.0.0
+ * @breaking-changes
+ * - Updated notification store path to feature-based structure
+ * - Enhanced form state management with isDirty tracking
+ * - Improved TypeScript strict mode compliance
+ * - Standardized string literals
+ * - Enhanced layout structure without fixed heights
+ * - Added unsaved changes warning system
+ *
+ * Provides interface for:
+ * - Managing platform-wide settings
+ * - Configuring global features
+ * - Setting platform defaults
+ * - Managing AI configurations
+ */
+declare const PlatformSettings: () => import("react/jsx-runtime").JSX.Element | null;
+export default PlatformSettings;

package/dist/Forms/PlatformSettings/PlatformSettingsTabs.d.ts

@@ -0,0 +1,16 @@
+import { Platform } from '../../store/usePlatformStore';
+import { AppTheme } from '../../store/useThemeStore';
+interface TabPanelProps {
+    children?: React.ReactNode;
+    index: number;
+    value: number;
+}
+export declare function TabPanel(props: TabPanelProps): import("react/jsx-runtime").JSX.Element;
+interface PlatformSettingsTabsProps {
+    platformSettings: Platform;
+    themeSettings: AppTheme;
+    handleUpdatePlatformSettings: (settings: Partial<Platform>) => void;
+    handleUpdateThemeSettings: (settings: AppTheme) => void;
+}
+export default function PlatformSettingsTabs({ platformSettings, themeSettings, handleUpdatePlatformSettings, handleUpdateThemeSettings, }: PlatformSettingsTabsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/AITab.d.ts

@@ -0,0 +1,7 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface AITabProps {
+    settings: Platform;
+    onUpdate: (settings: Platform) => void;
+}
+export default function AITab({ settings, onUpdate }: AITabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/AuthTab.d.ts

@@ -0,0 +1,7 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface AuthTabProps {
+    settings: Platform;
+    onUpdate: (settings: Partial<Platform>) => void;
+}
+export default function AuthTab({ settings, onUpdate }: AuthTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/CoursesTab.d.ts

@@ -0,0 +1,7 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface CoursesTabProps {
+    settings: Platform;
+    onUpdate: (settings: Partial<Platform>) => void;
+}
+export default function CoursesTab({ settings, onUpdate }: CoursesTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/FeaturesTab.d.ts

@@ -0,0 +1,24 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface FeaturesTabProps {
+    settings: Platform;
+    onUpdate: (settings: Platform) => void;
+}
+/**
+ * FeaturesTab Component
+ *
+ * @version 3.0.0
+ * @breaking-changes
+ * - Replaced Grid system with more flexible Box layout
+ * - Enhanced responsive design with flex-based layouts
+ * - Improved spacing consistency
+ * - Optimized component structure for better performance
+ * - Standardized style properties
+ *
+ * Provides interface for:
+ * - Managing platform-wide feature settings
+ * - Configuring feature availability
+ * - Setting feature-specific parameters
+ * - Managing feature dependencies
+ */
+export default function FeaturesTab({ settings, onUpdate }: FeaturesTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/GeneralTab.d.ts

@@ -0,0 +1,7 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface GeneralTabProps {
+    settings: Platform;
+    onUpdate: (settings: Partial<Platform>) => void;
+}
+export default function GeneralTab({ settings, onUpdate }: GeneralTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/PrivacyTab.d.ts

@@ -0,0 +1,7 @@
+import { Platform } from '../../../store/usePlatformStore';
+interface PrivacyTabProps {
+    settings: Platform;
+    onUpdate: (settings: Partial<Platform>) => void;
+}
+export default function PrivacyTab({ settings, onUpdate }: PrivacyTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/ThemeTab.d.ts

@@ -0,0 +1,7 @@
+import { AppTheme } from '../../../store/useThemeStore';
+interface ThemeTabProps {
+    theme: AppTheme;
+    onUpdate: (theme: AppTheme) => void;
+}
+export default function ThemeTab({ theme, onUpdate }: ThemeTabProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/components/ColorSettings.d.ts

@@ -0,0 +1,7 @@
+import { AppTheme } from '../../../../store/useThemeStore';
+interface ColorSettingsProps {
+    theme: AppTheme;
+    onUpdate: (theme: AppTheme) => void;
+}
+export declare const ColorSettings: ({ theme, onUpdate }: ColorSettingsProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/Forms/PlatformSettings/tabs/components/TypographySettings.d.ts

@@ -0,0 +1,7 @@
+import { AppTheme } from '../../../../store/useThemeStore';
+interface TypographySettingsProps {
+    theme: AppTheme;
+    onUpdate: (theme: AppTheme) => void;
+}
+export declare const TypographySettings: ({ theme, onUpdate, }: TypographySettingsProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ToolpadProvider.d.ts

@@ -0,0 +1,44 @@
+import { ReactNode } from 'react';
+export interface LogoConfig {
+    sidebarFooter?: {
+        smallLogo?: string;
+        fullLogo?: string;
+        alt?: string;
+    };
+}
+export interface ToolpadProviderProps {
+    children?: ReactNode;
+    logos?: LogoConfig;
+}
+export declare const useLogoContext: () => LogoConfig;
+/**
+ * ToolpadProvider Component
+ *
+ * @version 3.0.0
+ * @breaking-changes
+ * - Renamed from LMSProvider to ToolpadProvider in v3.0.0
+ * - Complete architectural restructuring for better separation of concerns
+ * - Removed direct course management (now handled by CourseManager)
+ * - Simplified authentication handling (now handled by AuthenticationManager)
+ * - Improved theme management with consistent application
+ * - Enhanced layout structure with PageContent and PageToolbar components
+ * - Removed direct message handling (now managed by respective components)
+ *
+ * Main application provider that sets up:
+ * - Authentication context
+ * - Theme provider
+ * - Navigation structure
+ * - Basic app layout
+ * - Router integration
+ *
+ * @example
+ * ```tsx
+ * <BrowserRouter>
+ *   <ToolpadProvider>
+ *     <YourApp />
+ *   </ToolpadProvider>
+ * </BrowserRouter>
+ * ```
+ */
+declare const ToolpadProvider: React.FC<ToolpadProviderProps>;
+export default ToolpadProvider;

package/dist/components/AuthenticationManager.d.ts

@@ -0,0 +1,2 @@
+declare const AuthenticationManager: () => null;
+export default AuthenticationManager;

package/dist/components/IconWithBadge.d.ts

@@ -0,0 +1,9 @@
+import { SxProps, Theme } from '@mui/material/styles';
+type IconWithBadgeProps = {
+    Icon: React.FC;
+    size: number;
+    title: string;
+    sx?: SxProps<Theme>;
+};
+declare const IconWithBadge: ({ Icon, size, title, sx }: IconWithBadgeProps) => import("react/jsx-runtime").JSX.Element;
+export default IconWithBadge;

package/dist/components/Microservices/MicroserviceNavigationBuilder.d.ts

@@ -0,0 +1,45 @@
+import { NavigationPageStoreItem } from '../../../../core/src';
+export type BuildMicroServiceNavigationProps = {
+    segment: string;
+    title: string;
+    description: string;
+    icon: any;
+    view?: React.ComponentType;
+    forRoles: string[];
+    children?: NavigationPageStoreItem[];
+};
+/**
+ * Builds a navigation structure for a microservice that can be integrated into the LMS navigation system.
+ *
+ * @param {BuildMicroServiceNavigation} options - Configuration options for the microservice navigation
+ * @param {string} options.segment - URL segment for the microservice (e.g., 'edutest')
+ * @param {string} options.title - Display title of the microservice
+ * @param {string} options.description - Description of the microservice's purpose
+ * @param {any} options.icon - MUI icon component to be used for the navigation item
+ * @param {string[]} options.forRoles - Array of role names that can access this microservice
+ * @param {NavigationPageStoreItem[]} [options.children] - Optional sub-navigation items
+ *
+ * @returns {NavigationPageStoreItem[]} Array containing the navigation structure
+ *
+ * @example
+ * ```typescript
+ * import ScienceIcon from '@mui/icons-material/Science';
+ *
+ * const eduTestNavigation = buildMicroServiceNavigation({
+ *   segment: 'edutest',
+ *   title: 'EduTest',
+ *   description: 'Testing system for education',
+ *   icon: ScienceIcon,
+ *   forRoles: ['teacher', 'student'],
+ *   children: [
+ *     {
+ *       kind: 'page',
+ *       segment: 'assignments',
+ *       title: 'Assignments',
+ *       // ... other properties
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare const buildMicroServiceNavigation: ({ segment, title, description, icon, view, forRoles, children, }: BuildMicroServiceNavigationProps) => NavigationPageStoreItem[];

package/dist/components/Microservices/MicroserviceSubsections.d.ts

@@ -0,0 +1,9 @@
+import { NavigationPageStoreItem } from '../../../../core/src';
+import { default as React } from 'react';
+/**
+ * Sub-sections navigation component for tool pages
+ */
+declare const SubSections: React.FC<{
+    children: NavigationPageStoreItem[];
+}>;
+export default SubSections;

package/dist/components/Microservices/Microservices.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+/**
+ * Core component for handling top-level app routing and microservices.
+ *
+ * @version 3.1.0
+ * @breaking-changes
+ * - Course routing has been moved to CourseMicroservice component
+ * - This component is now microservice-agnostic - it doesn't directly import course routes
+ * - Course routes register themselves via CourseRoutesProvider using NavigationRegistry
+ *
+ * Architecture:
+ * - Microservices handles: /, /help, /contact, dynamic microservices (via NavigationRegistry)
+ * - Course routes register themselves as route providers via CourseRoutesProvider
+ * - All routes are retrieved through useMicroserviceRoutes() which includes route providers
+ * - CourseMicroservice handles: /:code, /:code/:instance, /:code/:instance/:microservice
+ * - Course microservices are managed by CourseMicroservice component via context (not tightly coupled here)
+ *
+ * @component
+ * @param {Object} props
+ * @param {React.ReactNode} props.children - Child components (e.g., CourseMicroservice)
+ */
+declare const Microservices: ({ children }: {
+    children: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export default Microservices;

package/dist/components/Microservices/types.d.ts

@@ -0,0 +1,12 @@
+/** @format */
+/**
+ * Configuration interface for microservices
+ *
+ * Used to define microservice metadata including routing, component, and navigation building.
+ */
+export interface MicroserviceConfig {
+    path: string;
+    Component: React.ComponentType;
+    fetchHooks?: Array<(courseId: string) => void>;
+    buildNavigation: (courseId: string, isTeacher: boolean) => any[];
+}

package/dist/components/Routes/Home/Home.d.ts

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

package/dist/components/ThemeToggle/ThemeToggle.d.ts

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

package/dist/components/tools/addActions.d.ts

@@ -0,0 +1,5 @@
+import { NavigationStoreItem } from '../../../../core/src';
+/**
+ * Adds actions to navigation items based on their actionHandlers
+ */
+export declare const addActions: (navItems: NavigationStoreItem[]) => NavigationStoreItem[];

package/dist/components/tools/addIcons.d.ts

@@ -0,0 +1,2 @@
+import { NavigationStoreItem } from '../../../../core/src';
+export declare const addIcons: (navItems: NavigationStoreItem[]) => NavigationStoreItem[];

package/dist/components/tools/iconsByType.d.ts

@@ -0,0 +1,6 @@
+/** @format */
+type iconByType = {
+    [key: string]: React.ReactNode;
+};
+export declare const iconByType: iconByType;
+export {};

package/dist/components/tools/utils/ActionFCWrapper.d.ts

@@ -0,0 +1,5 @@
+declare const ActionFCWrapper: <T extends Record<string, unknown>>({ ActionHandler, props, }: {
+    ActionHandler: React.FC<T>;
+    props: T;
+}) => import("react/jsx-runtime").JSX.Element;
+export default ActionFCWrapper;

package/dist/components/tools/utils/IconFCWrapper.d.ts

@@ -0,0 +1,5 @@
+import { SvgIconComponent } from '@mui/icons-material';
+declare const IconWrapper: ({ IconFC }: {
+    IconFC: SvgIconComponent;
+}) => import("react/jsx-runtime").JSX.Element | null;
+export default IconWrapper;