feat: add flexibility to PeriodDimension and associated utils

[BRaimbault]

Implements DHIS2-15796

Relates to dhis2/maps-app#3407

---

Key features

1. PeriodDimension component to accept a height prop.
2. fixedPeriods utils to export regex patterns for period type identification.
3. New utility functions for relativePeriods in order to get relative period names and details.

---

Description

1. PeriodDimension

• PeriodTransfer component to accept a height prop (defaults to TRANSFER_HEIGHT ie. original behavior).
• PeriodDimension component to accept a height prop to pass to PeriodTransfer.

2. fixedPeriods utils

Export PERIOD_TYPE_REGEX from fixedPeriods utils to be used for period type identification.

3. relativePeriods utils

• Added new duration and offset properties to getDaysPeriodType, getWeeksPeriodType, getBiWeeksPeriodType, getBiWeeksPeriodType, getMonthsPeriodType, getBiMonthsPeriodType, getQuartersPeriodType, getSixMonthsPeriodType, getFinancialYearsPeriodType, and getYearsPeriodType. These allow for estimation of number of periods that will be returned in an analytics query when overlapping period presets are selected.
• Added new getRelativePeriodsDetails function that returns an object with relative period presets ids as keys and all their associated details (id, name, offset, duration and type) in an object as values, this across all period types (DAILY, WEEKLY...).
• Added new getRelativePeriodsName function that returns an object with relative period presets ids as keys and names as values, this across all period types (DAILY, WEEKLY...).

[jenniferarnesen]

Could you add a file comment explaining what offset is? Also, while you're at it, you could clarify duration as well.

[BRaimbault]

Added, see snippet below:

analytics/src/components/PeriodDimension/utils/relativePeriods.js

Lines 15 to 27 in 6bf23fd

	/*
	In getDaysPeriodType, getWeeksPeriodType, getBiWeeksPeriodType,
	getBiWeeksPeriodType, getMonthsPeriodType, getBiMonthsPeriodType,
	getQuartersPeriodType, getSixMonthsPeriodType,
	getFinancialYearsPeriodType, and getYearsPeriodType:
	- duration: The number of individual periods in the preset
	(the maximum when the duration is variable).
	eg: LAST_14_DAYS duration is 14
	- offset: The position of the most recent individual period
	relative to THIS period in the preset, earlier periods are
	negative (the maximum when the offset is variable).
	eg: LAST_BIMONTH offset is -1
	*/

Do you think it is clear enough? And the property names are well chosen?