@cosmicdrift/kumiko-types 0.402.0 → 0.404.0

package/dist/config.d.ts

@@ -148,6 +148,8 @@ export type JobTrigger = {
 } | {
     readonly cron: string;
     readonly tz?: string;
+} | {
+    readonly maintenance: true;
 } | {
     readonly manual: true;
 };

package/dist/fields.d.ts

@@ -5,6 +5,7 @@ export type { EmbeddedDerivedCellDef, EmbeddedFilesSubFieldProps, EmbeddedImages
 import type { ParentRefDef, ReadGateDef } from "./entity-row-visibility.ts";
 import type { DerivedFieldsMap } from "./fields-derived.ts";
 import type { EventUpcastCtx } from "./handlers.ts";
+import type { NamedListFilterDef } from "./named-list-filters.ts";
 import type { OwnershipMap } from "./ownership.ts";
 import type { EntityTenancy } from "./tenancy-brand.ts";
 export type { ClientDerivedFieldDef, DeriveContext, DerivedCondition, DerivedConditionValue, DerivedFieldDef, DerivedFieldsMap, DerivedRelatedMeasure, DerivedSqlSpec, DerivedValueType, JsDerivedFieldDef, SqlDerivedFieldDef, } from "./fields-derived.ts";
@@ -854,6 +855,8 @@ export type EntityDefinition<F extends FieldsMap = FieldsMap, T extends EntityTe
      * nameable as a column in a declarative `entityList`. See DerivedFieldDef.
      */
     readonly derivedFields?: DerivedFieldsMap;
+    /** Named work-queue rules keyed by id, selected via `namedFilter`; function-valued, never in the client schema. */
+    readonly namedFilters?: Readonly<Record<string, NamedListFilterDef>>;
     /** Optional free-text semantics for the AI agent manifest — see TextFieldDef.description. */
     readonly description?: string;
     /** Opts the rows into `tenant-handover`, a grant-legitimated move from an anonymous tenant to the

package/dist/named-list-filters.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="temporal-polyfill/global" preserve="true" />
+import type { AccessRule, HandlerContext, SessionUser } from "./handlers.ts";
+export type NamedListFilterOp = "eq" | "ne" | "lt" | "gt" | "lte" | "gte" | "in";
+export type NamedListFilterCondition = {
+    readonly field: string;
+    readonly op: NamedListFilterOp;
+    readonly value: unknown;
+};
+export type NamedListFilterScope = {
+    readonly ctx: HandlerContext;
+    readonly user: SessionUser;
+    readonly now: Temporal.Instant;
+};
+/** A work-queue rule defined once on the entity: the list and every count query resolve the same conditions. */
+export type NamedListFilterDef = {
+    readonly access?: AccessRule;
+    readonly filters: (scope: NamedListFilterScope) => readonly NamedListFilterCondition[] | Promise<readonly NamedListFilterCondition[]>;
+};
+/** Screen-side reference to an entity-defined named filter; `label` is an i18n key. */
+export type NamedListFilterRef = {
+    readonly id: string;
+    readonly label: string;
+};

package/dist/named-list-filters.js

@@ -0,0 +1 @@
+export {};

package/dist/screen-dashboard.d.ts

@@ -104,6 +104,13 @@ export type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate
      *  An accent that should change with the result (e.g. by sign) goes through
      *  `toneField`; leave `accentColor` unset then. */
     readonly accentColor?: string;
+    /** Makes the tile a link to a list screen (qualified screen id). Count tiles use the
+     *  list's own query with `params.namedFilter`; the boot validator pins that the tile and
+     *  the target list select the same rows. The click sets `<screenId>.filter`. */
+    readonly navigate?: {
+        readonly screen: string;
+        readonly namedFilter?: string;
+    };
 };
 export type DashboardChartKind = "timeseries" | "stacked-bars" | "segment-bars" | "stacked-area";
 export type DashboardChartTone = "positive" | "negative" | "active" | "neutral";

package/dist/screen-entity-list.d.ts

@@ -1,5 +1,6 @@
 import type { FieldCondition } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
+import type { NamedListFilterRef } from "./named-list-filters.ts";
 import type { IconKey } from "./nav-icon.ts";
 import type { FieldRenderer, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { ActionFormRedirect } from "./screen-action-form.ts";
@@ -446,6 +447,10 @@ export type EntityListScreenDefinition = {
      *  through `defaultFilters` and the URL). Fields without an entry keep the
      *  default dropdown. */
     readonly facets?: Readonly<Record<string, EntityListFacetConfig | false>>;
+    /** Named work-queue rules offered on this list: ids declared in `EntityDefinition.namedFilters`,
+     *  `label` an i18n key. Selected through the `<screenId>.filter` URL key; a dashboard stat's
+     *  `navigate.namedFilter` links here. While one is active `defaultFilters` are not applied. */
+    readonly namedFilters?: readonly NamedListFilterRef[];
     /** Replaces the default empty-list title/hint; the create button stays when the list can create. */
     readonly emptyState?: ListEmptyStateSpec;
     /** i18n key for the primary create button label (default `kumiko.actions.create`). */

package/dist/screen-projection.d.ts

@@ -1,5 +1,6 @@
 import type { SelectOptionTone } from "./fields.ts";
 import type { AccessRule, AgentScreenHints } from "./handlers.ts";
+import type { NamedListFilterRef } from "./named-list-filters.ts";
 import type { NavIconKey } from "./nav-icon.ts";
 import type { FormatSpec, PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts";
 import type { DashboardStatTone, ScreenVisibility } from "./screen-dashboard.ts";
@@ -112,6 +113,9 @@ export type ProjectionListScreenDefinition = {
      *  "dateRange" facet instead needs its two `params` keys in that schema;
      *  it sends no `filters` entry. */
     readonly facets?: readonly ListFacetSpec[];
+    /** Named work-queue rules the bound query understands: its Zod schema must have a
+     *  `namedFilter` key (boot-checked) and is sent the selected id in every list and count query. */
+    readonly namedFilters?: readonly NamedListFilterRef[];
     readonly slots?: ScreenSlots;
     readonly access?: AccessRule;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.402.0",
+  "version": "0.404.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -202,6 +202,10 @@
       "types": "./dist/hooks.d.ts",
       "default": "./dist/hooks.js"
     },
+    "./named-list-filters": {
+      "types": "./dist/named-list-filters.d.ts",
+      "default": "./dist/named-list-filters.js"
+    },
     "./nav": {
       "types": "./dist/nav.d.ts",
       "default": "./dist/nav.js"
@@ -501,6 +505,10 @@
         "types": "./dist/hooks.d.ts",
         "default": "./dist/hooks.js"
       },
+      "./named-list-filters": {
+        "types": "./dist/named-list-filters.d.ts",
+        "default": "./dist/named-list-filters.js"
+      },
       "./nav": {
         "types": "./dist/nav.d.ts",
         "default": "./dist/nav.js"

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.404.0",
+    "type": "improvement",
+    "title": "JobTrigger gains { maintenance: true }",
+    "detail": "A job with trigger { maintenance: true } runs once a day at the maintenance window of the app. Prefer it over a fixed cron for housekeeping; the window can be set per app."
+  },
   {
     "version": "0.392.0",
     "type": "improvement",