hs-uix 1.6.0 → 1.6.2

package/README.md

@@ -29,7 +29,7 @@ Requires `react` >= 18.0.0 and `@hubspot/ui-extensions` >= 0.12.0 as peer depend
 |-----------|-------------|------|
 | **DataTable** | Filterable, sortable, paginated table with auto-sized columns, inline editing, row grouping, and more | [Full documentation](https://github.com/05bmckay/hs-uix/blob/main/packages/datatable/README.md) |
 | **FormBuilder** | Declarative, config-driven form with validation, multi-step wizards, and 20+ field types | [Full documentation](https://github.com/05bmckay/hs-uix/blob/main/packages/form/README.md) |
-| **Kanban** | Stage-based board with filters, sort, headline metrics, card action bars, and DataTable-parity card field config | See the [Kanban section](#kanban) below |
+| **Kanban** | Stage-based board with filters, sort, headline metrics, card action bars, and DataTable-parity card field config | [Full documentation](https://github.com/05bmckay/hs-uix/blob/main/packages/kanban/README.md) |
 | **Common Components** | Thin visual wrappers over HubSpot primitives — `AutoTag`, `AutoStatusTag`, `AvatarStack`, `SectionHeader`, `KeyValueList`, `StyledText` | [Full documentation](https://github.com/05bmckay/hs-uix/blob/main/src/common-components/README.md) |
 | **Utils** | Pure helpers for formatting, options, HubSpot value guards, and tag-variant inference | [Full documentation](https://github.com/05bmckay/hs-uix/blob/main/src/utils/README.md) |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hs-uix",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Production-ready UI components for HubSpot UI Extensions — DataTable, FormBuilder, and more",
   "license": "MIT",
   "main": "./dist/index.js",

package/utils.d.ts

@@ -47,7 +47,34 @@ export interface StatusTagSortComparatorOptions extends AutoStatusTagOptions {
 export declare function createStatusTagSortComparator(
   options?: StatusTagSortComparatorOptions
 ): (aValue: unknown, bValue: unknown) => number;
+export interface FormatCurrencyCompactOptions extends Intl.NumberFormatOptions {
+  locale?: string;
+  currency?: string;
+  maximumFractionDigits?: number;
+  compactDisplay?: "short" | "long";
+}
+
+export interface DeriveCardFieldsOptions<Row = Record<string, unknown>> {
+  titleField?: string;
+  titleHref?: (row: Row) => string | { url: string; external?: boolean };
+  placements?: Record<string, "title" | "subtitle" | "meta" | "body" | "footer">;
+  exclude?: string[];
+  include?: string[];
+  maxBodyFields?: number;
+}
+
+export interface DerivedCardField<Row = Record<string, unknown>> {
+  key: string;
+  field: string;
+  placement: "title" | "subtitle" | "meta" | "body" | "footer";
+  label?: unknown;
+  render?: (value: unknown, row: Row) => unknown;
+  truncate?: true | number | { maxLength?: number };
+  href?: (row: Row) => string | { url: string; external?: boolean };
+}
+
 export declare function formatCurrency(value: unknown, options?: FormatCurrencyOptions): string;
+export declare function formatCurrencyCompact(value: unknown, options?: FormatCurrencyCompactOptions): string;
 export declare function formatDate(value: unknown, options?: FormatDateOptions): string;
 export declare function formatDateTime(value: unknown, options?: FormatDateOptions): string;
 export declare function formatPercentage(value: unknown, options?: Intl.NumberFormatOptions & { locale?: string }): string;
@@ -57,3 +84,7 @@ export declare function isDateValueObject(value: unknown): boolean;
 export declare function isTimeValueObject(value: unknown): boolean;
 export declare function isDateTimeValueObject(value: unknown): boolean;
 export declare function sumBy<Item = Record<string, unknown>>(items: Item[] | null | undefined, keyOrFn: keyof Item | ((item: Item) => unknown)): number;
+export declare function deriveCardFieldsFromColumns<Row = Record<string, unknown>>(
+  columns: ReadonlyArray<Record<string, unknown>> | null | undefined,
+  options?: DeriveCardFieldsOptions<Row>
+): DerivedCardField<Row>[];