bitboss-ui 3.0.0-beta.65 → 3.0.0-beta.67

package/dist/components/BbTable/types.d.ts

@@ -1,5 +1,5 @@
 import { Classes } from '../../types/Classes';
-import { PtNoInfer, PtItemCtx, PtItemMap, PtItemResult, PtValue } from '../../types/passthrough';
+import { PtCompoundProps, PtNoInfer, PtItemCtx, PtScopedItemMap, PtItemResult, PtValue } from '../../types/passthrough';
 import { ItemAccessor } from '../../types/ItemAccessor';
 import { BbTableItemsContext } from '../../types/ItemsProvider';
 import { Option } from '../../types/Option';
@@ -262,19 +262,19 @@ export type BbTableSurfacePtPart = 'root' | 'caption' | 'table' | 'head' | 'head
  *   is sorted, either direction (`bb-table__cell-column-header--sorted`).
  * @state sortedDesc - Per node, on `cellColumnHeader` and `sortIcon`: sorted
  *   descending (`bb-table__cell-column-header--sorted-desc`). Ascending is `sorted` alone.
- * @state expanded - Per node, on `row`, its cells and its `expand`: the row's
+ * @state expanded - Per node, on `row`, its cells, its `dragHandle` and its `expand`: the row's
  *   expand row is open (`bb-table__row--expanded`).
- * @state disabled - Per node, on `row`, its cells and its `selectIcon`: the row
+ * @state disabled - Per node, on `row`, its cells, its `dragHandle` and its `selectIcon`: the row
  *   cannot be SELECTED — `selectable` rejects it, or the table is `disabled`
  *   (`bb-table__row--disabled`). It still clicks, highlights and expands.
  *   Never on a table without selection. The select-all glyph takes it from
  *   the table's `disabled`.
- * @state selected - Per node, on `row`, its cells, its `expand` and its
+ * @state selected - Per node, on `row`, its cells, its `dragHandle`, its `expand` and its
  *   `selectIcon`: a checked row; on the select-all glyph, every row is
  *   selected.
  * @state indeterminate - Per node, on the select-all `selectIcon`: some rows
  *   are selected, not all.
- * @state highlighted - Per node, on `row`, its cells and its `expand`: the
+ * @state highlighted - Per node, on `row`, its cells, its `dragHandle` and its `expand`: the
  *   highlighted row.
  * @state value - Per node, on a DATA `cell`: the formatter / placeholder
  *   pipeline produced a value (not `null` / `undefined`), slot cells included
@@ -287,21 +287,53 @@ export type BbTableSurfacePtPart = 'root' | 'caption' | 'table' | 'head' | 'head
  * @state loading - Component-wide: the table is `loading`.
  */
 export type BbTablePtState = 'loading' | 'empty' | 'value' | 'placeholder' | 'sorted' | 'sortedDesc' | 'expanded' | 'disabled' | 'selected' | 'indeterminate' | 'highlighted';
