@cosmicdrift/kumiko-types 0.239.0 → 0.241.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.239.0",
+  "version": "0.241.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",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/screen.ts

@@ -72,6 +72,8 @@ export interface FieldFormatRegistry {
   // Prefer fieldOptionLabelKeyPrefix() from @cosmicdrift/kumiko-headless
   // over hand-typed prefix strings.
   enumOption: { readonly keyPrefix: string };
+  /** JSON-safe structured value rendered as indented text. */
+  json: { readonly indent?: number };
 }
 
 // Discriminated union derived from the registry — one variant per key.
@@ -481,6 +483,18 @@ export type ProjectionDetailScreenDefinition = {
   readonly query: string;
   /** Query-payload key for the row-id. Default "id". */
   readonly idParam?: string;
+  /** The server determines the shown row from the caller's session/context
+   *  instead of a row id in the path — a self-service screen ("my profile",
+   *  "my data") that has no row to link to (unlike `EntityEditScreenDefinition.
+   *  singleton`, which still resolves via `<entity>:list` limit 1; here the
+   *  query itself owns the row selection, e.g. `user:query:user:me`). The
+   *  query is called WITHOUT the `idParam` key — there is no id to send, so
+   *  the boot-validator rejects declaring `idParam` alongside this flag
+   *  instead of letting one silently win. Stricter than an id-addressed
+   *  screen, not looser: the server picks the row, so no client-supplied id
+   *  can reach the query — a stray id on the path is ignored, never
+   *  forwarded. */
+  readonly singleton?: boolean;
   readonly layout: EditLayout;
   /** Optionaler per-Field-Label-i18n-Key (Field-Name → Key), analog zu
    *  entityEdit.fieldLabels. Die Pseudo-Entity `__projection-detail__` hat
@@ -529,6 +543,10 @@ export type DashboardStatPanel = {
   /** Anzeige-Text (i18n-Key). */
   readonly label: string;
   readonly query: string;
+  /** Static, author-set query parameters merged on top of the screen's
+   *  dynamic filterParams — lets a panel pin a value (e.g. a status facet)
+   *  the screen-wide filter doesn't cover, without needing its own query. */
+  readonly params?: Readonly<Record<string, unknown>>;
   readonly valueField: string;
   readonly subField?: string;
   readonly toneField?: string;
@@ -697,7 +715,11 @@ export type EditFieldSpec =
 // id, so a bundled feature (e.g. custom-fields) can load and persist its
 // own data inside the form. `relatedList` runs its own query instead —
 // see `EditRelatedListSection`.
-export type EditSectionSpec = EditFieldsSection | EditExtensionSection | EditRelatedListSection;
+export type EditSectionSpec =
+  | EditFieldsSection
+  | EditExtensionSection
+  | EditRelatedListSection
+  | EditWriteFormSection;
 
 export type EditFieldsSection = {
   /** Kebab-case tab id, used as the `?tab=` value. Required by the
@@ -766,6 +788,50 @@ export type EditRelatedListSection = {
    *  is named here. `idColumn` names the row key holding that id (default
    *  "id"). Omit `rowClick` for a non-interactive list. */
   readonly rowClick?: { readonly entity: string; readonly idColumn?: string };
+  /** Per-row actions — same type and dispatch semantics as `entityList`/
+   *  `projectionList`'s `rowActions` (writeHandler dispatch with a
+   *  declarative `payload` extractor, or navigate). A successful
+   *  writeHandler action re-runs this section's own query, same as a
+   *  projectionList row action re-running its list query. */
+  readonly rowActions?: readonly RowAction[];
+};
+
+// A declarative, self-persisting form section for `projectionDetail`
+// (fw editable-detail-screens). Unlike the plain `fields` section — which
+// projectionDetail forces read-only, see the type's own doc — this section's
+// fields ARE editable and submit through their own write-handler, entirely
+// independent of the (nonexistent) outer form submit. Modeled on
+// `ActionFormScreenDefinition`: `fieldDefs` carries the field-type map (a
+// projectionDetail's synthesized display entity has no real field types to
+// draw on), `fields` the rendered order/overrides, same as
+// `EditFieldsSection.fields`. Only supported on projectionDetail — the
+// boot-validator rejects it on entityEdit/configEdit/actionForm, same as
+// `relatedList`.
+export type EditWriteFormSection = {
+  /** Kebab-case tab id, used as the `?tab=` value. Required by the
+   *  boot-validator when the enclosing `EditLayout.mode` is "tabs". */
+  readonly id?: string;
+  readonly kind: "writeForm";
+  readonly title?: string;
+  readonly description?: string;
+  readonly columns?: number;
+  readonly icon?: IconKey;
+  /** Field-type map for this section's own form — same shape as
+   *  `ActionFormScreenDefinition.fields`. */
+  readonly fieldDefs: Readonly<Record<string, FieldDefinition>>;
+  /** Rendered fields, in order — same shape as `EditFieldsSection.fields`.
+   *  Every referenced field must have an entry in `fieldDefs`. */
+  readonly fields: readonly EditFieldSpec[];
+  /** Write-handler QN dispatched on submit. The submitted values (not a
+   *  diff) land 1:1 as payload, same as `ActionFormScreenDefinition.handler`.
+   *  The payload carries only this section's own fields — no parent/record
+   *  id is injected automatically. To thread the host record's id through,
+   *  declare it in `fieldDefs` with `visible: false` on its `fields` entry:
+   *  it gets prefilled from the loaded record like any other field and rides
+   *  along in the submit payload without being shown in the form. */
+  readonly handler: string;
+  /** i18n-key for the submit button. Default: "kumiko.actions.save". */
+  readonly submitLabel?: string;
 };
 
 // Max width of the form container (see FormScreenShell in renderer-web).