@linagora/linid-im-front-corelib 0.0.63 → 0.0.66

package/dist/types/src/composables/useDayjs.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_DATE_FORMAT = "YYYY-MM-DD";
+/**
+ * Composable exposing dayjs utility functions.
+ * @returns An object containing dayjs helper methods.
+ */
+export declare function useDayjs(): {
+    maxDate: (dates: unknown[], format?: string) => import("dayjs").Dayjs | null;
+    minDate: (dates: unknown[], format?: string) => import("dayjs").Dayjs | null;
+    toDayjs: (value: unknown, format?: string) => import("dayjs").Dayjs;
+};

package/dist/types/src/composables/useFieldValidation.d.ts

@@ -15,5 +15,8 @@ export declare function useFieldValidation(i18nScope: string): {
     pattern: (value: string, pattern: string) => true | string;
     unique: (value: unknown, items: unknown[]) => true | string;
     validDate: (value: unknown, format?: string) => true | string;
-    dateNotInPast: (value: unknown, format?: string) => true | string;
+    afterDate: (value: unknown, compareTo: unknown, format?: string) => true | string;
+    beforeDate: (value: unknown, compareTo: unknown, format?: string) => true | string;
+    fromDate: (value: unknown, compareTo: unknown, format?: string) => true | string;
+    upToDate: (value: unknown, compareTo: unknown, format?: string) => true | string;
 };

package/dist/types/src/composables/useNunjucks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Composable exposing utility functions for working with Nunjucks templates.
+ * It provides a method to recursively render all string properties of an object as Nunjucks templates using a shared Nunjucks environment.
+ * The Nunjucks environment must be initialized and set in the `nunjucksService` before using this composable.
+ *
+ * **Security note:** XSS safety of the rendered output depends entirely on the Nunjucks environment
+ * provided by the caller. If the output is injected into the DOM as raw HTML (e.g. Via `v-html`),
+ * ensure the environment is configured with `autoescape: true`. Template strings (`value`) must be
+ * developer-controlled; passing user-supplied strings as templates is not supported and may introduce
+ * template injection risks.
+ * @returns An object containing utility methods for rendering Nunjucks templates within objects.
+ */
+export declare function useNunjucks(): {
+    render: <T>(value: T, context: Record<string, unknown>) => T;
+};

package/dist/types/src/composables/useQuasarDate.d.ts

@@ -0,0 +1,10 @@
+export declare const QDATE_DEFAULT_MASK = "YYYY/MM/DD";
+/**
+ * Composable for date handling compatible with Quasar framework.
+ * Provides utility functions to convert date strings between arbitrary formats and the Quasar date component format.
+ * @returns An object containing date utility methods for Quasar.
+ */
+export declare function useQuasarDate(): {
+    toQDateFormat: (date: string, format?: string) => string;
+    formatQDate: (date: unknown, format?: string) => string;
+};

package/dist/types/src/composables/useQuasarFieldValidation.d.ts

@@ -14,5 +14,8 @@ export declare function useQuasarFieldValidation(i18nScope: string): {
     pattern: (patternValue: string) => (value: string) => string | true;
     unique: (items: unknown[]) => (value: unknown) => string | true;
     validDate: (format?: string) => (value: unknown) => string | true;
-    dateNotInPast: (format?: string) => (value: unknown) => string | true;
+    afterDate: (compareTo: string, format?: string) => (value: unknown) => string | true;
+    beforeDate: (compareTo: string, format?: string) => (value: unknown) => string | true;
+    fromDate: (compareTo: string, format?: string) => (value: unknown) => string | true;
+    upToDate: (compareTo: string, format?: string) => (value: unknown) => string | true;
 };

package/dist/types/src/composables/useTree.d.ts

@@ -12,5 +12,5 @@ import type { TreeNode } from '../types/linidTree';
  * @returns An object exposing tree conversion helpers.
  */
 export declare function useTree(): {
-    toQTreeNodes: (nodes: TreeNode[]) => QTreeNode[];
+    toQTreeNodes: <T>(nodes: TreeNode<T>[]) => QTreeNode[];
 };

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

