@masterteam/system-settings 0.0.10 → 0.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/system-settings",
-  "version": "0.0.10",
+  "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.228",
+    "@masterteam/components": "^0.0.231",
     "@masterteam/icons": "^0.0.17"
   },
   "sideEffects": false,

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

@@ -76,6 +76,20 @@ 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 {
     frequency: TimeSheetFrequency;
@@ -106,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;
 }
@@ -117,6 +135,7 @@ interface HolidayTableRow {
     to: string;
 }
 interface SystemSettingsSnapshot {
+    generalConfiguration: GeneralConfigurationSettingValue;
     holidays: HolidaysSettingValue;
     timezone: TimezoneSettingValue;
     currency: CurrencySettingValue;
@@ -126,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>;
@@ -162,6 +184,20 @@ type SystemSettingsForm = FormGroup<{
     }>;
 }>;
 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 [{
@@ -272,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;
@@ -307,6 +346,9 @@ declare class SystemSettings implements OnInit {
             holidaysCsv: string;
         }>;
     }> | {
+        generalConfiguration: {
+            defaultExploreView: ExploreDefaultView;
+        };
         timezone: {
             regionId: string | null;
             dateFormat: string | null;
@@ -342,6 +384,12 @@ declare class SystemSettings implements OnInit {
             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>;
@@ -364,6 +412,7 @@ declare class SystemSettings implements OnInit {
     readonly currencyFormatOptions: _angular_core.Signal<SelectOption[]>;
     readonly weekendOptions: _angular_core.Signal<WeekendDayOption[]>;
     readonly dotnetDayOptions: _angular_core.Signal<WeekendDayOption[]>;
+    readonly exploreDefaultViewOptions: _angular_core.Signal<IconSelectOption[]>;
     readonly frequencyOptions: _angular_core.Signal<SelectOption[]>;
     readonly isReady: _angular_core.Signal<boolean>;
     readonly isLoading: _angular_core.Signal<boolean>;
@@ -384,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;
@@ -399,6 +456,7 @@ declare class SystemSettings implements OnInit {
     private normalizeHolidayItem;
     private normalizeTimezoneRegion;
     private normalizeCurrencyUnit;
+    private normalizeGeneralConfigurationSnapshot;
     private normalizeTimezoneSnapshot;
     private normalizeCurrencySnapshot;
     private normalizeWeekendSnapshot;
@@ -450,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, TIMESHEET_FREQUENCY_OPTIONS, WEEKEND_DAY_DEFINITIONS };
-export type { ApiResponse, CurrencyCatalogItem, CurrencySettingValue, CurrencyUnitLabel, FormatSchemaOption, GlobalWorkingHoursSettingValue, HolidayItem, HolidayTableRow, HolidaysSettingValue, ScheduleItemTypeOption, SelectOption, SmtpSettingValue, SystemSetting, SystemSettingObject, SystemSettingPrimitive, SystemSettingValue, SystemSettingsForm, SystemSettingsFormatSchema, SystemSettingsSnapshot, TimeSheetFrequency, 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 };