@jmruthers/pace-core 0.5.61 → 0.5.63

package/docs/api/interfaces/ToastProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / ToastProps
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / ToastProps
 
 # Interface: ToastProps
 

package/docs/api/interfaces/UnifiedAuthContextType.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UnifiedAuthContextType
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UnifiedAuthContextType
 
 # Interface: UnifiedAuthContextType
 

package/docs/api/interfaces/UnifiedAuthProviderProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UnifiedAuthProviderProps
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UnifiedAuthProviderProps
 
 # Interface: UnifiedAuthProviderProps
 

package/docs/api/interfaces/UseInactivityTrackerOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UseInactivityTrackerOptions
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UseInactivityTrackerOptions
 
 # Interface: UseInactivityTrackerOptions
 

package/docs/api/interfaces/UseInactivityTrackerReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UseInactivityTrackerReturn
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UseInactivityTrackerReturn
 
 # Interface: UseInactivityTrackerReturn
 

package/docs/api/interfaces/UsePublicEventLogoOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UsePublicEventLogoOptions
 
 # Interface: UsePublicEventLogoOptions
 

package/docs/api/interfaces/UsePublicEventLogoReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UsePublicEventLogoReturn
 
 # Interface: UsePublicEventLogoReturn
 

package/docs/api/interfaces/UsePublicEventOptions.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UsePublicEventOptions
 
 # Interface: UsePublicEventOptions
 

package/docs/api/interfaces/UsePublicEventReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UsePublicEventReturn
 
 # Interface: UsePublicEventReturn
 

package/docs/api/interfaces/UsePublicRouteParamsReturn.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UsePublicRouteParamsReturn
 
 # Interface: UsePublicRouteParamsReturn
 

package/docs/api/interfaces/UserEventAccess.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UserEventAccess
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UserEventAccess
 
 # Interface: UserEventAccess
 

package/docs/api/interfaces/UserMenuProps.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UserMenuProps
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UserMenuProps
 
 # Interface: UserMenuProps
 

package/docs/api/interfaces/UserProfile.md

@@ -1,4 +1,4 @@
-[@jmruthers/pace-core - v0.5.61](../README.md) / [Exports](../modules.md) / UserProfile
+[@jmruthers/pace-core - v0.5.63](../README.md) / [Exports](../modules.md) / UserProfile
 
 # Interface: UserProfile
 

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.5.61](README.md) / Exports
+[@jmruthers/pace-core - v0.5.63](README.md) / Exports
 
-# @jmruthers/pace-core - v0.5.61
+# @jmruthers/pace-core - v0.5.63
 
 **`File`**
 
