@oslokommune/punkt-react 17.1.3 → 18.1.0

package/dist/shared-strings/consent.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Tekster og informasjonskapsel-oppsett for samtykkedialogen.
+ *
+ * Denne ligger utenfor `nb.ts` fordi formen er en annen: en liste med
+ * informasjonskapsler som hver har egne tekster per språk, ikke et flatt
+ * namespace. Den deles av Elements og React slik at de to ikke kommer i utakt.
+ */
+export declare const consentStrings: {
+    i18n: {
+        nb: {
+            contentPresentation: {
+                title: string;
+                description: string[];
+                buttons: {
+                    accept: string;
+                    reject: string;
+                    settings: string;
+                };
+            };
+            contentSettings: {
+                title: string;
+                description: string[];
+                buttons: {
+                    back: string;
+                    save: string;
+                };
+            };
+        };
+        en: {
+            contentPresentation: {
+                title: string;
+                description: string[];
+                buttons: {
+                    accept: string;
+                    reject: string;
+                    settings: string;
+                };
+            };
+            contentSettings: {
+                title: string;
+                description: string[];
+                buttons: {
+                    back: string;
+                    save: string;
+                };
+            };
+        };
+    };
+    cookies: {
+        name: string;
+        defaultValue: boolean;
+        i18n: {
+            nb: {
+                title: string;
+                description: string;
+                buttons: {
+                    yes: string;
+                    no: string;
+                };
+            };
+            en: {
+                title: string;
+                description: string;
+                buttons: {
+                    yes: string;
+                    no: string;
+                };
+            };
+        };
+    }[];
+};

package/dist/shared-strings/format.d.ts

@@ -0,0 +1,21 @@
+import type { TPktStringParams } from './types';
+/**
+ * Setter verdier inn i `{navn}`-plassholdere.
+ *
+ * ```ts
+ * formatString('Verdien må være større enn eller lik {min}.', { min: 5 })
+ * // → 'Verdien må være større enn eller lik 5.'
+ * ```
+ *
+ * En plassholder uten tilsvarende verdi blir stående urørt, slik at en ufullstendig
+ * overstyring gir synlig, feilsøkbar tekst i stedet for et tomt felt.
+ */
+export declare function formatString(template: string, params?: TPktStringParams): string;
+/**
+ * Velger entalls- eller flertallsform.
+ *
+ * ```ts
+ * plural(count, s.fileLabelOne, s.fileLabelOther)
+ * ```
+ */
+export declare function plural(count: number, one: string, other: string): string;

package/dist/shared-strings/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delt tekstkatalog for Punkt.
+ *
+ * Alle UI-tekster i designsystemet defineres i `nb.ts` og brukes derfra av både
+ * `@oslokommune/punkt-elements` og `@oslokommune/punkt-react`. Konsumenter kan
+ * overstyre tekster globalt med `setPktStrings()` eller per komponentinstans via
+ * `strings`-propen.
+ */
+export { nb } from './nb';
+export { formatString, plural } from './format';
+export { getPktStrings, resetPktStrings, setPktStrings, subscribePktStrings } from './store';
+export { resolveNamespace, resolveStrings } from './resolve';
+export type { IPktStringsProps, TPktStringParams, TPktStrings, TPktStringsNamespace, TPktStringsOverride, TPktStringsShape, TPktStringValue, } from './types';
+export { consentStrings } from './consent';

package/dist/shared-strings/nb.d.ts

