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 CHANGED
@@ -17,9 +17,9 @@
17
17
 
18
18
  ---
19
19
 
20
- **clr-lift** supercharges VMware's **Clarity Design System** with battle-tested enterprise primitives. It fills the gaps
21
- in standard Clarity by delivering flicker-free datagrid state management, reactive notification systems, async
22
- multi-step wizards, type-safe form controls, zero-config dark mode, and built-in localization.
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. See the [usage and reference guide](../../docs/guides/object-path-breadcrumbs.md) for scope, encoding, unusual
102
- keys and API-response examples.
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
- [canonical design spec](../../docs/design/clr-lift/breadcrumb-design-spec.md).
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 | 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
- | | `DatagridSelectionAccessorDirective` | `[cllDatagridSelectionAccessor]` | Host-directive adapter that lets a reusable picker expose its inner selection field to the parent form. |
267
- | | `DatagridSelectionBindingDirective` | `cll-datagrid-selection[cllDatagridSelectionBinding]` | Binds exactly one inner selection field to the owning accessor host. |
268
- | **Theming & i18n** | `ThemeToggleComponent` | `cll-theme-toggle` | Light/dark theme switch with Clarity token synchronization & persistence. |
269
- | | `TranslationService` | Injectable Service | Runtime language selection, dictionary registration and fallback. |
270
- | | `TranslatePipe` | `translate` | Reactive pipe for localized component labels and messages. |
271
- | **Overlays** | `CalloutComponent` | `cll-callout` | Lightweight contextual notice box with subtle borders. |
272
- | | `CertificateSignpostComponent` | `cll-certificate-signpost` | Interactive X.509 certificate inspector showing issuer, validity, and fingerprint details. |
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 © [Guanghui Wang](https://github.com/wghglory)
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
- See the [key/value usage and design spec](../../docs/design/clr-lift/key-value-inputs-design-spec.md#usage) for selects,
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.