clr-lift 21.4.0 → 21.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -34
- package/fesm2022/clr-lift.mjs +378 -232
- package/fesm2022/clr-lift.mjs.map +1 -1
- package/package.json +1 -1
- package/types/clr-lift.d.ts +102 -42
package/README.md
CHANGED
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
**clr-lift** supercharges
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
**clr-lift** supercharges the **Clarity Design System** with battle-tested enterprise primitives. It fills the gaps in
|
|
21
|
+
standard Clarity by delivering flicker-free datagrid state management, reactive notification systems, async multi-step
|
|
22
|
+
wizards, type-safe form controls, zero-config dark mode, and built-in localization.
|
|
23
23
|
|
|
24
24
|
```html
|
|
25
25
|
<!-- Enhanced Clarity alert with automatic Error/HttpErrorResponse extraction -->
|
|
@@ -98,11 +98,11 @@ browser; unmeasured rendering uses the count ceiling. SSR/hydration support has
|
|
|
98
98
|
For exact bucket/prefix/object state, opt in to `buildObjectPathBreadcrumbs` with `BuildObjectPathBreadcrumbsOptions`
|
|
99
99
|
and `ObjectPathLocation`. It constructs stable IDs, display labels and exact cumulative contexts synchronously;
|
|
100
100
|
`hrefFor` owns destinations and `rootPrefix` excludes higher ancestors. Compose translated application items outside the
|
|
101
|
-
helper.
|
|
102
|
-
|
|
101
|
+
helper. The repository's `docs/guides/object-path-breadcrumbs.md` covers scope, encoding, unusual keys and API-response
|
|
102
|
+
examples.
|
|
103
103
|
|
|
104
|
-
See the [working demo](https://ngx-lift.vercel.app/clr-lift/components/breadcrumb) and
|
|
105
|
-
|
|
104
|
+
See the [working demo](https://ngx-lift.vercel.app/clr-lift/components/breadcrumb) and the canonical design spec at
|
|
105
|
+
`docs/design/clr-lift/breadcrumb-design-spec.md` in the repository.
|
|
106
106
|
|
|
107
107
|
## 🚀 Quick Start (60 Seconds)
|
|
108
108
|
|
|
@@ -247,31 +247,29 @@ export class CertificateImportComponent {
|
|
|
247
247
|
|
|
248
248
|
## 🧩 Component & Operator Quick Reference
|
|
249
249
|
|
|
250
|
-
| Category | Export
|
|
251
|
-
| :----------------- |
|
|
252
|
-
| **Datagrid** | `dgState`
|
|
253
|
-
| **Feedback** | `AlertComponent`
|
|
254
|
-
| | `AlertContainerComponent`
|
|
255
|
-
| | `ToastService`
|
|
256
|
-
| | `ToastContainerComponent`
|
|
257
|
-
| | `SpinnerComponent`
|
|
258
|
-
| | `StatusIndicatorComponent`
|
|
259
|
-
| **Navigation** | `TimelineWizardComponent`
|
|
260
|
-
| **Navigation** | `BreadcrumbComponent`
|
|
261
|
-
| | `PageContainerComponent`
|
|
262
|
-
| **Forms** | `FileReaderComponent`
|
|
263
|
-
| | `KeyValueInputsComponent`
|
|
264
|
-
| | `KeyValueControlComponent`
|
|
265
|
-
| | `DatagridSelectionComponent`
|
|
266
|
-
|
|
|
267
|
-
| | `
|
|
268
|
-
|
|
|
269
|
-
|
|
|
270
|
-
| | `
|
|
271
|
-
|
|
|
272
|
-
|
|
|
273
|
-
| | `TooltipDirective` | `[cllTooltip]` | Dynamic declarative popover tooltip. |
|
|
274
|
-
| **Development** | `QueryDevtoolsComponent` | `cll-query-devtools` | Resizable query panel with data/error inspection, row actions and a development-only root provider. |
|
|
250
|
+
| Category | Export | Selector / API | Description |
|
|
251
|
+
| :----------------- | :----------------------------- | :------------------------- | :------------------------------------------------------------------------------------------------------ |
|
|
252
|
+
| **Datagrid** | `dgState` | Operator / Utility | RxJS state operator; debounces filters and optionally suppresses duplicates. |
|
|
253
|
+
| **Feedback** | `AlertComponent` | `cll-alert` | Intelligent alert container with auto-unwrapping for `Error` and `HttpErrorResponse`. |
|
|
254
|
+
| | `AlertContainerComponent` | `cll-alert-container` | Multi-alert reactive stack controlled declaratively by `AlertService`. |
|
|
255
|
+
| | `ToastService` | Injectable Service | Global toast dispatcher supporting `success`, `error`, `warning`, `info`. |
|
|
256
|
+
| | `ToastContainerComponent` | `cll-toast-container` | Root toast overlay host with positioning and auto-dismiss timing. |
|
|
257
|
+
| | `SpinnerComponent` | `cll-spinner` | Center-aligned, sized (`sm`, `md`, `lg`), accessible loading spinner. |
|
|
258
|
+
| | `StatusIndicatorComponent` | `cll-status-indicator` | Semantic operational state badges (`success`, `warning`, `error`, `pending`). |
|
|
259
|
+
| **Navigation** | `TimelineWizardComponent` | `cll-timeline-wizard` | Multi-step asynchronous wizard with timeline navigation and async step hooks. |
|
|
260
|
+
| **Navigation** | `BreadcrumbComponent` | `cll-breadcrumb` | Caller-owned ordinary/SPA links, current-location text and addressless navigation; added in 21.4.0. |
|
|
261
|
+
| | `PageContainerComponent` | `cll-page-container` | Standardized header, breadcrumb, action bar, and content responsive shell. |
|
|
262
|
+
| **Forms** | `FileReaderComponent` | `cll-file-reader` | Text/base64 string CVA with size validation and read cancellation. |
|
|
263
|
+
| | `KeyValueInputsComponent` | `cll-key-value-inputs` | Caller-owned FormArray editor with duplicate key validation; not a CVA. |
|
|
264
|
+
| | `KeyValueControlComponent` | `cll-key-value-control` | Ordered array CVA with text/select/typed editors, custom validation, unique pairs and form integration. |
|
|
265
|
+
| | `DatagridSelectionComponent` | `cll-datagrid-selection` | Native Clarity datagrid CVA preserving stable keys, scoped select-all, availability and loading guards. |
|
|
266
|
+
| **Theming & i18n** | `ThemeToggleComponent` | `cll-theme-toggle` | Light/dark theme switch with Clarity token synchronization & persistence. |
|
|
267
|
+
| | `TranslationService` | Injectable Service | Runtime language selection, dictionary registration and fallback. |
|
|
268
|
+
| | `TranslatePipe` | `translate` | Reactive pipe for localized component labels and messages. |
|
|
269
|
+
| **Overlays** | `CalloutComponent` | `cll-callout` | Lightweight contextual notice box with subtle borders. |
|
|
270
|
+
| | `CertificateSignpostComponent` | `cll-certificate-signpost` | Interactive X.509 certificate inspector showing issuer, validity, and fingerprint details. |
|
|
271
|
+
| | `TooltipDirective` | `[cllTooltip]` | Dynamic declarative popover tooltip. |
|
|
272
|
+
| **Development** | `QueryDevtoolsComponent` | `cll-query-devtools` | Resizable query panel with data/error inspection, row actions and a development-only root provider. |
|
|
275
273
|
|
|
276
274
|
**Available since clr-lift 21.3.0:** the inspector and `clr-lift/devtools` entry point below ship from that release
|
|
277
275
|
onward. Register once in `app.config.ts`:
|
|
@@ -342,7 +340,7 @@ beforeEach(async () => {
|
|
|
342
340
|
|
|
343
341
|
## 📄 License
|
|
344
342
|
|
|
345
|
-
MIT ©
|
|
343
|
+
MIT © Project maintainers
|
|
346
344
|
|
|
347
345
|
## Lifecycle and production contracts
|
|
348
346
|
|
|
@@ -350,5 +348,5 @@ See
|
|
|
350
348
|
[service scoping, clocks, localization and query diagnostics](https://github.com/wghglory/ngx-lift-workspace/blob/main/docs/guides/demo-and-library-integration.md)
|
|
351
349
|
for ownership and loading contracts.
|
|
352
350
|
|
|
353
|
-
|
|
351
|
+
The `Usage` section of `docs/design/clr-lift/key-value-inputs-design-spec.md` in the repository covers selects,
|
|
354
352
|
dependent options, typed values, validation and migration.
|