@cosmicdrift/kumiko-framework 0.237.2 → 0.238.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.237.2",
+  "version": "0.238.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -198,7 +198,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-types": "0.237.2",
+    "@cosmicdrift/kumiko-types": "0.238.0",
     "bullmq": "^5.76.7",
     "bun-types": "^1.3.13",
     "hono": "^4.13.1",
@@ -214,7 +214,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.237.2",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.238.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

package/src/ui-types/index.ts

@@ -107,5 +107,13 @@ export type {
   QualifiedContentCollection,
   WorkspaceSchema,
 } from "./app-schema";
-export type { ListRowMetaColumnType, ListRowMetaReference } from "./list-row-meta";
-export { LIST_ROW_META_COLUMNS, LIST_ROW_META_REFERENCES } from "./list-row-meta";
+export type {
+  ListRowMetaColumnType,
+  ListRowMetaReference,
+  SystemReferenceLabel,
+} from "./list-row-meta";
+export {
+  LIST_ROW_META_COLUMNS,
+  LIST_ROW_META_REFERENCES,
+  SYSTEM_REFERENCE_LABELS,
+} from "./list-row-meta";

package/src/ui-types/list-row-meta.ts

@@ -12,6 +12,8 @@
 // deletedById) — this is also the SAME set the boot-validator's entityList
 // column checks accept, so a softDelete column stays a boot-time error
 // instead of a renderer-side throw (see screens.ts / entity-list-screens.ts).
+import { SYSTEM_TENANT_ID } from "../engine/types/identifiers";
+
 export type ListRowMetaColumnType = "text" | "number" | "timestamp";
 
 export const LIST_ROW_META_COLUMNS: Readonly<Record<string, ListRowMetaColumnType>> = {
@@ -39,3 +41,19 @@ export type ListRowMetaReference = {
 export const LIST_ROW_META_REFERENCES: Readonly<Record<string, ListRowMetaReference>> = {
   tenantId: { refFeature: "tenant", refEntity: "tenant", refLabelField: "name" },
 };
+
+export type SystemReferenceLabel = {
+  readonly id: string;
+  readonly labelKey: string;
+};
+
+// Reference ids that never resolve through the bulk id->row lookup because
+// no row exists for them (e.g. SYSTEM_TENANT_ID has no tenant record, see
+// isSystemTenant()) — every reference column falls back to the raw id
+// otherwise. Keyed by `${refFeature}:${refEntity}` so useReferenceLookup can
+// consult this generically instead of any screen/hook hardcoding an entity
+// name. Central so the label applies to every screen that references this
+// entity, not just delivery-log (fw#2662).
+export const SYSTEM_REFERENCE_LABELS: Readonly<Record<string, SystemReferenceLabel>> = {
+  "tenant:tenant": { id: SYSTEM_TENANT_ID, labelKey: "kumiko.reference.system-tenant" },
+};