@cosmicdrift/kumiko-renderer 0.290.0 → 0.292.0

package/src/hooks/use-list-url-state.ts

@@ -48,6 +48,14 @@ export type ListUrlStateApi = ListUrlState & {
   readonly setFilter: (field: string, values: readonly string[]) => void;
   /** Löscht alle aktiven Faceted-Filter (Reset-Button). */
   readonly clearFilters: () => void;
+  /** Sets both bounds of a dateRange facet in ONE params update — two
+   *  setFilter calls would overwrite each other, since the second still sees
+   *  the old searchParams. An empty string clears that bound. Resets the page
+   *  like setFilter. */
+  readonly setDateRange: (
+    field: string,
+    next: { readonly from: string; readonly to: string },
+  ) => void;
 };
 
 // `.` als Trenner: lesbar (`?orders.sort=name`), kollidiert nicht mit
@@ -142,11 +150,22 @@ export function useListUrlState(screenId: string): ListUrlStateApi {
     [nav, screenId],
   );
 
+  const setDateRange = useCallback(
+    (field: string, next: { readonly from: string; readonly to: string }) => {
+      nav.setSearchParams({
+        [key(screenId, `f.${field}.from`)]: next.from === "" ? null : next.from,
+        [key(screenId, `f.${field}.to`)]: next.to === "" ? null : next.to,
+        [key(screenId, "page")]: null,
+      });
+    },
+    [nav, screenId],
+  );
+
   const clearFilters = useCallback(() => {
     const updates: Record<string, string | null> = { [key(screenId, "page")]: null };
     for (const field of Object.keys(filters)) updates[key(screenId, `f.${field}`)] = null;
     nav.setSearchParams(updates);
   }, [nav, screenId, filters]);
 
-  return { sort, q, page, filters, setSort, setQ, setPage, setFilter, clearFilters };
+  return { sort, q, page, filters, setSort, setQ, setPage, setFilter, clearFilters, setDateRange };
 }

package/src/i18n-defaults.ts

@@ -67,6 +67,7 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.list.related-list-truncated":
       "Showing the first {count} entries. More are available but not loaded — this list does not paginate.",
     "kumiko.reference.system-tenant": "System",
+    "kumiko.reference.system-user": "System",
 
     "kumiko.pager.status": "{from}–{to} of {total}",
     "kumiko.pager.previousPage": "Previous page",

package/src/i18n.tsx

@@ -205,6 +205,17 @@ export function useOptionalLocale(): string | undefined {
   return ctx === undefined ? undefined : ctx.resolver.locale();
 }
 
+/** Non-throwing time-zone read — "UTC" outside LocaleProvider, matching
+ *  createStaticLocaleResolver's own default. */
+export function useOptionalTimeZone(): string {
+  const ctx = useContext(LocaleContext);
+  return useSyncExternalStore(
+    (onStoreChange) => (ctx ? ctx.resolver.subscribe(onStoreChange) : () => {}),
+    () => (ctx ? ctx.resolver.timeZone() : "UTC"),
+    () => (ctx ? ctx.resolver.timeZone() : "UTC"),
+  );
+}
+
 /** Non-throwing translate — undefined outside LocaleProvider. */
 export function useOptionalTranslation():
   | ((key: string, params?: Readonly<Record<string, unknown>>) => string)

package/src/index.ts

@@ -64,6 +64,13 @@ export type {
 export { isAppSchema, toAppSchema } from "./app/feature-schema";
 export type { KumikoScreenProps } from "./app/kumiko-screen";
 export { KumikoScreen, qualifyNavId, qualifyScreenId } from "./app/kumiko-screen";
+export type { DateRangeBound, DateRangeValue, ResolvedDateRangeFacet } from "./app/list-facets";
+export {
+  buildDateRangePayload,
+  clampDateRange,
+  readDateRange,
+  resolveDateRangeFacets,
+} from "./app/list-facets";
 export type {
   NavApi,
   NavProviderProps,
@@ -82,12 +89,15 @@ export {
   useNavigateWithInitialValues,
 } from "./app/nav";
 export { lastSegment } from "./app/qn";
-export type { ReturnHost } from "./app/return-to";
+export type { ReturnHost, ReturnTo } from "./app/return-to";
 export {
+  navigateToReturn,
+  navigateToReturnOr,
   navigateWithReturnTo,
   RETURN_TO_PARAM,
   ReturnHostProvider,
   resolveReturnTarget,
+  splitReturnTo,
   useReturnHost,
   useReturnTarget,
 } from "./app/return-to";
@@ -185,6 +195,7 @@ export type {
   CardProps,
   CardSlots,
   CorePrimitives,
+  DataTableDateRangeFacet,
   DataTableFacet,
   DataTableProps,
   DataTableRowAction,

package/src/primitives.tsx

@@ -572,6 +572,18 @@ export type DataTableFacet = {
   readonly options: readonly { readonly value: string; readonly label: string }[];
 };
 
+// Time-range filter slot in the toolbar (fw#3104): two date inputs
+// (from/to) instead of an options dropdown. Values are `YYYY-MM-DD` or ""
+// (bound open) — the caller converts them into query params.
+export type DataTableDateRangeFacet = {
+  /** The facet's namespace (its date field) — a key, not a filter value. */
+  readonly field: string;
+  /** Translated label ("When"). */
+  readonly label: string;
+  readonly from: string;
+  readonly to: string;
+};
+
 export type DataTableProps = {
   readonly columns: readonly ListColumnViewModel[];
   readonly rows: readonly ListRowViewModel[];
@@ -622,6 +634,10 @@ export type DataTableProps = {
   /** Reset-Button: löscht alle aktiven Facets. Renderer zeigt ihn nur
    *  wenn mindestens ein Facet aktiv ist. */
   readonly onFilterReset?: () => void;
+  /** Time-range filters beside the facet dropdowns (fw#3104). */
+  readonly dateRangeFacets?: readonly DataTableDateRangeFacet[];
+  /** One bound changed ("" clears it) → caller writes URL state + refetch. */
+  readonly onDateRangeChange?: (field: string, bound: "from" | "to", value: string) => void;
   /** Pagination-State + Callback. Wenn gesetzt, rendert der Renderer
    *  einen Pager unter der Tabelle (Web: Footer-Bar mit ← 1 ... N →).
    *  total/limit/page sind 1-basiert für die UI; Server-Translation