@cosmicdrift/kumiko-types 0.330.2 → 0.332.0

package/dist/config.d.ts

@@ -7,6 +7,7 @@ import type { EscapeHatchDeclaration, JobContext } from "./handlers.js";
 import type { PostDeleteHookFn, PostSaveHookFn, PreDeleteHookFn, PreQueryHookFn, PreSaveHookFn } from "./hooks.js";
 import type { TenantId } from "./identifiers.js";
 import type { NavIconKey } from "./nav-icon.js";
+import type { DashboardCustomPanel, DashboardScreenPanel } from "./screen.js";
 import type { TenantDb } from "./tenant-db-types.js";
 export type ConfigKeyAccess = {
     readonly read: readonly string[];
@@ -44,6 +45,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;
@@ -206,9 +214,11 @@ export type RegistrarExtensionRegistration = {
     readonly options?: Record<string, unknown> | undefined;
     readonly featureName?: string;
 };
+export type ExtensionSelectorPanel = DashboardCustomPanel | Omit<DashboardScreenPanel, "label">;
 export type ExtensionSelectorDef = {
     readonly extensionName: string;
     readonly qualifiedKey: string;
+    readonly panels?: readonly ExtensionSelectorPanel[];
 };
 export type ReferenceDataDef = {
     readonly entityName: string;

package/dist/feature.d.ts

@@ -1,6 +1,6 @@
 import type * as z from "zod";
 import type { ZodType } from "zod";
-import type { ConfigKeyDefinition, ConfigKeyHandle, ConfigKeyType, ConfigSeedDef, ExtensionSelectorDef, JobDefinition, JobHandlerFn, NotificationDataFn, NotificationDefinition, NotificationRecipientFn, NotificationTemplateFn, ReferenceDataDef, RegistrarExtensionDef, RegistrarExtensionRegistration, TranslationKeys, TranslationsDef } from "./config.js";
+import type { ConfigKeyDefinition, ConfigKeyHandle, ConfigKeyType, ConfigSeedDef, ExtensionSelectorDef, ExtensionSelectorPanel, JobDefinition, JobHandlerFn, NotificationDataFn, NotificationDefinition, NotificationRecipientFn, NotificationTemplateFn, ReferenceDataDef, RegistrarExtensionDef, RegistrarExtensionRegistration, TranslationKeys, TranslationsDef } from "./config.js";
 import type { QueryHandlerDefinition, StreamHandlerDefinition, WriteHandlerDefinition } from "./define-handler.js";
 import type { RegisterEntityCrudOptions } from "./entity-handlers.js";
 import type { EntityTableMeta } from "./entity-table-meta-types.js";
@@ -327,11 +327,15 @@ export type FeatureRegistrar<TFeature extends string = string> = {
      * Settings-Hub render one tenant dashboard for the owner: the selector as a
      * select of the mounted plugin ids, the selected plugin's config and secrets
      * as panels, and plugin features lose their own tenant nav. `config:write:set`
-     * rejects unknown plugin ids (`""` clears).
+     * rejects unknown plugin ids (`""` clears). `options.panels` adds the owner's own
+     * `custom`/`screen` panels to that dashboard, after the selection and before the
+     * plugin panels (a short `screen` id means a screen of the declaring feature).
      */
     extensionSelector(extensionName: string, key: {
         readonly name: string;
-    } | string): void;
+    } | string, options?: {
+        readonly panels?: readonly ExtensionSelectorPanel[];
+    }): void;
     /**
      * Marker-Deklaration: dieses Feature stellt eine Cross-Feature-API
      * unter dem genannten Namen bereit. Die eigentliche Implementation
@@ -489,6 +493,7 @@ export type Registry = {
     getExtension(name: string): RegistrarExtensionDef | undefined;
     getExtensionUsages(extensionName: string): readonly RegistrarExtensionRegistration[];
     getAllExtensionSelectors(): ReadonlyMap<string, string>;
+    getExtensionSelectorPanels(extensionName: string): readonly ExtensionSelectorPanel[];
     getAllNotifications(): ReadonlyMap<string, NotificationDefinition>;
     getAllReferenceData(): readonly ReferenceDataDef[];
     getProjectionsForSource(entityName: string): readonly ProjectionDefinition[];

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/nav-icon.d.ts

@@ -1,3 +1,3 @@
-export declare const NAV_ICON_KEYS: readonly ["dashboard", "layout-grid", "book-open", "clipboard-list", "package", "gauge", "list", "table", "layers", "building", "calculator", "wallet", "coins", "credit-card", "piggy-bank", "receipt", "chart", "bar-chart", "trending", "sparkles", "wand", "calendar", "file", "folder", "folder-open", "home", "bell", "shield", "shield-check", "send", "settings", "users", "user", "search", "tag", "key", "link", "palette", "share", "server", "mail", "lock", "hash", "download", "upload", "rocket", "plus", "languages", "trash", "x", "check", "arrow-left", "arrow-right", "copy", "pencil", "eye", "eye-off", "filter", "refresh", "more-horizontal", "more-vertical", "external-link", "chevron-down", "chevron-left", "chevron-right", "save", "undo", "archive", "star", "flag", "clock", "map-pin", "phone", "printer", "alert-triangle", "info", "check-circle", "x-circle", "loader", "mic", "circle-stop", "image", "camera", "headphones"];
+export declare const NAV_ICON_KEYS: readonly ["dashboard", "layout-grid", "book-open", "clipboard-list", "package", "gauge", "list", "table", "layers", "building", "calculator", "wallet", "coins", "credit-card", "piggy-bank", "receipt", "chart", "bar-chart", "trending", "sparkles", "wand", "calendar", "file", "folder", "folder-open", "home", "bell", "shield", "shield-check", "send", "settings", "users", "user", "search", "tag", "key", "link", "palette", "share", "server", "mail", "lock", "hash", "download", "upload", "rocket", "plus", "languages", "trash", "x", "check", "arrow-left", "arrow-right", "copy", "pencil", "eye", "eye-off", "filter", "refresh", "more-horizontal", "more-vertical", "external-link", "chevron-down", "chevron-up", "chevron-left", "chevron-right", "save", "undo", "archive", "star", "flag", "clock", "map-pin", "phone", "printer", "alert-triangle", "info", "check-circle", "x-circle", "loader", "mic", "circle-stop", "image", "camera", "headphones"];
 export type NavIconKey = (typeof NAV_ICON_KEYS)[number];
 export type IconKey = NavIconKey;

package/dist/nav-icon.js

@@ -78,6 +78,7 @@ export const NAV_ICON_KEYS = [
     "more-vertical",
     "external-link",
     "chevron-down",
+    "chevron-up",
     "chevron-left",
     "chevron-right",
     "save",

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
@@ -452,13 +462,20 @@ export type ProjectionListScreenDefinition = {
     readonly slots?: ScreenSlots;
     readonly access?: AccessRule;
 };
+export type RecordHeaderSubtitlePart = string | {
+    readonly field: string;
+    readonly navigate?: MetricNavigate;
+};
 export type RecordHeaderSpec = {
     readonly title: string;
-    readonly subtitle?: string;
+    /** Field name, or several parts (field name or `{ field, navigate }`)
+     *  joined by a separator; parts with an empty value are dropped. */
+    readonly subtitle?: string | readonly RecordHeaderSubtitlePart[];
     readonly status?: string;
     /** Record field holding an absolute http(s) URL. When present and the
      *  field's value is such a URL, the subtitle renders as an external link
-     *  (`target="_blank"`) instead of plain text. */
+     *  (`target="_blank"`) instead of plain text. Only valid with the string
+     *  form of `subtitle`. */
     readonly subtitleHref?: string;
     /** Badge tone per `status` field value; unlisted values fall back to the value heuristic. */
     readonly statusTones?: {
@@ -822,6 +839,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.2",
+  "version": "0.332.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>",