@sdcorejs/angular 19.0.4 → 19.0.6

package/assets/{scss/README.md → STYLE-GUIDE.md}

@@ -46,6 +46,7 @@
 
 ```
 projects/sdcorejs-angular/assets/
+├── STYLE-GUIDE.md                     # Tài liệu này (assets + SCSS reference cho người + AI agent)
 ├── fonts/
 │   ├── fonts.scss                     # @font-face khai báo cho Roboto + Material Icons + Material Symbols
 │   ├── material-icons/                # 2 file .woff2 (icons-v145 + outlined-v110)
@@ -321,6 +322,8 @@ p-{n}   pt-{n}   pr-{n}   pb-{n}   pl-{n}   px-{n}   py-{n}
 
 Ví dụ: `m-0`, `mt-8`, `px-16`, `py-24`, `mb-4`.
 
+**Spacing scale rule:** với spacing dùng cho layout element, chỉ dùng giá trị là **bội số của 4px**: `m-4`, `m-8`, `m-12`, `m-16`, `p-4`, `p-8`, `px-16`, `py-24`, `gap-8`, `gap-16`... Tránh sinh các class lẻ như `m-3`, `p-5`, `gap-7` trừ khi đang xử lý pixel-perfect exception đã được review rõ ràng.
+
 **Auto margin:** `m-auto`, `mt-auto`, `mr-auto`, `mb-auto`, `ml-auto`, `mx-auto`, `my-auto`.
 
 ### 7.2 Gap (px-based, 0–200)

package/components/index.d.ts

@@ -12,6 +12,8 @@ export * from '@sdcorejs/angular/components/upload-file';
 export * from '@sdcorejs/angular/components/section';
 export * from '@sdcorejs/angular/components/anchor';
 export * from '@sdcorejs/angular/components/query-builder';
+export * from '@sdcorejs/angular/components/org-chart';
+export * from '@sdcorejs/angular/components/tree';
 export * from '@sdcorejs/angular/components/import-excel';
 export * from '@sdcorejs/angular/components/document-builder';
 export * from '@sdcorejs/angular/components/mini-editor';

package/components/org-chart/index.d.ts

@@ -0,0 +1,3 @@
+export * from './src/org-chart.component';
+export * from './src/org-chart-item-def.directive';
+export * from './src/org-chart.model';

package/components/org-chart/src/org-chart-item-def.directive.d.ts

@@ -0,0 +1,9 @@
+import { TemplateRef } from '@angular/core';
+import { SdOrgChartItem, SdOrgChartItemContext } from './org-chart.model';
+import * as i0 from "@angular/core";
+export declare class SdOrgChartItemDefDirective<T extends SdOrgChartItem = SdOrgChartItem> {
+    static ngTemplateContextGuard<T extends SdOrgChartItem>(_dir: SdOrgChartItemDefDirective<T>, _ctx: unknown): _ctx is SdOrgChartItemContext<T>;
+    readonly templateRef: TemplateRef<SdOrgChartItemContext<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdOrgChartItemDefDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdOrgChartItemDefDirective<any>, "[sdOrgChartItemDef]", never, {}, {}, never, never, true, never>;
+}

package/components/org-chart/src/org-chart.component.d.ts

@@ -0,0 +1,26 @@
+import { TemplateRef } from '@angular/core';
+import { SdOrgChartItemDefDirective } from './org-chart-item-def.directive';
+import { SdOrgChartItem, SdOrgChartItemContext, SdOrgChartOption } from './org-chart.model';
+import * as i0 from "@angular/core";
+export declare class SdOrgChart {
+    #private;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly option: import("@angular/core").InputSignal<SdOrgChartOption<SdOrgChartItem> | undefined>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly items: import("@angular/core").InputSignal<SdOrgChartItem[] | undefined>;
+    readonly itemTemplate: import("@angular/core").InputSignal<TemplateRef<SdOrgChartItemContext<SdOrgChartItem>> | null | undefined>;
+    readonly collapsible: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly itemDef: import("@angular/core").Signal<SdOrgChartItemDefDirective<any> | undefined>;
+    readonly resolvedItems: import("@angular/core").Signal<SdOrgChartItem[]>;
+    readonly resolvedCollapsible: import("@angular/core").Signal<boolean>;
+    readonly resolvedItemTemplate: import("@angular/core").Signal<TemplateRef<SdOrgChartItemContext<SdOrgChartItem>> | undefined>;
+    readonly trackByItem: (_index: number, item: SdOrgChartItem) => string | number;
+    hasChildren: (item: SdOrgChartItem) => boolean;
+    childrenOf: (item: SdOrgChartItem) => SdOrgChartItem[];
+    isExpanded: (item: SdOrgChartItem) => boolean;
+    toggle: (item: SdOrgChartItem, event?: Event) => void;
+    createContext: (item: SdOrgChartItem, depth: number, parent: SdOrgChartItem | null) => SdOrgChartItemContext;
+    nodeAutoId: (item: SdOrgChartItem, part: "node" | "image" | "title" | "description" | "toggle") => string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdOrgChart, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdOrgChart, "sd-org-chart", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "option": { "alias": "option"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; }, {}, ["itemDef"], never, true, never>;
+}

package/components/org-chart/src/org-chart.model.d.ts

@@ -0,0 +1,32 @@
+import { TemplateRef } from '@angular/core';
+export interface SdOrgChartItem {
+    id: string | number;
+    image?: string | null;
+    title: string;
+    description?: string | null;
+    color?: string | null;
+    expanded?: boolean;
+    children?: SdOrgChartItem[];
+}
+export interface SdOrgChartItemContext<T extends SdOrgChartItem = SdOrgChartItem> {
+    $implicit: T;
+    item: T;
+    depth: number;
+    parent: T | null;
+    expanded: boolean;
+    hasChildren: boolean;
+    isLeaf: boolean;
+    toggle: () => void;
+}
+export type SdOrgChartItemTemplate<T extends SdOrgChartItem = SdOrgChartItem> = TemplateRef<SdOrgChartItemContext<T>>;
+export interface SdOrgChartToggleEvent<T extends SdOrgChartItem = SdOrgChartItem> {
+    item: T;
+    expanded: boolean;
+}
+export interface SdOrgChartOption<T extends SdOrgChartItem = SdOrgChartItem> {
+    autoId?: string | null;
+    items: T[];
+    itemTemplate?: TemplateRef<SdOrgChartItemContext<T>> | null;
+    collapsible?: boolean;
+    onToggle?: (event: SdOrgChartToggleEvent<T>) => void;
+}

package/components/query-bar/src/query-bar.component.d.ts

@@ -1,7 +1,7 @@
 import { Filter, Operator } from '@sdcorejs/utils/models';
 import { SdQueryChipPopover } from './components/chip-popover/chip-popover.component';
 import { SdQueryPopoverChip } from './components/popover-chip/popover-chip.component';
-import { BuildingChip, SdQuery, SdQueryField, SdQueryLogic, SdSavedFilter, sdQueryFieldIcon } from './query-bar.model';
+import { BuildingChip, SdQuery, SdQueryBarOption, SdQueryField, SdQueryLogic, SdSavedFilter, sdQueryFieldIcon } from './query-bar.model';
 import * as i0 from "@angular/core";
 type Density = 'compact' | 'comfortable';
 export declare class SdQueryBar {
@@ -12,6 +12,8 @@ export declare class SdQueryBar {
     private readonly buildChip;
     /** The extracted chip popover — owns operator+value staging + commit-on-close. */
     readonly chipPopover: import("@angular/core").Signal<SdQueryChipPopover | undefined>;
+    /** Main option object. Prefer this API for new usage; individual inputs stay as a migration bridge. */
+    readonly option: import("@angular/core").InputSignal<SdQueryBarOption<any> | undefined>;
     /** Prefix for auto-generated `data-autoid` on inner controls (chips, operator/value editors, buttons). */
     readonly autoIdInput: import("@angular/core").InputSignalWithTransform<string | undefined, string | null | undefined>;
     /** Available fields the user can filter by. Required for the field picker. */
@@ -66,6 +68,17 @@ export declare class SdQueryBar {
     /** Fires when the user presses "Áp dụng" inside a chip popover — host should reload data. */
     readonly apply: import("@angular/core").OutputEmitterRef<SdQuery<any>>;
     /** Map of `field.key` → `SdQueryField` for fast lookup from filters[]. */
+    readonly resolvedAutoId: import("@angular/core").Signal<string | undefined>;
+    readonly resolvedFields: import("@angular/core").Signal<SdQueryField[]>;
+    readonly resolvedMode: import("@angular/core").Signal<"popover" | "inline">;
+    readonly resolvedDensity: import("@angular/core").Signal<Density>;
+    readonly resolvedShowSearch: import("@angular/core").Signal<boolean>;
+    readonly resolvedShowSavedFilters: import("@angular/core").Signal<boolean>;
+    readonly resolvedSavedFiltersKey: import("@angular/core").Signal<string | undefined>;
+    readonly resolvedShowLogicToggle: import("@angular/core").Signal<boolean>;
+    readonly resolvedShowClearAll: import("@angular/core").Signal<boolean>;
+    readonly resolvedShowOperatorOnChip: import("@angular/core").Signal<boolean>;
+    constructor();
     readonly fieldByKey: import("@angular/core").Signal<Record<string, SdQueryField>>;
     /** Field keys already chained on a chip — the picker greys these out. */
     readonly usedFieldKeys: import("@angular/core").Signal<Set<string>>;
@@ -132,6 +145,6 @@ export declare class SdQueryBar {
     /** Receive `(commit)` from the child popover — splice into filters, null the index. */
     onChipPopoverCommit(next: Filter): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdQueryBar, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryBar, "sd-query-bar", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "logic": { "alias": "logic"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showSavedFilters": { "alias": "showSavedFilters"; "required": false; "isSignal": true; }; "savedFiltersKey": { "alias": "savedFiltersKey"; "required": false; "isSignal": true; }; "showLogicToggle": { "alias": "showLogicToggle"; "required": false; "isSignal": true; }; "showClearAll": { "alias": "showClearAll"; "required": false; "isSignal": true; }; "showOperatorOnChip": { "alias": "showOperatorOnChip"; "required": false; "isSignal": true; }; }, { "filters": "filtersChange"; "logic": "logicChange"; "search": "searchChange"; "queryChange": "queryChange"; "apply": "apply"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryBar, "sd-query-bar", never, { "option": { "alias": "option"; "required": false; "isSignal": true; }; "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "logic": { "alias": "logic"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showSavedFilters": { "alias": "showSavedFilters"; "required": false; "isSignal": true; }; "savedFiltersKey": { "alias": "savedFiltersKey"; "required": false; "isSignal": true; }; "showLogicToggle": { "alias": "showLogicToggle"; "required": false; "isSignal": true; }; "showClearAll": { "alias": "showClearAll"; "required": false; "isSignal": true; }; "showOperatorOnChip": { "alias": "showOperatorOnChip"; "required": false; "isSignal": true; }; }, { "filters": "filtersChange"; "logic": "logicChange"; "search": "searchChange"; "queryChange": "queryChange"; "apply": "apply"; }, never, never, true, never>;
 }
 export {};

package/components/query-bar/src/query-bar.model.d.ts

@@ -85,6 +85,28 @@ export interface SdQuery<T = any> {
     /** Free-text search box (only present when `showSearch=true`). */
     search?: string;
 }
+export interface SdQueryBarOption<T = any> {
+    /** Prefix for auto-generated `data-autoid` on inner controls. */
+    autoId?: string;
+    /** Available fields the user can filter by. */
+    fields: SdQueryField<T>[];
+    /** Initial active filter chips. */
+    filters?: Filter<T>[];
+    /** Initial global connector between filters. */
+    logic?: SdQueryLogic;
+    /** Initial free-text search string. */
+    search?: string;
+    mode?: 'popover' | 'inline';
+    density?: 'compact' | 'comfortable';
+    showSearch?: boolean;
+    showSavedFilters?: boolean;
+    savedFiltersKey?: string;
+    showLogicToggle?: boolean;
+    showClearAll?: boolean;
+    showOperatorOnChip?: boolean;
+    onQueryChange?: (query: SdQuery<T>) => void;
+    onApply?: (query: SdQuery<T>) => void;
+}
 /** Persisted bookmark of a query (filters + logic + search) — managed by `[savedFiltersKey]`. */
 export interface SdSavedFilter<T = any> {
     id: string;

package/components/query-builder/src/query-builder.component.d.ts

@@ -1,5 +1,5 @@
 import { Filter, Operator } from '@sdcorejs/utils/models';
-import { isQbGroup, QbDateMode, QbGroup, QbRule, QbToken, SdQueryBuilderField, SdQueryBuilderFieldOption } from './query-builder.model';
+import { isQbGroup, QbComparisonMode, QbDateMode, QbGroup, QbRule, QbToken, QbValueSource, qbFieldIcon, SdQueryBuilderField, SdQueryBuilderFieldOption, SdQueryBuilderOption } from './query-builder.model';
 import * as i0 from "@angular/core";
 /**
  * Visual filter / rule builder. Compose nested AND / OR groups of
@@ -10,10 +10,14 @@ import * as i0 from "@angular/core";
  */
 export declare class SdQueryBuilder {
     #private;
+    /** Main option object. Prefer this API for new usage; individual inputs stay as a migration bridge. */
+    readonly option: import("@angular/core").InputSignal<SdQueryBuilderOption | undefined>;
     /** Filterable fields — each declares a `type` that drives the operator set + value editor. */
     readonly fields: import("@angular/core").InputSignal<SdQueryBuilderField[]>;
     /** `'edit'` (default) = interactive tree · `'view'` = read-only raw-query string. */
     readonly mode: import("@angular/core").InputSignal<"edit" | "view">;
+    /** `value-only` = literal operands only · `value-or-field` = each rule may compare against another field. */
+    readonly comparisonMode: import("@angular/core").InputSignal<QbComparisonMode>;
     /** Disable all editing controls. */
     readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     /** Prefix for `data-autoid` on inner controls (E2E selectors). */
@@ -26,12 +30,16 @@ export declare class SdQueryBuilder {
     readonly rootLogic: import("@angular/core").ModelSignal<"AND" | "OR">;
     readonly tree: import("@angular/core").Signal<QbGroup>;
     /** `field.key` → field, for fast lookup from a rule. */
+    readonly resolvedFields: import("@angular/core").Signal<SdQueryBuilderField[]>;
+    readonly resolvedMode: import("@angular/core").Signal<"edit" | "view">;
+    readonly resolvedComparisonMode: import("@angular/core").Signal<QbComparisonMode>;
+    readonly resolvedDisabled: import("@angular/core").Signal<boolean>;
+    readonly resolvedAutoId: import("@angular/core").Signal<string | undefined>;
     readonly fieldByKey: import("@angular/core").Signal<Record<string, SdQueryBuilderField>>;
     /** Stable option list for the date-mode select. */
-    readonly dateModes: readonly {
-        value: QbDateMode;
-        display: string;
-    }[];
+    readonly dateModes: readonly import("@sdcorejs/angular/components/query-builder").QbDateModeOption[];
+    /** Stable option list for the literal-vs-field operand select. */
+    readonly valueSourceOptions: readonly import("@sdcorejs/angular/components/query-builder").QbValueSourceOption[];
     /** Stable combined unit×direction option list for the relative select. */
     readonly relativeUnitOptions: readonly {
         value: string;
@@ -42,6 +50,8 @@ export declare class SdQueryBuilder {
     readonly isView: import("@angular/core").Signal<boolean>;
     /** Expose the type-guard to the template. */
     readonly isGroup: typeof isQbGroup;
+    /** Resolve the leading icon for a field (own `icon` → per-type → `'tune'`) — used by the field picker. */
+    readonly fieldIcon: typeof qbFieldIcon;
     constructor();
     /** Switch a group's AND/OR connector and re-emit. No-op when disabled or unchanged. */
     setGroupLogic(group: QbGroup, logic: 'AND' | 'OR'): void;
@@ -71,12 +81,19 @@ export declare class SdQueryBuilder {
     setBetweenFrom(rule: QbRule, raw: any): void;
     /** Set the upper bound of a BETWEEN rule's `{ from, to }` value. */
     setBetweenTo(rule: QbRule, raw: any): void;
+    setValueSource(rule: QbRule, source: QbValueSource): void;
+    setCompareField(rule: QbRule, key: any): void;
     /** The field metadata for a rule's current `field` key (or undefined if unset). */
     fieldOf(rule: QbRule): SdQueryBuilderField | undefined;
     /** Operators allowed for a rule, derived from its field's type / override. */
     allowedOperators(rule: QbRule): Operator[];
     /** Whether to render the operator picker — hidden when only one operator is allowed. */
     showOperatorSelector(rule: QbRule): boolean;
+    compareFields(rule: QbRule): SdQueryBuilderField[];
+    canCompareWithField(rule: QbRule): boolean;
+    showValueSourceSelector(rule: QbRule): boolean;
+    valueSourceOf(rule: QbRule): QbValueSource;
+    isFieldSource(rule: QbRule): boolean;
     /** True for NULL / NOT_NULL — the template then renders no value editor. */
     isNoData(op: Operator | undefined): boolean;
     /** True for IN / NOT_IN — the template then renders a multi-select value editor. */
@@ -98,5 +115,5 @@ export declare class SdQueryBuilder {
     /** Build a `data-autoid` for an inner control under this builder's `autoId` prefix. */
     autoIdFor(suffix: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdQueryBuilder, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryBuilder, "sd-query-builder", never, { "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "rootLogic": { "alias": "rootLogic"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filters": "filtersChange"; "rootLogic": "rootLogicChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryBuilder, "sd-query-builder", never, { "option": { "alias": "option"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "comparisonMode": { "alias": "comparisonMode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "rootLogic": { "alias": "rootLogic"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filters": "filtersChange"; "rootLogic": "rootLogicChange"; }, never, never, true, never>;
 }

package/components/query-builder/src/query-builder.model.d.ts

@@ -1,4 +1,4 @@
-import { Operator } from '@sdcorejs/utils/models';
+import { DateRelative, Filter, Operator } from '@sdcorejs/utils/models';
 /** Field kinds the builder understands. Drives the operator set + value editor. */
 export type SdQueryBuilderFieldType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'values';
 /** One option for a `values`-type field (enum / lookup). */
@@ -19,6 +19,8 @@ export interface SdQueryBuilderField {
     label: string;
     /** Field type — picks the default operator set + value editor control. */
     type: SdQueryBuilderFieldType;
+    /** Material icon shown before the label in the field picker; falls back to `QB_TYPE_ICON[type]` then `'tune'`. */
+    icon?: string;
     /** Override the allowed operator set (otherwise `QB_OPERATORS_BY_TYPE[type]`). */
     operators?: Operator[];
     /** Override the starting operator (otherwise `QB_DEFAULT_OPERATOR_BY_TYPE[type]`). */
@@ -33,8 +35,29 @@ export interface SdQueryBuilderField {
     min?: number | string;
     /** Upper bound for number / date value editors. */
     max?: number | string;
+    /** Optional domain guard for field-to-field comparison candidates. */
+    compareGroup?: string;
+    /** Set false to hide this field from field-to-field comparison. */
+    allowFieldCompare?: boolean;
+}
+export interface SdQueryBuilderOption {
+    autoId?: string;
+    fields: SdQueryBuilderField[];
+    mode?: 'edit' | 'view';
+    comparisonMode?: QbComparisonMode;
+    disabled?: boolean;
+    value?: Filter | null;
+    filters?: Filter[];
+    rootLogic?: 'AND' | 'OR';
+    onValueChange?: (value: Filter | null) => void;
+    onFiltersChange?: (filters: Filter[]) => void;
+    onRootLogicChange?: (logic: 'AND' | 'OR') => void;
 }
 export type QbNode = QbGroup | QbRule;
+/** Component-level capability for right-hand operands. */
+export type QbComparisonMode = 'value-only' | 'value-or-field';
+/** Per-rule right-hand operand source. */
+export type QbValueSource = 'literal' | 'field';
 /** A logical group of nodes joined by AND / OR. Maps to `FilterAndOr`. */
 export interface QbGroup {
     id: string;
@@ -52,6 +75,10 @@ export interface QbRule {
     operator?: Operator;
     /** Single value, `{ from, to }` for BETWEEN, or an array for IN / NOT_IN. */
     value?: any;
+    /** Internal UI state: literal input or a same-type field reference. */
+    valueSource?: QbValueSource;
+    /** Right-hand field key when `valueSource` is `'field'`. */
+    compareField?: string;
 }
 /** Type guard — narrows a `QbNode` to a `QbGroup`. */
 export declare function isQbGroup(node: QbNode): node is QbGroup;
@@ -77,38 +104,59 @@ export declare function qbDefaultOperator(field: SdQueryBuilderField | undefined
 export declare function qbIsNoDataOperator(op: Operator | undefined): boolean;
 /** True when `op` is IN / NOT_IN (array value). */
 export declare function qbIsMultiOperator(op: Operator | undefined): boolean;
+/** True when the operator accepts one right-hand operand, including a field reference. */
+export declare function qbSupportsFieldCompareOperator(op: Operator | undefined): boolean;
+/**
+ * Icon fallback per field type when `SdQueryBuilderField.icon` is not set.
+ * Mirrors query-bar's `SD_QUERY_TYPE_ICON` so the two components read consistently,
+ * but kept local so query-builder has no dependency on the query-bar package.
+ */
+export declare const QB_TYPE_ICON: Record<SdQueryBuilderFieldType, string>;
+/**
+ * Icon shown before a field in the field picker / selected trigger.
+ * Priority: `field.icon` → `QB_TYPE_ICON[field.type]` → `'tune'` (default, like query-bar).
+ */
+export declare function qbFieldIcon(field: SdQueryBuilderField | undefined): string;
 /** Next stable node id with the given prefix. */
 export declare function qbId(prefix?: string): string;
 /** Build a fresh rule node (optionally pre-filled). */
-export declare function qbNewRule(field?: string, operator?: Operator, value?: any): QbRule;
+export declare function qbNewRule(field?: string, operator?: Operator, value?: any, valueSource?: QbValueSource, compareField?: string): QbRule;
 /** Build a fresh group node. */
 export declare function qbNewGroup(logic?: 'AND' | 'OR', children?: QbNode[]): QbGroup;
-/** Offset unit for a relative date. */
-export type SdQbRelativeUnit = 'day' | 'week' | 'month';
-/** Offset direction for a relative date. */
-export type SdQbRelativeDirection = 'previous' | 'next';
-/** A relative (resolved-at-query-time) date value stored in `Filter.data`. */
-export interface SdQbRelativeDate {
-    /** `'now'` = current moment / today · `'offset'` = now ± amount × unit. */
-    rel: 'now' | 'offset';
-    /** Offset unit — only for `rel: 'offset'`. */
-    unit?: SdQbRelativeUnit;
-    /** Offset magnitude (>= 1) — only for `rel: 'offset'`. */
-    amount?: number;
-    /** Offset direction — only for `rel: 'offset'`. */
-    direction?: SdQbRelativeDirection;
-}
+/** Offset unit for a relative date — re-exported from the utils `DateRelative` model. */
+export type SdQbRelativeUnit = DateRelative['unit'];
+/** Offset direction for a relative date — re-exported from the utils `DateRelative` model. */
+export type SdQbRelativeDirection = DateRelative['direction'];
+/** Sentinel held as a rule value (and emitted as `data`) for the "today" date mode. */
+export declare const QB_TODAY = "TODAY";
+/** The `'TODAY'` sentinel type (matches the utils `date-today` data literal). */
+export type QbToday = typeof QB_TODAY;
 /** Date value editor mode for a date/datetime rule (derived from the rule value). */
 export type QbDateMode = 'absolute' | 'now' | 'relative';
-/** Type guard — narrows an arbitrary value to a relative-date spec. */
-export declare function qbIsRelativeDate(v: any): v is SdQbRelativeDate;
+/** Type guard — narrows a rule value to a utils `DateRelative` (offset spec). */
+export declare const qbIsRelativeDate: (v: any) => v is DateRelative;
+/** Type guard — narrows a rule value to the `'TODAY'` sentinel ("now"/today mode). */
+export declare function qbIsToday(v: any): v is QbToday;
 /** Starting relative value when a rule first switches to "relative" mode. */
-export declare function qbDefaultRelative(): SdQbRelativeDate;
-/** Stable option list for the date-mode select (module ref — never reallocated). */
-export declare const QB_DATE_MODES: ReadonlyArray<{
+export declare function qbDefaultRelative(): DateRelative;
+/** One date-mode option — carries a Material icon shown in the dropdown + selected trigger. */
+export interface QbDateModeOption {
     value: QbDateMode;
     display: string;
-}>;
+    /** Material icon name (outlined set). */
+    icon: string;
+}
+/** Stable option list for the date-mode select (module ref — never reallocated). */
+export declare const QB_DATE_MODES: ReadonlyArray<QbDateModeOption>;
+/** One value-source option for field-to-field comparison UI. */
+export interface QbValueSourceOption {
+    value: QbValueSource;
+    display: string;
+    /** Material icon name (outlined set). */
+    icon: string;
+}
+/** Stable option list for choosing between a literal value and another field. */
+export declare const QB_VALUE_SOURCE_OPTIONS: ReadonlyArray<QbValueSourceOption>;
 /** Stable combined direction×unit option list (token `'unit:direction'`). */
 export declare const QB_RELATIVE_UNIT_OPTIONS: ReadonlyArray<{
     value: string;

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

@@ -7,11 +7,14 @@ export declare class SdSection {
     icon: import("@angular/core").InputSignal<string | null | undefined>;
     iconColor: import("@angular/core").InputSignal<Color>;
     collapsed: import("@angular/core").ModelSignal<boolean>;
+    collapsible: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** @deprecated Use `collapsible` instead. */
     collapsable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly isCollapsible: import("@angular/core").Signal<boolean>;
     hideHeader: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     noPaddingBody: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     constructor();
     toggleCollapse: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSection, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdSection, "sd-section", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subTitle": { "alias": "subTitle"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconColor": { "alias": "iconColor"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapsable": { "alias": "collapsable"; "required": false; "isSignal": true; }; "hideHeader": { "alias": "hideHeader"; "required": false; "isSignal": true; }; "noPaddingBody": { "alias": "noPaddingBody"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSection, "sd-section", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subTitle": { "alias": "subTitle"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconColor": { "alias": "iconColor"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "collapsable": { "alias": "collapsable"; "required": false; "isSignal": true; }; "hideHeader": { "alias": "hideHeader"; "required": false; "isSignal": true; }; "noPaddingBody": { "alias": "noPaddingBody"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[sdHeaderLeft]", "[sdHeaderRight]", "*"], true, never>;
 }

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

@@ -1,13 +1,19 @@
 import { SdSplitterPanelComponent } from './splitter-panel/splitter-panel.component';
-import { SplitterLayoutState, SplitterOrientation } from './splitter.models';
+import { SdSplitterOption, SplitterLayoutState, SplitterOrientation } from './splitter.models';
 import * as i0 from "@angular/core";
 export declare class SdSplitterComponent {
     #private;
+    option: import("@angular/core").InputSignal<SdSplitterOption | undefined>;
     orientation: import("@angular/core").InputSignal<SplitterOrientation>;
     disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     storageKey: import("@angular/core").InputSignal<string | undefined>;
     snapThreshold: import("@angular/core").InputSignalWithTransform<number, unknown>;
     keyboardStep: import("@angular/core").InputSignalWithTransform<number, unknown>;
+    resolvedOrientation: import("@angular/core").Signal<SplitterOrientation>;
+    resolvedDisabled: import("@angular/core").Signal<boolean>;
+    resolvedStorageKey: import("@angular/core").Signal<string | undefined>;
+    resolvedSnapThreshold: import("@angular/core").Signal<number>;
+    resolvedKeyboardStep: import("@angular/core").Signal<number>;
     readonly resizeEnd: import("@angular/core").OutputEmitterRef<SplitterLayoutState>;
     readonly collapsedChange: import("@angular/core").OutputEmitterRef<{
         panelId: string | number;
@@ -24,5 +30,5 @@ export declare class SdSplitterComponent {
     toggle(target: number | string): void;
     resizePanel(target: number | string, size: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdSplitterComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SdSplitterComponent, "sd-splitter", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "snapThreshold": { "alias": "snapThreshold"; "required": false; "isSignal": true; }; "keyboardStep": { "alias": "keyboardStep"; "required": false; "isSignal": true; }; }, { "resizeEnd": "resizeEnd"; "collapsedChange": "collapsedChange"; "layoutChange": "layoutChange"; }, ["panels"], ["sd-splitter-panel"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdSplitterComponent, "sd-splitter", never, { "option": { "alias": "option"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "snapThreshold": { "alias": "snapThreshold"; "required": false; "isSignal": true; }; "keyboardStep": { "alias": "keyboardStep"; "required": false; "isSignal": true; }; }, { "resizeEnd": "resizeEnd"; "collapsedChange": "collapsedChange"; "layoutChange": "layoutChange"; }, ["panels"], ["sd-splitter-panel"], true, never>;
 }

package/components/splitter/src/splitter.models.d.ts

@@ -10,6 +10,19 @@ export interface SplitterLayoutState {
     v: 1;
     panels: SplitterPanelState[];
 }
+export interface SdSplitterOption {
+    orientation?: SplitterOrientation;
+    disabled?: boolean;
+    storageKey?: string;
+    snapThreshold?: number;
+    keyboardStep?: number;
+    onResizeEnd?: (state: SplitterLayoutState) => void;
+    onCollapsedChange?: (event: {
+        panelId: string | number;
+        collapsed: boolean;
+    }) => void;
+    onLayoutChange?: (state: SplitterLayoutState) => void;
+}
 export interface ResolvedPanelMeta {
     id: string | number;
     index: number;

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

@@ -47,6 +47,8 @@ export interface SdTableOptionFilter<T = any> {
     /** Chế độ thủ công: phải nhấn nút áp dụng mới gửi filter */
     manualFilter?: boolean;
     /** Có thể thu gọn bộ lọc hay không */
+    collapsible?: boolean;
+    /** @deprecated Use `collapsible` instead. */
     collapsable?: boolean;
     /** Ẩn toolbar (xóa bộ lọc, thiết lập) của external filter, khi có ít external filter user không cần chức năng này */
     hideExternalFilterToolbar?: boolean;

package/components/tree/index.d.ts

@@ -0,0 +1,3 @@
+export * from './src/tree.component';
+export * from './src/tree-item-def.directive';
+export * from './src/tree.model';

package/components/tree/src/tree-item-def.directive.d.ts

@@ -0,0 +1,9 @@
+import { TemplateRef } from '@angular/core';
+import { SdTreeItemContext } from './tree.model';
+import * as i0 from "@angular/core";
+export declare class SdTreeItemDefDirective<T = any> {
+    static ngTemplateContextGuard<T>(_dir: SdTreeItemDefDirective<T>, ctx: unknown): ctx is SdTreeItemContext<T>;
+    readonly templateRef: TemplateRef<SdTreeItemContext<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdTreeItemDefDirective<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SdTreeItemDefDirective<any>, "[sdTreeItemDef]", never, {}, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,102 @@
+import { TemplateRef } from '@angular/core';
+import { SdTreeItemDefDirective } from './tree-item-def.directive';
+import { SdTreeCommand, SdTreeDataSource, SdTreeComponentOption, SdTreeItem, SdTreeItemContext, SdTreeNode, SdTreeOption, SdTreeSelectionAction, SdTreeSelectionEvent, SdTreeSelectorOption, SdTreeToggleEvent } from './tree.model';
+import * as i0 from "@angular/core";
+export type SdTreeAutoIdPart = 'row' | 'toggle' | 'checkbox' | 'icon' | 'label' | 'command';
+export interface SdTreeNodeAutoIds {
+    row?: string;
+    toggle?: string;
+    checkbox?: string;
+    icon?: string;
+    label?: string;
+    command?: string;
+}
+export interface SdTreeViewCommand<T = any> {
+    key: string;
+    command: SdTreeCommand<T>;
+    title: string;
+    icon: string;
+    color: SdTreeCommand<T>['color'];
+    fontSet: SdTreeCommand<T>['fontSet'];
+    disabled: boolean;
+    autoId?: string;
+    defaultColor: boolean;
+}
+export interface SdTreeViewNode<T = any> extends SdTreeNode<T> {
+    icon?: string;
+    selected: boolean;
+    selectionDisabled: boolean;
+    toggleDisabled: boolean;
+    toggleLabel: string;
+    ariaExpanded: boolean | null;
+    autoIds: SdTreeNodeAutoIds;
+    commands: SdTreeViewCommand<T>[];
+    context: SdTreeItemContext<T>;
+}
+export interface SdTreeSelectionActionView<T = any> {
+    action: SdTreeSelectionAction<T>;
+    autoId: string | null;
+}
+export declare class SdTree<T = any> {
+    #private;
+    readonly autoIdInput: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly option: import("@angular/core").InputSignal<SdTreeComponentOption<T> | undefined>;
+    /** Migration bridge. New usage should put the data source in `option.items`. */
+    readonly items: import("@angular/core").InputSignal<SdTreeDataSource<SdTreeItem<T>> | undefined>;
+    /** Migration bridge. New usage should put static/lazy config in `option.tree`. */
+    readonly tree: import("@angular/core").InputSignal<SdTreeOption<T> | undefined>;
+    readonly selectedItemsInput: import("@angular/core").InputSignal<T[] | null | undefined>;
+    readonly commands: import("@angular/core").InputSignal<SdTreeCommand<T>[] | null | undefined>;
+    readonly selectable: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly selector: import("@angular/core").InputSignal<SdTreeSelectorOption<T> | null | undefined>;
+    readonly itemTemplate: import("@angular/core").InputSignal<TemplateRef<SdTreeItemContext<T>> | null | undefined>;
+    readonly selectedItemsChange: import("@angular/core").OutputEmitterRef<T[]>;
+    readonly selectChange: import("@angular/core").OutputEmitterRef<SdTreeSelectionEvent<T>>;
+    readonly expandChange: import("@angular/core").OutputEmitterRef<SdTreeToggleEvent<T>>;
+    readonly collapseChange: import("@angular/core").OutputEmitterRef<SdTreeToggleEvent<T>>;
+    readonly itemDef: import("@angular/core").Signal<SdTreeItemDefDirective<any> | undefined>;
+    readonly resolvedItemsSource: import("@angular/core").Signal<SdTreeDataSource<SdTreeItem<T>>>;
+    readonly resolvedTree: import("@angular/core").Signal<SdTreeOption<T>>;
+    readonly resolvedSelector: import("@angular/core").Signal<SdTreeSelectorOption<T> | null | undefined>;
+    readonly resolvedCommands: import("@angular/core").Signal<SdTreeCommand<T>[]>;
+    readonly resolvedSelectable: import("@angular/core").Signal<boolean>;
+    readonly autoId: import("@angular/core").Signal<string | undefined>;
+    readonly resolvedItemTemplate: import("@angular/core").Signal<TemplateRef<SdTreeItemContext<T>> | undefined>;
+    readonly indentSize: import("@angular/core").Signal<number>;
+    readonly normalizedFilterText: import("@angular/core").Signal<string>;
+    readonly selectionVisible: import("@angular/core").Signal<boolean>;
+    readonly selectedIdSet: import("@angular/core").Signal<Set<string>>;
+    readonly rootNodes: import("@angular/core").Signal<SdTreeNode<T>[]>;
+    readonly visibleNodes: import("@angular/core").Signal<SdTreeNode<T>[]>;
+    readonly selectedItems: import("@angular/core").Signal<T[]>;
+    readonly selectedCount: import("@angular/core").Signal<number>;
+    readonly selectionMessage: import("@angular/core").Signal<string>;
+    readonly visibleSelectionActions: import("@angular/core").Signal<SdTreeSelectionAction<T>[]>;
+    readonly selectionActionViews: import("@angular/core").Signal<SdTreeSelectionActionView<T>[]>;
+    readonly clearSelectionAutoId: import("@angular/core").Signal<string | null>;
+    /**
+     * Template-facing row model. Expensive/variable values are resolved once per
+     * signal recomputation so the HTML does not call helper methods for every CD pass.
+     */
+    readonly visibleViewNodes: import("@angular/core").Signal<SdTreeViewNode<T>[]>;
+    readonly trackByNode: (_index: number, node: SdTreeNode<T>) => string;
+    constructor();
+    reload(): void;
+    filter(searchText: string | undefined | null): void;
+    isSelected(node: SdTreeNode<T>): boolean;
+    nodeIcon(node: SdTreeNode<T>): string | undefined;
+    visibleCommands(node: SdTreeNode<T>): SdTreeCommand<T>[];
+    isSelectionDisabled(node: SdTreeNode<T>): boolean;
+    commandTitle(command: SdTreeCommand<T>, item: T): string;
+    commandIcon(command: SdTreeCommand<T>, item: T): string;
+    isCommandDisabled(command: SdTreeCommand<T>, item: T): boolean;
+    toggle(node: SdTreeNode<T>, event?: Event): Promise<void>;
+    toggleSelection(node: SdTreeNode<T>, event?: Event): void;
+    clearSelection(): void;
+    onSelectionAction(action: SdTreeSelectionAction<T>): void;
+    createContext(node: SdTreeNode<T>): SdTreeItemContext<T>;
+    nodeAutoId(node: SdTreeNode<T>, part: SdTreeAutoIdPart): string | undefined;
+    commandAutoId(node: SdTreeNode<T>, command: SdTreeCommand<T>): string | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdTree<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdTree<any>, "sd-tree", never, { "autoIdInput": { "alias": "autoId"; "required": false; "isSignal": true; }; "option": { "alias": "option"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "selectedItemsInput": { "alias": "selectedItems"; "required": false; "isSignal": true; }; "commands": { "alias": "commands"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selector": { "alias": "selector"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; }, { "selectedItemsChange": "selectedItemsChange"; "selectChange": "selectChange"; "expandChange": "expandChange"; "collapseChange": "collapseChange"; }, ["itemDef"], never, true, never>;
+}