@masterteam/system-settings 0.0.18 → 0.0.20

package/fesm2022/masterteam-system-settings.mjs

@@ -1,2 +1,2 @@
-export { j as DEFAULT_DATE_FORMAT_OPTIONS, o as DEFAULT_EMAIL_DELIVERY_OPTIONS, D as DEFAULT_GENERAL_CONFIGURATION, k as DEFAULT_TIME_FORMAT_OPTIONS, l as DOTNET_DAY_DEFINITIONS, b as EMAIL_DELIVERY_ATTEMPT_STATUSES, q as EMAIL_DELIVERY_OPTIONS, f as EMAIL_DELIVERY_PERMISSIONS, x as EMAIL_DELIVERY_ROUTES, w as EMAIL_USER_INITIATED_TEST_OPERATION_KIND, h as EXPLORE_DEFAULT_VIEW_OPTIONS, s as EmailDeliveryAccessService, v as EmailUserTestDialog, F as FIXED_CURRENCIES, G as GENERAL_CONFIGURATION_SETTING_KEY, R as RATE_SOURCE_OPTIONS, m as SCHEDULE_ITEM_TYPE_OPTIONS, S as SystemSettings, n as SystemSettingsHolidayEditor, T as TIMESHEET_FREQUENCY_OPTIONS, W as WEEKEND_DAY_DEFINITIONS, d as areEmailTestRecipientsValid, u as buildEmailTemplatePlaceholderFields, t as collectEmailTemplatePlaceholders, c as createEmailTestRequestId, i as isConnectionTestAttempt, e as isEmailTestRequestPending, p as parseEmailTestRecipients, r as provideEmailDelivery } from './masterteam-system-settings-masterteam-system-settings-CO-XTJOi.mjs';
+export { j as DEFAULT_DATE_FORMAT_OPTIONS, o as DEFAULT_EMAIL_DELIVERY_OPTIONS, D as DEFAULT_GENERAL_CONFIGURATION, k as DEFAULT_TIME_FORMAT_OPTIONS, l as DOTNET_DAY_DEFINITIONS, b as EMAIL_DELIVERY_ATTEMPT_STATUSES, q as EMAIL_DELIVERY_OPTIONS, f as EMAIL_DELIVERY_PERMISSIONS, x as EMAIL_DELIVERY_ROUTES, w as EMAIL_USER_INITIATED_TEST_OPERATION_KIND, h as EXPLORE_DEFAULT_VIEW_OPTIONS, s as EmailDeliveryAccessService, v as EmailUserTestDialog, F as FIXED_CURRENCIES, G as GENERAL_CONFIGURATION_SETTING_KEY, R as RATE_SOURCE_OPTIONS, m as SCHEDULE_ITEM_TYPE_OPTIONS, S as SystemSettings, n as SystemSettingsHolidayEditor, T as TIMESHEET_FREQUENCY_OPTIONS, W as WEEKEND_DAY_DEFINITIONS, d as areEmailTestRecipientsValid, u as buildEmailTemplatePlaceholderFields, t as collectEmailTemplatePlaceholders, c as createEmailTestRequestId, i as isConnectionTestAttempt, e as isEmailTestRequestPending, p as parseEmailTestRecipients, r as provideEmailDelivery } from './masterteam-system-settings-masterteam-system-settings-DbsjQ7c7.mjs';
 //# sourceMappingURL=masterteam-system-settings.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/system-settings",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "publishConfig": {
     "directory": "../../../dist/masterteam/system-settings",
     "linkDirectory": false,
