@sdcorejs/angular 19.1.6 → 19.2.1

package/components/api-contract-builder/src/api-contract.validation.d.ts

@@ -0,0 +1,12 @@
+import { type SdApiContractConfiguration } from './api-contract.configuration';
+import { type SdApiContractDiagnostic } from './api-contract.model';
+/**
+ * Validates a contract against the grammar, the schema rules, the REST rules and the injected env
+ * catalog.
+ *
+ * Pure and UI-free: it takes `unknown` because an externally supplied contract may be malformed,
+ * and it **never repairs anything** — a silent fix would hide the very mistake the author needs to
+ * see. Diagnostics come back in a fixed traversal order (metadata → `input` → `req` → `res` →
+ * `output`, declaration order within each), so the same contract always yields the same list.
+ */
+export declare function validateSdApiContract(contract: unknown, configuration?: SdApiContractConfiguration): SdApiContractDiagnostic[];

package/components/api-contract-builder/src/components/api-contract-diagnostic-list.component.d.ts

@@ -0,0 +1,18 @@
+import type { SdApiContractDiagnostic } from '../api-contract.model';
+import * as i0 from "@angular/core";
+/**
+ * Validation summary + the diagnostic list.
+ *
+ * Severity is never signalled by colour alone: every row carries an icon, the severity word, the
+ * stable `code` and the structural `path`, so the list stays readable for a colour-blind reader and
+ * usable from a screen reader.
+ */
+export declare class SdApiContractDiagnosticList {
+    diagnostics: import("@angular/core").InputSignal<readonly SdApiContractDiagnostic[]>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    navigate: import("@angular/core").OutputEmitterRef<SdApiContractDiagnostic>;
+    protected readonly errorCount: import("@angular/core").Signal<number>;
+    protected readonly warningCount: import("@angular/core").Signal<number>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractDiagnosticList, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractDiagnosticList, "sd-api-contract-diagnostic-list", never, { "diagnostics": { "alias": "diagnostics"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
+}

package/components/api-contract-builder/src/components/api-contract-node-drawer.component.d.ts

@@ -0,0 +1,130 @@
+import { SdSideDrawer } from '@sdcorejs/angular/components/side-drawer';
+import { type SdApiContractDataType } from '../api-contract.model';
+import { type SdApiContractStructuralNode } from '../api-contract.schema';
+import type { SdApiContractSuggestion } from './api-contract-suggestion.model';
+import * as i0 from "@angular/core";
+/** What the drawer hands back when the author closes the books on one node. */
+export interface SdApiContractNodeCommit {
+    name: string;
+    node: SdApiContractStructuralNode;
+}
+/**
+ * A layer list asking for the drawer to be opened.
+ *
+ * The list does not own the drawer — the builder does, so there is exactly one drawer and one staged
+ * draft on the page. The list only says which node the author reached for; the builder knows which
+ * section that list was wired into and applies the commit there.
+ */
+export interface SdApiContractNodeEditRequest {
+    /** `null` means "add a new node to this collection". */
+    name: string | null;
+    node: SdApiContractStructuralNode | null;
+    /** Names already taken at this level, so the drawer can refuse a duplicate. */
+    siblingNames: readonly string[];
+    /**
+     * Where the listed collection sits inside its layer root — `[]` for an object layer, `['items']`
+     * for an array layer whose fields belong to the element.
+     *
+     * why cần: drawer không dùng field này, nhưng builder thì có. Một tầng `array` (vd `output.schema`
+     * nhận `${res.body.items}`) khai field ở `items.properties`, còn tầng `object` khai ở `properties`.
+     * Danh sách đã biết mình đang đọc chỗ nào, nên nó nói ra thay vì để builder đoán lại.
+     */
+    pointer?: readonly string[];
+}
+interface SdApiContractOption {
+    value: string;
+    label: string;
+}
+/**
+ * Editing surface for exactly one node, staged and committed in one go.
+ *
+ * The layer lists outside are read-only, so this drawer is the only place a node changes. It holds a
+ * DEEP COPY of the node it was seeded from and emits `nodeCommit` once, when the author saves — that
+ * is what makes "Huỷ" able to actually cancel, and what keeps the tree from changing under the
+ * author's cursor on every keystroke.
+ *
+ * Save is blocked only for the two problems that stop a node from existing at all: no name, or a name
+ * a sibling already holds. Everything else — a reference to a field that does not exist yet, a type
+ * that will not fit — saves and is reported by `validateSdApiContract`, because inventing rules here
+ * would stop an author declaring one end of a mapping before the other exists.
+ */
+export declare class SdApiContractNodeDrawer {
+    #private;
+    /** `mapping` shows the value editor; `schema` is a plain declaration with no mapping. */
+    layer: import("@angular/core").InputSignal<"schema" | "mapping">;
+    allowTransform: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    suggestions: import("@angular/core").InputSignal<readonly SdApiContractSuggestion[]>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    nodeCommit: import("@angular/core").OutputEmitterRef<SdApiContractNodeCommit>;
+    protected readonly drawerRef: import("@angular/core").Signal<SdSideDrawer>;
+    protected readonly draftName: import("@angular/core").Signal<string>;
+    protected readonly discardPrompt: import("@angular/core").Signal<boolean>;
+    /** The node the author is looking at right now — the draft root, or a descendant of it. */
+    protected readonly current: import("@angular/core").Signal<SdApiContractStructuralNode | null>;
+    /** Every key on the breadcrumb. The pointer alternates `properties`/key, so keys sit on odd slots. */
+    protected readonly breadcrumb: import("@angular/core").Signal<string[]>;
+    /**
+     * What the name field shows.
+     *
+     * why một signal riêng chứ không đọc thẳng từ draft: một tên KHÔNG áp được — rỗng, hoặc trùng
+     * sibling — vẫn phải hiện ra để người dùng thấy mình vừa gõ gì và đọc được lý do bị chặn. Đọc
+     * thẳng từ draft thì ô input nhảy về tên cũ ngay khi gõ, tức là từ chối im lặng.
+     */
+    protected readonly currentName: import("@angular/core").Signal<string>;
+    protected readonly children: import("@angular/core").Signal<{
+        key: string;
+        node: SdApiContractStructuralNode;
+    }[]>;
+    /** Siblings on the level the author is on — the root list, or the parent object's keys. */
+    protected readonly siblingNames: import("@angular/core").Signal<readonly string[]>;
+    protected readonly typeOptions: SdApiContractOption[];
+    protected readonly requiredOptions: SdApiContractOption[];
+    protected readonly transformOptions: SdApiContractOption[];
+    protected readonly title: import("@angular/core").Signal<string>;
+    protected readonly dirty: import("@angular/core").Signal<boolean>;
+    protected readonly nameError: import("@angular/core").Signal<string | null>;
+    protected readonly canSave: import("@angular/core").Signal<boolean>;
+    /**
+     * `beforeClose` guard for `<sd-side-drawer>`.
+     *
+     * why an arrow field, not a method: the drawer takes it as an input value, so it must keep `this`
+     * without the template having to bind it.
+     */
+    protected readonly closeGuard: () => boolean;
+    openForAdd(siblingNames?: readonly string[], type?: SdApiContractDataType): void;
+    openForEdit(name: string, node: SdApiContractStructuralNode, siblingNames?: readonly string[]): void;
+    /**
+     * Types into the name field.
+     *
+     * The typed text is ALWAYS kept, then applied to the draft only when it can be. A name that cannot
+     * be applied — empty, or already taken by a sibling — stays visible and `nameError()` explains it,
+     * which is what blocks Save. Refusing the keystroke instead would leave the field showing one name
+     * while the contract holds another.
+     */
+    protected setName(value: unknown): void;
+    protected setType(value: unknown): void;
+    protected setRequired(value: unknown): void;
+    protected setText(key: 'label' | 'description', value: unknown): void;
+    protected setTransform(value: unknown): void;
+    protected applyCurrent(node: SdApiContractStructuralNode): void;
+    protected enter(key: string): void;
+    /** `depth` counts breadcrumb entries, so 0 is the draft root. */
+    protected backTo(depth: number): void;
+    protected addChild(): void;
+    protected removeChild(key: string): void;
+    protected save(): void;
+    protected requestCancel(): void;
+    protected confirmDiscard(): void;
+    protected cancelDiscard(): void;
+    /**
+     * Blocks the close while the draft is dirty and raises an inline prompt instead.
+     *
+     * why inline chứ không `window.confirm`: một component thư viện không được dựng dialog của browser
+     * — nó không style được, không test được, và chặn cả tab.
+     */
+    protected guardClose(): boolean;
+    protected onClosed(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractNodeDrawer, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractNodeDrawer, "sd-api-contract-node-drawer", never, { "layer": { "alias": "layer"; "required": false; "isSignal": true; }; "allowTransform": { "alias": "allowTransform"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "nodeCommit": "nodeCommit"; }, never, never, true, never>;
+}
+export {};

package/components/api-contract-builder/src/components/api-contract-node-editor.component.d.ts

@@ -0,0 +1,35 @@
+import { type SdApiContractStructuralNode } from '../api-contract.schema';
+import type { SdApiContractNodeEditRequest } from './api-contract-node-drawer.component';
+import * as i0 from "@angular/core";
+interface SdApiContractPropertyEntry {
+    key: string;
+    node: SdApiContractStructuralNode;
+}
+/**
+ * One schema layer — `input.schema`, `req.body`, `res.body`, `output.schema` — rendered as a flat list
+ * of the fields it declares.
+ *
+ * It used to be a recursive tree of editable seven-column rows. It is now a list you read: adding and
+ * editing ask the builder to open its drawer, and only removal is applied straight away. The list is
+ * deliberately FLAT — an `object` field shows how many fields it holds and the author drills into it
+ * inside the drawer, so a deeply nested node is edited with a drawer's worth of room instead of a
+ * 100px cell.
+ */
+export declare class SdApiContractNodeEditor {
+    #private;
+    /** The layer's root node. */
+    node: import("@angular/core").InputSignal<SdApiContractStructuralNode>;
+    /** Diagnostic path of the layer itself, e.g. `input.schema`. */
+    basePath: import("@angular/core").InputSignal<string>;
+    disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    nodeChange: import("@angular/core").OutputEmitterRef<SdApiContractStructuralNode>;
+    editRequest: import("@angular/core").OutputEmitterRef<SdApiContractNodeEditRequest>;
+    protected readonly entries: import("@angular/core").Signal<SdApiContractPropertyEntry[]>;
+    protected requestAdd(): void;
+    protected requestEdit(key: string, node: SdApiContractStructuralNode): void;
+    protected removeProperty(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractNodeEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractNodeEditor, "sd-api-contract-node-editor", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; "basePath": { "alias": "basePath"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "nodeChange": "nodeChange"; "editRequest": "editRequest"; }, never, never, true, never>;
+}
+export {};

package/components/api-contract-builder/src/components/api-contract-node-summary.component.d.ts

@@ -0,0 +1,41 @@
+import type { SdApiContractStructuralNode } from '../api-contract.schema';
+import * as i0 from "@angular/core";
+/**
+ * One collapsed, read-only row for a node in a layer list.
+ *
+ * The whole point is that it holds NO editable control. Editing a node happens in the drawer, so the
+ * list can stay a thing you scan rather than a wall of inputs — and so a node never has two editors
+ * writing it at once.
+ *
+ * The row shows what an author needs to spot a mistake without opening anything: the name, the
+ * declared type, whether it is required, and where its value comes from.
+ */
+export declare class SdApiContractNodeSummary {
+    #private;
+    name: import("@angular/core").InputSignal<string>;
+    node: import("@angular/core").InputSignal<SdApiContractStructuralNode>;
+    /** `view` mode and `disabled` both land here: the row becomes text, with no action at all. */
+    readonly: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    edit: import("@angular/core").OutputEmitterRef<void>;
+    remove: import("@angular/core").OutputEmitterRef<void>;
+    protected readonly requiredLabel: string;
+    protected readonly removeLabel: string;
+    protected readonly unmapped: import("@angular/core").Signal<boolean>;
+    /**
+     * One line describing where the value comes from.
+     *
+     * why bốn dạng khác nhau: `${input.keyword}` rút về `input.keyword` vì dấu `${}` là cú pháp chứ
+     * không phải thông tin; còn template ghép giữ NGUYÊN VĂN vì rút gọn nó sẽ sai. Literal hiện giá trị
+     * để thấy ngay, object hiện số trường để biết còn bao nhiêu phải mở ra xem.
+     */
+    protected readonly mappingSummary: import("@angular/core").Signal<string>;
+    protected requestEdit(): void;
+    /**
+     * why stopPropagation: nút xoá nằm TRONG hàng có `(click)`, nên không chặn thì bấm xoá cũng mở
+     * drawer — người dùng bấm xoá lại thấy form hiện ra.
+     */
+    protected requestRemove(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractNodeSummary, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractNodeSummary, "sd-api-contract-node-summary", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "node": { "alias": "node"; "required": true; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "edit": "edit"; "remove": "remove"; }, never, never, true, never>;
+}

package/components/api-contract-builder/src/components/api-contract-record-editor.component.d.ts

@@ -0,0 +1,36 @@
+import { type SdApiContractStructuralNode } from '../api-contract.schema';
+import type { SdApiContractNodeEditRequest } from './api-contract-node-drawer.component';
+import * as i0 from "@angular/core";
+type SdApiContractNodeRecord = Record<string, SdApiContractStructuralNode>;
+interface SdApiContractRecordEntry {
+    key: string;
+    node: SdApiContractStructuralNode;
+    path: string;
+}
+/**
+ * One keyed collection of nodes — `req.path` / `req.query` / `req.headers` / `res.headers` — rendered
+ * as a list you read, not a list you type into.
+ *
+ * Every entry is a collapsed row. Adding and editing both ask the builder to open its drawer; only
+ * removal is applied straight away, because there is nothing to stage about deleting a row. That is
+ * why `add()` emits an edit request rather than an entry: a half-declared field must never reach the
+ * contract just because someone clicked the add button and changed their mind.
+ */
+export declare class SdApiContractRecordEditor {
+    #private;
+    record: import("@angular/core").InputSignal<SdApiContractNodeRecord | undefined>;
+    /** Diagnostic path of the collection itself, e.g. `req.query`. */
+    basePath: import("@angular/core").InputSignal<string>;
+    disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    emptyLabel: import("@angular/core").InputSignal<string>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    recordChange: import("@angular/core").OutputEmitterRef<SdApiContractNodeRecord>;
+    editRequest: import("@angular/core").OutputEmitterRef<SdApiContractNodeEditRequest>;
+    protected readonly entries: import("@angular/core").Signal<SdApiContractRecordEntry[]>;
+    protected requestAdd(): void;
+    protected requestEdit(entry: SdApiContractRecordEntry): void;
+    protected remove(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractRecordEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractRecordEditor, "sd-api-contract-record-editor", never, { "record": { "alias": "record"; "required": false; "isSignal": true; }; "basePath": { "alias": "basePath"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "recordChange": "recordChange"; "editRequest": "editRequest"; }, never, never, true, never>;
+}
+export {};

package/components/api-contract-builder/src/components/api-contract-source-editor.component.d.ts

@@ -0,0 +1,86 @@
+import type { SdApiContractStructuralNode } from '../api-contract.schema';
+import type { SdApiContractSuggestion } from './api-contract-suggestion.model';
+import * as i0 from "@angular/core";
+/**
+ * How a mapped node receives its value.
+ *
+ * - `source` — one whole-value reference, picked from a dropdown.
+ * - `advanced` — a raw template the dropdown cannot express, e.g. `Bearer ${env.token}`.
+ * - `static` — a literal typed in a control that matches the declared type.
+ * - `nested` — an object mapped field by field.
+ * - `none` — CHƯA GÁN. Không phải một lựa chọn trong picker: picker để trống + `required`, nên node
+ *   chưa gán là lỗi thấy ngay trên hàng thay vì một giá trị trông như đã chọn.
+ */
+export type SdApiContractValueMode = 'source' | 'advanced' | 'static' | 'nested' | 'none';
+interface SdApiContractOption {
+    value: string;
+    label: string;
+}
+/**
+ * Value editor for one mapped node: a mode picker plus one control chosen by the mode.
+ *
+ * `source` shows a single dropdown of the references the surrounding schemas and the injected env
+ * catalog make available — the author never types `${…}` for the common case. `advanced` keeps a raw
+ * expression field for what a dropdown cannot express (`Bearer ${env.token}`). `static` renders a
+ * control matching the declared type, including a JSON editor for `object` / `array` literals.
+ *
+ * The JSON editor for a composite literal only writes when the text parses. While it is half-typed it
+ * emits the raw string, and that string is dropped — otherwise one keystroke would turn a literal
+ * object into a garbage string in the contract.
+ */
+export declare class SdApiContractSourceEditor {
+    #private;
+    node: import("@angular/core").InputSignal<SdApiContractStructuralNode>;
+    suggestions: import("@angular/core").InputSignal<readonly SdApiContractSuggestion[]>;
+    disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    autoId: import("@angular/core").InputSignal<string | null | undefined>;
+    nodeChange: import("@angular/core").OutputEmitterRef<SdApiContractStructuralNode>;
+    protected readonly advancedPlaceholder = "Bearer ${env.token}";
+    protected readonly booleanOptions: SdApiContractOption[];
+    protected readonly mode: import("@angular/core").WritableSignal<SdApiContractValueMode>;
+    /**
+     * Giá trị hiển thị của picker.
+     *
+     * why: `none` không còn là một option, nên bind nó vào `[model]` sẽ ra một ô trống mà người dùng
+     * không hiểu tại sao. Trả `null` để picker rỗng THẬT — cộng `required`, một node chưa gán trở thành
+     * lỗi thấy được ngay trên hàng, khớp với diagnostic `mapping.node.unmapped` mà validation đã báo.
+     */
+    protected readonly modeValue: import("@angular/core").Signal<SdApiContractValueMode | null>;
+    protected readonly modeOptions: import("@angular/core").Signal<SdApiContractOption[]>;
+    protected readonly suggestionOptions: import("@angular/core").Signal<SdApiContractSuggestion[]>;
+    /**
+     * Options for the source dropdown.
+     *
+     * why: một `source` đang lưu có thể trỏ vào trường đã bị xoá hoặc đổi tên — nó KHÔNG còn trong
+     * danh sách gợi ý. `sd-select` không tìm thấy value sẽ hiện ô rỗng, và giá trị vẫn nằm trong
+     * contract mà người dùng không thấy để sửa. Thêm một option dựng từ chính giá trị đó để nó luôn
+     * hiển thị; validation lo phần báo `mapping.reference.missing`.
+     */
+    protected readonly sourceOptions: import("@angular/core").Signal<SdApiContractSuggestion[]>;
+    protected readonly staticText: import("@angular/core").Signal<string>;
+    protected readonly staticNumber: import("@angular/core").Signal<number | null>;
+    protected setMode(mode: unknown): void;
+    protected setSource(value: unknown): void;
+    protected setStaticScalar(value: unknown): void;
+    protected setStaticNumber(value: unknown): void;
+    /**
+     * Stores a `date` / `datetime` literal.
+     *
+     * why: `<sd-date>` / `<sd-datetime>` có thể bắn ra một `Date`. `String(new Date())` ra
+     * `Mon Aug 17 2026 …` — không parse lại được và đổi theo locale của máy tác giả, nên contract sẽ
+     * mang một giá trị không portable. Chuẩn hoá về ISO.
+     */
+    protected setStaticTemporal(value: unknown): void;
+    /**
+     * Stores an `object` / `array` literal from the JSON editor.
+     *
+     * why: `<sd-code-editor language="json">` bắn ra STRING khi cú pháp còn dở (`{"a":`). Ghi chuỗi đó
+     * vào contract sẽ biến một literal object thành rác, nên bỏ qua và giữ giá trị hợp lệ cuối cùng —
+     * người dùng vẫn thấy nguyên văn mình đang gõ trong editor.
+     */
+    protected setStaticJson(value: unknown): void;
+    protected setStaticBoolean(value: unknown): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdApiContractSourceEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SdApiContractSourceEditor, "sd-api-contract-source-editor", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "nodeChange": "nodeChange"; }, never, never, true, never>;
+}
+export {};

package/components/api-contract-builder/src/components/api-contract-suggestion.model.d.ts

@@ -0,0 +1,17 @@
+import type { SdApiContractDataType, SdApiContractExpressionRoot } from '../api-contract.model';
+/**
+ * One `${…}` reference the source editor can offer.
+ *
+ * Internal to the builder UI — it is derived from the contract and the injected env catalog on every
+ * edit, so it is never persisted and never part of the public surface.
+ */
+export interface SdApiContractSuggestion {
+    /** Ready-to-insert text, e.g. `${input.customer.id}`. */
+    expression: string;
+    /** Dotted path without the delimiters, e.g. `input.customer.id`. */
+    path: string;
+    root: SdApiContractExpressionRoot;
+    type: SdApiContractDataType;
+    /** What the picker shows. Never contains a value — a sensitive variable only shows its name. */
+    display: string;
+}

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

@@ -21,7 +21,9 @@ export declare class SdBadge {
     size: import("@angular/core").InputSignalWithTransform<Size, Size | null | undefined>;
     readonly click: EventEmitter<Event>;
     onClick: (event: Event) => void;
+    onActivateKey: (event: Event) => void;
     effectiveColor: import("@angular/core").Signal<Color>;
+    accessibleName: import("@angular/core").Signal<string>;
     baseColorClasses: import("@angular/core").Signal<{
         'c-primary': boolean;
         'c-secondary': boolean;

package/components/ckeditor-styles/src/ckeditor-styles.component.d.ts

@@ -6,7 +6,7 @@ import * as i0 from "@angular/core";
  * - CKEditor's CSS must be global (applies to body-rendered overlays, dialogs, balloons),
  *   which means whichever Angular component declares it must use ViewEncapsulation.None.
  * - Switching encapsulation on the main editor components (`<sd-editor>`, `<sd-mini-editor>`,
- *   `<sd-document-builder>`) would un-scope all their local styles too.
+ *   `<sd-mini-editor>`) would un-scope all their local styles too.
  * - Instead, this tiny no-render component owns the global CSS. The editor components embed
  *   `<sd-ckeditor-styles>` at the top of their template; the CSS is injected once into <head>
  *   the first time any editor instance mounts. Editor components themselves keep

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

@@ -8,7 +8,7 @@ export declare class ExpressionBuilderComponent implements OnInit {
     modal?: SdModal;
     form: FormGroup<{}>;
     attributeOperators: Record<"string" | "number" | "boolean" | "datetime" | "values", {
-        value: import("@sdcorejs/angular/components/form-generic").Operator;
+        value: import("@sdcorejs/angular/components/form-generic").SdFormGenericOperator;
         symbol?: string;
         display: string;
     }[]>;
@@ -37,6 +37,7 @@ export declare class ExpressionBuilderComponent implements OnInit {
     constructor(...args: unknown[]);
     ngOnInit(): void;
     onEdit: () => Promise<void>;
+    onExprKeydown: (event: KeyboardEvent) => void;
     addCondition: (conditions: SdFormGenericExpression["conditions"]) => void;
     addCombinator: (conditions: SdFormGenericExpression["conditions"]) => void;
     remove: (conditions: SdFormGenericExpression["conditions"], idx: number) => void;

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

@@ -104,7 +104,7 @@ export declare class SdFormBuilder implements OnInit, OnDestroy {
     placeholderColumnsFor: (item: FormBuilderComponent | SdFormGenericComponent | SdFormGenericGroup | DragDropRowItem | undefined) => number;
     /** True nếu component có expression điều kiện — drives the "conditional" status chip. */
     hasConditional: (item: SdFormGenericComponent | SdFormGenericGroup) => boolean;
-    /** Map SdColor preset → 2 CSS var names cho header-bg và header-fg của group card. */
+    /** Map Color preset → 2 CSS var names cho header-bg và header-fg của group card. */
     groupColorVars: (color: string | undefined | null) => {
         bg: string;
         fg: string;
@@ -112,6 +112,7 @@ export declare class SdFormBuilder implements OnInit, OnDestroy {
     /** Segmented Design/Preview toggle (replaces play_circle/stop_circle). */
     setMode: (preview: boolean) => void;
     /** Mở canvas thiết kế riêng cho 1 group (chỉ children của nó). Snapshot để Cancel revert. */
+    onEnterGroupEditKeydown: (group: SdFormGenericGroup, event: KeyboardEvent) => void;
     enterGroupEdit: (group: SdFormGenericGroup) => void;
     /** OK: giữ thay đổi children, quay về canvas chính. */
     confirmGroupEdit: () => void;
@@ -124,6 +125,7 @@ export declare class SdFormBuilder implements OnInit, OnDestroy {
     /** Xoá component theo scope hiện tại (top-level hoặc children của group đang Detail). */
     removeComponent: (id: string) => void;
     selectComponent: (item?: SdFormGenericComponent | SdFormGenericGroup) => void;
+    onPaletteItemKeydown: (item: FormBuilderComponent, event: KeyboardEvent) => void;
     onClickedOutside: (e: any) => void;
     clickFormContentEmpty: () => void;
     drop: (event: CdkDragDrop<any[]>) => void;

package/components/form-generic/src/components/form-render/components/item/components/checkbox/checkbox.component.d.ts

@@ -0,0 +1,34 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+import { Subject } from 'rxjs';
+import { SdFormGenericCheckbox } from '../../../../../../models';
+import * as i0 from "@angular/core";
+/**
+ * Ô checkbox của form-render.
+ *
+ * why: form-builder từ trước đã tạo được field `type: 'checkbox'` nhưng form-render KHÔNG có nhánh
+ * nào cho nó — field dựng trong builder chạy ra form trống, không hiện gì. Component này lấp chỗ đó
+ * theo đúng khuôn của các control còn lại (textfield/radio…): nhận cùng bộ input, tự áp defaultValue,
+ * và nghe `setVariables` để giá trị đặt từ biểu thức cũng phản ánh lên UI.
+ */
+export declare class CheckboxComponent implements OnInit, OnDestroy {
+    #private;
+    private ref;
+    readonly setVariables: import("@angular/core").InputSignal<Subject<{
+        key: string;
+        value: any;
+    }>>;
+    readonly form: import("@angular/core").InputSignal<FormGroup<{}>>;
+    entity: Record<string, any>;
+    set _entity(val: Record<string, any>);
+    component?: SdFormGenericCheckbox;
+    set _component(val: SdFormGenericCheckbox);
+    disabled: boolean;
+    set _disabled(val: boolean | '' | undefined | null);
+    viewed: boolean;
+    set _viewed(val: boolean | '' | undefined | null);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxComponent, "lib-checkbox", never, { "setVariables": { "alias": "setVariables"; "required": true; "isSignal": true; }; "form": { "alias": "form"; "required": false; "isSignal": true; }; "_entity": { "alias": "entity"; "required": true; }; "_component": { "alias": "component"; "required": true; }; "_disabled": { "alias": "disabled"; "required": false; }; "_viewed": { "alias": "viewed"; "required": false; }; }, {}, never, never, true, never>;
+}

package/components/form-generic/src/components/form-render/components/item/components/index.d.ts

@@ -6,6 +6,7 @@ export * from './number/number.component';
 export * from './datetime/datetime.component';
 export * from './select/select.component';
 export * from './radio/radio.component';
+export * from './checkbox/checkbox.component';
 export * from './upload/upload.component';
 export * from './table/table.component';
 export * from './html/html.component';

package/components/form-generic/src/components/form-render/components/item/components/table/table.component.d.ts

@@ -31,7 +31,7 @@ export declare class TableComponent implements AfterViewInit, OnDestroy, OnInit
     readonly modelChange: import("@angular/core").OutputEmitterRef<any[]>;
     tableOption?: SdTableOption;
     row: any;
-    columnValues: Record<string, SdFormGenericSelectionItem[] | SdSearch>;
+    columnValues: Record<string, SdFormGenericSelectionItem[] | SdSearch<SdFormGenericSelectionItem>>;
     formRenderColumn: Record<string, SdFormGenericTableColumn>;
     fileKeys: string[];
     imageKeys: string[];
@@ -40,6 +40,11 @@ export declare class TableComponent implements AfterViewInit, OnDestroy, OnInit
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    /**
+     * Tiêu đề của side-drawer phải nói đúng tác vụ đang làm — trước đây nó cứng là "Chi tiết" cho cả
+     * thêm mới lẫn sửa, còn dòng "Tạo mới/cập nhật" thì rơi vào thân drawer vì gắn nhầm slot.
+     */
+    get detailTitle(): string;
     onDetail: (row?: any) => void;
     onCancel: () => void;
     onAccept: (addable?: boolean) => void;

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

@@ -11,7 +11,7 @@ export declare class SdFeelExpression implements OnInit {
     modal?: SdModal;
     form: FormGroup<{}>;
     attributeOperators: Record<"string" | "number" | "boolean" | "datetime" | "values", {
-        value: import("@sdcorejs/angular/components/form-generic").Operator;
+        value: import("@sdcorejs/angular/components/form-generic").SdFormGenericOperator;
         symbol?: string;
         display: string;
     }[]>;

package/components/form-generic/src/configurations/form.configuration.d.ts

@@ -1,7 +1,7 @@
 import { SdSearch } from '@sdcorejs/angular/forms/models';
 import { SdFormGenericArgs, SdFormGenericDefinitionHtml, SdFormGenericDefinitionSelection, SdFormGenericDefinitionTable, SdFormGenericSelectionItem, SdFormGenericTemplate } from '../models';
 import { SdFormGenericValidationConfiguration } from '../models/form-generic-validation.model';
-export interface IWorkflowConfigurationForm<TSelectionArgs = any> {
+export interface IWorkflowConfigurationForm<TSelectionArgs = unknown> {
     templates: SdFormGenericTemplate[];
     selections: SdFormGenericDefinitionSelection<any, TSelectionArgs>[] | (() => SdFormGenericDefinitionSelection<any, TSelectionArgs>[]) | (() => Promise<SdFormGenericDefinitionSelection[]>);
     getValues?: (key: string, selectionArgs?: TSelectionArgs) => Promise<SdFormGenericSelectionItem[]>;

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

@@ -17,9 +17,9 @@ export interface SdFormGenericLayout {
     columns: '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
     mobileColumns?: '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 }
-export declare const GenerateId: () => string;
-export declare const GenerateKey: () => string;
-export declare const SdFormatComponent: (component: SdFormGenericComponent | SdFormGenericGroup) => void;
+export declare const sdGenerateId: () => string;
+export declare const sdGenerateKey: () => string;
+export declare const sdFormatComponent: (component: SdFormGenericComponent | SdFormGenericGroup) => void;
 export interface SdFormGenericVariable {
     id: string;
     key: string;
@@ -171,7 +171,7 @@ export interface FormRenderComponentTableColumnValues {
     query?: Record<string, any>;
 }
 export type SdFormGenericTableColumn<T = any> = TableColumnString<T> | TableColumnNumber<T> | TableColumnBool<T> | TableColumnDate<T> | TableColumnDatetime<T> | TableColumnRadio<T> | TableColumnValues<T> | TableColumnImage<T> | TableColumnFile<T>;
-export declare const TableColumnTypes: {
+export declare const SD_TABLE_COLUMN_TYPES: {
     value: string;
     display: string;
 }[];
@@ -301,17 +301,17 @@ export interface FormBuilderComponent {
     group: FormBuilderComponentGroup;
     name: string;
 }
-export declare const FormBuilderComponents: FormBuilderComponent[];
+export declare const SD_FORM_BUILDER_COMPONENTS: FormBuilderComponent[];
 /** Lookup: component type → Material icon + label, used by attribute panel header. */
-export declare const COMPONENT_ICONS: Record<string, {
+export declare const SD_COMPONENT_ICONS: Record<string, {
     symbol: string;
     label: string;
 }>;
-export declare const GetComponentAttributes: (components: (SdFormGenericComponent | SdFormGenericGroup)[]) => {
+export declare const sdGetComponentAttributes: (components: (SdFormGenericComponent | SdFormGenericGroup)[]) => {
     value: string;
     display: string;
 }[];
-export declare const GetVariableAttributes: (variables: SdFormGenericVariable[]) => {
+export declare const sdGetVariableAttributes: (variables: SdFormGenericVariable[]) => {
     value: string;
     display: string;
 }[];

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

@@ -1,6 +1,6 @@
 import { SdSearch } from '@sdcorejs/angular/forms/models';
 import { SdFormGenericArgs } from './form-render/form-render-args.model';
-export interface SdFormGenericSelectionItem<T = any> {
+export interface SdFormGenericSelectionItem<T = unknown> {
     value: string;
     display: string;
     disabled?: boolean;
@@ -11,8 +11,8 @@ export interface SdFormGenericSelectionStaticItem {
     value: string;
     label: string;
 }
-export type SdFormGenericDefinitionSelection<T = any, TArgs = any> = SelectionValues<T> | SelectionLazyValues<T> | SelectionValuesKey<TArgs> | SelectionLazyValuesKey<TArgs>;
-interface SelectionVariables<T = any> {
+export type SdFormGenericDefinitionSelection<T = unknown, TArgs = unknown> = SelectionValues<T> | SelectionLazyValues<T> | SelectionValuesKey<TArgs> | SelectionLazyValuesKey<TArgs>;
+interface SelectionVariables<T = unknown> {
     items?: {
         value: Extract<keyof T, string>;
         display: string;
@@ -40,10 +40,10 @@ interface SelectionLazyValuesKey<TArgs> extends SelecttionBase {
     lazyValuesKey: string;
     args?: TArgs;
 }
-interface SelectionValues<T = any> extends SelecttionBase {
+interface SelectionValues<T = unknown> extends SelecttionBase {
     values: (args: SdFormGenericArgs) => Promise<SdFormGenericSelectionItem<T>[]>;
 }
-interface SelectionLazyValues<T = any> extends SelecttionBase {
+interface SelectionLazyValues<T = unknown> extends SelecttionBase {
     lazyValues: (searchArgs: Parameters<SdSearch>[0], args: SdFormGenericArgs) => Promise<SdFormGenericSelectionItem<T>[]>;
 }
 export {};