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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@area8975/ui",
-  "version": "0.2.2-dev.41",
+  "version": "0.2.2-dev.42",
   "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;
@@ -3004,6 +3023,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>[]>;
@@ -3029,6 +3050,7 @@ 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 resizeState;
@@ -3180,7 +3202,23 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
     "selectedRowIds": "selectedRowIdsChange";
     "selectionChange": "selectionChange";
     "rowsReordered": "rowsReordered";
-  }, never, never, true, never>;
+  }, ["cellDirectives"], never, 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>;
 }
 export interface UiLinkedTable {
   readonly query: WritableSignal<string>;