@@ -1,17 +1,21 @@
 export { default as LinidZoneRenderer } from './components/LinidZoneRenderer.vue';
+export { DEFAULT_DATE_FORMAT, useDayjs } from './composables/useDayjs';
 export { useDialog } from './composables/useDialog';
 export { useFieldValidation } from './composables/useFieldValidation';
 export { useNotify } from './composables/useNotify';
+export { useNunjucks } from './composables/useNunjucks';
 export { usePagination } from './composables/usePagination';
+export { QDATE_DEFAULT_MASK, useQuasarDate } from './composables/useQuasarDate';
 export { useQuasarFieldValidation } from './composables/useQuasarFieldValidation';
 export { useQuasarRules } from './composables/useQuasarRules';
 export { useScopedI18n } from './composables/useScopedI18n';
-export { useUiDesign } from './composables/useUiDesign';
 export { useTree } from './composables/useTree';
+export { useUiDesign } from './composables/useUiDesign';
 export { useLinidConfigurationStore } from './stores/linidConfigurationStore';
 export { useLinidUiStore } from './stores/linidUiStore';
-export { useLinidZoneStore } from './stores/linidZoneStore';
 export { useLinidUserStore } from './stores/linidUserStore';
+export { useLinidZoneStore } from './stores/linidZoneStore';
+export { getDayjsInstance, setDayjsInstance } from './services/dayjsService';
 export { getModuleFederation, loadAsyncComponent, setModuleFederation, } from './services/federationService';
 export { getHttpClient, setHttpClient } from './services/httpClientService';
 export { getI18nInstance, setI18nInstance } from './services/i18nService';
