@brandsync/wc 1.5.4 → 1.7.0

package/dist/types/components/bs-file-upload-item/bs-file-upload-item.d.ts

@@ -0,0 +1,58 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type BsFileUploadItemState = 'loading' | 'in-progress' | 'error' | 'success';
+/**
+ * One file in an upload list: a thumbnail, the file name and size, a status line (a progress bar
+ * while uploading, or a success / error message) and an action button (cancel while uploading or
+ * after an error, remove once uploaded).
+ *
+ * Presentational only -- the consuming app owns the upload and drives `state`, `progress` and
+ * `message` from it. Pair with `bs-file-upload` (the dropzone that picks the files).
+ *
+ * ## When to use
+ * - Showing the status of each file the user has added, in a list under a `bs-file-upload`.
+ *
+ * ## When not to use
+ * - Attaching files to a chat message -- use `bs-attachment`.
+ *
+ * @slot thumbnail - Replaces the thumbnail content (the image-placeholder icon, or `thumbnailSrc`).
+ * @part item - The card.
+ * @part thumbnail - The thumbnail box.
+ * @part name - The file name.
+ * @part size - The file size text.
+ * @part progress - The progress bar (`loading` / `in-progress`).
+ * @part status - The success / error message line.
+ * @part action - The cancel / remove button.
+ */
+export declare class BsFileUploadItem {
+    /** Where the upload is. `loading` = working with no known percentage (indeterminate bar);
+     * `in-progress` = uploading with a known `progress`; `error` and `success` are final. */
+    state: BsFileUploadItemState;
+    /** The file name. */
+    fileName: string;
+    /** The file size, already formatted (e.g. "8MB"). */
+    fileSize?: string;
+    /** Upload progress, 0-100. Only used when `state="in-progress"`. */
+    progress: number;
+    /** The status text. Defaults per state: "Loading..." (`loading`), "{progress}% uploaded"
+     * (`in-progress`), "Upload failed" (`error`), "File uploaded successfully" (`success`). Provide
+     * your own for localisation or a specific error. */
+    message?: string;
+    /** A preview image of the file. Shown instead of the placeholder icon when set. */
+    thumbnailSrc?: string;
+    /** Alt text for `thumbnailSrc`. Leave empty when the file name already says it all. */
+    thumbnailAlt: string;
+    /** Accessible name of the cancel button (`loading`, `in-progress`, `error`). */
+    cancelLabel: string;
+    /** Accessible name of the remove button (`success`). */
+    removeLabel: string;
+    /** Fires when the cancel button is clicked (`loading`, `in-progress`, `error`). The consumer
+     * stops the upload and removes the item. */
+    bsCancel: EventEmitter<void>;
+    /** Fires when the remove button is clicked (`success`). The consumer removes the file. */
+    bsRemove: EventEmitter<void>;
+    private get clampedProgress();
+    private get statusText();
+    private onAction;
+    private renderStatus;
+    render(): any;
+}

package/dist/types/components/bs-file-upload-item/bs-file-upload-item.stories.d.ts

@@ -0,0 +1,18 @@
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+import type { BsFileUploadItemState } from './bs-file-upload-item';
+interface BsFileUploadItemArgs {
+    state: BsFileUploadItemState;
+    fileName: string;
+    fileSize: string;
+    progress: number;
+    message: string;
+    thumbnailSrc: string;
+}
+declare const meta: Meta<BsFileUploadItemArgs>;
+export default meta;
+type Story = StoryObj<BsFileUploadItemArgs>;
+export declare const Loading: Story;
+export declare const InProgress: Story;
+export declare const ErrorState: Story;
+export declare const Success: Story;
+export declare const AllStates: Story;

package/dist/types/components/bs-progress-linear/bs-progress-linear.d.ts

@@ -41,6 +41,11 @@ export declare class BsProgressLinear {
     /** Shows the slotted label below the bar. When `false`, or when no content is slotted, the
      * label wrapper isn't rendered at all. Defaults to `true`. */
     showLabel: boolean;
+    /** Accessible name for the progress bar (e.g. "Uploading report"). Required for assistive tech --
+     * a `role="progressbar"` with no name is an axe-core `aria-progressbar-name` violation. Setting
+     * `aria-label` on the host doesn't reach the inner element across the shadow boundary, so this
+     * prop binds it directly -- same pattern as `bs-button`'s `ariaLabel`. */
+    ariaLabel: string | null;
     private get clampedValue();
     render(): any;
     componentWillLoad(): void;