@cosmicdrift/kumiko-types 0.330.0 → 0.331.0

package/dist/config.d.ts

@@ -44,6 +44,13 @@ export type ConfigKeyDefinition<T extends ConfigKeyType = ConfigKeyType> = {
      *  `encrypted` (kumiko-platform#231/#459). */
     readonly piiEncrypted?: boolean;
     readonly options?: readonly string[];
+    /** Only on `type: "select"`: loads the options from this query (QN), contract
+     *  `{ rows: { value, label }[] }`, labels shown verbatim. Mutually exclusive with
+     *  `options` and `allowPerRequest`. The write side does not check the value against
+     *  the query result; the consuming feature validates it where it uses it. */
+    readonly optionsQuery?: string;
+    /** Static payload sent with every `optionsQuery` call. Requires `optionsQuery`. */
+    readonly optionsQueryPayload?: Readonly<Record<string, string | number | boolean>>;
     readonly bounds?: ConfigBounds;
     readonly pattern?: {
         readonly regex: string;

package/dist/fields.d.ts

@@ -180,6 +180,13 @@ export type SelectFieldDef<TOptions extends readonly string[] = readonly string[
     readonly optionTones?: {
         readonly [K in TOptions[number]]?: SelectOptionTone;
     };
+    /** Loads the options from this query (QN). Contract: `{ rows: { value, label }[] }`,
+     *  labels are shown verbatim (not translated). `options` must be empty when set.
+     *  Only valid on configEdit/actionForm screen fields and config keys, not on entity
+     *  fields: the stored value would not be checked against the query result. */
+    readonly optionsQuery?: string;
+    /** Static payload sent with every `optionsQuery` call. */
+    readonly optionsQueryPayload?: Readonly<Record<string, string | number | boolean>>;
 } & ResolvedPiiFlags;
 export type MultiSelectFieldDef<TOptions extends readonly string[] = readonly string[]> = {
     readonly type: "multiSelect";

package/dist/screen.d.ts

@@ -314,6 +314,11 @@ export type RelatedListToolbarAction = (Extract<ToolbarAction, {
 }> & {
     readonly visible?: FieldCondition;
 });
+/** Expandable area of an `entityList` row: a relatedList of the row's record.
+ *  `id` (tab id) and `countField` (tab badge) have no meaning outside a tabs
+ *  layout and are therefore omitted. `kind` stays the discriminator so further
+ *  expansion kinds can be added without a breaking change. */
+export type EntityListExpandableRow = Omit<EditRelatedListSection, "id" | "countField">;
 export type EntityListScreenDefinition = {
     readonly id: string;
     readonly type: "entityList";
@@ -343,6 +348,11 @@ export type EntityListScreenDefinition = {
      *  etc. — neben "+ Neu" wenn vorhanden. Reihenfolge im Array = UI-
      *  Reihenfolge, primary-style links. */
     readonly toolbarActions?: readonly ToolbarAction[];
+    /** Expandable area under each row: a relatedList of the row's record
+     *  (parentId = the row's `id`). Rows get a toggle button; several rows can
+     *  be open at once. Its own row actions run against the sub-list rows, and
+     *  a successful write also reloads this list. */
+    readonly expandableRow?: EntityListExpandableRow;
     /** Server-side Filter, fest am Screen — drei Buckets derselben
      *  Entity ohne Custom-Pages (z.B. "Upcoming" / "Active" / "Past"
      *  Maintenance). User-side q-Search läuft AUF dem gefilterten Set
@@ -497,6 +507,8 @@ export type ProjectionDetailScreenDefinition = {
      *  app); exempts it from the nav-area boot check. */
     readonly dormant?: boolean;
     readonly query: string;
+    /** Query output field whose value titles the page header (breadcrumb) when no `header` is set. */
+    readonly recordTitleField?: 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
@@ -820,6 +832,13 @@ export type EditRelatedListSection = {
         readonly field: string;
     };
     readonly columns: readonly ListColumnSpec[];
+    /** Entity the query's rows belong to: an entity name (same feature) or
+     *  `feature:entity`. Columns that name one of its fields render like an
+     *  entityList column of that field (select as a status badge with the
+     *  translated option label, dates locale-formatted, default header from the
+     *  field's label key). The column's own `sortable` still decides the
+     *  header sort. Without it every column renders as plain text. */
+    readonly entity?: string;
     /** i18n key for the one-line hint at the left of the tab toolbar. */
     readonly description?: string;
     /** i18n key holding plural forms for the footer count ("1 Position",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.330.0",
+  "version": "0.331.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>",