@@ -0,0 +1,121 @@
+export declare const nb: {
+    /** Tekster som går igjen på tvers av flere komponenter. */
+    generic: {
+        from: string;
+        to: string;
+        close: string;
+    };
+    /** Etiketter og hjelpetekst rundt skjemafelt. */
+    forms: {
+        optional: string;
+        required: string;
+        readMore: string;
+    };
+    /** Valideringsmeldinger. Nøkkelnavnene følger `ValidityState` der det finnes et tilsvarende flagg. */
+    validation: {
+        valueMissing: string;
+        typeMismatch: string;
+        patternMismatch: string;
+        tooShort: string;
+        tooLong: string;
+        rangeUnderflow: string;
+        rangeOverflow: string;
+        rangeUnderflowMin: string;
+        rangeOverflowMax: string;
+        stepMismatch: string;
+        timeStepMismatch: string;
+        timeStepMismatchHour: string;
+        timeStepMismatchHalfHour: string;
+        dateUnderflow: string;
+        dateOverflow: string;
+        counterExceeded: string;
+    };
+    /** Måneds- og dagsnavn. Listene må ha henholdsvis 12 og 7 elementer. */
+    dates: {
+        month: string;
+        year: string;
+        week: string;
+        days: string[];
+        daysShort: string[];
+        months: string[];
+        monthsShort: string[];
+    };
+    calendar: {
+        prevMonth: string;
+        nextMonth: string;
+    };
+    datepicker: {
+        openPicker: string;
+        deleteDate: string;
+    };
+    timepicker: {
+        hours: string;
+        minutes: string;
+        openPicker: string;
+        prevTime: string;
+        nextTime: string;
+        selectTime: string;
+    };
+    searchinput: {
+        placeholder: string;
+        submit: string;
+    };
+    backlink: {
+        label: string;
+    };
+    breadcrumbs: {
+        ariaLabel: string;
+    };
+    alert: {
+        lastUpdated: string;
+    };
+    tag: {
+        remove: string;
+    };
+    header: {
+        search: string;
+        menu: string;
+        openMenu: string;
+        openSearch: string;
+    };
+    listbox: {
+        searchLabel: string;
+        searchPlaceholder: string;
+    };
+    combobox: {
+        noResults: string;
+        maxSelected: string;
+        tooManySelected: string;
+        alreadySelected: string;
+        valueAdded: string;
+        noValidValue: string;
+    };
+    fileupload: {
+        dropZoneDragMultiple: string;
+        dropZoneDragSingle: string;
+        dropZoneDragMultipleThumbnail: string;
+        dropZoneDragSingleThumbnail: string;
+        dropZoneDragActiveMultiple: string;
+        dropZoneDragActiveSingle: string;
+        dropZoneDragActiveMultipleThumbnail: string;
+        dropZoneDragActiveSingleThumbnail: string;
+        dropZoneOpenFileDialogMultiple: string;
+        dropZoneOpenFileDialogSingle: string;
+        dropZoneOpenFileDialogMultipleThumbnail: string;
+        dropZoneOpenFileDialogSingleThumbnail: string;
+        supportedFormatsPrefix: string;
+        invalidFormat: string;
+        sizeTooLarge: string;
+        requiredMissing: string;
+        genericValidationRejection: string;
+        unknownFilename: string;
+        previewFallbackName: string;
+        previewImage: string;
+        fileLabelOne: string;
+        fileLabelOther: string;
+        srFileAdded: string;
+        srFilesAdded: string;
+        srFilesUploadedOfTotal: string;
+        srFilesFailedOfTotal: string;
+    };
+};

package/dist/shared-strings/resolve.d.ts

@@ -0,0 +1,12 @@
+import type { TPktStrings, TPktStringsNamespace, TPktStringsOverride } from './types';
+/** Slår opp ett namespace. */
+export declare function resolveNamespace<K extends TPktStringsNamespace>(ns: K, ...layers: Array<TPktStringsOverride | undefined>): TPktStrings[K];
+/**
+ * Slår opp flere namespace på én gang.
+ *
+ * ```ts
+ * const s = resolveStrings(['forms', 'validation'], this.strings)
+ * s.forms.optional
+ * ```
+ */
+export declare function resolveStrings<NS extends TPktStringsNamespace>(namespaces: readonly NS[], ...layers: Array<TPktStringsOverride | undefined>): Pick<TPktStrings, NS>;

package/dist/shared-strings/store.d.ts

