@cosmicdrift/kumiko-types 0.386.0 → 0.388.0

package/dist/list-aggregate-types.js

@@ -0,0 +1,19 @@
+import * as z from "zod";
+import { isPlainObject } from "./type-guards.js";
+export const MAX_LIST_AGGREGATE_MEASURES = 20;
+export const LIST_AGGREGATE_MEASURE_KINDS = ["sum", "avg", "count", "min", "max"];
+export const listAggregatePayloadSchema = z.object({
+    groupBy: z.string().optional(),
+    measures: z
+        .array(z.object({ field: z.string(), kind: z.enum(LIST_AGGREGATE_MEASURE_KINDS) }))
+        .max(MAX_LIST_AGGREGATE_MEASURES)
+        .default([]),
+});
+const LIST_AGGREGATE_RESULT_KEYS = ["groups", "truncated", "searchTruncated"];
+// Closed key set: a row that merely has a `groups` field (jsonb column) must not
+// be mistaken for an aggregate and skip the row-level read filter.
+export function isListAggregateResult(value) {
+    return (isPlainObject(value) &&
+        Array.isArray(value["groups"]) &&
+        Object.keys(value).every((key) => LIST_AGGREGATE_RESULT_KEYS.includes(key)));
+}

package/dist/screen-action-form.d.ts

@@ -55,7 +55,7 @@ export type ActionFormScreenDefinition = {
      *  validator).
      *
      *  A `money` field here must name its own currency source: this screen
