ngx-histaff-alpha 6.7.4 → 6.7.5

package/lib/app/libraries/core-dom-decision-editor/dom-oid-factory/dom-oid-factory.component.d.ts

@@ -1,10 +1,58 @@
+/**
+ * DomOIdFactoryComponent
+ *
+ * Đây KHÔNG phải là một picker thông thường, cũng không phải là một input CRUD.
+ *
+ * Component này đóng vai trò là “Symbolic Reference Binder” trong ngữ cảnh
+ * CoreDomDecisionEditor. Nhiệm vụ duy nhất của nó là cho phép người dùng:
+ *  - Phát biểu một danh từ tổ chức (O) dưới dạng ý định (literal),
+ *  - Hoặc ràng buộc tới một token tổ chức đã được nhắc tới ở các Seq trước đó.
+ *
+ * Các nguyên tắc bất biến:
+ *  - KHÔNG sinh entity mới.
+ *  - KHÔNG tạo ID giả, KHÔNG mô phỏng DB.
+ *  - KHÔNG giữ state riêng về token.
+ *  - KHÔNG nhận token qua @Input().
+ *
+ * DomOIdFactory chỉ đọc “sự thật ngữ cảnh” từ DomDecisionContextService,
+ * nơi tập hợp các token hợp lệ theo activeSeq hiện tại của Decision.
+ * Nhờ đó, component này không bao giờ cho phép người dùng
+ * “nhắc tới tương lai” hoặc phá vỡ quan hệ nhân quả của Intent Chain.
+ *
+ * Giá trị mà component ghi vào form KHÔNG phải là PK/ID DB,
+ * mà là một biểu thức tham chiếu mang tính ngôn ngữ (symbolic reference),
+ * sẽ được resolve duy nhất ở giai đoạn Executor.
+ *
+ * Component này chỉ được phép sử dụng bên trong CoreDomDecisionEditor.
+ * Nếu cần tái sử dụng ở ngữ cảnh khác, phải tạo component mới hoặc adapter rõ ràng,
+ * không được mang DomOIdFactory ra khỏi Decision boundary.
+ *
+ * DomOIdFactoryComponent là tiền đề kiến trúc cho các component cùng họ:
+ *  - DomSIdFactoryComponent
+ *  - DomPIdFactoryComponent
+ *
+ * Nếu component này bị đơn giản hóa hoặc dùng sai ngữ cảnh,
+ * toàn bộ mô hình Token / Decision / Executor phía sau sẽ mất ý nghĩa.
+ */
+import { AfterViewInit, OnDestroy } from '@angular/core';
 import { ICoreTreeReferenceNode } from '../../core-tree-reference/core-tree-reference.component';
 import { CoreFormControlBaseComponent } from '../../core-form-control-base/core-form-control-base.component';
 import { IEntityToken } from '../enum-interfaces/entity-token';
 import * as i0 from "@angular/core";