@@ -0,0 +1,27 @@
+import type { TPktStringsOverride } from './types';
+/**
+ * Global tekstoverstyring. Tilstanden ligger på `globalThis` bak en
+ * `Symbol.for()`-nøkkel, slik at `punkt-react` og `punkt-elements` deler én og
+ * samme store på tvers av modulgrafer.
+ */
+type TListener = () => void;
+/**
+ * Overstyrer tekster for hele applikasjonen. Kall det én gang ved oppstart.
+ * Flere kall merges sammen, namespace for namespace.
+ *
+ * ```ts
+ * setPktStrings({ forms: { optional: 'Frivillig' } })
+ * ```
+ */
+export declare function setPktStrings(overrides: TPktStringsOverride): void;
+/**
+ * Gjeldende globale overstyringer. Identiteten endrer seg ved hvert
+ * `setPktStrings()`-kall, så den kan brukes direkte som snapshot i
+ * `useSyncExternalStore`.
+ */
+export declare function getPktStrings(): TPktStringsOverride;
+/** Nullstiller til de innebygde tekstene. Ment for tester. */
+export declare function resetPktStrings(): void;
+/** Abonnerer på endringer. Returnerer en funksjon som melder av. */
+export declare function subscribePktStrings(listener: TListener): () => void;
+export {};

package/dist/shared-strings/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Typene for tekstkatalogen. Katalogen er nøyaktig to nivåer dyp:
+ * namespace → nøkkel → string | string[].
+ */
+import type { nb } from './nb';
+/** En enkelt tekstverdi. Lister brukes for måneds- og dagsnavn. */
+export type TPktStringValue = string | readonly string[];
+/** Formen alle språkbundler må følge. */
+export type TPktStringsShape = Record<string, Record<string, TPktStringValue>>;
+/**
+ * Hele katalogen, utledet fra bokmålsbundelen slik at `nb.ts` er det eneste
+ * stedet en nøkkel defineres.
+ */
+export type TPktStrings = typeof nb;
+/** Navnet på et namespace i katalogen, f.eks. `'forms'` eller `'searchinput'`. */
+export type TPktStringsNamespace = keyof TPktStrings;
+/**
+ * Delvis overstyring av katalogen. Generisk over namespace slik at en komponent
+ * kan smalne typen til de namespacene den faktisk bruker:
+ *
+ * ```ts
+ * strings?: TPktStringsOverride<'forms' | 'validation' | 'searchinput'>
+ * ```
+ */
+export type TPktStringsOverride<NS extends TPktStringsNamespace = TPktStringsNamespace> = {
+    [K in NS]?: Partial<TPktStrings[K]>;
+};
+/** Verdier som kan settes inn i en `{plassholder}`. */
+export type TPktStringParams = Record<string, string | number>;
+/**
+ * `strings`-propen som alle Punkt-komponenter som viser katalogtekst skal ha.
+ * Elements har den på `PktShadowElement`; React-interfaces extender denne slicen.
+ *
+ * TODO: Consider adding a type parameter for the namespace, so that the strings object can be narrowed to the namespace.
+ * f.eks. ÌPktFileUploadProps<'fileupload'|'forms'> for å kunne sette tekster for felt i skjema og valideringsmeldinger.
+ */
+export type IPktStringsProps<NS extends TPktStringsNamespace = TPktStringsNamespace> = {
+    /** Overstyrer tekster for denne komponenten. */
+    strings?: TPktStringsOverride<NS>;
+};

package/dist/shared-types/accordion.d.ts

