@area8975/ui 0.1.1-dev.21 → 0.1.1-dev.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@area8975/ui",
-  "version": "0.1.1-dev.21",
+  "version": "0.1.1-dev.23",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",

package/types/area8975-ui.d.ts

@@ -618,7 +618,19 @@ export type UiPrivacy = typeof UiPrivacies[number];
 export declare const UI_PRIVACY: InjectionToken<Signal<"visible" | "discreet" | "hidden">>;
 /** The factory runs in an injection context, so it can return a signal from an app service. */
 export declare function provideUiPrivacy(privacy: () => Signal<UiPrivacy>): Provider;
+/** The fixed mask for private text, e.g. a transaction's description. */
+export declare const PRIVATE_TEXT_MASK = "- - -";
+/** What screen readers hear in place of private text. */
+export declare const PRIVATE_TEXT_LABEL = "text hidden";
 export declare function maskMoney(currency: string, locale: string): string;
+export interface PrivateTextFormatter {
+  /** The text, or `PRIVATE_TEXT_MASK`. For visible attributes like `title`. */
+  (text: string | null | undefined): string;
+  /** The text, or `PRIVATE_TEXT_LABEL`. For `aria-*`, so screen readers don't read out dashes. */
+  label: (text: string | null | undefined) => string;
+}
+/** Needs an injection context. Reads `UI_PRIVACY` on every call, so a template or computed calling it follows the mode. */
+export declare function injectPrivateText(): PrivateTextFormatter;
 /** Native type values ui-input supports. File/checkbox/radio/range need their own components. */
 export declare const InputTypes: readonly ["text", "email", "tel", "url", "search", "password", "number", "date", "time", "datetime-local", "month", "week", "color"];
 /** @see {@link InputTypes} */
@@ -2179,6 +2191,25 @@ export declare class UiPaginationComponent {
     "page": "pageChange";
   }, never, never, true, never>;
 }
+/**
+ * Text that privacy mode masks, e.g. a transaction's description.
+ */
+export declare class UiPrivateComponent {
+  private readonly privacy;
+  readonly text: import("@angular/core").InputSignal<string | null | undefined>;
+  protected readonly mask = "- - -";
+  protected readonly label = "text hidden";
+  protected readonly masked: import("@angular/core").Signal<boolean>;
+  readonly generatedClasses: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiPrivateComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiPrivateComponent, "ui-private", never, {
+    "text": {
+      "alias": "text";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 /** Same names as badges, so a status reads the same wherever it shows. */
 export declare const ProgressIntents: readonly ["primary", "secondary", "success", "warning", "danger"];
 /** @see {@link ProgressIntents} */
@@ -2454,6 +2485,8 @@ export interface TableColumn<Row> {
   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. */
+  sensitive?: boolean;
   sortable?: boolean;
   filterable?: boolean;
   /** when set, the filter renders as a select instead of a free-text contains filter */
@@ -2562,6 +2595,8 @@ 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>;
+  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>;
@@ -2574,6 +2609,7 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   private readonly cdr;
   private readonly registry;
   protected readonly uiFormat: import("@area8975/ui").UiFormat;
+  private readonly privateText;
   private loadedQuery;
   private loadedFilters;
   private resizeState;
@@ -2593,6 +2629,7 @@ export declare class UiTableComponent<Row = unknown> implements OnInit, OnDestro
   protected filterDataSource(column: TableColumn<Row>): SelectDataSource<TableColumnFilterOption>;
   protected selectedFilterOption(column: TableColumn<Row>): TableColumnFilterOption | null;
   protected filterOptionLabel(option: TableColumnFilterOption): string;
+  protected readonly sensitiveFilterOptionLabel: (option: TableColumnFilterOption) => string;
   protected onFilterSelect(columnId: string, option: TableColumnFilterOption | null): void;
   protected clearFilters(): void;
   protected toggleSort(column: TableColumn<Row>): void;