@@ -342,10 +342,15 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [getCurrentAppName](modules.md#getcurrentappname)
 - [getCurrentAppId](modules.md#getcurrentappid)
 - [cn](modules.md#cn)
+- [formatDate](modules.md#formatdate)
+- [formatCurrency](modules.md#formatcurrency)
+- [formatNumber](modules.md#formatnumber)
+- [formatPercent](modules.md#formatpercent)
+- [formatCompactNumber](modules.md#formatcompactnumber)
+- [formatFileSize](modules.md#formatfilesize)
 - [createSecureDataAccess](modules.md#createsecuredataaccess)
 - [getFileSizeLimit](modules.md#getfilesizelimit)
 - [validateFileSize](modules.md#validatefilesize)
-- [formatFileSize](modules.md#formatfilesize)
 - [generateFilePath](modules.md#generatefilepath)
 - [generateUniqueFileName](modules.md#generateuniquefilename)
 - [extractFileMetadata](modules.md#extractfilemetadata)
@@ -1205,7 +1210,7 @@ Features are configured through the unified `features` prop for maximum flexibil
 
 #### Defined in
 
-[packages/core/src/components/DataTable/DataTable.tsx:435](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L435)
+[packages/core/src/components/DataTable/DataTable.tsx:448](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L448)
 
 ___
 
@@ -6075,6 +6080,145 @@ ___
 
 ___
 
+### formatDate
+
+▸ **formatDate**(`date`): `string`
+
+Format a date as a readable string
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `date` | `string` \| `number` \| `Date` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:8](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L8)
+
+___
+
+### formatCurrency
+
+▸ **formatCurrency**(`value`, `currencyCode?`, `locale?`): `string`
+
+Format a number as a currency
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `value` | `number` | `undefined` |
+| `currencyCode` | `string` | `'USD'` |
+| `locale` | `string` | `'en-US'` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:23](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L23)
+
+___
+
+### formatNumber
+
+▸ **formatNumber**(`value`, `options?`, `locale?`): `string`
+
+Format a number with custom options
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `value` | `number` | `undefined` |
+| `options` | `NumberFormatOptions` | `{}` |
+| `locale` | `string` | `'en-US'` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:33](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L33)
+
+___
+
+### formatPercent
+
+▸ **formatPercent**(`value`, `locale?`, `decimals?`): `string`
+
+Format a number as a percentage
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `value` | `number` | `undefined` |
+| `locale` | `string` | `'en-US'` |
+| `decimals` | `number` | `1` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L44)
+
+___
+
+### formatCompactNumber
+
+▸ **formatCompactNumber**(`value`, `locale?`): `string`
+
+Format a large number with abbreviations (K, M, B)
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `value` | `number` | `undefined` |
+| `locale` | `string` | `'en-US'` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:59](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L59)
+
+___
+
+### formatFileSize
+
+▸ **formatFileSize**(`bytes`): `string`
+
+Format a file size in bytes to a human-readable string
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `bytes` | `number` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/formatting.ts:69](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/formatting.ts#L69)
+
+___
+
 ### createSecureDataAccess
 
 ▸ **createSecureDataAccess**(`supabase`, `organisationId`, `isSuperAdmin?`): `SecureDataAccess`
@@ -6150,28 +6294,6 @@ Validate file size against limits
 
 ___
 
-### formatFileSize
-
-▸ **formatFileSize**(`bytes`): `string`
-
-Get human-readable file size
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `bytes` | `number` |
-
-#### Returns
-
-`string`
-
-#### Defined in
-
-[packages/core/src/utils/storage/config.ts:88](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L88)
-
-___
-
 ### generateFilePath
 
 ▸ **generateFilePath**(`options`, `fileName`): `string`

package/docs/implementation-guides/data-tables.md

@@ -941,6 +941,27 @@ const desktopColumnOrder = ['select', 'name', 'email', 'role', 'status', 'create
 />
 ```
 
+#### Default Sorting
+
+You can configure your DataTable to load with pre-applied sorting:
+
+```tsx
+<DataTable
+  data={recipes}
+  columns={columns}
+  features={{ sorting: true }}
+  defaultSorting={[
+    { id: 'diettype_name', desc: false },
+    { id: 'item_name', desc: false }
+  ]}
+  rbac={{ pageId: 'recipes' }}
+/>
+```
+
+**Examples:**
+- **Sort by Date (descending):** `defaultSorting={[{ id: 'created_at', desc: true }]}`
+- **Multi-column sort:** `defaultSorting={[{ id: 'category', desc: false }, { id: 'name', desc: false }]}`
+
 ### Filtering
 
 ```tsx
@@ -1543,6 +1564,52 @@ function SelectableUserTable() {
 />
 ```
 
+#### Default Grouping
+
+You can configure your DataTable to load with pre-applied grouping:
+
+```tsx
+<DataTable
+  data={recipes}
+  columns={columns}
+  features={{ grouping: true }}
+  defaultGrouping={['diettype_name']}
+  rbac={{ pageId: 'recipes' }}
+/>
+```
+
+**Examples:**
+- **Group by Status:** `defaultGrouping={['status']}`
+- **Multi-level grouping:** `defaultGrouping={['category', 'status']}`
+
+#### Combined Default Grouping and Sorting
+
+You can combine both default grouping and sorting for a fully pre-organized view:
+
+```tsx
+<DataTable
+  data={recipes}
+  columns={columns}
+  features={{
+    grouping: true,
+    sorting: true,
+  }}
+  defaultGrouping={['diettype_name']}
+  defaultSorting={[
+    { id: 'diettype_name', desc: false },
+    { id: 'item_name', desc: false }
+  ]}
+  rbac={{ pageId: 'recipes' }}
+/>
+```
+
+**Behavior:**
+- **defaultGrouping**: Array of column IDs to group by on initial load
+- **defaultSorting**: Array of sort configurations (column ID + direction)
+- Both props are optional and work independently or together
+- Users can still modify grouping/sorting via UI controls
+- Works with all DataTable features (pagination, filtering, etc.)
+
 ## Performance Optimization
 
 ### Virtual Scrolling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmruthers/pace-core",
-  "version": "0.5.61",
+  "version": "0.5.63",
   "description": "Clean, modern React component library with Tailwind v4 styling and native utilities",
   "private": false,
   "publishConfig": {

package/src/components/DataTable/DataTable.tsx

@@ -368,6 +368,19 @@ export interface DataTableProps<TData extends DataRecord> {
   virtualHeight?: number;
   /** Initial page size for pagination */
   initialPageSize?: number;
+  
+  // ========================================
+  // DEFAULT STATE CONFIGURATION
+  // ========================================
+  
+  /** Initial grouping configuration - columns to group by on load */
+  defaultGrouping?: string[];
+  /** Initial sorting configuration - sort state to apply on load */
+  defaultSorting?: Array<{
+    id: string;
+    desc: boolean;
+  }>;
+  
   /** Enable enhanced pagination controls */
   enhancedPagination?: boolean;
   /** Custom loading component */