@sd-angular/core 19.0.44 → 19.0.45

package/README.md

@@ -117,6 +117,10 @@ export const appConfig: ApplicationConfig = {
 | `--sd-black300` | `#BFBFBF` | Xám trung |
 | `--sd-black200` | `#E6E6E6` | Xám nhạt |
 | `--sd-black100` | `#F2F2F2` | Xám nhạt nhất |
+| `--sd-view-label-color` | `var(--sd-black400)` | Label chỉ-đọc (`sd-view`, control ở `viewed`, `sd-section-item`), class `.sd-view-label` |
+| `--sd-view-value-color` | `var(--sd-black500)` | Giá trị chỉ-đọc, class `.sd-view-value` |
+
+`theme()` còn ánh xạ token Material của form field, option và datepicker sang palette này (`assets/scss/themes/_material-tokens.scss`): viền/label/caret khi focus và option/ngày đang chọn dùng `--sd-primary`, viền lúc nghỉ dùng `--sd-black200`, field lỗi chỉ đổi viền sang `--sd-error` (label giữ màu thường). Đổi `primary` trong `theme()` là các trạng thái này đổi theo.
 
 ### Custom Theme / Tuỳ chỉnh theme
 

package/assets/scss/core/form.scss

@@ -11,19 +11,8 @@
     color: map.get(color.$color_map, 'error');
   }
 
-  // Xử lý màu border nhạt bớt
-  .mat-mdc-notch-piece {
-    &.mdc-notched-outline__leading {
-      border-color: map.get(color.$color_map, 'black200') !important;
-    }
-    &.mdc-notched-outline__notch {
-      border-top-color: map.get(color.$color_map, 'black200') !important;
-      border-bottom-color: map.get(color.$color_map, 'black200') !important;
-    }
-    &.mdc-notched-outline__trailing {
-      border-color: map.get(color.$color_map, 'black200') !important;
-    }
-  }
+  // Màu viền / label / caret theo trạng thái (thường, focus, lỗi): token Material ánh xạ sang palette
+  // Core trong theme() — xem themes/_material-tokens.scss.
 
   // Xử lý icon
   .sd-suffix-icon {
@@ -124,26 +113,12 @@
     }
   }
 
-  // Bỏ padding nếu hideInlineError
+  // Bỏ padding nếu hideInlineError. Viền đỏ khi lỗi đến từ token `error-outline-color` trong theme(),
+  // như mọi field khác.
   &.hide-inline-error {
     .mat-mdc-form-field-subscript-wrapper {
       display: none;
     }
-
-    &.mat-form-field-invalid {
-      .mat-mdc-notch-piece {
-        &.mdc-notched-outline__leading {
-          border-color: map.get(color.$color_map, 'error') !important;
-        }
-        &.mdc-notched-outline__notch {
-          border-top-color: map.get(color.$color_map, 'error') !important;
-          border-bottom-color: map.get(color.$color_map, 'error') !important;
-        }
-        &.mdc-notched-outline__trailing {
-          border-color: map.get(color.$color_map, 'error') !important;
-        }
-      }
-    }
   }
 
   // Size normal`
@@ -265,17 +240,15 @@
         }
       }
 
