@masterteam/system-settings 0.0.9 → 0.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/system-settings",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "publishConfig": {
     "directory": "../../../dist/masterteam/system-settings",
     "linkDirectory": false,
@@ -19,7 +19,7 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/components": "^0.0.225",
+    "@masterteam/components": "^0.0.231",
     "@masterteam/icons": "^0.0.17"
   },
   "sideEffects": false,

package/types/masterteam-system-settings.d.ts

@@ -76,28 +76,34 @@ interface SmtpSettingValue extends SystemSettingObject {
     host: string;
     port: number | null;
 }
+/** The landing view the app-client explore page opens with. */
+type ExploreDefaultView = 'cards' | 'timeline';
+/**
+ * General Configuration is persisted **inside the existing `Identity` record**
+ * (the same record `@masterteam/brand-display` owns), not under a key of its own.
+ * It is therefore a *slice* of `Identity`: reads pick these fields out, and saves
+ * must spread the untouched `Identity` value around them so no branding data is
+ * lost. See `GENERAL_CONFIGURATION_SETTING_KEY`.
+ */
+interface GeneralConfigurationSettingValue extends SystemSettingObject {
+    defaultExploreView: ExploreDefaultView;
+}
+/** The settings record General Configuration fields live in. */
+declare const GENERAL_CONFIGURATION_SETTING_KEY = "Identity";
+type TimeSheetFrequency = 'Daily' | 'Weekly' | 'BiWeekly' | 'Monthly';
 interface TimeSheetPolicySettingValue extends SystemSettingObject {
-    weekStartDay: number;
-    generationEnabled: boolean;
-    manualGenerationEnabled: boolean;
-    regularDailyHours: number;
+    frequency: TimeSheetFrequency;
     maxDailyHours: number;
-    allowOvertime: boolean;
-    requireOvertimeReason: boolean;
     requireDescription: boolean;
     allowFutureEntry: boolean;
-    pastEntryLockDays: number | null;
-    allowedScheduleItemTypes: string[];
-    assignedItemsOnly: boolean;
-    allowZeroHourSubmit: boolean;
-    costEnabled: boolean;
-    rateSource: string;
+    allowBackdatedEntry: boolean;
+    autoLockOnApprove: boolean;
+    submissionDeadlineDays: number;
 }
 interface GlobalWorkingHoursSettingValue extends SystemSettingObject {
     timeZoneId: string;
-    workDayStartMinute: number;
-    workDayEndMinute: number;
     workingDays: number[];
+    hoursPerDay: number;
     holidays: string[];
 }
 interface CurrencyCatalogItem {
@@ -114,6 +120,10 @@ interface SelectOption {
 interface WeekendDayOption extends SelectOption {
     dayNumber: number;
 }
+/** A `SelectOption` rendered as a radio card, so it carries its own icon. */
+interface IconSelectOption extends SelectOption {
+    icon: string;
+}
 interface ScheduleItemTypeOption extends SelectOption {
     itemType: string;
 }
@@ -125,6 +135,7 @@ interface HolidayTableRow {
     to: string;
 }
 interface SystemSettingsSnapshot {
+    generalConfiguration: GeneralConfigurationSettingValue;
     holidays: HolidaysSettingValue;
     timezone: TimezoneSettingValue;
     currency: CurrencySettingValue;
@@ -134,6 +145,9 @@ interface SystemSettingsSnapshot {
     globalWorkingHours: GlobalWorkingHoursSettingValue;
 }
 type SystemSettingsForm = FormGroup<{
+    generalConfiguration: FormGroup<{
+        defaultExploreView: FormControl<ExploreDefaultView>;
+    }>;
     timezone: FormGroup<{
         regionId: FormControl<string | null>;
         dateFormat: FormControl<string | null>;
@@ -154,31 +168,36 @@ type SystemSettingsForm = FormGroup<{
         port: FormControl<string>;
     }>;
     timeSheetPolicy: FormGroup<{
-        weekStartDay: FormControl<number | null>;
-        generationEnabled: FormControl<boolean>;
-        manualGenerationEnabled: FormControl<boolean>;
-        regularDailyHours: FormControl<number | null>;
+        frequency: FormControl<TimeSheetFrequency | null>;
         maxDailyHours: FormControl<number | null>;
-        allowOvertime: FormControl<boolean>;
-        requireOvertimeReason: FormControl<boolean>;
         requireDescription: FormControl<boolean>;
         allowFutureEntry: FormControl<boolean>;
-        pastEntryLockDays: FormControl<number | null>;
-        allowedScheduleItemTypes: FormControl<string[]>;
-        assignedItemsOnly: FormControl<boolean>;
-        allowZeroHourSubmit: FormControl<boolean>;
-        costEnabled: FormControl<boolean>;
-        rateSource: FormControl<string | null>;
+        allowBackdatedEntry: FormControl<boolean>;
+        autoLockOnApprove: FormControl<boolean>;
+        submissionDeadlineDays: FormControl<number | null>;
     }>;
     globalWorkingHours: FormGroup<{
         timeZoneId: FormControl<string | null>;
-        workDayStart: FormControl<string>;
-        workDayEnd: FormControl<string>;
         workingDays: FormControl<number[]>;
+        hoursPerDay: FormControl<number | null>;
         holidaysCsv: FormControl<string>;
     }>;
 }>;
 declare const FIXED_CURRENCIES: CurrencyCatalogItem[];
+/**
+ * Explore landing views, mirroring the app-client explore header switcher
+ * (same icons) so the configured default reads as the same choice.
+ */
+declare const EXPLORE_DEFAULT_VIEW_OPTIONS: readonly [{
+    readonly id: "cards";
+    readonly translationKey: "explore-default-view-cards";
+    readonly icon: "layout.grid-01";
+}, {
+    readonly id: "timeline";
+    readonly translationKey: "explore-default-view-timeline";
+    readonly icon: "time.clock";
+}];
+declare const DEFAULT_GENERAL_CONFIGURATION: GeneralConfigurationSettingValue;
 declare const DEFAULT_DATE_FORMAT_OPTIONS: FormatSchemaOption[];
 declare const DEFAULT_TIME_FORMAT_OPTIONS: FormatSchemaOption[];
 declare const WEEKEND_DAY_DEFINITIONS: readonly [{
@@ -225,6 +244,19 @@ declare const DOTNET_DAY_DEFINITIONS: readonly [{
     readonly dayNumber: 6;
     readonly translationKey: "saturday";
 }];
+declare const TIMESHEET_FREQUENCY_OPTIONS: readonly [{
+    readonly id: "Daily";
+    readonly translationKey: "frequency-daily";
+}, {
+    readonly id: "Weekly";
+    readonly translationKey: "frequency-weekly";
+}, {
+    readonly id: "BiWeekly";
+    readonly translationKey: "frequency-biweekly";
+}, {
+    readonly id: "Monthly";
+    readonly translationKey: "frequency-monthly";
+}];
 declare const SCHEDULE_ITEM_TYPE_OPTIONS: readonly [{
     readonly itemType: "Task";
     readonly translationKey: "schedule-item-task";
@@ -276,6 +308,9 @@ declare class SystemSettings implements OnInit {
     readonly selectedTimeFormat: _angular_core.Signal<string | null>;
     readonly selectedCurrencyCode: _angular_core.Signal<string | null>;
     readonly formValue: _angular_core.Signal<Partial<{
+        generalConfiguration: Partial<{
+            defaultExploreView: ExploreDefaultView;
+        }>;
         timezone: Partial<{
             regionId: string | null;
             dateFormat: string | null;
@@ -296,30 +331,24 @@ declare class SystemSettings implements OnInit {
             port: string;
         }>;
         timeSheetPolicy: Partial<{
-            weekStartDay: number | null;
-            generationEnabled: boolean;
-            manualGenerationEnabled: boolean;
-            regularDailyHours: number | null;
+            frequency: TimeSheetFrequency | null;
             maxDailyHours: number | null;
-            allowOvertime: boolean;
-            requireOvertimeReason: boolean;
             requireDescription: boolean;
             allowFutureEntry: boolean;
-            pastEntryLockDays: number | null;
-            allowedScheduleItemTypes: string[];
-            assignedItemsOnly: boolean;
-            allowZeroHourSubmit: boolean;
-            costEnabled: boolean;
-            rateSource: string | null;
+            allowBackdatedEntry: boolean;
+            autoLockOnApprove: boolean;
+            submissionDeadlineDays: number | null;
         }>;
         globalWorkingHours: Partial<{
             timeZoneId: string | null;
-            workDayStart: string;
-            workDayEnd: string;
             workingDays: number[];
+            hoursPerDay: number | null;
             holidaysCsv: string;
         }>;
     }> | {
+        generalConfiguration: {
+            defaultExploreView: ExploreDefaultView;
+        };
         timezone: {
             regionId: string | null;
             dateFormat: string | null;
@@ -340,30 +369,27 @@ declare class SystemSettings implements OnInit {
             port: string;
         };
         timeSheetPolicy: {
-            weekStartDay: number | null;
-            generationEnabled: boolean;
-            manualGenerationEnabled: boolean;
-            regularDailyHours: number | null;
+            frequency: TimeSheetFrequency | null;
             maxDailyHours: number | null;
-            allowOvertime: boolean;
-            requireOvertimeReason: boolean;
             requireDescription: boolean;
             allowFutureEntry: boolean;
-            pastEntryLockDays: number | null;
-            allowedScheduleItemTypes: string[];
-            assignedItemsOnly: boolean;
-            allowZeroHourSubmit: boolean;
-            costEnabled: boolean;
-            rateSource: string | null;
+            allowBackdatedEntry: boolean;
+            autoLockOnApprove: boolean;
+            submissionDeadlineDays: number | null;
         };
         globalWorkingHours: {
             timeZoneId: string | null;
-            workDayStart: string;
-            workDayEnd: string;
             workingDays: number[];
+            hoursPerDay: number | null;
             holidaysCsv: string;
         };
     }>;
+    /**
+     * The `Identity` record. It is shared with `@masterteam/brand-display`, which
+     * owns every other field in it — we only read/write the General Configuration
+     * slice and must preserve the rest verbatim.
+     */
+    readonly generalConfigurationSetting: _angular_core.Signal<SystemSetting | null>;
     readonly holidaysSetting: _angular_core.Signal<SystemSetting | null>;
     readonly timezoneSetting: _angular_core.Signal<SystemSetting | null>;
     readonly currencySetting: _angular_core.Signal<SystemSetting | null>;
@@ -386,8 +412,8 @@ declare class SystemSettings implements OnInit {
     readonly currencyFormatOptions: _angular_core.Signal<SelectOption[]>;
     readonly weekendOptions: _angular_core.Signal<WeekendDayOption[]>;
     readonly dotnetDayOptions: _angular_core.Signal<WeekendDayOption[]>;
-    readonly scheduleItemTypeOptions: _angular_core.Signal<ScheduleItemTypeOption[]>;
-    readonly rateSourceOptions: _angular_core.Signal<SelectOption[]>;
+    readonly exploreDefaultViewOptions: _angular_core.Signal<IconSelectOption[]>;
+    readonly frequencyOptions: _angular_core.Signal<SelectOption[]>;
     readonly isReady: _angular_core.Signal<boolean>;
     readonly isLoading: _angular_core.Signal<boolean>;
     readonly hasChanges: _angular_core.Signal<boolean>;
@@ -407,11 +433,19 @@ declare class SystemSettings implements OnInit {
     private buildCurrentSnapshot;
     private buildTimezoneValue;
     private buildCurrencyValue;
+    /**
+     * The `Identity` value exactly as last returned by the API (or written by a
+     * previous save in this session), used as the base every save merges onto so
+     * branding fields this page does not model survive round-trips.
+     */
+    private getIdentityRecord;
+    private buildGeneralConfigurationValue;
     private buildWeekendValue;
     private buildSmtpValue;
     private buildTimeSheetPolicyValue;
     private buildGlobalWorkingHoursValue;
     private findSettingByKey;
+    private extractGeneralConfigurationValue;
     private extractHolidaysValue;
     private extractTimezoneValue;
     private extractCurrencyValue;
@@ -422,6 +456,7 @@ declare class SystemSettings implements OnInit {
     private normalizeHolidayItem;
     private normalizeTimezoneRegion;
     private normalizeCurrencyUnit;
+    private normalizeGeneralConfigurationSnapshot;
     private normalizeTimezoneSnapshot;
     private normalizeCurrencySnapshot;
     private normalizeWeekendSnapshot;
@@ -473,5 +508,5 @@ declare class SystemSettingsHolidayEditor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SystemSettingsHolidayEditor, "mt-system-settings-holiday-editor", never, { "holiday": { "alias": "holiday"; "required": false; "isSignal": true; }; "isEditMode": { "alias": "isEditMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { DEFAULT_DATE_FORMAT_OPTIONS, DEFAULT_TIME_FORMAT_OPTIONS, DOTNET_DAY_DEFINITIONS, FIXED_CURRENCIES, RATE_SOURCE_OPTIONS, SCHEDULE_ITEM_TYPE_OPTIONS, SystemSettings, SystemSettingsHolidayEditor, WEEKEND_DAY_DEFINITIONS };
-export type { ApiResponse, CurrencyCatalogItem, CurrencySettingValue, CurrencyUnitLabel, FormatSchemaOption, GlobalWorkingHoursSettingValue, HolidayItem, HolidayTableRow, HolidaysSettingValue, ScheduleItemTypeOption, SelectOption, SmtpSettingValue, SystemSetting, SystemSettingObject, SystemSettingPrimitive, SystemSettingValue, SystemSettingsForm, SystemSettingsFormatSchema, SystemSettingsSnapshot, TimeSheetPolicySettingValue, TimezoneRegionOption, TimezoneSettingValue, UpdateSystemSettingItem, WeekendDayOption, WeekendSettingValue };
+export { DEFAULT_DATE_FORMAT_OPTIONS, DEFAULT_GENERAL_CONFIGURATION, DEFAULT_TIME_FORMAT_OPTIONS, DOTNET_DAY_DEFINITIONS, EXPLORE_DEFAULT_VIEW_OPTIONS, FIXED_CURRENCIES, GENERAL_CONFIGURATION_SETTING_KEY, RATE_SOURCE_OPTIONS, SCHEDULE_ITEM_TYPE_OPTIONS, SystemSettings, SystemSettingsHolidayEditor, TIMESHEET_FREQUENCY_OPTIONS, WEEKEND_DAY_DEFINITIONS };
+export type { ApiResponse, CurrencyCatalogItem, CurrencySettingValue, CurrencyUnitLabel, ExploreDefaultView, FormatSchemaOption, GeneralConfigurationSettingValue, GlobalWorkingHoursSettingValue, HolidayItem, HolidayTableRow, HolidaysSettingValue, IconSelectOption, ScheduleItemTypeOption, SelectOption, SmtpSettingValue, SystemSetting, SystemSettingObject, SystemSettingPrimitive, SystemSettingValue, SystemSettingsForm, SystemSettingsFormatSchema, SystemSettingsSnapshot, TimeSheetFrequency, TimeSheetPolicySettingValue, TimezoneRegionOption, TimezoneSettingValue, UpdateSystemSettingItem, WeekendDayOption, WeekendSettingValue };