@lifesg/react-design-system 4.0.0-alpha.1 → 4.0.0-alpha.2

package/unit-number/unit-number-input.style.d.ts

@@ -1,16 +1,52 @@
 interface LabelStyleProps {
     $inactive?: boolean;
 }
-export declare const HashContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<Omit<import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof import("../input-group/input-group.style").AddonStyleProps> & import("../input-group/input-group.style").AddonStyleProps, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-}, never>> & string;
-export declare const FloorInput: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never>> & string & Omit<(props: import("..").InputProps & import("react").RefAttributes<HTMLInputElement>) => React.ReactElement | null, keyof import("react").Component<any, {}, any>>;
-export declare const UnitInput: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never>, never>> & string;
-export declare const UnitNumberDivider: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("..").TypographyProps & {
-    ref?: import("react").RefObject<HTMLParagraphElement> | undefined;
-}, LabelStyleProps>> & string;
-export declare const ReadOnlyContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
-export declare const ReadOnlyLabel: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("..").TypographyProps & {
-    ref?: import("react").RefObject<HTMLParagraphElement> | undefined;
-}, LabelStyleProps>> & string;
+export declare const HashContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
+export declare const FloorInput: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never> & Partial<Pick<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never>>> & string & Omit<(props: import("..").InputProps & import("react").RefAttributes<HTMLInputElement>) => React.ReactElement | null, keyof import("react").Component<any, {}, any>>;
+export declare const UnitInput: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never> & Partial<Pick<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never>> & {
+    as?: import("styled-components").WebTarget | undefined;
+    forwardedAs?: import("styled-components").WebTarget | undefined;
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never> & Partial<Pick<import("..").InputProps & import("react").RefAttributes<HTMLInputElement>, never>> & {
+    as?: import("styled-components").WebTarget | undefined;
+    forwardedAs?: import("styled-components").WebTarget | undefined;
+}, never>>> & string;
+export declare const UnitNumberDivider: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>, "$inactive"> & LabelStyleProps, never> & Partial<Pick<import("styled-components").FastOmit<Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>, "$inactive"> & LabelStyleProps, never>>> & string & Omit<(props: Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>) => React.ReactElement | null, keyof import("react").Component<any, {}, any>>;
+export declare const ReadOnlyContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never> & Partial<Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>>> & string;
+export declare const ReadOnlyLabel: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>, "$inactive"> & LabelStyleProps, never> & Partial<Pick<import("styled-components").FastOmit<Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>, "$inactive"> & LabelStyleProps, never>>> & string & Omit<(props: Omit<any, "ref"> & {
+    weight?: import("..").TypographyWeight | undefined;
+    inline?: boolean | undefined;
+    paragraph?: boolean | undefined;
+    maxLines?: number | undefined;
+    as?: import("react").ElementType<any> | undefined;
+} & import("react").RefAttributes<HTMLParagraphElement>) => React.ReactElement | null, keyof import("react").Component<any, {}, any>>;
 export {};

package/unit-number/unit-number-input.style.js

@@ -1,12 +1,12 @@
-import t,{css as e}from"styled-components";import{Input as i}from"../input/input.js";import{LabelAddonContainer as r}from"../input-group/input-group.style.js";import{Typography as o}from"../typography/index.js";import{V3_Colour as n}from"../v3_theme/index.js";const m=t(r)`
+import e,{css as t}from"styled-components";import{Input as i}from"../input/input.js";import{Typography as r}from"../typography/index.js";import{V3_Colour as o}from"../v3_theme/index.js";const n=e.div`
     margin-right: 0.5rem;
-`,p=t(i)`
+`,m=e(i)`
     width: 2.5rem;
 
     input {
         text-align: center;
     }
-`,l=t(p)`
+`,d=e(m)`
     // Cheat to balance the placeholder look while ensuring enough width
     margin-left: 0.5rem;
     width: 6rem;
@@ -14,14 +14,14 @@ import t,{css as e}from"styled-components";import{Input as i}from"../input/input
     input {
         text-align: left;
     }
-`,a=t(o.BodyBL)`
+`,l=e(r.BodyBL)`
     margin: 0 0.25rem;
-    ${t=>{if(t.$inactive)return e`
-                color: ${n["text-disabled"]};
+    ${e=>{if(e.$inactive)return t`
+                color: ${o["text-disabled"]};
             `}}
-`,d=t.div`
+`,a=e.div`
     display: flex;
     align-items: center;
     height: calc(3rem - 2px); // exclude top and bottom borders
-`,g=t(o.BodyBL)``;export{p as FloorInput,m as HashContainer,d as ReadOnlyContainer,g as ReadOnlyLabel,l as UnitInput,a as UnitNumberDivider};
+`,p=e(r.BodyBL)``;export{m as FloorInput,n as HashContainer,a as ReadOnlyContainer,p as ReadOnlyLabel,d as UnitInput,l as UnitNumberDivider};
 //# sourceMappingURL=unit-number-input.style.js.map

package/unit-number/unit-number-input.style.js.map

@@ -1 +1 @@
-{"version":3,"file":"unit-number-input.style.js","sources":["../../src/unit-number/unit-number-input.style.tsx"],"sourcesContent":["import styled, { css } from \"styled-components\";\n\nimport { Input } from \"../input\";\nimport { LabelAddonContainer } from \"../input-group/input-group.style\";\nimport { Typography } from \"../typography\";\nimport { V3_Colour } from \"../v3_theme\";\n\n// =============================================================================\n// STYLE INTERFACE, transient props are denoted with $\n// See more https://styled-components.com/docs/api#transient-props\n// =============================================================================\ninterface LabelStyleProps {\n    $inactive?: boolean;\n}\n\n// =============================================================================\n// STYLING\n// =============================================================================\nexport const HashContainer = styled(LabelAddonContainer)`\n    margin-right: 0.5rem;\n`;\n\nexport const FloorInput = styled(Input)`\n    width: 2.5rem;\n\n    input {\n        text-align: center;\n    }\n`;\n\nexport const UnitInput = styled(FloorInput)`\n    // Cheat to balance the placeholder look while ensuring enough width\n    margin-left: 0.5rem;\n    width: 6rem;\n\n    input {\n        text-align: left;\n    }\n`;\n\nexport const UnitNumberDivider = styled(Typography.BodyBL)<LabelStyleProps>`\n    margin: 0 0.25rem;\n    ${(props) => {\n        if (props.$inactive) {\n            return css`\n                color: ${V3_Colour[\"text-disabled\"]};\n            `;\n        }\n    }}\n`;\n\nexport const ReadOnlyContainer = styled.div`\n    display: flex;\n    align-items: center;\n    height: calc(3rem - 2px); // exclude top and bottom borders\n`;\n\nexport const ReadOnlyLabel = styled(Typography.BodyBL)<LabelStyleProps>``;\n"],"names":["HashContainer","styled","LabelAddonContainer","FloorInput","Input","UnitInput","UnitNumberDivider","Typography","BodyBL","props","$inactive","css","V3_Colour","ReadOnlyContainer","div","ReadOnlyLabel"],"mappings":"0QAkBaA,EAAgBC,EAAOC,EAAoB;;EAI3CC,EAAaF,EAAOG,EAAM;;;;;;EAQ1BC,EAAYJ,EAAOE,EAAW;;;;;;;;EAU9BG,EAAoBL,EAAOM,EAAWC,OAAwB;;MAEpEC,IACC,GAAIA,EAAMC,UACN,OAAOC,CAAG;yBACGC,EAAU;aAE3B;EAIKC,EAAoBZ,EAAOa,GAAG;;;;EAM9BC,EAAgBd,EAAOM,EAAWC,OAAwB"}
+{"version":3,"file":"unit-number-input.style.js","sources":["../../src/unit-number/unit-number-input.style.tsx"],"sourcesContent":["import styled, { css } from \"styled-components\";\n\nimport { Input } from \"../input\";\nimport { Typography } from \"../typography\";\nimport { V3_Colour } from \"../v3_theme\";\n\n// =============================================================================\n// STYLE INTERFACE, transient props are denoted with $\n// See more https://styled-components.com/docs/api#transient-props\n// =============================================================================\ninterface LabelStyleProps {\n    $inactive?: boolean;\n}\n\n// =============================================================================\n// STYLING\n// =============================================================================\nexport const HashContainer = styled.div`\n    margin-right: 0.5rem;\n`;\n\nexport const FloorInput = styled(Input)`\n    width: 2.5rem;\n\n    input {\n        text-align: center;\n    }\n`;\n\nexport const UnitInput = styled(FloorInput)`\n    // Cheat to balance the placeholder look while ensuring enough width\n    margin-left: 0.5rem;\n    width: 6rem;\n\n    input {\n        text-align: left;\n    }\n`;\n\nexport const UnitNumberDivider = styled(Typography.BodyBL)<LabelStyleProps>`\n    margin: 0 0.25rem;\n    ${(props) => {\n        if (props.$inactive) {\n            return css`\n                color: ${V3_Colour[\"text-disabled\"]};\n            `;\n        }\n    }}\n`;\n\nexport const ReadOnlyContainer = styled.div`\n    display: flex;\n    align-items: center;\n    height: calc(3rem - 2px); // exclude top and bottom borders\n`;\n\nexport const ReadOnlyLabel = styled(Typography.BodyBL)<LabelStyleProps>``;\n"],"names":["HashContainer","styled","div","FloorInput","Input","UnitInput","UnitNumberDivider","Typography","BodyBL","props","$inactive","css","V3_Colour","ReadOnlyContainer","ReadOnlyLabel"],"mappings":"0LAiBO,MAAMA,EAAgBC,EAAOC,GAAG;;EAI1BC,EAAaF,EAAOG,EAAM;;;;;;EAQ1BC,EAAYJ,EAAOE,EAAW;;;;;;;;EAU9BG,EAAoBL,EAAOM,EAAWC,OAAwB;;MAEpEC,IACC,GAAIA,EAAMC,UACN,OAAOC,CAAG;yBACGC,EAAU;aAE3B;EAIKC,EAAoBZ,EAAOC,GAAG;;;;EAM9BY,EAAgBb,EAAOM,EAAWC,OAAwB"}

package/util/simple-id-generator.d.ts

@@ -4,3 +4,4 @@ export declare class SimpleIdGenerator {
      */
     static generate(): string;
 }
+export declare const useId: () => string;

package/util/simple-id-generator.js

@@ -1,2 +1,2 @@
-class t{static generate(){return Math.random().toString(36).substring(2,9)}}export{t as SimpleIdGenerator};
+import t from"react";var r;class e{static generate(){return Math.random().toString(36).substring(2,9)}}const n=null!==(r=t.useId)&&void 0!==r?r:()=>{const[r]=t.useState((()=>e.generate()));return r};export{e as SimpleIdGenerator,n as useId};
 //# sourceMappingURL=simple-id-generator.js.map

package/util/simple-id-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple-id-generator.js","sources":["../../src/util/simple-id-generator.ts"],"sourcesContent":["export class SimpleIdGenerator {\n    /**\n     * Generates a simple generator for element ids\n     */\n    public static generate(): string {\n        return Math.random().toString(36).substring(2, 9);\n    }\n}\n"],"names":["SimpleIdGenerator","generate","Math","random","toString","substring"],"mappings":"MAAaA,EAIF,eAAOC,GACV,OAAOC,KAAKC,SAASC,SAAS,IAAIC,UAAU,EAAG,EACnD"}
+{"version":3,"file":"simple-id-generator.js","sources":["../../src/util/simple-id-generator.ts"],"sourcesContent":["import React from \"react\";\n\nexport class SimpleIdGenerator {\n    /**\n     * Generates a simple generator for element ids\n     */\n    public static generate(): string {\n        return Math.random().toString(36).substring(2, 9);\n    }\n}\n\nconst useSimpleId = () => {\n    const [id] = React.useState(() => SimpleIdGenerator.generate());\n    return id;\n};\n\n// TODO: can be removed when React 17 support is dropped\n// @ts-expect-error useId is only available in React 18+\nexport const useId: () => string = React.useId ?? useSimpleId;\n"],"names":["SimpleIdGenerator","generate","Math","random","toString","substring","useId","_a","React","id","useState"],"mappings":"iCAEaA,EAIF,eAAOC,GACV,OAAOC,KAAKC,SAASC,SAAS,IAAIC,UAAU,EAAG,EACnD,EAGJ,MAOaC,EAAiC,QAAXC,EAAAC,EAAMF,aAAK,IAAAC,EAAAA,EAP1B,KAChB,MAAOE,GAAMD,EAAME,UAAS,IAAMV,EAAkBC,aACpD,OAAOQ,CAAE"}

package/util/string-helper.d.ts

@@ -50,5 +50,6 @@ export declare class StringHelper {
     private static suffixes;
     static formatOrdinal(n: number): string;
     static getMaskedDescription(value: string, displayMaskState: "masked" | "unmasked", maskRange?: number[]): string;
+    static joinNonEmptyStrings(strings: (string | undefined | null)[], delimiter?: string): string;
 }
 export {};

package/util/string-helper.js

@@ -1,2 +1,2 @@
-class t{static transformWithSpaces(t,e){const n="(.{"+e+"})";return t.replace(/[^\dA-Z]/gi,"").replace(new RegExp(n,"g"),"$1 ").trim()}static padValue(t,e){if("0"===t)return e?t:t.padStart(2,"0");if(""===t)return t;return parseInt(t).toString().padStart(2,"0")}static shouldTruncateToTwoLines(t,e){const n=Math.floor(e/9);return t.length>=2*n||1===t.split(" ").length&&t.length>n}static truncateOneLine(t,e,n,r,s=8){let a=0;e>n&&(a=Math.floor((e-n)/s));const i=r+a;if(i<t.length){const e=Math.floor(i/2);return t.substring(0,e)+" ... "+t.substring(t.length-e,t.length)}return t}static truncateTwoLines(t,e,n,r=1.2){const s=Math.floor(2*e/(.6*n))*(2/r);if(t.length<=s)return t;const a=Math.floor(.6*s),i=Math.floor(.2*s);return`${t.substring(0,a)}...${t.substring(t.length-i)}`}static getTextWidth(e,n){if("undefined"==typeof document)return 0;const r=(t.getTextWidth.canvas||(t.getTextWidth.canvas=document.createElement("canvas"))).getContext("2d");r.font=n;return r.measureText(e).width}static maskValue(e,n){if(!e)return e;const{maskRange:r,unmaskRange:s,maskChar:a="•",maskRegex:i,maskTransformer:u}=n;if(u)return u(e);if(i)return e.replace(i,a);if(r){const{startIndex:n,endIndex:s}=t.determineStartAndEndIndex(r[0],r[1]);return e.substring(0,n)+a.repeat(e.substring(n,s+1).length)+e.substring(s+1)}if(s){const{startIndex:n,endIndex:r}=t.determineStartAndEndIndex(s[0],s[1]);return a.repeat(e.substring(0,n).length)+e.substring(n,r+1)+a.repeat(e.substring(r+1).length)}return e}static determineStartAndEndIndex(t,e){return t<e?{startIndex:t,endIndex:e}:{startIndex:e,endIndex:t}}static formatOrdinal(e){const n=t.ordinalPluralRules.select(e);return`${e}${t.suffixes.get(n)}`}static getMaskedDescription(t,e,n){if(!t||"masked"!==e||!n)return"";const[r,s]=n,a=r>0,i=s<t.length-1,u=a?t.substring(0,r):"",d=i?t.substring(s+1):"";return a&&i?`Starting with ${u} and ending with ${d}`:a?`Starting with ${u}`:i?`Ending with ${d}`:""}}t.ordinalPluralRules=new Intl.PluralRules("en",{type:"ordinal"}),t.suffixes=new Map([["one","st"],["two","nd"],["few","rd"],["other","th"]]);export{t as StringHelper};
+class t{static transformWithSpaces(t,e){const n="(.{"+e+"})";return t.replace(/[^\dA-Z]/gi,"").replace(new RegExp(n,"g"),"$1 ").trim()}static padValue(t,e){if("0"===t)return e?t:t.padStart(2,"0");if(""===t)return t;return parseInt(t).toString().padStart(2,"0")}static shouldTruncateToTwoLines(t,e){const n=Math.floor(e/9);return t.length>=2*n||1===t.split(" ").length&&t.length>n}static truncateOneLine(t,e,n,r,s=8){let a=0;e>n&&(a=Math.floor((e-n)/s));const i=r+a;if(i<t.length){const e=Math.floor(i/2);return t.substring(0,e)+" ... "+t.substring(t.length-e,t.length)}return t}static truncateTwoLines(t,e,n,r=1.2){const s=Math.floor(2*e/(.6*n))*(2/r);if(t.length<=s)return t;const a=Math.floor(.6*s),i=Math.floor(.2*s);return`${t.substring(0,a)}...${t.substring(t.length-i)}`}static getTextWidth(e,n){if("undefined"==typeof document)return 0;const r=(t.getTextWidth.canvas||(t.getTextWidth.canvas=document.createElement("canvas"))).getContext("2d");r.font=n;return r.measureText(e).width}static maskValue(e,n){if(!e)return e;const{maskRange:r,unmaskRange:s,maskChar:a="•",maskRegex:i,maskTransformer:u}=n;if(u)return u(e);if(i)return e.replace(i,a);if(r){const{startIndex:n,endIndex:s}=t.determineStartAndEndIndex(r[0],r[1]);return e.substring(0,n)+a.repeat(e.substring(n,s+1).length)+e.substring(s+1)}if(s){const{startIndex:n,endIndex:r}=t.determineStartAndEndIndex(s[0],s[1]);return a.repeat(e.substring(0,n).length)+e.substring(n,r+1)+a.repeat(e.substring(r+1).length)}return e}static determineStartAndEndIndex(t,e){return t<e?{startIndex:t,endIndex:e}:{startIndex:e,endIndex:t}}static formatOrdinal(e){const n=t.ordinalPluralRules.select(e);return`${e}${t.suffixes.get(n)}`}static getMaskedDescription(t,e,n){if(!t||"masked"!==e||!n)return"";const[r,s]=n,a=r>0,i=s<t.length-1,u=a?t.substring(0,r):"",o=i?t.substring(s+1):"";return a&&i?`Starting with ${u} and ending with ${o}`:a?`Starting with ${u}`:i?`Ending with ${o}`:""}static joinNonEmptyStrings(t,e=", "){return t.filter(Boolean).join(e)}}t.ordinalPluralRules=new Intl.PluralRules("en",{type:"ordinal"}),t.suffixes=new Map([["one","st"],["two","nd"],["few","rd"],["other","th"]]);export{t as StringHelper};
 //# sourceMappingURL=string-helper.js.map

package/util/string-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-helper.js","sources":["../../src/util/string-helper.ts"],"sourcesContent":["// =============================================================================\n// TYPINGS\n// =============================================================================\ninterface MaskValueOptions {\n    maskRange?: number[] | undefined;\n    unmaskRange?: number[] | undefined;\n    maskRegex?: RegExp | undefined;\n    maskTransformer?: ((value: string) => string) | undefined;\n    maskChar?: string | undefined;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\nexport class StringHelper {\n    public static transformWithSpaces(\n        value: string | any,\n        groupLength: number\n    ): string {\n        const regex = \"(.{\" + groupLength + \"})\";\n        return value\n            .replace(/[^\\dA-Z]/gi, \"\")\n            .replace(new RegExp(regex, \"g\"), \"$1 \")\n            .trim();\n    }\n\n    /**\n     * Pads single digit values with a zero and trims leading zero for\n     * values of length more than 2\n     * @param value the string value\n     * @param retainSingleZero setting true will allow single zero value\n     */\n    public static padValue(value: string, retainSingleZero?: boolean): string {\n        if (value === \"0\") {\n            return retainSingleZero ? value : value.padStart(2, \"0\");\n        }\n\n        if (value === \"\") {\n            return value;\n        }\n\n        const trimmedValue = parseInt(value);\n        return trimmedValue.toString().padStart(2, \"0\");\n    }\n\n    /**\n     * Checks if the text is required to be truncated and broken into two lines based\n     * on the available width of container. **Note: This is relevant to font size 18px or 1.125rem only **\n     * @param text input text\n     * @param widthOfElement element width in px\n     */\n    public static shouldTruncateToTwoLines(\n        text: string,\n        widthOfElement: number\n    ): boolean {\n        // This is arbitrary and based on tests to derive that every 9px increment ~= 1 char length.\n        // But this applies to font size 18px or 1.125rem only\n        const estimatedCharOnLine = Math.floor(widthOfElement / 9);\n        return (\n            text.length >= estimatedCharOnLine * 2 ||\n            (text.split(\" \").length === 1 && text.length > estimatedCharOnLine)\n        );\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param minDivSize the minimum container size (using size on mobileS viewport as baseline)\n     * @param baselineCharLength the baseline amount of characters to be displayed before truncation kicks. This\n     * will be increased if there is more space available (derived from `widthOfElement`)\n     * @param incrementFactor the size (in px).\n     */\n    public static truncateOneLine(\n        text: string,\n        widthOfElement: number,\n        minDivSize: number,\n        baselineCharLength: number,\n        incrementFactor = 8 // Arbitrary based on tests and applies to font size of 18px or 1.125rem\n    ): string {\n        let additionalCharAllowed = 0;\n        if (widthOfElement > minDivSize) {\n            additionalCharAllowed = Math.floor(\n                (widthOfElement - minDivSize) / incrementFactor\n            );\n        }\n        const allowedCharLength = baselineCharLength + additionalCharAllowed;\n        if (allowedCharLength < text.length) {\n            const thresholdIndex = Math.floor(allowedCharLength / 2); // We will cut it halfway to derive x num of characters\n            return (\n                text.substring(0, thresholdIndex) + // Use the first x\n                \" ... \" +\n                text.substring(text.length - thresholdIndex, text.length) // Use the last x\n            );\n        }\n\n        return text;\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param fontSize the fontsize of the text\n     * @param lineHeight the line height of the text\n     */\n    public static truncateTwoLines(\n        text: string,\n        widthOfElement: number,\n        fontSize: number,\n        lineHeight = 1.2\n    ): string {\n        // Estimate characters per line based on width and font size\n        const charsPerLine = Math.floor(\n            (widthOfElement * 2) / (fontSize * 0.6) // 0.6 is an approximation for average char width\n        );\n\n        // Calculate total characters allowed in two lines\n        const totalCharsAllowed = charsPerLine * (2 / lineHeight);\n\n        if (text.length <= totalCharsAllowed) {\n            return text; // No truncation needed\n        }\n\n        // Calculate the number of characters to keep\n        const keepFromStart = Math.floor(totalCharsAllowed * 0.6); // Keep 60% from start\n        const keepFromEnd = Math.floor(totalCharsAllowed * 0.2); // Keep 20% from end\n\n        // Truncate the text\n        const start = text.substring(0, keepFromStart);\n        const end = text.substring(text.length - keepFromEnd);\n\n        return `${start}...${end}`;\n    }\n\n    /**\n     * Returns the width of the text in the specified font\n     * https://stackoverflow.com/questions/118241/calculate-text-width-with-javascript/21015393#21015393\n     */\n    public static getTextWidth(text: string, font: string): number {\n        if (typeof document === \"undefined\") {\n            return 0;\n        }\n\n        // create a reusable canvas object for better performance\n        const canvas =\n            (StringHelper.getTextWidth as any).canvas ||\n            ((StringHelper.getTextWidth as any).canvas =\n                document.createElement(\"canvas\"));\n        const context = canvas.getContext(\"2d\");\n        context.font = font;\n\n        const metrics = context.measureText(text);\n        return metrics.width;\n    }\n\n    public static maskValue(value: string, options: MaskValueOptions): string {\n        if (!value) {\n            return value;\n        }\n\n        const {\n            maskRange,\n            unmaskRange,\n            maskChar = \"•\",\n            maskRegex,\n            maskTransformer,\n        } = options;\n\n        if (maskTransformer) {\n            return maskTransformer(value);\n        } else if (maskRegex) {\n            return value.replace(maskRegex, maskChar);\n        } else if (maskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    maskRange[0],\n                    maskRange[1]\n                );\n            return (\n                value.substring(0, startIndex) +\n                maskChar.repeat(\n                    value.substring(startIndex, endIndex + 1).length\n                ) +\n                value.substring(endIndex + 1)\n            );\n        } else if (unmaskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    unmaskRange[0],\n                    unmaskRange[1]\n                );\n            return (\n                maskChar.repeat(value.substring(0, startIndex).length) +\n                value.substring(startIndex, endIndex + 1) +\n                maskChar.repeat(value.substring(endIndex + 1).length)\n            );\n        }\n\n        return value;\n    }\n\n    private static determineStartAndEndIndex(index0: number, index1: number) {\n        return index0 < index1\n            ? { startIndex: index0, endIndex: index1 }\n            : { startIndex: index1, endIndex: index0 };\n    }\n\n    private static ordinalPluralRules = new Intl.PluralRules(\"en\", {\n        type: \"ordinal\",\n    });\n\n    private static suffixes = new Map([\n        [\"one\", \"st\"],\n        [\"two\", \"nd\"],\n        [\"few\", \"rd\"],\n        [\"other\", \"th\"],\n    ]);\n\n    public static formatOrdinal(n: number) {\n        const rule = StringHelper.ordinalPluralRules.select(n);\n        const suffix = StringHelper.suffixes.get(rule);\n        return `${n}${suffix}`;\n    }\n\n    public static getMaskedDescription(\n        value: string,\n        displayMaskState: \"masked\" | \"unmasked\",\n        maskRange?: number[]\n    ): string {\n        if (!value || displayMaskState !== \"masked\" || !maskRange) return \"\";\n\n        const [startIndex, endIndex] = maskRange;\n        const hasStart = startIndex > 0;\n        const hasEnd = endIndex < value.length - 1;\n\n        const start = hasStart ? value.substring(0, startIndex) : \"\";\n        const end = hasEnd ? value.substring(endIndex + 1) : \"\";\n\n        if (hasStart && hasEnd)\n            return `Starting with ${start} and ending with ${end}`;\n        if (hasStart) return `Starting with ${start}`;\n        if (hasEnd) return `Ending with ${end}`;\n\n        return \"\";\n    }\n}\n"],"names":["StringHelper","transformWithSpaces","value","groupLength","regex","replace","RegExp","trim","padValue","retainSingleZero","padStart","parseInt","toString","shouldTruncateToTwoLines","text","widthOfElement","estimatedCharOnLine","Math","floor","length","split","truncateOneLine","minDivSize","baselineCharLength","incrementFactor","additionalCharAllowed","allowedCharLength","thresholdIndex","substring","truncateTwoLines","fontSize","lineHeight","totalCharsAllowed","keepFromStart","keepFromEnd","getTextWidth","font","document","context","canvas","createElement","getContext","measureText","width","maskValue","options","maskRange","unmaskRange","maskChar","maskRegex","maskTransformer","startIndex","endIndex","determineStartAndEndIndex","repeat","index0","index1","formatOrdinal","n","rule","ordinalPluralRules","select","suffixes","get","getMaskedDescription","displayMaskState","hasStart","hasEnd","start","end","Intl","PluralRules","type","Map"],"mappings":"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"}
+{"version":3,"file":"string-helper.js","sources":["../../src/util/string-helper.ts"],"sourcesContent":["// =============================================================================\n// TYPINGS\n// =============================================================================\ninterface MaskValueOptions {\n    maskRange?: number[] | undefined;\n    unmaskRange?: number[] | undefined;\n    maskRegex?: RegExp | undefined;\n    maskTransformer?: ((value: string) => string) | undefined;\n    maskChar?: string | undefined;\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\nexport class StringHelper {\n    public static transformWithSpaces(\n        value: string | any,\n        groupLength: number\n    ): string {\n        const regex = \"(.{\" + groupLength + \"})\";\n        return value\n            .replace(/[^\\dA-Z]/gi, \"\")\n            .replace(new RegExp(regex, \"g\"), \"$1 \")\n            .trim();\n    }\n\n    /**\n     * Pads single digit values with a zero and trims leading zero for\n     * values of length more than 2\n     * @param value the string value\n     * @param retainSingleZero setting true will allow single zero value\n     */\n    public static padValue(value: string, retainSingleZero?: boolean): string {\n        if (value === \"0\") {\n            return retainSingleZero ? value : value.padStart(2, \"0\");\n        }\n\n        if (value === \"\") {\n            return value;\n        }\n\n        const trimmedValue = parseInt(value);\n        return trimmedValue.toString().padStart(2, \"0\");\n    }\n\n    /**\n     * Checks if the text is required to be truncated and broken into two lines based\n     * on the available width of container. **Note: This is relevant to font size 18px or 1.125rem only **\n     * @param text input text\n     * @param widthOfElement element width in px\n     */\n    public static shouldTruncateToTwoLines(\n        text: string,\n        widthOfElement: number\n    ): boolean {\n        // This is arbitrary and based on tests to derive that every 9px increment ~= 1 char length.\n        // But this applies to font size 18px or 1.125rem only\n        const estimatedCharOnLine = Math.floor(widthOfElement / 9);\n        return (\n            text.length >= estimatedCharOnLine * 2 ||\n            (text.split(\" \").length === 1 && text.length > estimatedCharOnLine)\n        );\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param minDivSize the minimum container size (using size on mobileS viewport as baseline)\n     * @param baselineCharLength the baseline amount of characters to be displayed before truncation kicks. This\n     * will be increased if there is more space available (derived from `widthOfElement`)\n     * @param incrementFactor the size (in px).\n     */\n    public static truncateOneLine(\n        text: string,\n        widthOfElement: number,\n        minDivSize: number,\n        baselineCharLength: number,\n        incrementFactor = 8 // Arbitrary based on tests and applies to font size of 18px or 1.125rem\n    ): string {\n        let additionalCharAllowed = 0;\n        if (widthOfElement > minDivSize) {\n            additionalCharAllowed = Math.floor(\n                (widthOfElement - minDivSize) / incrementFactor\n            );\n        }\n        const allowedCharLength = baselineCharLength + additionalCharAllowed;\n        if (allowedCharLength < text.length) {\n            const thresholdIndex = Math.floor(allowedCharLength / 2); // We will cut it halfway to derive x num of characters\n            return (\n                text.substring(0, thresholdIndex) + // Use the first x\n                \" ... \" +\n                text.substring(text.length - thresholdIndex, text.length) // Use the last x\n            );\n        }\n\n        return text;\n    }\n\n    /**\n     * Performs a truncation by adding ellipsis in the middle of the text.\n     * @param text input text\n     * @param widthOfElement the dynamic width of the container in px\n     * @param fontSize the fontsize of the text\n     * @param lineHeight the line height of the text\n     */\n    public static truncateTwoLines(\n        text: string,\n        widthOfElement: number,\n        fontSize: number,\n        lineHeight = 1.2\n    ): string {\n        // Estimate characters per line based on width and font size\n        const charsPerLine = Math.floor(\n            (widthOfElement * 2) / (fontSize * 0.6) // 0.6 is an approximation for average char width\n        );\n\n        // Calculate total characters allowed in two lines\n        const totalCharsAllowed = charsPerLine * (2 / lineHeight);\n\n        if (text.length <= totalCharsAllowed) {\n            return text; // No truncation needed\n        }\n\n        // Calculate the number of characters to keep\n        const keepFromStart = Math.floor(totalCharsAllowed * 0.6); // Keep 60% from start\n        const keepFromEnd = Math.floor(totalCharsAllowed * 0.2); // Keep 20% from end\n\n        // Truncate the text\n        const start = text.substring(0, keepFromStart);\n        const end = text.substring(text.length - keepFromEnd);\n\n        return `${start}...${end}`;\n    }\n\n    /**\n     * Returns the width of the text in the specified font\n     * https://stackoverflow.com/questions/118241/calculate-text-width-with-javascript/21015393#21015393\n     */\n    public static getTextWidth(text: string, font: string): number {\n        if (typeof document === \"undefined\") {\n            return 0;\n        }\n\n        // create a reusable canvas object for better performance\n        const canvas =\n            (StringHelper.getTextWidth as any).canvas ||\n            ((StringHelper.getTextWidth as any).canvas =\n                document.createElement(\"canvas\"));\n        const context = canvas.getContext(\"2d\");\n        context.font = font;\n\n        const metrics = context.measureText(text);\n        return metrics.width;\n    }\n\n    public static maskValue(value: string, options: MaskValueOptions): string {\n        if (!value) {\n            return value;\n        }\n\n        const {\n            maskRange,\n            unmaskRange,\n            maskChar = \"•\",\n            maskRegex,\n            maskTransformer,\n        } = options;\n\n        if (maskTransformer) {\n            return maskTransformer(value);\n        } else if (maskRegex) {\n            return value.replace(maskRegex, maskChar);\n        } else if (maskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    maskRange[0],\n                    maskRange[1]\n                );\n            return (\n                value.substring(0, startIndex) +\n                maskChar.repeat(\n                    value.substring(startIndex, endIndex + 1).length\n                ) +\n                value.substring(endIndex + 1)\n            );\n        } else if (unmaskRange) {\n            const { startIndex, endIndex } =\n                StringHelper.determineStartAndEndIndex(\n                    unmaskRange[0],\n                    unmaskRange[1]\n                );\n            return (\n                maskChar.repeat(value.substring(0, startIndex).length) +\n                value.substring(startIndex, endIndex + 1) +\n                maskChar.repeat(value.substring(endIndex + 1).length)\n            );\n        }\n\n        return value;\n    }\n\n    private static determineStartAndEndIndex(index0: number, index1: number) {\n        return index0 < index1\n            ? { startIndex: index0, endIndex: index1 }\n            : { startIndex: index1, endIndex: index0 };\n    }\n\n    private static ordinalPluralRules = new Intl.PluralRules(\"en\", {\n        type: \"ordinal\",\n    });\n\n    private static suffixes = new Map([\n        [\"one\", \"st\"],\n        [\"two\", \"nd\"],\n        [\"few\", \"rd\"],\n        [\"other\", \"th\"],\n    ]);\n\n    public static formatOrdinal(n: number) {\n        const rule = StringHelper.ordinalPluralRules.select(n);\n        const suffix = StringHelper.suffixes.get(rule);\n        return `${n}${suffix}`;\n    }\n\n    public static getMaskedDescription(\n        value: string,\n        displayMaskState: \"masked\" | \"unmasked\",\n        maskRange?: number[]\n    ): string {\n        if (!value || displayMaskState !== \"masked\" || !maskRange) return \"\";\n\n        const [startIndex, endIndex] = maskRange;\n        const hasStart = startIndex > 0;\n        const hasEnd = endIndex < value.length - 1;\n\n        const start = hasStart ? value.substring(0, startIndex) : \"\";\n        const end = hasEnd ? value.substring(endIndex + 1) : \"\";\n\n        if (hasStart && hasEnd)\n            return `Starting with ${start} and ending with ${end}`;\n        if (hasStart) return `Starting with ${start}`;\n        if (hasEnd) return `Ending with ${end}`;\n\n        return \"\";\n    }\n\n    public static joinNonEmptyStrings(\n        strings: (string | undefined | null)[],\n        delimiter = \", \"\n    ): string {\n        return strings.filter(Boolean).join(delimiter);\n    }\n}\n"],"names":["StringHelper","transformWithSpaces","value","groupLength","regex","replace","RegExp","trim","padValue","retainSingleZero","padStart","parseInt","toString","shouldTruncateToTwoLines","text","widthOfElement","estimatedCharOnLine","Math","floor","length","split","truncateOneLine","minDivSize","baselineCharLength","incrementFactor","additionalCharAllowed","allowedCharLength","thresholdIndex","substring","truncateTwoLines","fontSize","lineHeight","totalCharsAllowed","keepFromStart","keepFromEnd","getTextWidth","font","document","context","canvas","createElement","getContext","measureText","width","maskValue","options","maskRange","unmaskRange","maskChar","maskRegex","maskTransformer","startIndex","endIndex","determineStartAndEndIndex","repeat","index0","index1","formatOrdinal","n","rule","ordinalPluralRules","select","suffixes","get","getMaskedDescription","displayMaskState","hasStart","hasEnd","start","end","joinNonEmptyStrings","strings","delimiter","filter","Boolean","join","Intl","PluralRules","type","Map"],"mappings":"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"}

package/util/styling-helper.d.ts

@@ -0,0 +1,6 @@
+import type { ColourCSSVariableString, RadiusCSSVariableString } from "../theme";
+import { BorderThickness } from "../theme";
+import type { ValueOf } from "./utility-types";
+export declare const isRadiusToken: (value: unknown) => value is RadiusCSSVariableString;
+export declare const isThicknessToken: (value: unknown) => value is ValueOf<typeof BorderThickness>;
+export declare const isColourToken: (value: unknown) => value is ColourCSSVariableString;

package/util/styling-helper.js

@@ -0,0 +1,2 @@
+import"../theme/theme-provider/index.js";import"react";import"../theme/theme-provider/context.js";import{BorderThickness as e}from"../theme/tokens/border.js";import"../theme/tokens/colour.js";import"../theme/tokens/font.js";import"../theme/tokens/media-query.js";import{Radius as t}from"../theme/tokens/radius.js";import{isTokenWithPrefix as r,isTokenFromSet as o}from"../theme/utils/token-resolver.js";import"./calendar-helper.js";import"../external/dayjs/dayjs.min.js";import"./simple-id-generator.js";import"./string-helper.js";import"@react-aria/live-announcer";const m=new Set(Object.values(t)),s=new Set(Object.values(e)),i=e=>o(e,m),n=e=>o(e,s),p=e=>r(e,"var(--fds-colour-");export{p as isColourToken,i as isRadiusToken,n as isThicknessToken};
+//# sourceMappingURL=styling-helper.js.map

package/util/styling-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styling-helper.js","sources":["../../src/util/styling-helper.ts"],"sourcesContent":["import type {\n    ColourCSSVariableString,\n    RadiusCSSVariableString,\n} from \"../theme\";\nimport {\n    BorderThickness,\n    isTokenFromSet,\n    isTokenWithPrefix,\n    Radius,\n} from \"../theme\";\nimport type { ValueOf } from \"./utility-types\";\n\nconst radiusTokenSet = new Set<string>(Object.values(Radius));\nconst thicknessTokenSet = new Set<string>(Object.values(BorderThickness));\n\nexport const isRadiusToken = (\n    value: unknown\n): value is RadiusCSSVariableString => {\n    return isTokenFromSet<RadiusCSSVariableString>(value, radiusTokenSet);\n};\n\nexport const isThicknessToken = (\n    value: unknown\n): value is ValueOf<typeof BorderThickness> => {\n    return isTokenFromSet<ValueOf<typeof BorderThickness>>(\n        value,\n        thicknessTokenSet\n    );\n};\n\nexport const isColourToken = (\n    value: unknown\n): value is ColourCSSVariableString => {\n    return isTokenWithPrefix<ColourCSSVariableString>(\n        value,\n        \"var(--fds-colour-\"\n    );\n};\n"],"names":["radiusTokenSet","Set","Object","values","Radius","thicknessTokenSet","BorderThickness","isRadiusToken","value","isTokenFromSet","isThicknessToken","isColourToken","isTokenWithPrefix"],"mappings":"sjBAYA,MAAMA,EAAiB,IAAIC,IAAYC,OAAOC,OAAOC,IAC/CC,EAAoB,IAAIJ,IAAYC,OAAOC,OAAOG,IAE3CC,EACTC,GAEOC,EAAwCD,EAAOR,GAG7CU,EACTF,GAEOC,EACHD,EACAH,GAIKM,EACTH,GAEOI,EACHJ,EACA"}

package/util/time-helper.d.ts

@@ -41,6 +41,14 @@ export declare class TimeHelper {
     static updateHours(valueString: string, direction: "add" | "minus"): string;
     static convertTo24HourFormat(values: TimeValues): string;
     static convertHourTo12HourFormat(hourValue: string): string;
+    /**
+     * Formats a 24hr time range into a 12hr display string.
+     * @param start - "HH:mm" e.g. "13:00"
+     * @param end   - "HH:mm" e.g. "14:30"
+     * @returns e.g. "1:00PM to 2:30PM"
+     */
+    static formatTimeRange(start: string, end: string): string;
+    static isSameTime(a: string, b: string): boolean;
     static formatDisplayValue(value: string | undefined, format: TimeFormat): string;
     static toMinutesSeconds(_seconds: number): {
         minutes: number;
@@ -49,7 +57,7 @@ export declare class TimeHelper {
     static to24Hour(time: string): string;
     static generateTimings(interval: number, // In minutes
     format?: TimeFormat, startTime?: string | undefined, endTime?: string | undefined): string[];
-    static parseInput(input: string, format?: TimeFormat): string | undefined;
+    static parseInput(input: string | undefined, format?: TimeFormat): string | undefined;
     static findClosestFlooredTime(inputTime: string | undefined, timeArray: string[]): string | undefined;
     static timeToMinutes(time: string): number;
     static calculateDuration(startTime: string, endTime: string): number;

package/util/time-helper.js

@@ -1,2 +1,2 @@
-import t from"../external/dayjs/dayjs.min.js";import{StringHelper as r}from"./string-helper.js";var e;!function(t){t.AM="AM",t.PM="PM"}(e||(e={}));class o{static roundToNearestInterval(t,r,e){const[o,n]=t.split(":"),a=parseInt(o,10),i=parseInt(n,10);if(isNaN(a)||isNaN(i)||i<0||i>=60)throw new Error("Invalid time format");const s=60*a+i,u=s%r,l=0===u?s:e?s+(r-u):s-u,c=l%60;return`${Math.floor(l/60).toString().padStart(2,"0")}:${c.toString().padStart(2,"0")}`}static generateHourlyIntervals(r,e,o="ha"){const n="HH:mm";let a=t(r,n),i=t(e,n);a.isSame(i)&&(i=i.add(1,"day"));const s=[];for(;a.isBefore(i);)s.push(a.format(o)),a=a.add(1,"hour");return s}static getTimeValues(t,o){const n={hour:"",minute:"",period:e.AM};if(!o)return n;try{if("24hr"===t){const a=s(o,t);n.minute=r.padValue(a.minute);const i=parseInt(a.hour);0===Math.floor(i/12)?(n.period=e.AM,n.hour=0===i?"12":r.padValue(i.toString())):(n.period=e.PM,n.hour=12===i?i.toString():r.padValue((i-12).toString()))}else{const{hour:a,minute:i,period:u=""}=s(o,t);n.hour=r.padValue(a),n.minute=r.padValue(i),n.period="am"===u.toLowerCase()?e.AM:e.PM}return n}catch(t){return n}}static updateMinutes(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("0"):"55";const n=Math.floor(o/5),a=(("add"===e?n+1:o%5==0?n-1:n)%12+12)%12;return r.padValue((5*a).toString())}static updateHours(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("1"):"12";const n="add"===e?o+1:o-1;return n<=12&&n>0?r.padValue(n.toString()):13===n?r.padValue("1"):"12"}static convertTo24HourFormat(t){const r=parseInt(t.hour);let o;return o=t.period===e.PM?12===r?r.toString():(r+12).toString():12===r?"00":t.hour,`${o}:${t.minute}`}static convertHourTo12HourFormat(t){const e=parseInt(t),o=e%12==0?12..toString():(e%12).toString();return r.padValue(o)}static formatDisplayValue(t,e){try{const{hour:o,minute:n,period:a=""}=s(t,e),i=r.padValue(o);let u=`${i}:${r.padValue(n)}`;return"12hr"===e?(u+=a.toLowerCase(),u):u}catch(t){return""}}static toMinutesSeconds(t){return{minutes:Math.floor(t/60),seconds:t%60}}static to24Hour(t){if((null==t?void 0:t.includes("am"))||(null==t?void 0:t.includes("pm"))){const[r,e]=t.split(/(am|pm)/i),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&a<12&&(a+=12),"am"===e&&12===a&&(a=0),u(a,n)}return t}static generateTimings(t,r="12hr",e,n){const a=[];let i=0,s=1440-t;for(e&&(i=o.timeToMinutes(e)),n&&(s=o.timeToMinutes(n));i<=s;){let e=Math.floor(i/60);const o=i%60;if("12hr"===r){const t=e>=12?"pm":"am";e%=12,e=e||12;const r=u(e,o,t);a.push(r)}else{const t=u(e,o);a.push(t)}i+=t}return a}static parseInput(t,r="12hr"){if(""===t||void 0===t)return t;const e=t.trim().toLowerCase(),o=/^(?:(\d{1,2})([:.])?(\d{2})?)?(a|p|am|pm)?$/.exec(e);if(!o)return;let n=parseInt(o[1]||"0",10);const a=parseInt(o[3]||"0",10);let i=o[4];if(void 0===o[1]||n>24||a>59)return;if("a"===i?i="am":"p"===i&&(i="pm"),"24hr"===r)return"pm"===i&&n<12?n+=12:("am"===i&&12===n||24===n)&&(n=0),u(n,a);i?0===n||24===n?(i="am",n=12):n>12&&(i="pm",n-=12):(i=0===n||24===n||n>6&&n<12?"am":"pm",n=n%12||12);return u(n,a,i)}static findClosestFlooredTime(t,r){if(!t)return t;const e=o.timeToMinutes(t);let n="",a=1/0;for(const t of r){const r=o.timeToMinutes(t)-e;if(r<=0&&Math.abs(r)<a)a=Math.abs(r),n=t;else if(r>0)break}return n}static timeToMinutes(t){const[r,e]=t.toLowerCase().split(/(am|pm)/),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&12!==a&&(a+=12),"am"===e&&12===a&&(a=0),60*a+n}static calculateDuration(t,r){const e=o.timeToMinutes(t);return o.timeToMinutes(r)-e}static calculateScrollPosition(t){const{scrollTime:r,minTime:e,maxTime:a,interval:i,intervalWidth:s,options:u}=t;try{if(!/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(r))return console.warn(`Invalid scrollTime format: "${r}". Expected format: HH:mm.`),null;const t=(null==u?void 0:u.roundToInterval)?o.roundToNearestInterval(r,i):r,[l,c]=n(t);if(isNaN(l)||isNaN(c))return console.warn(`Invalid scrollTime: "${r}".`),null;const m=60*l+c,[p,d]=n(e),h=60*p+d,[f,g]=n(a);(m<h||m>60*f+g)&&console.warn(`scrollTime "${r}" is outside the range (${e} - ${a}).`);return(m-h)/i*s}catch(t){return console.warn(`Error processing scrollTime: "${r}".`,t),null}}}const n=t=>t.split(":").map(Number),a=(t,r)=>{const e=parseInt(t);return"24hr"===r?e>=0&&e<=23:e>=1&&e<=12},i=t=>{const r=parseInt(t);return r>=0&&r<=59},s=(t,r)=>{const e=t?t.split(":"):[],o=new Error("Invalid format");if("12hr"===r){if(2!==e.length||4!==e[1].length)throw o;const t=e[1].substring(0,2),s=e[1].substring(2);if(!a(e[0],r)||!i(t)||"am"!==(n=s).toLowerCase()&&"pm"!==n.toLowerCase())throw o;return{hour:e[0],minute:t,period:e[1].substring(2)}}if(2!==e.length)throw o;if(!a(e[0],r)||!i(e[1]))throw o;return{hour:e[0],minute:e[1]};var n},u=(t,r,e)=>e?`${t}:${r.toString().padStart(2,"0")}${e}`:`${t.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`;export{e as EPeriod,o as TimeHelper};
+import t from"../external/dayjs/dayjs.min.js";import{StringHelper as r}from"./string-helper.js";var e;!function(t){t.AM="AM",t.PM="PM"}(e||(e={}));class o{static roundToNearestInterval(t,r,e){const[o,n]=t.split(":"),a=parseInt(o,10),i=parseInt(n,10);if(isNaN(a)||isNaN(i)||i<0||i>=60)throw new Error("Invalid time format");const s=60*a+i,u=s%r,m=0===u?s:e?s+(r-u):s-u,l=m%60;return`${Math.floor(m/60).toString().padStart(2,"0")}:${l.toString().padStart(2,"0")}`}static generateHourlyIntervals(r,e,o="ha"){const n="HH:mm";let a=t(r,n),i=t(e,n);a.isSame(i)&&(i=i.add(1,"day"));const s=[];for(;a.isBefore(i);)s.push(a.format(o)),a=a.add(1,"hour");return s}static getTimeValues(t,o){const n={hour:"",minute:"",period:e.AM};if(!o)return n;try{if("24hr"===t){const a=s(o,t);n.minute=r.padValue(a.minute);const i=parseInt(a.hour);0===Math.floor(i/12)?(n.period=e.AM,n.hour=0===i?"12":r.padValue(i.toString())):(n.period=e.PM,n.hour=12===i?i.toString():r.padValue((i-12).toString()))}else{const{hour:a,minute:i,period:u=""}=s(o,t);n.hour=r.padValue(a),n.minute=r.padValue(i),n.period="am"===u.toLowerCase()?e.AM:e.PM}return n}catch(t){return n}}static updateMinutes(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("0"):"55";const n=Math.floor(o/5),a=(("add"===e?n+1:o%5==0?n-1:n)%12+12)%12;return r.padValue((5*a).toString())}static updateHours(t,e){const o=parseInt(t);if(isNaN(o))return"add"===e?r.padValue("1"):"12";const n="add"===e?o+1:o-1;return n<=12&&n>0?r.padValue(n.toString()):13===n?r.padValue("1"):"12"}static convertTo24HourFormat(t){const r=parseInt(t.hour);let o;return o=t.period===e.PM?12===r?r.toString():(r+12).toString():12===r?"00":t.hour,`${o}:${t.minute}`}static convertHourTo12HourFormat(t){const e=parseInt(t),o=e%12==0?12..toString():(e%12).toString();return r.padValue(o)}static formatTimeRange(r,e){return`${t(r,"HH:mm").format("h:mmA")} to ${t(e,"HH:mm").format("h:mmA")}`}static isSameTime(r,e){return t(r,"H:mm").isSame(t(e,"H:mm"),"minute")}static formatDisplayValue(t,e){try{const{hour:o,minute:n,period:a=""}=s(t,e),i=r.padValue(o);let u=`${i}:${r.padValue(n)}`;return"12hr"===e?(u+=a.toLowerCase(),u):u}catch(t){return""}}static toMinutesSeconds(t){return{minutes:Math.floor(t/60),seconds:t%60}}static to24Hour(t){if((null==t?void 0:t.includes("am"))||(null==t?void 0:t.includes("pm"))){const[r,e]=t.split(/(am|pm)/i),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&a<12&&(a+=12),"am"===e&&12===a&&(a=0),u(a,n)}return t}static generateTimings(t,r="12hr",e,n){const a=[];let i=0,s=1440-t;for(e&&(i=o.timeToMinutes(e)),n&&(s=o.timeToMinutes(n));i<=s;){let e=Math.floor(i/60);const o=i%60;if("12hr"===r){const t=e>=12?"pm":"am";e%=12,e=e||12;const r=u(e,o,t);a.push(r)}else{const t=u(e,o);a.push(t)}i+=t}return a}static parseInput(t,r="12hr"){if(""===t||void 0===t)return t;const e=t.trim().toLowerCase(),o=/^(?:(\d{1,2})([:.])?(\d{2})?)?(a|p|am|pm)?$/.exec(e);if(!o)return;let n=parseInt(o[1]||"0",10);const a=parseInt(o[3]||"0",10);let i=o[4];if(void 0===o[1]||n>24||a>59)return;if("a"===i?i="am":"p"===i&&(i="pm"),"24hr"===r)return"pm"===i&&n<12?n+=12:("am"===i&&12===n||24===n)&&(n=0),u(n,a);i?0===n||24===n?(i="am",n=12):n>12&&(i="pm",n-=12):(i=0===n||24===n||n>6&&n<12?"am":"pm",n=n%12||12);return u(n,a,i)}static findClosestFlooredTime(t,r){if(!t)return t;const e=o.timeToMinutes(t);let n="",a=1/0;for(const t of r){const r=o.timeToMinutes(t)-e;if(r<=0&&Math.abs(r)<a)a=Math.abs(r),n=t;else if(r>0)break}return n}static timeToMinutes(t){const[r,e]=t.toLowerCase().split(/(am|pm)/),[o,n]=r.split(":").map(Number);let a=o;return"pm"===e&&12!==a&&(a+=12),"am"===e&&12===a&&(a=0),60*a+n}static calculateDuration(t,r){const e=o.timeToMinutes(t);return o.timeToMinutes(r)-e}static calculateScrollPosition(t){const{scrollTime:r,minTime:e,maxTime:a,interval:i,intervalWidth:s,options:u}=t;try{if(!/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(r))return console.warn(`Invalid scrollTime format: "${r}". Expected format: HH:mm.`),null;const t=(null==u?void 0:u.roundToInterval)?o.roundToNearestInterval(r,i):r,[m,l]=n(t);if(isNaN(m)||isNaN(l))return console.warn(`Invalid scrollTime: "${r}".`),null;const c=60*m+l,[p,d]=n(e),h=60*p+d,[f,g]=n(a);(c<h||c>60*f+g)&&console.warn(`scrollTime "${r}" is outside the range (${e} - ${a}).`);return(c-h)/i*s}catch(t){return console.warn(`Error processing scrollTime: "${r}".`,t),null}}}const n=t=>t.split(":").map(Number),a=(t,r)=>{const e=parseInt(t);return"24hr"===r?e>=0&&e<=23:e>=1&&e<=12},i=t=>{const r=parseInt(t);return r>=0&&r<=59},s=(t,r)=>{const e=t?t.split(":"):[],o=new Error("Invalid format");if("12hr"===r){if(2!==e.length||4!==e[1].length)throw o;const t=e[1].substring(0,2),s=e[1].substring(2);if(!a(e[0],r)||!i(t)||"am"!==(n=s).toLowerCase()&&"pm"!==n.toLowerCase())throw o;return{hour:e[0],minute:t,period:e[1].substring(2)}}if(2!==e.length)throw o;if(!a(e[0],r)||!i(e[1]))throw o;return{hour:e[0],minute:e[1]};var n},u=(t,r,e)=>e?`${t}:${r.toString().padStart(2,"0")}${e}`:`${t.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`;export{e as EPeriod,o as TimeHelper};
 //# sourceMappingURL=time-helper.js.map

package/util/time-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-helper.js","sources":["../../src/util/time-helper.ts"],"sourcesContent":["import dayjs from \"dayjs\";\n\nimport { StringHelper } from \"./string-helper\";\n\n// =============================================================================\n// INTERFACES\n// =============================================================================\nexport type TimeFormat = \"12hr\" | \"24hr\";\n\nexport enum EPeriod {\n    AM = \"AM\",\n    PM = \"PM\",\n}\n\nexport interface TimeValues {\n    hour: string;\n    minute: string;\n    period: EPeriod;\n}\n\nexport interface CalculateScrollPositionProps {\n    /** The time to scroll to in HH:mm format */\n    scrollTime: string;\n    /** The minimum time of the scrollable range in HH:mm format */\n    minTime: string;\n    /** The maximum time of the scrollable range in HH:mm format */\n    maxTime: string;\n    /** The interval in minutes (e.g., 15, 30, 60) */\n    interval: number;\n    /** The width in pixels of each interval */\n    intervalWidth: number;\n    /** Optional configuration */\n    options?: {\n        /** Round the scroll time to the nearest interval */\n        roundToInterval?: boolean;\n    };\n}\n\n// unexportable\ninterface TimeValuesPlain {\n    hour: string;\n    minute: string;\n    period?: string;\n}\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\nexport class TimeHelper {\n    /**\n     * Rounds time to the nearest interval, e.g 6:30 will be clamped to 6:00 when interval = 60\n     * @param time the input time in HH:mm format\n     * @param interval the interval in minutes (e.g., 15 for 15 minutes, 60 for 1 hour)\n     * @param toNextInterval to clamp to next interval instead, e.g. 6:30 will be clamped to 7:00 when interval = 60.\n     * If the time is already a valid interval, it will not be rounded\n     * @returns the rounded time in HH:mm format,\n     */\n    public static roundToNearestInterval(\n        time: string,\n        interval: number,\n        toNextInterval?: boolean\n    ): string {\n        const [hoursStr, minutesStr] = time.split(\":\");\n        const hours = parseInt(hoursStr, 10);\n        const minutes = parseInt(minutesStr, 10);\n\n        // Handle invalid inputs\n        if (isNaN(hours) || isNaN(minutes) || minutes < 0 || minutes >= 60) {\n            throw new Error(\"Invalid time format\");\n        }\n\n        // Convert the time to total minutes\n        const totalMinutes = hours * 60 + minutes;\n        const remainder = totalMinutes % interval;\n\n        // Calculate the rounded total minutes\n        const roundedMinutes =\n            remainder === 0\n                ? totalMinutes\n                : toNextInterval\n                ? totalMinutes + (interval - remainder)\n                : totalMinutes - remainder;\n\n        // Convert the rounded total minutes back to hours and minutes\n        const roundedHours = Math.floor(roundedMinutes / 60);\n        const roundedMinutesWithinHour = roundedMinutes % 60;\n\n        // Format the result as HH:mm, allowing for hours >= 24\n        const formattedHours = roundedHours.toString().padStart(2, \"0\");\n        const formattedMinutes = roundedMinutesWithinHour\n            .toString()\n            .padStart(2, \"0\");\n\n        return `${formattedHours}:${formattedMinutes}`;\n    }\n\n    public static generateHourlyIntervals(\n        startTime: string,\n        endTime: string,\n        generatedFormat = \"ha\"\n    ): string[] {\n        const format = \"HH:mm\";\n        let start = dayjs(startTime, format);\n        let end = dayjs(endTime, format);\n\n        if (start.isSame(end)) {\n            end = end.add(1, \"day\");\n        }\n\n        const intervals: string[] = [];\n\n        while (start.isBefore(end)) {\n            intervals.push(start.format(generatedFormat));\n            start = start.add(1, \"hour\");\n        }\n\n        return intervals;\n    }\n\n    public static getTimeValues(\n        format: TimeFormat,\n        value: string | undefined\n    ): TimeValues {\n        // Default value\n        const timeValues: TimeValues = {\n            hour: \"\",\n            minute: \"\",\n            period: EPeriod.AM,\n        };\n\n        if (!value) return timeValues;\n\n        try {\n            if (format === \"24hr\") {\n                const plain = convertToPlain(value, format);\n                // Add minute\n                timeValues.minute = StringHelper.padValue(plain.minute);\n\n                // Determine period, and convert to 12 hour value\n                const hour = parseInt(plain.hour);\n\n                if (Math.floor(hour / 12) === 0) {\n                    timeValues.period = EPeriod.AM;\n                    timeValues.hour =\n                        hour === 0\n                            ? \"12\"\n                            : StringHelper.padValue(hour.toString());\n                } else {\n                    timeValues.period = EPeriod.PM;\n                    timeValues.hour =\n                        hour === 12\n                            ? hour.toString()\n                            : StringHelper.padValue((hour - 12).toString());\n                }\n            } else {\n                const {\n                    hour,\n                    minute,\n                    period = \"\",\n                } = convertToPlain(value, format);\n\n                timeValues.hour = StringHelper.padValue(hour);\n                timeValues.minute = StringHelper.padValue(minute);\n                timeValues.period =\n                    period.toLowerCase() === \"am\" ? EPeriod.AM : EPeriod.PM;\n            }\n\n            return timeValues;\n        } catch {\n            return timeValues;\n        }\n    }\n\n    public static updateMinutes(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"0\") : \"55\";\n        }\n\n        /**\n         * We would increment or decrement by steps of 5\n         * Hence from 0 to 55, there are 12 steps\n         */\n        const steps = 12;\n\n        /**\n         * Look for last nearest step\n         * E.g. value 4 would be step 0 = 0, value 6 would be step 1 = 5\n         */\n        const lastNearestStep = Math.floor(currentValue / 5);\n\n        /**\n         * Getting the next step value would have to incorporate a cycle of the upper\n         * and lower limits. In this case upper = 12, lower = 0.\n         * If one is to increment from step 12, it would then go back to 0.\n         * If one is to decrement from step 0, it would then go back to 12.\n         * Reference: https://dev.to/turneremma21/circular-access-of-array-in-javascript-j52\n         */\n        const nextStep =\n            direction === \"add\"\n                ? lastNearestStep + 1\n                : currentValue % 5 === 0\n                ? lastNearestStep - 1 // if it is a value on the step, decrement one more\n                : lastNearestStep; // else the last nearest step would suffice\n        const newStep = ((nextStep % steps) + steps) % steps;\n\n        return StringHelper.padValue((newStep * 5).toString());\n    }\n\n    public static updateHours(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"1\") : \"12\";\n        }\n\n        const nextValue =\n            direction === \"add\" ? currentValue + 1 : currentValue - 1;\n\n        return nextValue <= 12 && nextValue > 0\n            ? StringHelper.padValue(nextValue.toString())\n            : nextValue === 13\n            ? StringHelper.padValue(\"1\")\n            : \"12\";\n    }\n\n    public static convertTo24HourFormat(values: TimeValues): string {\n        const hour = parseInt(values.hour);\n        let hourString: string;\n\n        if (values.period === EPeriod.PM) {\n            hourString = hour === 12 ? hour.toString() : (hour + 12).toString();\n        } else {\n            hourString = hour === 12 ? \"00\" : values.hour;\n        }\n\n        return `${hourString}:${values.minute}`;\n    }\n\n    public static convertHourTo12HourFormat(hourValue: string): string {\n        const hour = parseInt(hourValue);\n        const hourString =\n            hour % 12 === 0 ? (12).toString() : (hour % 12).toString();\n\n        return StringHelper.padValue(hourString);\n    }\n\n    public static formatDisplayValue(\n        value: string | undefined,\n        format: TimeFormat\n    ): string {\n        try {\n            const { hour, minute, period = \"\" } = convertToPlain(value, format);\n\n            const paddedHour = StringHelper.padValue(hour);\n            const paddedMinute = StringHelper.padValue(minute);\n\n            let formatted = `${paddedHour}:${paddedMinute}`;\n\n            if (format === \"12hr\") {\n                formatted += period.toLowerCase();\n\n                return formatted;\n            }\n\n            return formatted;\n        } catch {\n            return \"\";\n        }\n    }\n\n    public static toMinutesSeconds(_seconds: number) {\n        const minutes = Math.floor(_seconds / 60);\n        const seconds = _seconds % 60;\n\n        return {\n            minutes,\n            seconds,\n        };\n    }\n\n    // Converts h:mma/hh:mma to 24hr (eg. 13:00)\n    public static to24Hour(time: string) {\n        if (time?.includes(\"am\") || time?.includes(\"pm\")) {\n            const [t, p] = time.split(/(am|pm)/i);\n            const [hr, m] = t.split(\":\").map(Number);\n            let h = hr;\n            if (p === \"pm\" && h < 12) h += 12;\n            if (p === \"am\" && h === 12) h = 0;\n            return toTimeString(h, m);\n        }\n        return time; // No conversion if string alr has am/pm\n    }\n\n    // Generates an array of timings based on given startTime/interval/format\n    public static generateTimings(\n        interval: number, // In minutes\n        format: TimeFormat = \"12hr\",\n        startTime?: string | undefined,\n        endTime?: string | undefined // Inclusive\n    ): string[] {\n        const timings = [];\n        let currentMinutes = 0;\n        let endMinutes = 1440 - interval; // Do not include next day's 12am\n\n        // Convert startTime (h:mma) to minutes\n        if (startTime) {\n            currentMinutes = TimeHelper.timeToMinutes(startTime);\n        }\n        if (endTime) {\n            endMinutes = TimeHelper.timeToMinutes(endTime);\n        }\n\n        while (currentMinutes <= endMinutes) {\n            let hours = Math.floor(currentMinutes / 60);\n            const minutes = currentMinutes % 60;\n\n            if (format === \"12hr\") {\n                const period = hours >= 12 ? \"pm\" : \"am\";\n\n                hours = hours % 12;\n                hours = hours ? hours : 12; // Convert hour 0 to 12\n\n                const timeString = toTimeString(hours, minutes, period);\n                timings.push(timeString);\n            } else {\n                const timeString = toTimeString(hours, minutes);\n                timings.push(timeString);\n            }\n\n            currentMinutes += interval;\n        }\n\n        return timings;\n    }\n\n    // Return undefined = invalid field, \"\" = empty field, else returns h:mma\n    public static parseInput(\n        input: string,\n        format: TimeFormat = \"12hr\" // Returned format\n    ): string | undefined {\n        if (input === \"\" || input === undefined) return input;\n\n        const sanitizedInput = input.trim().toLowerCase();\n        const timeRegex = /^(?:(\\d{1,2})([:.])?(\\d{2})?)?(a|p|am|pm)?$/;\n        const match = timeRegex.exec(sanitizedInput);\n\n        if (!match) return;\n\n        let hours = parseInt(match[1] || \"0\", 10);\n        const minutes = parseInt(match[3] || \"0\", 10);\n        let period = match[4];\n\n        // Ensure hours/mins are valid\n        if (match[1] === undefined || hours > 24 || minutes > 59) return;\n\n        // Convert single-character periods to full am/pm\n        if (period === \"a\") {\n            period = \"am\";\n        } else if (period === \"p\") {\n            period = \"pm\";\n        }\n\n        if (format === \"24hr\") {\n            // Convert 12-hour input to 24-hour format if period is present\n            if (period === \"pm\" && hours < 12) {\n                hours += 12;\n            } else if ((period === \"am\" && hours === 12) || hours === 24) {\n                hours = 0; // Midnight case\n            }\n\n            // Return time in 24-hour format (HH:mm)\n            return toTimeString(hours, minutes);\n        }\n\n        // Handle 24-hour times or AM/PM conversion\n        if (period) {\n            if (hours === 0 || hours === 24) {\n                period = \"am\";\n                hours = 12;\n            } else if (hours > 12) {\n                period = \"pm\";\n                hours -= 12;\n            }\n        } else {\n            period =\n                // NOTE: 12 or 1-6 will default to pm for convenience\n                hours === 0 || hours === 24 || (hours > 6 && hours < 12)\n                    ? \"am\"\n                    : \"pm\";\n            hours = hours % 12 || 12;\n        }\n\n        // Format the time as h:mma\n        const formattedTime = toTimeString(hours, minutes, period);\n\n        return formattedTime;\n    }\n\n    public static findClosestFlooredTime(\n        inputTime: string | undefined,\n        timeArray: string[] // Should already be sorted in ascending order\n    ): string | undefined {\n        if (!inputTime) return inputTime;\n        const flooredInputMinutes = TimeHelper.timeToMinutes(inputTime);\n\n        let closestTime = \"\";\n        let minDifference = Infinity;\n\n        for (const time of timeArray) {\n            const timeInMinutes = TimeHelper.timeToMinutes(time);\n            const difference = timeInMinutes - flooredInputMinutes;\n\n            // If the difference is negative or zero, update the closest time\n            if (difference <= 0 && Math.abs(difference) < minDifference) {\n                minDifference = Math.abs(difference);\n                closestTime = time;\n            }\n            // If the difference becomes positive, we've passed the closest time\n            else if (difference > 0) {\n                break;\n            }\n        }\n\n        return closestTime;\n    }\n\n    // Accepts both 12hr and 24hr formats\n    public static timeToMinutes(time: string): number {\n        const [startHourMin, ampm] = time.toLowerCase().split(/(am|pm)/);\n        const [startHoursRaw, startMinutes] = startHourMin\n            .split(\":\")\n            .map(Number);\n        let startHours = startHoursRaw;\n\n        if (ampm === \"pm\" && startHours !== 12) {\n            startHours += 12; // Convert PM hours to 24-hour format\n        }\n        if (ampm === \"am\" && startHours === 12) {\n            startHours = 0; // Convert 12am to 0 hours\n        }\n\n        return startHours * 60 + startMinutes;\n    }\n\n    // Calculate duration between two time strings\n    public static calculateDuration(\n        startTime: string,\n        endTime: string\n    ): number {\n        const startMinutes = TimeHelper.timeToMinutes(startTime);\n        const endMinutes = TimeHelper.timeToMinutes(endTime);\n        return endMinutes - startMinutes;\n    }\n\n    /**\n     * Validates and calculates scroll position for a given time\n     * @param props - The configuration object for calculating scroll position\n     * @returns the calculated scroll position in pixels, or null if invalid\n     */\n    public static calculateScrollPosition(\n        props: CalculateScrollPositionProps\n    ): number | null {\n        const {\n            scrollTime,\n            minTime,\n            maxTime,\n            interval,\n            intervalWidth,\n            options,\n        } = props;\n\n        try {\n            // Validate time format (HH:mm)\n            const timeRegex = /^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/;\n            if (!timeRegex.test(scrollTime)) {\n                console.warn(\n                    `Invalid scrollTime format: \"${scrollTime}\". Expected format: HH:mm.`\n                );\n                return null;\n            }\n\n            // Round to nearest interval if specified\n            const timeToUse = options?.roundToInterval\n                ? TimeHelper.roundToNearestInterval(scrollTime, interval)\n                : scrollTime;\n\n            const [hours, minutes] = parseTimeToNumbers(timeToUse);\n\n            // Validate parsed values\n            if (isNaN(hours) || isNaN(minutes)) {\n                console.warn(`Invalid scrollTime: \"${scrollTime}\".`);\n                return null;\n            }\n\n            const scrollMinutes = hours * 60 + minutes;\n\n            const [minHours, minMinutes] = parseTimeToNumbers(minTime);\n            const minTotalMinutes = minHours * 60 + minMinutes;\n\n            const [maxHours, maxMinutes] = parseTimeToNumbers(maxTime);\n            const maxTotalMinutes = maxHours * 60 + maxMinutes;\n\n            // Warn if time is outside the visible range\n            if (\n                scrollMinutes < minTotalMinutes ||\n                scrollMinutes > maxTotalMinutes\n            ) {\n                console.warn(\n                    `scrollTime \"${scrollTime}\" is outside the range (${minTime} - ${maxTime}).`\n                );\n            }\n\n            const minutesFromStart = scrollMinutes - minTotalMinutes;\n            const intervalsFromStart = minutesFromStart / interval;\n            const scrollPosition = intervalsFromStart * intervalWidth;\n\n            return scrollPosition;\n        } catch (error) {\n            console.warn(\n                `Error processing scrollTime: \"${scrollTime}\".`,\n                error\n            );\n            return null;\n        }\n    }\n}\n\n// =============================================================================\n// NON-EXPORTABLES\n// =============================================================================\n\n/**\n * Parses a time string in HH:mm format to separate hour and minute values\n * @param timeString - Time string in HH:mm format (e.g., \"09:30\", \"14:45\")\n * @returns Array containing [hours, minutes] as numbers\n * @example\n * parseTimeToNumbers(\"09:30\") // returns [9, 30]\n * parseTimeToNumbers(\"14:45\") // returns [14, 45]\n */\nconst parseTimeToNumbers = (timeString: string): number[] => {\n    return timeString.split(\":\").map(Number);\n};\nconst isValidHour = (hourString: string, format: TimeFormat): boolean => {\n    const numValue = parseInt(hourString);\n    return format === \"24hr\"\n        ? numValue >= 0 && numValue <= 23\n        : numValue >= 1 && numValue <= 12;\n};\n\nconst isValidMinutes = (hourString: string): boolean => {\n    const numValue = parseInt(hourString);\n    return numValue >= 0 && numValue <= 59;\n};\n\nconst isValidTimePeriod = (timePeriodString: string): boolean => {\n    return (\n        timePeriodString.toLowerCase() === \"am\" ||\n        timePeriodString.toLowerCase() === \"pm\"\n    );\n};\n\nconst convertToPlain = (\n    value: string | undefined,\n    format: TimeFormat\n): TimeValuesPlain => {\n    const timeArr = value ? value.split(\":\") : [];\n    const error = new Error(\"Invalid format\");\n\n    if (format === \"12hr\") {\n        // Check format\n        if (timeArr.length !== 2 || timeArr[1].length !== 4) throw error;\n\n        const minute = timeArr[1].substring(0, 2);\n        const period = timeArr[1].substring(2);\n\n        // Validate hour, minute and time period values\n        if (\n            !isValidHour(timeArr[0], format) ||\n            !isValidMinutes(minute) ||\n            !isValidTimePeriod(period)\n        ) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute,\n            period: timeArr[1].substring(2),\n        };\n    } else {\n        // Check format\n        if (timeArr.length !== 2) throw error;\n\n        // Validate hour and minute values\n        if (!isValidHour(timeArr[0], format) || !isValidMinutes(timeArr[1])) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute: timeArr[1],\n        };\n    }\n};\n\nconst toTimeString = (hours: number, minutes: number, period?: string) => {\n    return period\n        ? `${hours}:${minutes.toString().padStart(2, \"0\")}${period}`\n        : `${hours.toString().padStart(2, \"0\")}:${minutes\n              .toString()\n              .padStart(2, \"0\")}`;\n};\n"],"names":["EPeriod","TimeHelper","roundToNearestInterval","time","interval","toNextInterval","hoursStr","minutesStr","split","hours","parseInt","minutes","isNaN","Error","totalMinutes","remainder","roundedMinutes","roundedMinutesWithinHour","Math","floor","toString","padStart","generateHourlyIntervals","startTime","endTime","generatedFormat","format","start","dayjs","end","isSame","add","intervals","isBefore","push","getTimeValues","value","timeValues","hour","minute","period","AM","plain","convertToPlain","StringHelper","padValue","PM","toLowerCase","_a","updateMinutes","valueString","direction","currentValue","lastNearestStep","newStep","updateHours","nextValue","convertTo24HourFormat","values","hourString","convertHourTo12HourFormat","hourValue","formatDisplayValue","paddedHour","formatted","toMinutesSeconds","_seconds","seconds","to24Hour","includes","t","p","hr","m","map","Number","h","toTimeString","generateTimings","timings","currentMinutes","endMinutes","timeToMinutes","timeString","parseInput","input","undefined","sanitizedInput","trim","match","exec","findClosestFlooredTime","inputTime","timeArray","flooredInputMinutes","closestTime","minDifference","Infinity","difference","abs","startHourMin","ampm","startHoursRaw","startMinutes","startHours","calculateDuration","calculateScrollPosition","props","scrollTime","minTime","maxTime","intervalWidth","options","test","console","warn","timeToUse","roundToInterval","parseTimeToNumbers","scrollMinutes","minHours","minMinutes","minTotalMinutes","maxHours","maxMinutes","error","isValidHour","numValue","isValidMinutes","timeArr","length","substring","timePeriodString"],"mappings":"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"}
+{"version":3,"file":"time-helper.js","sources":["../../src/util/time-helper.ts"],"sourcesContent":["import dayjs from \"dayjs\";\n\nimport { StringHelper } from \"./string-helper\";\n\n// =============================================================================\n// INTERFACES\n// =============================================================================\nexport type TimeFormat = \"12hr\" | \"24hr\";\n\nexport enum EPeriod {\n    AM = \"AM\",\n    PM = \"PM\",\n}\n\nexport interface TimeValues {\n    hour: string;\n    minute: string;\n    period: EPeriod;\n}\n\nexport interface CalculateScrollPositionProps {\n    /** The time to scroll to in HH:mm format */\n    scrollTime: string;\n    /** The minimum time of the scrollable range in HH:mm format */\n    minTime: string;\n    /** The maximum time of the scrollable range in HH:mm format */\n    maxTime: string;\n    /** The interval in minutes (e.g., 15, 30, 60) */\n    interval: number;\n    /** The width in pixels of each interval */\n    intervalWidth: number;\n    /** Optional configuration */\n    options?: {\n        /** Round the scroll time to the nearest interval */\n        roundToInterval?: boolean;\n    };\n}\n\n// unexportable\ninterface TimeValuesPlain {\n    hour: string;\n    minute: string;\n    period?: string;\n}\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\nexport class TimeHelper {\n    /**\n     * Rounds time to the nearest interval, e.g 6:30 will be clamped to 6:00 when interval = 60\n     * @param time the input time in HH:mm format\n     * @param interval the interval in minutes (e.g., 15 for 15 minutes, 60 for 1 hour)\n     * @param toNextInterval to clamp to next interval instead, e.g. 6:30 will be clamped to 7:00 when interval = 60.\n     * If the time is already a valid interval, it will not be rounded\n     * @returns the rounded time in HH:mm format,\n     */\n    public static roundToNearestInterval(\n        time: string,\n        interval: number,\n        toNextInterval?: boolean\n    ): string {\n        const [hoursStr, minutesStr] = time.split(\":\");\n        const hours = parseInt(hoursStr, 10);\n        const minutes = parseInt(minutesStr, 10);\n\n        // Handle invalid inputs\n        if (isNaN(hours) || isNaN(minutes) || minutes < 0 || minutes >= 60) {\n            throw new Error(\"Invalid time format\");\n        }\n\n        // Convert the time to total minutes\n        const totalMinutes = hours * 60 + minutes;\n        const remainder = totalMinutes % interval;\n\n        // Calculate the rounded total minutes\n        const roundedMinutes =\n            remainder === 0\n                ? totalMinutes\n                : toNextInterval\n                ? totalMinutes + (interval - remainder)\n                : totalMinutes - remainder;\n\n        // Convert the rounded total minutes back to hours and minutes\n        const roundedHours = Math.floor(roundedMinutes / 60);\n        const roundedMinutesWithinHour = roundedMinutes % 60;\n\n        // Format the result as HH:mm, allowing for hours >= 24\n        const formattedHours = roundedHours.toString().padStart(2, \"0\");\n        const formattedMinutes = roundedMinutesWithinHour\n            .toString()\n            .padStart(2, \"0\");\n\n        return `${formattedHours}:${formattedMinutes}`;\n    }\n\n    public static generateHourlyIntervals(\n        startTime: string,\n        endTime: string,\n        generatedFormat = \"ha\"\n    ): string[] {\n        const format = \"HH:mm\";\n        let start = dayjs(startTime, format);\n        let end = dayjs(endTime, format);\n\n        if (start.isSame(end)) {\n            end = end.add(1, \"day\");\n        }\n\n        const intervals: string[] = [];\n\n        while (start.isBefore(end)) {\n            intervals.push(start.format(generatedFormat));\n            start = start.add(1, \"hour\");\n        }\n\n        return intervals;\n    }\n\n    public static getTimeValues(\n        format: TimeFormat,\n        value: string | undefined\n    ): TimeValues {\n        // Default value\n        const timeValues: TimeValues = {\n            hour: \"\",\n            minute: \"\",\n            period: EPeriod.AM,\n        };\n\n        if (!value) return timeValues;\n\n        try {\n            if (format === \"24hr\") {\n                const plain = convertToPlain(value, format);\n                // Add minute\n                timeValues.minute = StringHelper.padValue(plain.minute);\n\n                // Determine period, and convert to 12 hour value\n                const hour = parseInt(plain.hour);\n\n                if (Math.floor(hour / 12) === 0) {\n                    timeValues.period = EPeriod.AM;\n                    timeValues.hour =\n                        hour === 0\n                            ? \"12\"\n                            : StringHelper.padValue(hour.toString());\n                } else {\n                    timeValues.period = EPeriod.PM;\n                    timeValues.hour =\n                        hour === 12\n                            ? hour.toString()\n                            : StringHelper.padValue((hour - 12).toString());\n                }\n            } else {\n                const {\n                    hour,\n                    minute,\n                    period = \"\",\n                } = convertToPlain(value, format);\n\n                timeValues.hour = StringHelper.padValue(hour);\n                timeValues.minute = StringHelper.padValue(minute);\n                timeValues.period =\n                    period.toLowerCase() === \"am\" ? EPeriod.AM : EPeriod.PM;\n            }\n\n            return timeValues;\n        } catch {\n            return timeValues;\n        }\n    }\n\n    public static updateMinutes(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"0\") : \"55\";\n        }\n\n        /**\n         * We would increment or decrement by steps of 5\n         * Hence from 0 to 55, there are 12 steps\n         */\n        const steps = 12;\n\n        /**\n         * Look for last nearest step\n         * E.g. value 4 would be step 0 = 0, value 6 would be step 1 = 5\n         */\n        const lastNearestStep = Math.floor(currentValue / 5);\n\n        /**\n         * Getting the next step value would have to incorporate a cycle of the upper\n         * and lower limits. In this case upper = 12, lower = 0.\n         * If one is to increment from step 12, it would then go back to 0.\n         * If one is to decrement from step 0, it would then go back to 12.\n         * Reference: https://dev.to/turneremma21/circular-access-of-array-in-javascript-j52\n         */\n        const nextStep =\n            direction === \"add\"\n                ? lastNearestStep + 1\n                : currentValue % 5 === 0\n                ? lastNearestStep - 1 // if it is a value on the step, decrement one more\n                : lastNearestStep; // else the last nearest step would suffice\n        const newStep = ((nextStep % steps) + steps) % steps;\n\n        return StringHelper.padValue((newStep * 5).toString());\n    }\n\n    public static updateHours(\n        valueString: string,\n        direction: \"add\" | \"minus\"\n    ): string {\n        const currentValue = parseInt(valueString);\n\n        if (isNaN(currentValue)) {\n            return direction === \"add\" ? StringHelper.padValue(\"1\") : \"12\";\n        }\n\n        const nextValue =\n            direction === \"add\" ? currentValue + 1 : currentValue - 1;\n\n        return nextValue <= 12 && nextValue > 0\n            ? StringHelper.padValue(nextValue.toString())\n            : nextValue === 13\n            ? StringHelper.padValue(\"1\")\n            : \"12\";\n    }\n\n    public static convertTo24HourFormat(values: TimeValues): string {\n        const hour = parseInt(values.hour);\n        let hourString: string;\n\n        if (values.period === EPeriod.PM) {\n            hourString = hour === 12 ? hour.toString() : (hour + 12).toString();\n        } else {\n            hourString = hour === 12 ? \"00\" : values.hour;\n        }\n\n        return `${hourString}:${values.minute}`;\n    }\n\n    public static convertHourTo12HourFormat(hourValue: string): string {\n        const hour = parseInt(hourValue);\n        const hourString =\n            hour % 12 === 0 ? (12).toString() : (hour % 12).toString();\n\n        return StringHelper.padValue(hourString);\n    }\n\n    /**\n     * Formats a 24hr time range into a 12hr display string.\n     * @param start - \"HH:mm\" e.g. \"13:00\"\n     * @param end   - \"HH:mm\" e.g. \"14:30\"\n     * @returns e.g. \"1:00PM to 2:30PM\"\n     */\n    public static formatTimeRange(start: string, end: string): string {\n        return `${dayjs(start, \"HH:mm\").format(\"h:mmA\")} to ${dayjs(\n            end,\n            \"HH:mm\"\n        ).format(\"h:mmA\")}`;\n    }\n\n    public static isSameTime(a: string, b: string): boolean {\n        return dayjs(a, \"H:mm\").isSame(dayjs(b, \"H:mm\"), \"minute\");\n    }\n\n    public static formatDisplayValue(\n        value: string | undefined,\n        format: TimeFormat\n    ): string {\n        try {\n            const { hour, minute, period = \"\" } = convertToPlain(value, format);\n\n            const paddedHour = StringHelper.padValue(hour);\n            const paddedMinute = StringHelper.padValue(minute);\n\n            let formatted = `${paddedHour}:${paddedMinute}`;\n\n            if (format === \"12hr\") {\n                formatted += period.toLowerCase();\n\n                return formatted;\n            }\n\n            return formatted;\n        } catch {\n            return \"\";\n        }\n    }\n\n    public static toMinutesSeconds(_seconds: number) {\n        const minutes = Math.floor(_seconds / 60);\n        const seconds = _seconds % 60;\n\n        return {\n            minutes,\n            seconds,\n        };\n    }\n\n    // Converts h:mma/hh:mma to 24hr (eg. 13:00)\n    public static to24Hour(time: string) {\n        if (time?.includes(\"am\") || time?.includes(\"pm\")) {\n            const [t, p] = time.split(/(am|pm)/i);\n            const [hr, m] = t.split(\":\").map(Number);\n            let h = hr;\n            if (p === \"pm\" && h < 12) h += 12;\n            if (p === \"am\" && h === 12) h = 0;\n            return toTimeString(h, m);\n        }\n        return time; // No conversion if string alr has am/pm\n    }\n\n    // Generates an array of timings based on given startTime/interval/format\n    public static generateTimings(\n        interval: number, // In minutes\n        format: TimeFormat = \"12hr\",\n        startTime?: string | undefined,\n        endTime?: string | undefined // Inclusive\n    ): string[] {\n        const timings = [];\n        let currentMinutes = 0;\n        let endMinutes = 1440 - interval; // Do not include next day's 12am\n\n        // Convert startTime (h:mma) to minutes\n        if (startTime) {\n            currentMinutes = TimeHelper.timeToMinutes(startTime);\n        }\n        if (endTime) {\n            endMinutes = TimeHelper.timeToMinutes(endTime);\n        }\n\n        while (currentMinutes <= endMinutes) {\n            let hours = Math.floor(currentMinutes / 60);\n            const minutes = currentMinutes % 60;\n\n            if (format === \"12hr\") {\n                const period = hours >= 12 ? \"pm\" : \"am\";\n\n                hours = hours % 12;\n                hours = hours ? hours : 12; // Convert hour 0 to 12\n\n                const timeString = toTimeString(hours, minutes, period);\n                timings.push(timeString);\n            } else {\n                const timeString = toTimeString(hours, minutes);\n                timings.push(timeString);\n            }\n\n            currentMinutes += interval;\n        }\n\n        return timings;\n    }\n\n    // Return undefined = invalid field, \"\" = empty field, else returns h:mma\n    public static parseInput(\n        input: string | undefined,\n        format: TimeFormat = \"12hr\" // Returned format\n    ): string | undefined {\n        if (input === \"\" || input === undefined) return input;\n\n        const sanitizedInput = input.trim().toLowerCase();\n        const timeRegex = /^(?:(\\d{1,2})([:.])?(\\d{2})?)?(a|p|am|pm)?$/;\n        const match = timeRegex.exec(sanitizedInput);\n\n        if (!match) return;\n\n        let hours = parseInt(match[1] || \"0\", 10);\n        const minutes = parseInt(match[3] || \"0\", 10);\n        let period = match[4];\n\n        // Ensure hours/mins are valid\n        if (match[1] === undefined || hours > 24 || minutes > 59) return;\n\n        // Convert single-character periods to full am/pm\n        if (period === \"a\") {\n            period = \"am\";\n        } else if (period === \"p\") {\n            period = \"pm\";\n        }\n\n        if (format === \"24hr\") {\n            // Convert 12-hour input to 24-hour format if period is present\n            if (period === \"pm\" && hours < 12) {\n                hours += 12;\n            } else if ((period === \"am\" && hours === 12) || hours === 24) {\n                hours = 0; // Midnight case\n            }\n\n            // Return time in 24-hour format (HH:mm)\n            return toTimeString(hours, minutes);\n        }\n\n        // Handle 24-hour times or AM/PM conversion\n        if (period) {\n            if (hours === 0 || hours === 24) {\n                period = \"am\";\n                hours = 12;\n            } else if (hours > 12) {\n                period = \"pm\";\n                hours -= 12;\n            }\n        } else {\n            period =\n                // NOTE: 12 or 1-6 will default to pm for convenience\n                hours === 0 || hours === 24 || (hours > 6 && hours < 12)\n                    ? \"am\"\n                    : \"pm\";\n            hours = hours % 12 || 12;\n        }\n\n        // Format the time as h:mma\n        const formattedTime = toTimeString(hours, minutes, period);\n\n        return formattedTime;\n    }\n\n    public static findClosestFlooredTime(\n        inputTime: string | undefined,\n        timeArray: string[] // Should already be sorted in ascending order\n    ): string | undefined {\n        if (!inputTime) return inputTime;\n        const flooredInputMinutes = TimeHelper.timeToMinutes(inputTime);\n\n        let closestTime = \"\";\n        let minDifference = Infinity;\n\n        for (const time of timeArray) {\n            const timeInMinutes = TimeHelper.timeToMinutes(time);\n            const difference = timeInMinutes - flooredInputMinutes;\n\n            // If the difference is negative or zero, update the closest time\n            if (difference <= 0 && Math.abs(difference) < minDifference) {\n                minDifference = Math.abs(difference);\n                closestTime = time;\n            }\n            // If the difference becomes positive, we've passed the closest time\n            else if (difference > 0) {\n                break;\n            }\n        }\n\n        return closestTime;\n    }\n\n    // Accepts both 12hr and 24hr formats\n    public static timeToMinutes(time: string): number {\n        const [startHourMin, ampm] = time.toLowerCase().split(/(am|pm)/);\n        const [startHoursRaw, startMinutes] = startHourMin\n            .split(\":\")\n            .map(Number);\n        let startHours = startHoursRaw;\n\n        if (ampm === \"pm\" && startHours !== 12) {\n            startHours += 12; // Convert PM hours to 24-hour format\n        }\n        if (ampm === \"am\" && startHours === 12) {\n            startHours = 0; // Convert 12am to 0 hours\n        }\n\n        return startHours * 60 + startMinutes;\n    }\n\n    // Calculate duration between two time strings\n    public static calculateDuration(\n        startTime: string,\n        endTime: string\n    ): number {\n        const startMinutes = TimeHelper.timeToMinutes(startTime);\n        const endMinutes = TimeHelper.timeToMinutes(endTime);\n        return endMinutes - startMinutes;\n    }\n\n    /**\n     * Validates and calculates scroll position for a given time\n     * @param props - The configuration object for calculating scroll position\n     * @returns the calculated scroll position in pixels, or null if invalid\n     */\n    public static calculateScrollPosition(\n        props: CalculateScrollPositionProps\n    ): number | null {\n        const {\n            scrollTime,\n            minTime,\n            maxTime,\n            interval,\n            intervalWidth,\n            options,\n        } = props;\n\n        try {\n            // Validate time format (HH:mm)\n            const timeRegex = /^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/;\n            if (!timeRegex.test(scrollTime)) {\n                console.warn(\n                    `Invalid scrollTime format: \"${scrollTime}\". Expected format: HH:mm.`\n                );\n                return null;\n            }\n\n            // Round to nearest interval if specified\n            const timeToUse = options?.roundToInterval\n                ? TimeHelper.roundToNearestInterval(scrollTime, interval)\n                : scrollTime;\n\n            const [hours, minutes] = parseTimeToNumbers(timeToUse);\n\n            // Validate parsed values\n            if (isNaN(hours) || isNaN(minutes)) {\n                console.warn(`Invalid scrollTime: \"${scrollTime}\".`);\n                return null;\n            }\n\n            const scrollMinutes = hours * 60 + minutes;\n\n            const [minHours, minMinutes] = parseTimeToNumbers(minTime);\n            const minTotalMinutes = minHours * 60 + minMinutes;\n\n            const [maxHours, maxMinutes] = parseTimeToNumbers(maxTime);\n            const maxTotalMinutes = maxHours * 60 + maxMinutes;\n\n            // Warn if time is outside the visible range\n            if (\n                scrollMinutes < minTotalMinutes ||\n                scrollMinutes > maxTotalMinutes\n            ) {\n                console.warn(\n                    `scrollTime \"${scrollTime}\" is outside the range (${minTime} - ${maxTime}).`\n                );\n            }\n\n            const minutesFromStart = scrollMinutes - minTotalMinutes;\n            const intervalsFromStart = minutesFromStart / interval;\n            const scrollPosition = intervalsFromStart * intervalWidth;\n\n            return scrollPosition;\n        } catch (error) {\n            console.warn(\n                `Error processing scrollTime: \"${scrollTime}\".`,\n                error\n            );\n            return null;\n        }\n    }\n}\n\n// =============================================================================\n// NON-EXPORTABLES\n// =============================================================================\n\n/**\n * Parses a time string in HH:mm format to separate hour and minute values\n * @param timeString - Time string in HH:mm format (e.g., \"09:30\", \"14:45\")\n * @returns Array containing [hours, minutes] as numbers\n * @example\n * parseTimeToNumbers(\"09:30\") // returns [9, 30]\n * parseTimeToNumbers(\"14:45\") // returns [14, 45]\n */\nconst parseTimeToNumbers = (timeString: string): number[] => {\n    return timeString.split(\":\").map(Number);\n};\nconst isValidHour = (hourString: string, format: TimeFormat): boolean => {\n    const numValue = parseInt(hourString);\n    return format === \"24hr\"\n        ? numValue >= 0 && numValue <= 23\n        : numValue >= 1 && numValue <= 12;\n};\n\nconst isValidMinutes = (hourString: string): boolean => {\n    const numValue = parseInt(hourString);\n    return numValue >= 0 && numValue <= 59;\n};\n\nconst isValidTimePeriod = (timePeriodString: string): boolean => {\n    return (\n        timePeriodString.toLowerCase() === \"am\" ||\n        timePeriodString.toLowerCase() === \"pm\"\n    );\n};\n\nconst convertToPlain = (\n    value: string | undefined,\n    format: TimeFormat\n): TimeValuesPlain => {\n    const timeArr = value ? value.split(\":\") : [];\n    const error = new Error(\"Invalid format\");\n\n    if (format === \"12hr\") {\n        // Check format\n        if (timeArr.length !== 2 || timeArr[1].length !== 4) throw error;\n\n        const minute = timeArr[1].substring(0, 2);\n        const period = timeArr[1].substring(2);\n\n        // Validate hour, minute and time period values\n        if (\n            !isValidHour(timeArr[0], format) ||\n            !isValidMinutes(minute) ||\n            !isValidTimePeriod(period)\n        ) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute,\n            period: timeArr[1].substring(2),\n        };\n    } else {\n        // Check format\n        if (timeArr.length !== 2) throw error;\n        // Validate hour and minute values\n        if (!isValidHour(timeArr[0], format) || !isValidMinutes(timeArr[1])) {\n            throw error;\n        }\n\n        return {\n            hour: timeArr[0],\n            minute: timeArr[1],\n        };\n    }\n};\n\nconst toTimeString = (hours: number, minutes: number, period?: string) => {\n    return period\n        ? `${hours}:${minutes.toString().padStart(2, \"0\")}${period}`\n        : `${hours.toString().padStart(2, \"0\")}:${minutes\n              .toString()\n              .padStart(2, \"0\")}`;\n};\n"],"names":["EPeriod","TimeHelper","roundToNearestInterval","time","interval","toNextInterval","hoursStr","minutesStr","split","hours","parseInt","minutes","isNaN","Error","totalMinutes","remainder","roundedMinutes","roundedMinutesWithinHour","Math","floor","toString","padStart","generateHourlyIntervals","startTime","endTime","generatedFormat","format","start","dayjs","end","isSame","add","intervals","isBefore","push","getTimeValues","value","timeValues","hour","minute","period","AM","plain","convertToPlain","StringHelper","padValue","PM","toLowerCase","_a","updateMinutes","valueString","direction","currentValue","lastNearestStep","newStep","updateHours","nextValue","convertTo24HourFormat","values","hourString","convertHourTo12HourFormat","hourValue","formatTimeRange","isSameTime","a","b","formatDisplayValue","paddedHour","formatted","toMinutesSeconds","_seconds","seconds","to24Hour","includes","t","p","hr","m","map","Number","h","toTimeString","generateTimings","timings","currentMinutes","endMinutes","timeToMinutes","timeString","parseInput","input","undefined","sanitizedInput","trim","match","exec","findClosestFlooredTime","inputTime","timeArray","flooredInputMinutes","closestTime","minDifference","Infinity","difference","abs","startHourMin","ampm","startHoursRaw","startMinutes","startHours","calculateDuration","calculateScrollPosition","props","scrollTime","minTime","maxTime","intervalWidth","options","test","console","warn","timeToUse","roundToInterval","parseTimeToNumbers","scrollMinutes","minHours","minMinutes","minTotalMinutes","maxHours","maxMinutes","error","isValidHour","numValue","isValidMinutes","timeArr","length","substring","timePeriodString"],"mappings":"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"}

package/util/use-countdown.d.ts

@@ -3,6 +3,14 @@ export interface UseCountdownOptions {
     duration: number;
     /** Called when countdown ends */
     onComplete?: () => void;
+    /** Time in seconds between reminder announcements */
+    reminderInterval?: number;
+    /** Build the message announced when countdown timer starts */
+    getStartMessage?: (duration: number) => string;
+    /** Build the message announced when countdown reaches each interval based on `reminderInterval` */
+    getIntervalMessage?: (remaining: number) => string;
+    /** Build the message announced when countdown timer completes */
+    getCompletionMessage?: () => string;
 }
 export interface UseCountdownReturn {
     /** Current countdown time in seconds */
@@ -21,4 +29,4 @@ export interface UseCountdownReturn {
 /**
  * Countdown hook
  */
-export declare const useCountdown: ({ duration, onComplete, }: UseCountdownOptions) => UseCountdownReturn;
+export declare const useCountdown: ({ duration, onComplete, reminderInterval, getStartMessage, getIntervalMessage, getCompletionMessage, }: UseCountdownOptions) => UseCountdownReturn;

package/util/use-countdown.js

@@ -1,2 +1,2 @@
-import{useState as r,useRef as t,useEffect as n}from"react";const e=({duration:e,onComplete:l})=>{const[u,c]=r(e),[o,a]=r(!1),s=t(null),m=t(null),i=()=>{a(!1),s.current&&(clearInterval(s.current),s.current=null)};return n((()=>{o||c(e)}),[e,o]),{timeLeft:u,isRunning:o,start:()=>{o||(m.current=Date.now(),a(!0),s.current=setInterval((()=>{const r=Math.floor((Date.now()-m.current)/1e3),t=Math.max(0,e-r);c(t),t<=0&&(a(!1),s.current&&(clearInterval(s.current),s.current=null),null==l||l())}),1e3))},stop:i,reset:()=>{i(),c(e),m.current=null},formatTime:r=>{const t=null!=r?r:u;return`${t} second${1===t?"":"s"}`}}};export{e as useCountdown};
+import{clearAnnouncer as e,announce as t}from"@react-aria/live-announcer";import{useState as r,useRef as n,useEffect as l}from"react";const o=({duration:o,onComplete:a,reminderInterval:u,getStartMessage:c,getIntervalMessage:s,getCompletionMessage:i})=>{const[m,p]=r(o),[f,g]=r(!1),v=n(null),M=n(null),I=()=>{v.current&&(clearInterval(v.current),v.current=null)},d=r=>{e("polite"),t(r,"polite")},h=()=>{g(!1),I()};return l((()=>{f||p(o)}),[o,f]),l((()=>()=>{I()}),[]),{timeLeft:m,isRunning:f,start:()=>{f||(I(),p(o),g(!0),M.current=Date.now(),c&&d(c(o)),v.current=setInterval((()=>{if(null==M.current)return;const e=Math.floor((Date.now()-M.current)/1e3),t=Math.max(0,o-e);p(t),"number"==typeof u&&u>0&&t>0&&t<o&&t%u==0&&s&&d(s(t)),t<=0&&(g(!1),I(),i&&d(i()),null==a||a())}),1e3))},stop:h,reset:()=>{h(),p(o),M.current=null},formatTime:e=>{const t=null!=e?e:m;return`${t} second${1===t?"":"s"}`}}};export{o as useCountdown};
 //# sourceMappingURL=use-countdown.js.map

package/util/use-countdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-countdown.js","sources":["../../src/util/use-countdown.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nexport interface UseCountdownOptions {\n    /** Duration in seconds */\n    duration: number;\n    /** Called when countdown ends */\n    onComplete?: () => void;\n}\n\nexport interface UseCountdownReturn {\n    /** Current countdown time in seconds */\n    timeLeft: number;\n    /** Whether countdown is currently running */\n    isRunning: boolean;\n    /** Start the countdown */\n    start: () => void;\n    /** Stop the countdown */\n    stop: () => void;\n    /** Reset countdown to initial duration */\n    reset: () => void;\n    /** Format time as \"X second(s)\" */\n    formatTime: (time?: number) => string;\n}\n\n/**\n * Countdown hook\n */\nexport const useCountdown = ({\n    duration,\n    onComplete,\n}: UseCountdownOptions): UseCountdownReturn => {\n    const [timeLeft, setTimeLeft] = useState(duration);\n    const [isRunning, setIsRunning] = useState(false);\n    const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n    const startTimeRef = useRef<number | null>(null);\n\n    const formatTime = (time?: number) => {\n        const t = time ?? timeLeft;\n        return `${t} second${t === 1 ? \"\" : \"s\"}`;\n    };\n\n    const start = () => {\n        if (isRunning) return;\n\n        startTimeRef.current = Date.now();\n        setIsRunning(true);\n\n        intervalRef.current = setInterval(() => {\n            const elapsed = Math.floor(\n                (Date.now() - startTimeRef.current!) / 1000\n            );\n            const remaining = Math.max(0, duration - elapsed);\n\n            setTimeLeft(remaining);\n\n            if (remaining <= 0) {\n                setIsRunning(false);\n                if (intervalRef.current) {\n                    clearInterval(intervalRef.current);\n                    intervalRef.current = null;\n                }\n                onComplete?.();\n            }\n        }, 1000);\n    };\n\n    const stop = () => {\n        setIsRunning(false);\n        if (intervalRef.current) {\n            clearInterval(intervalRef.current);\n            intervalRef.current = null;\n        }\n    };\n\n    const reset = () => {\n        stop();\n        setTimeLeft(duration);\n        startTimeRef.current = null;\n    };\n\n    // Update timeLeft when duration changes\n    useEffect(() => {\n        if (!isRunning) {\n            setTimeLeft(duration);\n        }\n    }, [duration, isRunning]);\n\n    return {\n        timeLeft,\n        isRunning,\n        start,\n        stop,\n        reset,\n        formatTime,\n    };\n};\n"],"names":["useCountdown","duration","onComplete","timeLeft","setTimeLeft","useState","isRunning","setIsRunning","intervalRef","useRef","startTimeRef","stop","current","clearInterval","useEffect","start","Date","now","setInterval","elapsed","Math","floor","remaining","max","reset","formatTime","time","t"],"mappings":"4DA2BO,MAAMA,EAAe,EACxBC,WACAC,iBAEA,MAAOC,EAAUC,GAAeC,EAASJ,IAClCK,EAAWC,GAAgBF,GAAS,GACrCG,EAAcC,EAA8C,MAC5DC,EAAeD,EAAsB,MAgCrCE,EAAO,KACTJ,GAAa,GACTC,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAgBJ,OANAE,GAAU,KACDR,GACDF,EAAYH,EAChB,GACD,CAACA,EAAUK,IAEP,CACHH,WACAG,YACAS,MAjDU,KACNT,IAEJI,EAAaE,QAAUI,KAAKC,MAC5BV,GAAa,GAEbC,EAAYI,QAAUM,aAAY,KAC9B,MAAMC,EAAUC,KAAKC,OAChBL,KAAKC,MAAQP,EAAaE,SAAY,KAErCU,EAAYF,KAAKG,IAAI,EAAGtB,EAAWkB,GAEzCf,EAAYkB,GAERA,GAAa,IACbf,GAAa,GACTC,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,MAE1BV,SAAAA,IACJ,GACD,KAAK,EA4BRS,OACAa,MAlBU,KACVb,IACAP,EAAYH,GACZS,EAAaE,QAAU,IAAI,EAgB3Ba,WAzDgBC,IAChB,MAAMC,EAAID,QAAAA,EAAQvB,EAClB,MAAO,GAAGwB,WAAiB,IAANA,EAAU,GAAK,KAAK,EAwD5C"}
+{"version":3,"file":"use-countdown.js","sources":["../../src/util/use-countdown.ts"],"sourcesContent":["import { announce, clearAnnouncer } from \"@react-aria/live-announcer\";\nimport { useEffect, useRef, useState } from \"react\";\n\nexport interface UseCountdownOptions {\n    /** Duration in seconds */\n    duration: number;\n    /** Called when countdown ends */\n    onComplete?: () => void;\n    /** Time in seconds between reminder announcements */\n    reminderInterval?: number;\n    /** Build the message announced when countdown timer starts */\n    getStartMessage?: (duration: number) => string;\n    /** Build the message announced when countdown reaches each interval based on `reminderInterval` */\n    getIntervalMessage?: (remaining: number) => string;\n    /** Build the message announced when countdown timer completes */\n    getCompletionMessage?: () => string;\n}\n\nexport interface UseCountdownReturn {\n    /** Current countdown time in seconds */\n    timeLeft: number;\n    /** Whether countdown is currently running */\n    isRunning: boolean;\n    /** Start the countdown */\n    start: () => void;\n    /** Stop the countdown */\n    stop: () => void;\n    /** Reset countdown to initial duration */\n    reset: () => void;\n    /** Format time as \"X second(s)\" */\n    formatTime: (time?: number) => string;\n}\n\n/**\n * Countdown hook\n */\nexport const useCountdown = ({\n    duration,\n    onComplete,\n    reminderInterval,\n    getStartMessage,\n    getIntervalMessage,\n    getCompletionMessage,\n}: UseCountdownOptions): UseCountdownReturn => {\n    const [timeLeft, setTimeLeft] = useState(duration);\n    const [isRunning, setIsRunning] = useState(false);\n    const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n    const startTimeRef = useRef<number | null>(null);\n\n    const clearTimer = () => {\n        if (intervalRef.current) {\n            clearInterval(intervalRef.current);\n            intervalRef.current = null;\n        }\n    };\n\n    const formatTime = (time?: number) => {\n        const t = time ?? timeLeft;\n        return `${t} second${t === 1 ? \"\" : \"s\"}`;\n    };\n\n    const handleAnnounce = (message: string) => {\n        clearAnnouncer(\"polite\");\n        announce(message, \"polite\");\n    };\n\n    const start = () => {\n        if (isRunning) return;\n\n        clearTimer();\n\n        setTimeLeft(duration);\n        setIsRunning(true);\n        startTimeRef.current = Date.now();\n\n        // First resend reminder message\n        if (getStartMessage) {\n            handleAnnounce(getStartMessage(duration));\n        }\n\n        intervalRef.current = setInterval(() => {\n            if (startTimeRef.current == null) return;\n\n            const elapsed = Math.floor(\n                (Date.now() - startTimeRef.current!) / 1000\n            );\n            const remaining = Math.max(0, duration - elapsed);\n\n            setTimeLeft(remaining);\n\n            if (\n                typeof reminderInterval === \"number\" &&\n                reminderInterval > 0 &&\n                remaining > 0 &&\n                remaining < duration &&\n                remaining % reminderInterval === 0\n            ) {\n                // second resend reminder message in intervals\n                if (getIntervalMessage) {\n                    handleAnnounce(getIntervalMessage(remaining));\n                }\n            }\n\n            if (remaining <= 0) {\n                setIsRunning(false);\n                clearTimer();\n\n                // final reminder message\n                if (getCompletionMessage) {\n                    handleAnnounce(getCompletionMessage());\n                }\n\n                onComplete?.();\n            }\n        }, 1000);\n    };\n\n    const stop = () => {\n        setIsRunning(false);\n        clearTimer();\n    };\n\n    const reset = () => {\n        stop();\n        setTimeLeft(duration);\n        startTimeRef.current = null;\n    };\n\n    // Update timeLeft when duration changes\n    useEffect(() => {\n        if (!isRunning) {\n            setTimeLeft(duration);\n        }\n    }, [duration, isRunning]);\n\n    useEffect(() => {\n        return () => {\n            clearTimer();\n        };\n    }, []);\n\n    return {\n        timeLeft,\n        isRunning,\n        start,\n        stop,\n        reset,\n        formatTime,\n    };\n};\n"],"names":["useCountdown","duration","onComplete","reminderInterval","getStartMessage","getIntervalMessage","getCompletionMessage","timeLeft","setTimeLeft","useState","isRunning","setIsRunning","intervalRef","useRef","startTimeRef","clearTimer","current","clearInterval","handleAnnounce","message","clearAnnouncer","announce","stop","useEffect","start","Date","now","setInterval","elapsed","Math","floor","remaining","max","reset","formatTime","time","t"],"mappings":"sIAoCO,MAAMA,EAAe,EACxBC,WACAC,aACAC,mBACAC,kBACAC,qBACAC,2BAEA,MAAOC,EAAUC,GAAeC,EAASR,IAClCS,EAAWC,GAAgBF,GAAS,GACrCG,EAAcC,EAA8C,MAC5DC,EAAeD,EAAsB,MAErCE,EAAa,KACXH,EAAYI,UACZC,cAAcL,EAAYI,SAC1BJ,EAAYI,QAAU,KAC1B,EAQEE,EAAkBC,IACpBC,EAAe,UACfC,EAASF,EAAS,SAAS,EAsDzBG,EAAO,KACTX,GAAa,GACbI,GAAY,EAsBhB,OAZAQ,GAAU,KACDb,GACDF,EAAYP,EAChB,GACD,CAACA,EAAUS,IAEda,GAAU,IACC,KACHR,GAAY,GAEjB,IAEI,CACHR,WACAG,YACAc,MA9EU,KACNd,IAEJK,IAEAP,EAAYP,GACZU,GAAa,GACbG,EAAaE,QAAUS,KAAKC,MAGxBtB,GACAc,EAAed,EAAgBH,IAGnCW,EAAYI,QAAUW,aAAY,KAC9B,GAA4B,MAAxBb,EAAaE,QAAiB,OAElC,MAAMY,EAAUC,KAAKC,OAChBL,KAAKC,MAAQZ,EAAaE,SAAY,KAErCe,EAAYF,KAAKG,IAAI,EAAG/B,EAAW2B,GAEzCpB,EAAYuB,GAGoB,iBAArB5B,GACPA,EAAmB,GACnB4B,EAAY,GACZA,EAAY9B,GACZ8B,EAAY5B,GAAqB,GAG7BE,GACAa,EAAeb,EAAmB0B,IAItCA,GAAa,IACbpB,GAAa,GACbI,IAGIT,GACAY,EAAeZ,KAGnBJ,SAAAA,IACJ,GACD,KAAK,EA+BRoB,OACAW,MAxBU,KACVX,IACAd,EAAYP,GACZa,EAAaE,QAAU,IAAI,EAsB3BkB,WA3FgBC,IAChB,MAAMC,EAAID,QAAAA,EAAQ5B,EAClB,MAAO,GAAG6B,WAAiB,IAANA,EAAU,GAAK,KAAK,EA0F5C"}

package/v2_layout/col-div.style.d.ts

@@ -6,4 +6,4 @@ export interface StyledDivStyleProps {
     $mobileStart?: number | undefined;
     $mobileSpan?: number | undefined;
 }
-export declare const StyledDiv: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, StyledDivStyleProps>> & string;
+export declare const StyledDiv: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof StyledDivStyleProps> & StyledDivStyleProps, never> & Partial<Pick<import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof StyledDivStyleProps> & StyledDivStyleProps, never>>> & string;