@sd-angular/core 19.0.31 → 19.0.33

package/fesm2022/sd-angular-core-utilities-read-state.mjs

@@ -0,0 +1,87 @@
+import { signal, TemplateRef } from '@angular/core';
+
+/** VALUE errors take precedence; otherwise SEARCH errors, then the active SEARCH channel. */
+function combineReadStates(value, search) {
+    const current = value.status === 'error' ? value : search.status !== 'idle' ? search : value;
+    return Object.freeze({ ...current, channels: Object.freeze({ VALUE: value, SEARCH: search }) });
+}
+/** @internal Request guard shared by controls. Context is checked even before Angular effects run. */
+class SdReadChannel {
+    operation;
+    changed;
+    #state;
+    state;
+    #revision = 0;
+    #valid = () => true;
+    constructor(operation, changed) {
+        this.operation = operation;
+        this.changed = changed;
+        this.#state = signal(Object.freeze({ status: 'idle', operation }));
+        this.state = this.#state.asReadonly();
+    }
+    begin(valid = () => true) {
+        this.#valid = valid;
+        const revision = ++this.#revision;
+        this.#set({ status: 'loading', operation: this.operation });
+        return revision;
+    }
+    isCurrent(revision) {
+        return revision === this.#revision && this.#valid();
+    }
+    succeed(revision, count) {
+        if (!this.isCurrent(revision))
+            return false;
+        this.#set({ status: count ? 'ready' : 'empty', operation: this.operation });
+        return true;
+    }
+    fail(revision, error) {
+        if (!this.isCurrent(revision))
+            return false;
+        this.#set({ status: 'error', operation: this.operation, error });
+        return true;
+    }
+    invalidate() {
+        ++this.#revision;
+        this.#valid = () => true;
+        if (this.state().status !== 'idle')
+            this.#set({ status: 'idle', operation: this.operation });
+    }
+    #set(state) {
+        const snapshot = Object.freeze(state);
+        this.#state.set(snapshot);
+        this.changed?.(snapshot);
+    }
+}
+/**
+ * @internal Copy request-owned data, including Dates. Unlike ObjectUtilities.clone,
+ * Dates must be copied too; structuredClone cannot retain table column callbacks.
+ */
+function cloneReadRequest(value, seen = new WeakMap()) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    // why: TemplateRef là handle thuộc Angular view, không phải dữ liệu request có thể sao chép.
+    if (value instanceof TemplateRef)
+        return value;
+    if (seen.has(value))
+        return seen.get(value);
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    const copy = (Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value)));
+    seen.set(value, copy);
+    for (const key of Object.keys(value)) {
+        Object.defineProperty(copy, key, {
+            value: cloneReadRequest(value[key], seen),
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    return copy;
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { SdReadChannel, cloneReadRequest, combineReadStates };
+//# sourceMappingURL=sd-angular-core-utilities-read-state.mjs.map

package/fesm2022/sd-angular-core-utilities-read-state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-angular-core-utilities-read-state.mjs","sources":["../../../projects/sd-angular/utilities/read-state/src/read-state.ts","../../../projects/sd-angular/utilities/read-state/sd-angular-core-utilities-read-state.ts"],"sourcesContent":["import { TemplateRef, signal } from '@angular/core';\n\nexport type SdReadOperation = 'TABLE' | 'VALUE' | 'SEARCH';\nexport type SdReadStatus = 'idle' | 'loading' | 'ready' | 'empty' | 'error';\n\n/** An accepted read result. Only an error snapshot contains the original exception. */\nexport type SdReadState = Readonly<\n  { status: Exclude<SdReadStatus, 'error'>; operation: SdReadOperation } | { status: 'error'; operation: SdReadOperation; error: unknown }\n>;\n\nexport type SdSearchReadState = SdReadState & {\n  readonly channels: Readonly<{ VALUE: SdReadState; SEARCH: SdReadState }>;\n};\n\n/** VALUE errors take precedence; otherwise SEARCH errors, then the active SEARCH channel. */\nexport function combineReadStates(value: SdReadState, search: SdReadState): SdSearchReadState {\n  const current = value.status === 'error' ? value : search.status !== 'idle' ? search : value;\n  return Object.freeze({ ...current, channels: Object.freeze({ VALUE: value, SEARCH: search }) });\n}\n\n/** @internal Request guard shared by controls. Context is checked even before Angular effects run. */\nexport class SdReadChannel {\n  readonly #state;\n  readonly state;\n  #revision = 0;\n  #valid = () => true;\n\n  constructor(\n    readonly operation: SdReadOperation,\n    private readonly changed?: (state: SdReadState) => void\n  ) {\n    this.#state = signal<SdReadState>(Object.freeze({ status: 'idle', operation }));\n    this.state = this.#state.asReadonly();\n  }\n\n  begin(valid: () => boolean = () => true): number {\n    this.#valid = valid;\n    const revision = ++this.#revision;\n    this.#set({ status: 'loading', operation: this.operation });\n    return revision;\n  }\n\n  isCurrent(revision: number): boolean {\n    return revision === this.#revision && this.#valid();\n  }\n\n  succeed(revision: number, count: number): boolean {\n    if (!this.isCurrent(revision)) return false;\n    this.#set({ status: count ? 'ready' : 'empty', operation: this.operation });\n    return true;\n  }\n\n  fail(revision: number, error: unknown): boolean {\n    if (!this.isCurrent(revision)) return false;\n    this.#set({ status: 'error', operation: this.operation, error });\n    return true;\n  }\n\n  invalidate(): void {\n    ++this.#revision;\n    this.#valid = () => true;\n    if (this.state().status !== 'idle') this.#set({ status: 'idle', operation: this.operation });\n  }\n\n  #set(state: SdReadState): void {\n    const snapshot = Object.freeze(state);\n    this.#state.set(snapshot);\n    this.changed?.(snapshot);\n  }\n}\n\n/**\n * @internal Copy request-owned data, including Dates. Unlike ObjectUtilities.clone,\n * Dates must be copied too; structuredClone cannot retain table column callbacks.\n */\nexport function cloneReadRequest<T>(value: T, seen = new WeakMap<object, unknown>()): T {\n  if (value === null || typeof value !== 'object') return value;\n  // why: TemplateRef là handle thuộc Angular view, không phải dữ liệu request có thể sao chép.\n  if (value instanceof TemplateRef) return value;\n  if (seen.has(value)) return seen.get(value) as T;\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n  const copy = (Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value))) as T;\n  seen.set(value, copy);\n  for (const key of Object.keys(value)) {\n    Object.defineProperty(copy, key, {\n      value: cloneReadRequest((value as Record<string, unknown>)[key], seen),\n      enumerable: true,\n      writable: true,\n      configurable: true,\n    });\n  }\n  return copy;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/sd-angular-core-utilities.mjs

@@ -1,6 +1,7 @@
 export * from '@sd-angular/core/utilities/extensions';
 export * from '@sd-angular/core/utilities/models';
 export * from '@sd-angular/core/utilities/data-state';
+export * from '@sd-angular/core/utilities/read-state';
 
 /**
  * Generated bundle index. Do not edit.

package/fesm2022/sd-angular-core-utilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sd-angular-core-utilities.mjs","sources":["../../../projects/sd-angular/utilities/sd-angular-core-utilities.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAAA;;AAEG"}
+{"version":3,"file":"sd-angular-core-utilities.mjs","sources":["../../../projects/sd-angular/utilities/sd-angular-core-utilities.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AAAA;;AAEG"}

package/forms/autocomplete/src/autocomplete.component.d.ts

@@ -3,6 +3,8 @@ import { FormControl, FormGroup, FormGroupDirective, NgForm } from '@angular/for
 import { MatAutocompleteTrigger } from '@angular/material/autocomplete';
 import { ErrorStateMatcher } from '@angular/material/core';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
+import { SdDataStateTemplateDirective } from '@sd-angular/core/components/data-state';
+import { SdSearchReadState } from '@sd-angular/core/utilities/read-state';
 import { SdItemDefDefDirective, SdViewDefDirective } from '@sd-angular/core/forms/directives';
 import { SdCustomValidator, SdFormControl, SdSearch, SdSelectionData, SdViewed, SdViewedInput } from '@sd-angular/core/forms/models';
 import { Size } from '@sdcorejs/utils/models';
@@ -46,6 +48,11 @@ export declare class SdAutocomplete<T = any> implements OnInit, OnDestroy, After
     hyperlink: import("@angular/core").InputSignal<string | null | undefined>;
     items: import("@angular/core").InputSignal<SdSearch<T> | T[] | null | undefined>;
     hideInlineError: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly hideReadError: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly dataStateTemplate: import("@angular/core").Signal<SdDataStateTemplateDirective | undefined>;
+    readonly sdReadStateChange: import("@angular/core").OutputEmitterRef<SdSearchReadState>;
+    readonly readState: import("@angular/core").Signal<SdSearchReadState>;
+    readonly hasSearched: import("@angular/core").WritableSignal<boolean>;
     addable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     required: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
@@ -91,7 +98,9 @@ export declare class SdAutocomplete<T = any> implements OnInit, OnDestroy, After
     ngOnDestroy(): void;
     onSelect: (item: T) => void;
     onFocus: () => void;
-    onBlur: () => void;
+    onBlur: (event?: FocusEvent) => void;
+    protected focusReadRetry: (event: KeyboardEvent) => void;
+    protected onReadRegionKeydown: (event: KeyboardEvent) => void;
     onClick: () => void;
     blur: () => void;
     focus: () => void;
@@ -100,7 +109,9 @@ export declare class SdAutocomplete<T = any> implements OnInit, OnDestroy, After
     clear: ($event?: any) => void;
     onAdd: ($event: Event) => void;
     reValidate: () => void;
+    /** Retry bypasses text debounce/distinctness while using the original loader and request snapshot. */
+    retryRead: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdAutocomplete<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdAutocomplete<any>, "sd-autocomplete", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; "sdAdd": "sdAdd"; }, ["sdLabelTemplate", "sdValueTemplate", "itemDef", "sdViewDef"], ["[sdLabel]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdAutocomplete<any>, "sd-autocomplete", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; "sdAdd": "sdAdd"; }, ["sdLabelTemplate", "sdValueTemplate", "itemDef", "sdViewDef", "dataStateTemplate"], ["[sdLabel]"], true, never>;
 }
 export {};

package/forms/select/src/select.component.d.ts

@@ -4,6 +4,8 @@ import { FormControl, FormGroup } from '@angular/forms';
 import { FloatLabelType, MatFormFieldAppearance } from '@angular/material/form-field';
 import { MatInput } from '@angular/material/input';
 import { MatSelect, MatSelectChange } from '@angular/material/select';
+import { SdDataStateTemplateDirective } from '@sd-angular/core/components/data-state';
+import { SdSearchReadState } from '@sd-angular/core/utilities/read-state';
 import { SdItemDefDefDirective, SdViewDefDirective } from '@sd-angular/core/forms/directives';
 import { SdCustomValidator, SdFormControl, SdSearch, SdSelectionData, SdViewed, SdViewedInput } from '@sd-angular/core/forms/models';
 import { Size } from '@sdcorejs/utils/models';
@@ -57,6 +59,10 @@ export declare class SdSelect<T extends object | string | number = Record<string
     hyperlink: import("@angular/core").InputSignal<string | null | undefined>;
     minWidthPanel: import("@angular/core").InputSignalWithTransform<string | number, string | number | null | undefined>;
     hideInlineError: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly hideReadError: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly dataStateTemplate: Signal<SdDataStateTemplateDirective | undefined>;
+    readonly sdReadStateChange: import("@angular/core").OutputEmitterRef<SdSearchReadState>;
+    readonly readState: Signal<SdSearchReadState>;
     required: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     /** Display mode: `false` edit · `true` static view · `'inline'` view + click-to-edit (bare editor). */
@@ -131,6 +137,10 @@ export declare class SdSelect<T extends object | string | number = Record<string
     updatePanelWidth: () => void;
     constructor();
     ngOnInit(): void;
+    protected focusReadRetry: (event: KeyboardEvent) => void;
+    protected onReadRegionKeydown: (event: KeyboardEvent) => void;
+    /** Retry the error selected by readState; VALUE and SEARCH retain separate snapshots. */
+    retryRead: () => Promise<void>;
     onSelectionChange: (change: MatSelectChange) => void;
     /**
      * Toggle "Chọn tất cả" theo scope hiện tại (items enabled khớp search):
@@ -148,5 +158,5 @@ export declare class SdSelect<T extends object | string | number = Record<string
     open: () => void;
     onOpenedChange: (isOpened: boolean) => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSelect<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdSelect<any>, "sd-select", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "minWidthPanel": { "alias": "minWidthPanel"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSelectedTemplate", "itemDef", "sdViewDef", "footerActions"], ["[sdLabel]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSelect<any>, "sd-select", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "displayField": { "alias": "displayField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "cacheChecksum": { "alias": "cacheChecksum"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "hyperlink": { "alias": "hyperlink"; "required": false; "isSignal": true; }; "minWidthPanel": { "alias": "minWidthPanel"; "required": false; "isSignal": true; }; "hideInlineError": { "alias": "hideInlineError"; "required": false; "isSignal": true; }; "hideReadError": { "alias": "hideReadError"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "viewed": { "alias": "viewed"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "validator": { "alias": "validator"; "required": false; "isSignal": true; }; "inlineError": { "alias": "inlineError"; "required": false; "isSignal": true; }; "appearanceInput": { "alias": "appearance"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "valueModel": { "alias": "model"; "required": false; "isSignal": true; }; }, { "sdReadStateChange": "sdReadStateChange"; "valueModel": "modelChange"; "sdChange": "sdChange"; "sdSelection": "sdSelection"; }, ["sdLabelTemplate", "sdValueTemplate", "sdSelectedTemplate", "itemDef", "sdViewDef", "footerActions", "dataStateTemplate"], ["[sdLabel]"], true, never>;
 }

package/i18n/src/en.d.ts

@@ -1,4 +1,13 @@
 export declare const EN_MESSAGES: {
+    readonly 'core.component.data-state.loading.title': "Loading";
+    readonly 'core.component.data-state.loading.message': "Please wait while the data is being loaded.";
+    readonly 'core.component.data-state.empty.title': "No data";
+    readonly 'core.component.data-state.empty.message': "There is no data to display yet.";
+    readonly 'core.component.data-state.error.title': "Unable to load data";
+    readonly 'core.component.data-state.error.message': "An error occurred. Please try again.";
+    readonly 'core.component.data-state.forbidden.title': "Access denied";
+    readonly 'core.component.data-state.forbidden.message': "You do not have permission to view this content.";
+    readonly 'core.component.data-state.retry': "Try again";
     readonly 'core.common.cancel': "Cancel";
     readonly 'core.common.close': "Close";
     readonly 'core.common.reload': "Reload page";
@@ -114,6 +123,7 @@ export declare const EN_MESSAGES: {
     readonly 'core.form.date-range.invalid-max': "End date is invalid (above limit)";
     readonly 'core.form.date-range.from': "From";
     readonly 'core.form.date-range.to': "to";
+    readonly 'core.form.date-range.clear': "Clear date range";
     readonly 'core.form.datetime.required': "Please enter information";
     readonly 'core.form.datetime.min-date': "Minimum date: {date}";
     readonly 'core.form.datetime.max-date': "Maximum date: {date}";
@@ -139,6 +149,7 @@ export declare const EN_MESSAGES: {
     readonly 'core.form.checkbox.unchecked': "No";
     readonly 'core.form.select.required': "Please enter information";
     readonly 'core.form.select.selectAll': "All";
+    readonly 'core.form.select.selected-count': "{count} items selected";
     readonly 'core.form.textarea.required': "Please enter information";
     readonly 'core.form.textarea.maxlength': "Maximum characters: {max}";
     readonly 'core.form.textarea.invalid-pattern': "Invalid format";
@@ -280,6 +291,21 @@ export declare const EN_MESSAGES: {
     readonly 'core.component.code-editor.copied': "Copied!";
     readonly 'core.component.code-editor.copy': "Copy code";
     readonly 'core.component.history.by': "By";
+    readonly 'core.component.import-excel.choose-hint': "Choose an .xlsx template file with up to {limit} rows.";
+    readonly 'core.component.import-excel.choose-file': "Choose Excel file";
+    readonly 'core.component.import-excel.template': "Download template";
+    readonly 'core.component.import-excel.row-count': "{count} data rows";
+    readonly 'core.component.import-excel.replace-file': "Replace file";
+    readonly 'core.component.import-excel.filter-all': "All";
+    readonly 'core.component.import-excel.filter-success': "Valid";
+    readonly 'core.component.import-excel.filter-warning': "Warnings";
+    readonly 'core.component.import-excel.filter-error': "Errors";
+    readonly 'core.component.import-excel.preview': "Excel data preview";
+    readonly 'core.component.import-excel.issue-count': "View {count} issues";
+    readonly 'core.component.import-excel.no-filter-results': "No matching rows";
+    readonly 'core.component.import-excel.no-filter-results-hint': "Try another filter or view all data.";
+    readonly 'core.component.import-excel.blocked-errors': "Fix {count} rows with errors before importing.";
+    readonly 'core.component.import-excel.submitted': "Data has been submitted for processing.";
     readonly 'core.component.import-excel.title': "Import Excel data";
     readonly 'core.component.import-excel.see-all': "See all";
     readonly 'core.component.import-excel.valid-rows': "Valid rows";
@@ -406,9 +432,14 @@ export declare const EN_MESSAGES: {
     readonly 'core.component.table.not-an-array': "Data is not an array";
     readonly 'core.component.table.config.confirm-reset': "Confirm reset all settings to defaults";
     readonly 'core.component.table.popup-export.select-columns': "Please select columns to export";
+    readonly 'core.component.table.selector-action.selected': "Selected {count}";
+    readonly 'core.component.table.selector-action.more': "More";
     readonly 'core.component.table.selector-action.default-msg': "items selected";
     readonly 'core.component.tab-router.too-many-tabs': "You have opened too many tabs.";
     readonly 'core.component.upload-file.upload': "Upload file";
+    readonly 'core.component.upload-file.remove': "Remove file";
+    readonly 'core.component.upload-file.loading': "Uploading file";
+    readonly 'core.component.upload-file.choose-or-drop': "Choose a file or drag it here";
     readonly 'core.component.upload-file.error-occurred': "An error occurred";
     readonly 'core.component.upload-file.please-upload': "Please upload a file/image";
     readonly 'core.component.upload-file.desc-format-and-size': "Format: {exts} and up to: {maxSize}MB";
@@ -429,6 +460,7 @@ export declare const EN_MESSAGES: {
     readonly 'core.module.layout.user.change-password': "Change password";
     readonly 'core.module.layout.user.logout': "Sign out";
     readonly 'core.module.layout.sidebar.search': "Search";
+    readonly 'core.module.layout.sidebar.clear-search': "Clear search";
     readonly 'core.module.layout.greeting.hello': "Hello, {name}";
     readonly 'core.module.layout.weekday.0': "Sunday";
     readonly 'core.module.layout.weekday.1': "Monday";

package/modules/layout/components/layout-main/layout-main.component.d.ts

@@ -5,7 +5,7 @@ export declare class SdLayoutComponent {
     menusInput: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     menus: import("@angular/core").Signal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SdLayoutUserInfo | undefined>;
-    sidebar: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SidebarConfigurationV1 | undefined>;
+    sidebar: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").ISdSidebarConfiguration | undefined>;
     isMobileOrTablet: import("@angular/core").WritableSignal<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SdLayoutComponent, "sd-layout", never, { "menusInput": { "alias": "menus"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;

package/modules/layout/components/sidebar-mobile-v1/components/sidebar/sidebar.component.d.ts

@@ -1,5 +1,5 @@
 import { Params } from '@angular/router';
-import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../../../configurations';
+import { SdLayoutUserInfo, ISdSidebarConfiguration } from '../../../../configurations';
 import { SdLayoutMenu } from '../../../../services';
 import * as i0 from "@angular/core";
 export declare class SidebarMobileOverlayComponent {
@@ -7,7 +7,7 @@ export declare class SidebarMobileOverlayComponent {
     isShowSidebar: import("@angular/core").InputSignal<boolean>;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
-    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    sidebar: import("@angular/core").InputSignal<ISdSidebarConfiguration>;
     showSideBar: import("@angular/core").OutputEmitterRef<boolean | null>;
     expandSideBar: import("@angular/core").OutputEmitterRef<void>;
     popupUserMenuOpened: import("@angular/core").OutputEmitterRef<void>;

package/modules/layout/components/sidebar-mobile-v1/main.component.d.ts

@@ -1,11 +1,11 @@
-import { SdLayoutUserInfo, SidebarConfigurationV1 } from '../../configurations';
+import { SdLayoutUserInfo, ISdSidebarConfiguration } from '../../configurations';
 import { SdLayoutMenu } from '../../services';
 import * as i0 from "@angular/core";
 export declare class SidebarMobileV1Component {
     #private;
     menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
     userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
-    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV1>;
+    sidebar: import("@angular/core").InputSignal<ISdSidebarConfiguration>;
     isShowSidebar: import("@angular/core").WritableSignal<boolean>;
     titleMenuGroup: import("@angular/core").WritableSignal<string | undefined>;
     constructor();

package/modules/layout/components/sidebar-v2/components/sidebar/sidebar.component.d.ts

@@ -0,0 +1,56 @@
+import { NestedTreeControl } from '@angular/cdk/tree';
+import { MatTreeNestedDataSource } from '@angular/material/tree';
+import { Params } from '@angular/router';
+import { SdLayoutUserInfo, SidebarConfigurationV2 } from '../../../../configurations';
+import { SdLayoutChildrenMenu, SdLayoutMenu } from '../../../../services';
+import * as i0 from "@angular/core";
+export declare class SidebarV2PanelComponent {
+    #private;
+    isShowSidebar: import("@angular/core").InputSignal<boolean>;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV2>;
+    expandSideBar: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuClosed: import("@angular/core").OutputEmitterRef<void>;
+    popupUserMenuOpened: import("@angular/core").OutputEmitterRef<void>;
+    showSideBar: import("@angular/core").OutputEmitterRef<boolean | null>;
+    screenHeight: number;
+    isMobileOrTablet: boolean;
+    isMenuLock: import("@angular/core").WritableSignal<boolean>;
+    currentPath: import("@angular/core").WritableSignal<string>;
+    searchText: import("@angular/core").WritableSignal<string>;
+    titleMenuGroup: import("@angular/core").WritableSignal<string | undefined>;
+    idMenuGroupActive: import("@angular/core").WritableSignal<string | undefined>;
+    menusByGroup: import("@angular/core").WritableSignal<SdLayoutMenu[]>;
+    pinnedMenuGroup: import("@angular/core").WritableSignal<SdLayoutChildrenMenu>;
+    totalMenuInMenusByGroup: import("@angular/core").Signal<number>;
+    pinnedNodeKeys: import("@angular/core").Signal<Set<string>>;
+    isPinnedMenuGroupActive: import("@angular/core").Signal<boolean>;
+    activeMenuPath: import("@angular/core").Signal<string | null>;
+    dataSource: MatTreeNestedDataSource<SdLayoutMenu>;
+    treeControl: NestedTreeControl<SdLayoutMenu, SdLayoutMenu>;
+    constructor();
+    hasChild: (_: number, node: SdLayoutMenu) => boolean;
+    onToggleMenuNode: (menu: SdLayoutMenu) => void;
+    isPinnedNode: (node: SdLayoutMenu) => boolean;
+    isHoveredNode: (node: SdLayoutMenu) => boolean;
+    expandPinnedGroup: () => void;
+    onTogglePin: (event: MouseEvent, node: SdLayoutMenu) => void;
+    toggleMenuLock(event: Event): void;
+    openHomePage: () => void;
+    onUserMenuClosed: () => void;
+    onUserMenuOpened: () => void;
+    navigate: (args: {
+        path: string;
+        queryParams: Params;
+    }) => void;
+    onFilterSearchText: (event: string) => void;
+    onClearSearchText: () => void;
+    expandMenuGroup: (menuGroupNode: SdLayoutMenu) => void;
+    onMouseOverMenuGroupNode: (event: MouseEvent, menuNode: SdLayoutMenu) => void;
+    onMouseLeaveMenuGroupNode: (event: MouseEvent, menuNode: SdLayoutMenu) => void;
+    onMouseOverMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
+    onMouseLeaveMenuNode: (event: MouseEvent, menuItem: SdLayoutMenu) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV2PanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV2PanelComponent, "sd-sidebar-v2-panel", never, { "isShowSidebar": { "alias": "isShowSidebar"; "required": true; "isSignal": true; }; "menus": { "alias": "menus"; "required": true; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, { "expandSideBar": "expandSideBar"; "popupUserMenuClosed": "popupUserMenuClosed"; "popupUserMenuOpened": "popupUserMenuOpened"; "showSideBar": "showSideBar"; }, never, never, true, never>;
+}

package/modules/layout/components/sidebar-v2/components/user/user.component.d.ts

@@ -0,0 +1,22 @@
+import { SdLayoutUserInfo } from '../../../../configurations';
+import * as i0 from "@angular/core";
+export declare class SidebarV2UserComponent {
+    #private;
+    isMobileOrTablet: import("@angular/core").InputSignal<boolean>;
+    isMenuLock: import("@angular/core").InputSignal<boolean>;
+    isShowSidebar: import("@angular/core").InputSignal<boolean>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    menuClosed: import("@angular/core").OutputEmitterRef<void>;
+    menuOpened: import("@angular/core").OutputEmitterRef<void>;
+    toggleMenuLock: import("@angular/core").OutputEmitterRef<Event>;
+    singoutLayoutConfig: () => void | Promise<void>;
+    changePasswordLayoutConfig: (() => void | Promise<void>) | undefined;
+    onMenuOpened: () => void;
+    onMenuClosed: () => void;
+    keepOpenWhenClickInsideMenu: (event: Event) => void;
+    logout: () => void;
+    changePassword: () => void;
+    onToggleMenuLock: (event: Event) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV2UserComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV2UserComponent, "sd-sidebar-v2-user", never, { "isMobileOrTablet": { "alias": "isMobileOrTablet"; "required": false; "isSignal": true; }; "isMenuLock": { "alias": "isMenuLock"; "required": false; "isSignal": true; }; "isShowSidebar": { "alias": "isShowSidebar"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; }, { "menuClosed": "menuClosed"; "menuOpened": "menuOpened"; "toggleMenuLock": "toggleMenuLock"; }, never, never, true, never>;
+}

package/modules/layout/components/sidebar-v2/main.component.d.ts

@@ -0,0 +1,25 @@
+import { MatSidenav } from '@angular/material/sidenav';
+import { SdLayoutUserInfo, SidebarConfigurationV2 } from '../../configurations';
+import { SdLayoutMenu } from '../../services';
+import * as i0 from "@angular/core";
+export declare class SidebarV2Component {
+    #private;
+    sidenav: import("@angular/core").Signal<MatSidenav>;
+    menus: import("@angular/core").InputSignal<SdLayoutMenu[]>;
+    userInfo: import("@angular/core").InputSignal<SdLayoutUserInfo>;
+    sidebar: import("@angular/core").InputSignal<SidebarConfigurationV2>;
+    isMobileOrTablet: import("@angular/core").WritableSignal<boolean>;
+    isMenuLock: import("@angular/core").WritableSignal<boolean>;
+    isShowSidebar: import("@angular/core").WritableSignal<boolean>;
+    onhover: import("@angular/core").WritableSignal<boolean>;
+    constructor();
+    openSidebar: () => void;
+    onPopupOfSideBarOpened: () => void;
+    onPopupOfSideBarClosed: () => void;
+    onExpandSideBar: () => void;
+    onMouseleaveSideBar: () => void;
+    onSidenavOpenedChange: (opened: boolean) => void;
+    onToggle: (data: boolean | null) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SidebarV2Component, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarV2Component, "sd-sidebar-v2", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/modules/layout/configurations/layout.configuration.d.ts

@@ -30,7 +30,7 @@ export interface SdLayoutUserInfo {
      */
     avatar?: string;
 }
-export type ISdSidebarConfiguration = SidebarConfigurationV1;
+export type ISdSidebarConfiguration = SidebarConfigurationV1 | SidebarConfigurationV2;
 export interface SidebarConfigurationV1 {
     version: 1;
     /**
@@ -64,4 +64,8 @@ export interface SidebarConfigurationV1 {
         enabled?: boolean;
     };
 }
+/** Opt in to the refreshed desktop sidebar while keeping the V1 configuration fields. */
+export interface SidebarConfigurationV2 extends Omit<SidebarConfigurationV1, 'version'> {
+    version: 2;
+}
 export declare const SD_LAYOUT_CONFIGURATION: InjectionToken<ISdLayoutConfiguration>;

package/modules/layout/services/layout.service.d.ts

@@ -1,9 +1,9 @@
-import { SdLayoutUserInfo } from '../configurations';
+import { ISdSidebarConfiguration, SdLayoutUserInfo } from '../configurations';
 import * as i0 from "@angular/core";
 export declare class SdLayoutService {
     #private;
     userInfo: import("@angular/core").WritableSignal<SdLayoutUserInfo | undefined>;
-    sidebar: import("@angular/core").WritableSignal<import("@sd-angular/core/modules/layout").SidebarConfigurationV1 | undefined>;
+    sidebar: import("@angular/core").WritableSignal<ISdSidebarConfiguration | undefined>;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<SdLayoutService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SdLayoutService>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sd-angular/core",
-  "version": "19.0.31",
+  "version": "19.0.33",
   "peerDependencies": {
     "@angular/common": "^19.0.0 || ^20.0.0 || ^21.0.0",
     "@angular/core": "^19.0.0 || ^20.0.0 || ^21.0.0",
@@ -116,6 +116,10 @@
       "types": "./components/code-editor/index.d.ts",
       "default": "./fesm2022/sd-angular-core-components-code-editor.mjs"
     },
+    "./components/data-state": {
+      "types": "./components/data-state/index.d.ts",
+      "default": "./fesm2022/sd-angular-core-components-data-state.mjs"
+    },
     "./components/document-builder": {
       "types": "./components/document-builder/index.d.ts",
       "default": "./fesm2022/sd-angular-core-components-document-builder.mjs"
@@ -355,6 +359,10 @@
     "./utilities/models": {
       "types": "./utilities/models/index.d.ts",
       "default": "./fesm2022/sd-angular-core-utilities-models.mjs"
+    },
+    "./utilities/read-state": {
+      "types": "./utilities/read-state/index.d.ts",
+      "default": "./fesm2022/sd-angular-core-utilities-read-state.mjs"
     }
   }
 }

package/utilities/index.d.ts

@@ -1,3 +1,4 @@
 export * from '@sd-angular/core/utilities/extensions';
 export * from '@sd-angular/core/utilities/models';
 export * from '@sd-angular/core/utilities/data-state';
+export * from '@sd-angular/core/utilities/read-state';

package/utilities/read-state/index.d.ts

@@ -0,0 +1 @@
+export * from './src/read-state';

package/utilities/read-state/src/read-state.d.ts

@@ -0,0 +1,37 @@
+export type SdReadOperation = 'TABLE' | 'VALUE' | 'SEARCH';
+export type SdReadStatus = 'idle' | 'loading' | 'ready' | 'empty' | 'error';
+/** An accepted read result. Only an error snapshot contains the original exception. */
+export type SdReadState = Readonly<{
+    status: Exclude<SdReadStatus, 'error'>;
+    operation: SdReadOperation;
+} | {
+    status: 'error';
+    operation: SdReadOperation;
+    error: unknown;
+}>;
+export type SdSearchReadState = SdReadState & {
+    readonly channels: Readonly<{
+        VALUE: SdReadState;
+        SEARCH: SdReadState;
+    }>;
+};
+/** VALUE errors take precedence; otherwise SEARCH errors, then the active SEARCH channel. */
+export declare function combineReadStates(value: SdReadState, search: SdReadState): SdSearchReadState;
+/** @internal Request guard shared by controls. Context is checked even before Angular effects run. */
+export declare class SdReadChannel {
+    #private;
+    readonly operation: SdReadOperation;
+    private readonly changed?;
+    readonly state: import("@angular/core").Signal<SdReadState>;
+    constructor(operation: SdReadOperation, changed?: ((state: SdReadState) => void) | undefined);
+    begin(valid?: () => boolean): number;
+    isCurrent(revision: number): boolean;
+    succeed(revision: number, count: number): boolean;
+    fail(revision: number, error: unknown): boolean;
+    invalidate(): void;
+}
+/**
+ * @internal Copy request-owned data, including Dates. Unlike ObjectUtilities.clone,
+ * Dates must be copied too; structuredClone cannot retain table column callbacks.
+ */
+export declare function cloneReadRequest<T>(value: T, seen?: WeakMap<object, unknown>): T;