@cosmicdrift/kumiko-types 0.237.2 → 0.239.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.237.2",
+  "version": "0.239.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/event-store-executor-types.ts

@@ -1,4 +1,5 @@
 import type { CursorResult } from "./cursor-types";
+import type { EntityDefinition } from "./fields";
 import type { SessionUser, WriteResult } from "./handlers";
 import type { DeleteContext, SaveContext } from "./hooks";
 import type { EntityId } from "./identifiers";
@@ -93,6 +94,21 @@ export type EventStoreExecutor = {
       // — includeDeleted only relaxes the soft-delete predicate, never the
       // visibility ones, so it can ride untrusted query input safely.
       readonly includeDeleted?: boolean;
+      // fw#2660 — a text search also matches `searchable: true` reference
+      // fields (and the implicit tenantId→tenant.name row-meta reference) by
+      // their target row's labelField, not just the raw FK column. Only
+      // available at request time (registry access), so it rides the same
+      // runtime-override extension point as searchAdapter. `fields` and
+      // `resolveEntity` travel together — one without the other silently
+      // no-ops, so they're grouped instead of two independent optionals.
+      readonly referenceSearch?: {
+        readonly fields: ReadonlyArray<{
+          readonly fieldName: string;
+          readonly targetEntityName: string;
+          readonly labelField: string;
+        }>;
+        readonly resolveEntity: (entityName: string) => EntityDefinition | undefined;
+      };
     },
   ) => Promise<CursorResult<Record<string, unknown>>>;
 

package/src/feature.ts

@@ -883,7 +883,11 @@ export type Registry = {
   getSearchableFields(entityName: string): readonly string[];
   getSortableFields(entityName: string): readonly string[];
   getRelations(entityName: string): EntityRelations;
-  getSearchIncludes(entityName: string): ReadonlyMap<string, readonly string[]>;
+  getSearchableReferences(entityName: string): ReadonlyArray<{
+    fieldName: string;
+    targetEntityName: string;
+    labelField: string;
+  }>;
   getIncomingRelations(entityName: string): ReadonlyArray<{
     sourceEntity: string;
     relationName: string;

package/src/fields.ts

@@ -471,6 +471,12 @@ export type ReferenceFieldDef = {
    *  statt single UUID. Storage als jsonb-Array<uuid>. UI rendert
    *  Multi-Select-Combobox mit Tag-Anzeige der gewählten Items. */
   readonly multiple?: boolean;
+  /** Include a row in this entity's result set on a text-search hit against
+   *  the referenced entity's `labelField`, instead of only matching the UUID
+   *  column itself (fw#2660). Requires an explicit `labelField` — the boot
+   *  validator rejects it otherwise, since the default "id" is a UUID column
+   *  and ILIKE against it would crash at runtime. */
+  readonly searchable?: true;
 } & ResolvedPiiFlags;
 
 // --- Currency ---

package/src/relations.ts

@@ -9,7 +9,6 @@ export type BelongsToRelation = {
   readonly type: "belongsTo";
   readonly target: string;
   readonly foreignKey: string;
-  readonly searchInclude?: readonly string[];
   // onDelete is declared on the parent-side (hasMany / manyToMany) because
   // that's where the "what happens to my children?" decision lives. A
   // belongsTo node just points at a parent — the parent's onDelete drives
@@ -45,7 +44,6 @@ export type ManyToManyRelation = {
     readonly sourceKey: string;
     readonly targetKey: string;
   };
-  readonly searchInclude?: readonly string[];
   readonly onDelete?: OnDeleteStrategy;
 };
 

package/src/screen.ts

@@ -117,6 +117,17 @@ export type ListColumnSpec =
        *  label; without one it is rejected at boot as an unknown field. `field`
        *  is then just a stable column key (pick any unique slug). */
       readonly label?: string;
+      /** Marks this column as a reference lookup instead of a plain value —
+       *  for projectionList/relatedList columns, which have no
+       *  `EntityDefinition` to carry a real `reference` field type. Same
+       *  target convention as `parseRefTarget`: an entity name (same
+       *  feature) or `feature:entity` (cross-feature). Ignored on
+       *  `entityList` columns, where the field's own declared type always
+       *  wins. */
+      readonly refEntity?: string;
+      /** Row field on the referenced entity shown as the label (default
+       *  "id"). Only meaningful together with `refEntity`. */
+      readonly refLabelField?: string;
     };
 
 // Pagination-Modi für entityList:
@@ -665,6 +676,17 @@ export type EditFieldSpec =
        *  `multiline` routes to a textarea (no icon slot), and other input
        *  kinds (select, combobox, date, …) silently ignore the key. */
       readonly icon?: FieldIconKey;
+      /** Marks this field as a reference lookup instead of a plain value —
+       *  for projectionDetail fields, which have no `EntityDefinition` to
+       *  carry a real `reference` field type. Same target convention as
+       *  `parseRefTarget` (and `ListColumnSpec.refEntity`): an entity name
+       *  (same feature) or `feature:entity` (cross-feature). Ignored on
+       *  `entityEdit` fields, where the field's own declared type always
+       *  wins. */
+      readonly refEntity?: string;
+      /** Row field on the referenced entity shown as the label (default
+       *  "id"). Only meaningful together with `refEntity`. */
+      readonly refLabelField?: string;
     };
 
 // A section is a normal field-grid (default — `kind` omitted keeps every