@@ -0,0 +1,58 @@
+/**
+ * accordion.ts
+ *
+ * Type definisjoner for pkt-accordion og pkt-accordion-item.
+ * Brukes av React, Elements, og typed component specs.
+ *
+ * @remarks React ekspanderer `title` streng typen til `string`|`ReactNode` på accordion-items.
+ * Form-field common props (`IFormFieldCommonProps`) gjelder ikke accordion —
+ * bruk `IAccordionVisualProps` for delte visuelle props (`skin`, `compact`).
+ */
+/** Accordion skin varianter — delt runtime source for types, specs, og Preview. */
+export declare const ACCORDION_SKINS: readonly ['borderless', 'outlined', 'beige', 'blue', 'plus-minus'];
+export type TAccordionSkin = (typeof ACCORDION_SKINS)[number];
+/** Visual props delt med pkt-accordion og pkt-accordion-item. */
+export type IAccordionVisualProps = {
+    skin?: TAccordionSkin;
+    compact?: boolean;
+};
+/**
+ * Accordion props delt med React, Elements, og typed specs.
+ */
+export type IPktAccordionBase = IAccordionVisualProps & {
+    /** ID of the element that labels the accordion group (`aria-labelledby`). */
+    ariaLabelledBy?: string;
+    /** Groups accordion items so only one panel is open at a time within the group. */
+    name?: string;
+};
+/**
+ * Accordion-item props delt med React, Elements, og typed specs.
+ *
+ * @remarks Item `skin` / `compact` overrider verdier arvet fra parent-kontekst når satt.
+ */
+export type IPktAccordionItemBase = IAccordionVisualProps & {
+    id: string;
+    /** Summary label — string in Elements; React may pass `ReactNode`. */
+    title: string;
+    /** Open on first render (uncontrolled initial state). */
+    defaultOpen?: boolean;
+    /** Controlled open state — overrides internal toggle state when set. */
+    isOpen?: boolean;
+    /** Accordion group name — inherits from parent pkt-accordion when omitted. */
+    name?: string;
+};
+/** Pkt-accordion props for typed component specs. */
+export type IAccordionSpecProps = Pick<IPktAccordionBase, 'skin' | 'compact' | 'ariaLabelledBy' | 'name'>;
+/** Pkt-accordion-item props for typed component specs. */
+export type IAccordionItemSpecProps = Pick<IPktAccordionItemBase, 'id' | 'title' | 'defaultOpen' | 'isOpen' | 'name' | 'skin' | 'compact'> & {
+    /**
+     * React-only click handler on the `<details>` element.
+     * @remarks Elements has no equivalent — use native DOM events if needed.
+     */
+    onClick?: (event: Event) => void;
+    /**
+     * React-only toggle handler on the `<details>` element.
+     * @remarks Elements has no equivalent — use native DOM events if needed.
+     */
+    onToggle?: (event: Event) => void;
+};

package/dist/shared-types/alert.d.ts

@@ -0,0 +1,20 @@
+import type { TAriaLive } from './aria';
+/** Alert skin variants — shared runtime source for types, specs, and Preview. */
+export declare const ALERT_SKINS: readonly ['info', 'success', 'warning', 'error'];
+export type TAlertSkin = (typeof ALERT_SKINS)[number];
+/** Alert size variants — shared runtime source for types, specs, and Preview. */
+export declare const ALERT_SIZES: readonly ['medium', 'small', 'xsmall'];
+/** Alert size type derived from ALERT_SIZES */
+export type TAlertSize = (typeof ALERT_SIZES)[number];
+/**
+ * Documented Alert props (subset of React `IPktAlert` / Elements `IPktAlert`).
+ * Used for typed component specs in documentation.
+ */
+export type IAlertSpecProps = {
+    title?: string;
+    skin?: TAlertSkin;
+    date?: string;
+    ariaLive?: TAriaLive;
+    size?: TAlertSize;
+    closeAlert?: boolean;
+};

package/dist/shared-types/aria.d.ts

@@ -9,7 +9,8 @@ export type TAriaBooleanMixed = TAriaBoolean | 'mixed';
 export type TAriaCurrent = TAriaBoolean | 'page' | 'step' | 'location' | 'date' | 'time';
 export type TAriaHasPopup = TAriaBoolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
 export type TAriaInvalid = TAriaBoolean | 'grammar' | 'spelling';
-export type TAriaLive = 'off' | 'polite' | 'assertive';
+export declare const ARIA_LIVE_VALUES: readonly ['off', 'polite', 'assertive'];
+export type TAriaLive = (typeof ARIA_LIVE_VALUES)[number];
 export type TAriaRelevant = 'additions' | 'removals' | 'text' | 'all';
 export type TAriaSort = 'none' | 'ascending' | 'descending' | 'other';
 export type TAriaAutoComplete = 'none' | 'inline' | 'list' | 'both';

package/dist/shared-types/backlink.d.ts

@@ -0,0 +1,23 @@
+/**
+ * backlink.ts
+ *
+ * Type definitions for pkt-backlink.
+ * Used by React, Elements, and typed component specs.
+ */
+import type { IPktStringsProps } from '../shared-strings';
+import type { TRenderLink } from './render-link';
+/** Shared backlink props for React, Elements, and typed specs. */
+export type IPktBackLinkBase = IPktStringsProps & {
+    href?: string;
+    text?: string;
+    /** @deprecated Bruk `strings={{ backlink: { label: '…' } }}` eller `setPktStrings()`. */
+    ariaLabel?: string | null;
+};
+/** Documented props for typed component specs. */
+export type IBacklinkSpecProps = Pick<IPktBackLinkBase, 'href' | 'text' | 'ariaLabel'> & {
+    /**
+     * React-only custom link renderer (e.g. Next.js Link).
+     * @remarks Elements has no equivalent — uses a native `<a>`.
+     */
+    renderLink?: TRenderLink;
+};

