@cosmicdrift/kumiko-types 0.170.0 → 0.171.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.170.0",
+  "version": "0.171.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/fields.ts

@@ -112,6 +112,11 @@ export type PiiAnnotations = {
    *  text-Feldern MIT Subject-Annotation erlaubt (Boot-Validator).
    *  Siehe docs/plans/datenschutz/blind-index.md (kumiko-framework#818). */
   readonly lookupable?: true;
+  /** Foreign key into the `user` entity (authorId, assigneeId, ...) with no
+   *  annotated content of its own. Triggers no encryption — feeds only the
+   *  GDPR-hook-coverage boot guard, which otherwise can't see subject data
+   *  that lives purely in an FK column. */
+  readonly subjectRef?: boolean;
 };
 
 // --- Retention (DSGVO Art. 5(1)(e) + HGB/AO Aufbewahrungspflichten) ---

package/src/screen.ts

@@ -212,9 +212,11 @@ export type RowActionNavigate = {
    *  AUSSCHLIESSLICH aus dem Pfad. Default: "id" wenn der Ziel-Screen
    *  ein entityEdit ist. */
   readonly entityId?: string;
-  /** Deklarative URL-Search-Params aus row-Context. Wird in actionForm-
-   *  Targets als initial values gelesen (actionForm pre-fillen).
-   *  `pick` extrahiert Felder gleichen Namens; `map` benennt um. */
+  /** Declarative URL search params extracted from the clicked row.
+   *  Both actionForm and entityEdit-create targets read `params` as
+   *  initial values (pre-filling the form). entityEdit-update does
+   *  not — the existing record's values take precedence.
+   *  `pick` extracts fields of the same name; `map` renames them. */
   readonly params?: RowFieldExtractor;
   /** Conditional Visibility pro Row. */
   readonly visible?: FieldCondition;
@@ -513,6 +515,13 @@ export type EditFieldSpec =
       readonly readOnly?: FieldCondition;
       readonly required?: FieldCondition;
       readonly renderer?: FieldRenderer;
+      /** Prefix icon on the input — symbolic key into the FIELD_ICONS
+       *  registry (renderer-web), analogous to `ScreenNavSugar.icon`.
+       *  Unknown key → no icon (clean fallback, no boot-fail). Only takes
+       *  effect for `type: "text"` and `"number"` — other input kinds
+       *  (select, combobox, date, …) have no icon slot and silently
+       *  ignore the key. */
+      readonly icon?: string;
     };
 
 // A section is either a normal field-grid (default — `kind` omitted keeps
@@ -529,6 +538,12 @@ export type EditFieldsSection = {
    *  Überschrift) — für flache Forms (Card-Titel + Felder direkt, ein
    *  einzelner Abschnitt) wie bei den meisten shadcn-Form-Mustern. */
   readonly title?: string;
+  /** Optional help text under the block heading (i18n key or raw string,
+   *  like `title`) — makes a form usable without training instead of
+   *  falling back to custom JSX for help text. Renders through the same
+   *  `subtitle` slot as `FormProps.subtitle`. Works without `title` too
+   *  (subtitle-only section). */
+  readonly description?: string;
   readonly columns?: number;
   readonly fields: readonly EditFieldSpec[];
 };
@@ -539,8 +554,15 @@ export type EditExtensionSection = {
   readonly component: PlatformComponent;
 };
 
+// Max width of the form container (see FormScreenShell in renderer-web).
+export type FormWidth = "sm" | "3xl" | "4xl" | "full";
+
 export type EditLayout = {
   readonly sections: readonly EditSectionSpec[];
+  /** Default "3xl". "full" for dense multi-column masks (many sections,
+   *  three-column fields) that would leave dead space on both sides in a
+   *  3xl column — see #1676. */
+  readonly width?: FormWidth;
 };
 
 export type EntityEditScreenDefinition = {