@masterteam/work-center 0.0.71 → 0.0.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/work-center",
-  "version": "0.0.71",
+  "version": "0.0.72",
   "publishConfig": {
     "directory": "../../../dist/masterteam/work-center",
     "linkDirectory": false,
@@ -20,12 +20,12 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/forms": "^0.0.133",
-    "@masterteam/components": "^0.0.253",
-    "@masterteam/client-components": "^0.0.71",
+    "@masterteam/client-components": "^0.0.72",
+    "@masterteam/discussion": "^0.0.26",
     "@masterteam/icons": "^0.0.17",
-    "@masterteam/structure-builder": "^0.0.62",
-    "@masterteam/discussion": "^0.0.26"
+    "@masterteam/components": "^0.0.254",
+    "@masterteam/forms": "^0.0.130",
+    "@masterteam/structure-builder": "^0.0.62"
   },
   "sideEffects": false,
   "exports": {

package/types/masterteam-work-center.d.ts

@@ -4,7 +4,7 @@ import * as _masterteam_components_statistic_card from '@masterteam/components/s
 import { StatisticCardData } from '@masterteam/components/statistic-card';
 import * as _masterteam_work_center from '@masterteam/work-center';
 import * as _angular_core from '@angular/core';
-import { Type } from '@angular/core';
+import { Type, InjectionToken, OnDestroy } from '@angular/core';
 import { ClientPageMenuItem } from '@masterteam/components/client-page-menu';
 import { PropertyFilterBuilderSchema, PropertyFilterBuilderRule } from '@masterteam/components/property-filter-builder';
 import { ClientLookup, ClientForm, ProcessFormSubmitResponse } from '@masterteam/forms/client-form';
@@ -12,6 +12,7 @@ import { LoadingStateShape } from '@masterteam/components';
 import { ModalRef } from '@masterteam/components/dialog';
 import { DrawerController } from '@masterteam/components/dynamic-drawer';
 import { ModalService } from '@masterteam/components/modal';
+import { EntityData } from '@masterteam/components/entities';
 import * as rxjs from 'rxjs';
 import * as _masterteam_components_types_masterteam_components_statistic_card from '@masterteam/components/types/masterteam-components-statistic-card';
 import * as _masterteam_components_types_masterteam_components_table from '@masterteam/components/types/masterteam-components-table';
@@ -465,9 +466,26 @@ declare class WorkCenterClientFormModal {
 }
 
 declare class WorkCenterItemModal {
+    private readonly registry;
     readonly details: _angular_core.InputSignal<WorkCenterItemBasicInfoData>;
     readonly lookups: _angular_core.InputSignal<WorkCenterLookups | null>;
     readonly readOnly: _angular_core.InputSignal<boolean>;
+    /**
+     * The request's operation key, read from the item context.
+     *
+     * `LevelData.PublishSchedule` is dispatched on THIS rather than on a new
+     * `type` value: the request arrives under the existing `ProcessStep` /
+     * `ProcessRequest` types, so no published Work Center contract shifts.
+     */
+    protected readonly operationKey: _angular_core.Signal<string>;
+    protected readonly isSchedulePublish: _angular_core.Signal<boolean>;
+    /**
+     * A host-registered renderer for this item, if one is registered. Checked
+     * before the built-in chain, keyed by `operationKey:<key>` first so a host can
+     * specialise an existing type without replacing it wholesale.
+     */
+    protected readonly registeredComponent: _angular_core.Signal<Type<unknown> | null>;
+    protected readonly registeredInputs: _angular_core.Signal<Record<string, unknown>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WorkCenterItemModal, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<WorkCenterItemModal, "mt-work-center-item-modal", never, { "details": { "alias": "details"; "required": true; "isSignal": true; }; "lookups": { "alias": "lookups"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -516,6 +534,285 @@ declare class WorkCenterItemModalRoute {
 declare function encodeWorkCenterRouteContextKey(contextKey: WorkCenterItemContextKey): string;
 declare function decodeWorkCenterRouteContextKey(value: WorkCenterItemContextKey | null): WorkCenterItemContextKey | null;
 
+/**
+ * A detail component a host can register for a Work Center item, keyed by the
+ * item's `type` or - for operations that reuse an existing type - by
+ * `operationKey:<OperationKey>`.
+ *
+ * Every registered component must accept the same three inputs the built-in
+ * types do, so the modal can mount any of them the same way.
+ */
+interface WorkCenterTypeComponentInputs {
+    details: WorkCenterItemBasicInfoData;
+    lookups?: unknown;
+    readOnly?: boolean;
+}
+/**
+ * Host-side registration for Work Center detail renderers.
+ *
+ * The built-in dispatch is a hardcoded `@if` chain, so every new request type
+ * has meant a package release. This token is the seam that makes the NEXT one a
+ * host registration instead. It is strictly additive: entries here are consulted
+ * before the built-in chain, so an unregistered host behaves exactly as before.
+ *
+ * Key by `operationKey:<OperationKey>` when the request arrives under an
+ * existing `type` - which is how `LevelData.PublishSchedule` is dispatched,
+ * deliberately avoiding a shift in the published `type` contract.
+ *
+ * @example
+ * providers: [
+ *   {
+ *     provide: WORK_CENTER_TYPE_COMPONENTS,
+ *     useValue: { 'operationKey:ApproveBudget': ApproveBudgetType },
+ *   },
+ * ]
+ */
+declare const WORK_CENTER_TYPE_COMPONENTS: InjectionToken<Record<string, Type<unknown>>>;
+
+/**
+ * work-center-schedule-publish.models.ts - The wire shape of the published-vs-draft
+ * comparison an approver acts on.
+ *
+ * Mirrors the backend's `SchedulePublishDiffDto`, which `process-form-load`
+ * returns as a REQUEST-level `schedulePublish` block for
+ * `LevelData.PublishSchedule`. It is request-level rather than hung off a form
+ * field because a publish submits no fields - the plan IS the payload.
+ *
+ * The same vocabulary is used by the schedule read envelope and the Review &
+ * Publish drawer in `@masterteam/task-schedule`, deliberately: one differ serves
+ * all three, so the planner who requested the publish and the approver deciding
+ * on it cannot be shown the same row described differently.
+ *
+ * Pure TypeScript - no Angular, no DOM.
+ */
+/**
+ * `'removed'` means a row that is in the published snapshot but no longer in the
+ * plan. `'unchanged'` never reaches the comparison payload - the drawer shows
+ * what is being published, not the whole plan.
+ */
+type SchedulePublishState = 'added' | 'changed' | 'removed' | 'unchanged';
+interface SchedulePublishFieldChange {
+    /** Authored field key, e.g. `plannedStart`. */
+    field: string;
+    /**
+     * How each side should be RENDERED - Text, Date, Number, Percentage or User.
+     * Carried per change so a date shows as a date and a user as an avatar rather
+     * than as the stored string.
+     */
+    viewType?: string | null;
+    publishedValue?: unknown;
+    currentValue?: unknown;
+}
+interface SchedulePublishDiffRow {
+    scheduleItemId: number;
+    state: SchedulePublishState;
+    /** Current name, falling back to the published name for a removed row. */
+    name: string;
+    /** Module key - `Task`, `Milestone` or `Deliverable`. */
+    type?: string | null;
+    parentId?: number | null;
+    order?: number | null;
+    isSummary?: boolean | null;
+    /** False for a removed row. */
+    existsInCurrentSchedule?: boolean | null;
+    /** False for an added row - it has never been announced. */
+    existsInPublishedSchedule?: boolean | null;
+    /**
+     * Populated for `changed` only. Added and removed rows carry no per-field
+     * list: the whole row is the change.
+     */
+    changes?: SchedulePublishFieldChange[] | null;
+}
+interface SchedulePublishDiff {
+    levelDataId?: number | null;
+    /**
+     * False when the project has never been published, in which case `rows` is
+     * empty and the whole plan is implicitly unannounced. The approver is told
+     * something different about that than about "nothing to publish".
+     */
+    hasSnapshot?: boolean | null;
+    lastPublishedAtUtc?: string | null;
+    lastPublishedBy?: string | null;
+    addedCount?: number | null;
+    changedCount?: number | null;
+    removedCount?: number | null;
+    unpublishedChangeCount?: number | null;
+    rows?: SchedulePublishDiffRow[] | null;
+}
+/** The slice of `process-form-load` this type consumes. */
+interface SchedulePublishFormLoadResponse {
+    schedulePublish?: SchedulePublishDiff | null;
+    requestId?: number | null;
+    /** Tolerated because several runtime endpoints wrap their payload. */
+    data?: SchedulePublishFormLoadResponse | null;
+}
+
+/**
+ * work-center-schedule-publish.rows.ts - Pure grouping, ordering, counting and
+ * filtering rules for the approver's published-vs-draft comparison.
+ *
+ * THE DIFF ITSELF IS SERVER-SIDE. This module never decides what changed - only
+ * how the answer is presented, so a 500-row plan stays scannable in a drawer.
+ * Split out of the component so the rules are unit-testable without a browser or
+ * TestBed, mirroring `work-center-process-preview.rows.ts` - this package has no
+ * component TestBed specs, only pure-function ones.
+ *
+ * Intentionally a twin of `@masterteam/task-schedule`'s
+ * `core/task-schedule-publish-diff.ts`: the planner and the approver must sort,
+ * group and count the same payload identically, and duplicating ~100 lines of
+ * pure rules is cheaper than a cross-package dependency between a schedule
+ * runtime and a work-center drawer.
+ *
+ * Pure TypeScript - no Angular, no DOM.
+ */
+
+/**
+ * The order groups are presented in, and the only states a group is built for.
+ *
+ * Added first because a new row is the biggest claim a publish makes; removed
+ * last because it is the one an approver most needs to not miss, and a trailing
+ * group is where the eye stops.
+ */
+declare const SCHEDULE_PUBLISH_GROUP_ORDER: readonly SchedulePublishState[];
+interface SchedulePublishGroup {
+    state: SchedulePublishState;
+    rows: SchedulePublishDiffRow[];
+    /** Rows in this group BEFORE the search filter - the badge count stays honest. */
+    totalCount: number;
+}
+interface SchedulePublishSummary {
+    hasSnapshot: boolean;
+    addedCount: number;
+    changedCount: number;
+    removedCount: number;
+    totalCount: number;
+    /** True when there is genuinely nothing to publish (as opposed to never published). */
+    isEmpty: boolean;
+}
+declare function summarizeSchedulePublish(diff: SchedulePublishDiff | null | undefined): SchedulePublishSummary;
+/**
+ * Group the comparison for display, optionally narrowed by a free-text search.
+ *
+ * Search matches a row's NAME and its changed FIELD KEYS, so "start" finds every
+ * row whose planned start moved even though that text appears nowhere in a name.
+ * Empty groups are dropped rather than rendered as empty headers.
+ */
+declare function groupSchedulePublishRows(diff: SchedulePublishDiff | null | undefined, searchText?: string): SchedulePublishGroup[];
+/**
+ * Plan order, falling back to the row id.
+ *
+ * Deliberately NOT alphabetical: an approver reads the comparison against the
+ * plan as the planner built it, and re-sorting by name would scatter a phase's
+ * rows across the list.
+ */
+declare function sortSchedulePublishRows(rows: readonly SchedulePublishDiffRow[]): SchedulePublishDiffRow[];
+declare function matchesSchedulePublishSearch(row: SchedulePublishDiffRow, lowerNeedle: string): boolean;
+/**
+ * A stable per-row key for `@for` tracking.
+ *
+ * Includes the state because the SAME schedule item id can legitimately appear
+ * under two groups across a re-render (a row removed then re-added), and reusing
+ * a DOM node across that transition would carry the old group's styling.
+ */
+declare function schedulePublishRowKey(row: SchedulePublishDiffRow): string;
+/**
+ * Changed fields in the order the backend classified them, with blanks dropped.
+ * Added and removed rows have no per-field list - the whole row is the change.
+ */
+declare function readSchedulePublishChanges(row: SchedulePublishDiffRow | null | undefined): SchedulePublishFieldChange[];
+/**
+ * Windowing for a plan large enough to stall a drawer. Returns the first
+ * `limit` rows and how many were withheld, so the caller can say so out loud
+ * rather than silently truncating a comparison someone is approving.
+ */
+declare function windowSchedulePublishRows(rows: readonly SchedulePublishDiffRow[], limit: number): {
+    rows: SchedulePublishDiffRow[];
+    hiddenCount: number;
+};
+
+/**
+ * The operation key this type renders for. Dispatch is by OPERATION KEY, not by
+ * a new `type` value: the request arrives under the existing `ProcessStep` /
+ * `ProcessRequest` types, so no published Work Center contract shifts.
+ */
+declare const SCHEDULE_PUBLISH_OPERATION_KEY = "PublishSchedule";
+/**
+ * The approver's view of a `LevelData.PublishSchedule` request.
+ *
+ * Exists because the closest existing zero-field action renders a title, a due
+ * date and three buttons: without this an approver would be asked to authorise a
+ * change to the plan of record while being shown less than the planner who
+ * requested it.
+ *
+ * The comparison is the diff FROZEN AT SUBMIT on the backend, not the live one,
+ * so the plan cannot move under the approver while they read it.
+ */
+declare class WorkCenterSchedulePublishType implements OnDestroy {
+    private readonly http;
+    private readonly transloco;
+    private readonly destroyRef;
+    private loadSub?;
+    readonly details: _angular_core.InputSignal<WorkCenterItemBasicInfoData>;
+    readonly readOnly: _angular_core.InputSignal<boolean>;
+    protected readonly activeTab: _angular_core.WritableSignal<string>;
+    private readonly activeLang;
+    protected readonly loading: _angular_core.WritableSignal<boolean>;
+    protected readonly error: _angular_core.WritableSignal<string | null>;
+    protected readonly diff: _angular_core.WritableSignal<SchedulePublishDiff | null>;
+    protected readonly searchText: _angular_core.WritableSignal<string>;
+    protected readonly expandedRowKeys: _angular_core.WritableSignal<ReadonlySet<string>>;
+    protected readonly itemContext: _angular_core.Signal<Record<string, unknown> | null>;
+    protected readonly requestId: _angular_core.Signal<number | undefined>;
+    protected readonly levelId: _angular_core.Signal<number | undefined>;
+    protected readonly levelDataId: _angular_core.Signal<number | undefined>;
+    protected readonly moduleKey: _angular_core.Signal<string>;
+    protected readonly requestSchemaId: _angular_core.Signal<number | undefined>;
+    protected readonly summary: _angular_core.Signal<_masterteam_work_center.SchedulePublishSummary>;
+    protected readonly groups: _angular_core.Signal<SchedulePublishGroup[]>;
+    protected readonly hasSearch: _angular_core.Signal<boolean>;
+    /** True when the search hid everything, as opposed to there being nothing to publish. */
+    protected readonly searchFoundNothing: _angular_core.Signal<boolean>;
+    protected readonly resolvedRequestId: _angular_core.Signal<number>;
+    protected readonly canRenderPreview: _angular_core.Signal<boolean>;
+    protected readonly canRenderDiscussion: _angular_core.Signal<boolean>;
+    protected readonly tabOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+        icon: string;
+    }[]>;
+    constructor();
+    ngOnDestroy(): void;
+    protected onSearch(value: string): void;
+    protected toggleRow(row: SchedulePublishDiffRow): void;
+    protected isExpanded(row: SchedulePublishDiffRow): boolean;
+    protected rowKey(row: SchedulePublishDiffRow): string;
+    protected visibleRows(group: SchedulePublishGroup): SchedulePublishDiffRow[];
+    protected hiddenCount(group: SchedulePublishGroup): number;
+    protected changesFor(row: SchedulePublishDiffRow): SchedulePublishFieldChange[];
+    /**
+     * Only `changed` rows have per-field detail worth expanding. For added and
+     * removed rows the whole row IS the change, so an expander would open onto
+     * nothing.
+     */
+    protected isExpandable(row: SchedulePublishDiffRow): boolean;
+    protected groupBadgeClass(state: string): string;
+    protected groupLabel(state: string): string;
+    /**
+     * The field key as a human label, falling back to the key itself on a missing
+     * translation rather than rendering `workCenter.publish.field.plannedStart`.
+     */
+    protected fieldLabel(field: string): string;
+    /**
+     * One side of a field change, projected into an `EntityData` so it renders
+     * through its NATIVE view type - a date as a date, a user as an avatar -
+     * rather than as the stored string.
+     */
+    protected sideEntity(change: SchedulePublishFieldChange, side: 'published' | 'current'): EntityData;
+    private loadComparison;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WorkCenterSchedulePublishType, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WorkCenterSchedulePublishType, "mt-work-center-schedule-publish-type", never, { "details": { "alias": "details"; "required": true; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class EnterArea {
     area: WorkCenterArea;
     static readonly type = "[WorkCenter] Enter Area";
@@ -716,5 +1013,5 @@ declare class WorkCenterState {
 
 declare const APP_STATES: (typeof WorkCenterState)[];
 
-export { APP_STATES, ApplyColumnFilters, ApplyHeaderFilters, ClearAllFilters, EnterArea, HydrateFromContext, LoadRuntime, SelectCard, SetGroupBy, SetLookups, SetParams, WORK_CENTER_EMPTY_LABEL, WORK_CENTER_GROUP_NONE, WORK_CENTER_LEVEL_GROUP_FIELD, WORK_CENTER_LEVEL_NAME_KEY, WORK_CENTER_MAX_FILTERS, WORK_CENTER_MAX_PAGE_SIZE, WORK_CENTER_MAX_SORT, WORK_CENTER_QUERY_VERSION, WorkCenterActionKey, WorkCenterClientFormModal, WorkCenterFacade, WorkCenterItemModal, WorkCenterItemModalRoute, WorkCenterPage, WorkCenterState, decodeWorkCenterRouteContextKey, encodeWorkCenterRouteContextKey };
-export type { ApiEnvelope, TranslatableDto, WorkCenterArea, WorkCenterAreaState, WorkCenterBootstrapInputs, WorkCenterClientFormModalData, WorkCenterClientFormModalOptions, WorkCenterColumnsConfig, WorkCenterContext, WorkCenterFilterOperator, WorkCenterFilterRule, WorkCenterHydratePatch, WorkCenterItemActionAfterSuccess, WorkCenterItemActionExecutionResult, WorkCenterItemActionsData, WorkCenterItemBasicInfoData, WorkCenterItemContextKey, WorkCenterItemModalComponentInput, WorkCenterItemModalOptions, WorkCenterLoadReason, WorkCenterLookups, WorkCenterPreviewLevelTarget, WorkCenterRuntimeCard, WorkCenterRuntimeFilterSchema, WorkCenterRuntimeItemAction, WorkCenterRuntimeOperatorOption, WorkCenterRuntimePagination, WorkCenterRuntimeProperty, WorkCenterRuntimeRequest, WorkCenterRuntimeResponseData, WorkCenterRuntimeSelectedCard, WorkCenterRuntimeStatsItem, WorkCenterRuntimeWarningDto, WorkCenterSortRule, WorkCenterStateModel };
+export { APP_STATES, ApplyColumnFilters, ApplyHeaderFilters, ClearAllFilters, EnterArea, HydrateFromContext, LoadRuntime, SCHEDULE_PUBLISH_GROUP_ORDER, SCHEDULE_PUBLISH_OPERATION_KEY, SelectCard, SetGroupBy, SetLookups, SetParams, WORK_CENTER_EMPTY_LABEL, WORK_CENTER_GROUP_NONE, WORK_CENTER_LEVEL_GROUP_FIELD, WORK_CENTER_LEVEL_NAME_KEY, WORK_CENTER_MAX_FILTERS, WORK_CENTER_MAX_PAGE_SIZE, WORK_CENTER_MAX_SORT, WORK_CENTER_QUERY_VERSION, WORK_CENTER_TYPE_COMPONENTS, WorkCenterActionKey, WorkCenterClientFormModal, WorkCenterFacade, WorkCenterItemModal, WorkCenterItemModalRoute, WorkCenterPage, WorkCenterSchedulePublishType, WorkCenterState, decodeWorkCenterRouteContextKey, encodeWorkCenterRouteContextKey, groupSchedulePublishRows, matchesSchedulePublishSearch, readSchedulePublishChanges, schedulePublishRowKey, sortSchedulePublishRows, summarizeSchedulePublish, windowSchedulePublishRows };
+export type { ApiEnvelope, SchedulePublishDiff, SchedulePublishDiffRow, SchedulePublishFieldChange, SchedulePublishFormLoadResponse, SchedulePublishGroup, SchedulePublishState, SchedulePublishSummary, TranslatableDto, WorkCenterArea, WorkCenterAreaState, WorkCenterBootstrapInputs, WorkCenterClientFormModalData, WorkCenterClientFormModalOptions, WorkCenterColumnsConfig, WorkCenterContext, WorkCenterFilterOperator, WorkCenterFilterRule, WorkCenterHydratePatch, WorkCenterItemActionAfterSuccess, WorkCenterItemActionExecutionResult, WorkCenterItemActionsData, WorkCenterItemBasicInfoData, WorkCenterItemContextKey, WorkCenterItemModalComponentInput, WorkCenterItemModalOptions, WorkCenterLoadReason, WorkCenterLookups, WorkCenterPreviewLevelTarget, WorkCenterRuntimeCard, WorkCenterRuntimeFilterSchema, WorkCenterRuntimeItemAction, WorkCenterRuntimeOperatorOption, WorkCenterRuntimePagination, WorkCenterRuntimeProperty, WorkCenterRuntimeRequest, WorkCenterRuntimeResponseData, WorkCenterRuntimeSelectedCard, WorkCenterRuntimeStatsItem, WorkCenterRuntimeWarningDto, WorkCenterSortRule, WorkCenterStateModel, WorkCenterTypeComponentInputs };