@cosmicdrift/kumiko-types 0.387.0 → 0.389.0

package/dist/screen-list-bulk.js

@@ -0,0 +1,3 @@
+export const LIST_BULK_ACTION_KEYS = ["id", "rowAction", "confirm"];
+/** Most rows one selection can hold; the loaded page caps it further. */
+export const MAX_BULK_SELECTION = 100;

package/dist/screen-list-table.d.ts

@@ -0,0 +1,70 @@
+import type { ListAggregateMeasureKind } from "./list-aggregate-types.ts";
+export declare const LIST_TABLE_DENSITIES: readonly ["comfortable", "compact"];
+export type ListTableDensity = (typeof LIST_TABLE_DENSITIES)[number];
+export declare const LIST_COLUMN_PINS: readonly ["left", "right"];
+export type ListColumnPin = (typeof LIST_COLUMN_PINS)[number];
+export declare const LIST_TABLE_OPTION_KEYS: readonly ["rememberState", "resetAll", "columnPicker", "density", "pinning", "resizing", "keyboardNavigation", "export", "grouping", "totals"];
+export declare const LIST_TABLE_GROUPING_KEYS: readonly ["field", "label", "labels", "collapsedWhen", "userChoice", "fields"];
+export declare const LIST_TABLE_TOTAL_KEYS: readonly ["field", "kind"];
+export declare const LIST_TABLE_EXPORT_KEYS: readonly ["xlsx", "maxRows"];
+export declare const DEFAULT_EXPORT_MAX_ROWS = 10000;
+/** Hard cap: the server builds the whole workbook in memory. */
+export declare const MAX_EXPORT_MAX_ROWS = 100000;
+export declare const LIST_TABLE_DENSITY_KEYS: readonly ["default", "userChoice"];
+/** Opt-in table behaviour of a list. Without the block a list renders and behaves exactly as before. */
+export type ListTableOptions = {
+    /** Keeps search, sort, page size, facets and date range for the browser session and restores them when the screen is opened without list parameters in the URL. A link with parameters always wins. */
+    readonly rememberState?: boolean;
+    /** Replaces the facet reset with one button that resets search, sort, page size, facets and date range, and drops the remembered list parameters (column and density choices stay). */
+    readonly resetAll?: boolean;
+    /** Lets the user hide and reorder columns in the view menu. Columns marked `hidden` start hidden. */
+    readonly columnPicker?: boolean;
+    /** Lets the user pin columns left or right in the view menu; columns may start pinned via `pinned`. Pinned columns stay sticky while scrolling horizontally. No effect in the card layout below `md`. */
+    readonly pinning?: boolean;
+    /** Switches the table to table-layout fixed; the user drags or uses the arrow keys on the header edge to resize. `width` and `minWidth` on a column are start values; widths are remembered per session. No effect in the card layout. */
+    readonly resizing?: boolean;
+    /** Rows become one tab stop; ArrowUp/ArrowDown move, Home/End jump, Enter runs the row click. Space stays reserved for selection. */
+    readonly keyboardNavigation?: boolean;
+    readonly density?: {
+        /** Row density on first visit. Default "comfortable". */
+        readonly default?: ListTableDensity;
+        /** Shows the density choice in the view menu and remembers it per session. */
+        readonly userChoice?: boolean;
+    };
+    /** Shows an export button; the server reads the whole filtered list (not just the visible page). */
+    readonly export?: ListTableExportOptions;
+    /** Server-side grouping: group headers with count and the `totals` measures over all matching rows; each open group loads its own rows. */
+    readonly grouping?: ListTableGrouping;
+    /** Footer row under the rows, computed by the server over all rows matching the current filters and search. In grouped mode the same measures show in each group header. */
+    readonly totals?: readonly ListTableTotal[];
+};
+export type ListTableGrouping = {
+    /** Start grouping. Without it the list starts ungrouped and the user picks from `fields`. */
+    readonly field?: string;
+    /** Groups whose key equals this start collapsed and load no rows until opened. */
+    readonly collapsedWhen?: string | number | boolean | null;
+    /** i18n key of the group header. Placeholders: `{count}` rows in the group, `{value}` the group's value. Default: the value itself. */
+    readonly label?: string;
+    /** Header i18n key per group key (as string), overriding `label`. */
+    readonly labels?: Readonly<Record<string, string>>;
+    /** Shows "Group by" in the view menu (needs `fields` or `field`) and remembers the choice per session. */
+    readonly userChoice?: boolean;
+    /** Fields offered under "Group by"; `field` is always offered. */
+    readonly fields?: readonly string[];
+};
+export type ListTableTotal = {
+    readonly field: string;
+    /** sum and avg on number, decimal, money and bigInt; min and max also on date and timestamp. Money is shown per currency, never added across currencies. */
+    readonly kind: ListAggregateMeasureKind;
+};
+export type ListTableExportOptions = {
+    readonly xlsx: true;
+    /** Export is refused above this many rows. Default 10000, hard cap 100000. Encrypted, sensitive and virtual columns are never written. */
+    readonly maxRows?: number;
+};
+/** One `table` block for every entityList, projectionList and relatedList of the bundled features. A screen's own `table` keys win per key. `grouping` and `totals` are not accepted here. */
+export type BundledListsOptions = {
+    readonly table: ListTableOptions;
+    /** Pins the first column left on every bundled list where no column is pinned. Needs `table.pinning: true`. */
+    readonly pinFirstColumn?: boolean;
+};

