@starasia/admin 8.1.3 → 8.2.0

package/dist/components/FilterBar/components/pills/DatePill.d.ts

@@ -1,21 +1,13 @@
 import { default as React } from 'react';
-import { DateFilterField, DateRangeFilterField } from '../../types';
+import { DateCompactFilterField, DateCompactValue, DateFilterField } from '../../types';
 
 interface DatePillProps {
-    field: DateFilterField | DateRangeFilterField;
-    value: Date | {
-        from: Date;
-        to: Date;
-    } | undefined;
+    field: DateFilterField | DateCompactFilterField;
+    value: Date | DateCompactValue | undefined;
     onChange: (v: unknown) => void;
     onClear: () => void;
     /** Removes the whole pill (the popover's "Remove Filter" action). */
     onRemove: () => void;
 }
-/**
- * Date / date-range pill. Outer `Menu` for positioning + Remove Filter; the
- * popover hosts a `StarasiaDate` calendar (no `input` mode — the Menu trigger
- * is our pill button).
- */
 export declare const DatePill: React.FC<DatePillProps>;
 export {};

package/dist/components/FilterBar/hooks/useLastFilterState.d.ts

@@ -0,0 +1,27 @@
+import { FilterStorageAdapter } from '../types';
+
+interface UseLastFilterStateOptions {
+    scopeId?: string;
+    storage: FilterStorageAdapter;
+    /** URL params to snapshot (e.g. [activeFilterKey, filterKey, perPageKey]). */
+    snapshotKeys: string[];
+    /** Opt-out toggle (default true when scopeId is provided). */
+    enabled?: boolean;
+}
+/**
+ * Persists the latest filter URL params per scope, so link-based back
+ * navigation (which drops the query string) still restores the previous
+ * filters on remount. URL always wins — restoration only kicks in when the
+ * URL has none of the snapshot keys.
+ *
+ * - **Autosave**: writes to `localStorage[filterbar:last:{scopeId}]` on every
+ *   `searchParams` change.
+ * - **Autorestore**: on mount, hydrates the URL from storage if empty.
+ * - **`clear()`**: removes the snapshot; call this from Reset so the user's
+ *   explicit reset isn't undone on the next navigation back.
+ */
+export declare function useLastFilterState({ scopeId, storage, snapshotKeys, enabled }: UseLastFilterStateOptions): {
+    enabled: boolean;
+    clear: () => void;
+};
+export {};

package/dist/components/FilterBar/index.d.ts

@@ -1,3 +1,3 @@
 export { FilterBar } from './FilterBar';
 export { localStorageAdapter, storageKeys } from './utils/storage-adapter';
-export type { FilterBarProps, FilterFieldConfig, FilterFieldType, SelectFilterField, CheckboxMultipleFilterField, DateFilterField, DateRangeFilterField, ColumnConfig, ColumnPrefState, SavedView, FilterStorageAdapter } from './types';
+export type { FilterBarProps, FilterFieldConfig, FilterFieldType, SelectFilterField, CheckboxMultipleFilterField, DateFilterField, DateCompactFilterField, DateCompactOp, DateCompactValue, RelativeDirection, RelativePeriod, ColumnConfig, ColumnPrefState, SavedView, FilterStorageAdapter } from './types';

package/dist/components/FilterBar/types.d.ts

@@ -8,7 +8,7 @@ import { Pagination } from '../TableSection/types';
  * (`handleChangeFilter`, `getValuesFilter`, …) so the JSON-blob URL encoding
  * (`?filter={...}`) is reused as-is. `key` is the param name inside that blob.
  */
-export type FilterFieldType = 'date' | 'date-range' | 'dropdown' | 'dropdown-multiple' | 'checkbox-multiple' | 'radio';
+export type FilterFieldType = 'date' | 'date-compact' | 'dropdown' | 'dropdown-multiple' | 'checkbox-multiple' | 'radio';
 interface BaseFilterField {
     /** Stable key — used as the field name inside the `?filter` blob. */
     key: string;
@@ -49,10 +49,28 @@ export interface DateFilterField extends BaseFilterField {
     type: 'date';
     mode?: 'days' | 'months' | 'years';
 }
-export interface DateRangeFilterField extends BaseFilterField {
-    type: 'date-range';
+/** Compact date filter — operator + payload (date / range / relative / empty). */
+export type DateCompactOp = 'is' | 'is-before' | 'is-after' | 'is-on-or-before' | 'is-on-or-after' | 'is-between' | 'is-relative-to-today' | 'is-empty' | 'is-not-empty';
+export type RelativeDirection = 'past' | 'next' | 'this';
+export type RelativePeriod = 'day' | 'week' | 'month' | 'year';
+export interface DateCompactValue {
+    op: DateCompactOp;
+    /** ISO date — set for is / before / after / on-or-before / on-or-after. */
+    date?: string;
+    /** ISO date — set together with `to` when `op === 'is-between'`. */
+    from?: string;
+    to?: string;
+    /** Set when `op === 'is-relative-to-today'`. `count` is required for past/next. */
+    relative?: {
+        direction: RelativeDirection;
+        count?: number;
+        period: RelativePeriod;
+    };
+}
+export interface DateCompactFilterField extends BaseFilterField {
+    type: 'date-compact';
 }
-export type FilterFieldConfig = SelectFilterField | CheckboxMultipleFilterField | DateFilterField | DateRangeFilterField;
+export type FilterFieldConfig = SelectFilterField | CheckboxMultipleFilterField | DateFilterField | DateCompactFilterField;
 /** A single column entry fed to the Customize Column panel. */
 export interface ColumnConfig {
     key: string;
@@ -127,6 +145,12 @@ export interface FilterBarProps {
         enabled?: boolean;
         scopeId: string;
     };
+    /**
+     * Auto-restore the last applied filter state when the URL has no filter
+     * params (e.g. link-based back navigation). Requires `savedViews.scopeId`.
+     * Default `true`.
+     */
+    persistLastState?: boolean;
     /** Persistence adapter (default: localStorage via @starasia/storage). */
     storage?: FilterStorageAdapter;
     /** Called after a full reset (clears filters + search). */

package/dist/components/FilterBar/utils/storage-adapter.d.ts

@@ -12,4 +12,5 @@ export declare const localStorageAdapter: FilterStorageAdapter;
 export declare const storageKeys: {
     columns: (scopeId: string) => string;
     savedViews: (scopeId: string) => string;
+    lastState: (scopeId: string) => string;
 };