@mmlogic/components 0.5.12 → 0.5.14

package/dist/mosterdcomponents/validation-CjjTt66G.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-CjjTt66G.js","sources":["src/utils/validation.ts"],"sourcesContent":["import { ClientLayoutItemFieldDataType } from '../types';\n\nexport function validateRequired(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n  if (typeof value === 'string') return value.trim().length > 0;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') {\n    // HyperlinkValue check\n    const hv = value as { href?: unknown };\n    if ('href' in hv) return typeof hv.href === 'string' && hv.href.trim().length > 0;\n    // CurrencyValue check\n    const cv = value as { amount?: unknown };\n    if ('amount' in cv) return cv.amount !== null && cv.amount !== undefined && cv.amount !== '';\n  }\n  return true;\n}\n\nexport function validateEmail(value: string): boolean {\n  if (!value) return true;\n  return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value);\n}\n\nexport function validateUrl(value: string): boolean {\n  if (!value) return true;\n  try {\n    const url = new URL(value);\n    return url.protocol === 'http:' || url.protocol === 'https:';\n  } catch {\n    return false;\n  }\n}\n\nexport function validateNumber(value: unknown, dataType: ClientLayoutItemFieldDataType): boolean {\n  if (value === null || value === undefined || value === '') return true;\n  const num = Number(value);\n  if (isNaN(num)) return false;\n  if (dataType === ClientLayoutItemFieldDataType.INTEGER) {\n    return Number.isInteger(num);\n  }\n  if (dataType === ClientLayoutItemFieldDataType.PERCENTAGE) {\n    return num >= 0 && num <= 100;\n  }\n  return true;\n}\n"],"names":[],"mappings":";;;AAEM,SAAU,gBAAgB,CAAC,KAAc,EAAA;AAC7C,IAAA,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;AAAE,QAAA,OAAO,KAAK;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;AAC7D,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;AACjD,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;;QAE7B,MAAM,EAAE,GAAG,KAA2B;QACtC,IAAI,MAAM,IAAI,EAAE;AAAE,YAAA,OAAO,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;;QAEjF,MAAM,EAAE,GAAG,KAA6B;QACxC,IAAI,QAAQ,IAAI,EAAE;AAAE,YAAA,OAAO,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE;;AAE9F,IAAA,OAAO,IAAI;AACb;AAEM,SAAU,aAAa,CAAC,KAAa,EAAA;AACzC,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AACvB,IAAA,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;AACjD;AAEM,SAAU,WAAW,CAAC,KAAa,EAAA;AACvC,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AACvB,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC;QAC1B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;;IAC5D,OAAA,EAAA,EAAM;AACN,QAAA,OAAO,KAAK;;AAEhB;AAEM,SAAU,cAAc,CAAC,KAAc,EAAE,QAAuC,EAAA;IACpF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;AAAE,QAAA,OAAO,IAAI;AACtE,IAAA,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,GAAG,CAAC;AAAE,QAAA,OAAO,KAAK;AAC5B,IAAA,IAAI,QAAQ,KAAK,6BAA6B,CAAC,OAAO,EAAE;AACtD,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;;AAE9B,IAAA,IAAI,QAAQ,KAAK,6BAA6B,CAAC,UAAU,EAAE;AACzD,QAAA,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG;;AAE/B,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/types/components/documents/mrd-document-container/mrd-document-container.d.ts

@@ -29,6 +29,10 @@ export declare class MrdDocumentContainer {
      *  on top, Finder-style. The table manages its own height. */
     height: number;
     locale: string;
+    /** When true, this dashboard is read-only: New folder and Upload are disabled
+     *  (with a tooltip explaining why) and the embedded table/list get it passed
+     *  through so their own create/upload/drag-drop paths are disabled too. */
+    readOnly: boolean;
     /** Re-emitted from the embedded list/table. `nodeId` present for a folder load. */
     mrdLoadPage: EventEmitter<{
         page: number;

package/dist/types/components/documents/mrd-document-list/mrd-document-list.d.ts

@@ -33,6 +33,11 @@ export declare class MrdDocumentList {
      *  accepts file drops and folder creation. */
     containerHref: string;
     locale: string;
+    /** When true, folder creation, file upload (button and drag-drop) and moving a
+     *  document between folders are all disabled — a viewer-role user can browse
+     *  but not mutate anything. Drives mrdCanCreate(false) so the host toolbar's
+     *  New folder / Upload buttons stay disabled too. */
+    readOnly: boolean;
     /** Request distinct values for a field/relation. Host fetches `{path}?{qs}` and calls `setDistinct(nodeId, values)`. */
     mrdLoadDistinct: EventEmitter<{
         nodeId: string;
@@ -181,7 +186,7 @@ export declare class MrdDocumentList {
     private resolveTarget;
     private get canCreateFolder();
     /** Start creating a folder under the current target. Called by the host toolbar
-     *  (mrd-document-container). No-op when there is no valid target. */
+     *  (mrd-document-container). No-op when there is no valid target, or read-only. */
     createFolder(): Promise<void>;
     private startCreateFolder;
     private onPendingInput;

package/dist/types/components/layout/mrd-layout-section/mrd-layout-section.d.ts

@@ -18,6 +18,10 @@ export declare class MrdLayoutSection {
     /** Top-level archetypes on the object dashboard. When it contains commons.document,
      *  the record is rendered as a single-document view instead of generic fields. */
     archetypes: ClientArchetype[];
+    /** When true, this dashboard is read-only (viewer role): the embedded mrd-table's
+     *  create ("+") action and the documents view's New folder / Upload are disabled
+     *  with a tooltip explaining why, so it's clear at a glance the user can't mutate data. */
+    readOnly: boolean;
     private searchQueryMap;
     private searchResultsMap;
     private imagePreviewUrl;

package/dist/types/components/table/mrd-table/mrd-table.d.ts

@@ -15,6 +15,17 @@ export declare class MrdTable {
     private keydownHandler;
     private createPickerClickHandler;
     private viewPopoverClickHandler;
+    /** Debounce timer for the free-text search box — separate from debounceTimer
+     *  (pending-page requests), since typing and scrolling debounce independently. */
+    private searchDebounceTimer;
+    /** The rendered search <input>, captured so it can be focused the instant it mounts. */
+    private searchInputEl;
+    /** Set by toggleSearch() when the box just expanded; consumed and cleared in componentDidRender(). */
+    private searchNeedsFocus;
+    /** Column filters stashed by stashFiltersForSearch() while the search box is open — the
+     *  backend can't combine `q` with column filters. Restored by restoreFiltersAfterSearch()
+     *  on close, unless the user applied a fresh filter of their own in the meantime. */
+    private stashedFilters;
     /** Watches the host for gaining a box (e.g. its tab pane being shown) — see componentDidLoad. */
     private resizeObserver;
     /** Guards against scheduling more than one column-width measurement per freeze. */
@@ -48,6 +59,10 @@ export declare class MrdTable {
     /** Time (ms) to wait for setPage() before retrying a page request; after
      *  MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages). */
     requestTimeoutMs: number;
+    /** When true, the toolbar's create ("+") action is disabled (with a tooltip
+     *  explaining why) so a viewer-role user can see at a glance that this dashboard
+     *  is read-only. Sorting, filtering and export stay available — those don't mutate data. */
+    readOnly: boolean;
     /** Clamp renderEnd when totalElements shrinks (e.g. after a filter is applied).
      *  0 means "unknown" (hosts that rely on minKnownTotal never set it, and some reset it
      *  while a filter is being applied) — clamping to it would collapse the window to a
@@ -70,6 +85,10 @@ export declare class MrdTable {
     sortDir: 'asc' | 'desc';
     /** Active filters keyed by field name. */
     activeFilters: Map<string, ColumnFilter>;
+    /** True while the toolbar's magnifying glass is expanded into the search input. */
+    private searchOpen;
+    /** Current free-text search query — sent as `q` on every mrdLoadPage/aggregations request. */
+    private searchQuery;
     /** Field name of the currently open filter popup (null = closed). */
     openFilterCol: string | null;
     /** Filter state being edited in the open popup. */
@@ -254,7 +273,13 @@ export declare class MrdTable {
      *  VIEW:         /{dataClass}
      *  RELATED_VIEW: /{fromClass}/{parentId}/{dataClass}  */
     private buildDataPath;
-    /** Build query params for a page request from current sort, view filters, filterClass and active column filters. */
+    /** Build query params for a page request from current sort, view filters, filterClass and active column filters.
+     *
+     *  `q` and column filters are mutually exclusive on the backend — combining them breaks
+     *  the search. stashFiltersForSearch() already empties activeFilters for the duration of
+     *  a search, but this guard is the actual guarantee: even if a filter is applied through
+     *  a column header while the search box is still open (before the query is cleared),
+     *  activeFilters is dropped from the request rather than sent alongside `q`. */
     private buildQueryParams;
     /** True when the table is in paginated / virtual-scroll mode rather than driven by the
      *  rows prop. Mirrors the branch taken in render().
@@ -302,9 +327,35 @@ export declare class MrdTable {
     private closeJsonModal;
     private setPending;
     private togglePendingValue;
+    /** Common reload after activeFilters or searchQuery changed: drop stale aggregations
+     *  (the next setPage(0) re-requests them, guarded against `q` in setPage() itself) and
+     *  re-fetch page 0. Shared by the filter popup, clear-all, and free-text search. */
+    private reloadAfterQueryChange;
     private applyFilter;
     private clearFilter;
     private clearAllFilters;
+    /** Search is a VIEW-only affordance — a RELATED_VIEW table is already scoped to
+     *  its parent record, so a free-text box there would invite confusion about what
+     *  it searches across. */
+    private get searchEnabled();
+    private toggleSearch;
+    /** Collapses the box back to the icon. Clearing a non-empty query and restoring any
+     *  stashed filters can each independently require a reload — reloadAfterQueryChange()
+     *  is called at most once here regardless of how many of the two actually changed. */
+    private closeSearch;
+    private handleSearchInput;
+    /** Reloads from page 0 with the current searchQuery, same reset as applyFilter(). */
+    private applySearch;
+    /** Column filters and the free-text `q` param are mutually exclusive on the backend —
+     *  sending both breaks the search. Opening the search box stashes any active filters
+     *  and clears them (the header filter icons and the clear-all button disappear along
+     *  with activeFilters, so there is nothing extra to hide) and reloads unfiltered. */
+    private stashFiltersForSearch;
+    /** Restores filters stashed by stashFiltersForSearch(), unless the user applied a fresh
+     *  filter of their own while the search box was open — that explicit choice wins over
+     *  reinstating the old one. Returns whether activeFilters actually changed, so the
+     *  caller can decide whether a reload is needed. */
+    private restoreFiltersAfterSearch;
     private handleViewSwitch;
     private toggleViewPopover;
     private closeViewPopover;

package/dist/types/components/table/mrd-table/table-parts.d.ts

@@ -6,6 +6,9 @@ import { AggregationResult, ClientCreateType } from '../../../types/client-layou
  * component; these components receive plain values and callbacks.
  */
 export declare const FilterIcon: FunctionalComponent;
+export declare const SearchIcon: FunctionalComponent<{
+    class?: string;
+}>;
 export declare const TableCell: FunctionalComponent<{
     col: TableColumn;
     row: Record<string, any>;
@@ -43,6 +46,14 @@ export interface ToolbarCallbacks {
     /** Emit the create action; basicType set when chosen from the create-type picker. */
     onCreate: (basicType?: string) => void;
     onAction: (action: string) => void;
+    /** Expand the collapsed magnifying-glass icon into the search input, or collapse it back. */
+    onToggleSearch: () => void;
+    /** Free-text search input changed; caller debounces before reloading. */
+    onSearchInput: (value: string) => void;
+    /** Clear the query and collapse the search box back to the icon. */
+    onCloseSearch: () => void;
+    /** Captures the rendered <input> so the caller can focus it the instant it mounts. */
+    onSearchInputRef: (el?: HTMLInputElement) => void;
 }
 export declare const Toolbar: FunctionalComponent<{
     locale: string;
@@ -55,5 +66,12 @@ export declare const Toolbar: FunctionalComponent<{
     viewPopoverOpen: boolean;
     createPickerOpen: boolean;
     createTypes?: ClientCreateType[] | null;
+    /** True when a viewer-role user has read-only access: mutating actions are
+     *  disabled and their tooltip explains why instead of just repeating the label. */
+    readOnly?: boolean;
+    /** True only for a top-level VIEW item — RELATED_VIEW tables never show free-text search. */
+    searchEnabled?: boolean;
+    searchOpen?: boolean;
+    searchQuery?: string;
     cb: ToolbarCallbacks;
 }>;

package/dist/types/components/table/mrd-table/table-query.d.ts

@@ -10,6 +10,10 @@ export declare const DATE_TYPES: Set<string>;
 export declare const NO_FILTER_TYPES: Set<string>;
 /** Column types that cannot be sorted or filtered (not stored in PostgreSQL). */
 export declare const NON_INTERACTIVE_TYPES: Set<string>;
+/** Wait this long (ms) after the user stops typing in the free-text search box
+ *  before firing the search request — mirrors REQUEST_DEBOUNCE_MS's purpose
+ *  (skip intermediate keystrokes) but is tuned for typing, not scrolling. */
+export declare const SEARCH_DEBOUNCE_MS = 400;
 export declare function parseDefaultSort(defaultSort: string): {
     field: string;
     dir: 'asc' | 'desc';
@@ -23,6 +27,8 @@ export declare function buildTableQueryParams(opts: {
     filterClass?: string | null;
     viewFilters?: ViewFilter[] | null;
     activeFilters: Iterable<ColumnFilter>;
+    /** Free-text search query from the toolbar's search box (VIEW only). */
+    query?: string;
 }): string;
 /** Groups aggregate columns by function; null when the view has no aggregates. */
 export declare function buildAggregationParams(columns: TableColumn[]): {

package/dist/types/components.d.ts

@@ -161,6 +161,11 @@ export namespace Components {
           * @default ''
          */
         "parentId": string;
+        /**
+          * When true, this dashboard is read-only: New folder and Upload are disabled (with a tooltip explaining why) and the embedded table/list get it passed through so their own create/upload/drag-drop paths are disabled too.
+          * @default false
+         */
+        "readOnly": boolean;
         /**
           * Lookup key used for the embedded `data-doclist` / `data-view` attributes.
           * @default ''
@@ -193,7 +198,7 @@ export namespace Components {
          */
         "containerHref": string;
         /**
-          * Start creating a folder under the current target. Called by the host toolbar (mrd-document-container). No-op when there is no valid target.
+          * Start creating a folder under the current target. Called by the host toolbar (mrd-document-container). No-op when there is no valid target, or read-only.
          */
         "createFolder": () => Promise<void>;
         /**
@@ -210,6 +215,11 @@ export namespace Components {
           * @default ''
          */
         "parentId": string;
+        /**
+          * When true, folder creation, file upload (button and drag-drop) and moving a document between folders are all disabled — a viewer-role user can browse but not mutate anything. Drives mrdCanCreate(false) so the host toolbar's New folder / Upload buttons stay disabled too.
+          * @default false
+         */
+        "readOnly": boolean;
         /**
           * Host callback with the created document's self href, so the optimistic row becomes navigable without waiting for a reload.
          */
@@ -529,6 +539,11 @@ export namespace Components {
           * Open the lightbox directly with a URL (e.g. after mrdDownload on a FILE field).
          */
         "openImagePreview": (url: string) => Promise<void>;
+        /**
+          * When true, this dashboard is read-only (viewer role): the embedded mrd-table's create ("+") action and the documents view's New folder / Upload are disabled with a tooltip explaining why, so it's clear at a glance the user can't mutate data.
+          * @default false
+         */
+        "readOnly": boolean;
         /**
           * Provide a resolved URL for an IMAGE field. Shows as thumbnail; clicking opens the lightbox.
          */
@@ -824,6 +839,11 @@ export namespace Components {
           * @default ''
          */
         "parentId": string;
+        /**
+          * When true, the toolbar's create ("+") action is disabled (with a tooltip explaining why) so a viewer-role user can see at a glance that this dashboard is read-only. Sorting, filtering and export stay available — those don't mutate data.
+          * @default false
+         */
+        "readOnly": boolean;
         /**
           * Time (ms) to wait for setPage() before retrying a page request; after MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages).
           * @default 15000
@@ -1848,6 +1868,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "parentId"?: string;
+        /**
+          * When true, this dashboard is read-only: New folder and Upload are disabled (with a tooltip explaining why) and the embedded table/list get it passed through so their own create/upload/drag-drop paths are disabled too.
+          * @default false
+         */
+        "readOnly"?: boolean;
         /**
           * Lookup key used for the embedded `data-doclist` / `data-view` attributes.
           * @default ''
@@ -1925,6 +1950,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "parentId"?: string;
+        /**
+          * When true, folder creation, file upload (button and drag-drop) and moving a document between folders are all disabled — a viewer-role user can browse but not mutate anything. Drives mrdCanCreate(false) so the host toolbar's New folder / Upload buttons stay disabled too.
+          * @default false
+         */
+        "readOnly"?: boolean;
     }
     /**
      * Archetype-driven single-document view. Given a `commons.document` binding and a
@@ -2320,6 +2350,11 @@ declare namespace LocalJSX {
           * An external file was dropped on a document view; host uploads and calls setViewFileReference(name, uri).
          */
         "onMrdViewUpload"?: (event: MrdLayoutSectionCustomEvent<{ name: string; file: File }>) => void;
+        /**
+          * When true, this dashboard is read-only (viewer role): the embedded mrd-table's create ("+") action and the documents view's New folder / Upload are disabled with a tooltip explaining why, so it's clear at a glance the user can't mutate data.
+          * @default false
+         */
+        "readOnly"?: boolean;
         /**
           * Legacy: view metadata map (ClientDashboardMetadata.views). Not needed in new flat format.
           * @default {}
@@ -2613,6 +2648,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "parentId"?: string;
+        /**
+          * When true, the toolbar's create ("+") action is disabled (with a tooltip explaining why) so a viewer-role user can see at a glance that this dashboard is read-only. Sorting, filtering and export stay available — those don't mutate data.
+          * @default false
+         */
+        "readOnly"?: boolean;
         /**
           * Time (ms) to wait for setPage() before retrying a page request; after MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages).
           * @default 15000
@@ -2769,11 +2809,13 @@ declare namespace LocalJSX {
         "viewKey": string;
         "height": number;
         "locale": string;
+        "readOnly": boolean;
     }
     interface MrdDocumentListAttributes {
         "parentId": string;
         "containerHref": string;
         "locale": string;
+        "readOnly": boolean;
     }
     interface MrdDocumentViewAttributes {
         "locale": string;
@@ -2833,6 +2875,7 @@ declare namespace LocalJSX {
     }
     interface MrdLayoutSectionAttributes {
         "locale": string;
+        "readOnly": boolean;
     }
     interface MrdListFieldAttributes {
         "name": string;
@@ -2901,6 +2944,7 @@ declare namespace LocalJSX {
         "rowHeight": number;
         "tableHeight": number;
         "requestTimeoutMs": number;
+        "readOnly": boolean;
     }
     interface MrdTextFieldAttributes {
         "name": string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmlogic/components",
-  "version": "0.5.12",
+  "version": "0.5.14",
   "description": "Stencil.js web component library for dynamic forms and virtual-scroll data tables",
   "license": "MIT",
   "author": "Mosterd",