package/dist/screen-list-table.js

@@ -0,0 +1,28 @@
+export const LIST_TABLE_DENSITIES = ["comfortable", "compact"];
+export const LIST_COLUMN_PINS = ["left", "right"];
+export const LIST_TABLE_OPTION_KEYS = [
+    "rememberState",
+    "resetAll",
+    "columnPicker",
+    "density",
+    "pinning",
+    "resizing",
+    "keyboardNavigation",
+    "export",
+    "grouping",
+    "totals",
+];
+export const LIST_TABLE_GROUPING_KEYS = [
+    "field",
+    "label",
+    "labels",
+    "collapsedWhen",
+    "userChoice",
+    "fields",
+];
+export const LIST_TABLE_TOTAL_KEYS = ["field", "kind"];
+export const LIST_TABLE_EXPORT_KEYS = ["xlsx", "maxRows"];
+export const DEFAULT_EXPORT_MAX_ROWS = 10000;
+/** Hard cap: the server builds the whole workbook in memory. */
+export const MAX_EXPORT_MAX_ROWS = 100000;
+export const LIST_TABLE_DENSITY_KEYS = ["default", "userChoice"];

package/dist/screen-projection.d.ts

@@ -4,6 +4,8 @@ import type { PlatformComponent, ScreenNavSugar, ScreenSlots } from "./screen.ts
 import type { DashboardPanelVisibility } from "./screen-dashboard.ts";
 import type { EditLayout, ListEmptyStateSpec } from "./screen-entity-edit.ts";
 import type { ListColumnSpec, ListPaginationMode, ListSortSpec, RowAction, RowActionMode, RowFieldExtractor, ScreenFilter, ToolbarAction } from "./screen-entity-list.ts";
