@sdcorejs/angular 20.2.0 → 20.2.2

package/i18n/index.d.ts

@@ -139,6 +139,8 @@ 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";
@@ -587,6 +589,84 @@ 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/index.d.ts

@@ -588,6 +588,22 @@ declare class SdSidebarMobileV3 {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdSidebarMobileV3, "sd-sidebar-mobile-v3", never, { "menus": { "alias": "menus"; "required": false; "isSignal": true; }; "userInfo": { "alias": "userInfo"; "required": true; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Thêm '/' ở cuối để so khớp theo segment: '/appointment' không khớp nhầm '/appointments'. */
+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). */
+declare const isMenuPathMatch: (routePath: string, path: string) => boolean;
+/** Mọi path trong cây menu khớp với route hiện tại. */
+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.
+ */
+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 đó. */
+declare const containsMenuPath: (menuItem: SdLayoutMenu, path: string) => boolean;
+
 /**
  * Resolve a translated tab name for `@SdTabComponent`.
  *
@@ -609,8 +625,12 @@ declare class MenuPipe implements PipeTransform {
 }
 
 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: _angular_core.ɵɵFactoryDeclaration<MenuFocusPipe, never>;
     static ɵpipe: _angular_core.ɵɵPipeDeclaration<MenuFocusPipe, "menuFocus", true>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MenuFocusPipe>;
@@ -631,5 +651,5 @@ declare class SdLayoutModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<SdLayoutModule>;
 }
 
-export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_DEMO_FALLBACK, SD_LAYOUT_STORAGE_NAMESPACE, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SdSidebarMobileOverlay, SdSidebarMobileV1, SdSidebarMobileV2, SdSidebarMobileV3, SdSidebarV2, SdSidebarV3, flattenMenuLeaves, getMenuStableKey, normalizeLayoutMobileBreakpoint, normalizeSidebarConfiguration, resolveMenuKeys, resolveSidebarV2Interaction, resolveSidebarV3Recent, resolveTabName, searchMenuLeaves, selectPrimaryMenuGroups };
+export { DEFAULT_LAYOUT_MOBILE_BREAKPOINT, ForbiddenModule, HighlightSearchPipe, HomeModule, MenuFocusPipe, MenuPipe, NotFoundModule, SD_LAYOUT_CONFIGURATION, SD_LAYOUT_DEMO_FALLBACK, SD_LAYOUT_STORAGE_NAMESPACE, SD_LAYOUT_VIEWPORT, SdLayoutComponent, SdLayoutMenuTreeComponent, SdLayoutModule, SdLayoutNavigationStateService, SdLayoutResponsiveService, SdLayoutService, SdLayoutStorageService, SdLayoutUserMenuComponent, SdPageComponent, SdSidebarMobileOverlay, SdSidebarMobileV1, SdSidebarMobileV2, SdSidebarMobileV3, SdSidebarV2, SdSidebarV3, collectMatchedMenuPaths, containsMenuPath, flattenMenuLeaves, getMenuStableKey, isMenuPathMatch, normalizeLayoutMobileBreakpoint, normalizeMenuPath, normalizeSidebarConfiguration, resolveActiveMenuPath, resolveMenuKeys, resolveSidebarV2Interaction, resolveSidebarV3Recent, resolveTabName, searchMenuLeaves, selectPrimaryMenuGroups };
 export type { ISdLayoutConfiguration, ISdSidebarConfiguration, Menus, ResolvedSidebarRecentConfiguration, SdLayoutAccountAction, SdLayoutChildrenMenu, SdLayoutMenu, SdLayoutNotificationConfiguration, SdLayoutRootMenu, SdLayoutStorageNamespace, SdLayoutUserInfo, SdLayoutUserRole, SdLayoutVersionState, SdLayoutViewport, SidebarConfigurationBase, SidebarConfigurationV1, SidebarConfigurationV2, SidebarConfigurationV3 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdcorejs/angular",
-  "version": "20.2.0",
+  "version": "20.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",
@@ -78,6 +78,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"