-      &.mat-mdc-form-field-can-float {
-        .mat-mdc-form-field-label {
-          top: 22px;
-        }
-
-        &.mat-mdc-form-field-should-float {
-          .mat-mdc-form-field-label {
-            transform: translateY(-10px) scale(0.75);
-            width: 133.33333%;
-          }
-        }
+      // why: chữ giá trị/placeholder nằm trong line box 24px của control, nên Chrome đặt glyph ở
+      // `floor((24 - cao_font) / 2)` — cao_font theo metrics của OS (Roboto: 17px trên Windows, 16px trên
+      // Linux/macOS). Label nghỉ dùng `line-height: normal` và căn tâm bằng translateY(-50%), không bị làm
+      // tròn như vậy, nên trên Windows nó thấp hơn chữ 1px. Cho label nghỉ cùng line-height với control:
+      // line box của label trùng line box của chữ, glyph trùng nhau trên mọi OS. Chỉ trạng thái nghỉ —
+      // label đã float giữ `normal` để vị trí trên viền không đổi. (Rule `top` cũ trỏ vào class M2
+      // `.mat-mdc-form-field-label` không còn tồn tại nên chưa từng có hiệu lực.)
+      .mdc-floating-label:not(.mdc-floating-label--float-above) {
+        line-height: var(--mat-form-field-container-text-line-height, var(--mat-sys-body-large-line-height, 24px));
       }
 
       // Fix for date range and datetime inputs with small size
@@ -289,6 +262,14 @@
   }
 }
 