-export declare class DomOIdFactoryComponent extends CoreFormControlBaseComponent {
+export interface IDomOIdFactoryEmit {
+    controlName: string | undefined;
+    id: string;
+    originalName?: string;
+}
+export declare class DomOIdFactoryComponent extends CoreFormControlBaseComponent implements AfterViewInit, OnDestroy {
+    $showSearch: import("@angular/core").InputSignal<boolean>;
+    resolved: import("@angular/core").OutputEmitterRef<IDomOIdFactoryEmit>;
     private ctx;
-    $tokens: import("@angular/core").Signal<IEntityToken[]>;
+    private elRef;
+    private destroyClickOutside?;
+    writeValue(obj: any): void;
+    constructor();
+    $currentTokens: import("@angular/core").Signal<IEntityToken[]>;
     $loading: import("@angular/core").WritableSignal<boolean>;
     $searchText: import("@angular/core").WritableSignal<string>;
     $displayName: import("@angular/core").WritableSignal<string>;
@@ -14,6 +62,8 @@ export declare class DomOIdFactoryComponent extends CoreFormControlBaseComponent
     onSearchTextChange(e: string): void;
     onPopupToggle(): void;
     onTreeItemSelected(e: ICoreTreeReferenceNode): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DomOIdFactoryComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DomOIdFactoryComponent, "dom-oid-factory", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DomOIdFactoryComponent, "dom-oid-factory", never, { "$showSearch": { "alias": "$showSearch"; "required": false; "isSignal": true; }; }, { "resolved": "resolved"; }, never, never, true, never>;
 }

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/entity-token.d.ts

@@ -7,3 +7,4 @@ export interface IEntityToken {
 }
 export type HumanSnapshot = Partial<Record<HumanReadableInputKey, string>>;
 export type HumanReadableInputKey = 'CODE' | 'SHORT_CODE' | 'ORIGINAL_NAME' | 'TREE_NAME' | 'ROLE' | 'NOTE';
+export declare const HUMAN_LABEL_MAP: Record<HumanReadableInputKey, string>;

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/intent-descriptor.model.d.ts

@@ -1,4 +1,5 @@
 import { EnumActionCode } from '../enum-interfaces/action-code.enum';
+import { IIntentGrammar } from '../enum-interfaces/narration-engine';
 export interface IIntentDescriptor {
     /** Unique action code – MUST match backend handler */
     readonly actionCode: EnumActionCode;
@@ -12,6 +13,8 @@ export interface IIntentDescriptor {
     readonly quickEmoji: string;
     /** Input schema – descriptive only */
     readonly inputs: ReadonlyArray<IIntentInputDescriptor>;
+    /** Grammar-based narration definition */
+    readonly narration?: IIntentGrammar;
 }
 export interface IIntentInputDescriptor {
     /** Logical input key */
@@ -21,7 +24,34 @@ export interface IIntentInputDescriptor {
     /** Input kind – NOT a form type */
     readonly kind: IntentInputKind;
     /** Default value when composing intent */
-    readonly defaultValue?: unknown;
+    defaultValue?: unknown;
+    /**
+     * defaultValueFactory
+     * ----------------------------------------
+     * Factory sinh giá trị mặc định tại THỜI ĐIỂM build form,
+     * không phải tại thời điểm định nghĩa descriptor.
+     *
+     * Dùng cho các giá trị có tính:
+     * - Động theo lần tạo intent (UUID, timestamp, random code, ...)
+     * - Phụ thuộc ngữ cảnh runtime
+     *
+     * ⚠️ TUYỆT ĐỐI KHÔNG dùng defaultValue cho:
+     * - crypto.randomUUID()
+     * - new Date()
+     * - Date.now()
+     * - Math.random()
+     *
+     * Lý do:
+     * Descriptor là metadata tĩnh, chỉ được evaluate MỘT LẦN
+     * khi module được load.
+     * Việc đặt giá trị động vào defaultValue sẽ gây reuse dữ liệu,
+     * phá vỡ lịch sử quyết định và dẫn tới bug rất khó truy vết.
+     *
+     * Quy tắc:
+     * - defaultValue        → literal / constant
+     * - defaultValueFactory → dynamic / runtime value
+     */
+    defaultValueFactory?: () => unknown;
     readonly validators?: IIntentInputValidatorSchema;
     /** Optional hint for humans */
     readonly hint?: string;
@@ -57,7 +87,7 @@ export interface IIntentInputError {
     errorMessage: string;
 }
 export type IntentInputKind = 'string' | 'boolean' | 'date' | 'dropdown' | 'number' | 'reference' | 'enum' | 'timezoneId' | 'orgGardenReference' | 'orgAttributeName' | 'seatAttributeName' | 'personAttributeName' | 'rCode' | 'treeId' | 'role';
-export type IntentInputKey = 'A_ID' | 'B_ID' | 'R_CODE' | 'VF_UTC' | 'VT_UTC' | 'TIMEZONE_ID' | 'ORIGINAL_NAME' | 'IS_ROOT' | 'IS_HR' | 'CODE' | 'SHORT_CODE' | 'ID' | 'OBJECT_ID' | 'ROLE' | 'NOTE' | 'OBJECT_TYPE' | 'ATTRIBUTE_NAME' | 'VALUE_IN_STRING' | 'AVAILABLE_UTC' | 'TREE_ID' | 'TREE_NAME';
+export type IntentInputKey = 'A_ID' | 'B_ID' | 'R_CODE' | 'VF_UTC' | 'VT_UTC' | 'TIMEZONE_ID' | 'ORIGINAL_NAME' | 'IS_ROOT' | 'IS_HR' | 'CODE' | 'SHORT_CODE' | 'ID' | 'OBJECT_ID' | 'ROLE' | 'NOTE' | 'OBJECT_TYPE' | 'ATTRIBUTE_NAME' | 'VALUE_IN_STRING' | 'AVAILABLE_UTC' | 'TREE_ID' | 'TREE_NAME' | 'A_ORIGINAL_NAME' | 'B_ORIGINAL_NAME' | 'LEFT_S_CODE' | 'RIGHT_S_CODE';
 export interface IIntentInputRow {
     readonly row: number;
     readonly inputs: ReadonlyArray<IIntentInputDescriptor>;

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/narration-engine.d.ts

@@ -0,0 +1,44 @@
+import { EnumActionCode } from '../enum-interfaces/action-code.enum';
+import { EnumRCodeForward } from './r-code.enum';
+export interface IIntentNarrationContext {
+    locale: 'vi' | 'en';
+    /** Raw facts from intent input */
+    facts: Record<string, unknown>;
+    /** Resolved human-readable references */
+    resolved: Record<string, string>;
+    /** Temporal interpretation */
+    temporal: {
+        /** Civil date, thường dùng cho CREATE */
+        localDate?: string;
+        /** Canonical IANA timezone */
+        timezoneId?: string;
+        /** Effective window – dùng cho LINK_, SET_ */
+        effective?: {
+            from?: string;
+            to?: string;
+        };
+        /** Moment semantics (optional, advanced) */
+        mode?: 'POINT' | 'RANGE';
+    };
+}
+export interface INarrationClause {
+    when(ctx: IIntentNarrationContext): boolean;
+    render(ctx: IIntentNarrationContext): string;
+}
+export interface IIntentGrammar {
+    intentCode: EnumActionCode;
+    /** Optional R_CODE constraint for this grammar */
+    rCode?: EnumRCodeForward;
+    subject(ctx: IIntentNarrationContext): string;
+    clauses?: ReadonlyArray<INarrationClause>;
+}
+export interface IIntentGrammar {
+    intentCode: EnumActionCode;
+    subject(ctx: IIntentNarrationContext): string;
+    clauses?: ReadonlyArray<INarrationClause>;
+}
+export declare const CreateOrganizationGrammar: IIntentGrammar;
+export declare function narrateIntent(grammar: IIntentGrammar, ctx: IIntentNarrationContext): string;
+export declare const CREATE_O_GRAMMAR: IIntentGrammar;
+export declare const CREATE_S_GRAMMAR: IIntentGrammar;
+export declare const LINK_O_O_GRAMMAR: IIntentGrammar;

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/omega-intent.d.ts

@@ -1,7 +1,9 @@
 import { EnumActionCode } from "./action-code.enum";
+import { IEntityToken } from "./entity-token";
 import { IOmegaValue } from "./others";
 export interface IOmegaIntent {
     readonly seq: number;
     readonly actionCode: EnumActionCode;
     readonly input: Record<string, IOmegaValue>;
+    readonly outputs?: ReadonlyArray<IEntityToken>;
 }

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/omega-projection.vm.d.ts

@@ -1,10 +1,9 @@
 export interface IOmegaProjectionVm {
     intentCount: number;
-    validityLabel: string;
     intents: ReadonlyArray<{
         seq: number;
         actionLabel: string;
-        summary: string;
+        summary?: string;
     }>;
     outputs: ReadonlyArray<{
         key: string;

package/lib/app/libraries/core-dom-decision-editor/enum-interfaces/registries/intent-grammar.registry.d.ts

@@ -0,0 +1,2 @@
+import { IIntentGrammar } from '../narration-engine';
+export declare const INTENT_GRAMMAR_REGISTRY: ReadonlyArray<IIntentGrammar>;

package/lib/app/libraries/core-dom-decision-editor/intent-composer/intent-composer.component.d.ts

@@ -3,11 +3,13 @@ import { IIntentDescriptor, IIntentInputError, IIntentInputRow, IIntentInputVali
 import { IIntentDraft } from '../enum-interfaces/intent-draft.model';
 import { FormBuilder, FormGroup, ValidatorFn } from '@angular/forms';
 import { AlertService } from '../../alert/alert.service';
-import { BehaviorSubject } from 'rxjs';
+import { BehaviorSubject, Subscription } from 'rxjs';
 import { ICoreDropdownOption } from '../../../interfaces/ICoreDropdownOption';
 import { BaseComponent } from '../../base-component/base/base.component';
 import { MultiLanguageService } from '../../../services/multi-language.service';
+import { IDomOIdFactoryEmit } from '../dom-oid-factory/dom-oid-factory.component';
 import { DomDecisionContextService } from '../dom-decision-context.service';
+import { ApplicationHelpService } from '../../../services/application-help.service';
 import * as i0 from "@angular/core";
 export declare class IntentComposerComponent extends BaseComponent {
     mls: MultiLanguageService;
@@ -15,6 +17,7 @@ export declare class IntentComposerComponent extends BaseComponent {
     $descriptor: import("@angular/core").InputSignal<IIntentDescriptor>;
     intentComposed: import("@angular/core").OutputEmitterRef<IIntentDraft>;
     cancelled: import("@angular/core").OutputEmitterRef<void>;
+    hotKeys: string[];
     $draftInput: import("@angular/core").WritableSignal<Record<string, unknown>>;
     $errors: import("@angular/core").WritableSignal<IIntentInputError[]>;
     $checkError: import("@angular/core").WritableSignal<boolean>;
@@ -22,7 +25,13 @@ export declare class IntentComposerComponent extends BaseComponent {
     fb: FormBuilder;
     as: AlertService;
     ctx: DomDecisionContextService;
+    applicationHelpService: ApplicationHelpService;
+    $tokens: import("@angular/core").Signal<import("../enum-interfaces/entity-token").IEntityToken[]>;
     form: FormGroup<{}>;
+    $formRawValue: import("@angular/core").WritableSignal<any>;
+    formSubscription: Subscription;
+    vfUtcSubscription: Subscription;
+    isDevMode: boolean;
     $rowableInputs: import("@angular/core").Signal<readonly IIntentInputRow[]>;
     rCodeOptions$: BehaviorSubject<ICoreDropdownOption[]>;
     roleOptions$: BehaviorSubject<ICoreDropdownOption[]>;
@@ -37,6 +46,10 @@ export declare class IntentComposerComponent extends BaseComponent {
     private buildFallbackErrorMessage;
     getErrorsOfField(fieldKey: string): IIntentInputError[];
     private applyActionSpecificBehavior;
+    onEscape(event: KeyboardEvent): void;
+    private setSnapshot;
+    onOrgResolved(e: IDomOIdFactoryEmit): void;
+    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<IntentComposerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<IntentComposerComponent, "intent-composer", never, { "$descriptor": { "alias": "$descriptor"; "required": true; "isSignal": true; }; }, { "intentComposed": "intentComposed"; "cancelled": "cancelled"; }, never, never, true, never>;
 }

package/lib/app/libraries/core-dropdown/core-dropdown/core-dropdown.component.d.ts

@@ -31,6 +31,7 @@ export declare class CoreDropdownComponent extends CoreFormControlBaseComponent
     optionHttpPayload: any;
     optionValueFrom: string;
     optionTextFrom: string;
+    $disabled: import("@angular/core").InputSignal<boolean>;
     container: ElementRef;
     listenerFn: () => void;
     options: ICoreDropdownOption[];
@@ -61,5 +62,5 @@ export declare class CoreDropdownComponent extends CoreFormControlBaseComponent
     onInPlaceSearchKeydown(e: KeyboardEvent): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CoreDropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CoreDropdownComponent, "core-dropdown", never, { "getByIdObject$": { "alias": "getByIdObject$"; "required": false; }; "paramMode": { "alias": "paramMode"; "required": false; }; "shownFrom": { "alias": "shownFrom"; "required": false; }; "options$": { "alias": "options$"; "required": false; }; "height": { "alias": "height"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "warningDisable": { "alias": "warningDisable"; "required": false; }; "clearDisable": { "alias": "clearDisable"; "required": false; }; "fitHeightWithItemCount": { "alias": "fitHeightWithItemCount"; "required": false; }; "itemHeight": { "alias": "itemHeight"; "required": false; }; "optionApiDriven": { "alias": "optionApiDriven"; "required": false; }; "optionApi": { "alias": "optionApi"; "required": false; }; "optionHttpVerb": { "alias": "optionHttpVerb"; "required": false; }; "optionHttpPayload": { "alias": "optionHttpPayload"; "required": false; }; "optionValueFrom": { "alias": "optionValueFrom"; "required": false; }; "optionTextFrom": { "alias": "optionTextFrom"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CoreDropdownComponent, "core-dropdown", never, { "getByIdObject$": { "alias": "getByIdObject$"; "required": false; }; "paramMode": { "alias": "paramMode"; "required": false; }; "shownFrom": { "alias": "shownFrom"; "required": false; }; "options$": { "alias": "options$"; "required": false; }; "height": { "alias": "height"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "warningDisable": { "alias": "warningDisable"; "required": false; }; "clearDisable": { "alias": "clearDisable"; "required": false; }; "fitHeightWithItemCount": { "alias": "fitHeightWithItemCount"; "required": false; }; "itemHeight": { "alias": "itemHeight"; "required": false; }; "optionApiDriven": { "alias": "optionApiDriven"; "required": false; }; "optionApi": { "alias": "optionApi"; "required": false; }; "optionHttpVerb": { "alias": "optionHttpVerb"; "required": false; }; "optionHttpPayload": { "alias": "optionHttpPayload"; "required": false; }; "optionValueFrom": { "alias": "optionValueFrom"; "required": false; }; "optionTextFrom": { "alias": "optionTextFrom"; "required": false; }; "$disabled": { "alias": "$disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/lib/app/libraries/core-timezone/core-timezone.component.d.ts

@@ -1,13 +1,14 @@
-import { AfterViewInit } from '@angular/core';
+import { AfterViewInit, OnInit } from '@angular/core';
 import { CoreFormControlBaseComponent } from '../core-form-control-base/core-form-control-base.component';
-import { CoreDatetimeService } from '../services/core-datetime.service';
 import { BehaviorSubject } from 'rxjs';
 import { ICoreDropdownOption } from '../../interfaces/ICoreDropdownOption';
+import { AppConfigService } from '../../services/app-config.service';
 import * as i0 from "@angular/core";
-export declare class CoreTimezoneComponent extends CoreFormControlBaseComponent implements AfterViewInit {
-    cdts: CoreDatetimeService;
+export declare class CoreTimezoneComponent extends CoreFormControlBaseComponent implements OnInit, AfterViewInit {
     dropdownOptions$: BehaviorSubject<ICoreDropdownOption[]>;
+    acs: AppConfigService;
     value: string;
+    ngOnInit(): void;
     ngAfterViewInit(): void;
     onValueChange(e: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CoreTimezoneComponent, never>;

package/lib/app/libraries/services/core-datetime.service.d.ts

@@ -1,3 +1,4 @@
+import { AppConfigService } from '../../services/app-config.service';
 import * as i0 from "@angular/core";
 export interface IDataItem {
     date: string;
@@ -23,11 +24,16 @@ export interface IDateRange {
     startDate: Date;
     endDate: Date;
 }
+export type TimeZoneId = {
+    raw: string;
+    canonical: string;
+};
 export declare class CoreDatetimeService {
+    acs: AppConfigService;
     timeZoneOffset: any;
-    $timeZones: import("@angular/core").WritableSignal<string[]>;
+    $knownTimeZones: import("@angular/core").WritableSignal<string[]>;
     constructor();
-    loadFullTimezones(): void;
+    loadKnownTimezoneIdentifiers(): void;
     getMonthText(lang: string, monthIndex: number): string;
     dateToVnString(date: Date): string;
     dateToLocalizedString(value: Date, lang: string): string;
@@ -79,6 +85,7 @@ export declare class CoreDatetimeService {
      * @returns Date representing the same civil day in local runtime timezone
      */
     interpretDateInTimezone(date: Date, timezoneId: string): Date;
+    canonicalizeTimeZone(tz: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CoreDatetimeService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CoreDatetimeService>;
 }

package/lib/app/services/app-config.service.d.ts

@@ -3,6 +3,8 @@ import * as i0 from "@angular/core";
 export declare class AppConfigService {
     APP_TYPE: string;
     DEFAULT_IANA_TIMEZONE_ID: string;
+    CANONICAL_IANA_TIMEZONES: string[];
+    DOM_VERSION: string;
     APP_UIID: string;
     ALLOW_IN_APP_NOTIFICATION: boolean;
     SHOW_LOGIN_NOTIFICATION: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ngx-histaff-alpha",
-  "version": "6.7.4",
-  "description": "6.7.4: Fix(WFE_Email: save delegatedReact)",
+  "version": "6.7.5",
+  "description": "6.7.5: Feat(DOM in progress)",
   "peerDependencies": {
     "@angular/common": "^19.0.1",
     "@angular/core": "^19.0.1"