@masterteam/task-schedule 0.0.2 → 0.0.3

package/README.md

@@ -14,16 +14,17 @@ Syncfusion Gantt based task-schedule package with external model switching.
 - `TaskScheduleContext`
 - `TASK_SCHEDULE_DEFAULT_PDF_FONT`
 
-## Inputs
-
-- `modelType`: `'default' | 'edit' | 'baseline' | 'criticalPath' | 'critical-path' | 'resources' | 'unscheduled' | 'phaseGate' | 'phase-gate' | 'custom'`
-- `context`: object with required `levelId` and `levelDataId` for runtime tree loading, plus optional `customViewId`, etc.
-- `dateFormat`: default `dd/MM/yyyy`
-- `height`: default `760px`
-- `langCode`: `'en' | 'ar' | null` (optional; auto-resolves from context/localStorage/document)
-- `pdfFontData`: optional base64 TTF string for PDF export font
-- `pdfRtlFontData`: optional base64 TTF string used in RTL/Arabic PDF export
-- `pdfFontSize`: optional PDF font size (default `11`)
+## Inputs
+
+- `context`: object with required `levelId` and `levelDataId` for fetch-based schedule reads
+
+Main context fields:
+
+- `modelType`: `'default' | 'edit' | 'baseline' | 'criticalPath' | 'critical-path' | 'resources' | 'unscheduled' | 'phaseGate' | 'custom'`
+- `langCode`: `'en' | 'ar' | null`
+- `dateFormat`: default `dd/MM/yyyy`
+- `height`: default `760px`
+- `pdfFonts`: optional `{ regular?: string; arabic?: string; size?: number }`
 
 ## Outputs
 
@@ -55,13 +56,16 @@ import {
   standalone: true,
   imports: [TaskSchedule],
   selector: 'app-task-schedule-host',
-  template: `
-    <mt-task-schedule
-      [modelType]="modelType()"
-      [context]="{ levelId: 12, levelDataId: 18 }"
-      [langCode]="'en'"
-    />
-  `,
+  template: `
+    <mt-task-schedule
+      [context]="{
+        levelId: 12,
+        modelType: modelType(),
+        levelDataId: 18,
+        langCode: 'en'
+      }"
+    />
+  `,
   providers: [
     {
       provide: TASK_SCHEDULE_DATA_ADAPTER,
@@ -74,17 +78,19 @@ export class TaskScheduleHostComponent {
 }
 ```
 
-The component uses `TaskScheduleBackendAdapter` by default.
-
+The component uses `TaskScheduleBackendAdapter` by default.
+
 Backend routes used:
 
-- Runtime tree (default/edit/baseline/critical/custom): `GET /api/levels/{levelId}/{levelDataId}/schedule/tree`
-- Runtime phase gate tree: `GET /api/levels/{levelId}/{levelDataId}/schedule/tree?renderMode=PhaseGate`
+- Mixed schedule reads (default/edit/critical/custom): `POST /api/levels/{levelId}/{levelDataId}/schedule/query`
+- Runtime baseline snapshot view: `GET /api/levels/{levelId}/{levelDataId}/schedule/baselines/latest`
 - Runtime unscheduled: `GET /api/levels/{levelId}/{levelDataId}/schedule/unscheduled`
 - Runtime resource mode: `GET /api/levels/{levelId}/{levelDataId}/schedule/by-resource`
 - Custom view config: `GET /api/schedulemanager/{levelId}/schedule/{customViewId}`
 - Team members (edit/resources mode): `GET /api/levels/{levelId}/TeamMember`
 
+Phase-gate runtime reads are handled separately in the app-client phase-gate flow and are not part of this package migration.
+
 Runtime mutations (when `levelDataId` exists):
 
 - `POST /api/levels/{levelId}/{levelDataId}/schedule`
@@ -96,16 +102,19 @@ Runtime mutations (when `levelDataId` exists):
 - `POST /api/levels/{levelId}/{levelDataId}/schedule/baselines` (set baseline)
 - `GET /api/levels/{levelId}/{levelDataId}/schedule/mpp` (export)
 
-Legacy `/api/tasks/...` routes are kept as fallback when `levelDataId` is not provided or when `context.endpoints` overrides are supplied.
-Import modal keeps legacy preview/apply defaults (`POST /api/tasks/mmp/import`, then apply endpoint), unless `endpoints.importTasks` / `endpoints.applyImportedTasks` are overridden.
+Plain schedule reads no longer use legacy `/api/tasks/...` read routes.
+Import modal keeps its current MPP preview/apply flow unless `endpoints.importTasks` / `endpoints.applyImportedTasks` are overridden.
 
 Context options for backend routing:
 
 - `apiBaseUrl`: optional base URL prefix
-- `schemaId`: optional legacy API schema id (used only for legacy fallback routes)
+- `modelType`: selected schedule mode
+- `langCode`: optional language override
+- `dateFormat`: optional gantt date format
+- `height`: optional gantt height
 - `customViewId`: used in `custom` mode to load schedule-manager view columns
 - `resources`: optional static resource list override
-- `endpoints`: optional endpoint template overrides (`scheduleTree`, `scheduleViewById`, `teamMembers`, `createTask`, etc.)
+- `endpoints`: optional endpoint template overrides (`scheduleTreePhaseGate`, `scheduleViewById`, `teamMembers`, `createTask`, etc.)
 - `endpoints.importTasks` / `endpoints.applyImportedTasks`: optional overrides for runtime/legacy MPP import flow
 - `endpoints.setBaseline`: optional override for baseline endpoint (runtime default: `/api/levels/{levelId}/{levelDataId}/schedule/baselines`)
 - `endpoints.exportTasks`: optional override for export endpoint (runtime default: `/api/levels/{levelId}/{levelDataId}/schedule/mpp`)
@@ -120,22 +129,23 @@ Use `mt-task-schedule-import-modal` to import `.mpp`/`.xer` files and apply task
 The modal is Tailwind-based and uses `@masterteam/components` (`mt-button`, `mt-entity-preview`).
 Imported rows support inline editing before apply (task name, planned/actual dates, assignee, progress) with per-row selection.
 
-## Shell Component
-
-Use `mt-task-schedule-shell` as the package-level host that combines:
+## Shell Component
+
+Use `mt-task-schedule-shell` as the package-level host that combines:
 
 - mode switcher
 - Set Baseline action (adapter `setBaseline`)
 - Import modal orchestration
 - Export tasks action (adapter `exportTasks`)
 
-Shell parity control inputs:
-
-- `allowEditMode`
-- `allowImport`
-- `allowSetBaseline`
-- `hasTasks`
-- `baselinePending`
+Shell parity control fields also live on `context`:
+
+- `modeOptions`
+- `allowEditMode`
+- `allowImport`
+- `allowSetBaseline`
+- `hasTasks`
+- `baselinePending`
 
 Use one adapter service per selector/source if needed. The component does not use NGXS.