package/dist/shared-types/breadcrumbs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * breadcrumbs.ts
+ *
+ * Type definitions for pkt-breadcrumbs.
+ * Used by React, Elements, and typed component specs.
+ */
+import type { IPktStringsProps } from '../shared-strings';
+import type { TRenderLink } from './render-link';
+/** Navigation mode for React `PktBreadcrumbs` (router vs native anchor). */
+export declare const BREADCRUMBS_NAVIGATION_TYPES: readonly ['router', 'anchor'];
+export type TBreadcrumbsNavigationType = (typeof BREADCRUMBS_NAVIGATION_TYPES)[number];
+/** One crumb in a breadcrumbs trail. */
+export type IBreadcrumb = {
+    text: string;
+    href: string;
+};
+/** @deprecated Use `IBreadcrumb` — former Elements export name. */
+export type IBreadcrumbItem = IBreadcrumb;
+/** @deprecated Use `IBreadcrumb` — former React export name (singular type, plural alias). */
+export type IBreadcrumbs = IBreadcrumb;
+/** Shared breadcrumbs props for React, Elements, and typed specs. */
+export type IPktBreadcrumbsBase = IPktStringsProps & {
+    breadcrumbs: IBreadcrumb[];
+};
+/** Documented props for typed component specs. */
+export type IBreadcrumbsSpecProps = Pick<IPktBreadcrumbsBase, 'breadcrumbs'> & {
+    navigationType?: TBreadcrumbsNavigationType;
+    /**
+     * React-only custom link renderer (e.g. Next.js Link).
+     * When set, `navigationType` is effectively `router`.
+     */
+    renderLink?: TRenderLink;
+};

package/dist/shared-types/fileupload.d.ts

@@ -4,8 +4,16 @@
  * Type definitions for the fileupload component.
  * Used by both Elements and React implementations.
  */
-export type TUploadStrategy = 'form' | 'custom';
-export type TFileUploadItemRenderer = 'filename' | 'thumbnail';
+import type { IFormFieldCommonProps, TFormFieldCommonSpecKeys } from './form-field';
+/** Upload strategy variants — shared runtime source for types, specs, and Preview. */
+export declare const UPLOAD_STRATEGIES: readonly ['form', 'custom'];
+export type TUploadStrategy = (typeof UPLOAD_STRATEGIES)[number];
+/** Queue item renderer variants — shared runtime source for types, specs, and Preview. */
+export declare const FILE_UPLOAD_ITEM_RENDERERS: readonly ['filename', 'thumbnail'];
+export type TFileUploadItemRenderer = (typeof FILE_UPLOAD_ITEM_RENDERERS)[number];
+/** Preview-only upload status display — used in docs demo props. */
+export declare const PREVIEW_UPLOAD_STATUS: readonly ['progressbar', 'text'];
+export type TPreviewUploadStatus = (typeof PREVIEW_UPLOAD_STATUS)[number];
 export type TFilesChangedReason = 'add' | 'remove' | 'update';
 export type TFileValidator = (file: File) => string | null;
 export type TTransferProgress = number | 'done' | 'error' | 'canceled' | 'queued';
@@ -44,30 +52,49 @@ export interface IFilesChangedDetail {
     reason: TFilesChangedReason;
     changedFileIds?: string[];
 }