+/** The parts that still render while the table is `empty` (no data rows). Spelled flat (T20). */
+export type BbTableEmptyPtPart = 'root' | 'caption' | 'table' | 'head' | 'headerRow' | 'cellColumnHeader' | 'sortIcon' | 'body' | 'selectIcon' | 'dragIcon' | 'foot';
+/** A column header and its sort arrow: they know the column's sort. */
+export type BbTableHeaderPtPart = 'cellColumnHeader' | 'sortIcon';
+/** A data row and the parts that carry its states. */
+export type BbTableRowPtPart = 'row' | 'cell' | 'dragHandle';
+/**
+ * Every `part` / `part:state` key of `BbTable` — only the pairs that land.
+ * `PtKeysOf<typeof BB_TABLE_PT>` is the same union; a type test pins them.
+ */
+export type BbTablePtKey = BbTablePtPart | `${BbTablePtPart}:loading` | `${BbTableEmptyPtPart}:empty` | `${BbTableHeaderPtPart}:${'sorted' | 'sortedDesc'}` | `${BbTableRowPtPart}:${'expanded' | 'disabled' | 'selected' | 'highlighted'}` | `expand:${'expanded' | 'selected' | 'highlighted'}` | `selectIcon:${'selected' | 'disabled' | 'indeterminate'}` | `cell:${'value' | 'placeholder'}`;
 /** The runtime lists the resolver is wired with — kept next to the types so the two cannot drift. */
 export declare const BB_TABLE_PT: {
     readonly parts: readonly ["root", "caption", "table", "head", "headerRow", "cellColumnHeader", "sortIcon", "body", "row", "cell", "expand", "firstRow", "lastRow", "selectIcon", "dragIcon", "dragHandle", "foot"];
     readonly states: readonly ["value", "placeholder", "empty", "sorted", "sortedDesc", "selected", "indeterminate", "disabled", "expanded", "highlighted", "loading"];
+    /** On every part: what the resolver's `active` map turns on. */
+    readonly wide: readonly ["empty", "loading"];
+    /** Per node: a header's sort, a row's states, a cell's content. */
+    readonly node: {
+        readonly cellColumnHeader: readonly ["sorted", "sortedDesc"];
+        readonly sortIcon: readonly ["sorted", "sortedDesc"];
+        readonly row: readonly ["selected", "disabled", "expanded", "highlighted"];
+        readonly cell: readonly ["value", "placeholder", "selected", "disabled", "expanded", "highlighted"];
+        readonly dragHandle: readonly ["selected", "disabled", "expanded", "highlighted"];
+        readonly expand: readonly ["selected", "expanded", "highlighted"];
+        readonly selectIcon: readonly ["selected", "indeterminate", "disabled"];
+    };
+    /** No data row renders while the table is `empty`. */
+    readonly except: {
+        readonly row: readonly ["empty"];
+        readonly cell: readonly ["empty"];
+        readonly expand: readonly ["empty"];
+        readonly firstRow: readonly ["empty"];
+        readonly lastRow: readonly ["empty"];
+        readonly dragHandle: readonly ["empty"];
+    };
 };
 export type BbTableProps<Item = any> = {
-    [K in `pt:${BbTableSurfacePtPart}` | `pt:${BbTablePtPart}:${BbTablePtState}`]?: PtValue;
-} & {
+    [K in `pt:${BbTableSurfacePtPart}` | `pt:${BbTablePtPart}:loading` | `pt:${BbTableEmptyPtPart}:empty` | `pt:${BbTableHeaderPtPart}:${'sorted' | 'sortedDesc'}` | `pt:${BbTableRowPtPart}:${'expanded' | 'disabled' | 'selected' | 'highlighted'}` | `pt:expand:${'expanded' | 'selected' | 'highlighted'}` | `pt:selectIcon:${'selected' | 'disabled' | 'indeterminate'}` | `pt:cell:${'value' | 'placeholder'}`]?: PtValue;
+} & /* @vue-ignore */ PtCompoundProps<typeof BB_TABLE_PT> & {
     'pt:row'?: PtValue | ((ctx: PtItemCtx<PtNoInfer<Item>, BbTablePtState>) => PtItemResult);
     'pt:expand'?: PtValue | ((ctx: PtItemCtx<PtNoInfer<Item>, BbTablePtState>) => PtItemResult);
     /**
      * Passthrough, object form: the same keys as the `pt:*` attributes
      * without the prefix. See the `pt:<part>` row.
      */
-    pt?: PtItemMap<BbTablePtPart, 'row' | 'expand', BbTablePtState, PtNoInfer<Item>>;
+    pt?: PtScopedItemMap<BbTablePtKey, 'row' | 'expand', BbTablePtState, PtNoInfer<Item>>;
     /**
      * The label of each row's selection checkbox, from `(columns, item)`. Unset:
      * the row's name in the locale's select template (its `rowHeader` cells,
@@ -873,7 +905,14 @@ export type BbTableSlots<Item = any> = BbTableColumnSlots<Item> & {
      * a CSS grid: provide `<div role="row">` rows of `<div
      * role="columnheader">` cells, never `<tr>` / `<th>`.
      */
-    thead?: (props: object) => any;
+    thead?: (props: {
+        /**
+         * True while the body shows its empty row: `items` (the rows you
+         * passed or the provider returned, so the current page, after your
+         * filters) has none and nothing is loading.
+         */
+        empty: boolean;
+    }) => any;
     /**
      * Replaces the content of the body row group (`.bb-table__body`), for full
      * control of the body markup. Provide role-complete rows (`<div role="row">`
@@ -895,6 +934,12 @@ export type BbTableSlots<Item = any> = BbTableColumnSlots<Item> & {
          * `grid-column: span N` with `N` up to this value.
          */
         columnCount: number;
+        /**
+         * True while the body shows its empty row: `items` (the rows you
+         * passed or the provider returned, so the current page, after your
+         * filters) has none and nothing is loading.
+         */
+        empty: boolean;
     }) => any;
     /**
      * Replaces the default selection header cell content (checkbox or radio label).

package/dist/components/BbTable/types.js

@@ -1,4 +1,4 @@
-//#region src/components/BbTable/types.ts
+// src/components/BbTable/types.ts
 var e = {
 	parts: [
 		"root",
@@ -31,7 +31,49 @@ var e = {
 		"expanded",
 		"highlighted",
 		"loading"
-	]
+	],
+	wide: ["empty", "loading"],
+	node: {
+		cellColumnHeader: ["sorted", "sortedDesc"],
+		sortIcon: ["sorted", "sortedDesc"],
+		row: [
+			"selected",
+			"disabled",
+			"expanded",
+			"highlighted"
+		],
+		cell: [
+			"value",
+			"placeholder",
+			"selected",
+			"disabled",
+			"expanded",
+			"highlighted"
+		],
+		dragHandle: [
+			"selected",
+			"disabled",
+			"expanded",
+			"highlighted"
+		],
+		expand: [
+			"selected",
+			"expanded",
+			"highlighted"
+		],
+		selectIcon: [
+			"selected",
+			"indeterminate",
+			"disabled"
+		]
+	},
+	except: {
+		row: ["empty"],
+		cell: ["empty"],
+		expand: ["empty"],
+		firstRow: ["empty"],
+		lastRow: ["empty"],
+		dragHandle: ["empty"]
+	}
 };
-//#endregion
 export { e as BB_TABLE_PT };