@cosmicdrift/kumiko-types 0.348.1 → 0.349.0

package/dist/screen.d.ts

@@ -649,6 +649,34 @@ export type ProjectionDetailScreenDefinition = {
      *  Set "form" to opt back into the disabled-Input look (fw#2245). */
     readonly valueDisplay?: "form" | "text";
 };
+/** Text a query handler can send untranslated: the renderer translates it. */
+export type DashboardI18nText = {
+    readonly i18nKey: string;
+    readonly i18nParams?: Readonly<Record<string, DashboardTextParam>>;
+};
+/** Minor units (like Money fields), formatted with the user locale. */
+export type DashboardMoneyParam = {
+    readonly kind: "money";
+    readonly amountMinor: number;
+    readonly currency: string;
+};
+/** Epoch ms, rendered as a medium date in the user time zone. */
+export type DashboardDateParam = {
+    readonly kind: "date";
+    readonly atMs: number;
+};
+/** Nested DashboardI18nText params resolve first (e.g. a duration "{years} {months}"
+ *  with one plural key each); numbers stay raw so plural rules can read `count`. */
+export type DashboardTextParam = string | number | DashboardI18nText | DashboardMoneyParam | DashboardDateParam;
+/** Plain string is displayed as-is; DashboardI18nText is translated by the renderer. */
+export type DashboardText = string | DashboardI18nText;
+/** Chart/stat values are minor units, formatted with the user locale. */
+export type DashboardValueFormat = {
+    readonly kind: "currency";
+    readonly currency: string;
+    /** Defaults to the currency's own decimals. */
+    readonly fractionDigits?: number;
+};
 export type DashboardPanelQueryOptions = {
     /** Static, author-set query parameters merged on top of the screen's
      *  dynamic filterParams — lets a panel pin a value (e.g. a status facet)
@@ -677,6 +705,8 @@ export type DashboardStatPanel = DashboardPanelQueryOptions & {
     readonly valueField: string;
     readonly subField?: string;
     readonly toneField?: string;
+    /** Formats a numeric value as currency (minor units); ignored for string values. The sparkline is not formatted. */
+    readonly valueFormat?: DashboardValueFormat;
     /** Fixed tone when `toneField` is unset or yields none; not applied while the value is 0. */
     readonly tone?: "default" | "positive" | "warn" | "negative";
     /** Record field holding `{ atMs, value | null }[]` (MetricResult.points),
@@ -714,6 +744,11 @@ export type DashboardChartPanel = DashboardPanelQueryOptions & DashboardPanelEmp
     readonly subtitle?: string;
     /** Series/segment key -> tone; unmapped keys fall back to a palette. */
     readonly seriesTones?: Readonly<Record<string, DashboardChartTone>>;
+    /** Formats values as currency (minor units): y ticks, legend totals and tooltips on
+     *  stacked-bars/segment-bars/stacked-area, only the y ticks on timeseries. */
+    readonly valueFormat?: DashboardValueFormat;
+    /** Only for chart "stacked-area": fixed width per bucket, plot scrolls horizontally. */
+    readonly scrollable?: boolean;
 };
 export type DashboardListPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & {
     readonly kind: "list";

package/package.json

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