@cosmicdrift/kumiko-types 0.388.0 → 0.390.0

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 newest (last) 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/secrets-types.js

@@ -6,7 +6,7 @@
 // but the nominal typing stops it from landing in an HTTP response by
 // accident — a response-serializer guard + the reveal() cost make the leak
 // intentional. Framework code that sees `Secret<string>` knows the caller
-// has already gone through the audited ctx.secrets.get path.
+// has already gone through the audited ctx.services.secrets.get path.
 //
 // Registered symbol, matching KUMIKO_*_SYMBOL in schema-table-types.ts. A
 // plain Symbol() is per-copy: two resolved copies of this package brand with

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.388.0",
+  "version": "0.390.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>",
@@ -178,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"
@@ -284,18 +288,18 @@
     }
   },
   "devDependencies": {
+    "bun-types": "^1.4.4",
     "hono": "^4.13.1",
-    "postgres": "npm:@bender0oo0/postgres@3.4.9-kumiko.2",
     "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",
@@ -461,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",
@@ -30,7 +43,7 @@
     "type": "breaking",
     "title": "HandlerContext.outsideTransaction removed",
     "detail": "The deprecated outsideTransaction field no longer exists on HandlerContext. ctx.dbOutsideTransaction together with runInOwnTransaction replaces it.",
-    "migration": "Replace ctx.outsideTransaction(fn) with runInOwnTransaction(requireOutsideTransactionDb(ctx), fn); both are exported from @cosmicdrift/kumiko-framework/db and fn keeps its (db) => Promise signature."
+    "migration": "Replace ctx.outsideTransaction(fn) with runInOwnTransaction(requireOutsideTransactionDb(ctx), fn); both are exported from @cosmicdrift/kumiko-framework/db and fn keeps its (db) => Promise signature. Since #4031 the two helpers are internal and no longer exported from /db; narrow ctx.db.outsideTransaction directly (if (ctx.db.outsideTransaction))."
   },
   {
     "version": "0.377.0",