@@ -19,9 +19,9 @@
     "rxjs": "^7.8.2",
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
-    "@masterteam/forms": "^0.0.143",
-    "@masterteam/icons": "^0.0.17",
-    "@masterteam/components": "^0.0.278"
+    "@masterteam/components": "^0.0.282",
+    "@masterteam/forms": "^0.0.147",
+    "@masterteam/icons": "^0.0.17"
   },
   "sideEffects": false,
   "exports": {

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

@@ -73,7 +73,7 @@ interface WeekendSettingValue extends SystemSettingObject {
     days: number[];
 }
 /** The landing view the app-client explore page opens with. */
-type ExploreDefaultView = 'cards' | 'timeline';
+type ExploreDefaultView = 'cards' | 'timeline' | 'table';
 /**
  * General Configuration is persisted **inside the existing `Identity` record**
  * (the same record `@masterteam/brand-display` owns), not under a key of its own.
@@ -191,6 +191,10 @@ declare const EXPLORE_DEFAULT_VIEW_OPTIONS: readonly [{
     readonly id: "timeline";
     readonly translationKey: "explore-default-view-timeline";
     readonly icon: "time.clock";
+}, {
+    readonly id: "table";
+    readonly translationKey: "explore-default-view-table";
+    readonly icon: "layout.table";
 }];
 declare const DEFAULT_GENERAL_CONFIGURATION: GeneralConfigurationSettingValue;
 declare const DEFAULT_DATE_FORMAT_OPTIONS: FormatSchemaOption[];
@@ -276,14 +280,49 @@ declare class SystemSettings implements OnInit {
     private readonly transloco;
     private readonly modal;
     private readonly toast;
-    readonly apiBasePath: _angular_core.InputSignal<string>;
-    readonly backRoute: _angular_core.InputSignal<string | null>;
+    /**
+     * Base path for the settings API. Safe to omit from a route's `data`
+     * even when the host uses `withComponentInputBinding()` - see
+     * `defaultWhenUndefined`.
+     */
+    readonly apiBasePath: _angular_core.InputSignalWithTransform<string, string | undefined>;
+    /**
+     * Route the page's back button navigates to; falsy (including an
+     * explicit `null`) disables it - see `goBack()`. Safe to omit from a
+     * route's `data` even when the host uses `withComponentInputBinding()`
+     * - see `defaultWhenUndefined`.
+     */
+    readonly backRoute: _angular_core.InputSignalWithTransform<string | null, string | null | undefined>;
     readonly formatSchema: _angular_core.InputSignal<SystemSettingsFormatSchema | null>;
-    readonly breadcrumbItems: {
+    /**
+     * Breadcrumb "home" link. `null` renders the crumb as non-navigable.
+     * Safe to omit from a route's `data` even when the host uses
+     * `withComponentInputBinding()` - see `defaultWhenUndefined`.
+     */
+    readonly homeRoute: _angular_core.InputSignalWithTransform<string | null, string | null | undefined>;
+    /**
+     * Hides the Timesheet Policy card only - Global Working Hours stays
+     * visible and required, since it's host-relevant on its own (working
+     * days/hours feed scheduling and calendar logic beyond timesheets).
+     * TimeSheetPolicy's fields lose their validators and are excluded from
+     * save diffing while hidden; GlobalWorkingHours is unaffected.
+     */
+    readonly hideTimeSheet: _angular_core.InputSignal<boolean>;
+    /**
+     * Restricts which Explore-default-view options are offered. `null` (the
+     * default) preserves pplus5's original two options (`'cards'`,
+     * `'timeline'`) - NOT the full catalog, since the catalog now also
+     * contains `'table'` (added for splus4) and an unset input must not
+     * silently surface it to hosts that never opted in. Pass the ids
+     * explicitly (e.g. `['cards', 'table']`, or all three) to get anything
+     * else.
+     */
+    readonly exploreViewOptions: _angular_core.InputSignal<ExploreDefaultView[] | null>;
+    readonly breadcrumbItems: _angular_core.Signal<{
         label?: string;
         routerLink?: string;
         icon?: string;
-    }[];
+    }[]>;
     readonly form: SystemSettingsForm;
     readonly settings: _angular_core.WritableSignal<SystemSetting[] | null>;
     readonly settingsLoading: _angular_core.WritableSignal<boolean>;
@@ -380,20 +419,22 @@ declare class SystemSettings implements OnInit {
     readonly timeSheetPolicySetting: _angular_core.Signal<SystemSetting | null>;
     readonly globalWorkingHoursSetting: _angular_core.Signal<SystemSetting | null>;
     readonly resolvedFormatSchema: _angular_core.Signal<SystemSettingsFormatSchema>;
-    readonly timezoneOptions: _angular_core.Signal<{
-        name: string;
-        id: string;
-        baseUtcOffset: string;
-        standardName: string;
-        displayName: string;
-        daylightName: string;
-    }[]>;
     readonly dateFormatOptions: _angular_core.Signal<SelectOption[]>;
     readonly timeFormatOptions: _angular_core.Signal<SelectOption[]>;
     readonly currencyOptions: _angular_core.Signal<SelectOption[]>;
     readonly currencyFormatOptions: _angular_core.Signal<SelectOption[]>;
-    readonly weekendOptions: _angular_core.Signal<WeekendDayOption[]>;
     readonly dotnetDayOptions: _angular_core.Signal<WeekendDayOption[]>;
+    /**
+     * The Explore-default-view ids actually offered, in the fixed catalog's
+     * order: `exploreViewOptions()` when the host sets it, else the legacy
+     * pplus5 pair (`DEFAULT_EXPLORE_VIEW_OPTIONS`) - deliberately NOT the full
+     * `EXPLORE_DEFAULT_VIEW_OPTIONS` catalog, since that now includes `'table'`
+     * and an unconfigured host must keep seeing exactly what it saw before.
+     * Filtered against the catalog either way, so an invalid/unknown id in a
+     * host's list is silently dropped rather than offered. Always non-empty
+     * unless a host passes an empty array.
+     */
+    readonly allowedExploreDefaultViews: _angular_core.Signal<ExploreDefaultView[]>;
     readonly exploreDefaultViewOptions: _angular_core.Signal<IconSelectOption[]>;
     readonly frequencyOptions: _angular_core.Signal<SelectOption[]>;
     readonly isReady: _angular_core.Signal<boolean>;
@@ -437,6 +478,14 @@ declare class SystemSettings implements OnInit {
     private normalizeTimezoneRegion;
     private normalizeCurrencyUnit;
     private normalizeGeneralConfigurationSnapshot;
+    /**
+     * Resolves a stored/incoming value against the currently allowed Explore
+     * views (`allowedExploreDefaultViews()`), not the full static catalog, so a
+     * host-restricted `exploreViewOptions` is enforced on both hydration and
+     * save. Falls back to the first allowed option - not a hardcoded 'cards' -
+     * since a host may configure a subset that excludes it.
+     */
+    private normalizeExploreDefaultView;
     private normalizeTimezoneSnapshot;
     private normalizeCurrencySnapshot;
     private normalizeWeekendSnapshot;
@@ -462,7 +511,7 @@ declare class SystemSettings implements OnInit {
     private applyUpdatedSettings;
     private areEqual;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SystemSettings, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SystemSettings, "mt-system-settings", never, { "apiBasePath": { "alias": "apiBasePath"; "required": false; "isSignal": true; }; "backRoute": { "alias": "backRoute"; "required": false; "isSignal": true; }; "formatSchema": { "alias": "formatSchema"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SystemSettings, "mt-system-settings", never, { "apiBasePath": { "alias": "apiBasePath"; "required": false; "isSignal": true; }; "backRoute": { "alias": "backRoute"; "required": false; "isSignal": true; }; "formatSchema": { "alias": "formatSchema"; "required": false; "isSignal": true; }; "homeRoute": { "alias": "homeRoute"; "required": false; "isSignal": true; }; "hideTimeSheet": { "alias": "hideTimeSheet"; "required": false; "isSignal": true; }; "exploreViewOptions": { "alias": "exploreViewOptions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type HolidayEditorForm = FormGroup<{