optimized-react-component-library-xyz123 0.1.122 → 0.1.124

package/dist/index.css

@@ -1,16 +1,14 @@
-/* src/NewInputComponentStandard/RadioMultipleStandard/RadioMultipleStandard.css */
-/* src/NewInputComponentStandard/MultipleCheckboxesStandard/MultipleCheckboxesStandard.css */
-/* src/NewInputComponentStandard/TextAreaStandard/TextAreaStandard.css */
-/* src/NewInputComponentStandard/FilesUploadStandard/FilesUploadStandard.css */
-/* src/NewInputComponentStandard/AddFilesStandard/AddFilesStandard.css */
-/* src/NewTextComponentStandard/EditPreviewLinkStandard/EditPreviewLinkStandard.css */
-/* src/NewTextComponentStandard/FooterStandard/FooterStandard.css */
-/* src/NewTextComponentStandard/HeaderStandard/HeaderStandard.css */
-/* src/NewTextComponentStandard/InfoOnlyStandard/InfoOnlyStandard.css */
-/* src/NewTextComponentStandard/ModalStandard/ModalStandard.css */
-/* src/NewTextComponentStandard/TextHeadlineAndBodyStandard/TextHeadlineAndBodyStandard.css */
-/* src/NewTextComponentStandard/ServiceHeadlineAndBodyStandard/ServiceHeadlineAndBodyStandard.css */
-/* src/NewTextComponentStandard/SkipLinkStandard/SkipLinkStandard.css */
-/* src/NewTextComponentStandard/StepperButtonsStandard/StepperButtonsStandard.css */
-/* src/NewTextComponentStandard/StepperStandard/StepperStandard.css */
+/* src/components/input-components/RadioMultipleStandard/RadioMultipleStandard.css */
+/* src/components/input-components/MultipleCheckboxesStandard/MultipleCheckboxesStandard.css */
+/* src/components/input-components/TextAreaStandard/TextAreaStandard.css */
+/* src/components/input-components/AddFilesStandard/AddFilesStandard.css */
+/* src/components/layout/FooterStandard/FooterStandard.css */
+/* src/components/layout/HeaderStandard/HeaderStandard.css */
+/* src/components/layout/ModalStandard/ModalStandard.css */
+/* src/components/layout/SkipLinkStandard/SkipLinkStandard.css */
+/* src/components/text-blocks/InfoOnlyStandard/InfoOnlyStandard.css */
+/* src/components/text-blocks/TextHeadlineAndBodyStandard/TextHeadlineAndBodyStandard.css */
+/* src/components/stepper/EditPreviewLinkStandard/EditPreviewLinkStandard.css */
+/* src/components/stepper/StepperButtonsStandard/StepperButtonsStandard.css */
+/* src/components/stepper/StepperStandard/StepperStandard.css */
 /*# sourceMappingURL=index.css.map */

package/dist/index.d.mts

