@oslokommune/punkt-react 16.14.0 → 16.15.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ og skriver commits ca etter [Conventional Commits](https://conventionalcommits.o
 
 ---
 
+## [16.15.0](https://github.com/oslokommune/punkt/compare/16.14.0...16.15.0) (2026-05-11)
+
+### ⚠ BREAKING CHANGES
+Ingen
+
+### Features
+Ingen
+
+### Bug Fixes
+Ingen
+
+### Chores
+Ingen
+
+---
+
+
 ## [16.14.0](https://github.com/oslokommune/punkt/compare/16.13.3...16.14.0) (2026-05-08)
 
 ### ⚠ BREAKING CHANGES

package/dist/{dialog-polyfill.esm-1hPr0gl9-EorOF9Wq.js → dialog-polyfill.esm-BmVHGRTX-CuhXqEqJ.js}

@@ -33,7 +33,7 @@
                   return [];
                 };
               }
-              //#region ../elements/dist/dialog-polyfill.esm-1hPr0gl9.js
+              //#region ../elements/dist/dialog-polyfill.esm-BmVHGRTX.js
 var e = window.CustomEvent;
 (!e || typeof e == "object") && (e = function(e, t) {
 	t ||= {};

package/dist/index.d.ts

@@ -10,6 +10,9 @@ import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
 import { HTMLProps } from 'react';
 import { IDatepickerStrings } from './shared-types/datepicker';
+import { IFileItem } from './shared-types';
+import { IFileTransfer } from './shared-types';
+import { IFileValidateDetail } from './shared-types';
 import { InputHTMLAttributes } from 'react';
 import { IPktComboboxOption } from './shared-types/combobox';
 import { IPktConsent as IPktConsent_2 } from '@oslokommune/punkt-elements';
@@ -33,6 +36,7 @@ import { TAlertSkin } from './shared-types';
 import { TAriaLive } from './shared-types';
 import { TCardSkin } from './shared-types';
 import { TextareaHTMLAttributes } from 'react';
+import { TFileUploadStrategy } from './shared-types';
 import { THeaderMenu } from './shared-types';
 import { THeaderPosition } from './shared-types';
 import { THeaderScrollBehavior } from './shared-types';
@@ -78,20 +82,20 @@ declare type ExtendedLoader = IPktLoader_2 & PktElType;
  * Notes:
  * - A `fileId` is generated automatically if omitted.
  * - `attributes.targetFilename` is the filename shown in the queue and may be updated by extensions (e.g. rename).
+ *
+ * Implements the shared `IFileItem` type from `shared-types`.
  */
-export declare class FileItem implements FileItem {
+export declare class FileItem implements IFileItem {
     fileId: TFileId;
     file: File;
-    attributes: Record<string, any>;
+    attributes: {
+        targetFilename: string;
+    } & Record<string, unknown>;
     constructor(file: File, fileId?: TFileId);
 }
 
 /**
  * Shared props for `PktFileUpload` (both `form` and `custom` strategies).
- *
- * The component can be used as:
- * - **controlled**: pass `value` + `onFilesChanged`
- * - **uncontrolled**: pass `defaultValue` (internal state is not stored; you still receive new lists via callbacks)
  */
 declare interface IBaseFileUploadProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'checked' | 'size' | 'type' | 'value' | 'onChange' | 'width' | 'defaultValue'> {
     /** Called with the next file list when files are added/removed/updated. */
@@ -120,9 +124,9 @@ declare interface IBaseFileUploadProps extends Omit<InputHTMLAttributes<HTMLInpu
     /** Uncontrolled initial value (use either `value` or `defaultValue`, not both). */
     defaultValue?: TFileItemList;
     /** Extra operations appended after built-ins (rename/comment). */
-    extraOperations?: Array<TQueueItemExtension>;
+    extraOperations?: Array<TQueueItemOperation>;
     /** Stretch to full container width (drop zone + queue). */
-    fullWidth?: boolean;
+    fullwidth?: boolean;
     /** Allowed formats for built-in validation (extensions like `pdf`, or MIME patterns like `image/*`). */
     allowedFormats?: string[];
     /** Custom message for invalid format. Use `{formats}` placeholder. */
@@ -133,6 +137,11 @@ declare interface IBaseFileUploadProps extends Omit<InputHTMLAttributes<HTMLInpu
     sizeErrorMessage?: string;
     /** Optional additional validation hook (runs after built-in format/size checks). Return string to block. */
     onFileValidation?: (file: File) => string | null;
+    /**
+     * Low-level validation escape hatch — Lit parity with the `file-validate` CustomEvent.
+     * Receives a detail object whose `errorMessage` can be mutated; set it to reject the file.
+     */
+    onFileValidate?: (detail: TFileValidateDetail) => void;
     /** External/programmatic error message shown under the component. */
     errorMessage?: string;
     /** External error flag (combined with internal validation errors). */
@@ -165,19 +174,11 @@ declare interface ICardTag {
     text: string;
 }
 
-/** Props for `uploadStrategy="form"` (native file input submission). */
 declare interface IFileInputFileUploadProps extends IBaseFileUploadProps, Omit<HTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'defaultValue'> {
     uploadStrategy?: 'form';
     onFileUploadRequested?: never;
 }
 
-/**
- * Props for `uploadStrategy="custom"` (upload handled externally).
- *
- * Requirements:
- * - `transfers` must be provided (to render status/progress)
- * - `onFileUploadRequested` is called for each added file
- */
 declare interface ImmediateFileUploadProps extends IBaseFileUploadProps {
     id: string;
     uploadStrategy: 'custom';
@@ -1192,20 +1193,11 @@ export declare type TFileId = string;
 /** The value type for `PktFileUpload` (`value` / `defaultValue`). */
 export declare type TFileItemList = Array<FileItem>;
 
-/**
- * Transfer status for a file when using `uploadStrategy="custom"`.
- *
- * - `progress`: `0..1` during upload, or a state (`queued`, `done`, `error`, `canceled`)
- * - `showProgress`: if false, UI uses indeterminate "Laster opp..." style instead of progress bar
- * - `lastProgress`: used to render a "failed at X%" bar when an upload errors
- */
-export declare type TFileTransfer = {
-    fileId: TFileId;
-    progress: number | 'done' | 'error' | 'canceled' | 'queued';
-    errorMessage?: string;
-    showProgress?: boolean;
-    lastProgress?: number;
-};
+/** Transfer status for a file when using `uploadStrategy="custom"` — aliased from `shared-types`. */
+export declare type TFileTransfer = IFileTransfer;
+
+/** Detail payload passed to the React `onFileValidate` escape hatch. */
+declare type TFileValidateDetail = IFileValidateDetail;
 
 declare type THeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 
@@ -1224,29 +1216,40 @@ declare type TPktAccordionSkin = TAccordionSkin;
 
 declare type TPktAccordionSkin_2 = TAccordionSkin;
 
-/** Factory that produces a queue item operation given access to file attributes. */
-export declare type TQueueItemExtension = (attributes: TFileAttributes) => TQueueItemOperation;
-
 /**
  * An operation that can be attached to a queue item (rename, comment, remove, etc).
  *
- * An operation may:
- * - be a simple action (`onClick`)
- * - render inline UI (e.g. rename)
- * - render extended UI (e.g. comments)
- * - render hidden inputs for form submission (`renderHidden`)
+ * Must carry a stable `id: string` — symbols are no longer supported.
  */
 export declare type TQueueItemOperation = {
-    title: string | ((fileItem: FileItem) => string);
-    ariaLabel?: string | ((fileItem: FileItem) => string);
-    onClick?: (transferItem: FileItem) => void;
-    renderInlineUI?: (fileItem: FileItem, closeOperationUi: () => void) => ReactNode;
-    renderExtendedUI?: (fileItem: FileItem, closeOperationUi: () => void) => ReactNode;
-    renderContent?: (fileItem: FileItem, activateOperation?: () => void, isOperationActive?: boolean) => ReactNode;
-    renderHidden?: (fileItem: FileItem) => ReactNode;
-    symbol: symbol;
+    id: string;
+    title: TQueueOperationLabel;
+    ariaLabel?: TQueueOperationLabel;
+    onClick?: (context: TQueueOperationContext) => void;
+    renderInlineUI?: (context: TQueueOperationContext) => ReactNode;
+    renderExtendedUI?: (context: TQueueOperationContext) => ReactNode;
+    renderContent?: (context: TQueueOperationContext) => ReactNode;
+    renderHidden?: (context: TQueueOperationContext) => ReactNode;
 };
 
+/**
+ * Context passed to queue-item operations. Mirrors the Lit
+ * `TQueueOperationContext` so operations authored for one runtime are
+ * trivial to port to the other.
+ */
+export declare type TQueueOperationContext = {
+    file: FileItem;
+    inputName: string;
+    disabled: boolean;
+    isActive: boolean;
+    activate: () => void;
+    close: () => void;
+    getAttribute: <T>(name: string) => T | undefined;
+    setAttribute: (name: string, value: unknown) => void;
+};
+
+declare type TQueueOperationLabel = string | ((fileItem: FileItem) => string);
+
 declare type TSkin = 'blue' | 'green' | 'red' | 'beige' | 'yellow' | 'grey' | 'gray' | 'blue-light';
 
 declare type TSkin_2 = IPktTag['skin'];
@@ -1260,7 +1263,7 @@ export declare type TTransferItemInProgress = TFileAndTransfer & {
 };
 
 /** Upload mode: `form` posts the files on submit, `custom` posts file IDs and uploads separately. */
-export declare type TUploadStrategy = 'custom' | 'form';
+export declare type TUploadStrategy = TFileUploadStrategy;
 
 /** User object for header components */
 declare interface User {