@emporix/component-library 1.13.4 → 2.0.0

package/README.md

@@ -271,23 +271,19 @@ function ConfirmDialogExample() {
 | draggable       | boolean       | false   | Allows dragging the dialog by its header                 |
 | data-testid     | string        | -       | Test ID on the dialog root                               |
 
-Requires PrimeReact base CSS and a theme in the host app.
+Requires only `@emporix/component-library/styles` (PrimeReact theme CSS is bundled).
 
 ### DataTable
 
 Encapsulated data table built on [PrimeReact DataTable](https://primereact.org/datatable/). Styles are scoped via CSS modules. Pass `columns`, optional controlled `pagination`, selection, `rowActions`, and an `emptyTemplate` for empty results.
 
-Import `@emporix/component-library/styles` once in your app entry, plus PrimeReact base CSS, a theme, and `primeicons` (required for paginator/sort icons).
+Import `@emporix/component-library/styles` once in your app entry. Pattern B PrimeReact (base CSS, saga-blue theme, and primeicons) is included in that stylesheet — no separate `primereact` install or CSS imports.
 
 ```tsx
 import { useMemo, useState } from 'react'
-import { FilterMatchMode } from 'primereact/api'
-import { DataTable } from '@emporix/component-library'
+import { DataTable, FilterMatchMode } from '@emporix/component-library'
 import type { DataTablePaginationState } from '@emporix/component-library'
 import '@emporix/component-library/styles'
-import 'primereact/resources/primereact.css'
-import 'primereact/resources/themes/saga-blue/theme.css'
-import 'primeicons/primeicons.css'
 
 const columns = [
   {
@@ -733,6 +729,27 @@ import { Message } from '@emporix/component-library'
 | className   | string                                   | -       | Additional CSS class on the root element        |
 | data-testid | string                                   | -       | Test ID for testing                             |
 
+### ProgressSpinner
+
+Indeterminate loading spinner for overlays and blocking states. Pattern A (no PrimeReact dependency). API inspired by [PrimeReact ProgressSpinner](https://primereact.org/progressspinner/).
+
+```tsx
+import { ProgressSpinner } from '@emporix/component-library'
+
+<ProgressSpinner />
+<ProgressSpinner size="2rem" aria-label="Saving" />
+```
+
+#### Props
+
+| Prop        | Type   | Default   | Description                          |
+| ----------- | ------ | --------- | ------------------------------------ |
+| size        | string | `50px`    | Diameter of the spinner (CSS length) |
+| strokeWidth | string | `4`       | Stroke width of the spinner ring     |
+| aria-label  | string | `Loading` | Accessible label for screen readers  |
+| className   | string | -         | Additional CSS class on the root     |
+| data-testid | string | -         | Test ID for the root element         |
+
 ### Accordion
 
 Collapsible content panels grouped in tabs.
@@ -1117,7 +1134,7 @@ Cursor loads the skill automatically when your request matches its description (
 1. **Audit** — find consumers, related SCSS, and PrimeReact dependencies in MD
 2. **Ask you to choose a pattern** (required before any implementation)
    - **Pattern A (custom):** boilerplate + SCSS modules + **same API as PrimeReact** — e.g. `Dropdown`, `InputText`, `SelectButton` (no `primereact` dependency)
-   - **Pattern B (PrimeReact wrapper):** encapsulated `primereact/*` + scoped overrides — e.g. `Toast`, `DataTable`
+   - **Pattern B (PrimeReact wrapper):** encapsulated `primereact/*` + scoped overrides; Prime is a library **dependency** (bundled) — e.g. `Toast`, `DataTable`
 3. **Implement in component-library** — component folder, tests, Storybook, exports, version bump
 4. **Wire consumer app** — import library component directly in pilot views **or** add a thin `Md*` wrapper; leave existing `Md*` unchanged for unmigrated screens; import `@emporix/component-library/styles`
 5. **Verify** — `npm run lint`, `npm run test -- --run`, `npm run build:lib` (library); build and manual QA in MD

package/dist/components/datatable/index.d.ts

@@ -1,6 +1,8 @@
 export { DataTable } from './DataTable';
 export { DataTableEmptyState, DEFAULT_DATA_TABLE_EMPTY_MESSAGE, } from './DataTableEmptyState';
-export type { DataTableProps, DataTablePaginationState, DataTableColumnProps, } from './types';
+export type { DataTableProps, DataTablePaginationState, DataTableColumnProps, DataTableFilterMeta, DataTableFilterMetaData, DataTableFilterMetaOperator, DataTableFilterConstraint, DataTableFilterEvent, DataTableSortEvent, DataTablePageEvent, DataTableSortOrder, } from './types';
 export { useDataTablePagination, DEFAULT_DATA_TABLE_PAGINATION, } from './useDataTablePagination';
 export type { DataTableFilters } from './useDataTablePagination';
+export { FilterMatchMode } from 'primereact/api';
+export type { ColumnFilterElementTemplateOptions as DataTableColumnFilterElementOptions } from 'primereact/column';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/datatable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/datatable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/datatable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EACL,mBAAmB,EACnB,gCAAgC,GACjC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EAAE,kCAAkC,IAAI,mCAAmC,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/components/progressspinner/ProgressSpinner.d.ts

@@ -0,0 +1,31 @@
+export interface ProgressSpinnerProps {
+    /**
+     * Diameter of the spinner. CSS length (e.g. `2rem`, `50px`).
+     * @default '50px'
+     */
+    size?: string;
+    /**
+     * Stroke width of the spinner ring.
+     * @default '4'
+     */
+    strokeWidth?: string;
+    /**
+     * Accessible label announced by screen readers.
+     * @default 'Loading'
+     */
+    'aria-label'?: string;
+    /**
+     * Additional CSS class name for the root.
+     */
+    className?: string;
+    /**
+     * Test ID for testing.
+     */
+    'data-testid'?: string;
+}
+/**
+ * Indeterminate loading spinner. Pattern A — no PrimeReact dependency.
+ * API inspired by [PrimeReact ProgressSpinner](https://primereact.org/progressspinner/).
+ */
+export declare const ProgressSpinner: ({ size, strokeWidth, "aria-label": ariaLabel, className, "data-testid": testId, }: ProgressSpinnerProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ProgressSpinner.d.ts.map

package/dist/components/progressspinner/ProgressSpinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressSpinner.d.ts","sourceRoot":"","sources":["../../../src/components/progressspinner/ProgressSpinner.tsx"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,mFAM7B,oBAAoB,4CA2BtB,CAAA"}

package/dist/components/progressspinner/index.d.ts

@@ -0,0 +1,3 @@
+export { ProgressSpinner } from './ProgressSpinner';
+export type { ProgressSpinnerProps } from './ProgressSpinner';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/progressspinner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/progressspinner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.d.ts

@@ -40,7 +40,9 @@ export { Menu } from './components/menu';
 export type { MenuProps, MenuItem, MenuRef } from './components/menu';
 export { Message } from './components/message/Message';
 export type { MessageProps, MessageSeverity, } from './components/message/Message';
-export { DataTable, DataTableEmptyState, DEFAULT_DATA_TABLE_EMPTY_MESSAGE, useDataTablePagination, } from './components/datatable';
-export type { DataTableProps, DataTablePaginationState, DataTableColumnProps, DataTableFilters, } from './components/datatable';
+export { DataTable, DataTableEmptyState, DEFAULT_DATA_TABLE_EMPTY_MESSAGE, useDataTablePagination, FilterMatchMode, } from './components/datatable';
+export type { DataTableProps, DataTablePaginationState, DataTableColumnProps, DataTableFilters, DataTableFilterMeta, DataTableFilterMetaData, DataTableFilterMetaOperator, DataTableFilterConstraint, DataTableFilterEvent, DataTableSortEvent, DataTablePageEvent, DataTableSortOrder, DataTableColumnFilterElementOptions, } from './components/datatable';
 export { DEFAULT_DATA_TABLE_PAGINATION } from './components/datatable';
+export { ProgressSpinner } from './components/progressspinner';
+export type { ProgressSpinnerProps } from './components/progressspinner';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAA;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAEhF,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAC7C,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AACzD,YAAY,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAC5D,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AACrE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wCAAwC,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAClE,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC3E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AACxC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,YAAY,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AAGtE,OAAO,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}