react-os-shell 4.11.1 → 4.14.0

package/dist/index.d.ts

@@ -32,15 +32,23 @@ interface NavItem {
     to: string;
     label: string;
     perms?: string[];
+    /** Permissions the user must hold EVERY one of, unlike `perms` which needs
+     *  only one. For an entry whose page is gated on a narrower permission than
+     *  the one that puts it in the menu: listing both in `perms` would widen the
+     *  audience (it's an OR), so the extra one goes here instead. */
+    allPerms?: string[];
     dividerAfter?: boolean;
-    /** Optional 3rd-level sub-items. Hovering the parent in <StartMenu> opens
-     *  a nested flyout; in <Sidebar> the parent becomes an inline sub-accordion. */
+    /** Optional sub-items, to any depth — a child may have children of its own.
+     *  Hovering the parent in <StartMenu> opens a nested flyout; in <Sidebar>
+     *  the parent becomes an inline sub-accordion. */
     children?: NavItem[];
 }
 interface NavSection {
     label: string;
     items: NavItem[];
     perms?: string[];
+    /** Same all-of rule as `NavItem.allPerms`, for a whole section. */
+    allPerms?: string[];
     /** Optional landing route for clicks on the section title itself
      *  (e.g. R&D's `/rd` dashboard). */
     to?: string;
@@ -1793,6 +1801,12 @@ declare function EntityList<T>(props: EntityListProps<T>): react_jsx_runtime.JSX
  * `dragenter` (once per card crossed) so the line stays stable rather than
  * flickering. Pass `onAddItem` to give each column a "+ Add item" button at its
  * foot, revealed on column hover / keyboard focus.
+ *
+ * With no items the board is replaced by `emptyState` — right when the items
+ * are the whole story, wrong when the columns are (a pipeline the user just
+ * configured has a shape worth showing, and a board with no drop target can't
+ * take its first card). Pass `showColumnsWhenEmpty` for that case and the
+ * normal layout draws with every column on its `columnEmptyText` placeholder.
  */
 interface KanbanColumn {
     /** Stable column key — what `columnOf` returns and `onMove` receives. */
@@ -1822,8 +1836,16 @@ interface KanbanProps<T> {
     sortInColumn?: (a: T, b: T) => number;
     isLoading?: boolean;
     loadingText?: string;
-    /** Shown when there are no items at all. */
+    /** Shown INSTEAD of the board when there are no items at all. */
     emptyState?: ReactNode;
+    /**
+     * Draw the board — headers, empty columns, drop targets — even with no items,
+     * instead of replacing it with `emptyState`. Opt in when the columns are
+     * themselves the information (a configurable pipeline the user just defined)
+     * or when an empty board still needs somewhere to drop a card into. Default
+     * `false` keeps the `emptyState` behaviour every existing caller relies on.
+     */
+    showColumnsWhenEmpty?: boolean;
     /** Placeholder text inside an empty column. */
     columnEmptyText?: string;
     /**
@@ -1834,7 +1856,7 @@ interface KanbanProps<T> {
     /** Label for the per-column add button. */
     addItemText?: string;
 }
-declare function Kanban<T>({ items, columns, columnOf, getId, onMove, renderCard, onCardClick, sortInColumn, isLoading, loadingText, emptyState, columnEmptyText, onAddItem, addItemText, }: KanbanProps<T>): react_jsx_runtime.JSX.Element;
+declare function Kanban<T>({ items, columns, columnOf, getId, onMove, renderCard, onCardClick, sortInColumn, isLoading, loadingText, emptyState, showColumnsWhenEmpty, columnEmptyText, onAddItem, addItemText, }: KanbanProps<T>): react_jsx_runtime.JSX.Element;
 
 interface PaginatedResponse<T> {
     count: number;