+// why: chữ option của sd-select / sd-autocomplete 14px, bằng chữ hiển thị trong ô. Option single của
+// Material mặc định là body-large (16px) trong khi trigger/input là 14px. Màu option đang chọn nằm ở
+// themes/_material-tokens.scss.
+.mat-mdc-select-panel.sd-select-panel,
+.mat-mdc-autocomplete-panel.sd-autocomplete-panel {
+  --mat-option-label-text-size: 14px;
+}
+
 // Override reboot rule `label { margin-bottom: 0.5rem }` cho mat-checkbox layout
 mat-checkbox {
   label.mat-mdc-checkbox-layout {

package/assets/scss/core/view.scss

@@ -0,0 +1,24 @@
+// Read-only label/value pair — <sd-view>, every form control in `viewed` mode and the label of
+// <sd-section-item>. Public classes, so a custom detail layout reads the same as the library:
+//
+//   <div class="sd-view-label">Mã hợp đồng</div>
+//   <div class="sd-view-value">HD-001</div>
+//
+// why: the value used to inherit the colour of its container, so inside a grey container label and
+// value ended up in the same colour. Both now take a token of theme(): --sd-view-label-color
+// (--sd-black400) and --sd-view-value-color (--sd-black500). Override them on any scope to restyle
+// every read-only field below it.
+
+.sd-view-label {
+  color: var(--sd-view-label-color, var(--sd-black400, #757575));
+  font-size: 14px;
+  font-weight: 400;
+  line-height: 20px;
+}
+
+.sd-view-value {
+  color: var(--sd-view-value-color, var(--sd-black500, #212121));
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 20px;
+}

package/assets/scss/sd-core.scss

@@ -5,6 +5,7 @@
 @use './core/form.scss';
 @use './core/image.scss';
 @use './core/scrollbar.scss';
+@use './core/view.scss';
 @use './themes/default.scss';
 @use './themes/material-theme.scss';
 

package/assets/scss/themes/_material-tokens.scss

@@ -0,0 +1,71 @@
+// Angular Material component tokens mapped onto the Core palette.
+//
+// why: `core/form.scss` used to force `border-color: var(--sd-black200) !important` on the outline
+// pieces in every state, so a focused field only drew a thicker grey outline and an invalid field kept
+// a grey outline under a red label. The colours now go through Material's own tokens, declared by
+// theme() so every theme scope resolves them against its palette and a parent of a field can still
+// override a token for its subtree.
+//
+// - Rest / hover / disabled outline: --sd-black200 (the colour the old rule forced).
+// - Focus: --sd-primary for the outline, floating label, caret, select arrow and datepicker toggle.
+// - Error: only the outline (and the filled active indicator) turns --sd-error. The floating label and
+//   the select arrow keep the colour of a valid field; the error message, error icon and required
+//   marker stay red.
+// - Options, checkmarks and datepicker: selected state in --sd-primary.
+//
+// Token names are the Material 19 ones (`--mdc-*-text-field-*`, `--mat-{full,minimal}-pseudo-checkbox-*`).
+// The label references fall back to the Material 2 theme values of `material-theme.scss`.
+
+$-text-field-prefixes: (
+  outlined: '--mdc-outlined-text-field-',
+  filled: '--mdc-filled-text-field-',
+);
+
+@mixin emit() {
+  @each $appearance, $prefix in $-text-field-prefixes {
+    #{$prefix}caret-color: var(--sd-primary);
+    #{$prefix}error-caret-color: var(--sd-primary);
+    #{$prefix}focus-label-text-color: var(--sd-primary);
+    #{$prefix}error-focus-label-text-color: var(--sd-primary);
+    #{$prefix}error-label-text-color: var(#{$prefix}label-text-color, rgba(0, 0, 0, 0.6));
+    #{$prefix}error-hover-label-text-color: var(#{$prefix}hover-label-text-color, rgba(0, 0, 0, 0.87));
+    @if $appearance == outlined {
+      #{$prefix}outline-color: var(--sd-black200);
+      #{$prefix}hover-outline-color: var(--sd-black200);
+      #{$prefix}disabled-outline-color: var(--sd-black200);
+      #{$prefix}focus-outline-color: var(--sd-primary);
+      #{$prefix}error-outline-color: var(--sd-error);
+      #{$prefix}error-hover-outline-color: var(--sd-error);
+      #{$prefix}error-focus-outline-color: var(--sd-error);
+    } @else {
+      #{$prefix}focus-active-indicator-color: var(--sd-primary);
+      #{$prefix}error-active-indicator-color: var(--sd-error);
+      #{$prefix}error-hover-active-indicator-color: var(--sd-error);
+      #{$prefix}error-focus-active-indicator-color: var(--sd-error);
+    }
+  }
+  --mat-form-field-focus-select-arrow-color: var(--sd-primary);
+  --mat-select-focused-arrow-color: var(--sd-primary);
+  --mat-select-invalid-arrow-color: var(--mat-select-enabled-arrow-color, rgba(0, 0, 0, 0.54));
+  --mat-datepicker-toggle-active-state-icon-color: var(--sd-primary);
+
+  --mat-option-selected-state-label-text-color: var(--sd-primary);
+  --mat-option-selected-state-layer-color: var(--sd-primary-light);
+  --mat-full-pseudo-checkbox-selected-icon-color: var(--sd-primary);
+  --mat-full-pseudo-checkbox-selected-checkmark-color: white;
+  --mat-minimal-pseudo-checkbox-selected-checkmark-color: var(--sd-primary);
+
+  --mat-datepicker-calendar-date-selected-state-background-color: var(--sd-primary);
+  --mat-datepicker-calendar-date-selected-state-text-color: white;
+  --mat-datepicker-calendar-date-today-outline-color: var(--sd-primary);
+  --mat-datepicker-calendar-date-today-selected-state-outline-color: white;
+  --mat-datepicker-calendar-date-in-range-state-background-color: var(--sd-primary-light);
+
+  // Nested rule last: Sass rejects declarations after a nested rule (mixed-decls).
+  // The Material 2 theme re-declares the checkmark colours on `.mat-primary` (the class sd-select puts
+  // on its panel) with the palette hex, so a custom --sd-primary would not reach them.
+  .mat-primary {
+    --mat-full-pseudo-checkbox-selected-icon-color: var(--sd-primary);
+    --mat-minimal-pseudo-checkbox-selected-checkmark-color: var(--sd-primary);
+  }
+}

package/assets/scss/themes/default.scss

@@ -1,5 +1,6 @@
 @use "sass:map";
 @use "../core/color";
+@use "./material-tokens";
 
 $default-theme: (
   primary: #2A66F4,
@@ -42,4 +43,13 @@ $default-theme: (
   @each $color in color.$system-colors {
     --sd-#{$color}: #{map.get($theme, $color)};
   }
+
+  // Read-only label/value pair of <sd-view>, the viewed mode of form controls and <sd-section-item>
+  // (classes .sd-view-label / .sd-view-value in core/view.scss). Override on any scope to restyle them.
+  --sd-view-label-color: var(--sd-black400);
+  --sd-view-value-color: var(--sd-black500);
+
+  // Material form-field / option / datepicker tokens on the Core palette (themes/_material-tokens.scss).
+  // Last: it ends with a nested rule.
+  @include material-tokens.emit();
 }

package/components/form-generic/src/components/form-builder/components/expression-builder/expression-builder.component.d.ts

@@ -4,6 +4,7 @@ import { SdModal } from '@sd-angular/core/components/modal';
 import { Attribute, SdFormGenericExpression, SdFormGenericExpressionCondition } from '../../../../models';
 import * as i0 from "@angular/core";
 export declare class ExpressionBuilderComponent {
+    #private;
     private ref;
     modal?: SdModal;
     form: FormGroup<{}>;

package/components/form-generic/src/models/form-generic-expression.model.d.ts

@@ -1,5 +1,11 @@
 import { Operator as SdOperator } from '@sdcorejs/utils/models';
 import { SdFormGenericComponent, SdFormGenericGroup } from './form-generic-component.model';
+import { type SdDateTimeService } from '@sd-angular/core/services/date-time';
+/**
+ * Clock and formatting of `ISdCoreConfiguration.timeZone` for expressions: pass `inject(SdDateTimeService)`.
+ * Omitted or `'local'`: the machine zone, as before.
+ */
+export type SdFormGenericExpressionDateTime = Pick<SdDateTimeService, 'timeZone' | 'toFormat'>;
 export interface SdFormGenericExpression {
     key: string;
     type: 'combinator';
@@ -52,7 +58,7 @@ export declare const DayInfoPreviouses: {
     display: string;
     format: (n: number) => string;
 }[];
-export declare const GetDatetimeValue: (value: string) => string | undefined;
+export declare const GetDatetimeValue: (value: string, dateTime?: SdFormGenericExpressionDateTime) => string | undefined;
 interface AttributeValues {
     value: string;
     display: string;
@@ -68,7 +74,7 @@ export declare const AttributeOperators: Record<Attribute['type'], {
     display: string;
 }[]>;
 export declare const GetAttributes: (components: (SdFormGenericComponent | SdFormGenericGroup)[]) => Attribute[];
-export declare const TemplateToCondition: (template: string | undefined | null, entity: Record<string, any>) => string | undefined;
-export declare const EvaluateExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition, entity: Record<string, any>) => boolean | undefined;
-export declare const ExpressionToJavascriptExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition) => string | undefined;
+export declare const TemplateToCondition: (template: string | undefined | null, entity: Record<string, any>, dateTime?: SdFormGenericExpressionDateTime) => string | undefined;
+export declare const EvaluateExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition, entity: Record<string, any>, dateTime?: SdFormGenericExpressionDateTime) => boolean | undefined;
+export declare const ExpressionToJavascriptExpression: (condition: SdFormGenericExpression | SdFormGenericExpressionCondition, dateTime?: SdFormGenericExpressionDateTime) => string | undefined;
 export {};

package/components/form-generic/src/pipes/component-viewed.pipe.d.ts

@@ -4,6 +4,7 @@ import { FormGenericService } from '../services';
 import { SdFormatNumberPipe } from '@sd-angular/core/pipes';
 import * as i0 from "@angular/core";
 export declare class ComponentViewedPipe implements PipeTransform {
+    #private;
     private readonly formatNumberPipe;
     private readonly formGenericService;
     constructor(formatNumberPipe: SdFormatNumberPipe, formGenericService: FormGenericService);

package/components/import-excel/src/pipes/column-transform.pipe.d.ts

@@ -3,6 +3,7 @@ import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
 import { SdImportExcelItem, SdUploadExcelColumn } from '../import-excel.model';
 import * as i0 from "@angular/core";
 export declare class ColumnTransformPipe implements PipeTransform {
+    #private;
     private sanitizer;
     constructor(sanitizer: DomSanitizer);
     transform(item: SdImportExcelItem, column: SdUploadExcelColumn): Promise<string | SafeHtml>;

package/components/inform/src/inform.component.d.ts

@@ -1,10 +1,14 @@
 import { ElementRef } from '@angular/core';
 import { Color } from '@sdcorejs/utils/models';
-import { MaterialIconFontSet } from '@sd-angular/core/utilities/models';
+import { MaterialIconFontSet, SdIconShape } from '@sd-angular/core/utilities/models';
 import { SdInformActionDirective } from './inform-action.directive';
 import * as i0 from "@angular/core";
+/** `default` = banner thường; `tip` = gợi ý gọn, không phải live region (role="note"). */
+export type SdInformType = 'default' | 'tip';
 export declare class SdInform {
     #private;
+    /** Banner thường hoặc gợi ý gọn (`tip`); null/undefined quay về `default`. */
+    type: import("@angular/core").InputSignalWithTransform<SdInformType, SdInformType | null | undefined>;
     color: import("@angular/core").InputSignalWithTransform<Color, Color | null | undefined>;
     primary: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     secondary: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
@@ -16,6 +20,11 @@ export declare class SdInform {
     description: import("@angular/core").InputSignal<string | undefined>;
     icon: import("@angular/core").InputSignal<string | undefined>;
     hideIcon: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Nền ô icon: `'none'` (mặc định, không nền, giữ kích thước ô), `'square'` (bo 8px) hoặc `'circle'`.
+     * Null/undefined quay về `none`. Variant `tip` luôn phẳng, không nền.
+     */
+    iconShape: import("@angular/core").InputSignalWithTransform<SdIconShape, SdIconShape | null | undefined>;
     fontSet: import("@angular/core").InputSignalWithTransform<MaterialIconFontSet, MaterialIconFontSet | null | undefined>;
     closable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     actionLabel: import("@angular/core").InputSignal<string | undefined>;
@@ -47,7 +56,7 @@ export declare class SdInform {
     hasActionSlot: import("@angular/core").Signal<boolean>;
     clampLines: import("@angular/core").Signal<number | null>;
     showToggle: import("@angular/core").Signal<boolean>;
-    liveRole: import("@angular/core").Signal<"alert" | "status">;
+    liveRole: import("@angular/core").Signal<"alert" | "status" | "note">;
     constructor();
     /** Đo tràn dòng của body; chỉ có ý nghĩa khi đang clamp. */
     measureOverflow(): void;
@@ -55,5 +64,5 @@ export declare class SdInform {
     onClose(event: Event): void;
     onAction(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdInform, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdInform, "sd-inform", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "primary": { "alias": "primary"; "required": false; "isSignal": true; }; "secondary": { "alias": "secondary"; "required": false; "isSignal": true; }; "info": { "alias": "info"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hideIcon": { "alias": "hideIcon"; "required": false; "isSignal": true; }; "fontSet": { "alias": "fontSet"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "lineClamp": { "alias": "lineClamp"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; "sdAction": "sdAction"; }, ["actionSlot"], ["[sdInformAction]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdInform, "sd-inform", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "primary": { "alias": "primary"; "required": false; "isSignal": true; }; "secondary": { "alias": "secondary"; "required": false; "isSignal": true; }; "info": { "alias": "info"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "hideIcon": { "alias": "hideIcon"; "required": false; "isSignal": true; }; "iconShape": { "alias": "iconShape"; "required": false; "isSignal": true; }; "fontSet": { "alias": "fontSet"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "actionLabel": { "alias": "actionLabel"; "required": false; "isSignal": true; }; "lineClamp": { "alias": "lineClamp"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "sdClosed": "sdClosed"; "sdAction": "sdAction"; }, ["actionSlot"], ["[sdInformAction]", "*"], true, never>;
 }

package/components/table/src/services/table-export/table-export.service.d.ts

@@ -1,4 +1,4 @@
-import { SdExcelColumn } from '@sd-angular/core/services';
+import { SdExcelColumn } from '@sd-angular/core/services/excel';
 import { ConfiguredTableResult } from '../../models/table-option-config.model';
 import { SdTableOption } from '../../models/table-option.model';
 import { SdTableFilterRequest } from '../table-filter/table-filter.model';

package/components/table/src/services/table-filter/table-filter.model.d.ts

@@ -1,5 +1,6 @@
 import { TemplateRef } from '@angular/core';
 import { SdSearch } from '@sd-angular/core/forms';
+import { type SdDateTimeService } from '@sd-angular/core/services/date-time';
 import { NestedKeyOf, Operator, Order, PagingReq } from '@sdcorejs/utils/models';
 import { Observable } from 'rxjs';
 import { SdTableColumn } from '../../models/table-column.model';
@@ -60,6 +61,12 @@ export declare const SdConvertToPagingReq: (filterRequest: SdTableFilterRequest,
     externalFilters?: SdTableExternalFilter[];
     fieldMapping?: Record<string, string>;
     orders?: Order[];
+    /**
+     * `inject(SdDateTimeService)` makes date filters follow `ISdCoreConfiguration.timeZone`: a day is
+     * [its first instant, the first instant of the next calendar day) in the zone, and a zone-less
+     * datetime is wall clock there. Omitted or `'local'`: the machine zone, as before.
+     */
+    dateTime?: Pick<SdDateTimeService, "timeZone" | "begin" | "end" | "beginOfNextDay" | "parse">;
 }) => PagingReq;
 export declare type SdTableExternalFilter<TData = any> = TextFilter<TData> | DateFilter<TData> | DateTimeFilter<TData> | DateRangeFilter<TData> | NumberFilter<TData> | ValuesFilter<TData> | LazyValuesFilter<TData> | BooleanFilter<TData> | CustomFilter<TData>;
 interface BaseFilter<TData = any> {

package/components/table/src/services/table-local/table-local-sort.util.d.ts

@@ -1,3 +1,9 @@
+import type { SdDateTimeService } from '@sd-angular/core/services/date-time';
 import type { SdTableColumn } from '../../models/table-column.model';
-/** Internal local-sort comparison; intentionally not exported from the table entry point. */
-export declare const compareLocalValues: (a: unknown, b: unknown, type: SdTableColumn["type"], direction: "ASC" | "DESC") => number;
+type SortDateTime = Pick<SdDateTimeService, 'timeZone' | 'parse'>;
+/**
+ * Internal local-sort comparison; intentionally not exported from the table entry point.
+ * `dateTime` reads zone-less dates in `ISdCoreConfiguration.timeZone`; omitted or `'local'` keeps the machine zone.
+ */
+export declare const compareLocalValues: (a: unknown, b: unknown, type: SdTableColumn["type"], direction: "ASC" | "DESC", dateTime?: SortDateTime) => number;
+export {};

package/components/table/src/services/table-local/table-local.util.d.ts

@@ -1,3 +1,5 @@
+import { type SdDateTimeService } from '@sd-angular/core/services/date-time';
+import { Operator } from '@sdcorejs/utils/models';
 import { SdTableColumn } from '../../models/table-column.model';
 import { SdTableItem } from '../../models/table-item.model';
 import { SdTableOptionTree } from '../../models/table-option-tree.model';
@@ -6,7 +8,10 @@ export interface FilterLocalItemsOption<T> {
     type: 'local' | 'server';
     columns: SdTableColumn<T>[];
     tree?: SdTableOptionTree<T>;
+    /** Date math of `ISdCoreConfiguration.timeZone`; omitted or `'local'` keeps the machine zone. */
+    dateTime?: LocalDateTime;
 }
+type LocalDateTime = Pick<SdDateTimeService, 'timeZone' | 'begin' | 'end' | 'parse'>;
 export interface FilterLocalItemsResult<T, TItem> {
     items: TItem[];
     total: number;
@@ -14,6 +19,6 @@ export interface FilterLocalItemsResult<T, TItem> {
 }
 type LocalFilterItem<T> = SdTableItem<T> | T;
 export declare const hasActiveColumnFilter: <T>(rawColumnFilter?: Partial<Record<string, any>>, columns?: SdTableColumn<T>[]) => boolean;
-export declare const matchesColumnFilter: <T>(data: T, columns?: SdTableColumn<T>[], rawColumnFilter?: Partial<Record<string, any>>) => boolean;
+export declare const matchesColumnFilter: <T>(data: T, columns?: SdTableColumn<T>[], rawColumnFilter?: Partial<Record<string, any>>, dateTime?: LocalDateTime, columnOperator?: Partial<Record<string, Operator>>) => boolean;
 export declare const filterLocalItems: <T, TItem extends LocalFilterItem<T>>(localItems: TItem[], option: FilterLocalItemsOption<T>, filterInfo: SdTableFilterRequest<T>) => FilterLocalItemsResult<T, TItem>;
 export {};

package/components/table/src/table.component.d.ts

@@ -2,7 +2,7 @@ import { AfterViewInit, OnDestroy } from '@angular/core';
 import { MatPaginator, MatPaginatorIntl } from '@angular/material/paginator';
 import { MatSort } from '@angular/material/sort';
 import { MatTable } from '@angular/material/table';
-import { SdExcelColumn } from '@sd-angular/core/services';
+import { SdExcelColumn } from '@sd-angular/core/services/excel';
 import { SdTableCellDefDirective } from './directives/sd-table-cell-def.directive';
 import { SdTableExpandDefDirective } from './directives/sd-table-expand-def.directive';
 import { SdTableGroupDefDirective, SdTableGroupDefContext } from './directives/sd-table-group-def.directive';

package/components/timeline/pipes/view-date.pipe.d.ts

@@ -1,6 +1,7 @@
 import { PipeTransform } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class ViewDateTimePipe implements PipeTransform {
+    #private;
     transform(value: any): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ViewDateTimePipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ViewDateTimePipe, "viewDateTime", true>;

package/configurations/src/sd-core.configuration.d.ts

@@ -1,9 +1,16 @@
 import { InjectionToken } from "@angular/core";
 import type { Language } from "@sd-angular/core/models";
+/**
+ * Time zone the whole app reads and shows dates in: `'local'` (the browser's zone) or an IANA id.
+ * The listed ids only drive autocomplete; any IANA id is accepted. Numeric offsets (`'+07:00'`) are
+ * rejected because they carry no offset history.
+ */
+export type SdTimeZone = 'local' | 'UTC' | 'Asia/Ho_Chi_Minh' | 'Asia/Bangkok' | 'Asia/Jakarta' | 'Asia/Singapore' | 'Asia/Kuala_Lumpur' | 'Asia/Manila' | 'Asia/Shanghai' | 'Asia/Hong_Kong' | 'Asia/Taipei' | 'Asia/Tokyo' | 'Asia/Seoul' | 'Asia/Kolkata' | 'Asia/Dubai' | 'Australia/Sydney' | 'Europe/London' | 'Europe/Paris' | 'Europe/Berlin' | 'America/New_York' | 'America/Chicago' | 'America/Los_Angeles' | (string & {});
 export interface ISdCoreConfiguration {
     format?: {
         number?: '1,234,567.89' | '1.234.567,89';
     };
     language?: Language | (() => Record<string, string>);
+    timeZone?: SdTimeZone;
 }
 export declare const SD_CORE_CONFIGURATION: InjectionToken<ISdCoreConfiguration>;