@sdcorejs/angular 19.1.5 → 19.2.0

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

@@ -11,17 +11,21 @@ import * as i0 from "@angular/core";
  * immediately before Search so the user sees one filter-cluster on the right.
  */
 export declare class SdQueryActionsBar {
+    #private;
     readonly showLogicToggle: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly logic: import("@angular/core").ModelSignal<SdQueryLogic>;
     readonly filtersCount: import("@angular/core").InputSignal<number>;
     readonly showSavedFilters: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly savedFiltersKey: import("@angular/core").InputSignal<string | undefined>;
-    readonly query: import("@angular/core").InputSignal<SdQuery<any>>;
-    readonly applyFilter: import("@angular/core").OutputEmitterRef<SdSavedFilter<any>>;
+    readonly query: import("@angular/core").InputSignal<SdQuery<unknown>>;
+    readonly applyFilter: import("@angular/core").OutputEmitterRef<SdSavedFilter<unknown>>;
     readonly showClearAll: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     readonly clear: import("@angular/core").OutputEmitterRef<void>;
     readonly canSearch: import("@angular/core").InputSignal<boolean>;
     readonly search: import("@angular/core").OutputEmitterRef<void>;
+    readonly logicGroupLabel: import("@angular/core").Signal<string>;
+    readonly clearAllLabel: import("@angular/core").Signal<string>;
+    readonly searchLabel: import("@angular/core").Signal<string>;
     setLogic(value: SdQueryLogic): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdQueryActionsBar, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SdQueryActionsBar, "sd-query-actions-bar", never, { "showLogicToggle": { "alias": "showLogicToggle"; "required": false; "isSignal": true; }; "logic": { "alias": "logic"; "required": false; "isSignal": true; }; "filtersCount": { "alias": "filtersCount"; "required": false; "isSignal": true; }; "showSavedFilters": { "alias": "showSavedFilters"; "required": false; "isSignal": true; }; "savedFiltersKey": { "alias": "savedFiltersKey"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "showClearAll": { "alias": "showClearAll"; "required": false; "isSignal": true; }; "canSearch": { "alias": "canSearch"; "required": false; "isSignal": true; }; }, { "logic": "logicChange"; "applyFilter": "applyFilter"; "clear": "clear"; "search": "search"; }, never, never, true, never>;

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

@@ -17,8 +17,11 @@ type Density = 'compact' | 'comfortable';
  *    operator step, disabled badge in value step) + the per-type picker + × cancel.
  */
 export declare class SdQueryBuildChip {
+    #private;
+    readonly booleanTrueLabel: import("@angular/core").Signal<string>;
+    readonly booleanFalseLabel: import("@angular/core").Signal<string>;
     /** Current build state — drives every visual branch. */
-    readonly building: import("@angular/core").InputSignal<BuildingChip<any>>;
+    readonly building: import("@angular/core").InputSignal<BuildingChip<unknown>>;
     /** Density preset — forwarded to the seamless chip + sizes the .c-token row. */
     readonly density: import("@angular/core").InputSignal<Density>;
     /** Operator set offered in the operator-step menu (parent's `allowedOperatorsFor(field)`). */

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

@@ -18,6 +18,14 @@ import * as i0 from "@angular/core";
  */
 export declare class SdQueryChipPopover {
     #private;
+    readonly swapFieldTooltip: import("@angular/core").Signal<string>;
+    readonly fromPlaceholder: import("@angular/core").Signal<string>;
+    readonly toPlaceholder: import("@angular/core").Signal<string>;
+    readonly booleanTrueLabel: import("@angular/core").Signal<string>;
+    readonly booleanFalseLabel: import("@angular/core").Signal<string>;
+    readonly selectValuePlaceholder: import("@angular/core").Signal<string>;
+    readonly enterValuePlaceholder: import("@angular/core").Signal<string>;
+    readonly loadingValuesLabel: import("@angular/core").Signal<string>;
     /** Resolved field of the currently editing chip — parent passes from `fieldByKey()`. */
     readonly field: import("@angular/core").InputSignal<SdQueryField | undefined>;
     /** The chip's current Filter — used by `seed()` for initial staging values. */

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

@@ -14,6 +14,8 @@ import * as i0 from "@angular/core";
  * chosen field through `(pick)`.
  */
 export declare class SdQueryFieldPicker {
+    #private;
+    readonly emptyLabel: import("@angular/core").Signal<string>;
     /** Field list shown in the menu (caller-supplied; rendered in input order). */
     readonly fields: import("@angular/core").InputSignal<SdQueryField[]>;
     /** Single key disabled with a trailing check — used in the chip-popover "Đổi field" flow. */

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

@@ -20,6 +20,8 @@ type Density = 'compact' | 'comfortable';
  */
 export declare class SdQueryInlineChip {
     #private;
+    readonly booleanTrueLabel: import("@angular/core").Signal<string>;
+    readonly booleanFalseLabel: import("@angular/core").Signal<string>;
     /** Resolved field — parent passes it (no lookup needed inside). */
     readonly field: import("@angular/core").InputSignal<SdQueryField>;
     /** The chip's Filter — used for `data` + `operator`. */

package/components/query-bar/src/components/inline-value-chip/inline-value-chip.component.d.ts

@@ -43,9 +43,9 @@ export declare class SdQueryInlineValueChip {
     readonly isBetween: import("@angular/core").Signal<boolean>;
     readonly isNoData: import("@angular/core").Signal<boolean>;
     readonly icon: import("@angular/core").Signal<string>;
-    readonly ph: import("@angular/core").Signal<"giá trị" | "nhập…">;
-    readonly phFrom: import("@angular/core").Signal<"Từ" | "từ…">;
-    readonly phTo: import("@angular/core").Signal<"Đến" | "đến…">;
+    readonly ph: import("@angular/core").Signal<string>;
+    readonly phFrom: import("@angular/core").Signal<string>;
+    readonly phTo: import("@angular/core").Signal<string>;
     readonly hasValue: import("@angular/core").Signal<boolean>;
     readonly state: import("@angular/core").Signal<ChipState>;
     constructor();

package/components/query-bar/src/components/saved-filters-menu/saved-filters-menu.component.d.ts

@@ -17,19 +17,24 @@ import * as i0 from "@angular/core";
  */
 export declare class SdQuerySavedFiltersMenu {
     #private;
+    readonly tooltipLabel: import("@angular/core").Signal<string>;
+    readonly tooltipDisabledLabel: import("@angular/core").Signal<string>;
+    readonly deleteLabel: import("@angular/core").Signal<string>;
+    readonly emptyLabel: import("@angular/core").Signal<string>;
+    readonly saveLabel: import("@angular/core").Signal<string>;
     /** Namespace key used to scope localStorage. `undefined` → menu disabled. */
     readonly key: import("@angular/core").InputSignal<string | undefined>;
     /** Current query the host wants to snapshot when the user clicks "Save current". */
-    readonly query: import("@angular/core").InputSignal<SdQuery<any>>;
+    readonly query: import("@angular/core").InputSignal<SdQuery<unknown>>;
     /** Fired when the user picks a saved filter from the list. */
-    readonly apply: import("@angular/core").OutputEmitterRef<SdSavedFilter<any>>;
-    readonly savedFilters: import("@angular/core").WritableSignal<SdSavedFilter<any>[]>;
+    readonly apply: import("@angular/core").OutputEmitterRef<SdSavedFilter<unknown>>;
+    readonly savedFilters: import("@angular/core").WritableSignal<SdSavedFilter<unknown>[]>;
     /**
      * Prompt for a name and append a snapshot of the current query as a new
      * saved filter. Public so the parent toolbar can wire its external "save"
      * button to this method without re-implementing persistence.
      */
-    promptSave(): void;
+    promptSave(): Promise<void>;
     /** Apply a saved filter — host re-installs filters/logic/search via `(apply)`. */
     pick(filter: SdSavedFilter): void;
     /** Delete a saved filter by id. Stops propagation so the parent button doesn't fire `pick`. */

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

@@ -13,7 +13,7 @@ export declare class SdQueryBar {
     /** 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>;
+    readonly option: import("@angular/core").InputSignal<SdQueryBarOption<unknown> | 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. */
@@ -54,7 +54,7 @@ export declare class SdQueryBar {
      * Snapshot of the current query — fed into `<sd-query-saved-filters-menu [query]>` so
      * saving a filter captures live filters/logic/search.
      */
-    readonly currentQuery: import("@angular/core").Signal<SdQuery<any>>;
+    readonly currentQuery: import("@angular/core").Signal<SdQuery<unknown>>;
     /** Receive an applied filter from the saved-filters menu — re-install bar state + trigger apply. */
     onApplyFilter(saved: SdSavedFilter): void;
     /** Show AND/OR segmented toggle (renders only when there are ≥2 filters). */
@@ -64,9 +64,15 @@ export declare class SdQueryBar {
     /** Render the operator label on the chip face (default: hidden — operator only visible in popover). */
     readonly showOperatorOnChip: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     /** Composite payload — emitted whenever filters / logic / search change. */
-    readonly queryChange: import("@angular/core").OutputEmitterRef<SdQuery<any>>;
+    readonly queryChange: import("@angular/core").OutputEmitterRef<SdQuery<unknown>>;
     /** Fires when the user presses "Áp dụng" inside a chip popover — host should reload data. */
-    readonly apply: import("@angular/core").OutputEmitterRef<SdQuery<any>>;
+    readonly apply: import("@angular/core").OutputEmitterRef<SdQuery<unknown>>;
+    /** Placeholder của ô tìm kiếm tự do bên trái. */
+    readonly searchPlaceholder: import("@angular/core").Signal<string>;
+    /** Tooltip nút "+" khi consumer chưa khai `fields`. */
+    readonly noFieldsLabel: import("@angular/core").Signal<string>;
+    /** Tooltip nút "+" ở trạng thái bình thường. */
+    readonly addFilterLabel: import("@angular/core").Signal<string>;
     /** 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[]>;
@@ -96,13 +102,34 @@ export declare class SdQueryBar {
      * popover-mode chips read `multiple()` from the child popover directly.
      */
     multiple(op: Operator): boolean;
+    /**
+     * Stable track key of a filter row. Assigned lazily on first read.
+     *
+     * ⚠️ Hai ràng buộc với `filters`, đều là hợp đồng của consumer:
+     *
+     * 1. KHÔNG được chứa cùng một object `Filter` ở hai vị trí. Khoá theo identity nên hai vị trí sẽ
+     *    cho hai track key trùng nhau và Angular ném NG0955. Đã thử khử trùng bằng hậu tố `$index`
+     *    và HỎNG: Angular đánh giá biểu thức `track` trên CẢ collection cũ khi diff, nên một filter
+     *    vừa bị xoá cho `indexOf === -1`, key đổi, và MỌI chip bị huỷ rồi dựng lại. Để Angular báo
+     *    NG0955 là đúng — thông điệp của nó đã chỉ rõ vấn đề.
+     * 2. Object phải ỔN ĐỊNH giữa các lần change detection. Sinh lại object mới mỗi pass
+     *    (vd `[option]="{ filters: buildFilters() }"`) sẽ khiến mọi chip nhận id mới mỗi pass và bị
+     *    huỷ + dựng lại — tệ hơn cả `track $index` cũ.
+     */
+    rowId(filter: Filter): string;
     readonly iconFor: typeof sdQueryFieldIcon;
     /** Chip is "active" when it has a non-empty value OR a no-data operator (NULL/NOT_NULL). */
     isFilterActive(filter: Filter): boolean;
     /** Rendered value text on a chip. */
     chipValueText(filter: Filter): string;
     isNoDataOperator(op: Operator | string): boolean;
-    readonly building: import("@angular/core").Signal<BuildingChip<any> | null>;
+    readonly building: import("@angular/core").Signal<BuildingChip<unknown> | null>;
+    /**
+     * Allowed operators of `field` — safe to call from a template binding: `sdQueryAllowedOperators`
+     * memo hoá theo object field nên ref trả về ổn định giữa các chu kỳ CD.
+     * why: `<sd-query-build-chip [allowedOperators]>` là OnPush; ref mới mỗi CD sẽ dirty child liên
+     * tục (bug class cấp-phát-mỗi-CD).
+     */
     allowedOperatorsFor(field: SdQueryField): Operator[];
     inlineAutoId(index: number, role: string): string;
     /** Entry point from the field picker — start building a chip for `field`. */

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

@@ -2,7 +2,7 @@ import { Signal } from '@angular/core';
 import { SdSearch } from '@sdcorejs/angular/forms/models';
 import { Filter, NestedKeyOf, Operator } from '@sdcorejs/utils/models';
 export type SdQueryFieldType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'values' | 'lazy-values';
-interface SdQueryFieldBase<T = any> {
+interface SdQueryFieldBase<T = unknown> {
     /** Dot-notation field path (matches `Filter.field`). */
     key: NestedKeyOf<T>;
     /** Human-readable label shown on chip + field picker. */
@@ -27,10 +27,10 @@ interface SdQueryFieldBase<T = any> {
     /** Field is offered in picker but not interactive (read-only badge in chip). */
     disabled?: boolean;
 }
-export interface SdQueryFieldString<T = any> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldString<T = unknown> extends SdQueryFieldBase<T> {
     type: 'string';
 }
-export interface SdQueryFieldNumber<T = any> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldNumber<T = unknown> extends SdQueryFieldBase<T> {
     type: 'number';
     /** Bounds for the input control inside the chip popover. */
     min?: number;
@@ -38,13 +38,13 @@ export interface SdQueryFieldNumber<T = any> extends SdQueryFieldBase<T> {
     /** Step for the number input. */
     step?: number;
 }
-export interface SdQueryFieldBoolean<T = any> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldBoolean<T = unknown> extends SdQueryFieldBase<T> {
     type: 'boolean';
     /** Labels rendered for the true/false buttons. Default: "Có" / "Không". */
     trueLabel?: string;
     falseLabel?: string;
 }
-export interface SdQueryFieldDate<T = any> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldDate<T = unknown> extends SdQueryFieldBase<T> {
     type: 'date' | 'datetime';
     /** Restrict the picker calendar to this range. */
     min?: Date | string;
@@ -54,7 +54,7 @@ export interface SdQueryFieldDate<T = any> extends SdQueryFieldBase<T> {
  * Statically-known options (sync array, signal, or one-shot promise).
  * Mirrors `SdTableColumnValues.option`.
  */
-export interface SdQueryFieldValues<T = any, K = Record<string, any>> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldValues<T = unknown, K = Record<string, any>> extends SdQueryFieldBase<T> {
     type: 'values';
     option: {
         items: K[] | Signal<K[]> | (() => Promise<K[]>);
@@ -68,7 +68,7 @@ export interface SdQueryFieldValues<T = any, K = Record<string, any>> extends Sd
  * `{ type: 'SEARCH', searchText }` for live queries and `{ type: 'VALUE', value }` for
  * resolving chip-display labels of already-selected IDs.
  */
-export interface SdQueryFieldLazyValues<T = any, K = Record<string, any>> extends SdQueryFieldBase<T> {
+export interface SdQueryFieldLazyValues<T = unknown, K = Record<string, any>> extends SdQueryFieldBase<T> {
     type: 'lazy-values';
     option: {
         search: SdSearch<K>;
@@ -76,16 +76,16 @@ export interface SdQueryFieldLazyValues<T = any, K = Record<string, any>> extend
         displayField: NestedKeyOf<K>;
     };
 }
-export type SdQueryField<T = any> = SdQueryFieldString<T> | SdQueryFieldNumber<T> | SdQueryFieldBoolean<T> | SdQueryFieldDate<T> | SdQueryFieldValues<T> | SdQueryFieldLazyValues<T>;
+export type SdQueryField<T = unknown> = SdQueryFieldString<T> | SdQueryFieldNumber<T> | SdQueryFieldBoolean<T> | SdQueryFieldDate<T> | SdQueryFieldValues<T> | SdQueryFieldLazyValues<T>;
 export type SdQueryLogic = 'AND' | 'OR';
-export interface SdQuery<T = any> {
+export interface SdQuery<T = unknown> {
     filters: Filter<T>[];
     /** Global connector between filters. Defaults to `'AND'`. */
     logic?: SdQueryLogic;
     /** Free-text search box (only present when `showSearch=true`). */
     search?: string;
 }
-export interface SdQueryBarOption<T = any> {
+export interface SdQueryBarOption<T = unknown> {
     /** Prefix for auto-generated `data-autoid` on inner controls. */
     autoId?: string;
     /** Available fields the user can filter by. */
@@ -108,7 +108,7 @@ export interface SdQueryBarOption<T = any> {
     onApply?: (query: SdQuery<T>) => void;
 }
 /** Persisted bookmark of a query (filters + logic + search) — managed by `[savedFiltersKey]`. */
-export interface SdSavedFilter<T = any> {
+export interface SdSavedFilter<T = unknown> {
     id: string;
     name: string;
     query: SdQuery<T>;
@@ -120,7 +120,7 @@ export interface SdSavedFilter<T = any> {
  *   - 'operator' — operator menu open, waiting for the user to pick a condition
  *   - 'value'    — operator locked, value picker / seamless input is the focus
  */
-export interface BuildingChip<T = any> {
+export interface BuildingChip<T = unknown> {
     field: SdQueryField<T>;
     operator?: Operator;
     step: 'operator' | 'value';
@@ -148,6 +148,9 @@ export declare function sdQueryDefaultOperator(field: SdQueryField): Operator;
  * - `operators === true` → full set for the type
  * - `operators` is an array → that array (deduped against the type set is the caller's job)
  * - otherwise (simple mode) → just the single default operator (no real choice)
+ *
+ * The returned array is referentially stable for a given `field` object, so it is safe to call
+ * straight from a template binding.
  */
 export declare function sdQueryAllowedOperators(field: SdQueryField): Operator[];
 /**

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

@@ -1,5 +1,5 @@
 import { Filter, Operator } from '@sdcorejs/utils/models';
-import { isQbGroup, QbComparisonMode, QbDateMode, QbGroup, QbRule, QbToken, QbValueSource, qbFieldIcon, SdQueryBuilderField, SdQueryBuilderFieldOption, SdQueryBuilderOption } from './query-builder.model';
+import { sdIsQbGroup, SdQbComparisonMode, SdQbDateMode, SdQbGroup, SdQbRule, SdQbToken, SdQbValueSource, sdQbFieldIcon, SdQueryBuilderField, SdQueryBuilderFieldOption, SdQueryBuilderOption } from './query-builder.model';
 import * as i0 from "@angular/core";
 /**
  * Visual filter / rule builder. Compose nested AND / OR groups of
@@ -17,7 +17,7 @@ export declare class SdQueryBuilder {
     /** `'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>;
+    readonly comparisonMode: import("@angular/core").InputSignal<SdQbComparisonMode>;
     /** Disable all editing controls. */
     readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     /** Prefix for `data-autoid` on inner controls (E2E selectors). */
@@ -28,42 +28,64 @@ export declare class SdQueryBuilder {
     readonly filters: import("@angular/core").ModelSignal<Filter[]>;
     /** Root group's logical connector. `[(rootLogic)]`. */
     readonly rootLogic: import("@angular/core").ModelSignal<"AND" | "OR">;
-    readonly tree: import("@angular/core").Signal<QbGroup>;
+    readonly tree: import("@angular/core").Signal<SdQbGroup>;
     /** `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 resolvedComparisonMode: import("@angular/core").Signal<SdQbComparisonMode>;
     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: import("@sdcorejs/angular/components/query-builder").QbDateModeOption[];
+    readonly dateModes: import("@angular/core").Signal<{
+        display: string;
+        value: SdQbDateMode;
+        labelKey: string;
+        icon: string;
+    }[]>;
     /** Stable option list for the literal-vs-field operand select. */
-    readonly valueSourceOptions: import("@sdcorejs/angular/components/query-builder").QbValueSourceOption[];
+    readonly valueSourceOptions: import("@angular/core").Signal<{
+        display: string;
+        value: SdQbValueSource;
+        labelKey: string;
+        icon: string;
+    }[]>;
     /** Stable combined unit×direction option list for the relative select. */
-    readonly relativeUnitOptions: {
-        value: string;
+    readonly relativeUnitOptions: import("@angular/core").Signal<{
         display: string;
-    }[];
-    /** View-mode token stream — recomputed from the emitted value. */
-    readonly tokens: import("@angular/core").Signal<QbToken[]>;
+        value: string;
+        labelKey: string;
+    }[]>;
+    readonly selectFieldLabel: import("@angular/core").Signal<string>;
+    readonly valueLabel: import("@angular/core").Signal<string>;
+    readonly fromLabel: import("@angular/core").Signal<string>;
+    readonly toLabel: import("@angular/core").Signal<string>;
+    readonly addLabel: import("@angular/core").Signal<string>;
+    readonly addNodeLabel: import("@angular/core").Signal<string>;
+    readonly conditionLabel: import("@angular/core").Signal<string>;
+    readonly groupLabel: import("@angular/core").Signal<string>;
+    readonly removeGroupLabel: import("@angular/core").Signal<string>;
+    readonly removeConditionLabel: import("@angular/core").Signal<string>;
+    readonly emptyLabel: import("@angular/core").Signal<string>;
+    /** View-mode token stream — recomputed from the emitted value (and from the active language). */
+    readonly tokens: import("@angular/core").Signal<SdQbToken[]>;
     readonly isView: import("@angular/core").Signal<boolean>;
     /** Expose the type-guard to the template. */
-    readonly isGroup: typeof isQbGroup;
+    readonly isGroup: typeof sdIsQbGroup;
     /** Resolve the leading icon for a field (own `icon` → per-type → `'tune'`) — used by the field picker. */
-    readonly fieldIcon: typeof qbFieldIcon;
+    readonly fieldIcon: typeof sdQbFieldIcon;
     constructor();
     /** Switch a group's AND/OR connector and re-emit. No-op when disabled or unchanged. */
-    setGroupLogic(group: QbGroup, logic: 'AND' | 'OR'): void;
+    setGroupLogic(group: SdQbGroup, logic: 'AND' | 'OR'): void;
     /** Open this group's "+" menu (closing any other open one). UI-only — does not emit. */
-    toggleDropdown(group: QbGroup, event: Event): void;
+    toggleDropdown(group: SdQbGroup, event: Event): void;
     closeAllDropdowns(): void;
     /** Append a blank rule to `group`. */
-    addRule(group: QbGroup): void;
+    addRule(group: SdQbGroup): void;
     /** Append a nested sub-group (seeded with one blank rule) to `group`. */
-    addGroup(group: QbGroup): void;
+    addGroup(group: SdQbGroup): void;
     /** Remove the child at `index` from `parent` (a rule or a whole sub-group). */
-    removeNode(parent: QbGroup, index: number): void;
+    removeNode(parent: SdQbGroup, index: number): void;
     /**
      * Point `rule` at a new field. Resets operator to the field's default and the value
      * to that operator's empty shape — the old operator/value rarely fit the new type.
@@ -72,46 +94,61 @@ export declare class SdQueryBuilder {
      * @param key - the chosen field key (from the field picker). Swap-only: a null / undefined
      *   key is a no-op — the field can be changed but never cleared (issue #2).
      */
-    setField(rule: QbRule, key: any): void;
+    setField(rule: SdQbRule, key: any): void;
     /** Change `rule`'s operator and reshape its value to fit the new operator (array / range / none). */
-    setOperator(rule: QbRule, op: Operator | undefined): void;
+    setOperator(rule: SdQbRule, op: Operator | undefined): void;
     /** Set a single-value rule's value (coercing numeric fields to `number`). */
-    setScalar(rule: QbRule, raw: any): void;
+    setScalar(rule: SdQbRule, raw: any): void;
     /** Set the lower bound of a BETWEEN rule's `{ from, to }` value. */
-    setBetweenFrom(rule: QbRule, raw: any): void;
+    setBetweenFrom(rule: SdQbRule, 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: unknown): void;
-    setCompareField(rule: QbRule, key: any): void;
+    setBetweenTo(rule: SdQbRule, raw: any): void;
+    setValueSource(rule: SdQbRule, source: unknown): void;
+    setCompareField(rule: SdQbRule, key: any): void;
     /** The field metadata for a rule's current `field` key (or undefined if unset). */
-    fieldOf(rule: QbRule): SdQueryBuilderField | undefined;
+    fieldOf(rule: SdQbRule): SdQueryBuilderField | undefined;
     /** Operators allowed for a rule, derived from its field's type / override. */
-    allowedOperators(rule: QbRule): Operator[];
+    allowedOperators(rule: SdQbRule): 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;
+    showOperatorSelector(rule: SdQbRule): boolean;
+    compareFields(rule: SdQbRule): SdQueryBuilderField[];
+    canCompareWithField(rule: SdQbRule): boolean;
+    showValueSourceSelector(rule: SdQbRule): boolean;
+    valueSourceOf(rule: SdQbRule): SdQbValueSource;
+    isFieldSource(rule: SdQbRule): 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. */
     isMulti(op: Operator | undefined): boolean;
     /** `[true/false]` option list for a boolean field's value select (stable reference). */
     booleanItems(field: SdQueryBuilderField): SdQueryBuilderFieldOption[];
+    /**
+     * Option list cho field `type:'values'`.
+     *
+     * why: template cũ bind thẳng `[items]="fieldOf(rule)!.values || []"`. `values` là OPTIONAL trên
+     * `SdQueryBuilderField`, nên với field khai thiếu `values`, nhánh `|| []` cấp phát một mảng MỚI
+     * mỗi lần change detection chạy — đúng nguyên nhân OOM đã ghi ở `#booleanOptionsByKey`:
+     * `sd-select` có `toObservable(items)` → `markForCheck()` → CD mới → mảng mới → lặp vô hạn.
+     *
+     * why: KHÔNG memo hoá qua `computed<Map>` snapshot. `field.values` vốn ĐÃ là mảng của consumer
+     * nên tự nó ổn định; snapshot vào Map chỉ thêm một tầng cache không bao giờ invalidate khi
+     * consumer nạp option bất đồng bộ bằng cách gán tại chỗ (`fields[0].values = loaded`) — reference
+     * `fields` không đổi nên `computed` giữ nguyên list cũ vĩnh viễn. Chỉ nhánh RỖNG cần hằng số
+     * dùng chung để tránh literal mới mỗi CD.
+     */
+    valueItems(field: SdQueryBuilderField): SdQueryBuilderFieldOption[];
     /** Current date-value mode of a rule, derived from its value (no separate state). */
-    dateMode(rule: QbRule): QbDateMode;
+    dateMode(rule: SdQbRule): SdQbDateMode;
     /** Switch a date/datetime rule's value mode, reseeding the value for the new mode. */
-    setDateMode(rule: QbRule, mode: unknown): void;
+    setDateMode(rule: SdQbRule, mode: unknown): void;
     /** Read the offset amount of a relative rule (default 1). */
-    relativeAmount(rule: QbRule): number;
+    relativeAmount(rule: SdQbRule): number;
     /** Set the offset amount (clamped to an integer >= 1). */
-    setRelativeAmount(rule: QbRule, raw: any): void;
+    setRelativeAmount(rule: SdQbRule, raw: any): void;
     /** Read the `'unit:direction'` token of a relative rule (default `'day:previous'`). */
-    relativeUnitDirValue(rule: QbRule): string;
+    relativeUnitDirValue(rule: SdQbRule): string;
     /** Set the offset unit + direction from a `'unit:direction'` token. */
-    setRelativeUnitDir(rule: QbRule, token: unknown): void;
+    setRelativeUnitDir(rule: SdQbRule, token: unknown): void;
     /** Build a `data-autoid` for an inner control under this builder's `autoId` prefix. */
     autoIdFor(suffix: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<SdQueryBuilder, never>;