@churchillliving/se-ui-toolkit 6.55.190 → 6.55.191

package/README.md

@@ -17,7 +17,50 @@ After building your library with `ng build se-ui-toolkit`, go to the dist folder
 
 ## Running unit tests
 
-Run `ng test se-ui-toolkit` to execute the unit tests via [Karma](https://karma-runner.github.io).
+**Run all tests (recommended):**
+```bash
+node run-all-tests.js
+```
+
+This runs both Angular unit tests and grid component tests in sequence.
+
+**Run individual test suites:**
+```bash
+# Angular unit tests via Karma
+ng test se-ui-toolkit
+
+# Grid component tests only
+node src/lib/components/base/grid/run-all-grid-tests.js
+```
+
+## Global Filters - Date Range Filter
+
+### Date Range Filter Initialization
+
+The `addGlobalDateRangeFilter` method accepts `value` and `valueTwo` properties to set initial start and end dates for the filter.
+
+**Supported Input Formats:**
+- Date objects: `new Date('2026-05-29')`
+- ISO date strings: `'2026-05-29'`
+- Locale-formatted strings: `'5/29/2026'`
+
+**Example:**
+```typescript
+this.gridService.addGlobalDateRangeFilter({
+  fromField: "FROM",
+  toField: "TO",
+  displayText: "Dates",
+  dayRange: utilities.EDayRange.WEEK,
+  value: new Date('2026-05-29'),      // Start date
+  valueTwo: new Date('2026-06-05'),   // End date
+})
+```
+
+**Important:** Both `value` and `valueTwo` must be provided together for the filter to initialize with dates. If either is missing, the filter will start empty. Users can then use the Previous/Next buttons to navigate date ranges based on the configured `dayRange` property.
+
+### Date Format Handling
+
+The component properly handles conversion of Date objects and strings to the format required by the p-datepicker component. Avoid calling `toLocaleDateString()` on date values before passing them to the filter, as the component handles this conversion internally.
 
 ## Further help