@cosmicdrift/kumiko-types 0.331.0 → 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[];
@@ -213,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/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

@@ -462,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?: {

package/package.json

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