@brycks/core-front 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -573,7 +573,13 @@ export declare interface ButtonOwnProps {
     leftIcon?: ReactNode;
     /** Right icon/element */
     rightIcon?: ReactNode;
-    /** Icon-only button (square, no text) */
+    /**
+     * Icon-only button (square, no text). Requires `aria-label`.
+     *
+     * With `variant="soft"` the tinted box is deferred to hover / open-menu:
+     * at rest the icon stands free, so a column of row-level icons doesn't read
+     * as a column of chips. Other variants are unaffected.
+     */
     isIconOnly?: boolean;
     /** Custom class name */
     className?: string;
@@ -1541,6 +1547,84 @@ export declare type FileInputSize = 'sm' | 'md' | 'lg';
 
 export declare type FileInputVariant = 'default' | 'dropzone';
 
+export declare interface FileRejection {
+    file: File;
+    reason: FileRejectionReason;
+}
+
+/** Why a file was refused. */
+export declare type FileRejectionReason = 'type' | 'size';
+
+export declare const FileUpload: ForwardRefExoticComponent<FileUploadProps & RefAttributes<HTMLInputElement>>;
+
+/**
+ * Every user-facing string, so the host app supplies its own translations.
+ * The library ships English defaults and stays i18n-free.
+ */
+export declare interface FileUploadLabels {
+    /** Text of the button in the `compact` variant. */
+    trigger?: string;
+    /** Shown next to the trigger while nothing is selected (`compact`). */
+    placeholder?: string;
+    /** Main call to action inside the dropzone. */
+    prompt?: ReactNode;
+    /** Shown while a drag is hovering the dropzone. */
+    dropPrompt?: string;
+    /** Accessible label of the per-file remove button. */
+    remove?: string;
+    /** Error for a file whose type is not accepted. */
+    invalidType?: (fileName: string) => string;
+    /** Error for a file above `maxSize`. */
+    tooLarge?: (fileName: string, maxSizeLabel: string) => string;
+}
+
+export declare interface FileUploadProps {
+    /** Selected files (controlled). */
+    files: File[];
+    /** Called with the next selection whenever files are added or removed. */
+    onFilesChange: (files: File[]) => void;
+    /** Layout. */
+    variant?: FileUploadVariant;
+    /** Size. */
+    size?: FileUploadSize;
+    /** Accepted types, e.g. `".pfx,.p12"` or `"application/pdf"`. */
+    accept?: string;
+    /** Allow selecting more than one file. */
+    multiple?: boolean;
+    /** Cap on the number of files when `multiple`. */
+    maxFiles?: number;
+    /** Maximum size per file, in bytes. Rejections are reported, never silent. */
+    maxSize?: number;
+    /** Helper text under the prompt (e.g. accepted formats). */
+    hint?: ReactNode;
+    /** Error message from the host app (e.g. a failed upload). */
+    error?: ReactNode;
+    /** Render the field as invalid without a message. */
+    isInvalid?: boolean;
+    /** Disable selection and removal. */
+    disabled?: boolean;
+    /** Icon shown in the dropzone. */
+    icon?: ReactNode;
+    /** Notified when files are refused by `accept`/`maxSize`. */
+    onReject?: (rejections: FileRejection[]) => void;
+    /** Overridable user-facing strings. */
+    labels?: FileUploadLabels;
+    /** Id of the underlying input, to pair with an external label. */
+    id?: string;
+    /** Custom class name. */
+    className?: string;
+    /** Test ID. */
+    testId?: string;
+}
+
+export declare type FileUploadSize = 'sm' | 'md' | 'lg';
+
+/**
+ * `dropzone` — generous dashed target, best for documents and images.
+ * `compact` — a single row (button + selected file), fits inline in a form.
+ */
+export declare type FileUploadVariant = 'dropzone' | 'compact';
+
 export declare const Flex: ForwardRefExoticComponent<FlexProps & RefAttributes<HTMLDivElement>>;
 
 declare type FlexAlign = 'start' | 'end' | 'center' | 'baseline' | 'stretch';
@@ -1771,6 +1855,15 @@ export declare interface FooterProps extends SemanticProps {
 
 export declare const Form: ForwardRefExoticComponent<FormProps & RefAttributes<HTMLFormElement>>;
 
+/**
+ * FileUpload — pure helpers
+ *
+ * Framework-free selection logic so it can be reasoned about and tested
+ * without rendering anything.
+ */
+/** Human-readable file size, e.g. `1.4 MB`. */
+export declare function formatBytes(bytes: number): string;
+
 export declare const FormCard: ForwardRefExoticComponent<FormCardProps & RefAttributes<HTMLDivElement>>;
 
 export declare type FormCardIntent = 'neutral' | 'primary' | 'success' | 'warning' | 'error' | 'info';