@@ -29,7 +33,7 @@ export type { Page, Pagination, QTableRequestEvent, QuasarPagination, QueryFilte
 export type { AttributeInputType, LinidApiEndpointConfiguration, LinidAttributeConfiguration, LinidEntityConfiguration, } from './types/linidConfiguration';
 export type { FederatedModule, ModuleHostConfig, ModuleZoneDefinition, RemoteModule, } from './types/module';
 export type { ModuleLifecycleHooks, ModuleLifecycleResult, } from './types/moduleLifecycle';
-export type { LinidQAvatarProps, LinidQBadgeProps, LinidQBannerProps, LinidQBtnDropdownProps, LinidQBtnProps, LinidQCardActionsProps, LinidQCardProps, LinidQDateProps, LinidQDialogProps, LinidQFileProps, LinidQFormProps, LinidQHeaderProps, LinidQIconProps, LinidQImgProps, LinidQInputProps, LinidQItemLabelProps, LinidQItemProps, LinidQItemSectionProps, LinidQListProps, LinidQMenuProps, LinidQRouteTabProps, LinidQSelectProps, LinidQSpinnerProps, LinidQTableProps, LinidQTabsProps, LinidQToggleProps, LinidQToolbarProps, LinidQToolbarTitleProps, LinidQTreeProps, UiDesign, UiDesignNamespace, UiDesignValue, } from './types/uiDesign';
+export type { LinidQAvatarProps, LinidQBadgeProps, LinidQBannerProps, LinidQBtnDropdownProps, LinidQBtnProps, LinidQCardActionsProps, LinidQCardProps, LinidQDateProps, LinidQDialogProps, LinidQFileProps, LinidQFormProps, LinidQHeaderProps, LinidQIconProps, LinidQImgProps, LinidQInputProps, LinidQItemLabelProps, LinidQItemProps, LinidQItemSectionProps, LinidQListProps, LinidQMenuProps, LinidQRouteTabProps, LinidQSelectProps, LinidQSpinnerProps, LinidQSplitterProps, LinidQTableProps, LinidQTabsProps, LinidQToggleProps, LinidQToolbarProps, LinidQToolbarTitleProps, LinidQTreeProps, UiDesign, UiDesignNamespace, UiDesignValue, } from './types/uiDesign';
 export type { NavigationMenuItem } from './types/linidUi';
 export { ModuleLifecyclePhase } from './types/moduleLifecycle';
 export { BasicRemoteModule } from './lifecycle/skeleton';

package/dist/types/src/services/dayjsService.d.ts

@@ -0,0 +1,13 @@
+import type dayjs from 'dayjs';
+/**
+ * Initializes the shared Dayjs instance.
+ * Should be called once by the host application during boot.
+ * @param instance - The Dayjs instance to use as the shared instance.
+ */
+export declare function setDayjsInstance(instance: typeof dayjs): void;
+/**
+ * Returns the shared Dayjs instance.
+ * Must be called after initialization via `setDayjsInstance()`.
+ * @returns The shared Dayjs instance.
+ */
+export declare function getDayjsInstance(): typeof dayjs;

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

@@ -3,4 +3,4 @@
  * These validators read their parameters from the `inputSettings` property
  * of `LinidAttributeConfiguration`.
  */
-export type ValidatorName = 'email' | 'dateNotInPast' | 'min' | 'max' | 'minLength' | 'maxLength' | 'pattern' | 'unique' | 'validDate';
+export type ValidatorName = 'email' | 'min' | 'max' | 'minLength' | 'maxLength' | 'pattern' | 'unique';

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

@@ -2,7 +2,7 @@
  * Supported UI input types for attribute rendering.
  * Each type corresponds to a specific form component.
  */
-export type AttributeInputType = 'Text' | 'Number' | 'Boolean' | 'Date' | 'List' | 'DynamicList';
+export type AttributeInputType = 'Text' | 'Number' | 'Boolean' | 'Date' | 'List' | 'DynamicList' | 'Textarea';
 /**
  * Describes a single attribute of an entity.
  * Corresponds to `AttributeDescription` from the backend API.

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

@@ -1,7 +1,7 @@
 /**
  * Represents a node in the tree structure.
  */
-export type TreeNode = {
+export type TreeNode<T> = {
     /**
      * The type of the node.
      */
@@ -11,13 +11,13 @@ export type TreeNode = {
      */
     key: string;
     /**
-     * The value associated with the node, which can be a string, number, or an object for complex nodes.
+     * The value associated with the node.
      */
-    value: string | number | Record<string, unknown>;
+    value: T;
     /**
      * Child nodes nested under this node.
      */
-    nodes: TreeNode[];
+    nodes: TreeNode<T>[];
     /**
      * Additional actions specific to this node instance, merged with the
      * default actions defined by the matching `TreeNodeType`.

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

@@ -1,4 +1,4 @@
-import type { NamedColor, QAvatarProps, QBadgeProps, QBannerProps, QBtnDropdownProps, QBtnProps, QCardActionsProps, QCardProps, QDateProps, QDialogProps, QFileProps, QFormProps, QHeaderProps, QIconProps, QImgProps, QInputProps, QItemLabelProps, QItemProps, QItemSectionProps, QListProps, QMenuProps, QRouteTabProps, QSelectProps, QSpinnerProps, QTableProps, QTabsProps, QToggleProps, QToolbarProps, QToolbarTitleProps, QTreeProps, VueClassProp, VueStyleObjectProp, VueStyleProp } from 'quasar';
+import type { NamedColor, QAvatarProps, QBadgeProps, QBannerProps, QBtnDropdownProps, QBtnProps, QCardActionsProps, QCardProps, QDateProps, QDialogProps, QFileProps, QFormProps, QHeaderProps, QIconProps, QImgProps, QInputProps, QItemLabelProps, QItemProps, QItemSectionProps, QListProps, QMenuProps, QRouteTabProps, QSelectProps, QSpinnerProps, QSplitterProps, QTableProps, QTabsProps, QToggleProps, QToolbarProps, QToolbarTitleProps, QTreeProps, VueClassProp, VueStyleObjectProp, VueStyleProp } from 'quasar';
 /**
  * Represents a single primitive value in the UI configuration.
  */
@@ -140,6 +140,10 @@ declare const Q_MENU_PROPS: readonly ["contextMenu", "touchPosition", "persisten
  * List of QTreeProps keys for type-safe UI design retrieval.
  */
 declare const Q_TREE_PROPS: readonly ["tickStrategy", "noSelectionUnset", "defaultExpandAll", "accordion", "noTransition", "noConnectors", "color", "controlColor", "textColor", "selectedColor", "dense", "dark", "duration"];
+/**
+ * List of QSplitterProps keys for type-safe UI design retrieval.
+ */
+declare const Q_SPLITTER_PROPS: readonly ["horizontal", "limits", "modelValue", "reverse", "unit", "disable", "beforeClass", "afterClass", "separatorClass", "separatorStyle", "dark"];
 /**
  * Maps Quasar component names to their respective props keys for UI design retrieval.
  */
@@ -260,6 +264,10 @@ export type LinidQMenuProps = Pick<QMenuProps, (typeof Q_MENU_PROPS)[number]>;
  * Subset of QTreeProps props supported in UI design configuration.
  */
 export type LinidQTreeProps = Pick<QTreeProps, (typeof Q_TREE_PROPS)[number]>;
+/**
+ * Subset of QSplitter props supported in UI design configuration.
+ */
+export type LinidQSplitterProps = Pick<QSplitterProps, (typeof Q_SPLITTER_PROPS)[number]>;
 /**
  * Union type of all supported Quasar component props subsets.
  */
@@ -267,5 +275,5 @@ export type LinidQComponentProps = LinidQAvatarProps | LinidQBadgeProps | LinidQ
 /**
  * Valid Quasar component names for type-safe UI design retrieval.
  */
-export type QComponentName = 'q-avatar' | 'q-badge' | 'q-banner' | 'q-btn' | 'q-btn-dropdown' | 'q-card' | 'q-card-actions' | 'q-date' | 'q-dialog' | 'q-file' | 'q-form' | 'q-header' | 'q-icon' | 'q-img' | 'q-input' | 'q-item' | 'q-item-label' | 'q-item-section' | 'q-list' | 'q-menu' | 'q-route-tab' | 'q-select' | 'q-spinner' | 'q-table' | 'q-tabs' | 'q-toggle' | 'q-toolbar' | 'q-toolbar-title' | 'q-tree';
+export type QComponentName = 'q-avatar' | 'q-badge' | 'q-banner' | 'q-btn' | 'q-btn-dropdown' | 'q-card' | 'q-card-actions' | 'q-date' | 'q-dialog' | 'q-file' | 'q-form' | 'q-header' | 'q-icon' | 'q-img' | 'q-input' | 'q-item' | 'q-item-label' | 'q-item-section' | 'q-list' | 'q-menu' | 'q-route-tab' | 'q-select' | 'q-spinner' | 'q-table' | 'q-tabs' | 'q-toggle' | 'q-toolbar' | 'q-toolbar-title' | 'q-tree' | 'q-splitter';
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linagora/linid-im-front-corelib",
-  "version": "0.0.63",
+  "version": "0.0.66",
   "description": "Core library of the LinID Identity Manager project. Provides shared types, services, components, and utilities for front-end and plugin, enabling consistent integration across the LinID ecosystem.",
   "type": "module",
   "files": [
@@ -34,6 +34,11 @@
       "name": "Christophe Chevalier",
       "email": "cchevalier@linagora.com",
       "url": "https://github.com/christophechevalier"
+    },
+    {
+      "name": "Adrien Céré",
+      "email": "acere@linagora.com",
+      "url": "https://github.com/Hamilcar31"
     }
   ],
   "license": "AGPL-3.0-only",