@helsevestikt/hviktor-angular 0.0.11 → 0.0.13

package/types/helsevestikt-hviktor-angular.d.ts

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
-import { EventEmitter, AfterViewInit, OnChanges } from '@angular/core';
-import { FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { EventEmitter, AfterViewInit, OnChanges, OnInit, OnDestroy } from '@angular/core';
+import { FormGroup, ValidatorFn, ReactiveFormsModule } from '@angular/forms';
+import { Placement } from '@floating-ui/dom';
 
 /**
  * Alert provides users with information that is especially important for them to see and understand.
@@ -463,6 +464,11 @@ declare class HviErrorSummary {
     static ɵcmp: i0.ɵɵComponentDeclaration<HviErrorSummary, "hvi-error-summary", never, { "heading": { "alias": "heading"; "required": false; }; "headingLevel": { "alias": "headingLevel"; "required": false; }; "errors": { "alias": "errors"; "required": false; }; "form": { "alias": "form"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "idMap": { "alias": "idMap"; "required": false; }; "errorPriority": { "alias": "errorPriority"; "required": false; }; "headingId": { "alias": "headingId"; "required": false; }; "showWhen": { "alias": "showWhen"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+declare function fieldObserver(fieldElement: HTMLElement | null): (() => void) | undefined;
+declare const isElement: (node: Node) => node is Element;
+declare const isLabel: (node: Node) => node is HTMLLabelElement;
+declare const isInputLike: (node: unknown) => node is HTMLInputElement;
+
 /**
  * Decorative affix container displayed alongside a text input.
  *
@@ -547,11 +553,6 @@ declare class HviField implements AfterViewInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<HviField, "hvi-field", never, { "position": { "alias": "position"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
-declare function fieldObserver(fieldElement: HTMLElement | null): (() => void) | undefined;
-declare const isElement: (node: Node) => node is Element;
-declare const isLabel: (node: Node) => node is HTMLLabelElement;
-declare const isInputLike: (node: unknown) => node is HTMLInputElement;
-
 /**
  * Fieldset is used to group and label fields that naturally belong together, such as date fields or address fields.
  * The component helps organize information, make forms more manageable, and improve accessibility for screen readers.
@@ -585,7 +586,9 @@ declare class HviFieldset {
 
 type HviAriaRole = 'switch' | 'button' | 'checkbox' | 'radio' | 'textbox' | 'searchbox' | string;
 declare class HviInput {
+    /** Supported input types */
     type?: 'number' | 'hidden' | 'color' | 'checkbox' | 'date' | 'datetime-local' | 'email' | 'file' | 'month' | 'password' | 'radio' | 'search' | 'tel' | 'text' | 'time' | 'url' | 'week';
+    /** Set size attribute on input element */
     size?: number;
     /** Set role, e.g. `switch` when `checkbox` or `radio` */
     role?: HviAriaRole;
@@ -653,6 +656,150 @@ declare class HviControlInvalid {
     static ɵdir: i0.ɵɵDirectiveDeclaration<HviControlInvalid, "[hviControlInvalid]", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * A bundle that pairs a validator function with its error key and message.
+ * This enables defining validation rules and messages in one place.
+ */
+interface HviValidatorBundle {
+    /** The Angular validator function */
+    validator: ValidatorFn;
+    /** The error key (e.g., 'required', 'minlength') */
+    key: string;
+    /** The user-facing error message */
+    message: string;
+}
+/**
+ * Result of processing validator bundles - ready to use with FormControl and hviValidationMessage.
+ */
+interface HviValidatorConfig {
+    /** Array of validator functions to pass to FormControl */
+    validators: ValidatorFn[];
+    /** Messages object to pass to hviValidationMessage */
+    messages: HviValidationMessages;
+}
+/**
+ * Extracts validators and messages from an array of validator bundles.
+ *
+ * @example
+ * ```ts
+ * const config = hviValidators([
+ *   hviRequired('Fornavn er påkrevd'),
+ *   hviMinLength(2, 'Fornavn må være minst 2 tegn'),
+ * ]);
+ *
+ * form = new FormGroup({
+ *   firstName: new FormControl('', config.validators),
+ * });
+ *
+ * // In template: [messages]="config.messages"
+ * ```
+ */
+declare function hviValidators(bundles: HviValidatorBundle[]): HviValidatorConfig;
+/**
+ * Extracts only the validator functions from bundles.
+ * Useful when you need just the validators for a FormControl.
+ */
+declare function hviExtractValidators(bundles: HviValidatorBundle[]): ValidatorFn[];
+/**
+ * Extracts only the messages from bundles.
+ * Useful when you need just the messages object.
+ */
+declare function hviExtractMessages(bundles: HviValidatorBundle[]): HviValidationMessages;
+
+/**
+ * Creates a required validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviRequired('Dette feltet er påkrevd')
+ * ```
+ */
+declare function hviRequired(message: string): HviValidatorBundle;
+/**
+ * Creates a requiredTrue validator bundle (for checkboxes that must be checked).
+ *
+ * @example
+ * ```ts
+ * hviRequiredTrue('Du må godta vilkårene')
+ * ```
+ */
+declare function hviRequiredTrue(message: string): HviValidatorBundle;
+/**
+ * Creates a minLength validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviMinLength(2, 'Må være minst 2 tegn')
+ * ```
+ */
+declare function hviMinLength(length: number, message: string): HviValidatorBundle;
+/**
+ * Creates a maxLength validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviMaxLength(100, 'Kan ikke være mer enn 100 tegn')
+ * ```
+ */
+declare function hviMaxLength(length: number, message: string): HviValidatorBundle;
+/**
+ * Creates an email validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviEmail('Ugyldig e-postadresse')
+ * ```
+ */
+declare function hviEmail(message: string): HviValidatorBundle;
+/**
+ * Creates a pattern validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviPattern(/^\d+$/, 'Kan kun inneholde tall')
+ * ```
+ */
+declare function hviPattern(pattern: string | RegExp, message: string): HviValidatorBundle;
+/**
+ * Creates a min value validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviMin(0, 'Må være minst 0')
+ * ```
+ */
+declare function hviMin(min: number, message: string): HviValidatorBundle;
+/**
+ * Creates a max value validator bundle.
+ *
+ * @example
+ * ```ts
+ * hviMax(100, 'Kan ikke være mer enn 100')
+ * ```
+ */
+declare function hviMax(max: number, message: string): HviValidatorBundle;
+/**
+ * Creates a custom validator bundle with a specified error key.
+ * Use this for custom validators or validators not covered by the built-in functions.
+ *
+ * @example
+ * ```ts
+ * // Custom validator that checks if value matches a specific format
+ * const norwegianPhoneValidator: ValidatorFn = (control) => {
+ *   const valid = /^(\+47)?\d{8}$/.test(control.value);
+ *   return valid ? null : { norwegianPhone: true };
+ * };
+ *
+ * hviCustom('norwegianPhone', norwegianPhoneValidator, 'Ugyldig norsk telefonnummer')
+ * ```
+ */
+declare function hviCustom(key: string, validator: ValidatorFn, message: string): HviValidatorBundle;
+/**
+ * Creates a nullValidator bundle (always valid, useful for conditional validation).
+ * Note: This validator always passes, so the message will never be shown.
+ */
+declare function hviNullValidator(): HviValidatorBundle;
+
 declare const HviFieldKit: readonly [typeof HviField, typeof HviFieldValidation, typeof HviFieldDescription, typeof HviFieldOptional, typeof HviFieldAffix, typeof HviFieldAffixes];
 declare const HviValidationKit: readonly [typeof ReactiveFormsModule, typeof HviForm, typeof HviControlInvalid, typeof HviValidationMessage];
 declare const HviForms: readonly [typeof ReactiveFormsModule, typeof HviForm, typeof HviControlInvalid, typeof HviValidationMessage, typeof HviField, typeof HviFieldValidation, typeof HviFieldDescription, typeof HviFieldOptional, typeof HviFieldAffix, typeof HviFieldAffixes, typeof HviInput, typeof HviFieldset, typeof HviErrorSummary];
@@ -774,6 +921,53 @@ declare class HviParagraph {
     static ɵdir: i0.ɵɵDirectiveDeclaration<HviParagraph, "p[hviParagraph]", never, { "variant": { "alias": "variant"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * @summary
+ * Popover vises over andre elementer i grensesnittet og er koblet til et spesifikt element.
+ * Den brukes til å vise tilleggsinformasjon, interaktive elementer eller korte forklaringer uten å navigere bort fra siden.
+ *
+ * @example
+ * ```html
+ * <button hviButton popovertarget="popover1">Open popover</button>
+ * <hvi-popover id="popover1"> Popover content </hvi-popover>
+ * ```
+ *
+ * @see {@link https://designsystemet.no/en/components/docs/popover/code}
+ */
+declare class HviPopover implements OnInit, OnDestroy {
+    private el;
+    private cleanupAutoUpdate?;
+    private boundHandleClick?;
+    private boundHandleKeydown?;
+    /** Popover type - 'manual' krever manuell lukking, 'auto' lukkes ved klikk utenfor */
+    type: 'auto' | 'manual' | 'hint';
+    /** Visuell variant */
+    variant: 'default' | 'tinted';
+    /** Farge-tema */
+    color: 'neutral' | 'danger' | 'info' | 'success' | 'warning';
+    /** Plassering av popover relativt til trigger */
+    placement: Placement;
+    /** Aktiver automatisk repositjonering hvis det ikke er plass */
+    autoPlacement: boolean;
+    /** Event når popover åpnes */
+    opened: EventEmitter<void>;
+    /** Event når popover lukkes */
+    closed: EventEmitter<void>;
+    private get popoverElement();
+    private get triggerElement();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private setupEventListeners;
+    private removeEventListeners;
+    private handleBeforeToggle;
+    private handleToggle;
+    private updatePosition;
+    private startAutoUpdate;
+    private stopAutoUpdate;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HviPopover, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<HviPopover, "hvi-popover", never, { "type": { "alias": "type"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "color": { "alias": "color"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "autoPlacement": { "alias": "autoPlacement"; "required": false; }; }, { "opened": "opened"; "closed": "closed"; }, never, ["*"], true, never>;
+}
+
 /**
  * @summary
  * Tag is a label that can be used to categorize items or communicate progress, status, or process. Tags can provide users with a quicker overview of content.
@@ -796,5 +990,5 @@ declare class HviTag {
     static ɵcmp: i0.ɵɵComponentDeclaration<HviTag, "hvi-tag", never, { "variant": { "alias": "variant"; "required": false; }; "size": { "alias": "size"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, {}, never, ["*"], true, never>;
 }
 
-export { HviAlert, HviAvatar, HviBadge, HviBadgePosition, HviBreadcrumbs, HviButton, HviCard, HviCardBlock, HviChipButton, HviChipLabel, HviControlInvalid, HviDetails, HviDetailsContent, HviDetailsSummary, HviDialog, HviDialogBlock, HviDivider, HviErrorSummary, HviField, HviFieldAffix, HviFieldAffixes, HviFieldDescription, HviFieldKit, HviFieldOptional, HviFieldValidation, HviFieldset, HviForm, HviForms, HviHeading, HviIcon, HviInput, HviLabel, HviLink, HviList, HviParagraph, HviTag, HviValidationKit, HviValidationMessage, fieldObserver, isElement, isInputLike, isLabel };
-export type { HviErrorSummaryItem, HviErrorSummaryMessages, HviValidationMessages };
+export { HviAlert, HviAvatar, HviBadge, HviBadgePosition, HviBreadcrumbs, HviButton, HviCard, HviCardBlock, HviChipButton, HviChipLabel, HviControlInvalid, HviDetails, HviDetailsContent, HviDetailsSummary, HviDialog, HviDialogBlock, HviDivider, HviErrorSummary, HviField, HviFieldAffix, HviFieldAffixes, HviFieldDescription, HviFieldKit, HviFieldOptional, HviFieldValidation, HviFieldset, HviForm, HviForms, HviHeading, HviIcon, HviInput, HviLabel, HviLink, HviList, HviParagraph, HviPopover, HviTag, HviValidationKit, HviValidationMessage, fieldObserver, hviCustom, hviEmail, hviExtractMessages, hviExtractValidators, hviMax, hviMaxLength, hviMin, hviMinLength, hviNullValidator, hviPattern, hviRequired, hviRequiredTrue, hviValidators, isElement, isInputLike, isLabel };
+export type { HviErrorSummaryItem, HviErrorSummaryMessages, HviValidationMessages, HviValidatorBundle, HviValidatorConfig };