@skdx/react-blocks 0.34.0 → 0.36.0

package/dist/workspace-switcher/types.d.cts

@@ -0,0 +1,151 @@
+import type * as React from 'react';
+import type { PopoverContent } from '@skdx/react/primitives/popover';
+type ContentProps = React.ComponentProps<typeof PopoverContent>;
+/** One switchable context in the list — a workspace, organisation, team, account or project. */
+export interface WorkspaceSwitcherItem {
+    /** Stable identifier reported to the change handler and matched against the current value. */
+    id: string;
+    /** Human-readable name rendered as the item's first line and in the closed trigger. */
+    label: string;
+    /**
+     * Secondary line rendered under the label, such as a plan name or member count.
+     * @default undefined — the item renders its label alone.
+     */
+    description?: string | undefined;
+    /**
+     * Heading of the group this item is listed under, gathering items that share it.
+     * @default undefined — the item sits in the leading ungrouped block.
+     */
+    group?: string | undefined;
+    /**
+     * Lists the item but withholds selection, keyboard traversal and pointer highlighting.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+}
+/** Props for the {@link WorkspaceSwitcher} block. */
+export interface WorkspaceSwitcherProps extends Omit<React.ComponentPropsWithRef<'button'>, 'children'> {
+    /** Every context the user may switch to, rendered in the order given. */
+    items: ReadonlyArray<WorkspaceSwitcherItem>;
+    /**
+     * Id of the active context, for controlled usage; pair it with the change handler.
+     * @default undefined — uncontrolled, the block tracks the active id itself.
+     */
+    value?: string | undefined;
+    /**
+     * Id of the context active on first render, for uncontrolled usage.
+     * @default '' — the trigger shows the placeholder until something is picked.
+     */
+    defaultValue?: string | undefined;
+    /**
+     * Fires with the id of the item the user picked, before the panel closes.
+     * @default undefined — the change is reported to nobody.
+     */
+    onValueChange?: ((value: string) => void) | undefined;
+    /**
+     * Trigger text shown while no item in the list is the active one.
+     * @default 'Select'
+     */
+    placeholder?: string | undefined;
+    /**
+     * Accessible name for the trigger and the list, when the visible text is not enough.
+     * @default undefined — the trigger is named by its own visible text.
+     */
+    label?: string | undefined;
+    /**
+     * Accessible name of the search field inside the open panel.
+     * @default 'Search'
+     */
+    searchLabel?: string | undefined;
+    /**
+     * Placeholder text shown inside the panel's empty search field.
+     * @default undefined — the search field renders no placeholder.
+     */
+    searchPlaceholder?: string | undefined;
+    /**
+     * Message shown in place of the list when the search matches nothing.
+     * @default 'No results'
+     */
+    emptyMessage?: string | undefined;
+    /**
+     * Message announced beside the list while results are still in flight.
+     * @default 'Loading'
+     */
+    loadingMessage?: string | undefined;
+    /**
+     * Marks the results as in flight, showing the loading message instead of the empty one.
+     * @default false
+     */
+    loading?: boolean | undefined;
+    /**
+     * Visually hidden text appended to the active item, naming it for screen readers.
+     * @default 'Current'
+     */
+    selectedLabel?: string | undefined;
+    /**
+     * Renders a decorative glyph — an avatar or a logo — for one item and for the trigger.
+     * @default undefined — no leading region renders anywhere.
+     */
+    renderLeading?: ((item: WorkspaceSwitcherItem) => React.ReactNode) | undefined;
+    /**
+     * Controls placed in the panel's footer, such as create and manage buttons.
+     * @default undefined — no footer region renders.
+     */
+    actions?: React.ReactNode | undefined;
+    /**
+     * Replaces the derived trigger button with the consumer's own element entirely.
+     * @default undefined — the block derives a trigger from the active item.
+     */
+    trigger?: React.ReactElement | undefined;
+    /**
+     * Whether the panel is open, for controlled usage; pair it with the change handler.
+     * @default undefined — uncontrolled, the block tracks the open state itself.
+     */
+    open?: boolean | undefined;
+    /**
+     * Whether the panel is open on first render, for uncontrolled usage.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Fires with the new open state whenever the panel opens or closes.
+     * @default undefined — the change is reported to nobody.
+     */
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    /**
+     * Fires with the new open state once the enter or exit animation has settled.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * Fires when Escape is pressed while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onEscapeKeyDown?: ContentProps['onEscapeKeyDown'];
+    /**
+     * Fires on a pointer-down outside the content while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onPointerDownOutside?: ContentProps['onPointerDownOutside'];
+    /**
+     * Fires when focus moves outside the content while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onFocusOutside?: ContentProps['onFocusOutside'];
+    /**
+     * Fires for either kind of outside interaction, just before the specific event.
+     * @default undefined — no-op if omitted.
+     */
+    onInteractOutside?: ContentProps['onInteractOutside'];
+    /**
+     * Fires before focus moves into the content on open; `preventDefault()` leaves focus where it is.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenAutoFocus?: ContentProps['onOpenAutoFocus'];
+    /**
+     * Fires before focus returns to the trigger on close; `preventDefault()` suppresses that return.
+     * @default undefined — no-op if omitted.
+     */
+    onCloseAutoFocus?: ContentProps['onCloseAutoFocus'];
+}
+export {};

package/dist/workspace-switcher/types.d.ts

@@ -0,0 +1,151 @@
+import type * as React from 'react';
+import type { PopoverContent } from '@skdx/react/primitives/popover';
+type ContentProps = React.ComponentProps<typeof PopoverContent>;
+/** One switchable context in the list — a workspace, organisation, team, account or project. */
+export interface WorkspaceSwitcherItem {
+    /** Stable identifier reported to the change handler and matched against the current value. */
+    id: string;
+    /** Human-readable name rendered as the item's first line and in the closed trigger. */
+    label: string;
+    /**
+     * Secondary line rendered under the label, such as a plan name or member count.
+     * @default undefined — the item renders its label alone.
+     */
+    description?: string | undefined;
+    /**
+     * Heading of the group this item is listed under, gathering items that share it.
+     * @default undefined — the item sits in the leading ungrouped block.
+     */
+    group?: string | undefined;
+    /**
+     * Lists the item but withholds selection, keyboard traversal and pointer highlighting.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+}
+/** Props for the {@link WorkspaceSwitcher} block. */
+export interface WorkspaceSwitcherProps extends Omit<React.ComponentPropsWithRef<'button'>, 'children'> {
+    /** Every context the user may switch to, rendered in the order given. */
+    items: ReadonlyArray<WorkspaceSwitcherItem>;
+    /**
+     * Id of the active context, for controlled usage; pair it with the change handler.
+     * @default undefined — uncontrolled, the block tracks the active id itself.
+     */
+    value?: string | undefined;
+    /**
+     * Id of the context active on first render, for uncontrolled usage.
+     * @default '' — the trigger shows the placeholder until something is picked.
+     */
+    defaultValue?: string | undefined;
+    /**
+     * Fires with the id of the item the user picked, before the panel closes.
+     * @default undefined — the change is reported to nobody.
+     */
+    onValueChange?: ((value: string) => void) | undefined;
+    /**
+     * Trigger text shown while no item in the list is the active one.
+     * @default 'Select'
+     */
+    placeholder?: string | undefined;
+    /**
+     * Accessible name for the trigger and the list, when the visible text is not enough.
+     * @default undefined — the trigger is named by its own visible text.
+     */
+    label?: string | undefined;
+    /**
+     * Accessible name of the search field inside the open panel.
+     * @default 'Search'
+     */
+    searchLabel?: string | undefined;
+    /**
+     * Placeholder text shown inside the panel's empty search field.
+     * @default undefined — the search field renders no placeholder.
+     */
+    searchPlaceholder?: string | undefined;
+    /**
+     * Message shown in place of the list when the search matches nothing.
+     * @default 'No results'
+     */
+    emptyMessage?: string | undefined;
+    /**
+     * Message announced beside the list while results are still in flight.
+     * @default 'Loading'
+     */
+    loadingMessage?: string | undefined;
+    /**
+     * Marks the results as in flight, showing the loading message instead of the empty one.
+     * @default false
+     */
+    loading?: boolean | undefined;
+    /**
+     * Visually hidden text appended to the active item, naming it for screen readers.
+     * @default 'Current'
+     */
+    selectedLabel?: string | undefined;
+    /**
+     * Renders a decorative glyph — an avatar or a logo — for one item and for the trigger.
+     * @default undefined — no leading region renders anywhere.
+     */
+    renderLeading?: ((item: WorkspaceSwitcherItem) => React.ReactNode) | undefined;
+    /**
+     * Controls placed in the panel's footer, such as create and manage buttons.
+     * @default undefined — no footer region renders.
+     */
+    actions?: React.ReactNode | undefined;
+    /**
+     * Replaces the derived trigger button with the consumer's own element entirely.
+     * @default undefined — the block derives a trigger from the active item.
+     */
+    trigger?: React.ReactElement | undefined;
+    /**
+     * Whether the panel is open, for controlled usage; pair it with the change handler.
+     * @default undefined — uncontrolled, the block tracks the open state itself.
+     */
+    open?: boolean | undefined;
+    /**
+     * Whether the panel is open on first render, for uncontrolled usage.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Fires with the new open state whenever the panel opens or closes.
+     * @default undefined — the change is reported to nobody.
+     */
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    /**
+     * Fires with the new open state once the enter or exit animation has settled.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * Fires when Escape is pressed while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onEscapeKeyDown?: ContentProps['onEscapeKeyDown'];
+    /**
+     * Fires on a pointer-down outside the content while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onPointerDownOutside?: ContentProps['onPointerDownOutside'];
+    /**
+     * Fires when focus moves outside the content while open; `preventDefault()` keeps it open.
+     * @default undefined — no-op if omitted.
+     */
+    onFocusOutside?: ContentProps['onFocusOutside'];
+    /**
+     * Fires for either kind of outside interaction, just before the specific event.
+     * @default undefined — no-op if omitted.
+     */
+    onInteractOutside?: ContentProps['onInteractOutside'];
+    /**
+     * Fires before focus moves into the content on open; `preventDefault()` leaves focus where it is.
+     * @default undefined — no-op if omitted.
+     */
+    onOpenAutoFocus?: ContentProps['onOpenAutoFocus'];
+    /**
+     * Fires before focus returns to the trigger on close; `preventDefault()` suppresses that return.
+     * @default undefined — no-op if omitted.
+     */
+    onCloseAutoFocus?: ContentProps['onCloseAutoFocus'];
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skdx/react-blocks",
-  "version": "0.34.0",
+  "version": "0.36.0",
   "description": "React blocks for the SkandaDX design system — page-level compositions of @skdx/react styled by @skdx/skins",
   "license": "MIT",
   "publishConfig": {
@@ -33,6 +33,66 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./chat-composer": {
+      "import": {
+        "types": "./dist/chat-composer/index.d.ts",
+        "default": "./dist/chat-composer/ChatComposer.js"
+      },
+      "require": {
+        "types": "./dist/chat-composer/index.d.cts",
+        "default": "./dist/chat-composer/ChatComposer.cjs"
+      }
+    },
+    "./chat-message": {
+      "import": {
+        "types": "./dist/chat-message/index.d.ts",
+        "default": "./dist/chat-message/ChatMessage.js"
+      },
+      "require": {
+        "types": "./dist/chat-message/index.d.cts",
+        "default": "./dist/chat-message/ChatMessage.cjs"
+      }
+    },
+    "./comment": {
+      "import": {
+        "types": "./dist/comment/index.d.ts",
+        "default": "./dist/comment/Comment.js"
+      },
+      "require": {
+        "types": "./dist/comment/index.d.cts",
+        "default": "./dist/comment/Comment.cjs"
+      }
+    },
+    "./comment-thread": {
+      "import": {
+        "types": "./dist/comment-thread/index.d.ts",
+        "default": "./dist/comment-thread/CommentThread.js"
+      },
+      "require": {
+        "types": "./dist/comment-thread/index.d.cts",
+        "default": "./dist/comment-thread/CommentThread.cjs"
+      }
+    },
+    "./confirm-dialog": {
+      "import": {
+        "types": "./dist/confirm-dialog/index.d.ts",
+        "default": "./dist/confirm-dialog/ConfirmDialog.js"
+      },
+      "require": {
+        "types": "./dist/confirm-dialog/index.d.cts",
+        "default": "./dist/confirm-dialog/ConfirmDialog.cjs"
+      }
+    },
+    "./conversation-list": {
+      "import": {
+        "types": "./dist/conversation-list/index.d.ts",
+        "default": "./dist/conversation-list/ConversationList.js"
+      },
+      "require": {
+        "types": "./dist/conversation-list/index.d.cts",
+        "default": "./dist/conversation-list/ConversationList.cjs"
+      }
+    },
     "./dashboard-layout": {
       "import": {
         "types": "./dist/dashboard-layout/index.d.ts",
@@ -43,6 +103,66 @@
         "default": "./dist/dashboard-layout/DashboardLayout.cjs"
       }
     },
+    "./empty-state": {
+      "import": {
+        "types": "./dist/empty-state/index.d.ts",
+        "default": "./dist/empty-state/EmptyState.js"
+      },
+      "require": {
+        "types": "./dist/empty-state/index.d.cts",
+        "default": "./dist/empty-state/EmptyState.cjs"
+      }
+    },
+    "./filter-bar": {
+      "import": {
+        "types": "./dist/filter-bar/index.d.ts",
+        "default": "./dist/filter-bar/FilterBar.js"
+      },
+      "require": {
+        "types": "./dist/filter-bar/index.d.cts",
+        "default": "./dist/filter-bar/FilterBar.cjs"
+      }
+    },
+    "./forgot-password-page": {
+      "import": {
+        "types": "./dist/forgot-password-page/index.d.ts",
+        "default": "./dist/forgot-password-page/ForgotPasswordPage.js"
+      },
+      "require": {
+        "types": "./dist/forgot-password-page/index.d.cts",
+        "default": "./dist/forgot-password-page/ForgotPasswordPage.cjs"
+      }
+    },
+    "./form-section": {
+      "import": {
+        "types": "./dist/form-section/index.d.ts",
+        "default": "./dist/form-section/FormSection.js"
+      },
+      "require": {
+        "types": "./dist/form-section/index.d.cts",
+        "default": "./dist/form-section/FormSection.cjs"
+      }
+    },
+    "./notification-center": {
+      "import": {
+        "types": "./dist/notification-center/index.d.ts",
+        "default": "./dist/notification-center/NotificationCenter.js"
+      },
+      "require": {
+        "types": "./dist/notification-center/index.d.cts",
+        "default": "./dist/notification-center/NotificationCenter.cjs"
+      }
+    },
+    "./onboarding-checklist": {
+      "import": {
+        "types": "./dist/onboarding-checklist/index.d.ts",
+        "default": "./dist/onboarding-checklist/OnboardingChecklist.js"
+      },
+      "require": {
+        "types": "./dist/onboarding-checklist/index.d.cts",
+        "default": "./dist/onboarding-checklist/OnboardingChecklist.cjs"
+      }
+    },
     "./page-container": {
       "import": {
         "types": "./dist/page-container/index.d.ts",
@@ -53,6 +173,16 @@
         "default": "./dist/page-container/PageContainer.cjs"
       }
     },
+    "./reset-password-page": {
+      "import": {
+        "types": "./dist/reset-password-page/index.d.ts",
+        "default": "./dist/reset-password-page/ResetPasswordPage.js"
+      },
+      "require": {
+        "types": "./dist/reset-password-page/index.d.cts",
+        "default": "./dist/reset-password-page/ResetPasswordPage.cjs"
+      }
+    },
     "./sign-in-page": {
       "import": {
         "types": "./dist/sign-in-page/index.d.ts",
@@ -63,6 +193,66 @@
         "default": "./dist/sign-in-page/SignInPage.cjs"
       }
     },
+    "./sign-up-page": {
+      "import": {
+        "types": "./dist/sign-up-page/index.d.ts",
+        "default": "./dist/sign-up-page/SignUpPage.js"
+      },
+      "require": {
+        "types": "./dist/sign-up-page/index.d.cts",
+        "default": "./dist/sign-up-page/SignUpPage.cjs"
+      }
+    },
+    "./stat-card": {
+      "import": {
+        "types": "./dist/stat-card/index.d.ts",
+        "default": "./dist/stat-card/StatCard.js"
+      },
+      "require": {
+        "types": "./dist/stat-card/index.d.cts",
+        "default": "./dist/stat-card/StatCard.cjs"
+      }
+    },
+    "./usage-card": {
+      "import": {
+        "types": "./dist/usage-card/index.d.ts",
+        "default": "./dist/usage-card/UsageCard.js"
+      },
+      "require": {
+        "types": "./dist/usage-card/index.d.cts",
+        "default": "./dist/usage-card/UsageCard.cjs"
+      }
+    },
+    "./user-menu": {
+      "import": {
+        "types": "./dist/user-menu/index.d.ts",
+        "default": "./dist/user-menu/UserMenu.js"
+      },
+      "require": {
+        "types": "./dist/user-menu/index.d.cts",
+        "default": "./dist/user-menu/UserMenu.cjs"
+      }
+    },
+    "./verification-page": {
+      "import": {
+        "types": "./dist/verification-page/index.d.ts",
+        "default": "./dist/verification-page/VerificationPage.js"
+      },
+      "require": {
+        "types": "./dist/verification-page/index.d.cts",
+        "default": "./dist/verification-page/VerificationPage.cjs"
+      }
+    },
+    "./workspace-switcher": {
+      "import": {
+        "types": "./dist/workspace-switcher/index.d.ts",
+        "default": "./dist/workspace-switcher/WorkspaceSwitcher.js"
+      },
+      "require": {
+        "types": "./dist/workspace-switcher/index.d.cts",
+        "default": "./dist/workspace-switcher/WorkspaceSwitcher.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -75,7 +265,7 @@
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@skdx/react": "^0.34.0"
+    "@skdx/react": "^0.36.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",
@@ -93,7 +283,8 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@skdx/react": "0.34.0"
+    "@skdx/react": "0.36.0",
+    "@skdx/shared": "0.36.0"
   },
   "scripts": {
     "lint": "eslint . --cache --cache-location node_modules/.cache/eslint/",