+import type { ListBulkAction } from "./screen-list-bulk.ts";
+import type { ListTableOptions } from "./screen-list-table.ts";
 export type ListFacetSpec = {
     readonly field: string;
     readonly type: "select";
@@ -71,9 +73,13 @@ export type ProjectionListScreenDefinition = {
     readonly rowActions?: readonly RowAction[];
     /** Layout of the row-action column — see `RowActionMode`. */
     readonly rowActionMode?: RowActionMode;
+    /** Bulk actions over checkbox-selected rows, each pointing at a writeHandler row action. Adds a checkbox column and a selection bar; without it the list has no checkboxes. */
+    readonly bulkActions?: readonly ListBulkAction[];
     readonly toolbarActions?: readonly ToolbarAction[];
     readonly pagination?: ListPaginationMode;
     readonly pageSize?: number;
+    /** Opt-in table behaviour: remembered state, reset, column picker, density. */
+    readonly table?: ListTableOptions;
     readonly defaultSort?: ListSortSpec;
     /** Replaces the default empty-list title/hint; the create button stays when the list can create. */
     readonly emptyState?: ListEmptyStateSpec;

package/dist/screen.d.ts

@@ -72,8 +72,11 @@ export interface FieldFormatRegistry {
     };
     /** 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;
+     *  inline preview for PDFs; elsewhere the raw value is shown.
+     *  `previewOpenByDefault` opens the first file's PDF preview initially. */
+    file: {
+        readonly previewOpenByDefault?: boolean;
+    };
 }
 export type FormatSpec = {
     [K in keyof FieldFormatRegistry]: {
@@ -111,7 +114,12 @@ export type { ActionFormFooterAction, ActionFormLoad, ActionFormRedirect, Action
 export type { ConfigEditScreenDefinition, CustomScreenDefinition, CustomScreenRoute, SecretsEditScreenDefinition, SecretsEditSection, } from "./screen-custom-config.ts";
 export type { DashboardChartKind, DashboardChartMarkerKind, DashboardChartPanel, DashboardChartRangeOption, DashboardChartRanges, DashboardChartTone, DashboardCurrencyFormat, DashboardCustomPanel, DashboardDateParam, DashboardFeedPanel, DashboardFilterDefinition, DashboardI18nText, DashboardListPanel, DashboardMoneyParam, DashboardPanelDefinition, DashboardPanelEmptyState, DashboardPanelGate, DashboardPanelQueryOptions, DashboardPanelSpan, DashboardPanelVisibility, DashboardProgressListPanel, DashboardProgressTone, DashboardRecordBinding, DashboardRefresh, DashboardRelativeTimeFormat, DashboardRelativeTimeParam, DashboardScopeDefinition, DashboardScreenDefinition, DashboardScreenPanel, DashboardStatGroupPanel, DashboardStatPanel, DashboardStatTone, DashboardText, DashboardTextBlock, DashboardTextPanel, DashboardTextParam, DashboardTimeRangeDefinition, DashboardValueFormat, } from "./screen-dashboard.ts";
 export { DASHBOARD_MIN_REFRESH_SECONDS, DASHBOARD_STAT_TONES } from "./screen-dashboard.ts";
-export type { EditExtensionSection, EditFieldGroup, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldFillAction, FormWidth, ListEmptyStateSpec, RelatedListGroupBy, RelatedListRowTone, } from "./screen-entity-edit.ts";
+export type { EditExtensionSection, EditFieldGroup, EditFieldPrefill, EditFieldSpec, EditFieldsSection, EditLayout, EditRelatedListSection, EditSectionSpec, EditWriteFormSection, EmbeddedListEditSpec, EntityEditAction, EntityEditActionPlacement, EntityEditScreenDefinition, EntityWriteExcludedFields, FieldAffix, FieldFillAction, FormWidth, ListEmptyStateSpec, RelatedListRowTone, } from "./screen-entity-edit.ts";
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.ts";
-export type { EntityListExpandableRow, EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, ListBadgeTone, ListColumnDisplay, ListColumnSpec, ListPaginationMode, ListSortDir, ListSortSpec, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, ScreenFilter, ScreenFilterOp, ToolbarAction, } from "./screen-entity-list.ts";
+export type { EntityListFacetConfig, EntityListFacetExtraOption, EntityListScreenDefinition, ListBadgeTone, ListColumnDisplay, ListColumnSpec, ListPaginationMode, ListSortDir, ListSortSpec, RelatedListToolbarAction, RowAction, RowActionClientAction, RowActionDisplay, RowActionDrawer, RowActionMode, RowActionNavigate, RowActionNavigateBase, RowActionWriteHandler, RowFieldExtractor, ScreenFilter, ScreenFilterOp, ToolbarAction, } from "./screen-entity-list.ts";
+export type { EntityListExpandableRow, ExpandableRowGrouping } from "./screen-expandable-row.ts";
+export type { ListBulkAction } from "./screen-list-bulk.ts";
+export { LIST_BULK_ACTION_KEYS, MAX_BULK_SELECTION } from "./screen-list-bulk.ts";
+export type { BundledListsOptions, ListColumnPin, ListTableDensity, ListTableExportOptions, ListTableGrouping, ListTableOptions, ListTableTotal, } from "./screen-list-table.ts";
+export { DEFAULT_EXPORT_MAX_ROWS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.ts";
 export type { ListFacetSpec, MetricNavigate, MetricSpec, ProjectionDetailScreenDefinition, ProjectionListScreenDefinition, RecordHeaderSpec, RecordHeaderSubtitlePart, } from "./screen-projection.ts";

package/dist/screen.js

@@ -1,2 +1,4 @@
 export { DASHBOARD_MIN_REFRESH_SECONDS, DASHBOARD_STAT_TONES } from "./screen-dashboard.js";
 export { relatedListGroupHeaderLabel, relatedListGroupKey } from "./screen-entity-edit.js";
+export { LIST_BULK_ACTION_KEYS, MAX_BULK_SELECTION } from "./screen-list-bulk.js";
+export { DEFAULT_EXPORT_MAX_ROWS, LIST_COLUMN_PINS, LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_EXPORT_KEYS, LIST_TABLE_GROUPING_KEYS, LIST_TABLE_OPTION_KEYS, LIST_TABLE_TOTAL_KEYS, MAX_EXPORT_MAX_ROWS, } from "./screen-list-table.js";

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

@@ -58,6 +58,11 @@ type TenantDbNonWrites = {
     /** Postgres `now()`; inside a transaction this is the transaction start. */
     databaseNow(): Promise<Date>;
     aggregate(table: SchemaTable | EntityTableMeta, spec: AggregateSpec, where?: WhereObject): Promise<readonly AggregateRow[]>;
+    upsert<T = Record<string, unknown>>(table: WritableTable, values: Record<string, unknown>, options: TenantDbUpsertOptions): Promise<T | undefined>;
+};
+export type TenantDbUpsertOptions = {
+    readonly conflictTarget: readonly string[];
+    readonly update?: Record<string, unknown>;
 };
 export type TenantDb = TenantDbNonWrites & TenantDbWrites<WritableTable>;
 export type ExecutorManagedTenantDb = TenantDbNonWrites & TenantDbWrites<EntityTableMeta> & ExecutorManagedWriteCapability;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.387.0",
+  "version": "0.389.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": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -154,6 +154,10 @@
       "types": "./dist/aggregate-types.d.ts",
       "default": "./dist/aggregate-types.js"
     },
+    "./list-aggregate-types": {
+      "types": "./dist/list-aggregate-types.d.ts",
+      "default": "./dist/list-aggregate-types.js"
+    },
     "./tenant-db-types": {
       "types": "./dist/tenant-db-types.d.ts",
       "default": "./dist/tenant-db-types.js"
@@ -174,6 +178,10 @@
       "types": "./dist/feature.d.ts",
       "default": "./dist/feature.js"
     },
+    "./feature-registrar": {
+      "types": "./dist/feature-registrar.d.ts",
+      "default": "./dist/feature-registrar.js"
+    },
     "./fields": {
       "types": "./dist/fields.d.ts",
       "default": "./dist/fields.js"
@@ -280,18 +288,18 @@
     }
   },
   "devDependencies": {
+    "bun-types": "^1.4.4",
     "hono": "^4.13.1",
-    "postgres": "npm:@bender0oo0/postgres@3.4.9-kumiko.1",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3",
     "ioredis": "^5.10.1"
   },
   "peerDependencies": {
     "hono": "^4.13.1",
-    "postgres": "^3.4.9-0",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3",
-    "ioredis": "^5.10.1"
+    "ioredis": "^5.10.1",
+    "bun-types": "^1.4.4"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -433,6 +441,10 @@
         "types": "./dist/aggregate-types.d.ts",
         "default": "./dist/aggregate-types.js"
       },
+      "./list-aggregate-types": {
+        "types": "./dist/list-aggregate-types.d.ts",
+        "default": "./dist/list-aggregate-types.js"
+      },
       "./tenant-db-types": {
         "types": "./dist/tenant-db-types.d.ts",
         "default": "./dist/tenant-db-types.js"
@@ -453,6 +465,10 @@
         "types": "./dist/feature.d.ts",
         "default": "./dist/feature.js"
       },
+      "./feature-registrar": {
+        "types": "./dist/feature-registrar.d.ts",
+        "default": "./dist/feature-registrar.js"
+      },
       "./fields": {
         "types": "./dist/fields.d.ts",
         "default": "./dist/fields.js"

package/src/changes.json

@@ -1,4 +1,17 @@
 [
+  {
+    "version": "0.389.0",
+    "type": "breaking",
+    "title": "DbConnection, DbTx and PgClient are Bun.SQL types and postgres is no longer a peer dependency",
+    "detail": "DbConnection is SQL | RawDbClient, DbTx is TransactionSQL | RawDbClient and PgClient is SQL from the bun module, so the package type-checks against bun-types instead of postgres. The postgres peer dependency is removed.",
+    "migration": "Remove postgres from your dependencies unless your own code imports it. Annotations that named postgres.Sql or postgres.TransactionSql for framework handles become SQL and TransactionSQL from \"bun\", or the DbConnection and DbTx aliases. Manual migration, there is no codemod."
+  },
+  {
+    "version": "0.389.0",
+    "type": "improvement",
+    "title": "Config validators can read a key's cascade",
+    "detail": "ConfigValidateContext gains readCascade(qualifiedKey), which returns the full cascade of any registered key from the writing tenant and user. Unknown keys throw."
+  },
   {
     "version": "0.386.0",
     "type": "improvement",