-/** Default Norwegian Bokmål strings used by both implementations. */
-export interface IFileUploadStrings {
-    dropZoneDragMultiple: string;
-    dropZoneDragSingle: string;
-    dropZoneDragMultipleThumbnail: string;
-    dropZoneDragSingleThumbnail: string;
-    dropZoneDragActiveMultiple: string;
-    dropZoneDragActiveSingle: string;
-    dropZoneDragActiveMultipleThumbnail: string;
-    dropZoneDragActiveSingleThumbnail: string;
-    dropZoneOpenFileDialogMultiple: string;
-    dropZoneOpenFileDialogSingle: string;
-    dropZoneOpenFileDialogMultipleThumbnail: string;
-    dropZoneOpenFileDialogSingleThumbnail: string;
-    supportedFormatsPrefix: string;
-    invalidFormatDefault: (formats: string) => string;
-    sizeTooLargeDefault: (maxSize: string) => string;
-    requiredMissing: string;
-    genericValidationRejection: string;
-    unknownFilename: string;
-    fileLabel: (count: number) => string;
-    srFileAdded: (filename: string) => string;
-    srFilesAdded: (count: number) => string;
-    srFilesUploadedOfTotal: (uploaded: number, total: number, label: string) => string;
-    srFilesFailedOfTotal: (failed: number, total: number, label: string) => string;
+/**
+ * Framework-agnostic FileUpload props shared by React, Elements, and typed specs.
+ *
+ * @remarks React widens `helptext`, `helptextDropdown`, `itemRenderer`, and `extraOperations`
+ * in `FileUpload.tsx`. Elements adds `id`, `accept`, and uses events instead of some callbacks.
+ */
+export interface IPktFileUploadBase extends IFormFieldCommonProps {
+    /** Field name. Used for native input (`form`) or hidden ID inputs (`custom`). */
+    name: string;
+    required?: boolean;
+    value?: IFileItem[];
+    defaultValue?: IFileItem[];
+    /** React callback — Elements uses the `files-changed` event instead. */
+    onFilesChanged?: (files: IFileItem[]) => void;
+    uploadStrategy?: TUploadStrategy;
+    multiple?: boolean;
+    itemRenderer?: TFileUploadItemRenderer;
+    allowedFormats?: string[];
+    formatErrorMessage?: string;
+    maxFileSize?: string | number;
+    onFileValidation?: TFileValidator;
+    /**
+     * Low-level validation escape hatch — Lit parity with the `file-validate` event.
+     * React: callback prop. Elements: listen for `file-validate` and mutate `detail.errorMessage`.
+     */
+    onFileValidate?: (detail: IFileValidateDetail) => void;
+    sizeErrorMessage?: string;
+    addCommentsEnabled?: boolean;
+    enableImagePreview?: boolean;
+    /** Experimental queue operations — typed per framework in React/Elements. */
+    extraOperations?: unknown[];
+    fullwidth?: boolean;
+    /** React callback — Elements uses the `file-upload-requested` event instead. */
+    onFileUploadRequested?: (fileItem: IFileItem) => void;
+    /** React callback — Elements uses the `transfer-cancelled` event instead. */
+    onTransferCancelled?: (fileItemId: string) => void;
+    renameFilesEnabled?: boolean;
+    transfers?: IFileTransfer[];
+    truncateTail?: number;
 }
-export declare const defaultFileUploadStrings: IFileUploadStrings;
+/** Documented props for typed component specs — subset of base + docs-only demo props. */
+export type IFileUploadSpecProps = Pick<IPktFileUploadBase, TFormFieldCommonSpecKeys | 'name' | 'required' | 'value' | 'defaultValue' | 'onFilesChanged' | 'uploadStrategy' | 'multiple' | 'itemRenderer' | 'allowedFormats' | 'formatErrorMessage' | 'maxFileSize' | 'onFileValidation' | 'onFileValidate' | 'sizeErrorMessage' | 'addCommentsEnabled' | 'enableImagePreview' | 'extraOperations' | 'fullwidth' | 'onFileUploadRequested' | 'onTransferCancelled' | 'renameFilesEnabled' | 'transfers' | 'truncateTail'> & {
+    previewUploadIntervalMs?: number;
+    previewSimulateUploadError?: boolean;
+    previewUploadStatus?: TPreviewUploadStatus;
+};

package/dist/shared-types/footer.d.ts

@@ -90,6 +90,16 @@ export interface IPktFooterSimpleProps<IconType = string> extends IPktFooterBase
     /** Custom links shown as a compact row in the secondary (grey) footer. */
     links?: IPktFooterLink[];
 }
