@cosmicdrift/kumiko-types 0.351.0 → 0.352.0

package/dist/fields.d.ts

@@ -213,6 +213,14 @@ export type SelectFieldDef<TOptions extends readonly string[] = readonly string[
     /** Payload sent with every `optionsQuery` call. `{ field }` entries re-load the
      *  options when that sibling field changes. */
     readonly optionsQueryPayload?: OptionsQueryPayload;
+    /** Marks static options as unavailable per tenant (e.g. by tier). Contract:
+     *  `{ rows: { value: string; disabled?: boolean; hint?: string }[] }`. The renderer
+     *  loads it (with `optionsQueryPayload` resolved like for `optionsQuery`, `{}` when
+     *  absent) and merges it onto `options`: `disabled` disables the option, `hint` becomes
+     *  its description. The currently stored value always stays enabled; unknown values
+     *  are ignored. Static `options` stay authoritative, and the write path must enforce
+     *  the same rule (see `withTierOptionGate`), the renderer only mirrors it. */
+    readonly optionsAvailabilityQuery?: string;
 } & ResolvedPiiFlags;
 export type MultiSelectFieldDef<TOptions extends readonly string[] = readonly string[]> = {
     readonly type: "multiSelect";

package/dist/handlers.d.ts

@@ -2,7 +2,7 @@ import type { Redis } from "ioredis";
 import type { ZodType } from "zod";
 import type { CacheSyncBus } from "./cache-sync-types.js";
 import type { ConfigAccessor, ConfigAccessorFactory, ConfigResolver } from "./config.js";
-import type { DbConnection } from "./db-connection.js";
+import type { DbConnection, DbTx } from "./db-connection.js";
 import type { DerivativesContext } from "./derivatives-types.js";
 import type { EntityCache } from "./entity-cache.js";
 import type { EventMetadata, WriteOrigin } from "./event-store-types.js";
@@ -505,12 +505,24 @@ export type AgentExposure = {
 };
 /** Undoes a reservation made before the handler transaction. */
 export type ReservationRelease = () => Promise<void>;
-/** Runs in the dispatcher after access and schema checks but before the
- *  handler transaction opens, so it must commit its own short write instead
- *  of holding a second connection while the transaction is open. The returned
- *  release runs when the transaction does not commit (failure result, throw,
- *  rollback, failed commit). Throwing a KumikoError rejects the write. */
-export type PreTransactionReservation = (event: WriteEvent, ctx: HandlerContext) => Promise<ReservationRelease | undefined>;
+/** The dispatcher's own open handler transaction: a reservation must settle on it, not on
+ *  HandlerContext, whose db is fail-closed for r.systemScope() handlers. */
+export type ReservationConfirmContext = {
+    readonly tx: DbTx;
+    readonly tenantId: TenantId;
+};
+/** A reservation that also settles inside the handler transaction. `confirmInTransaction` runs
+ *  after the handler succeeded and before COMMIT; a throw fails the write and rolls it back. */
+export type ReservationHandle = {
+    readonly release: ReservationRelease;
+    readonly confirmInTransaction: (confirm: ReservationConfirmContext) => Promise<void>;
+};
+/** Runs in the dispatcher after every pre-handler gate (feature, rate limit, access, schema,
+ *  validation, field roles) passed but before the handler transaction opens, so it must commit
+ *  its own short write instead of holding a second connection while the transaction is open.
+ *  The returned release (or handle.release) runs when the transaction does not commit (failure
+ *  result, throw, rollback, failed commit). Throwing a KumikoError rejects the write. */
+export type PreTransactionReservation = (event: WriteEvent, ctx: HandlerContext) => Promise<ReservationRelease | ReservationHandle | undefined>;
 export type WriteHandlerDef = {
     readonly name: string;
     readonly schema: ZodType;

package/dist/screen.d.ts

@@ -734,7 +734,10 @@ export type DashboardStatPanel = DashboardPanelQueryOptions & DashboardPanelGate
     /** Static CSS color value (e.g. "var(--color-debt)") for the icon chip,
      *  passed straight to the tile without a registry lookup. Applies ONLY when
      *  `icon` is set (StatCard renders the chip only together with an icon);
-     *  without an icon the value is silently dropped. */
+     *  without an icon the value is silently dropped. Without `accentColor` the
+     *  chip follows the tone, including a `toneField` value delivered per result.
+     *  An accent that should change with the result (e.g. by sign) goes through
+     *  `toneField`; leave `accentColor` unset then. */
     readonly accentColor?: string;
 };
 export type DashboardChartKind = "timeseries" | "stacked-bars" | "segment-bars" | "stacked-area";
@@ -796,6 +799,7 @@ export type DashboardStatGroupPanel = DashboardPanelGate & {
     readonly label?: string;
     /** i18n key, a line under `label`; the boot validator requires `label`. */
     readonly subtitle?: string;
+    readonly span?: DashboardPanelSpan;
     readonly stats: readonly DashboardStatPanel[];
 };
 export type DashboardFeedPanel = DashboardPanelQueryOptions & DashboardPanelEmptyState & DashboardPanelGate & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.351.0",
+  "version": "0.352.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/changes.json

@@ -1,4 +1,17 @@
 [
+  {
+    "version": "0.352.0",
+    "type": "improvement",
+    "title": "SelectFieldDef.optionsAvailabilityQuery marks static select options as unavailable per tenant",
+    "detail": "The query returns { rows: { value, disabled?, hint? }[] }; the renderer merges it onto options and keeps the stored value enabled."
+  },
+  {
+    "version": "0.352.0",
+    "type": "breaking",
+    "title": "Apps must import Temporal from @cosmicdrift/kumiko-types/temporal instead of temporal-polyfill (affects every app since 0.351.0)",
+    "detail": "Since 0.351.0 the native globalThis.Temporal wins over the polyfill. A Temporal imported from \"temporal-polyfill\" is a second implementation, so instanceof and z.instanceof(Temporal.Instant) reject values the framework creates. This applies whether you upgrade from before 0.351.0 or are already on it.",
+    "migration": "Replace every value import from \"temporal-polyfill\" in app code and tests, e.g. `import { Temporal } from \"temporal-polyfill\"`, with `import { Temporal } from \"@cosmicdrift/kumiko-types/temporal\"`, and drop side-effect imports of \"temporal-polyfill/global\" (importing @cosmicdrift/kumiko-types/temporal already installs the global when the runtime has none). `import type` and `/// <reference types=\"temporal-polyfill/global\" />` may stay. Then run `kumiko check`; the No-Temporal-Polyfill-Import guard lists anything left. Close the step with `kumiko-upgrade --resolve <id> --reason \"<what you changed>\"`, or add `--not-applicable` when the repo never imported temporal-polyfill."
+  },
   {
     "version": "0.351.0",
     "type": "fix",