@sdcorejs/angular 19.2.0 → 19.2.2

package/i18n/src/en.d.ts

@@ -133,6 +133,8 @@ export declare const EN_MESSAGES: {
     readonly 'core.form.tree-select.cancel': "Cancel";
     readonly 'core.form.tree-select.apply': "Apply";
     readonly 'core.component.tree.retry': "Retry";
+    readonly 'core.component.section.expand': "Expand {title}";
+    readonly 'core.component.section.collapse': "Collapse {title}";
     readonly 'core.service.unsaved-changes.message': "You have unsaved changes. Discard them and continue?";
     readonly 'core.component.job-progress.status.idle': "Ready";
     readonly 'core.component.job-progress.status.queued': "Queued";
@@ -581,6 +583,84 @@ export declare const EN_MESSAGES: {
     readonly 'core.component.query-builder.to': "To";
     readonly 'core.component.query-builder.boolean.true': "Yes";
     readonly 'core.component.query-builder.boolean.false': "No";
+    readonly 'core.component.api-contract-builder.steps': "Contract steps";
+    readonly 'core.component.api-contract-builder.step.general': "General";
+    readonly 'core.component.api-contract-builder.step.input': "Input schema";
+    readonly 'core.component.api-contract-builder.step.request': "Request";
+    readonly 'core.component.api-contract-builder.step.response': "Response";
+    readonly 'core.component.api-contract-builder.step.output': "Output";
+    readonly 'core.component.api-contract-builder.step.review': "Review";
+    readonly 'core.component.api-contract-builder.empty.contract': "No contract yet";
+    readonly 'core.component.api-contract-builder.create-contract': "Create a contract";
+    readonly 'core.component.api-contract-builder.contract.code': "Contract code";
+    readonly 'core.component.api-contract-builder.contract.name': "Name";
+    readonly 'core.component.api-contract-builder.contract.description': "Description";
+    readonly 'core.component.api-contract-builder.contract.version': "Contract version";
+    readonly 'core.component.api-contract-builder.node.name': "Name";
+    readonly 'core.component.api-contract-builder.node.type': "Type";
+    readonly 'core.component.api-contract-builder.node.required': "Required";
+    readonly 'core.component.api-contract-builder.node.label': "Label";
+    readonly 'core.component.api-contract-builder.node.description': "Description";
+    readonly 'core.component.api-contract-builder.node.transform': "Temporal transform";
+    readonly 'core.component.api-contract-builder.node.items': "Item schema";
+    readonly 'core.component.api-contract-builder.node.remove': "Remove";
+    readonly 'core.component.api-contract-builder.node.empty': "No properties yet";
+    readonly 'core.component.api-contract-builder.node.add-property': "Add property";
+    readonly 'core.component.api-contract-builder.node.duplicate-key': "This name is already used by a sibling";
+    readonly 'core.component.api-contract-builder.node.confirm-remove': "Remove \"{name}\" and every field inside it?";
+    readonly 'core.component.api-contract-builder.node.confirm-type': "Changing the type discards the nested fields. Continue?";
+    readonly 'core.component.api-contract-builder.confirm.yes': "Yes";
+    readonly 'core.component.api-contract-builder.confirm.no': "No";
+    readonly 'core.component.api-contract-builder.required.true': "Yes";
+    readonly 'core.component.api-contract-builder.required.false': "No";
+    readonly 'core.component.api-contract-builder.field.required': "Required";
+    readonly 'core.component.api-contract-builder.transform.none': "None";
+    readonly 'core.component.api-contract-builder.mapping.mode': "Value";
+    readonly 'core.component.api-contract-builder.mapping.mode.source': "From source";
+    readonly 'core.component.api-contract-builder.mapping.mode.static': "Static value";
+    readonly 'core.component.api-contract-builder.mapping.mode.advanced': "Advanced";
+    readonly 'core.component.api-contract-builder.mapping.mode.nested': "Map each field";
+    readonly 'core.component.api-contract-builder.mapping.source': "Source expression";
+    readonly 'core.component.api-contract-builder.mapping.value': "Static value";
+    readonly 'core.component.api-contract-builder.mapping.sensitive': "sensitive";
+    readonly 'core.component.api-contract-builder.drawer.add-title': "Add field";
+    readonly 'core.component.api-contract-builder.drawer.edit-title': "Edit field";
+    readonly 'core.component.api-contract-builder.drawer.save': "Save";
+    readonly 'core.component.api-contract-builder.drawer.cancel': "Cancel";
+    readonly 'core.component.api-contract-builder.drawer.discard-confirm': "Discard unsaved changes?";
+    readonly 'core.component.api-contract-builder.summary.unmapped': "unmapped";
+    readonly 'core.component.api-contract-builder.summary.field-count': "{count} field(s)";
+    readonly 'core.component.api-contract-builder.node.name-required': "The field name cannot be empty";
+    readonly 'core.component.api-contract-builder.boolean.true': "True";
+    readonly 'core.component.api-contract-builder.boolean.false': "False";
+    readonly 'core.component.api-contract-builder.request.method': "Method";
+    readonly 'core.component.api-contract-builder.request.url': "URL";
+    readonly 'core.component.api-contract-builder.request.path': "Path parameters";
+    readonly 'core.component.api-contract-builder.request.query': "Query parameters";
+    readonly 'core.component.api-contract-builder.request.headers': "Headers";
+    readonly 'core.component.api-contract-builder.request.body': "Body";
+    readonly 'core.component.api-contract-builder.request.add-body': "Add a body";
+    readonly 'core.component.api-contract-builder.request.remove-body': "Remove the body";
+    readonly 'core.component.api-contract-builder.request.add-entry': "Add";
+    readonly 'core.component.api-contract-builder.response.status': "Success status codes";
+    readonly 'core.component.api-contract-builder.response.status-hint': "Comma separated, for example 200, 201";
+    readonly 'core.component.api-contract-builder.response.headers': "Response headers";
+    readonly 'core.component.api-contract-builder.response.body': "Response body";
+    readonly 'core.component.api-contract-builder.response.add-body': "Add a body";
+    readonly 'core.component.api-contract-builder.response.remove-body': "Remove the body";
+    readonly 'core.component.api-contract-builder.output.schema': "Output schema";
+    readonly 'core.component.api-contract-builder.output.use-response': "Use a response field as the output";
+    readonly 'core.component.api-contract-builder.output.fields': "Fields available to consumers";
+    readonly 'core.component.api-contract-builder.output.no-fields': "No leaf field yet";
+    readonly 'core.component.api-contract-builder.review.valid': "The contract is valid";
+    readonly 'core.component.api-contract-builder.review.errors': "{count} error(s)";
+    readonly 'core.component.api-contract-builder.review.warnings': "{count} warning(s)";
+    readonly 'core.component.api-contract-builder.review.json': "Contract JSON";
+    readonly 'core.component.api-contract-builder.empty.path': "No path parameter yet";
+    readonly 'core.component.api-contract-builder.empty.query': "No query parameter yet";
+    readonly 'core.component.api-contract-builder.empty.headers': "No header yet";
+    readonly 'core.component.api-contract-builder.empty.body': "No body declared";
+    readonly 'core.component.api-contract-builder.empty.section': "This section is missing from the contract";
     readonly 'core.component.tree.selected-count': "{count} item(s) selected";
     readonly 'core.component.tree.expand': "Expand tree item";
     readonly 'core.component.tree.collapse': "Collapse tree item";

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

@@ -26,11 +26,20 @@ export declare class SdSidebarV1Panel {
     logoUrl: import("@angular/core").Signal<string | undefined>;
     pinnedNodeKeys: import("@angular/core").Signal<Set<string>>;
     isPinnedMenuGroupActive: import("@angular/core").Signal<boolean>;
+    activeMenuPath: import("@angular/core").Signal<string | null>;
     dataSource: MatTreeNestedDataSource<SdLayoutMenu>;
     treeControl: NestedTreeControl<SdLayoutMenu, SdLayoutMenu>;
     constructor();
     hasChild: (_: number, node: SdLayoutMenu) => boolean;
     onToggleMenuNode: (menu: SdLayoutMenu) => void;
+    menuNodeHref: (node: {
+        path: string;
+        queryParams?: Params;
+    }) => string;
+    onMenuNodeClick: (event: MouseEvent, node: {
+        path: string;
+        queryParams?: Params;
+    }) => void;
     onMenuNodeKeydown: (event: KeyboardEvent, node: {
         path: string;
         queryParams: Params;

package/modules/layout/pipes/menu-focus.pipe.d.ts

@@ -2,8 +2,12 @@ import { PipeTransform } from '@angular/core';
 import { SdLayoutMenu } from '../services';
 import * as i0 from "@angular/core";
 export declare class MenuFocusPipe implements PipeTransform {
-    #private;
-    transform(routePath: string, menuItem: SdLayoutMenu): boolean;
+    /**
+     * @param activeMenuPath Path khớp sát nhất với route hiện tại (xem `resolveActiveMenuPath`).
+     * Truyền vào thì chỉ menu chứa đúng path đó mới focus, nên '/appointment' không sáng khi đang ở
+     * '/appointment/cs'. Bỏ trống thì giữ cách khớp phần đầu cũ.
+     */
+    transform(routePath: string, menuItem: SdLayoutMenu, activeMenuPath?: string | null): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuFocusPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<MenuFocusPipe, "menuFocus", true>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MenuFocusPipe>;

package/modules/layout/utils/index.d.ts

@@ -1 +1,2 @@
+export * from './menu-path.util';
 export * from './tab-name.util';

package/modules/layout/utils/menu-path.util.d.ts

@@ -0,0 +1,16 @@
+import { SdLayoutMenu } from '../services/menu/menu.model';
+/** Thêm '/' ở cuối để so khớp theo segment: '/appointment' không khớp nhầm '/appointments'. */
+export declare const normalizeMenuPath: (path: string) => string;
+/** Route hiện tại có nằm trong nhánh của `path` không (khớp chính xác hoặc khớp phần đầu). */
+export declare const isMenuPathMatch: (routePath: string, path: string) => boolean;
+/** Mọi path trong cây menu khớp với route hiện tại. */
+export declare const collectMatchedMenuPaths: (menus: SdLayoutMenu[] | null | undefined, routePath: string) => string[];
+/**
+ * Path khớp sát nhất với route hiện tại trong cả cây menu.
+ * Khi cả '/appointment' và '/appointment/cs' cùng khớp route '/appointment/cs',
+ * chỉ path dài nhất được coi là active — path còn lại không được highlight.
+ * Hoà nhau thì lấy path xuất hiện trước theo thứ tự khai báo.
+ */
+export declare const resolveActiveMenuPath: (menus: SdLayoutMenu[] | null | undefined, routePath: string) => string | null;
+/** Chính menu này, hoặc bất kỳ menu con nào ở mọi cấp, có đúng path đó. */
+export declare const containsMenuPath: (menuItem: SdLayoutMenu, path: string) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "19.2.0",
+  "version": "19.2.2",
   "description": "Angular component library: data table, query bar/builder, 20+ signal-based form controls, layout, auth and workflow services. Standalone, OnPush, signals-first. Published in parallel lines for Angular 19, 20 and 21.",
   "keywords": [
     "angular",
@@ -74,14 +74,14 @@
       "types": "./components/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components.mjs"
     },
-    "./directives": {
-      "types": "./directives/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-directives.mjs"
-    },
     "./configurations": {
       "types": "./configurations/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-configurations.mjs"
     },
+    "./directives": {
+      "types": "./directives/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-directives.mjs"
+    },
     "./forms": {
       "types": "./forms/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms.mjs"
@@ -118,6 +118,10 @@
       "types": "./components/anchor/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-anchor.mjs"
     },
+    "./components/api-contract-builder": {
+      "types": "./components/api-contract-builder/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-components-api-contract-builder.mjs"
+    },
     "./components/audit-diff": {
       "types": "./components/audit-diff/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-components-audit-diff.mjs"
@@ -298,14 +302,14 @@
       "types": "./forms/inline-text/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-inline-text.mjs"
     },
-    "./forms/input": {
-      "types": "./forms/input/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-forms-input.mjs"
-    },
     "./forms/input-color": {
       "types": "./forms/input-color/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-input-color.mjs"
     },
+    "./forms/input": {
+      "types": "./forms/input/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-forms-input.mjs"
+    },
     "./forms/input-number": {
       "types": "./forms/input-number/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-forms-input-number.mjs"
@@ -378,6 +382,10 @@
       "types": "./services/confirm/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-confirm.mjs"
     },
+    "./services/excel": {
+      "types": "./services/excel/index.d.ts",
+      "default": "./fesm2022/sdcorejs-angular-services-excel.mjs"
+    },
     "./services/loading": {
       "types": "./services/loading/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-loading.mjs"
@@ -386,10 +394,6 @@
       "types": "./services/notify/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-notify.mjs"
     },
-    "./services/excel": {
-      "types": "./services/excel/index.d.ts",
-      "default": "./fesm2022/sdcorejs-angular-services-excel.mjs"
-    },
     "./services/persistence": {
       "types": "./services/persistence/index.d.ts",
       "default": "./fesm2022/sdcorejs-angular-services-persistence.mjs"