+/**
+ * Documented FooterSimple props (subset of `IPktFooterSimpleProps`).
+ * Used for typed component specs in documentation.
+ */
+export type IFooterSimpleSpecProps = Pick<IPktFooterSimpleProps, 'links' | 'skipGlobal' | 'data' | 'dataUrl' | 'locale' | 'openLinksInNewTab' | 'includeConsent' | 'googleAnalyticsId' | 'hotjarId'>;
+/**
+ * Documented Footer props (subset of `IPktFooterProps`).
+ * Used for typed component specs in documentation.
+ */
+export type IFooterSpecProps = Pick<IPktFooterProps, 'columns' | 'skipGlobal' | 'data' | 'dataUrl' | 'locale' | 'openLinksInNewTab' | 'includeConsent' | 'googleAnalyticsId' | 'hotjarId'>;
 /** Historical defaults for the deprecated link props — used to detect explicit overrides. */
 export declare const DEFAULT_FOOTER_PERSONVERN_URL = "https://www.oslo.kommune.no/personvern-og-informasjonskapsler/";
 export declare const DEFAULT_FOOTER_TILGJENGELIGHET_URL = "https://www.oslo.kommune.no/tilgjengelighet/";

package/dist/shared-types/form-field.d.ts

@@ -0,0 +1,45 @@
+/**
+ * form-field.ts
+ *
+ * Reusable prop slices for form-field components (input-wrapper, fileupload, etc.).
+ * Compose slices into `IFormFieldCommonProps`, then extend with component-specific props.
+ *
+ * @example
+ * IPktInputWrapperBase = IFormFieldCommonProps & { forId, counter, … }
+ * IPktFileUploadBase = IFormFieldCommonProps & { name, uploadStrategy, … }
+ */
+import type { IPktStringsProps } from '../shared-strings';
+/** Expandable helptext props used by pkt-input-wrapper and several form controls. */
+export type IHelptextProps = {
+    helptext?: string;
+    helptextDropdown?: string;
+    /** @deprecated Bruk `strings={{ forms: { readMore: '…' } }}` eller `setPktStrings()`. */
+    helptextDropdownButton?: string;
+};
+/** Optional/required tag labelling shared by pkt-input-wrapper and form controls. */
+export type ITagOptionalRequiredProps = {
+    tagText?: string | null;
+    optionalTag?: boolean;
+    /** @deprecated Bruk `strings={{ forms: { optional: '…' } }}` eller `setPktStrings()`. */
+    optionalText?: string;
+    requiredTag?: boolean;
+    /** @deprecated Bruk `strings={{ forms: { required: '…' } }}` eller `setPktStrings()`. */
+    requiredText?: string;
+};
+/** Label prop shared by pkt-input-wrapper and form controls that use PktInputWrapper. */
+export type IFormFieldLabelProps = {
+    label?: string;
+};
+/** Error/disabled state shared by pkt-input-wrapper and form controls. */
+export type IFormFieldErrorProps = {
+    disabled?: boolean;
+    hasError?: boolean;
+    errorMessage?: string;
+};
+/**
+ * Shared form-field props — helptext, tags, label, error state, and `strings`.
+ * Input-wrapper adds wrapper-only props (forId, counter, inline, …) on top of this.
+ */
+export type IFormFieldCommonProps = IHelptextProps & ITagOptionalRequiredProps & IFormFieldLabelProps & IFormFieldErrorProps & IPktStringsProps;
+/** Keys from `IFormFieldCommonProps` — reuse in `I*SpecProps` Pick unions across form components. */
+export type TFormFieldCommonSpecKeys = keyof IFormFieldCommonProps;

package/dist/shared-types/header-footer.d.ts

@@ -16,6 +16,8 @@
  */
 import type { Representing, TLogOutButtonPlacement, THeaderPosition, THeaderScrollBehavior, User, UserMenuItem } from './header';
 export type THeaderMenuLocale = 'nb-NO' | 'en-GB' | (string & {});
+/** Documented locale keys — shared runtime source for specs and Preview dropdowns. */
+export declare const HEADER_MENU_LOCALES: readonly ['nb-NO', 'en-GB'];
 /** Plain link without an icon. */
 export interface IHeaderMenuLink {
     text: string;