-     *  has no entity whose `defaultCurrency` it could inherit (fw#2839). */
+     *  has no entity whose `defaultCurrency` it could inherit. */
     readonly fields: Readonly<Record<string, FormFieldDefinition>>;
     /** Fields computed from other fields, shown read-only and recomputed on every
      *  change. A `listSum` over an empty list without `whenEmpty` leaves the field
@@ -109,7 +109,7 @@ export type ActionFormScreenDefinition = {
      *  The object form additionally names the success-payload field the
      *  navigation id comes from (`ActionFormRedirect.idFrom`) — needed when
      *  the handler creates a child record but the target screen is the
-     *  parent's detail screen (fw#2670). */
+     *  parent's detail screen. */
     readonly redirect?: string | ActionFormRedirect;
     /** Links shown in the success box after a successful submit while the
      *  screen stays put. Targets resolve like `redirect` (the id comes from the
@@ -164,7 +164,7 @@ export type ActionFormFooterAction = {
  *  id. The write-handler reports the id of what it wrote (`data.id`); when
  *  that record is a child and the target screen shows its parent, the
  *  parent id has to be read from a different field instead of forcing the
- *  handler to misreport its own result (fw#2670). */
+ *  handler to misreport its own result. */
 export type ActionFormRedirect = {
     /** Same target forms as the string `redirect`: short screen ID
      *  (same-feature) or a fully-qualified cross-feature screen QN. */

package/dist/screen-custom-config.d.ts

@@ -21,14 +21,13 @@ export type CustomScreenDefinition = {
     readonly access?: AccessRule;
     /** This screen is registered without a self-owned `r.nav()` entry by
      *  design — an app opts in by navving it explicitly (e.g. a settings-area
-     *  self-service screen). `createKumikoApp`'s boot diagnostic
-     *  (kumiko-framework#2025) skips dormant screens instead of flagging
-     *  every consumer that doesn't mount the client plugin as a false
-     *  positive (kumiko-framework#2034). Only set this on screens the
-     *  feature itself never navs — a screen the feature DOES nav still needs
-     *  its client plugin mounted by every consumer, and should keep
-     *  triggering the diagnostic if it's missing. Also gates the
-     *  boot-validator's nav-area check, same as `dormant` on other screens. */
+     *  self-service screen). `createKumikoApp`'s boot diagnostic skips dormant
+     *  screens instead of flagging every consumer that doesn't mount the client
+     *  plugin as a false positive. Only set this on screens the feature itself
+     *  never navs — a screen the feature DOES nav still needs its client plugin
+     *  mounted by every consumer, and should keep triggering the diagnostic if
+     *  it's missing. Also gates the boot-validator's nav-area check, same as
+     *  `dormant` on other screens. */
     readonly dormant?: boolean;
     /** UI-only gate, also on direct URL access; handlers still enforce access. Unmet or failed renders `fallback`. */
     readonly visibleWhen?: DashboardPanelVisibility;

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

@@ -149,7 +149,7 @@ export type EditExtensionSection = {
      *  surrounding form's Save button should activate for its dirty state.
      *  Omit/false for extensions that persist through their own dispatcher
      *  writes (e.g. notes-history NotesSection) — otherwise a read-only form
-     *  shows a Save button that does nothing (fw#2359). */
+     *  shows a Save button that does nothing. */
     readonly contributesToFormSubmit?: boolean;
     /** Overrides the host-derived entity name passed to the mounted component.
      *  Required on `projectionDetail` (which has no real entity — the host

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

@@ -105,7 +105,7 @@ export type RowActionWriteHandler = {
     readonly kind?: "writeHandler";
     /** Stable id per screen — kebab-case, unique within the action set. */
     readonly id: string;
-    /** Anzeige-Text (i18n-Key). */
+    /** Display text (i18n key). */
     readonly label: string;
     /** Qualified name of the server handler, e.g.
      *  "publicstatus:write:maintenance:start". Dispatched via
@@ -188,7 +188,7 @@ export type RowActionNavigate = RowActionNavigateBase & ({
     readonly screen: string;
     readonly entity?: never;
 } | {
-    /** Entity name instead of screen id (fw#2228) — resolves at boot time to
+    /** Entity name instead of screen id — resolves at boot time to
      *  the screen that declares `detailFor: "<entity>"` (see ObjectTarget/
      *  resolveTarget in @cosmicdrift/kumiko-renderer's nav.tsx). */
     readonly entity: string;

package/dist/screen-projection.d.ts

@@ -86,7 +86,7 @@ export type ProjectionListScreenDefinition = {
      *  param present). Same type serves author and wire schema (no separate
      *  client-facing screen type exists), so this stays structurally
      *  writable — validateProjectionListScreens rejects any hand-authored
-     *  value at boot (fw#2165). */
+     *  value at boot. */
     readonly sortable?: boolean;
     /** Derived by buildAppSchema from the query handler's Zod schema (`cursor`
      *  or `offset` param present). See `sortable` doc for why this is
@@ -212,6 +212,6 @@ export type ProjectionDetailScreenDefinition = {
     /** How head fields render. Default "text" — plain text instead of a
      *  disabled Input, since every field on this screen type is forced
      *  readOnly anyway (there is no write path, see the shim doc above).
-     *  Set "form" to opt back into the disabled-Input look (fw#2245). */
+     *  Set "form" to opt back into the disabled-Input look. */
     readonly valueDisplay?: "form" | "text";
 };

package/dist/screen.d.ts

@@ -91,7 +91,7 @@ export type ScreenSlots = {
     readonly sidebar?: PlatformComponent;
     readonly footer?: PlatformComponent;
     /** entityEdit wizard: marks `footer` as the sticky-footer primary action
-     *  (fw#1918's pinned `max-sm:fixed` group on mobile) instead of the
+     *  (pinned `max-sm:fixed` group on mobile) instead of the
      *  non-sticky secondary bucket it falls into by default alongside
      *  Back/Cancel. Set this when `footer` renders the screen's actual
      *  submit-type action (e.g. a custom "Publish" button standing in for, or

package/dist/step.d.ts

@@ -39,7 +39,7 @@ export type PipelineCtx<TPayload = unknown, TMap extends object = KumikoEventTyp
          */
         readonly retryAttempt?: number;
         /**
-         * Q7 Snapshot-at-Start fingerprint of the workflow definition that
+         * Snapshot-at-Start fingerprint of the workflow definition that
          * started this run. Propagated into every suspension event payload so
          * the resume-loop can detect library-upgrades that changed the closure
          * source and surface them as a typed failure instead of running a

package/dist/target-ref.js

@@ -1,16 +1,13 @@
-// TargetRef — runtime-Repräsentation eines typed buildTarget-Outputs.
-// Wird vom Visual-Tree-Component (renderer/web) an einen Target-Resolver
-// dispatcht; der Resolver findet die Editor-Maske via featureId.
+// TargetRef — runtime representation of a typed buildTarget output.
+// It is dispatched by the Visual Tree component (renderer/web) to a target
+// resolver, which finds the editor form via featureId.
 //
-// **Compile-time-Safety:** TargetRef wird niemals hand-getippt. Stattdessen
-// erzeugt der typed buildTarget-Builder (engine/build-target.ts) einen
-// TargetRef, dessen action + args gegen die treeActions-Map des Ziel-
-// Features validiert sind.
+// **Compile-time safety:** TargetRef is never written by hand. Instead, the
+// typed buildTarget builder (engine/build-target.ts) creates a TargetRef whose
+// action + args are validated against the target feature's treeActions map.
 //
-// **Runtime:** args sind hier untyped (Record<string, unknown>), weil
-// TargetRef die erased-runtime-Version ist. Der Resolver kennt das
-// Ziel-Feature und kann args entsprechend casten — ähnlich wie Event-
-// Payloads im Event-Store.
-//
-// Siehe docs/plans/architecture/visual-tree.md A5.
+// **Runtime:** args are untyped here (Record<string, unknown>) because
+// TargetRef is the erased runtime version. The resolver knows the target
+// feature and can cast args accordingly, similar to event payloads in the
+// event store.
 export {};

package/dist/tree-node.js

@@ -1,22 +1,22 @@
-// TreeNode — single Knoten im Client-navProvider-Tree. Provider liefern
-// entweder statische readonly TreeNode[] oder dynamische TreeChildrenSubscribe.
+// TreeNode — a single node in the client nav-provider tree. Providers return
+// either static readonly TreeNode[] or dynamic TreeChildrenSubscribe.
 //
-// **Mental-Modell** (VS-Code-Explorer):
+// **Mental model** (VS Code Explorer):
 //   [icon] [label] [...hover-actions]
-// optional ein target zum Klicken (öffnet Editor-Maske via
-// Target-Resolver) und optional children als nested tree.
+// An optional target makes the node clickable (opening an editor form via
+// the target resolver), and optional children form a nested tree.
 //
-// **State** markiert Visual-Modus für Skeleton-Pattern:
-//   - "filled" (default) — schwarz, Knoten hat Inhalt
-//   - "stub" — hellgrau, existing aber leer (Designer-Stub-File)
-//   - "empty" — Platzhalter für "+ create"-Affordance
-//   - "loading" — Children werden gerade aufgelöst
-//   - "error" — Provider hat Fehler emittiert
-// Provider die kein Skeleton-Pattern brauchen müssen state nicht setzen.
+// **State** selects the visual mode for the skeleton pattern:
+//   - "filled" (default) — black; the node has content
+//   - "stub" — light gray; existing but empty (designer stub file)
+//   - "empty" — placeholder for the "+ create" affordance
+//   - "loading" — children are currently being resolved
+//   - "error" — the provider emitted an error
+// Providers that do not need the skeleton pattern can omit state.
 //
-// **Subscribe-Form** für dynamic Children: Provider erhält emit(),
-// gibt unsubscribe() zurück. Initial-Emit synchron oder async, weitere
-// Emits beliebig oft (z.B. wenn Entity-Row neu erscheint via SSE).
-// Spielt natürlich mit existing SSE-Frame: ein Provider kann intern
-// auf Entity-Update-Events abonnieren und bei Änderung emit() aufrufen.
+// **Subscribe form** for dynamic children: the provider receives emit()
+// and returns unsubscribe(). The initial emit may be synchronous or async;
+// further emits may occur arbitrarily often (for example, when an entity row
+// appears through SSE). This works with the existing SSE frame: a provider
+// can subscribe internally to entity-update events and call emit() on change.
 export {};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.386.0",
+  "version": "0.388.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": "BUSL-1.1",
+  "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
   "repository": {
     "type": "git",
@@ -154,6 +154,10 @@
       "types": "./dist/aggregate-types.d.ts",
       "default": "./dist/aggregate-types.js"
     },
+    "./list-aggregate-types": {
+      "types": "./dist/list-aggregate-types.d.ts",
+      "default": "./dist/list-aggregate-types.js"
+    },
     "./tenant-db-types": {
       "types": "./dist/tenant-db-types.d.ts",
       "default": "./dist/tenant-db-types.js"
@@ -281,7 +285,7 @@
   },
   "devDependencies": {
     "hono": "^4.13.1",
-    "postgres": "npm:@bender0oo0/postgres@3.4.9-kumiko.1",
+    "postgres": "npm:@bender0oo0/postgres@3.4.9-kumiko.2",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3",
     "ioredis": "^5.10.1"
@@ -433,6 +437,10 @@
         "types": "./dist/aggregate-types.d.ts",
         "default": "./dist/aggregate-types.js"
       },
+      "./list-aggregate-types": {
+        "types": "./dist/list-aggregate-types.d.ts",
+        "default": "./dist/list-aggregate-types.js"
+      },
       "./tenant-db-types": {
         "types": "./dist/tenant-db-types.d.ts",
         "default": "./dist/tenant-db-types.js"