@linagora/linid-im-front-corelib 0.0.76 → 0.0.78

package/dist/types/src/filters/linidFilter.d.ts

@@ -37,14 +37,15 @@ export declare class LinidFilter<T = Record<string, unknown>> {
     constructor(name: string, type: LinidFilterType, options: T, values: LinidFilterValue[]);
     /**
      * Parses a value expression (e.g. `paris|not_lk_lyon`, as produced by
-     * {@link LinidFilterValue.toString}) into a new {@link LinidFilter} instance. `input` is the
-     * bare value expression only — it never carries the `name=` query parameter prefix produced
-     * by {@link LinidFilter.toString}.
+     * {@link LinidFilterValue.toString}) into a new {@link LinidFilter} instance — `input` is the
+     * bare value expression only, never the `name=` query parameter prefix produced by
+     * {@link LinidFilter.toString}.
      *
-     * `type` and `options` are not derivable from `input`, so the returned filter gets a
-     * placeholder `'text'` `type` and empty `options`; `id` is auto generated by the constructor,
-     * as for any `LinidFilter` instance. Callers that already track a `LinidFilter` definition
-     * should only use the parsed `values`.
+     * `type`/`options` aren't derivable from `input`, so the result gets a placeholder `'text'`
+     * `type` and empty `options` (callers tracking a `LinidFilter` definition should only use the
+     * parsed `values`); `id` is auto generated as for any instance. A non-string `input` at runtime
+     * (this class is exported across Module Federation boundaries, where TypeScript cannot enforce
+     * the contract) is treated like an empty string: an empty `values` array, rather than throwing.
      * @param name - Identifier of the filter.
      * @param input - The value expression, with values separated by `|`.
      * @returns The parsed filter instance.

package/dist/types/src/filters/linidFilterSet.d.ts

@@ -0,0 +1,50 @@
+import { LinidFilter } from './linidFilter';
+/**
+ * Represents a saved filter set (favorite search), combining a user-defined label with the list
+ * of `LinidFilter` it is made of. It converts to and parses from a `&`-separated list of
+ * `name=value` query parameter pairs — the same URL filter representation produced by
+ * `LinidFilter.toString` — so it can be stored as-is in user preferences and reused directly as
+ * a query string against APIs powered by
+ * [`spring-query-filter`](https://github.com/Zorin95670/spring-query-filter).
+ */
+export declare class LinidFilterSet {
+    /**
+     * User-friendly name of the favorite search (e.g. "My Active Projects").
+     */
+    label: string;
+    /**
+     * Collection of filters composing the favorite search.
+     */
+    filters: LinidFilter[];
+    /**
+     * Creates a new filter set.
+     * @param label - User-friendly name of the favorite search.
+     * @param filters - Collection of filters composing the favorite search.
+     */
+    constructor(label: string, filters: LinidFilter[]);
+    /**
+     * Parses a string representation of a filter set, as produced by {@link LinidFilterSet.toString},
+     * into a new {@link LinidFilterSet} instance.
+     *
+     * Each `&`-separated segment containing the `=` separator is parsed as a `name=value` pair via
+     * {@link LinidFilter.fromString} (which in turn uses `LinidFilterValue.fromString`); segments
+     * without `=` are silently dropped instead of producing a filter with a guessed name. Since
+     * `type`/`options` aren't derivable from the string, parsed filters get placeholder values —
+     * match them back to known definitions by `name`.
+     *
+     * `value` tolerates `null`/`undefined`/any non-string at runtime (e.g. `localStorage.getItem(...)`,
+     * or across a Module Federation boundary): like an empty string, it produces an empty `filters`
+     * array instead of throwing.
+     * @param label - User-friendly name of the favorite search.
+     * @param value - The `&`-separated string of `name=value` pairs, as produced by `toString()`.
+     * @returns The parsed filter set.
+     */
+    static fromString(label: string, value: string | null | undefined): LinidFilterSet;
+    /**
+     * Reconstructs the filter set as a `&`-separated string of `name=value` pairs, one per filter,
+     * ready to use with APIs powered by `spring-query-filter` or to store in user preferences.
+     * @returns The string representation of the filter set, e.g.
+     * `status=active|pending&createdAt=gt_2026-01-01`.
+     */
+    toString(): string;
+}

package/dist/types/src/filters/linidFilterValue.d.ts

@@ -26,6 +26,11 @@ export declare class LinidFilterValue {
     constructor(isNegation: boolean, operator: LinidFilterOperator, value: string);
     /**
      * Parses a filter value expression (e.g. `not_lk_paris`) into a {@link LinidFilterValue}.
+     *
+     * If `input` is not actually a string at runtime (this class is exported across Module
+     * Federation boundaries, where TypeScript cannot enforce the contract), the negation marker and
+     * operator prefix can't be looked up, so this returns the same neutral result as for an empty
+     * string: no negation, no operator, empty value.
      * @param input - The filter value expression to parse.
      * @returns The parsed filter value.
      */

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

@@ -29,6 +29,7 @@ export { getPiniaStore, setPiniaStore } from './services/piniaStoreService';
 export { getUiDesign, setUiDesign } from './services/uiDesignService';
 export { uiEventSubject } from './services/uiEventService';
 export { LinidFilter } from './filters/linidFilter';
+export { LinidFilterSet } from './filters/linidFilterSet';
 export { LinidFilterValue } from './filters/linidFilterValue';
 export { LINID_FILTER_NEGATION_PREFIX, LINID_FILTER_OR_SEPARATOR, } from './types/linidFilter';
 export type { LinidZoneEntry } from './types/linidZone';
@@ -37,7 +38,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, LinidQCheckboxProps, LinidQDateProps, LinidQDialogProps, LinidQFieldProps, LinidQFileProps, LinidQFormProps, LinidQHeaderProps, LinidQIconProps, LinidQChipProps, LinidQImgProps, LinidQInputProps, LinidQItemLabelProps, LinidQItemProps, LinidQItemSectionProps, LinidQLayoutProps, LinidQListProps, LinidQMenuProps, LinidQRouteTabProps, LinidQSelectProps, LinidQSeparatorProps, LinidQSpinnerProps, LinidQSplitterProps, LinidQTableProps, LinidQTabsProps, LinidQToggleProps, LinidQToolbarProps, LinidQToolbarTitleProps, LinidQTreeProps, UiDesign, UiDesignNamespace, UiDesignValue, } from './types/uiDesign';
+export type { LinidQAvatarProps, LinidQBadgeProps, LinidQBannerProps, LinidQBtnDropdownProps, LinidQBtnProps, LinidQCardActionsProps, LinidQCardProps, LinidQCheckboxProps, LinidQDateProps, LinidQDialogProps, LinidQFieldProps, LinidQFileProps, LinidQFormProps, LinidQHeaderProps, LinidQIconProps, LinidQChipProps, LinidQImgProps, LinidQInputProps, LinidQItemLabelProps, LinidQItemProps, LinidQItemSectionProps, LinidQLayoutProps, LinidQListProps, LinidQMenuProps, LinidQOptionGroupProps, LinidQRouteTabProps, LinidQSelectProps, LinidQSeparatorProps, 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/types/linidFilter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Separator used between OR'd value expressions in a filter's string representation.
+ * Separator used between value expressions combined with OR in a filter's string representation.
  */
 export declare const LINID_FILTER_OR_SEPARATOR = "|";
 /**

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

@@ -1,4 +1,4 @@
-import type { NamedColor, QAvatarProps, QBadgeProps, QBannerProps, QBtnDropdownProps, QBtnProps, QCardActionsProps, QCardProps, QCheckboxProps, QChipProps, QDateProps, QDialogProps, QFieldProps, QFileProps, QFormProps, QHeaderProps, QIconProps, QImgProps, QInputProps, QItemLabelProps, QItemProps, QItemSectionProps, QLayoutProps, QListProps, QMenuProps, QRouteTabProps, QSelectProps, QSeparatorProps, QSpinnerProps, QSplitterProps, QTableProps, QTabsProps, QToggleProps, QToolbarProps, QToolbarTitleProps, QTreeProps, VueClassProp, VueStyleObjectProp, VueStyleProp } from 'quasar';
+import type { NamedColor, QAvatarProps, QBadgeProps, QBannerProps, QBtnDropdownProps, QBtnProps, QCardActionsProps, QCardProps, QCheckboxProps, QChipProps, QDateProps, QDialogProps, QFieldProps, QFileProps, QFormProps, QHeaderProps, QIconProps, QImgProps, QInputProps, QItemLabelProps, QItemProps, QItemSectionProps, QLayoutProps, QListProps, QMenuProps, QOptionGroup, QRouteTabProps, QSelectProps, QSeparatorProps, QSpinnerProps, QSplitterProps, QTableProps, QTabsProps, QToggleProps, QToolbarProps, QToolbarTitleProps, QTreeProps, VueClassProp, VueStyleObjectProp, VueStyleProp } from 'quasar';
 /**
  * Represents a single primitive value in the UI configuration.
  */
@@ -161,6 +161,7 @@ declare const Q_TREE_PROPS: readonly ["tickStrategy", "noSelectionUnset", "defau
  */
 declare const Q_SPLITTER_PROPS: readonly ["horizontal", "limits", "modelValue", "reverse", "unit", "disable", "beforeClass", "afterClass", "separatorClass", "separatorStyle", "dark"];
 declare const Q_SEPARATOR_PROPS: readonly ["spaced", "inset", "vertical", "dark", "size", "color"];
+declare const Q_OPTION_GROUP_PROPS: readonly ["keepColor", "type", "leftLabel", "inline", "size", "color", "dark", "dense"];
 /**
  * Maps Quasar component names to their respective props keys for UI design retrieval.
  */
@@ -305,12 +306,16 @@ export type LinidQSplitterProps = Pick<QSplitterProps, (typeof Q_SPLITTER_PROPS)
  * Subset of QSeparator props supported in UI design configuration.
  */
 export type LinidQSeparatorProps = Pick<QSeparatorProps, (typeof Q_SEPARATOR_PROPS)[number]>;
+/**
+ * Subset of QOptionGroup props supported in UI design configuration.
+ */
+export type LinidQOptionGroupProps = Pick<QOptionGroup, (typeof Q_OPTION_GROUP_PROPS)[number]>;
 /**
  * Union type of all supported Quasar component props subsets.
  */
-export type LinidQComponentProps = LinidQAvatarProps | LinidQBadgeProps | LinidQBannerProps | LinidQBtnDropdownProps | LinidQBtnProps | LinidQCardActionsProps | LinidQCardProps | LinidQCheckboxProps | LinidQDateProps | LinidQDialogProps | LinidQFieldProps | LinidQFileProps | LinidQFormProps | LinidQHeaderProps | LinidQIconProps | LinidQChipProps | LinidQImgProps | LinidQInputProps | LinidQItemLabelProps | LinidQItemProps | LinidQItemSectionProps | LinidQListProps | LinidQMenuProps | LinidQRouteTabProps | LinidQSelectProps | LinidQSeparatorProps | LinidQSpinnerProps | LinidQSplitterProps | LinidQTableProps | LinidQTabsProps | LinidQToggleProps | LinidQToolbarProps | LinidQToolbarTitleProps | LinidQTreeProps;
+export type LinidQComponentProps = LinidQAvatarProps | LinidQBadgeProps | LinidQBannerProps | LinidQBtnDropdownProps | LinidQBtnProps | LinidQCardActionsProps | LinidQCardProps | LinidQCheckboxProps | LinidQDateProps | LinidQDialogProps | LinidQFieldProps | LinidQFileProps | LinidQFormProps | LinidQHeaderProps | LinidQIconProps | LinidQChipProps | LinidQImgProps | LinidQInputProps | LinidQItemLabelProps | LinidQItemProps | LinidQItemSectionProps | LinidQListProps | LinidQMenuProps | LinidQOptionGroupProps | LinidQRouteTabProps | LinidQSelectProps | LinidQSeparatorProps | LinidQSpinnerProps | LinidQSplitterProps | LinidQTableProps | LinidQTabsProps | LinidQToggleProps | LinidQToolbarProps | LinidQToolbarTitleProps | LinidQTreeProps;
 /**
  * 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-checkbox' | 'q-date' | 'q-dialog' | 'q-field' | 'q-file' | 'q-form' | 'q-header' | 'q-icon' | 'q-chip' | 'q-img' | 'q-input' | 'q-item' | 'q-item-label' | 'q-item-section' | 'q-layout' | 'q-list' | 'q-menu' | 'q-route-tab' | 'q-select' | 'q-separator' | 'q-spinner' | 'q-splitter' | '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-checkbox' | 'q-date' | 'q-dialog' | 'q-field' | 'q-file' | 'q-form' | 'q-header' | 'q-icon' | 'q-chip' | 'q-img' | 'q-input' | 'q-item' | 'q-item-label' | 'q-item-section' | 'q-layout' | 'q-list' | 'q-menu' | 'q-option-group' | 'q-route-tab' | 'q-select' | 'q-separator' | 'q-spinner' | 'q-splitter' | 'q-table' | 'q-tabs' | 'q-toggle' | 'q-toolbar' | 'q-toolbar-title' | 'q-tree';
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linagora/linid-im-front-corelib",
-  "version": "0.0.76",
+  "version": "0.0.78",
   "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": [