@area8975/ui 0.2.2-dev.41 → 0.2.2-dev.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@area8975/ui",
-  "version": "0.2.2-dev.41",
+  "version": "0.2.2-dev.43",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",

package/types/area8975-ui.d.ts

@@ -1525,6 +1525,10 @@ export interface SelectOptionContext<Model> {
 export interface SelectTriggerContext<Model> {
   $implicit: Model;
 }
+/** Context for a projected `#leading` template, inline search single select only. */
+export interface SelectLeadingContext<Model> {
+  $implicit: Model;
+}
 /** One line in the open list. Groups are headings, the rest can be picked. */
 export type SelectRow<Model> = {
   kind: 'group';
@@ -1591,6 +1595,8 @@ export declare class UiSelectComponent<Model = unknown> {
   readonly hasMore: import("@angular/core").WritableSignal<boolean>;
   readonly optionTemplate: import("@angular/core").Signal<TemplateRef<SelectOptionContext<Model>> | undefined>;
   readonly triggerTemplate: import("@angular/core").Signal<TemplateRef<SelectTriggerContext<Model>> | undefined>;
+  /** With an inline search, shown before the chosen item's text, e.g. its colour. Single select only. */
+  readonly leadingTemplate: import("@angular/core").Signal<TemplateRef<SelectLeadingContext<Model>> | undefined>;
   /** Index into the pickable rows, the one keyboard focus sits on. */
   readonly activeIndex: import("@angular/core").WritableSignal<number>;
   readonly listId: string;
@@ -1599,6 +1605,9 @@ export declare class UiSelectComponent<Model = unknown> {
   readonly isEmpty: import("@angular/core").Signal<boolean>;
   /** Tags only replace the trigger text when there's no inline search box. */
   readonly showTags: import("@angular/core").Signal<boolean>;
+  readonly showLeading: import("@angular/core").Signal<boolean>;
+  /** Typing replaces the chosen item's text, so its leading content sits out the search. */
+  readonly leadingHidden: import("@angular/core").Signal<boolean>;
   /** The text to create from, or null when there's nothing to offer. */
   readonly createQuery: import("@angular/core").Signal<string | null>;
   readonly rows: import("@angular/core").Signal<SelectRow<Model>[]>;
@@ -1763,7 +1772,7 @@ export declare class UiSelectComponent<Model = unknown> {
     "create": "create";
     "selectedItem": "selectedItemChange";
     "selectedItems": "selectedItemsChange";
-  }, ["optionTemplate", "triggerTemplate"], never, true, never>;
+  }, ["optionTemplate", "triggerTemplate", "leadingTemplate"], never, true, never>;
 }
 /** Native resize values for the textarea element. */
 export declare const TextareaResizeOptions: readonly ["none", "both", "horizontal", "vertical"];
@@ -2899,12 +2908,16 @@ export interface TableColumn<Row> {
   /** unique key, used for sorting/filtering/visibility/pinning/reordering */
   id: string;
   header: string;
+  /** the cell's value, used for sorting and filtering even when a `uiTableCell` template draws the cell */
   accessor: (row: Row) => unknown;
   /** how the cell value is formatted for display, defaults to plain text */
   displayType?: TableColumnDisplayType;
   /** ISO currency code, used when displayType is 'currency'. Defaults to the currency from `provideUiFormat`. */
   currency?: string;
-  /** Masks the cell in privacy mode, e.g. a transaction's description. Currency cells are already masked, icon cells have no text. */
+  /**
+   * Masks the cell in privacy mode, e.g. a transaction's description. Currency cells are already masked, icon cells have no text.
+   * A `uiTableCell` template is replaced by the mask too.
+   */
   sensitive?: boolean;
   sortable?: boolean;
   filterable?: boolean;
@@ -2920,6 +2933,12 @@ export interface TableColumn<Row> {
   /** false excludes the column from the visibility toggle menu */
   hideable?: boolean;
 }
+/** Context for a `uiTableCell` template. */
+export interface TableCellContext<Row> {
+  $implicit: Row;
+  /** what the column's accessor gives for the row */
+  value: unknown;
+}
 export interface TableRowAction<Row> {
   id: string;
   label: string;
@@ -2983,6 +3002,12 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   readonly reorderableColumns: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   readonly reorderableRows: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
   readonly stickyHeader: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Leaves out the header row, for rows that read on their own. A `uiTableBar` can still select every row. */
+  readonly headerless: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  private readonly bar;
+  protected readonly hasBar: import("@angular/core").Signal<boolean>;
+  /** Starts each run of rows with a heading row, e.g. a date. A row gets one whenever its heading differs from the row before it. */
+  readonly groupHeading: import("@angular/core").InputSignal<((row: Row) => string) | null>;
   readonly actions: import("@angular/core").InputSignal<TableRowAction<Row>[]>;
   readonly sort: import("@angular/core").ModelSignal<TableSortState | null>;
   readonly selectedRowIds: import("@angular/core").ModelSignal<Set<unknown>>;
@@ -3004,6 +3029,8 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   protected readonly dragOverColumnId: import("@angular/core").WritableSignal<string | null>;
   protected readonly dragPreview: import("@angular/core").WritableSignal<ColumnDragPreview | null>;
   protected readonly draggedRowIndex: import("@angular/core").WritableSignal<number | null>;
+  private readonly cellDirectives;
+  protected readonly cellTemplates: import("@angular/core").Signal<Map<string, TemplateRef<TableCellContext<unknown>>>>;
   readonly isEmpty: import("@angular/core").Signal<boolean>;
   readonly generatedClasses: import("@angular/core").Signal<string>;
   protected readonly orderedColumns: import("@angular/core").Signal<TableColumn<Row>[]>;
@@ -3014,13 +3041,16 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   protected readonly hasFilterableColumns: import("@angular/core").Signal<boolean>;
   protected readonly activeFilterCount: import("@angular/core").Signal<number>;
   protected readonly hasActions: import("@angular/core").Signal<boolean>;
+  protected readonly columnSpan: import("@angular/core").Signal<number>;
+  /** Each row's heading, or null when it continues the run above it. */
+  protected readonly groupHeadings: import("@angular/core").Signal<(string | null)[]>;
   private readonly hasSensitiveColumns;
   protected readonly fixedWidth: import("@angular/core").Signal<number | null>;
   protected readonly actionsColumnWidth: import("@angular/core").Signal<number>;
   protected readonly totalPages: import("@angular/core").Signal<number>;
   protected readonly resultsLabel: import("@angular/core").Signal<string>;
-  protected readonly allSelected: import("@angular/core").Signal<boolean>;
-  protected readonly someSelected: import("@angular/core").Signal<boolean>;
+  readonly allSelected: import("@angular/core").Signal<boolean>;
+  readonly someSelected: import("@angular/core").Signal<boolean>;
   private readonly leftOffsets;
   private readonly rightOffsets;
   private readonly load$;
@@ -3029,8 +3059,10 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   private readonly registry;
   protected readonly uiFormat: import("@area8975/ui").UiFormat;
   private readonly privateText;
+  protected readonly privacy: import("@angular/core").Signal<"visible" | "discreet" | "hidden">;
   private loadedQuery;
   private loadedFilters;
+  private loadedSort;
   private resizeState;
   private columnDragState;
   private readonly filterDataSources;
@@ -3058,7 +3090,7 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   protected toggleColumnVisibility(column: TableColumn<Row>): void;
   protected isRowSelected(row: Row, index: number): boolean;
   protected toggleRow(row: Row, index: number): void;
-  protected toggleSelectAll(): void;
+  toggleSelectAll(): void;
   protected columnWidth(column: TableColumn<Row>): number;
   protected isPinned(column: TableColumn<Row>): boolean;
   protected leftOffset(column: TableColumn<Row>): number | null;
@@ -3160,6 +3192,16 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
       "required": false;
       "isSignal": true;
     };
+    "headerless": {
+      "alias": "headerless";
+      "required": false;
+      "isSignal": true;
+    };
+    "groupHeading": {
+      "alias": "groupHeading";
+      "required": false;
+      "isSignal": true;
+    };
     "actions": {
       "alias": "actions";
       "required": false;
@@ -3180,7 +3222,31 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
     "selectedRowIds": "selectedRowIdsChange";
     "selectionChange": "selectionChange";
     "rowsReordered": "rowsReordered";
-  }, never, never, true, never>;
+  }, ["bar", "cellDirectives"], ["[uiTableBar]"], true, never>;
+}
+/**
+ * Draws a column's cells in place of its formatted value, matched by column id:
+ * `<ng-template uiTableCell="description" let-row>`. The accessor stays the cell's value.
+ */
+export declare class UiTableCellDirective {
+  readonly columnId: import("@angular/core").InputSignal<string>;
+  readonly template: TemplateRef<TableCellContext<unknown>>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiTableCellDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<UiTableCellDirective, "ng-template[uiTableCell]", never, {
+    "columnId": {
+      "alias": "uiTableCell";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Content for a bar along the top of the table, e.g. a count and a sort control above a
+ * `headerless` list: `<div uiTableBar>`. With `selectable`, the bar also selects every row.
+ */
+export declare class UiTableBarDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiTableBarDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<UiTableBarDirective, "[uiTableBar]", never, {}, {}, never, never, true, never>;
 }
 export interface UiLinkedTable {
   readonly query: WritableSignal<string>;