@cosmicdrift/kumiko-types 0.377.0 → 0.378.0

package/dist/config.d.ts

@@ -219,7 +219,10 @@ export type TemplateListVariableDef = TemplateVariableCommon & {
     readonly item: Readonly<Record<string, TemplateScalarVariableDef>>;
     readonly example?: readonly Readonly<Record<string, unknown>>[];
 };
-export type TemplateVariableDef = TemplateScalarVariableDef | TemplateListVariableDef;
+export type TemplateImagesVariableDef = TemplateVariableCommon & {
+    readonly type: "images";
+};
+export type TemplateVariableDef = TemplateScalarVariableDef | TemplateListVariableDef | TemplateImagesVariableDef;
 export type TemplateVariables = Readonly<Record<string, TemplateVariableDef>>;
 export type NotificationTemplateMeta = {
     readonly subject: string;

package/dist/fields.d.ts

@@ -489,7 +489,8 @@ export type EmbeddedSubFieldDef = (EmbeddedSubFieldBase & {
  *  precision its target sub-field in `schema` declares (money → integer,
  *  decimal → `scale`) before it's validated. */
 export type EmbeddedDerivedCellDef = {
-    readonly op: "multiply" | "sum" | "subtract";
+    /** `percent` = `from[0] * from[1] / 100` (exactly two sources, e.g. amount and rate). */
+    readonly op: "multiply" | "sum" | "subtract" | "percent";
     readonly from: readonly string[];
 };
 export type EmbeddedFieldDef = {

package/dist/screen.d.ts

@@ -63,8 +63,9 @@ export interface FieldFormatRegistry {
     image: {
         readonly variant?: string;
     };
-    /** List cell: FileRef id (or id array) as a download link with the file name.
-     *  Outside list cells the raw value is shown. */
+    /** FileRef id (or id array) as a download link with the file name. On a
+     *  read-only detail field it renders a file list with download links and an
+     *  inline preview for PDFs; elsewhere the raw value is shown. */
     file: object;
 }
 export type FormatSpec = {
@@ -1522,6 +1523,21 @@ export type EntityEditActionPlacement = "inline" | "menu";
 export type EntityEditAction = RowAction & {
     readonly placement?: EntityEditActionPlacement;
 };
+/** A form field computed from other fields of the same form. `listSum` adds one
+ *  numeric cell over all rows of an embedded list field; its `whenEmpty`
+ *  fallback applies while the list has no rows (it must not be a `listSum`). */
+export type FormFieldDerivation = {
+    readonly op: "sum" | "subtract" | "multiply" | "percent";
+    readonly from: readonly string[];
+} | {
+    readonly op: "listSum";
+    readonly list: string;
+    readonly cell: string;
+    readonly whenEmpty?: FormFieldDerivationWithoutList;
+};
+export type FormFieldDerivationWithoutList = Extract<FormFieldDerivation, {
+    from: unknown;
+}>;
 export type ActionFormScreenDefinition = {
     readonly id: string;
     readonly type: "actionForm";
@@ -1560,6 +1576,13 @@ export type ActionFormScreenDefinition = {
      *  A `money` field here must name its own currency source: this screen
      *  has no entity whose `defaultCurrency` it could inherit (fw#2839). */
     readonly fields: Readonly<Record<string, FormFieldDefinition>>;
+    /** Fields computed from other fields, shown read-only and recomputed on every
+     *  change. A `listSum` over an empty list without `whenEmpty` leaves the field
+     *  a normal input, and then the client value counts. Otherwise the client value
+     *  is never trusted: the handler must wrap its schema with
+     *  `withFormDerivations(schema, screen)`, which the boot validator enforces.
+     *  A field read only as `whenEmpty` operand is read-only while every such list has rows. */
+    readonly derive?: Readonly<Record<string, FormFieldDerivation>>;
     /** Layout analog zu EntityEditScreen: sections mit fields aus dem
      *  fields-Map oben. */
     readonly layout: EditLayout;

package/dist/tenant-db-types.d.ts

@@ -46,6 +46,11 @@ export type TenantDb = {
     selectMany<T = Record<string, unknown>>(table: SchemaTable | EntityTableMeta, where?: WhereObject, options?: SelectOptions): Promise<readonly T[]>;
     fetchOne<T = Record<string, unknown>>(table: SchemaTable | EntityTableMeta, where: WhereObject): Promise<T | undefined>;
     count(table: SchemaTable | EntityTableMeta, where?: WhereObject): Promise<number>;
+    /**
+     * Transaction-scoped advisory lock keyed on (namespace, this handle's tenantId + key); released at
+     * commit or rollback. Keys of different tenants never contend. Only serialises inside a transaction.
+     */
+    advisoryXactLock(namespace: number, key: string): Promise<void>;
     aggregate(table: SchemaTable | EntityTableMeta, spec: AggregateSpec, where?: WhereObject): Promise<readonly AggregateRow[]>;
     insertOne<T = Record<string, unknown>>(table: WritableTable, values: Record<string, unknown>): Promise<T | undefined>;
     updateMany<T = Record<string, unknown>>(table: WritableTable, set: Record<string, unknown>, where: WhereObject): Promise<readonly T[]>;

package/package.json

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