@@ -148,29 +148,6 @@ interface TextFieldStandardProps {
 
 declare const TextFieldStandard: FC<TextFieldStandardProps>;
 
-interface SelectedFile {
-    id: string;
-    file: File;
-    dataURL?: string;
-}
-interface FilesUploadStandardProps {
-    question: IQuestion;
-    isTouched: any;
-    visible?: boolean;
-    showPreview?: boolean;
-    activatedLanguage?: string;
-    allowedFileTypes?: Array<string>;
-    allowedNumberOfFiles?: number;
-    allowedTotalFileSize?: number;
-    onFilesAdded?: (files: SelectedFile[]) => void;
-    onFileRemoved?: (fileId: string) => void;
-    maxFileSize?: number;
-    allowDuplicates?: boolean;
-    multiple?: boolean;
-}
-
-declare const FilesUpload: React.FC<FilesUploadStandardProps>;
-
 interface AddFilesProps {
     questionObject: IQuestion;
     isTouched: any;
@@ -184,7 +161,15 @@ interface AddFilesProps {
 
 declare const AddFiles: FC<AddFilesProps>;
 
-declare const questionHasValidationError: (questionObject: any, arrayOfQuestionObjects: any[]) => boolean;
+/**
+ * Kontrollerar om en fråga har ett valideringsfel baserat på dess egenskaper och valideringstyper.
+ *
+ * @param questionObject - Den fråga som ska kontrolleras.
+ * @param arrayOfQuestionObjects - Alla frågor i formuläret (behövs för gruppvalideringar).
+ * @returns `true` om frågan har ett valideringsfel, annars `false`.
+ *
+ */
+declare const hasQuestionValidationError: (questionObject: any, arrayOfQuestionObjects: any[]) => boolean;
 
 interface TranslatedAnswers {
     [questionId: string]: {
@@ -195,35 +180,99 @@ interface ApiDataObject {
     [key: string]: string | number | boolean | File[];
 }
 
-declare function CreateApiDataObject(data: any[], specialMappedQuestions: Set<string>, translatedAnswers: TranslatedAnswers): ApiDataObject;
-
-declare function groupQuestionByStepPreviewPage(steps: IStepObject[], questions: IQuestion[]): any[];
-
-declare const isDependsOnOtherQuestionTrue: (data: any[], question: any) => boolean;
+/**
+ * Skapar ett API-anpassat dataobjekt baserat på användarens formulärsvar.
+ *
+ * Funktionen går igenom alla frågor och bygger ett objekt som kan skickas till backend.
+ * - Om en fråga finns i `specialMappedQuestions`, mappas svaret till `option.id` i stället för label.
+ * - Om `translatedAnswers` innehåller en översättning för frågans `mappingId`, används den.
+ * - Endast visade frågor (`isDisplayed`) med giltiga svar inkluderas i resultatet.
+ * - Filuppladdningar (`AddFiles`) inkluderas under egenskapen `files`.
+ *
+ * @param data - Lista med alla frågor och deras svar.
+ * @param specialMappedQuestions - En uppsättning mapping-ID:n som kräver specialhantering av svar.
+ * @param translatedAnswers - Objekt som innehåller översättningar av svar.
+ * @returns Ett `ApiDataObject` redo att skickas till backend.
+ *
+ */
+declare function createApiDataObject(data: any[], specialMappedQuestions: Set<string>, translatedAnswers: TranslatedAnswers): ApiDataObject;
 
-interface ILanguageSupport {
-    languageSupport?: Array<ILanguage>;
-    activatedLanguage: string;
-    forwardButton?: string;
-    backButton?: string;
-    sendButton?: string;
-    languageSupportLoaded: boolean;
-}
-interface ILanguage {
-    language: string;
-    forwardButton: string;
-    backButton: string;
-    sendButton: string;
-}
+/**
+ * Förbereder data för förhandsgranskningssidan.
+ *
+ * Funktionen grupperar alla synliga frågor (`isDisplayed = true`) utifrån vilket steg
+ * de tillhör. Resultatet används för att presentera formulärets innehåll steg för steg
+ * på förhandsgranskningen innan inskick.
+ *
+ * @param steps - Lista över alla steg i formuläret (`IStepObject[]`).
+ * @param questions - Alla frågor i formuläret (`IQuestion[]`).
+ * @returns En lista av objekt där varje element innehåller ett steg och dess synliga frågor:
+ */
+declare function preparePreviewData(steps: IStepObject[], questions: IQuestion[]): any[];
 
-declare const QuestioninitialState: IFormState;
-declare const ILanguageSupportinitialState: ILanguageSupport;
+/**
+ * Kontrollerar om en frågas beroenden (dependencies) är uppfyllda.
+ *
+ * En fråga kan ha ett eller flera beroenden till andra frågor, där varje beroende anger:
+ *  - vilket fråge-ID det är kopplat till (`LinkedToQuestionId`)
+ *  - vilket svar eller svarsalternativ som krävs (`Answer` eller `questionArrayAnswerId`)
+ *
+ * Funktionen går igenom alla beroendekombinationer och returnerar `true` om
+ * **minst ett** beroendeblock (AND-villkor inom varje block, OR mellan blocken)
+ * är uppfyllt utifrån datan i `data`-arrayen.
+ *
+ * @param data - En lista med alla frågor och deras aktuella svar.
+ * @param question - Den fråga som har beroenden till andra frågor.
+ * @returns `true` om frågans beroendevillkor är uppfyllda, annars `false`.
+ *
+ */
+declare const isQuestionDependencySatisfied: (data: any[], question: any) => boolean;
 
-declare const doCategoriesAndQuestionsVisible: (questions: IQuestion[], validationErrorsList: number[]) => any[];
+/**
+ * Uppdaterar frågor med information om synlighet och valideringsfel.
+ *
+ * För varje fråga:
+ * - Om frågan är beroende av andra frågor,
+ *   avgörs synligheten av villkoret`.
+ * - Om frågans ID finns i `validationErrorsList` markeras den som att den har valideringsfel.
+ *
+ * @param questions - En array av frågeobjekt (`IQuestion[]`).
+ * @param validationErrorsList - En lista av fråge-ID:n som har valideringsfel.
+ * @returns En ny lista med frågor där `visible` och `hasValidationError` är uppdaterade.
+ *
+ */
+declare const updateQuestionsAndCategoriesVisibilityAndErrors: (questions: IQuestion[], validationErrorsList: number[]) => any[];
 
-declare function validationCheckAllVisibleQuestions(data: any, formQuestion: any): number[];
+/**
+ * Går igenom alla synliga frågor och returnerar
+ * en lista med fråge-ID:n som har valideringsfel.
+ *
+ * Endast frågor som är markerade som `visible` och som returnerar `true`
+ * från `QuestionHasValidationError()` inkluderas i resultatet.
+ *
+ * @param data - Fyll på...
+ * @param formQuestion - Fyll på...
+ * @returns En array med ID:n (`number[]`) för frågor som har valideringsfel.
+ */
+declare function findVisibleQuestionsWithValidationErrors(data: any, formQuestion: any): number[];
 
-declare function groupQuestionsByStepCategoryGroup(questions: IQuestion[], steps: IStepObject[], validationErrorsList: number[]): any[];
+/**
+ * Bygger upp en hierarkisk datastruktur för formuläret, grupperad per steg, kategori och frågegrupp.
+ *
+ * Funktionen används för att strukturera frågedata så att varje steg innehåller:
+ * - En lista av kategorier
+ * - Varje kategori innehåller sina frågegrupper
+ * - Varje frågegrupp innehåller sina frågor
+ *
+ * Dessutom uppdateras frågor med `visible` baserat på dess beroende till andra frågor och `hasValidationError` baserat på aktuell valideringsstatus.
+ *
+ * @param questions - Alla frågor i formuläret (`IQuestion[]`).
+ * @param steps - Lista över alla steg i formuläret (`IStepObject[]`).
+ * @param validationErrorsList - Lista med fråge-ID:n som har valideringsfel.
+ * @returns En lista av stegobjekt med tillhörande kategorier och grupper.
+ *
+ */
+declare function buildStepCategoryGroupQuestionStructure(questions: IQuestion[], steps: IStepObject[], validationErrorsList: number[]): any[];
 
 /** ----- Typer ----- */
 interface LanguageEntry {
@@ -451,6 +500,13 @@ interface CookieConsentConfig {
     choiceKey: string;
     expiryYears?: number;
 }
+/**
+ * Skapar en uppsättning hjälpfunktioner för att hantera cookie-samtycke.
+ *
+ * @param config - Konfiguration för cookienamn, valnyckel och utgångstid.
+ * @returns Ett objekt med funktioner för att acceptera, neka och läsa cookie-status.
+ *
+ */
 declare const createCookieConsent: (config: CookieConsentConfig) => {
     acceptCookies: () => void;
     rejectCookies: () => void;
@@ -459,12 +515,39 @@ declare const createCookieConsent: (config: CookieConsentConfig) => {
     clearChoiceFromSession: () => void;
 };
 
+/**
+ * Laddar eller tar bort ett externt script beroende på användarens samtycke.
+ *
+ * Om `consent` är `true` och scriptet inte redan finns, skapas ett nytt
+ * `<script>`-element med de angivna attributen.
+ * Om `consent` är `false` tas scriptet bort från dokumentet.
+ *
+ * Denna funktion används t.ex. för att aktivera eller inaktivera tredjepartsskript
+ * (som analysverktyg) utifrån cookie-samtycke.
+ *
+ * @param consent - `true` om scriptet ska laddas, `false` om det ska tas bort.
+ * @param options - Inställningar för scriptet:
+ *  - `id`: unikt ID för script-elementet (används för att hitta/ta bort det)
+ *  - `src`: käll-URL för scriptet
+ *  - `attributes`: valfria ytterligare HTML-attribut (t.ex. `data-cookieconsent`)
+ */
 declare const toggleScriptByConsent: (consent: boolean, options: {
     id: string;
     src: string;
     attributes?: Record<string, string>;
 }) => void;
+/**
+ * Kontrollerar om ett script med ett visst ID redan är laddat i dokumentet.
+ *
+ * @param id - Scriptets unika ID-attribut.
+ * @returns `true` om scriptet finns i DOM, annars `false`.
+ */
 declare const isScriptLoaded: (id: string) => boolean;
+/**
+ * Tar bort ett script från DOM baserat på dess ID.
+ *
+ * @param id - Scriptets ID-attribut.
+ */
 declare const removeScriptById: (id: string) => void;
 
 /**
@@ -478,7 +561,7 @@ declare const focusElement: (target: string | HTMLElement | null) => void;
 /**
  * Plockar ut alla id:n från validationType som börjar med "groupCheck-"
  */
-declare const getIdsGroupCheckValidationTypes: (validationType?: string[]) => number[];
+declare const getGroupCheckIds: (validationType?: string[]) => number[];
 
 /**
  * Hook som hanterar öppning och stängning av en laddningsmodal baserat på formulärets status.
@@ -518,36 +601,20 @@ declare const useCookieConsent: ({ cookieName, choiceKey, expiryYears, onConsent
     rejectCookies: () => void;
 };
 
-interface StartApplicationButtonProps {
-    onClick: (event: React.MouseEvent<HTMLButtonElement>) => void;
-    label?: string;
-    className?: string;
-}
-/**
- * En standardiserad knapp för att starta e-tjänsten.
- */
-declare const StartApplicationButton: React.FC<StartApplicationButtonProps>;
-
-interface FormStatusMessagesProps {
-    formStatus: string;
-}
-/**
- * Visar statusmeddelanden för formulär på ett tillgängligt sätt.
- * Använder aria-live-regioner för att informera användare med skärmläsare.
- */
-declare const FormStatusMessagesScreenReader: React.FC<FormStatusMessagesProps>;
-
-declare const RenderQuestion: ({ question, isTouched, activatedLanguage, showPreview, hideValidationMessage, }: any) => react_jsx_runtime.JSX.Element;
+declare const QuestionRenderer: ({ question, isTouched, activatedLanguage, showPreview, }: any) => react_jsx_runtime.JSX.Element;
 
-declare const RenderQuestionGroup: ({ questionArray, wrapper, legend, isTouched, activatedLanguage, showPreview, AddQuestionDisplayed, hideValidationMessage, }: any) => react_jsx_runtime.JSX.Element;
+declare const QuestionGroup: ({ questionArray, wrapper, legend, isTouched, activatedLanguage, showPreview, AddQuestionDisplayed, }: any) => react_jsx_runtime.JSX.Element;
 
-interface EditPreviewLinkProps {
-    step: IStepObject;
-    changeStepHandler: any;
-    activatedLanguage?: string;
+interface CookieBannerProps {
+    isTouched?: any;
+    onCookieStateChange?: () => void;
+    visible?: boolean;
+    onClose?: () => void;
+    acceptCookies: () => void;
+    rejectCookies: () => void;
 }
 
-declare const EditPreviewLink: FC<EditPreviewLinkProps>;
+declare const CookieBanner: React.FC<CookieBannerProps>;
 
 interface FooterProps {
     activatedLanguage?: string;
@@ -563,6 +630,15 @@ interface HeaderProps {
 
 declare const Header: FC<HeaderProps>;
 
+interface ModalProps {
+    showModal: boolean;
+    activatedLanguage?: string;
+}
+
+declare const Modal: FC<ModalProps>;
+
+declare const SkipLink: FC;
+
 interface InfoOnlyProps {
     questionObject: IQuestion;
     isTouched: any;
@@ -576,27 +652,35 @@ interface InfoOnlyProps {
 
 declare const InfoOnly: FC<InfoOnlyProps>;
 
-interface ModalProps {
-    showModal: boolean;
+interface PrincipleOfPublicityProps {
     activatedLanguage?: string;
 }
 
-declare const Modal: FC<ModalProps>;
+declare const PrincipleOfPublicity: FC<PrincipleOfPublicityProps>;
 
-interface PrincipleOfPublicityProps {
-    activatedLanguage?: string;
+interface TextBodyProps {
+    data: ITextBlock;
 }
 
-declare const PrincipleOfPublicity: FC<PrincipleOfPublicityProps>;
+declare const TextBody: FC<TextBodyProps>;
 
-interface ServiceHeadlineAndBodyProps {
-    data: IApplicationContent;
-    activeStep?: number;
+interface EditPreviewLinkProps {
+    step: IStepObject;
+    changeStepHandler: any;
+    activatedLanguage?: string;
 }
 
-declare const ServiceHeadlineAndBody: FC<ServiceHeadlineAndBodyProps>;
+declare const EditPreviewLink: FC<EditPreviewLinkProps>;
 
-declare const SkipLink: FC;
+interface StartApplicationButtonProps {
+    onClick: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    label?: string;
+    className?: string;
+}
+/**
+ * En standardiserad knapp för att starta e-tjänsten.
+ */
+declare const StartApplicationButton: React.FC<StartApplicationButtonProps>;
 
 interface StepperButtonsProps {
     languageSupported?: any;
@@ -616,13 +700,6 @@ interface StepperProps {
 
 declare const Stepper: FC<StepperProps>;
 
-interface TextHeadlineAndBodyProps {
-    data: ITextBlock;
-    headlineType?: 'h1' | 'h2';
-}
-
-declare const TextHeadlineAndBody: FC<TextHeadlineAndBodyProps>;
-
 interface ValidationErrorSummaryListProps {
     formQuestions: any[];
     activatedLanguage: string;
@@ -632,15 +709,13 @@ interface ValidationErrorSummaryListProps {
 
 declare const ValidationErrorSummaryList: React.FC<ValidationErrorSummaryListProps>;
 
-interface CookieBannerProps {
-    isTouched?: any;
-    onCookieStateChange?: () => void;
-    visible?: boolean;
-    onClose?: () => void;
-    acceptCookies: () => void;
-    rejectCookies: () => void;
+interface FormStatusMessagesProps {
+    formStatus: string;
 }
+/**
+ * Visar statusmeddelanden för formulär på ett tillgängligt sätt.
+ * Använder aria-live-regioner för att informera användare med skärmläsare.
+ */
+declare const FormStatusMessagesScreenReader: React.FC<FormStatusMessagesProps>;
 
-declare const CookieBanner: React.FC<CookieBannerProps>;
-
-export { AddFiles as AddFilesStandard, CookieBanner, type CookieConsentConfig, CreateApiDataObject, doCategoriesAndQuestionsVisible as DoCategoriesAndQuestionsVisible, EditPreviewLink as EditPreviewLinkStandard, FilesUpload as FilesUploadStandard, Footer as FooterStandard, FormStatusMessagesScreenReader, groupQuestionByStepPreviewPage as GroupQuestionByStepPreviewPage, groupQuestionsByStepCategoryGroup as GroupQuestionsByStepCategoryGroup, Header as HeaderStandard, type IApplicationContent, type IFormState, type ILanguage, type ILanguageSupport, ILanguageSupportinitialState, type IOption, type IPTSLink, type IQuestion, type IQuestionExtraAttribute, type IStepObject, type IStepQuestionData, type ITextBlock, InfoOnly as InfoOnlyStandard, isDependsOnOtherQuestionTrue as IsDependsOnOtherQuestionTrue, type LanguageSupportConfig, Modal as ModalStandard, MultipleCheckboxes as MultipleCheckboxesStandard, PrincipleOfPublicity as PrincipleOfPublicityStandard, questionHasValidationError as QuestionHasValidationError, QuestioninitialState, InputRadio as RadioMultipleStandard, RenderQuestion, RenderQuestionGroup, ServiceHeadlineAndBody as ServiceHeadlineAndBodyStandard, SkipLink as SkipLinkStandard, StartApplicationButton, StepperButtons as StepperButtonsStandard, Stepper as StepperStandard, InputTextarea as TextAreaStandard, TextFieldStandard, TextHeadlineAndBody as TextHeadlineAndBodyStandard, validationCheckAllVisibleQuestions as ValidationCheckAllVisibleQuestion, ValidationErrorSummaryList, createCookieConsent, createLanguageSlice, createQuestionsSlice, focusElement, getIdsGroupCheckValidationTypes, isScriptLoaded, makeLanguageSelectors, makeQuestionsSelectors, removeScriptById, toggleScriptByConsent, useCookieConsent, useFormStatusModal, useInputMethodDetection, usePTSPageTitle };
+export { AddFiles as AddFilesStandard, CookieBanner, type CookieConsentConfig, EditPreviewLink as EditPreviewLinkStandard, Footer as FooterStandard, FormStatusMessagesScreenReader, Header as HeaderStandard, type IApplicationContent, type IFormState, type IOption, type IPTSLink, type IQuestion, type IQuestionExtraAttribute, type IStepObject, type IStepQuestionData, type ITextBlock, InfoOnly as InfoOnlyStandard, type LanguageSupportConfig, Modal as ModalStandard, MultipleCheckboxes as MultipleCheckboxesStandard, PrincipleOfPublicity as PrincipleOfPublicityStandard, InputRadio as RadioMultipleStandard, QuestionRenderer as RenderQuestion, QuestionGroup as RenderQuestionGroup, SkipLink as SkipLinkStandard, StartApplicationButton, StepperButtons as StepperButtonsStandard, Stepper as StepperStandard, InputTextarea as TextAreaStandard, TextBody, TextFieldStandard, ValidationErrorSummaryList, buildStepCategoryGroupQuestionStructure, createApiDataObject, createCookieConsent, createLanguageSlice, createQuestionsSlice, findVisibleQuestionsWithValidationErrors, focusElement, getGroupCheckIds, hasQuestionValidationError, isQuestionDependencySatisfied, isScriptLoaded, makeLanguageSelectors, makeQuestionsSelectors, preparePreviewData, removeScriptById, toggleScriptByConsent, updateQuestionsAndCategoriesVisibilityAndErrors, useCookieConsent, useFormStatusModal, useInputMethodDetection, usePTSPageTitle };